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
