#开始使用 ash

ash 是为 Coding Agent 设计的 AI Native Shell。它接收类型化 ASH/1 请求， 在有界的 Tokio I/O 与 Rayon CPU 平面中运行，最后返回带可取回证据的规范 ASON， 而不是面向人类排版的终端文字。

#选择你的阅读路径

#选择入口

#运行规范请求

创建 request.ason，在 src 中搜索字面量 TODO：

t:1
i:17
o:g
a{q,p,f}:
TODO,[src],0
u{tok,rec,ms}:
256,64,30000

ash run < request.ason

信封顺序是精确契约：消息类型、正请求 ID、操作、类型化参数，最后是 Token、记录和 时间预算。响应同样是规范 ASON。错误只包含稳定诊断码和类型化字段，不输出颜色、 进度条或说明性建议。

#一个请求如何流动

1. 将规范 ASON 解码为类型化 ASH/1 语义 IR。
2. 校验能力、预算、路径、摘要与任务图结构。
3. 在同一 Governor 下，把 I/O 调度给 Tokio，把可拆分 CPU 工作调度给 Rayon。
4. 稳定归并并发结果，并在需要时保留完整证据。
5. 发出最小但诚实的 ASON 投影；需要更多内容时沿引用继续取回。

完整能力地图列出十五个操作、运行保证、事务恢复、输出存储、 交付、测试证据与明确非目标。仓库内置的 Coding Agent Skill则把这些契约变成可复用的编码工作流。