前言¶
在 DeepSeek Harness（DSH）里和模型讨论工作区文件时，常见做法是手动复制路径、粘贴大段正文，或把 Excel 区域截图发出去。聊天记录容易被引用撑满，模型侧也未必能稳定对齐「第几行、哪张表、哪一页」。
dsh-file-to-chat 是面向 DSH Web 右侧栏的客户端插件：在文档预览里划选文字、框选表格区域，或在文件树上右键文件，把选区（或整份文件）连同你的批注写入当前会话输入框；发送后引用在界面里收成可展开的小胶囊，完整内容仍按插件规则交给模型。下面按安装、用法和限制说明。
这是什么¶
- 名称：dsh-file-to-chat（社区目录条目：feifiefei/dsh-file-to-chat）
- 维护者：feifiefei（GitHub 为镜像；开发与版本以 Gitee 主仓为准）
- 分类：客户端（
client.js在浏览器侧运行，宿主侧lib/index.js仅占位） - 许可：MIT
插件不增加宿主路由与额外 Node 依赖，逻辑集中在浏览器 bundle，通过 DSH 官方扩展点挂到右侧栏文档预览、文件树和输入框胶囊机制上。
核心功能¶
文档预览里划词批注¶
支持右侧栏文档预览的三种渲染器：
| 预览类型 | 怎么选 | 引用块里定位到 |
|---|---|---|
| 文本 / 代码 / Markdown | 直接划选文字 | （第 N 行） 或 （第 N-M 行） |
| Excel / CSV / TSV | 在表格里拖选区域 | （工作表 <名> · 区域 B3:D7），区域内值转为 Markdown 表格 |
| Word / PPT / PDF | 在文字层里划选 | （第 N 页） 或 （第 N-M 页） |
松手选区后会出现「批注」按钮（靠顶部时会落到下方）；点开写批注，Enter 发送，Shift+Enter 换行，Esc 取消。拖选过程中不会弹出按钮。
文件树右键菜单¶
在右侧栏「文件」标签页对文件或文件夹右键：
| 菜单项 | 作用 |
|---|---|
| 发送到聊天 | 读正文并开卡片（文本内联；.docx / .xlsx 在浏览器解包抽正文，其余按字节回退） |
| 只发送路径 | 不读正文，只发路径与「未读取正文」说明 |
| 发送目录清单 | 文件夹专用，列出目录内容 |
| 用默认程序打开 | 交给系统关联程序；文件夹则打开文件管理器 |
| 复制完整路径 / 复制相对路径 | 复制到剪贴板 |
已发送引用的折叠展示¶
消息里的 > 📄 引用来源：… 会折成胶囊：模型侧收到完整引用，聊天窗口只显示标题；点击胶囊可展开，移开鼠标自动合上。
插件只负责把胶囊填进输入框草稿，不会替你点发送；你可以先写批注、再按自己的节奏发送。
安装与启用¶
需要 DSH Web 0.2.x（README 记载在 0.2.0-rc.2 与 0.2.1-rc.2 上验证可用）。
从 Git 仓库安装（推荐）¶
桌面端 profile 为 desktop：
dsh plugin --profile desktop add https://gitee.com/mofeo/dsh-file-to-chat.git
dsh web 起的 Web 端将 profile 换成 web：
dsh plugin --profile web add https://gitee.com/mofeo/dsh-file-to-chat.git
装完后在 设置 → 插件 确认已启用，并对浏览器做一次硬刷新（Ctrl+Shift+R）。
社区目录页（dsh-plugin.org / skillhub.cn）可能给出 GitHub 镜像安装地址；若镜像滞后于主仓，可改用上述 Gitee 命令安装或切换源。
卸载¶
dsh plugin --profile desktop remove dsh-file-to-chat
Web 端将 desktop 换成 web。有会话正在跑时卸载会被拒绝（refused while agents are running），需先停掉再卸。
安装前请自行查看仓库源码与 MIT 许可证；插件在当前 DSH 进程权限下运行，读文件能力与工作区访问范围一致。
典型用法¶
- 在右侧栏打开「文件」标签页，点开文件进入预览。
- 划选文本 / Word / PDF 页面文字，或在 Excel 里拖选区域。
- 点选区旁的「批注」，填写说明（可留空）。
Enter或点「发送到聊天」；输入框出现引用胶囊。- 确认内容后，自行发送消息。
发送后，聊天里可见类似结构：引用来源行（含绝对路径与行号/工作表区域/页码）加上你的批注；界面侧以胶囊展示，需要时再展开全文。
适用场景与注意¶
适合：经常对照工作区文档、表格或 PDF 与模型讨论；希望引用带定位信息、又不想把长引用铺满聊天记录的 DSH 用户。
限制与依赖（摘自 README）：
- 仅右侧栏可触发；未打开预览时不会有文档侧入口。
- Word / PPT / PDF 只能定位到页码，无行号概念。
- Excel 仅当前工作表，内联上限 200 行；
.xlsx公式取缓存值。 - 读不到正文时会说明原因，不会假装成功。
- 依赖若干 DSH 内部 DOM 约定；DSH 大版本升级后若锚点变化，控制台可能
warn，需维护者跟进。
调试时可在浏览器控制台执行：
localStorage.setItem('dsh-file-to-chat:debug', '1') // 刷新后打开细节日志
localStorage.removeItem('dsh-file-to-chat:debug') // 关闭
结尾¶
dsh-file-to-chat 把「右侧栏选区 + 批注」和「文件树右键发送」接到当前对话输入框，并用胶囊折叠展示已发送引用，适合在 DSH 里做带定位的文件协作讨论。
- 社区目录页：https://www.skillhub.cn/plugins/feifiefei/dsh-file-to-chat
- GitHub 镜像：https://github.com/feifiefei/dsh-file-to-chat
- 开发主仓：https://gitee.com/mofeo/dsh-file-to-chat
