dsh-valuation-service：DeepSeek Harness 的确定性估值服务

前言¶

DeepSeek Harness（DSH）采用「一切皆插件」的架构，开发者可以通过插件扩展工具链。在构建财务分析或投资研究智能体时，常见痛点是：手工计算财务比率、DCF 模型输入、可比公司估值等步骤繁琐且易出错，不同项目间的数据口径难以统一。dsh-valuation-service 插件旨在解决这些问题，它将财务数据标准化与估值计算流程化，为 DSH 提供一个确定性、可复现的估值服务。

插件定位¶

dsh-valuation-service 是一个确定性财务数据和估值插件，由维护者 zirscard 开发，归类于「模型推理」。它读取项目目录下的 01.json / 02.json / 04.json 工作表 JSON，自动计算六个比率组、预测比率、DCF 输入槽、可比 PS/PE 和 IRR，并输出统一 schema。插件不进行任何 AI 推理或模型调用，缺失数据保持空白并标记 missing，留给下游步骤人工或自动化补全。

核心功能¶

插件注册了一个工具 valuation_service，其核心计算模块包括：

ratios.historical：盈利能力、偿债能力、营运能力、现金流、估值、增长六大类比率
ratios.forecast：预测期的盈利/增长/费用比率；依赖资产负债表和现金流量表的比率标记为 missing
dcf：完整的 DCF 输入槽（WACC、g、tax、EBIT、D&A、capex、ΔWC、net debt），输出 PV(FCFF)、TV、EV、equity，并列出缺失项和交接锚点
comparable：并列计算 PS 和 PE，提供切尾均值（n≥5 时切去 10%）、全样本均值、1 年均值、pre-money 倍数、premium
irr：计算目标/保守/乐观三种 IRR，判断 closed-vs-open，计算偏差
assumption_diff：逐字段对比人工假设与基于实际数计算的假设差异
pending / gate：记录未解决的冲突以及 C2–C7 gate 状态

插件输出统一的 JSON schema m1.valuation-service/v2，每个项目一条记录，包含财务输入、比率、DCF、可比、IRR、假设差异、待办事项和 gate 状态。

安装与启用¶

从 GitHub 安装：

dsh plugin add https://github.com/zirscard/dsh-valuation-service

从本地目录安装：

dsh plugin add link:/absolute/path/to/dsh-valuation-service

安装后重启 DSH，新会话即可使用 valuation_service 工具。

输入与输出¶

输入目录结构（默认 --base 为 $DSH_VALUATION_BASE 或 ./数据底表）：

<base>/
├── 项目A/
│   └── json/
│       ├── 01.json   # financial.raw (BS/IS/CF) + financial.ratios
│       ├── 02.json   # assumptions.forecast + assumptions.comparables + assumptions.valuation
│       └── 04.json   # validation.irr_recompute
└── 项目B/
    └── json/...

项目通过动态发现：包含所有三个 JSON 文件的目录即视为一个项目。01.json 支持两种布局：raw = {bs, is, cf} 或报告标题章节（如「一、资产负债表 · 资产」），插件会统一归一化。

工具调用示例：

{
  "base": "/path/to/数据底表",
  "projects": "项目A,项目B",
  "write": true
}

base（字符串，可选）：工作表根目录，相对路径相对于会话工作目录解析
projects（字符串或数组，可选）：限制处理的项目目录名
write（布尔，可选，默认 false）：写入 <base>/valuations-service.json
out（字符串，可选）：覆盖输出路径

工具返回每个项目的摘要：DCF 状态与缺失列表、PS/PE 状态、IRR closed 标志、假设差异数量、gate，以及输出路径。

CLI 使用¶

插件提供纯 Python 入口点（仅依赖标准库），可直接在命令行运行：

python3 core/valuation_service.py --base /path/to/数据底表 --dry-run
python3 core/valuation_service.py --base /path/to/数据底表 --projects 项目A
python3 core/valuation_service.py --base /path/to/数据底表 --write
python3 core/valuation_service.py --base /path/to/数据底表 --write --json

