@eric.wen/dsh-sight

DeepSeek Harness（DSH）插件：自动补推理等级 + Figma MCP 桥接。

设置页分两个独立入口：模型推理等级 与 Figma MCP，各自独立配置、互不影响。

功能

🧠 自动补推理等级

新增第三方渠道后，模型默认没有任何推理档位（模型选择器里看不到 Low/High/Max 等选项）。设置页点一下「自动补推理等级」，插件会按内置的模型家族字典，给未声明推理档位的模型写入其官方支持的档位：

• 字典只是兜底：写入前先问适配器，适配器（内置目录 / 渠道自带元数据）已经描述推理能力的模型一律不动——目录的 thinkingLevelMap 是按渠道转写的，比字典准，而 pi-ai 是整体替换而非合并这个映射，写下去只会把模型变窄（例如目录里的 minimal 会消失）或多出厂商不认的档位。字典只用于适配器描述不了的模型（自建中转的私有模型 id）；
• 已有档位声明（含 reasoningEfforts: false）一律不动；
• 预设按渠道协议生效：Claude 档位只写入 api: anthropic-messages 渠道，GPT/o 系只写入 openai-completions / openai-responses 渠道，同名模型挂在别的协议中转上不会误写；
• Claude 自适应思考机型（Opus/Fable/Sonnet 5、Opus 4.6+）同时写入 compat.forceAdaptiveThinking: true，档位以 output_config.effort 发送；Opus 4.7+/5 另写 supportsTemperature: false。已有的其他 compat 键保留；
• 结果区会列出写入、跳过（含原因：适配器已描述 / 已有声明）与失败（某个渠道被配置校验拒绝，其余渠道仍然写入）三类明细——所以"写入 0 个"会说明为什么；
• 每行「推理(声明)」右侧有「清除声明」（需点两次确认）：删掉该模型写入的 reasoningEfforts 及本插件写入的 compat 键，让适配器/内置目录的档位重新生效。这是插件唯一能做的"修复"——它读不到内置目录，无法算出正确档位，但取消声明之后 pi-ai 会回退到目录自己的 thinkingLevelMap，比重写更安全；手写的其他 compat 键保留；
• 档位值取自各家族厂商渠道的 thinkingLevelMap（zai 的 GLM、deepseek 的 V4、moonshotai 的 Kimi、openai 的 GPT、google 的 Gemini）；
• 写入 llm-pi-ai 配置的 reasoningEfforts，下次请求即生效。

🔍 实测图片能力（端点探测）

自建渠道名（ollma、hyper-charm 之类）不在 pi-ai 内置目录里，其模型默认按纯文本处理，即使模型本身支持图片。每行的「实测图片能力」会先用纯文本对照请求确认链路可用，再发一张 1×1 探针图问端点：接受就写入 input: [text, image]，拒绝或无法判定就按探针前快照回滚。结果是三态的（端点接受 / 端点拒绝 / 无法判定），无法判定 绝不显示成 不支持。详见下文「使用」。

🔗 Figma MCP（渐进式）

在设置页的 Figma MCP 入口，通过两个递进的引导区块接入 Figma：

① 设计稿 → 代码（只读插件，无 REST API）

让模型读取 Figma 设计稿并生成代码。通过 Figma Desktop 中的本地插件桥接读取画布，不调用 Figma REST API，不需要 Personal Access Token 或代理，因此不会触发官方 API 限流。

