dsh-wiki-notes 1.10.2 → 1.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,40 @@
2
2
 
3
3
  本文件的体例:只记「对使用者有影响的行为变化」,不记内部重构。版本号遵循 semver,`0.x` 阶段不承诺兼容。
4
4
 
5
+ ## 1.11.0
6
+
7
+ ### 改 · 一个词两种含义,现在只剩一种:`degraded` → `orFallback`
8
+ `wiki_context` 的 `status.degraded` 说的是**引擎挂了**(先修通道再谈结论);`wiki_recall` 的 `degraded` 说的是**放宽成 OR**(命中面变宽、精度下降)。同一个词,一个要报警、一个只是提醒,读的人和模型都会弄反。
9
+
10
+ | 位置 | 旧 | 新 |
11
+ | --- | --- | --- |
12
+ | `wiki_recall` 结果字段 | `degraded: true` | `orFallback: true` |
13
+ | `wiki_recall` 结果状态 | `status: "degraded"` | `status: "or_fallback"` |
14
+ | `wiki_context` 的引擎状态 | `status.degraded` | **不变**(这里本来就该叫这个名字) |
15
+
16
+ 跟着改的消费者:调用账本的 `fallback` 推导、面板计数行的黄字提示、`help` 里的状态说明、README 与测试。`tests/status.mjs` 新加一条守卫:search 的结果里**不许再有** `degraded` 这个键 —— 改名这种东西,没人盯着就会在下一版悄悄长回来。
17
+
18
+ 这是输出契约的变化。你是被动读它的模型,动作不变(看到 `or_fallback` 就收窄检索词或换更短的词);但如果你的库里有脚本在 parse `degraded`,得跟着改。
19
+
20
+ ### 改 · 文档里那张概览截图改用随包示例库渲染
21
+ `docs/preview-overview.png` 现在是拿 `examples/demo-wiki`(手冲咖啡那 10 页)真跑 `node tools/preview.mjs --state <样例> --tab overview`、渲真组件后截的图。之前那张用的是本机私人笔记库的样例 —— 数字是真的,但「真实的库长什么样」本身就带着页名、标签、枢纽页这些不该出海的东西。
22
+
23
+ 图里的路径、使用情况计数都是编的,**数字结构是真的**(页数 / 小节 / 用时就来自那次真实渲染),所以图不会骗人:组件改了、重出一遍就同步。
24
+
25
+ ## 1.10.3
26
+
27
+ ### 新 · 第二种结构的示例库:一个目录 + 一堆 .md
28
+ - `examples/flat-wiki/`:8 页家常厨房笔记,全部平铺在根目录,**零 frontmatter**、没有 `index.md`、没有 `log.md`、没有子目录。
29
+ - 它对应 README 的第 0 层承诺。没有 frontmatter 就没有类型 / 标签 / 别名那几路加分,也没有索引页提供的一句话摘要,检索退化成「文件名 + 正文」——但它照样能查,而且缺字段不报错,类型筛选会明说「现有类型:(无类型) 8」。
30
+ - 两个示例库合起来覆盖两端:`demo-wiki` 结构齐全(分目录、七个字段、红链、孤岛页),`flat-wiki` 近乎零结构。
31
+
32
+ ### 修 · 仓库里的示例库现在有测试盯着
33
+ - 新增 `tests/examples.mjs`:两个库都读一遍,断言页数、字段归一、别名字段、标签、枢纽页入链数、红链数、正文非空;零 frontmatter 那个还要断言 `fields` 是空对象、`dir` 是 `.`、`logPresent` 是 false。
34
+ - 理由:`examples/` 在 `files` 里,示例库就是 npm 用户第一眼看到的东西。它被改坏了,坏的不是测试,是「装完试一下」这条唯一的低门槛体验。
35
+
36
+ ### 修 · 体检脚本的第三个假绿灯
37
+ - 版本指纹探针原来用 `overview.tags[0].with` 判断宿主版本,遇到**零标签的库**(正是 flat-wiki)会把好宿主判成旧模块;现在没有标签时这一项记 skip,不计入缺失。
38
+
5
39
  ## 1.10.2
6
40
 
7
41
  ### 新 · 一个跟笔记无关的示例库
package/README.md CHANGED
@@ -131,7 +131,7 @@ ts · source · tool · mode · query · hits · ms · ok
131
131
  status · fallback · considered · warnings · topScore