--json 打印机器可读摘要对象
--write 写入聚合文件
不加 --write 为 dry run

聚合文件格式：

{
  "schema": "m1.valuation-service/aggregate/v2",
  "generated_at": "...",
  "base": "...",
  "projects": [...],
  "errors": [...]
}

统一 Schema¶

单项目输出示例：

{
  "schema": "m1.valuation-service/v2",
  "project_id": "...",
  "project_name": "...",
  "currency": "CNY",
  "method": "...",
  "financial_inputs": {"period": "...", "is": {}, "bs": {}, "cf": {}},
  "ratios": {"historical": {}, "forecast": {}},
  "dcf": {"status": "computed|partial|unavailable", "inputs": {}, "outputs": {}, "missing": [], "m3_handoff": {}},
  "comparable": {"ps": {}, "pe": {}},
  "irr": {"target": null, "conservative": null, "optimistic": null, "closed": false, "judge": "", "dev": null},
  "assumption_diff": [],
  "pending": [],
  "gate": {}
}

公式说明¶

比率：毛利率、营业利润率、净利率、ROE、ROA；流动比率、速动比率、现金比率、资产负债率、利息保障倍数；资产周转率、存货周转率、应收账款周转率及天数；经营现金流比率；PS/PE/EV/EV-EBITDA；收入与净利润增长率
DCF：FCFF = EBIT × (1 − t) + D&A − capex − ΔWC；TV = FCFF_last × (1 + g) / (WACC − g)；EV = Σ PV(FCFF) + PV(TV)；equity = EV − net debt
可比公司：切尾均值（n ≥ 5 时切去 10%）、全样本均值、1 年均值、pre-money 倍数、premium
IRR：(exit value / invested capital) ^ (1 / years) − 1
假设差异：逐字段对比人工假设与模块计算的实际值

数据适配层¶

插件内置适配层处理数据变体，避免每项目单独适配：

布局归一化：{bs,is,cf} 与报告标题章节统一为标准字段
单位转换：字段名后缀优先，再查找 forecast.unit
字段名变体：关键词匹配 + 排除词
总计与明细：资产总计 与 流动资产合计 区分
自比剔除：treatment 标记为「自比/剔除」的行被过滤
市场无 PE 多倍：当无可比市场 PE 时，将 comparable.pe.status 设为 assumption，使用假设范围而非市场倍数

新增变体属于结构化（布局/单位/命名）时加入适配层；测量约定加入公式；缺失数据留空并标记 missing。

DCF 交接锚点¶

插件将缺失的 DCF 输入列出交接锚点，供人工或下游步骤补全：

缺失输入	交接锚点
WACC	无风险利率 / beta / 权益风险溢价 / 资本结构
g	长期 GDP 增长 / 行业终值增长
capex	资本开支计划 / 在建工程 / 扩产计划
D&A	折旧摊销政策
ΔWC	应收/存货/应付周转预测
tax rate	有效税率
net debt	有息债务 − 现金

适用场景与注意¶

适合需要标准化财务数据与估值输出的 DSH 智能体开发，如投资研究、财务分析、尽职调查自动化
插件以当前 DSH 进程权限运行，安装前建议阅读源码与许可证（MIT）
不涉及 AI 推理或网络请求，不向外部发送项目数据
插件不替代估值模型，而是标准化输入并保持插槽与标记，配合模型或人工完成最终估值

总结¶

dsh-valuation-service 为 DeepSeek Harness 提供了一个确定性、可复现的估值服务插件。它将财务比率计算、DCF 输入准备、可比公司分析和 IRR 评估流程化，输出统一 schema，缺失数据保持标记，便于后续步骤补全或模型调用。对于需要构建财务分析或投资研究智能体的开发者，该插件提供了从原始工作表到结构化估值输出的标准化路径。

目录页：https://www.skillhub.cn/plugins/zirscard/dsh-valuation-service
GitHub：https://github.com/zirscard/dsh-valuation-service