公募基金研究报告PerryLink/dsh-fund-research

📊 dsh-fund-research
- 1024 商店渠道：先执行一次 npm i -g dsh1024，然后执行 dsh1024 plugin --profile web add dsh-fund-research（计入 deepseek1024.com 安装排行榜）。
Gitee

在 DeepSeek Harness 上，为中国公募基金生成确定性的研究报告。

每份报告中的每一个关键数字都可追溯至经过哈希处理的来源快照——缺口如实声明，绝不臆造。仅供研究；不构成投资建议。

License
DSH plugin
dsh-doctor
Node
CI
npm version
npm downloads

English · 简体中文 · Español · Português · हिन्दी

兼容性

| 组件 | 版本 |
|---|---|
| DeepSeek Harness | dsh-v0.1.6-alpha.2（peer 范围涵盖 alpha.2 系列：>=0.1.2-rc.1 =0.1.5-alpha.1 =0.1.6-0 =24.0.0 |
| 包管理器 | pnpm@11.7.0 |
| 平台 | Windows / macOS / Linux（仅宿主插件） |
| 数据来源 | 天天基金 / 东方财富公开接口（无需密钥，无需登录） |

你将获得

- fund_research 工具——输入一个基金代码，输出一份带版本号的 Markdown 研究报告：概览、业绩拆解、持仓穿透、简化风格归因、基金经理简介、风险与缺口声明、免责声明，以及一份数字可追溯性附录，将每一个关键数字映射到其快照 JSON 路径与验证结论。封存至 fund-reports/{code}/{YYYYMMDD-HHmmss}/，包含 report.md + manifest.json + snapshot.json。background: true 会将其作为 fund-report 后台任务运行。
- fund_snapshot 工具——一张轻量快照卡片（最新净值、已披露的阶段收益、规模、基金经理、前三大持仓），封存至该基金的日期目录中。
- 确定性指标，零模型算术 — 期间/年化收益、波动率、最大回撤、夏普比率；前 N 大集中度、HHI、行业分布、季度环比持仓对比；规模-价值风格分档；经理任期与同类对比。全部为基于密封快照的纯函数。
- 可追溯性作为一等特性 — 密封前，每个关键数字都会通过可选的 dsh-data-quality 服务（若已安装）对照密封的 snapshot.json 进行校验，否则通过内置的同构回退校验器（builtin-fallback）进行校验。附录表记录值 ↔ 路径 ↔ 判定结果。
- 诚实的缺口 — 数据源失败或降级时，会在受影响的章节中生成明确的数据缺口声明。插件绝不会用编造的数字填补缺口。
- 离线模式 — offline: true（配置或工具参数）从存储域快照层或最新的磁盘版本快照提供一切内容，零出站请求。非常适合测试和复现。
- asOf 截止 — asOfDate（ISO YYYY-MM-DD）将 NAV 序列截断至该日期或之前的数据，并在快照 + 报告中标记该截止日期；无效或未来日期会显式报错。
- 检查点续跑 — /.run-state.json 记录每个流水线阶段（快照/报告）及其时间戳和输入指纹；resume: true 从第一个未完成的阶段继续，复用已密封的产物，并拒绝指纹不匹配的情况。
- 数据源发现记录 — 每次采集都会密封一个代码生成的 sources-discovery.json（端点清单、主/备解析、各数据源覆盖范围与缺口、降级原因），并将其作为数据源与缺口声明并入报告附录。
- 多基金扇出 — codes 接受基金代码数组；每只基金独立运行流水线，并具备按基金隔离的故障处理（故障成为摘要缺口），结果为一张摘要卡片（代码 / asOf / 密封哈希 / 判定结果 / 失败原因）。
- 跟踪台账 — 每次成功密封都会向 /.tracking.jsonl 追加一行确定性记录；includeComparison: true 会渲染一个确定性的与上次对比章节（NAV 区间 / 规模 / 前十大持仓），当不存在先前记录时附带缺口声明。
- 只读审查 — 密封后，fund-review 作业会审查已密封的产物（缺口声明完整性、可追溯性表一致性、免责声明），并写入 review-note.md；当不存在作业服务时，它会优雅跳过（记录在运行状态中）。
- 按数据源的质量信号 — 每个数据源都携带确定性质量元数据（requested/succeeded/fieldsPresent/parseWarnings/degraded），在附录中渲染，并在工具值中呈现，以便下游对低质量数据源降权（绝不硬过滤）。
- 前向滚动稳定性摘要 — includeWalkForward: true 会添加一个样本外稳定性摘要部分：确定性的滚动窗口收益/夏普比率符号持续性和均值/标准差，明确标注为仅作统计描述，而非预测。
- 会话审计事件（依赖宿主） — fund-research/snapshot 和 fund-research/report 仅记录事件，携带代码、版本目录、清单哈希和缺口列表（模型可见 ⟺ 已记录）当宿主允许仓库外事件类型时；在 0.1.2-alpha.1–0.1.5-alpha.1 宿主上，已知类型目录是在仓库内构建生成的，因此该门控不会追加任何内容，工具结果加上密封工件即为审计轨迹。
- 方法论技能 — 一个捆绑的 fund-research 技能教会模型指标口径（定义）、缺口处理和合规措辞。计算仍保留在代码中。

