前言¶
用 DeepSeek Harness（DSH）写代码、跑智能体时，对话窗口往往占满屏幕。若还要单独开一个行情软件看指数和持仓，窗口切换频繁，注意力也容易被打断。常见做法是浏览器再开一个标签页，或手机上看盘，但和当前工作流仍是两套界面。
下面介绍社区插件 dsh-stock-leek（npm 包名 @shiqyka/dsh-stock-leek）：把大盘指数、自选股与持仓盈亏嵌进 DSH Web 对话界面，数据源为腾讯财经公开接口，红涨绿跌。维护者为 siqyka，分类为客户端插件，在 SkillHub 插件目录 可查到条目；源码与说明见 GitHub。
这是什么¶
dsh-stock-leek 是面向 DeepSeek Harness Web 端的股票行情插件：对话左下角常驻指数栏，配合可拖动的行情悬浮窗，覆盖大盘、自选、持仓与设置；支持 A 股、北交所、港股、美股的分时、K 线与持仓盈亏计算，无需离开 DSH 再开独立行情客户端。
运行环境要求（见 README 徽章与说明）：Node.js ≥ 20，DSH ≥ 0.2.0-rc.1。当前资料中的包版本为 0.7.2，许可证 MIT。
核心功能¶
对话左下角指数栏¶
- 展示可配置的大盘指数胶囊（如上证、深证、创业板、恒生、纳斯达克等）：简称、点位、涨跌幅，价格变动红/绿闪烁，盘中状态点。
- 点击胶囊打开悬浮窗；点
⚙进入设置。 - 有持仓时显示 💰收益 胶囊（今日盈亏），悬停可查看市值、累计收益、今日收益及每只持仓的当日明细。
- 交易时段行为：每天 9:00–15:06 自动展开；非交易时段自动收起，仅保留状态点与设置入口；可点 ● 手动收起/展开（选择持续到下一交易日失效）；午休不按 11:30–13:00 单独收起。
- 指数栏样式（点位+涨跌 / 仅涨跌）、对齐（左/中/右）、显隐可配；关闭指数栏后，仍可通过侧栏「插件 → @shiqyka/dsh-stock-leek」页内的「指数栏」配置卡片开关重新打开。
- 放置方式：默认悬浮锚定对话输入区左下角（可拖动）；可选嵌入输入框，走平台
conversation.composer.dock槽位（仅已有对话页显示，新会话页受平台限制不渲染该槽位）。
行情悬浮窗¶
四页：大盘、自选、持仓、设置；另有个股详情（分时 / K 线）与预警二级页。
| 页面 | 能力概要 |
|---|---|
| 大盘 | 指数列表可拖动排序；勾选是否显示在左下角；搜索添加港/美/北等指数；超过 10 条列表内滚动 |
| 自选 | 搜索（代码 / 名称 / 拼音首字母）添加；A 股、北交所、港股、美股、ETF、指数；现价、涨跌幅、涨速、成交额、换手等 |
| 持仓 | 成本价 + 股数；右键记买卖流水、查看交易记录；累计盈亏、今日盈亏（按当日买卖现金流口径）；可展开「今日盈亏走势」曲线 |
| 详情 | 分时（昨收基准线）；日/周/月 K（MA5/10/20/60）；持仓股显示成本线；五档盘口（集合竞价时段显示「集合竞价」）；滚轮缩放、拖动平移 K 线 |
| 设置 | 指数栏、刷新间隔（3–60s）、涨跌配色、数据源测试、预警、恢复默认等 |
悬浮窗标题栏有数据新鲜度徽标（距上次成功拉取已过 N 秒），过久未更新会标黄，可手动 ⟳ 刷新。
预警¶
在设置中进入预警二级页：支持多种条件（现价上/下穿、突破/跌破成本、涨跌幅、接近涨跌停、涨速等；成本类自动取持仓成本）。规则按股票分组管理；评估在 Host 独立循环 运行，关页面仍会评估（无规则或全市场休市时循环退避、不打上游请求）。触发时在对话区顶部居中弹窗（最多同时 3 条，10 秒自动消失等，见 README）。每交易日每规则只提示一次；休市/节假日按各市场交易时段与报价日跳过评估。
架构与数据流（简述）¶
浏览器 client.js 注册指数栏与悬浮窗 overlay，经同源路径 /dsh-stock-leek/* 访问 Host；Host index.js 提供配置读写、SSE 行情推送、批量行情与分时/K 线/搜索等路由，并持久化配置。配置主文件为 ~/.dsh/dsh-stock-leek/config.json；预警状态单独写在 config.json.alerts。更细的字段与盈亏口径见仓库内 docs/configuration.md、docs/architecture.md。
安装与启用¶
官方 README 给出的安装方式如下（二选一）：
# 本地目录（把 <path> 换成你自己 clone 的位置）
dsh plugin --profile desktop add file:<path>/dsh-stock-leek
# 发布后按包名（npm scoped 包，DSH 插件管理器自动识别）
dsh plugin add @shiqyka/dsh-stock-leek
安装后刷新页面生效。对话输入框下方出现指数栏；点任意指数胶囊打开悬浮窗，点 ⚙ 直达设置。
典型用法¶
- 看大盘：左下角查看已配置的指数胶囊；需要增删或排序时，打开悬浮窗「大盘」页，拖动 ⠿ 排序，勾选是否显示在左下角，用搜索添加新指数。
- 加自选：悬浮窗「自选」页搜索代码、名称或拼音首字母，添加后点击行进入分时/K 线详情。
- 记持仓：「持仓」页填写成本价与股数；右键 ⇅ 记一笔交易 录入买卖；右键 📒 交易记录 查看或删除流水。顶部可看市值与今日/累计盈亏，并可展开今日盈亏走势。
- 设预警：设置 → 预警；或自选/持仓行右键「🔔 设为预警」预填条件。注意规则存在即会评估，删除即停用。
- 指数栏被关掉时：侧栏进入插件页，用「指数栏」配置卡片上的胶囊开关重新开启。
刷新间隔、涨跌配色、盘口布局（左右/上下）、手数/金额切换等写入全局配置，跨股票与会话保持（详见 README 功能表）。
适用场景与注意¶
适合谁：长期在 DSH Web 端工作、又需要轻量盯盘（指数 + 自选 + 简单持仓账本）的开发者或用户；希望行情与对话同屏、减少切换窗口。
使用前请知悉：
- 插件以当前 DSH 进程权限在 Host 侧拉取腾讯财经公开接口并读写本地配置；安装前应自行查看 源码 与 MIT 许可证，确认符合你的安全与合规要求。
- 行情与盈亏为工具计算结果，不构成投资建议；接口可用性、休市规则以插件文档与实现为准。
- SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系；DSH 生态奉行「一切皆插件」，本插件为社区维护的客户端扩展之一。
结尾¶
dsh-stock-leek 把指数栏、悬浮窗行情、自选、持仓盈亏和预警收进 DSH 对话界面，数据走腾讯财经公开源，配置落在 ~/.dsh/dsh-stock-leek/。若要在 Harness 里少开一个行情窗口，可按上文命令安装 @shiqyka/dsh-stock-leek 后刷新页面试用。
- 目录页：https://www.skillhub.cn/plugins/siqyka/dsh-stock-leek
- GitHub：https://github.com/siqyka/dsh-stock-leek
