CLI 参考
update
apothem update 命令的 CLI 参考。
从当前共享配置文件重新安装某个harness适配器配置。
概要
apothem update --harness NAME|all [--profile PATH] [--dry-run]
[--project PATH]
[--quiet|-q] [--verbose|-v]
[--format plain|json] [--json] [--no-color]update 会从当前共享配置文件重新物化harness输出。它使用与 install 相同的配置文件校验、--harness all 选择、项目范围检查、dry-run 行为以及 JSON 信封。
连续式别名 apothem updating 解析到同一处理程序。
选项
| 选项 | 描述 |
|---|---|
--harness NAME | 要更新的harness适配器，或用 all 表示注册表范围的集合（必填）。 |
--profile PATH | 共享配置文件 YAML 的路径。默认为 ~/.config/apothem/profile.yaml。 |
--dry-run | 预览更新而不写入文件。 |
--project PATH | 项目范围harness的项目根目录。当所选harness集合包含项目范围适配器时为必填。 |
--quiet, -q | 抑制信息性输出；仅发出错误。 |
--verbose, -v | 发出额外的诊断输出。 |
--format plain|json | 输出格式（默认：plain）。 |
--json | --format json 的简写。 |
--no-color | 在输出中禁用 ANSI 颜色码。 |
-h, --help | 显示帮助并退出。 |
JSON 输出
{
"status": "success",
"command": "update",
"action": "updated",
"harness": "claude-code",
"profile_path": "C:\\Users\\Example\\.config\\apothem\\profile.yaml",
"project": null,
"files_written": [],
"results": [],
"warnings": [],
"error": null,
"output_path": "C:\\Users\\Example\\.claude\\settings.json"
}--dry-run 返回 status: "dry_run" 和 files_written: []。
示例
apothem update --harness claude-code
apothem update --harness claude-code --dry-run
apothem update --harness all --project . --dry-run --json
apothem Updating --harness claude-code # continuous-form alias
apothem updating --harness claude-code # lowercase variant退出码
| 码 | 含义 |
|---|---|
| 0 | 适配器成功更新，或 dry-run 干净地完成规划 |
| 1 | 预期的校验、配置文件、harness、项目或适配器错误 |
| 2 | 至少一次写入之后的部分批量物化 |
另请参阅
apothem updating— 此命令的连续式别名（此处有文档说明；CLI 接受两种形式）- apothem install — 初始安装
- 更新指南 — 各安装器的更新路径