dsh-router-flash

一句话定位

这是一个 DSH agent preset 分发包：装上之后，DSH 启动时自动把 router-flash 这套"按任务类型路由 + 工具分级放开"的预设同步到本地，重启后即可让 opencode-go 的 deepseek-v4-flash 进入作者标定的"神模式"引导状态。

核心能力

• 启动时把包内的 agent preset 文件自动同步到 ~/.dsh/.agent-presets/router-flash，无需手动复制
• 识别当前模型 id 是否属于 Flash 系列，若是则注入专属的弱引导 persona（任务分类 + 回顾 + 反跑题 + 深度思考 + 决策闭环）
• 首轮对话只暴露少量核心工具（read/write/edit 加平台 shell），首次工具调用后再放开完整工具目录
• 非 Flash 模型走关键词分类逻辑：按用户首条消息判定 build（动手实现）或 fix（先排查后动手）模式，匹配套的 persona 与核心工具集
• 跨平台适配：Linux/macOS 自动使用 bash 工具，Windows 自动切换到 PowerShell 工具

技术实现

• 语言: JavaScript（ESM，type: module）+ Cordis YAML 配置 + Markdown 提示词
• 关键依赖: 无第三方 npm 依赖；只用 Node 内置 node:fs/promises、node:os、node:path、node:url
• 架构模式: 标准 DSH bundle 双面插件（host 端负责同步 preset 文件到本地，client 端空实现占位），并通过 cordis.patch.yml 把 router-flash 组合行插入到宿主配置中
• 入口文件: lib/index.js（host 同步逻辑）、preset/router-bootstrap.mjs（system-prompt/assemble 钩子，路由 persona 与工具集）

适用场景

正在使用 opencode-go provider 接入 deepseek-v4-flash 模型的用户，常常发现默认情况下 Flash 思考浅、容易草草动手。这种情况适合安装本包：它把作者实测最优的弱 persona 与首轮工具收窄策略打包好，让你在常规复杂工程任务里直接拿到稳定的深度规划与高质量交付。如果你用 Pro 等其他模型，本包也兼容，但效果提升主要来自 Flash 专属的引导优化。

前置依赖与兼容性

安装方式

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

配置项

本插件无需额外配置。安装后请按 README 的两步骤手动在 ~/.dsh/settings.yaml 中把 agent-presets.default 指向 router-flash，并把模型指向 opencode-go 的 deepseek-v4-flash（含 reasoningEffort: max）。

常见问题

Q: 这个插件是给谁用的？我没有 deepseek-v4-flash 模型能用吗？

A: 主要面向使用 opencode-go provider 接入 deepseek-v4-flash 的用户。非 Flash 模型也能加载这个 preset，会自动回退到基于关键词的 build/fix 分类路由，不会报错，但 Flash 专属的弱引导效果对它们不明显。

Q: 安装后还需要做什么才能生效？

A: 安装后必须重启一次 DSH（让 host 端把 preset 文件同步到本地），然后在 ~/.dsh/settings.yaml 把 agent-presets.default 设为 router-flash，再把默认模型切到 opencode-go 的 deepseek-v4-flash。再次重启后新会话才会使用本 preset。

Q: 升级时我手工改过的 preset 文件会被覆盖吗？

A: 包内文件未变化的，你的修改会被保留；包内有新版本的文件会覆盖你的本地副本。卸载 bundle 不会自动删除 ~/.dsh/.agent-presets/router-flash 目录，如需彻底清理需要手动删除该目录并从 settings.yaml 移除引用。

Q: 和原版 dsh-router-standard 有什么不同？

A: 原版依赖三种在 DSH rc.6 上失效的机制（session/event 跨域监听、agent.inbox.append、assemble 阶段读取尚未到达的 user/message）。本包改为把深度引导静态合并进 WEAK_FLASH persona，不再依赖任何动态注入，对固定任务同样有效。

Q: Windows 上能用吗？

A: 可以。preset 内部已根据 process.platform 自动禁用 bash 工具、启用 pwsh 工具；首次工具调用前允许的 shell 是 pwsh。其他引导逻辑（persona、模型识别、路由）与操作系统无关。

Q: 为什么首轮只能用 read/write/edit？

A: 这是作者为 Flash 标定的"弱模式"策略：先用最小工具集强制模型读完/想清楚再动手，避免 Flash 在复杂任务里草率操作。完成首次 tool/call 后完整工具目录会自动放开。

上手难度

入门 — 安装一行命令、重启 DSH、改两行 settings.yaml 即生效，无需理解插件内部 Cordis 编排即可直接使用。

已知问题与限制

• 卸载本 bundle 不会自动清理 ~/.dsh/.agent-presets/router-flash 目录与 ~/.dsh/settings.yaml 中的 agent-presets.default 引用，需要用户手动删除与改回（README.md:50）
• router-bootstrap 内置了一个空的 overrides Map（按 session id 存放显式模式），当前没有任何代码路径写入它，是为未来外部调优预留的扩展点（preset/router-bootstrap.mjs:25）
• 本插件作者实测结论高度依赖 dsh-router-standard 的弱 persona 路由研究，其他底层 DSH 版本（如非 rc.6）可能因 host/agent 平面划分差异而失效；最低版本固定为 rc.6+（README.md:80）
• 工具收窄只发生在 system-prompt/assemble 阶段，DSH 之外的客户端或自定义会话入口绕开该钩子后将拿到完整工具集（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 无关联。