dsh-openpencil
ZSeven-W/dsh-openpencil
OpenPencil 设计预览与编辑插件。
安装
把 dsh-openpencil 装进 DeepSeek Harness
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库,也不需要额外配置。如果你用的是别的 profile,把 `web` 换成对应的名字。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
桌面版有自己的 profile,叫 desktop,只认它自带的 dsh 命令——npm 装的 dsh 会直接拒掉这个 profile。先在应用菜单里点 Manage dsh Command… 装上这个命令,打开一次桌面版再彻底退出,跑下面这条,然后重新打开桌面版。
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/desktop/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
我们的实装是在 npm 版 dsh 的 web profile 里跑的,没在桌面版上跑过。
我们跑过之后
我们跑过,装得上
这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 11 天前,DeepSeek Harness 0.2.2-rc.1.
挂进你的 README
给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。
安装前须知
装 dsh-openpencil 之前,先看这几条
- 源码在这里: ZSeven-W/dsh-openpencil——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:MIT。
安全
装 dsh-openpencil 会执行什么
- 构建脚本
我们这次实装里没有构建脚本被拦。
来源:我们在沙箱里的实装,DeepSeek Harness 0.2.2-rc.1,11 天前。
- 安装钩子
package.json 里没有 preinstall / install / postinstall 脚本。
来源:最近一次同步时读到的 GitHub 上的 package.json。prepare 没有记录——它只在从 GitHub 装时执行,被 pnpm 拦下时会出现在「构建脚本」那一行。
- README 里提到
shell 命令(bash、exec、spawn 之类)
来源:对 README 做的关键词匹配,只提示它可能碰到什么,不是代码分析。
这不是安全审计。上面是一次实装记录加两次文本扫描,没有人替你读过这个插件的代码。插件带着你 agent 的权限在跑。
AI 锐评
是什么 — DeepSeek Harness OpenPencil 插件在对话中集成 OpenPencil,允许预览、检查和编辑真实 .op 文档。
谁该装 — 在需要处理多帧 .op 文档的 agent 任务中使用 DSH 时适合安装此插件。
如果不涉及任何设计文档预览或编辑工作,则不必安装。
注意 — 实测通过:在全新 profile 里装上并被 harness 注册进 profile。
会执行 shell 命令是静态检查提示,非缺陷。
没发现其他明显坑。
锐评 — 我会装它,因为它提供 exact multi-frame .op previews 和 managed editor 工具。
grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。
dsh-openpencil 是做什么的

dsh-openpencil 是一个 DeepSeek Harness 插件,用于在会话中预览、检查、创建和编辑真实的 OpenPencil .op 文档。它通过 OpenPencil 的 headless exporter 和 Web SDK 工作:agent 可调用 openpencil_render 生成不可变的内容寻址快照,渲染当前页面的顶层 frame,并按需打开交互式画布;设置 editable: true 后则进入托管编辑器,进行节点选择、图层和属性调整、绘制、撤销重做及显式保存。
插件提供 openpencil_new、openpencil_create、openpencil_edit、openpencil_render、openpencil_selection 五个工具。设计修改使用事务性的 batch_design 程序;新文档写入 workspace-relative .op 路径,并经由 DSH sandboxed filesystem,在整批操作成功后才发布。已有路径不会被覆盖,保存采用 optimistic hash 和 atomic replace。预览与编辑能力通过签名且绑定 hash 的 capability 授予,不会把任意主机路径暴露给浏览器或模型上下文。
它适合需要可编辑设计稿、多个 frame 预览和画布检查的 agent 工作流。插件依赖 DeepSeek Harness 与 OpenPencil 运行时,并以 DSH 0.1.0-rc.6 测试;如果任务只需要静态图片,或根本不处理 .op 文档,就不应使用它。
dsh-openpencil 的文档
环境要求
README 记录的测试版本是 DSH 0.1.0-rc.6。插件使用 OpenPencil 的 headless exporter 和 Web SDK 处理 .op 文档,并在 DSH web app 中运行。文档路径必须是 workspace-relative 路径,文件通过 DSH sandboxed filesystem 保存。
命令
| 工具 | 用途 |
|---|---|
openpencil_new |
用一个 batch_design 程序创建新的 .op,要求使用新路径,不能覆盖已有路径。 |
openpencil_create |
将事务性的 batch_design 程序应用到现有 live canvas。 |
openpencil_edit |
修改指定节点,或修改用户当前选中的单个节点。 |
openpencil_render |
创建不可变、内容寻址的 .op snapshot,并渲染当前页面的全部顶层 frame。 |
openpencil_selection |
读取 live editor canvas 中当前选中的节点。 |
openpencil_render 支持 README 说明的 scale、editable 和 autoOpen。其中 editable: true 打开托管编辑器,工作流通常配合 autoOpen: true 展示返回的文档。
行为说明
batch_design 会在独立的 managed OpenPencil daemon 中执行。创建新文档时,只有整批操作成功后才发布结果;失败不会留下空文件。渲染结果包含首个顶层 frame 的预览,以及其他 frame 的缩略图导航。交互式 canvas 是只读的;托管编辑器提供编辑和显式保存。
预览与编辑使用签名、绑定 hash 的 capability。浏览器 metadata 不会暴露任意主机路径,这些 capability 也不会进入 canonical tool result 或 model context。已有文档保存时使用 optimistic hash 和 atomic replace。
根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README
同一分类
dsh-openpencil 的同类插件
dsh-web-ui-all
zhu1090093659
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
没有一行式安装命令——这个插件在一个大仓库的子目录里,也没发 npm 包。
DeepSeek-Balance-Whale-Widget
MeteorNOX
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
我们跑过,装得上