/dr-plugin 命令 — Datarim 插件系统
/dr-plugin 如何管理 Datarim 的可选扩展:双清单架构、datarim-core 引导、基于符号链接的安装,以及启用/禁用和回滚的分阶段路线图。
Datarim 自带一组固定的技能、代理、命令和模板。插件系统使这组内容可扩展,而无需修改核心安装。/dr-plugin 是管理这些扩展的 CLI。
所有子命令均已实现:list(首次运行时引导 datarim-core 条目)、enable、disable、sync 和 doctor。从 git URL 启用插件是唯一仍被推迟的路径;目前 enable 接受绝对路径。
双清单架构
每个插件都带有一个静态清单——plugin-storage/<id>/plugin.yaml——与其源文件一起提交在插件自己的仓库中。该清单描述插件包含的内容和依赖。第二个运行时清单位于工作区内的 datarim/enabled-plugins.md,记录该项目中哪些插件处于活动状态。这两层被有意分开:静态清单随插件一起移动;运行时清单属于工作区。
第三方插件以符号链接形式从 datarim/plugin-storage/<id>/ 安装到项目运行时 .datarim-runtime/local/{skills,agents,commands,templates}/<plugin-id>/;不会在你的主目录下写入任何内容。符号链接方式意味着插件的源文件保留在一处,运行时从标准加载路径获取它。
首次运行时的 datarim-core
首次运行 /dr-plugin list 会引导 datarim-core 条目。当前 Datarim 随附的整套内容——随框架一起安装的所有技能、代理、命令和模板——被注册为单个受保护的插件。它不能被禁用。这使得核心与第三方组件之间的边界从一开始就明确。
底层实现是一个位于 scripts/dr-plugin.sh 的 POSIX 友好 bash 脚本,兼容 bash 3.2 及以上版本。插件 ID 验证强制使用最长三十二个字符的 kebab-case 标识符。源验证接受绝对路径和 HTTPS URL;嵌入的凭据和路径遍历序列会被拒绝。
退出码和环境变量覆盖
退出码 0 表示成功。退出码 1 是验证或冲突错误。退出码 2 是 I/O 或文件系统错误。退出码 3 表示锁被并发调用持有。退出码 64 是来自无法识别的子命令或缺少参数的用法错误。
两个环境变量允许测试时覆盖:DR_PLUGIN_WORKSPACE 指向替代的工作区根目录,DR_PLUGIN_RUNTIME_ROOT 指定符号链接目标根目录,默认为 ${DATARIM_RUNTIME}/local,且必须与项目运行时匹配。测试套件(77+ 个用例加四个覆盖率门禁)在 macOS bash 3.2 和 Linux bash 5 上通过。
路线图
阶段 A3 到 D 已完成:enable 和 disable 支持对 datarim-core 的首次运行清单回填,overrides: 机制支持冲突预扫描,通过 sync 实现快照和回滚,以及 doctor,它现在运行十项诊断检查。阶段 A4——直接从 git URL 启用插件——仍被推迟。
了解如今如何用 /dr-addskill 扩展框架,或在 Datarim 是什么中了解更广泛的背景。