DSH to Figma 0.3.0

• 增强画布查询与批量修改，支持属性筛选、层级关系和链式操作。
• 完善变量、模式、别名、组件变体与实例修改工作流。
• 新增任务会话、文件校验和错误恢复提示，支持脚本文件输出与构建进度显示。
• 同步更新 Figma 配套插件，保留宿主版本开放策略及 DSH 0.2.1-rc.3 兼容声明。
• 更新中英日 README，优先推荐提示词安装，加入新的实机演示案例。

DSH to Figma 0.2.3

中文

修复升级 DSH 到 0.2.1-rc.3 后，插件被宿主兼容性检查拦截、Figma 工具无法注册的问题。

更新内容

• 设置 engines.dsh: "*"，取消 DSH 宿主版本限制。宿主采用该字段判断加载兼容性，不再因插件的 DSH peer 版本范围而拒绝加载。
• 保留运行依赖声明和 Node.js 要求；后续宿主版本若出现实际 API 兼容问题，再针对问题修复。
• 中、英、日 README 改为记录「已测试版本」，不再以版本白名单作为加载条件。

感谢 @heeq666 在 Issue #1 中提供详细的复现步骤、根因分析和本地验证结果。

安装与升级

下载 dsh-to-figma-0.2.3.tgz，使用宿主原生 CLI 安装。官方 macOS DSH Desktop 示例：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
  plugin --profile desktop add "file:/绝对路径/dsh-to-figma-0.2.3.tgz"

重启 DSH，让它调用 figma_setup 更新本机已配对插件。已导入稳定 manifest 路径的用户，重新运行 Figma 插件即可。

附件与验证

• dsh-to-figma-0.2.3.tgz：推荐的 DSH 安装包。
• DSH-to-Figma-companion-0.2.3.zip：无凭证的通用备用插件，需要手动配对。
• SHA256SUMS：上述两个文件的 SHA-256 校验值。

已用官方 rc.3 发行包中的兼容性检查函数验证：旧声明会被拒绝，新声明可以通过。33 项自动化测试及现有 rc.2 原生集成检查通过；本次未完成 rc.3 的真实 Figma 端到端验证。取消版本拦截不代表所有宿主版本均已实测。

English

Set engines.dsh to "*" so DSH no longer blocks plugin loading based on the host version. Runtime dependency declarations and the Node.js requirement are retained. Future API compatibility issues will be addressed when encountered; documented versions now mean tested versions.

The compatibility evaluator shipped in DSH 0.2.1-rc.3 rejects the old manifest and accepts the new one. All 33 tests and the existing rc.2 native integration check passed. Actual Figma end-to-end testing on rc.3 has not been completed in this release.

Thanks to @heeq666 for the detailed report and local verification in #1. Install the TGZ with your host CLI, restart DSH, run figma_setup, then rerun the companion. The standalone ZIP contains no credentials and requires manual pairing.

日本語

engines.dsh: "*" を設定し、DSH ホストのバージョンによる読み込み制限を解除しました。実行時の依存関係は維持し、今後の API 互換性の問題は発生時に対応します。README のバージョン表記は検証済みバージョンを示します。rc.3 の互換性チェック通過は確認済みですが、rc.3 と実際の Figma を組み合わせた全工程の検証は未完了です。

DSH to Figma 0.2.2

中文

Figma 本地插件换用更紧凑的深色 UI，减少画布遮挡，并融入项目产品图中的品牌连接插画。

更新内容

• 常规连接与暂停状态的内容区缩小至 300 × 158，设置和提示展开时自动调整高度。
• 修复暂停状态的文字拥挤及底部多余留白，恢复连接提示移至底栏。
• 暂停／恢复、设置改为紧凑图标按钮；文件名过长时自动截断。
• 中文优先，保留手动配对、文件链接及连接诊断。
• README 默认中文，另提供英文和日语版本。

安装与升级

下载 dsh-to-figma-0.2.2.tgz，使用宿主原生 CLI 安装。官方 macOS DSH Desktop 示例：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
  plugin --profile desktop add "file:/绝对路径/dsh-to-figma-0.2.2.tgz"

