Apache-2.0 工具:本地构建代码图与带出处的 Wiki,并以 bundle 形式提供给 DeepSeek Harness,暴露 `explore_context` 与 `dependency_subgraph`。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-12
许可证
Apache-2.0
01它能帮你完成什么?
让 DSH Agent 用编译器解析出的定义、调用者与依赖关系导航本地代码,而不是只靠 grep 加读文件
本地搜索索引加带类型的符号图,通过 `explore_context`、`dependency_subgraph` 等工具提供排序后的源码锚点
在不熟悉或很大的仓库里工作、需要 Agent 指明文件与行号的 DSH 用户
动手之前先读懂一个陌生仓库是怎么跑起来的
一份生成的 Wiki:每页都标出文件与行范围,概览从一条记录下来的调用路径展开,地图由记录到的引用生成
刚接手某个代码库的开发者,或想要一份有出处的结构图而不是模型散文的评审者
02如何接入 DeepSeek Harness?
前置条件
- Python 3.10+ 与 Git——README 在代码图配置里列了这两项
- 要索引的语言对应的工具链;README 强调「已注册能力」不等于机器上装好的工具,并指向 `codenib toolchain status`
- 代码图本身不需要模型、API Key 或 GPU,宿主 Agent 用自己配置的模型
安装步骤
- 01
从仓库的 `plugins/dsh` 路径安装 DSH bundle:`dsh plugin add "git+https://github.com/sysevol-ai/CodeNib.git#main&path:/plugins/dsh"`
$ dsh plugin add "git+https://github.com/sysevol-ai/CodeNib.git#main&path:/plugins/dsh"
- 02
安装 Python 侧:`python -m pip install "codenib[graph,mcp]"`,然后 `codenib codegraph init /path/to/your/repo` 建索引——初始化接受未提交改动并保留工作区
- 03
向 Agent 提问,例如「用 CodeNib 的 `explore_context` 找请求重试逻辑实现在哪里,并给出文件和行号」
验证接入成功
- `codenib toolchain status` 会列出机器上实际可用的语言后端
03DSH 适配与能力边界
从仓库的 `plugins/dsh` 路径装成 DeepSeek Harness bundle,把本地代码图工具交给宿主 Agent
给宿主 Agent 用的本地代码图
一份代码检出,包括未提交的改动→本地搜索索引与带类型的符号图,供已接入的 Agent 客户端查询
索引在本地构建,检出本身被保留`explore_context` 与 `dependency_subgraph`
一句自然语言问题,或要展开的符号→问题对应的排序源码锚点,以及一次调用返回深度 ≤ 8 的入向 / 出向静态引用
索引到的引用可能是调用、字段、类型使用或函数值,某条引用是否真的调用了函数仍要看源码确认Wiki 生成
`codenib wiki /path/to/your/repo --preset graph`→本地 `http://localhost:3000` 上的 Wiki:每个代码区域一页,每页标出文件与行范围,并有由记录引用构成的地图
页面由索引生成、不调用模型;加 `--generate --model <provider/model>` 才改用模型撰写已注册的语言支持
受支持语言写的仓库→14 种已注册语言中有 12 种能出代码图;Python、Go、Rust、C/C++、JavaScript、TypeScript 还带 LSP 或 clangd 增量后端
Swift 与 Lua 只做搜索,没有定义和调用者;已注册清单不代表本机工具链已装好
04适合谁?何时不该用?
适合
- 在不熟悉或很大的仓库里工作、需要 Agent 指明文件与行号的 DSH 用户
- 刚接手某个代码库的开发者,或想要一份有出处的结构图而不是模型散文的评审者
不适合
- 索引出的图可能缺外部与动态关系,一条引用也可能是调用、字段访问、类型使用或函数值——是否真的调用了函数仍要回到源码确认。
- CodeNib 处于 beta,稳定版之前公开接口可能变化;已注册的语言能力也不代表需要的工具链已经安装。
- 可选的 grep → Jev 检索路线用 OpenRouter 做规划与重排,选中的代码会发给远程模型;它与无模型的代码图是两条独立路径。
05兼容性、维护与安全提示
- 索引出的图可能缺外部与动态关系,一条引用也可能是调用、字段访问、类型使用或函数值——是否真的调用了函数仍要回到源码确认。
- CodeNib 处于 beta,稳定版之前公开接口可能变化;已注册的语言能力也不代表需要的工具链已经安装。
- 可选的 grep → Jev 检索路线用 OpenRouter 做规划与重排,选中的代码会发给远程模型;它与无模型的代码图是两条独立路径。
- ContextBench 榜单成绩描述的是 CodeNib 的研究型 Agent(Haiku 检索加 Opus 修复),不是本插件暴露的 Wiki 或代码图。
Apache-2.0 源码;本文所有事实均来自记录提交处的仓库 README,未做独立安全审计。
06常见问题
怎么把 CodeNib 装进 DeepSeek Harness?
README 给出的方式是装成 DSH bundle:`dsh plugin add "git+https://github.com/sysevol-ai/CodeNib.git#main&path:/plugins/dsh"`;Python 侧用 `python -m pip install "codenib[graph,mcp]"`,再用 `codenib codegraph init /path/to/your/repo` 建索引。
代码图需要另外准备 API Key 或模型吗?
不需要。CodeNib 用 SCIP/LSP 索引器在本地建搜索索引和带类型的符号图,自身不需要模型、API Key 或 GPU,宿主 Agent 用自己配置的模型。只有可选的 grep → Jev 路线会通过 OpenRouter 调远程模型。
DSH Agent 具体能问什么?
`explore_context` 用排序后的源码锚点回答自然语言问题,一次 `dependency_subgraph` 调用返回深度 ≤ 8 的入向与出向静态引用。README 提醒这些引用可能是调用、字段、类型使用或函数值,是否真的调用函数仍要看源码。
哪些语言有真正的代码图?
14 种已注册语言里 12 种有:Python、Go、Rust、C/C++、JavaScript、TypeScript 带 LSP 或 clangd 增量后端;C#、Java、Ruby、PHP、Kotlin、Scala 有代码图;Swift 与 Lua 只做搜索。`codenib toolchain status` 会显示本机实际装了什么。
公开的榜单成绩说的是 Wiki 还是插件?
都不是。README 说明 ContextBench 上的成绩(77.90% 行召回、77.60% Pass@1)来自 CodeNib 的研究型 Agent——两个 Haiku worker 负责检索,再由 Opus 修复——不是本插件暴露的 Wiki 或代码图。
07相关的 DSH 工作流
dsh-our-free-model
作者 ebony-vinyl
在 dsh 里装上这个插件即可,无需登录、注册或填 API Key,就能使用包括 DeepSeek V4.1 Flash、Kimi K3 在内的前沿模型——完全免费,不限量。 All you do is install this plugin in dsh: no login, no sign-up, no API key — the frontier models are just there, DeepSeek V4.1 Flash and Kimi K3 among them. Completely free, with no usage cap.
dsh-routing-suite
作者 yjh051108
DeepSeek Harness(dsh)路由套件:先装运行时注入器,再加载任务感知的推理模式路由预设(已实测 P1-P23)。
dsh-ops
作者 t-auto
A toolkit for low-level operations in DSH, designed to reduce token usage and task execution time / DSH 底层操作工具插件,旨在减少 Token 消耗与任务耗时
brooks-lint
作者 hyhmrright
基于 12 本经典工程书籍的 AI 代码评审工具,提供腐化风险诊断、书籍引用、严重度标签及 6 种分析模式。
08数据与来源
Grok Build reads the same plugin, and DeepSeek Harness installs it as a bundle:
dsh plugin add "git+https://github.com/sysevol-ai/CodeNib.git#main&path:/plugins/dsh"
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-12。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
