ld-1101/dsh-file-preview

README 摘要

dsh-file-preview DSH（DeepSeek Harness）文件预览插件：在 GUI 中浏览工作区文件、预览 Markdown / PDF / 图片 / CSV / 代码，展示当前会话产出/修改过的文件，并可将文件/文件夹拖入对话（插入单行路径）。 English: README.en.md 功能 - 左侧边栏入口 ：边栏底部「📁 文件」按钮，文件列表以右侧停靠的侧边栏列展示（对话保持可见，主列自动让位；窄屏降级为覆盖） - 宽度可调 ：拖动面板左缘手柄调整宽度（320–900px，随视口收缩），自动记忆；双击恢复默认 - 会话产出/修改文件 ：面板顶部列出当前会话中 AI 产出或修改过的文件（从会话事件日志提取），点击即预览 - 默认定位会话目录 ：自动定位到当前会话所在工作区与目录；多会话可在顶部切换 - 拖拽到对话 ：文件/文件夹拖到会话界面任意位置，即在输入框 光标处 插入 单行纯路径 （不粘贴内容） - 预览 ：Markdown 渲染 / PDF 内嵌 / 图片 / CSV 表格 / 代码文本 / 其他类型新标签页打开 - 安全 ：只能访问已注册的工作区，禁止路径穿越；文本读取 5 MiB 上限 安装 方式一：本地源码（当前推荐，npm 尚未发布） ⚠️ 本插件 尚未发布到 npm ， dsh plugin add 暂不可用；当前请使用本方式安装。 安装后 完全退出并重新启动 DSH 应用（宿主端插件在启动时加载）。 方式二：npm 发布后（推荐） 安装后 完全退出并重新启动 DSH 应用（宿主端插件在启动时加载）。 使用说明 1. 点击左侧边栏底部的 「📁 文件」 按钮，右侧展开文件列表面板；再点一次或点「✕ 关闭」收起 2. 顶部「📌 本会话产出 / 修改」列出当前会话 AI 产出/修改的文件，点击预览；下拉框可切换会话，切换后自动定位到该会话目录 3. 下方为工作区目录树：面包屑导航、目录优先排序、多工作区切换 4. 拖拽 ：把文件或文件夹拖到会话界面任意位置（无需对准输入框）→ 输入框光标处插入一行路径（如 C:\Users\...\简历.md ），发送即可让 AI 读取 5. 调整宽度 ：拖面板左缘手柄；双击手柄恢复默认宽度 6. 预览：点击任意文件 → 面板内渲染（Markdown/PDF/图片/CSV/代码），「新标签页打开」可脱离面板查看 会话产出文件说明 「会话产出」列表的数据来自会话事件日志：宿主读取 tool/result 事件中工具结果 JSON 的 locations[].path （与 DSH 自带 deliverables 同源）。注意：若 Agent 通过 run code 一类的包装工具执行文件操作（不产生 locations ），该列表为空——这是平台行为，与原生 deliverables …

分类