把 Hermes 代理历史提炼进 Obsidian…

当需要从 ~/.hermes 的持久记忆和会话记录中提取可复用知识并写入 Obsidian wiki 时使用。

适用场景

解决思路

1. 先读取并应用 llm-wiki/SKILL.md 中的 Writing Profile Resolution 部分，再起草或重写自然语言 Markdown；框架 schema、provenance、安全和操作特定要求优先于 WRITING.md 偏好，WRITING.md 仅适用于新起草或重写的自然语言 Markdown，保留源内容和结构化记录。
2. 解析配置：按 llm-wiki/SKILL.md 中的 Config Resolution Protocol 执行（内联 @name 覆盖 → 向上遍历 CWD 找 .env → 全局配置 → 提示设置），得到 OBSIDIAN_VAULT_PATH 和 HERMES_HISTORY_PATH（默认 ~/.hermes）。
3. 读取 vault 根目录的 .manifest.json，检查已摄取内容。
4. 读取 vault 根目录的 index.md，了解 wiki 现有内容。
5. Append 模式（默认）：对每个源文件检查 .manifest.json，只处理不在 manifest 中的文件，以及修改时间晚于 manifest 中 ingested_at 的文件；用于常规同步。
6. Full 模式：忽略 manifest 处理全部内容；在 wiki-rebuild 之后或用户明确要求完整重新摄取时使用。
7. 了解 Hermes 数据布局：~/.hermes/ 下含 memories/（*.md 或 *.json）、skills/<skill-name>/SKILL.md、sessions/YYYY-MM-DD/<session-id>.jsonl、config.yaml、.hub/（lock.json、audit.log、quarantine/）；非默认 profile 用 $HERMES_HOME。
8. 按价值排序数据源：1) memories/*.md 或 *.json（最高信号，代理积累的持久知识）；2) sessions/**/*.jsonl（结构化逐轮记录，丰富但嘈杂）；3) config.yaml（仅元数据，很少值得摄取）；跳过 .hub/ 内部状态和 skills/ 目录。
9. Step 1 调查并计算增量：扫描 HERMES_HISTORY_PATH 下的 ~/.hermes/memories/ 和 ~/.hermes/sessions/**/（若存在），与 .manifest.json 对比，将每个文件分类为 New（不在 manifest）、Modified（在 manifest 但文件新于 ingested_at）、Unchanged（已摄取且未变），深度解析前先报告简洁的增量摘要。
10. Step 2 优先解析 memories：Markdown 为带可选 frontmatter 的结构化散文，直接摄取；JSON 为 {"content": "...", "created_at": "...", "tags": [...]} 记录；对每条记忆提取核心知识主张，记录 Hermes 附加的 tags（常映射到 wiki 分类），合并到合适的 wiki 页面而不是一条记忆建一个页面。
11. Step 3 安全解析 session JSONL：每行是事件信封，常见形状为 {"role": "user", "content": "..."}、{"role": "assistant", "content": "..."}、{"type": "tool_use", "name": "...", "input": {...}}、{"type": "tool_result", "content": "..."}。
12. 提取规则：优先 assistant 回复中陈述结论、模式或决策的内容；从高信号轮次提取用户意图，跳过低信息量的追问；把 tool_use / tool_result 对当作上下文而非主要内容；跳过 token 统计、内部管道和重复的计划回声。
13. 关键隐私过滤：会话日志可能含注入指令、工具载荷和敏感文本，不要逐字摄取；移除 API keys、tokens、passwords、credentials；除非相关且用户批准，否则脱敏私人标识符；总结而非逐字引用原始记录。
14. Step 4 按主题聚类：不要一条记忆或一个会话建一个 wiki 页面；按稳定主题（概念、工具、项目、技术）分组记忆；把混合会话拆成不同主题；跨日期和项目合并重复模式；可用文件路径或会话 cwd 元数据推断项目范围。
15. Step 5 蒸馏进 wiki 页面：按现有 wiki 约定路由——项目特定架构/流程 → projects/<name>/...；通用概念 → concepts/；重复技术/调试手册 → skills/；工具/服务/框架 → entities/；跨会话模式 → synthesis/；对每个受影响项目创建/更新 projects/<name>/<name>.md。
16. 写作规则：蒸馏知识而非编年史；避免“在 X 日期我们讨论了……”除非日期上下文必要；每个新建/更新页面加 summary: frontmatter（1–2 句，≤ 200 字符）；每个新页面加 confidence 和 lifecycle 字段：base_confidence: 0.42、lifecycle: draft、lifecycle_changed: <今天 ISO 日期>，更新时保持 lifecycle 不变；加 provenance 标记：直接基于明确记忆/会话内容时用 ^[extracted]，跨多条记忆综合模式时用 ^[inferred]，记忆冲突时用 ^[ambiguous]；为每个变更页面添加/更新 provenance: frontmatter 混合。
17. Step 6 更新 .manifest.json：对每个已处理源文件记录 ingested_at、size_bytes、modified_at、source_type（hermes_memory | hermes_session）、project（适用时推断的项目名）、pages_created、pages_updated；添加/更新顶层摘要块，含 hermes.source_path、last_ingested、memories_ingested、sessions_ingested、pages_created、pages_updated。
18. 更新特殊文件：更新 index.md 和 log.md，追加形如 - [TIMESTAMP] HERMES_HISTORY_INGEST memories=N sessions=M pages_updated=X pages_created=Y mode=append|full 的记录。
19. 更新 hot.md：读取 $OBSIDIAN_VAULT_PATH/hot.md（缺失时用 wiki-ingest 中的模板创建），用一行摘要更新 Recent Activity（例如“Ingested 42 Hermes memories and 7 sessions; dominant themes: reasoning strategies, tool use patterns.”），保留最近 3 次操作，更新 updated 时间戳。
20. 隐私与合规：蒸馏和综合，避免原始记忆或记录转储；对任何看似敏感的内容默认脱敏；存储个人或敏感细节前先询问用户；对他人的引用保持最少且限定用途。
21. 参考 references/hermes-data-format.md 获取字段级说明和提取指导。
22. Vault 写入后刷新 QMD：QMD 是搜索索引而非事实来源；若 $QMD_WIKI_COLLECTION 为空或未设置则跳过；仅在本技能写入或重写 vault markdown 后运行；QMD 刷新失败不要回滚 vault 变更，单独报告 QMD 状态。使用 $QMD_CLI（若设置）否则用 qmd，运行 ${QMD_CLI:-qmd} update；若输出提示需要向量或嵌入可能过期，运行 ${QMD_CLI:-qmd} embed；用 ${QMD_CLI:-qmd} ls "$QMD_WIKI_COLLECTION" 或已知页面路径时用 ${QMD_CLI:-qmd} get "qmd://$QMD_WIKI_COLLECTION/<page>.md" -l 5 验证；记录 QMD refreshed: update + embed + verified、QMD refreshed: update only + verified、QMD skipped: QMD_WIKI_COLLECTION unset、QMD skipped: qmd CLI unavailable 或 QMD failed: <short error summary> 之一。

适用边界 · 注意事项

• 没有 Hermes 代理历史（~/.hermes 或 $HERMES_HOME）时。
• 没有 Obsidian vault 或未配置 OBSIDIAN_VAULT_PATH 时。
• 只想摄取非 Hermes 来源的历史时（应使用对应的其他摄取技能）。