dsh-invest-research

Multi-agent equity & fund research pipeline skill plugin for DeepSeek Harness (DSH). 同一包内提供11 个 skill，共用脱敏门禁与环境约定：

类别 skill 用途

个股 stock-research 单只 A 股行情/估值/周期/政策分析

基金重研究 fund-research 基金穿透式研究（主动/指数/ETF/联接/FOF/QDII/债基）+ 可选同业对比层

基金轻工作流 pick-funds（入口）· fund-screen · fund-profile · fund-watch · holdings-style · manager-profile · report-render · xlsx-author 筛选 / 单基金画像 / 经理画像 / 持仓风格 / 持续跟踪 / PDF·DOCX·XLSX 交付

决策闭环 decision-loop 登记结论 → 对齐已发生行情 → 结算 → 复盘 → 决策质量统计

最终都产出每个数字带【来源|日期|口径|类型】、落盘前过 PII 脱敏的研究报告。

v0.6.0 起新增时点纪律（point-in-time）：所有取数脚本支持 --as-of，历史序列一律截断到分析基准日，披露日期与数据日期分列 —— 详见下方「时点纪律」。

仅供研究参考,不构成投资建议。不接入任何交易通道,全程只读公开数据。

Install 安装

# 从 GitHub
dsh plugin --profile <profile-name> add github:lobster-liu/dsh-invest-research

# 或从本地目录 / zip 解包后
dsh plugin --profile <profile-name> add path/to/dsh-invest-research

v0.3.0 起包名由 dsh-stock-research 改为 dsh-invest-research（加入了基金研究能力）。 GitHub 旧地址会自动重定向；已安装旧版的用户请移除后按新名重装。 v0.4.0 起 fund-research 新增可选同业对比层（阶段 6）：同一主题下多只基金"谁更优"，由对比协调员亲自派发互相隔离的独立角色 agent 做跨基金对比 + 独立 red-team 质疑。

重启 DSH → 新会话里说 "分析 600048"（stock-research）或 "分析基金 025490"、"穿透这只基金的持仓"（fund-research）即触发；说 "筛选基金"、"这只基金怎么样"、"基金经理画像"、"出一份 PDF 报告" 则命中 pick-funds 套件。

安装约束（v0.5.5 起）：fund-research/tools/fetch_fund.py 的 _resolve_version() 依赖插件根 同时存在 assets/ 子目录与 package.json（name=="dsh-invest-research"）来读真实版本； 只拷贝 skills/ 子目录（没有插件根清单）时，版本会回落到脚本内的 _VERSION_FALLBACK 常量—— 属预期行为、不影响取数，但会让「防人肉抬值脱节」的同步守卫不生效（离线自测会打 ⚠️ SKIP 显式告警）。手动拆分安装请连同插件根一起拷，或直接用 dsh plugin add。

安装约束（v0.6.3 起，安全相关）：fund-research 的落盘门禁与 decision-loop 的台账/结算门禁都硬依赖同级的 stock-research/tools/sanitize_check.py（同一文件、不复制规则）。两个 skill 必须同级同装：

只装 fund-research 一个 skill 时，decision_log.py append / settle.py 拿不到 sanitize_check.py，会返回 sanitize_missing 并拒绝写入（失败关闭）；

这是安全正确的行为，不是 bug —— 门禁缺失时宁可写不进，也不静默放行。需要把 skill 单独拆走时，请连同 stock-research/tools/sanitize_check.py 一起拷，否则决策闭环会整条不可用。

Quick check 安装自检

# 1) 个股取数冒烟(需可访问 push2.eastmoney.com;失败多为网络环境而非代码问题)
python assets/skills/stock-research/tools/fetch_data.py --code 600000 --out /tmp/sr/data.json
# 2) 基金取数冒烟(需可访问 fund.eastmoney.com)
python assets/skills/fund-research/tools/fetch_fund.py --code 025490 --out /tmp/fr/fund.json --peer-stocks 10
# 3) 基金取数器离线自测(38 条断言,不依赖网络,期望 exit 0)
python assets/skills/fund-research/tools/test_fund_tools.py
# 4) 脱敏门禁行为自检(134 场景,期望 exit 0)
python assets/skills/stock-research/tools/test_gate.py
# 5) 对比层工具离线自测(24 条断言,期望 exit 0;含 ETF/联接份额、短码补零、--track 仍解析锚点名、关键词截断、https 回退、列表外代码不误拒、标签锚定解析)
python assets/skills/fund-research/tools/test_peer_tools.py
# 6) 时点纪律与决策闭环离线自测(77 条断言,期望 exit 0)
python assets/skills/fund-research/tools/test_decision_tools.py
# 统一入口:npm test 跑 30 条注册冒烟;npm run test:all 跑全部(30+134+38+24+77)

时点纪律 Point-in-Time（v0.6.0 新增）

此前的实现只做了「披露滞后标注」（报告期 vs 检索于、stale 标记），没有做时点纪律：历史序列一律取到「当下」，财报一律取「最新版」。于是一份声称基准日为 2026-06-30 的报告，只要用了这些工具产出的数据，就会静默地把 7—10 月的行情、后来重述的财报、以及基准日之后才披露的持仓算进结论 —— 典型的前视偏差。

v0.6.0 补齐三件事：

机制	实现	作用
序列按基准日截断	`fetch_data.py --as-of` / `fetch_fund.py --as-of`	历史行情/净值/指数序列只取 `日期 ≤ 基准日`；基准日之后的数据不进入任何计算窗口（含分位、回撤、收益）
披露日期与数据日期分列	记录新增 `披露日期` 字段 + `pit.py`	`数据日期`=统计截止，`披露日期`=公众首次可读之日；取不到记「未取得」，不得以数据日期冒充（重述靠这个字段暴露）
可见性判定	`pit.py` 的 `AsOf.visible()`	报告期（或其推算最早公开日）晚于基准日 → 该期不得使用，退回上一可见期并在「数据缺口」写明

披露日期用监管最晚披露时限推算（季报 25 日 / 半年报 60 日 / 年报 90 日），是刻意的保守上界 —— 实际披露通常更早，用最晚时限意味着宁可认为数据更晚可见，也不误判为「基准日已可见」。推算值在备注里标明「推算」，不得当作实际披露日期。

# 按基准日取数（--as-of 不可省）
python assets/skills/stock-research/tools/fetch_data.py --code 600000 --out /tmp/sr/data.json --as-of 2026-06-30
python assets/skills/fund-research/tools/fetch_fund.py --code 025490 --out /tmp/fr/fund.json --as-of 2026-06-30

决策闭环 Decision Loop（v0.6.0 新增）

一次运行只给出一个决策，无法说明这套方法决策得好不好。v0.6.0 把它变成一个闭环：

研究 → decision.json → 决策日志（只增追加）→ 结算（对齐已发生行情）→ 复盘 → 下次研究可读

