AI 功能及测试方法

助手是一个聊天功能，能回答有关您的项目、会话和标注的问题，并在您确认每项提议后进行整理。本地应用使用您配置的 AI 运行它；在 Pinar Cloud 中，它属于 Pro，每条消息使用 3 个 AI 积分。向助手提问介绍了它的工作方式。

在 Pinar Cloud 中，符合条件的已登录账户可以使用复现，生成文字步骤每次使用 1 个 AI 积分；生成失败会退还积分。语音与助手的 Pinar Cloud AI 积分说明了余额和退款。

开始填写标注评论并选择麦克风。最多录制 120 秒，停止后把转写插入评论，或直接发送。在 Pinar Cloud 中，语音转写需要 Pro 账户并使用 AI 积分；「语音与助手的 Pinar Cloud AI 积分」指南说明计费档位和退款规则。在本地应用中，语音使用「设置 → AI 助手」中设置的转写模型，在您自己的 OpenAI 兼容端点上运行，不消耗积分。该端点的 API 密钥必须允许音频转写。

打开 Pinar 捕获工具栏并按 G 开始录制。正常操作页面，再次打开 Pinar，添加标注，并在 macOS 上按 Command+Enter，或在 Windows 和 Linux 上按 Alt+Enter 完成。扩展会记录导航、点击、输入值、按键和必要的滚动；敏感值始终保持隐藏。

打开已保存的会话。复现区域会显示可在生成前编辑的原始时间线。选择生成文字步骤后，AI 会把时间线和标注评论转换为简明说明，与会话一起保存，并包含在交给本地智能体的内容中。

• 生成前编辑或删除时间线中的噪声事件。
• 交给本地智能体之前，请检查生成的说明。
• 让了解仓库及其约定的本地智能体创建项目专用的自动化测试。

本地应用可以使用您提供的 AI 而不是 Pinar Cloud 来转写语音评论、进行清理并运行助手。打开 「设置 → AI 助手」 并选择模式：「已停用」关闭 AI，「本地 AI」使用同一台电脑上的服务器，「BYOK」使用您自己的密钥直接连接到远程提供商。两种活动模式都需要一个 OpenAI 兼容端点及其公开的准确模型，外加一个可选的转写模型：留空该字段可保持语音关闭。

在 「BYOK」 模式下，API 密钥存储在您的操作系统凭据保险库中，而不是 Pinar 的偏好设置里。「测试连接」和「保存」会在完成前检查模型和转写模型。如果只有转写模型失败，消息会说明原因——例如密钥缺少音频权限——而不需要语音的功能仍可以保存。语音评论需要一个允许音频转写的端点。本地 AI 与 BYOK 指南涵盖了设置、隐私和模型要求。

• 本地应用中的语音转写、清理和助手直接使用您的提供商，不消耗 Pinar Cloud 积分。查看器中的「生成文字步骤」操作仅在 Pinar Cloud 中提供。
• 请求只从本地应用发送到您的端点，绝不会自行转到 Pinar Cloud。

默认情况下，录制的语音评论会把原始转写放入图钉。扩展选项中的「使用 AI 清理转录」开关——以及 Pinar Cloud 中 「设置 → AI 使用记录」 里的「清理语音转录」开关——会先让转写通过 AI 模型，使图钉收到您本意的评论：填充词和误开头会被移除，模型还可能在评论旁添加简短的验收标准。

关闭开关时，转写会直接作为评论，最多到评论长度上限，不经过 AI 重写。在本地应用中，清理使用您在 「设置 → AI 助手」 中配置的模型。在 Pinar Cloud 中，它使用语音转写已经使用的同一批 AI 积分运行。

• 保存图钉之前，请在语音面板中查看原始转写，或选择「使用转录文本」将其插入评论。原始转写也会复制到剪贴板；它不会与图钉单独保存。
• 清理默认关闭。本地捕获请在扩展选项中开启，Pinar Cloud 请在 「设置 → AI 使用记录」 中开启。