前言¶
DeepSeek Harness（DSH）的 Web 对话界面里，composer 上方通常是空白或固定 chrome。如果你希望在本地会话里看一眼自选股、或读一段 host 上的电子书，又不想把行情或书文摘进对话、session log 或模型上下文，就需要一个纯客户端展示面加最小 host 支撑的插件。dsh-fish（zingzheng/dsh-fish）走的就是这条路：在输入框上方用一行类似「推理过程」的样式挂 dock，整行由客户端渲染，不是会话事件，也不注册面向模型的 tool 或 prompt 段。
下面按定位、功能、安装与命令、两类应用、设置与数据边界说明用法。事实来自项目 README 与 package.json（当前版本 0.2.0，许可证 MIT，维护者 zingzheng）。
这是什么¶
dsh-fish 是面向 DSH Web UI 的 dsh.bundle 客户端插件（社区目录分类：客户端）。同一行 dock 里可切换两个应用：
- Stocks：自选列表，折叠时看起来像一行 reasoning 文本。
- Reading：TXT / EPUB 存放在 DSH host 上，进度可跨页刷新、跨浏览器共享。
插件以当前 DSH 进程权限运行；安装前建议自行查看 GitHub 仓库 源码与许可证。
核心功能¶
与对话的边界¶
- 摸鱼行完全在客户端绘制，不影响真实对话与模型输出。
- 不向模型注册 tool，不注入 prompt section。
- 书籍正文经同源认证路由由浏览器拉取，不写入会话、不进入模型上下文。
- 行情由 Host 代理请求
qt.gtimg.cn与web.ifzq.gtimg.cn，浏览器不直连这些第三方接口。
Stocks（自选）¶
- 折叠：一行展示当前焦点标的。
- 点击行可聚焦；按
E或点 chevron 展开（只点行本身不打开面板）。 R立即刷新；J/K（或方向键、[/]）切换焦点；1–9跳转到对应标的；Esc在聚焦时折叠。- 默认每 5 分钟刷新，间隔可在设置里改。
- 支持 A 股、港股、美股及部分指数，最多 12 个代码；颜色方案可选红涨绿跌、绿涨红跌或无着色（详见设置）。
Reading（阅读）¶
- 在 Settings → fish → Reading 导入书籍；文件上传到 host，存于
$DSH_HOME/fish，不进模型、不写 session log。 - 折叠：单行显示当前书的一行可视文本，长行自然换行，按「可视行」滚动。
- 展开：默认一页 10 行可视文本（6–14 可配）；翻页按视口，自动翻仍每次一行。
- 进度按字符位置锚定，改字号、行数、窗口宽度或折叠状态仍回到同一段文字。
- 每本书独立进度；多浏览器连同一 host 共享书架与进度。
- 支持 TXT（UTF-8、UTF-16 LE/BE、GB18030）与 EPUB（无图/CSS/脚注/DRM 渲染；不支持 PDF、MOBI、AZW3 等）。
- Host 限制：单文件上传 64 MB，解析文本最多 2000 万字符，EPUB 解压 64 MB，章节最多 5000；书架最多 100 本。
快捷键分「阅读行聚焦」与「全局（需 Ctrl/Alt/Cmd 修饰）」两套，可在 Settings → fish → Reading 与 Global 重绑。全局默认含隐藏/恢复 Alt + H、展开/折叠 Alt + G。
安装与启用¶
环境要求：
- 已启用 Web UI 的 DeepSeek Harness。
- Host 上 Node.js 20+（
package.json中engines.node为>=20）。
从 GitHub 安装（命令以 README 原文为准）：
dsh plugin --profile web add github:zingzheng/dsh-fish
安装后重启 DSH，以便加载 Host 端与客户端 bundle。
本地开发可用 link 指向工作副本：
dsh plugin --profile web add link:/path/to/dsh-fish
重启后打开会话，执行 /fish 验证。
典型用法¶
会话内命令（Host 命令；直接形式会在对话里出现普通 command 行）：
/fish # 打开应用选择器（选择器侧为客户端弹层，选中不写入 command 事件）
/fish stock # 直接打开自选
/fish novel # 直接打开阅读
/fish off # 关闭当前会话的 fish 行
/fish status # 打印当前激活的应用
设置入口：Settings → fish，含 Global、Stocks、Reading 等标签；股票与阅读的部分 UI 偏好存在浏览器 localStorage，书籍与进度在 host 的 $DSH_HOME/fish/ 下（如 library.json、books/<sha256>.json）。
适用场景与注意¶
适合谁：经常在 DSH Web 里长时间开着会话、需要旁边一行自选或本地电子书、且强调与模型上下文隔离的开发者或自用部署。
使用前请确认：
- 插件随 DSH 进程权限访问 host 文件系统与对外请求（行情代理、书籍存储）；生产环境请评估网络与磁盘策略。
- 上传文件在 host 上以仅属主权限存放；通过设置删除书会移除解析内容与书架记录，不保留原始上传文件副本。
- 社区目录 skillhub 条目 为独立生态站点，与 DeepSeek / 幻方无官方从属关系；安装仍以 README 命令与仓库为准。
结尾¶
dsh-fish 把「思考行」样式的 dock 做成两个互不打扰的小应用：行情走 host 代理，阅读走 host 书架与字符级进度，并明确排除进入对话与模型侧。若你要在 Web composer 上叠加这类人机专用表面，可按上文安装命令接入，用 /fish 系列命令与 Settings 完成配置。
- 目录页：https://www.skillhub.cn/plugins/zingzheng/dsh-fish
- GitHub：https://github.com/zingzheng/dsh-fish
