sophhub 0.4.19 → 0.4.21

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

@@ -1,150 +1,150 @@
-# 发布检查清单
-
-## ✅ 已完成的项目
-
-### 核心功能
-- [x] 完整的API客户端 (src/api.js)
-- [x] 工具函数库 (src/utils.js)
-- [x] 命令行接口 (bin/cli.js)
-- [x] 自动token刷新
-- [x] 错误处理和重试机制
-- [x] 参数验证
-
-### 数据表管理
-- [x] 列出数据表
-- [x] 创建数据表
-- [x] 获取数据表详情
-- [x] 删除数据表
-
-### 记录操作
-- [x] 列出记录（支持过滤、排序、分页）
-- [x] 创建单个记录
-- [x] 批量创建记录
-- [x] 更新记录
-- [x] 删除记录
-- [x] 批量操作
-
-### 字段和视图管理
-- [x] 列出字段
-- [x] 创建字段
-- [x] 更新字段
-- [x] 列出视图
-- [x] 获取视图详情
-
-### 文档和示例
-- [x] SKILL.md (Clawdbot技能文档)
-- [x] README.md (使用说明)
-- [x] description.md (发布描述)
-- [x] 示例文件 (examples/)
-- [x] .env.example (环境变量模板)
-- [x] 测试脚本 (test-simple.js)
-
-### 配置和依赖
-- [x] package.json (依赖配置)
-- [x] package-lock.json (依赖锁定)
-- [x] 完整的npm依赖
-- [x] 执行权限设置
-
-## 📋 发布准备
-
-### 技能信息
-- **Slug**: feishu-bitable
-- **名称**: Feishu Bitable
-- **版本**: 1.0.0
-- **描述**: 飞书多维表格(Bitable)API技能
-- **标签**: feishu, lark, bitable, database, spreadsheet, automation, api, chinese
-- **许可证**: MIT
-
-### 功能亮点
-1. 完整的飞书多维表格API集成
-2. 自动token刷新和错误处理
-3. 批量操作支持
-4. 详细的文档和示例
-5. 易于扩展的模块化设计
-
-## 🚀 发布步骤
-
-1. **登录ClawdHub**
-   ```bash
-   clawdhub login
-   ```
-
-2. **发布技能**
-   ```bash
-   cd skills/feishu-bitable
-   clawdhub publish . \
-     --slug feishu-bitable \
-     --name "Feishu Bitable" \
-     --version 1.0.0 \
-     --changelog "Initial release: Complete Feishu Bitable API integration" \
-     --tags "feishu,bitable,database,automation"
-   ```
-
-3. **验证发布**
-   ```bash
-   clawdhub search "feishu-bitable"
-   ```
-
-4. **测试安装**
-   ```bash
-   # 在另一个目录测试安装
-   mkdir test-install && cd test-install
-   clawdhub install feishu-bitable
-   cd feishu-bitable
-   npm install
-   node bin/cli.js --help
-   ```
-
-## 🔧 技能结构
-```
-feishu-bitable/
-├── src/                    # 源代码
-│   ├── api.js             # API客户端
-│   └── utils.js           # 工具函数
-├── bin/                   # 命令行工具
-│   └── cli.js             # CLI接口
-├── examples/              # 示例文件
-├── SKILL.md              # 技能文档
-├── README.md             # 使用说明
-├── description.md        # 发布描述
-├── package.json          # 依赖配置
-└── test-simple.js        # 测试脚本
-```
-
-## 📝 发布说明
-
-### 版本 1.0.0 (初始发布)
-- 完整的飞书多维表格API集成
-- 支持数据表、记录、字段、视图的CRUD操作
-- 自动token刷新和错误处理
-- 批量操作支持
-- 详细的文档和示例
-- 命令行工具接口
-
-### 目标用户
-- 需要自动化飞书多维表格的企业用户
-- 开发者和系统集成商
-- 团队协作和项目管理
-- 数据同步和报表生成
-
-### 系统要求
-- Node.js >= 16.0.0
-- 飞书企业账号和应用权限
-- Clawdbot环境
-
-## 🆘 故障排除
-
-### 常见问题
-1. **登录失败**: 检查网络连接，尝试使用--token参数
-2. **发布失败**: 确保所有必填字段完整
-3. **安装失败**: 检查网络和权限设置
-4. **API错误**: 验证飞书应用权限和凭证
-
-### 支持资源
-- ClawdHub文档: https://clawdhub.com/docs
-- 飞书开放平台: https://open.feishu.cn
-- Clawdbot社区: https://discord.com/invite/clawd
-
----
-
+# 发布检查清单
+
+## ✅ 已完成的项目
+
+### 核心功能
+- [x] 完整的API客户端 (src/api.js)
+- [x] 工具函数库 (src/utils.js)
+- [x] 命令行接口 (bin/cli.js)
+- [x] 自动token刷新
+- [x] 错误处理和重试机制
+- [x] 参数验证
+
+### 数据表管理
+- [x] 列出数据表
+- [x] 创建数据表
+- [x] 获取数据表详情
+- [x] 删除数据表
+
+### 记录操作
+- [x] 列出记录（支持过滤、排序、分页）
+- [x] 创建单个记录
+- [x] 批量创建记录
+- [x] 更新记录
+- [x] 删除记录
+- [x] 批量操作
+
+### 字段和视图管理
+- [x] 列出字段
+- [x] 创建字段
+- [x] 更新字段
+- [x] 列出视图
+- [x] 获取视图详情
+
+### 文档和示例
+- [x] SKILL.md (Clawdbot技能文档)
+- [x] README.md (使用说明)
+- [x] description.md (发布描述)
+- [x] 示例文件 (examples/)
+- [x] .env.example (环境变量模板)
+- [x] 测试脚本 (test-simple.js)
+
+### 配置和依赖
+- [x] package.json (依赖配置)
+- [x] package-lock.json (依赖锁定)
+- [x] 完整的npm依赖
+- [x] 执行权限设置
+
+## 📋 发布准备
+
+### 技能信息
+- **Slug**: feishu-bitable
+- **名称**: Feishu Bitable
+- **版本**: 1.0.0
+- **描述**: 飞书多维表格(Bitable)API技能
+- **标签**: feishu, lark, bitable, database, spreadsheet, automation, api, chinese
+- **许可证**: MIT
+
+### 功能亮点
+1. 完整的飞书多维表格API集成
+2. 自动token刷新和错误处理
+3. 批量操作支持
+4. 详细的文档和示例
+5. 易于扩展的模块化设计
+
+## 🚀 发布步骤
+
+1. **登录ClawdHub**
+   ```bash
+   clawdhub login
+   ```
+
+2. **发布技能**
+   ```bash
+   cd skills/feishu-bitable
+   clawdhub publish . \
+     --slug feishu-bitable \
+     --name "Feishu Bitable" \
+     --version 1.0.0 \
+     --changelog "Initial release: Complete Feishu Bitable API integration" \
+     --tags "feishu,bitable,database,automation"
+   ```
+
+3. **验证发布**
+   ```bash
+   clawdhub search "feishu-bitable"
+   ```
+
+4. **测试安装**
+   ```bash
+   # 在另一个目录测试安装
+   mkdir test-install && cd test-install
+   clawdhub install feishu-bitable
+   cd feishu-bitable
+   npm install
+   node bin/cli.js --help
+   ```
+
+## 🔧 技能结构
+```
+feishu-bitable/
+├── src/                    # 源代码
+│   ├── api.js             # API客户端
+│   └── utils.js           # 工具函数
+├── bin/                   # 命令行工具
+│   └── cli.js             # CLI接口
+├── examples/              # 示例文件
+├── SKILL.md              # 技能文档
+├── README.md             # 使用说明
+├── description.md        # 发布描述
+├── package.json          # 依赖配置
+└── test-simple.js        # 测试脚本
+```
+
+## 📝 发布说明
+
+### 版本 1.0.0 (初始发布)
+- 完整的飞书多维表格API集成
+- 支持数据表、记录、字段、视图的CRUD操作
+- 自动token刷新和错误处理
+- 批量操作支持
+- 详细的文档和示例
+- 命令行工具接口
+
+### 目标用户
+- 需要自动化飞书多维表格的企业用户
+- 开发者和系统集成商
+- 团队协作和项目管理
+- 数据同步和报表生成
+
+### 系统要求
+- Node.js >= 16.0.0
+- 飞书企业账号和应用权限
+- Clawdbot环境
+
+## 🆘 故障排除
+
+### 常见问题
+1. **登录失败**: 检查网络连接，尝试使用--token参数
+2. **发布失败**: 确保所有必填字段完整
+3. **安装失败**: 检查网络和权限设置
+4. **API错误**: 验证飞书应用权限和凭证
+
+### 支持资源
+- ClawdHub文档: https://clawdhub.com/docs
+- 飞书开放平台: https://open.feishu.cn
+- Clawdbot社区: https://discord.com/invite/clawd
+
+---
+
 **技能已准备好发布！** 🎉

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