组成	作用
`tools/rating.py`	唯一权威的结论标签词表（5 档）+ `REVIEW` 哨兵 + 锚定解析器（容忍 Markdown 加粗与全角标点）
`tools/decision_log.py`	只增追加的决策日志（`ledger.jsonl`）；按 `run_id` 幂等去重；`verify` 校验
`tools/settle.py`	结算：入场取决策日之后第一个收盘日，算原始收益 / 基准同期 / 超额，判 `SETTLED`/`PENDING`/`SETTLE_FAILED`
`tools/decision_score.py`	按标签聚合决策质量：n / 平均超额 / 命中率 + 前视偏差说明（按词表版本分组，跨版本不合并）
`assets/skills/decision-loop/`	3 角色（结算员 / 复盘员 / 质量分析师）+ 完整流程

三个关键口径：

REVIEW 哨兵 —— 解析不出结论标签时返回 REVIEW，绝不静默退化成「等待验证」。一个读不懂的决策不是中性决策，把它记成中性标签等于伪造了一个从未作出的判断。（v0.6.0 顺带修掉了 comparator.py 里 if l in md 全文档子串扫描的真实缺陷：它会把正文里讨论到的他人结论当成本次结论，且失败时静默返回空串。）
命中率只对方向性标签计算 —— 优先研究/可以关注/暂不优先 宣称了方向； 等待验证/数据不足/REVIEW 不宣称方向，参与统计会稀释结果，它们的样本数单独列出。
前视偏差必须披露 —— 结论标签词表与阈值会随版本变化，把今天的词表回填到历史决策会凭空制造「当年就会做出这个判断」的效果，因此按 vocabulary_version 分组统计，跨版本不合并。

# 登记本次决策（只增追加）
python assets/skills/fund-research/tools/decision_log.py append --ledger invest-decisions/ledger.jsonl --record $RUN/decision.json
# 结算 + 回测
python assets/skills/fund-research/tools/settle.py --ledger invest-decisions/ledger.jsonl --series series.json --benchmark bench.json --out $RUN/settlements.json
python assets/skills/fund-research/tools/decision_score.py --ledger invest-decisions/ledger.jsonl --settlements $RUN/settlements.json --out $RUN/decision-quality.md

边界：历史决策与复盘里的数字不得写进新报告的数据表 —— 它只提供「先验教训」与「上次结论是否被证伪」。fund.json 仍是唯一事实底稿。

What's inside

