sophhub 0.2.3 → 0.2.4

package/skills/feishu-bitable/src/bin/cli.js

@@ -0,0 +1,284 @@
+#!/usr/bin/env node
+
+/**
+ * 飞书多维表格命令行工具
+ */
+
+const { program } = require('commander');
+const FeishuBitableAPI = require('../src/api');
+const { parseJsonInput, validateRequired } = require('../src/utils');
+
+// 加载环境变量
+require('dotenv').config();
+
+program
+  .name('feishu-bitable')
+  .description('飞书多维表格命令行工具')
+  .version('1.0.0');
+
+// 测试连接命令
+program
+  .command('test')
+  .description('测试飞书连接')
+  .action(async () => {
+    try {
+      const api = new FeishuBitableAPI();
+      const result = await api.testConnection();
+      
+      if (result.success) {
+        console.log('✅ 连接测试成功');
+        console.log(`应用ID: ${result.appId}`);
+        console.log(`令牌有效: ${result.tokenValid ? '是' : '否'}`);
+      } else {
+        console.error('❌ 连接测试失败:', result.message);
+        process.exit(1);
+      }
+    } catch (error) {
+      console.error('❌ 连接测试失败:', error.message);
+      process.exit(1);
+    }
+  });
+
+// 获取应用信息
+program
+  .command('get-app')
+  .description('获取应用信息')
+  .requiredOption('--app-token <token>', '应用token')
+  .action(async (options) => {
+    try {
+      validateRequired(options, ['appToken']);
+      const api = new FeishuBitableAPI();
+      const result = await api.getApp(options.appToken);
+      
+      console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+      console.error('❌ 获取应用信息失败:', error.message);
+      process.exit(1);
+    }
+  });
+
+// 列出数据表
+program
+  .command('list-tables')
+  .description('列出所有数据表')
+  .requiredOption('--app-token <token>', '应用token')
+  .option('--page-size <number>', '每页大小', '100')
+  .option('--page-token <token>', '分页token')
+  .action(async (options) => {
+    try {
+      validateRequired(options, ['appToken']);
+      const api = new FeishuBitableAPI();
+      
+      const params = {};
+      if (options.pageSize) params.page_size = parseInt(options.pageSize);
+      if (options.pageToken) params.page_token = options.pageToken;
+      
+      const result = await api.listTables(options.appToken, params);
+      console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+      console.error('❌ 列出数据表失败:', error.message);
+      process.exit(1);
+    }
+  });
+
+// 创建数据表
+program
+  .command('create-table')
+  .description('创建数据表')
+  .requiredOption('--app-token <token>', '应用token')
+  .requiredOption('--name <name>', '表名')
+  .option('--fields <json>', '字段定义JSON或@文件路径')
+  .action(async (options) => {
+    try {
+      validateRequired(options, ['appToken', 'name']);
+      const api = new FeishuBitableAPI();
+      
+      const tableData = {
+        name: options.name
+      };
+      
+      if (options.fields) {
+        tableData.fields = parseJsonInput(options.fields);
+      }
+      
+      const result = await api.createTable(options.appToken, tableData);
+      console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+      console.error('❌ 创建数据表失败:', error.message);
+      process.exit(1);
+    }
+  });
+
+// 列出记录
+program
+  .command('list-records')
+  .description('列出记录')
+  .requiredOption('--app-token <token>', '应用token')
+  .requiredOption('--table-id <id>', '表ID')
+  .option('--page-size <number>', '每页大小', '100')
+  .option('--page-token <token>', '分页token')
+  .option('--filter <json>', '过滤条件JSON')
+  .option('--sort <json>', '排序条件JSON')
+  .action(async (options) => {
+    try {
+      validateRequired(options, ['appToken', 'tableId']);
+      const api = new FeishuBitableAPI();
+      
+      const params = {};
+      if (options.pageSize) params.page_size = parseInt(options.pageSize);
+      if (options.pageToken) params.page_token = options.pageToken;
+      if (options.filter) params.filter = parseJsonInput(options.filter);
+      if (options.sort) params.sort = parseJsonInput(options.sort);
+      
+      const result = await api.listRecords(options.appToken, options.tableId, params);
+      console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+      console.error('❌ 列出记录失败:', error.message);
+      process.exit(1);
+    }
+  });
+
+// 创建记录
+program
+  .command('create-record')
+  .description('创建记录')
+  .requiredOption('--app-token <token>', '应用token')
+  .requiredOption('--table-id <id>', '表ID')
+  .requiredOption('--data <json>', '记录数据JSON或@文件路径')
+  .action(async (options) => {
+    try {
+      validateRequired(options, ['appToken', 'tableId', 'data']);
+      const api = new FeishuBitableAPI();
+      
+      const recordData = parseJsonInput(options.data);
+      const result = await api.createRecord(options.appToken, options.tableId, recordData);
+      console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+      console.error('❌ 创建记录失败:', error.message);
+      process.exit(1);
+    }
+  });
+
+// 批量创建记录
+program
+  .command('batch-create')
+  .description('批量创建记录')
+  .requiredOption('--app-token <token>', '应用token')
+  .requiredOption('--table-id <id>', '表ID')
+  .requiredOption('--data <json>', '记录数据数组JSON或@文件路径')
+  .action(async (options) => {
+    try {
+      validateRequired(options, ['appToken', 'tableId', 'data']);
+      const api = new FeishuBitableAPI();
+      
+      const records = parseJsonInput(options.data);
+      if (!Array.isArray(records)) {
+        throw new Error('数据必须是数组格式');
+      }
+      
+      const result = await api.batchCreateRecords(options.appToken, options.tableId, records);
+      console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+      console.error('❌ 批量创建记录失败:', error.message);
+      process.exit(1);
+    }
+  });
+
+// 更新记录
+program
+  .command('update-record')
+  .description('更新记录')
+  .requiredOption('--app-token <token>', '应用token')
+  .requiredOption('--table-id <id>', '表ID')
+  .requiredOption('--record-id <id>', '记录ID')
+  .requiredOption('--data <json>', '更新数据JSON或@文件路径')
+  .action(async (options) => {
+    try {
+      validateRequired(options, ['appToken', 'tableId', 'recordId', 'data']);
+      const api = new FeishuBitableAPI();
+      
+      const recordData = parseJsonInput(options.data);
+      const result = await api.updateRecord(options.appToken, options.tableId, options.recordId, recordData);
+      console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+      console.error('❌ 更新记录失败:', error.message);
+      process.exit(1);
+    }
+  });
+
+// 删除记录
+program
+  .command('delete-record')
+  .description('删除记录')
+  .requiredOption('--app-token <token>', '应用token')
+  .requiredOption('--table-id <id>', '表ID')
+  .requiredOption('--record-id <id>', '记录ID')
+  .action(async (options) => {
+    try {
+      validateRequired(options, ['appToken', 'tableId', 'recordId']);
+      const api = new FeishuBitableAPI();
+      
+      const result = await api.deleteRecord(options.appToken, options.tableId, options.recordId);
+      console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+      console.error('❌ 删除记录失败:', error.message);
+      process.exit(1);
+    }
+  });
+
+// 列出字段
+program
+  .command('list-fields')
+  .description('列出字段')
+  .requiredOption('--app-token <token>', '应用token')
+  .requiredOption('--table-id <id>', '表ID')
+  .option('--page-size <number>', '每页大小', '100')
+  .option('--page-token <token>', '分页token')
+  .action(async (options) => {
+    try {
+      validateRequired(options, ['appToken', 'tableId']);
+      const api = new FeishuBitableAPI();
+      
+      const params = {};
+      if (options.pageSize) params.page_size = parseInt(options.pageSize);
+      if (options.pageToken) params.page_token = options.pageToken;
+      
+      const result = await api.listFields(options.appToken, options.tableId, params);
+      console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+      console.error('❌ 列出字段失败:', error.message);
+      process.exit(1);
+    }
+  });
+
+// 列出视图
+program
+  .command('list-views')
+  .description('列出视图')
+  .requiredOption('--app-token <token>', '应用token')
+  .requiredOption('--table-id <id>', '表ID')
+  .option('--page-size <number>', '每页大小', '100')
+  .option('--page-token <token>', '分页token')
+  .action(async (options) => {
+    try {
+      validateRequired(options, ['appToken', 'tableId']);
+      const api = new FeishuBitableAPI();
+      
+      const params = {};
+      if (options.pageSize) params.page_size = parseInt(options.pageSize);
+      if (options.pageToken) params.page_token = options.pageToken;
+      
+      const result = await api.listViews(options.appToken, options.tableId, params);
+      console.log(JSON.stringify(result, null, 2));
+    } catch (error) {
+      console.error('❌ 列出视图失败:', error.message);
+      process.exit(1);
+    }
+  });
+
+// 如果没有命令，显示帮助
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+} else {
+  program.parse(process.argv);
+}

