用途:修订既有 wiki 页面。触发场景为知识发生变化、新信息更新或与现有内容矛盾、用户想修改页面。核心原则:写入前必须展示 diff、必须记录日志、必须标注新信息来源。
前置条件:查找 SCHEMA.md(从 cwd 向上搜索或 ~/wikis/)。找不到时提示用户先运行 wiki-init。读取其中的 wiki 根路径与约定。链接风格读 link_style:缺失或配置文件不存在时默认 obsidian([[slug]]),否则读取 <wiki-root>/config/link-style.md 的生成与解析规则;扫描现有页面交叉引用用 Parse 规则,写新引用或引证用 Emit 规则。
流程:一、确定更新对象:用户可给出具体页面名;或给出新信息后运行 python bin/generate-index.py 重建索引,读 wiki/index.md 定位受影响页面再读取;或依据 lint 报告逐条处理。二、逐页更新:完整读取当前内容,提出改动(Current、Proposed、Reason、Source 四要素),Source 必填否则不可追溯;若引入新 [[slug]],写入前必须确认目标页面存在或本次正在创建;每页写入前逐页确认,不得批量应用。三、检查下游影响:用 Parse 规则扫描全部页面,找出链接到被更新页面的页面,若其断言受影响则显式标记并同样先确认再改。四、矛盾清查:新信息与 wiki 内容矛盾时,先搜索全部页面中该被矛盾说法,更新所有出现处。五、重建 wiki/index.md:不手工编辑索引;若摘要或分类变化,改页面自身的 summary / category frontmatter,并更新 updated 日期(created 不动),再运行 python bin/generate-index.py。六、更新 wiki/overview.md:重读后若整体综述变化,同样先确认再改。七、记录操作:Git wiki 暂存并建议提交(默认 Conventional Commits,docs: 加 trailer Wiki-Op: update,确认后提交);非 Git wiki 追加到 wiki/log.md,格式为 ## [日期] update | 页面 slug 列表,含 Reason 与 Source。
常见错误:不引用来源、跳过下游检查、跳过日志、未逐条确认就批量写入、以追加日期段落代替就地更新、在编辑中虚构不存在的 [[slug]] 链接。
资料未提供:具体安装方式、支持的平台、收费与价格信息暂未提供。