DeepSeek Harness Plugin Hub

Publish and manage complete Harness Profiles. Discover Plugins for your next setup.

Explore

PluginsPresetsDocsNews

Community

Publish a pluginContactReport an issue

Resources

Plugin Hub on GitHubDeepSeek HarnessSystem statusPrivacy notice
© 2026 DeepSeek Harness Plugin HubPowered byPaxTech

Independent and unofficial. Not affiliated with, authorized by, or endorsed by DeepSeek.

DeepSeek Harness Plugin Hub
ProfilesPluginsCategoriesNewsDocsSign inManage Profiles
ProfilesPluginsCategoriesNewsDocsSign in
← Plugins
C

dsh-coderag

Coderag

Codebase retrieval engine for DeepSeek Harness, exposed over MCP

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add github:VermilionPasvikin/dsh-coderag#35ffdb29c110ce09a5a3d2142b7a7925d6badd3b
READMECompatibilityVersions

Compatibility and provenance

Coderag is published as dsh-coderag and currently resolves to version 2.1.1. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility
*
Runtime surfaces
any
Release source
github
Registry updated
9/30/2026

Versions

2.1.1stable
9/30/2026
2.0.0stable
9/25/2026
1.0.0stable
9/23/2026
Show 1 more versionCollapse versions
0.1.0stable
9/23/2026

Related plugins

Loading related plugins…

Latest
2.1.1
DSH
*
HMR
Process restart
Tree shaking
Safe tree shaking not declared
Unpacked size
Unavailable
Files
Unavailable
Surface
any
License
MIT
Source
github
GitHub
★ 0
Weekly downloads
0
Last push
11/1/2026
View source ↗
README badge

Click the badge to copy Markdown for your README.

Do you maintain this Plugin?Claim benefit · Priority security scan

Verify the GitHub repository declared in package.json to manage this listing. After you claim it, Hub will prioritize a security scan of the current version and publish the result when it passes.

Claim this Plugin →
Report an issue

Related plugins

More verified plugins in developer-tools.

Web App@deepseek-ai/dsh-web-appThe dsh browser-surface bundle: the web patch layer over dsh-base plus the runtime glue plugin (frontend dist serving, web-surface prompt, bash runtime variables, URL line)Sdk Minimal@deepseek-ai/dsh-sdk-minimalThe standalone minimal SDK profile bundle: JSON-RPC, one DeepSeek adapter, persistent shell, and JSONL sessionsSdk App@deepseek-ai/dsh-sdk-appThe dsh SDK profile bundle: stdio JSON-RPC serving and process lifecycle over dsh-baseExperimental Plugin Market Bundle@deepseek-ai/dsh-experimental-plugin-market-bundleExperimental custom plugin indexes: a Discover tab that browses and installs bundles from plugin indexes

README

dsh-coderag

⚠️ 安全声明(请先读)

安装本插件等于授予它与本机账号同等的机器权限。 DSH 的三档文件权限(read-only / workspace-write / danger-full-access)不约束插件 (依据:DSH tool-cordis README 与 agent-scope-contexts 笔记,见 AGENTS.md E-04)。 请只在你信任的仓库与本机上安装和运行。 本项目默认不联网、不采集遥测。

dsh-coderag 是给 DeepSeek Harness(DSH)用的代码库检索引擎,以 MCP 服务器形态运行: 让 Agent 能按「行为描述」直接找到代码,而不是靠猜关键词反复 grep。它只读你的代码,不改。


项目功能概述

  • 4 个 MCP 工具(固定,不动态增删):code_search(按自然语言或标识符检索,返回文件路径 + 行号 + 符号名)、 code_outline(单文件的符号大纲)、code_index(建/刷新索引,立刻返回 taskId,后台执行)、 index_status(索引状态与跳过统计)。DSH 侧看到的完整名字带 mcp__coderag__ 前缀。
  • 索引:SQLite FTS5 + 中文 bigram,落点 <工作区>/.coderag/index.sqlite3; 用 tree-sitter 按函数/类/接口等声明边界分块。增量索引——只重算内容哈希变化的文件; 并发度与批大小按 CPU/内存自适应推导,不硬编码;文件数超上限显式失败并报实际数量。
  • 检索:BM25 打分。选按分数、排按源码顺序(ADR-05)——同一批命中按文件与行号输出, 便于模型按行号去读原文。召回三级递进:精度(全部词元)→ 仅标识符 → 含 CJK bigram; 纯标点/短符号查询不做全表扫描,而是返回结构化提示引导改用 grep。
  • 状态永远可解释:索引未就绪、返回为空、后端不可用时都返回结构化 status(而非空列表), 模型不会把"没查到"误读成"不存在"从而编造。
  • 安全过滤:三层(内置密钥黑名单 → .gitignore/.coderagignore → 内容级正则), 命中的 chunk 不入库;过滤结果对模型可见(skipped: {count, reasons})。
  • 异步与预算:code_index 立刻返回、后台执行(避开工具调用 60 秒超时); 单次检索有 token 预算,超出部分显式报告省略条数而不是静默截断。

