规范库（法规与管理标准）

状态：Phase 1 已落地；多维索引树 + 全屏三栏管理 UI（2026-07-25）已落地 API 与 /workspace/standards 管理页；来源抓取 / 影响清单等仍待做。

真值：用户可见能力见 docs/产品规格.md §3.2.2；本文供设计与实现对照。

表述：界面与帮助文案用用户表达（「规范库」「已发布」「待审核」「按地域浏览」等）；表名、API、路径等实现术语仅在本文 §7 给出。

关联：

• 产品规格.md §3.2.1（知识文档三层）、§3.2.2（规范库）、§4.2.4（平台插件）
• 智能体调用知识文档的方式.md（对话检索）
• 资料库.md（空白表/填报模板；可「依据」本规范库条目）
• 检查方案.md（实践机读包；必填依据本库条目，不冒充条文）
• 合规实践检查表转机读包.md（专家表 → 机读包 → 检查方案）
• 工作区能力包.md（工作智能体联网抓取）
• ../sdk/platform-plugin/README.md（平台插件读规范 / 互调）

1. 目标

• 在 工作区 内提供共用的 法规、行业标准、管理制度、管理理论 真源（用户说法：规范库）。
• 支持 人力资源、合规管理 等多类 平台插件 按同一真源生成调查表、检查项、职级与胜任力等业务数据。
• 支持 工作智能体（或定时任务）从 已登记官网 抓取更新，经 人审发布 后影响插件与对话。
• 支持 智能体 依据 已发布 规范回答用户问题，并尽量落到文号 / 版本 / 来源。

1.1 非目标（首期）

• 不替代各插件自己的 业务库（花名册、检查实例、整改单等仍由插件落库）。
• 不把规范库做成普通「工作区知识」文件夹的别名（见 §2）。
• 不允许「官网一爬完就自动改检查表 / 职级数据 / 对外口径」。
• 不要求插件之间互相爬对方磁盘上的 Markdown。

2. 与「工作区知识文档」的分工

| | 工作区知识文档 | 规范库 | |--|-------------------|------------| | 主要服务谁 | 对话答疑、团队 Wiki | 插件生成规则与数据、合规依据、条文问答 | | 典型内容 | 流程说明、FAQ、项目背景 | 政府/行业法规、管理制度、胜任力等理论真源 | | 变更门控 | 维护者可直接改 | 草稿 → 审核 → 已发布；法规默认须人审 | | 版本与效力 | 弱 | 强（文号、生效/废止、来源 URL、内容哈希） | | 对插件 | 一般不直接驱动落库 | 已发布版本 可驱动调查表 / 检查项等（须再确认） |

可选：规范 发布 时同步一份 对话用摘要 到工作区知识；真源与版本仍以规范库为准。

3. 产品决策（已确认，2026-07-25）

4. 用户可见能力（规划）

4.1 规范条目

每条规范至少让用户能理解：

• 标题、正文（或附件）
• 类型：法规 / 行业标准 / 企业内部制度 / 管理理论 等
• 领域标签（界面提供默认建议如人力资源 / 劳动用工 / 合规 / 胜任力等，亦可自建；插件按机器值筛选，如 hr、labor、compliance、competency）
• 文号 / 发布机关（法规类）
• 生效日、废止日（可空）
• 来源：手工上传 / 官网抓取（含 URL）
• 状态：草稿、待审核、已发布、已废止
• 版本号（同文号下递增或按发布批次）

4.2 来源白名单

• 工作区管理员登记允许抓取的 官网域名与入口页（以及可选的解析说明 / 技能）。
• 未在白名单内的地址：禁止自动抓取写入规范库。

4.3 抓取与待审

• 工作智能体或 定时任务按白名单检查更新 → 比对文号 / 内容哈希 / 官网标注的生效信息。
• 有变更则创建 草稿或待审核 条目，并生成 变更摘要（相对上一已发布版的 diff 说明，供人阅读）。
• 法规与行业强制标准：默认必须人审后才能发布。
• 企业内部制度：策略上可配置「低风险自动发布」（默认仍建议人审）。

4.4 发布与启用

• 审核通过 → 已发布；可指定 启用日（与法定生效日对齐）。
• 支持回滚到上一已发布版本（插件侧未确认的重算可取消）。

4.5 对插件的影响清单

规范发布后，平台按 领域标签 通知已订阅的插件（如人力资源、合规管理）：

• 列出可能受影响的能力（调查表模板、检查项、职级包等）。
• 插件提供 「按新规范预览」→ 确认 → 写入业务库。
• 每次生成须记录：规范 ID + 版本（审计与追溯）。

4.6 智能体问答

• 检索范围：已发布 且已到启用日、未废止的规范。
• 回答应尽量标明依据（标题、文号、版本或来源链接）。
• 查「当前工作区业务事实」（花名册、某次检查结论）仍走各插件操作（如 plugin_invoke），不用规范库冒充业务数据。

4.7 多维索引树（浏览与管理）

