Talent AI · 产品帮助中心
CUSTOMER GUIDE

Talent OS 客户帮助中心

覆盖猎头工厂与招聘工厂 HR 版：从安装、激活、协同通道配置，到 AI Agent 任务流、人才库、洞察预警和案例说明，帮助客户快速用起来。

下载与安装Mac M 系列、Mac Intel、Windows 系统设置飞书、企微、钉钉、工作区 AI Agent 任务画像、确认搜索、自动入库 案例说明日报、GitHub、人才洞察

Talent OS 客户操作手册

版本：猎头工厂 v1.4.56 / v1.4.57-beta.2，招聘工厂 HR 版 v1.4.57 / v1.4.57-beta.0 适用

适用对象：猎头负责人、RPO 团队、企业 HR、HRBP、招聘经理、招聘 COE、业务面试官协同团队

1. 两个版本分别适合谁

Talent OS 当前提供两条产品线：猎头工厂面向猎头/RPO 的客户交付闭环；招聘工厂 HR 版面向企业内部 HR 的用人需求、候选人搜寻、招聘协同、进度预警和人才资产运营。两者共享最新 Agent 框架，但业务语境不同。

猎头工厂更适合：猎头顾问、RPO、交付型招聘团队，需要推荐报告、Shortlist、客户周报、客户反馈闭环。

招聘工厂 HR 版更适合：企业 HR、HRBP、招聘 COE，需要岗位 Intake、用人经理协同、企业人才库沉淀、招聘日报/周报、人才资产洞察、历史人才再激活。

你可以用它完成：

2. 下载与安装

打开下载页：

https://talent-ai.com.cn/downloads-page/

猎头/RPO 客户选择“猎头版”；企业 HR 客户选择“招聘工厂 HR 版”。

招聘工厂 HR 版当前稳定版为 v1.4.57，覆盖 Mac M 系列、Mac Intel 和 Windows；HR 内测版仅保留 Mac M 系列 v1.4.57-beta.0，用于功能验证。

Mac 用户

请先确认电脑芯片：

  1. 点击左上角苹果菜单。
  2. 点击“关于本机”。
  3. 如果显示 Apple M1/M2/M3/M4，下载“Mac M 系列 / Apple Silicon”版本。
  4. 如果显示 Intel，下载“Mac Intel 芯片”版本。

安装步骤：

  1. 双击下载的 DMG 文件。
  2. 将对应 App 拖入“应用程序”文件夹：猎头版为“猎头工厂.app”，HR 版为“招聘工厂.app”。
  3. 推出磁盘映像。
  4. 从“应用程序”中打开对应 App。
  5. 如提示“无法验证开发者”，请按住 Control 键点击 App，选择“打开”；或前往“系统设置 → 隐私与安全性”点击“仍要打开”。

Windows 用户

  1. 按产品下载对应 Windows 便携版 ZIP：猎头版为“猎头工厂”，HR 版为“招聘工厂”。
  2. 解压到固定文件夹。
  3. 打开文件夹，猎头版双击“猎头工厂.exe”，HR 版双击“招聘工厂.exe”。
  4. 如出现 SmartScreen，点击“更多信息 → 仍要运行”。
  5. 如文件属性里有“解除锁定”，请勾选后再运行。

3. 第一次使用建议流程

建议按以下顺序配置：

  1. 打开“激活与工作区”，完成试用或激活。
  2. 打开“系统设置”，按渠道配置群机器人、人才库链接和标准人才库。
  3. 打开“渠道与群”，确认猎聘、GitHub、简历文件夹、邮箱等渠道；HR 版重点绑定企业人才库、ATS/API 和用人经理协同群。
  4. 回到“AI 助手主页”，输入招聘目标，让 AI 帮你生成画像和搜索策略。
  5. 确认后启动搜索。
  6. 到“人才库”查看入库结果和人才资产 Dashboard。
  7. 到“报告与洞察/洞察预警”生成日报、周报、人才资产洞察或风险改进计划。

4. 系统设置

点击左下角“系统设置”。

系统设置按渠道折叠展示，主要包括：

人才库初始化

v1.4.13 起，建议优先使用“标准人才库”思路：

  1. 飞书客户：如企业已经安装并授权“猎头工厂”应用，可点击“授权并创建标准人才库”。
  2. 外部客户如提示“没有猎头工厂的使用权限”，说明当前飞书应用尚未以第三方应用形式安装到该企业。此时可先粘贴客户自己的多维表格链接，或使用猎头工厂缓存区。
  3. 企微、钉钉客户：优先配置群机器人和智能表格/AI 表格链接。若平台授权暂未完成，搜索结果会先进入缓存区，避免候选人丢失。

配置完成后，建议点击对应渠道的“检查接入”按钮。系统会发送测试消息或给出诊断提示，确认后再开始正式搜索。

飞书商店应用模式