package/skills/feishu-bitable/src/description.md

@@ -0,0 +1,143 @@
+# 飞书多维表格技能 (Feishu Bitable)
+
+一个功能完整的飞书多维表格(Bitable)API技能，为Clawdbot提供强大的飞书多维表格操作能力。
+
+## 功能亮点
+
+### 📊 完整的数据表管理
+- **列出数据表**：获取应用中的所有数据表
+- **创建数据表**：支持自定义字段和属性
+- **数据表详情**：获取表结构和元数据
+- **删除数据表**：安全删除不需要的表
+
+### 📝 强大的记录操作
+- **CRUD操作**：完整的创建、读取、更新、删除功能
+- **批量操作**：支持批量创建、更新、删除记录
+- **高级查询**：支持过滤、排序、分页
+- **字段映射**：自动处理不同字段类型的值转换
+
+### 🔧 专业功能
+- **字段管理**：查看和操作表字段
+- **视图管理**：获取多维表格视图信息
+- **自动Token刷新**：无需手动处理认证过期
+- **错误处理**：完善的错误处理和重试机制
+
+## 技术特性
+
+### 🚀 高性能
+- **异步操作**：所有API调用都是异步的
+- **连接池**：复用HTTP连接提高性能
+- **批量处理**：优化批量操作减少API调用次数
+
+### 🛡️ 可靠性
+- **自动重试**：网络错误时自动重试
+- **Token刷新**：自动处理飞书token过期
+- **参数验证**：严格的输入参数验证
+- **错误处理**：友好的错误消息和诊断信息
+
+### 🔌 易用性
+- **命令行工具**：完整的CLI接口
+- **JSON支持**：支持直接JSON或文件输入
+- **环境变量**：灵活的配置方式
+- **详细文档**：完整的示例和使用说明
+
+## 使用场景
+
+### 🏢 企业自动化
+- **任务管理**：自动同步任务状态到飞书
+- **数据同步**：从其他系统导入数据到飞书
+- **报表生成**：自动生成业务报表
+- **审批流程**：集成飞书审批和工作流
+
+### 👥 团队协作
+- **项目管理**：团队任务跟踪和分配
+- **客户管理**：CRM数据管理和分析
+- **库存管理**：商品库存跟踪和预警
+- **日程安排**：团队日程和会议管理
+
+### 🔄 系统集成
+- **API集成**：与其他系统API集成
+- **数据管道**：构建数据ETL管道
+- **实时同步**：实时数据同步和更新
+- **监控告警**：系统监控和自动告警
+
+## 安装和使用
+
+### 快速开始
+```bash
+# 通过ClawdHub安装
+clawdhub install feishu-bitable
+
+# 进入技能目录
+cd skills/feishu-bitable
+
+# 安装依赖
+npm install
+
+# 配置环境变量
+cp .env.example .env
+# 编辑.env文件，填入你的飞书应用凭证
+
+# 测试连接
+node bin/cli.js test
+```
+
+### 基本示例
+```bash
+# 列出所有数据表
+node bin/cli.js list-tables --app-token basxxxxxx
+
+# 创建新表
+node bin/cli.js create-table --app-token basxxxxxx --name "项目任务"
+
+# 添加任务
+node bin/cli.js create-record --app-token basxxxxxx --table-id tblxxxxxx \
+  --data '{"任务名称": "开发API", "状态": "进行中", "优先级": "高"}'
+
+# 批量导入数据
+node bin/cli.js batch-create --app-token basxxxxxx --table-id tblxxxxxx \
+  --data @examples/create-records.json
+```
+
+## 与其他技能集成
+
+### 🤝 飞书生态
+- **feishu-bridge**：通过飞书机器人接收指令
+- **feishu-docx-powerwrite**：将表格数据生成精美文档
+- **feishu-card**：发送表格更新通知卡片
+- **feishu-calendar**：同步日程和截止日期
+
+### 🔗 数据工具
+- **google-sheet-api**：与Google Sheets数据同步
+- **notion**：与Notion数据库双向同步
+- **database**：与传统数据库集成
+- **csv-export**：导出数据为CSV格式
+
+## 开发指南
+
+### 扩展功能
+技能采用模块化设计，易于扩展：
+- `src/api.js` - 核心API客户端
+- `src/utils.js` - 工具函数库
+- `bin/cli.js` - 命令行接口
+
+### 贡献
+欢迎贡献代码和功能：
+1. Fork项目
+2. 创建功能分支
+3. 提交更改
+4. 创建Pull Request
+
+## 许可证
+
+MIT License - 免费用于商业和个人项目。
+
+## 支持
+
+- 文档：查看SKILL.md获取详细API文档
+- 问题：在GitHub Issues报告问题
+- 社区：加入Clawdbot Discord社区获取帮助
+
+---
+
+**让飞书多维表格成为你的数据中枢，释放自动化潜能！**

