Wiki Pages and Provenance zh CN

Wiki 页面与来源证明

语言： English · 简体中文

Wiki Page 是 LWC 持续维护的知识层。一篇页面把可读 Markdown 与稳定身份、检索元数据、引用、来源证明和链接组合在一起。

页面字段

字段	用途
Slug	命令、文件名和 Wiki 链接使用的稳定标识符
Title	便于人阅读的页面名称
Kind	检索与维护分类
Summary	用于索引和搜索的单行说明
Body	持续维护的 Markdown 知识正文
Source IDs	页面引用的不可变证据
Provenance	持久声明不来自 Source 时使用的显式来源证明
Links	从正文 [[slug]] 中提取的出站关系

Slug 应保持稳定。通过删除再新建的方式改名，会破坏链接、检索历史和外部引用。

页面类型

Kind	用途
source	单个 Source 的可追溯摘要
concept	随证据不断修订的技术、模式、规则或概念
entity	人、组织、产品、组件或数据集等命名实体
query	可复用答案、决策或待解决问题
comparison	对备选项或证据进行结构化比较
synthesis	整合多篇 Page 或多份 Source 的跨主题结论

Kind 用于改善发现与维护，本身并不会赋予页面权威性。

引用与 source-grounded

每一份支持页面声明的不可变 Source 都要重复传入 --source：

lwc page put storage-model \
  --title "Storage model" \
  --kind concept \
  --summary "Canonical and derived storage boundaries" \
  --file storage-model.md \
  --source 12 \
  --source 18

页面只要存在引用，就会自动获得 source-grounded。不要手工传入这个值。

建立引用意味着该 Source 支持页面中的声明，不能只因为“相关阅读”就引用。存在不确定性或证据冲突时，应在正文中写清楚。

显式非来源证明

持久知识不来自不可变 Source 时，使用显式 provenance：

lwc page put accepted-boundary \
  --title "Accepted boundary" \
  --kind query \
  --summary "User decision and current verification state" \
  --file boundary.md \
  --provenance user-provided \
  --provenance agent-observed

• user-provided 表示用户明确提出的持久事实或决策。
• agent-observed 表示 Agent 根据当前已授权证据完成验证。
• hypothesis 表示仍未验证但有调查价值的可能性。

不能因为一项假设一直没人反对，就把它改成 Agent 观察事实。

整体替换语义

page put 会在一次逻辑更新中整体替换页面正文、引用集合、显式 provenance 集合和提取出的链接。替换页面前先运行：

lwc page show storage-model
lwc page links storage-model

之后重复传入每一个仍然有效的 --source 和非来源 --provenance；省略就代表删除。

这种设计能够防止隐藏元数据过时，也意味着不能盲目执行局部覆盖。

Wiki 链接

在 Markdown 正文中使用 [[stable-slug]]：

规范数据库边界见 [[storage-model]]。
恢复行为由 [[checkpoint-policy]] 定义。

page links 返回出站链接、反向链接和未解析链接。Lint 会报告关系断裂和孤立页面等维护问题。

链接表达导航与结构关系。CONTRADICTS 或 DEPENDS_ON 等强语义声明应使用显式图关系，并附带来源证明、原因、置信度和支持它的 Source ID。

怎样写好一篇页面

一篇有用的页面应当：

• 回答一个可检索问题，或解释一个稳定概念；
• 说明作用范围和当前状态；
• 区分事实、决策与假设；
• 有不可变证据时引用准确 Source；
• 保留有意义的矛盾；
• 链接相关概念，不重复粘贴完整内容；
• 讨论运行行为时给出操作验收方式；
• 排除聊天时间线和临时进度。

更新已有页面

1. 新建 slug 前先搜索同一概念。
2. 打开当前页面并检查链接。
3. 声明依赖新鲜度时，检查对应引用来源。
4. 合并经过验证的新知识，同时保留仍然有效的旧内容。
5. 重新传入完整引用与显式 provenance 集合。
6. 运行 lint 和固定检索检查。

如果页面修订依赖其他 Page、Source、Purpose、Schema 或 ingest 变更，应使用 changeset。

删除页面

lwc page remove obsolete-page

删除操作受到保护。存在入站 Wiki 链接时，LWC 会拒绝删除；必须先更新或移除这些引用。禁止手工删除投影 Markdown 或数据库记录。

Provenance 不参与自动排名

Provenance 用于审计，不会自动改变搜索排名。经过验证的规范页面难以检索时，应先改善标题、摘要、正文和链接。只有检查 search --explain 后，才考虑使用有界权重或查询反馈。

完成证据

页面更新只有满足以下条件才算完成：

• slug 与 kind 对应一个稳定概念；
• summary 能够帮助检索发现该页面；
• 所有当前声明都有引用或显式来源证明；
• 仍然有效的旧证据与链接得到保留；
• 矛盾和不确定性保持可见；
• lint 与两种固定问法都通过。

下一篇：搜索与上下文载入