少女祈祷中...
l_o_o_k的个人网站

0.25升级指南

从 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 stash

pop时原路径已经不存在,大概率冲突——恢复时请把内容手动放到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(这是配置问题,不要当请求失败重试)

七、重启并确认

  1. /重启
  2. /agent.状态:看模型健康(每个使用点是可用还是缺哪个能力)与三级权限摘要
  3. 群里 @ 它一次:能正常回话就说明 model_think 通了
  4. 想验证语音:让它说一句短话(语音由模型逐条决定,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 换了模型,旧向量不在同一空间——换回原模型,或接受重建

九、这一版新增了什么(可选开启)

升级完就能用、不用额外配置的部分:

  • 语音回复:没配语音模型也会自动用内置 Edge;要不要发由模型逐条决定
  • 备份:/备份 与每日自动备份
  • 调度管理:/任务列表 之类,查看与暂停各服务的定时任务
  • 年终总结:/年终总结
  • 定时任务:她可以给自己安排提醒,重启后仍在
  • 记忆自动回忆:memory_prefetch_enabled(默认关,开启后每轮多一次嵌入调用)
分享到

评论