命令与操作
ArkPilot 的大部分功能已迁移到 GUI 界面，命令体系精简为核心操作。
命令列表
| 命令 | 权限 | 说明 |
|---|---|---|
/ark | arkpilot.use | 打开助手管理 GUI 菜单 |
/ark gui | arkpilot.use | 同上 |
/ark retry | arkpilot.use | 重试上一条失败的消息 |
/ark reload | arkpilot.admin.reload | 重载所有配置文件 |
/ark blueprint <code> | arkpilot.use | 使用蓝图分享码建造 |
/ark blueprint share | arkpilot.use | 分享最近生成的蓝图 |
/ark blueprint pause | arkpilot.use | 暂停当前建造 |
/ark blueprint resume | arkpilot.use | 恢复建造 |
/ark blueprint cancel | arkpilot.use | 取消建造 |
聊天触发
在聊天栏中使用 @触发词 前缀来与助手对话：
@helper 你好 → 默认助手（小墨）
@builder 建个木屋 → 建筑助手（小匠）触发词在助手配置的 interaction.chatTrigger 中定义。
助手别名
玩家可以在 GUI 中为助手设置短别名：
@h 你好 → 如果你设了 h 为 player-helper 的别名别名按玩家隔离，每个玩家可以设自己的别名。
私聊模式
进入私聊模式后，所有聊天自动发送给指定助手：
/ark→ 点击助手 → 私聊模式按钮- 直接打字即可对话
- 以
!前缀发送公共消息 - 超时自动退出（默认 15 分钟）
GUI 操作
输入 /ark 打开主菜单。
主菜单
显示所有可用助手列表，点击助手进入详情页。
助手详情
| 操作 | 说明 |
|---|---|
| 私聊模式 | 开启/关闭与该助手的私聊 |
| 别名设置 | 为该助手设置短别名 |
| 对话历史 | 查看和管理历史消息 |
| 记忆管理 | 查看助手记住的信息 |
| 新建会话 | 清空对话历史，开始新对话 |
| 重置 | 清空历史 + 清空记忆（慎用） |
管理员额外信息
拥有 arkpilot.admin.status 权限的管理员可以在助手详情中看到：模型配置信息、工具列表、技能列表、会话统计数据。
权限节点
| 权限 | 说明 |
|---|---|
arkpilot.use | 基本使用权限 |
arkpilot.assistant.<id> | 使用特定助手的权限 |
arkpilot.tool.<toolName> | 使用特定工具的权限 |
arkpilot.dm | 使用私聊模式的权限 |
arkpilot.admin.reload | 重载配置的权限 |
arkpilot.admin.status | 查看系统状态的权限 |
arkpilot.admin.manage | 管理会话和记忆的权限 |
工具确认机制
部分工具（如命令执行、蓝图建造）执行前需要玩家确认：
请求执行 执行命令: [✓ 确认] [✗ 取消]点击 ✓ 确认 执行操作，点击 ✗ 取消 取消操作。确认请求 30 秒后自动过期。