dsh-fact-check 1.5.0 → 1.5.2

package/ADAPTING.md

@@ -1,9 +1,14 @@
 # 换环境适配清单（ADAPTING）
 
-本技能**不绑定任何主机、产品、路径或密钥**：正文只讲能力与规则，两个工具是零依赖的 Node 脚本，所有环境相关的值都在 `tools/local.json`。本文说明落到你的环境需要做哪几件事。
+本技能**不绑定任何主机、产品、路径或密钥**：正文只讲能力与规则，两个工具是零依赖的 Node 脚本，所有环境相关的值都在 `local.json`（放在**包外**的用户配置目录，见下）。本文说明落到你的环境需要做哪几件事。
 
 > 逐步执行请用 **`FOR-AI.md`**（它是操作手册）；本文是配套的背景与决策依据（为什么这样改、没有决策模型怎么办、判据校准纪律）。
 
+> **配置文件位置**：默认 `%LOCALAPPDATA%\dsh-fact-check\local.json`（Windows）或
+> `~/.config/dsh-fact-check/local.json`；`JEV_LOCAL_CONFIG` 可指定任意路径；旧的包内
+> `tools/local.json` 仍会被读，但只作为兜底。放在包外是为了 `dsh plugin update` / `npm i`
+> 换掉整个包目录时，不会把本机设置一起清掉。`secrets.json` 用同一套目录。
+
 ---
 
 ## 1. 五分钟接上
@@ -17,13 +22,13 @@ node tools/doctor.mjs --net                     # 建议也跑一次：会真跑
 export TYPESAFE_API_KEY=…                       # 或 doctor --write 生成 local.json 后填 keyFile
 
 # 3) 本机值（可选）：自托管搜索、代理、可选工具路径；还有能力绑定 / 输出约定 / 运行时基线
-node tools/doctor.mjs --write                   # 生成 local.json 草稿，再把 null 的项补上
-#    或： cp tools/local.example.json tools/local.json
+node tools/doctor.mjs --write                   # 生成配置草稿（写到包外用户目录），再把 null 的项补上
+#    或： 把 tools/local.example.json 复制成配置文件（路径看 doctor 输出里的「本机配置」一行）
 
 # 4) 验收（离线，不花钱）
 node tools/jev-verdict.mjs selftest                              # 期望 25/25
