咔哒首次使用与配置指南
2026-09-27，适用本轮 Windows 11 x64 内测，具体构建号以软件及下载记录为准。首次使用先双击包内《内测开始前请先看.html》。软件已提供新手引导与真实试答；尚未由全新客户在第二台电脑独立走完。当前范围与未关闭问题见《内测已知问题与反馈.md》。
“私域副驾”是唯一副驾入口。原“极简副驾”“超轻私域副驾”只是同一功能的重复叫法，现已合并；窗口展开或收起不代表不同版本。
首次设置：逐项点击完成
首次打开且没有业务配置时显示「使用引导」。已有用户从侧栏「使用引导」或副驾「使用引导 · 查看还缺哪些设置」进入。
引导显示执行模式（软件无需硬件）、文字模型、画面模型、业务资料、试答、目标窗口/会话及授权 7 项。点「去完成」打开对应页面；模型配置直接定位对应区域，知识导入直接打开导入页。每项说明填写来源及成功判断。可以「关闭详细引导」，以后随时在使用引导重新开启；关闭说明不会自动完成检查或启动任务。
集中整理散落资料
进入「业务知识库 → 我的资料源」。点击「添加本机 / Obsidian 文件夹」选择具体业务资料目录，或批量填写飞书/Notion 文档链接。一次设置后会记住原位置，后续无需重新上传文件。
勾选来源，点击「读取并整理所选资料」。每个来源单独显示进度、失败原因和新增数量，失败不会把整批说成成功。可停止后续整理；已完成候选保留。文件解析不调用模型，导入后统一在「资料导入与审核」审核并试答。
一个目录含子目录，最多100份支持的文档、32MB，单文件8MB；只读取支持的文档，跳过隐藏目录和目录链接。过大目录请按业务拆成来源。每来源单次最多300条知识。
再次整理会跳过未变化的来源与重复内容；发现变化时暂停该来源被替换的旧版本，新增内容仍需审核。移除来源不会删除已导入的知识。读取失败或存在超限文件时，本来源不会被当成完整更新；原知识记录保留，暂停用于回答。处理原因后重新整理，核对后再启用。
内测先开放资料整理，不设置付费拦截；后续商业版权限另行发布。本机与已同步的云盘目录可用；四家网盘已提供远端授权与文件选择入口；需要先配置有效的平台应用并授权，真实账号兼容性仍需逐家验收。没有应用配置时可先用本地同步文件夹，详细步骤见《网盘远端接入与管理员配置》。
在线知识库
在「业务知识库 → 连接在线知识库」选择飞书或 Notion。连接凭据由桌面系统加密，工作区导出不包含凭据。保存凭据不等于验证成功，成功读取文档预览才说明该篇文档有权限。
- 飞书：管理员创建企业自建应用，开通文档只读及知识库节点读取权限、发布应用，并给文档/知识库添加应用阅读权限。填 App ID、App Secret，粘贴新版文档或知识库文档链接。
- Notion：创建具有读取权限的内部连接，在页面 Connections 中加入该连接，填密钥并粘贴页面链接。读取正文、嵌套块和分页，子页面需单独导入。
- 两者均为主动读取的文字快照。图片、附件和数据库/表格请另行整理；源文档更新后重新读取、审核并停用旧知识，不自动覆盖。
- 网盘：可以选择已下载/同步至本机的 PDF、DOCX 等文件。四家网盘的账号授权入口在“连接网盘”，需有效应用配置；整库自动同步和通用 MCP 连接仍未提供。
没有管理员权限也可先导出文件，不妨碍使用本地知识库和试答。
导入后：在软件里完成四步
副驾点击 训练我的客服 · 导入资料与试答，或进入 业务知识库 → 新手上手与试答。
- 导入资料：先选一份产品说明或价目表；在预览中填写业务/产品名和适用客户市场。不同业务的资料分批导入，避免报价混用。
- 确认业务：核对价格、服务范围和承诺后启用。可选智能整理会补充问法与回复规则，不替换资料原文。
- 试着回答：配置回复模型后，选择本次客户市场（国内、海外、未确认），输入客户常见问题，点“试答这一个问题”，或连续试答页面推荐的5问。试答不发送客户消息，但会产生模型费用并计入试用次数。查看回答与参考资料，标记答对或需要修改；答错可直接补资料或补充问法，重新审核后再试。
- 开始辅助接待：返回副驾核对真实客户的草稿。开启自动发送仍需要单独配置窗口、会话和执行模式，不会因试答完成而自动开始。
价格只按所选客户市场提供；未确认地区时先询问，不同时给出多套报价。国内和海外价目表应分成两条资料。
试答记录保存在本机，最多保留最近50条；资料、风格或模型变更后旧试答不再计为当前通过。通过数量是人工核对记录，不代表准确率或无人值守保证。
开始前准备
准备完整软件包、一台 Windows 11 x64 电脑、可用网络，以及已开通的文字和画面识别模型。当前不需要安装本地大模型。
先选一个有权测试的会话，准备几条准确的产品/价格/服务知识。首次发送使用本人或明确同意测试的对象。电脑上保留你自己登录的目标应用，执行时将键鼠交给咔哒。
点 X 后收起到托盘，已启动任务继续运行；从托盘右键「退出咔哒」才退出。双击托盘可显示界面。
1. 启动、授权与窗口
完整解压后运行 kadadesk.exe，不要只拷贝 EXE 或在压缩包里启动。打开副驾或完整后台；查看试用/授权状态。额度不足时先联系交付方核实授权，不反复点击任务。
在副驾“跟随窗口”选择实际目标；只有一个目标仍需核对名称，窗口名字不等于聊天收件人。最小化的目标先恢复，切换实际应用版本后重新检查。
成功判断： 咔哒页面正常显示，授权可用，所选窗口存在。恢复上次窗口不代表自动开始任务。
2. 选择执行模式
在「消息监控与回复」选择软件模式或硬件模式并保存。新配置默认软件模式，无需连接硬件；旧用户的硬件配置保留。软件模式可以跳过下面的硬件连接步骤。
硬件模式：连接皮卡
插好硬件，查看“皮卡在线”；若未连接，到“系统与硬件设置”的硬件入口查看状态。当前匹配固件为0.5.0、协议4；已匹配设备不因软件升级或改名重复刷机。
成功判断： 状态明确在线且固件匹配；仅握手成功不代表已验证目标应用输入。
没有连接： 检查 USB 数据线/接口和错误提示；关闭可能占用同一设备的旧版咔哒或调试程序后再试。不把 CH9329、其他 USB 小板自动视为兼容设备。
3. 配置回复模型
使用 PixMind 的用户请先按 注册与 API 配置教程 创建密钥，再回到下方步骤。教程包含接口地址、模型选择、文字与图片测试。
进入“系统与硬件设置 → 回复生成模型（独立配置）”。选择已开通的服务商预设，填写其 Base URL、文字模型名称、你自己的密钥；预设只是快捷填写，不代表账号已获得该模型权限。点击“保存并测试文字连接”。
成功判断： 返回文字接口测试成功。它只验证文字调用，不能代替下一步的识图或真实发送。
密钥只填设置，不发给客服或贴在截图里。留空保留已保存密钥；更换供应商时，接口、模型和密钥必须属于同一套有效配置。
4. 配置画面识别模型
在设置中的画面识别区域选择服务商/协议，并填写与其对应的接口、支持图像输入的模型 ID 和密钥。国内可使用已接入的火山方舟/豆包路径，国际可使用相应已支持的 Google 等路径；按你的账号和网络选择，不根据对话语言自动决定服务商。
方舟需复制控制台实际可用的完整模型 ID 或推理接入点 ID。展示名称、任意短字符串、API 密钥和模型 ID 是不同字段。只开通图片/视频生成模型不等于获得画面理解能力。
保存后，用已授权目标执行当前场景的只读核验：WhatsApp 可在“私域副驾 → 客户跟进与内容 → WhatsApp”检查客户与最新消息。
成功判断： 不只是“密钥已设置”，而是实际窗口中的对象和消息识别正确。错误时先按文末排查，不启动自动发送。
5. 导入业务知识
进入“业务知识库 → 导入业务资料”，先用少量准确内容：公司/产品介绍、价格、交付范围、不能承诺什么。预览解析结果、核对来源、去重，审核并启用；再用“检索演练”提几个真实问题。
支持文件和聊天文本格式详见客户知识库适配指南。扫描 PDF 需先转换文本；公开单页导入不等于登录私人知识库同步。
成功判断： 启用条目内容准确，真实问题命中相关知识；过期价格和客户私人信息未误作标准答案。导入成功、检索命中和模型回答正确需分别检查。
6. 第一次回复：先看内容，再核对发送
副驾可先粘贴客户原话生成草稿，核对事实、语气与引用知识。
WhatsApp 的完整单条操作按WhatsApp快速开始：打开网页版并登录→核对指定客户→选择业务知识并准备文案→核对并审核→由 皮卡 发送一条。第一次不要同时开启多个会话任务。
执行时不抢键鼠；“皮卡 整段粘贴”由软件准备剪贴板、皮卡执行粘贴按键，再核对正文与发送。看到新增气泡和发送勾号，并与任务记录一致，才算本条通过；这不代表客户已读。
结果不明： 保留任务并查看实际会话，不直接重发。只有明确证明未尝试发送的任务，才按产品提供的恢复路径处理。
7. 再测试持续回复
为已核验的 WhatsApp 客户配置持续回复，确认仅一个启用对象、回复语言、知识和执行方式；保存后启动。首轮默认建立基线，需另一真实测试账号发送新文字，不能拿原有历史消息或主动发送冒充新来信触发。
先做三轮真实新来信，检查对象、内容、回执、无重复，再扩大时长。当前这条完整来信链路尚未验收；8/24小时、第二台电脑和异常恢复仍是后续闸门。
聊天应用与其他应用按各自版本验收范围配置，不能直接套用 WhatsApp 的输入与定位结果。
停止、备份与求助
执行前找到“立即停止”或“紧急停止全部任务”；快捷键以界面显示注册成功为准。停止后确认控制归人，不通过清空历史绕过去重。重启不会自动恢复发送任务。
通过设置导出工作区备份；备份不含密钥，迁机后需重新配置模型并核对授权。备份可能含业务资料，不公开分享。
| 现象 | 先检查 |
| 401/认证失败 | 密钥是否属于当前接口、是否失效，检查供应商返回说明 |
| 403/无权限 | 账号是否开通模型、密钥访问范围；以具体错误为准 |
| 404/模型不存在 | 完整模型ID、接口路径与协议，不是只换一个名称 |
| 429/限流或额度错误 | 供应商返回原因、余额/配额和并发，不连续重试 |
| 识图失败、超时 | 目标是否可见、模型是否真支持图片、网络及请求错误 |
| 找不到窗口或失焦 | 窗口是否重开/最小化、是否有人抢键鼠；重新核对 |
| 草稿有内容 | 先确认来源，不直接清空不明草稿 |
| 发出了但记录不确定 | 人工核对实际气泡，保留记录，不重复发送 |
提交问题时提供软件版本、Windows/目标应用版本、发生时间、操作步骤、错误文字和脱敏截图；不要包含密钥或无关客户聊天。售后联系入口由交付方在发包时明确提供，本文不虚构联系电话。
交付人员首次使用验收表
- [ ] 新客户从干净环境独立启动，授权可用；仅硬件模式检查皮卡。
- [ ] 两类模型分别验证，客户知道费用和数据去向。
- [ ] 一条业务知识审核启用并正确用于真实答复。
- [ ] 一条授权发送正确完成，客户能找到回执与停止按钮。
- [ ] 演练断连/失焦时停止、结果不明不重发。
- [ ] 客户知道备份、求助和内测边界。
以上均待在实际客户第二台电脑签录结果；本文件不预先打勾。
文件夹更新与停止整理
新增文件夹后会自动勾选，点击读取并整理，再审核与试答。重复整理同一来源会跳过未变化内容；不同来源保留各自的版本与审核状态。原文件删除后要再次整理，相关旧知识才会停用；目录完全清空也会停用该来源的旧知识。文件不可读、目录不可访问或解析失败不会当作删除，页面会提示错误；应修复或手动停用失效资料后再接待。
点击停止后，当前解析结束会检查停止状态，不再提交尚未提交的来源；此前已完成的结果保留。移除来源仍保留已导入知识，若也要停止使用知识，请在审核页停用。
自动接待新客户（桌面聊天窗口）
在“消息监控与回复 → 接待范围”选择“自动接待新消息”，不用提前添加客户姓名。默认接待未免打扰的个人会话；需要群聊时勾选“同时接待群聊”。不想接待的对象填入排除名单，一行一个完整名称。
接待范围与回复方式分开设置：选“人工复制回复”只生成草稿；选“自动回复”才会由明确选择的软件或皮卡硬件模式输入并发送。保存设置后点击“启动前确认”，核对范围与模型，再启动。本轮自动发送仅限有人值守的小范围测试。
首次扫描也会处理当前未读会话的最新来信。人工接管、结果不明、免打扰或身份不清的会话不会自动继续发送。当前只发现可见列表内、名称完整且能明确识别的会话；折叠或屏幕之外的会话尚未自动翻找。WhatsApp 网页适配目前仍使用指定对象模式。