用途:将仓库文档同步发布到 GitHub wiki,作为只读公开帮助资源。仓库文件是唯一事实来源,wiki 仅作渲染目标,内容不直接编辑。仅适用于 Tier 3 和 Tier 4(公开仓库),Tier 1、Tier 2(私有仓库无公开 wiki)默认禁用。在完整评估中作为第 9 个模块最后运行,以便引用其他模块的发现并反映项目当前状态。
主要能力:检查仓库是否启用 wiki;克隆 wiki 仓库;初始化 wiki(创建 Home 页并推送以生成 wiki 仓库);对比生成内容与现有 wiki(new_pages、modified、unchanged、orphaned);提交并推送变更;清理临时目录。内容生成以 README.md 生成 Home.md,docs/ 目录文件转为 wiki 页面,自动生成 _Sidebar.md 目录与 _Footer.md 页脚,并支持从代码自动生成函数、CLI、配置、API 参考页。转换时修正相对链接与图片引用、添加自动生成提示、移除仓库专属内容。页面命名遵循 GitHub wiki 约定(空格转连字符)。
使用方式:通过 gh-manager 命令操作,例如 gh-manager wiki clone --repo owner/name --dir /tmp/wiki-xyz、gh-manager wiki init --repo owner/name [--dry-run]、gh-manager wiki diff --dir /tmp/wiki-xyz --content-dir /tmp/wiki-generated-xyz、gh-manager wiki push --dir /tmp/wiki-xyz --message "Wiki sync 2026-02-17" [--dry-run]、gh-manager wiki cleanup --dir /tmp/wiki-xyz。推送前需经所有者确认,Tier 4 默认先展示完整差异。
限制:推送会覆盖内容并立即公开可见,属不可逆操作;需 PAT 具备 Contents 读写权限;自动生成内容为尽力而为,需人工复核;孤儿页面处理可配置为 warn、delete 或 archive。资料未提供价格、平台支持范围等更多信息。