Cloudsome 文档
需求设计报告
  • 通用架构
  • Hermes Agent
  • Hermes Agent V2
  • OpenMausBot
  • 小鹏灵犀 · 静态架构(参考)
  • 土豆(@poteto)· Grok Bot 自动化开发流程
  • 微软人事智能体 · 分层架构(参考)
选型报告
  • 票据 OCR 选型(草稿)
  • OCR 云 API 产品评估与评分(草稿)
  • 票据 OCR 选型需求与评分口径(草稿)
  • 票据 OCR PoC 测试计划(待启动)
  • OCR 通用文档识别选型(维度二·草稿)
财务工作流
补充材料
需求设计报告
  • 通用架构
  • Hermes Agent
  • Hermes Agent V2
  • OpenMausBot
  • 小鹏灵犀 · 静态架构(参考)
  • 土豆(@poteto)· Grok Bot 自动化开发流程
  • 微软人事智能体 · 分层架构(参考)
选型报告
  • 票据 OCR 选型(草稿)
  • OCR 云 API 产品评估与评分(草稿)
  • 票据 OCR 选型需求与评分口径(草稿)
  • 票据 OCR PoC 测试计划(待启动)
  • OCR 通用文档识别选型(维度二·草稿)
财务工作流
补充材料
  • 需求设计报告
    • 静态架构
    • 基本流程
    • 支撑能力
    • 调度中心
    • Agent 分工
    • 运行环境
    • 持久卷与 RSI
    • 评审问题与讨论结论
  • 共用底座
    • 通用架构
    • Hermes Agent 方案
    • Hermes Agent 基础架构 V2
    • OpenMausBot 方案
  • 参考架构

    • 小鹏灵犀 · 静态架构(参考)
    • 土豆(@poteto)· Grok Bot 自动化开发流程
    • 微软人事智能体 · 分层架构(参考)
  • 数字员工选型报告
    • 数字员工目标静态架构
    • 数字员工目标静态架构v2
    • Hermes 会话机制
    • OpenMausBot 会话机制
  • 知识库选型研究
    • 知识库选型需求与评估 SOP
    • 知识库候选产品
    • 知识库逐项资料评分与代码证据
    • 知识库商业托管版横向评分
    • FastGPT 知识库增强源码与自研评估
  • 票据 OCR 选型(草稿)
    • OCR 云 API 产品评估与评分(草稿)
    • 票据 OCR 选型需求与评分口径(草稿)
    • 票据 OCR PoC 测试计划(待启动)
    • OCR 通用文档识别选型(维度二·草稿)
  • 财务工作流
  • 补充材料
    • 流程与组件说明
    • 简版流程图
    • 详细流程图
    • 记忆、技能与会话历史
    • Hermes 记忆与技能研究
    • Hermes 本机版本能力核验
    • Meegle 事件去重研究
    • 项目定位与设计边界
    • 交互架构图说明
    • 原报告导航说明

Hermes 本机版本:静态架构能力核验

结论

主干方案有 Hermes 原生能力支撑,但图不是安装 Hermes 后就全部具备的功能清单。

本机源码版本为 v0.23.1,提交 3b421578588243f920886e6fe79a6faa87ea026e,位置为 /Users/makia/.hermes/hermes-agent。核验时该源码树没有已跟踪文件的本地修改。以下结论绑定此版本,不以滚动官网替代本机实现。

  • 原生支持:Lark 消息与发送者身份字段、多个独立 Profile、一个 Gateway 托管多 Profile、按 Profile 配置 MCP 及工具过滤、1Password 密钥源,以及会话可使用的 Docker 工具执行沙盒。
  • 有扩展基础,仍须自研:把 Lark 员工映射到 Casdoor,获取业务权限范围;在 MCP 工具代码或自研安全网关中逐次强制执行业务权限。
  • 不能当成原生保证:自动生成业务授权、动态签发 ERP 凭证、真实业务凭证仅由外部 MCP 安全网关持有,以及 Profile 对主机文件和网络的强隔离。

架构中的「财务机器人 → 财务 Profile、人事机器人 → 人事 Profile、行政机器人 → 行政 Profile」可以采用原生多 Profile Gateway。三个业务各配各的 MCP,具体数据与动作权限再由工具代码落实 Casdoor 返回的授权;不需要新增三个业务之间的耦合。