• 数据来源：Figma Desktop 插件 localhost bridge，提供节点树、选区、CSS、样式、变量、组件、截图与仓库匹配等读取工具；
• 底层引擎可随时切换（设置页「Figma MCP → ① 设计稿 → 代码 → 底层引擎」，保存后即时生效、无需重启 DSH）：
  • figma-ui-mcp 原引擎（默认）：Figma 插件「Figma UI MCP Bridge (Sight)」，模型可见 figma_status / figma_read / figma_rules / figma_files，保留 get_css / export_svg / scan_design 等读取操作；
  • figwright 接地引擎：Figma 插件「Figwright」。在设置页插件安装卡点「一键下载最新版」即可自动下载并解压最新 release（保存在本机配置文件旁，只保留最新一份；网络失败时可点「手动下载（Releases）」兜底），再在 Figma 中 Import plugin from manifest... 选择解压出的 manifest.json 并运行一次。模型可见约 27 个只读工具（get_design_context / component_map / token_map / icon_map / design_diff / get_screenshot 等）。可选填「目标代码目录」，服务器会只读扫描该本机工程，把 Figma 组件/Token/图标匹配到工程已有实现，生成能直接落地、复用既有组件的代码——目录仅本机读取，不会上传任何代码；
• 使用：启用后在 Figma Desktop 运行当前引擎对应的插件（两者可同时安装，互不冲突），打开目标文件并选中画板/节点，再对模型说"实现成 React/CSS"即可；
• 安全边界：此入口无论哪个引擎都只注册只读工具，不能创建、修改、删除或移动画布节点。

② AI 主动设计（需要 Figma 桌面版 + 插件）

让模型直接在 Figma 画布上绘制/修改设计。需要：

• Figma 桌面版（网页版无法连接 localhost）；
• 首次安装 Figma 插件（一次性）：
  1. Plugins → Development → Import plugin from manifest...
  2. 选择设置页显示的 manifest.json 路径
  3. 运行「Figma UI MCP Bridge (Sight)」插件，看到绿点即已连接（该副本带多文件路由补丁：同时开多个文件时读写会锁定指定文件，见下方「多文件路由」）
• 之后每次只需在 Figma 里运行该插件即可，无需重复导入。

启用后，模型通过 figma_write / figma_read / figma_status 等工具在画布上绘制/修改/截图验证。

两个区块相互独立：① 需要运行插件但只读画布，② 才允许 AI 修改画布。两者可以同时启用，分别使用 figma-read 与 figma-ui 工具 namespace。

✅ 无需开通 Figma 会员

插件走的是社区开源 figma-ui-mcp localhost bridge，并由 dsh-sight 提供只读 MCP facade，不依赖 Figma 的任何付费功能：

对比官方 Figma MCP：远程 server 需要 OAuth，且按套餐/席位限流（View/Collab 席位每月仅约 6 次调用，写画布要求 Dev/Full 席位）。本插件用免费账号即可跑通全部能力，无套餐门槛。

安装

方式一：npm（推荐）

dsh plugin --profile desktop add @eric.wen/dsh-sight

桌面版 DSH Desktop 用 desktop profile；本地 CLI 用 web（按你的实际 profile 替换）。

npm 分发预构建产物，无需任何授权。

方式二：GitHub

dsh plugin --profile desktop add github:ericfetch/dsh-sight#<commit-sha>

一条命令即可：仓库已提交预构建 lib/ 且无 prepare 构建脚本，安装时无需任何构建授权。

验证

dsh --profile desktop --dump-config   # 应出现 "# == @eric.wen/dsh-sight" 补丁层

然后重启 DSH Desktop，插件自动加载。

升级

发布新版本后，不需要卸载重装——通过 --latest 参数直接升级到 npm 最新版：

dsh plugin --profile desktop update --latest @eric.wen/dsh-sight

• 想锁死大版本范围或装指定版本：dsh plugin --profile desktop add @eric.wen/dsh-sight@0.1.4；
• 更新后重启 DSH Desktop 生效。

卸载：dsh plugin --profile desktop remove @eric.wen/dsh-sight

使用

模型推理等级

1. 补推理等级：打开 设置 → 模型推理等级，点「自动补推理等级」，为未声明档位、且适配器描述不了的模型按模型家族写入其支持的推理档位；
2. 确认：结果区列出被写入的 provider/model → 家族 [档位]，以及被跳过的模型（适配器已描述 / 已有声明）和写入失败的渠道；模型选择器随即出现这些档位；
3. 复核：渠道列表里每行显示该模型当前的推理来源（推理: … = 来自适配器/目录，推理(声明): … = 来自你写入的 reasoningEfforts）与图片能力（🖼 可读图片 / 仅文本）。想改一个已存在的档位声明（包括写错的），点该行的「清除声明」让目录档位重新生效，或到 设置 → 模型 里手工改——本插件不会覆盖已有声明。

