跳到主内容

dsh-runtime 使用指南

Open Design 注入 dsh 的 profile,走 JSONL stdio 驱动 dsh 转发文本、思考、工具、用量,支持续接。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

open-design

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:nexu-io/open-design#path:packages/dsh-runtime

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • 🤖 Agent-native, model-agnostic. We don't ship an agent. The claude / codex / cursor-agent / copilot / hermes / kimi already on your PATH are the design engine. Swap with one click.
  • 🔒 Privacy by conviction. Everything runs where your data lives — your laptop, your team's server, your Vercel project. When the network is needed, the BYOK proxy is SSRF-guarded.
  • Linux (AppImage, optional lane) → GitHub Releases
  • 🔁 Migrate Figma / Pencil workflows → React, Next.js, or Vue source. See od-figma-migration.
  • 🛠️ Refresh an existing codebase to a brand spec — point a plugin at a git repo + DESIGN.md, get a PR. See od-code-migration.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

必须先安装 DeepSeek Harness 吗?

是。插件不会下载或安装 dsh 本身,需要用户先用 Open Design 提供的 bootstrap 安装脚本(macOS/Linux:curl … install-dsh.sh;Windows:irm install-dsh.ps1)把官方 dsh 装好并在 Harness 的 Web UI 里配置好模型 API Key。

我的 API Key 会保存在 Open Design 里吗?

不会。Open Design 仅在 dsh 的 Web UI 中以只写方式存放凭据,Open Design 既不读取也不回写 Key 明文;运行时按需让 dsh 自己读取自己配置的秘钥。

每个设计任务都会新启一个 dsh 进程吗?

是。Open Design 每次发起 run 都会启动一个短命的 dsh --profile open-design --stdio 进程;Harness 会话存储负责跨进程 cold resume,无需在 CLI 参数里带会话 ID。

跑一半想停下来怎么办?

协议层支持中途取消。宿主发 cancel 命令后会立即 abort;插件在 AbortController 未初始化的窗口期也会保留请求级意图并在 execute 激活时重放。

一次进程能同时跑多个任务吗?

不能。每个 profile 进程恰好接受一个 execute 命令,第二个会被 DSH_PROFILE_BUSY 拒绝;要用并发请由宿主侧开多个进程。

怎么卸载这个连接组件?

通过 od agent setup deepseek-harness 或 DSH 自带的 dsh plugin --profile open-design remove 卸载即可,DSH 自己的安装、凭据、模型配置都不会被改动。

生成的文件会留在 Open Design 工程里吗?

会。Harness 把文件落到 OD 当前的工程工作目录,文件监听和实时预览交给 Open Design 既有的工件管道处理。

协议握手失败会怎样?

探测阶段仅打印一个 JSON 对象失败信息;Open Design 仍把 DeepSeek Harness 留在"已安装 CLI"列表里并显示"需要安装连接组件",需要用户再次确认才会通过本插件的 dsh 重装。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 0.1.0-rc.6+
  • Node: >=24
  • Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则