code-intel:为 DeepSeek Harness 提供 IDE 级代码符号理解的 DSH plugin
legen07/code-intel
为 DSH 编码 Agent 提供 IDE 级代码智能:基于 TypeScript 语言服务器构建项目符号图谱,并以工具与侧边栏面板呈现。
code-intel 是一个为 DeepSeek Harness 编码 Agent 补上结构化代码视图的 DSH plugin。它针对 Agent 只能逐文件搜索原始文本的短板,启动 TypeScript 语言服务器扫描整个项目,采集每个符号的名称路径、种类、位置、签名与文档,并缓存成包含模块依赖与入口点的项目蓝图。Agent 通过一组按名称路径寻址的只读工具查询符号、引用、实现与诊断,人类用户则能在 Web 客户端右侧边栏的符号浏览器里直接浏览同一份数据。
如何安装
dsh plugin --profile <your-profile> add github:legen07/code-intel--profile 换成你本机实际使用的 profile 名(ls ~/.dsh/profiles/ 可查看目录名):浏览器版通常是 web,桌面版通常是 desktop 或 desktop-NNN。
- 分类
- 开发与运维
- 平台
- DSH Plugin
- 作者
- legen07
- 分发方式
- 插件
code-intel 核心特性
code-intel 仓库简介
它是做什么的?
code-intel 是 DeepSeek Harness(DSH)的代码智能插件,为编码 Agent 提供 IDE 级的项目符号理解能力。它解决 Agent 只能靠 grep 原始文本、缺乏结构化代码视图的问题:插件启动 TypeScript 语言服务器,扫描整个项目(遵循 gitignore),提取每个模块的符号及其属性,并持久化为「项目蓝图」——一张符号与模块依赖图。最终以一组固定工具和 Web 客户端侧边栏的符号浏览器呈现给 Agent 与用户。
核心功能
- 符号发现与属性提取:通过原生 TypeScript LSP 客户端启动语言服务器,打开整个项目树,采集每个符号的名称路径(如
Account.deposit)、种类、精确位置、签名与文档,并读取导出/异步/静态修饰符、容器与子符号。 - 项目蓝图持久化:把符号图按项目缓存为蓝图,包含每个模块的符号清单与导出、文件间依赖边、聚合的外部包依赖、推导出的入口点以及按符号种类统计的数量。
- 面向 Agent 的固定工具集:提供按名称路径寻址的只读工具,涵盖符号查找、引用查找、接口实现查找、文件符号概览、符号详情、诊断信息、项目蓝图读取与强制重建索引。
- 符号浏览器面板:在 Web 客户端右侧边栏提供标签页,可搜索符号、浏览模块、查看符号详情、引用、实现与诊断,与 Agent 使用同一套服务。
- 静态导入分析:解析项目内的静态 import 语句与模块说明符,构建文件到文件的依赖关系。
怎么使用这个插件?
在 DSH 中启用后,插件会为当前会话项目建立符号索引,Agent 即可调用 find_symbol、find_referencing_symbols、get_symbols_overview、get_diagnostics 等工具,按名称路径查询代码结构,而不必逐文件搜索文本。需要查看整体结构时,让 Agent 调用 get_project_blueprint 获取模块、依赖与入口点摘要;代码改动较大或索引过期时,调用 refresh_code_index 强制全量重建。人类用户则可在 Web 客户端右侧边栏打开符号浏览器,直接搜索符号、查看引用与诊断。该插件由 legen07 维护,采用 MIT 协议,使用 TypeScript 编写。
报错怎么排查?
若符号查询返回空结果或索引明显过期,通常是项目蓝图缓存与当前代码不一致,可让 Agent 触发一次全量重建索引。若诊断或符号信息缺失,检查语言服务器是否已为当前项目正常启动,并按官方说明修复环境后重试。
本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准:legen07/code-intel。插件是安装时就在你机器上运行的第三方代码;收录不代表背书——安装前请自行审阅源码。
DSH Plugin 常见问题