组成	说明
`assets/skills/stock-research/SKILL.md`	个股流程总纲 + 环境解析(`EQUITY_PY` / `EQUITY_SECRET_SCANNER` / `$RUN` / `$ARCHIVE`)
`assets/skills/stock-research/roles/*.md` ×6	各角色完整提示词(含 2026-10-15 真实事故教训固化:单一数据源、口径并列、先落盘再细化)
`assets/skills/stock-research/tools/fetch_data.py`	东财双通道行情/历史取数 + 分位/最大回撤衍生计算;空数据退出码 1;(v0.6.0) 支持 `--as-of` 基准日截断,记录带 `披露日期`
`assets/skills/stock-research/tools/pit.py`	(v0.6.0) 时点纪律底座:披露日期推算(季报 25/半年报 60/年报 90 日,保守上界)、可见性判定、序列截断;`stock-research` 与 `fund-research` 共用
`assets/skills/stock-research/tools/fetch_fundamentals.py`	(v0.2.0) 可选 akshare 财务基本面通道:ROE/每股净资产/负债率/现金流 + PE·PB 近一年真分位;未装 akshare 时退出码 1 不阻断主流程
`install_akshare.ps1` / `requirements.txt`	(v0.2.0) 沙箱内离线装 akshare(Node fetch 下 wheel + `--no-index --find-links`),绕开 pip 平台临时目录 `WinError 5` 与 schannel 两个坑
`assets/skills/fund-research/SKILL.md`	(v0.3.0 / v0.4.0) 基金流程总纲:五阶段 + 阶段6 对比层、10 章报告、5 个结论标签、三种情景、跟踪清单、条件式行动、铁律 11(对比层必由独立 agent 派发)
`assets/skills/fund-research/roles/*.md` ×10	(v0.3.0 / v0.4.0) 协调员 + Agent1–Agent6 + 对比层 3 角色(`peer-orchestrator` / `peer-builder` / `peer-red-team`),统一提交格式
`assets/skills/fund-research/tools/fetch_fund.py`	(v0.3.0 / 版本自 v0.5.5 起从本插件根 `package.json` 读,依赖插件根 `assets/` + `package.json` 同时存在;回落值 `_VERSION_FALLBACK` 有格式 + 同步双重测试断言) 基金身份/净值/多期持仓/行业配置/债券持仓/规模份额/持有人/资产配置/经理/基准对比/重仓股快照;多通道降级,空数据退出码 1
`assets/skills/fund-research/tools/test_fund_tools.py`	(v0.3.0 / v0.6.13 起 39 条) 39 条离线断言(内联 fixture + 网络桩,零网络;`_pkg_version()` 跨仓库/Qoder 安装形态可跑,无清单时打印 `⚠️ SKIP` 显式告警)
`assets/skills/fund-research/tools/test_annualization.py`	(v0.6.13) 20 条离线断言,锁死年化与夏普口径:年频率必须由样本期实际交易日 ÷ 样本年数实算,算不出来才回退 242 并标「回退默认」;禁止硬编 244 / 252;夏普 = `mean(r_t − rf_t)/s(r_t − rf_t)×sqrt(年频率)`,rf 几何日化
`assets/skills/fund-research/tools/fund_cost.py`	(v0.6.13) 销售费用口径校验器:`validate_fee_leg`(渠道 × 申购时点 × 口径,实收/应退两列必须同时给;v0.7.0 起接受 `holding_days`,代销腿按 ≤365 天「不返还」/>365 天「全额返还」分支)、`split_holding_period`(跨 2027-01-01 强制分段)、`net_cost`(实收 + Σ 销售服务费实收 − 应退)、`fee_version_key`(版本键 = 基金代码 + 费率变更生效日);不合规抛 `CostCaliberError`(E1–E7)
`assets/skills/fund-research/tools/test_fund_cost.py`	(v0.6.13 / v0.7.0 起 53 条) 离线断言,覆盖 P0-1 的 F1–F7 行为用例(直销 2027 后认申购费实收 > 0 即 E1;销售服务费先收后返净成本 0 但两列都在;跨 2027 不分段即 E4;未核到规则回落「费用不可精确复算」)＋合同例证 G1–G3(路博迈中国动力 2026-07-06 公告,单例:存量不返还、2027 起先收后返、A 类直销 0/代销 0.80%)＋代销持有期分支 G4–G8(≤365 天不返还、365/366 边界、缺 `holding_days` 即 E7)
`assets/skills/_shared/references/*.md`	(v0.6.13) 跨技能单副本参考件:`fund-return-traps.md`(收益字段口径陷阱,原 5 份逐字节重复已收敛为 1 正文 + 5 指针)、`fee-rules-2026.md`(销售费用规则、证据分级、净成本公式、降级表)
`assets/skills/fund-research/tools/peer_builder.py`	(v0.5.5) 同业筛选器:脚本执行 3 条(跟踪标的严格相等 / 仅被动型 / 非同一基金不同份额)+ 标记 1 条(结构差异);交易状态与份额类别一致性不执行,写入 `agent_review_required[]` 交 Agent-P1 人工复核,只筛不评;候选支持 `--codes`(列表外代码先抓身份页兜底,类型仍未知时记 `type_unknown_codes[]` + `agent_review_required(type_unverified)`,不按非被动型误拒)/ `--keyword`(被动型预筛 + `--max-candidates>=1` 上限)/ `--track`(仍解析锚点简称,不静默关掉判据 C);基金列表源 https 优先、抓取与解析失败都回退 http
`assets/skills/fund-research/tools/comparator.py`	(v0.4.0) 对比矩阵生成器:读 `peers.json` + 各基金 `report.md`/`fund.json`,对齐已冻结结论、暴露口径冲突,不重算指标;(v0.6.0) 结论标签改走 `rating.py` 锚定解析器(修复全文档子串扫描缺陷),`REVIEW` 单独统计
`assets/skills/fund-research/tools/rating.py`	(v0.6.0) 结论标签唯一权威词表(5 档)+ `REVIEW` 哨兵 + NFKC/加粗容忍的锚定解析器 + 方向性标签集合
`assets/skills/fund-research/tools/decision_log.py`	(v0.6.0 / v0.6.3 起 append 内建落盘脱敏门禁) 只增追加的决策日志(`ledger.jsonl`):按 `run_id` 幂等去重、损坏行不阻断读取但计数上报、`verify` 校验;追加前经 `sanitize_gate` 跑 `sanitize_check.py`,命中 CRITICAL/HIGH 直接拒绝写入(无绕过开关)
`assets/skills/fund-research/tools/settle.py`	(v0.6.0;v0.6.4 起写盘前内建落盘脱敏门禁) 决策结算:入场取决策日之后第一个收盘日,算原始/基准/超额,判 `SETTLED`/`PENDING`/`SETTLE_FAILED`;写 `settlements.json` 前经 `sanitize_gate` 跑门禁,命中即拒写并返回 1(失败关闭)
`assets/skills/fund-research/tools/sanitize_gate.py`	(v0.6.4) 落盘门禁公共件:`decision_log.py` 与 `settle.py` 共用同一份规则与失败关闭语义(`sanitize_record` / `sanitize_text` / `is_blocked`),避免两处各写一遍导致口径漂移;门禁脚本缺失返回 `missing`
`assets/skills/fund-research/tools/decision_score.py`	(v0.6.0) 决策质量回测:按标签聚合 n/平均超额/命中率(仅方向性标签),未结算单元显式列出,附前视偏差说明
`assets/skills/fund-research/tools/test_decision_tools.py`	(v0.6.0 / v0.6.3 +5 条 / v0.6.4 +8 条) 77 条离线断言(时点纪律 + 标签解析 + 日志幂等 + 落盘脱敏门禁(含 settle 拒写) + 结算口径 + 命中率口径;零网络)
`assets/skills/decision-loop/SKILL.md` + `roles/*.md` ×3	(v0.6.0 / v0.6.3 起过脱敏门禁) 决策闭环技能:登记 → 结算 → 复盘 → 质量统计;阶段 1/2 由代码强制(decision_log.py / settle.py 内置),阶段 3/4 由角色自查;账本只存公开结论,不含任何个人头寸
`assets/skills/fund-research/tools/test_peer_tools.py`	(v0.5.4) 对比层 24 条离线断言(含 `某ETF` 不得判成 F 份额、`11839→011839` 补零、`--track` 不得让判据 C 失效、`--keyword` 预筛+截断+下限、https 连接层/解析层回退、列表外代码不得按非被动型误拒、标签锚定解析七项回归;纯逻辑 + 工作区临时目录 fixture,零网络)
`tools/sanitize_check.py`	落盘前 PII 门禁:泄漏规则(持仓/成本/资金/盈亏/账户 + v0.6.4 起 `personal_amount`:自持动词/第一人称所有格/第一人称+自持动词 + 金额的组合规则 + v0.6.7 起 `personal_ownership`:金额 + 属于/归/是 + 显式个人 + 个人名词的反向锚定规则(v0.6.8 扩到 5 族变体:个人名词扩表 / 归属动词扩到算作/即 / 语序颠倒 / 无名词后缀;v0.6.9 补私人/私有修饰前缀与所有/名下收句尾巴;v0.6.10 收口:该规则不继承金融术语/政策条款两类豁免——归属声明自带「钱归谁」语义,术语表会把它整条放掉——并新增「金额在场」分支 C2 覆盖算作/即收句;v0.6.11 CAND-FT 自述句例外:紧挨命中处前面是我/本人/自己(可隔一个「的」)时,术语表豁免对 `personal_amount`/`capital_amount` 失效——「自有资金/自有资产/自有资本」在自述句里就是自己的钱,机构口径与「我认为自有资金…」不受影响)) + 5 层公开信息白名单(财报科目/政策条款/金融术语/基金公开披露/机构主语 + 持仓动词/资金名词/否定声明);混合陷阱必拦、政策豁免不跨句;未闭合的形态已在「门禁已知边界」一节对外声明
`tools/test_gate.py`	门禁行为自检 134 场景(真泄漏必拦(含第一人称散文绕过 + 观点句里的个人头寸一律照拦 + 金额后个人化从句 + 5 族归属变体 + 私人/私有与所有/名下两处加宽承重守卫 + 归属声明短接 fin-term/policy 承重守卫 + 金额在场分支 C2 承重守卫 + 自述句例外 CAND-FT 承重守卫(含 2 条只有「的」这一格能闭的))/公开条款必放(含观点句里的公开口径)/基金披露必放/机构主语必放(personal_amount + capital_amount)/公司自有资金必放/机构自述「我方」必放/机构主语豁免窗口常数承重守卫/署名元叙述必放/紧邻第一人称反例必放/陷阱必拦)
`tools/run_pipeline.ps1`	Windows PowerShell 引导脚本(ASCII-only,PS 5.1 兼容)

门禁已知边界 Known gate limits（v0.6.12 声明）

脱敏门禁是 fail-closed + 明确收口：personal_ownership 族自 0.6.10 起不再主动扩探针。下面这些 未闭合的形态按「已知残留」对外声明——它们都能用更宽的正则闭合，代价是误伤公开披露与元叙述（如「文末署名即本人。」），所以留在这里而不是塞进规则。

一、`personal_ownership` 三族残留（0.6.10 收口）

#	形态	示例	现状	未闭原因
①	我的 + 一个修饰词 + 个人名词	`这笔投资属于我的个人账户。` / `该份额归我的个人账户所有。`	放行	实测闭它 = 2 拦 : 4 条元叙述误伤；需换设计（收窄名词表 / 剔除可指人的词），不是加宽能解决
②	金额与归属成分之间插入语 > 8 字符	`3 亿元…（超过 8 字）…属于我的存款。`	放行	窗口一加宽就会吃掉跨句的情形，得不偿失
③	中文数字金额（纯倒装）	`我的存款三千万元。`	放行	无阿拉伯数字锚点；带归属动词的已由分支 C 接住（`三千万元归本人。` → BLOCK）

