astrbot_plugin_private_comp.../docs/OPS陪伴插件全功能盘点与删减评估.md

23 KiB

OPS 陪伴插件全功能盘点与删减评估

1. 评估范围

目标项目:运维分支 ops-main 的 astrbot_plugin_private_companion_ops。

本次评估不是普通陪伴版的功能规划,而是针对群晖 VM 运维智能体的陪伴层:

  • Bot 需要有人格、现实时间、日程和自我时间线;
  • Bot 需要记住用户的真实事实,但不能污染用户记忆;
  • Bot 需要协助 NAS、VM、代码、故障排查和长期项目;
  • Bot 的主动消息必须服务于提醒、跟进、运维状态和陪伴,而不是随机娱乐;
  • 私密阅读和长期创作明确保留;
  • 外部娱乐内容、社交展示和无关主动消费应从 OPS 分支剥离。

源码依据:

  • astrbot_plugin_private_companion-main/main.py
  • astrbot_plugin_private_companion-main/_conf_schema.json
  • astrbot_plugin_private_companion-main/command_handlers.py
  • astrbot_plugin_private_companion-main/page_api.py
  • astrbot_plugin_private_companion-main/README.md
  • astrbot_plugin_private_companion-main/metadata.yaml
  • astrbot_plugin_private_companion-main/docs/前端改造要求-Q6-Bot自有存储与用户记忆边界.md
  • astrbot_plugin_private_companion-main/docs/Q7后端接口收口与VM验收记录.md

当前主类仍组合了大量能力,包括日程、记忆、主动消息、群聊、图片、QQ 空间、新闻、创作、私密阅读、TTS 和外部工具,因此不能只删除一个配置开关就认为模块已经删除。

2. 结论先说

不建议删除:运维核心

这些能力构成 OPS 陪伴层的骨架:

  • AstrBot 生命周期、配置迁移、运行时兼容和插件状态;
  • JSON/SQLite 存储抽象和 Bot 自有存储边界;
  • 现实时间、日历、双层日程、时间窗口、计划/实际对账;
  • Bot 人格状态、自我时间线和主动行为审计;
  • 用户身份、关系边界、用户事实和用户记忆 Bridge;
  • 记忆插件协同,但只允许用户数据进入外部记忆;
  • 运维提醒、主动消息限流、免打扰、休息、失败解释和发送前审核;
  • Token 预算、余额感知、模型状态和插件排障;
  • 私密阅读;
  • 长期创作;
  • 作为运维知识边界的 Worldbook/身份资料;
  • 必要的文本、转发和图片输入理解能力。

建议删除:确定属于娱乐或外部社交展示的能力

这些能力与 NAS/VM 运维目标没有直接关系,且会带来外部账号、网络、Cookie、模型消耗和后台任务:

  • QQ 空间自动发布、动态、评论收件箱和配图发布;
  • B 站无聊监测、内容读取和主动分享;
  • 新闻热榜、AI 日报、新闻无聊阅读和新闻主动分享;
  • 无聊时主动网页搜索和搜索结果分享;
  • “吃什么”菜单推荐和饭点娱乐化关心;
  • 每日穿搭、自拍、生活照和主动生成图片分享;
  • 以娱乐为目的的外部内容自动消费;
  • 仅用于增加热闹感的群聊唤醒、插话和重复跟随;
  • 旧 LivingMemory 专用兼容路径,如果运维环境已经统一使用 Memory Companion。

可选删除:取决于 VM 的实际使用方式

这些功能不是核心运维能力,但可能在特定使用方式下有价值:

  • 群聊观察和群成员关系网;
  • 跨群转述和 AtRelay;
  • TTS、语音主动消息和本地语音播放;
  • 识屏、戳一戳、语音动作等平台动作;
  • 梦境、梦境碎片和 Bot 日记;
  • QQ 在线状态同步;
  • 食物、健康、周期、饥饿等拟人化状态;
  • 技能成长模拟和表达学习;
  • 个人目标系统;
  • 书柜备忘便签;
  • 复杂群聊 LLM、群唤醒、黑话学习和群关系图。

建议初始 OPS 配置关闭这些可选项,运行一段时间后根据真实使用再决定是否物理删除。

