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.pyastrbot_plugin_private_companion-main/_conf_schema.jsonastrbot_plugin_private_companion-main/command_handlers.pyastrbot_plugin_private_companion-main/page_api.pyastrbot_plugin_private_companion-main/README.mdastrbot_plugin_private_companion-main/metadata.yamlastrbot_plugin_private_companion-main/docs/前端改造要求-Q6-Bot自有存储与用户记忆边界.mdastrbot_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 和配置迁移文档;
- 测试、迁移预览和错题本中的旧能力说明。
旧数据不能直接删除,必须先:
- 统计旧字段数量;
- 标记来源和所属模块;
- 对 Bot 自有数据放入
legacy_quarantine; - 对娱乐缓存做备份后再清理;
- 确认用户记忆数据库没有被修改;
- 通过 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:删除外部娱乐模块
优先删除:
- QQ 空间完整链路;
- B 站链路;
- 新闻和 AI 日报;
- 无聊搜索;
- 食物、穿搭和娱乐图片链路。
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 部署和数据删除。