从 0.24 升级到 0.25
这一版的破坏性改动集中在智能体:模型配置换了结构,旧的 chat / tool 类型不再注册;功能调用改了短名,旧名只作别名、参数已经不同;整日日程换成了固定作息 + 填入层。
下面按顺序做,每一步都写了「改之前 / 改之后」和验证方式。
一、升级前
- 确认你是 git 部署。
/更新会先git stash备份已跟踪文件上的本地改动(标记atri-auto-+ 时间戳),未跟踪文件不受影响 - 备份一份
data/(升级后可以用新装的/备份做这件事) - 记下当前版本:WebUI 仪表盘或
/关于里的YHN-LK0-024 Patch4
plugins/ 里的业务插件搬走了
feed/fortune/lkchat/lkfarm/lkfishing/lkpet/signin从plugins/移到了ATRI/system/。这些是随仓库分发的内置服务,git 会把这次搬家当成重命名,所以:
- 你没有改过它们:什么都不用做
- 你手改过其中某个文件:改动会进 stash(标记
atri-auto-+ 时间戳),但 `git stashpop
时原路径已经不存在,大概率冲突——恢复时请把内容手动放到ATRI/system/` 下对应插件的同名文件里
二、更新代码与依赖
/更新 # 按配置通道更新(默认 main)
/重启
依赖这次动了两处,/更新 检测到 pyproject.toml 或 poetry.lock 变化会自动执行 poetry install:
| 依赖 | 0.24 | 0.25 | 原因 |
|---|---|---|---|
edge-tts |
6.1.19 |
7.3.1 |
微软停用了 6.x 用的旧令牌,6.x 连语音服务一律 403 |
容器部署不用管:重启时启动脚本会按 poetry.lock 自动对齐。手动部署请确认 poetry install 真的跑完了——edge-tts 停在 6.x 时语音会直接报错,提示里会让你装新版本。
三、改模型配置(最容易卡住的一步)
1. provider.yml:type 只认五种能力
data/config/system/provider.yml 里每个模型的 type 现在是能力,不再是用途:
| 0.24 的写法 | 0.25 写成 |
|---|---|
chat / work / tool / reasoning / action / language |
general |
image |
image(不变) |
embedding |
embedding(不变) |
tts |
tts(不变) |
sys1 |
sys1(不变;atri 类型已取消,对应使用点改用 general) |
# 0.24
models:
- name: siliconflow/DeepSeek-V4-Flash
type: chat
- name: siliconflow/qwen3-30b
type: tool
# 0.25
models:
- name: siliconflow/DeepSeek-V4-Flash
type: general
- name: siliconflow/qwen3-30b
type: general
写错的名字会打一条「暂不支持」的 warning 后跳过——模型等于没注册,接着就是「未配置思考模型可用」。
同一个模型可以顶多个使用点
general是通用文本模型,思考、聊天、判断、记忆、画像、日程、着装、家、总结都从它里面选。不必为了「聊天」和「思考」各买一个模型。
2. agent_config.json:五个模型字段变成十二个
data/config/plugins/agent_config.json 里的模型字段整体换结构:
| 0.24 | 0.25 | 说明 |
|---|---|---|
model_chat |
model_think + model_chat |
思考(必填)与聊天措辞拆成了两个使用点 |
model_tool |
model_judge / model_memory / model_profile / model_summary |
原来一个工具模型兼任的活,现在各选各的 |
model_image |
model_image |
不变(内部使用点叫 vision) |
model_tts |
model_tts |
不变,留空会自动用内置 Edge 语音 |
model_embedding |
model_embedding |
不变,一旦确定不要再换 |
| — | model_schedule / model_outfit / model_home |
生活系统的三个使用点 |
最少要做的:把 model_think 配上。它是唯一必填项,缺了智能体干脆不工作(聊天入口直接拒绝并告警)。其余留空都能按默认分配运行,只是各自的功能会弱一点(例如 model_chat 留空时她仍会说话,但措辞由思考模型直接给)。
WebUI 里这些字段是下拉框,选项来自 provider.yml 已注册的模型;手改 JSON 也可以,改完要 /agent.reload 或重启。
3. 顺手清理的旧字段
下面这些字段在 0.25 已不再生效,留着不会报错但也不起作用,建议删掉:
proactive_start_whitelist/proactive_start_bot/proactive_start_interval/proactive_start_hour_start/proactive_start_hour_end:主动开口改成了proactive_start的「机器人 ID → 群号」两级结构,每个群独立开关、间隔、时段与早间计划life_morning_plan:早间计划移进每个群的配置里,并新增morning_hour指定整点model_tool:已无对应使用点
proactive_start 的填法(键要手填,按 ID 精确匹配):
{
"proactive_start_enabled": true,
"proactive_start": {
"<机器人 self_id>": {
"label": "主号",
"chats": {
"<群号>": {
"enabled": true,
"interval": 120,
"hour_start": 8,
"hour_end": 24,
"morning_plan": true,
"morning_hour": 6
}
}
}
}
}
两级键都要自己填、按 ID 精确匹配,不做通配。label 只用于界面显示。
三级权限是新加的,默认留空就行
permission/permission_users默认是空的——默认权限由每个功能自己声明作用域(主人bot/ 群管理group/ 用户chat)。0.24 没有这两项,升级后会补上空的默认结构,不用动。
四、迁移旧日程
0.24 的「整日生成日程」取消了,换成固定作息 + 填写层。旧数据放在 data/config/system/ATRI_schedule.json,要手动跑一次迁移脚本:
python scripts/migrate_agent_life.py
- 旧条目会转成
data/plugins/agent/life/schedule/<日期>.json,标记为legacy - 旧
outfit是单套,白天与晚上都填同一段 - 目标日期已经有填入条目时跳过,不会覆盖新数据
- 结束后写
migration-report.json,列出转换天数与 legacy 条数
不迁移也能开机,只是她看不到以前的安排(固定作息仍然读得到)。
五、家的内容
「家」是这一版新增的,0.24 没有 home.md,不用迁移:
- 首次启动会自动从
res/data/agent/life/home.default.md复制出一份,之后她在里面记录房间与容器 - 五节固定:位置 / 房间 / 周边 / 容器 / 习惯;容器下用
###分衣物、食材等 - 每次改写前都会备份到
data/plugins/agent/life/home_history/(保留最近 20 份),改坏了可以从这里找回
如果你是从 0.25 的测试版(Pre1)一路升上来的,旧格式的家(含 外观 / 物品 / 衣柜 / 冰箱 这类旧章节名)会在启动时先备份、再按新模板重建,旧内容不会自动搬过去。
六、你可能自己写过的东西
技能正文里写的调用名
功能调用改成短名,0.24 里存在的这些名字留作别名(一个 minor 版本后移除):
| 0.24 | 0.25 |
|---|---|
send_message |
say |
send_md_message |
md |
read_md_message |
md_read |
send_face |
face |
love_change |
love |
relation_set |
rel_set |
user_profile |
profile |
memory_change |
remember |
self_memory |
self_note |
get_memories |
recall |
access_memory |
reinforce |
list_skills |
skills |
get_skill_content |
skill |
get_service_list |
services |
get_service_info |
service |
get_command_info |
command |
get_dir_tree |
tree |
read_file |
read |
0.25 还新增了一批,在旧技能里本来就没有、不需要迁移:say_exact、plan、wear、home、where、go、remind、tasks、untask、rel_get、user、alias。
别名只改名字,不改参数:send_message 仍会归一到 say,但它原来的 msg 参数已经不存在了(改成 intent / tone / count / at / voice)。所以旧技能文档里照抄的示例参数会直接被参数校验拒绝——自己写的技能要按新参数重写一遍。
stop_thinking 整个移除了,没有别名。它在旧技能/提示词里出现的,改成「说完就不要再调用任何功能」。
第三方插件的代码
ModelType 只剩五个值,旧枚举名全删了:
# 0.24
from ATRI.system.agent.llm import ModelType
await llm_manager.call_model_by_type(ModelType.CHAT, prompt, "用途")
# 0.25
from ATRI.system.agent.llm import ModelType
await llm_manager.call_model_by_type(ModelType.GENERAL, prompt, "用途")
对应关系:ATRI / CHAT / WORK / TOOL / REASONING / ACTION / LANGUAGE → GENERAL;IMAGE / EMBEDDING / TTS / SYSTEMONE 名字不变(SYSTEMONE 的值仍是 sys1)。
注意 provider.yml 里的 type 字符串用的是值(general / image / tts / embedding / sys1),不是枚举名。
内置于 ATRI/system 的宠物、投喂等已经跟着改好,你不用动;只改自己装的插件。
依赖智能体内部接口的扩展
LLMManager 的「按类型指定」改成了「按使用点指定」:
set_preferred(slot, name)/get_preferred(slot)的参数现在是使用点(think/chat/judge/memory/profile/schedule/outfit/home/summary/vision/embedding/tts),不再是类型- 选型固定,不再随机打散;指定了不存在或能力不符的模型时保留原选择并告警
- Agent 专用入口是
require(slot)/call_agent(slot, ...),缺模型时抛AgentModelMissingError(这是配置问题,不要当请求失败重试)
七、重启并确认
/重启/agent.状态:看模型健康(每个使用点是可用还是缺哪个能力)与三级权限摘要- 群里 @ 它一次:能正常回话就说明
model_think通了 - 想验证语音:让它说一句短话(语音由模型逐条决定,
tts_enabled打开、tts_max_chars不超过 60 时才可能带)
八、常见问题
| 现象 | 原因 / 处理 |
|---|---|
日志刷「xxx 的 chat 暂不支持」 |
provider.yml 里的 type 还是旧名,改成 general |
| 聊天入口直接拒聊、提示缺模型 | model_think 没配,去 WebUI 模型选择里选一个 general 模型 |
| 语音报 403 / 提示版本过旧 | edge-tts 没升到 7.3.1,重跑 poetry install;容器执行 /重启 |
| 主动开口完全不动 | 检查 proactive_start_enabled 与 proactive_start 两级键:机器人 ID 与群号都要精确匹配,任一为空就不开口 |
| 她不知道今天的安排 | 旧日程没搬,跑一次 scripts/migrate_agent_life.py |
| 她的家变成默认模板了 | 从测试版升上来的旧格式会被重建,原文件在 data/plugins/agent/life/home_history/ |
| 自己写的技能调用总是被拒 | 参数随短名一起改了,按新参数重写 |
/更新至测试版 用不了 |
已移除,改用 /更新 dev;/切换更新通道 仍可改默认通道 |
| 聊天记忆检索变空 | model_embedding 换了模型,旧向量不在同一空间——换回原模型,或接受重建 |
九、这一版新增了什么(可选开启)
升级完就能用、不用额外配置的部分:
评论