Skip to main content
plugin CX Codex

deepseek-minimal-anchor — Claude Code plugin: what it does

The deepseek-minimal-anchor plugin tunes DeepSeek sessions in Codex: Pro keeps a one-line anchor, while Flash follows a task-aware decide-and-verify contract.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install deepseek-minimal-anchor@awesome-codex-plugins
Open on GitHub

What deepseek-minimal-anchor does

deepseek-minimal-anchor targets deepseek-v4-pro and deepseek-v4-flash in Codex. Pro receives only the official Minimal instruction. Flash gets a task-based contract that closes reasoning blocks with a decision or an information need, runs a concrete check after coding, and retries once when that check fails.

Hooks are the main delivery path: they place the contract into developer context. A bundled skill takes over when application hooks cannot run. The contract is restored after context compaction, and each injection is written to ~/.codex/deepseek-minimal-anchor-reports/hook-log.jsonl. Ask whether the mini-router is active to inspect the current path.

Hook trust is required once; after a plugin update, trust it again and start a new thread. You can force or disable the anchor with DEEPSEEK_MINIMAL_ANCHOR=always|never, or choose a route with DEEPSEEK_MINIMAL_ANCHOR_MODE=auto|spec|react|flash. A BigCodeBench subset measured Flash v4 at 16/18, though the sample was small and covered only the react side.

What it helps with

  • keep deepseek-v4-pro on a minimal system anchor
  • route deepseek-v4-flash through decide-and-verify steps
  • restore the contract after context compaction
  • inspect hook activity in the audit log
  • compare Flash persona variants on a BigCodeBench subset

Example prompts for the agent

  • Check whether the mini-router is active and read ~/.codex/deepseek-minimal-anchor-reports/hook-log.jsonl.
  • In a new thread using deepseek-v4-flash, solve the coding task and run a concrete check after writing the code.
  • Set DEEPSEEK_MINIMAL_ANCHOR_MODE=spec, then report which contract is active.

How to install deepseek-minimal-anchor

Plugin marketplace

/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install deepseek-minimal-anchor@awesome-codex-plugins

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about deepseek-minimal-anchor

How do I install deepseek-minimal-anchor in Claude Code?

Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then run /plugin install deepseek-minimal-anchor@awesome-codex-plugins.

What does deepseek-minimal-anchor do?

It changes the DeepSeek working contract in Codex. deepseek-v4-pro gets a single Minimal instruction, while deepseek-v4-flash uses task-aware decisions, verification, and one retry after a failed check.

Which models and modes does the plugin support?

Automatic routing covers deepseek-v4-pro and deepseek-v4-flash. spec and react are experimental routes selected through DEEPSEEK_MINIMAL_ANCHOR_MODE.

Source text

codex-deepseek-mini-router · MIT
# DeepSeek Mini-Router(Codex 插件)

[English](README.en.md) | **中文(默认)**

给 Codex 里的 DeepSeek 模型(`deepseek-v4-pro` / `deepseek-v4-flash`)注入
「Pro 极简锚定 + Flash 任务感知路由」的插件:Pro 只注入官方 Minimal 的一句
系统提示词,Flash 按任务锁定 decide & verify 路由 persona;桌面应用钩子不可用
时由内置技能兜底,会话会主动说明当前走哪条通道。

**适用对象**:在 Codex(桌面或 CLI,官方 Responses API)里使用 DeepSeek 的人;
希望 Pro 保持官方 Minimal 一句的极简锚定(社区实测的高分条件),希望 Flash
稳定「决策 + 验证」而不是长篇自说自话。

在 6 任务 BigCodeBench 子集(`deepseek-v4-flash`)上的实测:
**基线 8/12 → 路由 v0 10/12 → 路由 v4「decide & verify」16/18**。
完整方法、逐题矩阵与诚实边界见 [docs/evidence.md](docs/evidence.md);
可复现跑批见 [bench/](bench/README.md)。

## 快速开始

```sh
git clone https://github.com/hccccc01333/codex-deepseek-mini-router
cd codex-deepseek-mini-router
codex plugin marketplace add .
codex plugin add deepseek-minimal-anchor@codex-deepseek-mini-router
```

然后:

1. 信任钩子一次(应用插件设置或 CLI 的 `/hooks`);信任按哈希绑定,插件更新后
   需重新信任并开新线程。
2. 新线程 + DeepSeek 模型,契约自动生效。
3. 随时问「mini-router 生效了吗」,助手会读审计日志回答
   (`~/.codex/deepseek-minimal-anchor-reports/hook-log.jsonl`)。

环境变量:

- `DEEPSEEK_MINIMAL_ANCHOR=always|never` —— 强制 / 禁用
- `DEEPSEEK_MINIMAL_ANCHOR_MODE=auto|spec|react|flash` —— 手动路由

## 工作模式

| 模式 | 谁触发 | 契约 |
| --- | --- | --- |
| pro | `deepseek-v4-pro`(自动) | **极简锚定**:只注入官方 Minimal 一句 `You are a helpful software engineer assistant.`,不再追加任何引导 |
| flash | `deepseek-v4-flash`(自动) | **决策 + 验证**:一步定任务类型、每个推理块以决策或信息需求收尾、写码后跑具体检查、失败重试一次 |
| spec / react | 仅环境变量强制(实验) | 保留旧分类 persona,仅作对照 |

