扩展包
把技能、Canvas 工具、种子页面与仪表盘打包成一个可安装单元 —— 卸载干净、绝不误删数据。
**扩展包(Pack)**是 NevoFlux 扩展能力的打包形式 —— 包含技能、
Canvas 工具、用作起步的知识库
页面,以及一个 Canvas 仪表盘 —— 通过单个 pack.toml 清单安装。一次
安装把所有东西就位,一次卸载又干净地全部移除。
扩展包面向 pack-protocol/0.1 协议。
一个扩展包能打包什么
| 组件 | 它带来什么 | 落地位置 |
|---|---|---|
| 技能 | 可复用的智能体能力 | ~/.config/nevoflux/skills/ |
| Canvas 工具 | 白名单中的命令 / 内部工具 | ~/.config/nevoflux/canvas-tools/ |
| 种子页面 | 可供你编辑的知识库起步页 | GBrain(仅当不存在时写入) |
| 仪表盘 | 一个常驻的 Canvas 微应用 | 我的 Canvas |
每个组件都是可选的 —— 扩展包可以只带其中任意子集。
平台为你保证什么
扩展包作者只写声明和文件;守护进程负责如何安装与卸载。因此你得到:
- 事务性安装 —— 任一步骤失败,已完成的操作全部回滚。
- 幂等 —— 重复安装同一版本是空操作;种子页面仅当不存在时写入;仪表盘按固定 id 更新。
- 路径安全 —— 文件只会落在白名单扩展目录中,清单无法越界。
- 凭据驱动的干净卸载 —— 平台精确记录它放置了什么,并恰好逆向移除。除非你明确要求 清除数据,否则绝不删除你的知识库数据,并会跳过你安装后已编辑过的文件。
安装与管理扩展包
三种方式:设置 → Packs 面板、安装链接,或命令行。
设置 → Packs
设置 → Packs 列出已安装的扩展包,并支持从本地 pack.toml 路径
或 GitHub 源安装。远程源在写入任何文件前会先经过检视 → 预览 → 确认流程。每行都有
更新与卸载操作,并提供一个默认关闭的“同时删除该扩展包的数据”选项。
安装链接(packhub)
扩展包可以通过一个深链接从任何地方一键发起安装 —— 网站、README,或 packhub 目录:
nevoflux://pack-install?src=<github-源><github-源> 仅支持 GitHub:简写 github:owner/repo[/sub][@ref],或一个
https://github.com/owner/repo[/tree/ref/sub] 链接。点击该链接会打开一个专用安装页,运行
与 设置 → Packs 相同的检视 → 预览 → 确认流程 —— 预览内容、标记其中携带的工具二进制、
对会阻止安装的策略违规项给出拦截,并要求你明确点击 Install 后才会写入(已安装的扩展包
会改为显示更新 / 重装)。链接只能发起安装 —— 绝不会静默执行。
nevoflux://pack-install?src=github:owner/repo
nevoflux://pack-install?src=github:owner/[email protected]
nevoflux://pack-install?src=https://github.com/owner/repo钉一个 @ref(标签或提交)可获得可复现的安装。在网页上放一个安装按钮:
<a href="nevoflux://pack-install?src=github:owner/[email protected]">在 NevoFlux 中安装</a>命令行
命令行需要守护进程在运行:
nevoflux pack validate <path/to/pack.toml> # 干跑能力检查,不写入
nevoflux pack install <path/to/pack.toml> [--force]
nevoflux pack list # 已安装的扩展包
nevoflux pack status <name> # 版本、组件数量、依赖
nevoflux pack update <path/to/pack.toml>
nevoflux pack uninstall <name> [--purge-data] [--force]