实测图片能力（探测端点是否真的收图）

DSH 的图片准入是声明制：读 inputModalities，未知一律拒绝。而 input 的解析顺序是「模型声明 → 内置目录同名条目 → 渠道 defaultInput（默认 ["text"]）」，所以自建渠道名（如 ollma、hyper-charm）的模型即使本身是多模态，也默认是纯文本——目录里没有这个名字可继承。

点某一行的「实测图片能力」可以真的问一次端点，而不是靠猜：

1. 纯文本对照请求先跑一次（证明 baseURL / 凭据 / 模型 id 都通）；
2. 通过后写入 input: [text, image]；
3. 回读适配器解析出的模态——没生效就不会发图（否则会被本地门拦下，误判成"端点拒绝"）；
4. 用附件服务生成一张 1×1 PNG 探针图并发出去；
5. 端点接受 → 保留声明；拒绝或无法判定 → 按探针前的快照精确回滚（原本没有 input 就删掉，原本有就还原原值），不留痕迹。

结果三态显示，无法判定 不等于 不支持：

说明与代价：

• 探测不能替代声明，只是"一次性发现手段"：它产生的是一条声明，准入仍按声明走；
• 每次探测会产生一次极小的真实模型调用（max_tokens: 16，1×1 图片），会计费；只在你点按钮时发生，不会批量自动跑；
• 探针图经附件服务归一化后再发，所以它测的是真实发图链路（含 DSH 的编码与尺寸预算），不是另拼一个请求；
• 官方 DeepSeek 渠道不在探测范围内：它的模态写在渠道目录的 inputModalities 里，本探测不写该目录；
• 想手工声明（或取消声明），到 设置 → 模型 → 该渠道 → 展开模型行 → 勾选/取消「输入类型」里的「图片」。

输入框里的标记：当前会话所用模型已声明支持图片时，输入框右侧（模型选择器左边）显示 🖼 可读图片。它读的就是准入检查用的 inputModalities，所以标记在 = 粘贴图片会被接受；没有标记不等于模型只能读文本（那看设置页的「仅文本」chip），只表示当前这条路由没有声明图片。

Figma MCP

1. 设计稿 → 代码（区块 ①）：设置页选择底层引擎并（可选）填「目标代码目录」→ 启用 → 重启 DSH（首次启用需要）→ 在 Figma Desktop 运行当前引擎对应的插件（figma-ui-mcp 引擎跑「Figma UI MCP Bridge (Sight)」；figwright 引擎跑「Figwright」，均在设置页指引内安装）→ 打开目标文件并选中画板/节点，说"实现"；
2. AI 主动设计（区块 ②）：按区块内指引安装「Figma UI MCP Bridge (Sight)」→ 启用 → 重启 DSH → 在 Figma 运行该插件 → 回对话描述设计需求。

引擎切换即时生效：工具列表会自动刷新，当前对话即可使用新工具；若未刷新，重启 DSH Desktop 即可。① 与 ② 可同时启用；两个 Figma 插件可同时安装、互不冲突（各自只连本机 127.0.0.1 的桥接服务）。

多文件路由（同时开多个 Figma 文件）

「Figma UI MCP Bridge (Sight)」是 DSH 生成的补丁副本（设置页有「多文件路由补丁」状态与「重新生成副本」按钮），它让每个 Figma 文件在桥接服务里各自占一条会话（f:<fileKey> + 文件名），于是读写可以锁定到指定文件：

