**Brief · Explore · Build · QA — DeepSeek Harness 的 Product Design 工作流插件**
[](docs/PROTOCOL.md)
[](package.json)
[](test/smoke.test.mjs)
[](LICENSE)
[这是什么](#这是什么) · [快速开始](#快速开始) · [十个技能](#十个技能) · [工作流闸门](#工作流闸门最关键的一节) · [架构设计](docs/ARCHITECTURE.md) · [主机契约](docs/PROTOCOL.md) · [更新日志](CHANGELOG.md) · [English](README.md)
---
## 这是什么
**只有一个入口 `/product-design`——任何设计类请求都会被路由进一套有纪律的工作流：**
```text
/product-design 给习惯养成应用做一个 onboarding 流程
```
背后发生的事：入口技能分析需求后路由到 9 个专注的 `pd-*` 子技能——最小设计简报、三个差异化视觉方向、证据化的研究与审计、忠实的 URL 克隆、响应式前端构建，以及交付前的**硬闸门 design-qa**——任何一步没过，都不许叫"完成"。
- 这是一个**纯技能** DSH 插件：不注册模型工具、不挂客户端模块——全部表面是隔离 provider 上的 10 个技能；
- 技能**编辑热加载**、不遮蔽项目/用户技能、随插件卸载一起消失；
- 证据驱动是契约：截图先检视后采纳，禁止假资产；
- 前提只有一条：**DSH Desktop 已经装好并能启动**（插件不会替你启动宿主）。
> 📌 主机契约已在 **DSH 0.1.2-alpha.1** 实测；13 个单元测试 + 安装态集成验证全部通过（判据见 [主机契约](docs/PROTOCOL.md)）。
> 📌 本插件是对 Codex 官方 Product Design 插件**工作流方法论的原创重写**（原文内容为 OpenAI Proprietary，未复制其文案与代码），与 OpenAI 无关联——见 [许可与来源](#许可与来源)。
## 快速开始
### 前置条件
- DSH Desktop（主机契约按 0.1.2-alpha.1 验证）；
- Node.js `^22.19.0 || >=24`（宿主运行时通常已满足）；
- PowerShell（部署脚本是 `.ps1`）。
### 安装（一条命令）
```powershell
git clone https://github.com/Kayungko/dsh-plugin-product-design.git
cd dsh-plugin-product-design
pwsh install.ps1
```
脚本把插件复制进 profile 的 `node_modules/`（不跑 `pnpm install`、不碰 lockfile），并在 profile manifest 登记依赖与 bundle——**改前全部自动备份**到 `backups/<时间戳>/`。
装完**重启 DSH Desktop**，任何会话都能看到十个技能。
> 💡 重复执行是安全的：文件覆盖幂等，manifest 登记自动去重。
### 验证
重启后，把这句发给任意会话：
`/product-design 给桌面宠物应用画一个设置页`
路由器会确认需求、跑简报闸门（问最小设计问题），并且在视觉目标存在之前**给出三个方向而不是直接写代码** ✅
卸载：`pwsh install.ps1 -Uninstall`（同样重启后生效）。
## 十个技能
| Skill | 角色 |
|---|---|
| `product-design` | 唯一用户入口（`/product-design`）：分析需求并路由；只路由不干活；"No Visual Target, No Build" |
| `pd-get-context` | 最小设计简报闸门 |
| `pd-user-context` | 持久化产品/设计上下文（`~/.dsh/product-design/`） |
| `pd-research` | 证据化 UX 桌面研究 |
| `pd-ideate` | 三个差异化视觉方向（有图像生成工具出图，否则结构化文字方向） |
| `pd-image-to-code` | 选定视觉目标 → 忠实交互前端 |
| `pd-url-to-code` | 线上 URL → 本地前端克隆（证据先行） |
| `pd-audit` | 产品流审计（用户面向，截图证据） |
| `pd-design-qa` | 内部 QA 闸门（`passed` / `blocked`） |
| `pd-share` | 部署分享（用户选定目标后执行） |
9 个 `pd-*` 子技能对模型可见、但在用户命令列表隐藏（`user-invocable: false`）——由模型自动路由。
## 工作流闸门（最关键的一节）
```text
显式唤起 / 设计类请求
→ pd-user-context preflight
├─ 审计 / 批评：pd-audit 直达（不过简报闸门；截图证据内联报告）
└─ 设计 / 构建 / 克隆 / 重设计 / 研究：
→ pd-get-context（最小简报：设计目标 + 期望的用户结果）
├─ 无视觉目标：pd-ideate 出 3 个方向 → 用户选 1 → pd-image-to-code
├─ 克隆线上页：pd-url-to-code（先取证、只按证据构建）
├─ 重设计（"Like 