# 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 部署和数据删除。