前言¶
DSH（DeepSeek Harness）採用插件化架構，允許開發者根據需求擴展功能。在使用 DeepSeek 進行代碼開發時，語法錯誤、類型缺失或 Lint 問題容易被忽略。dsh-lens 旨在解決這個問題，它充當代碼的“醫生”，在後臺自動執行檢查，並將診斷結果以卡片形式展示在聊天輸入旁，同時將問題直接反饋給 AI 助手，無需手動複製粘貼或具備深厚的技術背景。
插件介紹¶
dsh-lens 是一款 DeepSeek Harness 代碼自動檢查插件，由用戶 hajimixiaojie 維護，開源協議爲 MIT。該插件隸屬於模型推理類別，專注於爲 DSH 提供實時的代碼健康監測能力。
核心功能¶
該插件提供以下能力：
1. 代碼健康檢查：對代碼進行持續的監控與評估。
2. 自動檢查：支持語法、類型和 Lint 規則的自動檢測。
3. 診斷卡片：在聊天輸入框旁顯示檢查結果，直觀呈現問題。
4. AI 交互：將檢測到的問題自動分享給 AI 助手，輔助修復。
5. 低門檻：配置簡單，無需技術背景即可使用。
安裝與啓用¶
安裝過程分爲四步，請依次執行。
1. 檢查 DSH 安裝狀態¶
首先確認 DSH 是否已安裝。在終端中運行以下命令：
dsh --version
若成功，會輸出版本號（如 0.1.0-rc.6）；若提示 command not found，則需要先安裝 DSH。
2. 安裝插件¶
使用官方提供的命令安裝插件：
dsh plugin --profile web add npm:@dsh-lens/dsh-lens
此命令會從 npm 倉庫下載並安裝插件。
3. 確認安裝成功¶
運行以下命令檢查插件列表：
dsh plugin --profile web list
在輸出列表中確認存在 @dsh-lens/dsh-lens 即可。
4. 重啓 DSH¶
關閉當前的 DSH 窗口或頁面，重新打開 DSH。插件將在啓動後自動生效，無需額外配置。
典型用法¶
安裝完成後，插件會自動運行。以下是一個觸發檢查的演示步驟：
1. 打開一個包含 tsconfig.json 的 TypeScript 項目。
2. 打開任意 .ts 文件，故意寫錯一行代碼，例如將類型寫錯：
const x: number = "hello";
- 保存文件。
- 查看聊天輸入框上方，會出現一個診斷卡片，顯示類似“1 個問題 / 1 issue”的信息。
注意：如果項目根目錄沒有
tsconfig.json，插件將不會對該項目進行代碼檢查。
適用場景與前置條件¶
- 適用場景：需要在使用 DeepSeek AI 進行代碼生成或輔助開發時，實時監控代碼質量的開發者。
- 前置條件：
- DSH 已安裝並正常運行。
- 需要打開終端窗口以執行安裝命令。
- 環境需安裝 Node.js 版本 >= 20。
- 被檢查的 TypeScript 項目根目錄需存在
tsconfig.json文件。
總結¶
dsh-lens 通過在 DSH 環境中集成自動化的代碼診斷能力，降低了代碼錯誤進入生產環境的概率。它不修改文件內容，僅通過只讀端點提供診斷信息，確保了開發流程的穩定性。如需查看源碼或提交問題，可訪問其 GitHub 倉庫。
