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/kimialready on yourPATHare 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
gitrepo +DESIGN.md, get a PR. Seeod-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
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则