dsh-codex-reasoning-router
适用于 DeepSeek Harness 的可组合多模型代理角色及旧版 Luna/Sol 推理路由
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:chenmzh/dsh-codex-reasoning-router#ccd16ef6d6972181de31c31caad0c7e96ac53b8fCodex Reasoning Router 以 dsh-codex-reasoning-router 发布，当前版本为 0.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
简体中文 | English | AI / LLM context
A composable multi-model Agent Roles plugin for DeepSeek Harness (DSH). Version 0.2 no longer requires a dedicated preset: it layers onto Standard, Code, or a user-defined preset.
Default roles:
brain: tool-less deep reasoning, using openai-codex/gpt-5.6-sol at max.coordinator: tool-less decomposition and integration advice, using Sol at high.worker: a real tool-capable DSH subagent, using gpt-5.6-luna at max, with absolute maxDepth: 2.agent_role_catalog: reads the current user's registered providers, models, and model-specific reasoning efforts.agent_role_run: runs any configured advisory or subagent role.The legacy luna-sol-reasoning-router preset and durable sol_consult state machine remain available, but route locking is disabled by default.
Version 0.3.1 targets DSH 0.1.2-rc.1. It uses the split client domain services and Session projection API; rebuild against the same DSH checkout used by the profile.
Install and authenticate the model provider first, then add this plugin:
pnpm dsh plugin --profile web add dsh-codex
pnpm dsh plugin --profile web add link:/absolute/path/to/dsh-codex-reasoning-router
Or install from GitHub:
pnpm dsh plugin --profile web add github:chenmzh/dsh-codex-reasoning-router
Restart DSH and create a new session. Since 0.2, no preset copy or preset switch is needed. Copy preset/luna-sol-reasoning-router only when enabling the legacy route-guard workflow.
See cordis.patch.yml for the complete default:
teamEnabled: true
presetIds: [] # empty = all presets
roles:
- id: brain
kind: advisory # tool-less one-shot reasoning
description: Deep reasoning
provider: openai-codex
model: gpt-5.6-sol
reasoningEffort: max
maxTokens: 3000
- id: coordinator
kind: advisory
description: Coordinate work
provider: openai-codex
model: gpt-5.6-sol
reasoningEffort: high
- id: worker
kind: subagent # real DSH child inheriting the current preset
description: Implement and verify
provider: openai-codex
model: gpt-5.6-luna
reasoningEffort: max
subagentProvider: spawn
maxDepth: 2 # absolute: root=0, descendants=1,2,...
toolDeny: [web_search] # optional; toolAllow is also supported
Roles may be added, removed, or renamed. Role ids must begin with a lowercase letter and contain lowercase letters, digits, _, or -.
| Field | Meaning |
|---|---|
kind | advisory is tool-less; subagent starts a real delegated agent |
provider / model | Omit both to inherit the caller; explicit values must exist in the live user catalog |
reasoningEffort | Omit for model/provider default; explicit values must be offered by that exact model |
systemPrompt | Optional role persona |
subagentProvider | spawn, fork, or another provider registered by the host |
maxDepth | Absolute delegation-tree cap, not a relative remaining-depth count |
toolAllow / toolDeny | Native DSH child tool visibility filters for subagent roles |
The plugin does not guess model capabilities. It reads ctx.llm.listProviders(), listModels(), and resolveModelInfo() at runtime. Invalid model/effort combinations fail before provider dispatch. agent_role_catalog exposes the same live directory to the agent.
The WebUI “Agent Roles → Trigger rules” tab persists these policies:
Per-turn deep-reasoning and coordination limits plus worker concurrency are enforced by the runtime. Every agent_role_run selects a trigger_reason; repeated deep consultation can require prior_advice_evaluation. Role mappings use strict choices from configured roles. Only customInstructions is free text.
With the default presetIds: [], select whichever preset you already want:
Standard preset + agent roles
Code preset + agent roles
custom preset + agent roles
In-process children inherit their parent's preset composition, workspace, delegated policy, and tools. The role then applies its own route, effort, persona, optional tool filter, and depth cap.
To limit the plugin to selected presets:
presetIds: [standard, code, my-review-preset]
Restore the 0.1 behavior with:
requiredPresetId: luna-sol-reasoning-router
lunaProvider: openai-codex
lunaModel: gpt-5.6-luna
solProvider: openai-codex
solModel: gpt-5.6-sol
initialSolReasoning: medium
escalatedSolReasoning: high
initialConsultEnabled: true
failOpen: true
Copy and select the shipped preset. The old mode still provides a tool-less Sol advisor, validates the Luna root route, limits one blocker to two successful consultations, and restores escalation from durable session events. The 0.2 default requiredPresetId: '' disables only the legacy guard, not Agent Roles.
maxDepth on every start.installModelSelection before the child request.pnpm install --offline
pnpm run check
pnpm pack --dry-run
The test suite covers both the legacy router invariants and the new live catalog, effort validation, tool-less advisory, worker route/effort, tool filter, and absolute-depth behavior.
Apache-2.0. See LICENSE.