装上之后能带来多少提升(实测)

在一份 DSH 源码副本(3967 文件 / 63046 chunk)上,用同一套 13 个「找代码」任务各跑 3 次 (共 78 个真实模型会话),对比两个同配置的 headless DSH 实例:

  • A 组:纯净 profile(dsh-base + dsh-headless),只有基础的 bash / grep / glob / read。
  • B 组:同一个 profile,只多挂一层本插件的 patch(多出 code_search 等 4 个工具)。
指标A · 不装B · 装了 coderag差
任务成功率(39 次尝试)11/39 = 28.2%32/39 = 82.1%+53.8pp
95% Wilson 区间[0.165, 0.438][0.673, 0.910]不重叠
用例级「至少做对一次」4/13 = 30.8%13/13 = 100%+69pp
「三次全做对」3/13 = 23.1%7/13 = 53.8%+30.7pp
平均步数5.65.8+0.2
中位 token / 次80,07272,909−8.9%
总 token(39 次)6,169,5456,697,966+8.6%
token / 每个做对的任务560,868209,311−62.7%
用过 code_search 的用例0/1312/13+12

按问题类型拆开看,提升集中在「用中文描述、答案在英文代码里」的那两类:

问题类型A · 不装B · 装了 coderag
locate:描述行为,定位常量/文件在哪0/129/12
crossfile:跨文件链路(定义处 → 使用处 → 封锁处)0/1512/15
↳ 其中 semantic-gap:中文意图 ↔ 英文代码零词法重叠0/33/3
identifier:直接给标识符6/66/6
regression:标识符直查,装了不该变慢变差6/66/6
negative:仓库里根本不存在的东西,不该被编造5/65/6

一句话:不装插件时,Agent 在这 27 次「用中文问、答案在英文代码里」的定位/跨文件尝试中 一次都没找对(0/27);装上之后 21/27。而且简单直查题、回归题、反臆造题都没有变差 (identifier 与 regression 两组满分不变,negative 仅一条 3/3 变 2/3)。

成本上它不亏:典型一次查询的中位 token 反而降了 8.9%(不再反复 grep),总量只涨 8.6% (多出来的就是检索回来的代码片段),折算到「每个做对的任务」便宜 62.7%。

口径(请一起读):这 13 个任务刻意偏向"需要检索"的那一类(locate + crossfile + semantic-gap 占 10/13),所以 +53.8pp 不是真实流量上的提升幅度——真实提问里有大量精确标识符, 那些本来就不需要检索(上表 identifier 组差值为 0 正是证据)。它回答的是 「当问题确实需要检索时,装与不装差多少」。样本为单一语料、单一模型、13 条题 × 3 次; 3 次尝试不独立(同题重跑),真实置信区间比 Wilson 更宽。 原始数据:eval/runs/clean-a3/report.md(A 组)/ eval/runs/clean-b3/report.md(B 组)。


安装

前置:Python 3.10–3.12(requires-python = ">=3.10,<3.13")、 DSH、Git。 pnpm 不用自己准备:dsh 自带一个(实测:Windows 的 PATH 上没有 pnpm, dsh plugin add 仍用自带的 pnpm 11.7.0 正常完成)。

发布方式:只发布在 GitHub(tag / release),不发布到 PyPI、也不发布到 npm。 因此安装只能走下面这条「克隆」路径;pip install dsh-coderag 与 npm i dsh-coderag 都不可用。 当前版本 2.1.1 同样只在 GitHub 上以 tag / release 发布(v2.1.1),PyPI 与 npm 上没有任何版本。

平台状态(实测,2026-09-30):macOS 26.4 与 Windows 10(26100,win_amd64) 已实测通过—— 安装、dsh plugin add、--dump-config 与一次真实 code_search 两边都跑通,两边的全量 pytest 也通过。 Linux 尚未实测,因此本项目不声称支持 Linux。 三份证据:跨平台基线(依赖 wheel、FTS5、离线 grammar、MCP 子进程)、 macOS 复核、Windows 冒烟。 计划与判据见 PROJECT.md §6.5.1(T6-01–T6-05)。

