dsh-knit 0.15.0 → 0.16.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 +227 -0
- package/README.en.md +26 -12
- package/README.md +30 -15
- package/package.json +2 -2
- package/src/client/client.js +151 -99
- package/src/host/feedback.js +302 -85
- package/src/host/index.js +66 -49
- package/src/host/tool.js +8 -9
- package/test/client.test.mjs +180 -31
- package/test/context-delta.test.mjs +20 -7
- package/test/context-effectiveness.test.mjs +309 -0
- package/test/context-feedback-eval.test.mjs +36 -5
- package/test/host-http.test.mjs +101 -46
- package/test/i18n.test.mjs +19 -21
- package/test/path.test.mjs +6 -6
- package/test/peek.test.mjs +80 -26
- package/test/tool.test.mjs +11 -9
- package/tools/context-feedback-eval.mjs +46 -14
package/src/host/index.js
CHANGED
|
@@ -943,6 +943,26 @@ export function parseRange(header, size) {
|
|
|
943
943
|
return { start, end }
|
|
944
944
|
}
|
|
945
945
|
|
|
946
|
+
/**
|
|
947
|
+
* 从一个宿主会话对象解析工作区根。
|
|
948
|
+
*
|
|
949
|
+
* v0.16 起 `session/event` 的订阅回调里**只有 session 对象**(没有注入过的 webCtx),
|
|
950
|
+
* 所以这段逻辑必须能独立使用:面板路由与记账回调共用它,保证「算列表用的根」与
|
|
951
|
+
* 「归一化读路径用的根」永远是同一个 —— 否则同一次读会被一边算作包内、
|
|
952
|
+
* 一边算作包外(AGENTS.md §8.10 踩过这个坑)。
|
|
953
|
+
* @param {object} session - 宿主会话(可为空)
|
|
954
|
+
* @returns {string} 绝对路径根
|
|
955
|
+
*/
|
|
956
|
+
function rootOfSession(session) {
|
|
957
|
+
let root = ''
|
|
958
|
+
try {
|
|
959
|
+
if (session && session.header && typeof session.header.cwd === 'string') root = session.header.cwd
|
|
960
|
+
} catch { /* 取不到 cwd 就走兜底根 */ }
|
|
961
|
+
if (!root) root = process.cwd()
|
|
962
|
+
if (root.startsWith('~')) root = join(homedir(), root.slice(1))
|
|
963
|
+
return resolve(root)
|
|
964
|
+
}
|
|
965
|
+
|
|
946
966
|
/**
|
|
947
967
|
* 解析一个会话的工作区根。
|
|
948
968
|
* @param {object} webCtx - 注入了 sessions 的上下文
|
|
@@ -950,16 +970,13 @@ export function parseRange(header, size) {
|
|
|
950
970
|
* @returns {string} 绝对路径根
|
|
951
971
|
*/
|
|
952
972
|
function workspaceRootOf(webCtx, sessionId) {
|
|
953
|
-
let
|
|
973
|
+
let session
|
|
954
974
|
try {
|
|
955
|
-
|
|
975
|
+
session = sessionId && typeof webCtx.sessions.get === 'function'
|
|
956
976
|
? webCtx.sessions.get(sessionId)
|
|
957
977
|
: undefined
|
|
958
|
-
if (session && session.header && typeof session.header.cwd === 'string') root = session.header.cwd
|
|
959
978
|
} catch { /* 会话查不到就走兜底根 */ }
|
|
960
|
-
|
|
961
|
-
if (root.startsWith('~')) root = join(homedir(), root.slice(1))
|
|
962
|
-
return resolve(root)
|
|
979
|
+
return rootOfSession(session)
|
|
963
980
|
}
|
|
964
981
|
|
|
965
982
|
/**
|
|
@@ -1047,49 +1064,45 @@ function sendMedia(req, res, info) {
|
|
|
1047
1064
|
stream.pipe(res)
|
|
1048
1065
|
}
|
|
1049
1066
|
|
|
1050
|
-
/* ── v0.
|
|
1067
|
+
/* ── v0.16 · Context Feedback 的宿主侧封装 ────────────────────────────
|
|
1051
1068
|
*
|
|
1052
1069
|
* 这一层只做三件事:
|
|
1053
|
-
* 1.
|
|
1054
|
-
* 2. 把刚交出去的 Context Pack 记成 Context Snapshot
|
|
1070
|
+
* 1. **订阅**宿主的 `session/event`,把真实发生过的 `read` 一条条喂给 feedback store;
|
|
1071
|
+
* 2. 把刚交出去的 Context Pack 记成 Context Snapshot(带 `epochId`);
|
|
1055
1072
|
* 3. 给面板与 `knit_docs` 提供「**上一份**包之后发生了什么」。
|
|
1056
1073
|
*
|
|
1074
|
+
* ⚠️ v0.16 起**不再**从 `session.snapshotEvents()` 拉事件:那个 API 已被 DSH 标记
|
|
1075
|
+
* deprecated(「new production calls are prohibited」),而且它会把这个会话从父会话
|
|
1076
|
+
* fork 继承来的前缀事件也算进来。代价是:订阅之前发生过的事件不回溯 —— 宁可少记,
|
|
1077
|
+
* 也不去猜一段没法按当时上下文归因的历史。
|
|
1078
|
+
*
|
|
1057
1079
|
* 记账只在**被显式打开**的会话里发生(面板的「使用情况」开关,或 `knit_docs` 的
|
|
1058
|
-
* `audit: true`)——
|
|
1059
|
-
*
|
|
1080
|
+
* `audit: true`)—— 默认一条事件的处理成本就是一次 Map 查找。
|
|
1081
|
+
* 所有入口都 try/catch:记账坏了不许影响面板与工具(规格 §33 的降级纪律)。
|
|
1060
1082
|
*/
|
|
1061
1083
|
|
|
1062
1084
|
/** 进程内唯一的 feedback store(按会话分片,会话数与篇数都有硬上限)。 */
|
|
1063
1085
|
const feedbackStore = createStore()
|
|
1064
1086
|
|
|
1065
1087
|
/**
|
|
1066
|
-
*
|
|
1067
|
-
*
|
|
1088
|
+
* 订阅宿主的会话事件流,把真实的读记进 store。
|
|
1089
|
+
*
|
|
1090
|
+
* `{ global: true }` 是**必需**的:`session/event` 按 scope 过滤派发,而这个插件挂在
|
|
1091
|
+
* 根上下文上、要看的却是各 agent scope 里的会话(宿主自己的 `invariant.js` 也这么订)。
|
|
1092
|
+
*
|
|
1093
|
+
* 三道闸门,顺序即开销顺序:**没记账的会话,一条事件只花一次 Map 查找**就返回。
|
|
1094
|
+
* 任何异常一律咽掉 —— 记账坏了绝不许影响宿主。
|
|
1068
1095
|
* @param {object} session - 宿主会话
|
|
1069
|
-
* @
|
|
1096
|
+
* @param {object} event - 会话事件(`tool/call` / `tool/result` / 其它)
|
|
1097
|
+
* @returns {void}
|
|
1070
1098
|
*/
|
|
1071
|
-
function
|
|
1099
|
+
function onSessionEvent(session, event) {
|
|
1072
1100
|
try {
|
|
1073
|
-
|
|
1074
|
-
|
|
1075
|
-
|
|
1076
|
-
|
|
1077
|
-
|
|
1078
|
-
}
|
|
1079
|
-
}
|
|
1080
|
-
|
|
1081
|
-
/**
|
|
1082
|
-
* 把会话事件喂给 feedback store。幂等靠 `seq` 游标 —— 面板每 5 秒轮询一次,
|
|
1083
|
-
* 每次都会把**同一批历史事件**再拉一遍,游标保证同一篇读只记一次。
|
|
1084
|
-
* @param {string} root - 工作区根(归一化绝对路径用)
|
|
1085
|
-
* @param {string} sessionId - 会话 id
|
|
1086
|
-
* @param {object} session - 宿主会话
|
|
1087
|
-
* @returns {{ok: boolean, reads: number, cursor: number}} 结果
|
|
1088
|
-
*/
|
|
1089
|
-
function ingestFeedback(root, sessionId, session) {
|
|
1090
|
-
const events = sessionEvents(session)
|
|
1091
|
-
if (!events || !sessionId) return { ok: false, reads: 0, cursor: -1 }
|
|
1092
|
-
return ingestEvents(feedbackStore, sessionId, events, { root })
|
|
1101
|
+
const sessionId = session && typeof session.id === 'string' ? session.id : ''
|
|
1102
|
+
if (!sessionId || !event) return
|
|
1103
|
+
if (!isAudited(feedbackStore, sessionId)) return
|
|
1104
|
+
ingestEvents(feedbackStore, sessionId, [event], { root: rootOfSession(session) })
|
|
1105
|
+
} catch { /* 记账坏了不许影响宿主 */ }
|
|
1093
1106
|
}
|
|
1094
1107
|
|
|
1095
1108
|
/**
|
|
@@ -1120,6 +1133,7 @@ export function publicUsage(usage, limit = 20) {
|
|
|
1120
1133
|
if (!usage || !usage.stats) return null
|
|
1121
1134
|
return {
|
|
1122
1135
|
at: usage.at,
|
|
1136
|
+
epochId: usage.epochId,
|
|
1123
1137
|
stats: { ...usage.stats, outsideReads: usage.stats.outsideReads.slice(0, limit) },
|
|
1124
1138
|
delta: usage.delta ? {
|
|
1125
1139
|
appeared: usage.delta.appeared.slice(0, limit),
|
|
@@ -1133,38 +1147,37 @@ export function publicUsage(usage, limit = 20) {
|
|
|
1133
1147
|
/**
|
|
1134
1148
|
* 注入给 `knit_docs` 的桥 —— 工具不认识 `feedback.js`,只认识这两个方法
|
|
1135
1149
|
* (与 `scan` / `read` / `contextFor` 同样的注入理由)。
|
|
1150
|
+
*
|
|
1136
1151
|
* ⚠️ `summary()` 必须在 `note()` **之前**调用:它报告的是**上一份**包的用法。
|
|
1152
|
+
* v0.16 起这个桥**不再收** root 与 session:读证据由订阅那条路进 store,
|
|
1153
|
+
* 交包只是记一份快照(`seq` 用 store 自己的事件水位)。
|
|
1137
1154
|
*/
|
|
1138
1155
|
const auditBridge = {
|
|
1139
|
-
usage(
|
|
1156
|
+
usage(sessionId) {
|
|
1140
1157
|
try {
|
|
1141
1158
|
if (!sessionId) return null
|
|
1142
|
-
ingestFeedback(root, sessionId, session)
|
|
1143
1159
|
return usageFor(feedbackStore, sessionId)
|
|
1144
1160
|
} catch {
|
|
1145
1161
|
return null
|
|
1146
1162
|
}
|
|
1147
1163
|
},
|
|
1148
|
-
summary(
|
|
1164
|
+
summary(sessionId) {
|
|
1149
1165
|
try {
|
|
1150
1166
|
if (!sessionId) return ''
|
|
1151
|
-
ingestFeedback(root, sessionId, session)
|
|
1152
1167
|
return getAuditSummary(usageFor(feedbackStore, sessionId))
|
|
1153
1168
|
} catch {
|
|
1154
1169
|
return ''
|
|
1155
1170
|
}
|
|
1156
1171
|
},
|
|
1157
|
-
note(
|
|
1172
|
+
note(sessionId, pack) {
|
|
1158
1173
|
try {
|
|
1159
1174
|
if (!sessionId || !pack) return null
|
|
1160
1175
|
// 走到这里说明记账是**显式**的(面板带了 `usage=1`,或 agent 传了 `audit: true`
|
|
1161
1176
|
// 且 `tool.js` 只在那一刻调 note)—— 所以在这里开闸是安全的。
|
|
1162
1177
|
activateAudit(feedbackStore, sessionId)
|
|
1163
|
-
|
|
1164
|
-
|
|
1165
|
-
|
|
1166
|
-
at: Date.now(),
|
|
1167
|
-
})
|
|
1178
|
+
// 不传 `seq`:noteSnapshot 用会话当前的**事件水位**,也就是「交这份包时
|
|
1179
|
+
// 已经发生到第几个事件」—— seq ≤ 它的读才算在这份包里。
|
|
1180
|
+
return noteSnapshot(feedbackStore, sessionId, pack, { at: Date.now() })
|
|
1168
1181
|
} catch {
|
|
1169
1182
|
return null
|
|
1170
1183
|
}
|
|
@@ -1177,6 +1190,11 @@ const auditBridge = {
|
|
|
1177
1190
|
* @returns {void}
|
|
1178
1191
|
*/
|
|
1179
1192
|
export function apply(ctx) {
|
|
1193
|
+
// v0.16:订阅会话事件流 —— 这是 Knit 唯一的读证据来源。
|
|
1194
|
+
// ⚠️ 注册在这里,而不是 `inject(['webServer','sessions'])` 的回调里:
|
|
1195
|
+
// `knit_docs` 的 `audit: true` 也能打开记账,没有 webServer 的环境照样要记。
|
|
1196
|
+
ctx.on('session/event', onSessionEvent, { global: true })
|
|
1197
|
+
|
|
1180
1198
|
ctx.inject(['webServer', 'sessions'], (webCtx) => {
|
|
1181
1199
|
const handler = async (req, res) => {
|
|
1182
1200
|
if (!isLoopback(req.socket?.remoteAddress)) {
|
|
@@ -1209,11 +1227,10 @@ export function apply(ctx) {
|
|
|
1209
1227
|
// ⚠️ 默认(不带这个参数且本会话从未打开过)**一个字节都不记**。
|
|
1210
1228
|
if (sessionId && url.searchParams.get('usage') === '1') activateFeedback(sessionId)
|
|
1211
1229
|
if (sessionId && feedbackActive(sessionId)) {
|
|
1212
|
-
const session = sessionOf(webCtx, sessionId)
|
|
1213
1230
|
// ⚠️ 顺序是刻意的:先取 usage(它报告的是**上一份**包之后发生了什么),
|
|
1214
1231
|
// 再把这一份包记成新快照 —— 从下一次请求起,它才是「上一份」。
|
|
1215
|
-
body.usage = publicUsage(auditBridge.usage(
|
|
1216
|
-
if (body.context) auditBridge.note(
|
|
1232
|
+
body.usage = publicUsage(auditBridge.usage(sessionId))
|
|
1233
|
+
if (body.context) auditBridge.note(sessionId, body.context)
|
|
1217
1234
|
}
|
|
1218
1235
|
sendJson(res, 200, body)
|
|
1219
1236
|
return
|
|
@@ -1244,7 +1261,7 @@ export function apply(ctx) {
|
|
|
1244
1261
|
// v0.15:走这条路的调用方(只要上下文、不要列表)同样会推进 Context Snapshot ——
|
|
1245
1262
|
// 否则「上下文变了」这件事会漏记。**只在已记账的会话里**(同 recent 的闸门)。
|
|
1246
1263
|
if (sessionId && feedbackActive(sessionId)) {
|
|
1247
|
-
auditBridge.note(
|
|
1264
|
+
auditBridge.note(sessionId, context)
|
|
1248
1265
|
}
|
|
1249
1266
|
sendJson(res, 200, { ok: true, root, mode: payload.mode, topic: payload.topic, context })
|
|
1250
1267
|
return
|
package/src/host/tool.js
CHANGED
|
@@ -486,16 +486,14 @@ function whyText(reason) {
|
|
|
486
486
|
* 与 `scan` / `read` / `contextFor` 同样的理由:一层做一件事,且避免 index.js ↔ tool.js 循环 import。
|
|
487
487
|
* 桥没给、桥抛了、桥返回了非字符串:一律当「没有可说的」,返回空串。
|
|
488
488
|
*
|
|
489
|
-
* @param {object} [audit] - `{summary(
|
|
490
|
-
* @param {string} root - 工作区根
|
|
489
|
+
* @param {object} [audit] - `{summary(sessionId), note(sessionId, pack)}`
|
|
491
490
|
* @param {string} sessionId - 会话 id
|
|
492
|
-
* @param {object} session - 宿主会话
|
|
493
491
|
* @returns {string} 一行摘要或空串
|
|
494
492
|
*/
|
|
495
|
-
function auditSummary(audit,
|
|
493
|
+
function auditSummary(audit, sessionId) {
|
|
496
494
|
if (!audit || typeof audit.summary !== 'function' || !sessionId) return ''
|
|
497
495
|
try {
|
|
498
|
-
const line = audit.summary(
|
|
496
|
+
const line = audit.summary(sessionId)
|
|
499
497
|
return typeof line === 'string' ? line : ''
|
|
500
498
|
} catch {
|
|
501
499
|
return ''
|
|
@@ -515,8 +513,9 @@ function auditSummary(audit, root, sessionId, session) {
|
|
|
515
513
|
* `contextFor(root, {ranked, topic, task, total})` → Context Pack。
|
|
516
514
|
* **同样注入**(v0.14):装配规则长在 `context.js` 里,工具只负责投影。
|
|
517
515
|
* 不给就退化成 v0.13 的平铺列表 —— 但那只是兜底,正常路径 always 会传。
|
|
518
|
-
* @param {object} [audit] - Context Feedback 的桥(v0.
|
|
519
|
-
* `{ summary(
|
|
516
|
+
* @param {object} [audit] - Context Feedback 的桥(v0.16,**可选**):
|
|
517
|
+
* `{ summary(sessionId) → string, note(sessionId, pack) → void }`。
|
|
518
|
+
* 桥不再需要工作区根与会话对象:读证据由宿主的 `session/event` 订阅进 store。
|
|
520
519
|
* 不给就完全没有审计能力 —— 工具的入参与返回值与 v0.14 逐字一致。
|
|
521
520
|
* @returns {object} 工具定义
|
|
522
521
|
*/
|
|
@@ -654,10 +653,10 @@ export function knitDocsDefinition(scan, read, contextFor, audit) {
|
|
|
654
653
|
// 顺序是刻意的:先取「**上一份**包之后发生了什么」(usage 是回过头看的),
|
|
655
654
|
// 再把这一份包记成新的 Context Snapshot —— 从下一次调用起,它才是「上一份」。
|
|
656
655
|
// 两步都只是记账,任何失败都只让摘要少一行,绝不让整次工具调用失败。
|
|
657
|
-
const usage = auditRequested ? auditSummary(audit,
|
|
656
|
+
const usage = auditRequested ? auditSummary(audit, sessionId) : ''
|
|
658
657
|
if (auditRequested && audit && typeof audit.note === 'function' && sessionId) {
|
|
659
658
|
try {
|
|
660
|
-
audit.note(
|
|
659
|
+
audit.note(sessionId, pack)
|
|
661
660
|
} catch {
|
|
662
661
|
// 记账失败不影响排序结果 —— 这是「Knit 坏了也不许影响 Agent」那条纪律
|
|
663
662
|
}
|
package/test/client.test.mjs
CHANGED
|
@@ -126,6 +126,9 @@ test('注册:有 betterSidebar 时注册一个 tab descriptor', () => {
|
|
|
126
126
|
const d = log.bsTabs[0]
|
|
127
127
|
assert.equal(d.id, 'knit:recent')
|
|
128
128
|
assert.equal(d.single, true, '同类型只开一个')
|
|
129
|
+
// hidden 是给 better-sidebar v0.24.1+ 的「原生表面」看的:它会镜像成一个官方类型,
|
|
130
|
+
// 并在没有 hidden 时连带挂一条 guide 条目 ⇒ 「开始」页出现两行同名入口。
|
|
131
|
+
assert.equal(d.hidden, true, '不许镜像再挂一条 guide 入口(官方那条已够)')
|
|
129
132
|
assert.equal(typeof d.component, 'function')
|
|
130
133
|
assert.equal(d.title(), 'Knit 最近文档')
|
|
131
134
|
})
|
|
@@ -150,7 +153,7 @@ test('注册:better-sidebar 缺失时官方右侧栏照常注册', () => {
|
|
|
150
153
|
|
|
151
154
|
/* ── 渲染:排序模式 ─────────────────────────────────── */
|
|
152
155
|
|
|
153
|
-
test('渲染:relevance
|
|
156
|
+
test('渲染:relevance 模式不做任何相关度可视化(排序即答案)', async () => {
|
|
154
157
|
installFetch(() => listPayload({
|
|
155
158
|
mode: 'relevance',
|
|
156
159
|
topic: '相关性、sidebar',
|
|
@@ -179,13 +182,12 @@ test('渲染:relevance 模式不做任何相关度可视化,只解释排序
|
|
|
179
182
|
|
|
180
183
|
assert.equal(byClass(nodes, 'knit-time').length, 2, '时间对所有行都一样显示')
|
|
181
184
|
|
|
182
|
-
// 2026-09-
|
|
183
|
-
//
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
assert.
|
|
188
|
-
'关键词退到 title 里,悬停才给')
|
|
185
|
+
// 2026-09-30 用户裁决:排序说明那一行(.knit-topic)**整体删除** ——
|
|
186
|
+
// 排序方式由头部那个「相关 / 最新」切换按钮自己表达,再补一句是重复;
|
|
187
|
+
// 命中的关键词随行一起消失(它当时只在这一行的 title 里)。
|
|
188
|
+
// 这段守卫从当年的「可见文本里不许出现关键词」升级成「那一行根本不存在」——
|
|
189
|
+
// 只要行还在,关键词就可能再漏出来。
|
|
190
|
+
assert.equal(byClass(nodes, 'knit-topic').length, 0, '排序说明行已整体删除')
|
|
189
191
|
})
|
|
190
192
|
|
|
191
193
|
test('渲染:相关度分数只影响顺序,不影响任何一行的渲染', async () => {
|
|
@@ -267,7 +269,8 @@ test('渲染:time 模式不显示分数,显示相对时间', async () => {
|
|
|
267
269
|
|
|
268
270
|
assert.equal(byClass(nodes, 'knit-rel-num').length, 0, '时间模式不应有分数')
|
|
269
271
|
assert.equal(byClass(nodes, 'knit-time').length, 2, '应显示相对时间')
|
|
270
|
-
|
|
272
|
+
// 排序说明行已整体删除:切到「最新」也不会把它带回来
|
|
273
|
+
assert.equal(byClass(nodes, 'knit-topic').length, 0, '排序说明行已整体删除')
|
|
271
274
|
})
|
|
272
275
|
|
|
273
276
|
test('渲染:请求 URL 带上当前排序方式', async () => {
|
|
@@ -351,11 +354,14 @@ test('渲染:预览头显示路径面包屑(目录 + 文件名),不再
|
|
|
351
354
|
nodes = harness.render(h(KnitBody, { sessionId: 's1' }))
|
|
352
355
|
|
|
353
356
|
assert.equal(byExactClass(nodes, 'knit-preview-head').length, 1)
|
|
354
|
-
|
|
357
|
+
// 2026-10-01:目录不再展开,收敛成一个 `…/` 占位(用户要求「前面那一串都用三个点点点表示」,把宽度让给文件名)
|
|
358
|
+
assert.equal(byExactClass(nodes, 'knit-preview-dir').map(textOf).join(''), '…/')
|
|
355
359
|
assert.equal(byExactClass(nodes, 'knit-preview-name').map(textOf).join(''), '需求 文档.md')
|
|
360
|
+
// 整条路径的字面形态就是「…/文件名」—— 目录名一个字都不许漏到界面上
|
|
361
|
+
assert.equal(textOf(byExactClass(nodes, 'knit-preview-path')[0]), '…/需求 文档.md')
|
|
356
362
|
// 头部不再放标题:正文 H1 已经写了,重复会让「列表 / 头 / 正文」出现三遍同一个词
|
|
357
363
|
assert.equal(byClass(nodes, 'knit-preview-title').length, 0)
|
|
358
|
-
//
|
|
364
|
+
// 目录被收敛掉之后,完整路径靠 tooltip 悬停仍能看到(与列表行的 row.tooltip 同一套)
|
|
359
365
|
const pathBtn = byExactClass(nodes, 'knit-preview-path')[0]
|
|
360
366
|
assert.match(String(pathBtn.props.title), /sub\/需求 文档\.md/, 'tooltip 里带完整相对路径')
|
|
361
367
|
assert.equal(pathBtn.props.type, 'button', '路径是可点的')
|
|
@@ -1072,13 +1078,19 @@ test('文档:序号是最左边一列,行一=「点 + 标题 + 时间」
|
|
|
1072
1078
|
'一行=最左边一列序号 + 右边一列其余数据',
|
|
1073
1079
|
)
|
|
1074
1080
|
}
|
|
1075
|
-
// 没有序号的行(时间序 / 筛选结果
|
|
1076
|
-
//
|
|
1081
|
+
// 没有序号的行(时间序 / 筛选结果 /「其他相关文档」)**也不许掉进第一列** ——
|
|
1082
|
+
// 靠 .knit-body 的 grid-column 定死位置(用自动排布就会掉)。
|
|
1083
|
+
// 2026-10-01:这一列**不再整格空着**(用户原话:「其他相关文档…没有序号以后左边就空了,
|
|
1084
|
+
// 视觉上比较割裂,就觉得是个 bug 一样」)。这一屏里有号时,没号的行在同一列渲染一个
|
|
1085
|
+
// 中性占位标记 `.knit-gapmark`(·)—— 不冒充序号,也不让轨道断掉。
|
|
1077
1086
|
const unnumbered = docs.filter((d) => !classesUnder(d).includes('knit-num'))
|
|
1078
1087
|
assert.ok(unnumbered.length > 0, '这个 payload 里有不编号的条目')
|
|
1079
1088
|
for (const doc of unnumbered) {
|
|
1080
|
-
assert.
|
|
1081
|
-
'
|
|
1089
|
+
assert.deepEqual(
|
|
1090
|
+
doc.children.slice(0, 2).map((c) => String((c && c.props && c.props.className) || '')),
|
|
1091
|
+
['knit-gapmark', 'knit-body'],
|
|
1092
|
+
'没号的行用同列的占位标记顶住,正文仍然落在第二列',
|
|
1093
|
+
)
|
|
1082
1094
|
}
|
|
1083
1095
|
|
|
1084
1096
|
const rows = byExactClass(nodes, 'knit-row1')
|
|
@@ -1129,26 +1141,53 @@ test('样式:类型切换是下划线式页签,选中态不用品牌色也
|
|
|
1129
1141
|
assert.match(rule[1], /border-bottom-color:/, '选中态靠下划线表达层级')
|
|
1130
1142
|
assert.ok(!rule[1].includes('background:var(--knit-active-bg'),
|
|
1131
1143
|
'下划线式页签不许再退回灰底按钮——两者叠加会同时占用两种「选中」表达')
|
|
1132
|
-
//
|
|
1133
|
-
|
|
1144
|
+
// ⚠️ 2026-09-30 用户裁决(**覆盖**上面那条「页签条要有底边」):那条全宽 hairline
|
|
1145
|
+
// 与下面的列表割裂,删掉。层级现在只由选中项自己那条 2px 下划线表达 ——
|
|
1146
|
+
// 它是画在自己文字下面的,所以不是「下划线悬空」。
|
|
1147
|
+
assert.ok(!/\.knit-types\{[^}]*border/.test(source), '页签条不再画底边')
|
|
1134
1148
|
})
|
|
1135
1149
|
|
|
1136
|
-
test('
|
|
1150
|
+
test('样式:列表行的「正在预览」只有灰底,描边已整体删除', async () => {
|
|
1137
1151
|
const { readFileSync } = await import('node:fs')
|
|
1138
1152
|
const { fileURLToPath } = await import('node:url')
|
|
1139
1153
|
const source = readFileSync(fileURLToPath(new URL('../src/client/client.js', import.meta.url)), 'utf8')
|
|
1140
1154
|
|
|
1141
|
-
// v0.14(Design §12 / §8
|
|
1142
|
-
// ⚠️
|
|
1143
|
-
//
|
|
1155
|
+
// v0.14(Design §12 / §8):2026-09-29 用户裁决先把品牌色描边改成 neutral border。
|
|
1156
|
+
// ⚠️ 2026-09-30 用户裁决**再覆盖一次**:「悬停跟选中,最外层那个描边,我觉得也不需要了」
|
|
1157
|
+
// ⇒ 描边整条删掉,选中态只剩灰底。这条断言因此从「必须是中性描边」翻成「不许有任何描边」。
|
|
1144
1158
|
const rule = source.match(/\.knit-doc\.active\{([^}]*)\}/)
|
|
1145
1159
|
assert.ok(rule, '必须还有 .knit-doc.active 这条规则')
|
|
1146
1160
|
assert.ok(!rule[1].includes('--knit-accent'),
|
|
1147
1161
|
`列表行选中态不许再出现品牌色:${rule[1]}`)
|
|
1148
|
-
assert.
|
|
1149
|
-
|
|
1162
|
+
assert.ok(!rule[1].includes('border'),
|
|
1163
|
+
`选中态不许再有描边(2026-09-30 用户裁决):${rule[1]}`)
|
|
1150
1164
|
assert.match(rule[1], /background:var\(--knit-active-bg/,
|
|
1151
|
-
'
|
|
1165
|
+
'选中态保留灰底——现在它是唯一的分层信号')
|
|
1166
|
+
})
|
|
1167
|
+
|
|
1168
|
+
test('样式:这一轮的「去线 / 去描边」都不许回潮(2026-09-30 用户裁决)', async () => {
|
|
1169
|
+
const { readFileSync } = await import('node:fs')
|
|
1170
|
+
const { fileURLToPath } = await import('node:url')
|
|
1171
|
+
const source = readFileSync(fileURLToPath(new URL('../src/client/client.js', import.meta.url)), 'utf8')
|
|
1172
|
+
const start = source.indexOf('const CSS = `') + 'const CSS = `'.length
|
|
1173
|
+
const css = source.slice(start, source.indexOf('`', start)).replace(/\/\*[\s\S]*?\*\//g, '')
|
|
1174
|
+
|
|
1175
|
+
// ① 列表行的描边:静止那圈透明占位 + 悬停 / 选中各自上的色,三处一起删
|
|
1176
|
+
assert.ok(!css.includes('border:.5px solid transparent'), '那条 .5px 透明边框占位已删')
|
|
1177
|
+
assert.ok(!/\.knit-doc:hover\{[^}]*border-color/.test(css), '悬停态没有描边')
|
|
1178
|
+
assert.ok(!/\.knit-doc\.active\{[^}]*border-color/.test(css), '选中态没有描边')
|
|
1179
|
+
// ⚠️ 边框删了就得用 padding 补回它占掉的 .5px×2,否则每一行矮 1px、左右各窄 .5px
|
|
1180
|
+
assert.match(css, /\.knit-doc\{[^}]*padding:10\.5px 11\.5px/,
|
|
1181
|
+
'padding 要把删掉的边框补回来')
|
|
1182
|
+
// ② 引用条自己不再画线(预览头那条由另一条用例守)
|
|
1183
|
+
assert.ok(!/\.knit-links\{[^}]*border/.test(css), '引用条不画线')
|
|
1184
|
+
// ③ 排序说明行的四个 i18n 键随行一起删掉,不许留在字典里「以后可能用」
|
|
1185
|
+
for (const key of ['topic.relevancePlain', 'topic.relevanceTerms', 'topic.needsConversation', 'topic.time']) {
|
|
1186
|
+
assert.ok(!source.includes(`'${key}'`), `${key} 已随那一行删除`)
|
|
1187
|
+
}
|
|
1188
|
+
// ④ 过滤框提示改成不列字段的一句话(两种语言都在)
|
|
1189
|
+
assert.match(source, /'filter\.placeholder': '过滤文档'/)
|
|
1190
|
+
assert.match(source, /'filter\.placeholder': 'Filter docs'/)
|
|
1152
1191
|
})
|
|
1153
1192
|
|
|
1154
1193
|
test('样式:悬停 / 选中的灰底各降一档(悬停 −60% / 选中 −40%),两个主题都给了值', async () => {
|
|
@@ -1229,7 +1268,9 @@ test('样式:文档列表没有网格 —— 多列那套已整体删除,容
|
|
|
1229
1268
|
// **垂直居中**靠的正是这两个数字对齐,改一处必须改另一处
|
|
1230
1269
|
// (v0.14 规格 §15 把文档标题提到 14px,所以这一对数字一起变了)。
|
|
1231
1270
|
assert.match(css, /\.knit-title\{flex:1 1 auto;min-width:0;font-weight:600;font-size:14px;line-height:1\.4;/)
|
|
1232
|
-
|
|
1271
|
+
// 2026-10-01:`.knit-gapmark`(没号时的中性占位标记)与序号**共用同一条选择器**,
|
|
1272
|
+
// 所以「序号的行高必须等于标题行高」这条纪律自动覆盖它。
|
|
1273
|
+
assert.match(css, /\.knit-num,\.knit-gapmark\{grid-column:1;font-size:10\.5px;line-height:19\.6px;/)
|
|
1233
1274
|
|
|
1234
1275
|
// ⚠️ 行的**静止态没有底色**(2026-09-29 用户看了暗色主题之后要求:
|
|
1235
1276
|
// 「深色模式下,文档列表没有选中,鼠标没有悬停,不需要有背景。或者是说,跟深色模式的最底下的
|
|
@@ -1248,7 +1289,7 @@ test('样式:文档列表没有网格 —— 多列那套已整体删除,容
|
|
|
1248
1289
|
// (用户原话:「文档列表序号放在独立最左边,其他数据放在右边」)。
|
|
1249
1290
|
// 第二列必须是 minmax(0,1fr):不然长标题会把行撑宽,省略号失效。
|
|
1250
1291
|
assert.match(css, /\.knit-doc\{display:grid;grid-template-columns:22px minmax\(0,1fr\)/)
|
|
1251
|
-
assert.match(css, /\.knit-num\{grid-column:1;/)
|
|
1292
|
+
assert.match(css, /\.knit-num,\.knit-gapmark\{grid-column:1;/)
|
|
1252
1293
|
assert.match(css, /\.knit-body\{grid-column:2;min-width:0\}/,
|
|
1253
1294
|
'第二列的位置与 min-width:0 都要写死 —— 少一个长标题就会把行撑宽')
|
|
1254
1295
|
})
|
|
@@ -1384,9 +1425,10 @@ test('样式:预览面板底色恒为纯阅读底色,不靠底色分层;
|
|
|
1384
1425
|
// 分层三件套仍在:上边界 + 圆角 + 柔影
|
|
1385
1426
|
assert.match(css, /\.knit-preview\{[^}]*border-top-left-radius:12px/)
|
|
1386
1427
|
assert.match(css, /\.knit-preview\{[^}]*box-shadow:0 -8px 24px/)
|
|
1387
|
-
//
|
|
1428
|
+
// 头部高度仍对齐官方 .dhJKeW_header:38px;但官方那条 border-l3 底边
|
|
1429
|
+
// 已按 2026-09-30 用户裁决删掉(与引用条那条一起,两条细线把引用区夹得割裂)
|
|
1388
1430
|
assert.match(css, /\.knit-preview-head\{[^}]*height:38px/)
|
|
1389
|
-
assert.
|
|
1431
|
+
assert.ok(!/\.knit-preview-head\{[^}]*border-bottom/.test(css), '预览头不再画底边')
|
|
1390
1432
|
// 全屏时要去掉圆角与柔影(那时没有「浮在列表上」的隐喻)
|
|
1391
1433
|
assert.match(css, /\.knit-root\.fullscreen \.knit-preview\{[^}]*border-radius:0/)
|
|
1392
1434
|
// ⚠️ 旧行为已废:不再有 .knit-preview.reading,也没有背景过渡
|
|
@@ -1855,6 +1897,24 @@ test('上下文:行首序号跨三档连续,且「其他相关文档」不
|
|
|
1855
1897
|
assert.equal(docs.length, 5)
|
|
1856
1898
|
assert.equal(docs[4].props['data-knit-rel'], 'docs/other.md', '最后一档是「其他相关文档」')
|
|
1857
1899
|
assert.equal(byExactClass(nodes, 'knit-num').length, 4, '它不在这个包里,所以不编号')
|
|
1900
|
+
// 2026-10-01:它那一格不空着了 —— 同列一个中性标记(用户要「不要像 bug」,
|
|
1901
|
+
// 同时保住「所有行左边缘对齐」)。但它**不是**序号:整数序列里没有第 5 个数字。
|
|
1902
|
+
assert.deepEqual(byExactClass(nodes, 'knit-gapmark').map(textOf), ['·'])
|
|
1903
|
+
assert.equal(classesUnder(docs[4]).includes('knit-num'), false, '占位标记不许被当成序号')
|
|
1904
|
+
})
|
|
1905
|
+
|
|
1906
|
+
test('上下文:占位标记跟「这一屏有没有号」走 —— 混着才有,整屏没号就一个都没有', async () => {
|
|
1907
|
+
// 有号的一屏:只有「其他相关文档」那一行拿到标记
|
|
1908
|
+
const { nodes } = await mountWithPayload(contextPayload())
|
|
1909
|
+
assert.equal(byExactClass(nodes, 'knit-num').length, 4)
|
|
1910
|
+
assert.deepEqual(byExactClass(nodes, 'knit-gapmark').map(textOf), ['·'])
|
|
1911
|
+
// 过滤到「无关」之后只剩「其他相关文档」这一档:整屏没号 ⇒ 一个标记都不许有
|
|
1912
|
+
// (这才是「像 bug」的真正判据:混着才刺眼,整屏一致就没人觉得缺东西)
|
|
1913
|
+
const mounted = await mountWithPayload(contextPayload())
|
|
1914
|
+
byClass(mounted.nodes, 'knit-filter')[0].props.onChange({ target: { value: '无关' } })
|
|
1915
|
+
const after = mounted.render()
|
|
1916
|
+
assert.equal(byExactClass(after, 'knit-num').length, 0, '只剩包外那一档 ⇒ 没有号')
|
|
1917
|
+
assert.equal(byExactClass(after, 'knit-gapmark').length, 0, '没有号的一屏里也不放占位标记')
|
|
1858
1918
|
})
|
|
1859
1919
|
|
|
1860
1920
|
test('上下文:Primary 那颗点是位置信号,只有主上下文那一行有', async () => {
|
|
@@ -1872,6 +1932,8 @@ test('上下文:时间序不分层,行首也不编号(平铺列表照旧
|
|
|
1872
1932
|
const { nodes } = await mountWithPayload(contextPayload({ mode: 'time' }))
|
|
1873
1933
|
assert.equal(byExactClass(nodes, 'knit-tier').length, 0, '时间序不分层')
|
|
1874
1934
|
assert.equal(byExactClass(nodes, 'knit-num').length, 0, '平铺列表不编号')
|
|
1935
|
+
assert.equal(byExactClass(nodes, 'knit-gapmark').length, 0,
|
|
1936
|
+
'整屏都没号时一个占位标记都不渲染 —— 一屏里要么都有、要么都没有')
|
|
1875
1937
|
assert.equal(byExactClass(nodes, 'knit-dot').length, 0, '平铺列表没有主上下文点')
|
|
1876
1938
|
assert.equal(byClass(nodes, 'knit-doc').length, 5, '文档本身照常列全')
|
|
1877
1939
|
})
|
|
@@ -1919,12 +1981,17 @@ test('样式:组与组之间只靠 16px 空间(不再画横线),序号
|
|
|
1919
1981
|
// 用户要求「减少横向分割线」:组间距靠空间,不靠 border-top
|
|
1920
1982
|
assert.match(source, /\.knit-tier \+ \.knit-tier\{margin-top:16px\}/)
|
|
1921
1983
|
assert.ok(!/\.knit-tier \+ \.knit-tier\{[^}]*border-top/.test(source), '组之间不该再有横线')
|
|
1922
|
-
//
|
|
1923
|
-
|
|
1984
|
+
// 排序说明那一行(原名 .knit-topic)2026-09-30 已**整体删除** ——
|
|
1985
|
+
// 当年这条断言问的是「那一行有没有画线」,现在问的是「那一行还在不在」。
|
|
1986
|
+
// ⚠️ 必须剥掉注释再查 CSS:历史注释里还会提到这个类名(那是给后人 grep 的)。
|
|
1987
|
+
const start = source.indexOf('const CSS = `') + 'const CSS = `'.length
|
|
1988
|
+
const css = source.slice(start, source.indexOf('`', start)).replace(/\/\*[\s\S]*?\*\//g, '')
|
|
1989
|
+
assert.ok(!css.includes('.knit-topic'), '排序依据那一行的样式已整体删除')
|
|
1990
|
+
assert.ok(!source.includes("'knit-topic'"), '排序依据那一行的节点已整体删除')
|
|
1924
1991
|
// 字号:标题 14px / 行高 1.4 = 19.6px;序号的 line-height 必须与它同步,
|
|
1925
1992
|
// 这是「序号与标题第一行垂直居中」的唯一手段(改一处必须改两处)
|
|
1926
1993
|
assert.match(source, /\.knit-title\{flex:1 1 auto;min-width:0;font-weight:600;font-size:14px;line-height:1\.4;/)
|
|
1927
|
-
assert.match(source, /\.knit-num\{grid-column:1;font-size:10\.5px;line-height:19\.6px;/)
|
|
1994
|
+
assert.match(source, /\.knit-num,\.knit-gapmark\{grid-column:1;font-size:10\.5px;line-height:19\.6px;/)
|
|
1928
1995
|
assert.match(source, /\.knit-sum\{font-size:12px;line-height:19px;/)
|
|
1929
1996
|
})
|
|
1930
1997
|
|
|
@@ -1939,6 +2006,7 @@ function usagePayload() {
|
|
|
1939
2006
|
return contextPayload({
|
|
1940
2007
|
usage: {
|
|
1941
2008
|
at: 1_700_000_000_000,
|
|
2009
|
+
epochId: 4,
|
|
1942
2010
|
stats: {
|
|
1943
2011
|
reads: 7,
|
|
1944
2012
|
distinct: 3,
|
|
@@ -2003,6 +2071,7 @@ test('使用情况:打开后请求带 usage=1,那一行只报事实(没有
|
|
|
2003
2071
|
const line = byExactClass(nodes, 'knit-usage')[0]
|
|
2004
2072
|
assert.ok(line, '打开后必须出现那一行')
|
|
2005
2073
|
const text = textOf(line)
|
|
2074
|
+
assert.match(text, /当前上下文 · Epoch 4/, '当前上下文的编号要如实说出来')
|
|
2006
2075
|
assert.match(text, /已读/, '先看的那篇被读了要如实说出来')
|
|
2007
2076
|
assert.match(text, /辅助 1\/2/)
|
|
2008
2077
|
assert.match(text, /读了 7 次/)
|
|
@@ -2026,3 +2095,83 @@ test('样式:使用情况那一行是弱化文字 —— 没有卡片 / 进度
|
|
|
2026
2095
|
// 开关本身也不许染色
|
|
2027
2096
|
assert.ok(!/\.knit-btn\.active\{[^}]*knit-accent/.test(source), '开关的选中态走中性灰')
|
|
2028
2097
|
})
|
|
2098
|
+
|
|
2099
|
+
/* ── 可见性(v0.16 · 收起右栏时不许再敲宿主)────────────────────
|
|
2100
|
+
官方右侧栏收起后,dockkit **不卸载**标签身体,v0.16 之前这里照旧每 5 秒请求一次
|
|
2101
|
+
`/knit/api/recent` 并 `setState`:白烧一次全工作区扫描,还往宿主正在收起的那层 DOM 里
|
|
2102
|
+
插一帧重渲染(2026-10-01 用户报的「右栏收起来变成一条空白」)。契约给的
|
|
2103
|
+
`tab.visible` 就是「宿主还看得见吗」,用它做闸门。 */
|
|
2104
|
+
|
|
2105
|
+
test('可见性:宿主说看不见时一次都不取数,也不挂轮询', async () => {
|
|
2106
|
+
const { calls } = installFetch(() => listPayload())
|
|
2107
|
+
const { KnitBody } = loadClientModule().exports.__test
|
|
2108
|
+
harness.reset()
|
|
2109
|
+
harness.seed(['', 'relevance'])
|
|
2110
|
+
const render = (visible) => harness.render(h(KnitBody, { sessionId: 's1', visible }))
|
|
2111
|
+
const listCalls = () => calls.filter((url) => url.includes('/knit/api/recent'))
|
|
2112
|
+
// harness 的定时器是**整个测试文件共用**的(`reset()` 只清 hook 槽,不清定时器),所以看增量。
|
|
2113
|
+
const timers = () => harness.pendingTimers()
|
|
2114
|
+
const timersBefore = timers()
|
|
2115
|
+
|
|
2116
|
+
// 1. 折叠着挂载:连请求都不发,也不留定时器
|
|
2117
|
+
render(false)
|
|
2118
|
+
await harness.flush()
|
|
2119
|
+
assert.equal(listCalls().length, 0, '看不见就不该敲宿主 —— 折叠期间身体仍然挂着')
|
|
2120
|
+
assert.equal(timers() - timersBefore, 0, '看不见就不该挂轮询')
|
|
2121
|
+
|
|
2122
|
+
// 2. 重新可见:effect 重跑 ⇒ 立刻补一次,不必等下一个 5 秒
|
|
2123
|
+
let nodes = render(true)
|
|
2124
|
+
await harness.flush()
|
|
2125
|
+
assert.equal(listCalls().length, 1, '重新可见必须立刻取一次')
|
|
2126
|
+
assert.equal(timers() - timersBefore, 1, '看得见才挂下一次轮询')
|
|
2127
|
+
nodes = render(true)
|
|
2128
|
+
await harness.flush()
|
|
2129
|
+
assert.equal(byClass(nodes, 'knit-doc').length, 2, '列表照常渲染')
|
|
2130
|
+
|
|
2131
|
+
// 3. 又看不见:新登记的 effect 直接返回,不再取数
|
|
2132
|
+
const before = listCalls().length
|
|
2133
|
+
render(false)
|
|
2134
|
+
await harness.flush()
|
|
2135
|
+
assert.equal(listCalls().length, before, '再次折叠就该停手')
|
|
2136
|
+
})
|
|
2137
|
+
|
|
2138
|
+
test('可见性:官方座位把契约的 `tab.visible` 一路传到 KnitBody', async () => {
|
|
2139
|
+
const { ctx, log } = fakeCtx({ sidebarRightTabs: true })
|
|
2140
|
+
const { exports } = loadClientModule()
|
|
2141
|
+
exports.apply(ctx)
|
|
2142
|
+
|
|
2143
|
+
const body = log.slots.find((s) => s.opts && s.opts.name === 'sidebar.right.pane.tab')
|
|
2144
|
+
assert.ok(body, '官方座位必须注册 body')
|
|
2145
|
+
|
|
2146
|
+
// 座位给的真身:`tab.visible === false` 表示右栏收起 / 本标签不是当前那个
|
|
2147
|
+
const seat = (visible) => ({
|
|
2148
|
+
sessionId: 's1',
|
|
2149
|
+
useTabInfo: () => ({ tab: { visible, actions: { openResource() {} } } }),
|
|
2150
|
+
})
|
|
2151
|
+
const listCalls = (calls) => calls.filter((url) => url.includes('/knit/api/recent'))
|
|
2152
|
+
|
|
2153
|
+
// ① 收起时挂载:适配层要把 visible=false 传下去,否则下面这个断言会红
|
|
2154
|
+
let { calls } = installFetch(() => listPayload())
|
|
2155
|
+
harness.reset()
|
|
2156
|
+
harness.seed(['', 'relevance'])
|
|
2157
|
+
harness.render(h(body.component, seat(false)))
|
|
2158
|
+
await harness.flush()
|
|
2159
|
+
assert.equal(listCalls(calls).length, 0, '收起时不该取数(座位说了 visible=false)')
|
|
2160
|
+
|
|
2161
|
+
// ② 展开:同一个座位,立刻取一次
|
|
2162
|
+
;({ calls } = installFetch(() => listPayload()))
|
|
2163
|
+
harness.reset()
|
|
2164
|
+
harness.seed(['', 'relevance'])
|
|
2165
|
+
harness.render(h(body.component, seat(true)))
|
|
2166
|
+
await harness.flush()
|
|
2167
|
+
assert.equal(listCalls(calls).length, 1, '展开时必须取数')
|
|
2168
|
+
|
|
2169
|
+
// ③ 座位没给 `useTabInfo`(降级 / 别的宿主):当作看得见,不能把面板冻住
|
|
2170
|
+
;({ calls } = installFetch(() => listPayload()))
|
|
2171
|
+
harness.reset()
|
|
2172
|
+
harness.seed(['', 'relevance'])
|
|
2173
|
+
harness.render(h(body.component, { sessionId: 's1' }))
|
|
2174
|
+
await harness.flush()
|
|
2175
|
+
assert.equal(listCalls(calls).length, 1, '拿不到 visible 时要照旧取数')
|
|
2176
|
+
})
|
|
2177
|
+
|