dsh-wiki-notes 1.5.0 → 1.6.1
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 +142 -0
- package/README.md +33 -8
- package/lib/bridge.js +43 -3
- package/lib/calls.js +23 -5
- package/lib/client.js +62 -12
- package/lib/config.js +72 -10
- package/lib/corpus.js +99 -14
- package/lib/engine.js +401 -28
- package/lib/index.js +107 -49
- package/lib/jsonl-store.js +61 -7
- package/lib/text.js +20 -0
- package/package.json +4 -3
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
# 变更记录
|
|
2
|
+
|
|
3
|
+
本文件的体例:只记「对使用者有影响的行为变化」,不记内部重构。版本号遵循 semver,`0.x` 阶段不承诺兼容。
|
|
4
|
+
|
|
5
|
+
## 1.6.1
|
|
6
|
+
|
|
7
|
+
### 检索面板(设置页 / 右侧栏)
|
|
8
|
+
|
|
9
|
+
- **输入法组词时不再误提交**:中文输入法里按回车是「确认候选词」,原来会直接触发查询;Esc 也会顺手清空输入框。现在 `isComposing` / `keyCode === 229` 时整个 keydown 立刻返回 —— 连 `preventDefault` 都不做,避免把 IME 自己的确认吃掉。
|
|
10
|
+
- **请求在飞时不再丢弃新查询**:原来 `if (trimmed === '' || busy) return`,边打边查时会出现「输入框写着 A、下面列的是 B 的结果」。先发的请求由 `seqRef` 作废,并发不会互相覆盖。
|
|
11
|
+
- **兜底措辞分清两条路**:`degraded` 既可能是 OR 降级,也可能是 v1.6 起的字面覆盖率兜底。面板原来一律说「已降级为「命中任一」」,现在读 `coverageFallback` 分开说。
|
|
12
|
+
- **结果变化报给读屏**:检索中与计数行加 `role="status"` + `aria-live="polite"`;被省略号截断的页名补 `title`,悬停能看全名。
|
|
13
|
+
- **长词不再顶破面板**:正文里出现没有空格的英文长串或 URL 时,`pre-wrap` 不换行会把横向滚动条撑出来,给 `.wn-hit-text` 加 `overflow-wrap:anywhere`。
|
|
14
|
+
- **「N 份资料」改回「资料页 N 个」**:设置页三处(保存前试扫、探测结果标签、检索面板空状态)都拿 `stats.resources` 当份数显示,而那个数字数的是 `类型: 资料` 的**页数**;原始资料份数在各页的 `来源数量` 里,两者能差好几倍。写成「N 份资料」等于把资料量报小。空状态那一行的「实时同步开」也补上冒号。
|
|
15
|
+
- **两个页签成了真正的 tablist**:原来只是两个并排的按钮,读屏软件念的是「按钮 概览」「按钮 调用记录」,听不出这是一组里选一个、更听不出当前选的是哪个。现在外层 `role="tablist"` + `aria-label`,按钮 `role="tab"` + `aria-selected`。
|
|
16
|
+
- **页签补上焦点环**:页签没带 `.wn-btn`,而焦点样式只挂在 `.wn-btn` 上 —— 用 Tab 键走过去时「焦点在哪」完全看不见。补 `.wn-tab:focus-visible`。
|
|
17
|
+
- **没配库时不再显示「库 0 页」**:`/state` 在未配置时 `stats` 全是 0,检索面板的空状态就照实写「库 0 页 · 资料页 0 个 · 实时同步:关」—— 读起来像「你的库里什么也没有」,实际是「还没填路径」。现在读 `source: 'unset'` 或空 `root`,直接说「还没有配置知识库路径 —— 填一个装了 .md 笔记的文件夹,或设置 DSH_WIKI_ROOT」。
|
|
18
|
+
- **次要文字达到 AA 对比度**:`--wn-faint`(`#8a7f6e`)落在白卡片上只有 **3.87:1**、在浅底条上 3.68:1,低于 WCAG AA 对正文的 4.5:1,而它被拿去印「命中率分母不含 verify / observe」这类说明文字和「未命中」的词条。改成 `--wn-muted`(5.62:1 / 5.34:1);`--wn-faint` 只留给装饰(状态点、`▸` 折叠符号)。
|
|
19
|
+
|
|
20
|
+
### Python 通路(`wiki_context` / `wiki_verify` / `wiki_observe`)
|
|
21
|
+
|
|
22
|
+
- **三种「通不上」不再报同一个码**:以前没配 `bridge.toolsRoot`、目录不存在、目录里没有 `wiki_bridge.py`、`bridge.python` 写错,全都落到 `E_PYTHON_UNAVAILABLE`「找不到 Python 解释器」—— 而 Node 对「工作目录不存在」也报 ENOENT,于是「工具目录配错了」会把人引去改 `bridge.python`。现在先自己看一眼:没配或目录不存在 → `E_TOOLS_ROOT_MISSING`,目录在但缺入口文件 → `E_BRIDGE_SCRIPT_MISSING`,只有解释器真的找不到才是 `E_PYTHON_UNAVAILABLE`。
|
|
23
|
+
- 顺带发现一条**因为共用错误码而误通过的测试**:`tests/gateway.mjs` 的「python 不存在」在没配 `WIKI_TOOLS` 时,实际走的是「工具目录为空」那条路,却因为两者同码而判为通过。现在改用临时目录 + 假 `wiki_bridge.py`,让只有 python 这一环坏掉。
|
|
24
|
+
|
|
25
|
+
### 设置页 API(`/api/wiki-notes`)
|
|
26
|
+
|
|
27
|
+
- **`enabled: "false"` 不再被读成「开」**:原来只认 `raw.enabled !== false`,而字符串 `"false"` 是真值 —— 想关掉观察反而把它打开了,之后开始往账本里记东西。现在 `lib/config.js` 的 `toFlag` 认 `"false"/"0"/"off"/"no"` 与 `"true"/"1"/"on"/"yes"`,认不出来的值走默认。
|
|
28
|
+
- **`/check` 的坏 JSON 不再退化成「测当前库」**:请求体解析失败时原来走 `body?.root`(undefined),于是测的是配置里的库,「我刚测的是不是新路径」看不出来。现在直接 400。
|
|
29
|
+
- **`/check` 与 `/save` 指到文件时说清是路径问题**:给一个 `.md` 文件而不是目录时,原来只报「这个目录里没有任何页面」,现在报「这个路径不是一个目录(指向了文件)。要填的是装着 .md 笔记的那个文件夹」。
|
|
30
|
+
- **还没配库时检索回 400 而不是 500**:`/search` 在没配 `root` 时抛的是普通错误,统一被 catch 成 500 —— 日志和界面读起来像「插件坏了,重试看看」,其实是「你还没填库路径」。现在带 `NOT_CONFIGURED` 码,回 400 并原样给出配置指引。
|
|
31
|
+
|
|
32
|
+
### 回写骨架(`draft`)
|
|
33
|
+
|
|
34
|
+
- **标题不像文件名时先提醒,并改用能用的路径**:标题里的 `\ / : * ? " < > |` 是文件名禁用字符,原来会原样拼成 `概念-concepts/../../etc/passwd.md` 这种路径 —— 照着骨架建就会把文件写到知识层外面。现在路径按替代名生成(`../../etc/passwd` → `..-..-etc-passwd`),标题仍原样写在正文第一行,并在骨架前给出警告。
|
|
35
|
+
- **类型没有对应目录时提醒**:以前兜底放进 `概念-concepts/`,而 frontmatter 写的还是用户给的类型 —— 类型与目录自相矛盾,提交时会被 lint 拦下。现在给 `typeWarning`,把现有类型与「新目录还要同步目录表与 SKILL.md 白名单」一起说清。
|
|
36
|
+
- **`来源数量` 只写非负整数**:`-3` → `0`,`2.7` → `2`(原来原样落盘,读的人没法判断「2.7 份资料」是什么意思)。
|
|
37
|
+
|
|
38
|
+
### 扫描
|
|
39
|
+
|
|
40
|
+
- **跳过的链接目录不再无声无息**:junction / symlink 本来就不跟进去扫(跟进去会重复、也可能绕成环,Windows 上遍历不受信任的装入点还会抛 `0x800701C0`),但以前不留痕 —— 把另一个目录链接进库,看到的现象是「页不见了」。现在记 `stats.linksSkipped` / `stats.linkSkips`,`overview` 里报一行。
|
|
41
|
+
|
|
42
|
+
### 巡检(`lint`)
|
|
43
|
+
|
|
44
|
+
- **「更新」不是 `YYYY-MM-DD` 的页不再被静默跳过**:以前 `2026/11/01`、`2026-11` 这类写法算不出天数,那一页就既不进「久未更新」也不出声 —— 于是「0 页久未更新」看起来像「全库都新」。现在单独列一组「更新日期读不出来」,状态降为 `partial` 并说明原因。
|
|
45
|
+
|
|
46
|
+
### 总览(`overview`)
|
|
47
|
+
|
|
48
|
+
- **库里没有总览页时会说出来**:以前 `overview` 照样返回规模、index 一致性与最近日志,`overview` 字段是 `null` 却没有任何提示,读起来像「这库的总览是空的」。现在附一句说明并把状态降为 `partial`。
|
|
49
|
+
- **扫描行的措辞改准**:`N 份资料` 改成 `其中资料页 N 个` —— 那个数字数的是「类型: 资料」的页数,不是原始资料份数(份数在各页的「来源数量」里),原来的写法让人以为库里只有 N 份原文。
|
|
50
|
+
- **最近日志标明顺序**:由旧到新、最后一条最新(原来只写「最近日志:」,容易把第一条当成最新)。
|
|
51
|
+
- **`log.md` 在、但一条都对不上格式时会说出来**:`log.md` 只有 `## [日期] 类型 | 标题` 这种行才认。文件在、却一条也解析不出来时,以前「最近日志」直接是空的 —— 读起来就是「库里最近没有改动」。现在区分「没有 log.md」和「有但格式不对」,后者降为 `partial` 并明说这是格式没对上。
|
|
52
|
+
- **缺总览时的说明不再替别人的库下判断**:「按库结构约定每个库都该有一页总览」改成「按**本库**的结构约定」——别人用自己的目录树时,没有总览页是正常的。
|
|
53
|
+
- **两条「看起来空」会一起报**:缺总览页、且 `log.md` 在但一条格式都对不上时,原来第一个 `if` 直接 return,第二条警告永远不出现。现在合并成一个块,两条都进 `warnings`。
|
|
54
|
+
|
|
55
|
+
### 检索(`search`)
|
|
56
|
+
|
|
57
|
+
- **片段被截断时会明说**:命中的那一小节超过 `sectionChars`(默认 900)时,以前只是把正文砍断再补个「…」——可原文自己也可能以省略号结尾,模型分不出「这节看全了」和「这节被砍了一半」。截断的表格尤其容易让后半截被当成不存在,然后照着半张表回答。现在每条命中带 `section.chars`(整节字符数)与 `section.truncated`,渲染时补一行「本节正文已截断:全文 2924 字符;要整节用 page 取「页名」」。实测有一节正文 2924 字符,命中默认只给 900。
|
|
58
|
+
|
|
59
|
+
### 参数校验
|
|
60
|
+
|
|
61
|
+
- **「query 为空」不再用来解释「query 全是标点」**:传 `???!!!` 这种切不出任何字元的查询时,以前回「query 为空:请传 1–4 个关键词」,让人反复怀疑自己少传了参数。现在分两种话:真没传 → 还是「query 为空」;传了但切不出字 → 「query 切不出可检索的字:???!!! 全是标点或空白,换个具体的词」。
|
|
62
|
+
- **`tests/params.mjs` 打印真实条数**:原来 print 写死「5 项边界」而实际只断言了 4 条,现在按计数输出(8 项)。
|
|
63
|
+
|
|
64
|
+
### 取页
|
|
65
|
+
|
|
66
|
+
- **超大页不再被说成空页**:`page` 取到超过 512KB 的页时,原来会同时印出「这页没有正文(只有 frontmatter 或文件是空的)」和「正文超过 512KB 未载入」两条互相矛盾的说明;现在只说后者。
|
|
67
|
+
|
|
68
|
+
### 截断
|
|
69
|
+
|
|
70
|
+
- **截断不再切半个字符**:所有按长度截断的位置(命中小节正文、查询词元、账本里的 query、网关错误的 detail、系统提示词的 override/extra)改走新的 `lib/text.js` 的 `clipChars`。以前切点正好落在表情或扩展区汉字(如 `𠮷`)中间时,会留下孤立代理,JSON 里变成 `\ud83d`、界面显示成「�」。这类问题取决于字数,人工测不出来。
|
|
71
|
+
|
|
72
|
+
### 正文解析
|
|
73
|
+
|
|
74
|
+
- **代码围栏里的 `## 标题` 不再被当成小节**:以前只按行首匹配,笔记里贴一段 markdown / YAML 示例就会多出一个并不存在的小节,选节时还可能把那段代码当正文交给模型。
|
|
75
|
+
- **`~~~` 围栏里的双链不再被当成链接**:以前只剥 ``` 围栏,用 `~~~` 写的示例仍会进图谱、被算成红链。现在两种围栏由同一套判定处理。
|
|
76
|
+
|
|
77
|
+
### 配置
|
|
78
|
+
|
|
79
|
+
- **配置文件改为原子写**(`.tmp` + `rename`):以前直写,写一半崩掉会得到一个被截断的 JSON,而读取侧把坏文件当空对象,用户看到的是「我配的路径怎么没了」。
|
|
80
|
+
- **覆盖坏文件前留 `.broken` 备份**:坏文件里可能还有主题词、桥路径这些没被读到的设置,直接覆盖等于把它们一起埋了。
|
|
81
|
+
|
|
82
|
+
### 测试门禁(本机回归,`tests/local/`)
|
|
83
|
+
|
|
84
|
+
- **库指纹改成量内容,不再只量正文长度**:旧算法 hash `页名|body.length`,等长改写、别名 / 标签改字、`index.md` 摘要改字全都测不出来 —— 而检索打分恰恰读这些字段,于是「库变了、基线没过期、指标悄悄变」是通的。现在 `tests/local/library-fingerprint.mjs` 把正文、frontmatter、index 摘要、规模行一起 hash;页顺序 / 键顺序 / mtime 变化不算改动。`metrics.mjs` 与 `recall.mjs` 共用同一个函数,`npm test` 新增 `tests/fingerprint.mjs`(20 项自检)。
|
|
85
|
+
- **`recall.mjs` 的 floor 绑定到库快照**:`queries.json` 新增 `libraryFingerprint`。库换了还拿旧 floor 硬比,会把「新页把老页挤到第 2」判成「引擎退步」;现在指纹不一致改报 `BASELINE_STALE`(退出码 3),照实打印实测数字但不下 PASS / GATE_FAIL 结论。重导提示顺带修了 PowerShell `>` 默认写 UTF-16 会写坏 JSON 的坑。
|
|
86
|
+
- 顺带修一处**文档假绿**:快照 §47.1 里 `76.3%` 是从旧版库的记录照抄的;同一份库上 HEAD(1.6.0) 与工作区引擎逐条排序零差异,都是 `44/59`。这次按当前库重标 floor 并在 `floorNote` 写明证据,不改 `expect`、不为凑数字调排序。
|
|
87
|
+
|
|
88
|
+
### 文件编码(UTF-8 BOM)
|
|
89
|
+
|
|
90
|
+
- **带 BOM 的笔记不再「看着正常、读着全丢」**:Windows 记事本 / PowerShell 5.1 写出的 `.md` 开头常有一个 BOM。插件以前只在「有 frontmatter」的页容忍它,于是无 frontmatter 页的首个 `##` 标题切不出小节、`log.md` 的第一条日志整条消失、`index.md` 首行目录也可能读歪;Python 侧的 `FM_RE` 与 `if text.startswith("---")` 更会让整页 frontmatter 变空,检索却不报错。现在插件三处读文件统一在入口剥掉开头那一个 BOM,Python 侧 17 个工具共 29 处读取统一走 `utf-8-sig`,正文中间的 `U+FEFF`(零宽不换行空格)仍按内容保留。
|
|
91
|
+
- **带 BOM 的配置文件不再被当成坏文件**:`wiki-notes.config.json` 带 BOM 时 `JSON.parse` 直接失败,界面报「还没配库」,下次写入还会把这份其实完好的配置备份成 `.broken`,把主题词、桥路径一起埋掉。现在读取侧先剥 BOM 再解析。
|
|
92
|
+
- **顺带修一个 HEAD 里就有的语法错误**:知识库 `工具-tools/maturity.py` 的 `out = Path(r"os.environ.get(...)")` 把表达式包成了字符串,整个模块连 import 都做不到(这是一次性 BOM 验证脚本第一次跑出来的)。已改回真实的 `os.environ.get(...)`,端到端跑通并生成报告。
|
|
93
|
+
- 新增 `tests/bom.mjs`(15 项,进 `npm test`,共 29 文件):无 frontmatter 页 / 有 frontmatter 页 / index / log / 配置 / 正文中间 BOM 六种场景。Python 侧两条路径(工作区读取 / `lint.py --staged` 读暂存区 blob)另用一次性脚本各验过 14 项与 3 项,用完即删、不进仓库。
|
|
94
|
+
- **带 BOM 的 `lint-history.json` 不再让「与上次相比」凭空消失**:巡检历史是插件自己写、也可能被 PowerShell 重写的文件;它一旦带 BOM,原来 `JSON.parse` 抛错被当成「文件坏了」,于是每次都显示「第一次记录基线」。现在与配置文件共用同一个读 JSON 入口;`package.json` 带 BOM 时 `plugin_version` 退化成 `unknown` 也一并修好。
|
|
95
|
+
|
|
96
|
+
### 巡检报告与启动日志
|
|
97
|
+
|
|
98
|
+
- **不再把「资料页数」写成「份资料」**:总览与设置页早已改准,这两行是漏网的 —— 同一个数字数的是资料页而不是原文份数,写成「N 份资料」会让模型以为原文只有 N 份。现在统一写「其中资料页 N 个」。
|
|
99
|
+
|
|
100
|
+
## 1.6.0
|
|
101
|
+
|
|
102
|
+
### 检索
|
|
103
|
+
|
|
104
|
+
- **字面覆盖率兜底**:整句中文(无空格)在 AND 与 OR 双双落空时,降级为「中文二字组 / 拉丁整词」的覆盖率匹配(阈值 45%,`degraded: true`),并在结果里说明这是降级而非「库里没有」。长句查询的 Recall@5 从 23.1% 提到 61.5%。
|
|
105
|
+
- **NFKC 归一化**:全角输入(`AI`、`()`)先归一化再切词;全角查询的命中率从 0% 到 100%。
|
|
106
|
+
- **疑问词只剥两端**:`X 是什么`、`X 怎么安排` 里的问法不再当检索词;**只剥首尾**,不从前中段切(从中间切会造伪词,把一句完整查询切成两个不存在的词)。
|
|
107
|
+
- **查询长度上限 200 字符下沉到引擎**:以前只在工具层拦,`bin/cli.mjs`、设置页 `/search`、Python 桥都绕得过去。
|
|
108
|
+
- **标签 / 别名的逗号串**(`标签: a, b, c` 这种 YAML 裸标量)现在会被拆成多项,打分与 `list {tags}` 筛选口径一致(以前打分沾得上、筛选筛不到)。
|
|
109
|
+
- **`brokenLinks` 改为页级**,并复用语料层的双链解析(不再自己扫正文,避免把行内代码里的 `[[示例]]` 当断链)。
|
|
110
|
+
|
|
111
|
+
### 给模型看的解释
|
|
112
|
+
|
|
113
|
+
- **`note` 不再被吞**:`run()` 会给结果加 `status`,渲染层原来的条件导致所有 `note` 都印不出来;现在非 ok 时由 warnings 承载、ok 时由 note 承载。
|
|
114
|
+
- **`no_match` / 过滤空结果 / 覆盖率兜底** 都会说明原因(「库里没有这个主题」与「过滤条件把它排除了」是两回事)。
|
|
115
|
+
- **取页更诚实**:别名被多页共用时判 `partial` 并点名两页;命中只有 frontmatter 的空页会说明「这页没有正文」。
|
|
116
|
+
- **网关错误能印出 code**:以前只印 `知识网关调用失败:? — `,现在印 `E_PYTHON_UNAVAILABLE — …`。
|
|
117
|
+
|
|
118
|
+
### 账本与审计
|
|
119
|
+
|
|
120
|
+
- **测试不再往真实账本写**:11 个会 `apply()` 的测试文件改走临时目录,跑一遍 `npm test` 不再往「调用记录」里塞 33 条假调用。
|
|
121
|
+
- **`calls.read()` 合并顺序修正**:同一秒的多条不再倒序,轮转裁掉的旧行不再被内存补回来(窗口不再越读越长)。
|
|
122
|
+
- **JSONL 存储**:轮转阈值差一(5000 行会先长到 5001)、轮转改为 `.tmp` + `rename` 原子替换、末尾半行自动补换行(不再把新记录粘在坏行后面)、轮转按物理行计数(满盘坏行也能轮转)、`onRotate` 钩子让内存缓冲跟着裁。
|
|
123
|
+
|
|
124
|
+
### Python 桥
|
|
125
|
+
|
|
126
|
+
- **`stdin` 写入失败不再变成未捕获异常**:python 提前退出、而这边还在写大 payload 时会抛 `EPIPE`,以前会让宿主进程收到一个没人接的 error 事件;现在只记录并在错误消息里说明。
|
|
127
|
+
|
|
128
|
+
### 测试与工具
|
|
129
|
+
|
|
130
|
+
- 新增 `tests/tier.mjs`(类型层)、`tests/render.mjs`(渲染文本)、`tests/bridge.mjs`(桥的 11 条失败路径,用 `node` 冒充 python)、`tests/store.mjs`(JSONL 存储边界)、`tests/calls-read.mjs`(账本合并)。`npm test` 从 21 个文件到 **25 个**。
|
|
131
|
+
- 新增 `tests/local/recall.mjs`(质量评测:Recall@5 / Top-1 / MRR,按标签分组,低于 floor 退 2)与 `tests/local/queries.example.json`。
|
|
132
|
+
- `tools/probe.mjs` 同时接受 `--root=<path>` 与 `--root <path>`(以前只认后者,`--k=v` 会被当成参数名丢掉)。
|
|
133
|
+
|
|
134
|
+
## 1.5.0
|
|
135
|
+
|
|
136
|
+
- 本地知识网关的**双模式治理**:系统提示注入 + 四个工具的 description + 渲染层追加 + 治理账本,四层叠加约束「先查一次库、别自动升级成完整核验、结尾披露可信度」。
|
|
137
|
+
- `lib/index.js` 的 `inject` 补上 `sessions`(strict inject 下缺它会让插件整片不激活),新增 `tests/inject.mjs`。
|
|
138
|
+
- `wiki_observe` 只认 `kind: 'observe_stats'`(此前把日志事件的 kind 当成返回值的 kind,治理指标静默不合并)。
|
|
139
|
+
|
|
140
|
+
## 1.4.3
|
|
141
|
+
|
|
142
|
+
- 公开仓库的样例、契约文档与测试查询词全部换成虚构语料;发版前解包 `npm pack` 产物逐文件扫一遍。
|
package/README.md
CHANGED
|
@@ -160,7 +160,16 @@ plugin_manager { action: "install_bundle", target: "<绝对路径>" }
|
|
|
160
160
|
|
|
161
161
|
没配时工具会直接告诉你「还没配置知识库路径」,不会静默扫空目录。
|
|
162
162
|
|
|
163
|
-
`wiki_context` / `wiki_verify` / `wiki_observe` 还需要一条 Python 通路(`bridge.python` + `bridge.toolsRoot`,后者是含 `wiki_bridge.py`
|
|
163
|
+
`wiki_context` / `wiki_verify` / `wiki_observe` 还需要一条 Python 通路(`bridge.python` + `bridge.toolsRoot`,后者是含 `wiki_bridge.py` 的目录)。没配或配错时这三个工具会明确报错,且**不会假装成「知识库里没有」**:
|
|
164
|
+
|
|
165
|
+
| 情况 | 错误码 |
|
|
166
|
+
|---|---|
|
|
167
|
+
| 还没配 `bridge.toolsRoot` | `E_TOOLS_ROOT_MISSING` |
|
|
168
|
+
| 配了但目录不存在 | `E_TOOLS_ROOT_MISSING` |
|
|
169
|
+
| 目录在、里面没有 `wiki_bridge.py` | `E_BRIDGE_SCRIPT_MISSING` |
|
|
170
|
+
| `bridge.python` 找不到(不在 PATH、路径写错) | `E_PYTHON_UNAVAILABLE` |
|
|
171
|
+
|
|
172
|
+
配置形状见 [docs/契约-stage0/阶段4-插件接入.md](docs/契约-stage0/阶段4-插件接入.md)。
|
|
164
173
|
|
|
165
174
|
---
|
|
166
175
|
|
|
@@ -221,9 +230,15 @@ plugin_manager { action: "install_bundle", target: "<绝对路径>" }
|
|
|
221
230
|
|
|
222
231
|
## 检索质量
|
|
223
232
|
|
|
224
|
-
|
|
233
|
+
三条线分开看,别混成一个数字:
|
|
234
|
+
|
|
235
|
+
- **对齐(parity)**:`tests/local/ab.mjs` 比的是「JS 引擎的前 5 是否覆盖 Python `search.py` 的前 5」,当前 **166/166,漏 0**;`tests/local/metrics.mjs` 比同一批槽位的集合与排序,Recall@5 100%、Jaccard 0.63,当硬门禁。两侧刻意保留少量已知分歧(疑问词剥离是有意改进、index 摘要 +8、类型层平局裁决),名单在本地 `tests/local/parity-exceptions.json`,**不入仓库**。
|
|
236
|
+
- **质量(recall)**:`tests/local/recall.mjs` 跑人工标注的评测集,报 Recall@5 / Top-1 / MRR@5 并按标签分组。当前基线 **Recall@5 85.2% · Top-1 76.3% · MRR 0.819**(59 条查询 / 194 个槽位),低于基线即 exit 2。评测集 `tests/local/queries.json` 含真实笔记主题,**不入仓库**;仓库里只有中性 6 条的 `queries.example.json`。
|
|
237
|
+
- **性能**:123 页扫一遍约 51ms,单条查询 4ms 上下;`tools/probe.mjs` 另攒一条 hit@1 / hit@3 / Recall@5 的趋势 CSV。
|
|
225
238
|
|
|
226
|
-
评分刻意朴素:标题全等 120 / 标题含 60 / 别名含 50 / 标签含 25 / 正文词频 ×3(封顶 36)/ index 摘要只在其它通道全 0 时补 8
|
|
239
|
+
评分刻意朴素:标题全等 120 / 标题含 60 / 别名含 50 / 标签含 25 / 正文词频 ×3(封顶 36)/ index 摘要只在其它通道全 0 时补 8;同分再比类型层(综合 3 · 总览 3 / 概念·实体·对比 2 / 资料 1)→ 更新时间 → 码点序。四处经验细节:摘要分只补漏不抢位、同分用码点序(拼音序不可复现)、选节排除清单类与元讨论类小节、总览与综合同层(总览是全库唯一入口页,跨模块的词在它里面出现分量不同)。
|
|
240
|
+
|
|
241
|
+
中文连写整句在 AND / OR 双双落空时会降级到**字面覆盖率兜底**(中文二字组 / 拉丁整词,覆盖率 ≥45% 才入选,`degraded: true` 并在结果里说明),这是缓解不是语义检索;查询先做 NFKC 归一化并剥掉两端疑问词。
|
|
227
242
|
|
|
228
243
|
---
|
|
229
244
|
|
|
@@ -262,9 +277,10 @@ plugin_manager { action: "install_bundle", target: "<绝对路径>" }
|
|
|
262
277
|
|
|
263
278
|
## 已知局限
|
|
264
279
|
|
|
265
|
-
- 中文不分词,靠空格切分;连写词靠 `别名`
|
|
280
|
+
- 中文不分词,靠空格切分;连写词靠 `别名` 补。整句中文拿不到命中时会降级成字面覆盖率排序,那是**字面**匹配,语义相近但用词不同照样认不出。
|
|
266
281
|
- 页名本身是查询词时,正文很少重复该词,选节可能偏。
|
|
267
|
-
- 每次调用全量扫描;
|
|
282
|
+
- 每次调用全量扫描;123 页约 51ms,再大一个数量级要上增量索引。
|
|
283
|
+
- 每命中一页要塞约 900 字符正文(`sectionChars` 可调),一次返回 5 页就是 4–5k 字符 —— 瓶颈常在上下文预算而不在检索速度。
|
|
268
284
|
- **重启后第一次扫描是冷盘读**:95 页实测 5,217ms(此后 29ms)。插件启动就预热一次,所以这段延迟通常落在你还没提问的时候;但第一条查询正好赶上也确实要等。
|
|
269
285
|
- **面板没打开时 `/`、`Ctrl/⌘ + K` 不会有反应**:快捷键绑在面板上,而宿主的 `sidebarRightTabs` 只提供 `register()`,没有「打开 / 激活页签」的接口,插件没法从外面把面板叫出来。
|
|
270
286
|
- **知识网关那套仍是两套实现**:JS 侧 `wiki_recall` 和 Python 侧 `wiki_context` 各自解析页面,差在结构解读层。统一方向未定。
|
|
@@ -287,28 +303,37 @@ tools/probe.mjs 检索质量探针:hit@1 / hit@3 / Recall@5,追加趋势 CSV
|
|
|
287
303
|
tools/preview.mjs 把面板渲染成静态页(真组件 + 真 CSS),改样式不必重启 DSH
|
|
288
304
|
docs/库结构.md 库结构约定(这份才是一手文档)
|
|
289
305
|
docs/README.md 文档导航页
|
|
306
|
+
CHANGELOG.md 版本变更记录
|
|
290
307
|
docs/superpowers/specs/ 检索面板的设计稿
|
|
291
308
|
docs/契约-stage0/ 知识网关的设计与验收记录
|
|
292
309
|
examples/ 可跑的最小样例库
|
|
293
|
-
tests/ smoke / status / lint / explain / api / help / contract / watch / client
|
|
310
|
+
tests/ smoke / status / lint / explain / api / help / contract / watch / client
|
|
311
|
+
/ tier / render / bridge / store / calls / calls-read / gateway
|
|
312
|
+
tests/local/ 作者本机的评测集与回归基线(query 与基线文件不入仓库,只留 *.example)
|
|
313
|
+
tests/support/ 测试用小工具(quiet-ledger:把账本重定向到临时目录,别写进你的调用记录)
|
|
294
314
|
```
|
|
295
315
|
|
|
296
316
|
```bash
|
|
297
|
-
npm test #
|
|
317
|
+
npm test # 跑样例库,不需要本地知识库(25 个文件)
|
|
298
318
|
node bin/cli.mjs search 上下文 --root=examples/sample-wiki
|
|
299
319
|
WIKI_ROOT="/path/your/wiki" node tests/smoke.mjs # 拿自己的库跑通就行(不校验答案)
|
|
320
|
+
WIKI_ROOT="/path/your/wiki" node tests/local/recall.mjs # 质量评测:Recall@5 / Top-1 / MRR(低于 floor 退 2)
|
|
300
321
|
npm run probe -- --root "/path/your/wiki" # 攒一行检索质量趋势
|
|
301
322
|
node tools/preview.mjs # 出 preview/panel.html,浏览器直接看面板
|
|
302
323
|
node tools/preview.mjs --diag # 同上,并量一遍宽度 / 截断 / 溢出 / 对比度
|
|
303
324
|
```
|
|
304
325
|
|
|
326
|
+
`tests/local/` 那套要先把 `queries.example.json` 复制成 `queries.json` 再按自己的库改(`expect` 写「必须进前 5 的页名」,由人标,不依赖任何旧引擎的输出)。基线文件 `ab_baseline.json` 也是本地产物,重导用 `python ab_export.py > ab_baseline.json`。
|
|
327
|
+
|
|
305
328
|
跑知识网关那两段真实通路,要给两个环境变量(不给就整段跳过,不会假装通过):
|
|
306
329
|
|
|
307
330
|
```bash
|
|
308
331
|
WIKI_ROOT="/path/your/知识层-wiki" WIKI_TOOLS="/path/your/工具-tools" node tests/gateway.mjs
|
|
309
332
|
```
|
|
310
333
|
|
|
311
|
-
发版:改 `version` → `npm test` 全绿(`scripts.test`
|
|
334
|
+
发版:改 `version` → `npm test` 全绿(`scripts.test` 只串跑 `node tests/*.mjs`,25 个文件;`node --run test` 要 Node 22+,别在低版本上用它,也别拿它当门槛的证明)→ `npm pack --dry-run` 看一眼打包内容(`files` 只含 `lib`/`bin`/`docs`/`examples`/`README.md`/`CHANGELOG.md`/`LICENSE`/`cordis.patch.yml`,`preview/` 与 `tools/` 与 `tests/` 都不进包)→ **显式** `npm publish --registry=https://registry.npmjs.org/`。发布前先 `npm whoami --registry=https://registry.npmjs.org/` 确认已登录(本机 token 在 `.npmrc` 的 `//registry.npmjs.org/:_authToken=`;注意 `npm config get registry` 指向 npmmirror,而 npmmirror 那边不认这个 token,登录状态要显式指定 registry 去查)。发完要当场核三件事:`npm view <pkg>@<ver> dist.tarball` 取回的地址(带 fresh cache 与 REST cachebust)、下载 tarball 对 SHA256、`gh release view` 的 `isLatest`(注意它不能直接 `--json isLatest`)。
|
|
335
|
+
|
|
336
|
+
打包进了你的笔记标题怎么办:`tests/local/` 的 query 集、分歧白名单、回归基线与 `calls.jsonl` / `governance.jsonl` / `probe-history.csv` 都在 `.gitignore` 里,只在本机跑。发版前用 `git diff --cached | Select-String '<你的用户名>|<你的库路径>|<真实页名>'` 过一遍暂存区,命中就改口径再提交。
|
|
312
337
|
|
|
313
338
|
改样式的两条经验:
|
|
314
339
|
|
package/lib/bridge.js
CHANGED
|
@@ -9,7 +9,9 @@
|
|
|
9
9
|
* 并且带 stage='bridge'。绝不能把第 2 类伪装成「知识库里没有」。
|
|
10
10
|
*/
|
|
11
11
|
import { spawn } from 'node:child_process'
|
|
12
|
+
import { existsSync } from 'node:fs'
|
|
12
13
|
import path from 'node:path'
|
|
14
|
+
import { clipChars } from './text.js'
|
|
13
15
|
|
|
14
16
|
export const BRIDGE_VERSION = '0.1.0'
|
|
15
17
|
export const CONTRACT_VERSION = '1.0'
|
|
@@ -28,7 +30,7 @@ export function errorEnvelope(code, message, stage = 'bridge', detail = null, re
|
|
|
28
30
|
message,
|
|
29
31
|
stage,
|
|
30
32
|
retryable: retryable === true,
|
|
31
|
-
detail: detail === null || detail === undefined ? null : String(detail)
|
|
33
|
+
detail: detail === null || detail === undefined ? null : clipChars(String(detail), 2000),
|
|
32
34
|
},
|
|
33
35
|
}
|
|
34
36
|
}
|
|
@@ -71,13 +73,39 @@ export function runBridge({
|
|
|
71
73
|
data: null,
|
|
72
74
|
stderr: '',
|
|
73
75
|
ms: 0,
|
|
74
|
-
error: errorEnvelope('
|
|
76
|
+
error: errorEnvelope('E_TOOLS_ROOT_MISSING',
|
|
75
77
|
'还没配置工具目录(Python 管线所在文件夹)。请在插件配置里填 bridge.toolsRoot。',
|
|
76
78
|
'bridge'),
|
|
77
79
|
})
|
|
78
80
|
}
|
|
79
81
|
|
|
80
82
|
const script = path.join(toolsRoot, 'wiki_bridge.py')
|
|
83
|
+
|
|
84
|
+
// 目录没配对和 python 没装,在 spawn 眼里都是同一个 ENOENT(cwd 不存在也报 ENOENT)。
|
|
85
|
+
// 先自己看一眼,否则用户会去改 bridge.python 的路径 —— 那里根本没错。
|
|
86
|
+
if (!existsSync(toolsRoot)) {
|
|
87
|
+
return Promise.resolve({
|
|
88
|
+
ok: false,
|
|
89
|
+
data: null,
|
|
90
|
+
stderr: '',
|
|
91
|
+
ms: Date.now() - started,
|
|
92
|
+
error: errorEnvelope('E_TOOLS_ROOT_MISSING',
|
|
93
|
+
`工具目录不存在:${toolsRoot}(配置里的 bridge.toolsRoot 要指向放着 wiki_bridge.py 的那个文件夹)`,
|
|
94
|
+
'bridge'),
|
|
95
|
+
})
|
|
96
|
+
}
|
|
97
|
+
if (!existsSync(script)) {
|
|
98
|
+
return Promise.resolve({
|
|
99
|
+
ok: false,
|
|
100
|
+
data: null,
|
|
101
|
+
stderr: '',
|
|
102
|
+
ms: Date.now() - started,
|
|
103
|
+
error: errorEnvelope('E_BRIDGE_SCRIPT_MISSING',
|
|
104
|
+
`工具目录里没有 wiki_bridge.py:${toolsRoot}(这个目录还在,但缺了管线入口文件)`,
|
|
105
|
+
'bridge'),
|
|
106
|
+
})
|
|
107
|
+
}
|
|
108
|
+
|
|
81
109
|
const body = JSON.stringify({ ...(payload ?? {}), plugin_version: pluginVersion })
|
|
82
110
|
const pythonExe = python || 'python'
|
|
83
111
|
|
|
@@ -110,6 +138,7 @@ export function runBridge({
|
|
|
110
138
|
let outBytes = 0
|
|
111
139
|
let settled = false
|
|
112
140
|
let timer = null
|
|
141
|
+
let stdinError = null
|
|
113
142
|
|
|
114
143
|
const finish = (result) => {
|
|
115
144
|
if (settled) return
|
|
@@ -169,6 +198,14 @@ export function runBridge({
|
|
|
169
198
|
if (err.join('').length > 20000) err.splice(0, err.length - 8)
|
|
170
199
|
})
|
|
171
200
|
|
|
201
|
+
// python 先退出、这边还在写大 payload 时,stdin 会抛 EPIPE/EOF。
|
|
202
|
+
// **没有这个监听它就是一个没人接的 error 事件 —— 直接把宿主进程带崩**(实测 4MB payload + 立刻 exit 的子进程)。
|
|
203
|
+
// 只记下来,不在这里结算:py 完全不读 stdin 也是合法的(比如只回一句常数),
|
|
204
|
+
// 真正成不成要看 close 时有没有输出。
|
|
205
|
+
child.stdin.on('error', (error) => {
|
|
206
|
+
stdinError = error
|
|
207
|
+
})
|
|
208
|
+
|
|
172
209
|
child.on('close', (code) => {
|
|
173
210
|
const stdout = Buffer.concat(out).toString('utf8').trim()
|
|
174
211
|
const stderr = err.join('')
|
|
@@ -177,7 +214,10 @@ export function runBridge({
|
|
|
177
214
|
finish({
|
|
178
215
|
ok: false, data: null, stderr,
|
|
179
216
|
error: errorEnvelope('E_BRIDGE_CRASH',
|
|
180
|
-
|
|
217
|
+
stdinError === null
|
|
218
|
+
? `Python 没有输出(退出码 ${code})`
|
|
219
|
+
: `Python 没有输出(退出码 ${code}),stdin 写入也失败了(${stdinError.code ?? 'EPIPE'}):它可能没读完参数就退了`,
|
|
220
|
+
'bridge', tail(`${stdinError?.message ?? ''}\n${stderr}`)),
|
|
181
221
|
})
|
|
182
222
|
return
|
|
183
223
|
}
|
package/lib/calls.js
CHANGED
|
@@ -15,6 +15,7 @@ import { createJsonlStore } from './jsonl-store.js'
|
|
|
15
15
|
|
|
16
16
|
export { MAX_LINES, KEEP_LINES, TAIL_BYTES, lineCountOf } from './jsonl-store.js'
|
|
17
17
|
import { MAX_LINES, KEEP_LINES } from './jsonl-store.js'
|
|
18
|
+
import { clipChars } from './text.js'
|
|
18
19
|
|
|
19
20
|
/** 账本只认这 8 个字段。顺序就是表头顺序。 */
|
|
20
21
|
export const CALL_FIELDS = ['ts', 'source', 'tool', 'mode', 'query', 'hits', 'ms', 'ok']
|
|
@@ -44,7 +45,8 @@ function localDayOf(ts) {
|
|
|
44
45
|
|
|
45
46
|
function clipQuery(value) {
|
|
46
47
|
if (typeof value !== 'string') return ''
|
|
47
|
-
|
|
48
|
+
// 走 clipChars:账本里若留下半个表情,读回来是 \ud83d,设置页显示「�」
|
|
49
|
+
return value.length > QUERY_MAX ? clipChars(value, QUERY_MAX) + '…' : value
|
|
48
50
|
}
|
|
49
51
|
|
|
50
52
|
/**
|
|
@@ -75,7 +77,14 @@ export function normalizeEntry(raw) {
|
|
|
75
77
|
*/
|
|
76
78
|
export function createCallLog({ file, enabled = true, maxLines = MAX_LINES, keepLines = KEEP_LINES } = {}) {
|
|
77
79
|
const buffer = []
|
|
78
|
-
const store = createJsonlStore({
|
|
80
|
+
const store = createJsonlStore({
|
|
81
|
+
file, maxLines, keepLines,
|
|
82
|
+
// 轮转后文件里只剩最后 keepLines 条;内存缓冲若还留着被裁掉的那些,
|
|
83
|
+
// read() 会把它们当「文件缺的行」补回去 —— 窗口越读越长,而且补的是已经不存在的历史。
|
|
84
|
+
onRotate: ({ kept }) => {
|
|
85
|
+
while (buffer.length > kept) buffer.shift()
|
|
86
|
+
},
|
|
87
|
+
})
|
|
79
88
|
let on = enabled !== false
|
|
80
89
|
let warned = false
|
|
81
90
|
|
|
@@ -112,16 +121,25 @@ export function createCallLog({ file, enabled = true, maxLines = MAX_LINES, keep
|
|
|
112
121
|
|
|
113
122
|
function read({ limit = DEFAULT_LIMIT, source = 'all', only = 'all' } = {}) {
|
|
114
123
|
const fileRows = store.readRows()
|
|
115
|
-
//
|
|
124
|
+
// 文件里可能只有历史的一部分:要么写盘失败过(缺的是**最新**那几条),
|
|
125
|
+
// 要么被轮转/被外部删掉过(缺的是**更旧**那几条)。两种都要补回来,
|
|
126
|
+
// 但得放对位置 —— 直接往后追加会让旧行排到新行后面(真跑出来的顺序是 q2,q1,q0,q7,q6…)。
|
|
116
127
|
// 键带上 hits / ms:同一秒里两次相同的查询是不同的两件事,不该被去重吃掉。
|
|
117
128
|
const seen = new Set(fileRows.map((row) => `${row.ts}|${row.tool}|${row.query}|${row.hits}|${row.ms}`))
|
|
118
|
-
const
|
|
129
|
+
const firstTs = fileRows.length === 0 ? '' : String(fileRows[0].ts ?? '')
|
|
130
|
+
const missing = []
|
|
119
131
|
for (const row of buffer) {
|
|
120
132
|
const key = `${row.ts}|${row.tool}|${row.query}|${row.hits}|${row.ms}`
|
|
121
133
|
if (seen.has(key)) continue
|
|
122
134
|
seen.add(key)
|
|
123
|
-
|
|
135
|
+
missing.push(row)
|
|
124
136
|
}
|
|
137
|
+
// ts 只到秒,所以「同一秒」一律当成更旧(它们先写、文件后写):宁可让同秒的记录排前面,
|
|
138
|
+
// 也不要让列表撒谎。窗口最大不超过 maxLines —— 否则轮转等于没发生。
|
|
139
|
+
const older = firstTs === '' ? [] : missing.filter((row) => String(row.ts ?? '') <= firstTs)
|
|
140
|
+
const newer = firstTs === '' ? missing : missing.filter((row) => String(row.ts ?? '') > firstTs)
|
|
141
|
+
let merged = [...older, ...fileRows, ...newer]
|
|
142
|
+
if (merged.length > maxLines) merged = merged.slice(-maxLines)
|
|
125
143
|
merged.sort((a, b) => String(a.ts ?? '').localeCompare(String(b.ts ?? '')))
|
|
126
144
|
|
|
127
145
|
const scanned = merged.slice(-TOTALS_MAX)
|
package/lib/client.js
CHANGED
|
@@ -302,7 +302,9 @@ window.__ModuleLoader__.load({
|
|
|
302
302
|
setProbeNote({
|
|
303
303
|
tone: 'ok',
|
|
304
304
|
text:
|
|
305
|
-
|
|
305
|
+
// 这里的 resources 数的是「类型: 资料」的页数,不是原始资料份数 ——
|
|
306
|
+
// 写成「N 份资料」会让人以为库里只有 N 份原文(份数在每页的「来源数量」里)。
|
|
307
|
+
'这条路径能扫:' + (stats.pages || 0) + ' 页 / 其中资料页 ' + (stats.resources || 0) + ' 个(' + (result.ms || 0) + ' ms)',
|
|
306
308
|
})
|
|
307
309
|
} else {
|
|
308
310
|
setProbeNote({ tone: 'err', text: (result && result.error) || '这个路径扫不出页面' })
|
|
@@ -400,13 +402,17 @@ window.__ModuleLoader__.load({
|
|
|
400
402
|
),
|
|
401
403
|
)
|
|
402
404
|
|
|
405
|
+
// 页签做成真正的 tablist:读屏软件才会报「第 2 个,共 2 个,已选中」,
|
|
406
|
+
// 而不是两个没有关系的按钮。
|
|
403
407
|
var tabs = h(
|
|
404
408
|
'div',
|
|
405
|
-
{ className: 'wn-tabs' },
|
|
409
|
+
{ className: 'wn-tabs', role: 'tablist', 'aria-label': '知识库设置分页' },
|
|
406
410
|
h(
|
|
407
411
|
'button',
|
|
408
412
|
{
|
|
409
413
|
type: 'button',
|
|
414
|
+
role: 'tab',
|
|
415
|
+
'aria-selected': tab === 'overview',
|
|
410
416
|
className: tab === 'overview' ? 'wn-tab wn-tab-on' : 'wn-tab',
|
|
411
417
|
onClick: function () {
|
|
412
418
|
setTab('overview')
|
|
@@ -418,6 +424,8 @@ window.__ModuleLoader__.load({
|
|
|
418
424
|
'button',
|
|
419
425
|
{
|
|
420
426
|
type: 'button',
|
|
427
|
+
role: 'tab',
|
|
428
|
+
'aria-selected': tab === 'calls',
|
|
421
429
|
className: tab === 'calls' ? 'wn-tab wn-tab-on' : 'wn-tab',
|
|
422
430
|
onClick: function () {
|
|
423
431
|
setTab('calls')
|
|
@@ -671,7 +679,7 @@ window.__ModuleLoader__.load({
|
|
|
671
679
|
'div',
|
|
672
680
|
{ className: 'wn-chips' },
|
|
673
681
|
h('span', { className: 'wn-chip' }, (probe.stats.pages || 0) + ' 页'),
|
|
674
|
-
h('span', { className: 'wn-chip' }, (probe.stats.resources || 0) + '
|
|
682
|
+
h('span', { className: 'wn-chip' }, (probe.stats.resources || 0) + ' 资料页'),
|
|
675
683
|
h(
|
|
676
684
|
'span',
|
|
677
685
|
{ className: 'wn-chip' + ((probe.stats.brokenPages || 0) > 0 ? ' wn-chip-warn' : '') },
|
|
@@ -937,7 +945,8 @@ window.__ModuleLoader__.load({
|
|
|
937
945
|
'span',
|
|
938
946
|
{ className: 'wn-hit-row' },
|
|
939
947
|
h('span', { className: 'wn-hit-rank' }, String(rank)),
|
|
940
|
-
|
|
948
|
+
// 页名会被 ellipsis 截断,鼠标停上去要能看到全名
|
|
949
|
+
h('span', { className: 'wn-hit-name', title: hit.name }, hit.name),
|
|
941
950
|
hit.type !== '' && props.hideType !== true ? h('span', { className: 'wn-hit-type' }, hit.type) : null,
|
|
942
951
|
hit.allTerms === false ? h('span', { className: 'wn-hit-partial' }, '部分词') : null,
|
|
943
952
|
h(
|
|
@@ -1011,7 +1020,15 @@ window.__ModuleLoader__.load({
|
|
|
1011
1020
|
shown < result.total ? '(显示前 ' + shown + ')' : '',
|
|
1012
1021
|
),
|
|
1013
1022
|
result.degraded === true
|
|
1014
|
-
? h(
|
|
1023
|
+
? h(
|
|
1024
|
+
'span',
|
|
1025
|
+
{ className: 'wn-count-degraded' },
|
|
1026
|
+
// 兜底有两条路:OR(命中任一)与字面覆盖率(v1.6 起的第三条路)。
|
|
1027
|
+
// 说错会让人以为自己看到的是「任一词命中」的结果,实际是整句都没命中。
|
|
1028
|
+
result.coverageFallback === true
|
|
1029
|
+
? '没有一页命中整句,已按字面覆盖率匹配(≥45%)'
|
|
1030
|
+
: '没有一条命中全部词,已降级为「命中任一」',
|
|
1031
|
+
)
|
|
1015
1032
|
: null,
|
|
1016
1033
|
h(
|
|
1017
1034
|
'span',
|
|
@@ -1097,11 +1114,26 @@ window.__ModuleLoader__.load({
|
|
|
1097
1114
|
function EmptyState(props) {
|
|
1098
1115
|
var lib = props.lib
|
|
1099
1116
|
var pick = typeof props.onPick === 'function' ? props.onPick : function () {}
|
|
1117
|
+
var unset = lib !== null && lib !== undefined && (lib.source === 'unset' || String(lib.root || '') === '')
|
|
1118
|
+
// 没配库时说「还没填路径」,不要说「库 0 页」:后者会被读成「你库里什么都没有」
|
|
1119
|
+
if (unset) {
|
|
1120
|
+
return h(
|
|
1121
|
+
'div',
|
|
1122
|
+
{ className: 'wn-empty' },
|
|
1123
|
+
h('div', { className: 'wn-empty-line' }, '还没有配置知识库路径 —— 上面「当前库」那一栏填一个装了 .md 笔记的文件夹,或设置环境变量 DSH_WIKI_ROOT。'),
|
|
1124
|
+
h('div', { className: 'wn-empty-cov' }, '没配置时检索会直接报错,而不是返回空结果 —— 免得把「还没连上」读成「库里没有」。'),
|
|
1125
|
+
)
|
|
1126
|
+
}
|
|
1100
1127
|
return h(
|
|
1101
1128
|
'div',
|
|
1102
1129
|
{ className: 'wn-empty' },
|
|
1103
1130
|
lib !== null && lib !== undefined
|
|
1104
|
-
? h(
|
|
1131
|
+
? h(
|
|
1132
|
+
'div',
|
|
1133
|
+
{ className: 'wn-empty-lib' },
|
|
1134
|
+
// 「份资料」是错的:stats.resources 数的是资料页数。原件份数在每页的「来源数量」里。
|
|
1135
|
+
'库 ' + lib.pages + ' 页 · 资料页 ' + lib.resources + ' 个 · 实时同步:' + lib.watch,
|
|
1136
|
+
)
|
|
1105
1137
|
: null,
|
|
1106
1138
|
lib !== null && lib !== undefined
|
|
1107
1139
|
? h(
|
|
@@ -1200,6 +1232,10 @@ window.__ModuleLoader__.load({
|
|
|
1200
1232
|
unreadable: stats.unreadable || 0,
|
|
1201
1233
|
skipped: stats.skipped || 0,
|
|
1202
1234
|
root: data.scannedRoot || data.root || '',
|
|
1235
|
+
// 没配库时 stats 全是 0,空状态会写成「库 0 页」—— 读起来像「库里什么都没有」,
|
|
1236
|
+
// 而实际是「还没填路径」。这两个字段用来分开这两种情况。
|
|
1237
|
+
source: typeof data.source === 'string' ? data.source : '',
|
|
1238
|
+
sourceLabel: typeof data.sourceLabel === 'string' ? data.sourceLabel : '',
|
|
1203
1239
|
})
|
|
1204
1240
|
})
|
|
1205
1241
|
.catch(function () {})
|
|
@@ -1231,7 +1267,10 @@ window.__ModuleLoader__.load({
|
|
|
1231
1267
|
|
|
1232
1268
|
function runSearch(text) {
|
|
1233
1269
|
var trimmed = String(text === undefined ? query : text).trim()
|
|
1234
|
-
|
|
1270
|
+
// 不再因为 busy 就丢弃新查询:中文边打边查时,上一个请求还在飞、
|
|
1271
|
+
// 用户已经改完词了,丢掉新查询的结果就是「输入框写着 A,下面列的是 B 的结果」。
|
|
1272
|
+
// 先发的请求由 seqRef 作废,所以并发不会互相覆盖。
|
|
1273
|
+
if (trimmed === '') return
|
|
1235
1274
|
setQuery(trimmed)
|
|
1236
1275
|
setActive(-1)
|
|
1237
1276
|
seqRef.current = seqRef.current + 1
|
|
@@ -1306,6 +1345,10 @@ window.__ModuleLoader__.load({
|
|
|
1306
1345
|
scheduleSearch(next)
|
|
1307
1346
|
},
|
|
1308
1347
|
onKeyDown: function (event) {
|
|
1348
|
+
// 中文输入法正在组词时,回车是「确认候选词」、Esc 是「取消候选」,都不是面板的动作。
|
|
1349
|
+
// 这里连 preventDefault 都不能做,否则会把 IME 自己的确认吃掉。
|
|
1350
|
+
var composing = event.isComposing === true || event.keyCode === 229
|
|
1351
|
+
if (composing) return
|
|
1309
1352
|
if (event.key === 'Enter') {
|
|
1310
1353
|
event.preventDefault()
|
|
1311
1354
|
submit()
|
|
@@ -1355,9 +1398,14 @@ window.__ModuleLoader__.load({
|
|
|
1355
1398
|
|
|
1356
1399
|
error !== '' ? h(Notice, { tone: 'err', message: error }) : null,
|
|
1357
1400
|
|
|
1358
|
-
busy
|
|
1401
|
+
busy
|
|
1402
|
+
? h('div', { className: 'wn-busy', role: 'status', 'aria-live': 'polite' }, '检索中…')
|
|
1403
|
+
: null,
|
|
1359
1404
|
|
|
1360
|
-
|
|
1405
|
+
// 结果行也报给读屏:没有 aria-live 时,「命中 3 页」这种变化只有看得见的人知道
|
|
1406
|
+
result !== null
|
|
1407
|
+
? h('div', { role: 'status', 'aria-live': 'polite' }, h(CountRow, { result: result }))
|
|
1408
|
+
: null,
|
|
1361
1409
|
|
|
1362
1410
|
result !== null ? h(TermRow, { termPages: result.termPages, matchMode: result.matchMode }) : null,
|
|
1363
1411
|
|
|
@@ -1837,7 +1885,7 @@ window.__ModuleLoader__.load({
|
|
|
1837
1885
|
'.wn-chip-detail{color:var(--wn-muted);font-variant-numeric:tabular-nums;}',
|
|
1838
1886
|
'.wn-chip-warn{color:var(--wn-warn);border-color:color-mix(in srgb,var(--wn-warn) 35%,transparent);}',
|
|
1839
1887
|
'.wn-chip-dim{opacity:.7;}',
|
|
1840
|
-
'.wn-chip-dim .wn-chip-term{font-weight:500;color:var(--wn-
|
|
1888
|
+
'.wn-chip-dim .wn-chip-term{font-weight:500;color:var(--wn-muted);}',
|
|
1841
1889
|
'.wn-actions-spacer{flex:1 1 auto;}',
|
|
1842
1890
|
'.wn-details{border-top:1px solid var(--wn-line-soft);padding-top:9px;margin-top:2px;}',
|
|
1843
1891
|
'.wn-details summary{font-size:11.5px;color:var(--wn-muted);cursor:pointer;user-select:none;list-style:none;}',
|
|
@@ -1873,7 +1921,7 @@ window.__ModuleLoader__.load({
|
|
|
1873
1921
|
'.wn-why{display:flex;flex-wrap:wrap;gap:5px;}',
|
|
1874
1922
|
'.wn-hit-section{font-size:11px;color:var(--wn-muted);}',
|
|
1875
1923
|
// 设置页正文不设高度上限(页面本来就长,截断反而多出滚动条);侧栏才封顶。
|
|
1876
|
-
'.wn-hit-text{font-size:12.5px;line-height:1.75;color:var(--wn-fg);white-space:pre-wrap;padding-right:4px;}',
|
|
1924
|
+
'.wn-hit-text{font-size:12.5px;line-height:1.75;color:var(--wn-fg);white-space:pre-wrap;overflow-wrap:anywhere;padding-right:4px;}',
|
|
1877
1925
|
'.wn-hit-cite{font-size:10.5px;color:var(--wn-muted);word-break:break-all;display:flex;align-items:baseline;gap:8px;}',
|
|
1878
1926
|
'.wn-hit-cite-text{flex:1 1 auto;min-width:0;}',
|
|
1879
1927
|
'.wn-cite-copy{flex:0 0 auto;font-family:inherit;font-size:10.5px;line-height:1.6;padding:0 6px;border-radius:5px;border:1px solid var(--wn-line);background:var(--wn-bar);color:var(--wn-muted);cursor:pointer;}',
|
|
@@ -1919,12 +1967,14 @@ window.__ModuleLoader__.load({
|
|
|
1919
1967
|
'.wn-tabs{display:flex;gap:4px;border-bottom:1px solid var(--wn-line);padding-bottom:0;}',
|
|
1920
1968
|
'.wn-tab{appearance:none;border:0;background:transparent;padding:7px 12px;font-size:12.5px;color:var(--wn-muted);cursor:pointer;border-bottom:2px solid transparent;margin-bottom:-1px;}',
|
|
1921
1969
|
'.wn-tab:hover{color:var(--wn-fg);}',
|
|
1970
|
+
// 页签不是 .wn-btn,得单独给焦点环:否则用 Tab 键走过去时「当前焦点在哪」完全看不见
|
|
1971
|
+
'.wn-tab:focus-visible{outline:2px solid var(--wn-brand);outline-offset:2px;}',
|
|
1922
1972
|
'.wn-tab-on{color:var(--wn-fg);font-weight:600;border-bottom-color:var(--wn-brand);}',
|
|
1923
1973
|
'.wn-calls-stats{display:flex;gap:10px;flex-wrap:wrap;}',
|
|
1924
1974
|
'.wn-calls-stat{flex:1 1 120px;display:flex;flex-direction:column;gap:2px;padding:10px 12px;background:var(--wn-card);border:1px solid var(--wn-line-soft);border-radius:10px;}',
|
|
1925
1975
|
'.wn-calls-stat b{font-size:20px;line-height:1.1;}',
|
|
1926
1976
|
'.wn-calls-stat span{font-size:11.5px;color:var(--wn-muted);}',
|
|
1927
|
-
'.wn-calls-note{font-size:11.5px;color:var(--wn-
|
|
1977
|
+
'.wn-calls-note{font-size:11.5px;color:var(--wn-muted);}',
|
|
1928
1978
|
'.wn-calls-bar{display:flex;gap:8px;align-items:center;flex-wrap:wrap;}',
|
|
1929
1979
|
'.wn-calls-check{display:inline-flex;gap:5px;align-items:center;font-size:12px;color:var(--wn-muted);}',
|
|
1930
1980
|
'.wn-calls-table{width:100%;border-collapse:collapse;font-size:12px;}',
|