macOS / Linux(POSIX shell)

# 1. 克隆(cordis.patch.yml 在仓库里,必须克隆)
git clone https://github.com/VermilionPasvikin/dsh-coderag.git
cd dsh-coderag

# 2. 装引擎并自检:这个薄包装只做「找到解释器 → 转发给 Python CLI 的 install-deps」
bash scripts/install.sh          # 受限网络:CODERAG_PIP_ARGS="--index-url <镜像>" bash scripts/install.sh

# 3. 验证引擎可用(这一步不涉及 DSH)
"$CODERAG_PYTHON" -m dsh_coderag doctor     # 打印可复制的 CODERAG_PYTHON
"$CODERAG_PYTHON" -m dsh_coderag index /path/to/repo
"$CODERAG_PYTHON" -m dsh_coderag search "用户令牌在哪里校验" --root /path/to/repo

# 4. 挂插件(推荐):把本仓库注册成 web profile 的一层,然后确认
./scripts/dsh plugin --profile web add .
./scripts/dsh --profile web --dump-config | grep -A2 '== dsh-coderag'
# 期望:先出现 # == dsh-coderag,紧接着 - id: mcp-coderag

# 5. 启动(web 应用来自 profile 自带的 @deepseek-ai/dsh-web-app)
./scripts/dsh --profile web

Windows(PowerShell)

先确认你手上的 python 是哪一个。 Windows 上 python / python3 很可能只是 Microsoft Store 的占位符——运行时会打印 Python was not found; run without arguments to install from the Microsoft Store …, 那不是你装的那个解释器。所以下面一律用显式路径变量 $py,不依赖 PATH:

py -0p                     # 列出本机已注册的解释器(Windows 官方 launcher)
& $py --version            # 换成你自己的路径,确认落在 3.10–3.12
# 1. 克隆
git clone https://github.com/VermilionPasvikin/dsh-coderag.git
Set-Location dsh-coderag

# 2. 指定解释器(示例是 conda 环境;换成你自己的路径)
$py = "C:\Users\<你>\miniconda3\envs\coderag\python.exe"
& $py --version                          # 期望:Python 3.10 / 3.11 / 3.12

# 3. 装引擎与依赖:PowerShell 里没有 sh,所以直接用解释器调 pip / CLI
& $py -m pip install .                   # 开发者:& $py -m pip install -e ".[dev,semantic]"
& $py -m dsh_coderag doctor              # 探测解释器 / 版本 / FTS5,并打印 CODERAG_PYTHON
& $py -m dsh_coderag index C:\path\to\repo
& $py -m dsh_coderag search "用户令牌在哪里校验" --root C:\path\to\repo

# 4. 把解释器交给 patch(重要:patch 内置默认值是作者机器的 macOS 路径)。
#    这一句只对当前 PowerShell 窗口有效;DSH 从同一个窗口启动就继承得到。
$env:CODERAG_PYTHON = $py

# 5. 找一个能用的 dsh(见下方说明;本仓库的 ./scripts/dsh 是 sh 脚本,PowerShell 里跑不了)
$dsh = "F:\dsh\resources\runtime\cli\bin\dsh.cmd"   # 换成你自己的路径,或直接写全局 dsh 的路径
& $dsh plugin --profile web add .
& $dsh --profile web --dump-config | Select-String -Pattern '== dsh-coderag' -Context 0,2
# 期望:先出现 # == dsh-coderag,紧接着 - id: mcp-coderag

# 6. 启动
& $dsh --profile web

dsh 在 Windows 上不一定在 PATH 上(AGENTS.md E-07)。本机实测可用的两种写法: ① 桌面版自带的 CLI——<DeepSeek Harness 安装目录>\resources\runtime\cli\bin\dsh.cmd (本机是 F:\dsh\...、版本 0.2.0-rc.2,上面第 5 步用的就是它); ② Git for Windows 的 bash + 仓库里的薄包装——bash scripts/dsh --profile web(会回退到钉版本的 npx)。 你自己装过全局 dsh 的话,dsh ... 直接可用。