-node tools/route.mjs selftest                                    # 期望 37/37
-node tools/route.mjs regress --file cases/route-cases-neutral.json   # 期望 26/26
+node tools/route.mjs selftest                                    # 期望 44/44
+node tools/route.mjs regress --file cases/route-cases-neutral.json   # 期望 30/30
 ```
 
 要求：**Node 18+**（内置 `fetch` 与 `AbortSignal.timeout`）。零 npm 依赖。

package/CHANGELOG.md

@@ -3,6 +3,35 @@
 面向使用者的**版本间净变化**（修复 / 改进 / 新增）。只写最终结果，不写过程。
 判据、阈值、触发词的任何改动都必须同时更新 `MEASUREMENTS.md` 的数字与 `cases/` 的回归结果。
 
+## 1.5.2 — 2026-11-05
+
+**修复**
+
+- **包更新会把本机配置一起冲掉**：`local.json` / `secrets.json` 原先只从包内 `tools/` 读，而 `dsh plugin update`（以及任何 `npm i`）是**整包替换**，装在包里的本机设置必然消失；又因为 package.json 的 `files` 不含 `local.json`，用户只能在装完后手工往 `node_modules/…/tools/` 里放，每次更新重来一遍。现改为**包外配置目录**：Windows `%LOCALAPPDATA%\dsh-fact-check\`，其它平台 `$XDG_CONFIG_HOME/dsh-fact-check/` 或 `~/.config/dsh-fact-check/`；`JEV_LOCAL_CONFIG` 可显式指定文件。解析顺序 `JEV_LOCAL_CONFIG` → 用户配置目录 → 包内旧位置（兜底，不破坏已有安装）。
+- `tools/doctor.mjs --write` 改为写入包外用户目录（已存在则不覆盖），并在输出里加一行「本机配置：…」显示**实际生效**的文件路径；`route.mjs` / `jev-verdict.mjs` / `doctor.mjs` 的读取全部走同一套解析（新增 `tools/config.mjs`，仍零依赖）。密钥文件同目录解析（`secrets.json`）。
+
+**其它**
+
+- 文档同步：`ADAPTING.md`（新增「配置文件位置」说明）、`FOR-AI.md`、`README.md`、`README.zh-CN.md`、`tools/local.example.json` 的路径性描述改为包外位置；判据、阈值与流程正文未动。
+- 验收：`route selftest 44/44`、`jev-verdict selftest 25/25`、`smoke-plugin 27/27` 全部通过；解析优先级实测三条：`JEV_LOCAL_CONFIG` 指定路径生效、用户目录生效、两者皆无时 `overrides` 为空且不报错。
+- 升级提示：老安装升级到 1.5.2 后，把原来的 `tools/local.json` 复制到上面那个包外路径即可（包内旧位置仍会被读到，但下次整包替换后就没了）。
+
+## 1.5.1 — 2026-10-28
+
+**修复**
+
+- **未识别任务的兜底域选错（会劝退该派的活）**：任务文本匹配不到任何触发词时，原先兜底到 `tech_release`——给的是「官方仓库 README/CHANGELOG → 文档站 → 包管理器元数据」这套软件发布阶梯，而且该域 `closed=false`，`dispatchHint` 会说「单路可覆盖，串行处理即可」。对「某平台上两国网民骂战的来龙去脉」这类任务，等于同时给了错误的来源阶梯与错误的派发建议。现改为专用兜底域 `general_fact`：阶梯是「当事方原始发布 → 通讯社与官方广播 → 元搜索交叉 → 存档快照 → 当地媒体 → 社区线索」，`plan` 输出新增 `fallback` 字段，兜底时提示改为「未识别事实类型（兜底域）→ 按 SKILL.md 的信号表判断」。同时补齐两条触发词（`cn_social_rumor` 加 `推特 / Twitter / X 平台 / 骂战 / 对线 / 论战 / 口水战 / 开撕 / 网络战`，`international` 加常见外方国名），让同一类任务不再落兜底。
+- **子代理回报可能被内容审核整条丢弃**：极端题材（族群冲突 / 辱骂 / 暴力）里，子代理逐字复述辱称或族群贬损文本，会让**整条回报**被审核丢弃，那一路渠道的证据就全没了。`SKILL.md`「子代理分发模式（可选）」新增「回报的引文净化」：事实性表述（时间 / 账号名 / tweet_id / 互动量 / 可观察行为特征）照常逐字引；贬损原文改为**中性性质标签 + 原帖 URL + tweet_id + 发布时间**，需要逐字文本时由主对话自己调 syndication / oembed。派发 prompt 必须带上这条约定；回报第一行写 `渠道状态：已取证 / 无命中 / 抓取失败`，把「确实没证据」和「回报丢了」分开。
+
+**其它**
+
+- `cases/route-cases-neutral.json`：R10 改判 `general_fact` 并反向断言不是 `tech_release`；新增 R27–R30（未识别任务 / X 平台骂战 / 推特对线 / 外方国名进国际域）；`regress` 支持 `expectFallback`。
+- `SKILL.md` frontmatter 与 `package.json` 版本号同步到 **1.5.1**；`INSTRUCTIONS.md` 由 `make-instructions.mjs` 重新生成。
+- `MEASUREMENTS.md`：`route` 离线断言 37 → **44 项**、路由语料 26 → **30 例**；§7 增第 10 条记录兜底域修正与两条扩词，并注明 `arms` 的 28/35 与 7 条 mismatch **逐条不变**——新增词条在 35 条共识样本上没改变任何一条判定，样本小，这只说明「未变差」。
+- `ADAPTING.md` / `FOR-AI.md` / `README.md` / `README.zh-CN.md` / `cases/README.md` 里「期望 37/37、26/26」「当前状态」这类**现在时**数字同步到 44/44、30/30；带日期的历史证据行（「某日在该宿主上跑过 37/37」）保持原样，不改写历史。
+- 验收：`selftest 44/44`（原 37）、`regress 30/30`（原 26）、`arms 28/35 = 80.0%` 与 7 条 mismatch **逐条不变**；`jev-verdict selftest 25/25`、`smoke-plugin 27/27` 未受影响。
+- **判据层未动**：`jev-verdict.mjs`、`engine-routes.json`、`lib/` 本轮无改动。
+
 ## 1.5.0 — 2026-10-23
 
 **新增**

package/CONTRIBUTING.md

@@ -38,8 +38,9 @@ All of these run offline and need no API key.
 
 ## Machine-specific values never enter the repository
 
-Endpoints, keys, host paths and "which channel actually works here" belong in `tools/local.json`, which is
-git-ignored; `tools/local.example.json` is the template. `tools/*.mjs` carry assertions that fail if a host
+Endpoints, keys, host paths and "which channel actually works here" belong in `local.json` **outside the package**
+(default `%LOCALAPPDATA%\dsh-fact-check\local.json` on Windows, `~/.config/dsh-fact-check/local.json` elsewhere,
+or whatever `JEV_LOCAL_CONFIG` points at); `tools/local.example.json` is the template. `tools/*.mjs` carry assertions that fail if a host
 path is hard-coded, and `SKILL.md` may not name a host, an internal address, a path or a key.
 
 ## Versioning

package/CONTRIBUTING.zh-CN.md

@@ -36,8 +36,9 @@ node tools/make-instructions.mjs                     # 只有改了 SKILL.md 才
 
 ## 主机相关的值永不入库
 
-端点、密钥、主机路径，以及「这台机器上哪个渠道真的能用」，一律放 `tools/local.json`（已 gitignore），
-模板是 `tools/local.example.json`。`tools/*.mjs` 里有断言：一旦硬编码主机路径就失败；
+端点、密钥、主机路径，以及「这台机器上哪个渠道真的能用」，一律放 **包外** 的 `local.json`
+（Windows 默认 `%LOCALAPPDATA%\dsh-fact-check\local.json`，其它平台 `~/.config/dsh-fact-check/local.json`，
+或用 `JEV_LOCAL_CONFIG` 指定），模板是 `tools/local.example.json`。`tools/*.mjs` 里有断言：一旦硬编码主机路径就失败；
 `SKILL.md` 里也不得出现主机名、内网地址、路径或密钥。
 
 ## 版本纪律

package/FOR-AI.md

@@ -46,10 +46,10 @@ node tools/doctor.mjs --net      # 联网版：额外自测抓取链与判据端
 2. 或者生成配置草稿再补空值：
 
 ```bash
-node tools/doctor.mjs --write    # 生成 tools/local.json（已存在则不会覆盖）
+node tools/doctor.mjs --write    # 生成配置文件（默认写到包外用户目录；已存在则不会覆盖）
 ```
 
-3. 若环境里有自托管搜索 / 代理 / 工具，把它们填进 `tools/local.json` 的 `overrides`：
+3. 若环境里有自托管搜索 / 代理 / 工具，把它们填进配置文件的 `overrides`：
 
 ```json
 { "overrides": { "SEARXNG_URL": "…", "HTTP_PROXY_URL": "…", "VIDEO_FETCH_CMD": "…", "EXIFTOOL_CMD": "…" } }
@@ -63,7 +63,7 @@ node tools/doctor.mjs --write    # 生成 tools/local.json（已存在则不会
    - `runtimeNotes`：运行时基线，自由文本。最值得记的是"这台机器上哪些渠道真的能用"——例如元搜索实例里哪个引擎被 CAPTCHA 拦、哪些站点必须走代理。这类信息直接决定核查质量，但不适合写进正文。
 
 **硬性禁止**（违反即失职）：
-- 不要把密钥**写进** `SKILL.md`、任何 `.md`、任何数据表、或提交到版本库；`local.json` 已在 `.gitignore` 里。
+- 不要把密钥**写进** `SKILL.md`、任何 `.md`、任何数据表、或提交到版本库；`local.json` 属于本机配置，放**包外**用户配置目录（见 `ADAPTING.md`）。
 - 不要把密钥**打印**到对话、日志或终端输出里；只需要说明"密钥来源是 X"。
 - 不要修改 `cases/` 里语料的 `label`（那是校准真值）。
 
@@ -73,8 +73,8 @@ node tools/doctor.mjs --write    # 生成 tools/local.json（已存在则不会
 
 ```bash
 node tools/jev-verdict.mjs selftest      # 期望 25/25
-node tools/route.mjs selftest            # 期望 37/37
-node tools/route.mjs regress --file cases/route-cases-neutral.json   # 期望 26/26，0 成本
+node tools/route.mjs selftest            # 期望 44/44
+node tools/route.mjs regress --file cases/route-cases-neutral.json   # 期望 30/30，0 成本
 node tools/route.mjs arms                # 派发臂代理指标，期望 28/35 = 80.0%，0 成本
 
 # 有密钥时再跑一次真机，确认端到端可用（约 $0.0003）
@@ -117,7 +117,7 @@ node tools/jev-verdict.mjs regress --file cases/injection-cases-neutral.json --c
 node tools/route.mjs plan --task "核查一条社交媒体首发的传闻，需要国内外两侧交叉"
 #    → 看 ladders（该找哪些源）/ routes（走哪些渠道）/ failureActions（遇到 403、超时、0 结果怎么办）
 #    → 看 dispatchHint（要不要多路并行取证）
-node tools/route.mjs regress --file cases/route-cases-neutral.json   # 路由层回归，26 例，0 成本
+node tools/route.mjs regress --file cases/route-cases-neutral.json   # 路由层回归，30 例，0 成本
 node tools/route.mjs arms                                            # 派发臂代理指标（改触发词后必跑），0 成本
 
 # ② 判据层（有密钥时）：把"证据 → 结论"这件事交给决策模型
@@ -189,5 +189,5 @@ node tools/jev-verdict.mjs batch --file my-cases.json --question support --conc
 - **把"伪多源"当交叉验证**：多家转载同一篇首发只算 **1** 个独立来源；要追到最上游。
 - **去痕语料的数字更低**：包里是去痕版，`support` 期望约 37/40（92.5%）；原始版是 38–39/40。这不是判据退化，而是"具体出处本身是实据"——见 `MEASUREMENTS.md` §1.1。第二遍去痕（私有工具名/宿主产品名）则**没有**造成可测量的变化。
 - **阈值附近会漂**：同一批样本两轮结果可能差 1 例，差异都在 p≈0.5 的样本上。这正是"只能降档""unsure 交人"的理由。
-- **不要在技能正文里写本机事实**（内网地址、绝对路径、密钥、账号）：本机值只进 `local.json`，实测数字只进 `MEASUREMENTS.md`。两个工具的离线自检里有断言在守这条，别删。
+- **不要在技能正文里写本机事实**（内网地址、绝对路径、密钥、账号）：本机值只进 `local.json`（包外用户配置目录，见 `ADAPTING.md`），实测数字只进 `MEASUREMENTS.md`。两个工具的离线自检里有断言在守这条，别删。
 - **工具一律 fail-open**：找不到密钥/超时/HTTP 报错都返回 `unknown` 并回退人工规则，核查流程不应中断。

package/INSTRUCTIONS.md

@@ -23,12 +23,12 @@
 4. **平台专用工具**——视频 / 社交类平台的专用 CLI（字幕、弹幕、评论等）；
 5. **免登录直取接口**——平台公开的免登录端点；拿不到就如实标注"未能获取原文"，不要伪造。
 
-哪条链在本机可用、哪个站已经挂了，属于**运行时基线**：写进 `tools/local.json` 的 `runtimeNotes`（带日期），**不要写进本文**——正文没有时效标注机制，写在这里半年后就是过期信息，而且换台机器就得改正文。
+哪条链在本机可用、哪个站已经挂了，属于**运行时基线**：写进 `local.json`（包外用户配置目录，见 `ADAPTING.md`）的 `runtimeNotes`（带日期），**不要写进本文**——正文没有时效标注机制，写在这里半年后就是过期信息，而且换台机器就得改正文。
 
 **首选路径失败必须自动降级到次选**，而不是直接判定"无法核查"。只有**五条路径全部失败**才判"无法核查"，且必须在报告的「本次未能核实到的」里写明试过哪几条、各自报什么错。
 **搜索结果的 `content` / `snippet` 字段只是摘要，不能当正文计入证据。**
 
-**本技能不绑定任何具体产品、主机或工具链。** 正文只使用"能力名"；把能力落到你的环境里见 `ADAPTING.md`；所有"在某台机器上测出来"的数字都在 `MEASUREMENTS.md`，它们**是证据，不是配置**。本机的能力绑定与输出约定可写进 `tools/local.json`（可选字段，见 `tools/local.example.json`），正文只保留默认值。
+**本技能不绑定任何具体产品、主机或工具链。** 正文只使用"能力名"；把能力落到你的环境里见 `ADAPTING.md`；所有"在某台机器上测出来"的数字都在 `MEASUREMENTS.md`，它们**是证据，不是配置**。本机的能力绑定与输出约定可写进 `local.json`（包外，可选字段，见 `tools/local.example.json`），正文只保留默认值。
 
 自检：`node tools/doctor.mjs` 会探测当前环境有哪些能力、缺什么、会降级成什么样；加 `--net` 会额外自测判据端点与**两条可自测的抓取链**（宿主内置抓取与搜索服务的抽取字段它探不到，需自己各跑一次真实抓取确认）。
 
@@ -299,6 +299,8 @@
 | 封闭生态 | 不涉及 | 涉及公众号 / 知乎 / 视频站 / Reddit / 微博等需逐渠道专门取正文 |
 | 用户口径 | "简单查一下""快点看看" | 明确要"彻底核查""多找些资料" |
 
+**兜底域不等于简单任务**：`plan` 输出里 `fallback: true` 表示没有命中任何具体事实类型、给的是 `general_fact` 通用阶梯；`closed=false` 只说明「尚未识别出封闭生态」，不代表任务简单。此时仍按上表逐条判，**任一命中右列即派**。（1.5.1 修的正是这处：早期版本把未识别任务兜底到软件发布域 tech_release，并提示「单路可覆盖」，把该派的任务劝退了。）
+
 四种走法：
 
 - **轻量直连**：主对话自己多路搜索 + 抓取，本轮内出结论。**轻量 ≠ 降标准**——多源交叉、国内外并行、来源四要素等铁律全部照旧，只是不拆子代理。
@@ -312,8 +314,18 @@
 - 需要核实的事实点；
 - **必须遵守的规则**：多源交叉、来源固定四要素（出处名 / 来源类型 / 完整可点击 URL / 引用位置）、原文摘录加引号标"原文"否则标"转述"、配一条质疑词反查、抓不到就如实写"未能获取"而不许编造；
 - **该渠道的具体抓取手段**（如"Reddit 走 `.json` 端点""视频站走字幕/弹幕工具""X 走 syndication 接口"），避免子代理在登录墙上空转。
+- **「引文净化」约定必须写进派发 prompt**（见下节「回报的引文净化」）：子代理的最终回报会经过内容审核，逐字复述辱称或族群贬损文本可能让**整条回报被丢弃**，那一路渠道的证据就全丢了。
+
+### 回报的引文净化
+
+极端题材（族群冲突、辱骂、暴力内容）里，逐字引文既有**失真风险**（转述链上被裁剪成更冒犯的版本）也有**丢回报风险**。回报时统一按这两档处理：
+
+- **事实性表述照常逐字引**——时间、账号名、tweet_id、互动量、可观察行为特征（建号时间、发帖节奏、是否模板化），以及任何不含贬损的中性陈述；
+- **贬损性 / 辱骂性原文不逐字复述**——改为**分类描述 + 定位信息**：`该帖含针对特定族群的贬损表述`（或"人身侮辱""辱华/辱土"这类中性的性质标签）+ **原帖 URL + tweet_id + 发布时间**。需要逐字文本时由主对话自己调 syndication / oembed 接口取，不经子代理回报。
+
+**这是「原文摘录加引号并注明"原文"」规则在极端题材上的例外**：不引脏文本，但替代它的定位信息必须齐全，否则等于没给证据。这也不是软化结论——**性质、来源、定位信息一个不少**，少的是可被断章引用的原始脏文本；而"存在辱骂"这一事实本身，分类描述 + 可点击 URL 已经足够，且更经得起复核。极端题材建议按渠道数**多派一路冗余**（3→4）：某条回报若被整条丢弃，证据不至于全失。
 
-**回报**：每个子代理回报时须标注**来源同源性**（如"本渠道 6 条结果均转载自同一篇首发"），主对话才能正确计算独立源头数。**回报结构统一**：
+**回报**：每个子代理回报时须标注**来源同源性**（如"本渠道 6 条结果均转载自同一篇首发"），主对话才能正确计算独立源头数。回报**第一行写渠道状态**——`渠道状态：已取证 / 无命中 / 抓取失败`——主对话才能区分「这条渠道确实没有证据」与「这条渠道的回报丢了」，不至于把后者当成前者直接降档。**回报结构统一**：
 
 ```
 渠道 → 命中来源清单（带四要素）→ 与主线是否一致 / 矛盾 → 抓取失败的渠道及原因
@@ -330,7 +342,7 @@
 - 目录结构：**`FOR-AI.md`（交给 AI 的操作说明：逐步配置与使用）** + `SKILL.md`（本文件，流程与规则）+ `ADAPTING.md`（换环境要改什么）+ `MEASUREMENTS.md`（实测数字与复跑）+ `CHANGELOG.md`（版本间净变化）+ `lib/index.js`（DSH 插件入口：把本文件挂到 `ctx.skills`）+ `cordis.patch.yml`（让本包能被 `dsh plugin add` 安装）+ `tools/`（两个可选工具、本机配置模板与数据表）+ `cases/`（回归语料）+ `README.md` / `README.zh-CN.md`（给人类的说明）+ `submission/`（投稿到插件市场的条目文件，不属于插件包本身）。
 - **两种分发形态同一份正文**：① `dsh plugin add github:7starsseeker/dsh-fact-check`（DSH 插件市场的形态，`lib/index.js` 现读本文件，所以改本文件不必改代码）；② 把整个目录交给任何 AI 工具（`FOR-AI.md` 那套）。**不要为其中一种抄一份正文出来**——两份必然漂移，`tools/smoke-plugin.mjs` 里有断言在守"候选描述 = 本文件 frontmatter 的 description"这条单一真相源。
 - **改判据 = 重新校准事件**：`tools/jev-verdict.mjs` 里的 `QUESTIONS` 是冻结字面量，任何 instruction/criteria/阈值改动都必须重跑 `cases/` 下的回归，并把新数字写回 `MEASUREMENTS.md`。**`tools/route.mjs` 的触发词表与域路由表同理**：改完要重跑 `node tools/route.mjs regress --file cases/route-cases-neutral.json` 与 `node tools/route.mjs selftest`。
-- **环境相关的值只放 `tools/local.json`**（模板 `tools/local.example.json`）：密钥、端点、state 目录、数据表里的 `${占位符}`，以及可选的能力绑定 `capabilities`、输出约定 `outputConvention`、运行时基线 `runtimeNotes`。代码与数据表**不写死任何主机路径**，`selftest` 里有断言在守这条。
+- **环境相关的值只放 `local.json`**（包外用户配置目录；模板 `tools/local.example.json`）：密钥、端点、state 目录、数据表里的 `${占位符}`，以及可选的能力绑定 `capabilities`、输出约定 `outputConvention`、运行时基线 `runtimeNotes`。代码与数据表**不写死任何主机路径**，`selftest` 里有断言在守这条。
 - **不要在本技能正文里写入任何主机、内网地址、路径或密钥**。本机事实要么进 `local.json`，要么作为"在某环境测得"的证据进 `MEASUREMENTS.md`。
 - **版本纪律**：凡是改动面向使用者的行为（流程、报告模板、判据、触发词），就升 frontmatter 的 `version` 并在 `CHANGELOG.md` 记一条净变化；只改措辞或文档不算。
 - **「利益相关与污染面」是标注制，不是降权制**：不要把任何"利益相关 / 疑似投毒 ⇒ 降档"的规则接进定档。至少会同时坏三件事（非单调、奖励信息垄断、全局降档），三条理由是那一节的正文，改之前先重读。

package/MEASUREMENTS.md

@@ -114,8 +114,8 @@
 node tools/doctor.mjs                                                                   # 先看本机能力与降级路径
 node tools/doctor.mjs --net                                                             # 再真跑一遍抓取链与端点自测
 node tools/jev-verdict.mjs selftest                                                     # 25 项离线断言，不花钱
-node tools/route.mjs selftest                                                           # 37 项离线断言，不花钱
-node tools/route.mjs regress --file cases/route-cases-neutral.json                      # 路由语料 26 例，不花钱
+node tools/route.mjs selftest                                                           # 44 项离线断言，不花钱
+node tools/route.mjs regress --file cases/route-cases-neutral.json                      # 路由语料 30 例，不花钱
 node tools/route.mjs arms                                                               # 派发臂代理指标（§4.1），不花钱
 
 # 本包自带的是（第二遍）去痕版语料
@@ -140,4 +140,5 @@ node tools/jev-verdict.mjs regress --file cases/sufficient-cases-neutral.json
 7. **`contradicted` ≠ 证伪**：`p < 0.5` 的档位里确实混着真值为"支持"的样本（§1.2），对外只能表述为"证据不足或被反驳，需人工复核"。
 8. **域路由的触发词是正则，必然有误命中**：`tech_release` 的词表里有「发布」，会把「政策发布会」这类任务拉进技术域（实测 dispatch 语料 D27 因此同时命中 5 个域）；`medical` 的单字「药」会把「农药残留」同时拉进医疗域。多命中**不影响结论正确性**（多一个域只是多给几条来源阶梯），但会推高 `dispatchHint` 的域数阈值。1.3.0 新增七个域时按「具体在前」排列以降低串味，既有域的**触发词**一个未动。1.3.0 另修了 `medical` 的**域路由**：原先指向 `official_json_api`（国务院政策文件库 / 法规库），与它阶梯首级的「药品监管机构批准信息」对不上，已改走 `gov_notice`（含国家药监局与市场监管总局）。
 9. **`factPointsInText` 不是真的拆事实点**：它只数任务文本里 `；;。\n` 的个数再 +1，却被 `dispatchHint` 当判据用（`>= 4` 就建议派发）。一段逗号连写的长任务会被低估，一段分号并列的短任务会被高估。它只够当粗筛，不要拿它当「事实点已拆好」的证据。
+10. **路由的兜底域（1.5.1 修）**：未命中任何触发词的任务原先兜底到 `tech_release`——那是「官方仓库 / 包管理器元数据」的阶梯，与多数任务无关；而且该域 `closed=false`，`dispatchHint` 会说「单路可覆盖，串行处理即可」，把「封闭生态 / 大量长文」这类真正该派的任务劝退。现改为专用 `general_fact` 兜底阶梯（当事方原始发布 → 通讯社 → 元搜索交叉 → 存档 → 当地媒体 → 社区线索），`plan` 输出新增 `fallback`，兜底时提示改为「按 SKILL.md 的信号表判断」。同一轮补了两条触发词（`cn_social_rumor`：推特 / Twitter / X 平台 / 骂战 / 对线 / 论战 / 口水战 / 开撕 / 网络战；`international`：土耳其 / 希腊 / 俄罗斯 / 越南 / 印度 / 韩国 / 朝鲜 / 以色列 / 巴勒斯坦 / 乌克兰 / 阿根廷 / 巴西 / 墨西哥 / 沙特 / 埃及）。按 §4.1 的代理指标重跑，**28/35 = 80.0% 与 7 条 mismatch（D08 / D10 / D12 / D15 / D27 / D30 / D37）逐条不变**——新增词条在 35 条共识样本上没改变任何一条判定；样本小，这只说明「未变差」，不等于扩词已在通用任务上验证。
 

package/README.md

@@ -68,7 +68,7 @@ are kept in their own sections — *unverified* and *undecidable* never sit in t
 The skill body is not bound to any host, product or tool chain: it names *capabilities*, and
 [`ADAPTING.md`](./ADAPTING.md) maps them onto your environment.
 
-**Verified hosts: DSH 0.1.7-rc.2, 0.2.0-rc.2 and 0.2.1-rc.2.** DSH 0.1.7-rc.2 was checked end to end on 2026-09-25 (Node 24.21.0, WSL/Linux): the host discovers the skill
+**Verified hosts: DSH 0.1.7-rc.2, 0.2.0-rc.2, 0.2.1-rc.2, 0.2.1-rc.3 and 0.2.1-rc.5.** DSH 0.1.7-rc.2 was checked end to end on 2026-09-25 (Node 24.21.0, WSL/Linux): the host discovers the skill
 and loads its body; the plugin form mounts on the host's own skill registry with `source: bundled`, its
 description read from `SKILL.md` and `get()` returning that body verbatim; `npm run selftest` passes
 (plugin mount 27/27, `jev-verdict` 25/25, `route` 37/37); `route.mjs regress` is 26/26 offline; and the
@@ -83,6 +83,12 @@ forbidden.
 
 **DSH 0.2.1-rc.2 was checked end to end on 2026-10-17** (Node 24.21.0, Windows). The registry implementation (`@deepseek-ai/dsh-skill`'s `lib/index.js`) has **no content change** between 0.2.0-rc.2 and 0.2.1-rc.2 — the diff is line endings and version metadata only (`package.json` bumps the peers to cordis `~4.0.5` and adds a `./locale/*.json` export) — so no API adaptation was needed. What did change is what a provider may do with `control`, and this package now uses both 0.2.1 affordances: the candidate carries `path` (the absolute `SKILL.md`, retained in catalog summaries), and the provider watches `SKILL.md` and calls `control.invalidate()` on save, so editing the body refreshes the session catalog without a restart (150 ms debounce; the watcher is torn down on `control.signal` abort or context dispose, and a host that passes no `control` keeps the previous "restart to re-read" behavior). Evidence: the plugin was mounted on the host's own `0.2.1-rc.2` registry code (taken from the shipped asar, wired with the host's own cordis 4.0.5) and on the **published** `0.2.0-rc.2` package — 21/21 checks on each, `snapshot.complete === true`, `get()` returning the body verbatim, `provider.list()` rank 600, and both edit→refresh cycles observed; `npm run selftest` 27/27, 25/25, 37/37 and `route.mjs regress` 26/26 re-run on Node 24.21.0.
 
+**DSH 0.2.1-rc.3 was checked on 2026-10-24** (Node 24.22.1, Windows). Nothing in the registry contract moved: `@deepseek-ai/dsh-skill` 0.2.1-rc.3 still exports `BUNDLED_SKILL_RANK` (600), `SkillRegistry`, `isSkillName`, `isModelInvocable` and `isUserInvocable`, still hands `registerProvider()` the same `control` (`{ signal, invalidate }`), and `invalidateCache()` still advances the cache revision and broadcasts `skills/change`. The plugin was mounted on that registry — taken from the shipped `app.asar`, wired with the host's own cordis 4.0.5 — and passed **28/28** checks: `inject: ['skills']`; the candidate carrying `source: bundled`, `rank` 600 equal to the host's own exported constant, the absolute `SKILL.md` as `path`, the package root as `resourceBase`, and the frontmatter description verbatim; `get()` returning the body (13,533 characters, frontmatter stripped, `path` retained); `control.invalidate()` advancing the registry revision 1 → 2 and emitting exactly one `skills/change`; and disposal removing the provider and aborting `control.signal`. Two details worth writing down because they look like failures and are not: the host's `toSummary()` deliberately drops `rank` from catalog summaries (it is a same-name arbitration input, not a display field), and registration only becomes observable once `ctx.plugin()`'s thenable resolves — inspected before that await, even a successful mount shows no `control`. In this same rc3 session the **directory** form is the one that runs (the host's own skill directory), and the session's skill catalog lists `fact-check` with this repository's `SKILL.md` description.
+
+**DSH 0.2.1-rc.5 was checked on 2026-10-31** (Node 26.13.0, Windows; the host version is the one the shipped `app.asar`'s `@deepseek-ai/dsh-desktop` declares, and `dsh --version` reports the same `0.2.1-rc.5`). The registry contract did not move again: `@deepseek-ai/dsh-skill` 0.2.1-rc.5 still exports `BUNDLED_SKILL_RANK` (600) together with the same `SkillRegistry` / `isSkillName` / `isModelInvocable` / `isUserInvocable` surface, still hands `registerProvider()` the same `control` (`{ signal, invalidate }`), and `validateCandidate`, `toSummary` and `renderSkillContent` behave as in 0.2.1-rc.3 — checked line by line against the file taken from the shipped `app.asar`, wired with the host's own cordis 4.0.5. The plugin mounted on that registry and passed **24/24** checks: `inject: ['skills']`; exactly one candidate for `fact-check`, carrying `source: bundled`, `rank` 600 equal to the host's exported constant, the absolute `SKILL.md` as `path` and the package root as `resourceBase`; `get()` returning the body (14,462 characters, frontmatter stripped); that body rendering through `renderSkillContent` with the package root as the resource base; `control.invalidate()` making an edited description visible to the catalogue (edited and reverted inside the probe — `git status --porcelain` empty afterwards); and disposal removing the provider again. The bundled suite re-ran green on Node 26.13.0: `smoke-plugin` 27/27, `jev-verdict selftest` 25/25, `route selftest` 44/44, `route.mjs regress` 30/30 offline, `doctor` exit 0.
+
+One host behaviour added in this release decides whether *any* plugin loads, so it is recorded here. `@deepseek-ai/dsh-app-boot` gained a plugin↔runtime compatibility gate: a plugin that declares `engines.dsh` must satisfy it; a plugin that declares no `engines.dsh` but *does* declare `peerDependencies` must satisfy every `@deepseek-ai/dsh` / `@deepseek-ai/dsh-*` peer; **a plugin with neither passes unconditionally**. Incompatible profile bundles are skipped without printing anything, and incompatible `cordis.patch.yml` rows are set `disabled`. This package declares only `engines.node` and no `peerDependencies`, so the gate cannot deny it on any runtime — a second reason, after the plugin-market one above, to keep the manifest free of host versions.
+
 ## Install
 
 ### As a DSH plugin
@@ -129,7 +135,7 @@ Two optional offline tools sit alongside it:
 
 | Tool | What it does |
 |---|---|
-| `node tools/route.mjs plan --task "…"` | Deterministic planning: which source ladder and which channels this kind of claim needs, plus the failure-action table. A pure data table — no model, no tokens. |
+| `node tools/route.mjs plan --task "…"` | Deterministic planning: which source ladder and which channels this kind of claim needs, plus the failure-action table. A pure data table — no model, no tokens. A claim that matches no known fact type still gets the general fact-check ladder (flagged `fallback: true` in the output), never a software-release one. |
 | `node tools/jev-verdict.mjs` | The judgement client described below. |
 
 ## The optional Jev decision layer
@@ -146,8 +152,8 @@ Three judgements are inherently about facts rather than about prose, and the ski
 Two things about it are deliberate:
 
 - **It is optional.** With no key configured, the same three judgements are made by the deterministic
-  rules written in `SKILL.md`; nothing else changes. A key can come from `tools/local.json`, from the
-  `TYPESAFE_API_KEY` environment variable, or from `tools/jev-verdict.mjs --key-file`.
+  rules written in `SKILL.md`; nothing else changes. A key can come from the local config
+  (`local.json`), from the `TYPESAFE_API_KEY` environment variable, or from `tools/jev-verdict.mjs --key-file`.
 - **A model verdict can only lower a grade, never raise it.** The conclusion tier is decided by the
   deterministic rule *number of independent sources → tier*; a model saying "the evidence supports this"
   promotes nothing. Only "insufficient evidence" or "contradicts the evidence" triggers an action.
@@ -172,7 +178,7 @@ node tools/doctor.mjs                                # what this machine can and
 
 `node tools/doctor.mjs --net` additionally self-tests the fetch chains and the judgement endpoint, and
 reports which capabilities are missing and how the skill degrades without them. Current status on this
-checkout: **27/27**, **25/25**, **37/37** and **26/26** assertions pass.
+checkout: **27/27**, **25/25**, **44/44** and **30/30** assertions pass.
 
 CI runs exactly these commands on Linux and Windows, on Node 18 and 22, plus one more check: that the
 generated `INSTRUCTIONS.md` still matches `SKILL.md`.
@@ -197,7 +203,9 @@ generated `INSTRUCTIONS.md` still matches `SKILL.md`.
 ## Configuration
 
 Machine-specific values — endpoints, keys, which channels actually work on your machine — live in
-`tools/local.json`, which is git-ignored and shipped only as [`tools/local.example.json`](./tools/local.example.json).
+`local.json` **outside the package** (default `%LOCALAPPDATA%\dsh-fact-check\local.json` on Windows,
+`~/.config/dsh-fact-check/local.json` elsewhere; override with `JEV_LOCAL_CONFIG`), so a package update
+cannot wipe them. The template ships as [`tools/local.example.json`](./tools/local.example.json).
 No host path, endpoint or key is hard-coded in the code or the data tables, and `tools/*.mjs` carry
 assertions that fail if one ever appears.
 

package/README.zh-CN.md

@@ -62,7 +62,7 @@
 技能正文不绑定任何产品、主机或工具链：它只写**能力名**，由 [`ADAPTING.md`](./ADAPTING.md) 把能力
 落到你的环境里。
 
-**已验证宿主：DSH 0.1.7-rc.2、0.2.0-rc.2 与 0.2.1-rc.2。** 0.1.7-rc.2 于 2026-09-25 完整跑过一遍（Node 24.21.0，WSL/Linux）：宿主能发现本技能并读入正文；
+**已验证宿主：DSH 0.1.7-rc.2、0.2.0-rc.2、0.2.1-rc.2、0.2.1-rc.3 与 0.2.1-rc.5。** 0.1.7-rc.2 于 2026-09-25 完整跑过一遍（Node 24.21.0，WSL/Linux）：宿主能发现本技能并读入正文；
 插件形态能挂到宿主自己的技能注册表上，`source: bundled`，描述取自 `SKILL.md`，`get()` 交出的正文
 与 `SKILL.md` 逐字一致；`npm run selftest` 全过（插件挂载 27/27、`jev-verdict` 25/25、`route` 37/37）；
 `route.mjs regress` 离线 26/26；判据语料复现 [`MEASUREMENTS.md`](./MEASUREMENTS.md) §6 的预期 ——
@@ -75,6 +75,12 @@
 
 **DSH 0.2.1-rc.2 于 2026-10-17 完整跑过一遍**（Node 24.21.0，Windows）。注册表的实现（`@deepseek-ai/dsh-skill` 的 `lib/index.js`）在 0.2.0-rc.2 与 0.2.1-rc.2 之间**内容没有变化** —— diff 只有换行符与版本号（`package.json` 把 peer 依赖抬到 cordis `~4.0.5`、加了一个 `./locale/*.json` 导出）—— 所以不需要任何 API 适配。变的是 provider 能拿 `control` **做什么**，本包两样都用上了：候选带上 `path`（指向绝对的 `SKILL.md`，摘要会保留它）；provider 监听 `SKILL.md`，保存时调 `control.invalidate()`，改正文不必重启就会刷新会话里的技能目录（150 ms 去抖；`control.signal` abort 或上下文销毁时收尾，宿主不传 `control` 时退化为「改完重启生效」）。证据：插件分别挂到宿主自己那套 `0.2.1-rc.2` 注册表代码（从已发布的 asar 里取出，配宿主自带的 cordis 4.0.5）与**已发布**的 `0.2.0-rc.2` 包上，各 21/21 项检查通过：`snapshot.complete === true`、`get()` 交出的正文与 `SKILL.md` 逐字一致、`provider.list()` 的 rank 为 600，两轮「改文件 → 目录自动刷新」都观察到了；`npm run selftest` 27/27、25/25、37/37 与 `route.mjs regress` 26/26 均在 Node 24.21.0 上复跑。
 
+**DSH 0.2.1-rc.3 于 2026-10-24 完整跑过一遍**（Node 24.22.1，Windows）。注册表契约没有位移：`@deepseek-ai/dsh-skill` 0.2.1-rc.3 仍导出 `BUNDLED_SKILL_RANK`（600）、`SkillRegistry`、`isSkillName`、`isModelInvocable` 与 `isUserInvocable`，`registerProvider()` 交出的 `control`（`{ signal, invalidate }`）不变，`invalidateCache()` 仍推进缓存 revision 并广播 `skills/change`。插件挂在这套注册表上（取自随宿主发布的 `app.asar`，配宿主自己的 cordis 4.0.5）通过了 **28/28** 项检查：`inject: ['skills']`；候选带 `source: bundled`、`rank` 600 等于宿主导出的常量、绝对 `SKILL.md` 作为 `path`、包根目录作为 `resourceBase`、描述与 frontmatter 逐字一致；`get()` 交出正文（13,533 字符，frontmatter 已剥离，`path` 保留）；`control.invalidate()` 让注册表 revision 从 1 到 2 并恰好广播一次 `skills/change`；拆卸后 provider 消失且 `control.signal` 已 abort。两处看着像失败、其实不是的细节也一并记下：宿主的 `toSummary()` 有意不在目录摘要里带 `rank`（它是同名仲裁的输入，不是展示字段）；注册只在 `ctx.plugin()` 的 thenable 落定后可观测 —— 在 await 之前去看，即便挂载成功也看不到 `control`。同一次 rc3 会话里真正运行的是**目录形态**（宿主自己的技能目录），会话的技能目录用本仓 `SKILL.md` 的描述列出了 `fact-check`。
+
+**DSH 0.2.1-rc.5 于 2026-10-31 完整跑过一遍**（Node 26.13.0，Windows；宿主版本以随宿主发布的 `app.asar` 里 `@deepseek-ai/dsh-desktop` 声明的为准，`dsh --version` 报的也是同一个 `0.2.1-rc.5`）。注册表契约再次没有位移：`@deepseek-ai/dsh-skill` 0.2.1-rc.5 仍导出 `BUNDLED_SKILL_RANK`（600）与同一套 `SkillRegistry` / `isSkillName` / `isModelInvocable` / `isUserInvocable`，`registerProvider()` 交出的 `control`（`{ signal, invalidate }`）不变，`validateCandidate`、`toSummary`、`renderSkillContent` 的行为与 0.2.1-rc.3 一致 —— 均逐行对着从 `app.asar` 取出的那份文件、配宿主自己的 cordis 4.0.5 核过。插件挂在这套注册表上通过了 **24/24** 项检查：`inject: ['skills']`；`fact-check` 恰好一条候选，带 `source: bundled`、`rank` 600 等于宿主导出的常量、绝对 `SKILL.md` 作为 `path`、包根目录作为 `resourceBase`；`get()` 交出正文（14,462 字符，frontmatter 已剥离）；该正文经 `renderSkillContent` 可正常渲染且资源基准为包根；`control.invalidate()` 让改动过的描述在目录里可见（探针内改完即还原，事后 `git status --porcelain` 为空）；拆卸后 provider 再次消失。仓库自带套件在 Node 26.13.0 上复跑全绿：`smoke-plugin` 27/27、`jev-verdict selftest` 25/25、`route selftest` 44/44、`route.mjs regress` 离线 30/30、`doctor` exit 0。
+
+这一版新增的一条宿主行为决定**任何**插件能不能加载，所以记在这里。`@deepseek-ai/dsh-app-boot` 加了插件↔运行时兼容门禁：声明了 `engines.dsh` 的插件必须满足它；没有 `engines.dsh` 但**有** `peerDependencies` 的插件，其中凡是 `@deepseek-ai/dsh` / `@deepseek-ai/dsh-*` 的 peer 都必须满足；**两者都没有的插件无条件通过**。不兼容的 profile bundle 会被静默跳过、不打印任何东西，不兼容的 `cordis.patch.yml` 行会被置 `disabled`。本包只声明 `engines.node`、没有 `peerDependencies`，所以门禁在任何运行时上都无法拒载它 —— 这是除上面那条插件市场理由之外，又一条把 manifest 保持为「不声明宿主版本」的理由。
+
 ## 安装
 
 ### 作为 DSH 插件
@@ -119,7 +125,7 @@ dsh plugin add ./dsh-fact-check
 
 | 工具 | 做什么 |
 |---|---|
-| `node tools/route.mjs plan --task "…"` | 确定性规划：这类核查该走哪条来源阶梯、哪些渠道，以及失败动作表。纯数据表，无模型、0 token。 |
+| `node tools/route.mjs plan --task "…"` | 确定性规划：这类核查该走哪条来源阶梯、哪些渠道，以及失败动作表。纯数据表，无模型、0 token。未命中任何已知事实类型的任务也照样给阶梯——给的是通用事实核查阶梯（输出里 `fallback: true`），不会是软件发布那套。 |
 | `node tools/jev-verdict.mjs` | 下面说的判据客户端。 |
 
 ## 可选的 Jev 判据层
@@ -136,7 +142,7 @@ dsh plugin add ./dsh-fact-check
 两件事是刻意的：
 
 - **它是可选的。** 没配密钥时，这三件事由 `SKILL.md` 里写死的确定性规则执行，其余流程完全不变。
-  密钥可以来自 `tools/local.json`、环境变量 `TYPESAFE_API_KEY`，或 `tools/jev-verdict.mjs --key-file`。
+  密钥可以来自本机配置 `local.json`、环境变量 `TYPESAFE_API_KEY`，或 `tools/jev-verdict.mjs --key-file`。
 - **模型的判断只能降档，不能升档。** 结论档位由确定性规则「独立来源数 → 档位」裁定；模型说「支持」
   不会让任何东西升级。只有「证据不足」或「与证据矛盾」才触发动作。
 
@@ -157,7 +163,7 @@ node tools/doctor.mjs                                # 这台机器能做什么
 ```
 
 `node tools/doctor.mjs --net` 会额外自测抓取链与判据端点，并报告缺哪些能力、缺了会降级成什么样。
-本检出上的当前状态：**27/27**、**25/25**、**37/37**、**26/26** 断言全过。
+本检出上的当前状态：**27/27**、**25/25**、**44/44**、**30/30** 断言全过。
 
 CI 在 Linux 与 Windows 上、Node 18 与 22 下跑的就是上面这几条，另外多一条检查：生成的
 `INSTRUCTIONS.md` 是否仍然与 `SKILL.md` 一致。
@@ -181,8 +187,10 @@ CI 在 Linux 与 Windows 上、Node 18 与 22 下跑的就是上面这几条，
 
 ## 配置
 
-主机相关的值——端点、密钥、你那台机器上哪些渠道真的能用——一律放 `tools/local.json`，它被 gitignore，
-只分发 [`tools/local.example.json`](./tools/local.example.json)。代码与数据表里**不写死**任何主机路径、
+主机相关的值——端点、密钥、你那台机器上哪些渠道真的能用——一律放 `local.json`，它在**包外**
+（默认 `%LOCALAPPDATA%\dsh-fact-check\local.json`，其它平台 `~/.config/dsh-fact-check/local.json`，
+可用 `JEV_LOCAL_CONFIG` 覆盖），这样包更新不会把它清掉。模板只分发
+[`tools/local.example.json`](./tools/local.example.json)。代码与数据表里**不写死**任何主机路径、
 端点或密钥，`tools/*.mjs` 里有断言专门守这条。
 
 ## 参与贡献

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: fact-check
-version: 1.5.0
+version: 1.5.2
 description: 事实核查与资料搜索。当用户要求核实事实/传闻/新闻/数据/情况的真伪、查证信息、确认现状、补充资料时使用——即使用户只说了"查一下""确认一下""核实""这是不是真的""帮我看看"，也应触发。核心行为：不依赖自身知识库，所有关键信息一律通过互联网搜索获取，搜索途径与信息来源尽量多样以便交叉核实，并同时覆盖国内与国外信息生态。执行模式按工作量自动选择：轻量核查由主对话直连完成，渠道多或需抓取大量长文时自动分派并行子代理。
 ---
 
@@ -24,12 +24,12 @@ description: 事实核查与资料搜索。当用户要求核实事实/传闻/
 4. **平台专用工具**——视频 / 社交类平台的专用 CLI（字幕、弹幕、评论等）；
 5. **免登录直取接口**——平台公开的免登录端点；拿不到就如实标注"未能获取原文"，不要伪造。
 
-哪条链在本机可用、哪个站已经挂了，属于**运行时基线**：写进 `tools/local.json` 的 `runtimeNotes`（带日期），**不要写进本文**——正文没有时效标注机制，写在这里半年后就是过期信息，而且换台机器就得改正文。
+哪条链在本机可用、哪个站已经挂了，属于**运行时基线**：写进 `local.json`（包外用户配置目录，见 `ADAPTING.md`）的 `runtimeNotes`（带日期），**不要写进本文**——正文没有时效标注机制，写在这里半年后就是过期信息，而且换台机器就得改正文。
 
 **首选路径失败必须自动降级到次选**，而不是直接判定"无法核查"。只有**五条路径全部失败**才判"无法核查"，且必须在报告的「本次未能核实到的」里写明试过哪几条、各自报什么错。
 **搜索结果的 `content` / `snippet` 字段只是摘要，不能当正文计入证据。**
 
-**本技能不绑定任何具体产品、主机或工具链。** 正文只使用"能力名"；把能力落到你的环境里见 `ADAPTING.md`；所有"在某台机器上测出来"的数字都在 `MEASUREMENTS.md`，它们**是证据，不是配置**。本机的能力绑定与输出约定可写进 `tools/local.json`（可选字段，见 `tools/local.example.json`），正文只保留默认值。
+**本技能不绑定任何具体产品、主机或工具链。** 正文只使用"能力名"；把能力落到你的环境里见 `ADAPTING.md`；所有"在某台机器上测出来"的数字都在 `MEASUREMENTS.md`，它们**是证据，不是配置**。本机的能力绑定与输出约定可写进 `local.json`（包外，可选字段，见 `tools/local.example.json`），正文只保留默认值。
 
 自检：`node tools/doctor.mjs` 会探测当前环境有哪些能力、缺什么、会降级成什么样；加 `--net` 会额外自测判据端点与**两条可自测的抓取链**（宿主内置抓取与搜索服务的抽取字段它探不到，需自己各跑一次真实抓取确认）。
 
@@ -300,6 +300,8 @@ description: 事实核查与资料搜索。当用户要求核实事实/传闻/
 | 封闭生态 | 不涉及 | 涉及公众号 / 知乎 / 视频站 / Reddit / 微博等需逐渠道专门取正文 |
 | 用户口径 | "简单查一下""快点看看" | 明确要"彻底核查""多找些资料" |
 
+**兜底域不等于简单任务**：`plan` 输出里 `fallback: true` 表示没有命中任何具体事实类型、给的是 `general_fact` 通用阶梯；`closed=false` 只说明「尚未识别出封闭生态」，不代表任务简单。此时仍按上表逐条判，**任一命中右列即派**。（1.5.1 修的正是这处：早期版本把未识别任务兜底到软件发布域 tech_release，并提示「单路可覆盖」，把该派的任务劝退了。）
+
 四种走法：
 
 - **轻量直连**：主对话自己多路搜索 + 抓取，本轮内出结论。**轻量 ≠ 降标准**——多源交叉、国内外并行、来源四要素等铁律全部照旧，只是不拆子代理。
@@ -313,8 +315,18 @@ description: 事实核查与资料搜索。当用户要求核实事实/传闻/
 - 需要核实的事实点；
 - **必须遵守的规则**：多源交叉、来源固定四要素（出处名 / 来源类型 / 完整可点击 URL / 引用位置）、原文摘录加引号标"原文"否则标"转述"、配一条质疑词反查、抓不到就如实写"未能获取"而不许编造；
 - **该渠道的具体抓取手段**（如"Reddit 走 `.json` 端点""视频站走字幕/弹幕工具""X 走 syndication 接口"），避免子代理在登录墙上空转。
+- **「引文净化」约定必须写进派发 prompt**（见下节「回报的引文净化」）：子代理的最终回报会经过内容审核，逐字复述辱称或族群贬损文本可能让**整条回报被丢弃**，那一路渠道的证据就全丢了。
+
+### 回报的引文净化
+
+极端题材（族群冲突、辱骂、暴力内容）里，逐字引文既有**失真风险**（转述链上被裁剪成更冒犯的版本）也有**丢回报风险**。回报时统一按这两档处理：
+
+- **事实性表述照常逐字引**——时间、账号名、tweet_id、互动量、可观察行为特征（建号时间、发帖节奏、是否模板化），以及任何不含贬损的中性陈述；
+- **贬损性 / 辱骂性原文不逐字复述**——改为**分类描述 + 定位信息**：`该帖含针对特定族群的贬损表述`（或"人身侮辱""辱华/辱土"这类中性的性质标签）+ **原帖 URL + tweet_id + 发布时间**。需要逐字文本时由主对话自己调 syndication / oembed 接口取，不经子代理回报。
+
+**这是「原文摘录加引号并注明"原文"」规则在极端题材上的例外**：不引脏文本，但替代它的定位信息必须齐全，否则等于没给证据。这也不是软化结论——**性质、来源、定位信息一个不少**，少的是可被断章引用的原始脏文本；而"存在辱骂"这一事实本身，分类描述 + 可点击 URL 已经足够，且更经得起复核。极端题材建议按渠道数**多派一路冗余**（3→4）：某条回报若被整条丢弃，证据不至于全失。
 
-**回报**：每个子代理回报时须标注**来源同源性**（如"本渠道 6 条结果均转载自同一篇首发"），主对话才能正确计算独立源头数。**回报结构统一**：
+**回报**：每个子代理回报时须标注**来源同源性**（如"本渠道 6 条结果均转载自同一篇首发"），主对话才能正确计算独立源头数。回报**第一行写渠道状态**——`渠道状态：已取证 / 无命中 / 抓取失败`——主对话才能区分「这条渠道确实没有证据」与「这条渠道的回报丢了」，不至于把后者当成前者直接降档。**回报结构统一**：
 
 ```
 渠道 → 命中来源清单（带四要素）→ 与主线是否一致 / 矛盾 → 抓取失败的渠道及原因
@@ -331,7 +343,7 @@ description: 事实核查与资料搜索。当用户要求核实事实/传闻/
 - 目录结构：**`FOR-AI.md`（交给 AI 的操作说明：逐步配置与使用）** + `SKILL.md`（本文件，流程与规则）+ `ADAPTING.md`（换环境要改什么）+ `MEASUREMENTS.md`（实测数字与复跑）+ `CHANGELOG.md`（版本间净变化）+ `lib/index.js`（DSH 插件入口：把本文件挂到 `ctx.skills`）+ `cordis.patch.yml`（让本包能被 `dsh plugin add` 安装）+ `tools/`（两个可选工具、本机配置模板与数据表）+ `cases/`（回归语料）+ `README.md` / `README.zh-CN.md`（给人类的说明）+ `submission/`（投稿到插件市场的条目文件，不属于插件包本身）。
 - **两种分发形态同一份正文**：① `dsh plugin add github:7starsseeker/dsh-fact-check`（DSH 插件市场的形态，`lib/index.js` 现读本文件，所以改本文件不必改代码）；② 把整个目录交给任何 AI 工具（`FOR-AI.md` 那套）。**不要为其中一种抄一份正文出来**——两份必然漂移，`tools/smoke-plugin.mjs` 里有断言在守"候选描述 = 本文件 frontmatter 的 description"这条单一真相源。
 - **改判据 = 重新校准事件**：`tools/jev-verdict.mjs` 里的 `QUESTIONS` 是冻结字面量，任何 instruction/criteria/阈值改动都必须重跑 `cases/` 下的回归，并把新数字写回 `MEASUREMENTS.md`。**`tools/route.mjs` 的触发词表与域路由表同理**：改完要重跑 `node tools/route.mjs regress --file cases/route-cases-neutral.json` 与 `node tools/route.mjs selftest`。
-- **环境相关的值只放 `tools/local.json`**（模板 `tools/local.example.json`）：密钥、端点、state 目录、数据表里的 `${占位符}`，以及可选的能力绑定 `capabilities`、输出约定 `outputConvention`、运行时基线 `runtimeNotes`。代码与数据表**不写死任何主机路径**，`selftest` 里有断言在守这条。
+- **环境相关的值只放 `local.json`**（包外用户配置目录；模板 `tools/local.example.json`）：密钥、端点、state 目录、数据表里的 `${占位符}`，以及可选的能力绑定 `capabilities`、输出约定 `outputConvention`、运行时基线 `runtimeNotes`。代码与数据表**不写死任何主机路径**，`selftest` 里有断言在守这条。
 - **不要在本技能正文里写入任何主机、内网地址、路径或密钥**。本机事实要么进 `local.json`，要么作为"在某环境测得"的证据进 `MEASUREMENTS.md`。
 - **版本纪律**：凡是改动面向使用者的行为（流程、报告模板、判据、触发词），就升 frontmatter 的 `version` 并在 `CHANGELOG.md` 记一条净变化；只改措辞或文档不算。
 - **「利益相关与污染面」是标注制，不是降权制**：不要把任何"利益相关 / 疑似投毒 ⇒ 降档"的规则接进定档。至少会同时坏三件事（非单调、奖励信息垄断、全局降档），三条理由是那一节的正文，改之前先重读。

package/cases/README.md

@@ -35,7 +35,7 @@
 | `dispatch-blind-neutral.json` | 40 | —（仅 id + 任务描述，无标签） | 派发决策的**输入** |
 | `dispatch-label-L1-neutral.json` / `-L2-neutral.json` | 40×2 | 两名独立盲标注员 | 两人一致 35/40 = **87.5%**；不一致的 5 条即"口径本身有歧义" |
 | `dispatch-label-LLM-neutral.json` | 40 | 一个 LLM 用同一份判据作答 | 作为"派发决策让 LLM 现判"的对照臂 |
-| `route-cases-neutral.json` | 26 | 任务描述 → 期望命中的域 / 路线（按路由表机械裁定） | **26/26**（`route.mjs regress`，0 成本、不调模型、不出网） |
+| `route-cases-neutral.json` | 30 | 任务描述 → 期望命中的域 / 路线（按路由表机械裁定） | **30/30**（`route.mjs regress`，0 成本、不调模型、不出网） |
 
 前六套语料打的是**判据层**（`jev-verdict.mjs`，要密钥、有成本）；最后一套打的是**路由层**（`route.mjs`，纯数据表、0 成本）。路由层同样属于"判据"：**改触发词表或域路由表 = 重新校准事件**，必须重跑 `route.mjs regress` 与 `route.mjs selftest`。
 

package/cases/route-cases-neutral.json

@@ -1,11 +1,12 @@
 {
   "_about": "路由层回归语料（不调模型、不出网、0 成本）。每条给一个任务描述与若干 expect* 断言，检查 route.mjs 的确定性路由是否命中该命中的域、避开不该命中的域。跑法：node tools/route.mjs regress --file cases/route-cases-neutral.json",
-  "_generated_by": "2026-09-21 新增（补上游只有 selftest 断言、没有独立路由语料的缺口；触发词一改就必须重跑这里）；1.3.0 起随七个新域扩到 26 例",
+  "_generated_by": "2026-09-21 新增（补上游只有 selftest 断言、没有独立路由语料的缺口；触发词一改就必须重跑这里）；1.3.0 起随七个新域扩到 26 例；1.5.1 修兜底域后扩到 30 例（R10 改判 general_fact，新增 R27–R30）",
   "_notes": [
     "域是并列累积的：一个任务可以同时命中多个域，expectDomains 只要求包含（子集检查），不要求独占",
-    "expectClosed / expectDispatch 对应 plan 输出的 closedEcosystem / dispatchHint",
+    "expectClosed / expectFallback / expectDispatch 对应 plan 输出的 closedEcosystem / fallback / dispatchHint",
     "触发词表属于「判据」的一部分：改动触发词 = 重新校准事件，必须重跑本语料并记录",
-    "R15 起覆盖 1.3.0 新增的七个域（司法 / 灾害 / 食安 / 科学常识 / 教育考试 / 体育 / 娱乐），并检查相邻域不串味"
+    "R15 起覆盖 1.3.0 新增的七个域（司法 / 灾害 / 食安 / 科学常识 / 教育考试 / 体育 / 娱乐），并检查相邻域不串味",
+    "R10 / R27 断言未识别任务落到通用兜底域 general_fact 而不是软件发布域 tech_release；R28 / R29 覆盖 X 平台 / 推特上的骂战与对线（识别社媒域 + 封闭生态）；R30 覆盖外方国名进国际域"
   ],
   "cases": [
     {
@@ -63,7 +64,9 @@
     {
       "id": "R10",
       "task": "？？？",
-      "expectDomains": ["tech_release"]
+      "expectDomains": ["general_fact"],
+      "expectNotDomains": ["tech_release"],
+      "expectFallback": true
     },
     {
       "id": "R11",
@@ -159,6 +162,31 @@
       "task": "某球员转会费创纪录，核实金额是否属实",
       "expectDomains": ["sports"],
       "expectNotDomains": ["finance"]
+    },
+    {
+      "id": "R27",
+      "task": "今天天气不错",
+      "expectDomains": ["general_fact"],
+      "expectNotDomains": ["tech_release"],
+      "expectFallback": true
+    },
+    {
+      "id": "R28",
+      "task": "确认这几天 X 平台上两国网民骂战的来龙去脉和目前的状况",
+      "expectDomains": ["cn_social_rumor"],
+      "expectClosed": true,
+      "expectFallback": false
+    },
+    {
+      "id": "R29",
+      "task": "这几天推特上双方网友对线的来龙去脉",
+      "expectDomains": ["cn_social_rumor"],
+      "expectClosed": true
+    },
+    {
+      "id": "R30",
+      "task": "核查土耳其与某国之间的网络冲突",
+      "expectDomains": ["international"]
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-fact-check",
-  "version": "1.5.0",
+  "version": "1.5.2",
   "description": "Fact-checking skill for DeepSeek Harness: verifies claims against the open web instead of model memory, cross-checks independent sources across domestic and international search ecosystems, and can route three factual judgements (does the evidence support the claim / is this source primary / does this page carry usable text) to a TypeSafe Jev (System One) decision model when a key is configured, falling back to the skill's deterministic rules when it is not.",
   "keywords": [
     "deepseek-harness",

package/tools/config.mjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * config — 本机配置（local.json / secrets.json）的**包外**解析。
+ *
+ * 为什么需要这一层：`dsh plugin update` / `npm i` 换掉的是整个包目录。
+ * 配置如果写在 `tools/local.json`，每次更新都会被清掉；这个文件只决定
+ * “去哪儿找配置”，不改变配置本身的格式。
+ *
+ * 解析顺序（先命中先用）：
+ *   1. 环境变量 `JEV_LOCAL_CONFIG`（显式指定文件，便于测试与多机切换）
+ *   2. 平台配置目录：
+ *        Windows  %LOCALAPPDATA%\dsh-fact-check\local.json
+ *        其它     $XDG_CONFIG_HOME/dsh-fact-check/local.json 或 ~/.config/dsh-fact-check/local.json
+ *   3. 旧的包内路径 `tools/local.json`（向后兼容，不推荐继续用）
+ *
+ * `secrets.json` 用同一套目录，只是文件名不同。
+ * 零依赖；解析失败一律当作“没有配置”，绝不阻断核查流程。
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+
+export const APP_DIR = 'dsh-fact-check'
+
+/** 平台配置目录——包目录之外，更新不会动它。 */
+export function configDir() {
+  if (process.platform === 'win32' && process.env.LOCALAPPDATA) {
+    return join(process.env.LOCALAPPDATA, APP_DIR)
+  }
+  if (process.env.XDG_CONFIG_HOME) return join(process.env.XDG_CONFIG_HOME, APP_DIR)
+  return join(homedir(), '.config', APP_DIR)
+}
+
+/** 用户配置文件的**目标**路径（可能还不存在）。 */
+export function userConfigPath(name = 'local.json') {
+  return join(configDir(), name)
+}
+
+/**
+ * 按优先级列出候选路径。`pkgDir` 是 tools/ 目录（旧的包内位置）。
+ * 存在的排前面，但顺序严格按优先级——不存在的也在列表里，供 --write 判断。
+ */
+export function configCandidates(pkgDir, name = 'local.json') {
+  return [process.env.JEV_LOCAL_CONFIG, userConfigPath(name), join(pkgDir, name)].filter(Boolean)
+}
+
+/** 当前实际生效的配置文件；一个都不存在时返回 null。 */
+export function activeConfigPath(pkgDir, name = 'local.json') {
+  return configCandidates(pkgDir, name).find((f) => existsSync(f)) || null
+}
+
+/** 读 JSON；任何异常都返回 null（坏配置不能把核查流程带崩）。 */
+export function readJsonSafe(file) {
+  try {
+    return JSON.parse(readFileSync(file, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 读本机配置。
+ *   pkgDir  tools/ 目录（`import.meta.url` 所在目录）
+ *   name    文件名，默认 local.json
+ */
+export function readLocalConfig(pkgDir, name = 'local.json') {
+  const file = activeConfigPath(pkgDir, name)
+  return file ? readJsonSafe(file) || {} : {}
+}
+
+/**
+ * 写配置草稿：默认写到包外用户目录，已存在则不覆盖。
+ * 返回 { path, written }。
+ */
+export function writeLocalConfig(pkgDir, data, name = 'local.json') {
+  const existing = activeConfigPath(pkgDir, name)
+  if (existing) return { path: existing, written: false }
+  const target = userConfigPath(name)
+  mkdirSync(configDir(), { recursive: true })
+  writeFileSync(target, JSON.stringify(data, null, 2) + '\n', 'utf8')
+  return { path: target, written: true }
+}

package/tools/doctor.mjs

@@ -8,7 +8,7 @@
  *
  *   node tools/doctor.mjs            # offline checks only
  *   node tools/doctor.mjs --net      # also probe the endpoint, the local search service, and the fetch chain
- *   node tools/doctor.mjs --write    # write tools/local.json from detected values (won't overwrite)
+ *   node tools/doctor.mjs --write    # write the local config from detected values (won't overwrite)
  *   node tools/doctor.mjs --json     # machine-readable
  *
  * It never prints a secret — only where a key was found.
@@ -18,6 +18,7 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync, rmSync } from 'node
 import { dirname, join, isAbsolute, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { homedir, tmpdir } from 'node:os'
+import { activeConfigPath, readLocalConfig, userConfigPath, writeLocalConfig } from './config.mjs'
 import { spawnSync } from 'node:child_process'
 
 const HERE = dirname(fileURLToPath(import.meta.url))
@@ -36,7 +37,7 @@ function readJson(file) {
 }
 
 function localConfig() {
-  return readJson(join(HERE, 'local.json')) || {}
+  return readLocalConfig(HERE)
 }
 
 /* ---------------- runtime ---------------- */
@@ -44,6 +45,7 @@ function localConfig() {
 const major = Number(process.versions.node.split('.')[0])
 report.info.node = process.versions.node
 report.info.platform = `${process.platform} ${process.arch}`
+report.info.configFile = activeConfigPath(HERE) || `${userConfigPath('local.json')}（尚未生成）`
 if (major >= 18) report.ok.push(`Node ${process.versions.node}（≥18，内置 fetch / AbortSignal.timeout 可用）`)
 else report.fail.push(`Node ${process.versions.node} 过旧：需要 ≥18（内置 fetch）。判据层不可用，流程仍可按 SKILL.md 人工执行`)
 
@@ -255,9 +257,9 @@ if (has('--net')) {
 /* ---------------- --write ---------------- */
 
 if (has('--write')) {
-  const target = join(HERE, 'local.json')
-  if (existsSync(target)) {
-    report.warn.push(`local.json 已存在，未覆盖：${target}`)
+  const existing = activeConfigPath(HERE)
+  if (existing) {
+    report.warn.push(`local.json 已存在，未覆盖：${existing}`)
   } else {
     const generated = {
       _about: '由 doctor.mjs 生成；可按需修改。请勿提交或分享。',
@@ -272,8 +274,8 @@ if (has('--write')) {
         EXIFTOOL_CMD: process.env.JEV_EXIFTOOL_CMD || ov.EXIFTOOL_CMD || report.info.optionalTools.exiftool || null,
       },
     }
-    writeFileSync(target, JSON.stringify(generated, null, 2) + '\n', 'utf8')
-    report.ok.push(`已生成 ${target} —— 请把 null 的项按你的环境补上`)
+    const { path } = writeLocalConfig(HERE, generated)
+    report.ok.push(`已生成 ${path} —— 请把 null 的项按你的环境补上`)
   }
 }
 
@@ -287,6 +289,7 @@ if (has('--json')) {
   line('# fact-check skill · 环境自检')
   line('')
   line(`运行环境：Node ${report.info.node} · ${report.info.platform}`)
+  line(`本机配置：${report.info.configFile}`)
   line(`判据端点：${report.info.endpoint} · 模型：${report.info.model}`)
   line(`日志目录：${report.info.stateDir}${writable ? '（可写）' : '（不可写，会静默跳过）'}`)
   line('')
@@ -311,7 +314,7 @@ if (has('--json')) {
         '正文抽取字段探不到，请各自用一次真实抓取确认——这三条是"任一可用即可"的能力族。',
     )
   }
-  line('下一步：cp tools/local.example.json tools/local.json 并按上面提示填写；或 node tools/doctor.mjs --write 生成草稿。')
+  line(`下一步：node tools/doctor.mjs --write 生成配置草稿（写到 ${userConfigPath('local.json')}，包更新不会清掉）；或手动创建同名文件。`)
   line('')
 }
 

package/tools/engine-routes.json

@@ -1,5 +1,5 @@
 {
-  "_about": "渠道路由表：确定性映射，模型不参与。**这是模板，不是配置**：表里所有 ${...} 都是变量，取值由 tools/local.json 的 overrides（或 JEV_* 环境变量）提供；未填也能跑，计划会原样显示占位符并把它列进 localPlaceholdersUnset。",
+  "_about": "渠道路由表：确定性映射，模型不参与。**这是模板，不是配置**：表里所有 ${...} 都是变量，取值由 `local.json`（包外用户配置目录）的 overrides（或 JEV_* 环境变量）提供；未填也能跑，计划会原样显示占位符并把它列进 localPlaceholdersUnset。",
   "_template_note": "本表只描述公开可用的渠道与接口，不包含任何主机地址。下面的 capabilities 段是「这类渠道能干什么」，具体地址由你填。",
   "capabilities": {
     "searxng": "${SEARXNG_URL} —— 自托管元搜索：GET /search?q=…&format=json；引擎数量看你自己实例的 GET /config；若走 HTTP 代理，本地地址必须绕过代理；冷启首查可能超时，建议放宽到 20~30s",

package/tools/jev-verdict.mjs

@@ -31,6 +31,7 @@ import { readFileSync, writeFileSync, appendFileSync, existsSync, mkdirSync, rea
 import { dirname, join, isAbsolute, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { homedir } from 'node:os'
+import { readLocalConfig, userConfigPath } from './config.mjs'
 
 const HERE = dirname(fileURLToPath(import.meta.url))
 const ENDPOINT = 'https://api.typesafe.ai/v1/systemone'
@@ -48,8 +49,7 @@ const PRICE_PER_MTOK = 0.042
  */
 export function localConfig() {
   try {
-    const f = join(HERE, 'local.json')
-    if (existsSync(f)) return JSON.parse(readFileSync(f, 'utf8'))
+    return readLocalConfig(HERE)
   } catch {
     /* a broken local.json must never break a verdict */
   }
@@ -273,6 +273,7 @@ export function resolveKey({ explicit } = {}) {
       ? process.env.JEV_KEY_FILES.split(process.platform === 'win32' ? ';' : ':')
       : []),
     join(HERE, 'secrets.json'),
+    userConfigPath('secrets.json'),
   ].filter(Boolean)
   for (const f of candidates) {
     try {

package/tools/local.example.json

@@ -1,5 +1,5 @@
 {
-  "_about": "复制成 local.json 并填入你自己的值（或先跑 `node tools/doctor.mjs --write` 生成草稿）。local.json 属于本机配置：不要提交、不要随包分享、不要写进 SKILL.md。",
+  "_about": "复制成 local.json 并填入你自己的值（或先跑 `node tools/doctor.mjs --write` 生成草稿）。推荐放在包外的用户配置目录：Windows `%LOCALAPPDATA%\\dsh-fact-check\\local.json`，其它平台 `~/.config/dsh-fact-check/local.json`；也可用 JEV_LOCAL_CONFIG 指定路径。local.json 属于本机配置：不要提交、不要随包分享、不要写进 SKILL.md。",
   "_note": "全部字段都可以省略：省了就按内置默认值跑，占位符未填时 route.mjs 会把它们列进 localPlaceholdersUnset，jev-verdict.mjs 会在找不到密钥时明确报错并回退到人工规则。环境变量优先级高于本文件（JEV_ 前缀或原名，例如 JEV_SEARXNG_URL / SEARXNG_URL）。",
   "keyFile": "/path/to/your/secrets.json",
   "keyFiles": [],

package/tools/route.mjs

@@ -16,6 +16,7 @@
 import { readFileSync, writeFileSync, existsSync } from 'node:fs'
 import { dirname, join, isAbsolute, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
+import { activeConfigPath, readLocalConfig } from './config.mjs'
 
 const HERE = dirname(fileURLToPath(import.meta.url))
 const matrix = JSON.parse(readFileSync(join(HERE, 'source-matrix.json'), 'utf8'))
@@ -28,17 +29,25 @@ const CASES_DIR = resolve(HERE, '..', 'cases')
  * never in the tables or the code. Anything environment-specific in the tables
  * is written as ${PLACEHOLDER} and resolved here from:
  * env JEV_<NAME> → env <NAME> → local.json `overrides.<NAME>` → left as-is.
+ *
+ * The file itself lives OUTSIDE the package (see `config.mjs`), so a package
+ * update cannot delete the machine's settings; `tools/local.json` is still read
+ * as a fallback for older installs.
  */
 export function localOverrides() {
   try {
-    const f = join(HERE, 'local.json')
-    if (existsSync(f)) return JSON.parse(readFileSync(f, 'utf8')).overrides || {}
+    return readLocalConfig(HERE).overrides || {}
   } catch {
     /* a broken local.json must not break planning */
   }
   return {}
 }
 
+/** Which local.json is actually in effect — surfaced by the doctor/plan output. */
+export function localConfigPath() {
+  return activeConfigPath(HERE)
+}
+
 export function subst(text) {
   const ov = localOverrides()
   return String(text).replace(/\$\{([A-Z0-9_]+)\}/g, (m, name) =>
@@ -86,8 +95,8 @@ const DOMAIN_SIGNALS = [
   ['entertainment_celebrity', /(明星|艺人|演员|歌手|导演|主持人|网红|名人|公众人物|工作室|经纪公司|娱乐公司|粉丝|饭圈|塌房|绯闻|恋情|出道|退圈|封杀|演唱会|影视剧|综艺)/i],
   ['cn_policy', /(政策|法规|条例|法条|司法解释|统计年鉴|文号|国务院|征求意见)/i],
   ['finance', /(上市|股价|财报|融资|重组|证券|交易所|IPO|币|加密货币|跑路)/i],
-  ['cn_social_rumor', /(传闻|谣言|辟谣|网传|社媒|公众号|知乎|B\s?站|微博|小红书|抖音|舆情|热搜|大V|博主|网暴|舆论危机)/i],
-  ['international', /(国际|境外|外国|跨国|海外|联合国|世卫|欧盟|美国|美方|日本|日方|欧洲|白宫|国会|当地)/i],
+  ['cn_social_rumor', /(传闻|谣言|辟谣|网传|社媒|公众号|知乎|B\s?站|微博|小红书|抖音|舆情|热搜|大V|博主|网暴|舆论危机|推特|Twitter|X\s*平台|骂战|对线|论战|口水战|开撕|网络战)/i],
+  ['international', /(国际|境外|外国|跨国|海外|联合国|世卫|欧盟|美国|美方|日本|日方|欧洲|白宫|国会|当地|土耳其|希腊|俄罗斯|越南|印度|韩国|朝鲜|以色列|巴勒斯坦|乌克兰|阿根廷|巴西|墨西哥|沙特|埃及)/i],
   ['company_claim', /(公司|企业|厂商|宣布|合作|行业第一|市占|官网)/i],
   ['tech_release', /(版本|更新|发布|仓库|插件|npm|pip|库|许可|LICENSE|CVE|RFC|API|模型|部署)/i],
 ]
@@ -115,14 +124,20 @@ const DOMAIN_ROUTES = {
   education_exam: ['gov_notice', 'general_web', 'news_rss'],
   sports: ['sports_official', 'general_web', 'closed_intl_social'],
   entertainment_celebrity: ['entertainment_official', 'closed_cn_social', 'archive'],
+  general_fact: ['general_web', 'searxng_meta', 'news_rss', 'archive'],
 }
 
 export function planFor(task) {
   const matched = []
   for (const [domain, re] of DOMAIN_SIGNALS) if (re.test(task)) matched.push(domain)
-  // An unmatched task falls back to technology releases: the widest ladder, and the
-  // only one whose routes (general search + metasearch + vertical) fit any topic.
-  const chosen = matched.length ? matched : ['tech_release']
+  // An unmatched task falls back to the general fact-check domain: a ladder that
+  // applies to any topic (party's own release → wire service → metasearch → archive
+  // → local media), not the software-release ladder. Falling back to tech_release
+  // handed unrelated tasks a README/CHANGELOG ladder, and because that domain is
+  // not closed, a hint saying a single route was enough — which talked the agent
+  // out of dispatching.
+  const fallback = matched.length === 0
+  const chosen = fallback ? ['general_fact'] : matched
   const ladders = chosen.map((d) => ({ domain: d, label: matrix.domains[d].label, ladder: matrix.domains[d].ladder }))
   const routeIds = [...new Set(chosen.flatMap((d) => DOMAIN_ROUTES[d] || []))]
   const chosenRoutes = routeIds.map((id) => routes.routes.find((r) => r.id === id)).filter(Boolean)
@@ -131,15 +146,20 @@ export function planFor(task) {
   return {
     task,
     domains: chosen,
+    // True when no domain matched and the general ladder was used: read that ladder
+    // as a starting point, not as a domain verdict.
+    fallback,
     closedEcosystem: closed,
     factPointsInText: factPoints,
     ladders: substDeep(ladders),
     routes: chosenRoutes.map((r) => ({ id: r.id, when: subst(r.when), primary: substDeep(r.primary), notes: subst(r.notes) })),
     failureActions: substDeep(routes._failure_actions),
     localPlaceholdersUnset: unresolved(),
-    dispatchHint: closed || chosen.length >= 3 || factPoints >= 4
-      ? '需要多路取证（封闭生态 / 多类型事实点）→ 候选派子代理；最终仍以派发判据标注集为准'
-      : '单路可覆盖，串行处理即可',
+    dispatchHint: fallback
+      ? '未识别事实类型（兜底域）→ 按 SKILL.md 的信号表判断：涉及封闭生态 / 需抓大量长文 / 事实点 ≥4，任一命中即派子代理'
+      : closed || chosen.length >= 3 || factPoints >= 4
+        ? '需要多路取证（封闭生态 / 多类型事实点）→ 候选派子代理；最终仍以派发判据标注集为准'
+        : '单路可覆盖，串行处理即可',
   }
 }
 
@@ -248,7 +268,23 @@ function selftest() {
     const s = JSON.stringify(routes._failure_actions)
     return s.includes('403') && (s.includes('超时') || s.includes('000'))
   })
-  t('未匹配任务有兜底域', () => planFor('???').domains[0] === 'tech_release')
+  t('未匹配任务有兜底域', () => planFor('???').domains[0] === 'general_fact')
+  t('兜底域不是软件发布域（那套阶梯与多数任务无关）', () => planFor('???').domains[0] !== 'tech_release')
+  t('兜底域给出通用来源阶梯', () => {
+    const l = planFor('今天天气不错').ladders[0].ladder.join('|')
+    return l.includes('通讯社') && l.includes('当事方')
+  })
+  t('兜底任务提示按信号表判断派发（不误劝退）', () => {
+    const h = planFor('???').dispatchHint
+    return h.includes('未识别事实类型') && h.includes('派子代理')
+  })
+  t('兜底任务显式标记 fallback', () => planFor('???').fallback === true && planFor('网传某地发生地震').fallback === false)
+  t('社交平台战类任务识别出封闭生态', () =>
+    planFor('确认这几天 X 平台上两国网民骂战的来龙去脉和目前的状况').closedEcosystem === true)
+  t('社交平台战类任务识别为社媒域', () =>
+    planFor('这几天推特上双方网友对线的来龙去脉').domains.includes('cn_social_rumor'))
+  t('常见外方国名识别为国际域', () =>
+    planFor('核查土耳其与某国之间的网络冲突').domains.includes('international'))
   t('常见任务的路线数不超过 5 条', () => planFor('核查某公司宣称的合作是否属实，需要境外监管文件').routes.length <= 5)
   t('可移植：占位符可由 JEV_* 环境变量解析', () => {
     const old = process.env.JEV_SEARXNG_URL
@@ -335,6 +371,7 @@ function regress(file, out) {
     if (c.expectDomains) checks.push(['expectDomains', c.expectDomains.every((d) => p.domains.includes(d))])
     if (c.expectNotDomains) checks.push(['expectNotDomains', c.expectNotDomains.every((d) => !p.domains.includes(d))])
     if (typeof c.expectClosed === 'boolean') checks.push(['expectClosed', p.closedEcosystem === c.expectClosed])
+    if (typeof c.expectFallback === 'boolean') checks.push(['expectFallback', p.fallback === c.expectFallback])
     if (c.expectRoutes) checks.push(['expectRoutes', c.expectRoutes.every((r) => p.routes.some((x) => x.id === r))])
     if (typeof c.expectDispatch === 'boolean') {
       checks.push(['expectDispatch', c.expectDispatch === (p.dispatchHint.startsWith('需要多路取证'))])
@@ -346,6 +383,7 @@ function regress(file, out) {
       passed: ok,
       failed: failedOn,
       domains: p.domains,
+      fallback: p.fallback,
       closedEcosystem: p.closedEcosystem,
       routes: p.routes.map((r) => r.id),
     })

package/tools/source-matrix.json

@@ -106,6 +106,13 @@
       "closed": true,
       "note": "工作室声明是当事人立场而非中立证据：写进报告时须标注为「当事人声明」，不可当作第三方证据",
       "languages": ["zh", "en"]
+    },
+    "general_fact": {
+      "label": "通用事实核查（事实类型未识别时的兜底域）",
+      "ladder": ["当事方或主管机构的原始发布（官网、公告、原始账号）", "通讯社与官方广播（中外各一组）", "自托管元搜索与批量搜索交叉", "存档快照（Wayback）核对页面是否存在、是否被改", "当事国本地媒体（当地语言原文）", "社区与个人讨论（仅线索）"],
+      "closed": false,
+      "note": "兜底域：任务文本匹配不到任何具体事实类别时使用。早期版本兜底到 tech_release，那条阶梯是「官方仓库 / 包管理器元数据」，与多数任务无关，会同时给出错误的来源阶梯与错误的派发建议（该域 closed=false，提示会说「单路可覆盖」）。closed=false 只表示「尚未识别出封闭生态」，不表示任务一定不涉及——派发与否仍按 SKILL.md 的信号表判断。",
+      "languages": ["zh", "en"]
     }
   },
   "_rules": [