HR 人力脉搏驾驶舱 v0.1.0 更新日期：2026-05-29 小白版 HTML 说明书

从安装到
第一份看板

这份说明书按第一次使用的顺序写：
先安装，再配置模型，再准备员工快照，
最后导入数据，查看周期看板。

1. 这个工具做什么

人力脉搏驾驶舱用于把一段时间内的员工全量快照，整理成可复盘的人力经营看板。它会帮你看清楚人数变化、入离职、部门流动、层级变化、地点变化、人员结构和管理摘要。

一句话理解： 你每周、每月或每季度导入一份员工花名册，系统会把这些花名册连起来，告诉你组织发生了什么变化。

它不是人事系统，也不是员工信息维护系统。它更像一个本地 HR 分析工作台，适合 HR、HRBP、OD、招聘负责人和经营管理者做组织复盘。

2. 使用前准备

电脑

Windows 10/11 x64 或 macOS。推荐使用公司允许安装本地软件的电脑。

浏览器

应用会自动打开浏览器页面。Chrome、Edge、Safari 都可以。

模型配置

准备一个可通过 API 调用的模型服务。它不限定 OpenAI，也可以是 DeepSeek、通义千问、智谱、火山、硅基流动、本地中转站或公司内部模型服务；只要能提供 API 地址、API Key 和模型名称即可。

员工快照

准备 Excel、XLS 或 CSV 格式的员工全量快照。先用脱敏数据试跑更稳妥。

隐私边界： 不要把员工隐私、薪酬、身份证号、家庭住址、内部制度或公司机密上传到公开网盘、公开仓库或聊天窗口。模型配置和员工数据都应该由你所在组织授权后再使用。

3. 安装和打开

Windows 安装

下载 Windows 安装包

文件名是 hr-pulse-dashboard-windows-setup-v0.1.0.exe。

双击安装包

按安装向导继续。如果系统提示安全确认，先确认文件来自正式下载页，再继续安装。

从桌面或开始菜单打开

打开后应用会启动本地服务，并自动打开浏览器页面。

macOS 安装

下载 macOS DMG

文件名是 hr-pulse-dashboard-macos-signed-notarized-v0.1.0.dmg。这是已签名、公证并通过 Gatekeeper 校验的版本。

打开 DMG

把“人力脉搏驾驶舱.app”拖到 Applications 文件夹。

从 Applications 启动

正常情况下可以直接打开。第一次启动时请等待本地服务完成初始化。

Codex 直装包

如果你要把项目交给 Codex 安装、检查或二次开发，下载 hr-pulse-dashboard-codex-install-v0.1.0.zip。解压后把里面的 CODEX_INSTALL.md 交给 Codex，它会按说明启动后端、前端并验证页面。

第一次打开要等一会儿： 应用启动时会先在本机启动一个服务，再打开浏览器。如果浏览器没有马上出现，等 10 到 30 秒，再看是否有本地地址提示。

4. 第一次配置模型

“本地安装”不等于全程离线。

点击“生成摘要”会向你配置的模型发送周期、部门、人数与结构指标、发生变动员工的 ID、姓名、部门、职级、地点、入离职日期，以及相关事件的标题和描述。普通看板使用本地规则摘要，不会自动发起这一请求。

正式使用前先确认组织授权和模型服务的处理、留存与训练规则；需留在组织内时，使用获授权的内部模型。不要把本机数据库或备份公开上传，它们包含原始员工资料和模型密钥。

本说明按官方 v0.1.0 Codex 包源码核验；本轮没有运行或逐一核验 Windows/macOS 安装包内部行为。

当前公开 v0.1.0 Codex 包的字段映射与导入检查使用本地规则，仍需你逐项确认。连接测试会向所配模型发送固定测试提示；点击驾驶舱“生成摘要”才会调用摘要模型。真实导入仍按现有流程要求先完成连接测试，否则导入审核不会解锁。

进入设置页

打开应用后点击左侧“设置”

顶部会看到“模型已就绪”或“需要完成连接测试”。

填写连接信息

