前言¶
在使用 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 是在处理大型代码库时，平衡上下文长度与模型理解能力的实用工具。它通过提供结构化的映射，让智能体在无需加载全部源码的情况下，依然能对仓库有清晰的认知。
