83 行
7 KiB
Markdown
83 行
7 KiB
Markdown
|
|
# 错题本
|
|||
|
|
|
|||
|
|
## 2026-07-22 — 异步消息链内同步保存过多
|
|||
|
|
|
|||
|
|
- 阶段:源码复盘与性能审计
|
|||
|
|
- 类型:性能 / 环境 / 功能行为
|
|||
|
|
- 现象:私聊、群聊、命令、主动行为和多个 Mixin 中频繁直接调用 `_save_data_sync()`;静态统计约 313 处,部分位于 `async with self._data_lock` 内。
|
|||
|
|
- 根因:功能长期增量开发时,各模块各自承担数据修改与立即持久化,没有统一单写者和保存合并策略。
|
|||
|
|
- 修复或规避:本次只记录基线;后续引入 `SaveCoordinator`,锁内制作 snapshot,锁外用线程落盘,普通变化合并保存,关键事务显式 flush。
|
|||
|
|
- 预防规则:新的 async Handler 不得直接调用同步文件 I/O;不得在持有 `_data_lock` 时执行 JSON 序列化或磁盘替换。
|
|||
|
|
- 验证证据:全仓静态扫描 `_save_data_sync()`、`_data_lock` 和 `_write_data_snapshot_sync` 调用点;源码可编译通过。
|
|||
|
|
|
|||
|
|
## 2026-07-22 — 发送前 Hook 顺序依赖隐式注册顺序
|
|||
|
|
|
|||
|
|
- 阶段:AstrBot 消息流对照
|
|||
|
|
- 类型:API契约 / 功能行为
|
|||
|
|
- 现象:插件注册大量 `on_decorating_result`,很多使用默认优先级;多个 Hook 会调用 `event.stop_event()`。
|
|||
|
|
- 根因:发送出口功能按需求逐个追加,没有统一优先级带和单一出口编排器;AstrBot 同优先级依赖注册顺序,停止事件会跳过后续 Hook。
|
|||
|
|
- 修复或规避:后续把安全拦截、链路所有权、内容清洗、表现转换和发送确认划分为固定优先级带,逐步收敛成少量编排函数。
|
|||
|
|
- 预防规则:新增发送前 Hook 必须声明阶段、优先级、是否可能停止事件、停止后哪些后续动作允许被跳过。
|
|||
|
|
- 验证证据:对照 AstrBot 4.26.7 `StarHandlerRegistry`、`call_event_hook`、`ResultDecorateStage` 与本插件全部装饰器。
|
|||
|
|
|
|||
|
|
## 2026-07-22 — 缺少与规模匹配的自动化回归
|
|||
|
|
|
|||
|
|
- 阶段:源码复盘与回归验证
|
|||
|
|
- 类型:测试
|
|||
|
|
- 现象:插件约 14.3 万行 Python、33 个 Mixin,未发现测试文件。
|
|||
|
|
- 根因:功能开发主要依赖运行时人工验证,消息事件、主动任务和多平台能力缺少可复用 Fake。
|
|||
|
|
- 修复或规避:修改功能前先建立最小 AstrBot Event、ProviderRequest、Result、Bridge 和 Store 测试夹具。
|
|||
|
|
- 预防规则:每个新功能至少覆盖“触发”“不触发”“降级”“停止传播/放行”四类路径;涉及发送的功能必须验证发送后确认不被误触发。
|
|||
|
|
- 验证证据:全仓测试文件扫描为空;`python -m compileall -q` 通过只能证明语法正确,不能证明消息行为正确。
|
|||
|
|
|
|||
|
|
## 2026-07-22 — AstrBot 内部 API 耦合面过大
|
|||
|
|
|
|||
|
|
- 阶段:兼容性审计
|
|||
|
|
- 类型:API契约
|
|||
|
|
- 现象:静态统计约 234 处 `from astrbot.core...` 导入,覆盖 Agent、数据库 PO、平台对象、Handler Registry 和文件服务。
|
|||
|
|
- 根因:主动消息、内部 Agent 调用和跨平台发送需要框架深层能力,但适配逻辑散落在多个业务 Mixin。
|
|||
|
|
- 修复或规避:建立集中式 `astrbot_runtime_compat`,启动时 capability probe,业务层只依赖适配接口。
|
|||
|
|
- 预防规则:新增 AstrBot 内部导入必须进入兼容层,不得直接添加到业务模块;升级 AstrBot 前先跑兼容矩阵。
|
|||
|
|
- 验证证据:对照本机 AstrBot 4.26.7 源码和插件全仓 import 扫描。
|
|||
|
|
|
|||
|
|
## 2026-07-22 — 白话复盘文档阶段检查
|
|||
|
|
|
|||
|
|
- 阶段:文档交付
|
|||
|
|
- 类型:其他
|
|||
|
|
- 现象:本阶段未修改陪伴逻辑,也未发现新的运行问题。
|
|||
|
|
- 根因:不适用。
|
|||
|
|
- 修复或规避:新增独立白话注释版复盘文件,对消息阶段、保存阻塞、Hook 顺序和内部 API 耦合做非技术化解释。
|
|||
|
|
- 预防规则:讨论新功能时先用白话确认触发条件、数据所有者、可见范围和失败方式,再落实到具体 Hook 与模块。
|
|||
|
|
- 验证证据:白话版提供七问需求模板和分阶段改造顺序。
|
|||
|
|
|
|||
|
|
## 2026-07-22 — 陪伴人格不能直接取得运维写权限
|
|||
|
|
|
|||
|
|
- 阶段:VM 运维人格融合评估
|
|||
|
|
- 类型:API契约 / 功能行为 / 安全
|
|||
|
|
- 现象:用户希望同一个陪伴人格同时负责聊天、开发协助和 NAS 运维入口,容易在实现时把 HAPI、Shell 或 NAS 写工具直接加入主人格。
|
|||
|
|
- 根因:产品体验要求“像同一个她”,但生产系统实际依赖最小权限子智能体、确定性审批和控制器事实源。
|
|||
|
|
- 修复或规避:PrivateCompanion 只负责模式、日程、表达、委派和主动提醒;代码交给 code_dispatcher,NAS 只读交给 nas_observer,写操作继续走 `/nas` 一次性审批。
|
|||
|
|
- 预防规则:人格连续性不得通过扩大工具权限实现;新增运维能力必须先确定工具所有者、审批边界和事实来源。
|
|||
|
|
- 验证证据:VM 实机确认 Ops Suite、HAPI、NAS Controller 和 Persona 工具白名单均为独立服务或受限接口,真实 NAS 写模式仍关闭。
|
|||
|
|
|
|||
|
|
|
|||
|
|
## 2026-07-23 — 双分支仍需独立插件身份和数据
|
|||
|
|
|
|||
|
|
- 阶段:普通陪伴版与专用运维版分线评估
|
|||
|
|
- 类型:部署 / API契约 / 功能行为
|
|||
|
|
- 现象:如果运维分支仍保留普通版 `PLUGIN_NAME`,两个版本会共用 AstrBot 注册身份、数据目录、扩展页路径和备份包身份,存在升级覆盖与数据串用风险。
|
|||
|
|
- 根因:源码分支属于开发管理概念,AstrBot 运行时只识别插件名、目录、配置、路由和安装来源,并不知道代码来自哪条 Git 分支。
|
|||
|
|
- 修复或规避:运维版使用 `astrbot_plugin_private_companion_ops`,普通版继续使用原名;首次部署复制旧数据并由迁移器升级,之后禁止两版共用数据目录或双写。
|
|||
|
|
- 预防规则:专用分支上线前必须验证可独立安装、保存、升级、卸载,并阻止普通市场自动更新覆盖运维包。
|
|||
|
|
- 验证证据:已核对 `constants.py`、`main.py`、`page_api.py` 和 `metadata.yaml` 的身份、数据目录、页面路由及备份校验逻辑,并形成 `双分支运维版可行性评估.md`。
|
|||
|
|
|
|||
|
|
## 2026-07-23 — 运维版娱乐模块删减需保留阅读与创作
|
|||
|
|
|
|||
|
|
- 阶段:运维版功能边界确认
|
|||
|
|
- 类型:功能行为 / 性能
|
|||
|
|
- 现象:如果按“娱乐模块”整体删除,可能误删用户明确需要的私密阅读和长期创作,也可能把用于排障的识图能力一并删除。
|
|||
|
|
- 根因:当前多个能力都表现为陪伴活动,但私密阅读、长期创作、新闻娱乐、空间发布、生图和多模态输入的用途并不相同。
|
|||
|
|
- 修复或规避:运维版明确保留 `PrivateReadingMixin` 与 `CreativeMixin`;标记删除新闻/网页娱乐探索、QQ 空间、B站娱乐探索、纯娱乐生图分享及其主动消息链路;TTS、语音和排障识图另行评估。
|
|||
|
|
- 预防规则:删减模块时按业务用途和依赖链拆分,不能根据“看起来像娱乐”整组删除;必须同步清理配置、命令、Hook、后台任务、缓存、页面和时间线来源。
|
|||
|
|
- 验证证据:产品决定已写入 `双分支运维版可行性评估.md` 的运维版功能边界和第 4 阶段队列。
|