3. 全功能盘点

3.1 平台基础与运行维护 —— 不建议删除

对应源码:core_store.py、runtime_compat.py、platform_compat.py、integration_status.py、config_migration.py、main.py。

功能:

  • AstrBot 插件加载、卸载、重载和生命周期处理;
  • 配置读取、旧版配置迁移和分组配置兼容;
  • JSON 主存储和可选 SQLite 后端;
  • 数据默认值、存储修复、历史压缩和控制标签清理;
  • 平台能力探测和降级;
  • 页面 API 注册、运行状态和诊断信息;
  • 服务重启后的数据恢复。

判断:必须保留。它们不是业务娱乐,而是所有 OPS 功能的运行底座。

3.2 现实时间、日历与日程 —— 不建议删除

对应源码:calendar_system.py、agenda_contracts.py、agenda_runtime.py、schedule_reconciler.py、unified_agenda.py、planning.py、temporal_context.py、daily_state.py。

功能:

  • 现实日期、时区和带时区时间;
  • Bot 自己的每日计划;
  • 计划项、实际活动、时间窗口快照;
  • 延期、取消、部分完成和未知状态;
  • 计划与实际活动对账;
  • 当前时间段、上一段和下一段上下文;
  • 对话延迟和跨日回复感知;
  • 日程对 Bot 回复时机、主动提醒和状态的影响;
  • Bot 自有日程历史。

判断:必须保留,是 OPS 陪伴层最重要的区别之一。后续数据库优化也应优先服务这一组数据。

3.3 Bot 人格、状态与自我时间线 —— 不建议删除,但要去掉娱乐依赖

对应源码:bot_self_store.py、self_timeline.py、state_views.py、scene_context.py、daily_state.py、astrbot_knowledge.py。

功能:

  • Bot 自有记忆和自我时间线;
  • Bot 人格状态;
  • Bot 做过什么、计划过什么、创作过什么;
  • 当前忙碌、休息、精力和情绪上下文;
  • 环境、平台、模型和当前任务感知;
  • Bot 不能把自己的数据写入用户记忆插件。

判断:保留。需要删除的是其中的娱乐化数据源,而不是自我时间线本身。

建议拆分:

  • 保留:任务、运维事件、代码项目、创作、阅读、提醒、状态变化;
  • 可选:梦境、饭点、穿搭、周期、饥饿、纯情绪日记;
  • 删除:由 B 站、新闻、QQ 空间等娱乐源制造的 Bot “见闻”。

3.4 用户身份、关系与用户记忆 —— 不建议删除

对应源码:user_memory.py、memory_companion_adapter.py、remember_you_adapter.py、worldbook.py、interaction_utils.py。

功能:

  • 主要用户/次要用户区分;
  • 用户 ID、平台身份和跨平台别名;
  • 用户称呼、语气和关系阶段;
  • 用户事实、习惯、关系观察和未完话题;
  • 用户侧图片摘要;
  • 通过运维记忆插件召回用户记忆;
  • 记忆写入主体、时间、来源和边界保护;
  • 群成员和联系人身份资料。

判断:必须保留。OPS 不是只会执行命令的工具,它仍然需要理解操作者是谁、之前做了什么和当前任务的上下文。

硬性边界:

  • 用户数据进入记忆插件;
  • Bot 日程、人格、创作、梦境和自我时间线不进入记忆插件;
  • 不恢复旧的 Bot 数据外写降级通道;
  • LivingMemory 只保留兼容迁移所需的只读检测,后续可以删除专用适配。

3.5 私聊陪伴和被动回复 —— 不建议删除

对应源码:event_dispatch.py、prompt_surface.py、busy_reply_gate.py、user_rest_gate.py、temporal_context.py、forward_message.py、segmented_message.py。

功能:

  • 私聊上下文组装;
  • 根据现实时间、任务、关系和状态回复;
  • 休息、免打扰、忙碌和延迟回复;
  • 过长消息、转发消息和图片消息处理;
  • 回复前事实、隐私、平台和发送结果检查;
  • 失败原因和未发送原因解释;
  • 延迟较久后重新接续对话,而不是机械重复旧话题。

