# 共享知识库写入规范

更新时间：2026-05-17T13:47:47+0800

## 目标

NAS `00_共享区/共享知识库` 是公司多机器人协作的共享知识库，只保存精简、可执行、当前有效的最终版本，供机器人和团队直接读取执行。

共享知识库不是单个机器人的记忆区、不是项目动态看板、不是素材/脚本备份盘、不是聊天记录库，也不是用户个人偏好库。

## 可入库内容

1. **固定事实**：公司级环境边界、稳定路径索引、IP/项目长期有效资料、官方资料索引、已确认业务口径。
2. **最终 SOP**：已经验证、可重复执行的流程，写清触发条件、输入、步骤、输出、验收标准和风险边界。
3. **跨项目方法**：电商、设计、财务、授权、运营、运维等多个项目可复用的方法论。
4. **跨机器人协作规则**：任务路由、职责边界、移交条件、协作验收标准；应写成条件化规则，不写成某个 Agent 的个人宣言。
5. **本地 source-of-truth 引用**：对机器本地动态状态，只记录电脑、路径、检查命令和维护边界，不复制整张动态表。

## 写入原则

1. 正文只写当前应该怎么做，不写聊天过程、草稿、修订记录、反复讨论痕迹。
2. 修订记录、执行日志、备份、排查过程放本地运维目录或本地备份，不放 NAS 正式知识库正文。
3. 一个事实只维护一个 source of truth；其他位置只放引用路径，不重复复制表格。
4. 运维文档优先写路径、变量名、检查命令、执行边界和风险条件。
5. 过期规则应直接替换为当前规则，不在正文堆叠“旧版/新版”对照。
6. 用户个人偏好默认留在对应机器人 memory；如需共享，必须去个人化并提炼成业务策略。
7. 项目当前待办、负责人、截止时间和实时进展不进入共享知识库正文，只能进入项目工作区或任务系统。
8. 角色专属标准应限制在对应角色/调度场景使用，避免污染所有机器人行为。

## 禁止写入

- 明文 API key、token、cookie、密码、私钥、Feishu App Secret、verification token、encrypt key。
- `.env`、`auth.json`、OAuth 登录态、运行日志、缓存、数据库、向量索引、虚拟环境。
- 用户个人偏好、单个机器人私有记忆、未经脱敏私聊原文、单次任务情绪/复盘、临时猜测。
- 未验证的机器人身份映射、未经确认的 profile 迁移状态、复制出来的机器本地动态状态整表。
- 实时项目待办、当前负责人、未完成进展、未经确认的客户敏感沟通或合作状态。

## 可写入

- 不含密钥明文的路径、变量名、present/missing 状态摘要；动态状态优先只写本地 source-of-truth 路径。
- 最终 SOP、最终角色标准、最终运维边界。
- 脱敏案例、稳定业务事实、可复用字段模板和校验规则。
- 本地 source-of-truth 文件的引用路径，并说明属于哪台电脑。