@riconext/hermes-repo 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.2.0
+
+### Minor Changes
+
+- 4e1a9f7: 新增 capture 后自动 flush 调度配置。开启 `consolidate.autoFlush.enabled` 后，capture 成功写入时会根据待处理 session 数量、距离上次 flush 的时间和待处理内容字符数，在后台触发 `hermes-repo flush`。
+
+## 1.1.1
+
+### Patch Changes
+
+- cfa583b: 合并 llm 配置读取到通用配置模块，删除 readLlmConfig.ts 和 mergeLlmConfig.ts
+
 ## 1.1.0
 
 ### Minor Changes

package/README.md

@@ -76,8 +76,7 @@ hermes-repo 是挂在**你的 Git 项目**上的记忆层：不改变你平时
                 ▼
         在项目中创建/合并:
         ├── .memory/
-        │   ├── config.json           # version, storage, assistants[], debug
-        │   ├── llm.json              # [个人] 可选 LLM（gitignore，init 可生成示例）
+        │   ├── config.json           # version, storage, assistants[], debug, llm
         │   ├── captures/
         │   │   ├── semantic/         # [个人] 语义记忆
         │   │   ├── episodic/       # [个人] 情景记忆
@@ -114,7 +113,7 @@ Stop / stop hook → npx @riconext/hermes-repo capture
   2. 读取会话 transcript（JSONL 等）
   3. shouldCapture 质量过滤（过短/无信号 → exit 0 跳过）
   4. 启发式写入 captures/<type>/capture-YYYY-MM-DD-NNN.md
-  5. 若 llm.json 启用：入队 capture-llm 后台任务（detached）升级正文
+  5. 若 config.json 中 llm 启用：入队 capture-llm 后台任务（detached）升级正文
   6. 达阈值时 maybeScheduleConsolidate → 后台 flush（detached）
 
 flush / runConsolidate（手动或 capture 后自动）:
@@ -182,7 +181,7 @@ init 脚手架 → 日常编码（助手 + hooks）
 
 ```text
 .memory/
-├── llm.json      # 个人：可选 LLM API（gitignore，勿提交）
+├── config.json   # 个人：助手与 LLM 配置，含 apiKey，gitignore，勿提交
 ├── captures/     # 个人：semantic / episodic / procedural 原始捕获
 ├── topics/       # 团队：按主题整理后的约定
 ├── skills/       # 团队：可复用 SKILL.md
@@ -191,7 +190,6 @@ init 脚手架 → 日常编码（助手 + hooks）
 ├── refs/         # 个人：引用反馈（flush 时聚合）
 ├── promote/      # 个人：晋升 PR 草案（gitignore）
 ├── team/         # 团队：决策与冲突记录
-└── config.json   # 已启用助手、存储后端等
 ```
 
 架构细节、hooks 契约与 MCP 远期方案见 [设计文档 · 整体架构](docs/hermes-repo-design.md#整体架构)。
@@ -257,22 +255,32 @@ hermes-repo 的 **hooks 路径不依赖 LLM**（捕获、注入始终快速返
 npx @riconext/hermes-repo init
 ```
 
-按提示填写 API 地址、模型名与密钥；会写入 `.memory/llm.json`。
+按提示填写 API 地址、模型名与密钥；会写入 `.memory/config.json` 的 `llm` 字段。
 
 **方式二：手动编辑**
 
-`init` 会在 `.memory/templates/llm.json.example` 提供示例。复制或编辑 `.memory/llm.json`：
+编辑 `.memory/config.json`：
 
 ```json
 {
-  "enabled": true,
-  "provider": "openai",
-  "baseUrl": "https://api.deepseek.com",
-  "model": "deepseek-v4-flash",
-  "apiKey": "你的密钥",
-  "timeoutMs": 60000,
-  "maxInputChars": 24000,
-  "mode": "async"
+  "llm": {
+    "enabled": true,
+    "provider": "openai",
+    "baseUrl": "https://api.deepseek.com",
+    "model": "deepseek-v4-flash",
+    "apiKey": "你的密钥",
+    "timeoutMs": 60000,
+    "maxInputChars": 24000,
+    "mode": "async"
+  },
+  "consolidate": {
+    "autoFlush": {
+      "enabled": false,
+      "minPendingSessions": 3,
+      "minIntervalMinutes": 30,
+      "maxPendingChars": 20000
+    }
+  }
 }
 ```
 
@@ -281,16 +289,17 @@ npx @riconext/hermes-repo init
 | `enabled` | `true` 才启用；`false` 时与未配置等价 |
 | `apiKey` / `baseUrl` / `model` | 三者缺一不可；须为 **OpenAI 兼容** `/chat/completions` 端点 |
 | `provider` | 仅作标记（如 `"openai"`），实际以 `baseUrl` 指向的服务为准 |
-| `mode` | 默认 `async`：hook 不等待；调试可用 `sync` 或环境变量 `HERMES_LLM_SYNC=1` |
+| `mode` | 默认 `async`：hook 不等待；调试可用 `sync` |
 
 非 DeepSeek 时：保持 `enabled: true`，将 `baseUrl`、`model` 换成你所用网关提供的 OpenAI 兼容地址与模型名即可。
 
+`consolidate.autoFlush.enabled` 默认关闭。开启后，capture 成功写入时会在后台按阈值触发 `flush`：pending/stale session 数达到 `minPendingSessions`、距离上次 flush 超过 `minIntervalMinutes`，或待处理内容达到 `maxPendingChars` 时触发。
+
 **`init -y` 时**：会生成 `enabled: false` 的骨架；再次 `init` **不会覆盖**已有 `apiKey`，可安全补配。
 
 ### 安全说明
 
-- `.memory/llm.json` 在 init 写入的 **gitignore 块中**，**不要提交到 Git**
-- `config.json` 里**没有** API 密钥字段
+- `.memory/config.json` 包含 `apiKey`，在 init 写入的 **gitignore 块中**，**不要提交到 Git**
 - 团队共享记忆走 `topics/` / `MEMORY.md`，与个人 LLM 配置无关
 
 ### 验证与排障