先读 Harness 的路线推荐顺序README.mdMakefilecmd/gitness/main.gocli/operations/server/server.gotypes/config.gocmd/gitness/wire.goapp/bootstrap/bootstrap.goapp/router/web.goweb/dist.go选择一个业务域继续例如app/api/controller/repoapp/services/repoapp/store/database/repo.go读 Harness 不建议从web/src/pages开始因为前端页面很多容易迷失。先理解后端资源模型和 API 更有效。先读 Hermes Agent 的路线推荐顺序README.mdpyproject.tomlhermes_cli/main.pyrun_agent.pymodel_tools.pytools/registry.pytoolsets.pyhermes_state.pygateway/run.py选择一个工具继续例如tools/terminal_tool.py、tools/file_tools.py、tools/browser_tool.py读 Hermes Agent 不建议一上来读完整gateway/run.py文件非常大。先理解 agent loop 和 tool registry会更容易。从架构角度如何维护 Harness优先维护这些边界controller 不要承载过重业务逻辑service 负责业务规则store 负责数据访问types 保持稳定OpenAPI 与前端 client 保持同步配置项集中在types/config.go建议优化给 Makefile 增加统一 dev/start 目标拆分过大的 Wire 组装把本地启动说明写得更明确增加 API 变更时的生成校验从架构角度如何维护 Hermes Agent优先维护这些边界工具注册统一走tools.registryprovider 差异尽量放进ProviderProfileagent loop 不要继续无限膨胀gateway adapter 和核心 agent 保持隔离安全策略独立成可测试模块技能和插件要有明确的信任边界建议优化持续拆小run_agent.py、hermes_cli/main.py、gateway/run.py为工具注册、provider profile、gateway adapter 提供更明确的插件模板强化危险工具的审计日志对技能和插件增加签名/来源/权限说明对不同平台入口做一致的错误展示如果你要二次开发 Harness适合做增加 DevOps 平台功能扩展 API增加自定义资源管理集成企业认证或内部系统加强 Pipeline / Registry / Gitspace不适合把它改成AI agent runtime本地个人自动化助手纯聊天机器人如果你要二次开发 Hermes Agent适合做增加工具增加模型 provider增加消息平台增加自动化技能增加 memory backend增加企业内部系统连接器不适合把它改成大型多人 DevOps 平台Git 托管服务Artifact Registry企业 RBAC 平台最终判断如果你的目标是“搭一个代码托管/CI/制品/开发环境平台”看 Harness。如果你的目标是“搭一个能对话、能调用工具、能记忆、能通过消息平台执行任务的 AI 助手”看 Hermes Agent。如果你的目标是“让 AI 帮我操作 DevOps 平台”两者可以组合Harness 作为平台Hermes Agent 作为智能操作层。
