Skip to content

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。

接入入口

关联

TeamOS · docs as code · canon=权威知识,drafts=候选区