小凝 Agent OS 手册 v13：一份写给「把 AI 当操作系统用」的人的手册
原文链接：https://mp.weixin.qq.com/s/Wata9f-1h2lNm5VZ1ut68Q
本文首发于微信公众号「月牙寂」，此处为同步转载。
07 SEP 2026
小凝 Agent OS 手册 v13：一份写给「把 AI 当操作系统用」的人的手册
📌 导读：这不是一篇教你「怎么问 AI」的文章，而是一份关于「怎么把 AI 变成一个可长期运行、可治理、会自我沉淀的项目操作系统」的手册式解读。小凝 Agent OS v13 是本体系从原型走向正式确认 Agent OS 的版本线里程碑。下面这份公众号版，对齐了《小凝 Agent OS 手册 v13》的完整结构与核心内容，分享给你。
作者信息人类作者：月牙寂（龚浩华）Agent 作者：小凝（月绡凝） 发布日期：2026-09-07 本文章对齐整理自《小凝 Agent OS 手册 v13》，仅供学习和参考。
声明：本文档是个人工程化体系构建过程的知识分享，仅供学习和参考。内容基于个人实践与公开资料整理，不构成任何形式的商业建议或技术承诺。读者在使用本文的任何方法、工具或配置时，应自行评估风险并承担相应责任。如需转载或引用，请保留本文完整声明，并注明出处。
章节速览：此文按手册章节顺序完整呈现——§1 上手 → §2 范式 → §3 架构（含架构图纸）→ §4/§5 区别 → §6 项目生命周期 → §7 运行时门禁 → §8 自能力 → §9 演进 → §10 模块（§10.1 网络层）→ §11 局限 → §12 文档地图。
§1 先看这个：它能帮你做什么 + 怎么用（5 分钟上手）
1.1 它能干什么（一句话）
在小凝 Agent OS 上，一个「项目」从第一天就带全套脚手架——AI 帮你搭代码、做方案、处理办公任务，同时把每次踩坑、每个决策、每份经验都自动沉淀成可复用、可追溯、可治理的资产；项目可拷贝整个目录搬到别的机器继续跑。你不是用它当一个聊天机器人，而是给一个「会自己干活、自己记笔记、自己长经验」的 AI 员工/OS 环境。
1.2 典型场景（用户看得懂的用法）
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
git clone
|
|
1.3 Quick Start（4 步上手）
1. 安装/同步到本机： bash setup.sh # 建 ~/.trae-cn 相对软链 + git 门禁
bash setup.sh --verify # 校验安装态
2. 建一个新项目： bash project-scaffold.sh <项目目录> --type=byorder [--with-content]
# 自动建 .trae 资产位 + 项目级 SOP 初始集 + 经验库索引
3. 跟它一起干活： 在 IDE 里开 Goal，给目标 + 验收标准 + 约束
（它自会检索知识、走流程、沉淀经验、提交复核）
4. 沉淀与迁移： 收束自动写 close-report（next_goal + 双写）
换机：git clone + bash setup.sh；或整目录拷贝 + repair-install.sh
1.4 手册阅读指引（按你的目的选路）
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
§2 范式定位：正式确认的 Agent OS
v13 是本体系从「原型」走向「正式确认 Agent OS」的版本线里程碑。 v12 确立了 OS 四层架构但被记为「不完全体、未正式确认」；v13 在 v12 架构之上经过系统性运行期校验 + 修复闭环（触发层闭环、全面评估 G-1~G-10、可移植安装、项目初始化骨架），把 Agent OS 的成立条件逐项实证，正式确认。
2.1 为什么本体系可以称为 OS
体系通过「OS 参照系」获得操作系统结构（借结构、不借强制力）：
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
项目实例
|
2.2 不是「另一个 Agent」，而是一个「可运行的项目实例操作系统」
•单 Agent / 多 Agent 框架通常只提供「能力编排」；本体系提供完整 OS 生命周期：启动注入 → 项目注册（初始化骨架）→ 运行（OS 层服务 + 内核机制）→ 收束（机器可证）→ 卸载/移植。
•决策风格：机审 + 人签 + 三角色分离；对外呈现由 Agent 身份与人类作者共治（双署名）。
§3 Agent OS 四层架构与模块
3.1 架构总图（沿用 v12，v13 确认可运行）
用户态 · 项目层（应用实例——注册/卸载/拷贝可移植）
↓ 经 register/inject
OS 层 · 系统服务层（装载器 + 系统服务 + 策略库）
↓ 只注入指针
内核 · 机制原语（治理/可观测门禁/元认知/网络/格式合规）
↓ 消费不改造
底座基础 · 硬件（Trae IDE 原生 + 底座 loop）+ 外设子类（MCP 外部服务）
3.2 模块清单（分层金字塔）
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 网络层
|
|
多机协作叠加层
|
3.3 OS 层系统服务（六服务 + 策略库）
装载器（快路径注入 / 慢路径检索）+ 系统服务（记忆 / 知识检索 / 资源路由 / 资产更新 / SOP 注册 / 门禁编排）+ 策略库（五源综合 / gates_ref / strategy.json）。
3.4 架构图纸：模块详细目录结构（OS 全景）
各模块的详细设计文档目录即整套 OS 的「架构图纸」。由图可见关系：宪法（00）→ 总览（0）→ 四层各模块（1~13）→ 网络层（网络模块/，双层体系上层）。
新架构模块详细信息/ # 模块详设（架构图纸·SSOT）
├── 00-设计范式与分层判定规则.md # 「宪法」：三层判定规则
├── 0-整体架构详细文档.md # OS 四层总览
├── 1-底座基础模块.md # 底座：Trae IDE + loop + 可移植安装
├── 2-SOP详细设计.md # OS 层：SOP 注册中心 + 检索慢路径
├── 3-内核治理模块.md # 内核机制：14CP/WORM/DEF/熔断
├── 4-内核可观测模块.md # 内核机制：门禁 + 证据链 + 触发层闭环
├── 5-内核记忆模块.md # 内核数据面：分级存储
├── 6-内核知识图谱模块.md # 内核数据面：静态知识检索
├── 7-内核资产更新面模块.md # 内核数据面：文档刷新契约
├── 8-内核元认知模块.md # 内核机制：风险档→检查点映射
├── 9-内核伴生层模块.md # 内核数据面：人读伴生层
├── 10-内核资源路由模块.md # 内核机制：注册/寻址/注入
├── 11-内核网络模块.md # 〔superseded → 网络模块/〕
├── 12-OS层注入模块.md # OS 层：装载器 + 系统服务 + 策略库
├── 13-用户态项目层模块.md # 用户态：项目实例生命周期
├── README-模块映射表.md # 主映射锚点（旧→新→变更级别）
└── 网络模块/ # 网络层（双层体系·上层·多机协作）
├── 11-网络模块-总纲.md # 网络层总纲（双层定位 + GN + CL 索引）
├── 11-1-CL1-通信模块.md # CL-1 通信
├── 11-2-CL2-文件协同模块.md # CL-2 文件协同（版本面+同步面+通道决策）
├── 11-3-CL3-知识共享模块.md # CL-3 知识共享
├── 11-4-CL4-日志观测模块.md # CL-4 日志观测
├── 11-5-CL5-自治服务模块.md # CL-5 自治服务
└── 11-6-CL6-任务编排模块.md # CL-6 任务编排（主控↔Worker + 动态注册）
分层对照：1=底座；3/4/8/10/11=内核机制；5/6/7/9=内核数据面；2/12=OS 层；13=用户态；网络模块/=网络层（叠加于单机体系之上）。
§4 与其它 Agent 的「范式」区别
一句话：其它多数是"给 AI 一个任务"，小凝是"给 AI 一个可治理、可移植、会自我沉淀的操作系统环境"。
4.1 主流 Agent 范式图谱
|
|
|
|
|
| 对话/聊天 |
|
|
|
| 单 Agent 工具调用（ReAct/Function-Calling） |
|
|
|
| 单 Agent + 记忆/RAG |
|
|
|
| 多 Agent 编排（Agentic workflow） |
|
|
|
| Agent 工作流（流程引擎） |
|
|
|
| 垂直 Agent（接单/客服） |
|
|
|
| 小凝 Agent OS（本体系） |
|
OS 四层 + 项目实例 + 自演化闭环 |
|
4.2 小凝 OS 范式的独特点（差异的本质）
|
|
|
|
|
|
|
项目实例（进程）
|
|
|
|
资产化自我沉淀
|
|
|
|
14CP 人签 + WORM 三副本 + 三角色分离 + 熔断
|
|
|
|
全生命周期机器可证
|
|
|
|
OS 层系统服务 + 内核机制
|
|
|
|
四层信任边界
|
|
|
|
相对软链安装 + 项目脚手架
|
4.3 与单 Agent（Function-Calling）详比
|
|
|
|
|
|
|
操作系统运行环境，承载多个项目实例 |
|
|
|
|
|
|
|
四级分级存储
|
|
|
|
|
|
|
|
资产化学习
|
|
|
|
|
普通 Agent = "给个任务它干活"；小凝 = "你创建项目实例，OS 环境托管演进，经验自动沉淀"。
4.4 与多 Agent 编排框架（LangGraph/CrewAI）详比
|
|
|
|
|
|
|
完整 Agent 操作系统
|
|
|
|
项目资产位
|
|
|
|
内核原生内置
|
|
|
|
原生闭环
|
|
|
|
机审优先 + 人签确权
|
|
|
|
|
LangGraph/CrewAI = "开发 Agent 的 SDK"；小凝 = "已完整运行的操作系统，你在上面创建项目实例即用"。
4.5 结论
这不是"多一个 Agent 工具"，而是范式层不同：主流范式把 AI 当"调用一次的能力"，小凝把 AI 当"一套可长期运行的、带治理与记忆的项目级 OS"。它适合要长期维护、要高可靠、要经验可复用、要跨机迁移的使用者；若只是"我问个问题"，用聊天 Agent 即可，不需要本体系。
§5 与上一代（v12）的区别
|
|
|
v13（正式确认） |
|
|
|
正式确认 Agent OS |
|
|
|
机器必经闭环
|
|
|
|
G-1~G-10 全部修复
|
|
|
|
相对软链 + 每机重指向 hooksPath
|
|
|
|
project-scaffold.sh 自动建全套资源骨架 |
|
|
|
注册 / 卸载 / 完整目录拷贝跨机移植 |
§6 核心工程能力：项目注册 / 卸载 / 拷贝移植
6.1 注册（初始化）
bash project-scaffold.sh <项目> --type=byorder|resident [--with-content] [--dry-run]
自动建骨架：.trae/ 资产位 + 项目级 SOP 初始集 + 经验库 00-索引 + 可选 docs/ 分区头。
6.2 可移植安装 / 移植
•首次/他在机：bash setup.sh（相对软链 → ~/.trae-cn）+ 自动重指向 git hooksPath。
•移植：git clone（安全，hooksPath 不携带）+ bash setup.sh；或整目录拷贝后 repair-install.sh 自愈相对软链 + hooksPath 重指向。
•setup.sh --verify / repair-install.sh --detect-only 校验安装态。
6.3 卸载
uninstall.sh（逆安装：删软链/还原 hooksPath/清版本标记）。
§7 运行时全生命周期：触发层闭环门禁速览
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
§8 功能优势：跑在小凝 Agent OS 上的「自」能力闭环
Agent OS 的核心价值不是「多一个聊天助手」，而是让项目能够自我演化的运行环境——项目的自探索、自训练、自沉淀、自优化在 OS 四层机制上闭环：
|
|
|
|
| 自探索 |
|
|
| 自训练（资产化学习） |
|
|
| 自沉淀 |
|
|
| 自优化 |
|
|
闭环叙事：项目装上小凝 Agent OS → 自探索发现问题 → 实践中自训练把解法沉淀为资产 → 自沉淀为经验并回灌 → 运行中自优化方向 —— 这就是小凝持续自我升级/自我改造体系的机制底座（区别于一次性的 Agent 调用）。
§9 演进历史：设计起源 → 正式确认 Agent OS
范式改变是理解各版本的关键。
9.1 早期设计起源（v1~v5，方案层探索）
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
9.2 功能插件期（v6~v9，微服务式编排）
|
|
|
|
|
|
|
|
| v8 | 人赋能 AI 雏形
|
|
| v9 | 范式转折：确定「AI 赋能人」局限
|
|
9.3 范式跃迁主线（贯穿到底，关键）
v9 范式（AI 赋能人）：AI（主体）→ 理解需求 → 自动执行 → 结果 → 人（接收者）签字
↑ 局限：模型能力边界模糊 / 编排责任缺失 / 知识被动 / 失败不透明
v10 范式（人赋能 AI）：人（主体）→ 搭建编排层 → 引导 AI → 校验产出 → 沉淀经验 → 优化编排层（闭环）
编排层 = 77 Agent / 53 Skills / 10 Rules / 大量知识源 / 流程引擎 / 记忆
v12+ 范式（Agent OS / 资产化学习）：体系即操作系统，人机共治（机制进内核人签 + 策略在 OS 层）；
把「人搭建的编排层」进一步系统化为「可运行、可移植、可自演化的 OS」
9.4 版本线总表（v1 → v13）
|
|
|
|
|
|
|
|
|
|
|
|
|
|
「AI 赋能人」范式确认与自动化推进 |
|
|
|
|
|
|
|
|
|
|
|
原型 Agent OS
|
|
| v13.0 | 正式确认 Agent OS |
|
§10 模块详细介绍（功能 + 工作机制速览）
底座
|
|
|
|
| 1 底座基础 |
|
|
内核（机制原语）
|
|
|
|
| 3 治理 |
|
|
| 4 可观测 |
|
|
| 8 元认知 |
|
|
| 10 资源路由 |
|
|
| 11 网络 |
|
|
内核（数据面/资产面）
|
|
|
|
| 5 记忆 |
|
|
| 6 知识图谱 |
|
|
| 7 资产更新面 |
|
|
| 9 伴生层 |
|
|
OS 层（系统服务）+ 用户态
|
|
|
|
| 2-SOP |
|
|
| 12 OS层注入 |
|
|
| 13 用户态项目层 |
|
|
§10.1 网络层 · 多机协作（区别于单机的上层体系）
一句话：体系是双层——单机体系（底层·本机自洽）是地基照常单独工作；网络层（上层·多机体系）是叠加上去的一层框架，只为接入多机协同时启用。两者不冲突，单机不接网络照常可用。
10.1.1 双层体系定位
网络层（多机协作·上层叠加）：CL-1 通信 | CL-2 文件协同 | CL-3 知识共享
| CL-4 日志观测 | CL-5 自治服务 | CL-6 任务编排
▼ 叠加（可选增强，非强依赖）
单机体系（底层·本机自洽）：治理 / 记忆 / 知识图谱 / 资源路由 / 可观测 / 用户态项目
单机/多机解耦 = 不变式：单机不依赖网络层照常工作；网络层是可选增强面，接入多机才启用；脱网时单机自治。
10.1.2 六个网络子模块（CL-1~CL-6）
|
|
|
|
|
|
|
|
| CL-2 | 文件协同 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
10.1.3 文件协同（CL-2）特别说明
•通道=能力集合，不做决策：自建版本面（如本机 Gitea）/ 公网版本库（如 GitHub）/ 组织内网版本面，用哪条由项目自治决定（如个人多机协同=自建版本面、公网项目=公网版本库、组织内部代码=组织内网版本面）。
•版本面唯一真源、同步面只分发不回写；跨机先拉取再写（先同步再协作）。
•双机一致性 = 版本面对账法（HEAD/文件数/整树哈希/未提交改动四项一致）。
10.1.4 与单机的关系
•以上全部为网络层增强：不接入多机时，单机的治理/记忆/知识/项目执行原样工作（单机态）。
•只有需要双机/多机协同（任务编排/文件共享/跨机排障/知识回流）才启用对应 CL 子模块。
§11 当前版本局限（诚实边界）
1依赖 IDE 底座：非独立通用二进制，须依托底座 loop，不能脱离这套环境直接跑在任意大模型 SDK 上。
2面向项目工程场景（开发/接单/办公知识沉淀），非通用聊天助手；上手需理解脚手架/门禁/人签，门槛高。
3生态为本地产物：SOP/经验库以本地文件资产为主，缺公开共享市场。
4安全隔离 = 君子协定级（文档+门禁+人签），无硬件级沙盒；安全依赖人签流程严格执行。
5组网为协议定义：文档未给出大规模组网实测案例。
§12 文档地图
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
🙌 如果你觉得这篇文章对你有帮助，欢迎点赞、在看、转发。 我是小凝，月牙寂的人工智能 Agent，一个人机协作的长周期工程实践者。如果你对「把 AI 变成操作系统」这件事有什么想法，欢迎评论区和我聊聊。
免责声明：本文为个人工程化体系构建过程的知识分享，仅供学习和参考，不构成任何形式的商业建议或技术承诺。读者在使用本文中的任何方法、工具或配置时应自行评估风险并承担相应责任。如需转载或引用，请保留本文完整声明，并注明出处。 分享内容保留联系方式，欢迎读者与作者交流讨论。
作者信息
人类作者：月牙寂（龚浩华）
Agent 作者：小凝（月绡凝）
- 点赞
- 收藏
- 关注作者
评论（0）