| name | cherry-studio-feedback |
| description | 收集、脱敏、预览并提交 Cherry Studio BUG、UI/UX 或功能反馈，默认提交到飞书。可在用户同意后调用内置诊断工具整理环境、错误日志、截图和用户导出的 trace，自动提交飞书表单或生成匿名上传 ZIP；也可安全解析反馈 ZIP 为表单字段。用户说“提交问题”“提交反馈”“上报 bug”“收集/上传错误信息”“整理日志/trace”“生成反馈包”，或描述 Cherry Studio 问题并希望记录时触发。只有明确要求 GitHub Issue 时才改用 issue-reporter。 |
Cherry Studio Feedback
像协作排障一样收集反馈，不把对话变成表格审问。已知信息直接复用；每次最多追问一个会改变提交内容的问题。
选择路径
- 即时沟通：用户只想把材料发到群里或交给同事时，走“手动交接”。不要读取或上传本地数据。
- 结构化反馈：用户要整理、提交或生成反馈包时，走“自动收集”。这是默认路径。
- GitHub Issue：用户明确要求 GitHub Issue 时，立即转交
issue-reporter，不要重复提交飞书。
“提交问题”“帮我提交一下”“上报这个 bug”等未指定平台的表达，都默认使用飞书结构化反馈。未明确提及 GitHub 时，不要调用 gh、检查 GitHub 登录、搜索 Issue 或询问用户是否改投 GitHub。
会话中的“上传错误信息”按钮属于客户端/服务端功能，不由本 Skill 模拟。用户提出该按钮需求时，将它作为功能建议收集。
隐私和确认
- 收集诊断前说明将读取哪些类别，并取得用户同意。只调用
mcp__assistant__diagnose；不要直接扫描用户目录、读取数据库或查询完整会话历史。
- 日志和 trace 可能包含对话、路径或个人信息。只接收用户主动提供或明确同意读取的材料。
- 在展示和写入文件前，遮蔽 API key、token、Cookie、Authorization、密码、私钥、完整用户主目录、用户名和主机名。联系方式只保留用户主动提供的值。
- 原始日志最多保留与问题相关的 50 条、每条最多 2,000 字符；不要把无关日志或完整聊天记录加入反馈。
- 外部提交前展示最终字段、附件文件名和接收方，等待一次新的明确确认。预览确认不等于此前的诊断读取批准。
- 在频道、定时或其他无人实时确认的会话中，只生成本地草稿，不提交、不上传。
手动交接
给用户一份简短清单：
- 问题发生时间、实际结果、期望结果和最短复现步骤
- Cherry Studio 版本、操作系统和问题出现频率
- 报错截图或录屏
- 从出错会话导出的 trace，以及相关时间段的日志
提醒用户分享前检查敏感信息。根据已知内容生成一段可直接发群里的摘要；不要声称已经发送。
自动收集
1. 提取反馈字段
智能推断，不要求用户理解字段名：
- 类型：崩溃、报错、功能异常 →
BUG；显示或交互问题 → UI/UX；新增能力或改进建议 → 功能
- 优先级：数据安全或所有用户无法工作 →
P0；核心流程阻断且无绕过 → P1；有影响但可绕过 → P2；轻微问题或建议 → P3
- 问题概述：一句话描述实际问题
- 详细描述：实际结果、期望结果、首次出现时间、频率和影响范围
- 复现步骤：最短、编号、可验证；无法稳定复现时明确写“偶现”及最近时间
- 联系方式：可选；用户拒绝后不再追问
BUG 和 UI/UX 主动询问截图。不要重复询问用户已经提供的信息。
2. 收集最小诊断
用户同意后按需调用：
mcp__assistant__diagnose({ action: "info" })
mcp__assistant__diagnose({ action: "errors", lines: 100 })
仅在问题相关时追加：
- MCP/插件问题 →
mcp_status
- 设置或渲染问题 →
config
- Provider/模型问题 →
providers
- 错误摘要不足 → 说明原因后调用
logs，最多 200 行
- 需要主动联网探测 Provider → 先说明会发起网络请求，再调用
health
优先使用 info 返回的真实应用版本，不硬编码版本号。删除绝对路径和主机名，只保留平台、系统版本、架构、内存概况、Cherry Studio/Electron/Node 版本，以及与问题有关的脱敏配置。
用户提供截图、日志、trace 或反馈 ZIP 时，使用附件句柄调用 mcp__assistant-files__save_attachment 保存到当前 workspace。该调用需要用户批准；拒绝或失败时继续生成不含该附件的反馈。
3. 生成工作区反馈包
在 workspace 新建唯一目录 feedback/cherry-studio-YYYYMMDD-HHMMSS/，保留所有原文件，不覆盖现有路径。写入：
feedback.json：机器可读字段feedback.md：人类可读预览diagnostics.txt：脱敏后的相关诊断，可选- 用户批准保存的截图、日志和 trace，可选
feedback.json 使用以下稳定键：
{
"schema_version": 1,
"type": "BUG",
"priority": "P2",
"app_version": "2.x.x",
"summary": "一句话概述",
"description": "实际结果、期望结果、频率和影响",
"steps": ["步骤 1", "步骤 2"],
"environment": "脱敏后的环境摘要",
"diagnostic_summary": "相关错误摘要",
"attachments": ["相对路径"],
"contact": "",
"captured_at": "ISO-8601"
}
需要 ZIP 时使用可用的 Python 标准库在 workspace 内创建新文件，例如：
uv run python -m zipfile -c feedback/CherryStudio-feedback-YYYYMMDD-HHMMSS.zip feedback/cherry-studio-YYYYMMDD-HHMMSS/feedback.json feedback/cherry-studio-YYYYMMDD-HHMMSS/feedback.md
不要写 /tmp 或桌面，不要永久删除生成目录。调用 mcp__cherry-tools__report_artifacts 登记最终 ZIP 和预览文件。
4. 安全解析用户上传的反馈 ZIP
先通过 save_attachment 保存原始 ZIP，再只读检查：
- ZIP 不超过 100 MB、成员不超过 50 个、总解压大小不超过 200 MB
- 拒绝绝对路径、
..、符号链接、加密成员和嵌套压缩包
feedback.json 必须存在且不超过 1 MB；只读取该文件，不执行内容、不盲目解压整个压缩包- 仅接受上面的稳定键并再次脱敏；未知键保留在本地预览，不映射到表单
将解析结果展示给用户确认。提交时可把原始 ZIP 作为“日志”附件，不需要提取其中其他文件。
飞书表单提交
表单分享地址：
- 结构化自动提交：
https://mcnnox2fhjfq.feishu.cn/share/base/form/shrcnsTvZpUji5ZKAPSMwzZuWHb
- 匿名反馈包上传：
https://mcnnox2fhjfq.feishu.cn/share/base/form/shrcnufZiSDrvRPIzSKeqcbBbub
提交前读取实时结构
不要依赖缓存字段 ID、Base token、必填状态或版本选项。每次提交前调用：
lark-cli base +form-detail --share-token shrcnsTvZpUji5ZKAPSMwzZuWHb --as user --format json
只填写实时返回中可见的问题，并按 questions[].type、required、filter 和选项构造值。映射当前常用标题：
类型 ← type问题概述 ← summary详细描述 ← description、期望结果、频率和诊断摘要复现步骤 ← 编号后的 steps优先级 ← priority环境信息 ← environment 和真实 app_version联系方式 ← 用户主动提供的 contact截图 / 日志 ← 已确认的相对附件路径
如果真实版本不在“版本”的当前选项中，选择“其他”，并把真实版本写入“环境信息”和“详细描述”。不要填写表单未返回或被 filter 隐藏的字段。
自动提交
静默检查 lark-cli 和用户登录态；以 auth status --json --verify 的退出码、verified 和 identities.user.status 判断，不要查找旧的 code == 0。
登录可用时：
- 从
form-detail 的实时返回取得 base_token。
- 使用 workspace 相对路径构造
fields 和 attachments；附件不能放进 fields。
- 展示最终预览并取得明确确认。
- 调用
lark-cli base +form-submit --share-token ... --base-token ... --as user --json ... --yes。没有附件时省略 --base-token 和 attachments。这里的 --yes 只跳过 CLI 的重复终端确认，不能替代上一步的用户明确确认。
- 仅在命令退出码为 0 且返回
ok == true 时报告成功。
登录不可用、权限不足或提交失败时，不强制用户登录：
- 保留已生成的 workspace ZIP。
- 给出匿名反馈包上传链接。
- 告诉用户上传哪个文件，并明确说明仍需用户在网页中点击提交。
不要安装、升级或重新配置 lark-cli 来挽救一次反馈提交；命令缺失、版本不兼容或返回结构不符合预期时，立即使用上述 ZIP + 匿名上传降级路径。
提交预览
提交前至少展示：
类型 / 优先级 / 版本
问题概述
详细描述与复现步骤
脱敏环境与诊断摘要
截图、日志、trace 或 ZIP 的文件名
联系方式（如有）
接收方：Cherry Studio 反馈收集飞书表单
用户修改后重新生成预览并再次确认。提交成功后报告摘要；失败时保留本地反馈包并给出匿名上传链接。
