智能 HR 助手，支持员工花名册管理、组织架构维护、薪资自动计算（个税/社保/公积金）、年终奖优化与报表生成。
所有数据存储在用户本地，不上云。 用户上传 Excel 文件后，系统会自动分析表格结构并识别列映射。
python3 {{baseDir}}/tools/main.py "<用户自然语言指令>"
脚本内部会自动完成：意图识别 → 参数提取 → 工具执行 → 响应格式化。
# 查看帮助
python3 {{baseDir}}/tools/main.py "帮助"
# 查看当前配置状态
python3 {{baseDir}}/tools/main.py "查看配置"
# 查询员工
python3 {{baseDir}}/tools/main.py "查一下张三的信息"
python3 {{baseDir}}/tools/main.py "技术部有哪些员工"
# 员工统计
python3 {{baseDir}}/tools/main.py "员工统计"
# 薪资计算
python3 {{baseDir}}/tools/main.py "计算本月薪资"
python3 {{baseDir}}/tools/main.py "年终奖36000"
# 社保公积金计算（不需要绑定表格）
python3 {{baseDir}}/tools/main.py "北京社保10000"
python3 {{baseDir}}/tools/main.py "上海五险一金15000"
# 查看配置状态
python3 {{baseDir}}/tools/main.py status
# 绑定表格（分析 + 自动映射 + 绑定 一步完成）
python3 {{baseDir}}/tools/main.py bind organization /path/to/org.xlsx
python3 {{baseDir}}/tools/main.py bind employee /path/to/employee.xlsx
python3 {{baseDir}}/tools/main.py bind salary /path/to/salary.xlsx
# 仅分析表格结构（不绑定）
python3 {{baseDir}}/tools/main.py analyze /path/to/file.xlsx [sheet_name]
当用户说「开始初始化」或上传了 Excel 文件时：
python3 {{baseDir}}/tools/main.py status 查看当前状态# 绑定组织架构表
python3 {{baseDir}}/tools/main.py bind organization "<上传文件路径>"
# 绑定员工花名册
python3 {{baseDir}}/tools/main.py bind employee "<上传文件路径>"
# 绑定薪资表
python3 {{baseDir}}/tools/main.py bind salary "<上传文件路径>"
> 安全提示：仅接受用户主动上传的文件路径，不要读取或处理非 Excel 文件。
如果用户一次上传了多个 Excel 文件：
bind 依次绑定bind 命令会自动识别常见列名别名，包括：
| 标准字段 | 常见列名 |
|---|---|
| --------- | --------- |
| 工号 (empNo) | 工号、员工编号、员工ID、编号 |
| 姓名 (name) | 姓名、员工姓名、名字 |
| 部门 (deptCode) | 部门编码、部门ID、所属部门 |
| 基本工资 (baseSalary) | 基本工资、底薪、基础工资 |
| 入职日期 (hireDate) | 入职日期、入职时间、到岗日期 |
| 在职状态 (status) | 在职状态、状态、员工状态 |
如果自动匹配有误，系统会提示用户确认。
| 操作 | 示例指令 |
|---|---|
| ------ | ---------- |
| 查询员工 | 「查一下张三的信息」「E001的信息」 |
| 员工列表 | 「所有员工」「花名册」「在职多少人」 |
| 搜索筛选 | 「技术部员工」「试用期员工」「姓李的」 |
| 添加员工 | 「添加员工 E020 王五 技术部 工程师」 |
| 修改员工 | 「张三转正」「李四调到市场部」「E003调薪到20000」 |
| 删除员工 | 「E010离职」「删除E020」 |
| 批量操作 | 「E001到E010批量转正」 |
| 操作 | 示例指令 |
|---|---|
| ------ | ---------- |
| 查看部门 | 「组织架构」「有哪些部门」「技术部信息」 |
| 部门树 | 「部门树」「组织架构图」 |
| 汇报关系 | 「张三的汇报链」「张三向谁汇报」 |
| 操作 | 示例指令 |
|---|---|
| ------ | ---------- |
| 批量薪资 | 「计算本月薪资」「跑工资」「算2月工资」 |
| 单人薪资 | 「算一下张三的工资」 |
| 年终奖 | 「年终奖36000」「年终奖50000月薪2万」 |
| 社保公积金 | 「北京社保10000」「上海五险一金15000」 |
| 个税税率 | 「个税税率」「税率表」 |
| 操作 | 示例指令 |
|---|---|
| ------ | ---------- |
| 员工统计 | 「员工统计」「人数统计」「合同到期提醒」 |
| 数据校验 | 「校验花名册」「检查数据质量」 |
| 导出报表 | 「导出报表」「生成Excel」 |
| 审计日志 | 「查看操作日志」「最近操作记录」 |
所有数据存储在用户本地，不上云：
| 文件 | 说明 |
|---|---|
| ------ | ------ |
.hr-data/config.json | 绑定状态、列映射、初始化配置 |
.hr-data/audit.log.jsonl | 操作审计日志（append-only） |
.hr-data/payroll/YYYY-MM.json | 月度薪资计算结果（按月归档） |
.hr-data/conversations/ | 对话历史记录 |
bind 子命令.hr-data/payroll/ 目录{{baseDir}}/tools/main.py，所有 .py 文件在 tools/ 目录下共 1 个版本