用 DeepSeek Harness 做设计。
DeepSeek Harness 能读取仓库、修改真实 UI 代码、运行命令、加载项目指令，并在多轮迭代中保留会话，因此可以用来制作落地页、产品界面、仪表盘与前端原型。但它不会凭空提供设计品味：真正好用的设计流程仍然需要品牌规则、参考、工具、权限，以及渲染和检查结果的闭环。
做界面时，要把 brief 与验收闭环写清楚。DeepSeek 默认路由只支持文本，因此最可靠的基线是代码与规格工作流；只有在选择声明支持图片的模型路由后，才应附加截图。
模型仍然需要明确的视觉方向。最直接的做法是把 DeepSeek Harness 接入 Open Design：Open Design 提供设计系统、前端 Skill、产物预览与审阅界面，dsh 负责实际编码。本文从 [DeepSeek Harness 官网](https://www.deepseek.com/harness/)与[官方源码仓库](https://github.com/deepseek-ai/deepseek-harness)开始，完整演示从接入到生成界面的流程。
DeepSeek Harness 能做设计吗？
DeepSeek Harness 能读取仓库、修改真实 UI 代码、运行命令、加载项目指令，并在多轮迭代中保留会话，因此可以用来制作落地页、产品界面、仪表盘与前端原型。但它不会凭空提供设计品味：真正好用的设计流程仍然需要品牌规则、参考、工具、权限，以及渲染和检查结果的闭环。
- 持久的设计上下文: 默认指令加载器会从项目层级读取 `AGENTS.md` 与 `CLAUDE.md`。把 token、组件规则、响应式断点和验收标准放到每次运行都能看到的位置。
- 可复用 Skill: 本地 Skill 可以放在 `.dsh/skills` 或 `.agents/skills`。一套前端 Skill 能把准确的 brief、清单、示例与脚本打包，避免每个 UI 任务都从零开始。
- 按任务选择供应方: Web UI 可配置 DeepSeek、Anthropic 或 OpenAI 等目录供应方，以及自定义 OpenAI 兼容端点。截图任务选择明确支持图片的路由；DeepSeek 原生路由适合文本、代码、DOM 与规格驱动的工作。
最重要的限制与所有 Agent 一样：可组合性不等于品味。没有明确的字体、间距、组件与交互约束，运行时只会忠实地自动化一套通用结果。Open Design 的角色就是提供并组织这些设计输入。
第 1 步：安装并配置 DeepSeek Harness
先确保 DeepSeek Harness 可以独立运行。安装经过测试的 dsh 版本，然后打开本地 Web UI，配置好 API Key 与模型，再打开 Open Design。开发者预览版要求 Node.js `^22.19.0` 或 `>=24.0.0`。
# Open Design 当前完整测试 DeepSeek Harness 0.1.0-rc.6
# 需要 Node.js ^22.19.0 或 >=24.0.0
npm install -g @deepseek-ai/[email protected]
# 验证本地命令
dsh --version
# 启动本地 Web UI，并配置供应方与模型
dsh web
# 打开 http://127.0.0.1:3080- 打开 Harness Web UI: 运行 `dsh web`。默认会打开 `http://127.0.0.1:3080`；如果浏览器没有自动打开，请复制终端实际打印的地址，并以该地址为准。
- 填写 DeepSeek API Key: 先通过“内测声明”，再按提示保存或应用 Key。如果没有出现弹窗，请进入“设置 → 模型 → DeepSeek → API 密钥”。只粘贴 Key 本身，不要包含 `DEEPSEEK_API_KEY=...`，也不要加引号。配置会立即生效，无需重启 `dsh web`。没有 Key 时可前往 DeepSeek 开放平台创建。
- 确认模型并关闭配置页面: DeepSeek 提供方应显示为已配置，相应模型也会出现在选择器中。如果看到 `MISSING_CREDENTIAL`，请重新打开 DeepSeek 卡片并保存 Key。测试请求成功后可按 `Ctrl+C`；日常使用 Open Design 时不需要让 `dsh web` 常驻。
DeepSeek Harness 会以只写方式保存供应方凭证：页面可以判断 Key 是否已配置，但无法重新读取或显示明文。Open Design 会复用这套由用户安装的 dsh 与模型配置，不会把 Key 复制进 Open Design。为了稳定使用，建议把 dsh 锁定在已测试的 `0.1.0-rc.6`。凭证行为以官方供应方配置指南为准。
第 2–5 步：把 DeepSeek Harness 接入 Open Design
dsh 在本机正常运行后，剩下的操作都在 Open Design 里完成。DeepSeek Harness 接入能力从 Open Design 0.19.1 开始提供。
- 2 · 下载 Open Design 0.19.1 或更高版本: 从 Open Design 下载页获取当前桌面版本，完成安装并启动应用。
- 3 · 探测 DeepSeek Harness: 进入“设置 → 模型与提供商 → 本机 CLI”，点击“重新扫描”。如果安装时 Open Design 已经打开，请重启应用或再次扫描。找到第 1 步安装的 `dsh` 后，就会显示 DeepSeek Harness 卡片。
- 4 · 接入 Open Design Profile: 选择 DeepSeek Harness 卡片。若显示“需要安装连接组件”，确认“安装并选择”。Open Design 会校验自己的组件，通过 dsh 安装到 `open-design` profile，然后重新扫描并测试连接。
- 5 · 开始设计任务: 确认卡片显示 Harness 版本和“已从 CLI 同步”，然后点击“测试”。测试通过后，打开或新建项目，选择 DeepSeek Harness 与同步过来的模型，再发送设计需求。
到这里接入就完成了。界面与 `od agent setup deepseek-harness --json` 使用同一条本地设置路径；每次运行都会启动 `dsh --profile open-design --stdio`，Harness 会保留会话标识供后续轮次继续使用。
在当前工作区创建一页精致的产品落地页。
把 DESIGN.md、AGENTS.md 与已安装的前端 Skill 作为视觉契约。
复用项目中的 token 与组件，同时覆盖桌面端和移动端状态。
运行应用、检查渲染结果，修复可见的间距与层级问题，
最后把 HTML 与素材留在项目中，供 Open Design 直接预览。
边界很简单：Harness 管理 dsh、凭证、模型与会话；Open Design 管理经过校验的连接 profile 与设计工作区。Open Design 独立于 DeepSeek AI；DeepSeek 与 DeepSeek Harness 商标归各自权利人所有。
执行 UI 构建与验收闭环
做界面时，要把 brief 与验收闭环写清楚。DeepSeek 默认路由只支持文本，因此最可靠的基线是代码与规格工作流；只有在选择声明支持图片的模型路由后，才应附加截图。
- 从仓库目录启动 dsh，把该目录选为工作区，并为当前任务选择合适的模型路由。
- 把品牌契约写入 `AGENTS.md`、`CLAUDE.md` 或被引用的 `DESIGN.md`：token、基础组件、间距、字体、断点、状态与禁用模式。
- 从 `.dsh/skills` 或 `.agents/skills` 加载聚焦的前端 Skill；把示例与验证脚本放在指令旁边。
- 要求 Agent 复用现有组件、运行应用，并用项目自身的测试或浏览器工具验证响应式状态。
- 审阅可见结果，记录具体差异，用小步提交迭代。较弱的一轮直接回退，不要在错误基线上继续叠补丁。
一条有用的 prompt 需要同时说明视觉约束与验证证据：
用 React + TypeScript 实现账户仪表盘。
复用 AGENTS.md 与 DESIGN.md 中指定的组件和 token。
使用 240px 侧栏、12 栏内容网格，以及文档规定的移动端导航。
包含加载、空态、错误与焦点状态。
运行应用和现有 UI 检查，审阅桌面与移动断点，
并报告你实际验证过的文件与状态。如果截图不可或缺，先配置支持图片的模型供应方。所选路由未声明图片支持时，DeepSeek Harness 会在发送前拒绝图片，避免参考图被悄悄丢掉。
用插件与 Skill 固化设计工作流
DeepSeek Harness 真正的差异不在聊天界面，而在其下层。插件树让团队可以把设计工作流写进运行时，而不是每个会话都粘贴一次 prompt。
- AGENTS.md 与 CLAUDE.md: 指令插件会加载用户全局文件与项目层级，并在一等文件操作后发现相关的嵌套指令文件。它适合承载长期设计规则，而不是一次性请求。
- 文件系统 Skill: Skill 注册表会发现项目与用户目录、处理同名优先级，并向模型暴露 `skill` 工具。前端工艺、无障碍、响应式 QA 与设计系统流程都适合放在这里。
- Profile 与 Bundle: Profile 会叠加有序插件 bundle 和用户 patch。团队可以维护一套设计专用组合，只挂载真正需要的供应方、工具、权限策略和 Skill 来源。
- MCP 与外部能力: 源码包含 MCP 客户端能力，但面向用户的配置仍偏开发者。预览阶段应把集成视为需要锁版本的插件工作，而不是稳定的勾选项。
在搭建长期内部工作流前，用 `dsh --profile web --dump-config` 检查生效的插件树。它展示实际挂载和可 patch 的内容，比假设仓库里的每个 package 都已在默认 profile 中启用更可靠。
避免毁掉视觉结果的常见问题
最大的错误，是把预览版当稳定产品、把纯文本路由当视觉模型，或者把灵活的 Harness 当作视觉品味的来源。
- 先锁版本，再定制: 破坏兼容性的改动是明确的预览版策略。锁定 npm 版本，并让 profile patch 保持足够小，便于升级后逐项审阅。
- 检查所选模型的输入模态: DeepSeek 原生 chat-completions 路由只支持文本。做截图转代码时，应改用并声明支持图片的模型路由。
- 把品味作为数据提供: 向 Agent 提供 token、标准组件、参考状态与禁用模式。没有设计契约的模块化运行时，依然会产出通用 UI。
- 核实 Profile 真正挂载的能力: 仓库中的 package 代表可用能力，不等于默认 profile 已启用。记录或依赖某个集成前，先检查组合后的配置。
每条缓解措施，本质都是在做上下文与验证决策。这正是设计层应该变成可重复流程、而不是让每个项目重新摸索的工作。
Harness 在设计流程中负责什么
DeepSeek Harness（`dsh`）是 DeepSeek AI 开发、采用 MIT 许可的 Agent Harness。官方产品页用于了解产品，GitHub 仓库提供源码、版本记录与维护中的文档。公开开发者预览版包含本地 Web UI 与 headless profile。
它的核心理念是“万物皆插件”。Cordis 组合出一棵插件树，模型适配器、工具注册表、Agent Loop、文件系统、Shell、沙箱、Skill、子 Agent、持久化与 UI 都可以通过 profile 和 bundle 挂载、替换或打补丁。随项目提供的 `web` 与 `headless` profile 是起点，不是封闭产品。
- 本地 Web UI: `npx @deepseek-ai/dsh web` 默认在 `127.0.0.1:3080` 启动浏览器工作区。添加模型、选择工作区，即可在对话界面中运行任务。
- 无头模式: `headless` profile 会运行一个新的持久化会话、打印最终答案并退出，适合脚本化审计、构建与可重复的设计检查。
- 可组合运行时: Profile 会叠加插件 bundle 与用户 patch，让团队无需 fork Agent Loop 就能更换模型供应方、工具、策略与 UI 行为。
- 开发者：DeepSeek AI（官方项目）
- 状态：开发者预览版，预计会有破坏兼容性的改动
- 许可：MIT
- 主要命令：`npx @deepseek-ai/dsh web`
DeepSeek Harness、DeepSeek TUI 与 Open Design
DeepSeek Harness 与 DeepSeek TUI 是两个使用不同命令的独立项目。Open Design 现在同时把两者作为本地 Agent 支持，因此选择依据是你想使用哪套运行时，而不是哪一套能否进入设计工作区。
| 工具 | 它是什么 | 最适合的设计场景 |
|---|---|---|
| DeepSeek Harness（`dsh`） | DeepSeek AI 官方的插件优先 Harness，含本地 Web UI、headless profile 与 Open Design 一等适配器 | 在 Open Design 的产物流程中使用 Harness 会话、模型供应方与插件组合 |
| DeepSeek TUI（`deepseek` / `codewhale`） | 另一套终端编程 Agent，也有独立的 Open Design 适配器 | 不依赖 Harness profile 架构的终端优先 DeepSeek 工作流 |
| OpenCode | 成熟、开源、与模型供应方无关的终端 Agent | 在稳定 TUI 工作流中切换模型，并使用 AGENTS.md 与 MCP |
| Claude Code | 覆盖终端、IDE、桌面与 Web 的成熟编程 Agent | 前端推理、图片密集型参考与成熟设计集成 |
| Open Design | 围绕受支持编程 Agent 的 Agent-Native Design Workspace 与资源库 | 精选设计系统、Skill、视觉产物，以及不绑定单一模型厂商的本地工作流 |
需要官方 Web UI、Profile 系统、模型目录与可恢复 Harness 会话时选择 DeepSeek Harness；偏好另一套终端优先体验时选择 Open Design 内的 DeepSeek TUI。两者仍是独立运行时，但现在都能复用同一套 Open Design 设计流程。
用 DeepSeek Harness 做设计：常见问题
-
01 DeepSeek Harness 是什么？
DeepSeek Harness（`dsh`）是 DeepSeek AI 官方开源的 Agent Harness。它通过 Cordis 插件树组合模型、工具、上下文、会话、策略、编排与 UI。公开版本目前采用 MIT 许可，仍处于开发者预览阶段。
-
02 如何安装并运行 DeepSeek Harness？
先用 `npm install -g @deepseek-ai/[email protected]` 安装经过测试的 CLI，再运行 `dsh web`。通过“内测声明”后，进入“设置 → 模型 → DeepSeek → API 密钥”，只保存 Key 本身。确认供应方与模型正常后，用 `Ctrl+C` 关闭 Web UI。安装 Open Design 0.19.1 或更高版本，重新扫描本机 CLI Agent，连接 Harness 卡片并点击“测试”。
-
03 DeepSeek Harness 是 DeepSeek 官方项目吗？
是。仓库发布在 `deepseek-ai` GitHub 组织下，并明确说明 dsh 由 DeepSeek AI 开发。项目采用 MIT 许可，也明确标记为开发者预览版。
-
04 DeepSeek Harness 能根据截图构建 UI 吗？
只有所选模型路由声明支持图片输入时才可以。dsh 中 DeepSeek 自身的 chat-completions 路由只支持文本；在纯文本路由中，Harness 会在发送前拒绝图片。截图任务请选择支持图片的供应方，或通过代码、DOM、token 与书面规格描述目标。
-
05 DeepSeek Harness 支持 AGENTS.md 与 Skill 吗？
支持。它的指令插件会加载兼容 AGENTS.md 与 CLAUDE.md 的项目文件；文件系统 Skill 供应方会从 `.dsh/skills`、`.agents/skills` 以及配置的用户与内置目录中发现 Skill。
-
06 DeepSeek Harness 与 DeepSeek TUI 有什么区别？
它们是不同工具。DeepSeek Harness 使用 `dsh` 命令，是 DeepSeek AI 官方的插件优先 Web UI/headless 运行时。DeepSeek TUI 使用 `deepseek` 或 `codewhale` 调度器，是 Open Design 当前支持的另一套 DeepSeek 适配器。
-
07 Open Design 支持 DeepSeek Harness 吗？
支持。Open Design 会发现你安装的官方 dsh，在用户明确确认后安装由 Open Design 维护且经过校验的 profile 组件，同步 Harness 模型目录，并把 DeepSeek Harness 作为一等本地 Agent 运行。Open Design 不会安装 dsh，也不会接收 Harness 管理的供应方 secret。
-
08 DeepSeek Harness 把 API key 存在哪里？
请在 DeepSeek Harness 中配置 Key，而不是在 Open Design 中配置。官方模型指南说明，供应方 Key 以只写 Secret 的方式保存在 `$DSH_HOME/.credentials.yaml`：页面可以知道 Key 是否已配置，但无法读取或显示明文。Open Design 不会要求你把 Key 粘贴到应用内，也不会把 Key 写入 Open Design 配置。
在 Open Design 中使用 DeepSeek Harness 做设计。
安装官方 dsh，一次完成连接，然后在同一流程里使用 Open Design 的设计系统、Skill、同步模型与本地产物预览。