dsh-file-resource
DeepSeek Harness 的私有本地文件附件，支持原生图像和受限文档读取。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-file-resource@0.4.9
File Resource 以 dsh-file-resource 发布，当前版本为 0.4.9。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness Web 的本地文件输入插件。在输入框原有的 + 菜单顶部增加 attach，并用分隔线与 Harness 原生命令区分；不会再增加一个单独按钮。
选择图片时继续使用 Harness 官方图片附件流程。选择文档时，插件在本机解析并保存为会话隔离的私有资源，模型只在需要时通过一个受限读取工具按页、幻灯片、工作表、分块或搜索结果读取。界面不会伪造或显示“请读取某个文件”的用户消息。
× 可以取消正在进行的上传或移除文件。Ctrl+V 粘贴复制的文件）；图片始终走 Harness 原生流程。@文件名 引用，聊天记录里直接可见本条消息带了哪些文件；模型按名对应资源 ID 再读取。（输入框里的 @ 属于 Harness 自带的工作区文件/会话引用，插件不与之冲突。）@文件名，右侧会滑出该文件的预览面板（Esc、点遮罩或 × 关闭）。@邮箱、随手打的 @文字 不再触发），输入框内的点击一律忽略。@文件名 在右侧预览文件内容。@文件名 引用，聊天记录可见、模型可定位。完整历史见 CHANGELOG.md。
| 类别 | 格式 |
|---|---|
| Harness 原生图片 | PNG、JPEG、WebP、GIF |
| 文档 | PDF、DOCX、XLSX、PPTX、ODT、ODS、ODP、RTF、EPUB |
| 文本与代码 | TXT、Markdown、CSV、TSV、JSON/JSONL、XML、HTML、YAML、日志、配置、SQL，以及常见 JS/TS/Python/Java/C/C++/C#/Go/Rust/Ruby/PHP/Shell/PowerShell/CSS 文件 |
限制：旧二进制 DOC、XLS、PPT 不支持，请先另存为 DOCX、XLSX、PPTX。PDF 读取文字层；纯扫描件不会自动 OCR，避免后台下载识别模型、额外占用 CPU 或把内容发给第三方。
要求与当前 DeepSeek Harness 一致：Node.js 22.19+ 或 24+。v0.1.1 已在 DeepSeek Harness 0.1.1-rc.1 上验证。
从 npm 安装固定版本：
dsh plugin --profile web add dsh-file-resource@0.1.1
也可以直接安装对应的 GitHub Release：
dsh plugin --profile web add github:liznee/dsh-file-resource#v0.1.1
安装后运行 dsh --profile web --dump-config，输出中应出现 # == dsh-file-resource。随后重启 dsh web，从输入框左下角的 + 选择 attach。
升级时，将上述安装命令中的 0.1.1 替换为准备安装的新版本。卸载命令：
dsh plugin --profile web remove dsh-file-resource
本地开发安装：
npm install
npm run build
dsh plugin --profile web add C:\absolute\path\to\dsh-file-resource
默认缓存位于 $DSH_HOME/resources/dsh-file-resource/v1；未设置 DSH_HOME 时位于 ~/.dsh/resources/dsh-file-resource/v1。插件不会把副本或 Markdown 转换文件写进当前项目，也不会改动原文件。
文档全文不会直接塞进系统提示词。插件固定增加一个读取工具；按 Harness 自带的“4 字符约 1 token”估算，它的 schema 约为 188 tokens。文件索引约为：1 个文件 79 tokens、5 个文件 165 tokens、20 个文件 490 tokens。真正的文档内容仅在模型调用 read_uploaded_resource 时进入上下文，默认每次最多返回 8,000 字符，硬上限 24,000 字符。
发布前的小型真实文件基准：Host 冷导入约 12 ms、约 1.6 MiB 堆增量；DOCX/XLSX/PPTX 通常在 3–35 ms 内完成，PDF 第一次加载解析器约 0.1–0.6 秒。主机插件包约 51 KiB；PDF.js 只在第一次处理 PDF 时延迟加载。数据取决于机器和文件复杂度。
安全问题请按照 SECURITY.md 私下报告；不要在公开 Issue 中披露可利用细节。
npm test
npm run test:coverage
npm audit --omit=dev
npm run pack:check
当前测试覆盖文件选择、真实进度、取消、会话隔离、配额、缓存回收、恶意 ZIP 防护，以及真实 DOCX/XLSX/PPTX/PDF/ODF/EPUB/RTF 解析。
dsh-file-resource adds a unified attach entry to the existing DeepSeek Harness Web + menu. Images continue through Harness's native attachment pipeline. Documents are parsed locally into session-scoped, content-addressed resources and exposed to the model through one bounded read tool. Sending with attached documents appends @fileName mentions to the message, so the conversation visibly shows what was sent and the model maps the names to resource IDs; clicking an @fileName in the conversation previews the file in a right-side split view. (The composer's @ itself belongs to Harness's native workspace-file references.) Drag any file anywhere over the window, or paste copied files into the composer, to attach them.
See CHANGELOG.md for the full history. Recent highlights: sent messages carry visible @fileName mentions (v0.3.0); clicking an @fileName opens a right-side preview in a split view, spreadsheets render as bordered tables (v0.4.0–v0.4.5); previews are limited to files actually attached or sent in this conversation (v0.4.6); the split is aligned with the conversation column (v0.4.7/0.4.8); preview no longer blocks the left side (v0.4.9); a per-session send history keeps sent-file previews alive after the draft card is removed (v0.4.4).
Supported documents: PDF, DOCX, XLSX, PPTX, ODT, ODS, ODP, RTF, EPUB, plus common text and source-code formats. Legacy DOC/XLS/PPT files and automatic OCR for image-only PDFs are intentionally unsupported.
Install with:
dsh plugin --profile web add dsh-file-resource@0.1.1
# or: dsh plugin --profile web add github:liznee/dsh-file-resource#v0.1.1
The plugin has no telemetry or third-party file upload. See the Chinese sections above for cache limits, token estimates, security controls, and performance measurements.
MIT © liznee