plugin-commands — 指令系统

包名: @aalis/plugin-commands
源码: packages/plugin-commands/src/index.ts

概述

内置指令注册与执行系统，支持指令前缀配置、递归子指令和声明式参数/选项解析。

插件声明

meta.name = '@aalis/plugin-commands'
meta.provides = ['commands']
meta.inject = { required: ['gateway'] }

配置

字段	类型	默认值	说明
commandPrefix	string	'/'	指令前缀：指令触发前缀，设为空字符串可使用纯关键词触发

内置指令

指令	参数	说明	可见性
/help	[name]	无参时列出顶层指令（子指令只显示个数）；带指令名时显示用法详情，空格和点两种写法都可以，如 /help clear all	public
/status	—	系统状态	public
/clear	[--type/-t <type>]	清空当前会话指定类型；默认全部类型	public（需确认 confirm: session；群聊等共享会话要求等级 ≥ 2 或 owner，私聊不限）
/clear list	—	列出可清理类型	public
/clear all	[--type/-t <type>]	【危险】清空全部会话中指定类型的内容；不指定类型时清空全部类型	restricted（risk: dangerous，等级 2，需确认 confirm: session）
/shutdown	—	关闭应用	restricted
/restart	—	重启应用	restricted

/model 由 plugin-agent 注册，/tools 由 plugin-tool-system 注册，/authority、/level、/auto 由 plugin-authority 注册，详见各自页面。

单条指令的等级与确认可在 plugin-authority 配置中按能力键 command:<点路径>（如 command:clear.all）覆盖，见 plugin-authority 文档。

选项解析形式

执行时按命中节点声明解析选项：

• --name value
• --name=value
• --flag / --no-flag（boolean 显式开/关）
• -t value（短名在 option 的 syntax 字符串中声明，如 .option('type', '-t <type:string[]>')）
• string[] 支持重复传入或逗号分隔，如 -t vector -t image、--type context,summary

参数支持单引号或双引号包裹，也可以用反斜杠转义，如 "hello world" 会作为一个参数；-- 之后的内容全部按位置参数处理。

/clear 类型

/clear 通过 memory:clear hook 让各插件参与清理。本插件自身负责 context（经 memory 服务清空消息历史）和 image / video / audio / file 四类附件缓存（data:/images 等目录，按会话划分子目录），其余类型由对应插件的中间件处理。可用类型：

类型	内容
context	消息历史与会话上下文
summary	会话摘要
vector	向量记忆
image	图片缓存
video	视频缓存
audio	语音缓存
file	文件缓存
persona	会话角色状态
checkpoint	检查点（对话回滚存档）
user-profile	用户档案，仅全局清理
user-relation	用户关系图谱，仅全局清理

示例：

/clear
/clear --type context,summary
/clear -t vector -t image
/clear all --type user-profile