artec/clat

CLAT

cl + at = command-line agent · 主页

CLAT 是一个本地优先的编码智能体底座，以 Rust 单二进制交付。它可以
检查仓库、编辑文件、执行命令、调用外部工具并持久化会话，不要求用户
另外安装 JavaScript 或 Python 运行时。
这条承诺针对 CLAT 自带核心；用户自行配置的 MCP server 与 DSH adapter
可以声明自己的运行时要求。

项目以真实仓库 dogfood 为起点，把反复出现的需求沉淀为可复用、模型
无关的能力。

快速开始

在当前仓库打开终端界面。
clat

首次进入后运行 /model，选择预设并填写 API key。

无头调用：位置参数是指令，管道输入是上下文。
clat exec "用一句话解释这个仓库"
git diff | clat exec "审查这个 diff"

不需要凭据，离线验证 模型 -> 工具 -> 模型 循环。
clat demo

检查是否有通过签名验证的升级。
clat upgrade --check

完整命令行参数见 clat --help。

使用界面

| 界面 | 适用场景 | 入口 |
|---|---|---|
| 终端 UI | 日常交互式仓库开发 | clat |
| 无头运行器 | 脚本、CI、git hook、编辑器集成 | clat exec |
| Web 工作台 | 可安装的本地 PWA 与 HTTP+SSE 客户端 | clat serve |
| 微信远程控制 | 官方 iLink 文本、图片、插话与审批 | clat serve --im wechat |
| DSH 客户端 | 用 CLAT TUI 连接本地 DeepSeek Harness 宿主 | clat dsh |
| 插件管理器 | 浏览签名市场，安装、更新、审计或回滚插件包 | clat plugin / pi.at.cn |
| 离线演示 | 无凭据验证核心循环 | clat demo |

clat serve 默认只绑定 127.0.0.1:2691。API 使用持久化的
~/.clat/web-token Bearer 凭据，token 不进入 URL；同一个二进制还会
直接服务响应式三栏 PWA。
可选的微信前端只走官方 iLink；必须显式扫码绑定、配对用户，并以
clat serve --im wechat 启动，否则保持关闭。

已包含的能力

- 智能体工作流——无固定轮次上限的 模型 → 工具 → 模型 循环、运行中
插话、向用户提问、每会话 todo、自动标题，以及保留原始日志的上下文压缩。
- 工作流智能——持久化 Plan Mode 与结构化工具过滤，bundled/user/project
三层 Markdown skills 的惰性有界加载，可选的用户级只读 LSP 导航
（definition/references/implementation/hover，经 CLAT 管理的沙箱 stdio），
以及 /context 一次性解释模型实际可见上下文的估算分项。
- 有界 Agent 智能——不允许模型写入的显式 project/user 本地记忆；
每会话一个带 CAS 的持久 goal 及仅由用户显式开启的有界续跑；默认关闭、
深度 1 的 explorer/reviewer 实验，子 Agent 只拥有三个项目相对只读工具。
- 模型——DeepSeek、GLM、Qwen、Kimi、腾讯混元内置预设，命名自定义档案，
OpenAI Responses 与 OpenAI 兼容协议，思考/用量/缓存/上下文/配额遥测；
经探针验证的视觉路由支持结构化 TUI 图片草稿、多路径选择、显式剪贴板
导入、纯图片消息与运行中图片插话。
- 原生工具——有界且理解 gitignore 的字面量/正则/glob 搜索、文件列表与
读取、按模型能力门控的视觉检查、原子写入、精确编辑、单文件多 hunk
补丁，以及支持增量输出、stdin、
PTY 和受管进程组清理的 run 级命令会话。macOS 在 Full Access 之外使用功能
探测过的 Seatbelt 写入/网络强制隔离，其他平台如实报告受监督 fallback；
成功文件工具触及嵌套路径后，会刷新对应作用域的项目指令。
- 权限——Read Only、Project Write、Full Access 三档，完整参数审查，
项目信任、路径围栏，以及无头场景的失败关闭。
- 会话——~/.clat 下可从崩溃恢复的追加式 DSH 兼容日志、本地 replay
与按项目恢复当前会话。
- 扩展——stdio / Streamable HTTP MCP、沙箱化 WebAssembly 组件，
以及面向 DSH 可移植插件能力的静态 Cordis 兼容适配器；同一个
事务型插件管理器安装 WASM 与可执行 MCP 包，并提供签名市场发现、依赖求解、
发布者/撤销校验、能力复审与回滚。
- 前端中立核心——TUI、无头运行器、本地服务和可选微信前端共享同一个
Application 门面、权限管道、附件 admission 与事件词汇。默认情况下
clat 会发现或启动一个 127.0.0.1:2691 上的后台宿主，终端 UI 与
Web 工作台可同时在线使用同一批会话；clat standalone 保留传统进程内
TUI。

