前言¶
在 DSH 里做法律相关智能体或辅助工具时，赔偿金额往往要反复试算：分项怎么乘、N 和 2N 能不能一起要、利息按 365 天怎么分段，对方或承办人还要能拿纸笔重算一遍。若把计算藏在模型回复里，口径不透明，也容易和各地标准混在一起。下面介绍社区插件 @deepwhale-cn/dsh-legal-damages（仓库 feely0208/dsh-legal-damages）：它只做四类常见赔偿请求的算术，每项输出公式、代入值和金额，不生成文书、也不判断谁担责。
这是什么¶
深鲸损害赔偿计算器 由维护者 feely0208 发布，npm 包名 @deepwhale-cn/dsh-legal-damages，当前版本 0.1.0，许可证 MIT。在 SkillHub 等社区目录中归类为 客户端 插件：装好后在 Web 侧栏出现「法律·损害赔偿」，同时提供 CLI 与 HTTP 接口，便于脚本和智能体调用。
定位可以概括为：算得清、复核得了——不是文书生成器，不替用户判断责任或伤残等级；输出带「AI 辅助生成，需承办律师复核」类提示，与起诉状、法条核对等能力需配合其他 legal 类插件使用。
四类计算能力¶
插件覆盖四类最常见赔偿请求，关键口径如下（细节以 README 为准）。
| 类型 | 算什么 | 关键口径 |
|---|---|---|
| 人身损害 | 医疗费、误工费、护理费、营养费、住院伙食补助、残疾赔偿金、精神损害抚慰金、交通费等 | 残疾赔偿金 = 基数 × 年限 × 伤残系数；基数与年限由用户填写（各地标准不同，插件不内置任何地方数字） |
| 劳动争议 | 经济补偿 N、违法解除赔偿金 2N、代通知金、加班费、未休年假 200%、二倍工资差额 | N 与 2N 二选一不叠加；日工资按 21.75 天折算；填写当地社平时可提示 3 倍社平封顶校验 |
| 借款利息 | 本金 × 年利率 × 天数 ÷ 365，支持分段 | 算头不算尾；只提示 LPR 四倍上限，不内置 LPR 数值 |
| 违约金 | 基数 × 约定比例 | 超过实际损失 30% 时提示可请求调减（《民法典》第 585 条第 2 款） |
纪律上插件强调：不编地方标准（人均可支配收入、社平、护理/营养日标准、伙食补助、LPR 等一律用户填或留空）；金额两位小数，分项四舍五入后再相加，合计等于分项和；算的是请求额，不是判决额。
安装与启用¶
在 DSH Web 配置下安装（命令来自官方 README，勿自行拼接 GitHub 路径）：
dsh plugin --profile web add @deepwhale-cn/dsh-legal-damages
装好后侧栏出现「法律·损害赔偿」，命令 dsh-legal-damages 也可直接使用。package.json 要求 Node >= 18，dsh 版本 >=0.1.0-rc.6 <0.3.0，客户端注入 @deepseek-ai/dsh-client-runtime，平台为 web。
安装前建议自行查看仓库源码与 MIT 许可证；插件以当前 dsh 进程权限运行，涉及金额与案情参数时应在可控环境中使用。
典型用法¶
Web 面板¶
侧栏进入「法律·损害赔偿」→ 顶部四个类型页签 → 填表 → 计算 → 查看明细表（项目 / 公式 / 金额）及合计与提示 → 可复制结果或导出 CSV。
CLI¶
人身损害示例（残疾相关基数、年限、系数需自行填入）：
dsh-legal-damages --type injury --medical 12000 --daily-income 300 --lost-days 20 \
--disability-base 40000 --disability-years 20 --disability-coef 10
劳动争议（模式 N 表示经济补偿，与 2N 不叠加）：
dsh-legal-damages --type labor --monthly-wage 8000 --work-years 3.5 --mode N
借款利息（可按起止日期分段）：
dsh-legal-damages --type interest --principal 100000 --rate 6 \
--start 2024-01-01 --end 2024-12-31
违约金（可带实际损失用于 30% 调减提示）：
dsh-legal-damages --type penalty --base 200000 --rate 20 --actual-loss 20000
一次跑齐四类样例并输出到目录：
dsh-legal-damages --demo --out ./赔偿计算
常用选项：--json 输出机器可读结构（items / total / notes / pending）；--out DIR 生成 计算表.csv（UTF-8 BOM，便于 Excel 打开）与 计算说明.md。退出码 0 表示成功，2 表示参数错误或校验未通过。
HTTP¶
插件暴露如下路由（路径前缀以部署为准）：
GET /dsh-legal-damages/api/info
POST /dsh-legal-damages/api/calc {type, input}
POST /dsh-legal-damages/api/csv {type, input}
/api/calc 返回字段包括 ok、type、title、items（含 name、formula、sub、amount、basis）、total、notes、pending。
适用场景与注意¶
适合：律师助理、法务或 DSH 智能体在对话前先算一版赔偿明细，把公式和代入值交给对方手算复核；批量或自动化场景用 CLI/--json 或 HTTP 接入流水线。
不适合：替代承办律师对责任、伤残等级、违法解除等事实判断；内置任何地区赔偿标准；生成起诉状（README 指向 legal-complaint）或核法条（指向 legal-cite-check）。
仓库提供 bash tests/run.sh（README 称 27 条断言），覆盖四类金额、N/2N 不叠加、年假 200% 口径、365 天计息、缺参与非法输入等，可在本地改代码后自测。
结尾¶
@deepwhale-cn/dsh-legal-damages 把四类损害赔偿做成透明算术：公式、代入值、分项与合计一致，地方标准留空由人填，避免模型「替你想当然」。社区目录页：feely0208/dsh-legal-damages；源码与用法说明：GitHub。
