前言¶

使用 DeepSeek Harness（DSH）做本地 Web 面板时，有些用户会希望在一个侧边入口里顺手查看 A 股持仓和自选行情，而不是另外打开浏览器标签页。

Bob-Bo1/dsh-stock-watch 是一个 DSH 客户端插件。它在 DSH 左侧边栏底部提供股票入口，用来查看 A 股持仓和自选股的实时行情；持仓页显示盈亏，自选页只显示行情，并支持在网页中添加数据、保存到本机 holdings.json。

插件定位¶

Bob-Bo1/dsh-stock-watch 由 Bob-Bo1 维护，许可证为 MIT。

它解决的是本机 A 股观察场景：把持仓和自选数据放在你自己的电脑上，通过 DSH Web 页面查看行情和盈亏。行情来自腾讯公开行情接口；持仓数据只从本机 JSON 文件读取，插件不会把持仓内容上传到项目作者服务器。

这是一个观察工具，不构成投资建议，也不会执行买卖操作。

核心功能¶

• 在 DSH 左侧边栏底部提供股票入口。
• 查看 A 股持仓和自选股的实时行情。
• 持仓页显示盈亏，自选页只显示行情。
• 支持在网页中查找、添加、修改和删除持仓与自选股票。
• 支持把股票数据写入本机 holdings.json。
• 支持环境变量 DSH_STOCK_HOLDINGS 指定持仓文件。
• 行情来自腾讯公开行情接口。
• 页面可见时按设置间隔刷新，页面不可见时暂停请求。
• 按 A 股习惯红涨绿跌显示。
• 网络异常时会保留上一组成功数据。

安装与启用¶

先从 GitHub 安装插件：

dsh plugin --profile web add github:Bob-Bo1/dsh-stock-watch

安装后，需要在 DSH Web profile 的 cordis.patch.yml 中确认存在插件注册项：

- insert:
  - id: stock-watch
    name: stock-watch

这里的重点是确认 id: stock-watch 和 name: stock-watch 已存在。

确认注册后，重启 DSH Web：

dsh web

如果要在本地做开发安装，可以先克隆仓库：

git clone https://github.com/Bob-Bo1/dsh-stock-watch.git D:\Tools\stock-watch
dsh plugin --profile web add link:D:\Tools\stock-watch

本地路径可以替换成你实际保存插件的目录。本地安装后，同样需要确认 cordis.patch.yml 已注册插件，再重启 DSH Web。

关联本机股票数据¶

推荐把持仓文件放在 DSH workspace 根目录：

你的 DSH workspace\holdings.json

最简单的做法是：

1. 复制仓库里的 holdings.example.json。
2. 将副本改名为 holdings.json。
3. 替换成自己的数据。
4. 放到 DSH workspace 根目录。
5. 打开 DSH 左侧边栏底部的股票入口查看结果。

也可以用环境变量指定一个本机文件：

$env:DSH_STOCK_HOLDINGS = 'D:\Private\stocks\holdings.json'; dsh web

这个环境变量只保存文件路径，优先级高于默认 workspace\holdings.json。

网页添加与字段要求¶

插件支持在网页中查找、添加、修改和删除持仓与自选股票。添加后的股票数据会写入本机 holdings.json。

持仓和自选使用不同字段：

• 持仓允许字段：code、name、quantity、costPrice。
• 自选允许字段：code、name。
• 其他字段会被丢弃。

持仓字段要求：

• code 必填，格式为 sh、sz 或 bj 加 5～6 位数字。
• quantity 必填，且必须大于 0。
• costPrice 必填，且必须大于 0。

自选字段要求：

• 每项只需要 code 和可选 name。

数据与计算范围¶

• 持仓页显示盈亏。
• 自选页只显示行情。
• 行情来自腾讯公开行情接口。
• 网络异常时会保留上一组成功数据。
• 按 A 股习惯红涨绿跌显示。
• 当前版本没有计入手续费、印花税、分红和融资成本。

适用场景与注意¶

适合需要在本机 DSH Web 面板中查看 A 股持仓、自选行情和本机盈亏的用户。使用前建议先检查源码、许可证和本机文件权限。

需要注意：

• 持仓数据只从你自己电脑上的一个 JSON 文件读取。
• 插件只把本机配置中的股票信息传给当前 DSH 页面，不会上传到本项目作者的服务器。
• 行情请求发送到腾讯行情接口时只包含股票代码，不包含你的数量、成本价或 API Key。
• 默认情况下，DSH Web 服务只监听本机地址。
• 如果暴露到局域网或公网，能访问 DSH 的人也可能读取本地插件路由返回的持仓摘要。
• 不要把真实 holdings.json、截图、账号信息或 API Key 提交到 GitHub。
• DSH 插件会以当前 DSH 进程权限运行；安装前建议检查源码和权限影响。
• 许可证为 MIT。

结尾¶

Bob-Bo1/dsh-stock-watch 适合放在本机 DSH Web 环境里，作为一个轻量的 A 股持仓和自选观察入口。它读取本机 holdings.json，调用腾讯公开行情接口刷新行情，并在持仓页显示盈亏。

• GitHub 仓库：https://github.com/Bob-Bo1/dsh-stock-watch
• 插件目录线索（来自插件线索，未包含在已抓取资料中）：https://www.skillhub.cn/plugins/Bob-Bo1/dsh-stock-watch