What’s New

从项目说明页推进到可审查的产品入口

这不是新能力发布,而是把已经存在的运行路径、文档入口和验证边界整理成更容易判断的首页。

live

GitHub Pages 已上线

官网通过 `site/` 静态根目录发布,当前路径是 `zcxggmu.github.io/hermes-hip/`。

ready

本地 smoke 可复制

保留不依赖外部凭据的 start、status、emit 和 preflight 试跑路径。

opt-in

Observer 保持显式启用

页面只说明安装与启用边界,不暗示 Hermes observer plugin 自动开启。

pending

真实 live pass 未宣称

Discord/Hermes live verification 仍按 runbook 记录,不在首页写成已完成。

Method

Observe · Scrub · Deliver

首页保留工程细节,但对外先给出更容易记住的三步方法论。

01

Observe

从 Hermes hook、CLI、本地 source 和可选 observer plugin 捕获事件,不把 agent 上下文当消息队列。

02

Scrub

先做 typed envelope 与 privacy scrub,只保留路由、渲染和审计需要的安全字段。

03

Deliver

按 route filter 选择目标 sink,输出 compact、inline 或 alert 形式,并保留清晰失败边界。

30 秒本地试跑

先看见管道,再决定接入什么

第一次运行会先编译,不需要 Discord 凭据。这个入口只是证明 Hermeship 的基础命令、事件流和 preflight 记录都能在本地跑通。

Quickstart

copy & run

cargo run -- start
cargo run -- status
cargo run -- explain hermes.agent.started --payload '{"session_id":"demo","platform":"telegram","project":"Hermeship"}'
cargo run -- emit hermes.agent.started --payload '{"session_id":"demo","platform":"telegram","project":"Hermeship"}'
cargo run -- release preflight 0.1.0

如果你只想确认边界,先看 证据边界;如果你只想确认结构,先看 工作流

工作流路径

ingest → normalize → scrub → route → render → deliver

每一跳都独立、可解释、可失败。Hermeship 先把事件变成 typed envelope,再决定投递到哪里,以及是否需要裁剪敏感内容。

  1. 01

    Ingest

    接入 gateway hooks、CLI、observer plugin 和本地 source 命令。

  2. 02

    Normalize

    统一 event envelope、body 和 metadata,避免上游格式飘移。

  3. 03

    Scrub

    先做隐私清洗,再进入路由与渲染,避免原始噪音外泄。

  4. 04

    Route

    按事件、平台、项目和 route filter 选择目标 sink。

  5. 05

    Render

    把事件变成适合通知渠道的 compact、inline 或 alert 形式。

  6. 06

    Deliver

    交给 sink 执行投递,失败也要回传明确的边界信号。

能力矩阵

说清楚默认可用、显式启用和边界之外

这个矩阵只列真实可用的能力,不把后续范围包装成现成能力。

能力 状态 说明
daemon + HTTP ingress 默认 提供 health、event 和 Hermes hook 接口。
typed event envelope 默认 统一 canonical event body、metadata 和路由所需字段。
Discord sink 需配置 配置 Discord bot token/channel 或 webhook 后可投递。
Observer plugin 显式启用 需要 operator 安装并在 Hermes 中手动启用。
Slack sink 边界外 不在默认范围,不对外宣称已支持。
GitHub API polling 后续 仍是后续范围,当前只保留本地 deterministic source。
release preflight 记录 证明记录字段存在,不等于真实 live pass。

架构与图表

把流程、边界和联合工作流拆开看

图表来自仓库现有资产,优先展示真实架构,不做新的宣传插画。

Hermeship 总体架构图
总体管道:daemon、router、renderer 和 sink。
Hermeship observer framework 图
observer 只暴露安全摘要,不扩大 Hermes 上下文。
Hermeship GitHub Discord Codex 联合工作流图
联合工作流只展示协作路径,不暗示 GitHub polling 已上线。
Hermeship 事件流图
事件流从 ingest 到 delivery 的每一跳都可解释。

Evidence & Boundaries

信任来自证据,而不是把后续范围写成现成能力

Hermeship 的价值在于明确边界。页面中的每个状态都要能回到 README、spec、development-status 或 runbook,而不是只靠营销文案支撑。

Local proof deterministic smoke

Quickstart 证明本地命令和 event pipeline 能跑通,不证明真实外部系统。

Release proof preflight records

preflight 证明记录字段存在,不等于 Discord/Hermes live pass。

Operator proof manual observer enablement

observer plugin 由 operator 显式安装和启用,不自动改 Hermes 配置。

  • Hermeship 不修改 Hermes core,也不把通知消息写回 Hermes 对话上下文。
  • Observer plugin 需要 operator 显式安装并手动启用。
  • Slack sink 不在默认范围,页面不能暗示已经支持。
  • GitHub API polling 仍是后续范围,页面不能暗示已上线。
  • Real Discord/Hermes live verification pass 未获得,页面不能写成已完成。
  • release preflight 只证明记录字段存在,不证明线上环境已经通过。
  • 页面中不出现 raw prompt、conversation history、request/response body、secret 或 session_key 的外发暗示。

如果某个叙述不能被 README、spec 或 development-status 直接支撑,就不要放到首页里。