dsh-knit 0.24.0 → 0.25.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 +60 -0
- package/README.en.md +2 -2
- package/README.md +7 -5
- package/SECURITY.md +7 -2
- package/package.json +2 -2
- package/src/client/client.js +1147 -22
- package/src/host/attachments.js +245 -0
- package/src/host/index.js +131 -1
- package/test/attachments.test.mjs +285 -0
- package/test/client.test.mjs +1075 -7
- package/test/harness.mjs +12 -0
- package/test/index-incremental.test.mjs +13 -2
|
@@ -0,0 +1,245 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* **对话里「工具产出」的图**(v0.25)。
|
|
3
|
+
*
|
|
4
|
+
* 为什么要这个模块:在对话里生成的图**不在工作区里** —— 它们落在 DSH 的附件库
|
|
5
|
+
* `<dsh home>/attachments/v1/objects/<前两位>/<sha256>`,而 Knit 的扫描只能看会话工作区内,
|
|
6
|
+
* 所以那些图在媒体档里一个都看不到。
|
|
7
|
+
*
|
|
8
|
+
* 为了看到它们,这个模块只走一条**窄路**(与 L1 §6.9 / `SECURITY.md` 同一条纪律):
|
|
9
|
+
*
|
|
10
|
+
* 1. **列表从事件来,不从盘来** —— 会话事件里本来就带着完整元数据
|
|
11
|
+
* (`attachmentId: sha256:…` / `mediaType` / `width` / `height` / `bytes` / `name`),
|
|
12
|
+
* 所以「本会话有哪些图」**零 I/O**。
|
|
13
|
+
* 2. **只认 `tool/result` 里的图** —— 那是工具产出的(模型生成的);用户自己贴的图走
|
|
14
|
+
* `user/message` / `agent/inbox/spliced`,**默认不进媒体档**(隐私更保守)。
|
|
15
|
+
* 3. **字节只按 sha256 读** —— 路由不接受任何路径,只接受 `sha256:<64 hex>`;
|
|
16
|
+
* 而且**只有本会话出现过**的 id 才允许读(跨会话一律 404)。
|
|
17
|
+
* 4. **去重不扫全库** —— 附件 id 就是内容的 sha256,所以「工作区里已经有了吗」只要拿
|
|
18
|
+
* **大小相同**的候选文件算哈希即可(候选来自扫描结果里现成的 `size`,零额外 stat)。
|
|
19
|
+
*
|
|
20
|
+
* 纯函数与 I/O 分离:`attachmentsFromEvent` / `dropSaved` / `objectPath` 都能用假件真断言,
|
|
21
|
+
* 真正读盘只在 `readAttachment` 一处。
|
|
22
|
+
*/
|
|
23
|
+
|
|
24
|
+
import { createHash } from 'node:crypto'
|
|
25
|
+
import { createReadStream } from 'node:fs'
|
|
26
|
+
import { homedir } from 'node:os'
|
|
27
|
+
import { join } from 'node:path'
|
|
28
|
+
|
|
29
|
+
/** 一条附件 id 的**唯一**合法形状。这是整个边界的地基:只认内容哈希,不认路径。 */
|
|
30
|
+
const ATTACHMENT_ID_RE = /^sha256:([0-9a-f]{64})$/
|
|
31
|
+
|
|
32
|
+
/** 每个会话最多记多少条(超了丢最老的)。 */
|
|
33
|
+
const MAX_ATTACHMENTS_PER_SESSION = 200
|
|
34
|
+
/** 最多跟踪多少个会话(LRU;进程重启即失)。 */
|
|
35
|
+
const MAX_TRACKED_SESSIONS = 24
|
|
36
|
+
/** 单个附件的字节上限 —— 与图片上限同档,超过的不列(既不列也不读)。 */
|
|
37
|
+
export const MAX_ATTACHMENT_BYTES = 12 * 1024 * 1024
|
|
38
|
+
|
|
39
|
+
/** 只认这两种媒体类型:媒体档本来就只显示图片与视频。 */
|
|
40
|
+
const MEDIA_RE = /^(image|video)\/[a-z0-9][a-z0-9.+-]*$/i
|
|
41
|
+
|
|
42
|
+
/**
|
|
43
|
+
* 是不是一条合法的附件 id。
|
|
44
|
+
* @param {unknown} value - 候选值
|
|
45
|
+
* @returns {boolean} 合法与否
|
|
46
|
+
*/
|
|
47
|
+
export function isAttachmentId(value) {
|
|
48
|
+
return ATTACHMENT_ID_RE.test(String(value == null ? '' : value))
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* 取出 id 里的十六进制(不合法时回空串)。
|
|
53
|
+
* @param {unknown} value - 候选值
|
|
54
|
+
* @returns {string} 64 位十六进制
|
|
55
|
+
*/
|
|
56
|
+
export function attachmentHex(value) {
|
|
57
|
+
const m = ATTACHMENT_ID_RE.exec(String(value == null ? '' : value))
|
|
58
|
+
return m ? m[1] : ''
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* 附件库的根目录。
|
|
63
|
+
*
|
|
64
|
+
* 优先 `DSH_HOME`(宿主自己也是这么定的),否则 `<用户目录>/.dsh`。
|
|
65
|
+
* **这是本插件唯一一处读工作区之外的地方** —— 见模块顶部那四条边界。
|
|
66
|
+
*
|
|
67
|
+
* @param {Record<string, string|undefined>} [env] - 环境变量(测试可注入)
|
|
68
|
+
* @returns {string} 绝对路径
|
|
69
|
+
*/
|
|
70
|
+
export function attachmentsRoot(env = process.env) {
|
|
71
|
+
const home = env && typeof env.DSH_HOME === 'string' && env.DSH_HOME ? env.DSH_HOME : join(homedir(), '.dsh')
|
|
72
|
+
return join(home, 'attachments', 'v1', 'objects')
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* 一条 id 对应的对象文件路径。
|
|
77
|
+
*
|
|
78
|
+
* 路径**由哈希算出来**(前两位做目录,与 DSH 的布局一致),所以调用方给不出一个
|
|
79
|
+
* 能穿越到别处的路径 —— 不是「校验字符串里有没有 `..`」,而是**根本没有接受路径的入口**。
|
|
80
|
+
*
|
|
81
|
+
* @param {string} root - 附件库根
|
|
82
|
+
* @param {unknown} id - 附件 id
|
|
83
|
+
* @returns {string} 绝对路径(id 不合法时回空串)
|
|
84
|
+
*/
|
|
85
|
+
export function objectPath(root, id) {
|
|
86
|
+
const hex = attachmentHex(id)
|
|
87
|
+
if (!hex || typeof root !== 'string' || !root) return ''
|
|
88
|
+
return join(root, hex.slice(0, 2), hex)
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* 从**一条会话事件**里取出工具产出的图。
|
|
93
|
+
*
|
|
94
|
+
* 只认 `tool/result`:那是工具(模型)产出的。用户自己贴的图在 `user/message` /
|
|
95
|
+
* `agent/inbox/spliced` 里,**这里刻意不收**。
|
|
96
|
+
*
|
|
97
|
+
* @param {object} event - 会话事件
|
|
98
|
+
* @returns {{id:string, name:string, mediaType:string, kind:'image'|'video', width:number, height:number, bytes:number, at:number}[]} 元数据(可能为空)
|
|
99
|
+
*/
|
|
100
|
+
export function attachmentsFromEvent(event) {
|
|
101
|
+
if (!event || event.type !== 'tool/result') return []
|
|
102
|
+
const data = event.data && typeof event.data === 'object' ? event.data : {}
|
|
103
|
+
const message = data.message && typeof data.message === 'object' ? data.message : {}
|
|
104
|
+
const content = Array.isArray(message.content) ? message.content : []
|
|
105
|
+
const out = []
|
|
106
|
+
for (const part of content) {
|
|
107
|
+
if (!part || typeof part !== 'object') continue
|
|
108
|
+
if (part.type !== 'image' && part.type !== 'video') continue
|
|
109
|
+
const meta = part.attachment
|
|
110
|
+
if (!meta || typeof meta !== 'object') continue
|
|
111
|
+
const id = typeof meta.attachmentId === 'string' ? meta.attachmentId : ''
|
|
112
|
+
if (!isAttachmentId(id)) continue
|
|
113
|
+
const mediaType = typeof meta.mediaType === 'string' ? meta.mediaType : ''
|
|
114
|
+
if (!MEDIA_RE.test(mediaType)) continue
|
|
115
|
+
const bytes = Number.isFinite(meta.bytes) ? meta.bytes : 0
|
|
116
|
+
// 太小的多半不是图;太大的**不列也不读**(宁可漏,不去搬 12 MB 以上的东西)
|
|
117
|
+
if (!(bytes > 0) || bytes > MAX_ATTACHMENT_BYTES) continue
|
|
118
|
+
const kind = mediaType.toLowerCase().indexOf('video/') === 0 ? 'video' : 'image'
|
|
119
|
+
const name = typeof meta.name === 'string' && meta.name.trim() ? meta.name.trim() : `attachment-${attachmentHex(id).slice(0, 8)}`
|
|
120
|
+
out.push({
|
|
121
|
+
id,
|
|
122
|
+
name,
|
|
123
|
+
mediaType: mediaType.toLowerCase(),
|
|
124
|
+
kind,
|
|
125
|
+
width: Number.isFinite(meta.width) ? meta.width : 0,
|
|
126
|
+
height: Number.isFinite(meta.height) ? meta.height : 0,
|
|
127
|
+
bytes,
|
|
128
|
+
at: Number.isFinite(event.time) ? event.time : 0,
|
|
129
|
+
})
|
|
130
|
+
}
|
|
131
|
+
return out
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/**
|
|
135
|
+
* 一个**有界**的附件登记簿(只活在内存里,进程重启即失)。
|
|
136
|
+
*
|
|
137
|
+
* 它存在的唯一理由:`/api/attachment` 必须能回答「这个 id 在本会话里出现过吗」。
|
|
138
|
+
* 没有这条判断,任何拿到哈希的人都能读附件库 —— 那就等于开了一个任意读。
|
|
139
|
+
*
|
|
140
|
+
* @param {{maxSessions?:number, maxPerSession?:number}} [options] - 上限
|
|
141
|
+
* @returns {{note:Function, list:Function, get:Function, has:Function, reset:Function, size:number}} 登记簿
|
|
142
|
+
*/
|
|
143
|
+
export function createAttachmentStore(options = {}) {
|
|
144
|
+
const maxSessions = Number.isFinite(options.maxSessions) ? options.maxSessions : MAX_TRACKED_SESSIONS
|
|
145
|
+
const maxPerSession = Number.isFinite(options.maxPerSession) ? options.maxPerSession : MAX_ATTACHMENTS_PER_SESSION
|
|
146
|
+
/** @type {Map<string, Map<string, object>>} 会话 → (id → 元数据),插入顺序即先后 */
|
|
147
|
+
const bySession = new Map()
|
|
148
|
+
|
|
149
|
+
const touch = (sessionId) => {
|
|
150
|
+
let bag = bySession.get(sessionId)
|
|
151
|
+
if (!bag) {
|
|
152
|
+
bag = new Map()
|
|
153
|
+
bySession.set(sessionId, bag)
|
|
154
|
+
} else {
|
|
155
|
+
// 触达即把会话挪到 LRU 队尾
|
|
156
|
+
bySession.delete(sessionId)
|
|
157
|
+
bySession.set(sessionId, bag)
|
|
158
|
+
}
|
|
159
|
+
return bag
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
return {
|
|
163
|
+
/**
|
|
164
|
+
* 记一条事件(不是带图的事件就什么都不做 —— 默认成本是一次类型判断)。
|
|
165
|
+
* @param {string} sessionId - 会话 id
|
|
166
|
+
* @param {object} event - 会话事件
|
|
167
|
+
* @returns {number} 这条事件里记下的图数
|
|
168
|
+
*/
|
|
169
|
+
note(sessionId, event) {
|
|
170
|
+
if (typeof sessionId !== 'string' || !sessionId) return 0
|
|
171
|
+
const items = attachmentsFromEvent(event)
|
|
172
|
+
if (!items.length) return 0
|
|
173
|
+
const bag = touch(sessionId)
|
|
174
|
+
for (const item of items) bag.set(item.id, item)
|
|
175
|
+
while (bag.size > maxPerSession) bag.delete(bag.keys().next().value)
|
|
176
|
+
while (bySession.size > maxSessions) bySession.delete(bySession.keys().next().value)
|
|
177
|
+
return items.length
|
|
178
|
+
},
|
|
179
|
+
/**
|
|
180
|
+
* 本会话登记过的图(按先后顺序)。
|
|
181
|
+
* @param {string} sessionId - 会话 id
|
|
182
|
+
* @returns {object[]} 副本
|
|
183
|
+
*/
|
|
184
|
+
list(sessionId) {
|
|
185
|
+
const bag = bySession.get(sessionId)
|
|
186
|
+
return bag ? [...bag.values()] : []
|
|
187
|
+
},
|
|
188
|
+
/**
|
|
189
|
+
* 取一条(读字节前要用它拿 `mediaType` / `bytes`)。
|
|
190
|
+
* @param {string} sessionId - 会话 id
|
|
191
|
+
* @param {string} id - 附件 id
|
|
192
|
+
* @returns {object|undefined} 元数据
|
|
193
|
+
*/
|
|
194
|
+
get(sessionId, id) {
|
|
195
|
+
const bag = bySession.get(sessionId)
|
|
196
|
+
return bag ? bag.get(id) : undefined
|
|
197
|
+
},
|
|
198
|
+
/**
|
|
199
|
+
* 这个 id 在本会话里出现过吗(**读字节的唯一闸门**)。
|
|
200
|
+
* @param {string} sessionId - 会话 id
|
|
201
|
+
* @param {string} id - 附件 id
|
|
202
|
+
* @returns {boolean} 出现与否
|
|
203
|
+
*/
|
|
204
|
+
has(sessionId, id) {
|
|
205
|
+
return Boolean(this.get(sessionId, id))
|
|
206
|
+
},
|
|
207
|
+
reset() {
|
|
208
|
+
bySession.clear()
|
|
209
|
+
},
|
|
210
|
+
get size() {
|
|
211
|
+
return bySession.size
|
|
212
|
+
},
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
/**
|
|
217
|
+
* 把「工作区里已经有同内容文件」的条目去掉。
|
|
218
|
+
*
|
|
219
|
+
* 附件 id 就是内容的 sha256,所以这里是**内容级**去重,不是文件名去重:
|
|
220
|
+
* 你把图存成什么名字都行,只要字节一样就不会重复出现。
|
|
221
|
+
*
|
|
222
|
+
* 代价刻意压到最低:先按 `bytes` 筛候选(大小不同绝不可能同内容),
|
|
223
|
+
* 只给**大小相同**的那几个候选算哈希 —— 不扫全库、不给每张图算哈希。
|
|
224
|
+
*
|
|
225
|
+
* @param {object[]} items - 本会话登记的图
|
|
226
|
+
* @param {{candidates?:{rel:string,bytes:number}[], sha256Of?:(rel:string)=>Promise<string>|string}} [io] - 候选与哈希器(可注入)
|
|
227
|
+
* @returns {Promise<object[]>} 过滤后的列表
|
|
228
|
+
*/
|
|
229
|
+
export async function dropSaved(items, io = {}) {
|
|
230
|
+
const list = Array.isArray(items) ? items : []
|
|
231
|
+
if (!list.length) return []
|
|
232
|
+
const candidates = Array.isArray(io.candidates) ? io.candidates : []
|
|
233
|
+
const sha256Of = io.sha256Of
|
|
234
|
+
if (!candidates.length || typeof sha256Of !== 'function') return list.slice()
|
|
235
|
+
const sizes = new Set(list.map((item) => item.bytes))
|
|
236
|
+
const suspects = candidates.filter((c) => c && sizes.has(c.bytes))
|
|
237
|
+
if (!suspects.length) return list.slice()
|
|
238
|
+
const saved = new Set()
|
|
239
|
+
for (const candidate of suspects) {
|
|
240
|
+
let hex = ''
|
|
241
|
+
try { hex = await sha256Of(candidate.rel) } catch { hex = '' }
|
|
242
|
+
if (hex) saved.add(hex)
|
|
243
|
+
}
|
|
244
|
+
return list.filter((item) => !saved.has(attachmentHex(item.id)))
|
|
245
|
+
}
|
package/src/host/index.js
CHANGED
|
@@ -13,6 +13,7 @@
|
|
|
13
13
|
*
|
|
14
14
|
* 零模型、零网络出口:只读本地文件与会话日志。
|
|
15
15
|
*/
|
|
16
|
+
import { createHash } from 'node:crypto'
|
|
16
17
|
import { readFile, readdir, stat } from 'node:fs/promises'
|
|
17
18
|
import { createReadStream, realpathSync, statSync } from 'node:fs'
|
|
18
19
|
import { dirname, join, relative, resolve, sep } from 'node:path'
|
|
@@ -26,6 +27,11 @@ import { buildLinkGraph, extractRefsWithLines, linksOf } from './links.js'
|
|
|
26
27
|
// v0.21:关系事实表(谁提到谁)。**同步、零 I/O** —— 只吃记录上现成的 `refs` / `head`。
|
|
27
28
|
// v0.22 修法 ①:`importsOf` 同样提前到读盘时执行,结果进索引的 `refs.imports`。
|
|
28
29
|
import { buildRelationFacts, importsOf } from './relations.js'
|
|
30
|
+
// v0.25:对话里「工具产出」的图(在媒体档里显示)。它**是唯一读工作区之外**的地方,
|
|
31
|
+
// 所以边界全在那个模块里写死:只认 sha256、只认本会话出现过的 id、只读那一个对象文件。
|
|
32
|
+
import {
|
|
33
|
+
createAttachmentStore, isAttachmentId, objectPath, attachmentsRoot, dropSaved, MAX_ATTACHMENT_BYTES,
|
|
34
|
+
} from './attachments.js'
|
|
29
35
|
// v0.21:上下文控制层(固定 / 排除)。**纯逻辑 + 可选持久化**:本文件负责把
|
|
30
36
|
// `ctx.storage`(拿得到才有)递给它,它自己不 import 任何官方包。
|
|
31
37
|
import {
|
|
@@ -2630,6 +2636,74 @@ function sendMedia(req, res, info) {
|
|
|
2630
2636
|
/** 进程内唯一的 feedback store(按会话分片,会话数与篇数都有硬上限)。 */
|
|
2631
2637
|
const feedbackStore = createStore()
|
|
2632
2638
|
|
|
2639
|
+
/**
|
|
2640
|
+
* 本会话「工具产出的图」的登记簿(v0.25)。
|
|
2641
|
+
*
|
|
2642
|
+
* 内存里、有界、进程重启即失 —— 与 feedback 那一套同样只做**事实登记**,不落盘、不发请求。
|
|
2643
|
+
*/
|
|
2644
|
+
const attachmentStore = createAttachmentStore()
|
|
2645
|
+
|
|
2646
|
+
/**
|
|
2647
|
+
* 已经回填过附件的会话(每个会话只回填一次)。
|
|
2648
|
+
*
|
|
2649
|
+
* ⚠️ **这是本文件第 3 处调用 `session.snapshotEvents()`**(前两处:`rankByRelevance` 当检索输入、
|
|
2650
|
+
* v0.17 的 `backfillFeedback`)。那个 API 已被 DSH 标 deprecated(「new production calls are prohibited」),
|
|
2651
|
+
* 所以这里刻意照抄 v0.17 那条例外的三条边界:**一个会话只做一次、同步零 I/O、只读内存**,
|
|
2652
|
+
* 失败一律吞掉(回填坏了不许带影响面板)。
|
|
2653
|
+
*
|
|
2654
|
+
* 为什么非要有它:只靠订阅的话,**插件启动之前**生成的图一条都收不到 —— 用户看到的是一个
|
|
2655
|
+
* 永远空着的列表(`重启 DSH 前的历史全部消失`),那等于没做。
|
|
2656
|
+
*/
|
|
2657
|
+
const attachmentBackfilled = new Set()
|
|
2658
|
+
|
|
2659
|
+
/**
|
|
2660
|
+
* 一次性回填某会话已有的附件(幂等、有界、失败静默)。
|
|
2661
|
+
* @param {object|undefined} session - 宿主会话
|
|
2662
|
+
* @param {string} sessionId - 会话 id
|
|
2663
|
+
* @returns {void}
|
|
2664
|
+
*/
|
|
2665
|
+
function backfillAttachments(session, sessionId) {
|
|
2666
|
+
if (!sessionId || attachmentBackfilled.has(sessionId)) return
|
|
2667
|
+
// ⚠️ 只有「请求里的 id」与「真的解析出这个会话」一致时才回填。
|
|
2668
|
+
// 否则一个伪造的 sessionId 只要解析到**任意**会话,就能把那个会话的图登记到伪造 id 名下 ——
|
|
2669
|
+
// 那等于绕过「读字节必须在本会话出现过」这条闸门。
|
|
2670
|
+
if (!session || session.id !== sessionId) return
|
|
2671
|
+
attachmentBackfilled.add(sessionId)
|
|
2672
|
+
try {
|
|
2673
|
+
if (typeof session.snapshotEvents !== 'function') return
|
|
2674
|
+
const events = session.snapshotEvents() || []
|
|
2675
|
+
for (const event of events) attachmentStore.note(sessionId, event)
|
|
2676
|
+
} catch { /* 回填失败 = 少几张历史图,绝不影响面板 */ }
|
|
2677
|
+
}
|
|
2678
|
+
|
|
2679
|
+
/** 测试用:清空附件登记簿与回填记账。 */
|
|
2680
|
+
export function resetAttachments() {
|
|
2681
|
+
attachmentStore.reset()
|
|
2682
|
+
attachmentBackfilled.clear()
|
|
2683
|
+
}
|
|
2684
|
+
|
|
2685
|
+
/**
|
|
2686
|
+
* 工作区内某个文件的 sha256(十六进制)。**越界一律不读**。
|
|
2687
|
+
* @param {string} root - 工作区根
|
|
2688
|
+
* @param {string} rel - 相对路径
|
|
2689
|
+
* @returns {Promise<string>} 十六进制(读不到回空串)
|
|
2690
|
+
*/
|
|
2691
|
+
async function sha256OfRel(root, rel) {
|
|
2692
|
+
try {
|
|
2693
|
+
const base = resolve(root)
|
|
2694
|
+
const abs = resolve(base, rel)
|
|
2695
|
+
if (abs !== base && !abs.startsWith(base + sep)) return ''
|
|
2696
|
+
const st = await stat(abs)
|
|
2697
|
+
if (!st.isFile() || !(st.size > 0) || st.size > MAX_IMAGE_BYTES) return ''
|
|
2698
|
+
const hash = createHash('sha256')
|
|
2699
|
+
const stream = createReadStream(abs)
|
|
2700
|
+
for await (const chunk of stream) hash.update(chunk)
|
|
2701
|
+
return hash.digest('hex')
|
|
2702
|
+
} catch {
|
|
2703
|
+
return ''
|
|
2704
|
+
}
|
|
2705
|
+
}
|
|
2706
|
+
|
|
2633
2707
|
/**
|
|
2634
2708
|
* 宿主会话注册表(`webCtx.sessions`)的引用,只给**工具**那条路用。
|
|
2635
2709
|
*
|
|
@@ -2692,6 +2766,9 @@ function onSessionEvent(session, event) {
|
|
|
2692
2766
|
try {
|
|
2693
2767
|
const sessionId = session && typeof session.id === 'string' ? session.id : ''
|
|
2694
2768
|
if (!sessionId || !event) return
|
|
2769
|
+
// v0.25:附件收集**不看审计闸门** —— 媒体档要显示工具产出的图,与「使用反馈」
|
|
2770
|
+
// 是两件事。记一条的成本是一次 `event.type` 判断(不是带图的事件立刻返回)。
|
|
2771
|
+
attachmentStore.note(sessionId, event)
|
|
2695
2772
|
if (!isAudited(feedbackStore, sessionId)) return
|
|
2696
2773
|
const root = rootOfSession(session)
|
|
2697
2774
|
// v0.17:成功读被确认的那一刻取一次版本标记。取样只发生在**新事件**上,
|
|
@@ -3169,6 +3246,59 @@ export function apply(ctx) {
|
|
|
3169
3246
|
return
|
|
3170
3247
|
}
|
|
3171
3248
|
|
|
3249
|
+
if (url.pathname === `${ROUTE_PREFIX}/api/attachments`) {
|
|
3250
|
+
/* v0.25:本会话「工具产出」的图(媒体档里显示)。
|
|
3251
|
+
列表**全部来自会话事件**(零 I/O);这里只多做一件事:把「工作区里已经有同内容
|
|
3252
|
+
文件」的条目去掉 —— 先按 `bytes` 筛候选,只给大小相同的候选算 sha256。 */
|
|
3253
|
+
const sessionId = url.searchParams.get('sessionId') || ''
|
|
3254
|
+
backfillAttachments(sessionOf(webCtx, sessionId), sessionId)
|
|
3255
|
+
const items = sessionId ? attachmentStore.list(sessionId) : []
|
|
3256
|
+
if (!items.length) {
|
|
3257
|
+
sendJson(res, 200, { ok: true, items: [] })
|
|
3258
|
+
return
|
|
3259
|
+
}
|
|
3260
|
+
/* ⚠️ 候选必须用**媒体档**扫一遍(`kind: 'media'`):
|
|
3261
|
+
· `contextCorpus` 是「文档 + 代码」,**媒体从不在里面**(媒体不参与 Context Pack);
|
|
3262
|
+
· `allDocs` 是**按档位切开**的 —— `kind: 'context'` 下连一张图都没有(实测)。
|
|
3263
|
+
这次扫描只取 `{rel, bytes}` 两个字段,随后交给 `dropSaved` 按大小筛、只给
|
|
3264
|
+
大小相同的候选算 sha256。扫描结果进备忘也没问题:`contextCorpus` 与档位无关
|
|
3265
|
+
(`collectDocs()` 不分档),所以 `/api/changes` 读到的那份**一字不差**。 */
|
|
3266
|
+
const mediaPayload = await scan(root, 40, {
|
|
3267
|
+
session: sessionOf(webCtx, sessionId), sessionId, sort: 'relevance', kind: 'media',
|
|
3268
|
+
})
|
|
3269
|
+
const scanDocs = (mediaPayload && mediaPayload.allDocs) || []
|
|
3270
|
+
const candidates = scanDocs
|
|
3271
|
+
.filter((doc) => doc && (doc.kind === KIND_IMAGE || doc.kind === KIND_VIDEO))
|
|
3272
|
+
.map((doc) => ({ rel: doc.rel, bytes: Number.isFinite(doc.size) ? doc.size : -1 }))
|
|
3273
|
+
const kept = await dropSaved(items, { candidates, sha256Of: (rel) => sha256OfRel(root, rel) })
|
|
3274
|
+
sendJson(res, 200, { ok: true, items: kept })
|
|
3275
|
+
return
|
|
3276
|
+
}
|
|
3277
|
+
|
|
3278
|
+
if (url.pathname === `${ROUTE_PREFIX}/api/attachment`) {
|
|
3279
|
+
/* v0.25:按 **sha256** 读一个附件对象的字节 —— **本插件唯一越出工作区的读**。
|
|
3280
|
+
三条边界缺一不可:
|
|
3281
|
+
① 只收 `sha256:<64 hex>`,**不接受任何路径**(路径由哈希算出来,给不出穿越);
|
|
3282
|
+
② 这个 id 必须在**本会话**的 `tool/result` 里出现过(跨会话 / 没出现过一律 404);
|
|
3283
|
+
③ 只回图片 / 视频,走既有的 `sendMedia`(nosniff + sandbox CSP)。 */
|
|
3284
|
+
const sessionId = url.searchParams.get('sessionId') || ''
|
|
3285
|
+
const id = url.searchParams.get('id') || ''
|
|
3286
|
+
backfillAttachments(sessionOf(webCtx, sessionId), sessionId)
|
|
3287
|
+
const meta = sessionId && isAttachmentId(id) ? attachmentStore.get(sessionId, id) : undefined
|
|
3288
|
+
if (!meta) {
|
|
3289
|
+
sendJson(res, 404, { ok: false, code: ERROR_CODES.notFound })
|
|
3290
|
+
return
|
|
3291
|
+
}
|
|
3292
|
+
const abs = objectPath(attachmentsRoot(), id)
|
|
3293
|
+
const info = abs ? await stat(abs).catch(() => null) : null
|
|
3294
|
+
if (!info || !info.isFile() || !(info.size > 0) || info.size > MAX_ATTACHMENT_BYTES) {
|
|
3295
|
+
sendJson(res, 404, { ok: false, code: ERROR_CODES.notFound })
|
|
3296
|
+
return
|
|
3297
|
+
}
|
|
3298
|
+
sendMedia(req, res, { abs, type: meta.mediaType, size: info.size })
|
|
3299
|
+
return
|
|
3300
|
+
}
|
|
3301
|
+
|
|
3172
3302
|
sendJson(res, 404, { ok: false, code: ERROR_CODES.notFoundRoute })
|
|
3173
3303
|
} catch (error) {
|
|
3174
3304
|
sendJson(res, 500, { ok: false, code: ERROR_CODES.internal, detail: String((error && error.message) || error) })
|
|
@@ -3177,7 +3307,7 @@ export function apply(ctx) {
|
|
|
3177
3307
|
|
|
3178
3308
|
webCtx.effect(() => {
|
|
3179
3309
|
const unregister = webCtx.webServer.register({ kind: 'prefix', path: ROUTE_PREFIX, handler })
|
|
3180
|
-
console.log(`[${name}] route ready: ${ROUTE_PREFIX}/api/recent, ${ROUTE_PREFIX}/api/doc, ${ROUTE_PREFIX}/api/raw, ${ROUTE_PREFIX}/api/links, ${ROUTE_PREFIX}/api/context, ${ROUTE_PREFIX}/api/changes, ${ROUTE_PREFIX}/api/control (POST)`)
|
|
3310
|
+
console.log(`[${name}] route ready: ${ROUTE_PREFIX}/api/recent, ${ROUTE_PREFIX}/api/doc, ${ROUTE_PREFIX}/api/raw, ${ROUTE_PREFIX}/api/links, ${ROUTE_PREFIX}/api/context, ${ROUTE_PREFIX}/api/changes, ${ROUTE_PREFIX}/api/attachments, ${ROUTE_PREFIX}/api/attachment, ${ROUTE_PREFIX}/api/control (POST)`)
|
|
3181
3311
|
return () => unregister()
|
|
3182
3312
|
}, 'dsh-knit: host route')
|
|
3183
3313
|
})
|