Dex Buddy发给同事
下载 Markdown插件页加载本地目录，或打成 zip 拖进工作台。不要把源码复制进 Dex Buddy。
开发时挂到 Dex Buddy
打开已经装好的 Dex Buddy，进入插件页，点加号，选「加载本地目录」。选中的文件夹可以是插件根（里面直接有 plugin.manifest.json），也可以是一个父目录，里面每个子目录是一个插件。父目录只登记一次。取消选择不会改列表。
不要把源码复制进 Dex Buddy 的安装目录。改一处、另一处还是旧的。正确路径只有插件页「加载本地目录」。
日常改模型调用：按 模型 拷 dex-buddy-sdk.js / dex_buddy_sdk.py，对照 SDK_VERSION，本机填 DEX_BUDDY_API_KEY，index.js 里 requireEntitlement(ctx) 再 bindModels(ctx)，Python 子进程用 childEnv。装进 Dex Buddy 验收时走上面这条路，业务代码不用改。不要把 Key 打进 zip。
这条路径记在用户数据目录的 unpacked-plugins.json，重启后还在。本地实例的 id 是 dev- 加上该目录真实路径的哈希，不是清单 id。设置页、plugin-data 和页面调用的服务都用实例 id。清单 id 相同的已安装插件可以同时开着，保存或移除本地实例不会改到它的密钥和 plugin-data。
详情「…」里可以重新加载，或按发布预览（与插件中心同一套文件和依赖，仍用这份实例的设置）。重新加载会从登记的源码目录重读清单并重新挂上后端。工作区标题栏的重新加载对本地实例同样重挂后端，对已安装插件只刷新页面。移除只取消登记并删掉这个实例 id 下的宿主数据，源码还在磁盘上。
改完 index.js、它 require 的子文件或页面后，在插件详情或标题栏重新加载，不必退出。
打成 zip 给别人安装
同事拖进工作台的 zip 由作者自己打。压缩包要满足其中一种：
- 解压后根上就是
plugin.manifest.json - 解压后只有一层目录，这个目录里有
plugin.manifest.json
不要打进密钥、虚拟环境和依赖目录。包里不要出现绝对路径或 ..。拖进工作台的 zip 和插件中心的差别见 打包 里的「两种安装包」。安装之后不要把缓存、导出和数据库写回安装目录，见 数据。
对方打开 Dex Buddy，把 zip 拖进欢迎页，或从图标轨的拼图进入插件页，加号里选「添加压缩包」。列表会马上出现，不用重启。同一个已安装插件再次安装会覆盖。插件页加载的本地目录使用另一把实例 id，不挡住这次安装。
发到插件中心
同事不收下载地址。作者改版本、推 tag。需要 Python 或 Node 依赖时在清单里声明 runtime。步骤见 发到插件中心。
这样会加载失败
id含大写、中文、下划线，或超过 64 个字符。type写成ui，但没有uiEntry。main、uiEntry或settingsEntry写成绝对路径，或路径里有..。- zip 里没有
plugin.manifest.json，或有多份、Dex Buddy 无法确定用哪一份。 - 服务方法返回了函数、类实例，或页面调用了一个不存在的方法。
- 服务名已经被另一个非本地插件注册过。本地实例和已安装插件可以注册同一个服务名，页面只会调到自己这份。