first commit

2026-09-02 11:44:52 +08:00
commit 0c8fa2653e
309 changed files with 57278 additions and 0 deletions
@@ -0,0 +1,67 @@
+# Hrbrain（组织大脑）
+
+> 本文件为 `dingtalk-misc` 内组织大脑产品入口。命令前缀：`dws hrbrain`。Distinct from `dingtalk-contact`（通讯录/组织架构）、考勤（本包 `attendance.md`）。
+
+## 产品说明
+
+Hrbrain 是钉钉组织大脑，提供人才池管理、员工档案查询、人才搜索三大能力。
+
+**CLI 前缀**: `dws hrbrain`
+
+## 命令总览
+
+### talent-pool (人才池管理)
+
+| 命令 | 用途 | 必填参数 | 备注 |
+|------|------|----------|------|
+| `talent-pool list` | 查询人才池列表 | - | 可选 `--keyword`、`--pool-type`、`--creator`、`--labels`（逗号分隔）、`--page`、`--page-size` |
+| `talent-pool detail` | 获取人才池详情 | `--pool-code` | - |
+| `talent-pool employees` | 查询人才池内人员列表 | `--pool-code` | 可选 `--page`、`--page-size` |
+
+### profile (员工档案管理)
+
+| 命令 | 用途 | 必填参数 | 备注 |
+|------|------|----------|------|
+| `profile metadata` | 查询员工档案元数据结构 | `--work-no` | 用于构造 `profile query` 的 `--data-queries` |
+| `profile query` | 按模块批量查询员工档案数据 | `--work-no` `--data-queries` | `--data-queries` 为 JSON 数组，每项含 `modelCode`、`fields` |
+| `profile labels` | 获取员工标签 | `--staff-ids` | 逗号分隔工号列表；可选 `--all-label` |
+| `profile career` | 查询员工公司内职业历程 | `--work-no` | - |
+| `profile performance` | 查询员工绩效记录 | `--work-no` | - |
+
+### search (人才搜索)
+
+| 命令 | 用途 | 必填参数 |
+|------|------|----------|
+| `search employees` | 人才搜索（简单条件） | - |
+| `search employees-structured` | 高级结构化搜索 | `--origin-json` `--fields` |
+| `search fields` | 获取高级搜索字段列表 | - |
+
+## 意图判断
+
+- "人才池/储备干部池" → `talent-pool list/detail/employees`
+- "员工档案/档案数据" → `profile metadata/query`
+- "员工标签" → `profile labels`
+- "职业历程/内部履历" → `profile career`
+- "绩效记录" → `profile performance`
+- "搜人/按条件找人" → `search employees`（简单）或 `search fields` + `search employees-structured`（复杂）
+
+## 常用命令
+
+```bash
+dws hrbrain talent-pool list --page 1 --page-size 20 --format json
+dws hrbrain talent-pool detail --pool-code POOL_CODE --format json
+dws hrbrain talent-pool employees --pool-code POOL_CODE --format json
+dws hrbrain profile metadata --work-no WORK_NO --format json
+dws hrbrain profile query --work-no WORK_NO --data-queries '[{"modelCode":"basic","fields":["name","dept"]}]' --format json
+dws hrbrain profile labels --staff-ids WORK_NO1,WORK_NO2 --format json
+dws hrbrain profile career --work-no WORK_NO --format json
+dws hrbrain profile performance --work-no WORK_NO --format json
+dws hrbrain search employees --keyword "张三" --format json
+dws hrbrain search fields --format json
+dws hrbrain search employees-structured --origin-json '{"rules":[{"field":"name","operator":"contains","value":"张"}],"combinator":"and"}' --fields '[{"label":"姓名","value":"name"}]' --format json
+```
+
+## 安全规则
+
+- `--data-queries`、`--fields`、`--origin-json` 必须是合法 JSON；`--staff-ids`、`--labels`、`--order-by` 是逗号分隔字符串。
+- `talent-pool list` 需要账号单独开通人才池查看权限（`errorCode=2002` 时提示用户联系管理员开通）。