132
132
  ```
133
133
 
134
- 前 8 个是「发生了什么」,后 5 个是「为什么是这样」:`status` 是这次结果的状态(`ok` / `partial` / `no_match` / `unconfigured` / `error`),`fallback` 说明靠哪层兜底(`coverage` 字面兜底 / `or` 放宽 OR / 空 = 正常),`considered` 是参与比对的页数,`warnings` 是警告条数,`topScore` 是最高分。
134
+ 前 8 个是「发生了什么」,后 5 个是「为什么是这样」:`status` 是这次结果的状态(`ok` / `partial` / `or_fallback` / `no_match` / `unconfigured` / `error`),`fallback` 说明靠哪层兜底(`coverage` 字面兜底 / `or` 放宽 OR / 空 = 正常),`considered` 是参与比对的页数,`warnings` 是警告条数,`topScore` 是最高分。
135
135
 
136
136
  **没有这 5 个字段的时候,「0 命中」是一句没法追责的话**:换词重搜、放开过滤、修库路径,三种下一步长得一模一样。现在「命中」格悬停会显示「参与 N 页 · 最高 X 分」,诊断列直接标出「字面兜底 / 放宽 OR」。
137
137
 
@@ -177,14 +177,22 @@ plugin_manager { action: "install_bundle", target: "<绝对路径>" }
177
177
 
178
178
  返回 `application: applied` 就生效,不用重启。但**改插件自己的代码要重启 DSH**:`lib/*.js`(宿主半)和 `lib/client.js`(设置页)都一样,已载入的模块不会因为关开插件而重新求值。
179
179
 
180
- 想先看它到底怎么读库、不打算马上接自己的笔记:仓库里带了一个**跟笔记完全无关的小库** `examples/demo-wiki/`(10 页手冲咖啡笔记,含标签、别名、双链、一条红链、一个孤岛页),直接跑:
180
+ 想先看它到底怎么读库、不打算马上接自己的笔记:仓库里带了**两个跟笔记完全无关的小库**,分别对应「结构齐全」和「只有一个目录 + 一堆 `.md`」这两种最极端的情况。
181
181
 
182
182
  ```bash
183
+ # 结构齐全的那个:10 页手冲咖啡笔记,标签 / 别名 / 双链 / 一条红链 / 一个孤岛页
183
184
  node bin/cli.mjs search 萃取率怎么调 --root examples/demo-wiki
185
+
186
+ # 最低门槛的那个:8 页家常厨房笔记,全部平铺在根目录,零 frontmatter,没有 index.md / log.md
187
+ node bin/cli.mjs search 菜刀 --root examples/flat-wiki
188
+ node bin/cli.mjs overview --root examples/flat-wiki # 看它怎么如实说「这库没索引、没日志」
189
+
184
190
  WIKI_ROOT="<仓库绝对路径>/examples/demo-wiki" node tools/verify-host.mjs --self
185
191
  ```
186
192
 
187
- 它存在的意思是:这套东西只认「目录 + `.md` + frontmatter」,不认领域 —— 换一个库不需要改一行代码。
193
+ `flat-wiki` 存在的意思是:**第 0 层真能用**。没有 frontmatter 就没有类型、标签、别名那几路加分,也没有 `index.md` 提供的一句话摘要 —— 检索退化成「文件名 + 正文」,但它照样能查出东西,而且不会因为缺字段报错(类型筛选会明说「库里没有符合 type=概念 的页,现有类型:(无类型) 8」)。
194
+
195
+ 两个库谁都没被特殊对待 —— 换一个库不需要改一行代码,`tests/examples.mjs` 每次跑测试都在替你把这句话验一遍。
188
196
 
189
197
  ---
190
198
 
@@ -250,6 +258,10 @@ WIKI_ROOT="<仓库绝对路径>/examples/demo-wiki" node tools/verify-host.mjs -
250
258
 
251
259
  ![概览页签:左边一串数字全是宿主算好的,这一页只负责摆出来](docs/preview-overview.png)
252
260
 
261
+ > 截图不是画的,是拿随包的 `examples/demo-wiki`(手冲咖啡那 10 页)跑 `node tools/preview.mjs --state <样例> --tab overview` 渲真组件后截的 —— 组件改了、图不会自己变,所以每次发版都重出一遍。
262
+ >
263
+ > 为什么不用「真实笔记库」的截图:那样连页名、标签、枢纽页都跟着出海,而这台机器上的库是私人的。
264
+
253
265
  概览按「先看库有没有毛病,再决定查什么」排,只摆这六块:
254
266
 
255
267
  | 块 | 内容 | 为什么在这一块 |
@@ -342,7 +354,7 @@ WIKI_ROOT="<仓库绝对路径>/examples/demo-wiki" node tools/verify-host.mjs -
342
354
 
343
355
  评分刻意朴素:标题全等 120 / 标题含 60 / 别名含 50 / 标签含 25 / 正文词频 ×3(封顶 36)/ index 摘要只在其它通道全 0 时补 8;同分再比类型层(综合 3 · 总览 3 / 概念·实体·对比 2 / 资料 1)→ 更新时间 → 码点序。四处经验细节:摘要分只补漏不抢位、同分用码点序(拼音序不可复现)、选节排除清单类与元讨论类小节、总览与综合同层(总览是全库唯一入口页,跨模块的词在它里面出现分量不同)。
344
356
 
345
- 中文连写整句在 AND / OR 双双落空时会降级到**字面覆盖率兜底**(中文二字组 / 拉丁整词,覆盖率 ≥45% 才入选,`degraded: true` 并在结果里说明),这是缓解不是语义检索;查询先做 NFKC 归一化并剥掉两端疑问词。
357
+ 中文连写整句在 AND / OR 双双落空时会降级到**字面覆盖率兜底**(中文二字组 / 拉丁整词,覆盖率 ≥45% 才入选,`orFallback: true` 并在结果里说明),这是缓解不是语义检索;查询先做 NFKC 归一化并剥掉两端疑问词。
346
358
 
347
359
  ---
348
360
 
Binary file
@@ -0,0 +1,11 @@
1
+ # 一次多做点
2
+
3
+ 省时间的核心不是做得快,是**同一段时间里做完更多份**。
4
+
5
+ 可以批量做的:焯水蔬菜、卤味、炖肉、米饭。
6
+
7
+ 不适合批量的:清炒绿叶菜、需要现炸的东西、凉拌(出水就不好吃了)。
8
+
9
+ 分批做完按份冻起来,标上日期。三天内吃完的放冷藏,更久的进冷冻。
10
+
11
+ 相关:[[剩菜保存]]
@@ -0,0 +1,11 @@
1
+ # 刀具保养
2
+
3
+ 三句话:立刻擦干、别泡水、按材质选磨法。
4
+
5
+ 不锈钢也会锈,只是慢。洗完立在通风处,别横着放进密闭抽屉。
6
+
7
+ 磨刀分两步:先用粗石把刃口磨出形,再用细石抛光。只抛光不修形,用着用着就变圆了。
8
+
9
+ 什么时候该磨:能轻松切开番茄皮,就是还够快;切番茄要先压再拉,就该磨了。
10
+
11
+ 相关:[[挑一把趁手的菜刀]],还有 [[磨刀石的目数]](这页还没写)。
@@ -0,0 +1,10 @@
1
+ # 剩菜保存
2
+
3
+ 两个时间点最关键:**出锅后两小时内**进冰箱,**复热时**要彻底热透。
4
+
5
+ - 室温放太久是细菌繁殖的温床,尤其是含肉、含蛋的菜。
6
+ - 分装成小份凉得快,别一大盆直接塞冰箱。
7
+ - 绿叶菜隔夜亚硝酸盐上升快,尽量当顿吃完。
8
+ - 复热要中心冒热气、滚开一会儿,微波炉记得中途翻一下。
9
+
10
+ 相关:[[一次多做点]]
@@ -0,0 +1,13 @@
1
+ # 厨房动线
2
+
3
+ 按「取 → 洗 → 切 → 炒 → 盛」排成一圈,少走回头路。
4
+
5
+ 三个常见错误:
6
+
7
+ 1. 冰箱离操作台太远,拿一次东西要走三步。
8
+ 2. 砧板放在水槽和灶台之间却没有落手处,切完要端着走。
9
+ 3. 垃圾桶在身后 —— 削皮时不停转身。
10
+
11
+ 小厨房就按「水槽 → 砧板 → 灶台」这条线摆,别的都靠边。
12
+
13
+ 相关:[[砧板选择]]
@@ -0,0 +1,13 @@
1
+ # 挑一把趁手的菜刀
2
+
3
+ 先看用途:切片靠锋利,剁骨靠重量,一把刀干两件事,两件都干不好。
4
+
5
+ 三个能上手就判断的点:
6
+
7
+ 1. 握柄有没有毛刺、接缝处会不会夹手。
8
+ 2. 刀身重心落在护手前一点最好,切久了手腕不酸。
9
+ 3. 刀背厚薄:薄刃轻快但怕磕,厚背稳但切番茄容易压烂。
10
+
11
+ 中式片刀和日式三德各有拥趸,差别主要在刃口角度:中式约 15–20 度,耐剁;日式更薄,锋利但不耐碰骨。
12
+
13
+ 延伸看 [[刀具保养]]、[[砧板选择]]。
@@ -0,0 +1,11 @@
1
+ # 油温判断
2
+
3
+ 没有温度计时,看筷子。
4
+
5
+ - 三四成热(约 90–120℃):筷子插进去,周围只有细小气泡。适合滑炒、上浆。
6
+ - 五六成热(约 150–180℃):气泡密集且上升快。适合大部分爆炒。
7
+ - 七八成热(约 200℃):筷子一进去就冒大泡并带响声。适合复炸、需要快速定型。
8
+
9
+ 油冒青烟就别下了,那是油在分解,不是「够热」。
10
+
11
+ 相关:[[炒锅开锅]]
@@ -0,0 +1,11 @@
1
+ # 炒锅开锅
2
+
3
+ 铁锅买回来有一层出厂防锈油,得先洗掉,再让它吃油。
4
+
5
+ 步骤:热水加洗洁精刷净 → 烧干 → 小火抹一层薄油 → 静置 → 重复两三次。
6
+
7
+ 不粘锅不用开锅,别照搬铁锅那套,涂层经不起干烧。
8
+
9
+ 养锅比开锅重要:每次用完趁热冲、擦干、薄薄抹油。别用洗洁精反复猛刷。
10
+
11
+ 相关:[[油温判断]]、[[刀具保养]]
@@ -0,0 +1,12 @@
1
+ # 砧板选择
2
+
3
+ 按材质分:木、竹、塑料、树脂。
4
+
5
+ - 木:手感好、不伤刃,需要上油保养,容易吸味。
6
+ - 竹:硬、便宜,但硬度接近刀刃,长期用伤刃口。
7
+ - 塑料:好洗、不发霉,缺点是切痕深了容易藏污。
8
+ - 树脂:介于塑料和木之间,价格最贵。
9
+
10
+ 生熟分开是硬规矩,跟材质无关。
11
+
12
+ 相关:[[刀具保养]]、[[厨房动线]]
package/lib/client.js CHANGED
@@ -1056,10 +1056,10 @@ window.__ModuleLoader__.load({
1056
1056
  // 条数被 limit 截住时说清楚,否则「命中 7 页」下面只列 3 条会让人以为漏了。
1057
1057
  shown < result.total ? '(显示前 ' + shown + ')' : '',
1058
1058
  ),
1059
- result.degraded === true
1059
+ result.orFallback === true
1060
1060
  ? h(
1061
1061
  'span',
1062
- { className: 'wn-count-degraded' },
1062
+ { className: 'wn-count-orfallback' },
1063
1063
  // 兜底有两条路:OR(命中任一)与字面覆盖率(v1.6 起的第三条路)。
1064
1064
  // 说错会让人以为自己看到的是「任一词命中」的结果,实际是整句都没命中。
1065
1065
  result.coverageFallback === true
@@ -2206,7 +2206,7 @@ window.__ModuleLoader__.load({
2206
2206
  // 计数行:主信息在左,元信息推到行尾 —— 一眼看到「命中几页」,想核再看耗时。
2207
2207
  '.wn-count{display:flex;align-items:baseline;gap:10px;flex-wrap:wrap;font-size:12px;color:var(--wn-muted);font-variant-numeric:tabular-nums;}',
2208
2208
  '.wn-count-main{color:var(--wn-fg);font-weight:600;}',
2209
- '.wn-count-degraded{font-size:11.5px;color:var(--wn-warn);}',
2209
+ '.wn-count-orfallback{font-size:11.5px;color:var(--wn-warn);}',
2210
2210
  '.wn-near{display:flex;flex-direction:column;gap:6px;padding:14px 16px;border:1px solid rgba(168,152,133,0.45);border-radius:2px;background:#fffdf9;}',
2211
2211
  '.wn-near-head{font-size:11px;font-weight:400;letter-spacing:0.12em;color:#6f6558;}',
2212
2212
  '.wn-near-row{display:flex;align-items:center;gap:10px;width:100%;font:inherit;text-align:left;padding:6px 0;border:0;border-bottom:1px solid rgba(168,152,133,0.22);background:transparent;color:#2b2724;cursor:pointer;transition:color 700ms ease-in-out;}',
package/lib/engine.js CHANGED
@@ -229,7 +229,7 @@ function typeTier(page) {
229
229
  *
230
230
  * 多词查询里总有几页像「某课程·资料摘要」这种大而全的资料页,每个词都沾一点、分数最高,
231
231
  * 但不是答案。把只命中一部分词的页压到全命中页后面,等于保留 search.py 的 AND 语义;
232
- * 全部页都只命中一部分时(库里的确没写这个词),次序退回纯分数,并标 degraded。
232
+ * 全部页都只命中一部分时(库里的确没写这个词),次序退回纯分数,并标 orFallback。
233
233
  */
