Agent of Empires配置完全参考config.toml与Profile关键设置详解【免费下载链接】agent-of-empiresManage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding.项目地址: https://gitcode.com/gh_mirrors/ag/agent-of-empiresAgent of Empires 是统一管理 Claude Code、OpenCode、Codex CLI、Gemini CLI 等 AI 编码 Agent 的多会话调度中枢支持 TUI 与 Web 双端操作。本文详解其配置文件config.toml的三层覆盖机制与 Profile 关键设置帮助你快速完成 Agent of Empires 配置。配置文件放在哪里Agent of Empires 的设置采用三层覆盖模型逐层按字段覆盖未设置的字段自动继承上一层层级文件路径作用范围全局~/.agent-of-empires/config.toml所有会话生效Linux 默认在~/.config/agent-of-empires/Profile~/.agent-of-empires/profiles/名称/config.toml仅该 Profile 内会话仓库项目根目录.agent-of-empires/config.toml仅该仓库权限最受限目录结构大致如下~/.agent-of-empires/ config.toml # 全局配置 profiles/default/ config.toml # Profile 覆盖层 sessions.json # 会话数据自动管理 所有配置项都可以在 TUI 的设置界面按s和 Web 仪表盘中直接编辑改完即写回 TOML 文件。完整键值参考见 docs/guides/configuration.md。Profile 是什么多身份工作区一键切换Profile 是彼此隔离的工作区每个 Profile 拥有独立的会话列表、分组和配置覆盖。典型用法是把「个人项目」和「客户项目」分开管理。aoe # 使用 default profile aoe -p work # 使用 work profile aoe profile create client-xyz aoe profile list # 列出所有 profile aoe profile default work # 把 work 设为默认Profile 配置文件是一个稀疏覆盖树文件里只写你要改的字段其余全部继承全局配置。例如只想给客户 Profile 换个主题、禁用 YOLO 模式# ~/.agent-of-empires/profiles/client-xyz/config.toml description 客户交付专用禁止跳过权限确认 [theme] name empire [session] yolo_mode_default falseProfile 还支持一个description字段会在 TUI 和 Web 新建会话时的 Profile 选择器中显示为辅助说明。加载逻辑见 src/session/config/profile_config.rs它会对覆盖值做类型校验写错的键会给出警告而不是静默丢弃。config.toml 核心区块详解[theme]主题与配色[theme] name empire # 内置 8 套empire、tokyo-night-storm、dracula 等 color_mode truecolor # truecolor | palette老终端可切 256 色TUI 和 Web 共用同一主题自定义主题只需把 TOML 文件放进~/.agent-of-empires/themes/可用aoe theme export empire一键导出作为模板。内置主题源文件在 themes/builtin/。[session]会话行为最高频设置区[session] default_tool claude # 新建会话默认使用的 Agent yolo_mode_default false # 是否默认跳过权限确认 smart_rename true # 根据首轮对话自动重命名会话 auto_stop_idle_secs 0 # 0不自动停止7200闲置 2 小时后回收几个新手最容易问到的键default_tool新会话默认 Agent也支持自定义 Agent 名称找不到时回退到首个可用工具yolo_mode_default终端视图下等价于--dangerously-skip-permissions结构化视图下映射为 ACP 的bypassPermissions。smart_renamesmart_rename_agentsmart_rename_model自动重命名默认用会话自己的 Agent可以指定一个更便宜的「工具型 Agent」如 codex来执行再用smart_rename_model { claude haiku }为每个 Agent 钉住低价模型避免小标题烧掉大量 tokencustom_agents为 AoE 无法识别的命令定义自定义 Agent例如custom_agents { lenovo-claude ssh -t lenovo claude }配合agent_detect_as继承内置 Agent 的状态检测agent_status_hooks向各 Agent 的配置注入状态检测钩子默认开启关闭后回退到 tmux 面板内容解析可靠性略降。[acp]结构化视图调优[acp] default_new_session_view auto # auto | structured | terminal restrict_agents false # 开启后结构化会话只能用 allowed_agents 里的 Agent allowed_agents [claude, codex]offer_structured_in_new_session是否在 TUI 新建会话弹窗中提供结构化视图选项Web 端始终提供acp_defaults.agent为每个 Agent 预设model、effort思考级别、mode创建会话时即可指定pin_model true锁定模型restrict_agents是运营级开关只从全局配置读取Profile 无法放宽Web 端修改需要口令二次确认。[tmux] / [diff] / [updates]体验微调[tmux] status_bar auto # AoE 主题状态栏你的 tmux.conf 有配置时自动让位 mouse auto # 滚轮/触摸板进入复制模式滚动 [diff] default_branch main context_lines 3 split_view false # true 并排对比 [updates] update_check_mode notify # auto | notify | off离线网络用 off[worktree] 与 [sandbox]隔离工作目录与容器[worktree] enabled false # 新会话是否自动建 git worktree path_template ../{repo-name}-worktrees/{branch} [sandbox] enabled_by_default false default_image ghcr.io/agent-of-empires/aoe-sandbox:latest environment [GH_TOKEN$AOE_GH_TOKEN]两个区块都有完整独立文档worktrees.md 与 sandbox.md这里不展开。环境注入与钩子给 Agent 喂 Token 的正确姿势全局 environment 列表environment [ GH_TOKEN$AOE_GH_TOKEN, # 从 AoE 自身环境读取 TERM, # 裸键 直接透传 ]支持KEYvalue字面量、KEY$VAR引用、KEY$$literal转义和裸键透传四种写法。注意该列表只作用于非沙箱host会话沙箱会话请配置sandbox.environment两者互不相通。想要更安全的做法用[host_hooks]在启动时动态铸造临时 token[host_hooks] before_start [echo GH_TOKEN$(my-mint-tool $AOE_REPO_SLUG)]钩子输出的每一行KEYVALUE都会成为 Agent 的环境变量stdout 永不落日志适合注入机密。[host_hooks]仅限全局/Profile 层——仓库配置不允许在宿主机执行命令。[status_hooks]桌面通知自动化[status_hooks] enabled true on_waiting notify-send -a aoe 等待输入 \$AOE_SESSION_TITLE\ on_error notify-send -u critical -a aoe 出错 \$AOE_SESSION_TITLE\on_starting、on_running、on_waiting、on_idle、on_error在对应状态切换时触发命令中还能取到AOE_SESSION_ID、AOE_PROJECT_PATH等变量适合做桌面通知和个性化自动化。配置解析源码在哪看全局配置结构与所有设置项定义src/session/config/mod.rsProfile 稀疏覆盖与合并校验src/session/config/profile_config.rs仓库级配置与钩子安全策略src/session/config/repo_config/Profile 子命令create/list/defaultsrc/cli/profile.rs常见配置问题速查症状排查点设置改了不生效确认改的是哪一层仓库层 Profile 层 全局层列表字段是整体替换而非追加Profile 覆盖报未知键警告拼写检查如[sandbox] privildged会被列出并跳过想让某个 Profile 彻底独立该 Profile 下重复声明你要保留的 map 类字段如custom_agentsProfile 的 map 会整体替换全局离线环境频繁检查更新全局设update_check_mode off掌握三层覆盖 Profile 稀疏覆盖这两条主线你就覆盖了 Agent of Empires 配置 90% 的日常场景其余键值工具会话[tools.*]、日志[logging]、Web 推送[web]都遵循同样的写法可对照官方配置文档按需查阅。【免费下载链接】agent-of-empiresManage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding.项目地址: https://gitcode.com/gh_mirrors/ag/agent-of-empires创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
企业数字化 ERP 产品动态
相关推荐
Python手写机器学习算法：从逻辑回归到多分类实战指南 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 2:32:13
＜数据集＞煤矸石识别数据集＜目标检测＞ 一、数据集简介
YOLO与VOC格式的煤矸石数据集，适用于YOLO系列、Faster Rcnn、SSD等模型训练，类别：Coal、Rock，图片数量3091。 文件中包含图片、txt标签、指定类别信息的yaml文件、xml标签，已将图片和txt标签划分为训练… · 2026/9/27 2:32:13
单节锂保IC如何快速定制？CM100E新国标方案解析 /* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/9/27 2:31:42
企业网站开发介绍源码下载 不懂代码想做企业站？这份完整流程与费用清单请收好 自己不会代码，心里却盘算着给公司弄个像样的官网，这种焦虑我太懂了。很多老板或市场负责人在咨询时，第一句话往往是“我啥也不懂，能不能直接给我一个能用的网站？”别慌，这正是今天要聊的核心。作为在… · 2026/9/27 3:09:07
网站怎么做优化推广避坑指南 备案不卡壳的5个实操要点 网站怎么做优化推广避坑指南 备案不卡壳的5个实操要点 刚接手新项目，最让人头大的往往不是写代码，而是备案流程一头雾水。很多前端新手以为网站上线只是 npm run build 加个 nginx 配置，结果卡在 ICP… · 2026/9/27 3:09:01
慈溪网站制作哪家最好，一文搞懂防坑与安全底线 慈溪网站制作哪家最好，一文搞懂防坑与安全底线 在慈溪找建站公司，最让人头疼的就是怕被坑高价，还怕网站上线后漏洞百出，稍不留神就被黑客盯上。很多老板以为只要网站好看、能访问就行，殊不知在慈溪这种外贸出口大市，网站安全直接关系到企业信誉和订单安… · 2026/9/27 3:08:55
游戏补单机制：从一次 0.3% 的漏单说起 ⚠️ 各平台支付接口与政策变动频繁，本文用于建立架构认知与工作流。 具体接口签名、字段、时效以各平台官方最新文档为准。 开篇：0.3% 的漏单，毁掉一款月流水千万的游戏
这是一个数字游戏。
某款卡牌手游，上线三个月，月流水 1200 万
日均支付订单：8000 笔
漏单率：0.3… · 2026/9/27 3:08:55
MATLAB雷达信号脉冲压缩仿真：LFM线性调频、匹配滤波与距离分辨率实现 简介：这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程，从线性调频（LFM）信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑，面向电子信息工程、计算机、数学等专业学生，适用于课程设计、期末大作… · 2026/9/27 0:00:01
汕头网站建设制作厂家避坑指南：5大注意事项救急 汕头网站建设制作厂家避坑指南：5大注意事项救急 改个需求建站公司拖一周，这种憋屈事我见得太多了。 很多汕头老板找本地建站团队，签合同前看着方案挺美，一上线就变脸。 今天不聊虚的，直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01
多模态虚假新闻检测实战：BERT+ResNet双塔与对比学习 简介：基于PyTorch的多模态虚假新闻检测项目完整代码包，面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者，解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征，以Res… · 2026/9/27 0:00:01
MATLAB雷达信号脉冲压缩仿真：LFM线性调频、匹配滤波与距离分辨率实现 简介：这套Matlab仿真工具完整呈现雷达信号脉冲压缩过程，从线性调频（LFM）信号生成、目标回波仿真到匹配滤波压缩处理均有可运行代码支撑，面向电子信息工程、计算机、数学等专业学生，适用于课程设计、期末大作… · 2026/9/27 0:00:01
汕头网站建设制作厂家避坑指南：5大注意事项救急 汕头网站建设制作厂家避坑指南：5大注意事项救急 改个需求建站公司拖一周，这种憋屈事我见得太多了。 很多汕头老板找本地建站团队，签合同前看着方案挺美，一上线就变脸。 今天不聊虚的，直接拆解找 汕头网站建设制作厂家 时的5个核心 注意事项… · 2026/9/27 0:00:01
多模态虚假新闻检测实战：BERT+ResNet双塔与对比学习 简介：基于PyTorch的多模态虚假新闻检测项目完整代码包，面向自然语言处理与计算机视觉交叉方向的开发者、科研人员及毕业设计选题者，解决社交媒体中文本与图像联合识别虚假新闻的问题。系统以BERT预训练模型提取文本语义特征，以Res… · 2026/9/27 0:00:01
