前言¶
在 DeepSeek Harness（DSH）里做与投资相关的能力时，常见做法是散点调用行情 API、另开浏览器查术语、再用日历记财报。数据是非实时的 EOD，规则与缩写又分散在多处，面板里很难形成一条可用的工作流。
dsh-us-stocks 由维护者 turboYuu 发布，归类为联网工具。插件把行情（收盘日线）、内置知识库、财报日历、技术指标、提醒、规则引擎问答和组合对比放进 DSH 左侧「美股」入口，在单一面板内完成从查词到盯自选、记提醒的常见步骤。行情明确为免费日线收盘数据，界面标注「收盘数据 · 非实时」，与盘中实时行情工具的定位不同。
仓库：https://github.com/turboYuu/dsh-us-stocks；社区目录页：https://www.skillhub.cn/plugins/turboYuu/dsh-us-stocks。许可证为 MIT（见仓库 README）。
插件定位¶
dsh-us-stocks 是嵌在 DSH 宿主里的美股助手插件（当前 package 版本 0.6.2）。宿主半 index.js 负责数据代理、缓存、路由与持久化；浏览器半 client.js 负责侧栏入口与主面板 UI。用户数据与偏好写入本地文件：
$DSH_HOME/dsh-us-stocks.json
默认路径为 ~/.dsh/dsh-us-stocks.json。
核心功能¶
下面按 README 中的模块说明已核实能力；未配置 Finnhub API Key 时，行情、知识库、提醒及问答中的知识库部分仍可使用，基本面相关能力需要 Key。
行情（日线 EOD）¶
- 指数概览：标普 500、道琼斯、纳斯达克 100、纳斯达克综合。
- 自选股：添加或移除代码，展示收盘价、涨跌额与涨跌幅。
- 日 K 线：近一年日线；优先
lightweight-charts，不可用时降级 SVG 蜡烛图。 - 基本面：市盈率、市值、股息率、贝塔、每股收益、ROE、52 周高低等（需 Finnhub Key）。
- 搜索：按代码或名称（Yahoo 搜索源；国内可能不可用，失败时静默降级）。
知识库¶
内置 60+ 条（M3），分专业术语、缩写速查、K 线图解、技术指标、市场规则五类；支持搜索与分类筛选，语言跟随 DSH 设置。K 线条目带 OHLC 示意数据，客户端可渲染小蜡烛图。
财报日历、技术指标与提醒¶
- 财报日历（M2）：自选股未来 7 天财报（Nasdaq 官方日历，免 Key），可一键加财报提醒。
- 技术指标（M2）：主图 MA(5/20/50)、BOLL(20,2)；副图 RSI(14)、MACD(12,26,9)。
- 提醒与日程（M5）：美东市场时钟、开收盘提醒、价格上下穿、财报提前 N 天、免打扰时段；面板提示条与浏览器通知（页脚「开启通知」）。
智能问答、组合与个性化¶
- 智能问答（M4）：规则引擎路由术语/规则/指标到知识库，个股行情到 Nasdaq，基本面到 Finnhub，财报日期到 Nasdaq 日历；回答带来源、时间戳与免责声明。
- 组合与对比（M6）：手动录入持仓跟踪、多股对比与归一化走势、CSV/JSON 导出。
- 个性化：K 线绿涨红跌或红涨绿跌、难度等级、主题与语言跟随 DSH。
数据源与网络¶
README 说明 Yahoo Finance 在中国大陆不可达后，插件改用下表来源（节选）：
| 数据 | 来源 | 需 Key |
|---|---|---|
| 个股报价 / 日线历史 | Nasdaq 官方 API（api.nasdaq.com） |
否 |
| 标普 500 / 道琼斯 | 东方财富（push2.eastmoney.com） |
否 |
| 财报日历 | Nasdaq 官方财报日历 | 否 |
| 基本面 / 财报数据 | Finnhub | 是 |
| 财报原文 | SEC EDGAR | 否 |
安装与使用需能访问 api.nasdaq.com、push2.eastmoney.com 等端点；插件在 DSH 进程权限下发起联网请求，安装前宜自行审阅源码与许可证。
安装与启用¶
环境要求：DSH 桌面端或 Web 端；Node.js ≥ 18（安装依赖）；可访问上述行情相关域名。
推荐通过 DSH 插件管理 → 安装，在输入框填入 package spec（原文示例）：
github:turboYuu/dsh-us-stocks
也可使用：
git+https://github.com/turboYuu/dsh-us-stocks.git
或仓库 URL https://github.com/turboYuu/dsh-us-stocks。确认后 DSH 会用 pnpm 拉取代码并安装依赖（含 lightweight-charts）。安装完成后 启用 插件并刷新页面。若索引已收录，可在「插件市场」搜索 dsh-us-stocks。
加载成功后左侧栏出现「美股」入口；宿主半 index.js 变更需重载插件（禁用再启用或重启 DSH），client.js 变更刷新页面即可。
配置 Finnhub API Key（可选）¶
- 打开「美股」面板 → 页脚「设置」。
- 填入 Finnhub API Key → 保存，状态为「已配置」即生效。
或通过环境变量：
export FINNHUB_API_KEY=你的_key
优先级：环境变量高于界面设置。免费 Key 可在 https://finnhub.io 申请；Key 以明文保存在本机 dsh-us-stocks.json。
典型用法¶
面板入口¶
主面板顶部六个标签：行情 / 问答 / 日历 / 提醒 / 组合 / 知识库；页脚为 设置 与 开启通知。
问答快捷句¶
README 给出的示例提问包括：什么是 ETF、PE 是什么、AAPL 行情、美股交易时间。
调试与健康检查¶
开发时可请求宿主路由，例如：
curl http://127.0.0.1:<端口>/api/us-stocks/health
主要 REST 前缀为 /api/us-stocks/*（如 quote、candles、knowledge、ask、watchlist 等，详见 README 接口表）。
适用场景与注意¶
适合在 DSH 工作流内做美股收盘日线查阅、术语学习、财报日前提醒与自选股对比的用户；不适合需要盘中实时报价的场景。搜索与部分数据源在国内网络下可能失败或降级，应以界面实际结果为准。
插件属于 DSH 社区生态中的第三方联网工具，与 DeepSeek / 幻方无官方从属关系；社区目录 skillhub.cn 为独立站点。使用前请确认本机 DSH 版本、Node 版本与网络策略满足 README 要求。
结尾¶
dsh-us-stocks 把日线行情、知识库、日历、指标、提醒和问答收敛到 DSH 单一入口，减少在多个站点之间切换。进一步说明与版本历史见 GitHub README：https://github.com/turboYuu/dsh-us-stocks；目录页：https://www.skillhub.cn/plugins/turboYuu/dsh-us-stocks。