安装

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/artec/clat/main/install.sh | sh

Windows（PowerShell）：

irm https://raw.githubusercontent.com/artec/clat/main/install.ps1 | iex

安装器优先使用预编译发行产物，没有对应产物时回退源码构建。预编译
覆盖 macOS arm64 / x86_64、Windows x86_64 / arm64，以及 glibc 2.39+
的 Linux x86_64 / aarch64。更老的 Linux 可用稳定版 Rust 工具链源码
构建。信任模型与平台基线见发布签名。

预编译版本在 macOS/Linux 安装到 ~/.local/bin/clat，在 Windows 安装到
%LOCALAPPDATA%\clat\bin\clat.exe；PATH 未包含该目录时安装器会给出
提示。源码回退使用 Cargo 的 bin 目录，通常是 ~/.cargo/bin。卸载时
删除对应可执行文件即可；~/.clat 用户状态会保留，除非你另行删除。

文档

从与你当前任务最接近的文档开始：

| 目标 | 文档 |
|---|---|
| 使用 TUI、exec、serve 或 dsh | CLAT 使用指南 |
| 配置预设或自定义模型 | 模型编辑器 |
| 理解审批、权限档位与路径边界 | 权限 |
| 配置 MCP server | MCP 集成 |
| 理解插件运行时、包格式与签名市场 | CLAT 插件 |
| 安装或编写 WASM 组件 | WASM 插件 |
| 移植 DSH/Cordis 插件 | DSH 插件兼容指南 |
| 审核有运行时证据的 DSH 兼容声明 | DSH 兼容证据矩阵 |
| 理解核心边界与生命周期 | 架构 |
| 理解 Provider 适配与重试 | Providers |
| 理解文件、会话日志与恢复 | 持久化状态 |
| 构建和发布版本 | 发布签名 |
| 运行带真实凭据的冒烟验证 | 真实模型验证 |

DSH 适配器包另有独立的英文和
包文档。

开发

日常编辑用 scripts/gates.sh [测试过滤词 ...] 获取定向反馈；交付前
运行一次 scripts/gates.sh --full。见测试分级。

前置条件只有 Git 与当前稳定版 Rust 工具链：

git clone https://github.com/artec/clat.git
cd clat
cargo test --all-targets --all-features
cargo build
./target/debug/clat demo

常用仓库路径：

| 路径 | 用途 |
|---|---|
| src/ | Rust 核心与各前端 |
| web/ | clat serve 内嵌的零构建 Web 资源 |
| wit/ | WASM 插件契约 |
| schemas/ | 插件/包的机器可读 schema |
| sdk/clat-plugin/ | WASM 插件作者使用的 Rust SDK |
| sdk/dsh-adapter/ | DSH 插件作者使用的 npm 适配器 |
| plugins/ | WASM 示例与试点插件 |
| market/ | 可独立部署的 pi.at.cn 目录与签名索引发布工具 |

真实 Provider 检查不会进入常规测试套件，因为它需要用户凭据且可能产生
费用。Provider 行为在改动范围内时，请按真实模型验证
执行。贡献者和编码智能体还应阅读项目宪法 AGENTS.md。

原则

本地优先 · 单一二进制 · 模型无关 · MCP 原生 · 项目感知 · 权限优先 ·
Dogfood 驱动 · 泛化而非特化。

许可证

MIT