• 只开一个文件：自动路由，无感；
• 同时开多个文件：模型必须先用 figma_files 指定目标（{ use: "<文件名>" }），否则读写会直接报错并列出候选文件——绝不猜（宁可报错也不写错文件）；
• 指定后写入会锁定该文件；该文件关掉插件/关闭后，DSH 会报错提示重新指定，不会改写到另一个打开的文件；
• 也可以在调用时显式传 sessionId（覆盖锁定值）。

⚠️ Figma 导入 dev 插件时会复制文件到它自己的目录：如果你以前导入过旧版「Figma UI MCP Bridge」，请在插件列表里删掉那一项，再用设置页里的路径重新导入一次（现在显示为「Figma UI MCP Bridge (Sight)」，用于区分旧的那份）；没重新导入时仍可用（单文件），但结果里会带一条提醒。

写入端还有一个隐藏的补丁（figma-ui-mcp 生成的入口，设置页显示「服务端入口已补丁」）：上游服务在「桥接已被别的进程占用」时会走 HTTP 代理并丢掉 sessionId，补丁把它补回来，因此在任何启动顺序下路由都成立。

📖 场景化的「怎么对模型说」见下方 Figma MCP 使用手册。

Figma MCP 使用手册（场景与话术）

0. 先知道模型手里有哪些工具

DSH 把 MCP 工具挂给模型时带命名空间前缀（形如 mcp__figma-read__figma_read、mcp__figma-ui__figma_write）。对话里不必背前缀——按功能名说即可，模型会自动调用正确的工具；它拿不到图时会先运行 figma_status 自检。

figma_files 是写入端新增的路由开关：列出当前连着桥接服务的 Figma 文件，并锁定本次要操作的那个（同时开多个文件时，不锁定就会直接报错而不是猜）。

连接自检话术（任何会话开始时可选）：

先调用 figma_status 确认 Figma 插件已连接；如果没连上，直接告诉我该在 Figma 里运行哪个插件。

1. ① 设计稿 → 代码：什么场景用哪个引擎

2. ① 设计稿 → 代码：场景与话术

通用要点：先选中要转的画板/节点再发话；话术里给足「技术栈 + 输出位置 + 复用规则」，越具体越准；说完让它截图自查。

一句话模板（可自行填空）：

把我在 Figma 选中的【对象】实现成【技术栈：React + Tailwind v4 / Vue3 + scss …】。项目在【目录：figwright 引擎时必填】；【复用规则：优先 import 已有组件、用工程 token、图标走 assets】；输出到【src/components/…】；完成后用截图核对。

关于图片/资源：代码里遇到位图（logo、摄影图）时，让模型留占位并提示“请从 Figma 手动导出资源”，不要凭空近似。

3. ② AI 主动设计：场景与话术

前提：设置页 ② 已启用且 Figma 里运行了「Figma UI MCP Bridge (Sight)」（绿点）。② 与 ① 可同时启用，模型两种工具都有；只有 ② 能改画布，想避免任何误写时只启用 ①。

通用动作模板：

画之前先【读取画布/选区】→ 用文件里已有的【变量/样式/组件】→ 尺寸给【具体数值】→ 每完成一步【截图自查】→ 结尾告诉我【创建/改动清单】和下一步建议。

4. 常见问题速查

说明

• Figma MCP 区块①和②都走 localhost 插件桥且无需代理/Token；① 的引擎与目录切换即时生效并持久化，只暴露读取工具，② 才暴露写画布工具。
• 依赖的 @deepseek-ai/* 运行时由 DSH 模块表提供（peer 声明）。
• 「实测图片能力」用的附件服务（attachments，由 @deepseek-ai/dsh-attachment-local 提供）是可选注入：没有它时其余功能照常，只有探测返回 无法判定。该服务只以结构化接口访问（不 import 其类型），因此不列为 peer 依赖——它只在运行时通过模块表可达。
• 测试：pnpm test（node --test，无额外依赖）。

开发

pnpm install
pnpm build        # tsdown：lib/index.js + lib/client.js
pnpm typecheck    # tsc --noEmit

发布：npm version <新版本> → npm publish --access public → git push origin main --tags

License

MIT