快速开始

用 fund_research 出一份 161725 的研究报告

智能体调用 fund_research({ code: "161725" })；一分钟后工作区中会生成：

fund-reports/161725/20260819-153012/
├── snapshot.json            # raw extracted data + computed metrics + per-source sha256
├── sources-discovery.json   # code-generated endpoint roster + coverage + gaps
├── report.md                # the research report with the traceability appendix
└── manifest.json            # snapshot/report hashes, parameters, verify engine, gaps

.run-state.json 位于报告根目录，记录管道各阶段以便 resume: true。report.md 附录中的每个数字都带有针对 snapshot.json 的 verified / mismatch / not-found / unverifiable 判定——可用文档化的口径从 raw. 重新计算其中任何一个，以审计插件本身。

安装与卸载

dsh plugin --profile web add dsh-fund-research     # install (npm or tarball)
dsh plugin --profile web remove dsh-fund-research  # uninstall

安装后重启配置文件（bundle 激活基于重启）。随附的配置文件通过 dsh-base（dsh-storage + dsh-storage-json + dsh-storage-domain）组合存储栈；bundle 补丁仅挂载插件行。

配置

所有键均为可选（显示默认值）；无效值会在加载时明确报错。

| 键 | 默认值 | 描述 |
|---|---|---|
| enabled | true | 总开关；false 则完全不挂载任何内容。 |
| eastmoneyBaseUrl | https://fund.eastmoney.com | 天天基金 pingzhongdata 主机。 |
| f10BaseUrl | https://fundf10.eastmoney.com | 天天基金 F10 主机（持仓 + 经理页面）。 |
| quoteBaseUrl | https://push2.eastmoney.com | 东方财富行情主机，用于逐股估值快照。 |
| quoteFallbackBaseUrl | https://push2delay.eastmoney.com | 当主主机失败时逐股尝试的备用行情主机（东方财富自有的延迟行情主机）；'' 禁用它。 |
| requestIntervalMs | 1000 | 出站请求之间的最小间隔（礼貌采集）。 |
| timeoutMs | 15000 | 每请求超时。 |
| retries | 2 | 每个请求的重试次数，采用指数退避。 |
| cacheTtlHours | 12 | 存储域快照复用窗口。 |
| riskFreeRate | 0.02 | 用于夏普比率的年化无风险利率。 |
| offline | false | 从不发送请求；仅读取快照层。 |
| reportRoot | fund-reports | 相对于工作区（或绝对）的报告树根目录。 |
| styleQuotes | true | 获取每只股票的估值行情，用于风格归因。 |

工具与界面

fund_research

