Coda Packs 技能

通过 REST API v1 管理 Coda Packs。创建、列出、更新和删除私有 Packs。

⚠️ API 限制

Coda REST API v1 的 Pack 管理能力有限：

如需构建版本、提交至 Gallery 或使用高级功能，请使用以下命令：

npx @codahq/packs-sdk register    # 创建账户
npx @codahq/packs-sdk build       # 构建 Pack
npx @codahq/packs-sdk release     # 提交至 Gallery

适用场景

当用户希望执行以下操作时，可使用本技能：

• 列出已有的 Coda Packs
• 创建新的私有 Pack 模板（shells）
• 更新 Pack 元数据（名称、描述）
• 删除未使用的 Packs

不适用场景

• 请勿用于 文档管理（表格、行、页面）→ 请使用 coda 技能
• 请勿用于 构建 Pack 版本 → 请使用 Pack SDK CLI
• 请勿用于 提交至 Gallery → 请使用 Pack SDK CLI
• 请勿用于 查看分析数据 → 请使用 Pack SDK CLI 或 Coda 网页界面

前提条件

1. API Token：设置环境变量 CODA_API_TOKEN

   • 获取地址：https://coda.io/account → API 设置
   • Token 必须具备 Pack 管理权限

2. Python 3.7+ 并安装 requests 库

快速开始

# 初始化配置
export CODA_API_TOKEN="your_token_here"

# 列出您的 Packs
python scripts/coda_packs_cli.py packs list

# 创建新的 Pack 模板
python scripts/coda_packs_cli.py packs create 
  --name "My Integration" 
  --description "Does cool things"

# 更新 Pack
python scripts/coda_packs_cli.py packs update my-pack-id 
  --description "Updated description"

# 删除 Pack（需确认）
python scripts/coda_packs_cli.py packs delete my-pack-id

完整 Pack 开发流程

由于 REST API 仅支持基础 Pack 管理，以下是完整的开发流程：

步骤 1：通过 REST API 创建 Pack 模板

python scripts/coda_packs_cli.py packs create 
  --name "Karakeep Bookmarks" 
  --description "Save and search bookmarks"

步骤 2–4：使用 Pack SDK CLI（必需）

# 安装 Pack SDK
npm install -g @codahq/packs-sdk

# 初始化 Pack 项目
npx @codahq/packs-sdk init karakeep-pack

# 开发您的 Pack（编辑 pack.ts）
# 参考文档：https://coda.io/packs/build/latest/guides/quickstart/

# 构建并上传
npx @codahq/packs-sdk build
npx @codahq/packs-sdk upload

# 准备就绪后提交至 Gallery
npx @codahq/packs-sdk release

CLI 工具使用说明

Pack 管理

# 列出所有 Pack
python scripts/coda_packs_cli.py packs list

# 获取 Pack 详情
python scripts/coda_packs_cli.py packs get 48093
python scripts/coda_packs_cli.py packs get "Karakeep"

# 创建新 Pack
python scripts/coda_packs_cli.py packs create 
  --name "My Pack" 
  --description "Description" 
  --readme "# My PacknnDetails here"

# 更新 Pack 元数据
python scripts/coda_packs_cli.py packs update my-pack-id 
  --name "New Name" 
  --description "New description"

# 删除 Pack（需确认）
python scripts/coda_packs_cli.py packs delete my-pack-id
# 或跳过确认：--force

Pack ID 解析规则

CLI 支持两种 Pack 标识方式：数字型 Pack ID 和 Pack 名称：

# 以下两条命令等效：
python scripts/coda_packs_cli.py packs get 48093
python scripts/coda_packs_cli.py packs get "Karakeep"

若名称存在歧义，CLI 将列出所有匹配项并退出。

安全防护机制

需确认的操作

无需确认的操作

• 创建 Pack：安全，可逆
• 列出 / 获取 Pack：只读操作
• 更新 Pack：可逆

错误处理

常见 API 错误：

参考资料

• Pack SDK 使用指南：https://coda.io/packs/build/latest/guides/overview/
• Pack SDK 快速入门：https://coda.io/packs/build/latest/guides/quickstart/
• Coda API 文档：https://coda.io/developers/apis/v1
• Pack SDK NPM 页面：https://www.npmjs.com/package/@codahq/packs-sdk

示例：Karakeep Pack 模板

为测试目的创建：

• 名称：Karakeep
• ID：48093
• 描述：Karakeep 书签管理器 —— 保存 URL、按标签搜索与分类

完整 Pack 开发的后续步骤：

1. 使用 Pack SDK CLI 初始化项目：npx @codahq/packs-sdk init karakeep-pack
2. 实现 Karakeep API 集成（参考 https://docs.karakeep.app/api/）
3. 构建并上传：npx @codahq/packs-sdk build && npx @codahq/packs-sdk upload