CLI 使用指南

octopus-cli 以登录用户的身份在当前团队内操作，适用于批量装配、重复交付和脚本化验收。CLI 与 Portal 使用相同权限边界。

历史命令基线：0.1.13

本页基础命令来自产品构建指南的 CLI 0.1.13 历史实测记录。新 FDE Toolkit 未重新验证这些全部命令，以下内容不能当作当前版本保证。它不是所有版本的完整 API 参考。使用前通过 --version 和对应命令的 --help 核对当前版本，避免直接执行不匹配的参数。

安装与登录

npm install -g @syngy/octopus-cli
octopus-cli --version
octopus-cli --help

使用企业提供的真实 Portal 地址，完成授权后选择团队：

octopus-cli auth login --web-url https://<企业Portal域名>
octopus-cli configure team use <teamId>
octopus-cli auth whoami --json

操作前核对 Profile、主机、账号与团队。交付多个企业环境时，使用独立的命名 Profile，避免将配置写入错误团队。

配置命令按对象组织在 configure 下。请求体通常通过 --body-json 或 --body-file 传入；实际字段以当前命令与接口定义为准。

对支持的写操作，先使用全局 --dryrun 检查目标接口、团队和请求体。请求体未出现在预览结果中时，不应继续假设写操作会按预期生效。

不猜测标识

团队、员工、技能、数据应用和项目标识应从已确认环境回读取得。示例中的占位值不能直接执行；不要按名字推断另一个对象的标识。

这是一份使用导览；每个领域的具体子命令应以本机帮助为准。

octopus-cli conversation send --digi-employee-id <digiEmployeeId> --content "<验收输入>" --watch
octopus-cli conversation history <conversationId>

除会话外，还应核对任务、真实数据变化和交付物。不要仅依据文本中的“已完成”判断操作成功。

凭据保留在本地授权配置中，不写进交付脚本或代码库。测试数据与运行证据按企业约定保存。临时交付访问结束后，按约定登出或回收访问权限。

具体应用构建流程见Workbench 应用开发，以其指定的官方 Skill 和当前命令契约为准。资料来源及适用范围见文档基线。

以下限制来自同一版本的实测记录，不能只靠命令是否出现在 --help 中判断可用：

configure skill set add 命令存在，但当时的 dry-run 显示请求体未被转发。手工创建 skillset 使用 Portal；常规装配可使用启用技能装配的流程自动生成。
多文件 Skill 包接口要求表单上传，而当时的 CLI 以 JSON 发送。该版本的多文件包应在 Portal 上传。
市场包装、权益和资源限制等运营后台配置，不属于用户 CLI 的操作范围。

升级后应重新核对 dry-run 与实际小范围验证结果，不将旧版限制直接视为已修复，也不将它们认定为所有后续版本的现状。