dsh-wiki-notes 1.1.2 → 1.3.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/README.md +59 -9
- package/docs/metrics.md +3 -1
- package/docs/superpowers/specs/2026-11-04-wiki-search-panel-design.md +113 -0
- package/lib/client.js +979 -38
- package/lib/corpus.js +55 -3
- package/lib/engine.js +199 -8
- package/lib/index.js +215 -22
- package/package.json +4 -3
package/lib/index.js
CHANGED
|
@@ -8,17 +8,19 @@
|
|
|
8
8
|
* 沙箱策略拦一道;这里只需要「读一个用户明确授权的目录」,用 node:fs 更直接,
|
|
9
9
|
* 而且这一步只在扫描时发生,不涉及任何写操作。
|
|
10
10
|
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
11
|
+
* 只读承诺:知识库本体一个字节都不写。会写盘的只有插件目录旁这两个文件——
|
|
12
|
+
* wiki-notes.config.json(设置页保存库路径与提示词配置)、lint-history.json
|
|
13
|
+
* (lint 的上一轮问题键,只用来算「新增 / 已修」)。而且只在用户点了保存、
|
|
14
|
+
* 或模型真的跑了 lint 时才写,检索路径全程不落盘。
|
|
13
15
|
*/
|
|
14
16
|
|
|
15
17
|
import path from 'node:path'
|
|
16
|
-
import { statSync, watch } from 'node:fs'
|
|
18
|
+
import { mkdirSync, readFileSync, statSync, watch, writeFileSync } from 'node:fs'
|
|
17
19
|
import { fileURLToPath } from 'node:url'
|
|
18
20
|
|
|
19
21
|
import { asList, loadCorpus } from './corpus.js'
|
|
20
22
|
import { mergePromptConfig, mergeTopicConfig, normalizeTopicConfig, readTopicConfig, writeTopicConfig } from './config.js'
|
|
21
|
-
import { run } from './engine.js'
|
|
23
|
+
import { MODES, freshnessOf, lint, run } from './engine.js'
|
|
22
24
|
import { configPath, DEFAULT_WIKI_ROOT, NOT_CONFIGURED_HINT, readConfigFile, normalizePromptConfig, readPromptConfig, resolveWikiRootInfo, writeConfigFile, writePromptConfig } from './config.js'
|
|
23
25
|
|
|
24
26
|
export const name = 'wiki-notes'
|
|
@@ -32,6 +34,16 @@ const CACHE_TTL_MS = 30_000
|
|
|
32
34
|
/** 设置页的同源 API 前缀(浏览器半侧 lib/client.js 里写的是同一个值)。 */
|
|
33
35
|
const API_PREFIX = '/api/wiki-notes'
|
|
34
36
|
|
|
37
|
+
/** 面板里一次输入的查询长度上限:超过这个长度不是检索,是粘贴事故。 */
|
|
38
|
+
const MAX_QUERY_CHARS = 200
|
|
39
|
+
|
|
40
|
+
/** 面板显示几条:引擎自己封顶 12(那是给模型的 token 预算),面板取更小的默认值。 */
|
|
41
|
+
function clampLimit(raw) {
|
|
42
|
+
const value = Number.parseInt(String(raw ?? ''), 10)
|
|
43
|
+
if (!Number.isFinite(value)) return 5
|
|
44
|
+
return Math.min(Math.max(value, 1), 12)
|
|
45
|
+
}
|
|
46
|
+
|
|
35
47
|
/**
|
|
36
48
|
* 工具泛词:它们能出现在任何一页上,对「这个库在研究什么」没有信息量。
|
|
37
49
|
* 命中就跳过,不进主题词候选(打标签不受影响,检索打分照旧用它们)。
|
|
@@ -65,17 +77,25 @@ function sendJson(res, status, payload) {
|
|
|
65
77
|
function readBody(req, limit = 64 * 1024) {
|
|
66
78
|
return new Promise((resolve, reject) => {
|
|
67
79
|
let size = 0
|
|
80
|
+
let tooLarge = false
|
|
68
81
|
const chunks = []
|
|
69
82
|
req.on('data', (chunk) => {
|
|
70
83
|
size += chunk.length
|
|
71
84
|
if (size > limit) {
|
|
72
|
-
|
|
73
|
-
|
|
85
|
+
// 早先这里直接 destroy 连接:调用方拿到的是「连接被重置」,不知道是自己发大了。
|
|
86
|
+
// 现在把超限记下来、后面的字节丢掉,读完再回 413 —— 错误得说清楚是哪一步错。
|
|
87
|
+
tooLarge = true
|
|
88
|
+
chunks.length = 0
|
|
74
89
|
return
|
|
75
90
|
}
|
|
76
|
-
chunks.push(chunk)
|
|
91
|
+
if (!tooLarge) chunks.push(chunk)
|
|
77
92
|
})
|
|
78
93
|
req.on('end', () => {
|
|
94
|
+
if (tooLarge) {
|
|
95
|
+
const error = new Error(`请求体超过 ${limit} 字节上限`)
|
|
96
|
+
error.code = 'BODY_TOO_LARGE'
|
|
97
|
+
return reject(error)
|
|
98
|
+
}
|
|
79
99
|
const text = Buffer.concat(chunks).toString('utf8').trim()
|
|
80
100
|
if (text === '') return resolve(null)
|
|
81
101
|
try {
|
|
@@ -88,13 +108,38 @@ function readBody(req, limit = 64 * 1024) {
|
|
|
88
108
|
})
|
|
89
109
|
}
|
|
90
110
|
|
|
111
|
+
/**
|
|
112
|
+
* 跨源写配置的闸。
|
|
113
|
+
*
|
|
114
|
+
* 本机服务没有鉴权,浏览器里的任何网页都能往 127.0.0.1 发 POST —— 一个恶意页面
|
|
115
|
+
* 就能把库路径改走、把提示词换掉。拦的判据很窄:带 Origin 且 Origin 主机不是回环地址
|
|
116
|
+
* 就拒。不带 Origin 的请求(curl、命令行、插件自己)照旧放行,那是本机程序不是网页。
|
|
117
|
+
* 没有做 CSRF token:Setting 页是宿主的,改不动它的请求,先挡住最实的一层。
|
|
118
|
+
*/
|
|
119
|
+
function blockedOrigin(req) {
|
|
120
|
+
const origin = req.headers?.origin
|
|
121
|
+
if (typeof origin !== 'string' || origin === '') return false
|
|
122
|
+
// 沙箱 iframe / file:// 页面发的是字符串 'null'。DSH 的设置页若被宿主放进
|
|
123
|
+
// 不透传来源的 iframe,这里放行才不至于把用户自己的保存按钮挡掉 ——
|
|
124
|
+
// 代价是不透明来源挡不住,但那类页面本来也拿不到响应,只能盲写。
|
|
125
|
+
if (origin === 'null') return false
|
|
126
|
+
try {
|
|
127
|
+
const host = new URL(origin).hostname
|
|
128
|
+
return !['127.0.0.1', 'localhost', '::1', '[::1]'].includes(host)
|
|
129
|
+
} catch {
|
|
130
|
+
return true
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
|
|
91
134
|
const PARAMETERS = {
|
|
92
135
|
type: 'object',
|
|
93
136
|
properties: {
|
|
94
137
|
mode: {
|
|
95
138
|
type: 'string',
|
|
96
|
-
|
|
97
|
-
|
|
139
|
+
// 枚举只有一个来源:engine 的 MODES。新增 mode 时漏改这里,
|
|
140
|
+
// 描述教会了模型、schema 却把它挡在门外 —— 那是最难查的一种错。
|
|
141
|
+
enum: MODES,
|
|
142
|
+
description: 'search=关键词检索(默认);page=整页;list=目录;overview=总览;lint=健康检查;draft=落盘骨架;help=用法与状态说明',
|
|
98
143
|
},
|
|
99
144
|
query: {
|
|
100
145
|
type: 'string',
|
|
@@ -160,24 +205,23 @@ const DESCRIPTION = `本地 LLM-Wiki 知识库检索(只读,不会改动任
|
|
|
160
205
|
- 问个人记录(「我之前怎么记的」「笔记里写了什么」);
|
|
161
206
|
- 涉及你笔记库里长期整理、反复出现的学科或领域(注入的主题词就是从高频标签取的);
|
|
162
207
|
- 点名具体工具、框架、模型、项目、论文;
|
|
163
|
-
-
|
|
208
|
+
- 要求引用、转述、核对笔记原文;
|
|
209
|
+
- 正要下判断、正要写结论,或要把答案回写成新页之前:先查一遍再动笔,别写完再补。
|
|
164
210
|
|
|
165
211
|
何时可以不查:纯通用常识,且根据库索引线索能确认没有对应内容(如「水」「三角形」)。
|
|
166
212
|
只是没看到线索,不等于库里没有;拿不准先查,别靠自信跳过。
|
|
167
213
|
|
|
168
214
|
mode 用法:
|
|
169
|
-
- search(默认):传 1-4 个关键词,空格分隔做 AND
|
|
170
|
-
- page
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
- draft:把本次的好答案回写成新页时,先要一份落盘骨架(目录、frontmatter 七字段、index.md 那一行、log.md 那一条)。本工具只返回文本,写文件要用你自己的写文件工具。
|
|
215
|
+
- search(默认):传 1-4 个关键词,空格分隔做 AND,别传整句问话。
|
|
216
|
+
- page / list / overview / lint / draft:取整页 / 列目录 / 看总览 / 查健康 / 拿落盘骨架。
|
|
217
|
+
|
|
218
|
+
机制说明、每个 mode 的返回格式、status 各取值的含义、全部参数 —— 用 mode:"help" 查一次。
|
|
219
|
+
描述只讲「什么时候该调」,讲不全的细节都在 help 里,不确定就查,比猜便宜。
|
|
175
220
|
|
|
176
221
|
怎么读结果:
|
|
177
222
|
- kind=note 是消化过的笔记(最可信);raw-summary 是原始资料的压缩稿;source 是资料页。
|
|
178
223
|
- sources 是「来源数量」,判断证据强度用:1 份和 12 份不是一回事。
|
|
179
|
-
-
|
|
180
|
-
- brokenLinks 非空 = 这一节引用了库里不存在的页(红链),说明该处判断缺少页级支撑,转述时要标明。
|
|
224
|
+
- 每条带「更新」时间与距今天数;标了「可能已过时」的页,引用时要说明时间,别当成最新结论。
|
|
181
225
|
- 一条都没命中不代表话题不存在,换同义词(中文/英文/缩写)或先用 list 看目录再搜。`
|
|
182
226
|
|
|
183
227
|
/** 知识层的候选目录名:路径指到上一层时,自动下钻到这些名字。 */
|
|
@@ -406,10 +450,13 @@ export function apply(ctx, config = {}) {
|
|
|
406
450
|
}
|
|
407
451
|
|
|
408
452
|
// 启动时探一次库:路径写错的话,日志里会立刻出现,而不是等模型调用时才失败。
|
|
453
|
+
// 顺带把「重启后第一次扫描」提前到没人等的时候做 —— 实测冷盘要 5s 上下(一次真实重启后
|
|
454
|
+
// 5,217ms,第二次 29ms),这段延迟不该落在用户的第一句提问上。
|
|
455
|
+
const warmStarted = Date.now()
|
|
409
456
|
getCorpus()
|
|
410
457
|
.then((corpus) => {
|
|
411
458
|
ctx.logger?.info?.(
|
|
412
|
-
`LLM-Wiki 检索就绪:${corpus.stats.pages} 页 / ${corpus.stats.resources} 份资料 / ${corpus.stats.brokenPages} 页存在红链(${root})`,
|
|
459
|
+
`LLM-Wiki 检索就绪:${corpus.stats.pages} 页 / ${corpus.stats.resources} 份资料 / ${corpus.stats.brokenPages} 页存在红链(${root},首次扫描 ${Date.now() - warmStarted} ms)`,
|
|
413
460
|
)
|
|
414
461
|
})
|
|
415
462
|
.catch((error) => {
|
|
@@ -427,6 +474,19 @@ export function apply(ctx, config = {}) {
|
|
|
427
474
|
brokenPages: stats.brokenPages ?? 0,
|
|
428
475
|
brokenTotal: stats.brokenTotal ?? 0,
|
|
429
476
|
scannedMs: stats.scannedMs ?? 0,
|
|
477
|
+
// 覆盖诊断:分母各是各的,别让人对着「95 页」猜漏了什么。
|
|
478
|
+
// discovered = pages + unreadable + skipped(文件级恒等式);walkFailures 是目录数,另算。
|
|
479
|
+
discovered: stats.discovered ?? 0,
|
|
480
|
+
skipped: stats.skipped ?? 0,
|
|
481
|
+
unreadable: stats.unreadable ?? 0,
|
|
482
|
+
oversized: stats.oversized ?? 0,
|
|
483
|
+
walkFailures: stats.walkFailures ?? 0,
|
|
484
|
+
statFailures: stats.statFailures ?? 0,
|
|
485
|
+
sections: stats.sections ?? 0,
|
|
486
|
+
bytes: stats.bytes ?? 0,
|
|
487
|
+
newestMtime: stats.newestMtime ?? '',
|
|
488
|
+
oldestMtime: stats.oldestMtime ?? '',
|
|
489
|
+
scannedAt: stats.scannedAt ?? '',
|
|
430
490
|
}
|
|
431
491
|
}
|
|
432
492
|
|
|
@@ -494,10 +554,38 @@ export function apply(ctx, config = {}) {
|
|
|
494
554
|
path: API_PREFIX,
|
|
495
555
|
handler: async (req, res) => {
|
|
496
556
|
const route = (req.url ?? '').split('?')[0].slice(API_PREFIX.length) || '/'
|
|
557
|
+
// 写操作先过跨源闸;GET /state 是只读,不拦。
|
|
558
|
+
if (req.method === 'POST' && blockedOrigin(req)) {
|
|
559
|
+
return sendJson(res, 403, { error: '拒绝跨源请求:写配置只接受本机页面或命令行' })
|
|
560
|
+
}
|
|
497
561
|
try {
|
|
498
562
|
if (route === '/state' && req.method === 'GET') {
|
|
499
563
|
return sendJson(res, 200, await buildState())
|
|
500
564
|
}
|
|
565
|
+
// 面板专用只读查询:和模型调 wiki_recall 走同一个 run(),所以「人看到的」
|
|
566
|
+
// 就是「模型拿到的」——这正是这个面板存在的理由,另写一套轻量检索就白做了。
|
|
567
|
+
// explain 只在服务端打开;工具 schema 里没有这个参数,模型触发不到。
|
|
568
|
+
if (route === '/search' && req.method === 'GET') {
|
|
569
|
+
const parsed = new URL(req.url ?? '/', 'http://127.0.0.1')
|
|
570
|
+
const query = (parsed.searchParams.get('q') ?? '').trim().slice(0, MAX_QUERY_CHARS)
|
|
571
|
+
// 空查询不当作错误让面板弹红字:面板要显示的是「库现在什么样」,那是 /state 的事。
|
|
572
|
+
if (query === '') return sendJson(res, 400, { error: '缺少 q 参数(要查什么)' })
|
|
573
|
+
const started = Date.now()
|
|
574
|
+
const corpus = await getCorpus()
|
|
575
|
+
const result = run(corpus, {
|
|
576
|
+
mode: 'search',
|
|
577
|
+
query,
|
|
578
|
+
limit: clampLimit(parsed.searchParams.get('limit')),
|
|
579
|
+
explain: true,
|
|
580
|
+
})
|
|
581
|
+
return sendJson(res, 200, {
|
|
582
|
+
...result,
|
|
583
|
+
// 面板要的分母:扫了多少页、扫描本身花了多久、这次查询花了多久
|
|
584
|
+
scanned: corpus.stats?.pages ?? 0,
|
|
585
|
+
scannedMs: corpus.stats?.scannedMs ?? 0,
|
|
586
|
+
elapsedMs: Date.now() - started,
|
|
587
|
+
})
|
|
588
|
+
}
|
|
501
589
|
if (route === '/check' && req.method === 'POST') {
|
|
502
590
|
const body = await readBody(req)
|
|
503
591
|
return sendJson(res, 200, await probeRoot(body?.root))
|
|
@@ -552,6 +640,9 @@ export function apply(ctx, config = {}) {
|
|
|
552
640
|
}
|
|
553
641
|
return sendJson(res, 404, { error: `未知路由 ${route}` })
|
|
554
642
|
} catch (error) {
|
|
643
|
+
if (error?.code === 'BODY_TOO_LARGE') {
|
|
644
|
+
return sendJson(res, 413, { error: String(error.message ?? error) })
|
|
645
|
+
}
|
|
555
646
|
return sendJson(res, 500, { error: String(error?.message ?? error) })
|
|
556
647
|
}
|
|
557
648
|
},
|
|
@@ -568,6 +659,9 @@ export function apply(ctx, config = {}) {
|
|
|
568
659
|
ctx.systemPrompt?.context?.({
|
|
569
660
|
name: 'wiki-notes:topics',
|
|
570
661
|
order: 240,
|
|
662
|
+
// 关掉变量插值:这段文本里可能有用户自己写的提示词(extra / override),
|
|
663
|
+
// 里面的 {{...}} 是普通文字,不该被宿主当变量解析成空串或报错。
|
|
664
|
+
interpolate: false,
|
|
571
665
|
text: () => buildTopicText(),
|
|
572
666
|
})
|
|
573
667
|
} catch (error) {
|
|
@@ -590,6 +684,13 @@ export function apply(ctx, config = {}) {
|
|
|
590
684
|
if (result !== null && typeof result === 'object') {
|
|
591
685
|
result.scanned = corpus.stats.pages
|
|
592
686
|
result.root = root
|
|
687
|
+
if (result.mode === 'lint') {
|
|
688
|
+
try {
|
|
689
|
+
result.sinceLast = recordLintRun(corpus, args ?? {}, pluginRoot)
|
|
690
|
+
} catch {
|
|
691
|
+
// 历史文件坏了不该让体检失败:少一行对比,其它照报
|
|
692
|
+
}
|
|
693
|
+
}
|
|
593
694
|
if (typeof corpus.drilledFrom === 'string') result.drilledFrom = corpus.drilledFrom
|
|
594
695
|
result.ms = Date.now() - started
|
|
595
696
|
}
|
|
@@ -632,6 +733,59 @@ export function apply(ctx, config = {}) {
|
|
|
632
733
|
})
|
|
633
734
|
}
|
|
634
735
|
|
|
736
|
+
/* ------------------------- 体检历史(lint 的对比基线) ------------------------- */
|
|
737
|
+
|
|
738
|
+
/** 需要动手的项。不含「久未更新」:它随时间自己变,进 diff 只会产生噪音。 */
|
|
739
|
+
function lintIssueKeys(value) {
|
|
740
|
+
const keys = new Set()
|
|
741
|
+
for (const row of value.orphans ?? []) keys.add(`孤儿页 ${row}`)
|
|
742
|
+
for (const row of value.brokenTargets ?? []) keys.add(`断链 ${row.name}`)
|
|
743
|
+
for (const row of value.missingFields ?? []) keys.add(`缺字段 ${row.name}`)
|
|
744
|
+
for (const row of value.aliasConflicts ?? []) keys.add(`别名冲突 ${row.alias}`)
|
|
745
|
+
for (const row of value.noLinks ?? []) keys.add(`无出链 ${row}`)
|
|
746
|
+
return keys
|
|
747
|
+
}
|
|
748
|
+
|
|
749
|
+
/**
|
|
750
|
+
* 记下这次体检,并和上一次比。
|
|
751
|
+
*
|
|
752
|
+
* 单次报告只说明「现在有什么」,说不出「库在变好还是变坏」——
|
|
753
|
+
* 修了三处、又坏了五处,和一处没动,在单次报告里长得一样。
|
|
754
|
+
* 对比用的那份用大 limit 重算一次:报告的 items 是截断的,拿截断结果做 diff 会漏项。
|
|
755
|
+
*/
|
|
756
|
+
function recordLintRun(corpus, args, pluginRoot) {
|
|
757
|
+
const file = path.join(path.dirname(configPath(pluginRoot)), 'lint-history.json')
|
|
758
|
+
const full = lint(corpus, { ...args, limit: 500 })
|
|
759
|
+
const keys = lintIssueKeys(full)
|
|
760
|
+
|
|
761
|
+
let previous = null
|
|
762
|
+
try {
|
|
763
|
+
previous = JSON.parse(readFileSync(file, 'utf8'))
|
|
764
|
+
} catch {
|
|
765
|
+
previous = null // 第一次跑,或文件坏了:都当作没有基线
|
|
766
|
+
}
|
|
767
|
+
|
|
768
|
+
const before = new Set(Array.isArray(previous?.keys) ? previous.keys : [])
|
|
769
|
+
const added = [...keys].filter((key) => !before.has(key))
|
|
770
|
+
const fixed = [...before].filter((key) => !keys.has(key))
|
|
771
|
+
|
|
772
|
+
try {
|
|
773
|
+
mkdirSync(path.dirname(file), { recursive: true })
|
|
774
|
+
writeFileSync(file, JSON.stringify({ at: new Date().toISOString(), keys: [...keys] }), 'utf8')
|
|
775
|
+
} catch {
|
|
776
|
+
// 写不进去(只读家目录)不该影响体检本身
|
|
777
|
+
}
|
|
778
|
+
|
|
779
|
+
return {
|
|
780
|
+
at: previous?.at ?? '',
|
|
781
|
+
first: previous === null,
|
|
782
|
+
added: added.slice(0, 5),
|
|
783
|
+
addedTotal: added.length,
|
|
784
|
+
fixed: fixed.slice(0, 5),
|
|
785
|
+
fixedTotal: fixed.length,
|
|
786
|
+
}
|
|
787
|
+
}
|
|
788
|
+
|
|
635
789
|
/* ------------------------------- 渲染 ------------------------------- */
|
|
636
790
|
|
|
637
791
|
function renderValue(args, value) {
|
|
@@ -665,6 +819,9 @@ function renderValue(args, value) {
|
|
|
665
819
|
case 'draft':
|
|
666
820
|
body = renderDraft(value)
|
|
667
821
|
break
|
|
822
|
+
case 'help':
|
|
823
|
+
body = renderHelp(value)
|
|
824
|
+
break
|
|
668
825
|
default:
|
|
669
826
|
body = JSON.stringify(value, null, 2)
|
|
670
827
|
}
|
|
@@ -691,6 +848,18 @@ function renderLint(value) {
|
|
|
691
848
|
`库健康检查(只读)· ${stats.pages ?? 0} 页 · ${stats.resources ?? 0} 份资料 · 扫描 ${stats.scannedMs ?? 0} ms`,
|
|
692
849
|
]
|
|
693
850
|
|
|
851
|
+
const since = value.sinceLast
|
|
852
|
+
if (since && since.first !== true) {
|
|
853
|
+
// 单次报告只有「现在」,说不出趋势:修了三处又坏五处,和一处没动长得一样
|
|
854
|
+
const parts = []
|
|
855
|
+
if (since.addedTotal > 0) parts.push(`新增 ${since.addedTotal} 项(${since.added.join(';')})`)
|
|
856
|
+
if (since.fixedTotal > 0) parts.push(`已修 ${since.fixedTotal} 项(${since.fixed.join(';')})`)
|
|
857
|
+
if (parts.length === 0) parts.push('没有变化')
|
|
858
|
+
lines.push(`与上次(${String(since.at).slice(0, 10)})相比:${parts.join(',')}`)
|
|
859
|
+
} else if (since && since.first === true) {
|
|
860
|
+
lines.push('(第一次记录基线,下次起会显示相对上次的变化)')
|
|
861
|
+
}
|
|
862
|
+
|
|
694
863
|
const block = (title, total, rows, format) => {
|
|
695
864
|
if (!total) return
|
|
696
865
|
lines.push('')
|
|
@@ -716,6 +885,20 @@ function renderLint(value) {
|
|
|
716
885
|
}
|
|
717
886
|
|
|
718
887
|
/** draft 的渲染:要能整段复制去落盘,所以顺序是「未落盘声明 → 文件 → 内容 → 三件收尾」。 */
|
|
888
|
+
/**
|
|
889
|
+
* help 的渲染:纯静态文本,按小节铺开。
|
|
890
|
+
* 不放 markdown 表格 —— 模型读的是文本,表格的对齐空白是白付的 token。
|
|
891
|
+
*/
|
|
892
|
+
function renderHelp(value) {
|
|
893
|
+
const out = ['【wiki_recall 用法】']
|
|
894
|
+
for (const section of value.sections ?? []) {
|
|
895
|
+
out.push('')
|
|
896
|
+
out.push(`■ ${section.title}`)
|
|
897
|
+
for (const line of section.lines ?? []) out.push(line)
|
|
898
|
+
}
|
|
899
|
+
return out.join('\n')
|
|
900
|
+
}
|
|
901
|
+
|
|
719
902
|
function renderDraft(value) {
|
|
720
903
|
const out = []
|
|
721
904
|
// 最重要的事实放第一行:模型会截断、摘要或转述,末尾的说明最先被省掉
|
|
@@ -746,7 +929,8 @@ function metaLine(hit) {
|
|
|
746
929
|
if (hit.type) parts.push(hit.type)
|
|
747
930
|
if (hit.status) parts.push(hit.status)
|
|
748
931
|
if (hit.sources !== null && hit.sources !== undefined) parts.push(`${hit.sources} 源`)
|
|
749
|
-
|
|
932
|
+
// 光给日期模型判断不了该不该信:三年前的结论和上周的结论长得一模一样。
|
|
933
|
+
if (hit.updated) parts.push(freshnessOf(hit.updated))
|
|
750
934
|
if (hit.kind && KIND_LABEL[hit.kind]) parts.push(KIND_LABEL[hit.kind])
|
|
751
935
|
return parts.join(' · ')
|
|
752
936
|
}
|
|
@@ -775,6 +959,11 @@ function renderSearch(value) {
|
|
|
775
959
|
`${Number.isFinite(value.allTerms) ? `(全词 ${value.allTerms})` : ''}· 返回 ${value.returned ?? 0}`
|
|
776
960
|
: `扫描 ${scanned} 页,${value.total} 命中`
|
|
777
961
|
out.push(`【检索】${tokens} ${numbers}`)
|
|
962
|
+
// 「没沾到」是给模型看的换词依据:面板上能点出来,模型看不到就等于白算。
|
|
963
|
+
// 它和 degraded 说的不是一件事:degraded 是「一条全词命中都没有」,
|
|
964
|
+
// 这里是「这个具体的词在库里一页都没沾到」—— 后者才指着该换哪个词。
|
|
965
|
+
const missed = Array.isArray(value.missedTerms) ? value.missedTerms : []
|
|
966
|
+
if (missed.length > 0) out.push(`没沾到:${missed.join('、')}(这些词在库里一页都没命中,换同义词或干脆去掉)`)
|
|
778
967
|
// 降级说明已由 warnings 承载(degraded 时必有一条);只有老调用方(结果里没有 status 字段)
|
|
779
968
|
// 才需要这里的 note —— 否则同一句话模型会读两遍。
|
|
780
969
|
if (value.note && value.status === undefined) out.push(`⚠️ ${value.note}`)
|
|
@@ -794,7 +983,8 @@ function renderSearch(value) {
|
|
|
794
983
|
// 超大页的正文从来没读过,标题和摘要不沾边也推不出正文不沾边。
|
|
795
984
|
out.push(`当前可检索范围内没有命中:已比对 ${value.considered ?? scanned} 页的内容${gap}。`)
|
|
796
985
|
out.push('这只说明参与比对的页面里没有,不能反推全库没有。')
|
|
797
|
-
out.push('
|
|
986
|
+
out.push('下一步:① 用页面标题或术语原文重试(别用整句问话);② 换同义词 / 英文 / 缩写;③ mode:"list" 看这个库的命名习惯。')
|
|
987
|
+
out.push('三条都试过仍然没有,才可以说「笔记里没有这个主题」。')
|
|
798
988
|
}
|
|
799
989
|
return out.join('\n')
|
|
800
990
|
}
|
|
@@ -854,7 +1044,10 @@ function renderList(value) {
|
|
|
854
1044
|
if (value.scale) out.push(`规模:${value.scale}`)
|
|
855
1045
|
const rows = Array.isArray(value.rows) ? value.rows : []
|
|
856
1046
|
for (const row of rows) {
|
|
857
|
-
|
|
1047
|
+
// 和 search / page 一样把「多久以前」算出来:目录里最常被误读的就是一串裸日期,
|
|
1048
|
+
// 看不出哪页是上个月改的、哪页是两年前的。
|
|
1049
|
+
const updated = row.updated ? freshnessOf(row.updated) : ''
|
|
1050
|
+
const meta = [row.type, row.status, row.sources === null ? '' : `${row.sources} 源`, updated]
|
|
858
1051
|
.filter((part) => part !== '' && part !== null && part !== undefined)
|
|
859
1052
|
.join(' · ')
|
|
860
1053
|
out.push(`- ${row.name} ⟨${meta}⟩${row.summary ? ` ${row.summary}` : ''}`)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-wiki-notes",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.3.0",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"description": "Read-only Markdown knowledge-base retrieval for DeepSeek Harness: one wiki_recall tool (search/page/list/overview/lint/draft) returning the matching section's full text with page-level citations. 中文:本地 Markdown 笔记库检索插件,一次调用返回命中小节正文与出处,另带健康检查与回写骨架。",
|
|
6
6
|
"keywords": [
|
|
@@ -37,8 +37,9 @@
|
|
|
37
37
|
"node": ">=20.13.0"
|
|
38
38
|
},
|
|
39
39
|
"scripts": {
|
|
40
|
-
"test": "node tests/smoke.mjs && node tests/status.mjs && node tests/params.mjs && node tests/fields.mjs && node tests/lint.mjs && node tests/config.mjs && node tests/cli.mjs && node tests/api.mjs && node tests/topics.mjs && node tests/draft.mjs && node tests/watch.mjs && node tests/client.mjs",
|
|
41
|
-
"cli": "node bin/cli.mjs"
|
|
40
|
+
"test": "node tests/smoke.mjs && node tests/status.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/watch.mjs && node tests/client.mjs",
|
|
41
|
+
"cli": "node bin/cli.mjs",
|
|
42
|
+
"probe": "node tools/probe.mjs"
|
|
42
43
|
},
|
|
43
44
|
"peerDependencies": {
|
|
44
45
|
"@deepseek-ai/cordis": "^4.0.1",
|