按你的模型服务提供商填写 API Base URL、API Key、Cleaning Model 和 Summary Model。这里的“模型服务”是泛指，不只包括 OpenAI。

保存配置

点击保存后，配置会保存在本机。API Key 在界面中掩码显示；当前公开 Codex 包未见数据库存储加密实现。数据库与备份也含模型配置，请按敏感文件保管。

测试连接

点击测试连接。只有测试成功后，导入流程才算解锁。

每个字段是什么意思

页面字段 小白解释 示例
API Base URL 模型服务的接口地址。不同服务商格式不同，常见兼容接口通常以 /v1 结尾。 https://api.example.com/v1
API Key 调用模型的密钥。它相当于你的模型账户密码，不要发给别人。 sk-...
Cleaning Model 当前公开 Codex 包中用于连接测试。字段映射和导入问题检查为本地规则，不能把模型名称视为这些检查已由模型执行。 填写你的服务商模型名
Summary Model 用于生成管理摘要的模型。可以和 Cleaning Model 相同。 填写你的服务商模型名
Cleaning Temp 清洗任务的发散程度。建议保持默认低温。 0.1
Summary Temp 摘要任务的表达弹性。建议用默认值。 0.4
Max Tokens 单次生成最多输出多长。普通使用保持默认即可。 1200
没有模型 Key 怎么办： 你可以先点击设置里的“重置演示数据”体验看板。但真实员工快照导入需要可用模型连接。

5. 准备员工数据

这里最容易出错。请记住：每次上传都应该是一份“某一天公司全部员工的快照”，不是只上传变化人员。

推荐表格结构

建议列名 是否重要 说明
工号 / 员工ID 必须 用于判断同一个人是否跨周期存在。不要用会变化的昵称代替。
姓名 建议 用于明细查看。对外演示时可以脱敏。
部门 / 所属部门 必须 建议使用完整部门路径，例如“产品技术中心/平台研发部/前端组”。
在职状态 / 人员状态 必须 用于识别在职、离职。前后口径要稳定，例如统一用“在职、离职”。
入职日期 重要 用于计算新入职和司龄。
离职日期 重要 离职人员建议填写，未离职可留空。
职级 / 层级 建议 用于识别层级变化。
出生日期或年龄 可选 用于年龄结构分析。二选一即可。
性别、学历、办公地点、员工类型 可选 用于结构分析和分布图。
绩效、人才标记、汇报对象、人工成本、预算人数 可选 适合更深入的管理复盘。涉及敏感信息时先确认授权。

标准字段对照

系统内部会把你的中文列名映射到标准字段。常见标准字段包括： 

employee_id, employee_name, department_path, status, hire_date, leave_date,
level, birth_date, age, gender, education, location, employment_type,
performance, talent_tag, manager_id, labor_cost, headcount_budget

一个可参考的表头

人员ID, 姓名, 所属部门, 人员状态, 加入日期, 离任日期, 层级, 生日, 周岁,
性别, 最高学历, 办公地点, 员工类型, 绩效结果, 人才标记, 汇报对象,
人工成本, 预算人数
快照日期怎么填： 上传页面会单独让你选择“快照日期”。如果文件名是 HR_snapshot_2026-05-22.csv，快照日期就填 2026-05-22。

6. 导入和审核

导入不是“点一下就入库”。系统故意设计了审核闸口，避免脏数据直接污染看板。

进入“导入审核”

左侧菜单点击“导入审核”。如果模型未就绪，先回到设置页完成连接测试。

选择快照日期

填写这份花名册代表的日期，例如 2026-05-22。

选择文件

支持 CSV、XLSX、XLS。建议第一次先用脱敏样例文件试跑。

点击“上传并审核”

系统会上传文件、识别字段、检查数据问题，并生成质量分。

检查字段映射

左列是你的原字段，右列是系统标准字段。如果自动映射错了，手动改正后点击“保存映射”。

处理审核队列

逐条查看高风险、中风险和待确认问题。你可以接受建议、修正最终值或标记忽略。

确认入库

