前言¶
在使用 DeepSeek Harness（DSH）進行開發或調試時，用戶常遇到需要提交功能想法、錯誤報告或改進建議的情況。將這些零散的對話記錄整理成結構清晰、符合社區規範的 GitHub Discussions 內容，往往需要手動複製粘貼和格式調整。DSH Feedback Bridge 插件旨在解決這一問題，它允許用戶在 DSH Web 界面中直接整理反饋草稿，並利用模型輔助完善內容，最終提交到官方 Discussions 或導出爲 Markdown。
插件簡介¶
DSH Feedback Bridge 是一個 DeepSeek Harness 插件，由用戶 yx222yx 維護。它的核心價值是將雜亂的對話內容轉化爲結構化的社區反饋草稿。該插件支持將反饋內容整理爲 GitHub Discussions，提供模型輔助建議、相似性檢查以及本地草稿保存功能，所有操作均在 DSH Web 環境內完成。
核心功能¶
- 入口與界面：通過 DSH Web 左側欄進入“社區反饋”。主界面展示反饋文本編輯與預覽。
- 反饋來源整理：點擊“反饋來源”進入獨立頁面。反饋內容按“一次完整交流”分組（即從用戶提問開始，到模型完整輸出結束，包含工具結果與報錯），支持篩選、確認、移除與引用。
- 模型輔助：點擊“模型輔助建議”，使用當前對話選擇的模型生成反饋類型推薦、缺失信息提示或逐字段建議。
- 編輯與展開：每個字段文本框較小，點擊展開按鈕可進入大編輯頁進行詳細修改。
- 相似性檢查：點擊底部操作行的“相似性檢查”按鈕，會讀取官方 Discussions、插件信息和允許訪問的官方文檔，檢查內容重複度。
- 導出與提交：支持複製或導出 Markdown 草稿。支持通過 GitHub 登錄或 GitHub CLI 提交。每次提交前會顯示最終內容和 GitHub 賬號，需用戶確認。
- 草稿管理：自動保存未完成的草稿，刷新頁面或重啓 DSH 後可恢復。本地僅保存成功提交的鏈接和基本信息。
安裝與啓用¶
該插件目前僅支持 DSH Web 環境（v0.1）。
- 確保你的 DeepSeek Harness 版本在
>=0.1.1-rc.2 <0.2.0範圍內。 - 使用 DSH 插件命令安裝：
dsh plugin --profile web add dsh-feedback-bridge
- 啓動 DSH Web：
dsh --profile web --no-open --port 3080
- 在 DSH Web 左側欄找到“社區反饋”並點擊進入。
如果需要指定版本或使用本地文件安裝：
dsh plugin --profile web add dsh-feedback-bridge@0.1.3
# 或
dsh plugin --profile web add ./dsh-feedback-bridge-0.1.3.tgz
使用方法¶
- 打開“社區反饋”，在主界面進行編輯與預覽。
- 點擊頂部 反饋來源 查看並引用對話內容，確認無誤後引用到字段。
- 點擊頂部 模型輔助建議，根據模型推薦完善反饋內容。
- 點擊字段展開按鈕進入大編輯頁，進行精細調整。
- 點擊底部 相似性檢查 查看結果。
- 檢查預覽，刪除不希望公開的信息。
- 選擇導出 Markdown，或登錄 GitHub 後直接提交。直接提交前需再次確認公開內容和賬號信息。
配置與隱私¶
插件支持兩種 GitHub 授權方式：Device Flow 登錄和 GitHub CLI 登錄。授權過期時插件會嘗試自動續期。
如果僅需要導出草稿而不提交，可在 DSH profile 配置中設置：
github:
auth:
provider: none
隱私說明：
- GitHub access token 和 refresh token 僅在 DSH Host 端使用，不會發送給瀏覽器客戶端或模型。
- DSH 本地憑據存儲不等同於操作系統級安全存儲。
- 相似性檢查會讀取官方 Discussions、插件信息和允許訪問的官方文檔。
- 插件不會自動提交，每次寫入 GitHub 都需用戶單獨確認。
- 本地只保存提交鏈接和基本信息，不跟蹤回覆或狀態。
適用場景與限制¶
該插件適合需要在 DSH Web 環境下快速整理反饋、利用 AI 輔助撰寫並確保隱私的開發者。
當前限制：
- v0.1 版本僅支持 DSH Web。
- 同一時間只保存一份未完成的草稿。
- 只提交到官方 DeepSeek Harness Discussions，不支持向第三方插件倉庫提交。
- 不支持創建 GitHub Issue。
總結¶
DSH Feedback Bridge 是一個專注於反饋整理流程的工具，通過規範化的數據結構和模型輔助，降低了向社區提交高質量反饋的門檻。對於習慣在 DSH Web 中工作的用戶，它提供了一條從對話到社區反饋的清晰路徑。
