前言¶
在使用 DeepSeek Harness 構建智能體時，讓模型準確理解代碼結構（尤其是 TypeScript/JavaScript 的類型系統）通常需要智能體主動調用 LSP 工具。DSH TypeLens 插件解決了這個問題，它通過本地分析，在文件讀取和編輯後自動補充類型聲明和診斷信息，使智能體無需手動干預即可獲取上下文。
這是什麼¶
DSH TypeLens 是一個自動化的有界類型上下文和編輯診斷插件。它由 fantasyce 維護，旨在爲 DeepSeek Harness 提供本地優先的類型支持。插件通過在 DSH 的請求流中追加類型聲明和診斷結果，消除了智能體記憶調用 LSP 工具的需求。
核心功能¶
DSH TypeLens 提供以下核心能力：
- 自動類型上下文與診斷：在文件讀取後，僅追加理解可見代碼所需的完整類型聲明；在文件編輯後，追加有界的 TypeScript 診斷信息，並將新錯誤優先顯示。
- 本地分析與隱私：分析過程完全在本地進行，無出站請求，分析狀態和計數器僅駐留在內存中，不持久化源代碼分析狀態。
- 原生 DSH 集成：提供顯式的工具接口，並在 DSH Web 的 Settings → TypeLens 中提供健康檢查、自動行爲調整、限制設置以及內存緩存和計數器的重置功能。
- 有界與故障開放：對工作區、文件大小、超時、深度、結果、緩存和令牌進行限制。即使分析失敗，也會保持故障開放模式，不會將成功的文件操作轉爲失敗。
- 多語言支持：支持 TypeScript、TSX、JavaScript、JSX、Vue 和 Svelte。
安裝與啓用¶
安裝前請確保系統已安裝 dsh 和 pnpm。
dsh --version
pnpm --version
使用官方插件管理命令安裝：
dsh plugin --profile web add dsh-typelens
dsh plugin --profile headless add dsh-typelens
安裝完成後，重啓受影響的 DSH Profile，然後使用以下命令驗證配置是否生效：
dsh --profile web --dump-config
在 DSH Web 中，進入 Settings → TypeLens 即可查看健康狀態、調整自動行爲和限制參數，或重置內存中的緩存和計數器。
典型用法¶
DSH TypeLens 提供了四個原生工具供智能體調用：
typelens_lookup_type：查找與文件相關的命名聲明。typelens_list_types：列出與文件相關的有界聲明。typelens_check：運行有界的文件和項目診斷。typelens_explain：檢查有效的配置、健康狀態、斷路器狀態和源無關的計數器。
這些工具返回的路徑均爲工作區相對路徑。
適用場景與注意¶
DSH TypeLens 適合需要在 DeepSeek Harness 中處理 TypeScript、JavaScript、Vue 或 Svelte 項目的開發者。插件以當前 DSH 進程的權限運行，建議在安裝前檢查源碼與許可證。
插件僅持久化經過驗證的設置，位於 $DSH_HOME/typelens/settings，且僅允許所有者權限。分析上下文和診斷信息會附加到智能體步驟中，併成爲下一個 DSH 模型請求的一部分，因此遵循模型提供商的隱私政策。
結語¶
DSH TypeLens 爲 DeepSeek Harness 提供了標準化的類型上下文和診斷能力，通過本地化、有界的分析策略，提升了智能體在代碼編輯任務中的準確性和可靠性。
