/dr-plugin
管理可选插件:列出、启用、禁用、同步、诊断
概述
/dr-plugin 是 v1.23.0(<TASK-ID>)引入的 Datarim 插件系统 CLI。它管理一组可选启用的技能、智能体、命令和模板,这些内容不属于内置的 datarim-core 随附集合。插件在设计上就是可选启用的:除非操作者明确启用,否则不会加载任何内容,从而保持 AI 上下文精简、依赖图确定。
插件是本地目录(未来阶段将支持 git URL),结构为 {plugin-id}/{plugin.yaml, skills/, agents/, commands/, templates/}。CLI 会将发现的文件以符号链接方式放入项目运行时 .datarim-runtime/local/{category}/{plugin-id}/ 命名空间(不会写入你的主目录),并可通过 overrides: 字段选择性地安装到根位置。当前启用的集合保存在 datarim/enabled-plugins.md 中——这是唯一事实来源。
用法
# 显示当前启用项 + 首次运行时执行引导
/dr-plugin list
# 启用本地插件源(绝对路径)
/dr-plugin enable /path/to/my-plugin
# 禁用已启用的插件(移除符号链接 + 清单条目)
/dr-plugin disable my-plugin
# 退出 / 恢复核心自有的默认启用策略(仅墓碑记录)
/dr-plugin disable tdd-enforcement
/dr-plugin enable tdd-enforcement
# 协调运行时 ↔ 清单(幂等)
/dr-plugin sync
# 运行 10 项健康检查;--fix 自动修复可同步修复的问题
/dr-plugin doctor
/dr-plugin doctor --fix
插件源契约
插件源目录必须包含 plugin.yaml,至少包含以下内容:
schema_version: 1
id: my-plugin # kebab-case, [a-z][a-z0-9-]{0,31}
title: My Plugin
version: 0.1.0
author: ...
license: MIT
description: ...
categories:
- skills
- commands
overrides: # 可选——安装到根位置
- my-shadow-skill.md
depends_on: # 可选——其他插件 id
- some-other-plugin
诊断健康检查(10 项)
- manifest-syntax — 必需的标量字段、有效 ID(错误)
- inventory-consistency — 声明的符号链接存在(错误,--fix → sync)
- broken-symlinks — 声明的符号链接目标缺失(错误,--fix → sync)
- orphan-files — 运行时文件不在任何清单中(警告,--fix → sync)
- override-integrity — overrides 必须位于插件的 file_inventory 中(错误,--fix → sync)
- dependency-graph — 通过 DFS 检测循环/悬空依赖(错误)
- git-state — git 工作区中存在未提交的清单(警告)
- snapshot-cleanup — 超过 30 天的快照(警告,--fix → purge)
- skill-registry — 技能 frontmatter 的
name:与文件名基名匹配(警告)——当 frontmatter 格式错误时,弥补 Skill 工具解析缺口 - disabled-defaults — 核心自有的默认启用策略(如
tdd-enforcement)的## Disabled Defaults墓碑记录段缺失或格式正确(警告;格式错误状态已安全回退到更严格的策略)
退出码
0— 无问题1— 仅有警告2— 发现错误3— 并发调用(锁被另一进程持有)64— 用法错误
安全性
每次 enable 在应用任何更改之前,都会对 runtime/ + manifest.md 创建 tarball 快照。若应用中途失败,restore_from_snapshot 会原子性地回滚。FIFO 上限 DR_PLUGIN_SNAPSHOT_MAX=50;超过 DR_PLUGIN_SNAPSHOT_AGE_DAYS=30 后按时间清理。路径遍历、URL 中嵌入的凭据以及 YAML 中的 CRLF 会在验证关卡被拒绝。对关键核心的覆盖(evolution、datarim-system、pre-archive-check)会向 stderr 发出警告但允许执行——由操作者决定。
内置插件
框架仓库在 plugins/ 下随附以下插件。它们均不计入 28 个核心命令。
dr-orchestrate—/dr-orchestrate背后的终端窗格运行器:tmux 驱动、语义解析器、机器人传输和审计后端。dr-jev-control— 面向 Claude Code、Codex 和 Cursor 的可选项目本地 Jev 路由,带有破坏性命令底线和终止开关。tdd-enforcement— 仅元数据、默认启用的工作区开关,用于严格的测试先行顺序。dr-fleet-evolution— Bash 原生循环,在故障关闭门禁之后,根据执行信号改进舰队起始技能。controller-continuation(v3.1.0+) — 面向运行自有外部控制器的项目的 worker 入口/dr-continue-checkpoint。它从控制器拥有的只读资源中精确恢复已记录的阶段,并保持生产 HOLD。应从只读框架挂载提供服务,而不是在不受信任的工作区内启用。仅限 Linux;其他平台会以continuation_unsupported_platform拒绝。
何时使用插件 vs local/ 覆盖层
- 单个项目检出的个人新增内容 →
.datarim-runtime/local/{skills,agents,commands,templates}/(gitignore 的覆盖层;加载器策略:名称冲突时本地优先)。 - 作为单元版本化、以目录或仓库分发的可共享扩展 →
/dr-plugin enable。
报告结果
在面向人工的更新或结果之前,应用 Human Outcome Reporting。说明用户可见的结果、原始条件、检查与证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确的协议和技术记录完整。若要在不继续工作的情况下再次解释,请使用 /dr-explain。