规范常需按 地域、行业、效力类型、业务领域 等不同方式整理；用户期望左侧是树、并能换「索引方式」。这与 §3.2.1 知识文档目录树 易混淆，约定如下。

#### 4.7.1 产品原则

#### 4.7.2 用户说法

• 索引方式：顶部或侧栏切换，如「按地域」「按行业」「按类型」。
• 分类树：当前索引方式下的节点（可增删改、排序；管理员维护）。
• 未归类：尚未挂到当前维度任何节点的条目，单独一栏，避免「放进文件夹才存在」的误解。

#### 4.7.3 界面骨架（下一阶段）

┌─────────────────────────────────────────────────────────────┐
│ 规范库     [按地域 ▾]     返回工作区协作                      │
├──────────┬────────────────────┬────────────────────────────┤
│ 分类树   │ 当前节点下的条目列表 │ 标题 / 元数据 / 正文         │
│ （可展开）│ （状态、文号、版本） │ 草稿保存 · 提交 · 发布…     │
└──────────┴────────────────────┴────────────────────────────┘

• 观感可对齐知识文档管理页的「三栏」，但左侧是 当前索引的分类树，不是知识 knowledge/ 目录。
• 协作页可保留简介 +「管理规范库」入口；完整编辑进专用全屏路由（与「管理工作区知识文档」同类）。

#### 4.7.4 示意

规范条目：《中华人民共和国劳动合同法》v3（已发布）
  ├─ 挂到「地域」树：全国 → 劳动用工
  ├─ 挂到「行业」树：通用 → 人力资源
  └─ 挂到「类型」树：法规

插件订阅仍可按领域标签或 索引节点 ID 过滤已发布条目；生成业务数据时记录规范 ID + 版本（及可选节点路径便于审计展示）。

#### 4.7.5 实现对照（已落地）

仍待：来源白名单抓取、插件按节点订阅、影响清单等。

5. 端到端流程

flowchart TD
  A[官网白名单源] --> B[工作智能体或定时抓取]
  B --> C{与已发布版有差异?}
  C -->|否| D[记录检查时间]
  C -->|是| E[规范库草稿/待审]
  E --> F[管理员审核]
  F -->|驳回| G[保留痕迹]
  F -->|通过| H[已发布 + 可选启用日]
  H --> I[对话检索可用]
  H --> J[通知订阅插件]
  J --> K[影响清单与预览重算]
  K --> L[人确认后写插件业务库]

6. 插件与互调边界

智能体 ── 检索 ──────────────► 规范库（条文怎么说）
智能体 ── plugin_invoke ─────► HR / 合规（库里现在是什么）
HR / 合规 ── 只读 API ───────► 规范库（同一真源）
合规 ── 平台代调 ────────────► HR（只要人事等业务事实）

7. 实现对照

已补（2026-07-25）：工作区协作 UI「规范库」；对话运行时注入已发布规范（workspaceStandardsBlock）。

已补（导入/导出）：全屏管理页「导入 / 导出」，与知识文档同类；跨工作区迁移时分类按 slug + 标题路径 重建。

已补（智能体写条文草稿）：系统工具 workspace_standard_list / workspace_standard_write（须用户确认；仅草稿，不发布）。实践机读包勿再用本工具冒充法规，见 检查方案.md。

仍未实现（后续）：官网来源白名单与自动抓取、插件订阅与影响清单、跨插件业务代调、管理端运维页。

8. 验收要点

8.1 第一期（存储 + 草稿/发布 + 插件只读）— 已落地 API

• [x] 工作区成员 JWT 可创建草稿、提交审核；管理员可发布 / 废止 / 重新打开。
• [x] 普通成员列表仅见已发布且生效中的规范。
• [x] 插件 launch_token 只读已发布规范（含按 tag 过滤）。
• [x] 正文与 knowledge 目录分治；发布写入版本文件。

8.2 多维索引与管理界面 — 已落地

• [x] 工作区预置地域 / 行业 / 类型索引；树节点可增删。
• [x] 同一规范可挂到当前索引下多个节点；「未归类」可见。
• [x] 全屏管理页：索引切换 + 左树 + 列表 + 右编辑；不写入知识文档物理路径。
• [x] 发布门控与成员/插件可见性规则不因树浏览而绕过。

8.3 后续

• [ ] 白名单外 URL 无法写入自动抓取结果。
• [ ] 未发布规范不出现在普通成员的智能体答疑依据中（对话检索源已部分覆盖，抓取链路仍待做）。
• [x] HR 开局使用产品默认机读胜任力标准包（不扫规范库）；跟版仅按已绑定条目 ID 读一条（mindlink-competency-pack，2026-07-25）；平台级影响清单仍待做。
• [ ] 发布新版本后出现影响清单，静默不改业务库（HR 侧已有「预览新规范 → 确认应用」）。
• [ ] 可回滚已发布版本；审计可查「谁抓取、谁发布、谁确认重算」。

9. 修订记录