diff --git a/Docs/api-client.md b/Docs/api-client.md
index 4c6250f..e27de1f 100644
--- a/Docs/api-client.md
+++ b/Docs/api-client.md
@@ -155,11 +155,11 @@
 | 档位 | 中间件 | 条数 | 说明 |
 |---|:--:|:--:|---|
 | **只读监控档** | `viewerAuth`（owner/admin/viewer） | **14** | 非敏感投影：无凭据、无他人账号数据、无消息正文。**v0.78 新增两条**：面板接入点快照（A13）与插件动作分发（A14，**写门落在 handler 内**，见 A14 行注） |
-| **owner/admin 读档** | `writeAuth`（owner/admin） | **25** | viewer 不得看到的一切：记忆、LLM 栈、账号/key、后台思考、审计链、渠道消息日志、完整会话导出、配置事实面（v0.68）、最近一轮链路图快照（v0.71）、记忆整理试算（v0.75）、入库前审查留痕与回滚（**v0.79**，B16/B17）、链路图时间轴（**v0.80**，B18）、自排闸只读快照（**v0.82**，B19）、记忆整理应用面五条（**v0.83**，B20–B24）、**按动作批量拒绝候选（v0.85，B25）** |
+| **owner/admin 读档** | `writeAuth`（owner/admin） | **27** | viewer 不得看到的一切：记忆、LLM 栈、账号/key、后台思考、审计链、渠道消息日志、完整会话导出、配置事实面（v0.68）、最近一轮链路图快照（v0.71）、记忆整理试算（v0.75）、入库前审查留痕与回滚（**v0.79**，B16/B17）、链路图时间轴（**v0.80**，B18）、自排闸只读快照（**v0.82**，B19）、记忆整理应用面五条（**v0.83**，B20–B24）、**按动作批量拒绝候选（v0.85，B25）**、**记忆整理调优键读写（v0.92，B26/B27）** |
 | **owner-only 档** | `ownerAuth`（owner） | **40** | 带审计的策略写、每个获取凭据的渠道端点、其余全部变更 |
-| **合计** | — | **79** | `14 + 25 + 40`（v0.85） |
+| **合计** | — | **81** | `14 + 27 + 40`（v0.92） |
 
-**管理路由总数 = 14 + 25 + 40 = 79 条。**（v0.85 起；`14 + 24 + 40 = 78` 是 v0.84 的读数）
+**管理路由总数 = 14 + 27 + 40 = 81 条。**（v0.92 起；`14 + 25 + 40 = 79` 是 v0.85–v0.91 的读数）
 
 > **v0.78 计数变更**：`viewerAuth` 段新增两条（A13 `GET /admin/panels`、A14 `POST /admin/plugins/{id}/actions/{action}`）⇒ 12 → **14**、总数 66 → **68**。A14 走 `viewerAuth` 中间件，但**写动作在 handler 内按 owner/admin 收紧**（路由中间件只能有一道门）—— 因此它**是**本表的一行，读写面却不同档，详见 §2.1 A14 与 §4.14。
 
