前言¶
在使用 DeepSeek Harness（DSH）開發智能體或應用時，模型需要理解代碼倉庫的上下文。直接將整個源代碼注入上下文不僅會消耗大量 Token，還可能因爲無關代碼干擾模型判斷。dsh-repo-map 旨在解決這一痛點，它提供一個輕量級的視角，幫助模型快速定位倉庫結構和關鍵符號，而不必加載每一行具體代碼。
插件定位¶
這是一個由 MkaliezZ 維護的輕量級、只讀插件。它的核心職責是生成 DSH 的倉庫結構和符號映射。作爲 dsh-context-pack 的補充工具，它專注於梳理代碼骨架，而非提供完整的源碼內容，從而在保持上下文精簡的同時，提升模型對代碼庫的認知能力。
核心能力¶
該插件主要提供以下功能：
- 結構與符號映射：能夠識別並映射倉庫的目錄結構，提取關鍵的符號信息，幫助模型快速定位代碼位置。
- 非侵入式讀取：它以只讀模式運行，不會將整個源文件注入到上下文中，避免上下文窗口溢出。
- 智能過濾：插件會自動識別常見的源代碼聲明，並跳過
generated或vendor等生成目錄或第三方依賴目錄，只保留核心業務代碼的結構信息。
安裝與啓用¶
該插件以 npm 包的形式發佈，包名爲 @mkaliezz/dsh-repo-map。在安裝前，請確保你的 Node.js 環境版本大於等於 20。
npm install @mkaliezz/dsh-repo-map
安裝完成後，它將作爲 DSH 的一個模塊被引入。結合 dsh-context-pack 使用，可以完善模型對代碼庫的認知結構。
注意事項¶
- 只讀插件：請確認你的使用場景允許讀取倉庫結構，該插件不涉及文件修改操作。
- 環境要求：必須使用 Node.js 版本 20 或更高版本。
- 許可證：插件採用 MIT 許可證，使用前請查看源碼確認合規性。
結語¶
dsh-repo-map 是在處理大型代碼庫時，平衡上下文長度與模型理解能力的實用工具。它通過提供結構化的映射，讓智能體在無需加載全部源碼的情況下，依然能對倉庫有清晰的認知。
