拖拽上传 PDF/Word/Excel/图片等文件:落盘为本地路径引用,对话里不塞 base64 大文本。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:xing666173/dsh-vision-hub#path:/file-drop
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
DeepSeek Harness 持久插件:支持拖拽 / 点击上传非图片文件(PDF / Word / Excel / ZIP / 文本等),把文件路径直接写入输入框草稿,agent 即可读取。
工作方式(三个入口共用一套逻辑)
| 入口 | 行为 |
|---|---|
| 拖拽到窗口任意位置 | 全屏高亮浮层 → 松手 → 获取文件 |
| 回形针按钮(输入框工具行左侧,28px 圆形原生风格) | 点击弹系统文件选择器(多选) |
| hover 气泡 | 「点击选择文件 · 也可把文件拖到窗口任意位置」,1.5s 自动消失,每次 hover 循环 |
处理顺序(按可用性优先):
- 桌面壳直取原始路径(Electron 壳
window.dshDesktop,webUtils.getPathForFile)—— 零上传,拿到 Finder 里的真实路径; - 拖拽自带路径(
text/uri-list,如 Obsidian 拖笔记); - 上传兜底(浏览器/无壳时)——
POST /api/dsh-file-drop保存到<会话工作区>/.dsh-drops/,返回工作区路径。
拖拽监听挂在 window 捕获阶段,先于 DSH 自带的 document 级图片拖拽处理拦截(stopPropagation),不会触发「不支持非图片格式」报错。
限制
- 单文件 ≤ 25MB(上传兜底路径;壳直取路径不受限)
- 文本类(md/txt/json/代码等)按文本直写;二进制(PDF/Word/Excel/ZIP 等)经 base64 解码写真实字节
- 壳直取路径指向工作区外文件时,agent 读取需要沙箱放行(workspace-write 模式下需权限配置)
文件结构
index.js Host half:POST /api/dsh-file-drop 保存路由(node fs 原生能力)
client.js Client half:回形针按钮 + 拖拽监听 + 状态徽标(__ModuleLoader__ 格式)
cordis.patch.yml 组合行(inject: webServer, sessions)
dsh.plugin.json 插件清单
安装(已安装,仅备查)
dsh plugin --profile web add "link:/Users/fanxiaokang/dsh-file-drop"
# 重启 dsh web 生效
配套桌面壳(可选,推荐)
~/dsh-desktop/:Electron 壳,npm start 启动。自动复用/拉起 dsh web(127.0.0.1:3080),
preload 注入 window.dshDesktop(getPathForFile + drainDroppedPaths),使拖拽直取 Finder 原始路径。
视觉引擎基准(modlens,2026-08 实测)
DSH 的 modlens_read_image 走 modlens 视觉桥;单次分析为一次结构化输出(summary/OCR/版面/语义/视觉/不确定项)。
| 引擎 | 完整流程耗时 | 结论 |
|---|---|---|
| 智谱 glm-4v-flash(国内直连,免费) | ~3.7s | ✅ 当前配置,最优 |
| 智谱 glm-4.6v | ~17s | ❌ 慢 4.6 倍 |
| 智谱 glm-4.5v | 失败 | ❌ 不返回符合 schema 的 JSON |
| Gemini 免费 key(海外) | 429 额度用尽 / 兜底 codex-cli ~14s | ❌ |
配置位置:~/.modlens/config.json(providers.openai → baseUrl=https://open.bigmodel.cn/api/paas/v4,model=glm-4v-flash)。
端到端等待(贴图→回复)≈ 读图 3.7s + 模型回复生成时间,后者通常是主要部分。
链接
同类插件
Tencent/WeKnora#dsh-weknora★ 32318
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
superdesigndev/treg★ 4452
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
TencentCloudBase/CloudBase-AI-Toolkit#dsh-plugin★ 1132
把腾讯云 CloudBase 后端接入 DeepSeek Harness——在对话里搭好并部署全栈应用,查询结果渲染为表格卡片(分页、排序、导出 CSV),部署后可预览真实域名,并提供 CloudBase MCP 工具集(`mcp__cloudbase__*`),登录走 device-code 流程。
gitroomhq/postiz-agent#dsh-postiz★ 504
通过 MCP 将 DeepSeek Harness 连接到 Postiz:列出已连接的社交媒体渠道、获取各平台发帖规则,并向 X、LinkedIn、Instagram、Facebook、Threads、TikTok、YouTube、Reddit、Bluesky、Mastodon、Discord、Slack、Telegram 等平台排期、存草稿或发布帖子;附带 postiz 工作流技能。
EthanYoQ/Invoice-Downloader#dsh-invoice-downloader★ 496
面向 DeepSeek Harness 的本地 IMAP 发票下载、OCR 识别、归档与 Excel 报销汇总。
anysearch-team/anysearch-dsh★ 447
基于 AnySearch 的实时网页与垂直搜索插件,为 DeepSeek Harness 提供搜索工具。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。