package/skills/feishu-bitable/src/examples/create-records.json

@@ -0,0 +1,52 @@
+[
+  {
+    "任务名称": "开发用户登录功能",
+    "状态": "进行中",
+    "优先级": "高",
+    "截止日期": "2024-12-15",
+    "负责人": "user_id_1",
+    "描述": "实现用户登录、注册、忘记密码功能",
+    "完成百分比": 70,
+    "是否完成": false
+  },
+  {
+    "任务名称": "设计数据库架构",
+    "状态": "已完成",
+    "优先级": "中",
+    "截止日期": "2024-11-30",
+    "负责人": "user_id_2",
+    "描述": "设计系统数据库表结构和关系",
+    "完成百分比": 100,
+    "是否完成": true
+  },
+  {
+    "任务名称": "编写API文档",
+    "状态": "待办",
+    "优先级": "中",
+    "截止日期": "2024-12-20",
+    "负责人": "user_id_3",
+    "描述": "编写完整的API接口文档",
+    "完成百分比": 0,
+    "是否完成": false
+  },
+  {
+    "任务名称": "测试支付功能",
+    "状态": "进行中",
+    "优先级": "紧急",
+    "截止日期": "2024-12-10",
+    "负责人": "user_id_4",
+    "描述": "测试支付流程和异常处理",
+    "完成百分比": 50,
+    "是否完成": false
+  },
+  {
+    "任务名称": "部署生产环境",
+    "状态": "待办",
+    "优先级": "高",
+    "截止日期": "2024-12-25",
+    "负责人": "user_id_5",
+    "描述": "部署应用到生产服务器",
+    "完成百分比": 0,
+    "是否完成": false
+  }
+]