二、第一人称复数与机构自称同形

我们自有资金 3 亿元。 目前放行。「我们」与「我方」同样可指机构——本包把「我方」视为机构自述（我方自有资金 3 亿元。 必须放行），因此不对「我们」做预防性加宽；出现真实泄漏再单列处理。

三、过度拦截（fail-closed，不是泄漏）

机构主语豁免只认紧邻的机构主语，指示代词不算，于是这三句会被拦： 本行资金 3 亿元归表内核算。 / 该计划持仓 3 亿元归受托机构。 / 该笔资金 3 亿元归属专项账户。 这是有意的取舍——该计划/该笔 可以指向个人（「我的定投计划持仓 3 亿元」），进白名单等于开一条绕过通道。要解决得改用后置机构名词判定，属另一套机制。

遇到上面任意一族的真实泄漏，请附原始串提 issue。按约只修真泄漏、不主动扩探针。

pick-funds 分析师套件（v0.5.0 新增）

移植自 ZCode 官方插件 pick-funds v0.1.1，把原「1 agent + 7 skills」改为纯 skill 承载，入口技能 pick-funds 承载工作模式路由、数据源优先级与共享护栏。

技能	触发场景
`pick-funds`	基金研究类任务入口；共享护栏 + DSH 数据源映射
`fund-screen`	筛选基金 / 找基金 / 近一年收益前 10%
`fund-profile`	基金画像 / XX 基金怎么样
`fund-watch`	基金跟踪 / 持仓基金有没有问题 / 规模异动
`holdings-style`	持仓分析 / 风格漂移 / 两只基金重合度
`manager-profile`	基金经理 / 经理画像 / 这个经理靠谱吗
`report-render`	出一份 PDF / 导出报告 / 存成 docx
`xlsx-author`	表格类交付落成 .xlsx

与 `fund-research` 的分工

要「筛 / 画像 / 盯 / 比 / 出报告」用本套件（单 agent 工作流）；要「穿透底层 + 多 agent 交叉验证 + 固定 10 章」用 fund-research。两者都只读公开数据、不出具投资建议。

DSH 数据源映射

本套件按 DSH 原生方式接线：无 MCP server 依赖，直接走本插件自带取数脚本 + Web 检索兜底。

需要的数据	DSH 取法
基金档案/净值/持仓/规模/份额/持有人/经理/费率/基准/重仓股	本插件 `fetch_fund.py`（`数据` / `持仓` / `净值序列` 等字段）
指数/个股行情、板块、财务基本面	本插件 `fetch_data.py` + `web_fetch`
基金经理变更公告、基金公司事件	`web_search` + `web_fetch`（基金公司公告 / 巨潮 / 交易所披露页）
定性背景（经理访谈、基金公司事件）	`web_search` + `web_fetch`（媒体档标 `[媒体]`）
基金筛选（全市场按条件过滤）	无等价脚本 → `web_search` + `web_fetch`（天天基金等筛选页），须在覆盖度写明引擎口径

没有对应能力时记 源不可用 并写入覆盖度区块，不得静默跳到通用搜索兜底。 fetch_fund.py 退出码 1 表示基金身份与净值都取不到，此时停止并如实报告，不带空数据继续。

依赖边界

report-render 另需 reportlab / matplotlib / pypdf / pypdfium2 / pillow / fonttools / pymupdf （见 assets/skills/report-render/scripts/requirements.txt；pymupdf 为可选项，缺则字形覆盖检查自动跳过）与系统 CJK 字体；
xlsx-author 需 openpyxl，公式重算校验走 headless LibreOffice（缺失时用技能定义的强制替代检查并如实标注，不假装通过）；
peer_builder.py 基金列表源为 https://fund.eastmoney.com/js/fundcode_search.js，个别网络只放行 http，故保留 http:// 回退（设计取舍，非缺陷）；连接层或解析层失败都会触发回退。
两者脚本均为纯 Python，随技能原样携带，无平台耦合。

report-render / xlsx-author 完整度

本仓库技能只要求 soffice 在 PATH 上（探测用 shutil.which("soffice")）。缺失时 docx 排版量测 / xlsx 公式重算如实降级为"未测量 / 未经视觉验收 / recalc_unavailable"， 不假装通过。

# 1) Python 依赖(dsh 自带 python 或 $PY) —— 已装并验证:
& "$PY" -m pip install -r assets/skills/report-render/scripts/requirements.txt
#    reportlab / matplotlib / pypdf / pypdfium2 / pillow / fonttools / pymupdf
#    → PDF 直出、图表、墨量/空白页校验、CJK 字形覆盖全部可用(无需 LibreOffice)

# 2) LibreOffice(仅 docx 排版量测 + xlsx 公式重算需要)。无管理员时用「管理镜像」解包:
#    winget 不可用的环境示例 —— 官方 mirror 下载 Win_x86-64 MSI 后:
#    msiexec /a "LibreOffice_X.Y.Z.msi" /qn TARGETDIR="D:\Users\...\LibreOffice"
#    !!! 坑:解包后 program\bootstrap.ini 里 InstallMode=<installmode>(未替换占位符)
#        会报"配置文件已损坏";改成 InstallMode=1 后 soffice.COM 通常可用,soffice.exe 不一定。
#        若仍报错,请用管理员权限正常安装,不要沿用管理镜像。
#    然后把 <target>\program 加入用户 PATH。

# 3) 自检:python assets/skills/report-render/scripts/selftest.py <输出目录>
#    PDF 半程应全过;docx 排版量测有无取决于步骤 2。

本机现状（2026-10-25）：Python 依赖已装齐；LibreOffice 三种安装方式（winget / 用户级 MSI / 管理镜像）均未稳定成功，已从用户 PATH 移除，docx/xlsx 校验走降级路径。这不影响 PDF 交付与数据正确性，只影响 docx 逐页视觉验收和公式重算校验两项。

Requirements

DSH ≥ 0.2.0-rc(skill 注册走 Host skills 服务;无该服务时插件加载为 no-op,不会报错)
Python 3.10+(DSH 自带 runtime 直接可用;取数零第三方依赖,akshare 可选)
网络可达 push2.eastmoney.com / push2his.eastmoney.com(行情);政策核对建议搭配 dsh-web-search-pro(免费 anonymous 源,本插件按 read.fetch-为主设计)

环境变量(全部可选)

变量	作用
`EQUITY_PY`	指定 Python 解释器(默认自动解析 DSH 自带 runtime)
`EQUITY_SECRET_SCANNER`	外接凭据扫描器路径(如 audit-secrets.py);未设则明示 skipped,内置 PII 规则照常生效
`EQUITY_WORK`	run 产物根目录(默认当前工作目录 `./equity-runs/`)

Privacy

