用途:把 kairos-mcp 仓库中 .qoder/repowiki/en/content/ 的 Markdown 单向同步到 GitHub Wiki(debian777/kairos-mcp.wiki.git),GitHub Wiki 仅作为生成后的发布目标,不作为编辑入口。
主要能力与流程:内容源为 .qoder/repowiki/en/content/,其中 Home.md 为 Wiki 首页,_Sidebar.md 为左侧导航;.qoder/repowiki/en/meta/ 由 Qoder 管理,不可编辑。触发方式为推送到 main 且改动内容或工作流文件,也可通过 GitHub UI 或 gh workflow run 手动触发(workflow_dispatch)。关键文件包括 .github/workflows/sync-qoder-repowiki-to-github-wiki.yml、scripts/sync-wiki.sh(本地手动同步,逻辑与 CI 一致)、scripts/setup-github-wiki-permissions.sh(一次性 gh CLI 权限设置)。
使用方式:首次使用先运行 ./scripts/setup-github-wiki-permissions.sh 启用 Wiki 与 Actions 写权限;若 Wiki 从未初始化,需在 GitHub UI 创建首个 Home 页面;本地同步执行 ./scripts/sync-wiki.sh,其使用 rsync -a --delete 镜像内容后推送到 Wiki 仓库的 master 分支。新增页面时在 content 目录创建 NewPage.md,并在 _Sidebar.md 添加 - [[NewPage]],提交合并到 main 后由 CI 自动发布。
限制与注意:仅支持单向同步,禁止实现双向同步;不得直接编辑 GitHub Wiki UI,否则每次同步会被覆盖;不得编辑 meta 目录;无变更时不创建空提交;不使用复杂第三方 Action。Wiki 链接使用 [[Page Name]] 或 [[Page Name|自定义文本]],标题锚点由标题文本自动生成,图片需位于 Wiki 仓库内并使用相对路径。Qoder 在项目打开或 Git HEAD 变化时生成内容,单次代码改动建议不超过 10,000 行。常见问题包括 Wiki 未初始化导致 repository not found、Actions 缺少写权限、路径过滤未匹配、缺少 _Sidebar.md 等。