140 lines
4.0 KiB
Markdown
140 lines
4.0 KiB
Markdown
---
|
||
name: feishu
|
||
description: 飞书文档与多维表格操作入口。当用户提到飞书、云文档、多维表格、Bitable 相关任务时自动激活。
|
||
---
|
||
|
||
# 飞书集成
|
||
|
||
## 功能模块
|
||
|
||
| 模块 | 技能 | 说明 |
|
||
|------|------|------|
|
||
| 云文档 | `feishu-docx` | 创建、编辑云文档，会议纪要 |
|
||
| 多维表格 | `feishu-bitable` | 记录增删改查，数据同步 |
|
||
| 任务 | 本技能 | 创建待办任务 |
|
||
|
||
## 环境配置
|
||
|
||
```bash
|
||
# ~/.zshrc（凭证唯一配置位置）
|
||
export FEISHU_APP_ID="cli_a9f29dca82b9dbef"
|
||
export FEISHU_APP_SECRET="<从飞书开放平台获取>"
|
||
```
|
||
|
||
**权限要求**：
|
||
- 云文档：`docx:document`, `drive:drive`
|
||
- 多维表格：`bitable:app`
|
||
- 任务：`task:task:write`
|
||
|
||
## Access Token
|
||
|
||
```python
|
||
import os, requests
|
||
|
||
def get_tenant_access_token():
|
||
"""获取飞书 tenant_access_token"""
|
||
url = "https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal"
|
||
response = requests.post(url, json={
|
||
"app_id": os.environ["FEISHU_APP_ID"],
|
||
"app_secret": os.environ["FEISHU_APP_SECRET"]
|
||
})
|
||
data = response.json()
|
||
if data.get("code") == 0:
|
||
return data["tenant_access_token"]
|
||
raise Exception(f"获取 token 失败: {data}")
|
||
```
|
||
|
||
## 默认存储位置
|
||
|
||
| 文件夹 | folder_token |
|
||
|--------|-------------|
|
||
| ai-proj 根目录 | `RTLKf247ClQQDyd5IjxcTOVQnxd` |
|
||
| 01运营 (默认) | `C80gfkRnzlonQ5d4AhOcOACDnNg` |
|
||
|
||
## URL 结构
|
||
|
||
```
|
||
云文档: https://xxx.feishu.cn/docx/DoxcXXXXXX
|
||
└── document_id
|
||
|
||
多维表格: https://xxx.feishu.cn/base/BascXXX?table=tblXXX&view=vewXXX
|
||
└── app_token └── table_id
|
||
```
|
||
|
||
## 飞书任务
|
||
|
||
```python
|
||
def create_task(summary: str, due_time: int = None):
|
||
"""创建飞书任务"""
|
||
url = "https://open.feishu.cn/open-apis/task/v2/tasks"
|
||
token = get_tenant_access_token()
|
||
payload = {"summary": summary}
|
||
if due_time:
|
||
payload["due"] = {"timestamp": str(due_time), "is_all_day": False}
|
||
response = requests.post(url,
|
||
headers={"Authorization": f"Bearer {token}", "Content-Type": "application/json"},
|
||
json=payload)
|
||
data = response.json()
|
||
if data.get("code") == 0:
|
||
return data["data"]["task"]
|
||
raise Exception(f"创建任务失败: {data}")
|
||
```
|
||
|
||
## 工具类
|
||
|
||
完整工具类见：
|
||
- `~/.claude/skills/feishu/feishu_bitable.py` - 多维表格
|
||
- `~/.claude/skills/feishu/feishu_docx.py` - 云文档
|
||
|
||
## Incoming Webhook（群机器人通知卡片）
|
||
|
||
**Webhook 地址**：存储在 `~/.config/devops/credentials.env` → `FEISHU_DEPLOY_WEBHOOK`
|
||
|
||
**⚠️ 关键注意事项**：
|
||
- ❌ **禁用 schema 2.0**：`"schema": "2.0"` 会返回 ErrCode 11246，必须用 legacy 格式
|
||
- ✅ **legacy 卡片格式**（无 schema 字段）才能正常发送
|
||
- ❌ **按钮 URL 禁止指向列表页**：必须带具体资源 ID（如 `/requirements/864`，不能是 `/requirements`）
|
||
- ✅ **保存到文件再 curl**：包含中文的 JSON 直接用 `'...'` 传参会报 "blank argument" 错误
|
||
|
||
**正确的卡片发送示例**：
|
||
```bash
|
||
cat > /tmp/feishu_card.json << 'EOF'
|
||
{
|
||
"msg_type": "interactive",
|
||
"card": {
|
||
"header": {
|
||
"title": {"tag": "plain_text", "content": "通知标题"},
|
||
"template": "blue"
|
||
},
|
||
"elements": [
|
||
{
|
||
"tag": "div",
|
||
"text": {"tag": "lark_md", "content": "**内容**：描述文字"}
|
||
},
|
||
{
|
||
"tag": "action",
|
||
"actions": [{
|
||
"tag": "button",
|
||
"text": {"tag": "plain_text", "content": "查看详情"},
|
||
"type": "primary",
|
||
"url": "https://ai.pipexerp.com/requirements/864"
|
||
}]
|
||
}
|
||
]
|
||
}
|
||
}
|
||
EOF
|
||
|
||
curl -s -X POST \
|
||
"https://open.feishu.cn/open-apis/bot/v2/hook/xxx" \
|
||
-H "Content-Type: application/json" \
|
||
-d @/tmp/feishu_card.json
|
||
```
|
||
|
||
**header template 颜色**：`blue`（待审批）/ `green`（通过）/ `red`（驳回）/ `wathet`（信息）
|
||
|
||
## 相关技能
|
||
|
||
- `feishu-docx` - 云文档详细操作
|
||
- `feishu-bitable` - 多维表格详细操作
|