| 参数 | 类型 | 描述 |
|---|---|---|
| code | string | 六位基金代码，例如 "161725"（单只基金）。与 codes 互斥。 |
| codes | string[] | 多个六位基金代码：扇出执行，按基金隔离失败（返回摘要）。与 code 互斥。 |
| sections | string[] | 要渲染的章节 id（overview/performance/holdings/style/manager/benchmark/risk/disclaimer）。默认：全部。 |
| offline | boolean | 仅读取快照层（无网络）。默认：插件配置。 |
| asOfDate | string | ISO 8601 日期（YYYY-MM-DD）截止：仅使用该日期及之前的数据（NAV 序列被截断）。空 = 无截止；未来日期会明确报错。 |
| resume | boolean | 从第一个未完成的阶段恢复已记录的 .run-state.json 运行（复用已封存的产物）；拒绝指纹不匹配。默认：false。 |
| includeComparison | boolean | 针对上一条 .tracking.jsonl 记录渲染确定性的 与上次对比 章节；缺失的证据声明为缺口。默认：false。 |
| includeWalkForward | boolean | 渲染确定性的 样本外稳定性摘要（walk-forward）章节：滚动窗口收益/夏普符号持续性与均值/标准差。仅为统计描述，不是预测。默认：false。 |
| background | boolean | 作为 fund-report 后台任务运行；返回 { kind: "background", jobId }。默认：false。 |

fund_snapshot

| 参数 | 类型 | 描述 |
|---|---|---|
| code（必填） | string | 六位基金代码。 |
| offline | boolean | 仅读取快照层。默认：插件配置。 |
| asOfDate | string | ISO 8601 日期（YYYY-MM-DD）截止：仅使用该日期及之前的数据。空 = 无截止；未来日期会明确报错。 |

报告章节

概览 overview · 业绩拆解 performance decomposition · 持仓穿透 holdings penetration · 风格归因 style attribution (simplified) · 经理画像 manager profile · 同类/指数基准对比 benchmark & peer comparison · 风险与缺口声明 risk & gaps · 免责声明 disclaimer · 附录：数字回溯表 traceability appendix.

权限与数据

- 读取公开的天天基金 / 东方财富端点（fund.eastmoney.com/pingzhongdata/.js、fundf10.eastmoney.com F10 页面、push2.eastmoney.com 行情），使用浏览器 User-Agent 和可配置的礼貌节流。无需密钥、无需登录、无付费 API、不绕过反爬虫。
- 写入仅限会话工作区内配置的报告根目录下，以及 dsh_fund_research 存储域（每只基金的最新快照）。
- 绝不评估远程 JavaScript（pingzhongdata 块仅被扫描，绝不执行），绝不存储凭据，绝不交易。
- 会话事件是仅用于日志的审计记录，它们通过 src/events.ts 中的自适应门控：仅当宿主接纳某种仓库外类型时才会追加——其已知类型集覆盖该词汇表，或其 Session.append 接受 ignorable 信封。从 0.1.2-alpha.1 起（包括 0.1.5-alpha.1），两者均不成立：KNOWN_SESSION_EVENT_TYPES 是构建生成的仓库内目录，其构造上就排除了仓库外事件，而 Session.append 没有 ignorable 选项，因此该门控不追加任何内容——工具结果和密封产物仍是可重建的审计线索，且追加失败绝不会改变工具结果。
- 0.1.5-alpha.1（适配于 2026-09-09）：在新基线上重新验证了该门控——目录仍排除仓库外事件，且 Session.append 仍无法加盖 ignorable 信封，因此审计门控行为不变。
- 0.1.5-rc.1（适配于 2026-09-10）：依赖固定版本移至已发布的 0.1.5-rc.1 系列；无接缝变更影响此插件的行为。
- 0.1.5-rc.2（适配于 2026-09-11）：依赖固定版本移至已发布的 0.1.5-rc.2 系列；无接缝变更影响此插件的行为。

安全边界