两条路线的区别(Windows 与 macOS 均实测): dsh plugin --profile web add . 会把自带的 web 模板复制成你的 profile(package.json 里 bundles: ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-coderag"])——所以它既能挂上 本插件、又保留了 web 应用,--dump-config 里会多出 # == dsh-coderag 这一层标记。 而 & $dsh --profile web --patch .\cordis.patch.yml 只是临时叠加:dump 里只有 - id: mcp-coderag、没有 # == dsh-coderag。长期使用走 plugin add,改 patch 时用 --patch 叠加调试。 不要给一个全新的 profile 名(如 --profile coderag)当启动目标——它只拿到 dsh-base + 本插件, 没有 web 应用,dsh --profile coderag 起不来界面;它只适合拿来 --dump-config 验证。

为什么 Windows 用 & $py -m pip install . 而不是 install-deps:& $py -m dsh_coderag … 要求包已经可导入,而全新 clone 上它还没装。install-deps 做的是「装 + 装后自检」, 在包可导入之后随时可以重跑它。装了 Git for Windows 的话,也可以直接在 Git Bash 里跑 bash scripts/install.sh(实测可用)。

CODERAG_PYTHON 不设会怎样:patch 的内置默认值是 /opt/anaconda3/envs/forBSH/bin/python——那是作者本机的路径,在你的机器上多半不存在, MCP 子进程会启动失败。所以第 4 步不是可选项。

--patch 的位置:--profile / --patch 是启动器选项,必须写在 Web 应用自己的选项 (--port / --no-open / --host)之前,否则报 error: unknown option '--patch'。 正确写法:./scripts/dsh --profile web --patch ./cordis.patch.yml --port 3099(实测)。

dsh 不一定在 PATH 上,所以 macOS / Linux 上本仓库统一用 ./scripts/dsh(AGENTS.md E-07); 若你已有全局 dsh,它等价于直接敲 dsh。Windows 上没有 sh,请直接用全局 dsh 或 npx @deepseek-ai/dsh@<钉的版本>——./scripts/dsh 在 PowerShell 里跑不了。

两个 shell 脚本的平台范围:scripts/install.sh(bash)与 scripts/dsh(sh)是 macOS / Linux 用法;它们只做「找到解释器 → 转发」,安装与自检逻辑都在跨平台的 Python CLI (dsh-coderag doctor / install-deps)里,所以三个平台走的是同一条代码路径, 而且那条路径能被 pytest 直接覆盖。

怎么确认装上了——dsh plugin add 在 pnpm 非零退出时会静默跳过 bundle 登记, 插件看起来装上了却永远不会加载(AGENTS.md E-05)。务必自查这一条:

# macOS / Linux
./scripts/dsh --profile <名字> --dump-config | grep -A2 '== dsh-coderag'
# Windows
dsh --profile <名字> --dump-config | Select-String -Pattern '== dsh-coderag' -Context 0,2

期望看到 # == dsh-coderag,紧随一行 - id: mcp-coderag。

现象怎么办
--dump-config 里没有 # == dsh-coderagbundle 没被登记:回头看 add 的 pnpm 报错;若报 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED,把 pnpm 打印的精确 key 写进 ~/.dsh/profiles/<名字>/pnpm-workspace.yaml 的 allowBuilds: 下(<key>: true)后重跑 add
会话里没有 mcp__coderag__code_searchMCP 子进程起不来,最常见是解释器路径。macOS / Linux:export CODERAG_PYTHON=<真正装了 dsh_coderag 的解释器>;Windows:$env:CODERAG_PYTHON = "<同一个路径>"。用 python -m dsh_coderag --version(或 "$CODERAG_PYTHON" -m dsh_coderag --version)确认
pip install 报 externally-managed-environmentPEP 668:用 conda 或 venv;不要用 --break-system-packages
中文检索总是空该解释器的 SQLite 没编译 FTS5:macOS / Linux 上 bash scripts/install.sh、Windows 上 python -m dsh_coderag install-deps 都会预检并给指引

更完整的安装实录与边界见 docs/m4-install-verification.md。

配置

运行时参数只从环境变量读,唯一入口是 src/dsh_coderag/config.py,没有用户配置文件。

stdio 子进程的环境会被清洗:继承来的环境里,匹配 *KEY* / *PASSWORD* / *SECRET* / *TOKEN* 的变量与所有 DSH_* 变量都会被删除。清洗之后,cordis.patch.yml 的 config.env 会合并到最上面 (已核实:{...scrubbedParentEnv(), ...extra})——所以写进 patch 的一定到得了子进程,在 shell 里设的不一定。

配置写在哪(按推荐顺序):

写在哪Windows 上的路径适合什么会不会入库
profile 的 cordis.patch.yml%USERPROFILE%\.dsh\profiles\<profile>\cordis.patch.yml本机持久设置,包括密钥字面值❌ 仓库之外,不会
$DSH_HOME/cordis.patch.yml%USERPROFILE%\.dsh\cordis.patch.yml同上,且优先级更高(对所有 profile 生效)❌ 仓库之外,不会
启动 dsh 的那个 shellexport X=...(macOS / Linux)/$env:X = "..."(PowerShell)只对"名字不含 KEY/PASSWORD/SECRET/TOKEN"的变量有效;只活到窗口关闭❌ 不涉及文件
仓库里的 cordis.patch.yml(env: 块)同左非密钥的默认值;密钥只能用 !!js 表达式⚠️ 会(RL-02:绝不能写真实 key)

哪些变量在 shell 里设不生效:名字里含 TOKEN 的 CODERAG_MAX_TOKENS 会被清洗掉;云端的 API key 同理。 这两个必须写进上面任一处 patch 的 env: 里。CODERAG_ROOT 与 CODERAG_PYTHON 例外—— 它们在 cordis.patch.yml 里已被 !!js 引用,由宿主进程读取你的 shell 环境 (PowerShell 用 $env:CODERAG_PYTHON = $py,macOS / Linux 用 export CODERAG_PYTHON=...)。

Windows 上覆盖到一个持久位置——把下面这段写进 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml(该文件由 dsh plugin --profile web add . 生成, 初始是 []):

- id: mcp-coderag
  config:
    serverName: coderag
    transport: stdio
    command: 'C:\Users\<你>\miniconda3\envs\coderag\python.exe'
    args: ['-c', 'import dsh_coderag.server as s; s.run()']
    env:
      CODERAG_ROOT: 'C:\path\to\your\workspace'
      CODERAG_MAX_TOKENS: '8000'

改完用 dsh --profile web --dump-config(在配好的 DSH_HOME 下)确认组合结果。

覆盖时注意:DSH 的 patch 是「整体替换」而不是深合并——DSH schema 自己的说明就是 "A patch config replaces the whole config."。实测:只写 config.env 一项去覆盖 mcp-coderag 时,serverName / transport / args 会从结果里消失。所以上面那个例子把要保留的 字段全部重写了一遍;如果你还改了 cordis.patch.yml 里其它 env 项,也要一并抄过来。

变量作用默认生效情况
CODERAG_PYTHON运行 MCP 服务器的解释器路径作者机器上的 forBSH 路径(请覆盖)✅ 由 DSH 读(patch 里的 !!js)
CODERAG_ROOT要索引的工作区根DSH 进程的工作目录✅ MCP 服务器读它决定工作区
CODERAG_MAX_TOKENS单次检索返回的 token 预算4000✅ 作为 code_search 的默认预算;某一次调用传入 max_tokens 参数仍可覆盖它
CODERAG_MAX_FILES文件数上限,超限显式失败并报实际数量(不静默截断)20000✅ 建索引时生效;index_status 在超限时返回 INDEX_TOO_MANY_FILES + 实际数量
CODERAG_MAX_FILE_BYTES单文件大小上限,超过则跳过并计入 skipped.too_large1048576(1 MiB)✅ 建索引时生效,且 index_status 的 skipped 统计与它一致
CODERAG_BATCH_SIZE索引写库批大小(不设则自适应推导)自适应(1–512)✅ 建索引时生效
CODERAG_MAX_WORKERS索引并发度(不设则按 CPU/内存推导)自适应(上限 8)✅ 建索引时生效

这些变量曾经在 MCP 路径上全部不生效(config.py 读了,但 server.py 建索引时没把配置传下去、 检索预算还硬编码 4000),v2.1.0 发布时如实标注为 ⚠️。已在 T6-07 修好接线并补了 3 条测试—— 这 3 条测试在修复前会红(assert 2 == 1、命中数未被裁剪),因此这条路径不会再次静默失效。

它是怎么工作的

  • 引擎是 Python 包 dsh_coderag,以 MCP stdio 服务器运行。
  • DSH 通过内置包 @deepseek-ai/dsh-mcp-client 在本机拉起一个子进程 (dsh_coderag.server 的 stdio 入口,见 cordis.patch.yml),两者用 stdin/stdout 上的 JSON-RPC 通信,不经过网络、不监听端口。
  • 索引存放在 <工作区>/.coderag/index.sqlite3(SQLite FTS5 + 中文 bigram), 不写到工作区之外(AGENTS.md S-03/S-04),并被 .gitignore 排除。
  • 分块用 tree-sitter 按函数/类/接口等声明边界切分;检索用 BM25, 选按分数、排按源码顺序(ADR-05)。
  • 大文件重排/超限保护:文件数超 CODERAG_MAX_FILES、单文件超 CODERAG_MAX_FILE_BYTES 都会显式报告(进 skipped 或直接失败),不静默丢弃。
  • 仓库根的 cordis.patch.yml 同时充当本地开发 overlay 与可分发的 bundle patch: dsh plugin add . 之后 DSH 的组合配置里会出现 # == dsh-coderag 层(实测,见 docs/m4-bundle.md)。
  • 关于 dsh plugin add 的一个坑:pnpm 10+ 遇到依赖带 install/build script 时会拒绝执行, 并让 add 静默跳过 bundle 登记(插件看起来装了却永不加载)。本项目不含任何 install script,首次 add 不会触发它(干净 profile 实测,见 docs/m4-install-verification.md)。

安全与隐私警告

  • 三层过滤(AGENTS.md §4.1,按顺序、缺一不可): ① 内置密钥黑名单(.env*、*.pem、*.key、id_rsa*、.npmrc、.ssh/、.aws/ …); ② 项目的 .gitignore → .coderagignore(用 pathspec,不自造 gitignore 语义); ③ 内容级正则(私钥头、AKIA…、sk-…、ghp_…、xox…)——命中的 chunk 不入库, 且只记路径与模式名,绝不记录匹配到的内容。
  • 过滤结果对模型可见:code_search / index_status 会报告 skipped: {count, reasons}, 避免模型把"被过滤"误读成"不存在"从而编造。
  • 默认不联网、不采集遥测、不外发任何数据(AGENTS.md S-01/S-02)。
  • 索引只写在工作区内:<工作区>/.coderag/index.sqlite3,且被本仓库的 .gitignore 排除。

⚠️ 云端 embedding 后端的外发风险

本项目默认不联网。仅当你显式启用可选的云端 embedding 后端 (CODERAG_SEMANTIC=on 且 CODERAG_SEMANTIC_BACKEND=openai 且 非 loopback 地址时还要 CODERAG_SEMANTIC_ALLOW_REMOTE=1,条文见 docs/adr/ADR-17-optional-cloud-embedding.md) 时,才有下列外发行为:

  • 外发内容:已入库 chunk 的文本,包括每个 chunk 的上下文前缀行 (形如 // file: <工作区相对路径> | symbol: <种类 名字> | lines <起>-<止>)。 也就是说文件路径与符号名也会一并外发。
  • 仍然受保护的部分:三层过滤在入库前执行,被拦下的密钥文件(.env*、*.pem、id_rsa* 等) 从来没有 chunk,不可能被外发。
  • 不再成立的部分:本地后端承诺的"代码不出机器"在云端后端下不成立。
  • 费用:云端按 token 计费;首次索引会对全量 chunk 做 embedding,是一次性真实支出。
  • 合规:代码可能是公司资产或含第三方许可限制。外发前请自行确认你有权发给该服务商。
  • API key:只从环境读,绝不写进仓库、配置文件字面值、README 示例、测试或日志。
  • 传输:非 loopback 地址必须显式设 CODERAG_SEMANTIC_ALLOW_REMOTE=1,请使用 https://。

文档

文件内容
PROJECT.md项目概况、架构、ADR 表、任务表与进度追踪
AGENTS.md强制性约束:红线、DSH 环境坑、安全规范、提交规范
EVAL.md / TESTING.md评测方案 / 测试方案
docs/architecture.md已实现的架构:模块与依赖方向、索引/检索数据流、数据模型、工具契约
docs/eval-report-m3.mdM3 的 L1/L2 评测报告(分层指标 + 逐条 diff + 失败归因)
docs/eval-report-m3c.mdC 组(混合检索)评测报告与 V1–V4 判定
eval/runs/clean-a3/report.md / clean-b3本文「装上之后能带来多少提升」的原始数据(洁净组 / 装插件组)
docs/adr/决策记录:ADR-14(是否引入向量)、ADR-15(执行时机)、ADR-16(可选后端形态)、ADR-17(云端后端)
docs/m4-bundle.md / docs/m4-install-verification.md可分发的 DSH bundle 装载实测 / 安装验证实录

MIT,见 LICENSE。

docs/backlog.md
已知但未修的缺陷与欠账
CHANGELOG.md版本变更记录(Keep a Changelog)
cordis.patch.ymlDSH 接入配置(dev overlay 兼 bundle patch)