@wszhoho/dsh-file-attachment 0.4.1 → 0.5.1

package/lib/client.js

@@ -28,7 +28,7 @@ window.__ModuleLoader__.load({
 		// ---- 模块级状态：document 监听器 / dock 槽（同步桥）/ overlay 槽（toast）共享 ----
 		let ctxRef = null // apply 时记下 ctx，供远程调用与降级判断
 		const bridge = {
-			shell: null,          // 输入机 shell（insertReference/snapshot），来自当前会话
+			shell: null,          // 输入机 shell（insertText/snapshot），来自当前会话
 			actions: null,        // InputActions（setDraft/addImages...），来自当前会话
 			input: undefined,     // 最新 InputState（draft/phase...），随渲染刷新
 			conversation: undefined, // conversation 服务：登记草稿图片
@@ -49,9 +49,10 @@ window.__ModuleLoader__.load({
 			config: ['json', 'yml', 'yaml', 'toml', 'ini', 'conf', 'cfg', 'env', 'properties', 'xml', 'html', 'css'],
 		}
 		const allowedTypes = { doc: DEFAULT_TYPES.doc.slice(), code: DEFAULT_TYPES.code.slice(), config: DEFAULT_TYPES.config.slice() }
+		// 多模态 VLM 识别参数（仅当前模型非多模态时调用）：baseURL/apiKey/model/thinkingType
+		let vlmCfg = { baseURL: 'https://api.xiaomimimo.com/v1', apiKey: '', model: 'mimo-v2.5', thinkingType: 'disabled' }
 		let allowedExts = null // Set<ext>，rebuildAllowed 填充；上传校验用
-		let acceptString = 'image/*' // 上传按钮 <input accept>，buildAccept 生成
-		const acceptListeners = new Set() // accept 变化订阅（设置页保存 → 上传按钮重渲染）
+		let acceptString = 'image/*' // 文件选择器 <input accept>，buildAccept 生成；劫持📎打开前赋值
 		// 规范化扩展名列表（小写/去点/去重/仅 [a-z0-9]），与 host 侧同逻辑
 		function normalizeList(arr) {
 			const out = []
@@ -71,20 +72,90 @@ window.__ModuleLoader__.load({
 			allowedExts = set
 		}
 		function buildAccept() {
-			const parts = ['image/*']
-			const set = new Set()
-			for (const key of ['doc', 'code', 'config']) for (const ext of allowedTypes[key]) set.add(ext)
-			for (const ext of set) parts.push('.' + ext)
-			return parts.join(',')
+			// 默认所有文件类型可见（浏览器文件选择器不按扩展名过滤）；
+			// 扩展名白名单校验在 runBatch 阶段执行（不在允许列表则 announce 拒绝）。
+			return '*/*'
+		}
+		// ---- 劫持 dsh 原生📎按钮（hero / composer 两模式同一 InputBar，按钮都在加号右侧、modes 左侧）----
+		// 插件不再渲染自己的上传按钮；而是 capture 阶段拦截原生📎 click，改走本插件文件选择器，
+		// ---- 接管 dsh 原生📎：上传入口位于与 dsh 本体完全一致的位置（hero/composer 两模式同一按钮）----
+		// 方案：不劫持📎 click（原生 onClick 会打开 dsh 自己的 fileInput，files 可靠），
+		// 改为劫持 dsh 原生 fileInput 的 change 事件（元素级监听先于 React 冒泡，stopImmediatePropagation 阻断 onPickFiles），
+		// 读 files 后改走本插件 runBatch 管线。修复：自建隐藏 input 的 files 在某些浏览器返回空（count:0）导致上传失效。
+		const hijackedInputs = new WeakSet() // 已挂拦截的原生 fileInput
+		let uploadBusy = false // 文件选择中防重入
+		const nativeFileInputSelector = '[data-composer-card] input[type="file"], [data-composer-card] input[type=file]'
+		function onNativeFileChange(e) {
+			const el = e.currentTarget
+			if (el === null || el === void 0) return
+			const list = el.files
+			if (typeof console !== 'undefined' && console.log) console.log('[dsh-file-attachment] native fileInput change', { count: list === null ? 0 : list.length })
+			if (list === null || list.length === 0) return
+			e.preventDefault()
+			e.stopImmediatePropagation()
+			// FileList 是活对象：el.value='' 会把它清空（length 变 0），必须先快照成数组
+			const files = Array.prototype.slice.call(list)
+			try { el.value = '' } catch (err) { /* 忽略 */ }
+			const images = []
+			const docs = []
+			for (let i = 0; i < files.length; i++) {
+				const f = files[i]
+				if (f.type && f.type.indexOf('image/') === 0) { images.push(f); continue }
+				docs.push({ path: null, name: f.name, isDir: false, file: f })
+			}
+			if (typeof console !== 'undefined' && console.log) console.log('[dsh-file-attachment] native change classified', { images: images.length, docs: docs.length })
+			if (images.length === 0 && docs.length === 0) return
+			uploadBusy = true
+			try {
+				runBatch(images, docs).catch((err) => {
+					console.error('[dsh-file-attachment] runBatch rejected:', err)
+					announce('文件处理失败: ' + (err !== null && err !== void 0 && err.message ? err.message : String(err)))
+				})
+			} finally { uploadBusy = false }
+		}
+		function hijackFileInput(el) {
+			if (hijackedInputs.has(el)) return
+			hijackedInputs.add(el)
+			el.addEventListener('change', onNativeFileChange)
+		}
+		function installNativeAttachHijack() {
+			if (typeof document === 'undefined' || document.body === null || document.body === undefined) return
+			let body
+			try { body = document.body } catch (err) { return }
+			if (!(body instanceof Node)) return
+			const scan = () => {
+				let all = []
+				try { all = Array.from(body.querySelectorAll(nativeFileInputSelector)) } catch (err) { all = [] }
+				for (let i = 0; i < all.length; i++) hijackFileInput(all[i])
+			}
+			scan()
+			const mo = new MutationObserver(() => scan())
+			try { mo.observe(body, { childList: true, subtree: true }) } catch (err) { /* 忽略 */ }
+			// 兜底定时重扫：MutationObserver 偶发漏报（如同一帧内大段替换）时保底
+			const timer = setInterval(scan, 1500)
+			return { mo, timer }
+		}
+		// 客户端侧多模态参数规范化（空值回退默认，与 host normalizeMimo 一致）
+		function normalizeVlmClient(raw) {
+			const d = { baseURL: 'https://api.xiaomimimo.com/v1', apiKey: '', model: 'mimo-v2.5', thinkingType: 'disabled' }
+			if (raw === null || typeof raw !== 'object') return d
+			const pick = (k) => (typeof raw[k] === 'string' && raw[k] !== '') ? raw[k] : d[k]
+			return { baseURL: pick('baseURL'), apiKey: pick('apiKey'), model: pick('model'), thinkingType: raw.thinkingType === 'enabled' ? 'enabled' : 'disabled' }
 		}
-		// 应用配置：更新 allowedTypes → 重建校验 Set + accept → 通知上传按钮重渲染
+		// 应用配置：更新 allowedTypes → 重建校验 Set + accept（劫持📎在打开选择器时读取 acceptString）
 		function applyConfig(cfg) {
-			allowedTypes.doc = normalizeList(cfg && cfg.doc)
-			allowedTypes.code = normalizeList(cfg && cfg.code)
-			allowedTypes.config = normalizeList(cfg && cfg.config)
+			// 空数组/未配置 → 回退默认类型（否则 config 空数组会清空 allowedTypes，文档全被拒）
+			allowedTypes.doc = pickTypes(cfg && cfg.doc, DEFAULT_TYPES.doc)
+			allowedTypes.code = pickTypes(cfg && cfg.code, DEFAULT_TYPES.code)
+			allowedTypes.config = pickTypes(cfg && cfg.config, DEFAULT_TYPES.config)
+			vlmCfg = normalizeVlmClient(cfg && (cfg.vlm || cfg.mimo))
 			rebuildAllowed()
 			acceptString = buildAccept()
-			for (const fn of acceptListeners) { try { fn() } catch (err) { /* 忽略订阅者异常 */ } }
+		}
+		// 配置优先：list 规范化后非空则采用，否则回退默认（allow all 由设置页传 '*' 表达）
+		function pickTypes(list, fallback) {
+			const n = normalizeList(list)
+			return n.length > 0 ? n : fallback.slice()
 		}
 		// 拉取持久化配置；成功覆盖默认，失败保留默认。幂等（复用同一 Promise）
 		let configPromise = null
@@ -118,10 +189,10 @@ window.__ModuleLoader__.load({
 			noticeTimer = setTimeout(() => { noticeTimer = null; if (bridge.noticeText === text) publishNotice(null) }, NOTICE_MS)
 		}
 
-		// ---- 已附加文件（待发送）：runBatch 插入 chip 成功后登记，FaFileDock 渲染，发送后清空 ----
+		// ---- 已附加文件（待发送）：runBatch 插入 @路径 成功后登记，FaAttachments（输入框内附件条）渲染，发送后清空 ----
 		let faSeq = 0
 		const attached = new Map() // id -> { id, name, path, isImage, url, sessionId }
-		const attachedListeners = new Set() // 变化订阅（FaFileDock 重渲染）
+		const attachedListeners = new Set() // 变化订阅（FaAttachments 重渲染）
 		function emitAttached() { for (const fn of attachedListeners) { try { fn() } catch (err) { /* 忽略 */ } } }
 		function attachFile(entry) { attached.set(entry.id, entry); emitAttached() }
 		function detachFile(id) { if (attached.delete(id)) emitAttached() }
@@ -131,38 +202,40 @@ window.__ModuleLoader__.load({
 			if (changed) emitAttached()
 		}
 
-		// 文件条移除时清除草稿中指向给定路径的全部 @引用 chip（同一文件拖多次会留多个 chip，需全清）。
-		// 兼容两代 dsh 输入机：旧版（Lexical）draft 是 clipboard 投影（chip 展开为 @路径 文本），
-		// 新版（纯文本机，chip 外观是文本上的扫描装饰）draft 是纯文本——两代里 occurrence 的
-		// [offset, offset+length) 都是 snap.draft 内的文本区间，故统一 setDraft 整文拼接删除
-		//（新版 consumeToken 的 span 分支内部本就是 setDraft 拼接）。每轮删一个目标区间
-		//（连带 chip 后机器自动补的尾随空格 gap），draftRev 递增后重读 snapshot，循环至无目标。
+		// 附件条移除时清除草稿中指向给定路径的引用。
+		// chip 模式下 snap.draft（clipboardText 投影）包含 chip 的 @完整路径；
+		// setDraft 会清空所有 Lexical 节点（含 chip）重建为纯文本——调用后 chip 变为
+		// @路径 纯文本（TextRefNode 颜色装饰，可发送）。子串须位于行首或前面是空白，
+		// 防误伤用户文本；同一文件拖多次会留多份，循环至无目标。
 		function removeDraftRefs(path) {
 			const shell = bridge.shell
 			if (shell === null || typeof path !== 'string' || path === '') return
 			if (typeof shell.setDraft !== 'function') return
 			const plain = '@' + path
 			const quoted = '@"' + path + '"'
-			const isTarget = (oc) => oc.ref === plain || oc.ref === quoted
-				|| (oc.clipboardText !== void 0 && (oc.clipboardText === plain || oc.clipboardText === quoted))
 			for (let n = 0; n < 64; n++) {
 				const snap = readShellSnapshot(shell)
 				if (snap === null || snap === void 0 || typeof snap.draft !== 'string') break
-				// 发送进行中不动草稿（此时 occurrence 会随发送完成清空）
+				// 发送进行中不动草稿（此时 @引用 会随发送完成清空）
 				if (snap.phase === 'adjudicating' || snap.phase === 'submitting') break
-				// 取第一个有效（类型+边界健全）且指向目标路径的 occurrence，边界失配直接跳过防误伤用户文本
-				const occs = snap.occurrences || []
-				let oc = null
-				for (let i = 0; i < occs.length; i++) {
-					const o = occs[i]
-					if (typeof o.offset !== 'number' || typeof o.length !== 'number' || o.length <= 0) continue
-					if (o.offset < 0 || o.offset + o.length > snap.draft.length) continue
-					if (isTarget(o)) { oc = o; break }
+				const draft = snap.draft
+				let idx = -1
+				for (let i = 0; i <= draft.length; i++) {
+					const p = draft.indexOf(plain, i)
+					if (p === -1) break
+					if (p === 0 || /\s/.test(draft[p - 1])) { idx = p; break }
 				}
-				if (oc === null) break
-				let end = oc.offset + oc.length
-				if (snap.draft.charCodeAt(end) === 32) end += 1 // 吃掉插入 chip 时机器自动补的尾随空格 gap
-				shell.setDraft(snap.draft.slice(0, oc.offset) + snap.draft.slice(end))
+				if (idx === -1) {
+					for (let i = 0; i <= draft.length; i++) {
+						const p = draft.indexOf(quoted, i)
+						if (p === -1) break
+						if (p === 0 || /\s/.test(draft[p - 1])) { idx = p; break }
+					}
+				}
+				if (idx === -1) break
+				let end = idx + plain.length
+				if (draft.charCodeAt(end) === 32) end += 1 // 吃掉插入时补的尾随空格 gap
+				shell.setDraft(draft.slice(0, idx) + draft.slice(end))
 			}
 		}
 
@@ -385,6 +458,7 @@ window.__ModuleLoader__.load({
 			return out
 		}
 
+		// File → dataURL（base64 data: 前缀），供 host /describe 的 VLM 识别
 		// 触发应用自身 drop 浮层的关闭：应用在 window 上监听 dragend 执行 reset()。
 		// 从 OS 拖入时浏览器不派发 dragend，且我们拦截 drop 后应用的 drop 监听收不到事件，浮层会残留。
 		function dismissDropOverlay() {
@@ -407,7 +481,15 @@ window.__ModuleLoader__.load({
 			const docs = [] // { path, name, isDir, file }
 			for (let i = 0; i < files.length; i++) {
 				const file = files[i]
-				if (file.type && file.type.indexOf('image/') === 0) { images.push(file); continue }
+				// File.type 在剪贴板截图场景下可能为空（浏览器未填充 MIME）；
+				// 回退到 DataTransferItem.type 判定，并创建带正确 MIME 的 File 副本，
+				// 确保 createDrafts 的 imageMediaType 校验通过。
+				const effType = file.type || ((items && items[i]) ? items[i].type : '') || ''
+				if (effType.indexOf('image/') === 0) {
+					// file.type 为空时用 items[i].type 补全，生成新 File 对象
+					images.push(file.type ? file : new File([file], file.name || 'image.png', { type: effType }))
+					continue
+				}
 				let entry = null
 				const item = items ? items[i] : null
 				if (item && typeof item.webkitGetAsEntry === 'function') {
@@ -430,7 +512,7 @@ window.__ModuleLoader__.load({
 				announce('输入框不可用')
 				return true
 			}
-			// 有输入桥：接管全部（图片 + 文档统一落盘 → 芯片），彻底绕开 dsh 原生图片发送流程（解 413）
+			// 有输入桥：接管全部（图片与文档统一落盘 → @路径 纯文本，方案 B 绕开 dsh image 能力检查）
 			e.preventDefault()
 			e.stopImmediatePropagation()
 			dismissDropOverlay()
@@ -438,10 +520,12 @@ window.__ModuleLoader__.load({
 			return true
 		}
 
-		// 异步批处理：文档 + 图片统一落盘 → shell.insertReference 芯片（不显示长路径，发送还原 @ 路径）。
-		// 图片先 downscale（≤MAX_DIM，GIF 原样保动画）；目录拒绝；扩展名按配置校验（图片恒允许）。
+		// 异步批处理：文档 + 图片统一落盘 → shell.insertReference chip（label=短文件名显示，clipboardText=@完整路径发送）。
+		// 图片不走 dsh 草稿附件链路（方案 B：文本模型被 dsh 拒绝 image 附件），改与文档同链路：落盘 → chip 引用 → 附件条登记。
+		// 目录拒绝；扩展名按配置校验（图片恒允许）。
 		async function runBatch(images, docs) {
 			const shell = bridge.shell
+			if (typeof console !== 'undefined' && console.log) console.log('[dsh-file-attachment] runBatch start', { images: images.length, docs: docs.length, shell: shell === null ? 'null' : 'ok', mounted: bridge.mounted })
 			if (shell === null || typeof shell.insertReference !== 'function') {
 				announce(`输入框不可用 [mounted:${bridge.mounted} shell:${shell === null ? 'null' : 'ok'} addImg:${typeof bridge.addImages}]`)
 				return
@@ -481,15 +565,63 @@ window.__ModuleLoader__.load({
 				const it = pending[i]
 				try {
 					if (it.isImage) {
-						// 图片完全走 dsh 原生链路：addImages（草稿图片），不缩放/不落盘/不进文件条
-						const addImages = typeof bridge.addImages === 'function' ? bridge.addImages : null
-						if (addImages === null) { failed += 1; continue }
-						let imgErr = null; try { imgErr = addImages([it.file]) } catch (err) { imgErr = err instanceof Error ? err.message : String(err) }
-						if (imgErr) { failed += 1; continue }
-						inserted += 1
+						// 图片：落盘 → @路径 纯文本 + 附件条登记（方案 B：走文件引用链路，
+						// 不触发 dsh 的 image 能力检查，文本模型可正常发送到历史）
+						const data = it.file
+						const name = it.name
+						if (data === null || typeof data.size !== 'number' || data.size === 0) throw new Error('size')
+						if (data.size > MAX_BYTES) throw new Error('size')
+						const buf = await data.arrayBuffer()
+						const b64 = bytesToBase64(new Uint8Array(buf))
+						if (typeof console !== 'undefined' && console.log) console.log('[dsh-file-attachment] before saveFileToHost', { name, b64len: b64.length })
+						const res = await saveFileToHost(name, b64, bridge.sessionId)
+						if (typeof console !== 'undefined' && console.log) console.log('[dsh-file-attachment] saved', res.path)
+						const m = formatMention(res.path, false)
+						const clipboardText = m !== undefined ? m : '@' + res.path
+						// 文件条缩略图：data URL（图片已读入内存（buf），直接用 b64 组装，不重复读文件/不用 FileReader）
+						const mime = data.type && data.type !== '' ? data.type : 'application/octet-stream'
+						const thumbUrl = 'data:' + mime + ';base64,' + b64
+						// 每次插入前重取 snapshot（draftRev 随插入递增，span 取当前末尾）
+						const snap = readShellSnapshot(shell)
+						// 前导分隔空格：聊天记录对 @引用 的 file-chip 渲染（projectUserText）
+						// 要求 @ 前是行首或空白；纯文本 @路径 也遵循同样边界。
+						// 草稿末尾紧贴文字时先补一格，否则发送后聊天记录显示裸 @路径。
+						if (snap !== void 0 && typeof snap.draft === 'string' && snap.draft !== ''
+							&& !isSpace(snap.draft.charCodeAt(snap.draft.length - 1))) {
+							const leadSpan = { draftRev: snap.draftRev, start: snap.draft.length, end: snap.draft.length }
+							if (typeof shell.insertText === 'function') {
+								try { shell.insertText(' ', leadSpan) } catch (err) { /* 忽略：补空格失败不阻塞插入 */ }
+							} else if (typeof shell.setDraft === 'function') {
+								try { shell.setDraft(snap.draft + ' ') } catch (err) { /* 忽略 */ }
+							}
+						}
+						// 补空格会递增 draftRev，重新取快照后再定插入 span。
+						// 关键：insertText 的 span 是 detect 坐标（编辑器实际节点坐标），
+						// draft.length 是投影坐标，纯文本机下两者一致；仍优先 shell.caretSpan()
+						// 拿 detect 坐标（有光标返回光标处，否则返回文档末尾），与历史行为对齐。
+						const snap2 = readShellSnapshot(shell)
+						let span
+						if (typeof shell.caretSpan === 'function') {
+							try {
+								const cs = shell.caretSpan()
+								span = { draftRev: snap2.draftRev, start: cs.start, end: cs.end }
+							} catch (err) {
+								span = { draftRev: snap2.draftRev, start: snap2.draft.length, end: snap2.draft.length }
+							}
+						} else {
+							span = { draftRev: snap2.draftRev, start: snap2.draft.length, end: snap2.draft.length }
+						}
+						// chip 插入：label=短文件名（显示用），clipboardText=@完整路径（发送用）
+						const okInsert = shell.insertReference({ source: 'reference', ref: clipboardText, label: name, appearance: 'file', clipboardText: clipboardText }, span)
+						if (typeof console !== 'undefined' && console.log) console.log('[dsh-file-attachment] image insertReference result', { ok: okInsert, span, name, clipboardText, draftRev: snap2.draftRev })
+						if (okInsert) {
+							inserted += 1
+							// 登记到附件条（图片：data URL 缩略图 + 点击打开；发送后随 @引用 清空）
+							attachFile({ id: 'fa' + (++faSeq), name, path: res.path, isImage: true, url: thumbUrl, sessionId: bridge.sessionId })
+						} else failed += 1
 						continue
 					}
-					// 文档：原样落盘 → @引用芯片 + 文件条登记
+					// 文档：原样落盘 → @路径 纯文本 + 附件条登记
 					const data = it.file
 					const name = it.name
 					if (data === null || typeof data.size !== 'number' || data.size === 0) throw new Error('size')
@@ -502,7 +634,7 @@ window.__ModuleLoader__.load({
 					// 每次插入前重取 snapshot（draftRev 随插入递增，span 取当前末尾）
 					const snap = readShellSnapshot(shell)
 					// 前导分隔空格：聊天记录对 @引用 的 file-chip 渲染（projectUserText）
-					// 要求 @ 前是行首或空白，而 insertReference 只在 chip 后补空格。
+					// 要求 @ 前是行首或空白；纯文本 @路径 也遵循同样边界。
 					// 草稿末尾紧贴文字时先补一格，否则发送后聊天记录显示裸 @路径
 					//（旧版 insertTextAtCaret 的 padStart 同款保底）。
 					if (snap !== void 0 && typeof snap.draft === 'string' && snap.draft !== ''
@@ -511,30 +643,33 @@ window.__ModuleLoader__.load({
 						if (typeof shell.insertText === 'function') {
 							try { shell.insertText(' ', leadSpan) } catch (err) { /* 忽略：补空格失败不阻塞插入 */ }
 						} else if (typeof shell.setDraft === 'function') {
-							// 含 chip 的草稿末尾必为空白（chip 自动尾随空格），故此处必为纯文本，拼接安全
 							try { shell.setDraft(snap.draft + ' ') } catch (err) { /* 忽略 */ }
 						}
 					}
-					// 补空格会递增 draftRev，重新取快照后再定插入 span
+					// 补空格会递增 draftRev，重新取快照后再定插入 span。
+					// 与图片分支同理：insertText 的 span 须为 detect 坐标，优先 shell.caretSpan()。
 					const snap2 = readShellSnapshot(shell)
-					const span = { draftRev: snap2.draftRev, start: snap2.draft.length, end: snap2.draft.length }
-					const okInsert = shell.insertReference(
-						{
-							source: 'reference', // 复用内置已注册的 @引用 source（带 codec.serialize），否则报 no serializer
-							ref: clipboardText, // codec.serialize 原样返回 ref 作为模型文本，故放完整 @路径
-							label: name,
-							appearance: 'file',
-							clipboardText: clipboardText,
-						},
-						span,
-					)
+					let span
+					if (typeof shell.caretSpan === 'function') {
+						try {
+							const cs = shell.caretSpan()
+							span = { draftRev: snap2.draftRev, start: cs.start, end: cs.end }
+						} catch (err) {
+							span = { draftRev: snap2.draftRev, start: snap2.draft.length, end: snap2.draft.length }
+						}
+					} else {
+						span = { draftRev: snap2.draftRev, start: snap2.draft.length, end: snap2.draft.length }
+					}
+					// chip 插入：label=短文件名（显示用），clipboardText=@完整路径（发送用）
+					const okInsert = shell.insertReference({ source: 'reference', ref: clipboardText, label: name, appearance: 'file', clipboardText: clipboardText }, span)
 					if (okInsert) {
 						inserted += 1
-						// 登记到文件条（文档：类型图标 + 点击打开；图片走原生 addImages 不登记）
+						// 登记到附件条（图片：data URL 缩略图；文档：类型图标；发送后随 @引用 清空）
 						attachFile({ id: 'fa' + (++faSeq), name, path: res.path, isImage: false, url: null, sessionId: bridge.sessionId })
 					} else failed += 1
 				} catch (err) {
 					failed += 1
+					if (typeof console !== 'undefined' && console.error) console.error('[dsh-file-attachment] item failed', { name: it && it.name, isImage: it && it.isImage, error: err instanceof Error ? (err.message + '\n' + (err.stack || '')) : String(err) })
 				}
 			}
 			if (inserted === 0) {
@@ -580,6 +715,7 @@ window.__ModuleLoader__.load({
 			react.useEffect(() => {
 				if (bridge.noticeText !== null) setText(bridge.noticeText)
 				bridge.noticeSub = setText
+				if (typeof console !== 'undefined' && console.log) console.log('[dsh-file-attachment] FaToast mounted')
 				return () => { if (bridge.noticeSub === setText) bridge.noticeSub = null }
 			})
 			if (text === null || text === '') return null
@@ -618,15 +754,9 @@ window.__ModuleLoader__.load({
 					if (conversation !== void 0 && actx !== void 0) {
 						shell = conversation.input.for(actx)
 						if (shell !== null) {
-							addImages = (files) => {
-								try {
-									const images = conversation.createDraftImages(files)
-									if (!shell.addImages(images.map((image) => image.id))) conversation.releaseDraftImages(images)
-									return null
-								} catch (error) {
-									return error instanceof Error ? error.message : String(error)
-								}
-							}
+							// 不再注册 dsh 原生附件（createDrafts + addAttachments 会导致原生附件条重复显示）
+							// 插件已接管图片落盘 + chip 引用 + 自定义附件条（FaAttachments）
+							addImages = (files) => { return null }
 						}
 					}
 				}
@@ -638,6 +768,7 @@ window.__ModuleLoader__.load({
 				bridge.input = input
 				bridge.sessionId = sessionId
 				bridge.mounted = true
+				if (typeof console !== 'undefined' && console.log) console.log('[dsh-file-attachment] FaBridge mounted', { sessionId, shell: shell === null ? 'null' : 'ok', addImages: typeof addImages })
 				return () => {
 					bridge.shell = null
 					bridge.addImages = null
@@ -659,8 +790,10 @@ window.__ModuleLoader__.load({
 			)
 		}
 
-		// 文件条（输入框上方 dock）：图片真缩略图 / 文件类型图标，点击用默认程序打开，可移除，发送后自动清空。
-		function FaFileDock() {
+		// 输入框内附件条（conversation.input.attachments 槽，shadow 原生 ComposerAttachments）：
+		// 图片显示真缩略图预览 / 文件仅类型图标；文件名横排显示在缩略图/图标右侧（草稿 @引用 chip
+		// 已改为只留图标不显示文字，避免双份名称）；可移除（先清草稿 @引用 再登记移除）；发送后自动清空。
+		function FaAttachments() {
 			const [, force] = react.useState(0)
 			react.useEffect(() => {
 				const fn = () => force(n => n + 1)
@@ -686,26 +819,25 @@ window.__ModuleLoader__.load({
 			if (entries.length === 0) return null
 			return react.createElement('div', {
 				style: {
-					display: 'flex', flexWrap: 'wrap', gap: '6px', alignItems: 'center',
-					width: '100%', maxWidth: 'calc(var(--dsh-composer-card-max-width, 720px) - 24px)',
-					margin: '0 auto 6px', padding: '2px 4px', boxSizing: 'border-box',
+					display: 'flex', flexWrap: 'wrap', gap: '8px', alignItems: 'center',
+					width: '100%', boxSizing: 'border-box',
 				},
 			},
 				entries.map(e =>
 					react.createElement('div', { key: e.id, style: {
-						display: 'inline-flex', alignItems: 'center', gap: '6px',
+						display: 'inline-flex', alignItems: 'center', gap: '8px',
 						background: 'rgba(128,128,128,0.12)', border: '1px solid rgba(128,128,128,0.2)',
-						borderRadius: '8px', padding: '3px 8px', fontSize: '12px', lineHeight: '1.4', maxWidth: '240px',
+						borderRadius: '10px', padding: '4px 8px', fontSize: '12px', lineHeight: '1.4', maxWidth: '260px',
 					} },
 						e.isImage && e.url
-							? react.createElement('img', { src: e.url, alt: '', style: { width: '20px', height: '20px', objectFit: 'cover', borderRadius: '4px', flex: 'none' } })
+							? react.createElement('img', { src: e.url, alt: e.name, title: e.name, style: { width: '56px', height: '56px', objectFit: 'cover', borderRadius: '8px', flex: 'none', display: 'block' } })
 							: react.createElement('span', { style: { display: 'inline-flex', width: '20px', height: '20px', flex: 'none', color: 'inherit' } }, fileGlyph(e.name)),
 						react.createElement('span', {
 							style: { overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap', minWidth: 0 },
 						}, e.name),
 						react.createElement('span', {
 							onClick: () => {
-								// 先清草稿中指向该文件的全部 @引用 chip，再移除文件条条目
+								// 先清草稿中指向该文件的全部 @引用 chip，再移除附件条条目
 								try { removeDraftRefs(e.path) } catch (err) { /* 忽略：引用清理失败不阻塞移除 */ }
 								detachFile(e.id)
 							},
@@ -717,93 +849,231 @@ window.__ModuleLoader__.load({
 			)
 		}
 
-		// conversation.input.left 槽（操作行左侧动作区，官方扩展点）：文件上传按钮。
-		// 点击触发隐藏 <input type=file multiple>（PC/移动端原生文件选择器，accept 过滤图片+常见文档），
-		// 选中后复用既有 runBatch 管线：文档落盘→@引用插入，图片走 createDraftImages+addImages 草稿机制。
-		// 运行状态经 bridge（FaBridge 在 input.dock 槽填充 actions/input/sessionId，apply 填充 conversation）。
-		function FaUploadButton() {
-			const inputRef = react.useRef(null)
-			const busyState = react.useState(false)
-			const busy = busyState[0]
-			const setBusy = busyState[1]
-			// 订阅 accept 变化（设置页保存配置 → 重渲染，accept 属性随之刷新）
-			const [, forceAccept] = react.useState(0)
+		// ---- 聊天区用户消息渲染器（shadow conversation.chat.node keyed 'user'）----
+		// 需求：图片在聊天区也要预览（缩略图 + 点击放大）；文件自始至终不需要预览（保持 chip）。
+		// 方案 B 下用户消息以 @绝对路径 文本形式落库（无原生附件块），故核心是扫描 text 块内的
+		// @路径：图片路径 → /api/file?path= 缩略图（宿主既有文件服务路由，同 AssistantMarkdown
+		// localPathMediaUrl 机制）；文件路径 → 复刻 dsh projectUserText 的 refChip 样式（无预览）。
+		// 原生 image/file 附件块（多模态模型场景）→ 尽力渲染（renderMessageImages / 文件卡片）。
+		// 本插件自包含（无法 import dsh 包），全部 react.createElement + 内联样式复刻。
+
+		// 图片扩展名集合（与 host IMAGE_EXT 一致：png/jpg/jpeg/gif/webp/bmp）
+		const IMAGE_EXT_SET = new Set(['png', 'jpg', 'jpeg', 'gif', 'webp', 'bmp'])
+		function isImagePath(p) {
+			if (typeof p !== 'string' || p === '') return false
+			const dot = p.lastIndexOf('.')
+			if (dot <= 0) return false
+			return IMAGE_EXT_SET.has(p.slice(dot + 1).toLowerCase())
+		}
+		// 复刻 dsh fileSizeText：字节数 → 人类可读
+		function fileSizeText(bytes) {
+			if (typeof bytes !== 'number' || !isFinite(bytes) || bytes < 0) return ''
+			if (bytes < 1024) return bytes + ' B'
+			if (bytes < 1024 * 1024) return (bytes / 1024).toFixed(1).replace(/\.0$/u, '') + ' KB'
+			if (bytes < 1024 * 1024 * 1024) return (bytes / (1024 * 1024)).toFixed(1).replace(/\.0$/u, '') + ' MB'
+			return (bytes / (1024 * 1024 * 1024)).toFixed(1).replace(/\.0$/u, '') + ' GB'
+		}
+		// 复刻 dsh contentParts：用户消息 content（块数组）拆 text/attachments/rest
+		function contentParts(content) {
+			const texts = []
+			const attachments = []
+			const rest = []
+			if (!Array.isArray(content)) {
+				return { text: (typeof content === 'string' ? content : ''), attachments, rest }
+			}
+			for (const block of content) {
+				const b = (block !== null && typeof block === 'object') ? block : null
+				if (b !== null && b.type === 'text' && typeof b.text === 'string') texts.push(b.text)
+				else if (b !== null && b.type === 'image' && b.attachment !== void 0) attachments.push({ type: 'image', image: b.attachment })
+				else if (b !== null && b.type === 'file' && b.attachment !== void 0) attachments.push({ type: 'file', file: b.attachment })
+				else if (b !== null) rest.push(block)
+			}
+			return { text: texts.join(''), attachments, rest }
+		}
+		// 复刻 dsh projectUserText 的 @路径 正则（含引号形式），扫描 text 中的引用 token。
+		// 返回 [{ start, end, raw, path }]：raw=完整 token（含@），path=去 @ 与前导引号后的路径。
+		function scanRefTokens(text) {
+			const out = []
+			if (typeof text !== 'string' || text === '') return out
+			const re = /(^|\s)(\/[\w-]+(?=\s|$)|@"[^"\n]+"|@[^\s]+)/gu
+			let m = null
+			while ((m = re.exec(text)) !== null) {
+				const tokenStart = m.index + (m[1] || '').length
+				const raw = m[2]
+				if (typeof raw !== 'string' || raw.charAt(0) !== '@') continue // /name 是 skill/command，保持文本
+				let path = raw.slice(1)
+				if (path.charAt(0) === '"' && path.length > 1 && path.charAt(path.length - 1) === '"') path = path.slice(1, -1)
+				out.push({ start: tokenStart, end: tokenStart + raw.length, raw, path })
+			}
+			return out
+		}
+		// 复刻 dsh IconBrowseOutline16 的 SVG path（16×16 viewBox，文件浏览图标，currentColor）
+		function fileBrowseGlyph(size) {
+			return react.createElement('svg', { width: size, height: size, viewBox: '0 0 16 16', fill: 'none', xmlns: 'http://www.w3.org/2000/svg', 'aria-hidden': true, style: { display: 'block' } },
+				react.createElement('path', { d: 'M11.2426 4.80473V6.10551H4.75819V4.80473H11.2426Z', fill: 'currentColor' }),
+				react.createElement('path', { d: 'M9.40858 7.84478V9.14557H4.75819V7.84478H9.40858Z', fill: 'currentColor' }),
+				react.createElement('path', {
+					d: 'M9.23438 0.546389C10.1941 0.546389 10.9683 0.544914 11.5859 0.611819C12.2161 0.680096 12.7634 0.825745 13.2393 1.17139C13.5172 1.3733 13.7619 1.61812 13.9639 1.896C14.3096 2.37183 14.4551 2.91922 14.5234 3.54932C14.5903 4.16686 14.5889 4.94133 14.5889 5.90088V10.0981C14.5889 11.0576 14.5903 11.8321 14.5234 12.4497C14.4552 13.0798 14.3094 13.6272 13.9639 14.103C13.7619 14.381 13.5172 14.6257 13.2393 14.8276C12.7633 15.1734 12.2163 15.3189 11.5859 15.3872C10.9683 15.4541 10.1942 15.4536 9.23438 15.4536H6.76563C5.80591 15.4536 5.03168 15.4541 4.41407 15.3872C3.78385 15.3189 3.23665 15.1734 2.76074 14.8276C2.48291 14.6257 2.23802 14.3809 2.03614 14.103C1.69066 13.6272 1.54483 13.0798 1.47657 12.4497C1.40973 11.8321 1.41114 11.0576 1.41114 10.0981V5.90088C1.41113 4.94132 1.40966 4.16686 1.47657 3.54932C1.54488 2.91921 1.69042 2.37184 2.03614 1.896C2.2381 1.61807 2.4828 1.37333 2.76074 1.17139C3.23665 0.825682 3.78386 0.680109 4.41407 0.611819C5.03168 0.544905 5.80591 0.546389 6.76563 0.546389H9.23438ZM6.76563 1.896C5.77586 1.896 5.0876 1.89738 4.55957 1.95459C4.0443 2.01043 3.76214 2.11349 3.55469 2.26416C3.39135 2.38284 3.24761 2.52662 3.12891 2.68994C2.97821 2.89736 2.8752 3.17967 2.81934 3.69483C2.76214 4.22279 2.76075 4.91131 2.76074 5.90088V10.0981C2.76074 11.0876 2.76221 11.7762 2.81934 12.3042C2.87516 12.8194 2.97829 13.1026 3.12891 13.3101C3.24754 13.4733 3.39147 13.6172 3.55469 13.7358C3.76213 13.8865 4.04438 13.9896 4.55957 14.0454C5.0876 14.1026 5.77586 14.103 6.76563 14.103H9.23438C10.2242 14.103 10.9124 14.1026 11.4404 14.0454C11.9556 13.9896 12.2379 13.8865 12.4453 13.7358C12.6086 13.6172 12.7525 13.4733 12.8711 13.3101C13.0217 13.1026 13.1248 12.8195 13.1807 12.3042C13.2378 11.7762 13.2393 11.0876 13.2393 10.0981V5.90088C13.2393 4.91131 13.2379 4.22279 13.1807 3.69483C13.1248 3.17969 13.0218 2.89736 12.8711 2.68994C12.7524 2.52667 12.6086 2.38281 12.4453 2.26416C12.2379 2.11355 11.9556 2.01041 11.4404 1.95459C10.9124 1.8974 10.2241 1.896 9.23438 1.896H6.76563Z', fill: 'currentColor' }),
+			)
+		}
+		// 聊天区 @文件路径 → refChip（复刻 dsh css.refChip：inline + 主题色 + 图标 + 末段名；无预览）
+		function renderRefChip(raw, path) {
+			let name = path
+			const sl = path.lastIndexOf('/')
+			if (sl >= 0 && sl < path.length - 1) name = path.slice(sl + 1)
+			const isFolder = raw.charAt(raw.length - 1) === '/' || path.charAt(path.length - 1) === '/'
+			return react.createElement('span', {
+				title: raw,
+				style: {
+					display: 'inline', margin: '0 2px', whiteSpace: 'nowrap',
+					color: 'var(--dsw-alias-state-business-primary)', fontWeight: 500,
+				},
+			},
+				react.createElement('span', { style: { display: 'inline-block', width: '1em', height: '1em', marginRight: '4px', verticalAlign: '-0.125em', color: 'inherit' } },
+					fileBrowseGlyph(16)),
+				name,
+			)
+		}
+		// 图片放大预览（Lightbox）：模块级状态，FaUserMessage 缩略图点击打开，FaLightbox 渲染
+		let lightboxSrc = null
+		let lightboxName = ''
+		let lightboxListener = null
+		function openLightbox(src, name) {
+			lightboxSrc = src
+			lightboxName = name || ''
+			if (lightboxListener !== null) lightboxListener()
+		}
+		function FaLightbox() {
+			const [, force] = react.useState(0)
 			react.useEffect(() => {
-				const fn = () => forceAccept((n) => n + 1)
-				acceptListeners.add(fn)
-				return () => { acceptListeners.delete(fn) }
+				lightboxListener = () => force(n => n + 1)
+				return () => { if (lightboxListener !== null) lightboxListener = null }
 			}, [])
-			function onClick() {
-				const el = inputRef.current
-				if (el === null || busy) return
-				el.click()
-			}
-			async function onChange(e) {
-				const list = e.target.files
-				if (list === null || list.length === 0) return
-				const images = []
-				const docs = []
-				for (let i = 0; i < list.length; i++) {
-					const file = list[i]
-					if (file.type && file.type.indexOf('image/') === 0) { images.push(file); continue }
-					docs.push({ path: null, name: file.name, isDir: false, file })
-				}
-				setBusy(true)
-				try {
-					await runBatch(images, docs)
-				} finally {
-					// 重置 input 值，允许再次选择同名文件
-					e.target.value = ''
-					setBusy(false)
+			const src = lightboxSrc
+			if (src === null || src === '') return null
+			const close = () => { openLightbox(null, '') }
+			return react.createElement('div', {
+				onClick: close,
+				style: {
+					position: 'fixed', inset: '0', zIndex: 3000,
+					background: 'rgba(0,0,0,0.74)', display: 'flex', alignItems: 'center', justifyContent: 'center',
+					cursor: 'zoom-out',
+				},
+			},
+				react.createElement('img', { src, alt: lightboxName, style: { maxWidth: '90vw', maxHeight: '90vh', borderRadius: '8px', boxShadow: '0 8px 40px rgba(0,0,0,0.5)' } }),
+				react.createElement('span', {
+					onClick: (e) => { e.stopPropagation(); close() },
+					title: '关闭',
+					style: { position: 'absolute', top: '18px', right: '24px', color: '#fff', fontSize: '30px', cursor: 'pointer', lineHeight: '1', userSelect: 'none' },
+				}, '×'),
+			)
+		}
+		// 宿主文件服务 URL：与 dsh AssistantMarkdown.localPathMediaUrl 同机制
+		function imageUrlFor(path) {
+			return '/api/file?path=' + encodeURIComponent(path)
+		}
+		// 聊天区 @图片路径 → 缩略图（<img /api/file?path=> + 点击放大 Lightbox）
+		function renderImageThumb(path, raw) {
+			const src = imageUrlFor(path)
+			return react.createElement('img', {
+				src,
+				alt: '',
+				title: raw,
+				onClick: () => { openLightbox(src, path) },
+				style: {
+					maxWidth: '240px', maxHeight: '240px', width: 'auto', height: 'auto',
+					objectFit: 'contain', borderRadius: '12px', display: 'inline-block',
+					verticalAlign: 'middle', cursor: 'zoom-in', margin: '2px 2px',
+				},
+			})
+		}
+		// text 块 → 节点序列：普通文本 run + @路径（图片→缩略图 / 文件→chip）
+		function projectTextWithImages(text) {
+			const tokens = scanRefTokens(text)
+			if (tokens.length === 0) return react.createElement('span', null, text)
+			const parts = []
+			let cursor = 0
+			for (const tk of tokens) {
+				if (tk.start > cursor) parts.push(react.createElement('span', { key: 't' + cursor }, text.slice(cursor, tk.start)))
+				if (isImagePath(tk.path)) parts.push(react.createElement('span', { key: 'i' + tk.start }, renderImageThumb(tk.path, tk.raw)))
+				else parts.push(react.createElement('span', { key: 'r' + tk.start }, renderRefChip(tk.raw, tk.path)))
+				cursor = tk.end
+			}
+			if (cursor < text.length) parts.push(react.createElement('span', { key: 't' + cursor }, text.slice(cursor)))
+			return react.createElement(react.Fragment, null, parts)
+		}
+		// 聊天区文件附件块 → 文件卡片（名 + 扩展名/大小 meta；无预览）
+		function renderFileCard(file, key) {
+			const ext = (file && typeof file.name === 'string' ? file.name.lastIndexOf('.') : -1) > 0
+				? String(file.name.slice(file.name.lastIndexOf('.') + 1)).toUpperCase().slice(0, 8)
+				: ''
+			const meta = [ext, fileSizeText(file && file.bytes)].filter(Boolean).join(' ')
+			return react.createElement('span', {
+				key, title: file && file.name,
+				style: {
+					display: 'inline-flex', flex: '0 0 240px', alignItems: 'center', gap: '10px',
+					width: '240px', minHeight: '64px', padding: '8px 12px',
+					border: '0.5px solid var(--dsw-alias-border-l2, rgba(0,0,0,0.12))',
+					borderRadius: '16px', background: 'var(--dsw-specific-input-major, transparent)',
+					boxSizing: 'border-box',
+				},
+			},
+				react.createElement('span', { style: { display: 'inline-flex', width: '20px', height: '20px', flex: 'none' } },
+					fileGlyph(file && file.name ? file.name : 'file')),
+				react.createElement('span', { style: { display: 'flex', flexDirection: 'column', minWidth: 0 } },
+					react.createElement('span', { style: { fontSize: '13px', fontWeight: 500, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' } }, file && file.name),
+					react.createElement('span', { style: { fontSize: '11px', opacity: 0.7 } }, meta),
+				),
+			)
+		}
+		// 聊天区用户消息渲染器：气泡 + @图片缩略图预览 / @文件 chip；附件块尽力渲染
+		function FaUserMessage(props) {
+			const node = props && props.node
+			const data = node ? node.data : null
+			const content = data ? data.content : []
+			const renderMessageImages = props && props.renderMessageImages
+			const { text, attachments, rest } = contentParts(content)
+			const showBubble = text !== '' || rest.length > 0
+			const rows = []
+			// 附件块（image → 原生缩略图画廊 / file → 文件卡片）
+			for (let i = 0; i < attachments.length; i++) {
+				const a = attachments[i]
+				if (a.type === 'image') {
+					// 原生 image 附件块：交 dsh 缩略图画廊渲染（ChatNodeOwnerProps.renderMessageImages，
+					// 由 CHAT_NODE_INJECT 注入，宿主必有）
+					if (typeof renderMessageImages === 'function') {
+						rows.push(react.createElement(react.Fragment, { key: 'image:' + i }, renderMessageImages({ images: [{ attachment: a.image }], align: 'end', compact: attachments.length > 1 })))
+					}
+				} else {
+					rows.push(renderFileCard(a.file, 'file:' + i))
 				}
 			}
-			return react.createElement('span', { style: { display: 'inline-flex', alignItems: 'center' } },
-				react.createElement('input', {
-					ref: inputRef,
-					type: 'file',
-					multiple: true,
-					accept: acceptString,
-					style: { display: 'none' },
-					onChange: onChange,
-				}),
-				react.createElement('button', {
-					type: 'button',
-					title: '上传文件',
-					'aria-label': '上传文件',
-					disabled: busy,
-					onClick: onClick,
+			// 气泡（text + rest）
+			if (showBubble) {
+				rows.push(react.createElement('div', {
+					key: 'bubble',
 					style: {
-						display: 'inline-flex', alignItems: 'center', justifyContent: 'center',
-						width: '28px', height: '28px', padding: 0, margin: 0, border: 'none',
-						// 与 dsh 输入栏加号按钮同款（InputBar.module.css .add）：全圆 + selector 填充，无阴影
-					background: 'var(--dsw-specific-selector, rgba(128,128,128,0.10))',
-					color: 'var(--dsw-alias-label-primary, currentColor)',
-						cursor: busy ? 'default' : 'pointer', borderRadius: '999px',
-						opacity: busy ? 0.45 : 1, transition: 'background 120ms ease, opacity 120ms ease',
+						maxWidth: '100%', background: 'var(--dsw-specific-bubble)', borderRadius: '22px',
+						padding: '10px 16px', fontSize: 'var(--dsh-content-font-size, 14px)',
+						lineHeight: 'calc(22px + var(--dsh-content-font-delta, 0px))',
+						whiteSpace: 'pre-wrap', wordBreak: 'break-word',
 					},
-					onMouseEnter: (ev) => { if (!busy) ev.currentTarget.style.background = 'var(--dsw-alias-interactive-bg-hover-solid, rgba(128,128,128,0.16))' },
-					onMouseLeave: (ev) => { ev.currentTarget.style.background = 'var(--dsw-specific-selector, rgba(128,128,128,0.10))' },
 				},
-					react.createElement('svg', {
-						// 回形针按用户反馈取 12px（比加号 14px 小 2px）；描边 2/24×12≈1px
-					width: 12, height: 12, viewBox: '0 0 24 24', fill: 'none',
-						'aria-hidden': true, style: { display: 'block' },
-					},
-						react.createElement('path', {
-							d: 'm21.44 12.05-9.19 9.19a6 6 0 0 1-8.49-8.49l8.57-8.57A4 4 0 1 1 18 8.84l-8.59 8.57a2 2 0 0 1-2.83-2.83l8.49-8.48',
-							stroke: 'currentColor', strokeWidth: 2,
-							strokeLinecap: 'round', strokeLinejoin: 'round',
-						})
-					)
-				)
+					projectTextWithImages(text),
+					rest.map((block, i) => {
+						let label = ''
+						try { label = JSON.stringify(block) } catch (err) { label = String(block) }
+						if (label.length > 200) label = label.slice(0, 200) + '…'
+						return react.createElement('div', { key: 'rest' + i, style: { fontSize: '12px', opacity: 0.75, marginTop: '4px' } }, label)
+					}),
+				))
+			}
+			if (rows.length === 0) return null
+			return react.createElement('div', { style: { display: 'flex', flexDirection: 'column', alignItems: 'flex-end', gap: '6px' } },
+				react.createElement('div', { style: { display: 'flex', flexDirection: 'column', alignItems: 'flex-end', gap: '8px', minWidth: 0, maxWidth: 'min(calc(var(--dsh-chat-content-width, 748px) * 0.702), 82%)' } }, rows),
 			)
 		}
 
-		// 扩展名规范化：小写/去前导点/仅 [a-z0-9]；非法返回 null
-		function normExt(v) {
-			const s = String(v == null ? '' : v).trim().toLowerCase().replace(/^\.+/u, '')
-			return (s !== '' && /^[a-z0-9]+$/u.test(s)) ? s : null
-		}
 		function addExt(setList, value, current) {
 			const s = normExt(value)
 			if (s === null || current.indexOf(s) >= 0) return
@@ -855,11 +1125,20 @@ window.__ModuleLoader__.load({
 			)
 		}
 
+		// 扩展名规范化：小写/去前导点/仅 [a-z0-9]；非法返回 null
+		function normExt(v) {
+			const s = String(v == null ? '' : v).trim().toLowerCase().replace(/^\.+/u, '')
+			return (s !== '' && /^[a-z0-9]+$/u.test(s)) ? s : null
+		}
 		// 设置页：配置可上传的文档/代码/配置文件扩展名，保存写 ~/.dsh/file-attachment.json
 		function FaSettingsPage() {
 			const [doc, setDoc] = react.useState(DEFAULT_TYPES.doc.slice())
 			const [code, setCode] = react.useState(DEFAULT_TYPES.code.slice())
 			const [config, setConfig] = react.useState(DEFAULT_TYPES.config.slice())
+			const [vlmBaseURL, setVlmBaseURL] = react.useState('')
+			const [vlmApiKey, setVlmApiKey] = react.useState('')
+			const [vlmModel, setVlmModel] = react.useState('')
+			const [vlmThinking, setVlmThinking] = react.useState(false)
 			const [docIn, setDocIn] = react.useState('')
 			const [codeIn, setCodeIn] = react.useState('')
 			const [cfgIn, setCfgIn] = react.useState('')
@@ -873,6 +1152,10 @@ window.__ModuleLoader__.load({
 					setDoc(allowedTypes.doc.slice())
 					setCode(allowedTypes.code.slice())
 					setConfig(allowedTypes.config.slice())
+					setVlmBaseURL(vlmCfg.baseURL)
+					setVlmApiKey(vlmCfg.apiKey)
+					setVlmModel(vlmCfg.model)
+					setVlmThinking(vlmCfg.thinkingType === 'enabled')
 				})
 				return () => { live = false }
 			}, [])
@@ -885,7 +1168,7 @@ window.__ModuleLoader__.load({
 			async function save() {
 				setSaving(true); setSaved(false)
 				try {
-					const body = { doc: doc, code: code, config: config }
+					const body = { doc: doc, code: code, config: config, vlm: { baseURL: vlmBaseURL, apiKey: vlmApiKey, model: vlmModel, thinkingType: vlmThinking ? 'enabled' : 'disabled' } }
 					const r = await fetch('/dsh-file-attachment/config', {
 						method: 'POST',
 						headers: { 'Content-Type': 'application/json' },
@@ -908,6 +1191,23 @@ window.__ModuleLoader__.load({
 				react.createElement(FaExtGroup, { title: t('doc.title'), list: doc, setList: setDoc, input: docIn, setInput: setDocIn }),
 				react.createElement(FaExtGroup, { title: t('code.title'), list: code, setList: setCode, input: codeIn, setInput: setCodeIn }),
 				react.createElement(FaExtGroup, { title: t('config.title'), list: config, setList: setConfig, input: cfgIn, setInput: setCfgIn }),
+				react.createElement('div', { style: { margin: '16px 0', padding: '12px', borderRadius: '8px', background: 'rgba(128,128,128,0.08)', border: '1px solid rgba(128,128,128,0.15)' } },
+					react.createElement('div', { style: { marginBottom: '8px', fontSize: '13px', fontWeight: '600' } }, t('vlm.title')),
+					react.createElement('div', { style: { marginBottom: '10px', fontSize: '12px', color: 'rgba(128,128,128,0.9)' } }, t('vlm.hint')),
+					react.createElement('div', { style: { display: 'grid', gridTemplateColumns: '110px 1fr', gap: '8px 10px', alignItems: 'center' } },
+						react.createElement('span', { style: { fontSize: '12px' } }, t('vlm.baseURL')),
+						react.createElement('input', { value: vlmBaseURL, onChange: (e) => setVlmBaseURL(e.target.value), placeholder: 'https://api.xiaomimimo.com/v1', style: { padding: '6px 8px', borderRadius: '6px', border: '1px solid rgba(128,128,128,0.3)', background: 'transparent', color: 'inherit', fontSize: '12px' } }),
+						react.createElement('span', { style: { fontSize: '12px' } }, t('vlm.apiKey')),
+						react.createElement('input', { value: vlmApiKey, onChange: (e) => setVlmApiKey(e.target.value), type: 'password', placeholder: 'sk-...', style: { padding: '6px 8px', borderRadius: '6px', border: '1px solid rgba(128,128,128,0.3)', background: 'transparent', color: 'inherit', fontSize: '12px' } }),
+						react.createElement('span', { style: { fontSize: '12px' } }, t('vlm.model')),
+						react.createElement('input', { value: vlmModel, onChange: (e) => setVlmModel(e.target.value), placeholder: 'mimo-v2.5', style: { padding: '6px 8px', borderRadius: '6px', border: '1px solid rgba(128,128,128,0.3)', background: 'transparent', color: 'inherit', fontSize: '12px' } }),
+						react.createElement('span', { style: { fontSize: '12px' } }),
+						react.createElement('label', { style: { display: 'inline-flex', alignItems: 'center', gap: '6px', fontSize: '12px' } },
+							react.createElement('input', { type: 'checkbox', checked: vlmThinking, onChange: (e) => setVlmThinking(e.target.checked) }),
+							t('vlm.thinking'),
+						),
+					),
+				),
 				react.createElement('div', { style: { display: 'flex', alignItems: 'center', gap: '12px' } },
 					react.createElement('button', {
 						type: 'button', onClick: save, disabled: saving,
@@ -924,6 +1224,7 @@ window.__ModuleLoader__.load({
 
 		function apply(ctx) {
 			ctxRef = ctx
+			if (typeof console !== 'undefined' && console.log) console.log('[dsh-file-attachment] apply', { hasSlots: ctx.get('slots') !== undefined, hasConversation: ctx.get('conversation') !== undefined })
 			// 接入即拉持久化配置（幂等）：让自定义类型每次会话生效，而非仅打开设置页才加载
 			void loadConfig()
 			// 注册设置页文案（zh/en）
@@ -934,6 +1235,12 @@ window.__ModuleLoader__.load({
 					'doc.title': '文档',
 					'code.title': '代码',
 					'config.title': '配置文件',
+					'vlm.title': '多模态识别参数',
+					'vlm.hint': '当前会话模型不支持多模态时，粘贴图片将调用此 VLM 生成描述回填草稿；支持多模态则模型直接看图，不调用。',
+					'vlm.baseURL': 'Base URL',
+					'vlm.apiKey': 'API Key',
+					'vlm.model': '模型',
+					'vlm.thinking': '启用思考模式（默认禁用）',
 					'save': '保存',
 					'saving': '保存中…',
 					'saved': '已保存',
@@ -944,6 +1251,12 @@ window.__ModuleLoader__.load({
 					'doc.title': 'Documents',
 					'code.title': 'Code',
 					'config.title': 'Config Files',
+					'vlm.title': 'Multimodal VLM',
+					'vlm.hint': 'When the session model is not multimodal, pasted images are described by this VLM and appended to the draft; multimodal models read images directly (no call).',
+					'vlm.baseURL': 'Base URL',
+					'vlm.apiKey': 'API Key',
+					'vlm.model': 'Model',
+					'vlm.thinking': 'Enable thinking mode (disabled by default)',
 					'save': 'Save',
 					'saving': 'Saving…',
 					'saved': 'Saved',
@@ -965,19 +1278,27 @@ window.__ModuleLoader__.load({
 					},
 					FaBridge
 				))
-				// 文件条：渲染已附加文件（缩略图/类型图标 + 点击打开 + 可移除），发送后清空
-				slots.inject('conversation.input.dock', () => slots.register(
-					{ name: 'conversation.input.dock', id: 'dsh-file-attachment-dock', order: 400 },
-					FaFileDock
+				// 输入框内附件条：shadow 原生 ComposerAttachments（priority -100 < ui-attachment 的 0，
+				// lowest wins），图片缩略图预览 / 文件条目（无预览），发送后清空
+				slots.inject('conversation.input.attachments', () => slots.register(
+					{ name: 'conversation.input.attachments', id: 'dsh-file-attachment-attachments', priority: -100 },
+					FaAttachments
+				))
+				// 聊天区用户消息：shadow 原生 UserMessageNodeView（keyed 'user'，priority -100 < 0，
+				// lowest wins；Reusing a key replaces that node renderer），@图片路径→缩略图预览，
+				// @文件路径→chip（无预览）
+				slots.inject('conversation.chat.node', () => slots.register(
+					{ name: 'conversation.chat.node', key: 'user', priority: -100 },
+					FaUserMessage
 				))
 				slots.inject('shell.overlay', () => slots.register(
 					{ name: 'shell.overlay', id: 'dsh-file-attachment-toast', order: 100 },
 					FaToast
 				))
-				// 操作行左侧动作区（官方扩展点）：文件上传按钮，复用既有 runBatch 管线
-				slots.inject('conversation.input.left', () => slots.register(
-					{ name: 'conversation.input.left', id: 'dsh-file-attachment-upload', order: 10 },
-					FaUploadButton
+				// 图片放大预览（Lightbox）：list 槽，与 toast 共存（order 200 渲染在 toast 之上）
+				slots.inject('shell.overlay', () => slots.register(
+					{ name: 'shell.overlay', id: 'dsh-file-attachment-lightbox', order: 200 },
+					FaLightbox
 				))
 				// 设置页：文件附件类型配置（左侧菜单项 + 右侧配置页）
 				slots.inject('settings.section', () => [
@@ -990,6 +1311,17 @@ window.__ModuleLoader__.load({
 				])
 			}
 			bridge.conversation = ctx.get('conversation')
+			// 劫持 dsh 原生📎：让上传入口位于与 dsh 本体一致的位置（hero/composer 两模式同一按钮），
+			// 点击改走本插件文件选择器；MutationObserver + 定时重扫随 ctx.effect 生命周期清理
+			ctx.effect(() => {
+				const h = installNativeAttachHijack()
+				return () => {
+					if (h !== null && h !== void 0) {
+						try { h.mo.disconnect() } catch (err) { /* 忽略 */ }
+						try { clearInterval(h.timer) } catch (err) { /* 忽略 */ }
+					}
+				}
+			}, 'dsh-file-attachment: native attach hijack')
 			// document 级 capture 监听：dragenter/drop/paste 都先于既有 bubble 监听器；随 Fiber 停止
 			ctx.effect(() => {
 				document.addEventListener('dragenter', onDragEnterCap, true)

package/lib/index.js

@@ -7,10 +7,11 @@
 import { access, mkdir, readFile, writeFile } from 'node:fs/promises'
 import { homedir } from 'node:os'
 import { join, resolve } from 'node:path'
+import { defineTool } from '@deepseek-ai/dsh-tools'
 
 /** 本包声明依赖的 Host 服务。 */
 export const name = 'dsh-file-attachment'
-export const inject = ['webServer']
+export const inject = ['webServer', 'tools']
 
 // 临时目录名：落在会话工作区根下；每个项目都能看到自己引用过的文档
 const ATTACHMENT_DIR = '.dsh-file-attachment'
@@ -136,27 +137,50 @@ function normalizeTypeList(arr) {
   return out
 }
 
-/** 读取配置；文件缺失/损坏时回退默认值（保持三类齐全）。 */
+// 多模态识别（VLM）默认参数：用户在「设置→文件附件」可覆盖；空值回退默认，保证开箱可用。
+const VLM_DEFAULTS = {
+  baseURL: 'https://api.xiaomimimo.com/v1',
+  apiKey: '',
+  model: 'mimo-v2.5',
+  thinkingType: 'disabled',
+}
+
+/** 规范化多模态参数（缺省/空值回退默认，trim 去空白）。 */
+function normalizeVlm(raw) {
+  const r = (raw && typeof raw === 'object') ? raw : {}
+  const pick = (key) => (typeof r[key] === 'string' && r[key].trim() !== '' ? r[key].trim() : VLM_DEFAULTS[key])
+  return {
+    baseURL: pick('baseURL'),
+    apiKey: pick('apiKey'),
+    model: pick('model'),
+    thinkingType: pick('thinkingType'),
+  }
+}
+
+/** 读取配置；文件缺失/损坏时回退默认值（保持三类 + 多模态参数齐全）。 */
 async function readConfig() {
+  let stored = {}
   try {
     const text = await readFile(CONFIG_PATH, 'utf8')
-    const doc = JSON.parse(text)
-    return {
-      doc: normalizeTypeList(doc && doc.doc),
-      code: normalizeTypeList(doc && doc.code),
-      config: normalizeTypeList(doc && doc.config),
-    }
+    stored = JSON.parse(text) || {}
   } catch (err) {
-    return { doc: [...DEFAULT_TYPES.doc], code: [...DEFAULT_TYPES.code], config: [...DEFAULT_TYPES.config] }
+    stored = {}
+  }
+  return {
+    doc: normalizeTypeList(stored.doc),
+    code: normalizeTypeList(stored.code),
+    config: normalizeTypeList(stored.config),
+    vlm: normalizeVlm(stored.vlm || stored.mimo),
   }
 }
 
-/** 保存配置（全量覆盖三类）；返回规范化后的配置。 */
+/** 保存配置（全量覆盖三类 + 多模态参数）；返回规范化后的配置。 */
 async function writeConfig(body) {
   const next = {
     doc: normalizeTypeList(body && body.doc),
     code: normalizeTypeList(body && body.code),
     config: normalizeTypeList(body && body.config),
+    vlm: normalizeVlm(body && (body.vlm || body.mimo)),
   }
   await writeFile(CONFIG_PATH, JSON.stringify(next, null, 2) + '\n', 'utf8')
   return next
@@ -195,6 +219,48 @@ async function handleSave(root, body) {
   return { path: target, dir, name: safe, size: bytes.length }
 }
 
+/**
+ * 调 VLM（OpenAI 兼容 chat/completions）识别图片，返回中文描述。
+ * @param vlm - 多模态参数 { baseURL, apiKey, model, thinkingType }（来自配置）。
+ * @param dataUrl - base64 data URL（形如 data:image/png;base64,xxx）。
+ * @returns 图片的简洁中文描述。
+ * @throws VLM 请求失败或未返回有效内容时抛错。
+ */
+async function describeImage(vlm, dataUrl, prompt) {
+  const url = vlm.baseURL.replace(/\/+$/u, '') + '/chat/completions'
+  const userPrompt = (typeof prompt === 'string' && prompt.trim() !== '') ? prompt.trim() : '请描述这张图片。'
+  const payload = {
+    model: vlm.model,
+    thinkingType: vlm.thinkingType,
+    messages: [
+      { role: 'system', content: '你是图片描述助手，用简洁中文回答。' },
+      {
+        role: 'user',
+        content: [
+          { type: 'text', text: userPrompt },
+          { type: 'image_url', image_url: { url: dataUrl } },
+        ],
+      },
+    ],
+  }
+  const resp = await fetch(url, {
+    method: 'POST',
+    headers: {
+      'content-type': 'application/json',
+      'authorization': 'Bearer ' + vlm.apiKey,
+    },
+    body: JSON.stringify(payload),
+  })
+  if (!resp.ok) {
+    const text = await resp.text().catch(() => '')
+    throw new Error('VLM 请求失败 ' + resp.status + (text !== '' ? ' ' + text.slice(0, 200) : ''))
+  }
+  const data = await resp.json()
+  const content = data && data.choices && data.choices[0] && data.choices[0].message && data.choices[0].message.content
+  if (typeof content !== 'string' || content === '') throw new Error('VLM 未返回有效内容')
+  return content
+}
+
 /** 注册 /dsh-file-attachment 前缀路由（save POST）。 */
 function registerRoutes(ctx) {
   const webserver = ctx.get('webServer')
@@ -242,15 +308,122 @@ function registerRoutes(ctx) {
         json(res, { ok: true, value: { saved: true, config: value } })
         return
       }
-      json(res, { ok: false, error: 'only POST /dsh-file-attachment/save and GET/POST /dsh-file-attachment/config are allowed' }, 405)
+      if (req.method === 'POST' && pathname === '/dsh-file-attachment/describe') {
+        const body = await readJsonBody(req, MAX_BODY_BYTES)
+        if (body === null || typeof body !== 'object') {
+          json(res, { ok: false, error: '请求体必须是 JSON（68MB 内）' }, 400)
+          return
+        }
+        const dataUrl = typeof body.dataUrl === 'string' ? body.dataUrl : ''
+        if (dataUrl === '') {
+          json(res, { ok: false, error: 'dataUrl 必须是非空字符串（base64 data URL）' }, 400)
+          return
+        }
+        const cfg = await readConfig()
+        const vlm = cfg.vlm
+        if (vlm.apiKey === '') {
+          json(res, { ok: false, error: '未配置多模态 API Key（设置→文件附件填写）' }, 400)
+          return
+        }
+        try {
+          const description = await describeImage(vlm, dataUrl, body.prompt)
+          json(res, { ok: true, value: { description } })
+          return
+        } catch (err) {
+          const message = err && err.message ? err.message : '识别失败'
+          json(res, { ok: false, error: message }, 502)
+          return
+        }
+      }
+      json(res, { ok: false, error: 'only POST /dsh-file-attachment/save、GET/POST /dsh-file-attachment/config 与 POST /dsh-file-attachment/describe are allowed' }, 405)
     },
   })
 }
 
+// 图片扩展名判定（describe_image 工具用）
+const IMAGE_EXT = /\.(png|jpe?g|gif|webp|bmp)$/iu
+
+/** 按扩展名推断 MIME（缺省 image/png）。 */
+function mimeFromPath(p) {
+  const ext = String(p ?? '').toLowerCase().split('.').pop() || ''
+  switch (ext) {
+    case 'jpg':
+    case 'jpeg': return 'image/jpeg'
+    case 'png': return 'image/png'
+    case 'webp': return 'image/webp'
+    case 'gif': return 'image/gif'
+    case 'bmp': return 'image/bmp'
+    default: return 'image/png'
+  }
+}
+
+/**
+ * 注册 describe_image 工具：模型看到用户消息里的图片路径引用（@/绝对路径）时调用，
+ * 读图片 → 调 VLM 识别 → 识别结果直接作为工具输出返回：
+ * UI 展示描述文本，同时该输出即模型可见内容（tool/result 的 content 是 model-facing）。
+ */
+function registerTools(ctx) {
+  const tools = (ctx !== undefined && ctx !== null && typeof ctx.tools === 'object' && ctx.tools !== null)
+    ? ctx.tools
+    : (typeof ctx.get === 'function' ? ctx.get('tools') : undefined)
+  if (tools === undefined || typeof tools.register !== 'function') {
+    console.warn('[dsh-file-attachment] tools 服务不可用，跳过 describe_image 注册')
+    return
+  }
+  tools.register(defineTool({
+    name: 'describe_image',
+    description: '当用户消息里出现图片路径引用（形如 @/绝对路径，扩展名 png/jpg/jpeg/gif/webp/bmp）且需要理解图片内容时调用此工具，获取该图片的中文内容描述。path 参数填去掉前导 @ 的绝对路径。prompt 可选，指定要关注的内容（如"识别图中文字"、"描述 UI 布局"）。',
+    parameters: {
+      path: {
+        type: 'string',
+        required: true,
+        description: '图片文件的绝对路径（去掉前导 @）',
+      },
+      prompt: {
+        type: 'string',
+        description: '可选。告诉多模态模型要关注什么（如"识别图中的文字"、"描述 UI 布局"）。不填则默认"请描述这张图片"。',
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          ok: { type: 'boolean', required: true },
+          description: { type: 'string' },
+        },
+      },
+      render: (_args, value) => {
+        if (value && value.ok === true && typeof value.description === 'string' && value.description !== '') {
+          return [{ type: 'text', text: '图片识别结果：' + value.description }]
+        }
+        return [{ type: 'text', text: (value && value.ok === true) ? '（图片已识别）' : '（图片识别失败）' }]
+      },
+    },
+    async execute(args, exec) {
+      let path = typeof args.path === 'string' ? args.path.trim() : ''
+      if (path.startsWith('@')) path = path.slice(1)
+      if (path === '') throw new Error('path 不能为空')
+      if (!IMAGE_EXT.test(path)) throw new Error('path 不是受支持的图片（png/jpg/jpeg/gif/webp/bmp）')
+      const bytes = await readFile(path)
+      if (bytes.length === 0) throw new Error('图片文件为空')
+      const dataUrl = 'data:' + mimeFromPath(path) + ';base64,' + bytes.toString('base64')
+      const cfg = await readConfig()
+      if (cfg.vlm.apiKey === '') throw new Error('未配置多模态 API Key（设置→文件附件填写），无法识别图片')
+      const description = await describeImage(cfg.vlm, dataUrl, args.prompt)
+      // 识别结果直接作为工具输出返回：UI 直接展示描述文本，
+      // 同时该输出就是模型可见内容（tool/result 的 content），无需额外 deferContext 注入。
+      return { ok: true, description }
+    },
+  }))
+  console.log('[dsh-file-attachment] describe_image tool registered')
+}
+
 /**
- * @param ctx - 宿主上下文（webServer 注入）。
+ * @param ctx - 宿主上下文（webServer + tools 注入）。
  */
 export function apply(ctx, config = {}) {
+  registerTools(ctx)
   registerRoutes(ctx)
-  console.log('[dsh-file-attachment] host loaded (webServer routes)')
+  console.log('[dsh-file-attachment] host loaded (webServer routes + describe_image tool)')
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wszhoho/dsh-file-attachment",
-  "version": "0.4.1",
-  "description": "文件附件：输入框上传按钮 + 拖拽/粘贴文件（支持多文件）；图片走 dsh 原生图片草稿机制（addImages，不缩放/不落盘），文档落盘到 .dsh-file-attachment 并以芯片 @短名 引用（发送时还原 @绝对路径）；文档/代码/配置文件可上传类型可在设置页配置；支持 PC 与移动端浏览器",
+  "version": "0.5.1",
+  "description": "文件附件：拖拽/粘贴/上传文件（支持多文件）；图片与文档统一落盘到 .dsh-file-attachment 并以 @绝对路径 引用发送（文本模型可正常使用）；输入框内联显示图片缩略图预览与文件条目，聊天区图片同样渲染为可点击放大的缩略图、文件保持芯片样式；非多模态模型下图片自动调用可配置 VLM 识别生成中文描述回填草稿；文档/代码/配置文件可上传类型可在设置页配置；支持 PC 与移动端浏览器",
   "keywords": [
     "dsh",
     "plugin",
@@ -33,6 +33,9 @@
   "engines": {
     "node": ">=18"
   },
+  "peerDependencies": {
+    "@deepseek-ai/dsh": ">=0.1.0-rc.1 <0.1.1-0 || >=0.1.1-rc.1 <0.1.2-0 || >=0.1.2-alpha.1 <0.2.0-0"
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },