dsh-wiki-notes 1.10.0 → 1.10.2

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.
Files changed (16) hide show
  1. package/CHANGELOG.md +23 -0
  2. package/README.md +18 -0
  3. package/examples/demo-wiki/index.md +24 -0
  4. package/examples/demo-wiki/log.md +6 -0
  5. package/examples/demo-wiki//345/256/236/344/275/223-entities/V60/346/273/244/346/235/257.md +31 -0
  6. package/examples/demo-wiki//345/256/236/344/275/223-entities//346/211/213/346/221/207/347/243/250/350/261/206/346/234/272.md +26 -0
  7. package/examples/demo-wiki//345/257/271/346/257/224-comparisons//346/211/213/345/206/262/344/270/216/347/210/261/344/271/220/345/216/213.md +28 -0
  8. package/examples/demo-wiki//346/246/202/345/277/265-concepts//346/260/264/347/262/211/346/257/224.md +27 -0
  9. package/examples/demo-wiki//346/246/202/345/277/265-concepts//346/260/264/350/264/250.md +24 -0
  10. package/examples/demo-wiki//346/246/202/345/277/265-concepts//347/240/224/347/243/250/345/272/246.md +31 -0
  11. package/examples/demo-wiki//346/246/202/345/277/265-concepts//350/220/203/345/217/226/347/216/207.md +37 -0
  12. package/examples/demo-wiki//346/246/202/345/277/265-concepts//351/227/267/350/222/270.md +26 -0
  13. package/examples/demo-wiki//347/273/274/345/220/210-syntheses//344/270/200/346/235/257/345/222/226/345/225/241/345/245/275/344/270/215/345/245/275/345/226/235/346/200/216/344/271/210/345/210/244/346/226/255.md +27 -0
  14. package/examples/demo-wiki//350/265/204/346/226/231-sources//346/237/220/345/222/226/345/225/241/350/257/276/347/254/254/344/272/214/350/256/262/302/267/350/265/204/346/226/231/346/221/230/350/246/201.md +27 -0
  15. package/lib/index.js +10 -2
  16. package/package.json +4 -2
package/CHANGELOG.md CHANGED
@@ -2,6 +2,29 @@
2
2
 
3
3
  本文件的体例:只记「对使用者有影响的行为变化」,不记内部重构。版本号遵循 semver,`0.x` 阶段不承诺兼容。
4
4
 
5
+ ## 1.10.2
6
+
7
+ ### 新 · 一个跟笔记无关的示例库
8
+ - `examples/demo-wiki/`:10 页手冲咖啡笔记,覆盖 frontmatter 七个字段、双链、一条红链(`浓度计`)、一个孤岛页。它随包发布,装完就能跑 `node bin/cli.mjs search 萃取率怎么调 --root examples/demo-wiki` 看效果。
9
+ - 放在那里的理由不是「多给个例子」:这套东西只认「目录 + `.md` + frontmatter」,不认领域。换一个库不该改一行代码,这个库就是拿来当场验证这句话的。
10
+
11
+ ### 修 · 体检脚本的两个假绿灯
12
+ - `tools/verify-host.mjs` 的检索探针原来写死了某个库里的词,换个库来跑就只能测到「查不到」;现在从库里现挑枢纽页当查询词。
13
+ - 新增「读到了库」一项:`considered=0` 以前会显示成漂亮的「0 条命中」并判 PASS —— 那是 root 无效(比如 Windows 上传了 `/c/...` 这种 MSYS 路径),不是查得准。
14
+
15
+ ## 1.10.1
16
+
17
+ ### 修 · `wiki_context` 长期「降级」其实是一个环境变量没传
18
+ - 症状:每次 `wiki_context` 都返回 `degraded: true` / `degraded_sources: ["wiki_recall"]`,而 `status.support` 仍有值 —— 单看 `support` 会以为「库里的证据就这样」,实际是半个引擎在跑。
19
+ - 根因在插件这侧:Python 管线的 `wiki_recall` 引擎是回头调本插件的 `node bin/cli.mjs search`(`context_builder.py` 的 `run_plugin`),它用环境变量 `WIKI_PLUGIN_DIR` 定位插件目录。插件调桥时只传了 `WIKI_OBSERVE_LOG`,于是 cwd 落在工具目录、`bin/cli.mjs` 不存在,stdout 空,那边 `json.loads('')` 抛 `Expecting value: line 1 column 1 (char 0)`,引擎判死。
20
+ - 现在 `lib/index.js` 每次都传 `WIKI_PLUGIN_DIR`。修后实测:`engines` 两个都 `ok`,`degraded: false`,`degraded_sources: []`。
21
+ - 加了一条源码守卫(`tests/bridge.mjs`):假 python 的单元测试看不见这类故障 —— 它压根不调真管线,只有「必须传这个变量」的断言拦得住。
22
+
23
+ ### 新 · 两个体检脚本
24
+ - `node tools/verify-bridge.mjs`:真起一次 Python 桥,逐项断言「两个引擎都活着 / 没被标降级 / 带回了证据 / observe 认得回来」。默认不传观察日志,所以不会往治理账本里写东西。
25
+ - `node tools/verify-host.mjs --self`:在自己进程里用真入口起一个真 HTTP 服务,打 10 项探针(`/state` 版本指纹、`/links` 与它的 404、`/search`、`/open` 越界闸、`/calls` 字段数)。`--port <端口>` 探已在跑的 DSH。
26
+ - 两个脚本都在仓库里而不进包(`files` 不变),`npm run verify:bridge` / `npm run verify:host` 也能跑。
27
+
5
28
  ## 1.10.0
