@wszhoho/dsh-file-attachment 0.1.0 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wszhoho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# dsh-file-attachment
+
+DeepSeek Harness (dsh) web GUI 插件：在会话输入框中**拖入或 Ctrl+V 粘贴文档（支持多文件，一次可拖入/粘贴多个文件）**时，浏览器端批量读取全文，保存到**当前会话工作区根目录下的 `.dsh-file-attachment/`**，并在输入框光标处插入 `@<保存副本绝对路径>` 引用。agent 读取 `@路径` 时直接读到落盘副本，不再依赖原始文件位置。
+
+图片文件完全沿用 dsh web 既有草稿图片流程，不拦截、不改动。
+
+## 行为一览
+
+| 操作 | 行为 |
+| --- | --- |
+| 拖入/粘贴 **文档**（docx/xlsx/pdf/md/txt/rpk 等非图片文件） | 浏览器读全文 → base64 → 宿主落盘 `<会话工作区>/.dsh-file-attachment/<时间戳>-<文件名>` → 光标插入 `@绝对路径`，底部 toast 提示保存目录 |
+| 一次拖入/粘贴 **多个文件**（支持多文件） | 批量处理：逐个读取全文 → base64 → 落盘 → 在光标处一次性插入全部 `@` 引用，toast 汇总保存数量与目录 |
+| 拖入 **目录** | 拒绝，toast 提示「不支持拖入目录」，不插入引用 |
+| 拖入/粘贴 **图片** | 不拦截，原样走 dsh web 既有草稿图片流程（零变化） |
+| 粘贴 **纯文本**（含从地址栏复制的目录路径字符串） | 不改写，完全原生行为 |
+| 重复拖入同名文件（同一秒内） | 追加 `-1`、`-2` 序号，绝不覆盖 |
+| 单文件 > 50MB | 跳过并提示 |
+
+### 文件命名
+
+`<时间戳>-<清洗后文件名>`，例如 `2026-02-11T15-04-05-说明.docx`；时间戳为 `2026-02-11T15-04-05` 格式（去掉冒号/毫秒/Z，各平台文件名安全且可排序）。同名冲突在扩展名前追加 `-N`。
+
+### 项目根解析
+
+保存目录的根 = **当前会话工作区**（`session.header.cwd`），回退顺序：会话 cwd → `sandboxPolicy.workspaceRoot` → `process.cwd()`。每个项目（工作区）都各自维护自己的 `.dsh-file-attachment/` 目录。
+
+### 跨平台
+
+- 保存路径用 Node `path.join`（平台分隔符自适应）
+- 时间戳/文件名清洗同时对 Windows 与 POSIX 命名规则安全
+- Host 半直接 `node:fs/promises` 写字节，无 shell 依赖
+
+## 安装（官方 `dsh plugin` 方式）
+
+本仓库是一个标准 dsh 插件包（声明了 `dsh.bundle.patch`），并已发布为 npm 包 `@wszhoho/dsh-file-attachment`。用官方 CLI 安装，pnpm 会自动处理依赖、并把本包加入 profile 的 `dsh.profile.bundles` 层。`dsh plugin add` 的参数会转发给 profile 目录的 pnpm 执行，三种来源任选其一：
+
+### 从 npm 安装（普通用户推荐）
+
+```powershell
+dsh plugin --profile web add @wszhoho/dsh-file-attachment
+# 重启 web GUI：dsh web（或从托盘重启）
+```
+
+### 本地源码安装（开发用，边改边验）
+
+```powershell
+# 在仓库父目录执行（<parent> 换成放置仓库的实际目录，如 E:\wszhoho）
+cd <parent>
+dsh plugin --profile web add ./dsh-file-attachment
+# ./dsh-file-attachment 相对路径等价 pnpm link；改完 lib/*.js 后重启 dsh web 即生效
+```
+
+### 从 GitHub 安装
+
+```powershell
+dsh plugin --profile web add github:<你的账号>/dsh-file-attachment
+```
+
+- 无论哪种来源，安装后都自动进入 `dsh.profile.bundles`，无需手改 profile `package.json`；
+- 升级：`dsh plugin --profile web update dsh-file-attachment`。
+
+## 架构
+
+```
+packages/dsh-file-attachment/
+├── package.json          # dsh.client 声明 + bundle patch 指向
+├── cordis.patch.yml      # bundle 补丁：插入本插件行
+└── lib/
+    ├── index.js          # Host 半：webServer 路由（POST /dsh-file-attachment/save），node:fs/promises 写盘
+    └── client.js         # Client 半：document 级 capture drop/paste/dragenter 监听 + 槽组件
+```
+
+- **Host 半**：`webServer.register` 前缀路由 `/dsh-file-attachment`，POST `/dsh-file-attachment/save` 接收 `{name, data(base64), sessionId}`，base64 解码后用 `node:fs/promises` 写盘到会话工作区 `.dsh-file-attachment/`，返回 `{ok, value:{path,dir,name,size}}`。
+- **Client 半**：`conversation.composer.dock`（list 槽，同步桥状态，不渲染文本）+ `shell.overlay`（list 槽，toast 通知展示），document 级 capture 监听先于应用 bubble 监听执行。
+- **通知**：`shell.overlay` frame-wide 浮动 toast（不参与文档流，不破坏布局），4 秒自动消失。
+- **浮层**：拖入任何文件时 capture 阶段拦截应用自带「拖入图片…」DropOverlay（文案面向图片，对文档是误导）。
+
+## 开发说明
+
+- `lib/*.js` 使用 **UTF-8 with BOM**（项目约定）；`package.json`、`cordis.patch.yml` 使用 **UTF-8 无 BOM**。
+- Host 半用 `webServer.register({ kind: 'prefix', path: '/dsh-file-attachment', handler })` 收文件（参考 `dsh-upload-file` 同架构的 `/dsh-upload` 路由），纯 ESM 无构建，不依赖装饰器/远程反射。
+- Client 半保存用 `fetch('/dsh-file-attachment/save', { method: 'POST', body: JSON.stringify({ name, data, sessionId }) })`，信封为 `{ ok, value | error }`。
+- 项目根 = 会话工作区（`session.header.cwd` → `sandboxPolicy.workspaceRoot` → `process.cwd()` 兜底）。
+- 50MB 上限两侧一致（client 跳过 + host 校验）。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -1,4 +1,4 @@
-# dsh-fileAttachment 补丁行：挂载本插件（Host 半提供 fileAttachment remote 服务写临时目录；Client 半监听拖拽/粘贴）
+# dsh-file-attachment 补丁行：挂载本插件（Host 半提供 file-attachment 服务写临时目录；Client 半监听拖拽/粘贴）
 - insert:
