SuperAPI AI 工具集

ct

部署与运维

查看项目

更新于 10-15 20:14

技能介绍

ct 是 CommonTools 的命令行工具,用于与 pieces、patterns 和 Common Fabric 交互,适合部署 pattern、管理 piece 及调试。

主要能力:类型检查(ct check)、部署新 piece(piece new)、更新已有 piece(piece setsrc)、查看状态(piece inspect)、读写字段(piece get/set)、调用 handler(piece call)、触发重算(piece step)、列出 pieces(piece ls)和可视化(piece map)。

使用方式:多数操作需要身份密钥,可用 deno run -A packages/cli/mod.ts id derive "implicit trust" > claude.key 生成本地开发密钥,或用 id new 生成随机密钥。注意不要用 deno task ct id new > file 重定向,因为会混入 ANSI 输出。可通过环境变量 CT_API_URL 和 CT_IDENTITY 避免重复传参。首次部署用 piece new,之后迭代一律用 setsrc 原地更新,避免产生重复 piece。set 和 call 都不会自动重算,必须随后执行 piece step 才能获取最新计算值。所有 set/call 的输入必须是合法 JSON。

限制与注意:实验性功能需在服务端和 CLI 同时设置对应环境变量;命令挂起时检查 Tailnet 连接;密钥文件权限问题可用 chmod 600 修复。更多细节参见官方文档。