判断:必须保留,但要把随机闲聊和娱乐内容来源清理掉。

3.6 主动消息和运维提醒 —— 保留并改造

对应源码:proactive.py、proactive_engine.py、proactive_message.py、proactive_chat_runtime_bridge.py、proactive.py、command_handlers.py。

功能:

  • 主动消息候选生成;
  • 用户未回复后的降速和停止;
  • 日程提醒、任务跟进和到期提醒;
  • 运维事件、服务异常和代码任务提醒;
  • 主动消息审核、风险拦截、Token 限额和发送审计;
  • 与 Proactive Chat 的运行时桥接;
  • 文本、图片、语音、戳一戳等多种发送动作。

判断:保留核心,但必须做来源删减。

保留的主动来源:

  • Bot 日程;
  • 运维任务;
  • VM/NAS 事件;
  • 用户明确交代的待办;
  • 长期创作推进;
  • 私密阅读进度;
  • 用户长时间未回复时的低频关心;
  • 明确的故障或安全提醒。

删除的主动来源:

  • 无聊时看 B 站;
  • 无聊时看新闻;
  • 无聊时搜索网页;
  • QQ 空间发动态;
  • 每日穿搭和自拍;
  • 吃什么候选;
  • 仅为了制造热闹的群聊插话。

3.7 运维诊断、模型和成本控制 —— 不建议删除

对应源码:token_budget.py、balance_awareness.py、integration_status.py、page_api.py、command_handlers.py。

功能:

  • Provider 和模型状态;
  • Token 使用统计、预算和硬限制;
  • 余额查询和余额不足提醒;
  • 主动行为审计;
  • 配置导出、导入、备份和恢复;
  • 页面接口、排障接口和能力列表;
  • 插件状态、依赖、Bridge 和降级状态。

判断:必须保留。OPS 环境的重点就是稳定运行、成本可控和故障可解释。

3.8 图片和视觉能力 —— 拆分保留

对应源码:private_image.py、llm_tool_actions.py、qzone_media.py、pages/陪伴面板。

不建议删除:

  • 用户发送截图、报错图、NAS 面板截图时的图片理解;
  • 图片摘要和短期视觉上下文;
  • 运维图片证据的来源和时间记录;
  • 私密阅读中必要的图片读取。

建议删除:

  • 自拍和每日穿搭生成;
  • 纯娱乐图片分享;
  • QQ 空间自动配图;
  • 与运维无关的自然语言生图入口。

可选删除:

  • 识屏主动窥视;
  • Poke、自动语音等平台动作;
  • 外部图片 API 的备用链路。

3.9 TTS 与语音 —— 可选删除

对应源码:tts_enhancement.py、tts_tool_sanitizer.py、voice_action_config 相关配置。

保留价值:

  • 运维告警通过语音播放;
  • 用户在不方便阅读时接收提醒;
  • 语音输入后的统一处理。

删除理由:

  • 增加模型、音频缓存和平台适配复杂度;
  • 对 NAS 运维不是硬依赖;
  • 语音主动消息容易扩大主动行为噪声。

建议:初始关闭,保留模块;如果 VM 只使用文字运维,可在第二轮物理删除。

3.10 私密阅读 —— 不建议删除

对应源码:private_reading.py、page_api.py 的书柜和阅读接口、_conf_schema.json 中的 enable_private_reading_*。

功能:

  • 私密阅读目录和夹层数据;
  • 阅读进度、偏好和标签;
  • 阅读内容在 Bot 自有上下文中的影响;
  • 私密阅读与主要用户边界;
  • 阅读状态和长期创作的灵感关联。

判断:用户已经明确要求保留,不能按娱乐模块删除。后续只需清理无聊自动阅读和不必要的主动推荐开关。

建议默认:

  • 保留阅读数据和偏好影响;
  • 关闭无聊时自动阅读;
  • 关闭无明确请求的推荐;
  • 保留用户主动查询和阅读进度追踪。

3.11 长期创作 —— 不建议删除

对应源码:creative.py、page_api.py 创作接口、creative_projects 和 creative_memory_pool。