-    - id: dsh-fileAttachment
+    - id: dsh-file-attachment
       name: '@wszhoho/dsh-file-attachment'

package/lib/client.js

@@ -1,15 +1,15 @@
-// @local/dsh-fileAttachment 浏览器半（client 半，全部功能在此）。
+// @wszhoho/dsh-file-attachment 浏览器半（client 半，全部功能在此）。
 // 拖放/粘贴文件进输入框：
 // 1) 纯图片 —— 不拦截事件，原样交给既有图片拖放路径（行为零变化）；
 // 2) 文档（非图片文件）—— capture 阶段接管：浏览器端读取全文 → base64 →
-//    remote.fileAttachment.save 落盘到 <会话工作区>/.dsh-fileAttachment/ →
+//    fetch POST /dsh-file-attachment/save 落盘到 <会话工作区>/.dsh-file-attachment/ →
 //    在草稿光标处插入 @绝对路径 引用；粘贴文件走同一核心；
 // 3) 目录 —— 拒绝并 toast 提示「不支持拖入目录」（需求确认：不插引用）；
 // 4) 纯文本粘贴（含目录路径字符串）—— 完全原生，不做任何改写。
 // 5) 拖入任何文件时在 capture 阶段拦截应用自带「拖入图片…」DropOverlay 浮层。
 // 通知：shell.overlay 浮动 toast（frame-wide，fixed 定位，点击穿透，不破坏布局）。
 window.__ModuleLoader__.load({
-	id: '@local/dsh-fileAttachment',
+	id: '@wszhoho/dsh-file-attachment',
 	factory: (require) => {
 		const module = { exports: {} }
 		const exports = module.exports
@@ -17,7 +17,7 @@ window.__ModuleLoader__.load({
 		const react = require('react')
 
 		// Client 服务依赖：槽位 / 输入机 / 会话（与官方 dsh-upload-file 同范式）。
-		// 保存文件不走 remote，而是 fetch POST 宿主 webServer 路由 /dsh-fileAttachment/save。
+		// 保存文件不走 remote，而是 fetch POST 宿主 webServer 路由 /dsh-file-attachment/save。
 		const inject = [
 			"slots",
 			"conversation",
@@ -55,7 +55,7 @@ window.__ModuleLoader__.load({
 			if (typeof fetch !== 'function') throw new Error('当前环境无 fetch，无法上传')
 			let response
 			try {
-				response = await fetch('/dsh-fileAttachment/save', {
+				response = await fetch('/dsh-file-attachment/save', {
 					method: 'POST',
 					headers: { 'content-type': 'application/json' },
 					body: JSON.stringify({ name: fileName, data: b64, sessionId: sessionId }),
@@ -428,11 +428,11 @@ window.__ModuleLoader__.load({
 			const slots = ctx.get('slots')
 			if (slots !== undefined) {
 				slots.inject('conversation.composer.dock', () => slots.register(
-					{ name: 'conversation.composer.dock', id: 'dsh-fileAttachment', order: 300 },
+					{ name: 'conversation.composer.dock', id: 'dsh-file-attachment', order: 300 },
 					FaBridge
 				))
 				slots.inject('shell.overlay', () => slots.register(
-					{ name: 'shell.overlay', id: 'dsh-fileAttachment-toast', order: 100 },
+					{ name: 'shell.overlay', id: 'dsh-file-attachment-toast', order: 100 },
 					FaToast
 				))
 			}
@@ -447,7 +447,7 @@ window.__ModuleLoader__.load({
 					document.removeEventListener('drop', onDrop, true)
 					document.removeEventListener('paste', onPaste, true)
 				}
-			}, 'dsh-fileAttachment: document dragenter/drop/paste listeners')
+			}, 'dsh-file-attachment: document dragenter/drop/paste listeners')
 		}
 
 		exports.apply = apply

package/lib/index.js

@@ -1,6 +1,6 @@
-// @local/dsh-fileAttachment Host 半：webServer HTTP 路由方案（参考 dsh-upload-file 同架构）。
-// Client 半读取文件全文（base64）后 POST /dsh-fileAttachment/save 到这里，
-// 写入 <会话工作区根>/.dsh-fileAttachment/<时间戳>-<文件名> 并返回 { path, dir, name, size }。
+// @wszhoho/dsh-file-attachment Host 半：webServer HTTP 路由方案（参考 dsh-upload-file 同架构）。
+// Client 半读取文件全文（base64）后 POST /dsh-file-attachment/save 到这里，
+// 写入 <会话工作区根>/.dsh-file-attachment/<时间戳>-<文件名> 并返回 { path, dir, name, size }。
 // 项目根解析：Client 传 sessionId → sessions.get(sessionId).header.cwd →
 // sandboxPolicy.workspaceRoot → process.cwd()（三平台绝对路径，Node path.join 自适应分隔符）。
 // 纯 ESM 无构建：不依赖 TypertRemoteService/装饰器，原生 Node 可直接加载。
@@ -8,11 +8,11 @@ import { access, mkdir, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 
 /** 本包声明依赖的 Host 服务。 */
-export const name = 'dsh-fileAttachment'
+export const name = 'dsh-file-attachment'
 export const inject = ['webServer']
 
 // 临时目录名：落在会话工作区根下；每个项目都能看到自己引用过的文档
-const ATTACHMENT_DIR = '.dsh-fileAttachment'
+const ATTACHMENT_DIR = '.dsh-file-attachment'
 // 单文件上限 50MB（与 Client 半一致）
 const MAX_BYTES = 50 * 1024 * 1024
 // 请求体上限：base64(50MB) + 信封余量
@@ -140,16 +140,16 @@ async function handleSave(root, body) {
   return { path: target, dir, name: t + '-' + safe, size: bytes.length }
 }
 
-/** 注册 /dsh-fileAttachment 前缀路由（save POST）。 */
+/** 注册 /dsh-file-attachment 前缀路由（save POST）。 */
 function registerRoutes(ctx) {
   const webserver = ctx.get('webServer')
   if (webserver === undefined) return
   webserver.register({
     kind: 'prefix',
-    path: '/dsh-fileAttachment',
+    path: '/dsh-file-attachment',
     handler: async (req, res) => {
       const pathname = new URL(req.url ?? '/', 'http://x').pathname
-      if (req.method === 'POST' && pathname === '/dsh-fileAttachment/save') {
+      if (req.method === 'POST' && pathname === '/dsh-file-attachment/save') {
         const body = await readJsonBody(req, MAX_BODY_BYTES)
         if (body === null || typeof body !== 'object') {
           json(res, { ok: false, error: '请求体必须是 JSON（68MB 内）' }, 400)
@@ -173,7 +173,7 @@ function registerRoutes(ctx) {
           return
         }
       }
-      json(res, { ok: false, error: 'only POST /dsh-fileAttachment/save is allowed' }, 405)
+      json(res, { ok: false, error: 'only POST /dsh-file-attachment/save is allowed' }, 405)
     },
   })
 }
@@ -183,5 +183,5 @@ function registerRoutes(ctx) {
  */
 export function apply(ctx, config = {}) {
   registerRoutes(ctx)
-  console.log('[dsh-fileAttachment] host loaded (webServer routes)')
+  console.log('[dsh-file-attachment] host loaded (webServer routes)')
 }

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@wszhoho/dsh-file-attachment",
-  "version": "0.1.0",
-  "description": "拖拽/粘贴文件进输入框：图片沿用原有草稿图片流程；文档读取内容存入项目根 .dsh-fileAttachment 临时目录并插入 @绝对路径引用",
+  "version": "0.2.1",
+  "description": "拖拽/粘贴文件（支持多文件）进输入框：图片沿用原有草稿图片流程；文档读取内容存入项目根 .dsh-file-attachment 临时目录并插入 @绝对路径引用",
   "keywords": [
     "dsh",
     "plugin",
     "file-attachment",
     "upload",
-    "drag-drop"
+    "drag-drop",
+    "multi-file"
   ],
   "type": "module",
   "main": "lib/index.js",