Hermes 原生文档产物管理系统方案
分析日期：2026-05-15
一、核心理念
Hermes 本身被设计为 AI 编码代理框架, 其最原生的文档/产物管理系统并非任何第三方平台, 而是：
Git 仓库 + 本地文件系统这是 Hermes 内核工具链天然围绕的核心工作流。
二、原生工具链 (Built-in, 零额外依赖)
| 工具 | 功能 | 说明 |
|---|---|---|
read_file() |
读取文件内容 | 任意格式文本文件 |
write_file() |
创建/覆盖文件 | AI 直接写入文档产物 |
search_files() |
全文搜索 + 文件名搜索 | 快速定位内容 |
patch() |
精准编辑文件片段 | 修改而不覆盖 |
terminal(git) |
Git 工作流 | clone/commit/push/pull/branch/PR |
这些工具内建在 Hermes 内核中, 任何会话立即可用, 无需技能或插件。
三、文档产物的目录结构范式
文件系统（本地/挂载卷）
+-- 项目目录/
+-- docs/ <- 设计文档 (.md)
+-- designs/ <- 设计稿描述 (.md / .html)
+-- specs/ <- 规格文档
+-- proposals/ <- 方案/提案
+-- research/ <- 调研记录
+-- src/ <- 代码产物
+-- README.md <- 项目总览
^ Hermes 通过 file tools 直接读写
v Git 版本管理 + 协作分享
四、为什么这是最原生的
从 Hermes 的技能目录可以看出其设计重心：
github-pr-workflow- PR 生命周期管理github-code-review- 代码审阅github-issues- Issue 管理github-repo-management- 仓库管理codebase-inspection- 代码库分析
这些都是围绕 Git 仓库中的文件 展开的。
五、私网部署 + 公网访问的完整链路
手机 (Telegram)
^ 文件/消息
v 指令
Hermes (Docker, 私有网络)
v read_file / write_file / search_files / terminal(git)
v
局域网私有服务器
+-- Git 仓库 (Forgejo / bare repo)
| +-- docs/设计文档.md
| +-- specs/规格.md
| +-- src/code.py
|
+-- Forgejo (可选, 在线查看 MD/代码渲染 + 多用户权限)
对于公网访问 (可选安全方案):
Cloudflare Tunnel -> 局域网 Forgejo (不可用时)
或 Hermes -> Telegram 直接发送文件 (最安全, 零端口暴露)
六、对比其他方案
| 方案 | 与 Hermes 原生度 | 说明 |
|---|---|---|
| Git + 文件系统 | 最原生 | 工具链内建在 Hermes 内核中 |
| Obsidian | 有 skill | 扩展集成, 非设计核心 |
| Trilium | 通过 MCP | 社区集成, 非原生 |
| Seafile / Nextcloud | 外部集成 | 需 curl, 非原生工具 |
| Forgejo / GitLab | Git 生态延伸 | Git 的托管平台 |
七、优势总结
- 原生集成： Hermes 工具链天然支持, 零配置
- 版本管理： Git 自动记录所有文档变更历史
- 在线查看： Forgejo/GitHub/GitLab 渲染 MD/代码
- 多用户隔离： Git 仓库权限天然隔离
- AI 全权管理： read/write/search/patch/git 全部原生
- 私网安全： 文件无需暴露公网, 通过 Telegram 桥接
- 零依赖： 不依赖任何第三方服务