前言¶
做智能体或日常用 DeepSeek Harness（DSH）时，如果要在面板里顺手查美股，常见做法是 scattered：行情开一个站、术语查搜索、财报再换日历。数据跳来跳去，也和 DSH 的「一切皆插件」思路不太一致。
下面介绍社区维护的 dsh-us-stocks（GitHub：turboYuu/dsh-us-stocks，SkillHub 登记名常与仓库对应）。它把行情、内置知识库、财报日历、技术指标、提醒、规则引擎问答和组合对比收进侧栏「美股」面板，分类为联网工具。行情明确是免费日线（收盘 EOD），非实时；宿主侧代理 Nasdaq、东方财富等源，可选 Finnhub 补基本面。
这是什么¶
dsh-us-stocks 是嵌在 DSH 里的美股助手，当前 package.json 版本为 0.6.2，MIT 许可。维护者为 turboYuu 仓库侧贡献者；本地状态写入 ~/.dsh/dsh-us-stocks.json（即 $DSH_HOME/dsh-us-stocks.json）。
它面向从术语新手到需要多股对比、导出的用户：不靠实时盘口，而用日线收盘、日历和本地提醒把「看、学、记」放在同一处。
核心功能¶
行情与图表¶
指数概览覆盖标普 500、道琼斯、纳斯达克 100 与纳斯达克综合。自选股可增删代码，展示收盘价、涨跌额与涨跌幅；近一年日 K 优先用 TradingView lightweight-charts，无法打包时降级为 SVG 蜡烛图。
配置了 Finnhub API Key 后，可看市盈率、市值、股息率、贝塔等基本面字段。按代码或名称搜索走 Yahoo 搜索源，国内可能不可用，失败时静默降级。
知识库¶
内置 60+ 条（M3），分术语、缩写、K 线图解、技术指标、市场规则五类；支持中英检索与分类筛选，跟随 DSH 语言。K 线条目带 OHLC 示意，客户端会渲染小型蜡烛图。
财报日历、指标与提醒¶
自选股未来 7 天财报来自 Nasdaq 官方日历（免 Key），可一键加财报提醒。K 线详情支持 MA(5/20/50)、BOLL(20,2) 及 RSI、MACD 等开关。
提醒含市场时钟（美东、盘前盘中盘后、倒计时）、开收盘与价格穿越、财报日前 N 天，并支持免打扰时段；面板提示条加浏览器通知（页脚授权）。
问答、组合与个性化¶
面板问答由规则引擎路由：术语走知识库，个股走 Nasdaq，基本面走 Finnhub，财报日期走日历；回答带来源与时间戳。组合为手动录入持仓与多股对比，可导出 CSV / JSON。K 线配色、难度等级、明暗主题与语言均可随 DSH 或插件设置调整。
数据源与网络¶
Yahoo Finance 在大陆不可达后，插件改用下表组合（节选）：
| 数据 | 来源 | 需 Key |
|---|---|---|
| 个股报价 / 日线 | api.nasdaq.com |
否 |
| 标普 500 / 道琼斯 | push2.eastmoney.com |
否 |
| 财报日历 | Nasdaq 官方日历 | 否 |
| 基本面 | Finnhub | 是 |
| SEC 财报原文 | SEC EDGAR | 否 |
安装与使用前请确认本机 DSH 进程能访问上述域名。
安装与启用¶
环境要求：DSH 桌面或 Web、Node.js ≥ 18，以及可访问 Nasdaq / 东方财富的网络。
推荐用 DSH 插件管理器 的 package spec 安装，例如：
github:turboYuu/dsh-us-stocks
或完整 Git 地址：
git+https://github.com/turboYuu/dsh-us-stocks.git
步骤：
- 打开 DSH → 插件管理 → 安装，填入上述 spec（亦可填仓库 HTTPS URL，或若已发布则填包名
dsh-us-stocks）。 - 确认后 DSH 用 pnpm 拉取依赖（含
lightweight-charts）。 - 启用插件并刷新页面；若市场已收录，也可在插件市场搜索
dsh-us-stocks。
加载后左侧栏出现「美股」入口。宿主半 index.js 变更需禁用再启用或重启 DSH；客户端 client.js 变更刷新页面即可。
配置 Finnhub API Key（可选）¶
不配置仍可用行情、知识库、提醒及问答中的知识检索部分。推荐在面板页脚 设置 中填写 Key 并保存；或用环境变量：
export FINNHUB_API_KEY=你的_key
优先级为环境变量高于界面设置。免费 Key 可在 https://finnhub.io 申请；Key 以明文保存在本机 dsh-us-stocks.json。
典型用法¶
- 打开「美股」→ 行情：查看指数与自选股，点进个股看日 K 与指标开关。
- 知识库 或 问答：搜术语，或用快捷问法如「什么是 ETF」「AAPL 行情」「美股交易时间」。
- 日历：查看自选未来财报，按需加提醒；提醒 页配置价格与开收盘规则，页脚 开启通知。
- 组合：录入持仓或多股对比后导出 CSV / JSON。
调试宿主接口示例（端口以本地 DSH 为准）：
curl http://127.0.0.1:<端口>/api/us-stocks/health
主要 REST 前缀为 /api/us-stocks/*（如 quote、candles、knowledge、ask、portfolio 等），由 index.js 统一代理与缓存。
适用场景与注意¶
适合在 DSH 内做收盘后复盘、术语学习、财报日程与本地提醒，不适合要毫秒级行情的交易决策。插件以当前 DSH 进程权限访问外网并读写本地 JSON；安装前请自行审阅 turboYuu/dsh-us-stocks 源码与 MIT 许可证。社区目录 SkillHub 插件页 与 GitHub 无 DeepSeek / 幻方官方从属关系，仅为生态收录。
结尾¶
dsh-us-stocks 把美股日线、知识库、日历、指标、提醒和组合收进 DSH 侧栏，强调非实时收盘数据与可本地持久化的自选与提醒。需要全貌与版本历史时，见仓库 README：https://github.com/turboYuu/dsh-us-stocks；目录入口：https://www.skillhub.cn/plugins/turboYuu/duh-us-stocks。
