@jjh32456/dsh-longlive 1.6.7 → 1.8.0

package/docs/CONFIG.md

@@ -1,6 +1,6 @@
-# CONFIG.md — @jjh32456/dsh-longlive（久视）配置手册
+# CONFIG.md — @jjh32456/dsh-longlive（久视）配置手册
 
-适用版本：**1.6.5**（以包内 `package.json` 的 `version` 为准）。所有默认值以该源码树为准。
+适用版本：**1.8.0**（以包内 `package.json` 的 `version` 为准）。所有默认值以该源码树为准。
 读者：会改 YAML、会看日志，但没参与开发的人。
 
 ---
@@ -21,6 +21,40 @@ YAML 路径建议一律用正斜杠（例如 `<memory-root>/topics` 这种写法
 
 ---
 
+## 0.5 1.8.0 默认值总览（全部功能默认开；显式 false 才关）
+
+1.8.0 起 `FEATURE_DEFAULTS` 与 `Config({})` 的默认值是“功能默认开”。任何 `enabled` 开关都遵循同一语义：
+**未写 → true；只有字面 `false` 才关闭**（旧版“缺省为 false、写 true 才开”的写法全部作废）。安全/灰度类除外，见下表。
+
+| 默认开（opt-out 写法） | 默认值 | 关闭 |
+|---|---|---|
+| `autoRecall.enabled` | `true` | `autoRecall: { enabled: false }` |
+| `identityCard.enabled` | `true` | `identityCard: { enabled: false }` |
+| `presenceBus.enabled` | `true` | `presenceBus: { enabled: false }` |
+| `sharedBrain.activity.enabled` | `true` | `sharedBrain.activity: { enabled: false }` |
+| `sharedBrain.thinkingInjection` | `true` | `sharedBrain: { thinkingInjection: false }` |
+| `autoMaintenance.enabled` | `true` | `autoMaintenance: { enabled: false }` |
+| `autoConclusion` | `true` | `autoConclusion: false` |
+| `memoryV2.enabled` / `role.enabled` / `answerGuard.enabled` | `true`（1.8.0 既有） | 各自 `enabled: false` |
+| `d2.enabled` / `d6.enabled` | `true` | `d2: { enabled: false }` / `d6: { enabled: false }` |
+| `routerFace.enabled` | `true` | `routerFace: { enabled: false }` |
+| `routerEnabled` / `routerSharedBoard` / `routerWakeEnabled` | `true` | 对应键 `false` |
+| `workers.enabled` | `true` | `workers: { enabled: false }` |
+| `autoTruncate.enabled` | `true`（仍默认 `mode: dryrun`，不直接切） | `autoTruncate: { enabled: false }` |
+| `embedding.enabled` | `true`（本地模型缺失时静默退关键词召回） | `embedding: { enabled: false }` |
+
+**保持原默认值的清单（安全/灰度，刻意不翻）**：`answerGuard.gate.enabled=false`（信心闸灰度；审计与注入仍随 answerGuard 开）、`routerApplyEnabled=false`（批准后写工作区的第三道闸）、`strictMemoryRoot=false`（兼容宿主路径推导）、`routerRuntime='off'`（1.6.0 安全默认；显式 `shadow`/`on` 才记录/拦截）、`d6.dryRun=false` 之外的工具面细节不变、`autoTruncate.mode='dryrun'`。
+
+```yaml
+# 例：保留默认全开，只关掉两个不想要的
+session-longlive:
+  config:
+    autoRecall: { enabled: false }
+    workers: { enabled: false }
+```
+
+---
+
 ## 1. 配置键总表
 
 ### 1.1 记忆库与路径
@@ -44,7 +78,7 @@ autoTruncate:
 
 | 键 | 类型 | 默认值 | 合法值 / 范围 | 改了要重启？ | 风险与说明 |
 |---|---|---|---|---|---|
-| `enabled` | boolean | `false` | `true` / `false` | 是 | 1.6.0 起默认关闭。`false` 时 `evaluate` 在写日志之前就早退（`disabled`），连日志行都没有（`src/auto-truncate.js:390-443` 的早退分支） |
+| `enabled` | boolean | `true` | `true` / `false` | 是 | 1.8.0 起默认开启（仍默认 `mode: dryrun`，只规划不直接切会话）；显式 `false` 时 `evaluate` 在写日志之前就早退（`disabled`） |
 | `mode` | string | `dryrun` | `log` \| `dryrun` \| `request` | 是 | 1.6.0 起默认 `dryrun`（只规划不写会话）。**没有 `on`**。写 `on` → `AUTO_BAD_MODE`，整条 entry 不激活。旧值 `apply` 会被改写成 `request` 并记 `modeAlias:"apply->request"`（`src/auto-truncate.js:64,117-125`） |
 | `tokensThreshold` | integer | `300000` | ≥ 1 | 是 | 阈值比较是 `estimate.tokens >= tokensThreshold`（`src/auto-truncate.js:435`）。`tokens` 是**启发式估算**：对 `MESSAGE_TYPES` 事件的 data JSON 取字符数 ÷ 4（`src/truncate-visible.js:80`），不是宿主计费 token，两者偏差**待核实**。阈值压到几千只适合演练 |
 | `minTurns` | integer | `12` | ≥ 1 | 是 | 条件对 turn 数是**严格大于**：`estimate.turns > minTurns`（同 435 行）。`minTurns: 1` 表示第 2 个 turn 起才可能触发 |
@@ -56,10 +90,7 @@ autoTruncate:
 
 补充：
 
