前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。开发者需要在智能体会话中接入实时市场数据，进行盯盘或辅助决策。dsh-tradewatcher 是一个 Web 插件，通过 ctx.betterSidebar 服务在侧边栏注册「盯盘」页签，提供行情、自选、持仓和大盘分析功能。
核心功能¶
顶部行情与自选¶
页签顶部展示三行行情条（A股指数、国际市场、大宗商品），每 10 秒自动刷新，页面隐藏时暂停。每张卡片悬停可显示当天分时图（源缺失时回退近 5 日收盘走势）。
自选列表支持分组管理（新建、改名、删除/归档、备注），组内添加证券时支持名称/代码搜索补全。列表展示所属行业板块及板块当日涨幅，并计算个股相对板块的 Alpha（个股涨跌幅 - 板块涨跌幅）。支持按默认顺序、当日涨跌、总市值排序。
持仓账本¶
持仓采用流水驱动，支持分组 CRUD（删除即归档）及组内证券的买卖、调整、编辑、移动和移除操作。分组与总览显示总市值、浮动盈亏、当日盈亏、累计已实现。每行明细含浮动盈亏率与当日盈亏率。支持按默认顺序、市值、持仓盈亏、当日盈亏、仓位占比排序。
A股大盘与护盘信号¶
A股大盘页提供六大指数、涨跌家数/成交额统计，行业/概念板块及主力资金排行，ETF 排行，以及个股/基金搜索详情卡。
护盘信号工具用于识别符合国家队历史行为模式的宽基 ETF 护盘行为。面板展示等级（强护盘/疑似护盘/资金异动/平静）、评分及归因。监测通道默认为 6 只宽基 ETF（如沪深300ETF），支持在设置中添加自定义通道。评分基于六因子加权（量能、超大单、脉冲、持续性、量价背离、共振），并引入时点系数（早盘/尾盘权重不同）。此外，面板还展示底部位置、日内形态及底部概率（历史频率）。
技术图表与详情¶
自选或持仓点击后弹出右侧抽屉，展示固定信息头及三窗格专业图（主图、成交量、MACD）。K 线叠加 MA5/10/30/60，支持滚轮以光标为中心缩放及日期宽度缩放窗。图表上标注买卖点，下方可切换分时、五日、日K/周K/月K/年K。
安装与启用¶
通过 npm 安装后，执行安装脚本以加载插件配置。
npm run install:profile
安装完成后，在 DSH 环境中通过 ctx.betterSidebar 即可看到「盯盘」页签。
典型用法¶
- 查看行情：在侧边栏打开盯盘页签，查看顶部三行行情条及悬浮分时图。
- 管理自选与持仓：在自选或持仓页签中添加证券、调整分组或排序。
- 分析资金流向：进入 A股大盘页，查看护盘信号面板，分析资金流向与市场情绪。
- 辅助决策：利用只读模型工具
tradewatcher_rescue读取当前信号与因子明细，或在会话中导出明文 JSON 文件进行深度分析。
注意事项¶
- 行情性质：数据来源为免费公开接口的延迟行情（非 L2），仅作盯盘参考，不构成投资建议。
- 历史数据限制：免费源无 ETF 资金流历史，历史回看只能从本模块上线日起算。
- 数据存储：采样数据与信号事件保存在
rescue-log.json（60 天滚动）。 - 数据源切换：东财接口限流时，会自动切换至腾讯备用源（部分功能如资金流无替代）。
总结¶
该插件为 DSH 用户提供了集成化的市场看盘工具，通过侧边栏与只读工具链，将行情数据与智能体分析能力打通，适合需要实时监控市场动态的开发者。
