dsh-local-path-attachments
将本地文件拖入 DeepSeek Harness Desktop，作为绝对路径附件卡片，而不将其复制到工作区
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:WangZetian-IVERSON/dsh-local-path-attachments#68c4df454b745a0e8e26147b41e972b637ce9ce3Local Path Attachments 以 dsh-local-path-attachments 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Turn files dropped from Explorer or Finder into removable attachment cards backed by their real absolute paths — without uploading or copying file bytes.
Get Started · 中文文档 · Releases · Report a Bug
Drop one file or fifty. Each becomes a compact card above the DSH composer, with its filename, complete path, and a remove action. When the message is submitted, the Agent receives the path verbatim:
C:\Users\you\Desktop\research report.pdf
The source file stays exactly where it was. The plugin does not read it, upload it, or create a workspace copy.
| 📎 Native-feeling cards Files appear as removable cards in the existing composer dock instead of noisy pasted text. | 📍 Real absolute paths Electron resolves the genuine disk path, including spaces, Chinese filenames, UNC paths, and files outside the workspace. | 🛡️ Zero-copy by design Only a path reference enters the draft. File bytes remain in their original directory and under DSH sandbox policy. |
Drag, display, and manage
Reliable composer lifecycle
Safe coexistence
conversation.input.dock; the shipped image attachment slot is not replaced.Download the ready-to-install dsh-local-path-attachments-0.1.1.tgz from the latest release.
cd "$env:USERPROFILE\.dsh\profiles\desktop"
pnpm add "D:\path\to\dsh-local-path-attachments-0.1.1.tgz"
Append dsh-local-path-attachments to the existing dsh.profile.bundles array in the Desktop Profile's package.json:
{
"dsh": {
"profile": {
"bundles": [
"dsh-local-path-attachments"
]
}
}
}
Preserve every bundle already present; only append this entry. Restart DSH Desktop once after installation.
flowchart LR
A[Explorer / Finder] -->|drop File objects| B[Electron preload bridge]
B -->|webUtils.getPathForFile| C[Absolute paths]
C --> D[Composer reference nodes]
D --> E[Attachment cards]
D -->|submit verbatim path| F[Agent]
A -. file bytes stay in place .-> A
The hidden reference node owns draft and submission semantics. The visible dock card is a projection of that reference. Clipboard-safe markers allow cards to survive a Client reload without copying file contents.
| Environment | Status | Behavior |
|---|---|---|
| Windows DSH Desktop | ✅ Verified | Absolute paths, multi-file drop, card removal, persistence, and submission tested end to end. |
| macOS / Linux DSH Desktop | 🧪 Path-aware | POSIX paths are supported by the codec; these platforms have not yet been field-tested by the maintainer. |
| Browser-only Web GUI | ➖ Intentional fallback | Browser File objects do not expose absolute paths; the plugin does not intercept the existing drop behavior. |
git clone https://github.com/WangZetian-IVERSON/dsh-local-path-attachments.git
cd dsh-local-path-attachments
pnpm install
pnpm check
pnpm pack
pnpm check builds the Host and Client bundles, typechecks all targets, runs 11 unit and jsdom integration tests, and verifies the DSH lazy-module wrapper and external dependencies.
| Layer | Technology |
|---|---|
| Plugin composition | Cordis / dsh.bundle.patch |
| Client UI | React 18 + DSH Slots |
| Composer integration | DSH input-trigger references |
| Desktop path bridge | Electron webUtils.getPathForFile |
| Language and build | TypeScript 6 + tsdown |
| Tests | Vitest + jsdom |
v0.1.1 tarball SHA-256:
e41e542365470558a0d4fe30434727a007c70dd7cb2c967112bac44b9720c372
See the full history in CHANGELOG.md.
Bug reports, focused feature requests, documentation improvements, and pull requests are welcome. Please include the DSH Desktop version, operating system, reproduction steps, and any relevant Client diagnostics.
If this plugin is useful, consider starring the repository so other DSH users can discover it.
MIT © WangZetian-IVERSON