DSH Stock Research

面向 A 股与美股的单股研究插件，为研究过程保留数据、证据与分析产物。

基于 deepseek-harness（DSH）构建，支持从固定数据快照出发进行问答、快速研究、深度研究和复盘。研究由主 Agent 协调多个研究角色完成；插件不执行交易。

本项目尚未稳定，可能存在缺陷，后续更新也可能包含不兼容的变更。请在使用和升级时注意备份重要数据。

能做什么

• 个股问答：基于采集到的数据快照回答具体问题。
• 快速与深度研究：主 Agent 组织研究角色，分阶段验收并汇总报告。
• 复盘与重跑：基于既有研究记录复盘，或使用固定输入创建派生运行。
• 保留研究依据：保存数据快照、证据、产物和采集诊断，方便后续查阅。

快速研究适合形成初步判断：覆盖市场、基本面、宏观和公开信息，进行一轮多空讨论与综合风险分析。

深度研究增加经营、地缘政治和市场情绪分析，进行两轮多空讨论，并分别评估财务、估值和事件风险。它通常需要更多时间和模型调用，成本也可能更高。

开始使用

需要 Node.js 24.16.0、DSH >0.2.1-rc.1 和 pnpm。使用 DSH 插件管理命令安装到指定 profile（以 web 为例）：

dsh plugin --profile web add @megapandas/dsh-stock-research@next

也可在项目目录执行 npm ci 和 npm run build，将构建后的包放入 DSH 宿主可解析的依赖中，并在 profile 的 dsh.profile.bundles 中加入 @megapandas/dsh-stock-research。

宿主需提供 Agent、工具、模型、命令及本地子 Agent 等基础服务；模型及凭证由 DSH 管理。

在 DSH 聊天中直接提出研究需求，例如：

请对 SZ.002594 比亚迪做一次快速个股调研。
请对 NASDAQ:NVDA 做一次深度调研，研究日期为 2026-10-23。

默认使用 DSH 数据目录，研究子 Agent 继承当前会话的模型设置。

使用 DeepSeek V4.1 Flash（OFF）时，单次快速调研成本约为人民币 1 元，仅供参考；实际费用取决于模型价格、任务复杂度和调用量。

常用命令

日常使用建议直接与 Agent 对话，描述研究或操作需求，由 Agent 调用相应能力；无需手动操作以下命令。

命令	用途
/stock-ask	基于采集快照回答问题
/stock-quick / /stock-deep	发起快速或深度研究
/stock-review	基于既有研究保存独立复盘记忆
/stock-replay	使用固定输入创建派生运行
/stock-gc all	清除插件缓存、研究运行和复盘数据；任务运行时不可执行

清除后的研究数据无法用于后续复盘或重跑，请在清理前确认需要保留的内容。

研究过程

问答和研究先进行确定性数据收集，取得必需日线后采集其余数据。研究子 Agent 分章节撰写和提交报告，主 Agent 可以追问、要求修改，并在验收后推进后续阶段。聊天任务卡显示进度，最终报告由主 Agent 回复。

采集结果和诊断保存在数据目录的 collections/<UUID>.json 中，正式研究也会保存其使用的数据快照。公开信息搜索在额度耗尽后需要审批；搜索多次被拒时暂停，由用户或主 Agent 判断是否恢复。

配置

在 DSH Web 界面打开 设置 → 股票研究，可按需调整以下选项：

选项	用途与默认行为
研究模型与思考强度	配置研究子 Agent 使用的模型；默认继承主 Agent 的会话设置。主 Agent 始终使用当前会话模型。
旧版摘要模型	兼容旧版本会话，为旧版研究的摘要任务指定模型；默认继承研究模型。此选项后续将移除。
免审批搜索次数	每次公开信息研究尝试默认可搜索 8 次，超过后每次搜索需要审批；设为 0 时每次都需要审批。搜索后端由 DSH 配置。
数据来源	控制行情、财务、宏观、基准和公开信息来源。SEC 默认关闭；启用时须提供请求身份、有效联系方式以及已确认的股票 ID 与十位 CIK 映射。
数据目录	保存缓存、采集快照、研究记录和复盘记忆，通常为 ~/.dsh/stock-research，随 DSH 数据目录变化。切换目录不会迁移原有数据。
网络与缓存	调整请求超时、最大并发、最小间隔、缓存容量及各类数据的缓存有效期。缓存过期不删除已保存的研究记录。
数据新鲜度	设置行情、财务和宏观数据的新鲜度阈值；超过阈值的数据会标记为陈旧。

修改后需保存。模型与搜索额度对新任务生效，在途研究保留启动时的设置；数据目录、来源、网络与缓存等资源配置需在研究空闲时保存，并在下一次研究操作前应用。

写锁恢复

DSH 非正常退出可能留下写锁，导致再次启动时出现 Cannot acquire data-root writer lock。锁不会自动清除；后续版本将改进这一问题。临时恢复时，确认使用该数据目录的 DSH 和其他写入者均已停止，然后执行以下命令并重新启动 DSH：

rm ~/.dsh/stock-research/.writer.lock

以上路径适用于默认数据目录；如果使用其他目录，请替换为报错中显示的数据目录。不要在写入者运行时删除锁。

数据来源

插件通过以下来源获取数据；SEC 默认关闭，其余来源在默认配置中启用。公开信息搜索还需要在 DSH 中配置搜索后端。实际采集内容取决于市场、来源设置及数据可用性。

数据	来源与用途
行情与估值	东方财富提供 A 股行情和估值；Yahoo Finance 提供美股行情及部分市场基准；腾讯行情和新浪财经提供部分行情查询或备用数据。
财务	东方财富和新浪财经提供 A 股财务数据。美国证券交易委员会（SEC）可提供美股发行人标准财务字段，默认关闭，启用前须配置请求身份、联系方式及 CIK。
宏观与市场基准	东方财富提供中国宏观及部分指数、汇率、黄金和国债数据；商务部数据中心提供社融数据；FRED 提供美国宏观序列；部分市场基准使用 Yahoo Finance。
公开信息	通过 DSH 配置的搜索服务获取，具体搜索后端由宿主决定。

上游数据源可能不稳定，出现延迟、缺失或请求失败；不同来源的覆盖范围和更新频率也可能不同。请结合报告中的数据缺口和采集诊断核对研究结论。

本地开发

npm ci
npm run build
npm run typecheck
npm test
npm run lint
npm run format:check

构建后可运行 npm run test:package 验证包入口。仅采集数据、不调用模型：

npm run collect:data -- SZ.002594 2026-10-27 /tmp/byd-collection

输出目录须不存在。结果包含快照、汇总、逐表数据、请求记录和原始响应；来源失败及覆盖不足分别保存在失败清单和缺口中。

参考与致谢

项目基于 deepseek-harness 开发，研究思路参考了 TradingAgents。

免责声明

本项目仅供研究和学习使用，生成的内容不构成投资建议或交易依据。模型生成的分析可能不准确，历史表现也不代表未来收益。股票投资可能造成部分或全部本金损失；使用者应独立核实信息，结合自身情况审慎决策，并自行承担投资风险。

许可证

MIT