sophhub 0.2.3 → 0.3.0

package/skills/feishu-bitable/src/package-lock.json

@@ -0,0 +1,324 @@
+{
+  "name": "feishu-bitable",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "feishu-bitable",
+      "version": "1.0.0",
+      "license": "MIT",
+      "dependencies": {
+        "axios": "^1.6.0",
+        "commander": "^11.1.0",
+        "dotenv": "^16.3.0"
+      },
+      "bin": {
+        "feishu-bitable": "bin/cli.js"
+      },
+      "engines": {
+        "node": ">=16.0.0"
+      }
+    },
+    "node_modules/asynckit": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmmirror.com/asynckit/-/asynckit-0.4.0.tgz",
+      "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
+      "license": "MIT"
+    },
+    "node_modules/axios": {
+      "version": "1.13.4",
+      "resolved": "https://registry.npmmirror.com/axios/-/axios-1.13.4.tgz",
+      "integrity": "sha512-1wVkUaAO6WyaYtCkcYCOx12ZgpGf9Zif+qXa4n+oYzK558YryKqiL6UWwd5DqiH3VRW0GYhTZQ/vlgJrCoNQlg==",
+      "license": "MIT",
+      "dependencies": {
+        "follow-redirects": "^1.15.6",
+        "form-data": "^4.0.4",
+        "proxy-from-env": "^1.1.0"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmmirror.com/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/combined-stream": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmmirror.com/combined-stream/-/combined-stream-1.0.8.tgz",
+      "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
+      "license": "MIT",
+      "dependencies": {
+        "delayed-stream": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/commander": {
+      "version": "11.1.0",
+      "resolved": "https://registry.npmmirror.com/commander/-/commander-11.1.0.tgz",
+      "integrity": "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/delayed-stream": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmmirror.com/delayed-stream/-/delayed-stream-1.0.0.tgz",
+      "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/dotenv": {
+      "version": "16.6.1",
+      "resolved": "https://registry.npmmirror.com/dotenv/-/dotenv-16.6.1.tgz",
+      "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://dotenvx.com"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmmirror.com/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmmirror.com/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmmirror.com/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmmirror.com/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-set-tostringtag": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmmirror.com/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+      "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/follow-redirects": {
+      "version": "1.15.11",
+      "resolved": "https://registry.npmmirror.com/follow-redirects/-/follow-redirects-1.15.11.tgz",
+      "integrity": "sha512-deG2P0JfjrTxl50XGCDyfI97ZGVCxIpfKYmfyrQ54n5FO/0gfIES8C/Psl6kWVDolizcaaxZJnTS0QSMxvnsBQ==",
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/RubenVerborgh"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=4.0"
+      },
+      "peerDependenciesMeta": {
+        "debug": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/form-data": {
+      "version": "4.0.5",
+      "resolved": "https://registry.npmmirror.com/form-data/-/form-data-4.0.5.tgz",
+      "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==",
+      "license": "MIT",
+      "dependencies": {
+        "asynckit": "^0.4.0",
+        "combined-stream": "^1.0.8",
+        "es-set-tostringtag": "^2.1.0",
+        "hasown": "^2.0.2",
+        "mime-types": "^2.1.12"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmmirror.com/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmmirror.com/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmmirror.com/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmmirror.com/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmmirror.com/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-tostringtag": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmmirror.com/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+      "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+      "license": "MIT",
+      "dependencies": {
+        "has-symbols": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmmirror.com/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmmirror.com/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmmirror.com/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmmirror.com/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/proxy-from-env": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmmirror.com/proxy-from-env/-/proxy-from-env-1.1.0.tgz",
+      "integrity": "sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg==",
+      "license": "MIT"
+    }
+  }
+}

package/skills/feishu-bitable/src/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "feishu-bitable",
+  "version": "1.0.0",
+  "description": "飞书多维表格(Bitable)API技能 - 用于创建、读取、更新和删除飞书多维表格的数据表、记录和字段",
+  "main": "src/api.js",
+  "bin": {
+    "feishu-bitable": "bin/cli.js"
+  },
+  "scripts": {
+    "start": "node bin/cli.js",
+    "test": "node test-simple.js",
+    "publish": "clawdhub publish . --slug feishu-bitable --name \"Feishu Bitable\" --version 1.0.0 --changelog \"Initial release: Complete Feishu Bitable API integration\""
+  },
+  "keywords": ["feishu", "lark", "bitable", "多维表格", "api", "clawdbot", "database", "spreadsheet", "automation"],
+  "author": "Clawdbot Community",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clawdbot/skills.git"
+  },
+  "homepage": "https://clawdhub.com/skills/feishu-bitable",
+  "bugs": {
+    "url": "https://github.com/clawdbot/skills/issues"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "commander": "^11.1.0",
+    "dotenv": "^16.3.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/skills/feishu-bitable/src/publish-config.json

@@ -0,0 +1,14 @@
+{
+  "slug": "feishu-bitable",
+  "name": "Feishu Bitable",
+  "version": "1.0.0",
+  "description": "飞书多维表格(Bitable)API技能 - 用于创建、读取、更新和删除飞书多维表格的数据表、记录和字段",
+  "tags": ["feishu", "lark", "bitable", "database", "spreadsheet", "automation", "api", "chinese"],
+  "changelog": "Initial release with complete Feishu Bitable API integration:\n- Full table management (list, create, get, delete)\n- Complete record operations (CRUD + batch)\n- Field and view management\n- Automatic token refresh\n- Error handling and retry logic\n- Command-line interface\n- Examples and documentation",
+  "readme": "See SKILL.md for detailed documentation",
+  "keywords": ["飞书", "多维表格", "bitable", "数据库", "自动化", "API"],
+  "author": "Clawdbot Community",
+  "license": "MIT",
+  "homepage": "https://clawdhub.com/skills/feishu-bitable",
+  "repository": "https://github.com/clawdbot/skills/tree/main/feishu-bitable"
+}

package/skills/feishu-bitable/src/test-simple.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+/**
+ * 简单测试脚本
+ */
+
+console.log('=== 飞书多维表格技能测试 ===\n');
+
+// 检查环境变量
+const requiredEnvVars = ['FEISHU_APP_ID', 'FEISHU_APP_SECRET'];
+const missingVars = requiredEnvVars.filter(varName => !process.env[varName]);
+
+if (missingVars.length > 0) {
+  console.log('❌ 缺少必要的环境变量:');
+  missingVars.forEach(varName => {
+    console.log(`  - ${varName}`);
+  });
+  console.log('\n请设置环境变量或创建 .env 文件');
+  console.log('参考 .env.example 文件');
+  process.exit(1);
+}
+
+console.log('✅ 环境变量检查通过');
+console.log(`应用ID: ${process.env.FEISHU_APP_ID ? '已设置' : '未设置'}`);
+console.log(`应用密钥: ${process.env.FEISHU_APP_SECRET ? '已设置' : '未设置'}`);
+
+// 测试API客户端
+try {
+  const FeishuBitableAPI = require('./src/api');
+  const api = new FeishuBitableAPI();
+  
+  console.log('\n✅ API客户端初始化成功');
+  
+  // 测试连接
+  console.log('\n正在测试连接...');
+  api.testConnection().then(result => {
+    if (result.success) {
+      console.log('✅ 连接测试成功');
+      console.log(`令牌有效: ${result.tokenValid ? '是' : '否'}`);
+    } else {
+      console.log('❌ 连接测试失败:', result.message);
+    }
+    
+    console.log('\n=== 测试完成 ===');
+    console.log('\n可用命令:');
+    console.log('  node bin/cli.js test              - 测试连接');
+    console.log('  node bin/cli.js --help           - 查看所有命令');
+    console.log('  node bin/cli.js list-tables --help - 查看具体命令帮助');
+    
+  }).catch(error => {
+    console.error('❌ 连接测试失败:', error.message);
+    console.log('\n可能的原因:');
+    console.log('1. 应用ID或密钥错误');
+    console.log('2. 网络连接问题');
+    console.log('3. 应用权限不足');
+  });
+  
+} catch (error) {
+  console.error('❌ API客户端初始化失败:', error.message);
+  process.exit(1);
+}

package/skills/feishu-bitable/src/utils.js

@@ -0,0 +1,261 @@
+/**
+ * 工具函数
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * 读取环境变量
+ */
+function getEnvVar(name, defaultValue = null) {
+  // 从环境变量读取
+  let value = process.env[name];
+  
+  // 如果是文件路径，从文件读取
+  if (name.endsWith('_PATH') && value) {
+    try {
+      const filePath = value.startsWith('~') 
+        ? path.join(process.env.HOME, value.slice(1))
+        : value;
+      
+      if (fs.existsSync(filePath)) {
+        value = fs.readFileSync(filePath, 'utf8').trim();
+      }
+    } catch (error) {
+      console.warn(`无法读取文件 ${value}: ${error.message}`);
+    }
+  }
+  
+  return value || defaultValue;
+}
+
+/**
+ * 获取飞书访问令牌
+ */
+async function getAccessToken(appId, appSecret) {
+  const axios = require('axios');
+  
+  try {
+    const response = await axios.post('https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal/', {
+      app_id: appId,
+      app_secret: appSecret
+    }, {
+      headers: {
+        'Content-Type': 'application/json; charset=utf-8'
+      }
+    });
+    
+    if (response.data.code === 0) {
+      return response.data.tenant_access_token;
+    } else {
+      throw new Error(`获取访问令牌失败: ${response.data.msg}`);
+    }
+  } catch (error) {
+    throw new Error(`获取访问令牌时出错: ${error.message}`);
+  }
+}
+
+/**
+ * 验证必填参数
+ */
+function validateRequired(params, requiredFields) {
+  for (const field of requiredFields) {
+    if (!params[field]) {
+      throw new Error(`缺少必填参数: ${field}`);
+    }
+  }
+}
+
+/**
+ * 解析JSON字符串或文件
+ */
+function parseJsonInput(input) {
+  if (!input) return null;
+  
+  // 如果是文件路径（以@开头）
+  if (typeof input === 'string' && input.startsWith('@')) {
+    const filePath = input.slice(1);
+    try {
+      const content = fs.readFileSync(filePath, 'utf8');
+      return JSON.parse(content);
+    } catch (error) {
+      throw new Error(`无法读取或解析文件 ${filePath}: ${error.message}`);
+    }
+  }
+  
+  // 如果是JSON字符串
+  if (typeof input === 'string') {
+    try {
+      return JSON.parse(input);
+    } catch (error) {
+      // 如果不是有效的JSON，返回原始字符串
+      return input;
+    }
+  }
+  
+  // 已经是对象
+  return input;
+}
+
+/**
+ * 格式化日期
+ */
+function formatDate(date, format = 'YYYY-MM-DD') {
+  const d = date instanceof Date ? date : new Date(date);
+  
+  const year = d.getFullYear();
+  const month = String(d.getMonth() + 1).padStart(2, '0');
+  const day = String(d.getDate()).padStart(2, '0');
+  const hours = String(d.getHours()).padStart(2, '0');
+  const minutes = String(d.getMinutes()).padStart(2, '0');
+  const seconds = String(d.getSeconds()).padStart(2, '0');
+  
+  return format
+    .replace('YYYY', year)
+    .replace('MM', month)
+    .replace('DD', day)
+    .replace('HH', hours)
+    .replace('mm', minutes)
+    .replace('ss', seconds);
+}
+
+/**
+ * 延迟函数
+ */
+function delay(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+/**
+ * 分页处理
+ */
+async function paginate(fetchFunction, params = {}, pageSize = 100) {
+  let allItems = [];
+  let pageToken = null;
+  let hasMore = true;
+  let page = 1;
+  
+  while (hasMore) {
+    try {
+      const response = await fetchFunction({
+        ...params,
+        page_size: pageSize,
+        page_token: pageToken
+      });
+      
+      if (response.data && response.data.items) {
+        allItems = allItems.concat(response.data.items);
+        
+        if (response.data.has_more && response.data.page_token) {
+          pageToken = response.data.page_token;
+          page++;
+          
+          // 避免速率限制
+          await delay(100);
+        } else {
+          hasMore = false;
+        }
+      } else {
+        hasMore = false;
+      }
+    } catch (error) {
+      console.error(`分页获取第 ${page} 页时出错:`, error.message);
+      hasMore = false;
+    }
+  }
+  
+  return allItems;
+}
+
+/**
+ * 构建字段值
+ */
+function buildFieldValue(fieldType, value) {
+  switch (fieldType) {
+    case 'text':
+      return value;
+    case 'number':
+      return Number(value);
+    case 'single_select':
+      return { name: value };
+    case 'multi_select':
+      return Array.isArray(value) ? value.map(v => ({ name: v })) : [{ name: value }];
+    case 'date':
+      return { start: formatDate(value, 'YYYY-MM-DD') };
+    case 'person':
+      return Array.isArray(value) ? value.map(id => ({ id })) : [{ id: value }];
+    case 'checkbox':
+      return Boolean(value);
+    case 'url':
+      return value;
+    case 'phone':
+      return value;
+    case 'email':
+      return value;
+    case 'attachment':
+      // 附件需要先上传
+      return value;
+    default:
+      return value;
+  }
+}
+
+/**
+ * 解析记录字段
+ */
+function parseRecordFields(record, fieldsMap) {
+  const result = {};
+  
+  if (!record.fields) return result;
+  
+  for (const [fieldId, value] of Object.entries(record.fields)) {
+    const fieldInfo = fieldsMap[fieldId];
+    if (fieldInfo) {
+      result[fieldInfo.field_name] = parseFieldValue(fieldInfo.type, value);
+    } else {
+      result[fieldId] = value;
+    }
+  }
+  
+  return result;
+}
+
+/**
+ * 解析字段值
+ */
+function parseFieldValue(fieldType, value) {
+  if (value === null || value === undefined) return null;
+  
+  switch (fieldType) {
+    case 'text':
+      return String(value);
+    case 'number':
+      return Number(value);
+    case 'single_select':
+      return value?.name || value;
+    case 'multi_select':
+      return Array.isArray(value) ? value.map(v => v.name || v) : [value];
+    case 'date':
+      return value?.start || value;
+    case 'person':
+      return Array.isArray(value) ? value.map(p => p.id || p) : [value];
+    case 'checkbox':
+      return Boolean(value);
+    default:
+      return value;
+  }
+}
+
+module.exports = {
+  getEnvVar,
+  getAccessToken,
+  validateRequired,
+  parseJsonInput,
+  formatDate,
+  delay,
+  paginate,
+  buildFieldValue,
+  parseRecordFields,
+  parseFieldValue
+};