brief.md

Brief

当前目标

在 Mac mini 上为 Hermes Gateway 建立一套长期可维护的 ConversationSpec 架构。
每个 Feishu thread / 会话都自动创建 spec，避免长会话遗忘上下文。
自动创建不等于自动乱总结：新 spec 先是低噪音草稿，真实目标、任务、决策需要基于历史证据、用户澄清或后续对话逐步完善。
所有可发布 thread specs 定期发布到观澜台 /thread/，作为统一查看入口。

最小上下文

不把每个会话都塞进长期 memory；memory 只存稳定偏好。
每个 Feishu thread 维护独立 spec：brief / decisions / tasks / context / open questions / archive。
默认渐进式披露：先加载 brief、tasks、decisions；需要时再展开 context 或查原始 session。
自动 hook 在 response-ready 后 fail-soft 运行，不影响正常回复投递；配置和 threadspec.py 每次调用热读取，减少重启依赖。

Decisions

采用 ConversationSpec 作为长会话状态层。
全局 memory 只存长期稳定事实；临时任务、会话进度、阶段性安排不进 memory。
每个重要 thread 建独立目录：~/.hermes/thread_specs/<platform>/<chat>/<thread>/。
观澜台开根目录 /thread/，发布所有 specs 的静态 HTML viewer。
OpenSpec 可作为思想来源；Hermes 聊天场景先实现轻量版，不直接强依赖 OpenSpec runtime。
回复和上下文加载遵循渐进式披露：brief first, details on demand。
已决定把 ConversationSpec 接入 Hermes gateway response-ready 生命周期：agent 生成 final response 后，gateway 异步触发 spec 自动更新；hook 必须 fail-soft，不影响回复投递。
自动更新默认启用 Feishu 且要求 thread_id，避免全平台误触；开关在 ~/.hermes/config.yaml 的 conversation_spec.auto_update。hook 每轮热读取配置和脚本，减少对 gateway 重启的依赖。
自动更新采用本地确定性脚本，不额外调用 LLM，避免增加响应延迟和模型成本。
自动创建 spec，但内容要谨慎：每个新 thread 都应自动创建 ConversationSpec 草稿；初始内容只能是低噪音占位、必要证据和待澄清项，不能从单轮消息猜真实目标。后续通过检索历史、用户澄清或继续对话逐步完善。
已存在且人工整理过的 spec 才允许 auto-update 更新最近状态、archive，并保守捕捉明确任务/问题；不得覆盖 title/chat_id/created_at 等人工整理元数据。
/thread/ 是观澜台的一等入口：已从 ABOS 首页导航、Hero 按钮和 Notes 卡片链接过去。
Thread Specs viewer 必须沿用观澜首页设计语言，新增 spec 渲染也默认套用：米色纸感、蓝绿水墨、ABOS 固定导航、卡片式信息层级。
误发到本 thread 的平台架构分支不进入本 spec 的长期决策；本 thread 继续聚焦 ConversationSpec。

tasks.md

Tasks

Todo

[ ] 完成 gateway 外部重启后的真实 Feishu E2E：重启后在当前 thread 发一条真实消息，确认 last_auto_update_at 自动推进到真实 session。
[ ] 后续从 session_search/session files 为重要 thread 做内容级 backfill，不只创建占位。
[ ] 观察自动创建的每会话 spec：确认只生成低噪音草稿，待澄清项进入 open_questions.md，不随便猜目标/任务。

Doing

暂无。

Done

[x] 明确不采用“每会话长期 memory”作为主方案。
[x] 明确 OpenSpec 与 Hermes 聊天方式的映射。
[x] 明确观澜台作为公开 spec 查看入口。
[x] 实现本地 ConversationSpec 脚本。
[x] 发布观澜台 /thread/ viewer。
[x] 配置定期同步 cron。
[x] 沉淀 Hermes skill：conversation-spec。
[x] 把漏项写回当前 spec，避免只在聊天里说完就忘。
[x] 补发布前敏感信息扫描：命中 secret/token/cookie/private key 的 spec 跳过公网发布。
[x] 补 private spec 支持：meta.json private=true 或 .private 文件。
[x] 补发布快照：~/.hermes/thread_specs/.snapshots/thread_specs-*.tar.gz，保留最近 30 份。
[x] 补 health.json / manifest.json。
[x] 补 viewer 状态信息：任务统计、未决问题、过期天数、跳过发布数量。
[x] 补恢复入口：threadspec.py recover。
[x] 补现有 Feishu topic 回填能力：threadspec.py backfill-feishu。
[x] 新增 gateway/conversation_spec_hook.py，提供 fail-soft 异步自动更新 hook。
[x] 在 gateway/run.py 的 response ready 后接入 schedule_conversation_spec_update()。
[x] 给 threadspec.py 新增 auto-update 子命令。
[x] 在 ~/.hermes/config.yaml 新增 conversation_spec.auto_update: true，限制 platforms: [feishu] 且 require_thread: true。
[x] 完成 py_compile 验证：gateway/conversation_spec_hook.py、gateway/run.py、threadspec.py。
[x] 完成本地模拟 auto-update 验证：last_auto_update_at、last_session_id、brief 最近状态均能更新。
[x] 修正 init spec 策略：每个新 thread 自动创建 spec 草稿，但只写低噪音占位/证据/待澄清项，不从单轮消息猜真实目标。
[x] 更新 conversation-spec skill 和 gateway hook reference：自动创建与内容谨慎是两件事；不确定项可向用户澄清或逐步完善。
[x] 把 Thread Specs 链接加入观澜首页导航、Hero 按钮和 Notes 卡片。
[x] 将 /thread/ viewer 和新增 spec 详情页统一为观澜首页设计样式：米色纸感、蓝绿水墨、ABOS 顶部导航、卡片布局。
[x] 发布并验证：https://abos-at.work/、https://abos-at.work/thread/、当前详情页、health.json 均返回 200，且内容命中。
[x] 移除误发到本 thread 的 abos-at.work / Mini 自优化观测平台 分支内容，恢复 ConversationSpec 主线。

