dsh-open-file
DeepSeek Harness 的工作区范围内任意文件上传、读取、OCR 和渲染。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-open-file@0.1.2-rc.1Open File 以 dsh-open-file 发布，当前版本为 0.1.2-rc.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English · 简体中文
Workspace-scoped file attachments, document reading, local OCR, and page rendering for DeepSeek Harness Web.
dsh-open-file brings files of any format into DeepSeek Harness conversations. Its included agent tools inspect each upload and read, OCR, or render the content available for the task through one traceable workflow.
Drop files anywhere in DeepSeek Harness Web
Drag files into the conversation
Drop one or more files anywhere in DeepSeek Harness Web to add them to the active session.
+ menu.file_inspect, file_read, file_ocr, and file_render.| Component | Version or requirement |
|---|---|
| DeepSeek Harness | 0.1.2-rc.1 |
| Node.js | >=22.13.0 |
| Operating systems | Windows, Linux, macOS |
| Browser APIs | fetch, XMLHttpRequest, File, drag and drop, clipboard file paste |
The Web integration uses the current input-trigger registration, conversation renderer, native image workflow, and client runtime APIs. Compatibility checks report FILE_WEB_COMPATIBILITY when the host contract requires attention.
Install the latest npm release:
dsh plugin --profile web add dsh-open-file
Install version 0.1.2-rc.1 for DeepSeek Harness 0.1.2-rc.1:
dsh plugin --profile web add dsh-open-file@0.1.2-rc.1
Install a locally reviewed package:
npm ci
npm pack
dsh plugin --profile web add ./dsh-open-file-0.1.2-rc.1.tgz
The package activates the Host service, Web client, and Open File Skill through cordis.patch.yml. npm presents this README.md as the package documentation.
+ → Add → Attachment, drop files onto the Web app, or paste files from the clipboard.dsh-open-file://attachment/v1/... references.Files in multiple formats ready in the DeepSeek Harness composer
Upload any file format whenever your task calls for it
Documents, data, source code, archives, images, and every other format share one attachment flow.
| Tool | Role |
|---|---|
file_inspect | Returns metadata, parser details, and selectable part_ref values |
file_read | Reads a selected part with text cursors or worksheet ranges |
file_ocr | Runs local English and Simplified Chinese OCR on a selected image part |
file_render | Renders a selected document part to a workspace PNG |
Image files integrate with the DSH image workflow. Documents and regular files use the workspace attachment workflow.
Version 0.1.2-rc.1 uses packaged release defaults. cordis.patch.yml registers the Host service, Web client, and Skill. Resource limits are listed below and represented in the public contract.
Source files and derived artifacts live under the active session workspace:
<workspace>/.dsh/open-file/v1/sessions/<sha256(session-id)>/
The plugin reads and writes this session directory and registers same-origin upload routes on the DSH Web Host. OCR uses the packaged eng and chi_sim language data.
POST /dsh-open-file/v1/uploads/prepare
PUT /dsh-open-file/v1/uploads/<upload-id> application/octet-stream
POST /dsh-open-file/v1/uploads/<upload-id>/commit
DELETE /dsh-open-file/v1/uploads/<upload-id>
Tool responses include the source hash, parser, locator, cursor, and canonical references. Extracted file content is tagged as untrusted evidence for downstream reasoning.
| Limit | Default |
|---|---|
| File size | 256 MiB |
| Draft files per session | 20 |
| Draft bytes per session | 512 MiB |
| ZIP entries | 10,000 |
| Expanded ZIP entry | 64 MiB |
| Total expanded ZIP bytes | 512 MiB |
| ZIP compression ratio | 100:1 |
| Upload timeout | 300 seconds |
| Parse and render timeout | 30 seconds |
| OCR timeout | 120 seconds |
| Rendered pixels | 40,000,000 |
These values define the 0.1.2-rc.1 resource envelope.
See SECURITY.md for the security policy and reporting process.
0.1.2-rc.1.file_render, then choose eng, chi_sim, or both languages.file_inspect to review the detected type, parser, and available parts.Stable error codes are exported from the package contract and included in tool failures for programmatic handling.
dsh plugin --profile web remove dsh-open-file
Install a selected release to complete a version change:
dsh plugin --profile web add dsh-open-file@0.1.2-rc.1
npm ci
npm run typecheck
npm run lint
npm test
npm run build
npm run verify:release
npm pack
The release workflow runs type checks, linting, the complete automated test suite, production builds, and npm artifact inspection across Windows, Linux, and macOS.
GitHub and npm publication begins after maintainer approval of both README files and the generated tarball. Final acceptance covers package installation, Web startup, file selection, drag and drop, uploads, message rendering, all four tools, draft controls, and plugin removal.