当待确认问题为 0，且没有阻塞行时，点击“确认入库”。这份快照才会进入看板计算。

质量分怎么看

页面指标 含义 怎么处理
质量分 系统对本次导入质量的综合判断。 低于 70 时建议不要急着入库，先看问题队列。
高风险 可能影响人数、离职、部门变化等关键指标。 逐条确认，不建议一键忽略。
中风险 可能影响结构分析或个别字段。 可以逐条确认，也可以在确认合理后批量接受。
阻塞 会阻止快照入库的问题。 必须修正或做明确处理。

7. 查看和导出看板

看板上方怎么用

  • 周期类型：可以切换周、月、季、年。
  • 周期：选择具体周期，例如 2026-W21 或 2026-05。
  • 部门筛选：输入或选择部门后，只看该部门相关数据。
  • 管理摘要：展示系统生成的关键变化、风险和管理问题。

重点看哪些模块

KPI 区

看在职人数、新增、离职、流失率、部门流动等核心指标。

结构图

看性别、年龄、司龄、学历等人员结构。

变动明细

查看新增、离职、部门变化、层级变化、地点变化人员名单。

事件时间线

记录组织调整、业务变化、制度变化，用来解释指标波动。

导出

看板支持导出简版 Markdown 和全量交互式 HTML。Markdown 适合放进周报或会议纪要，HTML 适合离线发送给管理者查看。

8. 备份和安全

设置页提供本地数据库备份、恢复最新备份和重置演示数据。处理真实员工数据前，建议先备份。

备份当前库

在设置页点击“备份当前库”。备份文件会保存在本机应用数据目录。

恢复最新备份

如果导入错了或看板异常，可以恢复最新一次备份。

重置演示数据

只想体验时使用。注意它会把演示库恢复到内置数据，不要在真实库上随意点击。

真实数据建议： 第一次正式使用时，先用脱敏版员工快照跑完整流程。确认字段映射、指标口径和导出结果都符合预期后，再导入真实数据。

9. 常见问题

页面打不开

先重新打开应用。应用需要启动本地服务，如果服务还没准备好，浏览器可能暂时打不开。

页面打开了，但提示 API 未连接

退出应用后重新打开。如果是 Codex 调试模式，确认后端服务还在运行，并且前端 API 端口指向正确。

导入按钮不可用或导入未解锁

去设置页保存模型配置，并点击测试连接。测试成功后再回到导入审核。

模型连接测试失败

  • 检查 API Base URL 是否按你的模型服务商要求填写；如果服务商提供兼容接口，通常会包含 /v1。
  • 检查 API Key 是否复制完整，前后不要多空格。
  • 检查模型名称是否是服务商支持的真实名称。
  • 检查电脑网络是否能访问模型服务。

字段映射错了

在“字段映射”表格里手动选择正确标准字段，然后点击“保存映射”。系统会根据你的映射重新审核。

指标看起来不对

优先检查三个地方：员工ID是否稳定、在职状态口径是否一致、快照日期是否填对。其次检查部门名称是否前后统一。

macOS 仍然提示安全拦截

确认下载的是 signed/notarized DMG，文件名为 hr-pulse-dashboard-macos-signed-notarized-v0.1.0.dmg，并核对页面上的 SHA256。

10. 小白验收清单

第一次使用时，按下面清单逐项打勾。全部完成后，再正式导入真实员工数据。

  • 我已经从正式下载页下载安装包。
  • 应用能打开，并且浏览器里能看到人力脉搏驾驶舱页面。
  • 设置页里的模型配置已经保存。
  • 模型连接测试已经成功，页面显示模型已就绪。
  • 我知道员工快照必须是全量花名册，不是只上传变化人员。
  • 我已经用脱敏数据或演示数据跑通过一次导入。
  • 字段映射里，员工ID、部门、状态、入职日期这些关键字段是正确的。
  • 审核队列里的高风险和阻塞问题都已经处理。
  • 确认入库后，看板能显示人数、变化和管理摘要。
  • 正式导入前，我已经做过一次本地备份。