功能:

  • 长期创作项目;
  • 大纲、角色、章节、草稿块和创作记忆;
  • 项目阶段、版本和复盘;
  • 创作上下文注入;
  • 创作与 Bot 自我时间线关联;
  • 作品封面生成和创作分享。

判断:核心保留。需要删减的是娱乐化的自动分享和无聊灵感触发,不是创作数据本身。

建议默认:

  • 保留项目、草稿、大纲和复盘;
  • 关闭无聊时自动开始新项目;
  • 关闭自动公开分享;
  • 封面生成设为可选,不作为核心依赖。

3.12 日记、梦境和拟人化生活 —— 可选删除

对应源码:dreaming.py、daily_state.py、main.py 中的 diary/dream 配置和命令。

保留价值:

  • 为 Bot 自我时间线提供连续性;
  • 让 Bot 在长期互动中有自我状态;
  • 记录运维任务之外的休息和复盘。

删除或收缩理由:

  • 梦境、穿搭、饥饿、周期和健康模拟与 NAS 运维没有直接关系;
  • 会增加模型调用、数据量和人格噪声;
  • 容易与用户真实记忆混淆。

建议方案:

  • 保留轻量 Bot 日记和任务复盘;
  • 删除增强梦境、亲密梦境和梦境外部分享;
  • 删除每日穿搭;
  • 饥饿、周期、健康等状态只保留睡眠、精力、忙碌和休息四类;
  • 不把这些内容写入用户记忆插件。

3.13 群聊观察与群聊陪伴 —— 可选删除,不能直接整体删除

对应源码:group_observation.py、group_wakeup.py、page_api_users_groups.py、worldbook.py。

保留价值:

  • 如果运维群是主要控制入口,群观察可以识别故障上下文;
  • 群成员身份和权限边界可以防止误执行;
  • 群话题和事件线可以辅助判断运维任务是否已完成。

建议保留:

  • 群消息观察;
  • 群成员身份和权限;
  • 群隐私保护;
  • 群中明确的运维任务和故障上下文。

建议删除:

  • 群聊娱乐唤醒;
  • 冷群主动找话题;
  • 无关插话;
  • 黑话网页搜索;
  • 纯热闹型重复跟随。

如果 VM 实际只使用单人私聊,第二轮可以整组删除 GroupWakeupMixin 和大部分群聊主动逻辑,但先不要删除 GroupObservationMixin,以免误伤身份和权限判断。

3.14 Worldbook、身份资料和关系网 —— 不建议删除

对应源码:worldbook.py、astrbot_knowledge.py、AtRelayMixin 的身份解析部分。

功能:

  • 用户、群成员和运维角色身份;
  • 别名、平台 ID 和权限边界;
  • 待确认观察;
  • 群聊成员关系;
  • Bot 自我注册和关系资料;
  • 运维项目、服务和环境的知识入口。

判断:保留。OPS 需要知道“谁在说什么、对谁可见、谁能触发什么”,这不是娱乐功能。

需要控制:

  • 待确认观察不能自动变成硬事实;
  • 关系图不应扩大运维权限;
  • 不把群成员资料写入外部用户长期记忆;
  • World 数据只作为上下文,不直接覆盖现实日程事实。

3.15 AtRelay 和跨群转述 —— 可选删除

对应源码:atrelay.py、forward_message.py、main.py 中的 enable_atrelay_*。

保留价值:

  • 在多个运维群之间转发故障状态;
  • 把指定群的处理结果带回主控私聊;
  • 统一跨平台身份和消息来源。

删除理由:

  • 权限和隐私边界复杂;
  • 运维系统初期可能只有一个主控会话;
  • 转述错误会造成事实和责任归属混乱。

建议:默认关闭;只有确实存在多个运维群时才保留。

3.16 外部娱乐内容和社交发布 —— 建议删除

QQ 空间

对应源码:qzone_integration.py、qzone_media.py、qzone_selection.py、qzone_recent_parser.py、page_api_qzone.py。

删除范围:

  • QQ 空间动态读取;
  • 自动生活说说;
  • 情绪动态;
  • 生成图片动态;
  • 评论收件箱;
  • QQ 空间页面和命令;
  • QQ 空间 Cookie、Provider 和后台任务。

