dsh-upload-origin

Upload Origin

DSH 插件：通过匹配名称、大小和 sha256，解析上传到 .dsh-uploads 的文件的原始本地路径。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:wlc114514/dsh-upload-origin#d0bf279580992fde416f9d8d809d333e2c5c4029

兼容性与来源证明

Upload Origin 以 dsh-upload-origin 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: any
发布来源: github
Registry 更新时间: 2026/9/18

版本

0.1.0stable

2026/9/18

README

dsh-upload-origin

A host-side plugin for DeepSeek Harness that resolves the original local absolute path of a file the user dragged into the conversation.

Why

When a file is dragged into the web composer, the browser upload surface can send the file bytes and its display name, but it cannot expose the original absolute path to JavaScript. DSH stores the uploaded snapshot under:

<session cwd>/.dsh-uploads/<sessionId>/<sha256-16>-<name>

dsh-upload-origin runs on the DSH host, scans the session workspace and common user folders, and matches that snapshot against local files by name + size + sha256. The resolved original path is then injected into the system prompt for the current agent and is also available through a tool.

What it does

Watches the current session's .dsh-uploads directory when a turn is assembled.
Keeps only uploads that a human prompt actually referenced.
Resolves each referenced upload against local files:
- first through the official workspace file-reference index (ctx.fileReferences);
- then through a bounded filesystem scan of the session cwd, Desktop, Documents, Downloads, OneDrive, and a shallow home scan.

Injects a mapping block into the system prompt:

[Uploaded files: original local paths]
- uploaded: .dsh-uploads/session-.../7538541a1efdc6c6-report.docx
  original: C:\Users\Alice\Desktop\report.docx [exact]
  Prefer this original path when the user refers to their local file; the
  .dsh-uploads copy is a snapshot.

Registers the resolve_uploaded_file tool for on-demand lookup.

Install

From npm (after publication):

dsh plugin --profile web add dsh-upload-origin

Install the prebuilt tarball from GitHub Releases:

dsh plugin --profile web add https://github.com/wlc114514/dsh-upload-origin/releases/download/v0.1.0/dsh-upload-origin-0.1.0.tgz

The package declares dsh.bundle, so it installs through the normal DSH bundle/profile flow.

Tool: `resolve_uploaded_file`

Arguments:

Argument	Type	Description
`file_path`	string, optional	Uploaded path, absolute or relative to the session workspace.
`name`	string, optional	Original file name to locate when no uploaded path is known.
`search_roots`	string[], optional	Extra absolute directories to scan.
`max_results`	integer, optional	Maximum candidates to return (1-20, default 10).

The result contains the uploaded path, the original name, size, sha256, the best original path, confidence, candidates, scanned roots, and scan metadata.

Confidence values:

Confidence	Meaning
`exact`	Name, size, and sha256 all match.
`name+size`	Name and size match; sha256 was not checked or differs.
`name+size-hash-differs`	Name and size match, but content has changed since upload.
`name-only-size-differs`	Same name, different size.
`name-only`	Same name only. Verify manually.

Configuration

The plugin accepts these optional config fields in a bundle patch row:

- id: upload-origin
  name: 'dsh-upload-origin'
  config:
    maxSearchFiles: 250000
    searchTimeoutMs: 9000
    maxDepth: 12
    maxHashChecks: 30
    maxResults: 10
    recentUploadMs: 604800000
    maxRecentUploads: 8
    autoResolveTimeoutMs: 7000

Field	Default	Description
`maxSearchFiles`	`250000`	Maximum filesystem entries visited per resolution.
`searchTimeoutMs`	`9000`	Overall search deadline per resolution.
`maxDepth`	`12`	Directory depth for common roots.
`maxHashChecks`	`30`	Maximum candidate files whose content is hashed.
`maxResults`	`10`	Maximum candidates returned by the tool.
`recentUploadMs`	`604800000`	Only uploads newer than this are auto-resolved (7 days).
`maxRecentUploads`	`8`	Maximum recent uploads considered per prompt assembly.
`autoResolveTimeoutMs`	`7000`	Maximum wait for automatic prompt mapping per turn.

Limitations

Browsers do not expose the original absolute path during drag-and-drop. This plugin recovers it by matching the uploaded snapshot on the host.
If the original file was modified after upload, the sha256 will differ; the plugin falls back to name + size or name-only candidates.
Files outside the default roots are not found automatically. Pass search_roots to the tool or configure additional roots in a future version.
The uploaded copy remains the durable source of truth for reading; the original path is used when the user wants to edit their local file.

Security

