命令行 (CLI)

这是什么？

OpenCode CLI（命令行接口）允许用户通过单行命令快速调用 AI 能力。它适用于脚本自动化、管道操作（Piping）或快速且无需持续上下文的简单查询任务。

什么时候你会用到它？

• 当你希望将 OpenCode 的输出作为另一个命令的输入（例如生成 git commit message）时。
• 当你需要快速查询某个 Linux 命令的用法，而不想进入交互式界面时。
• 当你编写 Shell 脚本，需要集成 AI 处理步骤时。

核心概念

• 无状态执行：默认情况下，每次 CLI 调用都是独立的，不保留上一次的对话历史（除非显式传递上下文）。
• 标准输入/输出 (Stdin/Stdout)：完全遵循 Unix 管道哲学，能够处理文本流。
• 参数标记 (Flags)：通过 -m, -f 等参数指定使用的模型或读取的文件。

基本用法 / 配置说明

TODO：后续补充具体用法示例

常见误解 / 注意事项

• CLI 模式不适合处理需要多轮对话来澄清需求的复杂任务，这种情况建议使用 TUI。
• 使用管道传输大量代码时，需注意 Tokens 限制。

延伸阅读

TODO：后续补充