模块与 .vpack

最后更新 · 2026-09-05

**模块(Module)**是以 .vpack 包发布的扩展功能。模块向 VibeSpace 声明式地贡献能力:导航入口、界面槽位、后台进程、技能与专家定义——包本身不携带可任意执行的代码。

内置模块:VibeWorking

随应用内置、默认启用的必备模块,贡献了:

  • 侧栏导航的全部主入口(新建任务、技能、看板、定时任务、专家、项目);
  • 内置技能 review-code
  • 6 位内置专家/团长定义;
  • 看板与浏览器等页面。

若模块状态异常,模块页提供「修复 VibeWorking」安全模式按钮,可一键恢复内置模块。

可选模块:VibeCoding

为工作区提供内嵌本机终端

  • 出现在工作台底部面板,可直接执行命令、查看输出;
  • 终端与 Agent 共处同一工作区,便于手动干预和验证 Agent 的改动;
  • 终端由模块自带的独立 worker 进程驱动,与 Agent 运行时相互隔离。

安装与卸载

在「模块」页中:

  1. 导入 .vpack:选择下载或构建好的模块包;
  2. 安装时会校验签名(Ed25519)与 SHA-256 完整性清单,校验失败会拒绝安装;
  3. 已安装模块可以停用 / 启用(停用后其贡献的导航与功能即消失);
  4. 支持回滚到上一版本,或彻底卸载

当前没有远程模块市场,模块包通过侧载方式分发(从可信渠道获取 .vpack 文件)。

安全模型

  • 签名 + 完整性:每个 .vpack 都经过 Ed25519 签名,包内文件清单做哈希校验,防篡改;
  • 声明式贡献:包内容不会被当作代码加载执行;导航、界面、技能、专家都以声明的方式注册;
  • 能力请求:模块需要敏感能力(如「本地终端」)时必须显式声明,由你在安装/启用时决定是否授予;
  • 进程隔离:模块 worker 是独立进程,帧传输有大小上限,崩溃不影响主应用。

依赖与恢复

模块可以声明对其他模块的依赖;安装、升级、回滚时由包管理器统一解析。若升级后出现问题,回滚机制可以恢复到之前的工作状态。