@@ -230,6 +230,8 @@
 | B24 | POST | `/api/v1/admin/memories/tidy/run` | **手动真跑一轮整理（v0.83 新增，切片 TIDY-1）** —— 不等 23:00 的 panic button：按**同一套规则与配置**立刻跑一轮，**写候选 + 写运行留痕**，**不自动应用**（人工在环，能落地的只有 B21/B22）。**无请求体**。`200 {data:{runId,trigger:"manual",ruleVersion,durationMs,partitions,scanned,compared,pairs,vetoed,errors,truncated[],vetoReasons{},candidatesCreated,candidatesDuplicate,candidatesByAction{}}}`。🔴 **如实计数**：`candidatesCreated` = 本次**新建**候选数、`candidatesDuplicate` = 被**幂等键**挡下的重复数（同一批数据重复跑 ⇒ 全进 duplicate，**不是失败**）；`errors` 非 0 面板必须显示；`truncated[]` 是**被护栏截断**的分区标签（扫描/比对/候选上限，或墙钟预算 `[budget]`）。失败：配置关闭 → `409 tidy_disabled`；超时 → `503 tidy_timeout`（**已跑部分仍写入了留痕**）；只接线了试算（没接真跑）→ `500 tidy_run_unavailable`；未接线 → `500 tidy_unavailable`；失败 → `500 tidy_run_failed`。**审计不在这里写** —— 由领域侧记一条 `memory.tidy.run`（`trigger=manual` + run_id + 计数），**一次点击一条**。语义见 **§4.15(b)** |
 
 | B25 | POST | `/api/v1/admin/memories/candidates/reject?action=&limit=` | **按动作批量拒绝整理候选（v0.85 新增，切片 TIDY-AUTO）** —— 把某一类 `pending` 候选一次性标成 `rejected`（**幂等**：同一调用再来一次 ⇒ `total:0`；**只改候选 status，绝不碰记忆行**）。`action` **必填**、**闭集** `merge\|link\|archive\|reclassify\|keep`（未知/空 → `400 bad_request`）；`limit` 缺省 **1000**、硬顶 **10000**、非整数 → `400 bad_request`。`200 {data:{action,limit,total,rejected,truncated}}`。🔴 **两个计数口径不同**：`total` = 命中筛选的**真**条数，`rejected` 只覆盖 `limit` 之内 ⇒ 不等时 **`truncated:true`**（客户端必须如实显示）。**落审计** `memory.tidy.reject`（只带计数）。用法见 **§4.15(e)**（`link` 停产后的存量清理就靠它）。⚠️ **不是「删除」**：候选行仍在，只是不再待办 |
+| B26 | GET | `/api/v1/admin/memories/tidy/tuning` | **记忆整理调优键读取（v0.92 新增，切片 M4）**，只读、**不审计**。**无参数**。`200 {data:{path,present,hot,hotError?,specs[],values{},envValues{}}}`。🔴 **三块分工（客户端按此编程）**：`specs[]` = **取值规则唯一真源**（`{key,kind,unit?,min?,max?,fallback}`；`fallback` 只给**来源** `env:<键名>` ｜ `panel:<键名>` ｜ `code-default`，**不给数值**）；`values` = **盘上**的值，**键缺位 ⇒ 该键在对象里不出现**（= 跟随兜底），**不是 0**；`envValues` = 键缺位时**下一档（`.env`）**的进程生效值（连 `.env` 档也没有 ⇒ 该键不出现；网关绝不 fopen `.env`）。管 7 键：`intervalSec`/`quietIntervalSec`/`quietStartHour`/`quietEndHour`/`ingestGate`/`autoApply`/`tempTtlSec`；同文件不受管的键（`t1Judge` 等）不回显。🔴 **`hot` 恒为 false** —— 读不改变任何东西，这是**如实占位**，别读成能力声明。失败：数据目录未接线 → `500 tuning_unavailable`。语义见 **§4.17** |
+| B27 | PUT | `/api/v1/admin/memories/tidy/tuning` | **记忆整理调优键写入（v0.92 新增，切片 M4）**。门同 B26（`writeAuth`）。请求体 = **扁平 JSON 对象**，只放要改的键；值 int（秒/钟点）或 bool；**`null` = 清除该键**（回到下一档兜底）。🔴 **三态（硬要求，逐字）**：键**缺位** ⇒ 不改动；**合法值** ⇒ 采用；**非法值** ⇒ `400 invalid_payload` 且**盘上一个字节不动**；**未知键（含拼错）也归「非法」，绝不静默忽略**。`200` 与 B26 **同形状**，但值是**写完重新读盘**的真值（带 `hot`/`hotError`）。错误码：`400 invalid_payload`（值非法/未知键/体不是对象/体是 `null`）｜`409 tuning_corrupt`（盘上那份运行期读不走 ⇒ **拒绝覆盖**）｜`500 tuning_unavailable`｜`500 tuning_write_failed`（落盘失败，盘上未改动）。**两条语义**：**值一个都没变时不写盘**（连 mtime 都不动）；同文件**不受管的键原样保留**。🔴 **`hot` 诚实口径**：`hot:true` = 值已叠到运行期（整理档会重排心跳，否则新周期要等旧周期那一觉睡完）；`hot:false` = **已落盘但运行期没接上**，`hotError` 给原因，面板文案必须是「**重启后端后生效**」—— **绝不把「落盘了」说成「生效了」**。**落审计** `memory.tidy.tuning`（`result` ∈ `ok\|error`）。语义见 **§4.17** |
 
 > **读取 `GET /admin/observability/{logs,metrics,trace}` 兼任可观测推送的订阅握手**（该凭据的连接全部断开即退订）。REST 响应形状不变。
 