open_questions.md

Open Questions

回填旧 thread 时，是只做占位，还是用 session_search/LLM 总结历史？当前已实现占位回填，内容级回填待后续执行。
是否需要为每个 thread 生成“最近 7 天变更摘要”？可由 cron 后续加 agent job 实现。
ConversationSpec 自动更新是否需要更强的“错窗口/临时分支”识别机制，避免用户发错窗口时污染当前 spec？

context.md

Context

背景

用户提出：Hermes 会话聊久后容易忘记前面安排和上下文，需要机制化解决。探索 OpenSpec 后，判断其核心价值是“把意图沉淀为工件”，适合借鉴，但 Hermes 聊天场景不必完整引入代码开发向 OpenSpec 流程。

架构

Global Memory
  稳定偏好、长期事实

ConversationSpec
  每个 thread 的当前目标、决策、任务、背景、未决问题

Session History
  原始记录，需要追溯时 session_search

观澜台 /thread/
  所有可发布 specs 的 HTML 索引和详情页

核心原则

每个 Feishu thread / 会话都自动创建 spec，避免漏建。
自动创建只负责建立结构和记录低噪音证据；不要从一轮消息随便推断真实目标、任务或决策。
不确定内容进入 open_questions.md；如果用户澄清成本低，可以直接问用户。
后续通过 session_search、session files、用户澄清和继续对话逐步完善 spec。

本地目录

~/.hermes/thread_specs/
└── feishu/
    └── IM与AI/
        └── omt_1923b78caa8f5b89/
            ├── meta.json
            ├── brief.md
            ├── decisions.md
            ├── tasks.md
            ├── context.md
            ├── open_questions.md
            └── archive.md

观澜台路径

https://abos-at.work/thread/

底层映射：

https://abos-at.work/thread/ -> /tmp/cc-wechat/files/thread/

实现组件

~/.hermes/scripts/threadspec.py
  create / append / recover / render / publish / list / snapshot / backfill-feishu / auto-update

~/.hermes/scripts/publish-thread-specs.sh
  cron 薄壳，调用 threadspec.py publish

Hermes cron
  job_id: e353051ee8d9
  name: publish-thread-specs-to-guanlan
  schedule: */15 * * * *
  no_agent: true
  deliver: local

gateway/conversation_spec_hook.py + gateway/run.py
  response ready 后 fail-soft 异步触发 auto-update

已补的防忘机制

把漏项直接写入本 spec 的 tasks/open_questions/context，后续照 spec 执行。
发布前生成本地 tar.gz 快照，保留最近 30 份。
发布前扫描疑似敏感信息；命中 secret/token/cookie/private key 的 spec 不发布到公网。
支持 private spec：meta.json private=true 或目录下 .private 文件，默认跳过公网发布。
观澜 viewer 生成 health.json 和 manifest.json，展示发布数量、跳过数量、过期 specs。
首页展示状态、任务数、未决问题数、7 天未更新数量。
新增 recover 命令：恢复上下文时只输出 brief/tasks/decisions/open_questions。
新增 backfill-feishu 命令：从 channel_directory.json 回填已有 Feishu topics 的占位 spec。
新增 auto-update：每轮完成后自动创建/更新当前 thread spec。

archive.md

Mini Hermes Gateway Architecture & ConversationSpec

Brief

当前目标

最小上下文

最近状态

Decisions

Tasks

Todo

Doing

Done

Open Questions

Context

背景

架构

核心原则

本地目录

观澜台路径

实现组件

已补的防忘机制

Archive

2026-07-03 00:18 自动更新

2026-07-03 00:19 自动更新

2026-07-03 00:59 自动更新

2026-07-03 01:11 自动更新

2026-07-03 01:18 自动更新

2026-07-03 01:25 自动更新

2026-07-03 01:34 自动更新

2026-07-03 01:59 自动更新

2026-07-03 02:04 自动更新

2026-07-03 02:09 自动更新