- 基金代码在触及路径或 URL 之前会被校验为恰好六位数字；报告根目录解析于会话工作区之内。
- 源载荷在获取时进行哈希（SHA-256）；密封清单让你能够检测运行之间上游的静默编辑。
- 验证绝不阻塞密封：损坏的可选 dsh-data-quality 服务会降级为内置检查器，且所使用的引擎会记录在清单和附录中。
- 报告政策见 SECURITY.md。

已知限制

- 上游结构漂移。 解析器在设计上是严格的：如果天天基金更改了 var Data_* 的形状或 F10 表格布局，受影响的源会抛出指明字段的 SourceParseError，该部分会降级为已声明的缺口（核心 pingzhongdata 块失败会大声中止运行）。这是有意为之——静默的错误解析比已声明的缺口更糟。
- 风格归因是估算口径。 固定规模区间（≥1000亿 / 300–1000亿 / <300亿）和 PE 区间，加上持仓内五分位——不参考全市场分布。报告对此进行了标注。
- 持仓是季度披露数据（披露滞后）；F10 页面载有最近两个季度的数据。
- 每次调用一只基金；无组合分析、无 PDF 年报、无实时行情（fundgz.1234567.com.cn 实时端点已失效且被有意不使用）。
- Web UI 的“交付物”行以变更工具调用卡片为键；此插件生成的文件通过工具调用卡片的跟随位置（基金的报告目录）呈现，而非逐文件行。

开发

pnpm install
pnpm run typecheck && pnpm run typecheck:ci   # types, incl. CI-strictbash
pnpm test                                     # 在真实 harness 接缝上运行 176 个测试
pnpm run test:e2e                              # 可选启用的 LIVE 网络 E2E（LIVE_E2E=1）
pnpm run build && pnpm run verify:artifacts   # tsdown + tsc 声明文件
pnpm run verify:self-contained                # 无仓库外依赖规格
node scripts/check-readme-sync.mjs            # 五语言 README 门禁
node scripts/check-endpoints.mjs              # M3 端点存活探测（4 个东方财富主机）
pnpm pack                                     # 打包 tarball

测试运行来自 0.1.5-rc.2 对等依赖的真实 Context/SessionStore/ToolRuntime/LocalJobRegistry/存储接缝；网络仅在 fetch 边界处被保存的真实响应夹具（fixtures/，基金 161725）替换。使用 .tmp/ 中的采集脚本刷新夹具。

主题

dsh · dsh-plugin · deepseek-harness · cordis · fund-research · mutual-fund · investment-research · finance · research-report

贡献者

- PerryLink — 维护者：采集器/指标/报告封存流水线、端点存活探测、CI 与发布，以及五语言文档。
- dsh-fund-research 贡献者 — 基础构建（插件契约、配置 schema、工具、测试、打包）的集体作者。

尚无外部贡献者——已合并 0 个社区 PR/issue。通过 .github/ISSUE_TEMPLATE/ 中的表单提交 issue，或针对 main 提交 pull request，即可列于此处。

PerryLink DSH 插件家族

本项目是由 PerryLink 维护的 40 个 DeepSeek Harness 插件之一。如果这个对你有帮助，其他的很可能也一样：

| dsh-budget | DeepSeek Harness 的成本治理：预算、碳排与延迟集于一个面板。 | |