重启 DSH，让它调用 figma_setup 更新本机已配对插件。已导入生成的稳定 manifest 路径时，重新运行 Figma 插件即可；首次使用请在 Figma 桌面端通过 Plugins → Development → Import plugin from manifest 导入工具返回的文件。

附件

• dsh-to-figma-0.2.2.tgz：推荐的 DSH 安装包。
• DSH-to-Figma-companion-0.2.2.zip：无凭证的通用备用插件，需要手动配对。
• SHA256SUMS：上述两个文件的 SHA-256 校验值。

本地模式不消耗官方 MCP 调用额度。Release 附件不包含本机配对凭证。本次通过 GitHub 分发，未发布到 npm。

验证

33 项自动化测试、原生 DSH 集成检查及 GitHub CI 通过。已在真实 Figma 中验证 0.2.2 版本、已连接状态、设置展开／收起和暂停／恢复，用户已试用并确认 UI 效果。

English

Version 0.2.2 introduces a compact dark Figma companion with a 300 × 158 connected/paused content area, brand connection artwork, icon controls, and automatic height adjustment. It fixes crowded paused-state text and extra bottom space. Chinese is now the default README language, with English and Japanese alternatives.

Install the TGZ with your host CLI, restart DSH, and ask it to run figma_setup. Rerun the companion from the generated stable manifest. The standalone ZIP is a credential-free manual-pairing fallback. All 33 tests, native integration checks and GitHub CI passed; connection, settings and pause/resume were verified in Figma.

日本語

コンパクトなダーク UI、ブランドイラスト、アイコンボタン、自動高さ調整を追加しました。一時停止中の文字の詰まりと余白を修正しています。TGZ をインストールして DSH を再起動し、figma_setup でローカルプラグインを更新してください。ZIP は認証情報を含まない手動ペアリング用の予備パッケージです。

DSH to Figma 0.2.1

中文

默认使用本地编辑模式：安装 DSH 插件后，DSH 会自动生成这台电脑专用、已配对的 Figma 插件。首次在 Figma 导入一次 manifest，之后运行即可自动连接，无需复制密钥。

更新内容

• 默认本地模式，自动生成稳定路径的已配对插件目录及私有 ZIP。
• 单个连接文件自动绑定；多个文件或旧连接失效时要求明确选择，避免误改其他文件。
• 空闲断线自动重连；执行结果不确定时不自动重放写入。
• 修复 Figma 沙箱缺少 crypto.randomUUID 导致启动卡住的问题。
• 官方桌面 MCP 保留为可选的读取、截图模式。官方远程 OAuth 客户端注册仍返回 403，未打通。

安装 / 升级（推荐）

1. 下载 dsh-to-figma-0.2.1.tgz，用宿主的原生 CLI 安装。官方 macOS DSH Desktop 示例：

"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
  plugin --profile desktop add "file:/绝对路径/dsh-to-figma-0.2.1.tgz"

2. 重启 DSH；确认 DSH to Figma 组件运行中。旧版本如果显式设置了 backend: desktop，请改为 backend: local 后重启。
3. 对 DSH 说“帮我连接 Figma”，让它调用 figma_setup 返回生成的 manifest 路径。默认路径为 ~/.dsh/figma/companion/manifest.json；使用其他 DSH_HOME 时以工具返回为准。
4. Figma 桌面端 → Plugins → Development → Import plugin from manifest，导入上一步的文件。在目标设计文件中运行 DSH to Figma · Local，它会自动连接。使用时保持插件窗口打开，设计模式即可。

已导入这个稳定路径的用户，升级后重新运行 Figma 插件即可。仍使用旧 node_modules 下清单的用户，请重新导入生成的新路径。

下载文件说明

• dsh-to-figma-0.2.1.tgz：推荐安装包，包含自动生成已配对 Figma 插件的能力。
• DSH-to-Figma-companion-0.2.1.zip：无凭证的通用备用包，需要手动配对；正常使用上述自动生成流程时不需要下载它。
• SHA256SUMS：上述两个文件的 SHA-256 校验值。

本机生成的 companion 目录与 DSH-to-Figma-paired.zip 含本机凭证，请勿公开分享；它们不包含在 Release 附件中。此版本通过 GitHub 分发，未发布到 npm。

验证

