运行前准备

开始前先确认以下条件。准备充分可以避免采集到错误店铺、错误员工或错误日期的数据。

• 使用 Windows 电脑，并在当前项目中安装好本 Skill。
• 电脑控制能力已经启用，环境检查结果应显示 ready: true。
• 千牛客户端已经打开并完成登录，最好提前进入“聊天记录查询”页面。
• 准备准确的店铺名称、员工账号和起止日期；单次查询跨度不超过三个月。
• 员工账号是需要采集和质检的客服账号，不要把当前登录账号误当成查询账号。

选择工作模式

使用 $qianniu-chat-audit 采集当前千牛客户端中的历史聊天。

店铺名称：填写店铺名称
员工账号：填写需要查询的员工账号
查询日期：2026-08-01 至 2026-08-31

只生成历史聊天 XLSX，不执行客服话术质检。遇到登录或安全验证时暂停，让我手动处理。

运行过程中如何配合

1. 1

   Codex 开始采集后，不要同时点击千牛的员工或买家列表，避免当前会话发生变化。

2. 2

   出现登录页、扫码、验证码、滑块或安全提示时，由本人手动处理。

3. 3

   处理完成后，在对话中回复“已经处理完成，请继续”。

4. 4

   如果提示窗口消失或店铺不一致，先恢复正确的千牛窗口，再让 Codex 继续。

5. 5

   采集量较大时可以中断。Skill 会维护检查点，后续可以继续未完成的会话。

中断后继续

重新开始前，应保持店铺、员工账号和查询日期与上一次一致，然后发送下面的指令。

继续上一次 $qianniu-chat-audit 采集任务。请读取现有检查点，从尚未完成的员工账号和买家会话继续，不要重复采集已经完成的内容。

理解导出结果

完成后的人工检查

• Excel 文件可以正常打开。
• 店铺、员工账号和日期范围正确。
• 会话数和消息数没有异常为零。
• 执行质检时包含四张质检工作表。
• 质检概览标明 v1.0 和“待人工复核”。
• 严重违规候选已经安排人工确认。

如果结果为零，只能视为“无结果或待核查”。应检查账号、日期、筛选条件和聊天记录是否完全加载，不能直接认定员工没有历史聊天。