@@ -1423,6 +1425,81 @@ curl -s -X POST -H "X-API-Key: $KEY" \
 
 **一个保守处置（待设计裁决，生产库 0 例）**：`<p>A\n\n<p>B</p>`（未闭合段落之间夹正文）产出侧选择**合并** ⇒ `<p>A\n\nB</p>`，**不**做「插入式隐式收尾」（那要猜作者意图）。客户端不必为此适配。
 
+### 4.17 记忆整理调优键的读写面（B26 / B27；**v0.92 新增，切片 M4**）
+
+| 项 | 值 |
+|---|---|
+| 方法 / 路径 | `GET` 与 `PUT` `/api/v1/admin/memories/tidy/tuning` |
+| 鉴权档 | `writeAuth`（**owner / admin**；`viewer` → `403`，未认证 → `401`）。与同族 `GET /admin/memories`、`POST …/tidy/dry-run` 同档 |
+| 审计 | GET **不审计**；PUT 落 **`memory.tidy.tuning`**（`result` ∈ `ok\|error`） |
+| 落盘 | `$DATA_DIR/config/memory-tidy.json`（原子写：temp + rename；**值一个都没变时不写盘**） |
+
+它救的是「这些键只能改文件 + 重启后端」——面板从此是配置的一等来源（`.env` 只做兜底）。
+
+#### 管的 7 个键
+
+| key | kind | unit | 取值 | 兜底来源 |
+|---|---|---|---|---|
+| `intervalSec` | int | sec | ≥ 1 | `env:MEMORY_TIDY_INTERVAL_SEC` |
+| `quietIntervalSec` | int | sec | ≥ 1 | `panel:intervalSec` |
+| `quietStartHour` | int | hour | 0–23 | `env:MEMORY_TIDY_QUIET_START_HOUR` |
+| `quietEndHour` | int | hour | 0–23 | `env:MEMORY_TIDY_QUIET_END_HOUR` |
+| `ingestGate` | bool | — | — | `code-default` |
+| `autoApply` | bool | — | — | `code-default` |
+| `tempTtlSec` | int | sec | ≥ 1 | `code-default` |
+
+🔴 **`specs` 是取值规则唯一真源**：面板据此渲染与就地校验 ⇒ 不会出现两套规则。`fallback` **只给来源**（`env:<键名>` ｜ `panel:<键名>` ｜ `code-default`）、**不给数值** —— 数值真源仍在领域侧，网关不另抄一份默认值。
+
+#### 响应（GET 与 PUT 的 200 同形状）
+
+```json
+{
+  "path": "config/memory-tidy.json",
+  "present": true,
+  "hot": false,
+  "hotError": "…（仅 hot=false 时出现）",
+  "specs": ["…见上表，每项 {key,kind,unit?,min?,max?,fallback}…"],
+  "values": {"intervalSec": 3600, "quietStartHour": 23, "quietEndHour": 7, "ingestGate": false},
+  "envValues": {"intervalSec": 86400, "quietStartHour": 23, "quietEndHour": 7}
+}
+```
+
+🔴 **`values` 的缺位语义**：**键缺位 ⇒ 该键在对象里不出现**（= 跟随下一档兜底），**不是 0** ——「没配」与「配成 0」必须分得开。只回这 7 键；同文件里**不受管**的键（`t1Judge` / `t1PerWindow` / `autoApplyPerRound` 等）**不回显**，但 PUT 时**原样保留**。
+
+🔴 **`envValues`**：键缺位时的**下一档（`.env`）进程生效值**（与 `/admin/config-facts` 同源 `s.cfg`，网关**绝不 fopen `.env`**）；某键连 `.env` 档也没有值 ⇒ 该键不出现（例：`intervalSec ≤ 0`、安静时段两端都为 0 = 未填）。
+
+#### 写侧三态（硬要求，逐字）
+
+| 请求体里 | 结果 |
+|---|---|
+| 键**缺位** | 不改动 |
+| **合法值** | 采用 |
+| **非法值** | `400 invalid_payload`，且**盘上一个字节不动** |
+| **未知键**（含拼错） | 归「非法」⇒ `400`，**绝不静默忽略** |
+| 值 `null` | **清除该键**（回到下一档兜底） |
+
+- 请求体 = **扁平 JSON 对象**（值类型 int 秒/钟点 或 bool）。
+- **PUT 的 200 是「写完重新读盘」的真值**，不是回显请求体。
+
+#### 错误码
+
+| code | 何时 |
+|---|---|
+| `400 invalid_payload` | 值非法 / 未知键 / 体不是对象 / 体是 `null` |
+| `409 tuning_corrupt` | 盘上那份**运行期读不走** ⇒ **拒绝覆盖**（文案说明此刻正回落 `.env`/代码默认） |
+| `500 tuning_unavailable` | 数据目录未接线 |
+| `500 tuning_write_failed` | 落盘失败（盘上未改动） |
+
+#### 🔴 `hot` 的诚实口径（客户端按此渲染）
+
+- `hot:true` = 值**已叠到运行期**：整理档会 `Stop→写→Start` **重排心跳**（否则新周期要等旧周期那一觉睡完 —— 主人把 24h 改成 3h 就「等于没改」）；审查档重算 `ingestGate` / `tempTtlSec`。
+- `hot:false` = **已落盘但运行期没接上**，`hotError` 给原因，面板文案必须是「已保存到面板配置文件，**重启后端后生效**」。
+- **绝不把「落盘了」说成「生效了」。**
+
+#### `recallMode` 的渲染（前端，承接 v0.91）
+
+试算卡片（B14）的 `recallMode` 现在四态如实渲染：`embedding` ⇒「召回来源：语义向量」｜`lexical` ⇒「召回来源：词项余弦（未接向量，已降级）」｜`mixed` ⇒「召回来源：部分分区降级（其余走向量）」｜`""` ⇒「召回来源：无候选可比（本轮未做召回）」——**不再渲染成空标签**。未登记取值 ⇒「…（未登记取值）」（不吞信息）。「尝试过但向量源不可用」走**错误路径**（`error.code === "tidy_recall_unavailable"`），面板额外渲染一句解释，**不套在别的错误码上**。
+
 ## 5. env 与模型配置（与契约相关）
 
 > **`.env` vs 面板文件**：面板「LLM 模型」页保存写 `<DATA_DIR>/models.json`（默认 `./data/models.json`）；「渠道管理」页写 `<DATA_DIR>/channels.json`。**只要文件存在且有效，运行时优先用它**，`.env` 只作兜底/播种层。`.env.example` 与实现同步（键名逐字一致、值占位符）。
