GitHub
GitHub 在企业版架构里被定位为 wiki 真相源(single source of truth)。
仓库地址:github.com/daishiyu1991-hub/wiki-vault
注:本架构最初设计选用 Gitee(详见该页"为什么选 Gitee 不选 GitHub"段)。 实际部署落地时改用 GitHub,原因和取舍见本页 §为什么最终选 GitHub。
它负责什么
- 存放
wiki-vault的 main 分支 - 承载所有 canonical wiki 页面的版本历史
- 作为本地 Obsidian、ECS 工作副本、未来其他消费者之间的同步中枢
- 提供 diff、PR、回滚等 git 原语,作为知识治理的最底层支撑
- 通过 Git LFS(付费 $5/月,50GB 存储 + 50GB 月流量)托管图片/视频等二进制资产
它不负责什么
- 不负责渲染(渲染由 VitePress 完成)
- 不负责 agent 直接读取(agent 走 ECS 工作副本
/opt/wiki-vault/canon/,而非 GitHub API) - 不负责审批(审批在 Multica 管理页面)
- 不负责权限分发(团队成员权限由 GitHub repo 的 collaborator 列表管理,由 Allen 维护)
为什么最终选 GitHub
| 维度 | Gitee(最初设想) | GitHub(最终选择) |
|---|---|---|
| 国内访问稳定性 | ✅ 国内 IDC | 多数同事可正常访问;ECS 已验证 push/pull 稳定 |
| 私有 repo | ✅ 免费配额够 | ✅ 免费 repo + 团队 collaborator 模式 |
| Git LFS | ❌ 配额小且贵 | ✅ $5/月 50GB 流量,够用很久 |
| 生态熟悉度 | 国内开发者偏低 | 几乎所有开发者都用过 |
| Webhook / CI / Actions | 弱 | 成熟 |
| 可见性(同事审计 collaborator) | 一般 | 更清晰 |
实际部署中 GitHub 没出现明显瓶颈,且 LFS 配额优势显著,因此从 Gitee 改为 GitHub。
同步链路
text
本地 Obsidian (E:\Ai+人协作系统\wiki\)
↓ git push (SSH)
GitHub daishiyu1991-hub/wiki-vault (main)
↓ git pull (cron 每分钟)
ECS /opt/wiki-vault/
↓ refresh-symlinks.sh + npx vitepress build
ECS /opt/wiki-site/.vitepress/dist/
↓ Nginx
https://wiki.86lux.net同时 5 个 Hermes 容器把 /opt/wiki-vault/canon/ 只读挂载,立即看到最新 canon。
接入入口
- 本地接入:同事接入wiki发布流程
- 自动化:vault-publish skill
- 资产管理:wiki图片视频管理规范
- 整体架构:Docs-as-Code 发布架构
关联
- Gitee — 原架构选型,已被本页取代
- VitePress — 渲染层
- Multica — 审批层
- Hermes Agents — 主要 agent 消费者
- Git LFS — 二进制资产管理
- Docs-as-Code over Feishu Publishing