官方提 issue 的确认卡片依赖默认未安装的 GitHub 插件,首次使用无引导
- Dominant language
- TypeScript
- Stars
- 2.7k
- Forks
- 401
- Avg merge
- 21h 48m
- Merged PRs (30d)
- 776
Description
**客户端版本**: 0.1.33
**反馈类型**: feature
---
# 使用场景
想给 Cindy 官方提交 bug / 功能建议。用户使用官方内置的 /issue 指令发起反馈,agent 会按流程用 cindy_helper 的 submit_github_issue 提交,工具说明承诺「调用后会在 App 内弹出系统确认卡片,用户可以编辑标题/正文并确认或取消」。
## 诉求
反馈入口应开箱即用;缺依赖时应给出明确引导,而不是让用户和 agent 在黑暗中各自摸索。
## 建议方案
1. 调用 submit_github_issue 前检测 GitHub 插件是否启用:未启用时返回可操作提示(如「请先在设置中启用 GitHub 插件并绑定账号」+ 入口路径),而不是笼统的「could not verify this session's tool policy」。
2. /issue 指令与官方文档补充前置条件:反馈卡片需要先安装/启用 GitHub 插件并绑定账号。
3. 若走平台代提交降级,应明确告知身份差异(平台身份 vs 本人 GitHub),避免误导。
## 实际经历(复现参考)
通过官方 /issue 指令真实提交 #1870 时的过程,供复现:
1. 按 /issue 指令让 agent 用 cindy_helper 提交,但该工具在当前会话里根本没有暴露;直连 MCP 端点也返回「could not verify this session's tool policy. Start a new session and try again.」——没有任何线索提示根因是 GitHub 插件未启用。
2. 一番折腾(翻会话 rollout 文件找到线程 ID、手动带 _meta.threadId 才打通 list_tools)后终于能调 submit_github_issue,但确认卡片上中文乱码,连续两次提交被用户取消。
3. 最后是用户自己「拍脑门」想起来:去 Cindy 插件列表里手动启用 GitHub 插件,才真正弹出可用的确认卡片,第三次提交成功(#1870)。
整条链路全靠用户灵光一现,普通用户走到这一步大概率直接放弃。默认未安装的插件 + 无指向性的错误信息 + 文档缺失,让官方 /issue 反馈入口形同虚设。
---
**版本区域**: CN
**OS**: win32 x64 (10.0.26100)
**界面语言**: zh-CN
Contributor guide
Research direction
Start at the official /issue command and the cindy_helper submit_github_issue entry point, then trace how GitHub plugin availability and session-policy errors are handled. Check the GitHub plugin settings and the official documentation for the stated prerequisites. Done means missing dependencies produce an actionable guide, the prerequisite is documented, and any platform-submission fallback identifies the submitting identity.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github, typescript
- Domain
- developer-experience, documentation
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 55/100