返回目录

codenib

精选清单收录维护状态: 活跃

sysevol-ai/codenib

添加 Codenib MCP 工具,为当前 Git 检出提供排序后的来源链接上下文和代码引用。

前往 GitHub项目主页
$ dsh plugin add "git+https://github.com/sysevol-ai/CodeNib.git#main&path:/plugins/dsh"

95

星标

6

Fork

Python

语言

Apache-2.0

许可证

2025-03-09

创建于

2026-11-13

最近推送

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 用自己配置的模型

安装步骤

  1. 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"

  2. 02

    安装 Python 侧:`python -m pip install "codenib[graph,mcp]"`,然后 `codenib codegraph init /path/to/your/repo` 建索引——初始化接受未提交改动并保留工作区

  3. 03

    向 Agent 提问,例如「用 CodeNib 的 `explore_context` 找请求重试逻辑实现在哪里,并给出文件和行号」

验证接入成功

  • `codenib toolchain status` 会列出机器上实际可用的语言后端

03DSH 适配与能力边界

DSH 适配原生运行时

从仓库的 `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 或代码图。
2025-03-092026-11-09v0.2.5

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 或代码图。

08数据与来源

  • 作者声明github.coma5e3844e62b4…

    Grok Build reads the same plugin, and DeepSeek Harness installs it as a bundle:

  • 作者声明github.coma5e3844e62b4…

    dsh plugin add "git+https://github.com/sysevol-ai/CodeNib.git#main&path:/plugins/dsh"

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-12。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。