astrbot_plugin_private_comp.../docs/对话日程可行性评估.md

12 KiB

对话日程可行性评估

评估日期:2026-07-24
工作区:D:\CODEX\projects\我会永远陪着你
范围:评估陪伴插件是否可以把双方真实互动纳入日程,而不是只生成 Bot 自身日程。

1. 结论

技术上可行,建议实施;但不建议把现有 Bot 日程直接改成“聊天流水账”。

推荐新增一层“对话日程 / 共享互动日程”,由 MemoryCompanion 提供可追溯的消息时间线和会话边界,由 PrivateCompanion 负责聚合、展示、提醒和下一轮承接。

可行性判断:

维度 判断 说明
数据来源 高 MemoryCompanion 已有真实可见对话时间线、message_id、occurred_at、session_id 和 scope。
日程模型 高 PrivateCompanion 已有时区、起止时间、状态、重复、冲突检测和日程 API 基础。
对话事件抽取 中高 可以从明确约定、共同经历、待续话题和已完成互动中抽取;需要置信度和证据约束。
主动承接 高 已有 proactive、open-loop 和主动消息调度,可复用但必须增加重复提醒和冷却控制。
隐私隔离 中 私聊、群聊、不同 Bot 和不同用户必须严格隔离;共享事件不能复用 Bot 自身可见性。
外部日历同步 中 需要单独的 ICS/CalDAV/平台日历适配,不应作为第一阶段目标。

2. 三种日程必须分开

2.1 Bot 自身日程

描述 Bot 的生活、行动和内部安排,例如吃饭、阅读、创作、休息、主动发消息、开发或维护窗口。

  • 当前主要来源:daily_plan、细化日程、主动事件和 self_timeline。
  • 当前 calendar_system.py 已支持 personal_agenda、work_agenda、maintenance_agenda、external_schedule。
  • 这类事件的主体是 Bot,不能因为用户提到某件事就自动改写成 Bot 已经做过。

2.2 对话日程 / 共享互动日程

描述双方真实发生、正在进行或明确约定的互动事件,例如:

  • “今晚一起看这部电影”;
  • “下次继续聊这个话题”;
  • “你明天把结果告诉我”;
  • “刚才我们讨论了插件部署,等测试结果回来再继续”;
  • “这段对话已经告一段落,下一次从某个问题接着聊”。

这类事件的主体是 Bot + 当前对话对象,必须带 session_id、参与者、来源消息和置信度。它不是 Bot 的私人经历,也不是每一句消息。

2.3 真实日历事件

描述具有明确时间、提醒和外部日历语义的事项。只有用户确认或来自可信外部日历的内容,才可以进入硬提醒或外部同步。

3. 当前代码可直接复用的能力

3.1 PrivateCompanion 日程基础

  • calendar_system.py 已统一处理带时区的 ISO 8601 起止时间。
  • 已支持全天、跨午夜、每日/每周/工作日重复、状态和冲突检测。
  • 旧 daily_plan 可以投影为确定性的日历事件,保留兼容回退。
  • 日程已有来源、可编辑性、提醒、关联任务等字段基础。
  • planning.py 已有日程段、主动事件、日程连续性提示和模型结果清洗。

这些能力适合承载“事件容器”,但现有类型集合需要增加共享互动语义,不能只把 dialogue 填进 personal_agenda。

3.2 消息和互动事实来源

MemoryCompanion 已提供:

  • record_visible_turn():记录真实可见的用户/Bot 对话轮次,适合保留原始短期时间线;
  • 时间窗口检索:按 scope、session_id、实体和时间范围读取对话记录;
  • message_id、occurred_at、发送者、会话和平台等证据字段;
  • search_open_loops():检索未完成承诺和待续话题;
  • 关系阶段、情绪事件和上下文编排;
  • record_shared_experience():已有共享经历接口,但当前默认语义偏向 bot_self / bot_action,不能直接当作对话日程存储合同,需要新增或调整为明确的 shared dialogue/event 类型。

PrivateCompanion 侧已有:

  • 私聊和群聊入口、消息去重、消息收口、防抖;
  • 互动状态、open_loops、主动消息和未回复反馈;
  • unified_msg_origin 会话边界;
  • _record_schedule_adjustment_from_interaction() 等从对话修正 Bot 日程的能力。

