稳如磐石的 Agent 底座 · DSH 的 TUI 客户端 · Rust 单文件
Why CLAT
CLAT 把模型接入你的终端:读代码、改文件、跑命令都在本地完成,每一步操作可见、可控、可审计。
会话以 append-only 日志落盘,配置、密钥与信任状态存本地 JSON 文件(~/.clat)。没有云端依赖,数据不出你的机器。
Rust 编译的单文件可执行程序,无运行时、无依赖安装。macOS、Linux 与 Windows 六个平台开箱即用。
进入新目录先过信任门;权限分只读、项目写入、完全访问三档可切换,默认档位下写文件、执行命令逐次询问,路径不出项目根。
Positioning
Spring、DeepSeek Harness 与 CLAT 共享同一个「组装式容器」的器官——把系统拆成可声明、可组合的部件(这一思想可上溯到 IoC 与 OSGi 运动)——却服务不同的用户、走向不同的方向。下表帮第一次接触 CLAT 的你快速定位。
| Spring | DSH | CLAT | |
|---|---|---|---|
| 定位 | 企业级 Java 应用框架 | 「一切皆插件」的 Agent 运行时 | 稳如磐石的 Agent 底座 |
| 用户 | 构建应用的程序员 | 驱动 agent 的开发者与模型自身 | 追求本地优先、单二进制、可审计的用户 |
| 容器哲学 | 让程序员忘记容器的存在 | 让运行时随时可改写 | 让用户能够审计容器 |
| 组合时机 | 编译期 / 部署期 | 运行期 | 编译期(静态清单),扩展经 MCP 外移 |
| 扩展方式 | jar + 接口 | 进程内 TypeScript 插件 | MCP 协议 + 门控 WASM |
Spring 让程序员忘记容器,DeepSeek Harness 让模型改写容器,CLAT 让用户审计容器。如果你想要的是一个稳、小、看得见的 Agent 底座——那就是这里。
Features
01 — 模型
DeepSeek、GLM、Qwen、Kimi、Tencent Hy 官方预设内置,任意 OpenAI 兼容端点同样能用。/model 打开两级选择器:先选厂商,再选模型,密钥按厂商分槽保存。
02 — 多模态
Ctrl+V 直接粘贴截图,拖入路径或 /paste-image 读取剪贴板,图片以结构化附件进入消息,TUI 与 Web 工作台同步展示;内置 view_image 工具让模型自己查看项目里的图片。GLM 5.3 Flash 与 DeepSeek Vision 预设原生看图,模型能力不符时明确报错,绝不静默降级。
03 — 交互
模型遇到该由你拍板的事会停下来提问;运行中也能随时插入转向消息,改变当前任务的方向。思考过程内联为可折叠的 Think 行(Ctrl+R 展开),/suggest 按需生成下一条消息的提示预览,采纳后才会发送。
04 — 运行
轮次没有上限,任务跑完为止;上下文用到八成自动压缩摘要,原始历史完整保留。
05 — 权限
只读、项目写入(默认)、完全访问三档随时切换:/perm 或权限弹窗内一键换档、可临时提权,按项目记忆。低两档下写文件、跑命令仍逐次审批。
06 — 集成
MCP 服务器支持 stdio 与 Streamable HTTP 远程传输;GLM Coding Plan 自动挂载官方四台 MCP 服务器,/mcp 查看连接状态与已注册工具。
07 — 智能体
记忆由你显式管理:/memory 按项目或全局存放知识,模型只读检索,绝不自动把对话写成记忆;/goal 为会话设定带轮数、令牌、时长硬上限的目标,可指定验收条件自动完成;/subagents on 派出只读子代理并行探索代码,用量全额计入父会话。
08 — 持久化
完整对话写入 append-only 日志,先落盘再调用模型,崩溃后自动恢复到最近的完整批次;日志为 DSH 兼容格式,可被兼容工具直接读取,旧格式会话经 /update 一键升级。模型自动起标题,/rename 随时改。
09 — 技能
技能分项目 .clat/skills/、用户、内置三层,模型按名加载技能说明与参考资源(/skill 可直接调用),加载只读、绝不执行代码;配置 ~/.clat/lsp.json 后,模型获得只读 LSP 能力——定义、引用、实现、悬停精确导航。
10 — 插件
签名插件市场 pi.at.cn 已上线:clat plugin 一条命令浏览、安装、更新与回滚,依赖解析、发布者核验、能力审查全部内置;WASM 组件与 MCP 服务共用一套管理器,并与 DSH 插件生态互通。
11 — 生态
一条 clat dsh 连上本地 DSH 宿主,CLAT 界面就成为它的终端:DSH 的会话、提问与审批都在同一套 TUI 里完成,断线自动重连;对 ~/.dsh 只读不写,一切经官方 API 交互。
12 — 前端
clat 启动的是后台宿主:TUI、Web 工作台、微信遥控都作为客户端挂接同一批会话,关掉 TUI 宿主照常运行,任务不断线;宿主常驻 127.0.0.1:2691,新版 CLAT 会自动平滑替换闲置的旧宿主,浏览器页面原地重连。
Get started
推荐用一键脚本:自动识别平台、下载 Release 二进制、验证 Minisign 签名与 SHA-256 后放入 ~/.local/bin(Windows 为 %LOCALAPPDATA%\Programs\clat)。预装校验需要 minisign(macOS:brew install minisign);没有预编译产物时回退到源码构建。
也可以从 Releases 页面下载对应平台的二进制,放入 PATH 即可。已安装用户用 clat upgrade 自更新。
| 平台 | 资产 | 架构 |
|---|---|---|
| macOS | clat-v*-aarch64-apple-darwin.tar.gz | Apple Silicon |
| macOS | clat-v*-x86_64-apple-darwin.tar.gz | Intel |
| Linux | clat-v*-x86_64-unknown-linux-gnu.tar.gz | x64 |
| Linux | clat-v*-aarch64-unknown-linux-gnu.tar.gz | ARM64 |
| Windows | clat-v*-x86_64-pc-windows-msvc.zip | x64 |
| Windows | clat-v*-aarch64-pc-windows-msvc.zip | ARM64 |
Linux 产物要求 glibc 2.39+(Ubuntu 24.04 同代及以上),更老的发行版请从源码构建。解压后先 clat --help 看一眼,进入项目目录运行 clat,首次会请求信任该目录。脚本安装同理,装完直接运行 clat 即可。