dsh-router-flash

One-Line Positioning

This is a DSH agent preset distribution package: upon installation, DSH will automatically synchronize the router-flash preset — which implements "task-type routing + tool tiered release" — to the local system on startup. After restarting, it enables the author-marked "god mode" guidance state for opencode-go's deepseek-v4-flash.

Core Capabilities

• Automatically syncs the bundled agent preset files to ~/.dsh/.agent-presets/router-flash on startup, no manual copying required
• Identifies if the current model ID belongs to the Flash series; if so, injects the exclusive lightweight guidance persona (task classification + review + staying on topic + deep thinking + decision闭环)
• First-round conversation only exposes a limited set of core tools (read/write/edit plus platform shell); the complete tool directory is unlocked after the first tool call
• Non-Flash models use keyword classification logic: determines build (implement first) or fix (investigate first then act) mode based on the user's first message, matching the appropriate persona and core toolset
• Cross-platform adaptation: Linux/macOS automatically uses bash tool, Windows automatically switches to PowerShell tool

Technical Implementation

• Language: JavaScript (ESM, type: module) + Cordis YAML configuration + Markdown prompts
• Key Dependencies: No third-party npm dependencies; uses only Node built-ins node:fs/promises, node:os, node:path, node:url
• Architecture Pattern: Standard DSH bundle dual-sided plugin (host side syncs preset files to local, client side is empty implementation placeholder), and inserts router-flash combined line into host configuration via cordis.patch.yml
• Entry Files: lib/index.js (host sync logic), preset/router-bootstrap.mjs (system-prompt/assemble hooks, routing persona and toolset)

Applicable Scenarios

Users currently using opencode-go provider with deepseek-v4-flash model often find that Flash tends to think shallowly and act hastily by default. This package is suitable for such cases: it bundles the author's tested optimal lightweight persona and first-round tool narrowing strategy, allowing you to get stable deep planning and high-quality delivery in regular complex engineering tasks. If you use Pro or other models, this package is also compatible, but the improvement mainly comes from Flash-specific guidance optimization.

Prerequisites & Compatibility

Installation

dsh plugin --profile web add github:xiaoxianyu-office/dsh-router-flash

Configuration

No additional configuration required for this plugin. After installation, please manually follow the two steps in README to point agent-presets.default to router-flash in ~/.dsh/settings.yaml, and set the model to opencode-go's deepseek-v4-flash (with reasoningEffort: max).

FAQ

Q: Who is this plugin for? Can I use it without deepseek-v4-flash model?

A: Primarily for users using opencode-go provider with deepseek-v4-flash. Non-Flash models can also load this preset; it will automatically fall back to keyword-based build/fix classification routing without errors, but the Flash-specific lightweight guidance effect is not significant for them.

Q: What else do I need to do after installation for it to take effect?

A: After installation, you must restart DSH once (so the host side syncs preset files to local), then set agent-presets.default to router-flash in ~/.dsh/settings.yaml, and switch the default model to opencode-go's deepseek-v4-flash. After another restart, new sessions will use this preset.

Q: Will my manually modified preset files be overwritten during upgrades?

A: Your modifications to unchanged package files will be preserved; files with new versions in the package will overwrite your local copies. Uninstalling the bundle does not automatically delete the ~/.dsh/.agent-presets/router-flash directory; for complete cleanup, you need to manually delete that directory and remove references from settings.yaml.

Q: How is this different from the original dsh-router-standard?

A: The original version relies on three mechanisms that became ineffective on DSH rc.6 (session/event cross-domain monitoring, agent.inbox.append, reading not-yet-arrived user/message during assemble phase). This package instead statically merges deep guidance into the WEAK_FLASH persona, with no reliance on any dynamic injection, equally effective for fixed tasks.

Q: Can it be used on Windows?

A: Yes. The preset internally automatically disables bash tool and enables pwsh tool based on process.platform; the shell allowed before the first tool call is pwsh. Other guidance logic (persona, model recognition, routing) is independent of the operating system.

Q: Why can only read/write/edit be used in the first round?

A: This is the author's "lightweight mode" strategy for Flash: using the minimum toolset forces the model to read/think clearly before acting, preventing Flash from acting rashly in complex tasks. After the first tool/call completes, the complete tool directory automatically unlocks.

Getting Started Difficulty

Beginner — One installation command, restart DSH, modify two lines in settings.yaml, and it takes effect. No need to understand the plugin's internal Cordis orchestration to use directly.

Known Issues & Limitations

• Uninstalling this bundle does not automatically clean up the ~/.dsh/.agent-presets/router-flash directory or the agent-presets.default reference in ~/.dsh/settings.yaml; users need to manually delete and revert (README.md:50)
• router-bootstrap contains an empty overrides Map (storing explicit modes by session id); currently no code path writes to it; it's a reserved extension point for future external tuning (preset/router-bootstrap.mjs:25)
• This plugin's author's empirical conclusions highly rely on dsh-router-standard's lightweight persona routing research; other underlying DSH versions (non-rc.6) may become ineffective due to host/agent plane division differences; minimum version is fixed at rc.6+ (README.md:80)
• Tool narrowing only occurs during system-prompt/assemble phase; clients or custom session entries outside DSH that bypass this hook will get the complete toolset (preset/router-bootstrap.mjs:27)

让 opencode-go 的 DeepSeek V4 Flash 从「鬼模式」切换到「神模式」的 dsh agent preset 标准分发包。