234
234
  function compareHits(a, b) {
235
235
  if (a.allTerms !== b.allTerms) return a.allTerms ? -1 : 1
@@ -557,11 +557,11 @@ export function search(corpus, query, options = {}) {
557
557
  }
558
558
 
559
559
  // AND 优先;一条 AND 都没有时降级为 OR,并在结果里说明,别让模型以为「库里没有」。
560
- // 注意:OR 也一条没有时不算「降级」——那是真的没命中,标 degraded 反而误导。
561
- let degraded = false
560
+ // 注意:OR 也一条没有时不算「降级」——那是真的没命中,标 orFallback 反而误导。
561
+ let orFallback = false
562
562
  let list = scored.filter((item) => item.allTerms)
563
563
  if (list.length === 0) {
564
- degraded = scored.length > 0
564
+ orFallback = scored.length > 0
565
565
  list = scored
566
566
  }
567
567
 
@@ -572,7 +572,7 @@ export function search(corpus, query, options = {}) {
572
572
  const covered = coveragePass(corpus, tokens, { typeFilter, tagFilter, statusFilter })
573
573
  if (covered.length > 0) {
574
574
  coverageFallback = true
575
- degraded = true
575
+ orFallback = true
576
576
  list = covered
577
577
  }
578
578
  }
@@ -649,14 +649,14 @@ export function search(corpus, query, options = {}) {
649
649
  // 覆盖率兜底下调时不能报「这些词一页都没命中」——命中正是靠这些词的字面片段捞到的,
650
650
  // 两句话放在一起自相矛盾,note 里已经交代清楚。
651
651
  missedTerms: coverageFallback ? [] : tokens.filter((token) => (termPages.get(token) ?? 0) === 0),
652
- matchMode: degraded ? 'or' : 'and',
652
+ matchMode: orFallback ? 'or' : 'and',
653
653
  // 覆盖率兜底是 or 的下一层(仍标 matchMode/or 以保持面板与既有断言的两值语义),
654
654
  // 但必须单独标出来:这时候「命中」只是字面沾边,精度比 OR 更低,模型叙述时要收着写。
655
655
  coverageFallback,
656
656
  trivialQuery,
657
657
  ...(explain ? { termPages: tokens.map((token) => ({ term: token, pages: termPages.get(token) ?? 0 })) } : {}),
658
658
  total: list.length,
659
- degraded,
659
+ orFallback,
660
660
  // 调用级统计:分母各是各的,别合成一个数字
661
661
  considered,
662
662
  matched: coverageFallback ? list.length : scored.length,
@@ -674,7 +674,7 @@ export function search(corpus, query, options = {}) {
674
674
  note: filterNote
675
675
  || (coverageFallback
676
676
  ? `整句没有命中任何页(中文不分词,"${query}" 被当成一个词元),已降级为字面覆盖率匹配(≥${Math.round(COVERAGE_MIN * 100)}%)。结果只作线索:命中是字面沾边,不是这页回答了你。`
677
- : degraded
677
+ : orFallback
678
678
  ? '没有同时命中全部检索词,已降级为 OR(命中任一):命中面变宽、精度下降'
679
679
  : trivialQuery
680
680
  ? `查询只有一个字("${tokens[0]}"),它在这 ${considered} 页里出现了 ${scored.length} 页——这个字到处都有,排序没有区分度。换个更具体的词再搜。`
@@ -1301,7 +1301,7 @@ export function help() {
1301
1301
  title: 'status 怎么读',
1302
1302
  lines: [
1303
1303
  'ok:正常,内容可信。',
1304
- 'degraded:只有部分检索词命中,已降级成 OR —— 命中面变宽、精度下降,答案要点可能偏。',
1304
+ 'or_fallback:只有部分检索词命中,已降级成 OR —— 命中面变宽、精度下降,答案要点可能偏。结果里另有布尔字段 orFallback 与它同义;coverageFallback 为真表示连 OR 都没有、退回字面覆盖率。',
1305
1305
  'partial:看到的不全(有页读不出来 / 目录列不出 / 超大页没参与 / 有同名页)。warnings 说漏了什么。',
1306
1306
  'no_match:参与比对的页里没有命中。**不能反推全库没有**,换词组或 list 看命名习惯。',
1307
1307
  'unavailable:库一页都没扫到,通常是路径指错层 —— 该去查配置,不是换关键词。',
@@ -1465,8 +1465,8 @@ export function decideStatus(corpus, mode, args = {}, result = {}) {
1465
1465
  warnings.push(engineNote(result) || '这个别名被多页共用,这次给的不一定是你要的那篇')
1466
1466
  return { status: 'partial', warnings }
1467
1467
  }
1468
- if (mode === 'search' && result.degraded === true) {
1469
- // 降级与「超大页可能相关」可以同时成立:状态按约定取 degraded,但两条事实都要输出 ——
1468
+ if (mode === 'search' && result.orFallback === true) {
1469
+ // 降级与「超大页可能相关」可以同时成立:状态按约定取 or_fallback,但两条事实都要输出 ——
1470
1470
  // 别让一个状态值把覆盖缺口吞掉。
1471
1471
  if (oversizedHit) warnings.push(oversizedWarning)
1472
1472
  // 引擎自己知道这次是「命中任一词」还是「整句只沾字面」(覆盖率兜底),
@@ -1474,7 +1474,7 @@ export function decideStatus(corpus, mode, args = {}, result = {}) {
1474
1474
  // 固定文案只当兜底(老调用方不带 note 时)。
1475
1475
  warnings.push(engineNote(result)
1476
1476
  || '只命中部分检索词,已降级为 OR:命中面变宽、精度下降;想收窄就改用页面标题或更少的词重查一次')
1477
- return { status: 'degraded', warnings }
1477
+ return { status: 'or_fallback', warnings }
1478
1478
  }
1479
1479
  if (oversizedHit) {
1480
1480
  // 目录/检索为空而库里恰好有超大页时,两件事都得说:先说「为什么是空的」(可能是过滤条件写错),
package/lib/index.js CHANGED
@@ -1041,7 +1041,7 @@ export function apply(ctx, config = {}) {
1041
1041
  // 和工具那条路记同一组字段:面板里查的一遍也是「一次调用」,
1042
1042
  // 少了这五项,账本里就有一半的行说不出为什么命中得勉强。
1043
1043
  status: typeof result?.status === 'string' ? result.status : '',
1044
- fallback: result?.coverageFallback === true ? 'coverage' : result?.degraded === true ? 'or' : '',
1044
+ fallback: result?.coverageFallback === true ? 'coverage' : result?.orFallback === true ? 'or' : '',
1045
1045
  considered: Number.isFinite(result?.considered) ? result.considered : null,
1046
1046
  warnings: Array.isArray(result?.warnings) ? result.warnings.length : null,
1047
1047
  topScore: Array.isArray(result?.hits) && result.hits.length > 0 && Number.isFinite(result.hits[0]?.score)
@@ -1707,7 +1707,7 @@ const registerGateway = () => {
1707
1707
  ? ''
1708
1708
  : value?.coverageFallback === true
1709
1709
  ? 'coverage'
1710
- : value?.degraded === true
1710
+ : value?.orFallback === true
1711
1711
  ? 'or'
1712
1712
  : '',
1713
1713
  considered: searchable && Number.isFinite(value?.considered) ? value.considered : null,
@@ -2019,11 +2019,11 @@ function renderSearch(value) {
2019
2019
  : `扫描 ${scanned} 页,${value.total} 命中`
2020
2020
  out.push(`【检索】${tokens} ${numbers}`)
2021
2021
  // 「没沾到」是给模型看的换词依据:面板上能点出来,模型看不到就等于白算。
2022
- // 它和 degraded 说的不是一件事:degraded 是「一条全词命中都没有」,
2022
+ // 它和 orFallback 说的不是一件事:orFallback 是「一条全词命中都没有」,
2023
2023
  // 这里是「这个具体的词在库里一页都没沾到」—— 后者才指着该换哪个词。
2024
2024
  const missed = Array.isArray(value.missedTerms) ? value.missedTerms : []
2025
2025
  if (missed.length > 0) out.push(`没沾到:${missed.join('、')}(这些词在库里一页都没命中,换同义词或干脆去掉)`)
2026
- // 降级说明已由 warnings 承载(degraded 时必有一条,用的就是同一段文字);只有 status 仍是 ok
2026
+ // 降级说明已由 warnings 承载(orFallback 时必有一条,用的就是同一段文字);只有 status 仍是 ok
2027
2027
  // 或老调用方(结果里没有 status 字段)才需要这里的 note —— 否则同一句话模型会读两遍。
2028
2028
  // ok 也要放行:单字查询「这个字到处都有、排序没有区分度」是 ok 状态下唯一能说这句话的出口,
2029
2029
  // 而 ok 按契约不带 warnings 键(tests/status.mjs 守着「正常路径零额外 token」)。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-wiki-notes",
3
- "version": "1.10.2",
3
+ "version": "1.11.0",
4
4
  "type": "module",
5
5
  "description": "Read-only knowledge gateway over a local Markdown vault for DeepSeek Harness — recall, evidence pack, answer verification, call audit | 本地 Markdown 笔记库的只读知识网关:检索、证据包、核验、调用审计",
6
6
  "keywords": [
@@ -44,7 +44,7 @@
44
44
  "node": ">=20.13.0"
45
45
  },
46
46
  "scripts": {
47
- "test": "node tests/smoke.mjs && node tests/status.mjs && node tests/overview.mjs && node tests/params.mjs && node tests/fields.mjs && node tests/robust.mjs && node tests/lint.mjs && node tests/lintdiff.mjs && node tests/config.mjs && node tests/explain.mjs && node tests/cli.mjs && node tests/api.mjs && node tests/help.mjs && node tests/contract.mjs && node tests/topics.mjs && node tests/draft.mjs && node tests/calls.mjs && node tests/governance.mjs && node tests/inject.mjs && node tests/watch.mjs && node tests/client.mjs && node tests/tier.mjs && node tests/render.mjs && node tests/nearmiss.mjs && node tests/calls-read.mjs && node tests/store.mjs && node tests/bridge.mjs && node tests/text.mjs && node tests/parse.mjs && node tests/fingerprint.mjs && node tests/bom.mjs",
47
+ "test": "node tests/smoke.mjs && node tests/examples.mjs && node tests/status.mjs && node tests/overview.mjs && node tests/params.mjs && node tests/fields.mjs && node tests/robust.mjs && node tests/lint.mjs && node tests/lintdiff.mjs && node tests/config.mjs && node tests/explain.mjs && node tests/cli.mjs && node tests/api.mjs && node tests/help.mjs && node tests/contract.mjs && node tests/topics.mjs && node tests/draft.mjs && node tests/calls.mjs && node tests/governance.mjs && node tests/inject.mjs && node tests/watch.mjs && node tests/client.mjs && node tests/tier.mjs && node tests/render.mjs && node tests/nearmiss.mjs && node tests/calls-read.mjs && node tests/store.mjs && node tests/bridge.mjs && node tests/text.mjs && node tests/parse.mjs && node tests/fingerprint.mjs && node tests/bom.mjs",
48
48
  "cli": "node bin/cli.mjs",
49
49
  "probe": "node tools/probe.mjs",
50
50
  "verify:host": "node tools/verify-host.mjs --self",