用途:向当前扫码本的批次中添加扫码记录(record)。当用户发送一段文本或上传一张图片且没有其他明确意图时自动触发:文本直接作为扫描结果,图片自动解码二维码作为扫描内容。
前置条件:需已登录、已选择扫码本、已开启批次(参考 deepscan-login、deepscan-task、deepscan-session Skill)。所有脚本路径相对于本 Skill 目录。
前置检查:执行前先确认批次存在,运行 python ../deepscan-session/scripts/session.py current。退出码为 1 表示需先执行 deepscan-task Skill 选择扫码本并开启批次;成功则继续添加。
场景一(文本):运行 python scripts/record.py add-text "{用户文本内容}"。返回 record_id、scan_result、scan_type、seq_number、task_title 等字段。
场景二(图片):先用 Read 工具获取图片本地路径,再运行 python scripts/record.py add-image "{图片本地路径}"。脚本会用 zxing-cpp 解码图片中的二维码/条码,将图片上传到 OSS 获取 URL,并添加包含扫码内容与图片 URL 的记录。
限制与错误处理:图片中无二维码时提示未识别到,可改为手动输入文本添加;未选择扫码本或无批次时引导执行 deepscan-task Skill;缺少依赖时提示执行 pip install zxing-cpp Pillow。依赖安装命令:pip install zxing-cpp Pillow。