| name | crater-cli-shared |
| version | 1.1.1 |
| description | Crater CLI 共享基础：安全调用 crater 命令的通用规则，包括可执行文件选择、全局选项、列表分页、--json、--no-interactive、--help、错误输出、退出码、错误场景判断、API 兼容性诊断、敏感信息处理，以及执行会修改用户环境的命令前的确认规则。处理任何 Crater CLI 操作前使用。 |
| metadata | {"requires":{"bins":["crater"]}} |
Crater CLI 共享规则
通过 crater 命令帮助用户操作 Crater 平台时，先遵守本共享规则。
CRITICAL — 处理任何 Crater CLI 操作前，先读取本文件。
基础规则
- 不要要求用户把密码、token、cookie 或 Keyring 内容发到聊天里。
- 执行会修改用户本地状态或平台资源的命令前，必须确认用户意图。
- 默认调用已安装的
crater；如果用户说明正在本地开发、测试或验证刚编译出的 CLI，则优先调用工作区内的二进制，例如从仓库根目录使用 ./cli/crater，从 cli/ 目录使用 ./crater。
- 当本地 CLI 版本可能变化、选项不确定或用户要求精确用法时，先用所选可执行文件运行
<command> --help 查看当前帮助。
- 脚本化读取结果时优先使用
--json，从 stdout 解析成功数据。
- 列表命令提供
--page / --page-size 时，默认每页 15 条；按 data.pagination.total 判断是否还有下一页。只有任务明确需要全部记录时才使用 --all-pages。
- 失败信息从 stderr 读取；脚本和 AI 判断应优先使用结构化字段，不要依赖自然语言错误文案。
全局选项
常用全局行为见 references/crater-cli-global-flags.md。
错误排查
错误分类、退出码与 HTTP 错误码约定见 references/crater-cli-error-handling.md。
API 版本不一致是命令失败的低概率原因。先根据原命令的错误排查参数、配置、认证、网络、权限、平台状态和 CLI 自身缺陷；只有常见原因无法解释问题，或现象明显指向 API 契约差异时，才运行 crater compatibility 与目标后端握手。兼容性结果的简要解读和后续处置也见上述错误排查 reference。
安全边界
- 不要静默添加
--yes / -y 来跳过确认；只有用户明确同意跳过确认或明确要求非交互执行时才使用。
- 不要把用户提供的自由文本拼进 shell 字符串执行；需要执行命令时应保留参数边界，避免 shell 注入。
- 普通交互登录时，让用户在本机终端输入密码；不要让用户把密码发到聊天里。
