诊断与技术支持

当遇到异常问题需要开发者协助时，Kapinote 提供了内置的去敏诊断报告生成功能。打开 设置 → 诊断，一键生成诊断日志。请在复制或提交给技术支持团队前自行核验确认。

1. 诊断报告包含的系统元数据

• Kapinote 客户端版本号与 macOS 系统架构信息（Apple 芯片型号、系统版本号）
• 关键系统权限（麦克风、系统音频录制、语音识别）的授权开启状态
• 当前启用的语音与 AI 服务商类型、模型名称（所有 API Key 均自动过滤剔除）
• 基础运行指标：会议数量、转录处理时长统计、段落计数等用于复现 bug 的运行时状态
• 应用最近产生的脱敏错误日志（Stack Trace）

2. 诊断报告绝对排除的内容（隐私承诺）

为确保你的隐私安全，诊断生成器在底层代码中严格排除了以下数据：

• 零 API Key / 凭据泄露： 所有 Token、密码与认证字段均被过滤替换为掩码
• 零会议音频： 绝不包含任何麦克风或扬声器录制的原始音频文件
• 零会议文本： 绝不包含会议标题、发言人姓名、转录逐字文本与 AI 总结笔记
• 零对话内容： 绝不包含用户在 Chat 对话框中输入的 Prompt 或对话历史

技术说明： 为了在不读取真实文本的前提下排查断句与总结异常，报告中仅可能包含派生的统计指标（如字符总数、段落长度范围、检测到的语种标识符）。

3. 如何提交一份高质量的 Issue 反馈

在 GitHub 或邮件中提交问题反馈时，建议提供以下结构化信息：

1. 环境版本： Kapinote 客户端版本与 macOS 系统版本（如 macOS 15.1 on M3 Max）。
2. 预期 vs 实际： 明确描述预期发生的结果与实际出现的异常现象。
3. 稳定复现步骤： 清晰列出第 1 步、第 2 步的操作路径。
4. 模型配置： 当前生效的语音转录引擎与 AI 服务商名称（无需包含 Key）。
5. 内置测试结果： 设置页面的“内置测试”按钮是否能正常跑通。
6. 附件： 附上自检后的去敏诊断报告文本。

4. 分享前自检清单

• 在文本编辑器中快速搜索公司内部主机名、内网 IP 或特定员工邮箱。
• 确认未在 Issue 描述中误贴私有 API Key。若曾意外泄露，请立即在服务商平台注销废弃该 Key。
• 遇到常规使用问题，建议先查阅 故障排查手册。