DeepSeek Harness 的开发者和使用者，在运行自主工作流或遇到插件故障时，通常需要向上游提交高质量的 Bug 报告。手动填写报告流程繁琐，且容易因疏忽泄露 API Key、本地路径等敏感信息。dsh-issue-reporter 插件旨在解决这一问题，提供从发现故障、隐私合规检查到生成报告的一站式流程。
该插件由 GooDAnDReaDY 维护，基于 MIT 许可证。它是一个客户端工具，提供可视化的 Issue 编写界面，并集成了自动去敏、重复检测、AI 优化和自动诊断等能力。
核心功能¶
1. 插件目录与双分组¶
插件会扫描当前 DSH 的运行时组合，发现已安装的插件。它将插件分为两组：原生 @deepseek-ai/ 插件和第三方社区插件。非公开、无效或重复的包会被过滤掉。点击插件行可打开集成的 Issue 编写器。
2. 身份验证与权限管理¶
用户通过 GitHub 的标准 OAuth Device Flow 进行授权。插件请求 repo 权限以支持 Issue 创建和重复搜索。生成的访问令牌通过 DSH Credentials 安全存储（环境变量 GITHUB_ISSUE_REPORTER_TOKEN）。提供明确的“Sign out”功能以切换账户。
3. 隐私边界与去敏¶
内置编辑器会自动去敏 bearer tokens、API keys、凭证 URL、本地系统路径和邮箱地址。在提交前，界面会显示去敏后的预览，并统计去敏项目数量。对于未登录的情况，提供预填好的 GitHub issue-form 链接。
4. 重复检测与搜索¶
在提交前，插件会实时查询目标仓库的 Issues。通过标题和正文进行规范化搜索，并排名展示潜在的重复问题，避免噪声。
5. 截图上传¶
支持上传最多 5 张截图（PNG, JPG, GIF, WebP）。图片仅在内存中处理，上传通过 GitHub CLI (gh issue create --attach) 执行，并使用临时目录，上传完成后自动清理。
6. AI 优化与日志¶
提供 POST /dsh-issue-reporter/ai/optimize 接口，利用 LLM 将非结构化的错误描述转化为清晰的复现步骤和标题。
提供 GET /dsh-issue-reporter/logs 接口，用于查看最近的会话日志，方便附带相关服务器追踪信息。
7. 自主代理报告工具¶
注册了 ctx.tools.report_issue 工具。自主编码代理或编排器可以在插件遇到未处理的异常或崩溃时，自动调用该工具生成结构化的 Bug 报告。
8. Issue 监控与状态跟踪¶
提供 POST /dsh-issue-reporter/issues/batch-status 接口，用于批量查询已提交 Issue 的状态，并在“My Reports”标签页中展示。
9. 智能标记与组件检测¶
提供 POST /dsh-issue-reporter/labels 接口，查询上游仓库的标签，并自动推荐匹配的类别标签。
10. 交互与更新¶
支持剪贴板粘贴（Ctrl+V）截图和拖放文件。提供符合 DSH 标准的设置卡片更新器，支持一键更新插件。
典型用法¶
查看 Session Logs¶
通过日志端点检查主机会话记录，筛选相关错误信息。
GET /dsh-issue-reporter/logs
AI 优化描述¶
将非结构化的错误笔记转化为标准的复现步骤。
POST /dsh-issue-reporter/ai/optimize
代理自动报告¶
在代理逻辑中调用工具文件 Issue。
ctx.tools.report_issue({
target: "plugin-name",
title: "Error description",
body: "Details..."
});
上传截图¶
通过 GitHub CLI 附件功能上传。
gh issue create --attach screenshot.png
批量查询状态¶
检查提交的 Issue 状态。
POST /dsh-issue-reporter/issues/batch-status
适用场景与注意¶
该插件适合需要在 DSH 环境中频繁排查插件故障并规范提交 GitHub Issues 的用户。
注意事项：
* 权限要求：OAuth 范围需要 repo，用于 Issue 创建和重复搜索。
* 用户确认：任何 GitHub 写操作（创建 Issue、上传附件）都需要明确的用户确认（confirm: true）。
* 运行环境：插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证。
* 依赖项：需要 Node.js 20+，并依赖 @deepseek-ai/cordis 版本 ^4.0.2。
插件目录地址：https://www.skillhub.cn/plugins/GooDAnDReaDY/dsh-issue-reporter