@@ -1,178 +1,178 @@
-# 飞书多维表格技能
-
-这是一个用于操作飞书多维表格(Bitable)的Clawdbot技能。
-
-## 快速开始
-
-### 1. 安装依赖
-```bash
-cd skills/feishu-bitable
-npm install
-```
-
-### 2. 配置环境变量
-创建 `.env` 文件：
-```bash
-FEISHU_APP_ID=cli_xxxxxx
-FEISHU_APP_SECRET=your_app_secret
-```
-
-或者使用密钥文件：
-```bash
-FEISHU_APP_ID=cli_xxxxxx
-FEISHU_APP_SECRET_PATH=~/.clawdbot/secrets/feishu_app_secret
-```
-
-### 3. 测试连接
-```bash
-node bin/cli.js test
-```
-
-## 基本用法
-
-### 列出数据表
-```bash
-node bin/cli.js list-tables --app-token basxxxxxx
-```
-
-### 创建数据表
-```bash
-node bin/cli.js create-table \
-  --app-token basxxxxxx \
-  --name "任务管理" \
-  --fields @examples/create-table.json
-```
-
-### 创建记录
-```bash
-node bin/cli.js create-record \
-  --app-token basxxxxxx \
-  --table-id tblxxxxxx \
-  --data '{"任务名称": "测试任务", "状态": "待办"}'
-```
-
-### 批量创建记录
-```bash
-node bin/cli.js batch-create \
-  --app-token basxxxxxx \
-  --table-id tblxxxxxx \
-  --data @examples/create-records.json
-```
-
-### 列出记录
-```bash
-node bin/cli.js list-records \
-  --app-token basxxxxxx \
-  --table-id tblxxxxxx \
-  --page-size 50
-```
-
-### 更新记录
-```bash
-node bin/cli.js update-record \
-  --app-token basxxxxxx \
-  --table-id tblxxxxxx \
-  --record-id recxxxxxx \
-  --data '{"状态": "已完成", "完成百分比": 100}'
-```
-
-### 删除记录
-```bash
-node bin/cli.js delete-record \
-  --app-token basxxxxxx \
-  --table-id tblxxxxxx \
-  --record-id recxxxxxx
-```
-
-## 在Clawdbot中使用
-
-### 1. 确保技能已安装
-技能应该位于 `skills/feishu-bitable` 目录。
-
-### 2. 设置环境变量
-在Clawdbot配置中设置：
-```json
-{
-  "env": {
-    "FEISHU_APP_ID": "cli_xxxxxx",
-    "FEISHU_APP_SECRET": "your_app_secret"
-  }
-}
-```
-
-### 3. 在对话中使用
-Clawdbot可以调用此技能来操作飞书多维表格。
-
-## API参考
-
-### 数据表操作
-- `list-tables` - 列出数据表
-- `create-table` - 创建数据表
-- `get-table` - 获取数据表详情（待实现）
-- `delete-table` - 删除数据表（待实现）
-
-### 记录操作
-- `list-records` - 列出记录
-- `create-record` - 创建记录
-- `batch-create` - 批量创建记录
-- `update-record` - 更新记录
-- `delete-record` - 删除记录
-
-### 字段操作
-- `list-fields` - 列出字段
-
-### 视图操作
-- `list-views` - 列出视图
-
-## 字段类型映射
-
-| 字段类型 | API类型 | 示例值 |
-|---------|---------|--------|
-| 文本 | text | "Hello World" |
-| 数字 | number | 123.45 |
-| 单选 | single_select | {"name": "选项1"} |
-| 多选 | multi_select | [{"name": "选项1"}, {"name": "选项2"}] |
-| 日期 | date | {"start": "2024-01-01"} |
-| 人员 | user | {"id": "user_id"} |
-| 复选框 | checkbox | true |
-| 附件 | attachment | {"file_token": "token"} |
-
-## 错误处理
-
-技能包含完整的错误处理：
-- 网络错误重试
-- Token自动刷新
-- 参数验证
-- 友好的错误消息
-
-## 注意事项
-
-1. **权限**：确保飞书应用有 `bitable:record:readonly` 和 `bitable:record:write` 权限
-2. **速率限制**：飞书API有速率限制，建议添加适当的延迟
-3. **数据大小**：单次请求不要超过100条记录
-4. **字段名称**：字段名称在表中必须唯一
-
-## 开发
-
-### 项目结构
-```
-feishu-bitable/
-├── src/
-│   ├── api.js          # API客户端
-│   └── utils.js        # 工具函数
-├── bin/
-│   └── cli.js          # 命令行接口
-├── examples/           # 示例文件
-├── package.json        # 依赖配置
-├── SKILL.md           # 技能文档
-└── README.md          # 使用说明
-```
-
-### 添加新功能
-1. 在 `src/api.js` 中添加新的API方法
-2. 在 `bin/cli.js` 中添加对应的命令
-3. 更新文档
-
-## 许可证
-
+# 飞书多维表格技能
+
+这是一个用于操作飞书多维表格(Bitable)的Clawdbot技能。
+
+## 快速开始
+
+### 1. 安装依赖
+```bash
+cd skills/feishu-bitable
+npm install
+```
+
+### 2. 配置环境变量
+创建 `.env` 文件：
+```bash
+FEISHU_APP_ID=cli_xxxxxx
+FEISHU_APP_SECRET=your_app_secret
+```
+
+或者使用密钥文件：
+```bash
+FEISHU_APP_ID=cli_xxxxxx
+FEISHU_APP_SECRET_PATH=~/.clawdbot/secrets/feishu_app_secret
+```
+
+### 3. 测试连接
+```bash
+node bin/cli.js test
+```
+
+## 基本用法
+
+### 列出数据表
+```bash
+node bin/cli.js list-tables --app-token basxxxxxx
+```
+
+### 创建数据表
+```bash
+node bin/cli.js create-table \
+  --app-token basxxxxxx \
+  --name "任务管理" \
+  --fields @examples/create-table.json
+```
+
+### 创建记录
+```bash
+node bin/cli.js create-record \
+  --app-token basxxxxxx \
+  --table-id tblxxxxxx \
+  --data '{"任务名称": "测试任务", "状态": "待办"}'
+```
+
+### 批量创建记录
+```bash
+node bin/cli.js batch-create \
+  --app-token basxxxxxx \
+  --table-id tblxxxxxx \
+  --data @examples/create-records.json
+```
+
+### 列出记录
+```bash
+node bin/cli.js list-records \
+  --app-token basxxxxxx \
+  --table-id tblxxxxxx \
+  --page-size 50
+```
+
+### 更新记录
+```bash
+node bin/cli.js update-record \
+  --app-token basxxxxxx \
+  --table-id tblxxxxxx \
+  --record-id recxxxxxx \
+  --data '{"状态": "已完成", "完成百分比": 100}'
+```
+
+### 删除记录
+```bash
+node bin/cli.js delete-record \
+  --app-token basxxxxxx \
+  --table-id tblxxxxxx \
+  --record-id recxxxxxx
+```
+
+## 在Clawdbot中使用
+
+### 1. 确保技能已安装
+技能应该位于 `skills/feishu-bitable` 目录。
+
+### 2. 设置环境变量
+在Clawdbot配置中设置：
+```json
+{
+  "env": {
+    "FEISHU_APP_ID": "cli_xxxxxx",
+    "FEISHU_APP_SECRET": "your_app_secret"
+  }
+}
+```
+
+### 3. 在对话中使用
+Clawdbot可以调用此技能来操作飞书多维表格。
+
+## API参考
+
+### 数据表操作
+- `list-tables` - 列出数据表
+- `create-table` - 创建数据表
+- `get-table` - 获取数据表详情（待实现）
+- `delete-table` - 删除数据表（待实现）
+
+### 记录操作
+- `list-records` - 列出记录
+- `create-record` - 创建记录
+- `batch-create` - 批量创建记录
+- `update-record` - 更新记录
+- `delete-record` - 删除记录
+
+### 字段操作
+- `list-fields` - 列出字段
+
+### 视图操作
+- `list-views` - 列出视图
+
+## 字段类型映射
+
+| 字段类型 | API类型 | 示例值 |
+|---------|---------|--------|
+| 文本 | text | "Hello World" |
+| 数字 | number | 123.45 |
+| 单选 | single_select | {"name": "选项1"} |
+| 多选 | multi_select | [{"name": "选项1"}, {"name": "选项2"}] |
+| 日期 | date | {"start": "2024-01-01"} |
+| 人员 | user | {"id": "user_id"} |
+| 复选框 | checkbox | true |
+| 附件 | attachment | {"file_token": "token"} |
+
+## 错误处理
+
+技能包含完整的错误处理：
+- 网络错误重试
+- Token自动刷新
+- 参数验证
+- 友好的错误消息
+
+## 注意事项
+
+1. **权限**：确保飞书应用有 `bitable:record:readonly` 和 `bitable:record:write` 权限
+2. **速率限制**：飞书API有速率限制，建议添加适当的延迟
+3. **数据大小**：单次请求不要超过100条记录
+4. **字段名称**：字段名称在表中必须唯一
+
+## 开发
+
+### 项目结构
+```
+feishu-bitable/
+├── src/
+│   ├── api.js          # API客户端
+│   └── utils.js        # 工具函数
+├── bin/
+│   └── cli.js          # 命令行接口
+├── examples/           # 示例文件
+├── package.json        # 依赖配置
+├── SKILL.md           # 技能文档
+└── README.md          # 使用说明
+```
+
+### 添加新功能
+1. 在 `src/api.js` 中添加新的API方法
+2. 在 `bin/cli.js` 中添加对应的命令
+3. 更新文档
+
+## 许可证
+
 MIT