-- **发布默认值（1.4.0 起，1.6.0 收紧代码默认）**：包内 `cordis.patch.yml` 的
-  `session-longlive.config` 显式写了 `autoTruncate: { enabled: false, mode: dryrun }`；1.6.0
-  起 `src/auto-truncate.js` 的代码回退默认也改为 `enabled: false` / `mode: dryrun`。所以无论
-  是发布配置还是手写配置漏掉该块，自动截断都默认关闭；想开启必须显式写 `enabled: true`。
+- **发布默认值（1.8.0 起）**：包内 `cordis.patch.yml` 显式写 `autoTruncate: { enabled: true, mode: dryrun }`，代码回退默认也是 `enabled: true` / `mode: dryrun`。所以缺省即开启，但仍只 dryrun、不改会话；要关显式写 `enabled: false`。
 - `mode: request` 只写 `<memoryRoot>/.longlive/logs/auto-truncate.request.json`，**不碰会话日志**；
   真正改写会话的是宿主外的 `scripts/auto-truncate-run.ps1` + `scripts/truncate-cli.mjs`。
 - `mode: dryrun` 会真的跑一遍 `truncateVisibleSession({dryRun:true})`（读+规划+报告），但不写盘；
@@ -81,7 +112,7 @@ autoTruncate:
 |---|---|---|---|---|---|
 | `keepEvents` | integer | `20000` | ≥ 1 | 是 | 只作为 `session_truncate` 的默认 `keepEvents`（`src/index.js:199`）。切点还会被"第一条可见消息"夹住，见 `planTruncation` `src/truncate.js:103-152` |
 | `recentWriteWindowMs` | integer | `60000` | ≥ 0 | 是 | 最近写窗口；窗口内拒绝截断（`SESSION_RECENT_WRITE`）。runner 走 CLI 时显式传 0，因为它假定宿主已退出 |
-| `heartbeatMs` | integer | `15000` | 有限正数；`0` 关闭自动写 | 是 | 只影响 live 注册表心跳，**不影响**自动截断：`onTurnEnd` 在 `enabled` 门之前触发（`src/heartbeat.js:169`）。给 1 这种极小值 = 高频写盘，别这么干；无上限校验 |
+| `heartbeatMs` | integer | `15000` | 有限正数；`0` 只关定时心跳与工具调用触发的写 | 是 | `0` **不关 turn 边界状态机**：turn/start 与 turn/end 仍维护 live 行 state/turn；也不影响自动截断：`onTurnEnd` 在 `enabled` 门之前触发（`src/heartbeat.js:169`）。给 1 这种极小值 = 高频写盘，别这么干；无上限校验 |
 | `recoverOnStart` | boolean | `true` | `true` / `false` | 是 | 启动时扫 `.truncate-visible-inflight.json` 并收尾/回滚（`src/index.js:230-236` + `sweepInflight`）。只有排障时才建议关 |
 | `originalFetchMaxBytes` | integer | `65536` | 1024..4194304（超范围夹回） | 否 | 仅 `session_original` 的单次返回上限（UTF-8 字节）；超出按 `offset` 分页。隐私门先扫全量，调大它不会绕过隐私拦截 |
 | `touchLiveSession` / `now` / `defineTool` | 内部 | — | — | 是 | 测试注入缝（`src/index.js:160,193-195,205`），不是给部署用的稳定配置；**待核实**未来版本是否保留 |
@@ -129,14 +160,14 @@ patch 关掉，引擎加载失败时 `entry.js` 自动回退 stock，`/compact`
 剩余上下文。1.6.3 的 30k 触发 + 6 轮保留在长对话里几乎每轮一刀；1.6.4 改成 300k 触发 +
 保留 4 轮，切刀间隔拉长到十几轮，缓存命中率上去、账单下来。
 
-### 1.4b D2 工具输出裁剪 `d2`（默认关闭）
+### 1.4b D2 工具输出裁剪 `d2`（默认开启）
 
-配置形态是嵌套对象；只有 `d2.enabled: true` 才挂 `tools/post-execute`，默认整段不存在时
+配置形态是嵌套对象；1.8.0 起默认开启（缺省即挂 `tools/post-execute`）；只有显式 `d2.enabled: false` 才不挂。
 一切保持原样。
 
 ```yaml
 d2:
-  enabled: false
+  enabled: true
   maxInlineChars: 4096
 ```
 
@@ -160,14 +191,14 @@ d2:
 - **回退**：`d2.enabled: false`（或删除整个 `d2` 块）后重启；已归档文件不动会话，可保留
   取证或手工删除。
 
-### 1.4c D6 工具面裁剪 v1 `d6`（默认关闭）
+### 1.4c D6 工具面裁剪 v1 `d6`（默认开启）
 
