{"skill":{"slug":"feishu-api-bitable","displayName":"Feishu Bitable API","summary":"飞书多维表格(Bitable)API技能。用于创建、读取、更新和删除飞书多维表格的数据表、记录和字段。","description":"---\nname: feishu-bitable\ndescription: 飞书多维表格(Bitable)API技能。用于创建、读取、更新和删除飞书多维表格的数据表、记录和字段。\nmetadata: {\"clawdbot\":{\"emoji\":\"📊\",\"requires\":{\"env\":[\"FEISHU_APP_ID\",\"FEISHU_APP_SECRET\"]},\"primaryEnv\":\"FEISHU_APP_ID\"}}\n---\n\n# 飞书多维表格(Bitable)技能\n\n用于操作飞书多维表格的完整技能，支持数据表、记录和字段的CRUD操作。\n\n## 功能特性\n\n- ✅ 数据表管理（创建、列表、获取、删除）\n- ✅ 记录管理（创建、读取、更新、删除、批量操作）\n- ✅ 字段管理（创建、列表、更新）\n- ✅ 视图管理（列表、获取）\n- ✅ 应用管理（获取应用信息）\n\n## 环境变量配置\n\n```bash\n# 飞书应用ID\nexport FEISHU_APP_ID=cli_xxxxxx\n\n# 飞书应用密钥（或密钥文件路径）\nexport FEISHU_APP_SECRET=your_app_secret\n# 或\nexport FEISHU_APP_SECRET_PATH=~/.clawdbot/secrets/feishu_app_secret\n```\n\n## 快速开始\n\n### 1. 安装依赖\n```bash\ncd skills/feishu-bitable\nnpm install\n```\n\n### 2. 设置环境变量\n```bash\nexport FEISHU_APP_ID=cli_xxxxxx\nexport FEISHU_APP_SECRET=your_app_secret\n```\n\n### 3. 使用CLI工具\n```bash\n# 获取帮助\nnode bitable-cli.js --help\n\n# 列出所有数据表\nnode bitable-cli.js list-tables --app-token basxxxxxx\n\n# 创建新记录\nnode bitable-cli.js create-record --app-token basxxxxxx --table-id tblxxxxxx --data '{\"字段1\": \"值1\", \"字段2\": \"值2\"}'\n\n# 查询记录\nnode bitable-cli.js list-records --app-token basxxxxxx --table-id tblxxxxxx\n```\n\n## API端点\n\n### 数据表相关\n- `GET /bitable/v1/apps/{app_token}/tables` - 获取数据表列表\n- `POST /bitable/v1/apps/{app_token}/tables` - 创建数据表\n- `GET /bitable/v1/apps/{app_token}/tables/{table_id}` - 获取数据表详情\n- `DELETE /bitable/v1/apps/{app_token}/tables/{table_id}` - 删除数据表\n\n### 记录相关\n- `POST /bitable/v1/apps/{app_token}/tables/{table_id}/records` - 新增记录\n- `GET /bitable/v1/apps/{app_token}/tables/{table_id}/records` - 获取记录列表\n- `PUT /bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id}` - 更新记录\n- `DELETE /bitable/v1/apps/{app_token}/tables/{table_id}/records/{record_id}` - 删除记录\n- `POST /bitable/v1/apps/{app_token}/tables/{table_id}/records/batch_create` - 批量新增记录\n- `POST /bitable/v1/apps/{app_token}/tables/{table_id}/records/batch_update` - 批量更新记录\n- `POST /bitable/v1/apps/{app_token}/tables/{table_id}/records/batch_delete` - 批量删除记录\n\n### 字段相关\n- `GET /bitable/v1/apps/{app_token}/tables/{table_id}/fields` - 获取字段列表\n- `POST /bitable/v1/apps/{app_token}/tables/{table_id}/fields` - 创建字段\n- `PUT /bitable/v1/apps/{app_token}/tables/{table_id}/fields/{field_id}` - 更新字段\n\n### 视图相关\n- `GET /bitable/v1/apps/{app_token}/tables/{table_id}/views` - 获取视图列表\n- `GET /bitable/v1/apps/{app_token}/tables/{table_id}/views/{view_id}` - 获取视图详情\n\n## 使用示例\n\n### 1. 创建数据表\n```bash\nnode bitable-cli.js create-table \\\n  --app-token basxxxxxx \\\n  --name \"任务管理\" \\\n  --fields '[{\"field_name\": \"任务名称\", \"type\": \"text\"}, {\"field_name\": \"状态\", \"type\": \"select\", \"property\": {\"options\": [{\"name\": \"待办\"}, {\"name\": \"进行中\"}, {\"name\": \"已完成\"}]}}]'\n```\n\n### 2. 添加记录\n```bash\nnode bitable-cli.js create-record \\\n  --app-token basxxxxxx \\\n  --table-id tblxxxxxx \\\n  --data '{\"任务名称\": \"完成API开发\", \"状态\": \"进行中\", \"优先级\": \"高\", \"截止日期\": \"2024-12-31\"}'\n```\n\n### 3. 查询记录\n```bash\nnode bitable-cli.js list-records \\\n  --app-token basxxxxxx \\\n  --table-id tblxxxxxx \\\n  --filter '{\"conjunction\": \"and\", \"conditions\": [{\"field_name\": \"状态\", \"operator\": \"is\", \"value\": [\"进行中\"]}]}' \\\n  --sort '[\"-创建时间\"]' \\\n  --page-size 50\n```\n\n### 4. 批量操作\n```bash\nnode bitable-cli.js batch-create \\\n  --app-token basxxxxxx \\\n  --table-id tblxxxxxx \\\n  --data-file records.json\n```\n\n## 字段类型支持\n\n飞书多维表格支持以下字段类型：\n- `text` - 文本\n- `number` - 数字\n- `single_select` - 单选\n- `multi_select` - 多选\n- `date` - 日期\n- `person` - 人员\n- `checkbox` - 复选框\n- `url` - 链接\n- `phone` - 电话\n- `email` - 邮箱\n- `attachment` - 附件\n- `formula` - 公式\n- `created_time` - 创建时间\n- `modified_time` - 修改时间\n- `created_by` - 创建人\n- `modified_by` - 修改人\n\n## 错误处理\n\n技能包含完整的错误处理机制：\n- 网络错误重试\n- 权限验证\n- 参数验证\n- 速率限制处理\n\n## 注意事项\n\n1. **权限要求**：应用需要具备`bitable:record:readonly`和`bitable:record:write`权限\n2. **速率限制**：飞书API有速率限制，建议添加适当的延迟\n3. **数据大小**：单次请求记录数量建议不超过100条\n4. **字段名称**：字段名称在表中必须唯一\n\n## Clawdbot集成\n\n### 在Clawdbot中使用此技能\n\n1. **确保技能已安装**：技能应该位于 `skills/feishu-bitable` 目录\n2. **设置环境变量**：在Clawdbot配置中设置飞书应用凭证\n3. **在对话中调用**：Clawdbot可以调用此技能来操作飞书多维表格\n\n### 示例对话\n\n**用户**: \"帮我在飞书多维表格中添加一个任务\"\n**Clawdbot**: \n```bash\n# 使用技能添加任务\nnode skills/feishu-bitable/bin/cli.js create-record \\\n  --app-token basxxxxxx \\\n  --table-id tblxxxxxx \\\n  --data '{\"任务名称\": \"新任务\", \"状态\": \"待办\", \"优先级\": \"中\"}'\n```\n\n### 自动化工作流\n\n你可以创建自动化工作流，例如：\n- 每天同步任务状态\n- 从其他系统导入数据到飞书多维表格\n- 根据条件自动更新记录\n- 生成报表并发送到飞书群聊\n\n## 开发指南\n\n如需扩展功能，请参考：\n- `src/api.js` - API客户端\n- `src/cli.js` - 命令行接口\n- `src/utils.js` - 工具函数\n\n### 添加新的API端点\n\n1. 在 `src/api.js` 的 `FeishuBitableAPI` 类中添加新方法\n2. 在 `bin/cli.js` 中添加对应的命令\n3. 更新文档\n\n### 错误处理最佳实践\n\n- 使用 `try-catch` 包装所有API调用\n- 提供有意义的错误消息\n- 实现重试逻辑处理网络错误\n- 验证输入参数","tags":{"api":"1.0.0","automation":"1.0.0","bitable":"1.0.0","chinese":"1.0.0","database":"1.0.0","feishu":"1.0.0","lark":"1.0.0","latest":"1.0.0","spreadsheet":"1.0.0"},"stats":{"comments":0,"downloads":3683,"installsAllTime":17,"installsCurrent":17,"stars":4,"versions":1},"createdAt":1770346670898,"updatedAt":1778988624418},"latestVersion":{"version":"1.0.0","createdAt":1770346670898,"changelog":"Complete Feishu Bitable API integration with table management, record CRUD operations, field/view management, automatic token refresh, and error handling.","license":null},"metadata":{"setup":[{"key":"FEISHU_APP_ID","required":true},{"key":"FEISHU_APP_SECRET","required":true}],"os":null,"systems":null},"owner":{"handle":"stevenlikewatermelon","userId":"s17ftg2z8fyckr1jvpjmrbs061885txc","displayName":"StevenLikeWatermelon","image":"https://avatars.githubusercontent.com/u/34053346?v=4"},"moderation":null}