package/skills/feishu-bitable/src/examples/create-table.json

@@ -0,0 +1,64 @@
+{
+  "name": "任务管理",
+  "fields": [
+    {
+      "field_name": "任务名称",
+      "type": "text",
+      "property": {
+        "formatter": "text"
+      }
+    },
+    {
+      "field_name": "状态",
+      "type": "single_select",
+      "property": {
+        "options": [
+          {"name": "待办", "color": "blue"},
+          {"name": "进行中", "color": "orange"},
+          {"name": "已完成", "color": "green"}
+        ]
+      }
+    },
+    {
+      "field_name": "优先级",
+      "type": "single_select",
+      "property": {
+        "options": [
+          {"name": "低", "color": "gray"},
+          {"name": "中", "color": "blue"},
+          {"name": "高", "color": "red"},
+          {"name": "紧急", "color": "magenta"}
+        ]
+      }
+    },
+    {
+      "field_name": "截止日期",
+      "type": "date",
+      "property": {
+        "formatter": "yyyy-MM-dd"
+      }
+    },
+    {
+      "field_name": "负责人",
+      "type": "user"
+    },
+    {
+      "field_name": "描述",
+      "type": "text",
+      "property": {
+        "formatter": "text"
+      }
+    },
+    {
+      "field_name": "完成百分比",
+      "type": "number",
+      "property": {
+        "formatter": "0%"
+      }
+    },
+    {
+      "field_name": "是否完成",
+      "type": "checkbox"
+    }
+  ]
+}