stock-watch
DSH 股票观察站：在左侧边栏查看 A 股持仓、自选行情和持仓盈亏，支持网页添加并保存到本机 holdings.json。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Bob-Bo1/dsh-stock-watch#8b74366224b59cc8eed547d431e4f1da2029bc74Stock Watch 以 stock-watch 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
一个面向 DeepSeek Harness（DSH）的客户端插件。它在 DSH 左侧边栏底部提供一个 📈 入口，用来查看 A 股持仓和自选股的实时行情。持仓页显示盈亏，自选页只显示行情。
holdings.example.json 只有假数据。请不要把真实的 holdings.json、截图、账号信息或 API Key 提交到 GitHub。code、name、quantity、costPrice，自选使用 code、name。其他字段会被丢弃。dsh plugin --profile web add github:Bob-Bo1/dsh-stock-watch
然后在 DSH Web profile 的 cordis.patch.yml 中确认有这段注册配置：
- insert:
- id: stock-watch
name: stock-watch
重启 DSH Web：
dsh web
如果你使用的是 dsh.cmd，把上面的 dsh 换成 dsh.cmd 即可。
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。
安装并重启 DSH 后，直接打开左下角的 📈 按钮即可在网页里管理数据。
面板底部有两个页面：
点击面板底部的“＋添加”，输入名称或代码后搜索。若有多个匹配结果，选择正确的一项，插件会把代码和名称写入本机的 holdings.json。股票名称会先在 Host 端解析为代码，浏览器不会直接修改文件。
点击底部的“修改”后，选择一只股票即可编辑。持仓可以修改股票名称、买入份数和买入价格；自选可以修改股票名称。编辑表单中也提供“删除这只股票”，删除前需要确认。持仓页和自选页分别管理自己的列表；删除持仓不会影响同一只股票在自选中的记录。打开股票插件、切换持仓/自选页面时，插件会立即重新读取数据并刷新行情，后台仍会按设置的间隔继续更新。
网页添加失败时，可以继续使用下面的 JSON 文件方式。
推荐把持仓文件放在 DSH workspace 根目录：
你的 DSH workspace\holdings.json
最简单的做法：
holdings.example.json。holdings.json。DSH workspace 通常就是启动 dsh web 时所在的目录。你也可以用环境变量指定一个本机文件：
$env:DSH_STOCK_HOLDINGS = 'D:\Private\stocks\holdings.json'
dsh web
相对路径会按 DSH workspace 解析。环境变量优先级高于默认的 workspace\holdings.json。
如果你希望无论从哪个目录启动 DSH 都使用同一个文件，可以在 Windows 用户环境变量中固定路径：
[Environment]::SetEnvironmentVariable('DSH_STOCK_HOLDINGS', 'D:\你的固定目录\holdings.json', 'User')
设置后请完全重启 DSH Web。这个环境变量只保存文件路径，不会把持仓内容上传到 GitHub。
{
"refreshSeconds": 5,
"holdings": [
{
"code": "sz000001",
"name": "示例股票",
"quantity": 100,
"costPrice": 10.5
}
],
"watchlist": [
{
"code": "sh600028",
"name": "示例自选"
}
]
}
字段说明：
| 字段 | 必填 | 说明 |
|---|---|---|
code | 是 | sh、sz 或 bj 加 5～6 位数字，例如 sz000001 |
name | 否 | 自定义名称；不填时使用行情接口返回的名称 |
quantity | 是 | 持仓数量，必须大于 0 |
costPrice | 是 | 成本价，必须大于 0 |
refreshSeconds | 否 | 行情刷新间隔，支持 1～3600 秒，默认 5 秒 |
watchlist 中的每一项只需要 code 和可选的 name。持仓和自选可以同时出现同一只股票。
文件保存后，插件会自动重新读取。页面可见时按设置的间隔刷新行情，页面不可见时会暂停行情请求。
确认三点：
dsh plugin --profile web add ... 安装插件。cordis.patch.yml 中存在 id: stock-watch 的注册项。检查：
holdings.json。DSH_STOCK_HOLDINGS，且路径确实存在。sh、sz 或 bj 前缀。sh600547、sz000001。真实文件名请使用 holdings.json，仓库已通过 .gitignore 忽略它。提交前仍建议检查：
git status --short
git diff --cached
确认提交内容中只有 holdings.example.json，没有自己的股票代码、数量和成本价。
npm run check
npm pack --dry-run
npm pack --dry-run 应只显示插件代码、README、示例数据、许可证和 package.json，不应包含真实持仓文件或 node_modules。
stock-watch/
├─ lib/index.js # DSH Host 侧：本地数据、搜索和保存路由
├─ lib/client.js # DSH Client 侧：切换、添加和行情面板
├─ holdings.example.json # 假数据示例，公开安全
├─ package.json # npm 与 DSH 插件清单
├─ LICENSE
└─ README.md
MIT License，详见 LICENSE。