| 插件 | 一句话简介 |
|---|---|
| dsh-auto-review | 审批链上的第二模型自动审查，默认故障关闭 | |
| dsh-autotier | 自动的强/廉价模型层级路由，带确定性风险防护和 /tier 命令 | |
| dsh-background-agents | 持久化的后台子代理，带 Web UI 侧边栏、消息传递与中断 | |
| dsh-catalog | PerryLink 家族的 DSH Desktop Market 标准目录源 | |
| dsh-cert-mcp | 只读 MCP 服务器，暴露认证注册表：等级、快照与五维证据 | |
| dsh-checkpoint-rewind | 统一的会话 + 工作区 + 配置检查点，一键 /rewind | |
| dsh-claude-move | 将 Claude Code、Codex、OpenCode 和 Hermes 的会话、记忆与技能迁移到 DSH | |
| dsh-click | 面向 DeepSeek Harness 的跨平台原生桌面控制——优先支持 Windows。 | |
| dsh-composer-history | 为 Web 输入框提供终端风格的输入历史：方向键、Ctrl+R 搜索 | |
| dsh-data-quality | 确定性的数据集剖析、清洗与引用验证 | |
| dsh-defend | 面向 DeepSeek Harness 的提示注入、越狱与密钥泄露防御。 | |
| dsh-doublecheck | 工程纪律守卫：需求拷问、测试门禁、对抗式审查 | |
| dsh-draw | 面向 DeepSeek Harness 的统一静态图像生成路由。 | |
| dsh-fast | 只读性能诊断：负载、溢出、压缩与缓存命中率 | |
| dsh-github | GitHub PR/issue/CI 集成，所有写入操作均需审批 | |
| dsh-industry-research | 行业与公司研究包：产业链图谱、政策时间线、公司卡片 | |
| dsh-kit | 一键安装核心套件的入门包 | |
| dsh-library | 本地文档知识库，支持混合搜索与引用感知注入 | |
| dsh-local-ai | 本地 Ollama 模型发现与基于任务的路由，支持云端回退 | |
| dsh-lsp-actions | LSP 诊断、格式化、补全、代码操作、符号与重命名 | |
| dsh-mask | 在模型边界进行 PII 脱敏，并在宿主侧维护还原表 | |
| dsh-mcp-panel | MCP 管理控制台：/mcp 命令、设置选项卡与试调用 | |
| dsh-memento | 需审批的跨会话记忆协议（ctx.memory + SQLite） | |
| dsh-observe | 从会话事件流导出 OpenTelemetry 与 Langfuse 遥测数据 | |
| dsh-output-styles | 可在运行时切换的模型输出风格 | |
| dsh-permission-rules | 声明式允许/拒绝/询问规则，外加进程级网络策略 | |
| dsh-plugin-certification | 社区认证注册表，提供可复现检查的等级与徽章 | |
| dsh-plugin-doctor | 面向 DSH 插件的零依赖静态 + 沙箱冒烟检测器 | |
| dsh-plugin-guide | 插件开发知识库、agent 技能以及 dsh-plugin-dev CLI 工具链 | |
| dsh-plugin-kit | 面向 PerryLink DSH 插件的共享零运行时依赖工具包 | |
| dsh-plugin-portal | 零依赖静态门户，将整个插件家族渲染为单一页面 | |
| dsh-plugin-upgrade-015 | 合并 0.1.3-alpha.1 → 0.1.5-rc.1 升级通道卡片，外加零依赖接缝扫描器 | |
| dsh-reach | 多渠道审批/提问桥接：微信、Telegram、飞书 + 会话控制台 | |
| dsh-research-report | 可验证研究报告：证据账本、清单密封、逐条断言裁定 | |
| dsh-score | 多维插件质量评分，配有基于证据的排行榜 | |
| dsh-session-pin | 在 Web 侧边栏中固定会话和工作区，支持每个固定项独立配色 | |
| dsh-session-sync | 基于 Git 的跨设备会话同步，支持保留双方的合并方式 | |
| dsh-skill-pack-security | 安全审计技能包，外加 plugin_vet 供应链门禁 | |
| dsh-talk | 语音优先的会话循环：语音转文字输入与文字转语音回复 | |
| dsh-team-rooms | 跨会话团队房间：共享消息总线、任务看板与时间线 | |
| dsh-test-drive | 隔离的安装与冒烟测试试驾，配有通过/失败矩阵 | |
| dsh-ticktick | TickTick/滴答清单任务桥接：会话头部面板外加十一个 agent 工具 | |
| dsh-translate | 厂商参数转换与确定性 JSON 修复 | |
| dsh-wechat | 微信 ↔ DSH 桥接（腾讯 iLink 机器人），与 pan17 共同开发，由其托管仓库 | |
| dsh-personal-directive | 个人指令注入器，带顶栏开关（liucai2026/dsh-personal-directive 的 fork） | |