模式会话内锁定,绝不中途翻转;Flash 每轮按任务复杂度注入引导(复杂任务附加
「决策闭环」深锚),Pro 保持一句极简、不再追加。双通道交付:**钩子**是主通道
(桌面 + CLI),把契约作为
developer 上下文注入;**技能**是兜底通道,携带同一份契约并主动说明当前走哪条
通道。上下文压缩(compact)后会自动重新锚定契约,防止 persona 中途退化。
每次注入都写入审计日志。

## 「v4」到底是什么(命名对照)

README 里有两个容易混淆的编号:

- **插件版本**:v1 = 静态 minimal 锚定 → **v2 = 迷你路由(当前)**,这是插件代际;
- **Persona 变体**:v0–v6 是 Flash 工作契约的内部筛选编号,**不是插件版本**。

| Persona 变体 | Flash 契约 | 成绩(BigCodeBench 6 任务) |
| --- | --- | --- |
| v0 | 五锚(社区 w7 一脉) | 10/12(n=2) |
| v1 | 先复现 | 5/6(n=1) |
| v2 | 规格转代码 | 4/6(n=1) |
| v3 | 快速收敛 | 3/6(n=1) |
| **v4** | **决策 + 验证(当前默认)** | **16/18(n=3)** |
| v5 | 验证优先 | 4/6(n=1) |
| v6 | 决断第一人称(I need / I will) | 10/12(n=2) |

所以「router v4」= **persona 变体 4(决策 + 验证)**,不是插件 4.0。v4 是唯一
超过 v0 的变体;v6 与 v0 持平,但优势在小样本上是任务级噪声(详见
[docs/evidence.md](docs/evidence.md))。

## 实测证据(可复现)

![Pass rate by arm](docs/pass-rate-by-arm.png)

![Per-task pass-rate heatmap](docs/per-task-heatmap.png)

![Reasoning-style metrics by persona variant](docs/thinking-metrics.png)

核心数字(BigCodeBench v0.1.4,6 任务子集,本地评分):

| 臂 | 通过率 |
| --- | --- |
| Flash 基线(无插件,n=2) | 8/12(67%) |
| Flash v0 五锚(n=2) | 10/12(83%) |
| Flash v4 决策+验证(n=3) | **16/18(89%)** |
| Pro 基线(n=1) | 5/6(83%) |
| Pro 强制 spec(n=1) | 4/6(67%) |
| Pro 路由(n=1) | 5/6(83%) |

7 个 persona 变体筛选中,v4(决策 + 验证)是唯一超过 v0 的;思考链内容可从会话
transcript 的 `reasoning_text` 提取并打分。

> Pro 现在默认走极简一句锚定(路由不再用于 Pro);上表中的 Pro static/router
> 是历史对照:路由对 Pro 没有带来超过基线的提升,所以 Pro 只保留 Minimal 条件。

诚实边界:样本小(n=1–3)、只测了「按规格实现」的 react 侧(spec 维护侧尚未
在 Codex 里测);措辞(I need vs let me)只换失败题不换总分;本项目不背书
「超过 Opus 4.8」类第三方说法。完整方法见 [docs/evidence.md](docs/evidence.md),
跑批见 [bench/](bench/README.md)。

## 开发 / 授权

```sh
cd plugins/deepseek-minimal-anchor
npm test            # 14 个单测 + 钩子测试
```

跑批复现:见 [bench/README.md](bench/README.md);图表:
`python bench/make-charts.py`。MIT 许可([LICENSE](LICENSE)),设计参考
dsh-router-standard、dsh-anchored-standard、modeltest(详见
[NOTICE.md](plugins/deepseek-minimal-anchor/NOTICE.md))。社区项目,
与 DeepSeek、OpenAI 无隶属关系。

官方 Plugins Directory 提交素材与自检清单:
[docs/publish-checklist.md](docs/publish-checklist.md)。

© Hzz · MIT · hashgraph-online/awesome-codex-plugins

Similar plugins

All plugins for Agent setup: memory, context, orchestration →

From the same set391

The whole set →
designer-skill designer-skill is a plugin for Claude Code and Codex that routes UI design requests, retrieves guides, and checks code against 44 static rules without an API key. CX Codex ★ 1,596repo stars design-helper The design-helper plugin puts CSS, layout, and motion options side by side in a browser, then applies your choice to the project. Use it before committing to a UI change. CX Codex ★ 1,596repo stars delx-recovery delx-recovery — a plugin that reopens an agent's earlier sessions, records where the work stands and turns failures into a recovery plan. Session memory sits on a hosted MCP server. CX Codex ★ 1,596repo stars dejavu-gates dejavu-gates catches repeating tool failures across sessions and turns them into automatic reminders followed by hard execution blocks. CX Codex ★ 1,596repo stars debt-ops The debt-ops plugin for Claude Code and Codex records deferred agent decisions in a repo registry; its review skill ranks debt by file churn. CX Codex ★ 1,596repo stars core-learning core-learning structures study sessions around Socratic questioning, Feynman teach-back, and spaced recall to deliver working projects. CX Codex ★ 1,596repo stars context-guard context-guard is a Claude Code and Codex plugin that preserves requirements and verification evidence in long Codex tasks. It restores open items after context compaction and checks evidence before marking work complete. CX Codex ★ 1,596repo stars codex-attachment-manager codex-attachment-manager is a Claude Code plugin that manages image history in Codex tasks. It selects attachments for the next message and searches them by description. CX Codex ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open