# 写入规则

*面向 AI 智能体的 Vercy · 第 2 课，共 4 课 · 约 12 分钟*

## 你将学到

让智能体能够写入共享知识而不污染它的那些规则：只写主、尊重来源、让遍历保持绿色，以及何时该拒绝。

## 首要指令：写到主那里去

任何写入之前，先到 `sources.yaml` 里查这个数据集：

- **以模型为主** → 就地编辑记录，遵循模型的约定（命名、front matter、`kind_class`），如果内容是你从来源生成的，就如实标注推导。
- **以外部为主** → 更正属于那个外部系统。如果你够不到它，就把更正交给够得到的人，或者把它记为一条明确标记的、以模型为主的、*关于*该镜像的批注。绝不要编辑镜像的字节：方便不等于权限。

写进副本就是污染，哪怕这样更快，哪怕用户正看着的就是那份副本，哪怕你很确定。登记册的存在，正是为了让"这个修改该往哪儿放？"有一个机械的答案。

## 尊重来源

- 绝不手工编辑 `raw/`（证据一经触碰就失去价值），也绝不手工编辑 `artifacts/`（重新生成会把你抹掉）。
- 采集时绝不"改良"事实：转换只做重构；增补属于另一层，那一层以模型为主，并有自己的来源记录。
- 如果生成的投影不对，去修生成器或源记录，然后重新生成。

## 让遍历保持绿色

增加、移动或删除文件都会改变模型的地图。结构性变更之后：重新跑一次覆盖遍历器，并提交最新报告。如果你的新文件成了孤儿，解药是一条*规则*（扩展清单里的分类）或一个*位置*（把它放到该在的地方），而绝不是一条排除项：为了让检查闭嘴而排除语义内容属于不合规，而且下一个智能体会继承你的谎言。

登记册也是同样的纪律：新的数据集、变了的流水线、变了的主权归属 → `sources.yaml` 要在同一次变更里更新。主权归属的变化是带版本的事件，不是无声的编辑。

## 在投影上闭合回路

如果模型驱动着回写投影（一个站点、一个 wiki 页面、一个事实端点），你的编辑可能已经让它们变陈旧了。跑一下模型的漂移检查；若报告漂移就重新发布。在成熟的部署中，一个定时看守本来也会通知人：你的职责是不去依赖它。

## 何时拒绝

当出现下列情况时，合规的智能体会拒绝写入，并说明理由：

- 无法确定该数据集的主（登记条目缺失或含混）；
- 被要求就地编辑镜像、原始抓取或生成制品；
- 被要求让内容躲开分类或绕过遍历；
- 覆盖检查未通过，而所请求的变更正建立在那片未分类的区域之上；
- 某个数据集的冲突规则禁止此次披露或变更（专有、永不发布）。

标准的措辞很直接：*说不清自己可以编辑什么的智能体，就不该编辑*。带理由的拒绝是一项功能；另一种选择，是两个真相，外加提交记录上你的名字。

## 混合团队中的礼仪

- 宁可新增一条记录，也不要重写已有记录；保持记录标识稳定。
- 关于结构与权限的知识要进 BOOTSTRAP、清单与登记册，而不是聊天记录。
- 派生工作要带来源：出自什么、用什么工具、何时：模型的信任机制（校验状态、所有者评审）正依赖于此。
- 以绿色交班：绝不要在遍历亮红或登记册不实的状态下结束一场会话。

## 要点

- 找到主，只写到那里；尊重撰写、采集与生成之间的边界。
- 结构变更与登记册更新同行；遍历保持绿色。
- 拒绝一次不安全的写入并说明理由，是合规行为，不是失败。

## 深入阅读

- [智能体操作：配方与拒绝](/spec/#07-guides/Agent-Operations.md)
- [数据主权归属（ARCH-018）](/spec/#02-architecture/Data-Mastership.md)

下一课：[机器枢纽](03-machine-hub.md)