Hermes 原生文档产物管理系统方案

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 直接读写
               ↓ Git 版本管理 + 协作分享

四、为什么这是最原生的

从 Hermes 的技能目录可以看出其设计重心：

  • github-pr-workflow — PR 生命周期管理
  • github-code-review — 代码审阅
  • github-issues — Issue 管理
  • github-repo-management — 仓库管理
  • codebase-inspection — 代码库分析

这些都是围绕 Git 仓库中的文件 展开的。

五、私网部署 + 公网访问的完整链路

手机（Telegram）
  ↑ 文件/消息
  ↓ 指令

Hermes（Docker，私有网络）
  ↓ read_file / write_file / search_files / terminal(git)
  ↓

局域网私有服务器
  ├── 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 桥接
  • 零依赖： 不依赖任何第三方服务