报告禁止出现个人持仓/成本/资金量——落盘前 sanitize_check.py 强制拦截(退出码非 0 禁止写入,无绕过开关);
政策原文中的条款数字(如"单户上限100万元")是公开信息,白名单放行且不改写;
所有产物默认留在用户工作区,是否归档进个人笔记库(Vault/Obsidian)由用户显式配置 $ARCHIVE。

License

MIT

dsh-invest-research

Multi-agent equity & fund research pipeline skill plugin for DeepSeek Harness (DSH). 同一包内提供11 个 skill，共用脱敏门禁与环境约定：

类别 skill 用途

个股 stock-research 单只 A 股行情/估值/周期/政策分析

基金重研究 fund-research 基金穿透式研究（主动/指数/ETF/联接/FOF/QDII/债基）+ 可选同业对比层

基金轻工作流 pick-funds（入口）· fund-screen · fund-profile · fund-watch · holdings-style · manager-profile · report-render · xlsx-author 筛选 / 单基金画像 / 经理画像 / 持仓风格 / 持续跟踪 / PDF·DOCX·XLSX 交付

决策闭环 decision-loop 登记结论 → 对齐已发生行情 → 结算 → 复盘 → 决策质量统计

最终都产出每个数字带【来源|日期|口径|类型】、落盘前过 PII 脱敏的研究报告。

v0.6.0 起新增时点纪律（point-in-time）：所有取数脚本支持 --as-of，历史序列一律截断到分析基准日，披露日期与数据日期分列 —— 详见下方「时点纪律」。

仅供研究参考,不构成投资建议。不接入任何交易通道,全程只读公开数据。

Install 安装

# 从 GitHub
dsh plugin --profile <profile-name> add github:lobster-liu/dsh-invest-research

# 或从本地目录 / zip 解包后
dsh plugin --profile <profile-name> add path/to/dsh-invest-research

v0.3.0 起包名由 dsh-stock-research 改为 dsh-invest-research（加入了基金研究能力）。 GitHub 旧地址会自动重定向；已安装旧版的用户请移除后按新名重装。 v0.4.0 起 fund-research 新增可选同业对比层（阶段 6）：同一主题下多只基金"谁更优"，由对比协调员亲自派发互相隔离的独立角色 agent 做跨基金对比 + 独立 red-team 质疑。

安装约束（v0.5.5 起）：fund-research/tools/fetch_fund.py 的 _resolve_version() 依赖插件根 同时存在 assets/ 子目录与 package.json（name=="dsh-invest-research"）来读真实版本； 只拷贝 skills/ 子目录（没有插件根清单）时，版本会回落到脚本内的 _VERSION_FALLBACK 常量—— 属预期行为、不影响取数，但会让「防人肉抬值脱节」的同步守卫不生效（离线自测会打 ⚠️ SKIP 显式告警）。手动拆分安装请连同插件根一起拷，或直接用 dsh plugin add。

安装约束（v0.6.3 起，安全相关）：fund-research 的落盘门禁与 decision-loop 的台账/结算门禁都硬依赖同级的 stock-research/tools/sanitize_check.py（同一文件、不复制规则）。两个 skill 必须同级同装：

只装 fund-research 一个 skill 时，decision_log.py append / settle.py 拿不到 sanitize_check.py，会返回 sanitize_missing 并拒绝写入（失败关闭）；

这是安全正确的行为，不是 bug —— 门禁缺失时宁可写不进，也不静默放行。需要把 skill 单独拆走时，请连同 stock-research/tools/sanitize_check.py 一起拷，否则决策闭环会整条不可用。

Quick check 安装自检

# 1) 个股取数冒烟(需可访问 push2.eastmoney.com;失败多为网络环境而非代码问题)
python assets/skills/stock-research/tools/fetch_data.py --code 600000 --out /tmp/sr/data.json
# 2) 基金取数冒烟(需可访问 fund.eastmoney.com)
python assets/skills/fund-research/tools/fetch_fund.py --code 025490 --out /tmp/fr/fund.json --peer-stocks 10
# 3) 基金取数器离线自测(38 条断言,不依赖网络,期望 exit 0)
python assets/skills/fund-research/tools/test_fund_tools.py
# 4) 脱敏门禁行为自检(134 场景,期望 exit 0)
python assets/skills/stock-research/tools/test_gate.py
# 5) 对比层工具离线自测(24 条断言,期望 exit 0;含 ETF/联接份额、短码补零、--track 仍解析锚点名、关键词截断、https 回退、列表外代码不误拒、标签锚定解析)
python assets/skills/fund-research/tools/test_peer_tools.py
# 6) 时点纪律与决策闭环离线自测(77 条断言,期望 exit 0)
python assets/skills/fund-research/tools/test_decision_tools.py
# 统一入口:npm test 跑 30 条注册冒烟;npm run test:all 跑全部(30+134+38+24+77)

时点纪律 Point-in-Time（v0.6.0 新增）

v0.6.0 补齐三件事：

机制	实现	作用
序列按基准日截断	`fetch_data.py --as-of` / `fetch_fund.py --as-of`	历史行情/净值/指数序列只取 `日期 ≤ 基准日`；基准日之后的数据不进入任何计算窗口（含分位、回撤、收益）
披露日期与数据日期分列	记录新增 `披露日期` 字段 + `pit.py`	`数据日期`=统计截止，`披露日期`=公众首次可读之日；取不到记「未取得」，不得以数据日期冒充（重述靠这个字段暴露）
可见性判定	`pit.py` 的 `AsOf.visible()`	报告期（或其推算最早公开日）晚于基准日 → 该期不得使用，退回上一可见期并在「数据缺口」写明

# 按基准日取数（--as-of 不可省）
python assets/skills/stock-research/tools/fetch_data.py --code 600000 --out /tmp/sr/data.json --as-of 2026-06-30
python assets/skills/fund-research/tools/fetch_fund.py --code 025490 --out /tmp/fr/fund.json --as-of 2026-06-30

决策闭环 Decision Loop（v0.6.0 新增）

一次运行只给出一个决策，无法说明这套方法决策得好不好。v0.6.0 把它变成一个闭环：

研究 → decision.json → 决策日志（只增追加）→ 结算（对齐已发生行情）→ 复盘 → 下次研究可读

组成	作用
`tools/rating.py`	唯一权威的结论标签词表（5 档）+ `REVIEW` 哨兵 + 锚定解析器（容忍 Markdown 加粗与全角标点）
`tools/decision_log.py`	只增追加的决策日志（`ledger.jsonl`）；按 `run_id` 幂等去重；`verify` 校验
`tools/settle.py`	结算：入场取决策日之后第一个收盘日，算原始收益 / 基准同期 / 超额，判 `SETTLED`/`PENDING`/`SETTLE_FAILED`
`tools/decision_score.py`	按标签聚合决策质量：n / 平均超额 / 命中率 + 前视偏差说明（按词表版本分组，跨版本不合并）
`assets/skills/decision-loop/`	3 角色（结算员 / 复盘员 / 质量分析师）+ 完整流程

三个关键口径：