判断:OPS 无需对外运营 Bot 社交账号,建议完整删除。

B 站

当前主要以 main.py 配置、主动来源和外部能力形式存在。

删除范围:

  • 无聊时观看;
  • 内容评分和主动分享;
  • B 站定时抓取和缓存;
  • B 站相关页面、配置和 Provider。

判断:建议删除。

新闻、AI 日报和热点

对应源码:news_exploration.py、main.py 新闻配置、新闻页面和主动触发。

删除范围:

  • 新闻源读取;
  • 热榜和 AI 日报;
  • 无聊时新闻阅读;
  • 新闻主动分享;
  • 新闻 API、Provider、缓存和定时任务。

判断:建议删除。若未来需要技术资讯,应由单独的运维资讯插件提供,不重新塞回陪伴插件。

主动网页搜索

对应源码:main.py 的 web_exploration_* 配置、相关上下文和页面。

判断:建议删除陪伴插件内的“无聊搜索”和分享逻辑。真正的运维检索应由专用工具或运维 Agent 调用,保留明确请求的外部查询能力也应放到独立插件。

3.17 食物、穿搭和日常娱乐 —— 建议删除

功能包括:

  • 吃什么候选;
  • 饭点主动关心;
  • 每日穿搭照片;
  • 生活照分享;
  • 生活化娱乐推荐。

对应配置:enable_food_menu_recommendation、enable_meal_care_proactive、enable_daily_outfit_photo 等。

判断:与 OPS 目标无关,建议删除配置、命令、数据字段、后台任务和页面入口。

3.18 QQ 状态、Poke、语音动作和识屏主动窥视 —— 可选删除

这些属于平台动作,不是运维核心:

  • QQ 在线状态同步;
  • Poke;
  • 主动语音动作;
  • 主动识屏;
  • 未回复后的屏幕窥视。

建议:

  • 用户主动发送图片/截图时的识图保留;
  • 主动窥视、Poke 和状态同步默认关闭;
  • 如果 VM 完全不需要 QQ 社交表现,可以第二轮物理删除。

4. 需要一起清理的配置和页面

删除娱乐模块时不能只删 Python 文件,还要清理:

  • _conf_schema.json 中的配置项和旧兼容项;
  • main.py 的配置读取、默认值、Provider 映射和能力别名;
  • command_handlers.py 中对应命令;
  • page_api.py 和 page_api_qzone.py 的 API;
  • pages/陪伴面板/index.html 的页面、Tab、配置卡和诊断卡;
  • pages/陪伴面板/app.js 的状态、请求和渲染逻辑;
  • 后台定时任务、主动候选、缓存和清理逻辑;
  • data 中不再使用的运行状态字段;
  • README、CHANGELOG、metadata 和配置迁移文档;
  • 测试、迁移预览和错题本中的旧能力说明。

旧数据不能直接删除,必须先:

  1. 统计旧字段数量;
  2. 标记来源和所属模块;
  3. 对 Bot 自有数据放入 legacy_quarantine;
  4. 对娱乐缓存做备份后再清理;
  5. 确认用户记忆数据库没有被修改;
  6. 通过 VM 重启和回滚验收。

5. 推荐的 OPS 最终功能边界

必须保留

  • 人格和现实时间;
  • 日历、日程、时间窗口和计划/实际对账;
  • Bot 自有存储和自我时间线;
  • 用户身份、关系和用户记忆协同;
  • 私聊陪伴和时间跨度感知;
  • 运维提醒、任务跟进和主动消息审核;
  • Token、余额、模型、Bridge 和故障诊断;
  • 私密阅读;
  • 长期创作;
  • 运维知识、Worldbook 和权限边界;
  • 用户截图、日志图和错误图片理解;
  • 配置、备份、迁移和审计。

建议删除

  • QQ 空间完整集成;
  • B 站主动阅读和分享;
  • 新闻、热点、AI 日报;
  • 无聊时网页搜索;
  • 食物推荐、饭点娱乐关心;
  • 每日穿搭、自拍和娱乐生图;
  • 外部社交动态和评论收件箱;
  • 纯娱乐群聊唤醒和插话。

