前言¶
在 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。
