M6.1.3-R2 非五类兼容(阻断修复):DTO date 缺失时从 occurred_at 派生, 刻意不做时区换算以与 _infer_window 同一时钟;calendar_event 取 start_at、 creative_progress 取 project.updated_at;未知 kind 不再默认 bot_observed_activity; capture_hard_fact L4→L3;TYPE_CONTRACTS 覆盖全部 12 类,修复非五类 source_kind 兜底成 observed 污染本地记录;proactive_message 的 image_path 改为 has_image+ image_name(原样透传会被自身隐私校验整条静默丢弃);snapshot/daily_plan 透传 version。 M6.1.4 创作/媒体/主观分域:creative_progress 补 chunk 形参(生产调用点一直 TypeError 导致创作推进整步被阻断)并只留里程碑摘要;photo_generation 改为媒体索引 (原 payload 带 prompt 键与绝对路径,100% 静默丢弃);幂等键纳入隐私校验; 禁用键清单收窄,放行媒体标识键;两条 Bridge 路径统一送 body payload。 M6.1.5 Bot 专用检索 Profiles:按 Profile 分槽注入,固定槽位与条数、跨槽去重、 声明当前以本地运行态为准;旧版记忆插件回退通用检索。 M6.1.6 分层只读 API:新增 build_agenda_runtime_view 与 GET /agenda/runtime, 记忆插件停用时仍完整返回并标降级。 M6.1.7 隐私与残余收口:DTO 新增 contexts 禁用键;已删除娱乐功能(qzone/news/ web_exploration)的残余配置入口从展示面隐藏,旧值保留不删。 测试:174 项通过(pytest 与 unittest 双口径)。联合 E2E 135 项全部通过。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
16 KiB
错题本
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 阶段队列。
2026-07-23 — 建立 ops-main 与运行时身份隔离
-
阶段:运维分支初始化与第一批代码改造
-
类型:环境 / 部署 / API契约
-
现象:两个源码目录最初不是 Git 仓库;初始化后又因 Windows 目录所有者与沙箱用户不同触发 Git dubious ownership。Forgejo MCP 可读取仓库但令牌缺少 write:user,不能创建远端仓库。
-
根因:源码来自下载快照,缺少版本历史;Git 安全策略不信任管理员所有的目录;当前 Forgejo 令牌只有读取能力。
-
修复或规避:本地建立 companion-main 基线、upstream-sync 和 ops-main;所有 Git 命令使用仓库级 safe.directory 参数,不修改全局配置;远端仓库创建与推送留待取得明确写权限。
-
预防规则:未经成功创建和查询验证,不得把 metadata 中的远端地址宣称为已存在;推送前必须再次检查远端仓库与默认分支。
-
验证证据:companion-main 基线提交为 6eaf1b7,当前分支为 ops-main;运维身份改为 astrbot_plugin_private_companion_ops;全仓 compileall 通过。 \n\n## 2026-07-23 — 运维陪伴插件开发队列规划
-
阶段:运维版产品规划
-
类型:功能行为 / API契约 / 性能
-
现象:运维版同时包含人格、日程、外部事实、任务跟踪、主动提醒和部分阅读/创作能力,直接按文件顺序开发容易把人格和 Controller、生活日程和机器计划混在一起。
-
根因:现有 PrivateCompanion 是大型 Mixin 组合,外部运维服务尚未形成统一 capability、事件和事实引用合同。
-
修复或规避:制定 Q0-Q12 队列,先做数据迁移、运行时兼容层和运维事件模型,再做双层日程、只读事实、任务联动、主动提醒和娱乐删减;私密阅读与长期创作明确保留。
-
预防规则:先只读后写入,先事实后表达;人格只委派,不直接拥有 Shell、SSH Key、Docker Socket 或 NAS 写权限;每阶段必须有独立提交、测试和回滚说明。
-
验证证据:已核对
ops-main当前提交f496570、相关源码 Mixin 和既有运维融合评估,队列已写入运维陪伴插件开发队列.md。
2026-07-24 — Q1 迁移器不能依赖启动自动搬迁
- 阶段:Q1 数据迁移与启动安全
- 类型:功能行为 / 数据安全
- 现象:普通版和运维版插件身份已经分开,但旧数据不会自动进入运维目录;如果直接在启动时搬迁,可能覆盖正在使用的目标数据。
- 根因:插件名隔离只解决了新写入路径,没有定义一次性的跨目录迁移契约;启动阶段也不适合执行不可逆的数据搬运。
- 修复或规避:增加独立迁移器,支持 preview/run、格式校验、目标非空拒绝、SQLite backup、临时目录、迁移标记和失败清理;启动过程不自动执行。
- 预防规则:所有生产数据迁移必须先预览、再备份、后执行;目标目录必须为空;成功后保留迁移标记和源目录。
- 验证证据:
tests/test_ops_migration.py5 项 unittest 通过;人格与记忆插件 compileall 通过。
2026-07-24 — VM 放弃 LivingMemory
- 决策:运维 VM 不安装、不启用、不接入 LivingMemory;MemoryCompanion 作为唯一长期记忆源。
- 实现:运维人格分支将 LivingMemory 协同强制设为关闭,避免旧配置误开启兼容链。
- 保留:旧 LivingMemory 迁移代码暂不立即删除,待 Q9 清理遗留依赖时移除;不作为运行时依赖。
- 影响:Memory Archivist 只联动
astrbot_plugin_memory_companion_ops,不再设计 LivingMemory 回退路径。 - 验证:运维人格仍通过 compileall;MemoryCompanion 运行时探测和归档 Bridge 测试保持通过。
2026-07-24 — VM 生产仍是普通版,不能提前宣称运维版验收
- 阶段:Q2 VM 只读验收
- 类型:部署 / API契约 / 环境
- 现象:本地运维版已完成 Q1/Q2,但 VM 上未发现
_ops插件目录,因此无法执行/mcomp runtime或验证 Archivist 的运维 Bridge 发现。 - 根因:源码完成、Forgejo 推送和生产部署是三个独立状态;不能用本地提交或普通版插件在线来代表运维版已加载。
- 修复或规避:只读确认 AstrBot
4.26.6、systemd active、NRestarts=0、普通版插件和 Archivist 状态;不覆盖普通版目录,不重启生产,不绕过管理认证;记录缺口并等待单独部署验收。 - 预防规则:任何“实机验收通过”必须同时具备目标插件目录、启动导入证据、命令或 Bridge 返回结果;缺一项只能标记为“部署前置未完成”。
- 验证证据:
Q2_VM只读验收记录.md;SSH 只读检查于 2026-07-24 21:49 CST 完成。
2026-07-24 — Q3 事件合同必须在启动后重新发现 Bridge
- 阶段:Q3 运维事件与数据模型、VM 部署验收
- 类型:API契约 / 部署 / 功能行为
- 现象:两个 ops 插件已成功加载,但 Memory Archivist 初始仍报告
source=unavailable。 - 根因:Archivist 在
__init__阶段解析记忆源,早于 MemoryCompanion 完成插件实例化;on_astrbot_loaded只探测旧适配器,没有重新解析。 - 修复或规避:在宿主加载完成 Hook 中重新调用
resolve_memory_source;同时优先复用当前进程已加载的 ops 模块,避免重复导入造成空 Bridge。 - 预防规则:跨插件发现不能只测试“模块能否 import”;必须验证插件生命周期顺序、Bridge 实例是否已初始化和实机 capability 返回。
- 验证证据:VM 日志
source=memory_companion version=1.6.2-ops.1 available=True search=True;AstrBot4.26.6、NRestarts=0。
2026-07-24 — 对话日程不能直接复用 Bot 日程
- 阶段:对话日程可行性评估
- 类型:功能行为 / API契约 / 隐私
- 现象:需求希望把双方真实互动加入日程,容易直接把聊天内容写入现有
personal_agenda,从而把共享互动误记为 Bot 自身经历。 - 根因:Bot 自身日程、共享互动事件和真实外部日历的主体、可见性、证据要求和提醒语义不同;现有
record_shared_experience()默认仍偏向bot_self/bot_action,不能直接作为对话日程合同。 - 修复或规避:新增独立
dialogue_agenda/shared_interaction层;只保存事件级派生记录和source_message_ids,按scope/session_id/participants/visibility隔离;无明确时间只允许待续话题,不触发硬提醒。 - 预防规则:每个新日程事件先回答“主体是谁、证据在哪、谁可见、是否确认、提醒强度是什么”;普通聊天不自动转日程。
- 验证证据:核对
calendar_system.py、memory_companion_adapter.py、MemoryCompanioncore/bridge.py与core/service.py的日历、时间线、open-loop、session 和共享经历接口;评估文档已写入docs/对话日程可行性评估.md。
2026-07-25 — 统一日程不等于删除来源流
- 阶段:统一真实日程与 World Server 接入评估
- 类型:功能行为 / API契约
- 现象:如果为了避免“计划下午看电影、实际下午写代码”的割裂而把计划和实际直接压成一条数据流,将无法解释计划为何被覆盖,也无法处理延期、部分完成和共同活动双端同步。
- 根因:用户看到的是统一日程视图,但计划、实际活动、World 共同事件和对方活动投影的事实性、主体、权限和生命周期不同。
- 修复或规避:采用
PlanItem、ObservedActivity、WorldEvent和UnifiedAgendaEntry四层模型;通过ScheduleReconciler生成最终视图;对方活动只进入world_context,共同活动由唯一WorldEvent投影到双方本地shared_activity。 - 预防规则:任何“合并日程”设计必须同时保留来源、证据、主体、状态、可见性和对账原因;禁止直接把计划覆盖写成事实。
- 验证证据:已核对 OPS 的
calendar_system.py、planning.py、self_timeline.py、temporal_context.py,World Server 文档和C:\Users\Administrator\Downloads\世界.md;方案已写入docs/统一真实日程与World接入改造评估.md。
2026-07-26 — Outbox 去重不能吞掉新版本或删除未完成任务
- 阶段:M6.1.3 联合审查
- 类型:功能行为 / 数据可靠性 / 隐私 / 测试
- 现象:同 key 版本 2 仍保留版本 1 payload;第 501 条任务会删除最老 pending;
access_token和密码文本可进入 outbox;实际活动归档没有生产调用。 - 根因:outbox 只按 key 返回旧项,没有版本化 upsert;容量裁剪不看状态;DTO 只做精确 key 黑名单;测试只验证骨架和 DummyBridge。
- 修复或规避:R1 实现 type+key 版本 upsert、无损容量策略、与记忆侧一致的递归隐私拒绝,并从实际活动落地路径触发归档。
- 预防规则:可靠队列必须证明“新版本不丢、未完成不删、敏感数据不落盘、生产调用真实存在”;仅有 enqueue/retry 单元测试不够。
- 验证证据:联合审查运行复现显示版本 2 后仍存版本 1、第 1 条 pending 被删除、凭据字段原样进入 DTO。