用 DeepSeek Harness 做设计。
把 DeepSeek Harness 变成一套本地 UI 工作台：加载项目规则与 Skill，选择模型路由，生成界面，再用浏览器完成视觉验收。
启动 dsh，打开代码仓库，加载设计契约，生成界面，然后在浏览器里验证结果。
要用 DeepSeek Harness 做设计，关键不是让模型随手写一段 JSX，而是把它放进一套可重复的 UI 流程：模型修改代码，项目文件保存视觉契约，Skill 固化前端工艺，浏览器检查决定结果是否通过。
本文按这条路径从配置讲到视觉验收。插件架构、模型限制和工具对比只在它们会影响实际设计工作时出现，不再喧宾夺主。
搭建 DeepSeek Harness 设计工作台
公开预览版要求 Node.js `^22.19.0` 或 `>=24.0.0`。npm 命令会在首次运行时初始化 web profile，因此无需克隆仓库也能打开本地 UI。
# 1. 启动官方 DeepSeek Harness Web UI
# 需要 Node.js ^22.19.0 或 >=24.0.0
npx @deepseek-ai/dsh web
# 2. 打开本地 UI（默认地址）
# http://127.0.0.1:3080
# 3. 在 Settings → Models 中添加 DeepSeek API key
# 或配置其他受支持的模型供应方。
# 4. 把项目目录选为 workspace。
# 可选：Profile 初始化后运行一次无头任务
npx @deepseek-ai/dsh --profile headless "Audit this UI against AGENTS.md"
- 凭证只保留引用: Web UI 将供应方密钥存入 `$DSH_HOME/.credentials.yaml`；设置中只保留凭证引用，UI 收到的是脱敏描述，而不是明文 key。
- 把预览版当作需锁版本的基础设施: 维护者明确说明会有破坏兼容性的改动。团队工作流应锁定版本，并在升级前审阅发布变化。
给 Agent 一份设计契约
模型会写 JSX，但真正好用的设计 Agent 还需要品牌规则、参考、工具、权限，以及渲染和检查结果的闭环。DeepSeek Harness 把这些外围能力暴露出来，而不是藏在固定产品里。
- 持久的设计上下文: 默认指令加载器会从项目层级读取 `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 的角色就是提供并组织这些设计输入。
执行 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。公开的开发者预览版提供本地 Web UI 与无头运行器。它不是模型，也不只是终端皮肤；它是把模型、工具、上下文、权限、会话和用户界面组装成 Agent 的运行时。
它的核心理念是“万物皆插件”。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 Harness 与 Open Design 当前列出的 DeepSeek TUI 是两个不同项目，命令和集成状态也不同。
| 工具 | 它是什么 | 最适合的设计场景 |
|---|---|---|
| DeepSeek Harness（`dsh`） | DeepSeek AI 官方的插件优先 Harness，含本地 Web UI 与 headless profile；开发者预览版 | 想自行组合运行时、Skill、模型供应方、策略与 UI 的团队 |
| DeepSeek TUI（`deepseek` / `codewhale`） | 另一套终端编程 Agent，也是 Open Design 当前支持的 DeepSeek 适配器 | 今天就在 Open Design 内使用 DeepSeek |
| OpenCode | 成熟、开源、与模型供应方无关的终端 Agent | 在稳定 TUI 工作流中切换模型，并使用 AGENTS.md 与 MCP |
| Claude Code | 覆盖终端、IDE、桌面与 Web 的成熟编程 Agent | 前端推理、图片密集型参考与成熟设计集成 |
| Open Design | 围绕受支持编程 Agent 的 Agent-Native Design Workspace 与资源库 | 精选设计系统、Skill、视觉产物，以及不绑定单一模型厂商的本地工作流 |
当你想扩展 Harness 本身时选择 dsh；当你需要当前已支持的 DeepSeek 适配器与现成设计层时，选择 Open Design 内的 DeepSeek TUI。未来两者可能通过新适配器汇合，但今天不能互换。
把 Open Design 作为设计层接入
Open Design 与 DeepSeek Harness 位于相邻层。dsh 负责组合 Agent 运行时；Open Design 负责策展让 Agent 真正适合视觉工作的设计系统、Skill与本地产物流程。Open Design 尚未发布专用 `dsh` 适配器，所以今天准确的用法是并行配合。
- 安装 Open Design，用其中的设计系统与 Skill 为项目建立视觉契约。
- 把生成的 `DESIGN.md`、参考与项目指令保存在 DeepSeek Harness 打开的同一个仓库中。
- 用 dsh 做插件优先实验与代码任务；复用同一套 token、规则、资产与验收标准，不要再维护第二份设计 brief。
- 如果今天就需要在 Open Design 内直接用 DeepSeek，请选择现有 DeepSeek TUI 适配器。把未来 dsh 适配器当成另一项集成，不要误写成现有能力。
最终得到的是同一个自有代码库与一份可移植设计契约，横跨两款本地优先工具。Open Design 独立于 DeepSeek AI；DeepSeek 与 DeepSeek Harness 商标归各自权利人所有。
用 DeepSeek Harness 做设计：常见问题
-
01 DeepSeek Harness 是什么？
DeepSeek Harness（`dsh`）是 DeepSeek AI 官方开源的 Agent Harness。它通过 Cordis 插件树组合模型、工具、上下文、会话、策略、编排与 UI。公开版本目前采用 MIT 许可，仍处于开发者预览阶段。
-
02 如何安装并运行 DeepSeek Harness？
安装受支持的 Node.js 版本，然后运行 `npx @deepseek-ai/dsh web`。默认会在 `http://127.0.0.1:3080` 启动本地 Web UI。进入 Settings → Models 添加模型，选择工作区后即可开始会话。
-
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 当前支持另一套 DeepSeek TUI。你仍可让 Open Design 的设计系统、Skill、DESIGN.md 与产物和 dsh 并行使用，并保存在同一个本地仓库里。
-
08 DeepSeek Harness 把 API key 存在哪里？
官方模型指南说明，供应方 key 存在 `$DSH_HOME/.credentials.yaml`。设置中只保留凭证引用，Web UI 收到的是脱敏描述，不是明文 secret。
为你的 DeepSeek 工作流补上设计层。
今天就使用 Open Design 的本地设计系统、Skill 与产物流程，并让同一份项目契约适配你下一步选择的任何 Agent 运行时。