使用手册 / 第 04 章
工具
在桌面应用左侧展开「工具」。当前安装包面向 macOS 和 Windows;两者的截图方式和系统权限有所不同。
AI 助手
- 先到设置 → AI 模型配置接口和文字模型;要分析截图,再配置看图模型。保存配置后,另选「默认服务商」。
- 打开「工具 → AI 助手 → 对话」,描述你的问题和期望结果。按 Enter 或点「发送」,Shift + Enter 换行。生成中可点「停止」,可在「历史」里打开或删除旧会话,也可以新开对话。
- 发送前检查文字、日志、所选上下文和附图。请求会提交给配置的模型接口,需要该接口可达。「发送前脱敏」不能识别所有秘密,也不会遮挡图片里的信息;请先手动删掉密钥、私人信息和不必要的截图区域。停止生成或删除本机记录,不会撤回服务商已收到的内容。
按任务选择模式
- 助手:用自然语言要求打开工作区、切换主题或操作 Docker。执行前看清操作卡片上的目标和动作,不要把模型建议当成授权。
- 报错、日志、解释:「报错」粘贴错误或堆栈,并补充触发步骤;「日志」粘贴日志,或选 Docker 容器拉取最近日志;「解释」适合单独提交一段代码、日志或报错,问清它的含义。
- Docker 诊室:选择容器,拉取日志并研判;如果建议启停或重启,先确认容器名称及服务影响,再决定是否执行。
- 端口:输入要查的端口,结合本机进程快照看占用者;不要仅凭模型结论结束进程。
- SSH 草稿:选服务器并说明目标,审阅命令,再带到终端;不会替你按回车。已连上远程服务器时,终端里的「AI → 运维」可给出分步建议,「Agent」可根据输出规划下一步,但当前每条命令都需确认。确认前检查目标主机、权限和影响;命令输出也可能作为上下文发给模型。
- 清理建议:先扫描,再请模型解释哪些项可优先检查;建议不是删除操作,真正清理前请在空间清理工作区核对路径。
- 看图:从图库或本地选择图片,再输入问题或选择快捷提问。图片会交给看图模型;只需提取文字时可先用截图工作区的本机 OCR。
- 改写、正则、Cron:「改写」粘贴原文并说明语气、长度或目标语言;「正则」描述要匹配的内容和反例;「Cron」描述频率和时间。生成的表达式先用文本工具检查,不会自动建立任务。
微信:从截图生成回复候选
- 为默认服务商明确配置「文字模型」和「看图模型」。在「微信」页从图库点选、「选择本地图片」或「粘贴图片」;也可以点「去截图」先取图。只保留有权分享的聊天片段。
- 点「开始回复流水线」。默认启用「用本机 OCR 辅助识别文字」,OCR 失败仍可继续图片研判;即使使用本机 OCR,研判和起草也会把截图和可用的识别文字发送给看图模型。
- 查看意图、摘要、建议和 0–9 的风险分。模型建议不回复,或风险达到 7 分时,流水线停在研判;否则会起草并排序三条候选。风险分只供参考。
- 核对措辞、事实和承诺后点「复制」,再自行粘贴到微信。「弹出悬浮窗」可置顶查看并复制候选,不会登录微信或自动发送。最新 OCR、研判和候选文本可保留在应用本机存储中。
用量统计
- 打开「工具 → 用量统计」,按「时间范围」(默认最近 7 天)、「模型」、「调用来源」和「请求状态」筛选,也可搜索服务商、模型或请求/会话 ID。
- 用「请求日志」定位单次失败或慢请求;用「会话上下文」按会话查看多个请求的耗时、Token、缓存读写或消息结构。消息结构只记录角色、字符数和图片数量,不记正文、图片或密钥。
- 「未上报」不等于零,字符数也不等于 Token。这里仅包含应用记录的生成请求,不包含「测试连接」与「读取模型列表」,不能当作服务商账单。
本机保留最近 30 天、最多 1,000 条记录,不随业务数据目录自动迁移。「清空记录」只删本机用量,不删 AI 对话或服务商记录。
文本工具
打开「工具 → 文本工具」,在「工具」栏选择功能。多数结果随输入更新,复制或替换前先核对。可在「设置 → 文本工具」设定打开时的工具、JSON 缩进以及是否预填示例。
- JSON:把严格 JSON 粘到「原文」,选「美化」或「压缩」,按需「排序键」或「去空值」。在「结构」点节点,或输入
owners[0].name这样的路径提取值。符合条件的扁平对象数组可看「表格」,复制的仍是 JSON。「去空值」会移除空值和空容器并可能改变数组下标;核对后再「替换原文」。 - YAML:选「YAML → JSON」或「JSON → YAML」,在左侧粘贴内容,再复制右侧结果。切换方向会重新解释当前输入;转换不保留注释等排版信息。
- 对比:分别粘贴「改之前」和「改之后」,在「差异」里查看增删行。按行比较而非逐字比较,大段改动可能整体显示为替换。
- 时间:输入时间戳或日期,或点「现在」,再复制「本地」「UTC」「秒」或「毫秒」。数字绝对值达到 1000 亿才按毫秒解释,否则按秒;日期字符串最好写明时区。
- Base64:选「Base64」「URL」或「十六进制」,再选「编码」或「解码」。此处「URL」是 Base64url,不是百分号编码;解码输出要求有效 UTF-8 文本。编码不能保护秘密。
- JWT:粘贴令牌,查看或复制 Header 和 Payload,按本机时钟查看过期提示。「签名未校验」表示无法凭此验证签发者或确认令牌可信;避免分享仍有效的令牌。
- Cron:输入五字段表达式或点「工作日 9:30」等预设,看字段拆解和「接下来 5 次」。预览使用本机时间,不含秒字段,也不会注册或运行任务。
- 正则:输入表达式和测试文本,按需选择
g、i、m、s、u,检查高亮、位置和捕获组。采用 JavaScript 语法;不选g只看首个匹配。先用短样本试复杂表达式,以免卡住界面。 - 哈希:输入文本,选「十六进制」或「Base64」,点摘要复制 MD5、SHA-1、SHA-256 或 SHA-512。计算包含空白字符;不要把普通摘要当作密码存储方案。
- UUID:选「UUID v4」「UUID v7」或「随机字符串」,设「数量」后点「重新生成」。UUID 可调大小写和连字符,随机字符串可调长度和字符集;可单条或整批复制。UUID v7 含时间信息,不是秘密令牌。
- URL:输入地址查看协议、主机和路径,按需添加、修改或删除「查询参数」;也可使用「整段编码/解码」。编辑参数会重新序列化地址,可能使签名链接失效;解析不代表链接可信。
- 颜色:输入颜色或点「选择颜色」,查看 HEX、RGB、HSL、HSB/HSV、OKLCH 和 Figma/iOS 数值,或点色板取样。白底/黑底对比提示不计透明度,半透明颜色请在实际背景上复核。
屏幕截图
采集和导入
- macOS:用「框选」拖动选区、「窗口」点选窗口,或用「整屏」。无权限时按提示「打开系统设置」,在「隐私与安全性」中授予屏幕录制权限后重开应用。这里的屏幕录制是系统权限名称,工作区只截取静态图片。
- Windows:内置截图仅支持「整屏」。框选可按 Win + Shift + S 后将结果粘贴到工作区。
- 延时和显示器:截图前选「立即/3 秒/5 秒/10 秒」。齿轮可设置截图时隐藏 Dockyard;指针和窗口阴影选项仅在 macOS 生效。多屏时可为整屏指定显示器;不要把 macOS 的「全部显示器」当成拼接截图。
- 导入、取色、测量:点「打开」选 PNG、JPEG、WebP、GIF 或 BMP,也可拖入图片,或离开文字输入框后直接粘贴。顶部「取色/测量」会重新截图并按 1:1 打开工具,不走延时、自动入库或自动 OCR;编辑器里的取色和标尺则作用于当前图。
编辑、识别和保存
- 用矩形、椭圆、箭头、直线、画笔、荧光笔、文字、序号、马赛克或聚光灯标注;用「选择 / 移动」拖动或删除选中标注,双击文字可改。用「裁剪」框选后按 Enter 应用,Esc 取消。
- 在「调整」中旋转、翻转、改尺寸、加滤镜或裁掉纯色边;在「美化」中预览背景、边框、留白和阴影,再点「应用到图片」。裁剪及这些变换会将已有标注合入新图,可用撤销返回上一步。
- 在「识别」选「识别整张」或「框选识别」,编辑并复制结果;有文字框时可点选复制单行。「检测引擎与语言」可查看本机 OCR 能力(macOS Vision、Windows OCR,或可用的 Tesseract)。「识别二维码」不等于通用条码识别。
- 用「问 AI」发送当前图片和问题;「设计走查」还需选一张参考设计稿,再点「开始走查」。这些操作会把图片发往配置的模型接口,和本机 OCR 不同。
- 「复制」将合成图放进剪贴板,「存入图库/更新图库」写入图库,「导出 PNG」另存文件。可在「信息 → 偏好」切换 JPEG 或 WebP。分享前打开导出的文件检查敏感区域;仅添加马赛克不会清除已入库或导出的原图。
默认自动入库,也适用于打开、拖入或粘贴的图片;自动 OCR 默认关闭。图库可按名称或识别文字搜索、置顶、双击改名、打开图库目录或删除。删除会移除图库文件;换图时如提示有未保存修改,请先保存或导出。
二维码工具
生成单张
在「类型」下选一种,填写表单,等预览更新后用「查看编码内容」核对载荷。「复制编码」只复制文字;「复制图片」复制预览 PNG;「下载 PNG」会遵守单张下载最小尺寸(默认 512 像素)。
- 链接:输入地址,没写协议时自动加
https://。生成前自行确认域名和目标页。 - 文本:输入要分享的内容,首尾空白会去掉。二维码不是加密容器。
- Wi-Fi:填网络名称,选 WPA/WPA2/WPA3、WEP 或无密码,按需填密码并设置「隐藏网络」。密码可从生成的码中读出;不要公开分发内网密码。
- 联系人:填写姓名,按需补公司、职位、电话、邮箱、网站和备注;扫码端能否导入 vCard 取决于其应用。
- 邮件:填收件人,可附主题和正文,供扫码端预填邮件,不会自动发送。
- 短信:填号码,可附内容;扫码端对正文的支持因应用而异。本工具识别后打开短信应用时只传号码。
- 电话:填号码,生成拨号用二维码;扫码后的行为由接收端决定。
- 位置:填纬度(±90)、经度(±180)和可选名称;空坐标可能被当成 0,务必核对位置。
生成区可选模板,调尺寸、边距、容错和前景/背景色,或加 Logo 并调比例与形状。Logo 会让编码使用最高容错,但不保证扫得出;保留四周留白和明显的明暗对比,发布或印刷前请试扫最终图片。
批量、场景、模板和识别
- 批量:「内容」每行填一条原始载荷(如完整链接),空行会忽略,默认最多取 500 条。查看预览和逐行错误后点「逐张下载」。它不是 ZIP,下载的是逐张预览图,不使用单张下载最小尺寸。
- 场景:按分类、名称或编号找标签、工牌、标牌或海报样式,点「使用此样式」,分别编辑「二维码内容」和「标签字段」。后者决定画面文字,不会自动写进码里;二维码内容留空会回退到示例。验证后可「保存到我的样式」,或「复制图片/下载标签 PNG」。保存的样式可包含实际载荷和字段值。
- 模板:选择内置或自定义样式卡。调整外观后输入「模板名称」保存,或更新、另存、重命名、复制或删除自定义模板。内置项不能删。「Logo 库 → 上传 Logo」可添加 PNG、JPEG、SVG 或 WebP(最多 600 KiB)。模板预览是样例,不是业务二维码。
- 识别:拖入图片,点「打开图片/粘贴截图」,或授权后「打开摄像头」。识别的是二维码,不是普通条码;摄像头命中后或离开页面时停止。可「复制原文」或「用原文再生成」到文本类型。识别不会自动打开目标;点打开链接、写邮件、发短信、拨打或打开地图前,先核对原文。Wi-Fi 和联系人只展示内容,不会自动加入网络或导入联系人。
历史和敏感内容:默认记录历史,成功识别以及单张生成时复制图片或下载,都可能在本机留下完整载荷。即使 Wi-Fi 密码字段被遮住,原文仍可见。可在「设置 → 二维码工具」关闭「记录历史」阻止新增,再到「识别 → 最近 → 清空」删除已有记录;这不会清除剪贴板、保存的场景或已下载图片。