REVIEW 哨兵 —— 解析不出结论标签时返回 REVIEW，绝不静默退化成「等待验证」。一个读不懂的决策不是中性决策，把它记成中性标签等于伪造了一个从未作出的判断。（v0.6.0 顺带修掉了 comparator.py 里 if l in md 全文档子串扫描的真实缺陷：它会把正文里讨论到的他人结论当成本次结论，且失败时静默返回空串。）
命中率只对方向性标签计算 —— 优先研究/可以关注/暂不优先 宣称了方向； 等待验证/数据不足/REVIEW 不宣称方向，参与统计会稀释结果，它们的样本数单独列出。
前视偏差必须披露 —— 结论标签词表与阈值会随版本变化，把今天的词表回填到历史决策会凭空制造「当年就会做出这个判断」的效果，因此按 vocabulary_version 分组统计，跨版本不合并。

# 登记本次决策（只增追加）
python assets/skills/fund-research/tools/decision_log.py append --ledger invest-decisions/ledger.jsonl --record $RUN/decision.json
# 结算 + 回测
python assets/skills/fund-research/tools/settle.py --ledger invest-decisions/ledger.jsonl --series series.json --benchmark bench.json --out $RUN/settlements.json
python assets/skills/fund-research/tools/decision_score.py --ledger invest-decisions/ledger.jsonl --settlements $RUN/settlements.json --out $RUN/decision-quality.md

边界：历史决策与复盘里的数字不得写进新报告的数据表 —— 它只提供「先验教训」与「上次结论是否被证伪」。fund.json 仍是唯一事实底稿。

What's inside

组成	说明
`assets/skills/stock-research/SKILL.md`	个股流程总纲 + 环境解析(`EQUITY_PY` / `EQUITY_SECRET_SCANNER` / `$RUN` / `$ARCHIVE`)
`assets/skills/stock-research/roles/*.md` ×6	各角色完整提示词(含 2026-10-15 真实事故教训固化:单一数据源、口径并列、先落盘再细化)
`assets/skills/stock-research/tools/fetch_data.py`	东财双通道行情/历史取数 + 分位/最大回撤衍生计算;空数据退出码 1;(v0.6.0) 支持 `--as-of` 基准日截断,记录带 `披露日期`
`assets/skills/stock-research/tools/pit.py`	(v0.6.0) 时点纪律底座:披露日期推算(季报 25/半年报 60/年报 90 日,保守上界)、可见性判定、序列截断;`stock-research` 与 `fund-research` 共用
`assets/skills/stock-research/tools/fetch_fundamentals.py`	(v0.2.0) 可选 akshare 财务基本面通道:ROE/每股净资产/负债率/现金流 + PE·PB 近一年真分位;未装 akshare 时退出码 1 不阻断主流程
`install_akshare.ps1` / `requirements.txt`	(v0.2.0) 沙箱内离线装 akshare(Node fetch 下 wheel + `--no-index --find-links`),绕开 pip 平台临时目录 `WinError 5` 与 schannel 两个坑
`assets/skills/fund-research/SKILL.md`	(v0.3.0 / v0.4.0) 基金流程总纲:五阶段 + 阶段6 对比层、10 章报告、5 个结论标签、三种情景、跟踪清单、条件式行动、铁律 11(对比层必由独立 agent 派发)
`assets/skills/fund-research/roles/*.md` ×10	(v0.3.0 / v0.4.0) 协调员 + Agent1–Agent6 + 对比层 3 角色(`peer-orchestrator` / `peer-builder` / `peer-red-team`),统一提交格式
`assets/skills/fund-research/tools/fetch_fund.py`	(v0.3.0 / 版本自 v0.5.5 起从本插件根 `package.json` 读,依赖插件根 `assets/` + `package.json` 同时存在;回落值 `_VERSION_FALLBACK` 有格式 + 同步双重测试断言) 基金身份/净值/多期持仓/行业配置/债券持仓/规模份额/持有人/资产配置/经理/基准对比/重仓股快照;多通道降级,空数据退出码 1
`assets/skills/fund-research/tools/test_fund_tools.py`	(v0.3.0 / v0.6.13 起 39 条) 39 条离线断言(内联 fixture + 网络桩,零网络;`_pkg_version()` 跨仓库/Qoder 安装形态可跑,无清单时打印 `⚠️ SKIP` 显式告警)
`assets/skills/fund-research/tools/test_annualization.py`	(v0.6.13) 20 条离线断言,锁死年化与夏普口径:年频率必须由样本期实际交易日 ÷ 样本年数实算,算不出来才回退 242 并标「回退默认」;禁止硬编 244 / 252;夏普 = `mean(r_t − rf_t)/s(r_t − rf_t)×sqrt(年频率)`,rf 几何日化
`assets/skills/fund-research/tools/fund_cost.py`	(v0.6.13) 销售费用口径校验器:`validate_fee_leg`(渠道 × 申购时点 × 口径,实收/应退两列必须同时给;v0.7.0 起接受 `holding_days`,代销腿按 ≤365 天「不返还」/>365 天「全额返还」分支)、`split_holding_period`(跨 2027-01-01 强制分段)、`net_cost`(实收 + Σ 销售服务费实收 − 应退)、`fee_version_key`(版本键 = 基金代码 + 费率变更生效日);不合规抛 `CostCaliberError`(E1–E7)
`assets/skills/fund-research/tools/test_fund_cost.py`	(v0.6.13 / v0.7.0 起 53 条) 离线断言,覆盖 P0-1 的 F1–F7 行为用例(直销 2027 后认申购费实收 > 0 即 E1;销售服务费先收后返净成本 0 但两列都在;跨 2027 不分段即 E4;未核到规则回落「费用不可精确复算」)＋合同例证 G1–G3(路博迈中国动力 2026-07-06 公告,单例:存量不返还、2027 起先收后返、A 类直销 0/代销 0.80%)＋代销持有期分支 G4–G8(≤365 天不返还、365/366 边界、缺 `holding_days` 即 E7)
`assets/skills/_shared/references/*.md`	(v0.6.13) 跨技能单副本参考件:`fund-return-traps.md`(收益字段口径陷阱,原 5 份逐字节重复已收敛为 1 正文 + 5 指针)、`fee-rules-2026.md`(销售费用规则、证据分级、净成本公式、降级表)
`assets/skills/fund-research/tools/peer_builder.py`	(v0.5.5) 同业筛选器:脚本执行 3 条(跟踪标的严格相等 / 仅被动型 / 非同一基金不同份额)+ 标记 1 条(结构差异);交易状态与份额类别一致性不执行,写入 `agent_review_required[]` 交 Agent-P1 人工复核,只筛不评;候选支持 `--codes`(列表外代码先抓身份页兜底,类型仍未知时记 `type_unknown_codes[]` + `agent_review_required(type_unverified)`,不按非被动型误拒)/ `--keyword`(被动型预筛 + `--max-candidates>=1` 上限)/ `--track`(仍解析锚点简称,不静默关掉判据 C);基金列表源 https 优先、抓取与解析失败都回退 http
`assets/skills/fund-research/tools/comparator.py`	(v0.4.0) 对比矩阵生成器:读 `peers.json` + 各基金 `report.md`/`fund.json`,对齐已冻结结论、暴露口径冲突,不重算指标;(v0.6.0) 结论标签改走 `rating.py` 锚定解析器(修复全文档子串扫描缺陷),`REVIEW` 单独统计
`assets/skills/fund-research/tools/rating.py`	(v0.6.0) 结论标签唯一权威词表(5 档)+ `REVIEW` 哨兵 + NFKC/加粗容忍的锚定解析器 + 方向性标签集合
`assets/skills/fund-research/tools/decision_log.py`	(v0.6.0 / v0.6.3 起 append 内建落盘脱敏门禁) 只增追加的决策日志(`ledger.jsonl`):按 `run_id` 幂等去重、损坏行不阻断读取但计数上报、`verify` 校验;追加前经 `sanitize_gate` 跑 `sanitize_check.py`,命中 CRITICAL/HIGH 直接拒绝写入(无绕过开关)
`assets/skills/fund-research/tools/settle.py`	(v0.6.0;v0.6.4 起写盘前内建落盘脱敏门禁) 决策结算:入场取决策日之后第一个收盘日,算原始/基准/超额,判 `SETTLED`/`PENDING`/`SETTLE_FAILED`;写 `settlements.json` 前经 `sanitize_gate` 跑门禁,命中即拒写并返回 1(失败关闭)
`assets/skills/fund-research/tools/sanitize_gate.py`	(v0.6.4) 落盘门禁公共件:`decision_log.py` 与 `settle.py` 共用同一份规则与失败关闭语义(`sanitize_record` / `sanitize_text` / `is_blocked`),避免两处各写一遍导致口径漂移;门禁脚本缺失返回 `missing`
`assets/skills/fund-research/tools/decision_score.py`	(v0.6.0) 决策质量回测:按标签聚合 n/平均超额/命中率(仅方向性标签),未结算单元显式列出,附前视偏差说明
`assets/skills/fund-research/tools/test_decision_tools.py`	(v0.6.0 / v0.6.3 +5 条 / v0.6.4 +8 条) 77 条离线断言(时点纪律 + 标签解析 + 日志幂等 + 落盘脱敏门禁(含 settle 拒写) + 结算口径 + 命中率口径;零网络)
`assets/skills/decision-loop/SKILL.md` + `roles/*.md` ×3	(v0.6.0 / v0.6.3 起过脱敏门禁) 决策闭环技能:登记 → 结算 → 复盘 → 质量统计;阶段 1/2 由代码强制(decision_log.py / settle.py 内置),阶段 3/4 由角色自查;账本只存公开结论,不含任何个人头寸
`assets/skills/fund-research/tools/test_peer_tools.py`	(v0.5.4) 对比层 24 条离线断言(含 `某ETF` 不得判成 F 份额、`11839→011839` 补零、`--track` 不得让判据 C 失效、`--keyword` 预筛+截断+下限、https 连接层/解析层回退、列表外代码不得按非被动型误拒、标签锚定解析七项回归;纯逻辑 + 工作区临时目录 fixture,零网络)
`tools/sanitize_check.py`	落盘前 PII 门禁:泄漏规则(持仓/成本/资金/盈亏/账户 + v0.6.4 起 `personal_amount`:自持动词/第一人称所有格/第一人称+自持动词 + 金额的组合规则 + v0.6.7 起 `personal_ownership`:金额 + 属于/归/是 + 显式个人 + 个人名词的反向锚定规则(v0.6.8 扩到 5 族变体:个人名词扩表 / 归属动词扩到算作/即 / 语序颠倒 / 无名词后缀;v0.6.9 补私人/私有修饰前缀与所有/名下收句尾巴;v0.6.10 收口:该规则不继承金融术语/政策条款两类豁免——归属声明自带「钱归谁」语义,术语表会把它整条放掉——并新增「金额在场」分支 C2 覆盖算作/即收句;v0.6.11 CAND-FT 自述句例外:紧挨命中处前面是我/本人/自己(可隔一个「的」)时,术语表豁免对 `personal_amount`/`capital_amount` 失效——「自有资金/自有资产/自有资本」在自述句里就是自己的钱,机构口径与「我认为自有资金…」不受影响)) + 5 层公开信息白名单(财报科目/政策条款/金融术语/基金公开披露/机构主语 + 持仓动词/资金名词/否定声明);混合陷阱必拦、政策豁免不跨句;未闭合的形态已在「门禁已知边界」一节对外声明
`tools/test_gate.py`	门禁行为自检 134 场景(真泄漏必拦(含第一人称散文绕过 + 观点句里的个人头寸一律照拦 + 金额后个人化从句 + 5 族归属变体 + 私人/私有与所有/名下两处加宽承重守卫 + 归属声明短接 fin-term/policy 承重守卫 + 金额在场分支 C2 承重守卫 + 自述句例外 CAND-FT 承重守卫(含 2 条只有「的」这一格能闭的))/公开条款必放(含观点句里的公开口径)/基金披露必放/机构主语必放(personal_amount + capital_amount)/公司自有资金必放/机构自述「我方」必放/机构主语豁免窗口常数承重守卫/署名元叙述必放/紧邻第一人称反例必放/陷阱必拦)
`tools/run_pipeline.ps1`	Windows PowerShell 引导脚本(ASCII-only,PS 5.1 兼容)