可选删除

  • 群聊整体能力;
  • AtRelay 跨群转述;
  • TTS 和语音动作;
  • Poke、QQ 状态同步、主动识屏;
  • 梦境和完整 Bot 日记;
  • 饥饿、健康、周期等拟人化状态;
  • 技能成长和表达学习;
  • 个人目标和备忘便签;
  • 创作封面生成;
  • 外部图片 API 备用链路。

6. 建议执行顺序

OPS-Trim-0:先关闭,不删代码

  • 在 VM 配置中关闭确定删除项;
  • 关闭所有 boredom/无聊触发;
  • 关闭外部社交发布和自动分享;
  • 关闭每日穿搭、食物推荐和娱乐主动源;
  • 观察主动消息数量、Token 消耗、错误日志和用户体验。

OPS-Trim-1:删除外部娱乐模块

优先删除:

  1. QQ 空间完整链路;
  2. B 站链路;
  3. 新闻和 AI 日报;
  4. 无聊搜索;
  5. 食物、穿搭和娱乐图片链路。

OPS-Trim-2:收缩主动系统

  • 只保留日程、运维任务、用户待办、创作和阅读进度来源;
  • 删除娱乐候选生成器;
  • 删除无聊触发计时器;
  • 保留主动审核、限流、免打扰和审计。

OPS-Trim-3:收缩拟人化模块

  • 保留睡眠、精力、忙碌、休息;
  • 评估删除饥饿、周期、健康、梦境和穿搭;
  • 保留 Bot 自我时间线,但只接收运维、创作、阅读和任务事件。

OPS-Trim-4:按实际入口处理群聊、语音和跨群转述

  • 如果 VM 只用私聊,关闭并评估删除群聊主动模块;
  • 如果存在运维群,保留观察和权限边界,删除娱乐插话;
  • 根据实际告警场景决定是否保留 TTS 和 AtRelay。

OPS-Trim-5:统一前端和数据清理

  • 按 前端改造要求-Q6-Bot自有存储与用户记忆边界.md 改造页面;
  • 删除已移除功能的 Tab、配置卡和命令提示;
  • 显示“运维能力”和“已关闭/已删除娱乐能力”的边界;
  • 清理旧缓存和废弃字段,但保留可回滚备份。

7. 最终建议

当前不要直接大规模物理删除。建议先执行 OPS-Trim-0,观察一轮真实 VM 运行数据,再按模块拆分删除。

优先级判断:

  • 第一批一定删除:QQ 空间、B 站、新闻/AI 日报、无聊搜索、食物推荐、每日穿搭、娱乐生图;
  • 第一批一定保留:日程、真实时间、Bot 自有存储、用户记忆边界、私聊陪伴、运维主动提醒、诊断、私密阅读、长期创作;
  • 第二批再决定:群聊、TTS、AtRelay、梦境、拟人化身体状态、技能成长、个人目标和备忘便签。

本评估只做盘点和删减方案,不在本轮直接删除源码、配置或 VM 数据。

本轮已执行的运维版删减(2026-07-25)

已在 ops-main 完成本轮源码删减,范围仅限运维分支:

  • 删除 QQ 空间完整链路及页面入口:动态、评论收件箱、自动配图发布、发布接口和独立实现文件。
  • 删除新闻、热点、AI 日报、B 站主动阅读/无聊监测/分享、无聊时主动搜索的独立实现入口。
  • 删除主动 Poke、QQ 状态同步、主动识屏的启动入口;普通用户主动发送的图片理解不受影响。
  • 删除饭点娱乐化关心和“吃什么”配置入口;日程、真实时间、运维提醒、私密阅读、长期创作保留。
  • LivingMemory 不再读取数据库、不再进入页面状态和运行时召回;仅保留关闭状态字段,避免旧配置导致启动异常。
  • 保留旧数据区的惰性兼容结构,不做数据删除和数据库迁移,确保现有 Bot 自有存储、用户记忆、日程数据可继续启动。

验证结果:

  • python -m compileall -q . 通过。
  • 已扫描 Python/HTML 对已删除模块的导入和页面脚本引用,无结果。
  • 本地未安装 pytest,基线测试暂未执行;未做 VM 部署和数据删除。