逐项证据

1. Lark 接入与员工身份字段:支持;Casdoor 员工映射不是同一件事

Feishu/Lark 适配器的 _resolve_sender_profile() 提取 user_id、open_id、union_id,以租户 user_id 优先、应用 open_id 回退,并保留 union_id。这提供员工身份映射的输入,不是已完成 Casdoor 身份或业务授权查询。不同 Lark 应用的标识范围不同,不能直接把三个机器人的应用级 open_id 当作全局员工 ID。

源码:Lark 身份字段归一化。

2. 一个 Gateway 托管多个业务 Profile:支持

Gateway 为每个 Profile 读取配置,在该 Profile 的运行域内创建并连接适配器,使用 _profile_adapters[profile_name] 管理;缺少该 Profile 的机器人凭证时跳过,不借用其他 Profile 的机器人身份。可用这一机制承接三个不同的 Lark 机器人,而不是必须运行三个独立 Gateway。

这里的机器人对应 Profile、MCP 和凭证配置需由部署配置明确建立;Gateway 不会自行理解「财务、人事、行政」并生成企业授权政策。

源码:各 Profile 的适配器创建与连接。同版本说明:单 Gateway 多 Profile。

3. Profile 圈定 MCP 与工具集合:支持配置级控制,不等于员工业务授权

MCP 连接键包含 Profile scope;不同 Profile 的同名 MCP 可以有不同凭证和工具注册范围。MCP 配置提供 tools.include / tools.exclude,可以按具体工具名或通配符筛选;显式 include: [] 不注册任何工具。它们是配置级工具过滤,不会自动从 Casdoor 动态推导数据行、账套、部门或具体动作权限。

相同路由和凭证的部分远程 MCP 连接允许复用,因此「业务配置独立」不应被写成所有底层连接、进程、资源都物理独立。

源码:Profile scope 连接键与可见性、工具过滤实现。同版本说明:连接与凭证作用域。

4. 代码 / 工具级落实 Casdoor 业务权限:需自研,有拦截扩展点

在本机核心源码及所查本地插件、Hook 源文件中未找到 casdoor 集成。Hermes 有 pre_tool_call 控制 Hook,可返回 block 拒绝工具调用;Shell Hook 的故障拒绝策略需要明确配置 fail_closed,不能默认当成授权服务故障时必然拒绝。Hook 提供机制,Casdoor 查询、可信员工上下文、权限校验和撤权逻辑仍需自己实现。

与图一致的落点是:Profile 选择业务及可用 MCP,MCP 工具代码或自研 MCP 安全网关依据可信员工上下文检查 Casdoor 的业务权限范围,再执行业务调用;不依赖模型自报身份或提示词约束。

源码:工具调用阻断指令、Shell Hook 失败策略。同版本说明:pre_tool_call。

5. 1Password 接入:原生支持,但不等于图中的凭证代持协议

本机版本已有 OnePasswordSource,按配置中的 ENV_VAR → op://... 映射调用本机 op read 解析真实值;原生应用路径会把值写入运行环境,MCP 子进程也可在所属 Profile 范围内接收相应值。不能据此宣称「真实业务凭证只在外部 MCP 安全网关,Hermes / 沙盒只见引用」。

为保留已确认的安全边界,ERP、知识库等下游真实凭证应由自研 MCP 安全网关服务端取用或代持。Hermes 侧只持用于访问该网关的受限凭据或引用,不把下游真实凭证通过原生密钥源注入执行环境。凭据引用的绑定、逐次鉴权与撤销协议仍属自研。

原生密钥源失败时可告警后继续,不是按 Casdoor 查询结果发放凭证的失败即拒绝机制,也不是 ERP 临时凭证签发器。

源码:op read 与映射取值、应用到运行环境。同版本说明:原生 1Password 工作方式与失败行为。

6. Profile 独立:配置与状态分域,不是安全沙盒

Profile 分开配置、会话、Memory、Skills 等;它不是文件系统或网络隔离。默认 local 后端仍以本机用户权限访问文件。若要「只通过安全网关访问业务系统」,还需要禁用或约束不必要工具、限制网络出口并验证执行环境,不能仅凭分了三个 Profile 就宣布不存在旁路。

同版本明确边界:Profiles vs workspaces vs sandboxing。