门禁已知边界 Known gate limits（v0.6.12 声明）

一、`personal_ownership` 三族残留（0.6.10 收口）

#	形态	示例	现状	未闭原因
①	我的 + 一个修饰词 + 个人名词	`这笔投资属于我的个人账户。` / `该份额归我的个人账户所有。`	放行	实测闭它 = 2 拦 : 4 条元叙述误伤；需换设计（收窄名词表 / 剔除可指人的词），不是加宽能解决
②	金额与归属成分之间插入语 > 8 字符	`3 亿元…（超过 8 字）…属于我的存款。`	放行	窗口一加宽就会吃掉跨句的情形，得不偿失
③	中文数字金额（纯倒装）	`我的存款三千万元。`	放行	无阿拉伯数字锚点；带归属动词的已由分支 C 接住（`三千万元归本人。` → BLOCK）

二、第一人称复数与机构自称同形

三、过度拦截（fail-closed，不是泄漏）

遇到上面任意一族的真实泄漏，请附原始串提 issue。按约只修真泄漏、不主动扩探针。

pick-funds 分析师套件（v0.5.0 新增）

移植自 ZCode 官方插件 pick-funds v0.1.1，把原「1 agent + 7 skills」改为纯 skill 承载，入口技能 pick-funds 承载工作模式路由、数据源优先级与共享护栏。

技能	触发场景
`pick-funds`	基金研究类任务入口；共享护栏 + DSH 数据源映射
`fund-screen`	筛选基金 / 找基金 / 近一年收益前 10%
`fund-profile`	基金画像 / XX 基金怎么样
`fund-watch`	基金跟踪 / 持仓基金有没有问题 / 规模异动
`holdings-style`	持仓分析 / 风格漂移 / 两只基金重合度
`manager-profile`	基金经理 / 经理画像 / 这个经理靠谱吗
`report-render`	出一份 PDF / 导出报告 / 存成 docx
`xlsx-author`	表格类交付落成 .xlsx

