14. 插件路线图

翻译说明： 本页是与 英文源规格 一一对应的机器辅助翻译。代码、协议字段和标识符保持原文；如翻译与英文源事实有歧义，以英文版本为准。

1. 指导原则

Local plugins usable → developer-friendly → marketplace distribution → signing and auto-update

2. 路线图

R1 — 基础（带 M4）✅

• 清单 v1
• 本地目录加载
• enable/disable/uninstall
• 命令面板集成
• 你好示例插件
• 权限声明显示

R2 — Agent 扩展（部分 ✅）

• 完整的代理工具管道 ✅
• 技能贡献被激活：声明的技能作为 # Skills 到达模型 授予 agent.prompt.inject 时系统提示中的目录，以及模型 通过 Skill 工具按需加载主体 ✅ (ADR 0039, D174)
• 统一命名空间和审计 ✅
• 每个插件设置 API 和生成式设置 UI 已实现。UI 支持字符串、数字、布尔、枚举、JSON 字段与插件域命令快捷键。系统级绑定已通过 keyboard.globalShortcut、 contributes.globalShortcuts 与 pi.keyboard 独立实现。
• 插件日志面板仍在计划中；运行时审计日志的存在没有专用的 插件日志表面

R3 — DX 和包装 ✅

• 插件 SDK ✅
• 模板生成✅（panel-basic、agent-tool-basic、skill-pack、 full-demo，来自插件页面、代理或 pi-plugin init）
• pi-plugin check/pack ✅（@pi-desktop/plugin-devkit，也暴露为 PluginCheck / PluginScaffold / PluginPack 代理工具）
• .piplug 安装 ✅
• 开发热重载✅（监视+反跳，并且重载永远不会扩大权限）

R4 — 市场只读 ✅

• 市场提供商抽象（官方远程 GitHub 目录提供商）
• 来自 vastsa/pi-desktop-plugins 的官方来源 browse/search（已被取代：官方来源是插件中心 plugins.aiuo.net）
• 下载+校验和安装
• 更新列表（手动更新）

R5 — 信任和自动更新（部分✅）

• 发布者验证（目录中的验证标志）
• 签名验证（仍在计划中；现在强制执行校验和）
• 权限差异升级✅
• 自动更新政策✅
• 恶意版本的拉克响应（仍在计划中）

R6 — 高级生态系统（部分✅）

• MCP 插件类型 ✅ — 通过 stdio 和远程 HTTP 的 contributes.mcpServers (D176)
• 后台服务插件 ✅ — contributes.services 受监督 重新启动（D177）
• 插件间消息总线 ✅ — 声明的主题，pi.bus.* (D178)
• 主题插件 ✅ — 插件提供 CSS 文件 (D175)
• 企业私人资源（仍在计划中）
• 市场评论/质量评分（可选，仍在计划中）

当前新增能力

• 渲染器插槽与审定的草稿/附件分发（renderer.extension）
• 清单 Provider、Add Service 分类、宿主 OAuth 登录
• 带撤销的输入框转换与可忽略的输入框建议
• 插件会话导入、读取、重命名、删除及比较更新的自动标题
• 已完成轮次用量、模型目录、宿主持有的单次补全
• 当前会话快照与工作面板视图展示
• 运行时主题、类型化变量与数据型主题设置卡片
• 有界 WebSocket 与宿主系统快捷键
• 后台音频仍返回 UNSUPPORTED，尚无设备后端

R7 — Agent 扩展（v1.1 ✅，D387 / D388）

• v1：Agent sidecar 中的 ExtensionAPI 适配层；工具、命令、生命周期与 provider hooks、 基础 UI 提示
• v1.1：模块成为插件贡献点（contributes.agentExtensions，权限 agent.extension）； “导入 pi 扩展”把 pi CLI 扩展变成开发插件；没有独立注册表或设置标签
• v2：自定义会话条目、sessionManager 只读 shim、编辑器读写、快捷键、markdown 转换器； 签名到位后开放市场分发
• v3：pi CLI settings.json 提示、统一 skill/提示发现、远程控制提示路由
• 规格：16-trusted-extensions.md；ADR 0214、ADR 0215

3. 映射到产品里程碑

产品里程碑	插件目标
M1骷髅	保留插件目录和接口存根
M2 聊天运行时	非阻塞；可以并行设计
M3工具	ToolHost保留贡献挂钩
M4 插件基金会	R1完成
M5硬化	插件隔离和稳定性
后MVP	分阶段完成 R2 并推进 R3–R6

4. 成功指标（生态系统）

1. 即使没有新的官方版本，用户也可以通过插件扩展他们的工作流程 2.第三方可独立开发并本地安装插件 3.插件故障不会破坏主应用程序的可用性 4.安装任何插件之前权限可见且可拒绝

5. 风险和缓解措施

风险	缓解措施
过早建立市场会破坏核心的稳定	推迟市场； R1 优先执行本地操作
插件安全事件	默认拒绝+审核+稍后强制签名
API 频繁损坏	api版本 / schema版本
开发者门槛高	模板+hello示例+SDK