快速入门

假设你已经完成了安装，本页帮你 5 分钟上手 ArkPilot。

与助手对话

方式一：聊天触发（最常用）

在聊天栏输入 @助手触发词 消息：

@helper 你好！
@builder 帮我建一个小木屋

每个助手有不同的触发词，默认助手：

助手	触发词	说明
小墨	@helper	通用助手，解答问题、管理事务
小匠	@builder	建筑助手，规划和建造

方式二：私聊模式

"锁定"一个助手，之后所有聊天自动发给它：

1. 输入 /ark 打开菜单
2. 点击助手 → 点击"私聊模式"按钮
3. 之后直接打字就是和助手对话
4. 用 ! 前缀发送公共消息（如 !大家好）
5. 超过 15 分钟无交互自动退出

方式三：GUI 菜单

输入 /ark 打开助手管理菜单：

• 查看所有可用助手
• 查看/管理对话历史
• 查看/编辑助手记忆
• 设置助手别名

助手能做什么？

回答问题

@helper 怎么去主城？
@helper 服务器有哪些规则？

执行命令

@helper 把我传送到主城
@helper 把时间改成白天

AI 会根据权限白名单调用服务器命令。敏感操作会弹出确认按钮。

记住你的偏好

@helper 以后叫我小明就好
@helper 我喜欢中世纪风格的建筑

助手会自动记住这些信息，下次对话时使用。

建造建筑

@builder 帮我建一个 7x7 的橡木小屋
@builder 在这里建一个石砖瞭望塔

建筑助手会规划结构、生成蓝图、逐步建造。

为你的服务器定制

编辑服务器信息

编辑 plugins/ArkPilot/SERVER.md，写入你的服务器特色内容：

# Server Info

## Server Overview
这是一个空岛生存服务器，玩家从一个小岛开始冒险。

## Basic Rules
1. 禁止使用外挂
2. 禁止恶意破坏他人岛屿
3. 友好交流

## Economy
- 货币：金币
- 赚钱方式：完成任务、出售物品
- 商店位置：主城传送点

## Key Locations
| 位置 | 坐标 | 说明 |
|------|------|------|
| 主城 | (0, 100, 0) | 传送点和公共设施 |
| 商店 | (50, 100, 50) | NPC 商店区 |

## FAQ
- 怎么创建岛屿：使用 /is create
- 怎么邀请好友：使用 /is invite <玩家名>

修改助手人格

编辑 assistants/player-helper/SOUL.md 来调整助手的性格和行为风格。

编辑 assistants/player-helper/IDENTITY.md 来修改助手的名字、形象和口头禅。

添加技能文档

在 skills/ 目录下创建新技能：

skills/my-guide/SKILL.md

在 SKILL.md 开头添加 frontmatter：

---
name: my-guide
description: 我的自定义指南
---

# 我的指南内容
...

然后在助手配置中启用：

skills:
  load:
    - server-wiki
    - my-guide      # 新增

管理员命令

命令	说明
/ark	打开助手管理菜单
/ark reload	重载所有配置
/ark retry	重试上一条消息