@@ -1496,7 +1573,22 @@ curl -s -X POST -H "X-API-Key: $KEY" \
 > 只保留最近若干版（**v0.60 起**）；更早的全部历史见归档 `Docs/archive/api-client.v0.65.md` §5（v0.28 → v0.59）。
 > 每版一句话 + 三档标注。**三档定义见 [§0.4](#04-三档标注惯例)。**
 
-### v0.91（当前契约版本）
+### v0.92（当前契约版本）
+
+**「记忆整理调优键可写」版 —— 管理面新增 2 条 `writeAuth` 端点，把面板从「只能改文件 + 重启」救出来**（依据：主人 2026-10-13 口径「`.env` 只做兜底…这些键优先从面板配置上取」「频率必须调…白天间隔短一点、静默期长一点」；实现切片 M4）
+
+- **新增 `GET /api/v1/admin/memories/tidy/tuning`（B26）** 与 **`PUT` 同路径（B27）**。管 7 个键：`intervalSec` / `quietIntervalSec` / `quietStartHour` / `quietEndHour` / `ingestGate` / `autoApply` / `tempTtlSec`。门 = `writeAuth`（owner｜admin；`viewer` → 403，未认证 → 401），与同族 `GET /admin/memories`、`POST …/tidy/dry-run` 同档；GET 只读**不审计**，PUT 落审计 **`memory.tidy.tuning`**（`result` ∈ `ok|error`）。
+- 🔴 **响应三块的分工（客户端按此编程，别自己算默认值）**：
+  - `specs[]` 是**取值规则唯一真源**（`kind` / `unit` / `min` / `max` / `fallback`），面板据此渲染与就地校验 ⇒ 不会出现两套规则；`fallback` **只给来源**（`env:<键名>` ｜ `panel:<键名>` ｜ `code-default`）、**不给数值** —— 数值真源仍在领域侧，网关不另抄一份默认值。
+  - `values` 是**盘上**的值：**键缺位 ⇒ 该键在对象里不出现**（= 跟随下一档兜底），**不是 0** ——「没配」与「配成 0」必须分得开。只回这 7 键，同文件里不受管的键（`t1Judge` / `t1PerWindow` / `autoApplyPerRound` 等）**不回显**。
+  - `envValues` 是键缺位时**下一档（`.env`）**的进程生效值（与 `/admin/config-facts` 同源，网关**绝不 fopen `.env`**）；连 `.env` 档也没有值 ⇒ 该键不出现。
+- 🔴 **写侧三态（硬要求，逐字）**：键**缺位** ⇒ 不改动；**合法值** ⇒ 采用；**非法值** ⇒ `400 invalid_payload` 且**盘上一个字节不动**。**未知键（含拼错）也归「非法」，绝不静默忽略**。值 `null` = **清除该键**（回到下一档兜底）。错误码：`400 invalid_payload` ｜ `409 tuning_corrupt`（盘上那份运行期读不走 ⇒ **拒绝覆盖**）｜ `500 tuning_unavailable`（数据目录未接线）｜ `500 tuning_write_failed`（落盘失败，盘上未改动）。
+- **两条语义**：**值一个都没变时不写盘**（连 mtime 都不动）；同文件**不受管的键原样保留**。PUT 的 200 与 GET **同形状**，但值是**写完重新读盘**的真值。
+- 🔴 **`hot` 语义（绝不把「落盘了」说成「生效了」）**：`hot:true` = 值已叠到运行期（整理档会 `Stop→写→Start` **重排心跳**，否则新周期要等旧周期那一觉睡完；审查档重算 `ingestGate`/`tempTtlSec`）；`hot:false` = 已落盘但运行期没接上，`hotError` 给原因，面板文案必须是「**重启后端后生效**」。GET 的 `hot` **恒为 false**（读不改变任何东西）——那是如实占位，**别读成能力声明**。
+- **兼容性**：**纯增量**（新端点；既有端点/帧一字未改），老客户端零影响。
+- **计数**：`writeAuth` 段 25 → **27**；管理路由总数 79 → **81**（`14 + 27 + 40`）。字段级说明见 **§4.17**。
+
+### v0.91
 
 **「召回来源如实上报」版 —— `recallMode` 取值域扩两个 + 语义收紧**（实现 `5967272`，切片 M9；起因 = M6 诊断发现旧实现把「全量降级」静默报成 `embedding`，见 `DevDocs/audit/去重失效诊断-2026-10-13.md`）