共用底座交互架构图
职责与边界
共用底座.html 是解释一次通用任务如何经过共用底座的自包含文档,不是研发交付流程、运行监控或真实审批系统。采用自由探索而非逐步播放:读者点击组件查看职责、直接上下游与权限边界。
原独立 SVG 被 HTML 完全替换,仓库内入口指向 HTML;页面无需后端或外部依赖,可直接本地打开。连接线虽然用内联 SVG 绘制,但不另行维护可独立交付的 SVG 版本,避免静态图与交互图分叉。
产品方案与目录
通用架构与 Hermes Agent、OpenMausBot 两个产品方案通过左侧目录互相访问;窄屏目录移到内容上方。目录使用原生链接,当前方案有 aria-current,各 HTML 可直接本地打开;返回主报告时回到顶层,避免在阅读框架内嵌套报告。主报告和研发流程不因增加产品方案而改写。
产品页是静态目标架构,不模拟产品运行。Hermes Agent 方案标为「暂定终版」,只表示本轮静态方案收口,不代表已实现或联调;OpenMausBot 仍为候选方案。二者共享页面模板与交互,但主图节点和路径分别维护。
Hermes Agent:员工权限主线(暂定终版)
Gateway 按 Lark 机器人区分业务:财务机器人 → 财务 Profile,人事机器人 → 人事 Profile,行政机器人 → 行政 Profile。三个 Hermes Profile 各自独立、互不耦合,由同一个 Hermes Gateway 托管,分别指定业务权限域和 1Password 凭证映射。先用 Profile 圈定业务及该 Profile 可用的 MCP,再在这些 MCP 的代码 / 工具级落实 Casdoor 返回的业务权限范围,限制可读资源和可执行动作;不只依赖提示词,不混用业务配置。员工身份与 Casdoor 查询保留原链路,真实工具凭证仍由 1Password 保管。
主链为 Lark → Hermes Gateway(hermesgw,识别 Lark 员工身份)→ Casdoor(返回能读什么、能做什么)→ Gateway(取得员工权限域)→ 1Password(取相关工具凭证)→ Hermes Session(限制对应工具权限)→ 自研 MCP 安全网关 → 业务系统(财务 ERP、知识库等)。Gateway 在图中只画一次,Casdoor 的查询与权限返回分别画为两条有向边。
权限与凭证分路交付:Gateway 经自研服务端适配按已核验的员工身份与权限域取用 1Password 凭证;真实工具凭证仅经可信服务端交给 MCP 安全网关代持,Session 只接收权限域与凭证引用或受限调用凭据。图中单独画出 1Password → MCP 安全网关,禁止把真实凭证路径画成经过 Session。Session 限制工具、资源范围和动作,不只依赖提示词;网关仍须逐次验证员工授权上下文与凭证引用,再携真实凭证调用业务系统。身份、权限或凭证核验失败即拒绝受保护访问;不同员工的上下文与凭证引用不得串用。
主图为七个节点、八条有向边。原图中的工作流编排、沙盒、Memory / Skills、审计等按本轮确认统一在业务系统侧呈现,不再作为主链中间节点。这是展示分组,不表示全部外部化、已有 MCP 接口或改变原生归属:Memory / Skills 仍由 Hermes 原生维护,企业知识库独立;业务状态与人工等待由编排维护,沙盒隔离和生命周期、审计与计量分别承担原有职责。
Hermes Gateway 与 Session 是原生基础,但 Lark 员工身份映射、Casdoor 授权查询、1Password 凭证映射及交付、Session 员工权限装配均属于本项目自研适配,节点须同时标明原生基础与自研约束,不宣称上游已提供完整集成。1Password 不决定员工权限,也不假定它原生按员工权限自动发放短期凭证。权限新鲜度、撤权传播、凭证轮换、隔离与禁止旁路均须锁定版本并验证。MCP 安全网关沿用原自研 MCP 代持网关的凭证代持职责,不采购第三方代持;真实凭证不进模型、Session、沙盒或审计正文。
本机 v0.23.1 的原生能力、自研边界及验证范围见 Hermes 本机版本能力核验。原生多 Profile Gateway、MCP 配置和 1Password 密钥源均有源码依据,但原生密钥注入不等于本方案的外部网关独占真实业务凭证;Casdoor 对接与工具级业务授权仍需自研。
OpenMausBot:保留原候选主线
原调度中心展开为十节点目标图:业务入口 → 事件接入与业务检查(自研)→ OpenMausBot(原生)→ 对应工作流(自研编排)→ 沙盒里的 Agent(共用执行环境)→ 自研 MCP 代持网关 → 工具与业务系统(共用)。
OpenMausBot 的四个自研控制组件是事件接入与业务检查、可靠工作流编排、员工授权适配、MCP 代持网关;外围共用节点是业务入口、身份与凭证、沙盒、工具与业务系统、历史 / 审计 / 计量。事件经接入层验签、去重与业务检查后直接交给产品,产品自己找对应工作流;编排派工时同时拉起沙盒、取员工凭证,凭证交给代持网关持有,不下发到沙盒。环境与执行策略不单独成组件:环境在派工时拉起、随任务回收,这部分职责写在编排与沙盒节点里。
三处职责归属是明确的:在产品方案里 Memory / Skills 与会话记忆由开源产品原生承担,不再单列自研 RSI 写回组件,本项目只约束读取范围、写权限与留存;通用架构与主报告的 RSI 设计本次未改,两者差异属于“是否更换调度中心”的分支。MCP 代持网关自研,不采购第三方代持,真实凭证不进模型、沙盒或审计正文;产品的运行后端(Docker / SSH 或 Drivers)只是沙盒载体,支持它不等于具备隔离保证。
OpenMausBot 图中的沙盒画在替换区内只表示它由编排派工时拉起、生命周期跟着任务走;它是共用基础设施而不是自研组件,图注与说明都写明这一点。Hermes 图不再维护该替换区。
原生能力、自研补齐和共用组件用文字与不同边框/填充共同区分;产品会话、工具批准、定时触发不等同业务状态、员工审批或可靠流程。上游公开资料只是能力依据,不是完成集成、安全验证或部署的证明。OpenMausBot 的受限 MCP 控制面不被描述为能批准授权或管理电脑生命周期。
两产品页由 scripts/build-foundation-pages.py 的共享模板与各产品数据生成;每个方案的节点与边在生成器里定义一次,SVG 与说明栏共用该方案的同一份数据。提交的 HTML 仍各自自包含,无运行时资源依赖。结构测试约束生成结果一致、导航目标存在、图中关系端点有效、节点集合与角色(自研 / 原生 / 共用)、交互契约及关键产品边界。页面提供自研职责、原生能力、官方来源及文字路径;图的横向滚动限制在画布内,不挤出整页。
Hermes V2 分层流水蓝图
Hermes V2 参考 V1,仅展示指定的十一个组件及其连接:Lark、Web UI、Hermes Gateway、Casdoor、Hermes Session、Hermes Memory、Hermes Skills、1Password、MCP 安全网关、知识库、业务系统。保留有组件的五个职责层,自上而下为交互、安全、Hermes 运行、知识与记忆、业务系统;不保留空模型层,不展开执行链、治理侧栏或其他候选组件。Lark 与 Web UI 并列位于交互层,均经 Hermes Gateway 接收消息并返回回复,不直接访问业务工具。V2 位于「共用底座」,不替换 V1、不扩大权限。
Hermes Gateway 负责消息与会话路由,MCP 安全网关负责工具访问与凭证代持。Session 与 Memory / Skills、MCP 的连接概括 Hermes 会话内的处理关系,不表示 SessionStore 本身执行全部动作;省略接入、执行、编排与逐系统适配细节,不删除 V1 对这些职责的约束。Casdoor 的员工核验与配套权限服务、1Password 的凭证交付仍需可信适配。业务与企业知识访问均经 MCP 安全网关,真实业务凭证不交给模型或会话;知识库独立于原生 Memory / Skills,业务系统保留事实权威。
气泡与分层位置保持静态,所有连接为平滑贝塞尔曲线,不使用直角折线。业务、授权、知识关系用颜色和线型共同区分;双向箭头表示请求与响应或读取与维护,流水只辅助理解连接方向,不模拟真实运行。筛选突出指定关系,选择节点突出筛选内的直接连接;说明区列出全部直接关系,双向关系在上下游均可见。交叉不表示相连,分层不表示串行步骤。
生成器以同一份数据输出自包含 HTML 的静态 SVG、连接与说明;无脚本时仍可看图。暂停 / 继续流水、减少动态、后台暂停、键盘选择、缩放和画布内滚动均为阅读控制。画布默认按原始 1200 单位宽度的 70% 显示,缩放范围为 25%–200%;放大 / 缩小按钮每次改变 10 个百分点,显示当前比例,重置回 70%。Ctrl / Command 加滚轮在鼠标附近缩放,普通滚轮不被接管;适应宽度会随阅读区宽度变化更新。SVG 实际布局尺寸随比例变化,避免视觉大小与滚动范围不一致。站内 VuePress 页面与独立原件使用同一份缩放实现。页面保持短说明与组件详情,不继续扩展为完整部署或验收报告。
数字员工分层图
数字员工栏目保留原版五层逻辑职责 SVG,另以目标静态架构v2 展示六层底座与治理中枢;均不替代共用底座交互图,也不表示严格调用顺序。IdP 确定采用 Casdoor,凭证保管采用 1Password;身份核验、动作授权、凭证保管仍各有边界,不因产品名确定就宣称完成集成。沙盒与审计标为「待选型」,考察开源方案;知识库独立选型,不以 Hermes 原生 Memory / Skills 替代企业知识底座。Memory / Skills 保持 Hermes 原生归属,知识库的接入、权限隔离与读写边界另行验证。MCP 安全网关明确自研。v2 的安全层组合 Casdoor、1Password 与 MCP 安全网关,分别承担身份与权限判断、凭证保管、调用时的授权执行;不是三者都属于 IdP,也不表示只在入口鉴权。v2 的入口范围包括 Lark、Slack、Web UI 与邮件,列表只展示名称、无括号说明,Lark 高亮;新增渠道接入、来源验证及身份映射待验证。Grokbot 仅按需求方说明纳入外部任务执行候选,单向任务下发不等于完成确认、结果回收或可靠工作流,相关能力与授权边界待验证;不因同名关联而等同于 Grok 模型。原版“大模型不列入本轮选型”的历史口径不再用于 v2 的产品展示:v2 首选 GPT,Grok 紧随其后作为可选模型,展示次序不是性能排名。组件清单与具体状态以选型报告第 9.6 节为准。
关系与交互契约
节点与有向边是画布和说明栏共同的数据来源。选择组件时,只突出自身、直接相连的组件与相应连接;不把所有可达节点误称为直接上下游。说明栏的关系入口可继续选择组件;取消选择恢复全图。通用图还提供定位、缩放与适应宽度;产品图按宽度铺满,只保留选择与说明,不重复这些工具条。定位、缩放和滚动只改变阅读视图,不模拟业务执行或授权。
产品图的说明区在画布下方而不是粘性侧栏,窄屏不需要第二套布局;选中后原位的「清除选择」「查看说明」才出现。OpenMausBot 产品与记录节点之间是一条双向点线:说明栏按方向分别读作「执行记录、审计与计量」与「复盘写回 Memory / Skills(产品原生)」,不把一条双向关系说成一句话。
任务调用、授权凭证、记录知识通过颜色和不同线型共同区分;连线交叉不代表连接。调用响应沿原路返回,业务事件回调单独标示。通用图文案说明 IdP / 权限服务、Vault、Harness、沙盒、模型网关、MCP 代理网关和受控网络出口的不同职责;OpenMausBot 图把 IdP 与 Vault 合成「身份与凭证」、把 MCP 工具与业务系统合成「工具与业务系统」。Hermes 图分别展示 Casdoor 与 1Password,权限返回与真实凭证交付用不同路径表达。两方案都写明自研 MCP 网关提供 MCP Server 端点,真实工具调用凭证留在可信服务端。
OpenMausBot 图的执行记录、审计、计量合为一个节点,Hermes 图将其归入业务系统侧;三者分别保存、不互相替代。记忆与 Skills 保持开源产品原生归属,不因展示分组而重建。业务系统保留各自的权威结果,Agent 不替人审批、合并代码或发布生产。未验证的 Lark 审批、产品选型和安全实现不标为已接入或已实现。
可访问性与窄屏
组件使用可聚焦按钮,Enter 可选择,Esc、空白画布或显示全图可取消选择,选择变化提供屏幕阅读器提示。说明栏中的组件入口保持键盘可操作。产品页的节点是可聚焦的 SVG 按钮组(role="button" + aria-pressed + aria-controls),说明区是 aria-live 区域并在选中时原位出现清除与跳转入口。窄屏将说明移到画布下方,提供跳转说明入口;画布内部滚动,不造成整页横向溢出。通用图的缩放有上下限,并可适应可见宽度。