咔哒 · kadadesk — 中文版第一版测试说明

第一次使用请先双击同目录“内测开始前请先看.html”。本轮功能范围和未关闭问题见“内测已知问题与反馈.md”；反馈可填写“内测反馈模板.txt”。更新日期：2026-09-27，构建号以软件和下载记录为准。

当前支持 Windows 11 x64。默认软件模式无需硬件；可选硬件模式使用 咔哒硬件-皮卡（RP2040）和匹配的 0.5.0 固件、协议 4。已匹配的 皮卡 无需因软件改名重新烧录。其他系统和硬件尚未完成本版验收。

开始使用
1. 完整解压后运行 kadadesk.exe，不要只复制 EXE。默认进入私域副驾，恢复上次选择的窗口和跟随方式；浏览器自动模式默认悬浮。
2. 在模型设置分别填写“回复模型”和“画面识别模型”。国内视觉可选火山方舟/豆包等云接口，国际可选 Gemini；具体模型需账户已开通。没有本地模型依赖。
3. 在“消息监控与回复 → 应用与输入”选择执行模式。默认软件模式不需要购买硬件；选择硬件模式时才需连接皮卡。旧用户保存的硬件模式保留，不会自动替换。
4. 将已获授权的客户消息粘贴到副驾，点击“意图剖析”生成草稿。已选客服风格时按该风格和已审核业务知识起草。请核对事实，再复制使用；“打开会话设置”是进入配置，不代表已写入聊天应用。
5. 当前仍是测试版。自动输入的视觉焦点识别尚有未关闭问题；模型连接、草稿生成成功不等于自动发送通过验收。

窗口与托盘
点 X 只收起到托盘，不退出进程；托盘右键可以显示咔哒、停止全部任务或退出。明确退出会先停止任务。首次启动仍需配置并确认接待，不会直接向客户发消息。
自动、靠左、靠右会在有足够空间时贴边并保持等高；两侧空间不足时暂时悬浮。手动拖动转为悬浮。目标最小化时副驾可能随目标隐藏，目标恢复后继续跟随；显式重新打开副驾可恢复显示。启动不会自动恢复回复任务。

知识库
支持 TXT、Markdown、CSV、JSON、XLSX、DOCX、文本 PDF、明确角色的聊天记录及公开 HTTPS 单页正文。聊天应用记录请使用你已合法取得的导出文件或粘贴文本，并填写双方准确昵称；不自动读取聊天应用数据库。扫描 PDF 尚未内置 OCR，请先转换为文本。
导入先预览、核对来源、去重、审核启用；只有已审核启用的知识参与起草。修改已审核事实会撤销启用并要求再审核。公开链接不含登录后的私人知识库，不代表已接入飞书/Notion/语雀账号同步。
默认单次最多 5 个文件，每个 8MB，最多 300 条。详细格式见《客户知识库适配指南.md》。

持续回复测试
选择准确且唯一的目标窗口与会话，校准列表、标题、消息、输入框和发送按钮。人工草稿模式只生成草稿；自动模式才会输入和发送。首轮通常建立消息基线。
聊天应用省流监听在本机检查消息徽标和当前消息区域变化；需要时才调用云端识图。无法看到目标或图标时会报告不可读，不把遮挡当作没有消息。
软件模式通过 Windows 键鼠和临时剪贴板操作，整段输入前后核对；硬件模式通过匹配的皮卡执行，可选整段粘贴或逐键输入。模式由用户明确选择，硬件断开不会自动切换软件模式。保持目标可见、从空白草稿开始。逐键输入需要全拼候选选择；其他输入法兼容性需分别验证。候选、会话或结果不确定时停止并交人工，不能清除不确定记录后直接重发。
设备断开、焦点变化或暂停后停止后续动作；不要把物理键鼠方式视为任何平台账号风险保证。
紧急停止：点击“紧急停止全部任务”，或在界面显示快捷键注册成功时按 Ctrl + Alt + Esc。达到小时发送上限后进入冷却，到期重新核对现场；停止或重启不会自动重放旧任务。自动任务执行期间不能切换话术或复制草稿，请先暂停再人工接手。长回复分段最多三个气泡。

本次小范围试用范围
优先验证人工副驾、知识导入和窗口跟随；自动中文输入、草稿中断恢复与长期无人值守尚未完成验收。第一次由交付人员陪同配置与记录问题，暂不用于无人看管的客户自动接待。遇到发送结果不明请保留记录、人工核对，勿重发。

配置与备份
新版继续读取原有配置和知识，不要求重新填写密钥。导出备份不包含密钥和截图。内部数据目录、接口标识和旧固件设备名称暂保留原标识，以兼容已有数据与已烧录硬件；客户界面使用“咔哒”，英文品牌为 kadadesk。

下一阶段
自然语言控制仅有规划，本轮未新增执行功能。必须先完成当前版真实发送、异常停止、去重恢复及另一台 Windows 11 电脑的验收。
