大肥鱼女仆长 · 环境自适应模式(改编自风神插件与明神插件)
DSH(DeepSeek Harness)自定义 Agent Preset 插件:首轮以 Linux 极简双工具「开智」锚定,自动探测宿主环境(原生 Linux / 原生 Windows / WSL 内外)与工作目录所属世界,
gitbash默认操作 Windows 母系统(pwsh兜底)、bash直达 WSL 发行版;晋升后进入任务感知思维模式路由(react / spec / weak)与四阶段渐进工具披露(了解 → 方案 → 开发 → 验证 +delivery_check交付 gate),dev_tool_search按需解锁更重工具;全程保持蓝发蓝瞳鲸鱼娘女仆长人设。单预设自包含 · 零外部插件依赖:不依赖
dsh-wsl-workspace,复制一个文件夹即可使用。
一、这个插件是做什么的?
它是 DSH 的一个 Agent Preset(自定义智能体模式),在一个模式里解决了九件事:
| # | 能力 | 说明 |
|---|---|---|
| 1 | 首轮「开智」锚定 | 会话第一轮只暴露 Linux 极简模式的双工具(bash + str_replace_editor),统一注入门控(context-gate)屏蔽全部自动注入上下文,让模型以最稳定的轨迹起步 |
| 2 | 判断运行环境 | 自动识别宿主是原生 Linux、原生 Windows、还是运行在 WSL 内部,并枚举 WSL 发行版与默认发行版 |
| 3 | 判断工作目录世界 | 自动判定当前工作目录属于 Windows 母系统、WSL 文件系统(\\wsl.localhost\…)还是原生 Linux,并给出路径互转规则 |
| 4 | 三世界 shell 路由 | Windows 宿主上:gitbash(Git Bash)默认操作 Windows 母系统,pwsh 在 Git Bash 不可用或需要 PowerShell 专属能力时兜底;bash 工具直达 WSL 发行版里的 bash(预设自带的 wsl-bash 实现,通过 wsl.exe 调用);Linux 宿主上全原生 |
| 5 | 思维模式路由 | 晋升后按任务分类自动叠加模式句:react(开发/创建 → 动手交付)、spec(修复/调试 → 先查后改)、weak(模糊任务 → 模型自路由,Flash 模型带回顾/收敛/反跑题三锚) |
| 6 | 渐进式工具披露 | 晋升后四阶段闯关:了解/对齐 → 拟合方案 → 开发 → 验证,每阶段只暴露当前档工具(预解锁归零),调用下一档工具自动跳级,阶段状态按会话持久化 |
| 7 | 交付 gate | 验证阶段 delivery_check 强制交付契约:文件存在/非空/UTF-8 + 证据清单(页面/图像必须含已复核的视觉证据),PASS 才允许宣告完成 |
| 8 | 按需工具解锁 | dev_tool_search 按名解锁更重的 Standard 工具(web_search、subagent、workflow…);skill_search / skill_load 按需加载技能,替代 ~9KB 技能目录注入;instruction-hint 只提示指令文件存在,模型自己读文件 |
| 9 | 女仆长人设 | 蓝发蓝瞳鲸鱼娘女仆长(DeepSeek 娘)完整人设与外貌设定,中文思考,温柔可靠、专业严谨 |
首轮还会自动注入一条英文环境简报(省 token),告诉模型当前宿主、目录世界、三个 shell 分别通往哪里、路径如何互转;晋升后随时可调用 env_probe 工具复查环境并实测两侧 shell,dev_router_status 查看当前路由状态。
二、功能特性一览
- ✅ 零外部插件依赖:全部
.mjs只使用node:内置模块,用户预设目录下可直接运行。 - ✅ 平台互斥自动分派:win32 与非 win32 各只有一组
bash/str_replace_editor提供者,绝无重复注册。 - ✅ win32 三 shell 路由:
gitbash(Git Bash)默认操作 Windows 母系统文件;pwsh(优先 PowerShell 7,兜底 5.1)兜底;bash直达 WSL 发行版。 - ✅
wsl-变体自禁用:被dsh-wsl-workspace生成器复制为wsl-*变体时自动让位,避免工具冲突。 - ✅ 无机器相关路径:不含任何绝对路径,装到任何机器都无需改配置。
- ✅ 安全降级:WSL 缺失、shell 探测失败等场景一律 fail-open,不阻断预设运行。
- ✅ 压缩后回落:
compaction/end后回到受控面(锚定对 + 核心工作集),新晋升信号后恢复。
三、快速安装(三步)
- 前置条件:已安装 DSH CLI 与
dsh web。Windows 宿主想用「bash 直达 WSL」功能时,需先安装任意 WSL 发行版(如wsl --install -d kali-linux)。 - 复制本项目文件夹到用户预设根目录:
Copy-Item -Recurse . "$env:USERPROFILE\.dsh\.agent-presets\big-fat-whale-maid-adaptive" - 重启
dsh web,在模式选择器中选择「大肥鱼女仆长 · 环境自适应模式」。
详细安装方法、验证清单与故障诊断见 AIreadme.md。
四、项目文件
big-fat-whale-maid-adaptive/
├── agent.cordis.yml # Agent 组合定义(24 行:门控、锚定、路由、渐进披露、环境、人设)
├── preset.yml # 模式列表里显示的元数据
├── context-gate.mjs # 统一注入门控(anchored-standard 移植,必须排第一)
├── compaction-epoch.mjs # epoch 感知晋升追踪(context-gate / tool-bootstrap 共享)
├── tool-bootstrap.mjs # 首轮双工具锚定 + 压缩后回落(anchored-standard 改造版)
├── router-core.mjs # 思维模式路由核心(纯函数库,无 apply,不作为插件装载)
├── router-progressive.mjs # 四阶段渐进披露 + delivery_check + 路由自检工具
├── dev-tool-search.mjs # 按需工具解锁(dev_tool_search)
├── skill-search.mjs # 技能搜索(skill_search / skill_load)
├── instruction-hint.mjs # 指令文件短提示(替代完整 AGENTS.md digest)
├── env-probe.mjs # 环境探测 + 英文简报注入 + env_probe/gitbash/pwsh 工具
├── wsl-bash.mjs # 自包含的「bash 直达 WSL」工具(wsl.exe)
├── README.md # 本文件:插件作用说明(给人看)
├── AI.md # 面向 AI 的项目构成与安装说明
├── AIreadme.md # 安装方法说明(给 AI / 维护者看)
└── CREDITS.md # 改编来源与致谢(上游插件)
五、常见问题
| 问题 | 原因与处理 |
|---|---|
| Windows 上 bash 工具不存在 | 没装 WSL 发行版或 wsl.exe -l -q 列不出任何发行版。安装 WSL 后重启 dsh web;预设会安全降级为全量目录 |
| bash 报「workdir is not in any known world」 | 传入的 workdir 不是 WSL UNC / Linux 路径 / Windows 盘符三者之一 |
| resume 报「tool "bash" is already registered」 | 与其它预设的 wsl-* 自动变体冲突(dsh-wsl-workspace 生成器上游坑)。本预设通过「变体目录自禁用」规避;如遇旧会话,重启 dsh web 后新建会话即可 |
| 晋升后工具很少 | 渐进披露机制:当前阶段只暴露当前档工具。用 dev_router_status 查看阶段,phase_advance 推进,或调用下一档工具自动跳级;dev_tool_search 可按名解锁任意工具 |
| delivery_check 报 FAIL | 交付契约未满足:检查文件存在/非空/UTF-8 与证据清单(页面/图像类必须 reviewed: true),修复后重跑 |
| 想自定义 | 复制整个文件夹为新 id,编辑 agent.cordis.yml(改人设/加删工具行)与 preset.yml(显示名),详见 AIreadme.md |
六、改编来源与致谢
本项目改编自两位 DSH 社区插件作者的优秀作品——风神(yjh051108)的 dsh-routing-suite 与明神(xiaobright)的 dsh-anchored-standard,感谢他们的设计与公开分享:
| 上游项目 | 作者 | 本项目借鉴 |
|---|---|---|
| dsh-routing-suite | 风神(yjh051108) | 思维模式路由(react/spec/weak 分类 + 模型感知叠加句)、四阶段渐进披露、delivery_check 交付 gate、Git Bash 探测经验 |
| dsh-anchored-standard | 明神(xiaobright) | 首轮 Minimal 双工具锚定、统一注入门控(context-gate)、epoch 感知晋升、按需工具解锁(dev_tool_search / skill_search)、指令文件短提示 |
详细改编说明与致谢见 CREDITS.md。
No comments yet. Be the first to write one.