7. Gateway 能否拉起沙盒里的 Agent / Session:支持工具沙盒,不等于整体 Agent 入箱

原生能做到:Gateway 管理 Session 和 Agent,Agent 的工具执行层按配置创建 Docker 沙盒。不能直接说:Gateway 为每个 Session 创建容器,并把完整 Agent 运行循环、MCP 客户端和会话数据都放进去。

调用路径可分成两部分:

  • Gateway 创建或复用对应会话的 AIAgent,在执行线程运行 run_conversation()。部分 managed session 路径会启动本机 Python 子进程;普通子进程本身不是容器或安全沙盒。
  • 当工具需要沙盒执行环境时,终端环境层按 Profile 的后端配置创建并缓存环境。Docker 后端启动的是运行 sleep infinity 的执行容器,再在其中执行命令,不是在这个容器中启动一份完整 Hermes Agent。

源码:创建会话 Agent、Gateway 执行线程、运行对话循环、managed worker 的本机子进程、Docker 容器启动命令。

按 Session 分配执行沙盒:可以配置

在相应业务 Profile 的配置中,可以采用以下最小意图示例(本次没有修改本机配置):

terminal:
  backend: docker
  container_persistent: false

这一模式按会话标识分配执行容器,通常在首次终端或需要该后端的文件操作时创建;同一会话跨多轮复用,关闭会话或空闲回收时删除,子 Agent 默认使用父会话的容器,不是每个子 Agent 单独一箱。

相反,默认 container_persistent: true 在未开启宿主工作区挂载等额外分组时,同一 Profile 的多个 Session 共用长期容器。不能以启用 backend: docker 就推导出每名员工或每次业务任务都有独立沙盒;Session 边界也不自动等于业务任务边界。

源码:会话与 Profile 作用域、容器标识选择、会话容器生命周期标记、按需创建与缓存。同版本配置说明:Docker 的会话隔离模式。

对架构图中 Session 的准确理解

图里的 Hermes Session 可以理解为 Gateway 管理的受限会话 / Agent 运行上下文,按需使用工具执行沙盒。Profile 内的终端后端配置可用于它,但 Session 不应与容器画等号。

terminal.backend: docker 不会自动把所有 MCP 调用搬进 Docker;MCP 仍有自己的客户端与传输路径。对只调用 MCP 的任务,也不能保证会创建终端沙盒。若要求完整 Agent、MCP 客户端及执行工具都位于每会话独立沙盒,所查代码未提供仅靠上述配置实现该拓扑的路径,需要额外的隔离 Worker 部署或调度适配。

把整个 Hermes/Gateway 部署进 Docker 是另一种原生支持的部署方式,但那是 Gateway 与 Agent 共同位于部署容器,并不等于 Gateway 外置、每个 Session 独占一个容器。

源码:MCP 客户端独立调用路径。同版本明确区分:Hermes 在 Docker 中运行与 Docker 终端后端。

验证范围与未验证项

  • 已核对本机启动包装器指向的源码路径、Git 标签与提交,阅读实现及同版本文档,并交叉查看上游公开文档。
  • 已在独立进程执行 12 项有限离线断言:MCP include/exclude 过滤 5 项、Profile 连接键与可见性 3 项、工具阻断指令解析 2 项、模拟 Lark 身份字段归一化 2 项。函数从本机源码 AST 提取,没有导入完整 Hermes 或建立外部连接;不等于完整上游测试或部署验证。
  • 沙盒补充核验另执行 9 项有限离线断言:Session/Profile 作用域 5 项、会话与父子 Agent 的容器标识 2 项、模拟 Docker 环境的会话生命周期标记 2 项。未调用 Docker,也未启动实际容器或完整 Agent。
  • 没有读取密钥、修改 Hermes 配置、启动或重启机器人,也没有连接 Lark、Casdoor、1Password 或 ERP 做真实联调。所查解释器环境未直接提供 pytest,未安装依赖或运行完整测试套件。
  • 默认 ~/.hermes/profiles/ 目录在核验时不存在;不能将「本机已安装 Hermes」理解为已配置并验证三个业务 Profile,也未据此排除非默认数据目录中的配置。
  • 当前图仍是目标架构;本核验不改变其「暂定终版、尚未实现或联调」状态,也不把自研集成改标为原生功能。