dsh-stock-quotes

中文 | English

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

• 面板：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

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

实现说明

文件	作用
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。