dsh-knit 0.19.1 → 0.21.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 +372 -0
- package/README.en.md +150 -24
- package/README.md +122 -22
- package/SECURITY.md +4 -3
- package/package.json +3 -2
- package/src/client/client.js +1251 -92
- package/src/host/context.js +71 -7
- package/src/host/control.js +421 -0
- package/src/host/index.js +348 -19
- package/src/host/links.js +74 -24
- package/src/host/passage.js +408 -0
- package/src/host/relations.js +306 -0
- package/src/host/tool.js +200 -29
- package/test/client.test.mjs +1332 -23
- package/test/code-context.test.mjs +3 -1
- package/test/context/fixture.mjs +2 -5
- package/test/context-eval.test.mjs +5 -1
- package/test/context.test.mjs +32 -2
- package/test/control.test.mjs +324 -0
- package/test/deep-context.test.mjs +447 -0
- package/test/deep-corpus.mjs +110 -0
- package/test/deep-eval.test.mjs +90 -0
- package/test/deep-scale.test.mjs +64 -0
- package/test/eval/deep.mjs +322 -0
- package/test/eval/fixture.mjs +6 -9
- package/test/fixture.mjs +21 -1
- package/test/harness.mjs +69 -6
- package/test/host-http.test.mjs +107 -0
- package/test/host.test.mjs +2 -2
- package/test/i18n.test.mjs +12 -6
- package/test/icon.test.mjs +11 -8
- package/test/links.test.mjs +50 -0
- package/test/relations.test.mjs +360 -0
- package/test/tier1.test.mjs +2 -2
- package/test/tool.test.mjs +326 -19
package/CHANGELOG.md
CHANGED
|
@@ -3,6 +3,374 @@
|
|
|
3
3
|
本项目的重要变更都记在这里。格式参考 [Keep a Changelog](https://keepachangelog.com/),
|
|
4
4
|
版本号遵循[语义化版本](https://semver.org/lang/zh-CN/)。
|
|
5
5
|
|
|
6
|
+
## [0.21.0] - 2026-10-08
|
|
7
|
+
|
|
8
|
+
> **Relations & Context Control** —— **原 v0.21 与 原 v0.22 合并成一个版本**(用户 2026-10-08 拍板:
|
|
9
|
+
> 两件事在实现上是同一条链路上的前后两环,分两版只会让「关系」先当摆设)。这一版回答两个问题:
|
|
10
|
+
> **「这一篇为什么在这里?」** 与 **「我自己想留住 / 挡掉的那几篇呢?」**
|
|
11
|
+
> —— 前者给**有行号、能 grep 回原文**的关系证据(引用 / 导入 / 测试 / 文档),后者给**固定与排除**,
|
|
12
|
+
> 而且真的活过重启。
|
|
13
|
+
> 硬约束一条没松:**零模型 / 零网络 / 零新依赖 / 无构建步骤**。
|
|
14
|
+
> 两条边界是刻意的:关系**是投影,不是第二个排序阶段**(`rankByRelevance()` 一行未改);
|
|
15
|
+
> 不做调用图 / 依赖图 / 符号索引(没有 AST / LSP / Tree-sitter),Git provenance 推迟
|
|
16
|
+
> (每文件一次 `git log` 在 1000 文件规模上是秒级到十秒级,与 R1 门槛冲突)。
|
|
17
|
+
|
|
18
|
+
### 变化
|
|
19
|
+
|
|
20
|
+
- **新增 `src/host/relations.js`(零 I/O 的纯逻辑)**。只做四类**有证据**的关系,
|
|
21
|
+
数组顺序即截断优先级:`references`(Markdown 里引用了另一篇 Markdown)、
|
|
22
|
+
`documents`(Markdown 里写到了某个代码路径)、`imports`(代码里的 `import … from` / `require(…)`,
|
|
23
|
+
**逐行正则**,含行号)、`tests`(文件名约定上的测试与被测方,**唯一不带行号的一类** ——
|
|
24
|
+
证据是文件名这条可核验的路径事实,不是某一行文字,所以如实不给行号,而不是编一个)。
|
|
25
|
+
导出 `MAX_RELATIONS_PER_ITEM = 3` / `MAX_TOOL_RELATIONS_PER_ITEM = 2` / `RELATION_TYPES` /
|
|
26
|
+
`importsOf` / `resolveSpec` / `testsOf` / `buildRelationFacts` / `relationsOf` / `resetRelationCache`。
|
|
27
|
+
每条边**两端各登记一次**,`line` 属于**提及所在的那个文件**(`dir: 'in'` 时行号读的是对方那一篇)。
|
|
28
|
+
同一 `(type, dir, other)` 去重取最小行号;对端**不在本批候选集**里就不产生边(不硬凑)。
|
|
29
|
+
- **`src/host/links.js` 三处修改**:① 新增 `extractRefsWithLines()`(与 `extractRefs` **同一套正则、
|
|
30
|
+
同一套顺序**,只多给行号;`extractRefs` 现在是它 `.map()` 的结果,一处真源);② 引用目标放开到
|
|
31
|
+
「已索引的文件」(`{anyExt: true}`),**源仍然只有 Markdown** ——
|
|
32
|
+
`test/code-context.test.mjs` 里那条「代码只能被指向、不能当源」的守卫原意一个字没改;
|
|
33
|
+
③ **修掉一个既有缺陷**:引用图缓存的签名原本只是「篇数 + 最大 mtime + 是否截断」,
|
|
34
|
+
**不含候选集身份**,同一进程里连跑两个候选数相同、最大 mtime 落在同一文件的 query 会**串图**
|
|
35
|
+
(实测复现,第二个 query 的关系全落空)。现在签名是逐篇 `rel\u0000mtimeMs` 排序后的精确键,
|
|
36
|
+
不用哈希(碰撞会让关系静默错配),`test/links.test.mjs` 有回归用例。
|
|
37
|
+
- **`src/host/context.js`:`provenance` 三值**(`retrieval` / `relation` / `manual`)。
|
|
38
|
+
⚠️ 字段名**不叫 `source`** —— `source` 从 v0.14 起指的是**文件角色**
|
|
39
|
+
(`impl` / `test` / `config` / `design` / `doc`),两者同时出现在一条记录上,不能混。
|
|
40
|
+
三条既有断言(`test/context.test.mjs` / `test/context-eval.test.mjs` / `test/code-context.test.mjs`)
|
|
41
|
+
已按新键加强。包内条目还会带 `relations`(最多 3 条)与 `relationsTotal`(真实总数);
|
|
42
|
+
**没有关系、也没被截断时这两个键根本不出现**(空数组是纯噪音,9 条要白花一百多字节)。
|
|
43
|
+
- **`src/host/index.js`**:`buildContextFor()` 组装完包后投影关系,并多一个
|
|
44
|
+
`withRelations: false` 开关 —— 它唯一的用途是让「关系不改变任何一层的成员与顺序」这条
|
|
45
|
+
可以被**同一次调用**直接证伪(`test/relations.test.mjs` 的端到端守卫就这么写的)。
|
|
46
|
+
新路由 **`POST /knit/api/control`**(`{action, rel}`,四个动作 `pin` / `unpin` / `exclude` / `restore`)
|
|
47
|
+
是**唯一的写通道**;排除在检索之前生效(`stats.controlSkipped`),固定是排名的下游
|
|
48
|
+
(`applyPinOverride()`:从三层移出、进 `pinned` 区、`provenance: 'manual'`,**零新 I/O**)。
|
|
49
|
+
`/api/recent` 另外回报 `control = {pinned, excluded, skipped, persisted}`,
|
|
50
|
+
其中每个被排除项带 `exists`(「这篇现在还在工作区里吗」——「恢复」按钮只在它真可能回来时给)。
|
|
51
|
+
- **新增 `src/host/control.js`(纯逻辑 + 可选持久化,不 import 任何官方包)**。
|
|
52
|
+
`ctx.storage` 拿得到就用 `kv` 落盘(`unit: knit_control`,表 `pinned` / `excluded`,
|
|
53
|
+
`layout: 'single'`、键 = `` `${root}\u0000${rel}` ``,按工作区隔离),拿不到就退化成内存态。
|
|
54
|
+
写路径**只写差量**,且**串行**。
|
|
55
|
+
- 两条真机缺陷在这一版修掉(都是**先取证再改**):① 插件被重复加载时,每次加载都会新建一份
|
|
56
|
+
登记表,而存储单元「一个进程只有一个活句柄」,于是被模块级变量留下的**最后一个**实例恰好是
|
|
57
|
+
打不开存储的那个 ⇒ 共享那份登记表挂在**后端对象**上(`Symbol.for('dsh-knit.control')`),
|
|
58
|
+
同一进程里的后续加载直接复用;② `persisted` 原本在拿到 `kv` 的那一刻就报 `true`
|
|
59
|
+
(报的是**能力**,不是**结果**),现在**证据到之前一律 `false`**:读成功、或这一次写真的成功,
|
|
60
|
+
才转 `true`;写失败在**同一次响应**里就说出来。面板因此可以诚实地写「本会话有效(未持久化)」。
|
|
61
|
+
- **`src/host/tool.js`:`knit_docs` 每个条目最多 2 条关系**(`relations` / `relationsTotal` 进 schema,
|
|
62
|
+
`provenance` 进 `required`),渲染成一行 `relations: references ← docs/x.md:12; imports → src/y.js:3`
|
|
63
|
+
(`←` = 对方提到本条目,`→` = 本条目提到对方;`tests` 不带行号)。**只给事实,不写理由文案** ——
|
|
64
|
+
理由由既有的 `Why:` 行承担。被固定的条目出现在 `pinned` 分区且 `provenance: manual`;
|
|
65
|
+
被排除的条目**完全不出现**。
|
|
66
|
+
- **面板(`src/client/client.js`)**:相关模式的每一行有一个**弱化的来源词**(`检索` / `关系` / `用户固定`,
|
|
67
|
+
只有这三个词,没有分数没有百分比);**2026-10-09 布局改造**:标题行只留「序号 · 标记 · 标题 · 时间」,
|
|
68
|
+
来源词与 `固定` / `排除` 一起搬到**证据行右端**,顺序 `固定 → 排除 → 检索`,**默认 `visibility:hidden`**
|
|
69
|
+
(鼠标悬停该项 / 键盘光标 / 焦点进入才显形 —— 用 `visibility` 而不是 `opacity:0`,隐藏时**真的退出键盘焦点序**,
|
|
70
|
+
且不占额外高度、不引起横向跳动),证据文本留在左边、过长可截断而操作永不被挤掉;
|
|
71
|
+
**没有命中段也没有理由的条目仍留一条只含右侧操作的空行**(不写占位文字);三个入口都是纯文字按钮、无图标;
|
|
72
|
+
**同日按体验反馈**:三个入口的字号提到与命中段同级(10px → 11px;行高仍由证据行决定,不增高),
|
|
73
|
+
悬停热区左右各加 4px(用等量负外边距把宽度收回 ⇒ 行的宽度与词间距都不变);
|
|
74
|
+
**同日工具栏重排(2026-10-09 第二条规格)**:`相关 / 最新`(排序)|一根浅灰竖线|
|
|
75
|
+
`文档 / 代码 / 媒体 / 全部`(类型)|搜索框靠最右且宽度自适应 —— 类型组从独立一行搬进工具栏
|
|
76
|
+
(`.knit-types` 不再自带左右内边距),`.knit-filter` 用 `flex:1 1 180px` + `max-width:240px`
|
|
77
|
+
+ `min-width:0`(常规面板 180–240px、封顶后靠 `margin-left:auto` 贴右、面板窄了先缩它),
|
|
78
|
+
两组都是 `flex:none` ⇒ **前面的按钮永不被挤**;六个选项彼此独立(切类型不动排序与搜索词,反之亦然);
|
|
79
|
+
「为什么」展开**行级证据**(最多 3 条,
|
|
80
|
+
每条 = 类型标签 + 对方文件 + 第 N 行 + 打开,点开就地预览到那一行;超过 3 条如实写「共 N 条关系」);
|
|
81
|
+
被排除项消失并在上方留一行弱化说明 + 「恢复」;头部一条**检索状态摘要** ——
|
|
82
|
+
**单行、三组、竖线分隔**:`收集 N · 排除 N · 候选 N | BM25 词法检索 · 关系 N 条 · 固定 N | 入包 N`
|
|
83
|
+
(工作区候选 → 检索与调整 → 最终结果;组内中点、组间一根细竖线,**一个箭头都没有** —— 原来那串
|
|
84
|
+
`↓` / `→` 把一条**已经完成**的管线画成了流程图,2026-10-09 用户裁定删除;那个没有名字的光数字
|
|
85
|
+
「→ N」现在叫「候选 N」)。**每一格都是已经发生的事实**,口径逐格钉在守卫里;
|
|
86
|
+
没有图标 / 胶囊 / 色块 / 装饰边框,也**不承担任何交互**(它只负责展示信息)。
|
|
87
|
+
**同日第三条反馈(2026-10-09)**:这一行**紧贴工具栏**、**位置不随开关变** —— 观察层(「使用情况」)
|
|
88
|
+
从摘要上面挪到它的下面,渲染顺序固定为 工具栏 → 状态摘要 → 排除说明 → 通知 → 观察层 → 列表
|
|
89
|
+
(守卫钉着「开关前后摘要的位置一模一样」)。
|
|
90
|
+
**同日第四条反馈(2026-10-09)**:头部那格计数**只留阿拉伯数字**(`9` / 过滤时 `3 / 79`)——
|
|
91
|
+
量词本来随档位变(文档「篇」/ 代码「个代码文件」/ 媒体「个媒体」/ 混排「项」),
|
|
92
|
+
同一位置换个档就换一种中文 ⇒ 整句降级到 `title`(悬停仍读得到「9 个代码文件」),
|
|
93
|
+
`count` / `count.code…` 八条词条照旧在用。
|
|
94
|
+
**同日第五条反馈(2026-10-09)**:点开「检索」长出来的行级证据原来是**压在下一行上面**的 ——
|
|
95
|
+
DocRow 的入场补间用 `fill:'both'`,播完之后**仍然**按入场那一刻量到的高度钉着这一行
|
|
96
|
+
(`el.style.height=''` 清不掉补间效果),于是证据不把下面的行挤下去、而是溢出到它上面;
|
|
97
|
+
现在收尾统一走 `settleEnterAnim(el, anim)`:先 `cancel()` 注销补间、再清那两行内联样式。
|
|
98
|
+
守卫 = `test/client.test.mjs` 的「行级证据是向下延展」那条(替身没有 DOM ⇒ 喂纯对象 + 钉住调用点)。
|
|
99
|
+
**固定不是排序干预**:固定区不编号,三层 `01…0N` 的编号一个都不变。
|
|
100
|
+
- **打包修复(即 v0.20.1 的内容,已在本版树里)**:语料工厂搬进 `test/deep-corpus.mjs`,
|
|
101
|
+
`tools/deep-benchmark.mjs` 变成 CLI 外壳 —— 因为 `tools/` **不在 `package.json` 的 `files` 白名单**里,
|
|
102
|
+
registry 上那份 tarball 里 `npm test` 是 638 pass / 1 fail(3 条 R1 规模门槛用例)。
|
|
103
|
+
**不变式保住了:`tools/` 仍然不进包**。新增 **`tools/clean-room-test.mjs`**:真打 `npm pack` →
|
|
104
|
+
解包到临时目录 → 断言 `package/tools/` 只有白名单那两个文件 → 在解包目录里跑 `npm test` ⇒
|
|
105
|
+
非全绿就非零退出。它是**发版前**闸门(v0.20.0 的清单只在发完之后查,太晚)。
|
|
106
|
+
⚠️ 它必须带 `--cache`,否则会撞 `~/.npm/_cacache/tmp` 的权限(那个目录属于 root)。
|
|
107
|
+
|
|
108
|
+
### 实测
|
|
109
|
+
|
|
110
|
+
- `cd knit && npm test` → **697/697**(28 个测试文件;v0.20.0 的 641 条**一条未删、未放宽、未 skip**,
|
|
111
|
+
v0.21 净增 56 条:关系 / 控制 / 跨面 + 布局与动效收尾守卫)。
|
|
112
|
+
- `node tools/clean-room-test.mjs` → `dsh-knit-0.21.0.tgz` · 56 个文件 · 解包目录 **697 pass / 0 fail** ⇒ exit 0
|
|
113
|
+
(版本号改成 `0.21.0` 当天复跑;改名之前那次是 `dsh-knit-0.20.0.tgz`,文件数与结论相同)。
|
|
114
|
+
- 关系投影的载荷(按 `{type, dir, other, line}` 四字段序列化):**≈252 B/项**
|
|
115
|
+
(两组真实任务各 9 项、合计 4539 B 关系投影);面板总载荷实测 **7857 B / 9 项**(门槛 16000 B)。
|
|
116
|
+
- 真机(`curl` 打运行中的 DSH,工作区 `08_Knit`):三层逐条 `provenance: retrieval` 且
|
|
117
|
+
`relations` 恰好 3 条(`relationsTotal` 实测 11 / 7 / 24 / 22 / 33 / 66 / 12 / 18 / 8,截断说明里的数字是真的);
|
|
118
|
+
固定 `README.md` ⇒ 包里多出 `pinned` 分区、`provenance: manual`、原层里消失;
|
|
119
|
+
排除 `03_发布/真机验收清单.md` ⇒ `skipped: 1`、被排除项**不出现**、`excluded[].exists: true`;
|
|
120
|
+
**重启 DSH 后读回**:`persisted: true`,介质 `~/.dsh/storages/knit_control.json`(475 B,按工作区隔离)。
|
|
121
|
+
- `src/host/tool.js` 与面板**同源**:同一条任务下,面板每项关系的前 2 条与工具侧逐字相同
|
|
122
|
+
(`test/tool.test.mjs` 的跨面守卫,把工具里的截断拿掉即变红)。
|
|
123
|
+
|
|
124
|
+
## [0.20.0] - 2026-10-07
|
|
125
|
+
|
|
126
|
+
> **Deep Context Retrieval**。核心体验从「任务 → 相关文件」升级为
|
|
127
|
+
> 「**任务 → 相关文件 → 相关内容片段**」—— Find the file. Then find the part that matters.
|
|
128
|
+
> 在这之前,每一篇只有**正文前 2500 字**参与打分,所以「那一段在 5000 字之后」就等于
|
|
129
|
+
> 「搜不到」,而 `knit_docs` 只能诚实地告诉模型「用 grep 去更深处找」。
|
|
130
|
+
> 关键约束:**没有 embedding / 向量库 / LLM / 网络请求 / AST / LSP / Tree-sitter /
|
|
131
|
+
> 代码知识图谱、没有第二个栏位、没有 Dashboard、没有新的 preview framework。**
|
|
132
|
+
> 文件仍然是 Context Pack 的**基本实体** —— 这不是把 Knit 改成一个纯片段搜索工具。
|
|
133
|
+
|
|
134
|
+
### 变化
|
|
135
|
+
|
|
136
|
+
- **取消「每篇只看前 2500 字」**(删掉 `HAYSTACK_CHARS`)。文档与代码的 `body` / `hayBody`
|
|
137
|
+
现在都是**整篇**转小写,上限仍是单文件 `MAX_BODY_BYTES = 256 KB`。
|
|
138
|
+
一个容易忽略的事实:宿主**本来就把整篇读进内存**(`readFile` 之后才 `subarray`),
|
|
139
|
+
所以这一版新增的磁盘 I/O 约等于 0,代价是幂等副本的内存(约 2× 正文,见「已知限制」)。
|
|
140
|
+
- **新增 `src/host/passage.js`(零依赖、纯字符串、无 AST)**。切分是**结构优先 + 长度兜底**:
|
|
141
|
+
Markdown 按 H1/H2/H3 / 段落 / 代码块,代码按 `function` `class` `const` `let` `var`
|
|
142
|
+
`interface` `type` `export` `import` 声明起点与大括号块;行号与字符偏移量由构造过程保证
|
|
143
|
+
(不是事后 `indexOf` 猜的)。导出 `chunkText()` / `snippetOf()` / `passageMatchesFor()` /
|
|
144
|
+
`windowTf()` / `passageTfOf()` 与 `PASSAGE_WINDOW = 24` / `PASSAGE_MAX_PER_FILE = 2` /
|
|
145
|
+
`SNIPPET_CHARS = 200` / `PASSAGE_MAX_CHARS = 1200`。
|
|
146
|
+
- **文件排序与片段排序分开**(需求 §8)。既有 `rankByRelevance()` 一行未改:先按文件排名,
|
|
147
|
+
再在每篇内部挑片段(命中词种数优先、其次窗口字频、最后行号升序),每篇最多 2 段、
|
|
148
|
+
段与段不重叠;「20 个低价值片段堆高分」这条被 `PASSAGE_MAX_PER_FILE` 与窗口内字频同时挡住。
|
|
149
|
+
- **长文件污染不再因为全文检索复活**(需求 §9)。`context.js` 的 `isDocHit` 闸门改用
|
|
150
|
+
**片段窗口内的字频**(`windowTf`,默认窗口 = `PASSAGE_MAX_CHARS`)而不是整篇字频 ——
|
|
151
|
+
否则 29000 字的 CHANGELOG 会对**每一个**任务都满足「这一篇在讲它」而挤进每条任务的 Supporting。
|
|
152
|
+
没有片段数据时(老宿主、`test/context*/fixture.mjs` 的合成记录)逐字退回 v0.19 的整篇口径,
|
|
153
|
+
因此 `test/eval.test.mjs` 与 `test/context-eval.test.mjs` 的基线**一条都没改**。
|
|
154
|
+
- **`knit_docs` 给出「文件 + 理由 + 最相关片段 + 行号」**(需求 §15/§11)。每项可选带
|
|
155
|
+
`matches: [{startLine, endLine, startOffset, endOffset, terms, snippet}]`;渲染成
|
|
156
|
+
`match: lines 147–163 — …`。**只渲染一段**:R2 实测两段 = v0.19 的 1.71×,超过实现说明
|
|
157
|
+
定的 1.4×,按那条规则砍到一段(同一语料 1.04×,最坏语料 1.36×)。诚实性文案改成
|
|
158
|
+
「Every document and code file was searched in full (files over 256 KB are indexed only up
|
|
159
|
+
to that size); images and videos have no searchable text.」—— 不再提 `2500 characters`
|
|
160
|
+
和 `use grep`。顺带拿掉 v0.19 里「每返回一条就 `readDocument()` 读一遍整篇」的 I/O。
|
|
161
|
+
- **面板多一行 metadata:「命中段 147–163」**(需求 §12 + 2026-10-07 用户裁决)。它是一个
|
|
162
|
+
**长得像文字的 button**(无图标、**无描边** —— 选中 / 聚焦都不画环,键盘焦点靠与 hover
|
|
163
|
+
同款的下划线;**有一个灰底**:`--knit-chip-bg` + 6px 圆角(胶囊感)、1px 6px 内边距,两个主题各一套值,
|
|
164
|
+
比行选中那档深一点,免得它在被选中的行里消失),点它走**既有**的就地预览。**点整行也一样**:行点击与
|
|
165
|
+
「点那行字」都带上篇内第一段命中(用户原话「我在点击这个文档或者是代码块的时候,就进入一个
|
|
166
|
+
预览,那能不能直接定位到这几段呢?这样的交互非常丝滑」)。代码文件会定位到命中行,命中区域画
|
|
167
|
+
一条中性灰横带(`.knit-code-hit`,`position:absolute` + `pointer-events:none` + **`opacity:.5`**
|
|
168
|
+
—— 用户要求「背景太深了,再减少一半」;不写死颜色、用 `--knit-active-bg` 回落),滚动用的仍是
|
|
169
|
+
既有那一个 `.knit-preview-body`。文案从「命中片段」缩到**「命中段」**(EN `Passage:`),并且与
|
|
170
|
+
v0.14 的「直接命中」**合成同一条 metadata 行**(`.knit-subrow`:命中段在左、中间一条 1px 中性
|
|
171
|
+
竖线、理由在右)—— 于是这一版**没有让每一行变高**。没有分数、没有百分比、没有置信度、
|
|
172
|
+
没有「AI 分析」—— 只展示可验证的行号区间。**2026-10-07 用户裁决(标点)**:中文去掉全角冒号
|
|
173
|
+
(`命中段 147–163 | 直接命中 knit · border`)—— 全角冒号占一个整字宽 + 强制停顿,而这一行是两个
|
|
174
|
+
标签并排;整族 6 个理由标签一起改,否则标点会随理由类型跳。**冒号只在引出列表时保留**,**英文保留
|
|
175
|
+
ASCII 冒号**(半个字宽,且 `direct match knit` 读起来像在说 match 这个词)。
|
|
176
|
+
- **Markdown 预览也跳到命中段**(2026-10-07 用户裁决:「文档这边也参考代码块一样,选中文档以后进入详情,
|
|
177
|
+
要指定到段落」)。`.md` 没有行号 ⇒ 不走行锚点,走**文本锚点**:从片段原文的 `[startOffset, endOffset)`
|
|
178
|
+
里按行取 1–4 根「针」(长度 ≥12、≤40;去掉行首 `#` / `>` / 列表符,`[文字](地址)` 只留文字,
|
|
179
|
+
`*` / `~` / 反引号去掉,**下划线只在成对强调处删**以保住 `snake_case`,空白折叠),再把渲染后的
|
|
180
|
+
文本节点接成一根带下标映射的串去 `indexOf`,找到就滚 `.knit-preview-body` 并给那一块一次 1.2s 的淡底
|
|
181
|
+
(`.knit-md-body .knit-doc-hit`,与 Coverage 那层同一档灰、同一个 `FLASH_MS`);**找不到就什么都不做**
|
|
182
|
+
(宁可不动,也不假装动了 —— 需求 §26)。两处都是真机实测后才对的:① DSH 的**行内 `code` 是
|
|
183
|
+
`inline-block`** —— 不把它算作行内,淡底会画在那一小片片上,所以 `DOC_INLINE_DISPLAY` 里补上
|
|
184
|
+
`inline-block / inline-flex / inline-grid / ruby`,落到所在的段落 / 列表项;② 同一根针在长文档里出现
|
|
185
|
+
几十次是常态,`docPickOffset()` 先**独特的那根针优先**、同档再按 `startOffset / 全文长度` 挑
|
|
186
|
+
**离锚点最近的那一次**(否则 `indexOf` 永远跳去全篇最早那次 —— 实测 CHANGELOG 就跳去了第 11 行的
|
|
187
|
+
同名行内 code 而不是第 36 行)。渲染仍是 DSH 的 `MarkdownText`(`DocPane` 只包一层,**不自己渲染
|
|
188
|
+
Markdown**);正文走**显式 `body` prop** 而不是 children(测试替身展开函数组件时只传 props)。
|
|
189
|
+
- **修一处在真机截图上发现的缺陷:Context Pack 的三层行不显示「命中片段」**(2026-10-07 验收时发现)。
|
|
190
|
+
宿主给三层条目的投影只有 `rel / title / summary / mtimeMs / kind / source / reason` 七个键
|
|
191
|
+
(`context.js`),**没有 `matches`** —— 于是 Primary / Supporting / Related 这九行(恰恰是最该给
|
|
192
|
+
片段的那几行)一条片段行都没渲染,只有「其他相关文档」区(取自 `docs`)有。修法是客户端按 `rel`
|
|
193
|
+
从 `visibleDocs` 取回 `matches`(`docs` 里本来就有这份数据 ⇒ **载荷零增长**;没有改成让宿主补键,
|
|
194
|
+
因为面板载荷已经吃掉 16 KB 预算的大部分)。新增守卫
|
|
195
|
+
`test/client.test.mjs`「v0.20 命中片段:三层(Primary/Supporting/Related)的行也要有片段行」——
|
|
196
|
+
把修法拿掉即变红(`README 在三层里,也必须有片段行`)。
|
|
197
|
+
|
|
198
|
+
|
|
199
|
+
- **暗色模式:把列表里最高那一档的白降下来,并全部改回 DSH 官方令牌**(2026-10-07 用户:
|
|
200
|
+
「暗色模式下高亮那个色值是不是纯白色……太亮了,就是太白了,看得有点犯晕」)。属实:命中段的底
|
|
201
|
+
原本是**纯白 13%**(`--knit-chip-bg`),是三档里最高的一档,而且那个 13% 是我们自己拍的数 ——
|
|
202
|
+
DSH 官方的 `--dsw-alias-interactive-bg-active` 在暗色下只有 `#ffffff24` = 14.12%(值取自
|
|
203
|
+
`dsh-client-ui-theme/lib/client.js`)。现在三档一律「官方透明度 × 固定比例」,且**暗色三个比例
|
|
204
|
+
比浅色各低 10%**:hover `7.84%×0.36`、active `14.12%×0.54`、chip `14.12%×0.81`(浅色比例是
|
|
205
|
+
`0.41` / `0.60` / `0.90`,暗色这组 = 浅色 ×0.9;**浅色的三个值一个字没动**)。顺手修掉两处「自己造一套」:
|
|
206
|
+
① 代码里有 6 处引用 `--dsw-alias-text-primary/secondary/tertiary` —— **DSH 全库零定义**(逐文件核实),
|
|
207
|
+
等于一直在静默失效:`color` 取到 unset ⇒ 命中段那一格的 hover 变色其实从来没生效过;已全部改回
|
|
208
|
+
官方 `--dsw-alias-label-primary/secondary/tertiary`,并补上官方浅色值作 fallback。
|
|
209
|
+
② 图标原来写死 `#000` / `#fff`:暗色的 `#fff` 比 DSH 自己的主文本色 `#f9fafb` 还亮,现在走
|
|
210
|
+
`--dsw-alias-label-primary`(令牌自己随主题切,那条 `body[data-ds-dark-theme] .knit-icon` 覆盖规则
|
|
211
|
+
因此删掉)。守卫:`test/client.test.mjs` 的灰底用例改成断言三档 + 「命中段必须比行选中更深」
|
|
212
|
+
+ 「不得亮过官方 active 14.12%」+「不许出现 `--dsw-alias-text-`」;`test/icon.test.mjs` 改成断言
|
|
213
|
+
官方令牌 + 不许再写死黑白。**测试数不变(635)**,是替换断言而不是加用例。
|
|
214
|
+
|
|
215
|
+
- **代码预览:语法高亮(2026-10-07 用户新增需求)**。用户原话:「我们现在在暗色模式下它是白色,
|
|
216
|
+
对于一个阅读代码的用户来说,它的可读性太低了;那在浅色模式下它也是一种黑色……你看这块要怎么治理一下?」
|
|
217
|
+
治理方式**不是自己配色**,而是**接 DSH 官方那一套**:
|
|
218
|
+
① 复用客户端**本来就在 require** 的 `@deepseek-ai/dsh-client-ui-primitives` 里的
|
|
219
|
+
`useCodeHighlighter(language)`(与 `MarkdownText` 同一个包 ⇒ **零新依赖、零新 specifier**);
|
|
220
|
+
② 语言标识**只认宿主分类层**给的 `language`(`classifyFile()` 的结论)—— 客户端自己不建第二张后缀表;
|
|
221
|
+
③ 颜色**只来自 `--shiki-*`**(定义在 `dsh-client-ui-theme`:`--shiki-token-keyword` 浅 `#d6336c` /
|
|
222
|
+
暗 `#faa2c1`、`comment` `#868e96` / `#adb5bd`、`string` `#2f9e44` / `#69db7c`……)⇒ 深浅两个主题
|
|
223
|
+
各自吃到官方调色板,不必为任何一个主题写死色值(这正是上面那条暗色治理的反面教材);
|
|
224
|
+
④ 拿不到高亮器(旧版 DSH / 包缺失)时**静默回落纯文本**,不报错、不空白。
|
|
225
|
+
**性能**:官方高亮器是同步的 shiki JS 引擎,真机实测约 170–560 ms / 千行 —— 4000 行的文件
|
|
226
|
+
(v0.19.1 基线 117 ms 打开)要 **1.3–2.2 s**,回车点开会白等一秒多。当天先收到「只上色前
|
|
227
|
+
800 行」,用户仍反馈「加载还是有点慢」,于是**再收一次**(用户原话:「要不代码模块我们换一个方案,
|
|
228
|
+
就是命中段才有颜色,不命中的段就不用上颜色,还是用原来的,浅色模式下用黑色,暗色模式下用白色
|
|
229
|
+
就可以了。我觉得这样可能就简单了。因为我刚刚去看了一下,加载还是有点慢,800 行也是很慢」):
|
|
230
|
+
上色范围 = **命中段前后各 `CODE_HL_PAD = 60` 行**,硬上限 `CODE_HL_MAX_LINES = 800`
|
|
231
|
+
(命中段本身可能几百行);**没有命中段(载荷里没有 `matches`)就一个 token 都不上色**,其余行
|
|
232
|
+
保持默认正文色(浅色黑 / 暗色白,跟随主题令牌);窗口之上 / 之下的行各是**一个**纯文本节点
|
|
233
|
+
(截断的是颜色,不是内容)。真机实测(同一浏览器会话连开 8 篇):`client.js`(4000 行)
|
|
234
|
+
**1496 → 424 ms**、`client.test.mjs`(4000 行)**2226 → 193 ms**,8 篇合计约 **5.9 s → 1.3 s**。
|
|
235
|
+
⚠️ 已知代价:窗口从半截注释 / 字符串中间开始时缺分词上下文,那一段可能**错色**(命中横带仍精确
|
|
236
|
+
标出行)。⚠️ 试过并**否决**「用
|
|
237
|
+
`useEffect` + `setTimeout(0)` 让出一帧、颜色随后补」:真机反而更慢(首个文本 3605 ms、颜色 3614 ms,
|
|
238
|
+
基线是同步版 1458 ms)—— `setTimeout(0)` 的回调在下一次绘制**之前**就跑掉了,纯文本那一帧从未
|
|
239
|
+
真正画出来,还多付了一次「文本节点 → 19782 个 span」的替换提交。
|
|
240
|
+
**渲染形状**:正文仍是**一个** `<pre>`,行间只隔一个 `'
|
|
241
|
+
'` 文本节点、**不包逐行元素** ——
|
|
242
|
+
行锚点(v0.20 §13)靠 `pre.scrollHeight / 行数` 量行高,逐行元素会把这个几何改掉;
|
|
243
|
+
窗口之外的头 / 尾也各是**一个**纯文本节点。高亮器返回的行数与正文对不上时一律退回纯文本
|
|
244
|
+
(宁可没颜色,也不能让颜色落在错误的代码上)。`useMemo` 记忆化,滚动 / 悬停 / 5 s 轮询的重渲染不重算。
|
|
245
|
+
测试 **+4(635 → 639)**:`test/client.test.mjs` 新增「逐 token 上色、颜色只来自 `--shiki-*`」
|
|
246
|
+
「宿主没导出高亮器时回落纯文本」「只给命中段前后各 60 行上色、窗口被 `CODE_HL_MAX_LINES` 截住」
|
|
247
|
+
「没有命中段就一个 token 都不上色」;`test/harness.mjs` 的假高亮器同时记录收到的**语言**与**正文**。
|
|
248
|
+
真机实测(Playwright,浅/暗两主题):颜色集合 = `--shiki-token-keyword/-comment/-string/-constant/
|
|
249
|
+
-function/-punctuation` + `--shiki-foreground`;命中横带几何、锚点滚动、横向滚动都没被 token 化破坏。
|
|
250
|
+
|
|
251
|
+
- **交互性能治理(2026-10-07,用户报「点击选中文档 / 代码都很卡、切换标签也卡顿」)**。先测后改:
|
|
252
|
+
宿主**不慢**(`/api/recent` 59–104 ms、`/api/context` 58 ms;R1 规模基准 1000 文件 cold 157 ms /
|
|
253
|
+
warm 21 ms,两条门槛都 PASS),慢在客户端四处:① **语法高亮每次重付**(`CodePane` 的 `useMemo`
|
|
254
|
+
只活在挂载期,切换类型档会卸载预览)⇒ 加**按文件缓存**(`CODE_HL_CACHE`,LRU 8 篇,键 =
|
|
255
|
+
`rel` + 窗口范围);② **FLIP 每次提交把整屏行全量量一遍**(`applyRowFlips` 的 `settled` 判据只看
|
|
256
|
+
视图签名)⇒ 加**行签名短路**(`rowSig` = 窗口尺寸 + 每行 `rel` / `tierKey` / `matches` 数 / mtime,
|
|
257
|
+
签名不变就复用上次的布局点、一行都不量);③ **每 5 s 轮询无条件 `setState` 一个新对象** ⇒
|
|
258
|
+
载荷签名与上次相同就**返回同一个 state 对象**(真 React 靠 `Object.is` 跳过整棵子树重渲染),
|
|
259
|
+
时间戳也改成渲染时刻取钟、不再为它重建 state;④ 行高 layout effect **先量后判** ⇒ 改成不补间就
|
|
260
|
+
提前返回(「别白量」:一屏挂着上万个 token span 时白量一次 ≈ 0.25 s @4× 节流)。
|
|
261
|
+
**改前 / 改后**(4× CPU 节流 + Retina,同一套脚本):切换类型档阻塞 **118 → 0–69 ms**、
|
|
262
|
+
点文档行阻塞 **415 → 172 ms**、同一篇代码关掉再开阻塞 **1390 → 261 ms**(CDP Profiler 里
|
|
263
|
+
`findNextMatchSync` = shiki 分词**从热点中消失**)、点代码行首开仍重(**2728 → 2217 ms**,剩下的是
|
|
264
|
+
第一次冷分词,第二次起走缓存)。测试 **+2(639 → 641)**:「同一篇代码收起再打开不再重新分词
|
|
265
|
+
(按文件缓存)」「载荷一字没变时,轮询不再落状态」—— 两条都**放过一次 bug**:把缓存 / 去重绕过
|
|
266
|
+
立刻变红(`actual 17 vs 11` / `actual 2 vs 1`)。⚠️ `test/harness.mjs` 的 `reset()` 补了
|
|
267
|
+
`timers.clear()` 与 `stateWrites()`:轮询链会自己续命、替身又从不跑 effect cleanup,上一个用例的
|
|
268
|
+
链会污染下一个用例的 hook 槽位(`v0.18 Coverage flash` 那条用例因此补了一次 `await harness.flush()`,
|
|
269
|
+
断言一个字没改)。
|
|
270
|
+
|
|
271
|
+
### 测试
|
|
272
|
+
|
|
273
|
+
- `npm test`:**641 / 641 通过**(v0.19.1 是 588;26 个测试文件)。
|
|
274
|
+
- **新增 `test/deep-context.test.mjs`(17 条)**:需求 §21 点名的 12 个用例逐条对应 + §17 的
|
|
275
|
+
媒体反例 + `windowTf` 单元 + 长归档分层集成 + **R2 面板预算**(≤24 篇带片段、每篇 ≤2 段、
|
|
276
|
+
片段 ≤`SNIPPET_CHARS`+8、载荷增量 ≤ 实测上界 16 KB / 每篇 700 B)。
|
|
277
|
+
- **新增 `test/deep-eval.test.mjs`(4 条)** 与 `test/eval/deep.mjs`(四指标的唯一定义处)。
|
|
278
|
+
- **新增 `test/deep-scale.test.mjs`(3 条)**:1000 文件规模的硬门槛与确定性。
|
|
279
|
+
- `test/client.test.mjs` **+17**(127 → 144):命中片段的渲染与点击、代码行锚点几何、样式纪律、i18n 键、
|
|
280
|
+
「媒体卡片即使被塞上 `matches` 也不渲染」,以及两条 2026-10-07 的裁决守卫:
|
|
281
|
+
**三层行也要有片段行**(`README 在三层里,也必须有片段行` —— 把客户端的 `withHits` 拿掉即红)、
|
|
282
|
+
**两条 metadata 合成一条**(`.knit-subrow` 存在、命中段在「正文命中」之前、有且只有一条 1px 竖线)、
|
|
283
|
+
**点整行带锚点**(行为断言 + `previewFor(doc, firstMatchOf(doc))` 源码守卫 —— 测试替身没有真实
|
|
284
|
+
布局,横带量不到行高,所以这条按 `AGENTS.md` §8.2 走「守代码形状 + 人眼」)。样式守卫同时钉住
|
|
285
|
+
`outline:none`(不再有白描边)、横带 `opacity:.5`、竖线是 1px 且不是虚线 / 渐变。
|
|
286
|
+
其中 **6 条是 Markdown 文本锚点**:归一化口径(`snake_case` 不许被当成强调)、取针(跳太短的行 /
|
|
287
|
+
去重 / 上限 / 越界不许闭眼切)、`docPickOffset`(重复的针按位置比例挑、独特的针优先、空正文返回 -1)、
|
|
288
|
+
`DocPane` 只包一层且没有 DOM 时不抛、接线守卫(`ratio` 一路传下去、`inline-block` 必须算行内)、
|
|
289
|
+
样式纪律(`transition` 在基础选择器上、时长 == `FLASH_MS`、不画边框)。
|
|
290
|
+
- `test/tool.test.mjs` +3:R2 预算守卫、镜像常量守卫(工具说的 256 KB 必须等于宿主真读的
|
|
291
|
+
`MAX_BODY_BYTES`,工具的 `SNIPPET_CHARS` 必须等于评分侧的)、**跨面集成守卫**(需求 §15:
|
|
292
|
+
同一条任务下 `knit_docs` 的 `matches` 行号必须与面板载荷 `docs[].matches` 逐条一致 ——
|
|
293
|
+
两侧各有自己的补偿路径〔面板靠客户端按 `rel` 取回、工具靠 `tool.js` 的 `matchesByRel`〕,
|
|
294
|
+
单面测试**各自都是绿的**,只有这条能抓住它们漂移)。
|
|
295
|
+
- **v0.19 的既有基线一条没改**(需求 §22):`test/eval.test.mjs` 与
|
|
296
|
+
`test/context-eval.test.mjs` 的断言、夹具与阈值全部原样通过。
|
|
297
|
+
|
|
298
|
+
### 改动量
|
|
299
|
+
|
|
300
|
+
- **26 个功能文件 = 20 改 + 6 新增**(另有 2 个不进包的开发文件:`tools/agents-budget.mjs`、`knit/AGENTS.md`;
|
|
301
|
+
发布提交合计 **33 处改动 = 25 改 + 8 新增** —— 多出来的 5 处是仓库侧的演示资产:`docs/README.md`
|
|
302
|
+
与重拍的四张图 `docs/screenshot.png` / `screenshot-media.png` / `screenshot-all.png` / `demo-reorder.gif`)。
|
|
303
|
+
仓库根就是 `knit/`;`git diff --shortstat` = `25 files changed, 2507 insertions(+), 218 deletions(-)`,
|
|
304
|
+
不含 8 个新文件。
|
|
305
|
+
> 2026-10-08 仓库侧又补了两轮**不进包**的改动:① **指令上下文治理**(`tools/agents-budget.mjs` 加
|
|
306
|
+
> `--claims` / `--strict` / 每层 sha256 指纹,常驻层改成触发词路由并净减 302 B,裁决记在
|
|
307
|
+
> `Knit-决策记录.md`);② 按 v0.20 界面**重拍四张演示图**(`docs/` 不在 `files` 白名单里,它们只出现在
|
|
308
|
+
> GitHub README 与市场详情页上)。两轮都**没动插件代码**(tarball 只因本节这几行文档改动而略变,
|
|
309
|
+
> 打包数字见下)。
|
|
310
|
+
- **新增 6 个**:`src/host/passage.js`、`test/deep-context.test.mjs`、`test/deep-eval.test.mjs`、
|
|
311
|
+
`test/deep-scale.test.mjs`、`test/eval/deep.mjs`、`tools/deep-benchmark.mjs`。
|
|
312
|
+
- `npm pack --dry-run`:**51 文件 / 557.0 kB 打包 / 1.66 MB 解包**(v0.19.1 是 46 文件 / 483.4 kB)。
|
|
313
|
+
⚠️ **shasum 故意不写在这一节里**:这份 CHANGELOG 本身就在 tarball 里,写自己的 shasum 会自指
|
|
314
|
+
(改一次就变一次)。**发布前那一刻的 shasum 记在 `03_发布/发布清单-v0.20.0.md`**(仓库外)。
|
|
315
|
+
|
|
316
|
+
### 基准
|
|
317
|
+
|
|
318
|
+
- **Deep Context Eval(需求 §23 的四个指标,`node -e "…runDeepEval()"`)**:
|
|
319
|
+
`DeepHitRate = 1.000`(v0.19 口径 **0.167**)、`PassageHit@1 = 1.000`、
|
|
320
|
+
`PassageRecall = 1.000`、`LongDocumentNoiseRate = 0.000`。5 条深度用例(词只在 2500 字之后、
|
|
321
|
+
尾部、一处两命中、代码函数附近、heading 附近)全部 `✔ 第 1 名`,长归档在 6 条用例里
|
|
322
|
+
**一次都没进 Primary/Supporting**。
|
|
323
|
+
- **R1 规模(`node tools/deep-benchmark.mjs`)**:100 文件 cold 63 ms;500 文件 164 ms;
|
|
324
|
+
1000 文件(进池 400 文档 + 100 代码)**157 ms**;真实工作区 1100 文件
|
|
325
|
+
(进池 400 + 300)**384 ms**。门槛 `1500 ms` / `1200 ms`,余量约 10× / 3×。
|
|
326
|
+
- **R2 预算(实测)**:面板载荷 24 篇带片段时 `+14760` 字节(每篇 615 B,片段最长 202 字符 ——
|
|
327
|
+
需求 §16 要的是更精准而不是更大,所以这条钉了自动守卫);`knit_docs` 渲染文本
|
|
328
|
+
1.04×(真机压力语料)~1.36×(最坏语料),均在 1.4× 以内。
|
|
329
|
+
- **§29 Step 8 真实验证**(真实工作区 `08_Knit`,非合成样本):`knit/CHANGELOG.md`
|
|
330
|
+
第 907 行的唯一词(正是那句「Matches come from the first 2500 characters…」)与
|
|
331
|
+
`knit/src/host/context.js` 第 133 行的唯一词,两者都**不在前 2500 字内** ——
|
|
332
|
+
v0.20 都能命中并给出覆盖该行的片段(名次 5/126 与 10/126)。
|
|
333
|
+
|
|
334
|
+
### 已知限制
|
|
335
|
+
|
|
336
|
+
- **Markdown 预览靠文本锚点跳段,不是行号**:`.md` 的「命中段」点击(以及直接点整行)会滚到**那一块**
|
|
337
|
+
(片段首行那根「针」落在哪个渲染块上)并闪一次底 —— 但它指的是一段**文本**,不是源文件第 N 行;
|
|
338
|
+
针在渲染结果里找不到时只打开、不滚动(宁可不动,也不指错)。代码文件才是精确到行的锚点。
|
|
339
|
+
- **单文件 256 KB 上限**:超过的部分不索引(输出里如实说明)。
|
|
340
|
+
- **媒体没有可检索正文**,不做 OCR、不调视觉模型(需求 §17)。
|
|
341
|
+
- **内存**:`body`(原文)与 `hayBody`(小写副本)现在都是整篇,每条约占 2× 正文;
|
|
342
|
+
缓存淘汰仍按 `bodyBytes` 计一份(已知偏差,未改)。
|
|
343
|
+
- **多词查询下,什么话题都提一句的长归档在文件级仍可能排在聚焦短文前面**:
|
|
344
|
+
`isDocHit` 管的是**分层**,不管文件名次。
|
|
345
|
+
|
|
346
|
+
### 没有实现(刻意)
|
|
347
|
+
|
|
348
|
+
Context Provenance、Context Graph UI、Pin-Lock、Context Bundle、Multi-Harness、MCP Server、
|
|
349
|
+
Doubao Adapter、Semantic Search、Embedding、Session Memory、AI Summary、新 Dashboard、
|
|
350
|
+
embedding / 向量数据库 / LLM / 网络 / LSP / Tree-sitter / AST 依赖图 / 语义模型 / 知识图谱,
|
|
351
|
+
以及把 Knit 做成 IDE / Code Intelligence / Language Server。
|
|
352
|
+
|
|
353
|
+
### 三问(每版必答,需求 §16)
|
|
354
|
+
|
|
355
|
+
1. **用户现在多获得了什么能力**:点开任何一篇(无论多长)都能直接看到**命中在哪几行**,并且
|
|
356
|
+
预览会**滚到那一段** —— 代码精确到行、Markdown 落到那一块。此前长文档里「第 5000 字之后」
|
|
357
|
+
等于不存在:列表只给文件名,预览从头开始,用户得自己在整篇里找。
|
|
358
|
+
2. **Agent 的 Context Consumption 多获得了什么能力**:**知道「文件内部哪里相关」**。
|
|
359
|
+
`knit_docs` 每条多一行 `match: lines 147–163 — …`(原文片段 + 行号),模型不必为定位再 `grep`
|
|
360
|
+
或整篇读一遍;诚实性文案也随之改成「全文都搜过了」(不再说「只看前 2500 字,更深的用 grep」)。
|
|
361
|
+
3. **明确没有做**:见上一节「没有实现(刻意)」。这一版**刻意不做**的四条最容易被误加的:
|
|
362
|
+
语义/向量检索(留 v0.24)、把片段当排序基本实体(文件仍是基本实体)、第二套预览框架、
|
|
363
|
+
在任何界面上显示分数 / 百分比 / 命中计数。已知边界另见「已知限制」。
|
|
364
|
+
|
|
365
|
+
### 升级注意
|
|
366
|
+
|
|
367
|
+
- **宿主不热加载** ⇒ 升级后要重启 DSH 才会生效(客户端 bundle 随页面刷新)。
|
|
368
|
+
|
|
369
|
+
> ✅ **2026-10-08 已发布**:轻量 tag `v0.20.0` = 发布提交 `2be278486299c721daa21ee127fd26bbe21af284`;npm `latest = 0.20.0`、`gitHead` = 同一个提交、共 **17 个**版本;registry 真包 **51 文件 / 565 078 B tarball / 1 662 961 B 解包 / shasum `7be584a08529379dba7d255028d59a2853624094`**;OIDC 可信发布 + provenance(workflow run `37730146187`,22 s);GitHub Release 正文取自本节(前置「更新后必须重启 DSH」与「已知问题」两条),`publishedAt 2026-10-08T05:08:35Z`。
|
|
370
|
+
> ⚠️ 本地 `npm pack --dry-run` 报 51 文件 / 557.0 kB / shasum `deb8bfe6…` —— **本地字节与 registry 历来对不上**(v0.18 / v0.19.x 都这样),差的只是 tar/gzip 框架元数据,解包后清单与内容逐字一致。
|
|
371
|
+
> ⚠️ **发布后才发现的一条包装缺陷**:`test/deep-scale.test.mjs` 从 `../tools/deep-benchmark.mjs` 取语料工厂,而 `tools/` 不随包发布 ⇒ **解包目录里 `npm test` = 638 pass / 1 fail**(`ERR_MODULE_NOT_FOUND`)。**插件本体不受影响**(`src/` 不引用 `tools/`)。仓库完整套件仍是 641/641;已在 **v0.20.1** 修(把语料工厂搬进 `test/`)。
|
|
372
|
+
> ⚠️ **这一行不在已发布的 tarball 里** —— 它在 publish 成功之后才写进来(下次 `npm view` 看到的是这份仓库里的文件)。
|
|
373
|
+
|
|
6
374
|
## [0.19.1] - 2026-10-07
|
|
7
375
|
|
|
8
376
|
> **定位重构(只改对外叙事,一行代码没动)**。产品已经从 v0.12 时代的「更聪明的最近文件列表」
|
|
@@ -30,6 +398,10 @@
|
|
|
30
398
|
keywords 24 → 27(新增 `workspace-context` / `context-retrieval` / `context-lifecycle`)。
|
|
31
399
|
- **无代码变更**:`src/`、`test/`、`tools/` 一行没动,测试仍是 588 项全绿。
|
|
32
400
|
|
|
401
|
+
> ✅ **2026-10-07 已发布**:轻量 tag `v0.19.1` = 发布提交 `8dbbdef80c0d4d691b2724225ee6c4ec93aa6c34`;npm `latest = 0.19.1`、`gitHead` = 同一个提交、共 **16 个**版本;registry 真包 **46 文件 / 490 417 B 打包 / 1 452 990 B 解包 / shasum `a69ed85eb065335fda6a3e6cf91dfb346b76b71a`**;OIDC 可信发布 + provenance(`/slsa.dev/provenance/v1`);GitHub Release 正文取自本节(27 行 / 2020 字节),`publishedAt 2026-10-07T04:49:46Z`。
|
|
402
|
+
> ⚠️ 本地 `npm pack --dry-run` 报 46 文件 / 483.4 kB / shasum `5bfd69b0…` —— **本地字节与 registry 历来对不上**(v0.18 / v0.19.0 都这样),差的只是 tar/gzip 框架元数据,解包后清单与内容逐字一致。
|
|
403
|
+
> ⚠️ **这一行不在已发布的 tarball 里** —— 它在 publish 成功之后才写进来(下次 `npm view` 看到的是这份仓库里的文件)。
|
|
404
|
+
|
|
33
405
|
## [0.19.0] - 2026-10-07
|
|
34
406
|
|
|
35
407
|
> **Code Context**。产品概念从「Markdown / 图片 / 视频」变成「**文档 / 代码 / 媒体**」——
|