前言¶
DeepSeek Harness 的 agent 在处理个股行情、财报、分析师观点和新闻等问题时，如果没有结构化的市场数据工具，通常会退回到网页搜索和 shell 命令，再逐页抓取、解析 HTML。dsh-us-stocks 是一个面向 DeepSeek Harness 的插件，由 Realyujie 维护，基于 yahoo-finance2 提供一组服务器端 agent 工具，用于查询美股行情、价格历史、财务报表、分析师共识、新闻和持仓信息。
这是什么¶
- 包名：
dsh-us-stocks - 仓库路径：
Realyujie/dsh-us-stocks - 许可证：MIT
package.json声明版本：0.3.0- 依赖：
yahoo-finance2 ^4.0.2
它注册的是服务器端 agent 工具。在 web profile 中，它还会附带一个浏览器侧组件，用于绘制 get_history 对应的 K 线图；在 TUI 或 headless profile 中，浏览器侧组件不存在，但所有工具仍然可用。
核心工具¶
| 工具 | 返回内容 |
|---|---|
get_quote |
最新价、涨跌、日内区间、成交量、市值、P/E、EPS、账面价值、股息率、52 周区间、移动平均线、最近和下一次财报日期 |
get_history |
日线、周线、月线的 OHLCV 数据，包含调整后的收盘价，以及窗口内的分红和拆股信息 |
get_financials |
利润表、资产负债表和现金流量表科目，可按季度或年度查询 |
get_analyst_view |
共识评级、按月的买入/持有/卖出数量、目标价、前瞻 EPS 和营收预测、近期券商上调和下调、EPS beat/miss 历史 |
get_news |
近期新闻标题，包含发布方、时间戳和链接 |
get_ownership |
内部人与机构持股比例、最大机构和基金持有人、内部人近六个月买入和卖出情况 |
基金报价字段会附带 caveats，涉及费用率准确性、滚动收益口径和重仓持仓覆盖范围。这些说明会随响应字段一起出现，避免把基金层面的汇总指标误解为单一公司的估值数据。
安装与启用¶
下面介绍几种安装方式。安装完成后，需要重启 profile，因为插件在启动树构造成型时才会被解析。
通过 Harness 安装¶
如果当前环境已经可以访问仓库，可以直接对 DeepSeek Harness 说：
Install this plugin: https://github.com/Realyujie/dsh-us-stocks
安装过程中可能会请求文件系统权限，因为 profile 目录位于 session workspace 之外。
手动安装¶
如果 dsh 已在 PATH 中，可以执行：
dsh plugin --profile web add dsh-us-stocks
如果 dsh 不在 PATH 中，可以通过 npx 调用：
npx @deepseek-ai/dsh plugin --profile web add dsh-us-stocks
这里的 dsh plugin 会在 profile 目录内转发到 pnpm，并保持 profile 的 dsh.profile.bundles 列表同步，因此不需要手动注册插件。
更新插件¶
之后更新时，可以执行：
dsh plugin --profile web update dsh-us-stocks
本地开发¶
如果要指向本地 checkout，可以使用 link: 路径：
dsh plugin --profile web add link:/absolute/path/to/dsh-us-stocks
本地开发时，代码改动通常需要执行构建流程并重启 profile 后生效。
典型用法¶
安装完成后，可以要求 Harness 使用这些工具查询指定 ticker。例如，围绕一个 ticker，可以分别请求：
get_quote：获取当前报价和基础估值字段get_history：获取日线、周线或月线 OHLCV 数据get_financials：获取季度或年度财务报表科目get_analyst_view：获取共识评级、目标价和近期调整记录get_news：获取近期新闻标题get_ownership：获取内部人和机构持仓情况
仓库还提供了基准脚本。可以执行：
npm run benchmark
也可以指定另一个 ticker：
npm run benchmark -- TTMI
适用场景与注意¶
这个插件适合需要在 DeepSeek Harness 中查询结构化美股数据的场景，尤其是希望减少网页抓取、HTML 解析和多次 shell 调用的任务。
使用前后需要注意：
- 插件会在当前 DSH 的权限上下文中运行，安装前应检查源码、依赖和许可证。
- 安装可能请求 profile 目录的文件系统权限，因为该目录位于 session workspace 之外。
- 插件按 MIT 许可证发布，
package.json中声明版本为0.3.0。 - 在 TUI 或 headless profile 中，浏览器侧组件不存在，但工具调用仍然可用。
- 基金报价字段存在口径和覆盖范围限制，应结合响应中的 caveats 使用。
结尾¶
dsh-us-stocks 的价值在于把美股行情、财报、分析师观点、新闻和持仓查询收敛为一组明确的 agent 工具，而不是让 agent 在网页和 shell 中反复摸索。
- GitHub：https://github.com/Realyujie/dsh-us-stocks
- 目录页线索（未独立核实）：https://www.skillhub.cn/plugins/Realyujie/dsh-us-stocks