4. 推荐数据模型

建议新增 dialogue_agenda 或 shared_interaction 事件类型。不要复制一份完整消息库,而是保存“派生事件 + 证据引用”。

{
  "event_id": "dialogue-...",
  "calendar": "dialogue_agenda",
  "kind": "promise|shared_activity|topic_continuation|episode|check_in",
  "title": "下次继续确认部署结果",
  "description": "双方约定在测试完成后继续确认结果",
  "start_at": "2026-07-24T21:00:00+08:00",
  "end_at": "2026-07-24T21:30:00+08:00",
  "time_precision": "exact|range|relative|unknown",
  "status": "planned|active|completed|cancelled|expired|pending_review",
  "confidence": 0.86,
  "confirmation": "explicit|inferred|user_confirmed",
  "scope": "private",
  "session_id": "platform:private:user",
  "platform": "qq",
  "bot_id": "...",
  "participants": ["bot:...", "user:..."],
  "source_message_ids": ["...", "..."],
  "evidence_summary": "用户明确表示测试完成后继续确认",
  "reminder_policy": "none|soft|confirmed_only",
  "visibility": "private_pair",
  "created_by": "dialogue_event_extractor",
  "updated_at": "..."
}

关键约束:

  1. source_message_ids 必须可回溯到真实对话;没有证据不能生成高置信度事件。
  2. time_precision=unknown 时只能作为“待续话题/互动记录”,不能生成硬提醒。
  3. confirmation=explicit 或 user_confirmed 才能进入主动提醒队列。
  4. 私聊使用 private_pair,群聊使用 group_public 或更窄的成员范围;禁止把一个群的事件注入另一个私聊。
  5. 事件应幂等,推荐以 session_id + kind + 主题指纹 + 时间窗口 去重,并保留来源消息 ID。

5. 事件分类和生成规则

第一批允许生成

  • promise:明确承诺、约定、等待结果;
  • shared_activity:双方明确共同完成或正在完成的活动;
  • topic_continuation:明确“下次继续”“之后再聊”的话题;
  • episode:一段已结束但值得保留的对话事件摘要;
  • check_in:用户明确要求某时段再提醒或再询问。

第一批禁止自动生成

  • 每条普通聊天消息;
  • 没有明确时间的“以后”“有空”“改天”;
  • 模型自己推断的“我们应该一起做”;
  • 群聊中只对其他成员成立的约定;
  • Bot 在提示词中生成但没有实际发送的计划;
  • 把用户的计划说成 Bot 已完成的真实经历。

6. 分阶段开发队列

D0:合同和边界设计

  • 增加 dialogue_agenda 类型和事件 schema。
  • 明确 scope/session_id/bot_id/participants/visibility 规则。
  • 定义 source_message_ids、置信度、确认状态和生命周期。
  • 补 Fake Bridge、Fake Event 和最小测试夹具。

验收:同一事件可以区分 Bot 日程、私聊日程、群聊日程;没有时间和证据的内容不能进入硬提醒。

D1:对话事件抽取(只读候选)

  • 从已捕获消息和当前回复中识别明确约定、共同活动、待续话题。
  • 先生成 pending_review 候选,不立即提醒。
  • 使用稳定指纹去重,保存来源消息 ID 和时间范围。
  • 复用 MemoryCompanion 时间线,不新增完整消息表。

验收:同一消息重复到达不会生成重复候选;Bot 未实际发送的草稿不会被记录为互动事实。

D2:用户确认和生命周期

  • 增加“确认/取消/完成/延期/忽略”操作。
  • 只有明确确认的事件进入 confirmed_only 提醒策略。
  • 过期、取消和完成事件保留历史,不删除证据。
  • 允许把“待续话题”升级为有时间的共享互动事件。

验收:取消后不再提醒;完成后不重复追问;延期会更新同一 event_id 而非创建无穷副本。

D3:陪伴承接和轻提醒

  • 在主动消息生成前优先读取当前会话的 confirmed dialogue agenda。
  • 增加冷却、免打扰、用户最近已主动提及和重复提醒抑制。
  • “软承接”与“硬提醒”分开:无精确时间只自然承接,不报警式通知。
  • 继续复用 open_loop,但将已确认对话事件作为更高质量来源。