33 项自动化测试、原生 DSH 0.2.1-rc.2 集成检查及 GitHub CI 通过。在 Figma Desktop 126.9.13 的 Design 模式中，通过真实 DSH 会话验证了自动连接、DSH 重启后恢复、单文件自动绑定、创建画板与文字、独立读回修改、截图显示和 PNG 导出（960×560）。另外通过真实 DSH 图片附件完成了 Today 待办 UI 的 1536×1024 可编辑图层还原。未据此宣称全部 Plugin API、FigJam/Slides、长期稳定性或云端保存均已验收。

验证记录与实际图片 · 中文 README

---

English

Local editing is now the default. Installing the DSH plugin lets DSH generate a private, pre-paired Figma companion for this computer. Import its manifest once, then launch it to connect automatically without copying a token.

Changes

• Automatically generated companion at a stable local path, with a private ZIP option.
• Automatic binding for a single connected file; explicit selection for multiple files or disconnected bindings.
• Idle reconnect with backoff; uncertain writes are never automatically replayed.
• Fix for Figma's opaque-origin sandbox lacking crypto.randomUUID.
• Optional official desktop MCP remains available for reading/screenshots. Remote OAuth client registration still returns HTTP 403 and is not operational.

Recommended setup / upgrade

Install dsh-to-figma-0.2.1.tgz with your host's native CLI and restart DSH. Existing explicit desktop configurations must be changed to backend: local. Ask DSH to call figma_setup, import the returned manifest in Figma Desktop under Plugins → Development → Import plugin from manifest, then run DSH to Figma · Local in the target file. Keep the companion window open; Design mode is sufficient.

Users already importing the generated stable manifest only need to rerun the companion after upgrading. Users importing an old node_modules manifest should import the newly generated path instead.

The standalone DSH-to-Figma-companion-0.2.1.zip is a credential-free, manual-pairing fallback and is unnecessary for the recommended flow. The generated private companion and paired ZIP contain a local credential and must not be published or shared. SHA256SUMS covers both public packages. Distribution remains on GitHub, not npm.

Verification

All 33 automated tests, native DSH 0.2.1-rc.2 integration checks and GitHub CI pass. Actual DSH conversation tools with Figma Desktop 126.9.13 in Design mode verified automatic connection, recovery after DSH restart, single-file binding, frame/text creation, independent readback/update, screenshot display and PNG export (960×560). A further real image-attachment task recreated a Today task UI as editable 1536×1024 Figma layers. This does not establish full Plugin API, FigJam/Slides, long-running or cloud-save acceptance.

Verification and actual image · README

DSH to Figma 0.1.4

本版修复 Figma 桌面端本地配对问题，并加入真实的「参考截图 → 可编辑 Figma UI」案例。

• 配套插件使用 localhost:3055，避免 IP 地址被 Figma manifest 校验拒绝；桥接服务仍仅监听本机，并保留精确 Host 校验与令牌鉴权。
• 正确接收来自 Figma 外层窗口的文件信息和操作结果，仅接受指定 Figma 来源；解决一直停留在“正在读取画布”的问题。
• 中英文 README 加入维护者提供的两张实机截图和案例说明，只说明 DSH 内核兼容性。
• 支持的 DSH 内核：0.2.0-rc.2、0.2.1-rc.2。

验证：23 项自动化测试通过，原生 DSH 0.2.1-rc.2 集成测试通过，包结构与生成文件检查通过。已验证实机导入和配对；案例展示原生图层重建。完整读回、修改、导出及 FigJam/Slides 验收仍待完成。

更新方式：拉取仓库最新源码，使用对应宿主 CLI 重新执行 dsh plugin --profile <你的 profile> add "file:$PWD"，然后重启宿主。在 Figma 中重新导入已安装插件的 companion/manifest.json，运行并配对。保持插件窗口打开。

附带 dsh-to-figma-0.1.4.tgz 和 SHA-256 校验文件；继续通过 GitHub 分发，未发布到 npm。

---

Fixes local Figma desktop pairing through a localhost-compatible manifest and trusted outer-window message handling. Includes a maintainer-provided screenshot-to-editable-UI example in both READMEs. All 23 automated tests and native DSH 0.2.1-rc.2 integration checks pass. See the verification record for real-editor coverage and remaining acceptance work.