与 `fund-research` 的分工

DSH 数据源映射

本套件按 DSH 原生方式接线：无 MCP server 依赖，直接走本插件自带取数脚本 + Web 检索兜底。

需要的数据	DSH 取法
基金档案/净值/持仓/规模/份额/持有人/经理/费率/基准/重仓股	本插件 `fetch_fund.py`（`数据` / `持仓` / `净值序列` 等字段）
指数/个股行情、板块、财务基本面	本插件 `fetch_data.py` + `web_fetch`
基金经理变更公告、基金公司事件	`web_search` + `web_fetch`（基金公司公告 / 巨潮 / 交易所披露页）
定性背景（经理访谈、基金公司事件）	`web_search` + `web_fetch`（媒体档标 `[媒体]`）
基金筛选（全市场按条件过滤）	无等价脚本 → `web_search` + `web_fetch`（天天基金等筛选页），须在覆盖度写明引擎口径

依赖边界

report-render 另需 reportlab / matplotlib / pypdf / pypdfium2 / pillow / fonttools / pymupdf （见 assets/skills/report-render/scripts/requirements.txt；pymupdf 为可选项，缺则字形覆盖检查自动跳过）与系统 CJK 字体；
xlsx-author 需 openpyxl，公式重算校验走 headless LibreOffice（缺失时用技能定义的强制替代检查并如实标注，不假装通过）；
peer_builder.py 基金列表源为 https://fund.eastmoney.com/js/fundcode_search.js，个别网络只放行 http，故保留 http:// 回退（设计取舍，非缺陷）；连接层或解析层失败都会触发回退。
两者脚本均为纯 Python，随技能原样携带，无平台耦合。

report-render / xlsx-author 完整度

# 1) Python 依赖(dsh 自带 python 或 $PY) —— 已装并验证:
& "$PY" -m pip install -r assets/skills/report-render/scripts/requirements.txt
#    reportlab / matplotlib / pypdf / pypdfium2 / pillow / fonttools / pymupdf
#    → PDF 直出、图表、墨量/空白页校验、CJK 字形覆盖全部可用(无需 LibreOffice)

# 2) LibreOffice(仅 docx 排版量测 + xlsx 公式重算需要)。无管理员时用「管理镜像」解包:
#    winget 不可用的环境示例 —— 官方 mirror 下载 Win_x86-64 MSI 后:
#    msiexec /a "LibreOffice_X.Y.Z.msi" /qn TARGETDIR="D:\Users\...\LibreOffice"
#    !!! 坑:解包后 program\bootstrap.ini 里 InstallMode=<installmode>(未替换占位符)
#        会报"配置文件已损坏";改成 InstallMode=1 后 soffice.COM 通常可用,soffice.exe 不一定。
#        若仍报错,请用管理员权限正常安装,不要沿用管理镜像。
#    然后把 <target>\program 加入用户 PATH。

# 3) 自检:python assets/skills/report-render/scripts/selftest.py <输出目录>
#    PDF 半程应全过;docx 排版量测有无取决于步骤 2。

本机现状（2026-10-25）：Python 依赖已装齐；LibreOffice 三种安装方式（winget / 用户级 MSI / 管理镜像）均未稳定成功，已从用户 PATH 移除，docx/xlsx 校验走降级路径。这不影响 PDF 交付与数据正确性，只影响 docx 逐页视觉验收和公式重算校验两项。

Requirements

DSH ≥ 0.2.0-rc(skill 注册走 Host skills 服务;无该服务时插件加载为 no-op,不会报错)
Python 3.10+(DSH 自带 runtime 直接可用;取数零第三方依赖,akshare 可选)
网络可达 push2.eastmoney.com / push2his.eastmoney.com(行情);政策核对建议搭配 dsh-web-search-pro(免费 anonymous 源,本插件按 read.fetch-为主设计)

环境变量(全部可选)

变量	作用
`EQUITY_PY`	指定 Python 解释器(默认自动解析 DSH 自带 runtime)
`EQUITY_SECRET_SCANNER`	外接凭据扫描器路径(如 audit-secrets.py);未设则明示 skipped,内置 PII 规则照常生效
`EQUITY_WORK`	run 产物根目录(默认当前工作目录 `./equity-runs/`)

Privacy

报告禁止出现个人持仓/成本/资金量——落盘前 sanitize_check.py 强制拦截(退出码非 0 禁止写入,无绕过开关);
政策原文中的条款数字(如"单户上限100万元")是公开信息,白名单放行且不改写;
所有产物默认留在用户工作区,是否归档进个人笔记库(Vault/Obsidian)由用户显式配置 $ARCHIVE。

License

MIT

类别	skill	用途
个股	`stock-research`	单只 A 股行情/估值/周期/政策分析
基金重研究	`fund-research`	基金穿透式研究（主动/指数/ETF/联接/FOF/QDII/债基）+ 可选同业对比层
基金轻工作流	`pick-funds`（入口）· `fund-screen` · `fund-profile` · `fund-watch` · `holdings-style` · `manager-profile` · `report-render` · `xlsx-author`	筛选 / 单基金画像 / 经理画像 / 持仓风格 / 持续跟踪 / PDF·DOCX·XLSX 交付
决策闭环	`decision-loop`	登记结论 → 对齐已发生行情 → 结算 → 复盘 → 决策质量统计

lobster-liu/dsh-invest-research

dsh-invest-research

Install 安装

Quick check 安装自检

时点纪律 Point-in-Time（v0.6.0 新增）

决策闭环 Decision Loop（v0.6.0 新增）

What's inside

门禁已知边界 Known gate limits（v0.6.12 声明）

一、personal_ownership 三族残留（0.6.10 收口）

二、第一人称复数与机构自称同形

三、过度拦截（fail-closed，不是泄漏）

pick-funds 分析师套件（v0.5.0 新增）

与 fund-research 的分工

DSH 数据源映射

依赖边界

report-render / xlsx-author 完整度

Requirements

环境变量(全部可选)

Privacy

License

Community comments

lobster-liu/dsh-invest-research

dsh-invest-research

Install 安装

Quick check 安装自检

时点纪律 Point-in-Time（v0.6.0 新增）

决策闭环 Decision Loop（v0.6.0 新增）

What's inside

门禁已知边界 Known gate limits（v0.6.12 声明）

一、personal_ownership 三族残留（0.6.10 收口）

二、第一人称复数与机构自称同形

三、过度拦截（fail-closed，不是泄漏）

pick-funds 分析师套件（v0.5.0 新增）

与 fund-research 的分工

DSH 数据源映射

依赖边界

report-render / xlsx-author 完整度

Requirements

环境变量(全部可选)

Privacy

License

Community comments

一、`personal_ownership` 三族残留（0.6.10 收口）

与 `fund-research` 的分工

一、`personal_ownership` 三族残留（0.6.10 收口）

与 `fund-research` 的分工