同一份 HTML，同时服务搜索、AI 答案与浏览器代理。

# 跨平台 AI 终端工具开发与架构设计

Source: https://www.5173z.com/case-studies/cross-platform-ai-terminal-arch

做跨平台 AI 终端工具，架构上拆四层：提示与会话状态、工具执行沙箱、模型供应商适配、以及终端绘制。Windows / macOS / Linux 的差异应停在伪终端、路径和凭据存储，不要渗进会话逻辑。配置用同一份 JSON schema。测试至少覆盖：无 TTY 的非交互、路径分隔符、以及信号中止。OpenCode 这类产品是这一形态的参照，而不是必须抄的实现。

- 会话 / 工具 / 供应商 — 核心
- PTY / 路径 / 凭据 — 薄层
- 无 TTY + 中止 — 测试

密钥存储用各系统官方钥匙串 / 凭据管理器，不要自己发明加密文件格式。

## layers 四层

- 会话：消息、压缩、权限。
- 工具：超时、工作目录、输出截断。
- 供应商：重试、流式、模型 ID。
- UI：TUI 或纯日志。

## takeaway 要点

- 业务逻辑不进平台 ifdef。
- 同一份配置 schema。
- 无 TTY 必须能跑。

跨平台 AI 终端工具开发与架构设计

高森模型产品
齐岚开发者体验

发布时间：2026 年 9 月 22 日

做跨平台 AI 终端工具，架构上拆四层：提示与会话状态、工具执行沙箱、模型供应商适配、以及终端绘制。Windows / macOS / Linux 的差异应停在伪终端、路径和凭据存储，不要渗进会话逻辑。配置用同一份 JSON schema。测试至少覆盖：无 TTY 的非交互、路径分隔符、以及信号中止。OpenCode 这类产品是这一形态的参照，而不是必须抄的实现。

会话 / 工具 / 供应商 核心
PTY / 路径 / 凭据 薄层
无 TTY + 中止 测试

密钥存储用各系统官方钥匙串 / 凭据管理器，不要自己发明加密文件格式。

四层#

会话：消息、压缩、权限。
工具：超时、工作目录、输出截断。
供应商：重试、流式、模型 ID。
UI：TUI 或纯日志。

要点#

业务逻辑不进平台 ifdef。
同一份配置 schema。
无 TTY 必须能跑。

该内容对您有帮助吗？

如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据Apache 2.0 许可获得了许可。插图为站点原创。

最后更新时间：2026-09-22。