面向客户交付时，推荐使用“猎头工厂”飞书商店应用。客户不需要自己设计多维表格字段，也不需要创建自建应用：

  1. 客户在飞书应用中心安装“猎头工厂”。
  2. 在猎头工厂客户端点击“授权并创建标准人才库”。
  3. 客户同意授权后，系统会在客户自己的飞书环境中创建标准人才库。
  4. 搜索结果、AI 解析、日报和人才资产洞察会继续同步到客户自己的飞书表格和协作群。

如果授权页提示“没有猎头工厂的使用权限”，说明当前使用的仍是企业自建应用模式，或客户企业尚未安装商店应用。此时请先联系管理员安装应用，或临时使用客户自己的表格链接与缓存区。

飞书群机器人

用于把搜索结果、日报、洞察推送到飞书群。

配置方式：

  1. 打开目标飞书群。
  2. 进入群设置。
  3. 添加群机器人。
  4. 复制 Webhook 地址。
  5. 粘贴到猎头工厂“飞书群机器人”输入框。
  6. 点击“测试”。

飞书自建应用

用于读取和写入客户自己的飞书多维表格。

你需要在飞书开放平台创建企业自建应用，并准备：

建议开通权限：

配置完成后，猎头工厂可以将候选人写入客户自己的多维表格，而不是只保存在猎头工厂缓存区。

飞书人才库多维表格

如果你已经有自己的飞书人才库，请将多维表格链接粘贴到“飞书人才库多维表格”。

链接示例：

https://xxx.feishu.cn/base/appxxxx?table=tblxxxx&view=vewxxxx

系统会自动识别：

如果写入失败，系统会尽量返回飞书 API 的真实原因，例如字段类型不匹配、URL 字段格式错误、权限不足等。

5. AI 助手主页

AI 助手主页是推荐的起点。

你可以输入自然语言，例如：

我想找腾讯 AI产品经理 深圳 50人，偏大模型应用和 ToB 产品经验

AI 会先整理成：

如果你回复“确认”，系统会直接启动搜索，并按当前开启的渠道入库和推送。

如果信息不足，例如只输入“生成人才画像”，AI 会先追问：

6. 候选人搜索

点击“候选人搜索”。

可配置：

搜索完成后，系统会：

  1. 抓取候选人结果。
  2. 生成 CSV。
  3. 写入人才库。
  4. 推送结果摘要到已开启的群。
  5. 在底部日志中显示每一步结果。

注意：

7. 渠道与群

点击“渠道与群”，可以配置更多搜寻和入库来源。

猎聘搜索

用于搜索猎聘候选人。首次使用需要登录猎聘账号。

简历自动入库

支持监听本地简历文件夹。

适用场景：

邮箱简历监听

可配置 IMAP 邮箱，用于识别投递邮件和附件。

GitHub 搜索

适合技术岗位和海外人才。

建议输入更偏英文或技术栈的关键词，例如：

LLM researcher Shenzhen
NLP engineer recommendation system
AI product manager agent workflow

如果中文关键词搜索不到，系统会尝试扩展成英文查询，但 GitHub 用户资料以英文为主，仍建议补充技术栈、城市英文名或目标公司。

8. 人才库

点击“人才库”。

人才库不是简单列表，而是人才资产 Dashboard。

你可以看到：

如果配置了飞书多维表格，系统会优先显示并写入客户自己的飞书人才库。

9. 报告与洞察

点击“报告与洞察”。

主要功能：

支持的数据基座包括：

猎头工厂定位为客户交付作战入口；招聘工厂 HR 版定位为企业内部招聘作战入口。企业自己的 ATS、飞书表格或人才主库保留人才主数据所有权，客户端负责索引、协同和行动推进。

ATS / 自研平台同步

在“报告与洞察 → ATS / 人才数据基座”中，可以登记北森、Moka 或自研 ATS/API 地址。

当前支持的通用拉取格式：

[
  {"name": "张三", "company": "腾讯", "position": "AI 产品经理", "location": "深圳"}
]

也支持：

{"candidates": [...]}
{"data": [...]}
{"items": [...]}
{"rows": [...]}

配置 API Token/Key 后，客户端不会回显密钥。点击“立即同步数据源”后，系统会拉取候选人、标准化字段、写入本地缓存区，并在已绑定飞书多维表格时同步到企业自己的飞书人才库。同步结果会记录到同步日志，失败时会返回具体原因，便于联调北森、Moka 或自研平台。

10. 定时任务

点击“定时任务”。

可以设置最多 5 个自动搜索任务。

适合：

客户端运行时，到点会自动执行搜索、推送结果速览并同步入库。

BOSS 直聘渠道说明

BOSS 直聘渠道采用“受控辅助模式”，不是无限制自动抓取。

推荐使用方式：

  1. 客户使用自己的 BOSS 企业账号登录。
  2. 在 BOSS 企业后台完成岗位、城市、筛选条件设置。
  3. 猎头工厂打开 BOSS 后台链接，辅助用户解析当前可见页面或手动导入候选人。
  4. 解析后写入猎头工厂缓存区，并按配置同步到飞书多维表格、企微智能表格、钉钉 AI 表格或 ATS/API。

风险控制原则：

ATS/API 事件接口

