dsh-wiki-notes 1.10.2 → 1.10.3
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 +14 -0
- package/README.md +10 -2
- package/examples/flat-wiki//344/270/200/346/254/241/345/244/232/345/201/232/347/202/271.md +11 -0
- package/examples/flat-wiki//345/210/200/345/205/267/344/277/235/345/205/273.md +11 -0
- package/examples/flat-wiki//345/211/251/350/217/234/344/277/235/345/255/230.md +10 -0
- package/examples/flat-wiki//345/216/250/346/210/277/345/212/250/347/272/277.md +13 -0
- package/examples/flat-wiki//346/214/221/344/270/200/346/212/212/350/266/201/346/211/213/347/232/204/350/217/234/345/210/200.md +13 -0
- package/examples/flat-wiki//346/262/271/346/270/251/345/210/244/346/226/255.md +11 -0
- package/examples/flat-wiki//347/202/222/351/224/205/345/274/200/351/224/205.md +11 -0
- package/examples/flat-wiki//347/240/247/346/235/277/351/200/211/346/213/251.md +12 -0
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,20 @@
|
|
|
2
2
|
|
|
3
3
|
本文件的体例:只记「对使用者有影响的行为变化」,不记内部重构。版本号遵循 semver,`0.x` 阶段不承诺兼容。
|
|
4
4
|
|
|
5
|
+
## 1.10.3
|
|
6
|
+
|
|
7
|
+
### 新 · 第二种结构的示例库:一个目录 + 一堆 .md
|
|
8
|
+
- `examples/flat-wiki/`:8 页家常厨房笔记,全部平铺在根目录,**零 frontmatter**、没有 `index.md`、没有 `log.md`、没有子目录。
|
|
9
|
+
- 它对应 README 的第 0 层承诺。没有 frontmatter 就没有类型 / 标签 / 别名那几路加分,也没有索引页提供的一句话摘要,检索退化成「文件名 + 正文」——但它照样能查,而且缺字段不报错,类型筛选会明说「现有类型:(无类型) 8」。
|
|
10
|
+
- 两个示例库合起来覆盖两端:`demo-wiki` 结构齐全(分目录、七个字段、红链、孤岛页),`flat-wiki` 近乎零结构。
|
|
11
|
+
|
|
12
|
+
### 修 · 仓库里的示例库现在有测试盯着
|
|
13
|
+
- 新增 `tests/examples.mjs`:两个库都读一遍,断言页数、字段归一、别名字段、标签、枢纽页入链数、红链数、正文非空;零 frontmatter 那个还要断言 `fields` 是空对象、`dir` 是 `.`、`logPresent` 是 false。
|
|
14
|
+
- 理由:`examples/` 在 `files` 里,示例库就是 npm 用户第一眼看到的东西。它被改坏了,坏的不是测试,是「装完试一下」这条唯一的低门槛体验。
|
|
15
|
+
|
|
16
|
+
### 修 · 体检脚本的第三个假绿灯
|
|
17
|
+
- 版本指纹探针原来用 `overview.tags[0].with` 判断宿主版本,遇到**零标签的库**(正是 flat-wiki)会把好宿主判成旧模块;现在没有标签时这一项记 skip,不计入缺失。
|
|
18
|
+
|
|
5
19
|
## 1.10.2
|
|
6
20
|
|
|
7
21
|
### 新 · 一个跟笔记无关的示例库
|
package/README.md
CHANGED
|
@@ -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
|
-
|
|
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
|
-
|
|
193
|
+
`flat-wiki` 存在的意思是:**第 0 层真能用**。没有 frontmatter 就没有类型、标签、别名那几路加分,也没有 `index.md` 提供的一句话摘要 —— 检索退化成「文件名 + 正文」,但它照样能查出东西,而且不会因为缺字段报错(类型筛选会明说「库里没有符合 type=概念 的页,现有类型:(无类型) 8」)。
|
|
194
|
+
|
|
195
|
+
两个库谁都没被特殊对待 —— 换一个库不需要改一行代码,`tests/examples.mjs` 每次跑测试都在替你把这句话验一遍。
|
|
188
196
|
|
|
189
197
|
---
|
|
190
198
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-wiki-notes",
|
|
3
|
-
"version": "1.10.
|
|
3
|
+
"version": "1.10.3",
|
|
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",
|