为 DeepSeek Harness 提供右侧栏文件启动器,支持对话与项目文件盘点、搜索筛选、图片/PDF/Office 预览、缺失文件标记、收藏、归档副本与 @ 引用。
安装
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:ZOU2850/dsh-file-launcher
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。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 右侧边栏的文件启动器:把「这个对话产出了哪些文件、交付了哪些文件、我发了哪些附件、工作区里有哪些文档」收进一个面板,并直接预览、用本机软件打开、在资源管理器中定位、加入输入框引用、收藏防上下文压缩、归档备份。
功能
- 当前对话 / 我发送的 / 当前项目 / 收藏 / 历史对话 五个范围。我发送的 会扫描最近 20 个顶层会话,跨所有项目汇总用户发送的文件与图片,并按 项目 → 会话 折叠分组;历史对话同样按项目分组,可折叠展开。
- 从会话日志自动发现文件:
present交付、write/edit/apply_patch结果、读取过的文件、用户发送的普通文件、@路径文件/文件夹与图片。 - 一个「筛选」按钮打开主从面板:左边来源是父级(交付/用户/生成/参考/工作区…),右边类型嵌在当前来源下。父级数字保持稳定,子级数字按父来源、搜索和已归档实时计算;选中的筛选显示为可移除标签,清除全部一键复位。
- 我发送的 / 当前项目按“项目 → 会话”分组。「我发送的」支持组头和会话头折叠,且可设置默认收起,打开面板先看到项目目录;当前项目在单一项目下自动展开外层分组,免去无谓折叠点击。搜索或任一筛选生效时会自动展开匹配分组,筛选只作用于组内文件,组头数字随筛选更新。
- 用户 @ 路径会被解析:文件归入用户文件并标记 引用,同时出现在 用户 与 我发送的;点引用标签或右键 追溯引用位置 可查看来源会话、项目、消息位置、时间和原始文本。文件夹显示为文件夹行并提供 在资源管理器中打开;未知/特殊扩展名自动分类为程序、设计文件、数据库、字体、磁盘镜像、二进制、文件夹等。支持
@路径、@"带空格路径"和紧跟在中文后的@"..."。 - 工作区文档扫描:Word、PowerPoint、Excel、PDF、Markdown、文本、图片、HTML、音视频、压缩包及特殊文件;自动跳过
node_modules、.git、构建产物与隐藏目录。 - 面板打开时定时刷新:默认每 60 秒 自动轮询当前范围(可在设置中调整 5–300 秒或关闭),复用 Host 短时缓存避免卡顿;显式点击「刷新」时绕过缓存(
fresh=1)。「我发送的」会先合并当前会话。 - 文件删除后保留空壳:用户发送/交付的文件消失后保留为 不存在 行,显示最后路径,不会直接消失;通过插件删除的文件会记录 tombstone,不会以空壳回来。移盘后如果新路径在同一会话里再次出现且文件名+大小一致,会尝试关联为 已移动;跨盘移动且没有新引用时无法自动发现,会保留空壳,直到重新发送新路径或手动清理。
- PDF/Office 页面预览工具栏常驻:上一页/下一页、页码、缩放、适合宽度、在侧边栏打开、关闭;点击外部不会关闭,页面内右键可弹菜单。
- 面板内预览图片、PDF、Markdown、文本,以及经 Host
office-kit转 PDF 再渲染成页面的 Word/PowerPoint/Excel;图片支持「上一个 / 下一个」和键盘←/→。 - 常驻行操作 + 浮动右键菜单:右键或点 打开方式 ▾ 会在点击位置弹出可滚动卡片,包含预览、本机打开、资源管理器、关联软件、复制、收藏、归档和 删除文件。
- 历史对话全局返回:从项目进入会话后,标题栏左侧的
←可返回历史项目列表。 - 预览内右键:图片预览中右键同样弹出操作卡片,可复制图片、复制路径、插入引用、收藏、归档、删除。
- 删除需确认:明确确认后才从硬盘永久删除,并同步移除收藏记录与归档标记;不会误删。
- 打开方式:按文件关联列出本机软件;可在资源管理器中显示;Windows 下可呼出系统原生「选择打开方式」。
- 加入输入框 / 插入引用:优先通过宿主可选的
fileDrag服务作为真实文件附件加入输入框;若宿主未提供或无拖放目标,则自动回退写入可退格删除的@路径文本或复制到剪贴板。 - 收藏(只保护路径记忆):写入
$DSH_HOME/file-launcher/pins.json;文件始终留在硬盘,收藏不会移动或删除文件,上下文压缩只压缩记忆、不影响文件。 - 归档(只复制副本):优先复制到
$DSH_FILE_LAUNCHER_ARCHIVE_DIR或设置页配置的「自定义归档目录」,默认归档至系统文档目录下的DeepSeekHarnessFileLauncher/Archived_Docs日期文件夹;原文件保留。成功复制会记录到archive.json,面板显示 已归档 标记并支持单独筛选。 - 模型工具
file_launcher:list(含跨会话sent)/sessions/pin/unpin/archive。
安装与使用
把本目录作为 DSH bundle 通过 插件 → 添加插件 安装,刷新页面。三个快捷入口:对话标题栏右侧工具区的文件夹按钮、输入框工具行左侧的 文件 胶囊、右侧边栏 + 指南中的「文件启动器」卡片。任一点击即可打开面板。
从 GitHub 安装:
- 打开 DSH 的 插件 → 添加插件
- 安装源选 默认 / GitHub(中国大陆镜像源主要用于 npm 包,不一定代理 GitHub)
- 输入仓库地址:
https://github.com/ZOU2850/dsh-file-launcher - 点击 安装
- 安装完成后完全退出并重开 DSH(1.4.x 改了 Host 扫描与设置模块,重启才加载新模块)
如果 GitHub 安装失败,可在同一输入框填本地目录:
D:\Downloads\文件打开助手插件dsh适配改造\dsh-file-launcher
已安装同名插件时,先移除/禁用旧版本再安装,避免重复实例。
- 选择范围:当前对话、我发送的、当前项目、收藏或历史对话。
- 点击文件行在面板内预览;图片/Office 可直接切换上一个、下一个。
- 行尾 打开方式 ▾ 或右键文件行,可在点击位置弹出可滚动卡片:预览、本机打开、复制路径/引用、插入引用、收藏、归档、删除。
设置
在 DSH 底部头像菜单进入 设置,左侧导航会出现 文件启动器:
外观
- 主题:跟随 DSH / 浅色 / 深色 / 跟随系统
- 切换后立即应用到已打开的侧边栏,并自动写入
settings.json和当前浏览器本地缓存,跨重启保留
行为、预览与路径
- 面板打开时自动刷新开关,以及刷新间隔(5–300 秒,默认 60 秒)
- 默认打开范围(当前对话 / 我发送的 / 当前项目)
- 「我发送的」项目/会话分组是否默认收起
- PDF/Office 最大渲染页数(1–40)、渲染 DPI(80–160)
- 单次加载上限(100–2000)
- 自定义归档目录,并展示当前数据目录、我发送的索引与实际归档路径
设置写入 $DSH_HOME/file-launcher/settings.json,不写入 profile 的 cordis.patch.yml,因此插件升级/重装不会覆盖。
目录
dsh-file-launcher/
├── index.js # Host 半边:注册工具与路由
├── lib/
│ ├── inventory.js # 会话日志 / 工作区文件盘点
│ ├── store.js # 收藏清单与归档
│ ├── routes.js # 认证 Fetch 路由
│ ├── tool.js # file_launcher 工具
│ └── util.js # 路径、分类、引用文本
├── client.js # 浏览器半边(右侧边栏面板)
├── locale/{en,zh}.json # 插件管理器元数据
├── docs/DETAIL.md # 详细说明
├── icon.svg
└── cordis.patch.yml
兼容与升级
- 在 DSH Desktop 0.2.2-rc.3 / Electron 44.7 / Node 24.21 上测试。
- 只使用公开扩展点:
ctx.tools、ctx.connection.fetch、Cordis 服务、Clientslots/sidebarRightTabs/locale/ remotes;没有 import 任何@deepseek-ai/dsh-*包,可选能力(officeKit、fileDrag)不阻塞插件启动与激活。 - 设置页通过
settings.section懒注册:旧版 DSH 没有该 slot 时只是没有设置页,不会阻止插件加载;如果未来 DSH 改这个 slot 的契约,需要随版本适配。 - 升级方式:重新安装/启用 bundle 后完全退出并重开 DSH,再刷新页面(如新增 Host 路由或设置字段,仅刷新页面可能仍使用旧的 Host 模块)。
pins.json、sent-index.json、archive.json、settings.json、deleted.json都在$DSH_HOME/file-launcher/,不会因插件升级丢失。 - 社区分发时请保持
package.json中的dsh.bundle/dsh.client/engines.dsh与LICENSE完整;无需启用启动期阻塞标记。
性能与资源
- 不消耗模型 token:面板、预览、自动刷新都在浏览器/Host 本地执行,不调用 LLM。
- 只有模型主动调用
file_launcher工具时才占上下文;默认最多 60 行,可通过工具参数limit降到 1 行。 - 自动刷新默认 60 秒;在设置里可以关闭或调整(5–300 秒)。刷新请求带
AbortController,不会在慢会话上堆叠请求。 - 面板默认最多加载 800 行;PDF 默认最多 20 页(可调到 40 页),普通 PDF 直接按 Host 磁盘路径渲染避免冗余 base64 传输。
- 内存主要是 DSH/Chromium 本身与当前打开的预览图;
$DSH_HOME/file-launcher/previews下生成的临时预览缓存会自动清理上限。
限制
- 仅由 shell 命令创建、且没有出现在工具结果或
present中的文件,只会归入「当前项目」,不会归到具体对话。 - 本机打开能力取决于 Host 是否为桌面端。
- PDF 页面渲染依赖本地
pdfinfo/pdftoppm;缺失时预览会提示,并保留“在侧边栏打开”。 - 文件夹 @ 路径 只提供资源管理器入口,不会展开或递归扫描文件夹内容。
- 面板内 Office 预览依赖当前 profile 的
office-kit提供方;缺失时回退到右侧边栏原生预览。 - 空壳只覆盖用户 @ 文件和交付文件;纯工作区文件如果被外部删除、又从未被对话引用,就没有历史路径可以保留。跨盘移动且没有新引用时也会保留旧空壳。
- 定时刷新默认 60 秒轮询,不是文件系统监听;刚创建的文件会在下一个周期出现,也可点击刷新即时获取。
- 我发送的 只扫描最近 20 个顶层会话,并且逐个串行读取;首次访问时才构建索引,启动时不预热扫描,避免一次读取大量会话导致宿主内存峰值。索引持久化到
$DSH_HOME/file-launcher/sent-index.json,之后打开直接读索引,支持点击刷新重建。 - 插入引用 / 附件:依赖宿主是否提供
fileDrag与编辑框拖放接收器;不可用时自动退回@路径文本或剪贴板。 - 用户 @ 引用:用户在消息里用纯文本
@路径发送的文件(包括桌面绝对路径)会被解析,并出现在 用户 / 我发送的 里,不再只识别浏览器附件。 - 删除文件 是永久操作,无法撤销;归档和收藏都不会删除文件。
- 收藏是当前机器的全局清单,不随会话导出同步;收藏只保护路径记忆,不会移动或删除文件。
- 归档是普通文件副本,没有版本历史;原文件始终保留。
- 规范化图片附件没有扩展名,Host 会在
$DSH_HOME/file-launcher/previews发布带扩展名的预览链接,附件对象本身仍是文件本体。
详见 docs/DETAIL.md;QA 与资源测量见 docs/QA.md。
链接
同类插件
zhu1090093659/dsh-web#packages/dsh-task-board★ 10458
侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。
zhu1090093659/dsh-web#packages/dsh-web-all★ 10458
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
ccch1mneyyy/dsh-TUI★ 7797
Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7271
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
omdsh-dev/DSH-better-sidebar★ 5191
侧边栏完整工作台:内置文件渲染编辑、终端、Git 与子代理,支持三方插件注册新 Tab。
omdsh-dev/dsh-genui★ 1007
助手回复内渲染交互式 UI 组件:布局、图表、表单、测验、mermaid、3D 场景与回传事件循环。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。