Host-side only. No network calls.
No credentials are read, stored, or transmitted.
The plugin reads only local files whose names match the uploaded snapshot; content hashes are computed locally to confirm the match.
The resolve_uploaded_file tool is read-only.

License

MIT

README

dsh-upload-origin

A host-side plugin for DeepSeek Harness that resolves the original local absolute path of a file the user dragged into the conversation.

Why

<session cwd>/.dsh-uploads/<sessionId>/<sha256-16>-<name>

What it does

Watches the current session's .dsh-uploads directory when a turn is assembled.
Keeps only uploads that a human prompt actually referenced.
Resolves each referenced upload against local files:
- first through the official workspace file-reference index (ctx.fileReferences);
- then through a bounded filesystem scan of the session cwd, Desktop, Documents, Downloads, OneDrive, and a shallow home scan.

Injects a mapping block into the system prompt:

[Uploaded files: original local paths]
- uploaded: .dsh-uploads/session-.../7538541a1efdc6c6-report.docx
  original: C:\Users\Alice\Desktop\report.docx [exact]
  Prefer this original path when the user refers to their local file; the
  .dsh-uploads copy is a snapshot.

Registers the resolve_uploaded_file tool for on-demand lookup.

Install

From npm (after publication):

dsh plugin --profile web add dsh-upload-origin

Install the prebuilt tarball from GitHub Releases:

dsh plugin --profile web add https://github.com/wlc114514/dsh-upload-origin/releases/download/v0.1.0/dsh-upload-origin-0.1.0.tgz

The package declares dsh.bundle, so it installs through the normal DSH bundle/profile flow.

Tool: `resolve_uploaded_file`

Arguments:

Argument	Type	Description
`file_path`	string, optional	Uploaded path, absolute or relative to the session workspace.
`name`	string, optional	Original file name to locate when no uploaded path is known.
`search_roots`	string[], optional	Extra absolute directories to scan.
`max_results`	integer, optional	Maximum candidates to return (1-20, default 10).

The result contains the uploaded path, the original name, size, sha256, the best original path, confidence, candidates, scanned roots, and scan metadata.

Confidence values:

Confidence	Meaning
`exact`	Name, size, and sha256 all match.
`name+size`	Name and size match; sha256 was not checked or differs.
`name+size-hash-differs`	Name and size match, but content has changed since upload.
`name-only-size-differs`	Same name, different size.
`name-only`	Same name only. Verify manually.

Configuration

The plugin accepts these optional config fields in a bundle patch row:

- id: upload-origin
  name: 'dsh-upload-origin'
  config:
    maxSearchFiles: 250000
    searchTimeoutMs: 9000
    maxDepth: 12
    maxHashChecks: 30
    maxResults: 10
    recentUploadMs: 604800000
    maxRecentUploads: 8
    autoResolveTimeoutMs: 7000

Field	Default	Description
`maxSearchFiles`	`250000`	Maximum filesystem entries visited per resolution.
`searchTimeoutMs`	`9000`	Overall search deadline per resolution.
`maxDepth`	`12`	Directory depth for common roots.
`maxHashChecks`	`30`	Maximum candidate files whose content is hashed.
`maxResults`	`10`	Maximum candidates returned by the tool.
`recentUploadMs`	`604800000`	Only uploads newer than this are auto-resolved (7 days).
`maxRecentUploads`	`8`	Maximum recent uploads considered per prompt assembly.
`autoResolveTimeoutMs`	`7000`	Maximum wait for automatic prompt mapping per turn.

Limitations

Browsers do not expose the original absolute path during drag-and-drop. This plugin recovers it by matching the uploaded snapshot on the host.
If the original file was modified after upload, the sha256 will differ; the plugin falls back to name + size or name-only candidates.
Files outside the default roots are not found automatically. Pass search_roots to the tool or configure additional roots in a future version.
The uploaded copy remains the durable source of truth for reading; the original path is used when the user wants to edit their local file.

Security

Host-side only. No network calls.
No credentials are read, stored, or transmitted.
The plugin reads only local files whose names match the uploaded snapshot; content hashes are computed locally to confirm the match.
The resolve_uploaded_file tool is read-only.

License

MIT

Upload Origin

兼容性与来源证明

版本

相关插件

Upload Origin

README

dsh-upload-origin

Why

What it does

Install

Tool: resolve_uploaded_file

Configuration

Limitations

Security

License

兼容性与来源证明

版本

相关插件

相关插件

相关插件

README

dsh-upload-origin

Why

What it does

Install

Tool: resolve_uploaded_file

Configuration

Limitations

Security

License

Tool: `resolve_uploaded_file`

Tool: `resolve_uploaded_file`