feat: 工资查询助手首版 v1.0.105

基于 skill-template 脚手架开发,包含:
- payroll_config(费率配置,可编辑)+ payslip_snapshots(解析历史,只读)2 张业务表
- 全国默认 + 北上广 4 套费率(社保/公积金/个税起征点/7 级税率表)
- 5 个业务 Action:calculate-payslip-simple / calculate-payslip-full / explain-term / view-config / edit-config
- 个税累计预扣法计算,支持多月历史累加
- 20 个薪资名词库(社保/公积金/个税/全勤/加班费等)
- 完整市场文档(README/TUTORIAL/DEMO/CHANGELOG)
- 296 测试全部通过
This commit is contained in:
skill-dev
2026-09-07 17:02:05 +08:00
commit 3db196e49d
205 changed files with 29927 additions and 0 deletions

86
README.md Normal file
View File

@@ -0,0 +1,86 @@
---
description: "员工端轻量化薪资智能查询工具:粘贴工资条文本或输入字段,自动核算应发/扣除/实发,核对差异,解释名词,估算个税累计预扣。不连接企业真实工资库。"
---
## 这个技能能帮你做什么
- 粘贴工资条文本或输入字段 → 自动**核算应发/扣除/实发**
- 用户给出实发金额 → **核对差异**,标出多报/少报
- 看不懂扣款 → **名词解释**(社保/公积金/个税/全勤等)
- 缺扣除项 → 按**费率估算**社保/公积金/个税(标"仅供参考")
- 个税按**累计预扣法**计算(年初低档,年末可能跳档)
- 每次解析**写入本地历史**,可多月对比
---
## 适合什么场景
- 收到工资条,想核对实发金额是否正确
- 看不懂社保/公积金/个税怎么扣的
- 想估算下月到手工资(输入基本工资即可)
- 核对个税累计预扣是否扣多
---
## 使用前需要准备什么
- 知道基本工资金额(必填)
- 工资期间(如 2026-08,必填)
- 可选:工资条上的各项金额(绩效/补贴/扣款等)
- 可选:工资条上的实发金额(用于核对)
---
## 怎么使用
支持**对话任务**与**数据管理**两种入口。
### 对话任务
直接对助手说:"帮我核算工资,基本 8000,期间 2026-08,自报实发 6200"。
助手会自动选 Action 并返回结构化结果。
### 数据管理
- 工具栏点「快速估算工资」或「精确核算工资」→ 填表单 → 出结果
- 查看历史:在「解析历史」表查看所有解析记录
- 改费率:在「费率配置」表双击数值编辑(仅管理员)
**逐步操作与示例话术,请查看技能市场「使用教程」Tab。**
---
## 执行后你会得到什么
- 应发合计 / 扣除合计 / 实发工资(计算值)
- 若提供自报实发:核对是否一致 + 差异金额
- 估算项标注"仅供参考,非官方数据"
- 一条历史记录(可多月对比)
---
## 注意事项
- **不连接企业真实工资库**:纯本地解析与计算
- 估算结果统一标注"仅供参考",以公司实际为准
- 个税累计预扣需历史数据:首次使用无累计,按单月计算
- 费率默认全国,可选北上广;其他地区走全国默认
- **不处理**:工资申诉、劳动仲裁、薪资维权
---
## 常见问题
### 估算的个税和工资条对不上?
> 个税按累计预扣法计算,需本月之前的历史数据。首次使用无累计,结果仅供参考。建议补录前几个月工资条后重算。
### 可以删除历史记录吗?
> 解析历史为只读业务表,请勿在 UI 直接编辑。如需清理,联系管理员。
### 费率不对怎么办?
> 管理员可在「费率配置」表编辑数值(双击单元格)。地区选 default=全国默认。
### 会泄露我的工资信息吗?
> 数据仅存本地(本人匠厂数据目录),不上传。原始工资条文本默认隐藏,仅管理员可见。