DeepSeek Harness 插件：retirement-calc 中國退休年齡與養老金測算

前言¶

2025 年 1 月 1 日起，中國實施漸進式延遲退休政策。官方規則包含精確的延遲階梯和繳費年限遞增表，但大多數第三方計算器基於經驗估算，導致計算結果與官方表格存在偏差。retirement-calc 插件將這套精確規則編碼爲單一模塊，並在 DeepSeek Harness (DSH) 中提供網頁計算器、側邊欄倒計時以及 Agent 工具，確保頁面與 Agent 的計算結果完全一致。

插件定位¶

名稱：smallballoons01/retirement-calc
類別：工作流
許可證：MIT
簡介：中國法定退休年齡與養老金測算工具，集成於 DSH 生態。

核心功能¶

該插件提供三種形態的交互方式：

側邊欄按鈕：在 DSH 側邊欄底部顯示 “🕐 retirement in N days” 按鈕，提供倒計時入口。
Agent 工具：爲 Agent 提供三個專用工具，用於查詢和模擬：
- retirement_plan：返回退休日期、年齡、剩餘天數及預計月養老金（含基礎養老金與個人賬戶）。
- retirement_profile：對退休人員的基礎信息、繳費假設進行存儲管理（獲取、設置、清除）。
- retirement_compare：模擬不同場景（增加繳費年限、提高繳費指數、延遲退休）對養老金的影響。
精細化配置：支持按省份配置參數，例如廣東地區在平均指數低於 0.6 時會額外扣除。

安裝與啓用¶

插件安裝需要手動處理 peer dependencies 的符號鏈接。請確保已安裝 DeepSeek Harness 及其核心包。

1. 創建目錄並鏈接依賴¶

mkdir -p retirement_calc/node_modules/@deepseek-ai
for p in cordis dsh-llm dsh-settings dsh-skill dsh-system-prompt dsh-tools schemastery; do
  ln -sfn "$HOME/.dsh/profiles/node_modules/@deepseek-ai/$p" "retirement_calc/node_modules/@deepseek-ai/$p"
done

2. 註冊插件¶

將本地路徑添加到指定 profile（如 web）：

dsh plugin --profile web add link:/path/to/retirement_calc

3. 驗證安裝¶

檢查配置是否生效：

dsh --profile web --dump-config | grep retirement-calc

注意：如果配置文件中已有一行 retirement-calc，請先刪除。重複註冊會導致插件樹因路由衝突而無法啓動。

典型用法¶

網頁計算：打開 dist/retirement-calculator.html。在左側輸入性別、出生年月、職業類別（如企業職工）及當前繳費基數，右側面板會實時顯示退休倒計時和月養老金預估。
側邊欄快捷：在 DSH 側邊欄點擊底部的 “🕐 retirement in N days” 按鈕，快速查看倒計時。
Agent 交互：Agent 可調用 retirement_plan 工具獲取當前用戶的退休測算結果，或使用 retirement_compare 工具進行多方案對比。

適用場景與注意¶

適用對象：需要精確測算中國法定退休年齡和養老金的 DSH 用戶及開發者。
計算邏輯限制：如果計劃繳費月份超過實際剩餘月份，系統只計算實際月份。
地區規則：廣東和其他省份在平均指數低於 0.6 時會額外扣除，工具支持按省份啓用此邏輯。
性別與職業：男性與女性、不同職業類別的延遲規則不同，輸入時必須準確區分性別和職業類別。
權限注意：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證（MIT）。

生態鏈接¶

插件目錄：https://www.skillhub.cn/plugins/Smallballoons01/retirement-calc
源碼倉庫：https://github.com/Smallballoons01/retirement-calc