自选股行情面板 AhaCrazy/dsh-stock-quotes

dsh-stock-quotes

DeepSeek Harness 插件：在侧边栏数据面板里显示自选股实时行情，同时注册 stock_quote 工具，让智能体能在对话里直接回答「茅台现在多少钱」这类问题。

- 面板：A 股 / 港股 / 美股自选股一张表 —— 最新价、涨跌额、涨跌幅、今开 / 最高 / 最低、成交额；15 秒自动刷新；右键菜单、拖拽排序、多选批量操作。
- 工具：stock_quote 一次批量取回一只或多只行情（不带参数时用配置里的默认自选股）。
- 外观中性：侧边栏默认叫「数据」、图标是普通表格样式，显示名称可配置 —— 看起来像通用数据视图，而不是行情软件。

行情来自公开接口的延时/快照数据，仅供查看，不构成任何投资建议，不用于交易决策。

环境要求

- DeepSeek Harness（0.2.x，需要 plugin_manager 工具）
- 无需 API key，无需安装额外依赖；Host 半不 import 包外任何模块

安装

git clone https://github.com/AhaCrazy/dsh-stock-quotes.git

然后在 DSH 会话里按绝对路径安装这个 bundle：

plugin_manager action: install_bundle target: <path-to>/dsh-stock-quotes

客户端模块加载后侧边栏会出现图标；没出现就刷新一次页面。stock_quote 会在下一次请求的工具清单里出现。

卸载：

plugin_manager action: remove_bundle target: dsh-stock-quotes

面板操作

| 操作 | 怎么做 |
| 添加 | 顶部输入代码 → 回车 / 点「添加」 |
| 删除 | 在任意一行上右键 → 菜单里选「删除」（没有每行右侧的 ✕ 按钮） |
| 排序 | 拖行首的 ⠿ 手柄上下拖拽，落点会显示品牌色指示线；也可以用右键菜单的「上移 / 下移 / 置顶 / 置底」 |
| 多选 | 勾选每行最左侧复选框；表头复选框是全选 / 清空 |
| 批量操作 | 选中 ≥1 项后表格上方出现操作条：删除所选 / 置顶 / 置底 / 取消选择 |
| 右键菜单其余项 | 复制代码（多选时按行拼接）、全选、清除选择 |

右键菜单是感知选择范围的：右键的那一行若已在多选里，删除 / 移动 / 复制会作用于整个选中集合，菜单标题会带数量；否则只作用于该行。

自选股顺序与成员保存在浏览器 localStorage（键 dsh-stock-quotes/watchlist）。表格始终按自选股顺序渲染、行情按代码映射进对应行，所以拖动排序不会让「代码 ↔ 报价」错位。

显示名称

侧边栏文案、面板标题、提示信息共用一个可配置名称，默认「数据」。到 设置 → 插件 → 「数据面板」→ 面板设置 里改；留空即恢复默认。名称会自动去首尾空白、忽略多余空格、限 24 字，存在 localStorage（键 dsh-stock-quotes/prefs）。

支持的代码写法

| 市场 | 写法 | 例子 |
| 上交所 | 6 位代码 / sh 前缀 | 600519、sh600519、688981、900901 |
| 深交所 | 6 位代码 / sz 前缀 | 000001、sz000001、300750 |
| 北交所 | 6 位代码 / bj 前缀 | 430047、830799、920001 |
| 港股 | 1–5 位数字 / hk 前缀 | 00700、700、hk00700 |
| 美股 | 字母代码 / us 前缀 | AAPL、usAAPL、BRK.B（自动在 NASDAQ / NYSE / AMEX 之间匹配） |
| 原始 secid | 市场.代码 | 1.600519、116.00700 |

配置

cordis.patch.yml 里的 config.defaultSymbols 是 stock_quote 不带参数时使用的默认自选股：

- insert:
- id: stock-quotes
name: 'dsh-stock-quotes'
config:
defaultSymbols:
- sh000001
- sh600519
- sz300750
- hk00700
- usAAPL

注意：面板自己的自选股存在浏览器里，与这份配置相互独立 —— 配置是给智能体查的，面板是给自己看的。

实现说明

| 文件 | 作用 |
| package.json | bundle 清单：dsh.bundle.patch 插入 Host 行，dsh.client 让 Web 端加载浏览器半 |
| cordis.patch.yml | Loader 补丁：插入 stock-quotes 行并给出默认自选股 |
| index.js | Host 半：以原生 ToolDefinition 注册 stock_quote（包外零依赖） |
| quotes.js | 纯数据层：代码解析、批量取数、格式化 |
| client.js | 浏览器半：main 面板、plugins.bundle.config 设置卡、sidebar.panellist 图标 |
| locale/{zh,en}.json | 插件管理器卡片的标题与描述 |

改代码前值得知道的两条设计约束：

- Host 半不能写裸 @deepseek-ai/... import。 工作区里的 bundle 是 link 进 profile 的，这些裸模块名解析不到，整行会 failed to import。所以它直接用原生 ToolDefinition。
- 浏览器半不 import 任何 Harness 客户端包。 控件全部自己写、只用主题 token（--dsw-alias-*），这样跨 Harness 版本更稳。

测试

npm test
- tests/quotes.test.mjs：代码解析、批量取数、格式化、取消；确定性的部分不联网，联网段不可达时自动跳过。
- tests/render.test.mjs：工具定义与它渲染的文本——两位小数、正负号、缺失字段显示为「—」、退化输入不抛错。
- tests/client.test.mjs：模拟模块加载器 / 语言服务 / slot 注册表 / React，断言注册了什么、组件渲染出什么，以及排序与移动的纯函数。

Host 半的完整契约校验需要 DSH 安装目录里的包，因此没有放进本仓库。

许可证

MIT —— 见 LICENSE。