日常对话 · 项目工作 · 先规划再执行 · 持续完成长任务
Emperor Agent 是一款面向个人长期使用的桌面 Agent。你可以用它处理日常问答，也可以绑定本地项目，让 Agent 在明确的权限范围内读取文件、运行工具并持续推进任务。
导航
认识 Emperor Agent
Emperor Agent 里有几组名称看起来相似，实际处在不同层级：
| 层级 | 含义 |
|---|---|
| Chat / Build | 会话类型：一个用于普通对话，一个绑定本地项目 |
| 权限预设 | read-only、workspace-write、danger-full-access：决定 Agent 能写哪里 |
| Plan | 规划模式：先只读探索并提交方案，批准后再执行 |
| Goal | 让 Agent 在你不再输入时一轮轮继续推进同一个目标 |
| Scheduler | 按时间触发 Agent turn 的机制 |
应用会把会话、记忆、配置和附件保存在本机。Chat（普通对话）适合问答和轻量任务；Build（项目工作）绑定本地目录，并读取项目中的 AGENTS.md / CLAUDE.md。
每个会话都完整记录在本机；应用崩溃后，会话可以自动修复并继续使用。
“本地优先”不等于完全离线。模型请求会发送给你配置的 Provider；调用远程 MCP、会联网的 Skill 或命令时，对应内容也会离开本机。
下载与首次使用
安装包适合直接使用，不要求目标机预装 Node.js、Python、Git 或 ripgrep。
- 打开 GitHub Releases。
- 根据设备选择 macOS、Windows 或 Linux 安装包。
- 当前公开安装包是未签名 Preview，不是 Stable。运行前请阅读未签名预览版安全说明。
- 第一次启动后进入设置页，添加模型 Provider、API Key 和模型 ID。
- 创建 Chat 开始普通对话，或者选择本地目录创建 Build 会话。
没有可用模型时，对话和模型测试会给出配置入口；熟悉配置文件的用户也可以参考 config/examples/model_config.example.json。
模型配置
设置页可以保存多个标准接口模型，管理 Provider、协议、凭证和能力；当前使用哪个模型在聊天输入框中选择，切换从下一次请求开始生效。Provider 为 deepseek 时使用内置的 DeepSeek 适配器，其他 Provider 按所选协议走 OpenAI Chat Completions 或 Anthropic Messages。可重试的错误最多自动重试 5 次，不会暗中切换模型。
模型配置、记忆和附件见模型、记忆与附件。
Chat、Build、Plan 与 Goal
Chat：普通对话
Chat 适合日常问答、资料整理和一次性的工具任务。它使用用户档案、全局长期记忆和当前会话历史，工作目录是 Emperor Home 下的 workspace/，不绑定你的项目。
Build：项目工作
Build 会话绑定一个本地文件夹，适合代码、文档和其他项目任务。Agent 会读取项目中逐级的 AGENTS.md / CLAUDE.md 和该项目的私有记忆。项目私有记忆保存在全局 stateRoot，不会写回项目文件。
权限预设
| 命令 | 行为 |
|---|---|
/permissions read-only |
可以读取；任何写入都需要你逐次批准 |
/permissions workspace-write |
默认。可以写当前 workspace 和临时目录；超出范围时逐次请求批准 |
/permissions danger-full-access |
不限制写入，也不弹出审批 |
批准只对那一次工具调用有效。Shell 命令在 macOS（Seatbelt）和 Linux（bubblewrap）上由系统沙箱执行；其他平台没有沙箱后端，只有 danger-full-access 才能运行 Shell 命令。受限预设主要限制文件写入；macOS 还拒读 Emperor 的电脑操作状态与浏览器数据，并阻止部分系统 GUI 连接。普通文件读取和互联网访问仍不受此文件沙箱普遍限制。
Plan：先规划再执行
/plan
/plan 为现有项目设计一套迁移方案
/plan off
进入 Plan 后，Agent 先只读探索、必要时向你提问，然后提交一份完整计划。你可以选择 Approve（退出 Plan 并开始执行）或 Keep planning（附上意见让它修改）。Plan 通过提示词约束 Agent，实际写入范围仍由当前权限预设决定。
Goal：持续推进一个目标
/goal 让项目的全部测试通过
设置 Goal 后，每当 Agent 空闲，系统会自动发起新一轮续跑，直到 Agent 判断目标完成、报告受阻，或达到轮数上限（默认 256 轮）。你的消息始终优先。
| 命令 | 作用 |
|---|---|
/goal |
查看当前 Goal |
/goal <目标> |
设置 Goal |
/goal edit <目标> |
修改目标 |
/goal pause |
暂停自动续跑 |
/goal resume |
恢复自动续跑 |
/goal clear |
清除当前 Goal |
应用重启后 Goal 保留，但需要 /goal resume 才会继续续跑。Goal 不提高权限。
No comments yet.