6
29
 
7
30
  把「探索」这一窗补成能顺着走的:从标签走到相邻主题,从一页走到它指向的和指向它的。
package/README.md CHANGED
@@ -90,6 +90,10 @@
90
90
 
91
91
  同时返回 `evidence`(证据页,含分级、支撑了哪个槽位)、`missing`(缺什么、为什么缺)、`conflicts`(冲突候选,**未裁决,别当成已确认的结论**)、`answer.contract_text`(给回答的约束:必须披露缺口、不得超出证据、引文须原文),以及一个 `context_id`。模型看到的渲染文本里,每张证据页最多再附 2 条原文引文(每条按槽位标注、裁到 220 字);JSON 结构不变,引文仍是页面原文子串,不是插件替你概括的。
92
92
 
93
+ `degraded` 为真时要先修通道,再谈结论。返回里的 `engines` 会写清每个通道的状态(`{"search":{"status":"ok"},"wiki_recall":{"status":"ok"}}`),`degraded_sources` 则点名是哪个死了。想直接体检这条通路,跑 `node tools/verify-bridge.mjs`:它真起一次 Python 管线,逐项断言「两个引擎都活着 / 没被标降级 / 带回了证据 / observe 认得回来」。
94
+
95
+ > 2026-11-17 踩过的一个真实故障:`wiki_recall` 通道长期是死的,于是每次 `wiki_context` 都挂 `degraded:true`,而 `support` 看上去还有值 —— 单看 `support` 会以为「库里的证据就这样」。根因不在 Python 也不在检索,而是插件调桥时**少传了一个环境变量** `WIKI_PLUGIN_DIR`:管线的 `wiki_recall` 引擎是回头调本插件的 `node bin/cli.mjs search`(见 `context_builder.py` 的 `run_plugin`),拿不到插件目录就把 cwd 落在工具目录,`bin/cli.mjs` 不存在,stdout 空,那边 `json.loads('')` 抛错,引擎判死。现在 `lib/index.js` 每次都传它,`tests/bridge.mjs` 里有一条源码守卫盯着这行 —— 假 python 的单元测试看不见这种故障,因为它压根不调真管线。
96
+
93
97
  ### `wiki_verify` —— 核验回答
94
98
 
95
99
  写完答案后自查(尤其含数字、范围、年份、题量分值这类主张时)用它。参数:`context_id` + `answer`(可选 `observe_id`,一般不用传,插件会自动带上)。
@@ -173,6 +177,15 @@ plugin_manager { action: "install_bundle", target: "<绝对路径>" }
173
177
 
