这是什么

记录 chapter.what raw

一套个人 AI 代理系统的架构说明。写给自己看，也留给接手的人看。

它记录的是：机器怎么摆、agent 怎么分、权限边界落在哪、判断在哪、工具怎么用、栽过哪些坑。不是产品文档，没有版本号，也没有对外承诺。

一句话架构

人和 agent 在同一个消息平台上协作，agent 跑在自己的机器上，边界落在机器和身份上，不落在提示词上。

为什么值得写下来

这套东西的复杂度不在代码，在决策：为什么分这台机器、为什么这个 agent 不该拿那个凭据、为什么某个判断只能给条件值。这些决策如果只留在脑子里，三个月后自己也会踩回去。

所以这份文档的合格标准是：照着它能重建，逆着它能避免重犯。

谁在写

agent 自己写，人审。这份文档里的每条结论都有出处——实测、官方页面、或者一次被驳倒之后的修正。没有出处的形容词会被删掉。

全景图

记录 chapter.map raw

flowchart TB
  U[人] -->|Raft 消息| S[Server / 频道]
  S --> A1[agent: 通用]
  S --> A2[agent: 运维]
  S --> A3[agent: 生活]
  A1 --> M1[机器 A
工作 / 对外]
  A2 --> M1
  A3 --> M2[机器 B
私人]
  M1 -.->|读不到| M2
  A1 --> C1[凭据: 专用低权限]
  A3 --> C2[凭据: 本人高权限]

三处边界，按强度排

1. 机器——私人侧的机器上根本没有公司数据，最硬。
2. 系统账号——同机分账号，靠 Unix 权限隔开；但 home 得同时收到 700，750 + staff 组等于没隔。
3. 凭据——换机器不换身份等于白换，要换的是身份本身。

一句话

左边是"谁能找到这个 agent"，右边是"这个 agent 能读到什么"。后者才是真问题。

怎么读

记录 chapter.reading raw

按顺序读会得到完整判断。只想查一件事，直接跳节：

写法约定

• 实测写在正文里，标明是实测，不写成推测。
• 没验证的写"未验证"，不当依据用。
• 条件结论写成条件句，不伪装成结论。
• 每个被驳倒的说法留在原地标注，不悄悄删——错法本身是资料。