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