-只有 `d6.enabled: true` 才注册 `tool_search` 与两个 listener；默认整段不存在时工具面与
+1.8.0 起默认开启：缺省即注册 `tool_search` 与两个 listener；只有显式 `d6.enabled: false` 时工具面与
 1.4.0 完全一致。
 
 ```yaml
 d6:
-  enabled: false
+  enabled: true
   dryRun: false
   log: true
   keepTools: []
@@ -200,7 +231,7 @@ d6:
 - **回退**：`d6.enabled: false`（或删除整个 `d6` 块）后重启；没有数据迁移。运行中选择、
   `restrict()` 或组装任一步抛错、或裁剪后工具集为空，也一律回到全量工具面，不阻断会话。
 
-### 1.5 面板（@jjh32456/dsh-longlive-panel@0.2.5，独立可选插件）
+### 1.5 面板（@jjh32456/dsh-longlive-panel@1.8.0，独立可选插件）
 
 面板的配置**不继承**上面插件的 `memoryRoot`，它有自己的两个键（`src/server.js:2103-2109`）：
 
@@ -209,7 +240,7 @@ d6:
 | `memoryRoot` | string | `~/.dsh/longlive-memory` | 目录 | 是 | 面板只读这个目录。插件配了显式根（本机示例 `<memory-root>`）而面板没配 → **面板显示 0 卡**（它读的是默认空目录），不是记忆丢了 |
 | `sessionsRoot` | string | `~/.dsh/sessions` | 目录 | 是 | "截断记录"页读这里的 `<会话目录>/truncate.json`、`truncate-visible.json`（宿主可见对话截断账本）和 `backups.json`（并 stat 账本里记的备份文件）；两份截断账合并后按时间倒序列出。指错 → 该页空白 |
 
-面板也可以用环境变量 `DSH_LONGLIVE_MEMORY_ROOT` / `DSH_MEM` 覆盖 `memoryRoot`。0.2.5 是配套本版的文案与 G1/G2/G4 修复版；本机 `desktop` profile 此前装的是 0.2.4（profile `package.json` 的 `@jjh32456/dsh-longlive-panel` 依赖 + bundles 列表，`node_modules` 有 0.2.4），升级到 0.2.5 的装法/验证/卸载见包内 `INSTALL.md`，装完或改配置后必须重启宿主。
+面板也可以用环境变量 `DSH_LONGLIVE_MEMORY_ROOT` / `DSH_MEM` 覆盖 `memoryRoot`。1.8.0 是配套本版的「六层视图活体行排序 + 已归档折叠（按需物化）」与外部评审 v1 回执修复版；本机 `desktop` profile 之前装的是旧版面板，升级到 1.8.0 的装法/验证/卸载见包内 `INSTALL.md`，装完或改配置后必须重启宿主。
 
 **1.6.0 新增：插件自带的设置页伴侣**（不是上面的面板包）。`package.json` 的 `./client` +
 `src/ui/*` 在宿主设置页的插件行注册 `plugins.row.config`，标题「久视 · 功能开关」，提供 7 个
@@ -219,14 +250,67 @@ slot key 为 `@jjh32456/dsh-longlive#session-longlive`（包名已改，row id
 的 profile 不注册 `/api/longlive/flags`，插件照常加载。`workers.enabled` 不在 7 个面板开关里，
 需要直接改配置。
 
-### 1.6 Router 1.1.0（默认关闭，50 键）
+### 1.5b 共享大脑活动流 `sharedBrain.activity`（默认开启）
+
+```yaml
+sharedBrain:
+  activity:
+    enabled: true          # 默认开启；显式 false 关闭（opt-out）；与 presenceBus 无关
+    injectMaxChars: 300    # 每轮注入总字符上限（含固定头尾，60–2000）
+    maxItems: 5            # 每轮最多注入条数（1–10）
+```
+
+| 键 | 类型 | 默认值 | 合法值 / 范围 | 改了要重启？ | 风险与说明 |
+|---|---|---|---|---|---|
+| `enabled` | boolean | `true` | `true` / `false` | 是 | 默认开启（1.8.0 产品默认）：按事件写活动行（同 key ≤1 条/10s 节流）到 `<memoryRoot>/.longlive/board/activity.jsonl`；`agent/pre-step` 只注入 `seq > lastSeenSeq` 的其他会话活动。显式 `false` 关闭，关闭时不写盘、不注入。失败静默，不影响 turn |
+| `injectMaxChars` | number | `300` | 60–2000 | 是 | 渲染后的整条提示（含 `【共享大脑活动】` 头与 `【活动结束】` 尾）不超过此值；预算不够时先裁条目标题、再少注入几条 |
+| `maxItems` | number | `5` | 1–10 | 是 | 最多条数；blocked 优先 |
+
+- 判重：同会话最近 10 条内 `key` 相同或文本相似度 ≥0.8 → 合并，`count+1`、`last_at` 更新、正文保留首条。
+- 蒸馏：同 key 连续 3 次（`count`）或累计 10 次 → 旧行 `archived:true`，新增一条
+  `阶段：<key>（N 次，最近 …）`。500 条窗口外的最旧行归档到 `activity-YYYYMM.jsonl`。
+- 每会话游标：`<memoryRoot>/.longlive/bridge/<sessionId>.activity.json`（`lastSeenSeq`）。
+  与 A1 结论桥的 `<sessionId>.json` 分开，互不覆盖；删掉该文件只会让该会话下次重新看到最近 5 条。
+- 隐私门：写盘前与注入前都调 `src/recall/privacy.mjs`；`local_only` 的活动不写、不注入。
+- 关闭方法（opt-out）：`sharedBrain.activity.enabled: false` 并重启；关闭时不注册
+  `session/event` / `agent/pre-step` 两个 hook、不建活动板、不注入，行为等同 1.7.4 的共享大脑关闭态。
+  已写文件保留，可手动删除。默认开启但数据只写本地 `<memoryRoot>/.longlive/board/`，不发网络。
+- 面板：活动流的「谁在干什么」页不在旧版面板（0.2.6）内（由面板侧后续版本提供）；
+  longlive 包只负责写盘与增量注入。
+
+### 1.5c 共享大脑 thinking 摘要注入 `sharedBrain.thinkingInjection`（默认开启，1.8.0）
+
+```yaml
+sharedBrain:
+  activity:
+    enabled: true                 # 活动流默认开启；thinking 摘要依赖活动流写侧
+  thinkingInjection: true         # 1.8.0 起默认开启；显式 false 关闭
+```
+
+| 键 | 类型 | 默认值 | 合法值 / 范围 | 改了要重启？ | 风险与说明 |
+|---|---|---|---|---|---|
+| `thinkingInjection` | boolean | `true` | `true` / `false` | 是 | 默认开启（1.8.0 产品默认）：开启后写侧把本会话 assistant 的可见 `reasoning`/`thinking` 段压成一行摘要（首句或 ≤200 字符，确定性规则，不新增模型调用），写为活动板 `kind:"thinking"` 行；每会话每 turn 最多 1 条。注入侧给其他会话加「【共享大脑 · 最近在思考（已有，新会话别重复）】」段，每事件一行「第 N 轮：<摘要>」，单次最多 5 行、每行 ≤200 字符，只带未消费（`seq > lastSeenSeq`）的新增。 |
+
+- opt-out 语义（thinking 自身）：`thinkingInjection=false` 时**不写 thinking 行、不注入 thinking 段**；
+  活动流本体仍按 1.8.0 默认开启（普通活动写/注入不受影响）。1.8.0 起默认 `true`；要关就显式写 false 并重启。
+  `thinkingInjection=true` 但 `activity.enabled=false` 时启动仅 warn 并跳过（thinking 依赖活动流写侧）。
+- 不泄原文：只落摘要（首句/≤200 字符），不保存、不回写原始 thinking 全文，也不改会话日志；
+  摘要为空（无可见 reasoning）时不写行。
+- 安全：写盘前与注入前都过现有隐私门；注入前再做 payload-safety 检查（空/超 200/控制字符/
+  伪造固定围栏标记的摘要直接丢弃），并沿用活动流的 `neutralizeEnvelope` 防围栏逃逸。
+- 游标：复用活动流的 `<memoryRoot>/.longlive/bridge/<sessionId>.activity.json`（`lastSeenSeq`），
+  注入成功后推进；同一条 thinking 不会重复注入，本会话自己的思考不回灌（自回声抑制）。
+- 回退：`sharedBrain.thinkingInjection: false` 并重启；已写 thinking 行保留在活动板，可手动删除，
+  不设开关也不影响已有活动流。
+
+### 1.6 Router 1.1.0（默认开启，50 键）
 
 全部键都在插件 `config` 里，`routerEnabled` 只认字面 `true`；改完重启宿主才生效。
 `false` 时 22 个工具不变、不建 `.longlive/router/`；打开后先多 4 个 `router_*`
 （22→26），再开 `routerProposalEnabled` 多 3 个（26→29）。
 
 ```yaml
-routerEnabled: false                    # 总开关；字面 true 才生效
+routerEnabled: true                     # 1.8.0 默认开启；显式 false 才关
 routerProvider: deepseek-official
 routerModel: auto                       # 显式 id / 宿主 currentSelection / listModels 首个非 preview
 routerTickMs: 60000
@@ -246,7 +330,7 @@ routerVaultDir: ''                      # 空 = <memoryRoot>/.longlive/router；
 routerAgentTimeoutMs: 15000
 routerDisposeTimeoutMs: 2000
 routerFlowSlice: 1200
-routerSharedBoard: false
+routerSharedBoard: true
 routerHintScope: root                   # root | all
 routerHintTokens: 700                   # clamp 到 200–700
 routerReflectHintTokens: 150            # clamp 到 50–150
@@ -256,9 +340,9 @@ routerInjectMaxPerSessionPerDay: 24
 routerInjectMaxTotalTokens: 12000
 routerLiveRowsMax: 128
 routerBoardMaxSessions: 5
-routerProposalEnabled: false            # 第二档：提案三工具
+routerProposalEnabled: true             # 第二档：提案三工具（默认开启）
 routerApplyEnabled: false               # 第三道闸：真正写盘
-routerL4MergeEnabled: false             # 相邻小写合并
+routerL4MergeEnabled: true              # 相邻小写合并（默认开启）
 routerProposalMaxChars: 4000
 routerProposalsPerSessionHour: 6        # 子代理固定 3/h，不读此键
 routerMaxProposals: 200
@@ -267,7 +351,7 @@ routerLeaseRenewMax: 2                  # maxHold = ttl + renewals × ttl/2 = 24
 routerLeaseWaitTimeoutMs: 300000
 routerBlockedOnUserTtlMs: 86400000
 routerProposalTtlH: 72
-routerWakeEnabled: false
+routerWakeEnabled: true
 routerWakeCooldownMs: 600000
 routerWakeDailyQuota: 20
 routerWakeLogMaxBytes: 33554432
@@ -313,7 +397,7 @@ routerSnapshotKeepDays: 30
 只读读取用 `node scripts/metrics-read.mjs --memory-root <root>`，或直接读文件；
 `router_status` 的 `ledger` 字段是同一份汇总。
 
-### 1.8 语义召回 `embedding`（默认关闭）
+### 1.8 语义召回 `embedding`（默认开启；模型缺失静默退关键词）
 
 `autoRecall` 的顶层开关之外，另有一个 `embedding` 对象；它不属于三块 feature flag，
 只在 `autoRecall.enabled: true` 且 `config.embedding` 是对象时透传给 auto-recall。
@@ -331,13 +415,13 @@ routerSnapshotKeepDays: 30
 `autoRecall.budgetTokens` 的硬上限是 2000（超出会被夹回），保证单轮注入不超过 2K token。
 完整行为与 recall-log 行格式见 [AUTO-RECALL.md](AUTO-RECALL.md)。
 
-### 1.9 routerFace（v1 后台面，默认关闭，8 键）
+### 1.9 routerFace（v1 后台面，默认开启，8 键）
 
 嵌套对象。`enabled` 只认字面 `true`；关闭时零定时器、零目录、零 IO。
 
 ```yaml
 routerFace:
-  enabled: false                # 总开关；还需 routerEnabled + routerSharedBoard 才能把留话递到前台
+  enabled: true                 # 默认开启；还需 routerEnabled + routerSharedBoard 才能把留话递到前台；显式 false 关闭
   tickMs: 60000                 # 30000–900000
   dryRun: true                  # true = 只写 journal，不调 LLM、不写 outbox
   dailyTokenBudget: 50000       # input+output；超了自动停（state=stopped, reason=daily-budget）
@@ -349,7 +433,7 @@ routerFace:
 
 | 键 | 类型 | 默认值 | 合法值 / 范围 | 风险与说明 |
 |---|---|---|---|---|
-| `enabled` | boolean | `false` | `true` / `false` | false 时 `createRouterFace` 都不调用；改完重启宿主才生效 |
+| `enabled` | boolean | `true` | `true` / `false` | 默认开启；显式 false 时 `createRouterFace` 不调用；改完重启宿主才生效 |
 | `tickMs` | integer | `60000` | 30000–900000 | 同一窗口内 journal 按 `tickKey` 幂等；窗口过短会提高调用频率 |
 | `dryRun` | boolean | `true` | `true` / `false` | 首次上真机建议先跑 dry-run 看上下文和 journal，再关掉 |
 | `dailyTokenBudget` | integer | `50000` | 1000–5000000 | 只记 LLM usage，不估算上下文；超预算停到当天结束 |
@@ -363,26 +447,75 @@ routerFace:
 `<memoryRoot>/IDENTITY.md` 是前后台共用身份文件（只读，缺省用内置默认），
 不要在 hint 里改它；bridge 文件是 `.longlive/bridge/router-outbox.jsonl`。
 
-### 1.10 子会话扇出 `workers`（默认关闭）
+### 1.10 子会话扇出 `workers`（默认开启）
 
-`worker_spawn` / `worker_status` / `worker_kill` 仍在 22 个默认工具里，但 1.6.0 起每次调用
-先看 `workers.enabled`：缺省或 `false` 时直接返回
-`{ ok:false, status:"unavailable", available:false, message:"unavailable: worker_* 默认关闭…" }`，
-不会派发任何子会话。只有显式打开才走宿主 `subagents` 服务。
+`worker_spawn` / `worker_status` / `worker_kill` 仍在 22 个默认工具里。1.8.0 起默认开启，缺省即走宿主 `subagents` 服务；只有显式 `workers.enabled: false` 时返回 unavailable、不派发子会话。
 
 ```yaml
 config:
   workers:
-    enabled: true     # 默认 false；打开后才能派子会话
+    enabled: true     # 1.8.0 默认开启；显式 false 关闭后才能派子会话
 ```
 
 | 键 | 类型 | 默认值 | 合法值 | 说明 |
 |---|---|---|---|---|
-| `workers.enabled` | boolean | `false` | `true` / `false` | 关闭时三个 worker 工具都返回 unavailable；打开后仍受宿主 `subagents` 服务是否存在约束 |
+| `workers.enabled` | boolean | `true` | `true` / `false` | 默认开启；显式关闭时三个 worker 工具都返回 unavailable；开启后仍受宿主 `subagents` 服务是否存在约束 |
 
-整块不在 `src/config.js` 的 Config schema 里（保持 schema 面不变），属于透传配置；Cordis
+整块不在 `src/config.js` 的 90 节点 Config schema 里（1.6.0 为 80；1.6.4 的 `hotTruncate`
+块 +5，本次活动流 `sharedBrain.activity` 再 +5；透传键保持 schema 面稳定），属于透传配置；Cordis
 的 schema 校验保留未知键，运行时由 `src/tools.js` 的注册包装读取。
 
+### 1.11b AutoCard / sidecar 签名与信任边界（1.8.0）
+
+AutoCard（`.longlive/index/cards.jsonl`）与精卡回链 sidecar（`.longlive/index/card-anchors.jsonl`）
+写入时用宿主 key 做逐行 HMAC；读取时：无 key、签名不符、链断、重放/删行/插行、重复 rel
+一律 fail-closed（不进入 recall，并写 `card-audit.jsonl`）。
+
+key 解析顺序（写入与读取一致）：
+
+1. 宿主注入环境变量 `DSH_LONGLIVE_AUDIT_KEY`（推荐，不落盘）；
+2. 宿主注入的 `auditKey`；
+3. fallback `<memoryRoot>/.longlive/.hostkey`（首启生成，权限 0600，**明文**）。
+
+**信任根 = L0 会话日志 + 宿主 key**。`events.db` 是派生索引、本身不签名；AutoCard 的
+`anchor.digest` 用 `turnDigest` 与 L0 校活，`scripts/verify-card-anchors.mjs` 可离线复核
+live/stale/missing。AutoCard 注入的 title/terms 在读取时从 events.db 的 EventRecord **重新派生**，
+不信任卡片文件内容；人工精卡保留原文。
+
+**残余风险（如实说明）**：同 OS 用户能读 `.hostkey`，因此本机同用户恶意程序可以伪造签名；
+HMAC 只能防跨进程误写、意外损坏和未持 key 的伪造，**不防本用户裸 fs 攻击**。需要更强隔离时
+用环境变量注入 key，并把记忆根放到受限账户/独立主机。
+
+**信任根与轮换**：信任根 = 宿主进程写入的 `events.db` + L0 会话日志 + 宿主 key；`events.db`
+本身不签名，同用户直接改写 DB/L0 属 OS 级边界，不宣称防裸 fs。轮换 key 后旧卡签名失效，
+需运行 `node scripts/backfill-auto-cards.mjs --resign` 重签并重跑 sidecar 回填；不重签时旧卡
+一律 untrusted、不进入 recall。
+
+### 1.11 身份与隐私（1.8.0）
+
+**身份默认中性**：1.8.0 起内置身份不含任何人名/角色/称呼；身份由 `<memoryRoot>/IDENTITY.md`
+（只读）定义，文件不存在时使用中性默认文本，不自动创建、不自动改写。蒸馏的 `who` 字段默认空，
+由用户显式配置注入，不再把内置称呼当默认值。
+
+| 键 | 类型 | 默认值 | 合法值 | 说明 |
+|---|---|---|---|---|
+| `identityCard.path` | string | `<memoryRoot>/IDENTITY.md` | 相对/绝对路径；支持 `<memoryRoot>` 占位 | 前后台共用的身份文件；只读 |
+| `identityCard.maxChars` | integer | `800` | 120–4000 | 开机卡注入上限；不改文件内容 |
+
+```yaml
+config:
+  identityCard:
+    path: <memoryRoot>/IDENTITY.md   # 默认值；按需要改
+    maxChars: 800
+```
+
+- **隐私门**：发布包不含个人姓名、本机绝对路径、记忆库或会话日志；打包时
+  仓库内发版门脚本（**npm 包不含**）`scripts/scan-abs-paths.mjs` 扫描 blocker（绝对路径/个人目录名等），**计数必须为 0 才发版**。
+- **共享大脑 thinking**：1.8.0 默认开启（显式 false 关闭）；开启后只注入其他会话摘要、不写原文、不进日志，
+  `local_only` 内容不写不注入。配置键与开关以本文档「共享大脑 thinking」段为准
+  （1.8.0 同步补入；未补入前以发布说明为准）。
+- 用户侧说明与升级注意见 [PRIVACY.md](PRIVACY.md)。
+
 ---
 
 ## 2. 环境变量
@@ -471,7 +604,7 @@ config:
 ```
 
 门禁：先按 `OPERATIONS.md` 的 `dryrun → request` 验收；连续三次真实 runner 执行都通过
-`verify-truncation.mjs` 的 `VIOLATIONS=0` 后，才谈下一步。
+按 OPERATIONS 的人工验收完成（`verify-truncation.mjs` 已移除）后，才谈下一步。
 
 ### 4.3 激进：自动切 + 路由拒绝（只在有验收证据后用）
 

package/docs/ERRORS.md

@@ -2,7 +2,7 @@
 
 @jjh32456/dsh-longlive 的所有工具失败时都会返回 `{ ok: false, code, message }`（同步抛出的则是带 `code` 的 `Error`）。这张表按出错的位置分组：**先找你的 `code`，照最后一列做**。
 
-> 版本：1.5.0。码表与源码同步；新增码时必须同时改本文件（`test/portability.test.mjs` 会检查本文件随包发布）。
+> 版本：1.8.0。码表与源码同步；新增码时必须同时改本文件（`test/portability.test.mjs` 会检查本文件随包发布）。
 
 ## 插件整条没加载（一个工具都没有）
 
@@ -217,7 +217,7 @@ R1 主脑决策层的错误码。**这一层的语义是 fail-closed**：`route(
 | `E_ROUTE_ALIASES_INVALID` | 别名表 JSON 损坏、`actions` 结构不对、`canonical` 重复 | 按 `version/actions[{canonical,legacy,aliases}]` 修 |
 | `E_ROUTE_RULE_FIELD` | 某条规则缺字段或字段类型错（id/priority/match/decision/before/after/level/writeScope 形状） | 错误里带 `ruleId`，按提示补字段；**整表拒收，不会只丢这一条** |
 | `E_ROUTE_RULE_UNKNOWN` | 某条规则的 `kind` / `action` / `target` 不在白名单 | 改用 `route.js` 里 `KINDS/TARGETS/aliases.json` 的合法值；**不许静默丢弃该规则后继续** |
-| `E_ROUTE_AMBIGUOUS` | 最高优先级上有 ≥2 条规则同时命中（`errors[].rules` 列出全部竞争 ruleId） | 交人裁决：收紧关键词/ctx，或给规则排出明确优先级；**不许按文件顺序选中** |
+| `E_ROUTE_AMBIGUOUS` | 最高优先级上有 ≥2 条规则同时命中（`errors[].rules` 列出全部竞争 ruleId） | 人工决定：收紧关键词/ctx，或给规则排出明确优先级；**不许按文件顺序选中** |
 | `E_ROUTE_CTX_MISSING` | 规则的关键词命中了，但 `ctx` 缺它门控要的字段 | 补 `ctx.tokens/activeWorkers/openRows/zone`；**不许当成「条件不满足」静默跳过** |
 | `E_ROUTE_CTX_TYPE` | `ctx` 字段类型错（如 `activeWorkers: "2"`）或 `ctx` 不是对象 | 按 schema 传有限数字/字符串；类型错不是「没命中」 |
 | `E_ROUTE_OVERRIDE_UNJUSTIFIED` | override 缺 `ruleId` 或 `reason` | 补理由；该 override 被丢弃，原判定保留 |
@@ -236,10 +236,10 @@ R1 主脑决策层的错误码。**这一层的语义是 fail-closed**：`route(
 | `E_ROUTE_HUMAN` | 该交人的决定没标 `needsHuman` | 在规则模板里写 `needsHuman: true` |
 | `E_ROUTE_POLICY` | 规则的 `policyRef` 在设计文档里解析不到 | 核对 `policyRef` 与 `R1-DESIGN.md` 的章节锚点 |
 | `E_ROUTE_LEVEL` | 规则的 level 不在 X/D/H，或与设计矩阵不符 | 按 `LEVEL_MATRIX` 改 |
-| `E_ROUTE_FORBIDDEN` | 命中设计里的禁止行为（如按文件顺序裁决） | 改规则/代码，不许绕过 |
+| `E_ROUTE_FORBIDDEN` | 命中设计里的禁止行为（如按文件顺序判定） | 改规则/代码，不许绕过 |
 | `E_ROUTE_BRIEF` | `worker_spawn` 的 `args.brief` 缺五要素或验收/产物路径 | 按 judge 的 brief 模板补齐 |
 
-### J8 身份同意（`route.js` / `judge.mjs` J9）
+### 身份同意（`route.js` / `judge.mjs`）
 
 这两个码**不套 `E_ROUTE_` 前缀**：它们说的不是「路由层坏了」，而是「身份变更被正确地挡下了」，
 属于正常判定结果，不是 fail-closed 故障。
@@ -247,11 +247,23 @@ R1 主脑决策层的错误码。**这一层的语义是 fail-closed**：`route(
 | 码 | 什么时候出现 | 你该怎么做 |
 | --- | --- | --- |
 | `E_IDENTITY_CONSENT_REQUIRED` | 用户单方面要求改名/改画像/改自称，但没有当前会话助手本人的同意记录（`consent.holder === "assistant"` 且带 `at` 与 `quote`） | 回 `identity.hold`，把「谁有权」说清楚；**不许把用户的「我同意/你改吧」当成同意**，也不许先改再补记录 |
-| `E_SELF_CONSENT` | judge J9：判定里出现了 `engram.profile.edit` 画像/名字写入，但同意记录不是当前会话助手本人给的（或 `satisfied !== true`、缺 `at`/`quote`） | 改回 `identity.hold`；只有当前会话助手本人带时间戳与原话的同意记录才能写 `engram:profile`，且必须 `keepHistory: true` |
+| `E_SELF_CONSENT` | 身份同意判官：判定里出现了 `engram.profile.edit` 画像/名字写入，但同意记录不是当前会话助手本人给的（或 `satisfied !== true`、缺 `at`/`quote`） | 改回 `identity.hold`；只有当前会话助手本人带时间戳与原话的同意记录才能写 `engram:profile`，且必须 `keepHistory: true` |
 
 本规则与被判断的 agent 具体叫什么无关：判定只看 `consent.holder === "assistant"` 以及 `at`/`quote` 是否齐全，
 不看 agent 的名字、自称或头像；换一个 agent 装上这套路由器，同意权同样归它自己，用户单方面要求同样不算同意。
 
+## 1.8.0 版本/安装集/迁移（v2.8.5 §16.1/§16.6）
+
+安装集是三件（longlive / panel / answer-guard）同版本发布；这四个码只在「版本/安装集/迁移」这条路径上出现。
+码表与源码同步（R9 实测：登记前 grep=0）。
+
+| 码 | 什么时候出现 | HTTP / 退出码 | 载荷字段 | 测试落点 |
+| --- | --- | --- | --- | --- |
+| `E_VERSION_MISSING` | 安装集清单或迁移记录缺版本号（三件任一没写 `version`，或 `install-set-*.json` 缺 `members[].version`） | HTTP 409；CLI 退出码 5 | `{code,message,details:{member,expected,actual,missing}}` | `test/version-set.test.mjs`（缺 version 用例）、`test/gate4-installset.test.mjs`（仓库测试，npm 包不含） |
+| `E_VERSION_SET` | 三件版本不一致（longlive 1.8.0 + panel 1.7.x 混装）或面板/核心版本集合校验失败 | HTTP 400；CLI 退出码 5 | `{code,message,details:{versions:{longlive,panel,answerGuard},reason}}` | `test/version-set.test.mjs`（混装用例） |
+| `E_VERSION_HASH` | 安装集 `*.sha256` manifest 与实文件哈希不符（下载损坏 / 被替换） | HTTP 409；CLI 退出码 5 | `{code,message,details:{file,expected,actual}}` | `test/version-set.test.mjs`、`test/gate4-installset.test.mjs`（仓库测试，npm 包不含）（哈希篡改用例） |
+| `E_MIGRATE_INCOMPLETE` | `scripts/migrate-180.mjs --apply` 迁移后条数不一致或存在无法映射的旧记录（`countMatched=false`） | CLI 退出码 1（默认 dry-run 不写、不报此码） | `{code,message,receipt:{recordsTotal,mapped,unmapped,afterClaims,countMatched}}` | `test/recall-v2/gov-migration.test.mjs`（apply/幂等/计数一致用例） |
+
 ## 这些不是错误码
 
 - `DSH_MEM`、`DSH_LONGLIVE_MEMORY_ROOT`、`DSH_LONGLIVE_STRICT_MEMORY_ROOT`、`DSH_HOST_VERSION`：环境变量名，出现在提示文案里。

package/docs/FAQ.md

@@ -1,4 +1,4 @@
-# 常见问题（FAQ）
+# 常见问题（FAQ）
 
 **读完你会得到什么**：装完没反应、侧栏不见了、401/404、剪完变少、换电脑、断电、卸载这些最常见的情况，能自己判断「是正常、是没装好，还是该回滚」。
 
@@ -8,13 +8,13 @@
 
 大概率是正常的。这个插件**没有自带界面**，默认 `mode: "log"` 也只会在后台写一行评估日志，不会弹窗、不会剪东西。
 
-按顺序确认：`dsh plugin --profile desktop list --depth 0` 有 `@jjh32456/dsh-longlive@1.6.5`；doctor 没有硬错误（退出码 0，或只有 engram 缺失导致的 1）；重启后新会话里能数到 22 个工具；聊到超过阈值后，`%USERPROFILE%\.dsh\longlive-memory\.longlive\logs\auto-truncate.log` 才出现评估行（默认阈值 300000，所以短时间内没有是正常的）。
+按顺序确认：`dsh plugin --profile desktop list --depth 0` 有 `@jjh32456/dsh-longlive@1.8.0`；doctor 没有硬错误（退出码 0，或只有 engram 缺失导致的 1）；重启后新会话里能数到 22 个工具；聊到超过阈值后，`%USERPROFILE%\.dsh\longlive-memory\.longlive\logs\auto-truncate.log` 才出现评估行（默认阈值 300000，所以短时间内没有是正常的）。
 
 如果这四样都没有，先看宿主启动 stderr 有没有 `1 entry did not activate`。
 
 ## 2. 侧栏没有「潜望镜」？
 
-「潜望镜」不是 longlive 本体自带的，它来自独立可选包 `@jjh32456/dsh-longlive-panel@0.2.5`。不装那个包，就永远不会有这个侧栏——这不是故障。
+「潜望镜」不是 longlive 本体自带的，它来自独立可选包 `@jjh32456/dsh-longlive-panel@1.8.0`。不装那个包，就永远不会有这个侧栏——这不是故障。1.8.0 面板侧 `GET /api/longlive-panel/v2/state` 返回 27 条路由 / 18 个动作；「本轮想起」审计入口读 `.longlive/recall-log.jsonl`。
 
 装了还没有，按顺序查：
 
@@ -28,7 +28,7 @@
 22 是 longlive 自己注册的数量，不是「整个会话只有 22 个工具」。先确认你看的是**新会话**，且是装插件的那个 profile。
 
 - 一个都没有 → 插件没激活，看 stderr 的 `1 entry did not activate` 和紧随其后的错误。
-- 少几个 → 可能被 profile 的工具过滤挡住，或版本不是 1.5.0。
+- 少几个 → 可能被 profile 的工具过滤挡住，或版本不是 1.8.0。
 - 只有 `engram_*` 缺失 → 那是可选依赖没装，和 22 个工具无关。
 
 ## 4. 401 和 404 到底差在哪？
@@ -66,7 +66,7 @@
 能，但要重新装，不能直接复制 profile。
 
 - 包是便携的，没有写死盘符；把 `.tgz` 拷过去，在新机器上重新 `plugin add`。
-- profile 里的 `file:C:/...` 是**那台机器**的绝对路径；换机后必须改成新路径，否则装不上。
+- profile 里的 `file:<path>` 是**那台机器**的绝对路径；换机后必须改成新路径，否则装不上。
 - `memoryRoot` 默认跟着 DSH home 走（Windows 是 `%USERPROFILE%\.dsh\longlive-memory`）；如果你显式配了路径，**那个目录必须已经存在**，插件不会替你创建。
 - 会话根目录默认 `%USERPROFILE%\.dsh\sessions`，设了 `DSH_HOME` 就以它为准。
 - `request` 模式的 runner 目前只支持 Windows；换到 Linux/macOS 就用 `log` / `dryrun`，或完全退出宿主后手动跑 `truncate-cli.mjs`。
@@ -86,13 +86,13 @@
 & $DSH plugin --profile desktop remove @jjh32456/dsh-longlive
 ```
 
-然后重启宿主，`list` 里不再出现即成功。卸载**不会**删 `longlive-memory`、会话的 `.bak-YYYYMMDD`、`session.v4.jsonl.zstd.archive/` 和 `.longlive/` 状态文件；要清就自己确认后手动删。面板是独立可选包 `@jjh32456/dsh-longlive-panel@0.2.5`，得单独 `remove @jjh32456/dsh-longlive-panel`。
+然后重启宿主，`list` 里不再出现即成功。卸载**不会**删 `longlive-memory`、会话的 `.bak-YYYYMMDD`、`session.v4.jsonl.zstd.archive/` 和 `.longlive/` 状态文件；要清就自己确认后手动删。面板是独立可选包 `@jjh32456/dsh-longlive-panel@1.8.0`，得单独 `remove @jjh32456/dsh-longlive-panel`。
 
 ## 10. 怎么确认它真的生效了，而不是「装了个寂寞」？
 
 四个独立证据，至少看到两个：
 
-1. `plugin list` 显示 `@1.6.5`；
+1. `plugin list` 显示 `@1.8.0`；
 2. doctor 没有硬错误（0，或只有 engram 缺失导致的 1）；
 3. 新会话能调用 `session_health`，返回里有 `sessionPath` / `events` / `visibleMessages`；
 4. 聊到超过阈值后，`auto-truncate.log` 出现评估行（`action` 是 `planned` / `dryrun-planned` / `none` 都算插件在评估）。