验收:主动消息能自然接上双方约定;短时间内不重复提醒;无关对话不被旧事件劫持。

D4:页面和查询

  • 陪伴面板增加“Bot 日程 / 对话日程 / 外部日程”筛选。
  • 显示事件状态、置信度、确认状态和证据数量。
  • 支持按今天、未来、待续、已完成查询。
  • 页面不展示不应跨 scope 的群聊或其他用户内容。

验收:用户能看出某条记录是 Bot 自身安排还是双方互动约定。

D5:外部日历(可选)

  • 仅对 user_confirmed 或可信外部来源提供 ICS/CalDAV/平台同步。
  • 外部事件先只读投影,再考虑写回。
  • 外部同步必须有来源 ID、同步状态和冲突策略。

7. 主要风险与控制

风险 后果 控制措施
过度日程化 日历充满闲聊,体验变成流水账 只记录事件级聚合,不记录普通消息。
模型幻觉 把推断当作双方约定 必须有证据、置信度和确认状态。
隐私串话 群聊内容泄露到私聊,或用户间串线 强制 scope/session/participant 过滤,默认最小可见。
重复提醒 体验像催办机器人 event_id 幂等、提醒冷却、完成/取消状态。
误把 Bot 计划当共同经历 人格事实失真 Bot 日程与 dialogue agenda 使用不同主体和 visibility。
数据重复 两插件各存一套消息和事件 MemoryCompanion 保存事实和证据,PrivateCompanion 保存执行状态和视图。
时间含义不清 “以后”被错误安排到具体时间 time_precision=unknown 时不生成硬提醒。
群聊关系复杂 事件归属不明确 第一阶段只支持明确点名 Bot + 单一目标成员的事件。

8. 建议的最小可行版本

第一版只做四件事:

  1. 识别明确的双方约定和待续话题;
  2. 生成带证据的 pending_review 对话事件;
  3. 用户确认后进入轻提醒和自然承接;
  4. 页面区分 Bot 日程和对话日程。

第一版暂不做:每条消息转日程、自动外部日历同步、复杂群聊共享事件、无确认的强提醒。

9. 验收测试清单

  • 私聊 A 与私聊 B 的事件完全隔离。
  • 群聊事件不会默认注入任意成员私聊。
  • 同一 message_id 重复处理只产生一个事件。
  • 同主题跨多条消息可以聚合,但不会覆盖不同时间的独立事件。
  • “下次继续”生成待续话题,不生成具体时间提醒。
  • “明天 20:00 一起看电影”生成候选;用户确认后才提醒。
  • Bot 计划“明天阅读”不会变成共享互动事件。
  • Bot 生成但未实际发送的内容不会作为真实互动。
  • 取消、完成、延期状态可查询且不会重复提醒。
  • MemoryCompanion 不可用时,聊天和 Bot 日程继续工作;对话事件降级为不提醒或本地候选。
  • 事件证据可回查到时间线和来源消息。

10. 当前能做与暂不能宣称的部分

现在可以直接做

  • 完成 schema、状态机和跨插件 Bridge 合同设计;
  • 复用现有时间线、open-loop、session 和日历基础;
  • 建立只读候选抽取和 Fake 测试;
  • 在页面上增加三层日程的展示模型。

需要继续开发和验证

  • 对话事件抽取器与去重器;
  • shared dialogue 事件的 MemoryCompanion 存储语义;
  • 用户确认命令/API;
  • 主动提醒的冷却、免打扰和完成反馈;
  • 私聊/群聊/多 Bot 的真实 VM 回归。

当前不能宣称

  • 现有代码已经支持“对话日程”;
  • 现有 record_shared_experience() 可以直接替代新合同;
  • 所有聊天都能安全加入日历;
  • 未确认的对话内容可以直接触发提醒或外部同步。

11. 结论建议

建议把这项工作作为现有 Q4 双层日程之后的 Q4.3 对话日程,按 D0-D4 实施。产品上它不是“给 Bot 增加更多日程”,而是让系统知道:

哪些事是她自己要做,哪些事是我们一起经历过,哪些事是我们约好之后还要继续。

这样既能实现真实互动的时间连续性,又不会破坏 Bot 自我时间线、记忆真实性和隐私边界。