dsh-file-ref
DeepSeek Harness 插件：拖放文件附件——将任意本地文件粘贴或拖放到 DSH Web 撰写器中，作为 @workspace 路径引用
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:auroralab-art/dsh-file-ref#bb5e1358ecd559911ce76a93f26bb2e58e5f45b0File Ref 以 dsh-file-ref 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Drag-and-drop or paste any local file — PDF, CSV, code, or document — into the DSH web composer. The plugin resolves the filesystem path and inserts an @workspace reference the agent opens with existing tools. No upload API, no extra model context.
Without this plugin, the DSH composer only accepts PNG, JPEG, WebP, and GIF. Any other file is rejected as an unsupported image format.
dsh-file-ref bridges that gap:
@ that path.@relative mentions before the model step so the agent can open the file with read, the shell, or other tools already in the session.There is no new upload API and no extra model-facing file tool. The agent uses whatever access mode the session already provides.
Requires the dsh CLI and the web profile.
dsh plugin --profile web add https://github.com/auroralab-art/dsh-file-ref/releases/download/v0.1.0/dsh-file-ref-0.1.0.tgz
Restart dsh web and hard-refresh the browser. Done.
To remove:
dsh plugin --profile web remove dsh-file-ref
| File location | Draft text inserted |
|---|---|
| Inside the current workspace | @docs/spec.pdf |
| Outside the workspace | /Users/you/Downloads/spec.pdf |
| Path hidden by the browser | @.dsh-inbox/spec.pdf (a copy under the workspace) |
| PNG / JPEG / WebP / GIF | First-party image rail, unchanged |
Before a step, the host confirms each @relative path still exists and injects:
<workspace-reference path="docs/spec.pdf" kind="file" />
Absolute paths stay as typed. The plugin does not open the file or send its bytes. The agent reads the path with the session's usual tools and access mode.
@relative. A path outside the workspace is inserted as absolute text.inboxDir and the draft @s that relative path.@relative tokens that still exist inside the workspace.maxStageBytes.read opens UTF-8 text. Other formats use the session's shell or other tools.Optional keys go in ~/.dsh/profiles/web/cordis.patch.yml. A later layer replaces the whole config object, so restate every key you set.
- id: dsh-file-ref
config:
inboxDir: .dsh-inbox
maxStageBytes: 20971520
| Key | Default | Description |
|---|---|---|
inboxDir | .dsh-inbox | Workspace-relative directory for copies when the browser hides the original path |
maxStageBytes | 20971520 (20 MiB) | Maximum size of one staged copy |
No. The plugin inserts a path into the composer text. The agent opens the file using the session's existing tools (read, shell, etc.). File bytes are never sent to the LLM context through this plugin.
All formats except PNG, JPEG, WebP, and GIF (which use the built-in image rail). Common use cases include PDF, CSV, JSON, YAML, source code, Markdown, and any text-based document.
No. This plugin targets the web profile only, as it relies on browser paste/drop events and the composer UI.
Files staged into the inbox are capped by maxStageBytes (default 20 MiB). The agent still needs to read the file through standard tools, so very large files may hit the session's own limits.
Tested against DeepSeek Harness v0.1.0-rc.1 and later. Plugin contracts may change between DSH preview releases — pin the version you test against.
| Requirement | Version |
|---|---|
| DeepSeek Harness | v0.1.0-rc.1+ |
| Node.js | ^22.19.0 or >=24.0.0 |
| Profile | web |
This plugin is published by Aurora Lab. We build plugins that extend what DeepSeek Harness can do.
Other plugins from Aurora Lab:
You may download and install this software for personal, non-commercial use. Contact the owner through auroralab-art before any modification or derivative work. Commercial use requires the owner's written consent.
pnpm install
pnpm test
pnpm run build
dsh plugin --profile web add "$PWD"
add "$PWD" links this checkout into the profile. Keep the directory. That is the development path, not the install command for other machines.
The build expects a deepseek-harness checkout at ../../deepseek-harness, or DSH_CHECKOUT.