174
178
  返回 `application: applied` 就生效,不用重启。但**改插件自己的代码要重启 DSH**:`lib/*.js`(宿主半)和 `lib/client.js`(设置页)都一样,已载入的模块不会因为关开插件而重新求值。
175
179
 
180
+ 想先看它到底怎么读库、不打算马上接自己的笔记:仓库里带了一个**跟笔记完全无关的小库** `examples/demo-wiki/`(10 页手冲咖啡笔记,含标签、别名、双链、一条红链、一个孤岛页),直接跑:
181
+
182
+ ```bash
183
+ node bin/cli.mjs search 萃取率怎么调 --root examples/demo-wiki
184
+ WIKI_ROOT="<仓库绝对路径>/examples/demo-wiki" node tools/verify-host.mjs --self
185
+ ```
186
+
187
+ 它存在的意思是:这套东西只认「目录 + `.md` + frontmatter」,不认领域 —— 换一个库不需要改一行代码。
188
+
176
189
  ---
177
190
 
178
191
  ## 配
@@ -393,6 +406,8 @@ lib/client.js 设置页 + 检索面板 + 右侧栏页签(手写 bundle,无
393
406
  bin/cli.mjs 命令行,不装插件也能跑
394
407
  tools/probe.mjs 检索质量探针:hit@1 / hit@3 / Recall@5,追加趋势 CSV
395
408
  tools/preview.mjs 把面板渲染成静态页(真组件 + 真 CSS),改样式不必重启 DSH
409
+ tools/verify-host.mjs 宿主实机验收:--self 自己起个真 HTTP 服务打 10 项探针,--port 探已在跑的 DSH
410
+ tools/verify-bridge.mjs 真管线体检:起一次 Python 桥,断言两个引擎都活着、没被标降级
396
411
  docs/库结构.md 库结构约定(这份才是一手文档)
397
412
  docs/README.md 文档导航页
398
413
  CHANGELOG.md 版本变更记录
@@ -413,6 +428,9 @@ WIKI_ROOT="/path/your/wiki" node tests/local/recall.mjs # 质量评测:Recal
413
428
  npm run probe -- --root "/path/your/wiki" # 攒一行检索质量趋势
414
429
  node tools/preview.mjs # 出 preview/panel.html,浏览器直接看面板
415
430
  node tools/preview.mjs --diag # 同上,并量一遍宽度 / 截断 / 溢出 / 对比度
431
+ node tools/verify-host.mjs --self # 宿主验收:本进程起真 HTTP 服务,打 10 项探针
432
+ node tools/verify-host.mjs --port 63123 # 探已在跑的 DSH(改完宿主没重启时,会在这几项上红)
433
+ node tools/verify-bridge.mjs # 真管线体检:两个引擎都得是 ok,degraded 得是 false
416
434
  ```
417
435
 
418
436
  `tests/local/` 那套要先把 `queries.example.json` 复制成 `queries.json` 再按自己的库改(`expect` 写「必须进前 5 的页名」,由人标,不依赖任何旧引擎的输出)。基线文件 `ab_baseline.json` 也是本地产物,重导用 `python ab_export.py > ab_baseline.json`。
@@ -0,0 +1,24 @@
1
+ # 索引
2
+
3
+ **当前规模**:10 个页面 · 2 份课程资料 · 最后更新 2026-11-10
4
+
5
+ ## 概念
6
+
7
+ - [[萃取率]] — 粉里溶进水里的物质占比,手冲 18%–22%(4 份资料,更新于 2026-11-10)
8
+ - [[研磨度]] — 所有变量里影响最大的一个,同时改萃取速度和停留时间(3 份资料,更新于 2026-11-08)
9
+ - [[水粉比]] — 决定「能溶出多少」,不决定「溶出了多少」(2 份资料,更新于 2026-11-06)
10
+ - [[闷蒸]] — 注水后先停 30–45 秒让粉排气,后面的水才走得匀(3 份资料,更新于 2026-11-04)
11
+ - [[水质]] — 咖啡液 98% 是水,硬度与碱度各有区间(2 份资料,更新于 2026-11-02)
12
+
13
+ ## 实体
14
+
15
+ - [[V60滤杯]] — 锥形单孔,出水快、容错低,手法直接决定总时间(3 份资料,更新于 2026-11-09)
16
+ - [[手摇磨豆机]] — 价值不在便宜,在换豆子时不用清刀盘(2 份资料,更新于 2026-11-05)
17
+
18
+ ## 对比
19
+
20
+ - [[手冲与爱乐压]] — 手冲给层次,爱乐压给稳定(4 份资料,更新于 2026-11-07)
21
+
22
+ ## 综合
23
+
24
+ - [[一杯咖啡好不好喝怎么判断]] — 先看萃取是否平衡,再谈豆子合不合口味(5 份资料,更新于 2026-11-10)
@@ -0,0 +1,6 @@
1
+ # 操作日志
2
+
3
+ ## [2026-10-15] ingest | 某咖啡课第二讲(3 篇原始资料)
4
+ ## [2026-10-20] query | 萃取率怎么调
5
+ ## [2026-11-07] query | 手冲和爱乐压区别
6
+ ## [2026-11-10] lint | 全库红链检查,发现缺少「浓度计」一页
@@ -0,0 +1,31 @@
1
+ ---
2
+ 类型: 实体
3
+ 状态: 稳定
4
+ 标签: [器具, Hario]
5
+ 别名: [V60, 锥形滤杯]
6
+ 来源数量: 3
7
+ 创建: 2026-10-04
8
+ 更新: 2026-11-09
9
+ ---
10
+
11
+ # V60 滤杯
12
+
13
+ > 一句话:锥形、单孔、螺旋肋 —— 靠形状把水流速度交给使用者控制。
14
+
15
+ ## 规格
16
+
17
+ - 角度 60°,这是名字的来源
18
+ - 锥形单孔,出水快,容错低
19
+ - 螺旋肋支撑滤纸,让空气从侧面走
20
+
21
+ ## 它为什么难
22
+
23
+ 出水孔大,注水快慢几乎直接决定总时间。手法不稳的人用它,同参数两杯能差出 30 秒。
24
+
25
+ ## 配套
26
+
27
+ - 滤纸:原厂 02 号
28
+ - 研磨:中细,见 [[研磨度]]
29
+ - 先 [[闷蒸]] 再分段注水
30
+
31
+ 相关:[[手冲与爱乐压]]、[[水粉比]]
@@ -0,0 +1,26 @@
1
+ ---
2
+ 类型: 实体
3
+ 状态: 稳定
4
+ 标签: [器具, 磨豆机]
5
+ 别名: [C3, 磨豆机, 手磨]
6
+ 来源数量: 2
7
+ 创建: 2026-10-07
8
+ 更新: 2026-11-05
9
+ ---
10
+
11
+ # 手摇磨豆机
12
+
13
+ > 一句话:手磨的价值不是便宜,是**换豆子时不用清刀盘**。
14
+
15
+ ## 六星刀盘(常见于 C3 一类)
16
+
17
+ - 磨出来的粉粒径分布偏窄,细粉少
18
+ - 磨一杯 15g 大约 30–40 秒
19
+ - 刻度每格约 0.02 mm,从意式到法压大约 40 格
20
+
21
+ ## 用它的两个纪律
22
+
23
+ 1. 每次只动一格,动完连冲两杯再判断。
24
+ 2. 细粉是手冲堵水的头号原因,磨完可以在纸上抖一抖。
25
+
26
+ 相关:[[研磨度]]
@@ -0,0 +1,28 @@
1
+ ---
2
+ 类型: 对比
3
+ 状态: 演进中
4
+ 标签: [咖啡, 器具]
5
+ 别名: [Pour-over vs AeroPress, 手冲 对比 爱乐压]
6
+ 来源数量: 4
7
+ 创建: 2026-10-09
8
+ 更新: 2026-11-07
9
+ ---
10
+
11
+ # 手冲与爱乐压
12
+
13
+ > 结论:手冲给你**风味层次**,爱乐压给你**稳定性**。要练手法选手冲,要每天一样选爱乐压。
14
+
15
+ ## 三个维度的差别
16
+
17
+ | 维度 | [[V60滤杯]] 手冲 | 爱乐压 |
18
+ | --- | --- | --- |
19
+ | 变量数 | 多(注水、时间、水温、研磨) | 少(浸泡时间、研磨) |
20
+ | 容错 | 低 | 高 |
21
+ | 出杯风格 | 干净、层次分明 | 饱满、醇厚 |
22
+
23
+ ## 同一支豆子的表现
24
+
25
+ 手冲会把酸质和香气拉开;爱乐压会把它们压在一起,喝起来更「整」。
26
+ 两者都受 [[萃取率]] 支配,只是调法不同:手冲调水流,爱乐压调浸泡时间。
27
+
28
+ 相关:[[研磨度]]
@@ -0,0 +1,27 @@
1
+ ---
2
+ 类型: 概念
3
+ 状态: 演进中
4
+ 标签: [咖啡, 配方]
5
+ 别名: [Brew Ratio, 粉水比]
6
+ 来源数量: 2
7
+ 创建: 2026-10-05
8
+ 更新: 2026-11-06
9
+ ---
10
+
11
+ # 水粉比
12
+
13
+ > 定义:咖啡粉与水的质量比。手冲常用 1:15 到 1:17。
14
+
15
+ ## 记住一句话
16
+
17
+ **比例决定「能溶出多少」,不决定「溶出了多少」。**
18
+
19
+ 1:15 是浓一点的配方,1:17 是淡一点的配方;但如果你萃取不足,加再多水也只是把淡的东西摊得更薄。
20
+
21
+ ## 常见区间
22
+
23
+ - 1:15 —— 浓郁,适合深烘、奶咖底
24
+ - 1:16 —— 手冲默认档
25
+ - 1:17 —— 浅烘、想喝风味层次时
26
+
27
+ 相关:[[萃取率]]、[[V60滤杯]]
@@ -0,0 +1,24 @@
1
+ ---
2
+ 类型: 概念
3
+ 状态: 演进中
4
+ 标签: [咖啡, 水质]
5
+ 别名: [Water, 水的硬度, TDS]
6
+ 来源数量: 2
7
+ 创建: 2026-10-11
8
+ 更新: 2026-11-02
9
+ ---
10
+
11
+ # 水质
12
+
13
+ > 定义:冲煮用水的矿物含量。咖啡液里 98% 是水,水质不是细节。
14
+
15
+ ## 两条经验值
16
+
17
+ - 总硬度(GH)50–100 ppm:太低萃不出甜感,太高发涩。
18
+ - 碱度(KH)40–70 ppm:碱度是「缓冲苦味」的,过高会把酸质压平。
19
+
20
+ ## 常见做法
21
+
22
+ 纯净水加矿物质包,或者用瓶装低矿化水。自来水经软水器后钠离子偏高,味道会发咸。
23
+
24
+ 相关:[[萃取率]]
@@ -0,0 +1,31 @@
1
+ ---
2
+ 类型: 概念
3
+ 状态: 稳定
4
+ 标签: [咖啡, 研磨]
5
+ 别名: [Grind Size, 粗细度]
6
+ 来源数量: 3
7
+ 创建: 2026-10-03
8
+ 更新: 2026-11-08
9
+ ---
10
+
11
+ # 研磨度
12
+
13
+ > 定义:咖啡粉颗粒的粗细。它是所有变量里对结果影响最大的一个。
14
+
15
+ ## 一个大致的对照
16
+
17
+ | 器具 | 粗细 | 手感 |
18
+ | --- | --- | --- |
19
+ | 意式 | 极细 | 像面粉 |
20
+ | [[V60滤杯]] 手冲 | 中细 | 像细砂糖 |
21
+ | 爱乐压 | 中细偏细 | 介于砂糖与面粉 |
22
+ | 法压 | 粗 | 像海盐 |
23
+
24
+ ## 为什么它排第一
25
+
26
+ 研磨度同时改变两件事:**表面积**(决定萃取速度)和**水流阻力**(决定停留时间)。
27
+ 其他变量都是「微调」,它是「换赛道」。
28
+
29
+ 同一支豆子,细一档可能就是尖酸变焦苦。所以调参数时一次只动这一个。
30
+
31
+ 相关:[[萃取率]]、[[手摇磨豆机]]
@@ -0,0 +1,37 @@
1
+ ---
2
+ 类型: 概念
3
+ 状态: 稳定
4
+ 标签: [咖啡, 冲煮]
5
+ 别名: [Extraction Yield, 萃取率公式]
6
+ 来源数量: 4
7
+ 创建: 2026-10-02
8
+ 更新: 2026-11-10
9
+ ---
10
+
11
+ # 萃取率
12
+
13
+ > 定义:咖啡粉里溶进水里的物质,占咖啡粉总重的百分比。手冲通常在 18%–22% 之间。
14
+
15
+ ## 怎么算
16
+
17
+ `萃取率 = 溶出物质量 / 咖啡粉质量`
18
+
19
+ 实际操作拿不到「溶出物质量」,所以用浓度反推:
20
+
21
+ `萃取率 ≈ (浓度 × 咖啡液质量) / 咖啡粉质量`
22
+
23
+ 浓度要用 [[浓度计]] 量,没有的话只能靠味觉经验估。
24
+
25
+ ## 三个能动的旋钮
26
+
27
+ 1. **研磨细度** —— 越细表面积越大,萃取越快。见 [[研磨度]]。
28
+ 2. **水粉比** —— 水越多,能溶出的上限越高。见 [[水粉比]]。
29
+ 3. **时间与水温** —— 水温 88–93℃,总时长 2–3 分钟是手冲的常见区间。
30
+
31
+ ## 高了低了分别什么味
32
+
33
+ - 萃取不足(< 18%):尖酸、涩、余味短,像嚼生豆。
34
+ - 萃取过度(> 22%):苦、木质、口干。
35
+ - 两头都可能「味道淡」—— 因为感知的是浓度,不是萃取率。
36
+
37
+ 延伸:[[一杯咖啡好不好喝怎么判断]]
@@ -0,0 +1,26 @@
1
+ ---
2
+ 类型: 概念
3
+ 状态: 演进中
4
+ 标签: [咖啡, 手法]
5
+ 别名: [Bloom, 排气]
6
+ 来源数量: 3
7
+ 创建: 2026-10-06
8
+ 更新: 2026-11-04
9
+ ---
10
+
11
+ # 闷蒸
12
+
13
+ > 定义:注水后先停 30–45 秒,让咖啡粉排气、均匀湿润的那一段。
14
+
15
+ ## 它在干什么
16
+
17
+ 新鲜烘焙的豆子含大量二氧化碳。热水一浇,气往外顶,水就进不去粉芯。
18
+ 先给一点水让它排完气,后面的水才能均匀穿过整层粉。
19
+
20
+ ## 三个可调的细节
21
+
22
+ 1. **水量** —— 通常两倍粉重(15g 粉配 30g 水)。
23
+ 2. **时长** —— 浅烘 45 秒,深烘 30 秒;豆子越新鲜越长。
24
+ 3. **要不要搅** —— 搅能提高均匀度,也会加快萃取,二者要一起算。
25
+
26
+ 相关:[[V60滤杯]]、[[水粉比]]
@@ -0,0 +1,27 @@
1
+ ---
2
+ 类型: 综合
3
+ 状态: 演进中
4
+ 标签: [咖啡, 品鉴]
5
+ 别名: [品鉴, 好喝的标准, 怎么判断好不好喝]
6
+ 来源数量: 5
7
+ 创建: 2026-10-12
8
+ 更新: 2026-11-10
9
+ ---
10
+
11
+ # 一杯咖啡好不好喝怎么判断
12
+
13
+ > 一句话:先分「萃取是否平衡」,再谈「这支豆子是不是你喜欢」。
14
+
15
+ ## 四步顺序
16
+
17
+ 1. **看甜感** —— 有没有中段的一口甜。没有甜,多半是萃取不足或豆子本身薄。
18
+ 2. **看余味** —— 咽下去 10 秒后嘴里剩下什么。剩苦是过萃,剩酸是欠萃。
19
+ 3. **看干净度** —— 有没有泥、涩、纸味。这些是技术问题,不是风味偏好。
20
+ 4. **最后才谈喜好** —— 前面三条都过了还觉得不好喝,那是豆子不合口味,不是手艺问题。
21
+
22
+ ## 常见误判
23
+
24
+ - 把「浓」当「好」:加粉就能变浓,但浓不等于萃取得当。
25
+ - 把「酸」当「坏」:浅烘的酸是设计出来的,尖涩的酸才是问题。
26
+
27
+ 相关:[[萃取率]]、[[水粉比]]、[[研磨度]]
@@ -0,0 +1,27 @@
1
+ ---
2
+ 类型: 资料
3
+ 状态: 稳定
4
+ 标签: [咖啡, 课程]
5
+ 别名: [第二讲, 课程笔记]
6
+ 来源数量: 1
7
+ 创建: 2026-10-15
8
+ 更新: 2026-10-15
9
+ 标题: 手冲基础:变量与顺序
10
+ 作者: 课程讲义
11
+ 来源: 线下课程录音整理
12
+ 覆盖文件: 原始资料-raw/某咖啡课/(3 篇)
13
+ ---
14
+
15
+ # 某咖啡课第二讲·资料摘要
16
+
17
+ > 这一讲的骨架:先把变量分成「换赛道」和「微调」两组,再按影响大小排序。
18
+
19
+ ## 关键结论(原文意思)
20
+
21
+ - 研磨度是换赛道,其他都是微调。原话:「先把粉磨对,再谈手法。」
22
+ - [[闷蒸]] 的意义被高估了一半:排气是真的,但「必须 30 秒」是教学习惯不是物理约束。
23
+ - 同一支豆子,[[萃取率]] 合适时,器具之间的差别比想象中小。
24
+
25
+ ## 原文里没有的
26
+
27
+ 没有讲 [[水质]],这一块是后来补的。
package/lib/index.js CHANGED
@@ -1496,8 +1496,16 @@ async function callBridge(command, payload) {
1496
1496
  python: cfg.python || 'python',
1497
1497
  toolsRoot: cfg.toolsRoot,
1498
1498
  timeoutMs: cfg.timeoutMs,
1499
- // 观察日志单独落盘:正式使用与测试数据物理隔离,免得修正率被自测记录带歪
1500
- env: cfg.observeLog ? { WIKI_OBSERVE_LOG: cfg.observeLog } : {},
1499
+ // 观察日志单独落盘:正式使用与测试数据物理隔离,免得修正率被自测记录带歪。
1500
+ // WIKI_PLUGIN_DIR 必须一起给:Python 管线里有一个 `wiki_recall` 引擎是回头调
1501
+ // 本插件的 `node bin/cli.mjs search`(context_builder.py 的 run_plugin),它按
1502
+ // 这个变量定位插件目录;不给就 cwd 落到工具目录、`bin/cli.mjs` 不存在,
1503
+ // node 的错误只进 stderr,stdout 空 → 那边 json.loads('') 抛
1504
+ // 「Expecting value: line 1 column 1 (char 0)」→ 每次 context 都被标成
1505
+ // degraded / degraded_sources:["wiki_recall"],两个引擎等于只跑了一个。
1506
+ env: cfg.observeLog
1507
+ ? { WIKI_OBSERVE_LOG: cfg.observeLog, WIKI_PLUGIN_DIR: pluginRoot }
1508
+ : { WIKI_PLUGIN_DIR: pluginRoot },
1501
1509
  pluginVersion: PLUGIN_VERSION,
1502
1510
  })
1503
1511
  if (!result.ok) {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-wiki-notes",
3
- "version": "1.10.0",
3
+ "version": "1.10.2",
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": [
@@ -46,7 +46,9 @@
46
46
  "scripts": {
47
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",
48
48
  "cli": "node bin/cli.mjs",
49
- "probe": "node tools/probe.mjs"
49
+ "probe": "node tools/probe.mjs",
50
+ "verify:host": "node tools/verify-host.mjs --self",
51
+ "verify:bridge": "node tools/verify-bridge.mjs"
50
52
  },
51
53
  "peerDependencies": {
52
54
  "@deepseek-ai/cordis": "^4.0.1",