
Issue Reporter
This handles bug reports and feature requests with a smart dual mode approach. If you have GitHub CLI authenticated, it searches for duplicates, reads the repo's issue templates, shows you a preview, and submits directly to CherryHQ/cherry-studio. No GitHub access? It saves everything locally to `.cherry-assistant/` as markdown with structured fields and reminds you to submit manually later. The nice touch is it can batch submit accumulated local reports once you do authenticate. Triggers automatically when Claude spots a bug during debugging, or when you say things like "this is a bug" or "I want this feature." Strips tokens from logs and flags breaking changes appropriately.
- GitHub stars
- 47.2K
- last updated
- Jun 11, 2026
Install
$ npx -y skills add cherryhq/cherry-studio --skill issue-reporter --agent claude-codeInstalls into .claude/skills of the current project.
Files
Issue Reporter
触发边界
只有用户明确要求提交到 GitHub,才能继续本流程。不得从“提交问题”“反馈”“bug”或“功能建议”推断 GitHub;未明确点名 GitHub 时立即转交 cherry-studio-feedback,不得运行 gh auth status、搜索仓库或发起任何 GitHub 操作。
检测 GitHub 登录
每次提交前: gh auth status 2>&1。成功→GitHub模式,失败→本地模式。
GitHub 模式
Bug Report: 收集信息(描述/复现步骤/期望/平台/版本) → 查重 gh search issues "[关键词]" --repo CherryHQ/cherry-studio --state open --limit 5 → 读模板 .github/ISSUE_TEMPLATE/0_bug_report.yml → 预览给用户 → 确认后 gh issue create → 告知链接
Feature Request: 确认需求→查重→读模板 1_feature_request.yml→预览→确认→提交→记录到 .cherry-assistant/feature-requests.md
本地模式
Bug 存 .cherry-assistant/bug-reports.md,Feature 存 feature-requests.md:
### [Bug/Feature]: [标题]
- **日期**: YYYY-MM-DD | **平台**: OS | **版本**: vX.X.X
- **描述**: ... | **复现步骤**: 1... 2... | **期望**: ...
- **状态**: 待提交
---
存档后引导: GitHub(推荐) https://github.com/CherryHQ/cherry-studio/issues | 论坛 linux.do | 飞书表单 https://mcnnox2fhjfq.feishu.cn/share/base/form/shrcnsjfFkx4gy6wx9LQ70tMaKe
批量提交: 有权限时可说「帮我把待提交的都提交了」→读文件→筛待提交→逐个查重预览确认→更新状态为「已提交 #号」
注意
- 提交前必须用户确认
- 脱敏日志中 token/key
- Redux/IndexedDB schema 变更标记 Blocked: v2
Sponsors
Details
- Repository
- github.com/cherryhq/cherry-studio
- Categories
- Git & Pull Requests, Debugging
- License
- AGPL-3.0
- First seen
- Jun 11, 2026