Talent OS 为招聘工厂 HR 版、猎头工厂和企业自研平台预留标准事件接口：

POST /api/workspace/{client_id}/ats-webhook

事件类型：

候选人字段建议：

{
  "event": "search_preview",
  "keyword": "AI 产品经理 深圳",
  "preview": "候选人摘要",
  "candidates": [
    {
      "name": "张三",
      "company": "腾讯",
      "position": "AI 产品经理",
      "location": "深圳",
      "phone": "",
      "email": "",
      "source": "boss",
      "status": "新候选人",
      "note": "",
      "link": ""
    }
  ]
}

如果在“报告与洞察 → ATS / 人才数据基座”中配置了北森、Moka 或自研 API 地址，招聘工厂 HR 版会把上述事件转发到企业内部平台；未配置时会记录同步日志并提示下一步配置。

11. 常见问题

搜索结果显示推送成功，但飞书表格没有新增

请检查：

  1. 系统设置里是否填写了正确的飞书多维表格链接。
  2. 飞书自建应用是否有多维表格读写权限。
  3. 多维表格字段类型是否兼容，例如 URL 字段需要写入链接格式。
  4. 日志中是否出现飞书 API 返回的具体错误。

新版客户端会在“系统设置”和“人才库”中显示配置诊断；写入飞书前也会读取客户表字段，优先复用“公司/职位/来源/状态”等已有字段，缺少关键字段时会尝试自动创建。若自动创建失败，系统会明确提示缺少哪个字段或权限。

Mac 提示应用已损坏或无法打开

通常是 macOS 安全策略导致。

请尝试：

  1. 确认下载了正确芯片版本。
  2. 将 App 拖入“应用程序”后再打开。
  3. 按住 Control 点击 App，选择“打开”。
  4. 前往“系统设置 → 隐私与安全性”点击“仍要打开”。

GitHub 搜不到结果

常见原因：

建议改成：

LLM NLP Shenzhen
AI researcher transformer
recommendation system engineer China

飞书群能推送，但不能写表

飞书群机器人 Webhook 只能发消息，不能读写多维表格。

要写入飞书多维表格，需要配置飞书自建应用 App ID、App Secret，并粘贴目标多维表格链接。

12. 使用案例

案例一：搜索 AI 产品经理

输入：

腾讯 AI产品经理 深圳 50人，偏大模型应用和 ToB 产品经验

AI 会生成：

回复：

确认

系统会自动启动搜索，完成候选人入库和群推送。

案例二：生成今日猎头日报

在 AI 助手输入：

生成今天的猎头日报

系统会读取人才库数据，生成日报链接，并推送到已配置的协作群。

日报包含：

案例三：基于简历文件夹自动入库

适合场景：

HR 每天收到大量 PDF/Word 简历，不想手动录入。

操作：

  1. 打开“渠道与群”。
  2. 选择本地简历文件夹。
  3. 点击“开始监听”。
  4. 将简历放入该文件夹。
  5. 系统自动解析并进入人才库。

案例四：人才资产洞察

打开“报告与洞察”，点击“人才资产洞察”。

系统会生成：

并推送到协作群。

案例五：GitHub 技术人才搜索

输入：

LLM researcher Shenzhen

或：

NLP engineer recommendation system China

系统会搜索 GitHub 用户，并沉淀开源活跃度、关键词和搜索链接。

如果输入中文岗位，例如：

大模型研究员 深圳

系统会自动扩展为 LLM researcher location:Shenzhen、NLP researcher、machine learning engineer location:China 等英文查询，并在日志中显示实际查询、命中数量和 API 额度。如果配置了飞书多维表格，GitHub 人选也会同步写入客户自己的飞书人才库。

13. 推荐客户内部使用方式

建议客户建立一个“猎头工厂协作群”，群内包含：

推荐节奏：

这样猎头工厂会逐步学习客户偏好，后续搜索和推荐会越来越贴近实际需求。

14. 作为 talent-ai 子站持续更新的评估

建议将本手册建设为 talent-ai 的客户帮助子站，例如：

https://recruitment.talent-ai.com.cn/help/
https://talent-ai.com.cn/recruitment-factory/help/

可行性判断：适合建设，而且建议持续维护。原因如下：

建议子站栏目：

  1. 快速开始：下载、安装、激活、首次配置。
  2. 系统设置：飞书、企微、钉钉、服务端、WebSocket。
  3. 飞书多维表格：自建应用、权限、表格链接、字段映射、错误排查。
  4. AI 猎头任务流：职位/JD、人才画像、确认搜索、入库推送。
  5. 渠道配置：猎聘、GitHub、简历文件夹、邮箱。
  6. 人才库与报告：Dashboard、日报、周报、洞察、预警。
  7. 案例库：AI 产品经理、算法工程师、HRD、销售负责人、海外技术人才。
  8. 常见问题：安装拦截、权限不足、入库失败、搜索无结果。
  9. 版本说明：稳定版、内测版、Mac M 系列、Mac Intel、Windows。

推荐维护方式：