01两个插件不是替代关系
名字都带「多猎 AI」,但一个在对话框里动脑,一个在别人家的网页上动手。分开看都缺一半,合起来才是一条完整链路。
会对话的大脑
侧边栏形态,一个输入框 + 13 条快捷指令 + 4 个具名子 agent。方法论不写在客户端,全部由服务端在指令入口处注入提示词。能做的是:解释职位、写邀约、写推荐理由、评估离职风险、辅导面试、发起寻访、查询会话与简历。
后端 api-rcn.duolie.com · 服务数 29 · 核心对象 会话、消息、指令、人才库
会采集的手
常驻页面的浮层,不参与对话。它做的是:在 28 个受支持的外部招聘网站上读页面,把简历解析成结构化字段,跟库里查重,入库,取云电话,绑附件。没有提示词,没有方法论,只有管道。
后端 api-plugin.duolie.com · 服务数 30 · 核心对象 解析任务、简历、收藏夹、电话
www.duolie.com,一次登录两边同时可用。反过来也成立:任何一边触发单点互踢(错误码 -1701),另一边立刻失效。
02运行时:五个后端,一套请求规矩
两个插件在浏览器里都不执行自己的界面,能力全部在后端。所以「用插件」这件事,实质是在登录态下直接对后端发请求。
| 域名 | 归属 | 承担什么 | 实测状态 |
|---|---|---|---|
api-rcn.duolie.com | 小易 | 会话、消息、指令、卡片、人才库检索、简历详情、自定义指令配置 | 主通道 |
api-plugin.duolie.com | 小助手 | 外站白名单、解析、查重、入库、云电话、收藏夹、职位池、埋点 | 主通道 |
api-h.liepin.com | 职聊 | 猎聘 H 端会话、消息历史、会话内简历原文 | 读侧可用 |
api-im.duolie.com | 连接 | 插件的 socket 配置入口 | web 域 404 |
tdoss.duolie.com | 文件 | 上传、下载、附件地址 | 可用 |
请求的四条硬规矩
- 必须同源。请求从对应后端自己的域发出,跨域直接失败。
- 先预热。进页面后先
fetch('/')一次,跳过这步必回-1400。 - 头要齐。表单编码 +
X-Client-Type: web+X-Fscp-*全套 + 现生成的X-Fscp-Trace-Id;小助手多一个X-Alt-Plugin-Version: 1.5.3,缺了回800006。 - 错误码分三类。
-1400头不全、-1701别处登录、700000/0003参数非法。看到-1701不要重试,去重新登录。
03能力分层:从输入到回写
把两个插件的能力放在一条纵向链路上看,分六层。小易占第 2、3 层最重,小助手占第 5 层最重,第 4 层两边都碰。
imId / oppositeImId / payload.bodies),消息体自带 extType 区分文本、图片、指令、卡片。get-at-suggest(客户/职位两桶)、人才库搜索、简历详情。小助手:职位池分页、收藏夹清单、库内查重。检索的主力在小易侧的人才库接口,小助手只做职位与收藏夹。04小易:六个能力面
29 个服务归成六面。方法论那部分(指令体系、七份模板的文本构造)已单独成篇,这里只讲能力边界和可编程的部分。
对话与消息
建会话、删会话、发消息、读消息全套打通。发消息走 send-push-batch,消息体是一个 JSON 字符串,bodies[0].type 支持文本 / 文件 / 图片 / 站点链接。stop-chat 可随时掐断生成,feedback-ai-msg 点赞点踩(feedback 传 1 赞、0 踩、null 清除)。
指令体系
13 条官方指令,get-ai-command-list 拿全集、get-command-info 拿单条提示词全文。接口可直接触发:消息体换成 {commandContent, commandIdEncode, commandIcon},extType 置 3。这就是「同一句话,走指令和走自由对话输出完全不同」的原因。
检索与详情
get-at-suggest 只搜客户与职位(简历桶恒空,别当候选人搜索用)。真正的候选人检索走人才库 my-talent-library,关键词 + 年龄/年限/学历/薪资/城市/有电话/排除看过组合筛选,再按 resIdEncode 取详情。
卡片渲染
get-card-content 传 modelKey + param,返回的是服务端拼好的 HTML 字符串,按钮写成自定义标签 <xuanji-button>。已实测 job_card 与 order_card_v2 两个模板。
自定义指令(可编程)
建档 → 列配置 → 删档全部走接口:save-command-info(saveCommandInfoVo)→ get-user-command-config-list(commandGroup 必填 0/1/2/3)→ delete-command-info。commandContent 上限 8 字、commandPrompt 上限 1000 字、shareType=0 只落自己账号。
文件与平台
文件走 tdoss auth-upload → analysis-file → get-analysis-file-result,这条链只回解析状态不回正文。download-url 给文件下载地址。平台侧还有升级检查、新手引导状态、用户反馈。
get-jump-agent-config(自动化任务)九种参数组合全回 -1,服务端只在收到 MQTT 事件后才调它;get-socket-conf 在 web 域是 404,socket 配置实际由 get-im-info-v2 的 socketConf 一并下发。这两个不是参数没猜对,是设计上就不给外部发起。
05小助手:一条采集管道
30 个服务里,真正干活的只有一条链:读页面 → 解析 → 查重 → 入库 → 取号。其余是配置、埋点和外呼。
apply-parse 提交正文 → get-parse-result 取结构化字段get-repeat-resume,命中回 code=8 精准重复save-resume-4plugin 拿进程 key → 轮询到 code=2三个必须知道的实现细节
- 入库是异步任务。提交只回一个
saveResProcessKey和code:3,必须再轮询get-save-resume-result-4plugin到code:2才算成功,成功才返回新的resIdEncode。中间任何一步断了,库里就是没有。 - 查重命中是服务端指令,不是点击造成的。回
code=8 / msg="精准重复"+autoUpdateLibraryFlag=1+repeatVos[{resIdEncode,type:"2"}]。面板那句「发现重复简历且更新」是这句话渲染出来的。 - 取号走
voice-record-lp,不走get-privacy-phone。后者在本账号回900403 暂无权限,是旧路径。取号 24 小时有效,每次都是新号。
其余能力面
| 面 | 接口 | 能做什么 |
|---|---|---|
| 职位池 | search-recommend-job-list | 50 条/页,queryType=1/2 是两个不同池子,不支持关键词(服务端忽略) |
| 收藏夹 | get-talent-collect-catalog-4plugin | 回真实收藏夹与简历数,字段 resumeCollectCatalogIdEncode;加收藏要这个 ID |
| 沟通记录 | save-communicate | {resIdEncode, content} 直接写成功,是唯一纯简历 ID 就能写成功的沟通类接口 |
| 附件 | save-attach-4plugin | 把 PDF 绑到已有 resIdEncode 上 |
| 配置 | get/save-plugin-user-define-config | 8 个开关;save 传空 VO 也回成功且不会清空原值 |
| 解析配置 | get-plugin-parse-config | 关键是 urlCode(如 h.liepin.com/resume/showresumedetail),回 {needRefresh, configVer} |
| 号码格式 | get-tel-config | 回各国手机号正则表,判号码格式可直接用这份 |
| 观测 | get-plugin-monitor-config / plugin-monitor / monitor-statistics | 三条全部可调,空参也不报错 |
add-talent-collect 参数能被接受但回「添加失败」,推测还要插件解析出的 VO 上下文,纯简历 ID 不够;add-calllist 四种参数组合全回 0003;labels-suggest-4plugin 恒回 -1。这三条要真正跑通,得在页面里带真实上下文触发,不适合脚本硬拼。
06接口地图:59 条逐个实跑
状态口径:通 返回 flag:1 且数据可用;半通 参数契约成立但业务没走完;不通 技术上无法外部发起;不参与 功能关闭或本技能明确不碰。
小易 29 个 · 24 通 / 3 半通 / 2 不通
服务名(/api/ 后) | 能干什么 | 参数要点 | 状态 |
|---|---|---|---|
xuanji.get-user-info | 身份与权益 | 空参 | 通 |
xuanji.get-xuanji-upgrade-info | 版本检查 | 空参,回 latestVersion | 通 |
xuanji.submit-user-feedback | 提交反馈 | feedback + imageList(JSON) | 通 |
agent.get-history-conversation-list | 会话列表 | 空参 | 通 |
agent.create-conversation | 新建会话 | 空参 | 通 |
agent.delete-history-conversation | 删会话 | conversationIdEncode | 通 |
agent.get-at-suggest | @ 联想客户/职位 | keyword;简历桶恒空 | 通 |
agent.get-ai-command-list | 13 条官方指令 | fileId + keyword | 通 |
agent.get-card-content | 卡片渲染 | modelKey + param | 通 |
agent.get-jump-agent-config | 自动化任务 | 九种组合全 -1 | 不通 |
agent.analysis-file | 文件解析 | 先 auth-upload | 通 |
agent.get-analysis-file-result | 取解析状态 | 按 key 查 | 通 |
agent.stop-chat | 中断生成 | conversationIdEncode | 通 |
agent.feedback-ai-msg | 点赞点踩 | msgId + feedback 1/0/null | 通 |
config.get-command-info | 指令详情(含提示词) | commandIdEncode | 通 |
config.save-command-info | 新建/修改指令 | saveCommandInfoVo | 通 |
config.delete-command-info | 删指令 | commandIdEncode | 通 |
config.get-user-command-config-list | 指令配置列表 | commandGroup 0/1/2/3 | 通 |
config.save-user-command-config | 显隐与排序 | saveUserCommandConfigVo | 通 |
im.get-im-info-v2 | IM 身份 + socket 配置 | imUserType=3 | 通 |
im.get-opposite-im-info | 会话对端 | oppositeUserIdEncode | 通 |
im.get-chat-list | 消息历史 | 要用对端 imId | 通 |
im.send-push-batch | 发消息 | imSendMsgVoList | 通 |
im.get-atmsg-config | @ 标签跳转配置 | scene=0 + params{id,kind} | 半通 |
platform.get-guided4novice | 新手引导内容 | scene=copilot-version-1.0.0 | 通 |
platform.has-guided4novice | 是否看过引导 | 同上 | 通 |
common.file.download-url | 文件下载地址 | fileId+scene+sceneObjId | 半通 |
cbp.socket.get-socket-conf | socket 配置 | web 域 404,功能已由 IM 身份接口覆盖 | 不通 |
rcnresume.get-resume-summaries | 批量简历摘要 | resIdEncodeList(JSON) | 半通 |
小助手 30 个 · 20 通 / 4 半通 / 6 不参与
服务名(/api/ 后) | 能干什么 | 参数要点 | 状态 |
|---|---|---|---|
plugin.v2.get-plugin-user-define-config | 8 个开关 | 空参 | 通 |
plugin.v2.save-plugin-user-define-config | 改开关 | userConfVo;空 VO 不清值 | 通 |
plugin.v2.get-plugin-white-url-list | 28 个支持点位 | 空参 | 通 |
plugin.v2.apply-parse | 提交解析 | 需先上传拿标识 | 通 |
plugin.v3.get-parse-result | 取解析结果 | pluginParseVo | 通 |
plugin.v3.get-repeat-resume | 库内查重 | resIdEncode + type=2 | 通 |
plugin.v3.save-resume-4plugin | 入库(异步第一段) | 回 saveResProcessKey | 通 |
plugin.v2.get-save-resume-result-4plugin | 入库结果轮询 | 3 处理中 / 2 成功 | 通 |
plugin.v3.voice-record-lp | 取云电话 | 仅 resIdEncode,24h 有效 | 通 |
plugin.v3.get-privacy-phone | 旧取号路径 | 900403 暂无权限 | 半通 |
plugin.v3.save-attach-4plugin | 绑附件 | 需先有 resIdEncode | 通 |
plugin.v3.search-recommend-job-list | 职位池分页 | queryType + curPage | 通 |
plugin.v2.add-talent-collect | 加收藏夹 | 要收藏夹 ID,纯简历 ID 回添加失败 | 半通 |
plugin.v2.add-calllist | 加电话清单 | 四种组合全 0003 | 半通 |
plugin.v2.save-communicate | 写沟通记录 | {resIdEncode, content} | 通 |
plugin.labels-suggest-4plugin | 标签建议 | 恒 -1 | 不通 |
plugin.v3.get-plugin-parse-config | 解析配置 | 关键是 urlCode | 通 |
plugin.v3.get-plugin-monitor-config | 埋点配置 | 空参 | 通 |
plugin.v3.plugin-monitor | 埋点上报 | 空参也回成功 | 通 |
rcnresume.monitor-statistics | 埋点统计 | 回 data:0 | 通 |
rcnresume.get-resume-info-config | 字段校验配置 | 空参 | 通 |
rcnresume.get-talent-collect-catalog-4plugin | 收藏夹清单 | 字段 resumeCollectCatalogIdEncode | 通 |
rcn.plugin.get-plugin-upgrade-info | 插件升级 | 现 1.5.3 | 通 |
cbp.touchway.get-tel-config | 手机号正则表 | 空参 | 通 |
plugin.v3.batch-auto-save | 批量入库 | pluginParseVoList;空列表空操作 | 半通 |
plugin.v2.user-feedback | 反馈 | — | 不参与 |
plugin.v3.voice-record | 普通取号 | 已被 lp 版取代 | 不参与 |
plugin.v3.call | 外呼 | 功能关闭 | 不参与 |
plugin.v3.call-lp | 外呼(猎聘号) | 功能关闭 | 不参与 |
plugin.v3.call.switch-type | 外呼切换 | 功能关闭 | 不参与 |
07六张关键契约
这六条是「知道了就能少踩坑」的部分,也是最容易被误判的地方。
① extType 决定消息怎么渲染
COMMON=1 普通文本 / IMAGE=2 图片 / AI_COMMAND=3 指令 / CARD=4 卡片 / TOOL_CALL=6 工具调用。发指令就是 extType=3,卡片消息 extType=4 的 msg 里带 modelKey 和 param。
② 指令消息体长什么样
bodies[0].msg 换成 {"commandContent":"推荐理由","commandIdEncode":"…","commandIcon":""},其余结构不变。13 条指令的 commandIdEncode 已全部落表,可以脚本化复测任何一条方法论。
③ 卡片是服务端 HTML
不是前端模板。返回一串带内联样式的 HTML,按钮是自定义标签 <xuanji-button type="primary" href="…" target="_blank">。要做同形态卡片,前端只需实现这个标签的渲染器。
④ 自定义指令可编程
建档 → 列配置 → 删档全走接口,shareType=0 只在自己账号生效。这是把内部方法论灌进小易输入框的唯一正路,不用改客户端。
⑤ 入库是异步两段,不是一次调用
提交只拿进程 key,必须轮询到 code=2 才算成功,成功时才有新的 resIdEncode。中途断了库里就是空的,别当成「提交成功=入库成功」。
⑥ 查重命中是服务端判断
回 code=8 / msg="精准重复" 时说明库里有同一个人,同时给 repeatVos 里的 resIdEncode 和 type:"2"。面板上的「发现重复简历」只是这句话的渲染结果。
08三条组合链路
单个接口只是零件,真正省时间的是把两边接起来。三条已验证的链路,都是接口层直接跑通的。
链路 A:外部简历 → 入库 → 出推荐
- 小助手确认目标站点在 28 个白名单里(
get-plugin-white-url-list)。 - 读页面正文 →
apply-parse→get-parse-result拿结构化字段。 get-repeat-resume查重,命中就比对差异,不命中走入库。save-resume-4plugin+ 轮询get-save-resume-result-4plugin到code=2。- 把
resIdEncode交给小易,用「推荐理由」指令生成推荐文本。
链路 B:人才库找人 → 读详情 → 会话里推
- 小易侧
my-talent-library按条件检索,拿resIdEncode列表。 - 按人取
get-resume-detail,工作段rwDuty是真正的职责原文。 - 需要电话就先
voice-record-lp取号(24 小时有效)。 - 回到小易会话,把职位 + 候选人要点发进对话,让方法论模板产出邀约或推荐。
链路 C:把内部方法论固化成一条指令
- 用
save-command-info建一条私有指令,commandPrompt写内部口径(1000 字以内)。 get-command-info回读确认全文落库。- 之后在任何会话里用指令入口触发,输出结构就被这套口径约束住了。
- 口径要改:
save-command-info覆盖,或delete-command-info删掉重建。
09边界与红线
这套能力能做的事比插件界面多,所以边界要写清楚。以下不是建议,是默认值。
- 登录只由本人完成。不代填账号密码、不复用 Cookie、不导出会话令牌。看到登录页就交给用户。
- 写回库前要确认。入库、加收藏夹、写沟通记录、改配置都会真实落在账号里,没有删除接口的(如沟通记录)尤其要谨慎。
- 不碰外呼。三条外呼接口功能本身是关的,也不在本能力范围。
- 采集有节流。人才库检索串行、按
resIdEncode去重、单日取号有上限;批量抓取他人站点前用户须在场知情。 - 联系方式只用于本次沟通。不导出、不写公开文档、不进群。
- 提示词与方法论属对方资产。本文只做结构与机制层面的说明,页面不贴提示词全文。
10复现方法与版本
想自己跑一遍,需要的东西不多,但顺序不能乱。
- 打开
www.duolie.com登录,确认两边的接口都返回flag:1。 - 两个后端各停一个同源标签:
api-rcn.duolie.com与api-plugin.duolie.com。 - 先
fetch('/',{credentials:'include'})预热,再逐条 POST。 - 批量跑的时候把原始响应存进
window的字典再逐个取,不要在请求回调里截断后直接解析——半个 JSON 会解析失败。