前言¶
DeepSeek Harness（DSH）采用插件化架构，支持按需扩展能力。obra/superpowers 提供了一套成熟的工程工作流，包含需求分析、代码审查、Git 交付等环节。Meteor-system/superpowers-for-dsh 旨在将这套工作流带入 DSH 环境，通过独立的 bundle 和 preset 提供自动 session bootstrap、原生协作工具集成以及 Windows sandbox 兼容层。
核心功能¶
该插件提供以下能力：
- 14 个可按需加载的 skills：覆盖需求与设计、执行与协作、质量与调试、代码审查、Git 与交付、Skill 维护等场景。
- 自动 session bootstrap：会话启动时自动加载适用 skill，而非将所有内容塞入上下文。
- DSH 原生计划与协作工具：集成 plan mode、goal、subagent、workflow、Ralph、todo、background jobs、filesystem、PowerShell 和 Web search。
- Windows sandbox 兼容层：处理
danger-full-access模式下的权限字段，确保普通pwsh、write、edit调用无需手动添加sandbox_permissions或justification。 - 可选的 UI/UX Pro Max：提供 domain search、stack search 和确定性的 design-system 生成能力。
安装与启用¶
安装分为 bundle 安装和 preset 安装两步。
1. 安装 Bundle¶
在终端中运行以下命令，将 bundle 安装到 DSH profile：
npx @deepseek-ai/dsh plugin --profile web add github:Meteor-system/superpowers-for-dsh
安装完成后，通过 dsh --profile web --dump-config 确认输出中包含 superpowers-for-dsh。
2. 安装 Base Preset¶
进入仓库根目录，运行安装脚本。默认安装路径为 %USERPROFILE%\.dsh\.agent-presets\superpowers-dsh。
node scripts/install-preset.mjs
升级时使用 --force 参数，安装器会自动备份旧目录。
3. 可选：安装 UI/UX Pro Max Preset¶
如需使用 UI/UX Pro Max 功能，需额外安装 variant preset：
node scripts/install-preset.mjs --variant uiux
4. 启用与重启¶
安装或更新后，必须停止并重新启动 DSH profile，刷新 Web 页面，创建新会话，并选择 SuperPowers for DSH 或 SuperPowers for DSH + UI/UX Pro Max preset。旧会话保留创建时的配置，无法自动验证新的 bootstrap 或 tool catalog。
典型用法¶
Base Preset 工作流¶
新会话启动后，模型应按照预设流程操作：
- 新功能开发：
brainstorming->writing-plans->executing-plans/subagents - Bug 调试：
systematic-debugging->test-driven-development->verification-before-completion - Git 交付：
requesting-code-review->finishing-a-development-branch
PowerShell 调用¶
在 Base preset 下，普通 pwsh 调用无需手动构造 sandbox_permissions 字段，直接调用即可：
{
"command": "Get-Location",
"description": "确认当前项目目录",
"timeoutMs": 30000,
"workdir": "D:\\Code\\project",
"run_in_background": false
}
UI/UX Pro Max 使用¶
使用 UI/UX 功能需先通过 brainstorming 明确产品定义，再调用搜索和生成工具。
1. Domain Search¶
{
"query": "keyboard focus modal",
"domain": "ux",
"max_results": 3,
"diagnostics": true
}
2. Stack Search¶
Stack search 必须单独调用，不能与 domain 参数混用：
{
"query": "accessible responsive analytics dashboard",
"stack": "react",
"max_results": 3,
"diagnostics": true
}
3. Generate¶
需求稳定后生成设计系统：
{
"query": "SaaS analytics dashboard for business operators",
"project_name": "Metrics",
"format": "markdown",
"variance": 5,
"motion": 4,
"density": 5,
"persist": false
}
Model-facing Schema 约束¶
ui_ux_search 和 ui_ux_generate 工具的 schema 严格限制参数，使用 additionalProperties: false。例如，ui_ux_generate 在非持久化模式下不能包含 page 或 force 字段。
注意事项¶
- 独立实现：这是一个独立的 DSH bundle，并非
obra/superpowers或LayneChai/superpowers-dsh的 fork。 - 前置条件：
- Base preset 需要 DSH Web profile、可运行 Node.js 脚本的环境以及 Git。
- UI/UX preset 额外需要 Python 3（无需安装第三方包，环境变量
UI_UX_PRO_MAX_PYTHON可用于指定路径）。
- 工具禁用：当前 preset 中明确禁用了
subagent_codex和subagent_claude_code。 - 返回值规范：工具返回结果必须原样保留
upstream（含 repository、revision、skillVersion）、sourceIds和warnings字段。 - Schema 验证：即使模型参数合法，core 层仍会执行二次输入规范化和范围检查。
总结¶
SuperPowers for DSH 为 DeepSeek Harness 提供了一套完整的工程化工作流。它通过 lazy loading skills 和 DSH 原生工具集成，减少了人工干预，并通过 Windows sandbox 兼容层简化了本地操作。配合可选的 UI/UX Pro Max，开发者可以在本地完成从需求到设计的全流程。