标准 DSH bundle 插件包：安装后自动把 router-flash preset 同步到 ~/.dsh/.agent-presets/router-flash，重启 DSH 即生效。原 install.sh 手动复制方式已由本 bundle 替代。

这是什么

一个 DeepSeek Harness（dsh）的 agent preset 分发包。它把 dsh-router-standard 研究里为 Flash 标定的最优引导（w7 persona + 深度思考锚）适配到 opencode-go provider 的 deepseek-v4-flash 上。

核心问题：Flash 在默认（无引导）条件下会进入「鬼模式」——思考浅、草草动手、质量差。这不是 Flash 能力不行，而是引导条件不对。补上正确的引导（分类 + 回顾 + 反跑题 + 深度思考 + 决策闭环），Flash 就能进入「神模式」——深度规划、高质量交付、自测零错误。

安装

dsh plugin --profile web add -w github:xiaoxianyu-office/dsh-router-flash#v0.1.0

安装后重启 DSH：router-flash preset 会被自动安装到 ~/.dsh/.agent-presets/router-flash。

然后编辑 ~/.dsh/settings.yaml，把默认 agent preset 指向它（模型也需指向 Flash）：

agent-default-model:
  provider: opencode-go
  model: deepseek-v4-flash
  reasoningEffort: max
agent-presets:
  default: router-flash

再次重启 dsh，新会话即使用 router-flash preset + deepseek-v4-flash 模型。

升级

重复 add 并指定最新 tag，不要使用 update 选择 Git 引用：

dsh plugin --profile web add -w github:xiaoxianyu-office/dsh-router-flash#v0.1.0

重启 DSH 后，包内变更的 preset 文件会自动覆盖到 ~/.dsh/.agent-presets/router-flash。

卸载

dsh plugin --profile web remove dsh-router-flash

卸载后重启 DSH。注意：bundle 安装的 preset 文件（~/.dsh/.agent-presets/router-flash）会保留，如需彻底移除可手动删除该目录，并在 ~/.dsh/settings.yaml 中移除 agent-presets.default 指向。

使用

1. 安装并配置后重启 dsh，新会话会自动使用 router-flash preset + deepseek-v4-flash 模型。
2. 直接提交任务即可。persona 会自动注入「分类 + 回顾 + 反跑题 + 深度思考 + 决策闭环」五个锚。
3. 会话启动后，模型的 system prompt 应包含：

   You are a helpful assistant.
   Before acting, decide the task type (build or fix)...
   Before acting, briefly review what you have already done...
   Do not run environment checks (echo, whoami, uname...)...
   Think deeply about the architecture, edge cases...
   Produce when your information is complete...
   

跨平台支持

本 preset 三平台通用，dsh 会自动选择 shell 工具：

说明：agent.cordis.yml 内已有 process.platform === 'win32' 判断，Windows 自动禁用 bash、启用 pwsh。核心路由逻辑（persona / 引导 / 模型识别）与操作系统无关。

依赖

• DeepSeek Harness（dsh）rc.6+
• opencode-go provider 的 deepseek-v4-flash 模型（https://opencode.ai/zen/go/v1）

适配了什么（与原版 dsh-router-standard 的区别）

原版依赖三个在你的 dsh 版本上会失效的机制，本 preset 已修复：

1. ctx.on('session/event') 注入 —— dsh rc.6 中 session/event 是 session-scoped，agent-plane preset 收不到。
2. target.inbox.append —— agent 对象没有 .inbox 属性。
3. assemble 时 session.events 里还没有 user/message —— 时序问题。

修复方式：把引导静态合并进 WEAK_FLASH persona，避免依赖任何动态注入机制。对固定任务同样有效，且更简单可靠。

适用范围

• ✅ 本 preset 专为 Flash 设计：命中 isFlashModel 后一律走 weak 模式（作者实测 w7 最优解）。
• ✅ 非 Flash 模型（如 pro）不受影响，走原版关键词分类逻辑。
• ✅ 复杂构建任务（如大型工程、从零开发）尤其受益于深度思考锚。

包结构

dsh-router-flash/
├── package.json      # dsh.bundle（组合补丁）+ dsh.client（标准双面）声明
├── cordis.patch.yml  # 组合补丁：insert dsh-router-flash 插件行
├── lib/
│   ├── index.js      # host 端：启动时同步安装 preset 到 ~/.dsh/.agent-presets
│   └── client.js     # client 端：空实现占位（无浏览器 UI）
└── preset/           # router-flash agent preset 本体
    ├── preset.yml
    ├── agent.cordis.yml
    ├── router-bootstrap.mjs
    └── router-core.mjs

说明

• host 插件依赖宿主服务：fs / sandboxPolicy；写 ~/.dsh/.agent-presets 使用 danger-full-access 策略
• preset 同步为幂等内容比对：无变化不写入；升级时包内变更文件覆盖目标；不删除目标目录中包内没有的文件
• 卸载 bundle 不会自动删除已安装的 preset 文件，避免误删用户修改

致谢与来源

本仓库是衍生作品，内容来源如下：

本仓库新增的 bundle 包装层（package.json / cordis.patch.yml / lib/）为本仓库独立新增代码。

完整许可与衍生链说明见 LICENSE 与 NOTICE。DeepSeek 是 DeepSeek 公司商标；本项目为社区产物，与 DeepSeek 无关联。