核心代码：/home/halo/xiuxiu3-open-source/xiuxiu3_core/standalone.py
版本记录：/home/halo/xiuxiu3_version_records.md
当前代码哈希：473519a86bc187b3a7fbad315021697091337127172a57c0158e59f236f8b8a9
秀秀 3.0 当前已经形成三模块运行体系：秀秀模块负责消息和任务，链接模块负责跨服和路由，龙虾模块负责语义理解和内容生成。用户从电脑端、手机端、群聊、私聊、引用消息发起任务后，系统会按 12 步链路完成接收、入库、选 Bot、建任务、入队、调用龙虾、校验、写回和后续 @ 派发。其中替身类任务在第 4 步选中替身后、第 5 步创建正式任务事件前，会先经过后台基础 Bot「工作要求整理专家BOT」，把用户原话、引用内容和上下文整理成更稳定的执行内容。
稳定基础消息链路、三模块服务、私聊 Bot、群聊 @、引用消息、批量创建主链路、工作要求整理专家、私聊不 @ 替身、多行回复完整写回、四台服务器同步。
待观察复杂多轮 Loop、多 Loop 自动选择、OpenClaw 运行态、旧 Bot 人设残留、失败提示和后续成功并存。
程序层负责确定性边界：身份、入库、锁、确认、数量冲突、派发幂等、文件和动作协议。龙虾层负责语义理解、方案生成和业务内容，不用代码枚举替代复杂语义。
这一节按你近 20 天反复提出的问题和要求整理，不只看当前代码"有什么函数"，还对应"为什么要做这个功能"。其中"已稳定"表示当前代码层已有明确保护，并至少经过函数级或真实链路验证；"待观察"表示主链路已经有机制，但还受历史数据、旧 Bot 人设、OpenClaw 运行态或长任务复杂度影响。
| 类别 | 你提出的要求或问题 | 当前已经实现的能力 | 当前状态 |
|---|---|---|---|
| 完整消息进入龙虾 | 不能只把 @ 或截断内容发给龙虾；真实任务、引用内容、确认工单都要完整带过去。 | 原始消息、quote.content、batch_original_content、source_task_id 和任务 metadata 都保留；后续 002/001/Loop 可继承原始上下文。 | 已稳定 |
| 三模块运行 | 必须始终是秀秀模块、链接模块、龙虾模块三模块运行，不能把逻辑打包成一个模块。 | 秀秀负责消息/队列/数据库；链接负责跨服路由；龙虾负责 OpenClaw 语义生成和动作协议。 | 已稳定 |
| 标准确认 | 创建、配置、复杂执行不能直接跑，必须先拆解并等"确认执行"。 | 替身会写 pending 工单；确认后续跑；未确认不派发 002/001，不创建 Bot。 | 已稳定 |
| 讨论任务 | "我想找几个专家帮我讨论/梳理"不是立即创建，也不应该套创建工单。 | 讨论型任务由工作要求整理专家先整理，再由替身输出可读的讨论拆解；第 9 步保护不强制转标准工单。 | 刚修复 |
| 普通调用任务 | 用户让替身找群里已有 Bot 做事时，应识别现有 Bot 并派发，不必进入创建流程。 | 工作要求整理结果携带任务类型和候选执行方式；后续按群聊行首 @ 创建 task_events。 | 基本稳定 |
| 批量创建 | 批量创建要逐个 002、逐个 001、逐个自测、逐个验收，不能并行串台。 | batch metadata 锁定清单、当前项、职责、回报对象和批次 ID；001 配置完成后自动推进下一项。 | 已稳定 |
| 数量冲突 | 如果说创建 4 个但后面列出 5 个，不能随便按其中一个执行。 | 第 7 步数量冲突拦截，写明 expected/parsed，要求用户确认最终清单。 | 已稳定 |
| Bot 名称误抽取 | "两个Bot""应找哪些专家""先讨论"等短语不能被当成 Bot 名。 | 显式 Bot 清单优先；数量词、流程词、讨论说明被清洗；引用讨论创建时只取明确专家候选。 | 已稳定 |
| 动态专家 | 不能固定套"方法论专家、业务落地专家、审核校验专家"，要按实际任务设计专家。 | 工作要求整理专家输出动态专家候选；讨论保护要求围绕业务主题生成专家画像。 | 已稳定 |
| 工作要求整理专家 | 第 5 步前挂基础 Bot，减少程序层枚举，用语义整理出工作要求。 | 后台基础 Bot 已纳入链路，输出 execution_content、task_type、task_modes、explicit_bot_list、discussion_boundary。 | 已稳定 |
| 可读回复 | 后台可以结构化，但展示给人看的回复必须有交流属性，不要只有机器字段。 | 讨论任务显示任务理解、专家画像、流程、交付物和下一步；后台分类不对用户暴露。 | 已稳定 |
| 多 Bot 协同 Loop | 创建后或已有 Bot 协同要按顺序发言、逐轮验收、最终汇总。 | Loop metadata 记录参与 Bot、轮次、主题、回报对象；行首 @ 派发继承上下文。 | 基本稳定 |
| Loop 主题抽取 | 不能出现"这个主题""这些症状""创建 Bot 原始指令"等错误主题。 | 主题清洗、后续任务抽取、post_batch_loop_topic 继承、占位词拒绝。 | 基本稳定 |
| 多 Loop 调用 | 同群可能有多个 Loop，后续提问应根据语义选择合适 Loop。 | 已有多 Loop 记忆和语义候选思路；多个都匹配时应确认。 | 待观察 |
| 插队任务 | 用户中途插入新任务时，替身要听最新任务，不要继续旧 Loop 硬跑。 | 用户插入任务暂停活动 Loop，取消同会话排队/运行的旧协同任务。 | 已修，需回归 |
| 短回复/空回复 | 不能只回复"需要进一步帮忙随时告诉我"或只有最后一句。 | OpenClaw 多行抽取修复；空回复/只有 @/短句触发校验和重试。 | 刚修复 |
| 私聊不回替身 | 私聊业务 Bot 不应该在末尾 @ 群里的替身。 | Prompt 明确私聊规则，写回前用 sanitize_private_bot_return_mentions 清理错误回报 mention。 | 已稳定 |
| 龙虾异常 | context overflow、timeout、session busy 不能无限卡住，也不能丢记忆。 | trajectory 恢复、上下文压缩、换 session 重试、失败可追踪提示、长期记忆和任务 metadata 继承。 | 待观察 |
| Bot 独立资料 | 每个 Bot 都要有自己的文件资料、长期记忆和可迭代培养空间。 | 每个 Bot 独立 OpenClaw Agent、workspace、长期人设、交互沉淀文件和公司资料继承。 | 基本稳定 |
| 文件/网页交付 | 长报告、表格、网页不能只给路径，要真正生成文件并可查看。 | XIUXIU3_FILE 协议、downloads/bot-reports、附件上传目录、报告页链接和文件任务校验。 | 已稳定 |
| 动作协议 | 001 配置不能只说"等待秀秀执行"，必须输出可执行动作。 | XIUXIU3_ACTION 解析并执行；001 缺动作时有程序层配置动作兜底。 | 已稳定 |
| 旧测试 Bot 清理 | 测试生成 Bot 要清理，不影响基础 Bot、想象力激发 Bot 和正式业务 Bot。 | 清理原则是禁用/移出群，不删聊天审计；按服务器/账号/群范围执行。 | 已执行多轮 |
| 跨服同步 | 以立大志为标准同步到影子、南安、守一、206，不动聊天记录、API、模型、业务 Bot。 | 同步 standalone.py 和版本记录；各服务器保留本地 API/model/workspace；重启三模块并核对哈希。 | 已同步 |
| 备份和版本 | 底层修改前后要有版本记录，方便回滚。 | xiuxiu3_version_records.md 记录版本；远端 standalone.py.bak-* 备份；立大志/影子做过整机内容备份记录。 | 已稳定 |
| 电脑端和手机端 | 不能只保证后台 Bot，电脑端和手机端已经实现的聊天、引用、@、附件、群管理等不能受影响。 | 后端消息接口统一供 web/web.js 和 app/mobile.js 使用；移动端和桌面端共享消息入库、读取、已读、附件、quote、mention 机制。 | 未改动，需日常回归 |
| 模块 | 通俗解释 | 已经实现的功能点 | 稳定性 |
|---|---|---|---|
| 秀秀模块 | 聊天系统和任务调度中心，负责把用户消息接进来、存起来、派给 Bot，再把 Bot 回复显示出去。 | API 接收消息；身份匹配；消息入库；私聊/群聊区分；引用 quote 保存；mention 解析；替身类任务调用工作要求整理专家；创建任务事件；队列 worker；可见回复写回；前端消息拉取。 | 稳定 主链路稳定，最近问题集中在第 9/10 步兜底规则，已修。 |
| 链接模块 | 服务器之间的中转层，判断这个 Bot 是本机处理还是发到其它服务器。 | 远端 Bot 路由；跨服消息复制；防止复制消息再次派发形成循环；跨服失败可见提示。 | 基本稳定 依赖对端服务、版本和 Bot 绑定一致。 |
| 龙虾模块 | 语义大脑，负责理解任务、生成回复、生成方案、输出文件协议和配置动作。 | OpenClaw Agent 调用；独立 workspace；长期人设；公司资料；当前任务 prompt；session 隔离；trajectory 恢复；上下文压缩；异常重试。 | 待观察 逻辑能力稳定，运行态受模型超时、session busy、上下文长度影响。 |
| 步骤 | 名称 | 说明 | 状态 |
|---|---|---|---|
| 1 | 用户发消息 | 电脑端、手机端、群聊、私聊、引用回复都从这里开始。 | 稳定 |
| 2 | API 接收 | 后端检查身份和请求合法性，再进入消息处理。 | 稳定 |
| 3 | 消息入库 | 写入 chat_messages，保存正文、引用、metadata。 | 稳定 |
| 4 | 选择执行 Bot | 私聊按会话 Bot；群聊按行首 @、前端 mention、引用确认、远端 Bot。 | 稳定 |
| 4.5 | 工作要求整理 | 替身类任务先调用 工作要求整理专家BOT，整理出 execution_content、任务类型、组合模式、候选 Bot 清单和执行边界。 | 稳定 |
| 5 | 创建任务事件 | 写入 task_events，替身类任务优先使用整理后的 execution_content，同时保留原始正文、引用和 metadata。 | 稳定 |
| 6 | 队列执行 | 任务进入 BOT 队列，worker 取出后调用 process_bot_task。 | 稳定 |
| 7 | 前置检查 | 检查 Bot 是否启用、任务状态、会话锁、数量冲突、插队等。 | 基本稳定，session busy 待优化 |
| 8 | 龙虾生成 | 组装 prompt，调用 OpenClaw，拿到语义回复或动作协议。 | 主链路稳定，运行态待观察 |
| 9 | 校验修复 | 处理结构化计划、工单、批量创建、Loop、短句、空回复、文件和动作协议。 | 持续修复后基本稳定 |
| 10 | 写回消息 | 通过 bot_insert_message 写回可见聊天。 | 稳定；多行抽取已修 |
| 11 | 行首 @ 派发 | 群聊里 Bot 回复行首 @ 时，继续创建下一位 Bot 任务。 | 基本稳定，重复派发仍需观察 |
| 12 | 前端展示 | 前端轮询消息列表，渲染气泡、引用、附件和已读。 | 稳定 |
电脑端主要由 /home/halo/xiuxiu3-open-source/web/web.js 承载，和后端 /api/im/messages、文件接口、群组/Bot接口共用一套数据库链路。电脑端显示出来的任何 Bot 回复，都必须先经过第 10 步写入 chat_messages，前端再拉取展示。
| 功能区域 | 已实现功能 | 与 12 步链路的关系 | 状态 |
|---|---|---|---|
| 登录与身份 | 账号登录、当前用户身份、公司/服务器上下文、接口身份校验配合。 | 影响第 2 步 API 身份匹配，防止前端伪造其它账号发消息。 | 稳定 |
| 会话列表 | 群聊、私聊、Bot 会话、未读数、置顶/免打扰/隐藏状态、最近消息预览。 | 第 12 步从后端列表接口读取会话状态；不直接决定 Bot 执行。 | 稳定 |
| 聊天窗口 | 发送文本、查看历史消息、滚动加载、消息气泡、Bot/真人身份、时间、头像和状态。 | 发送进入第 1-3 步；展示依赖第 10-12 步。 | 稳定 |
| @ 与 mention | 群聊输入 @、选择群成员/Bot、发送 mention metadata、行首 @ 触发 Bot。 | 影响第 4 步选择执行 Bot和第 11 步继续派发。 | 稳定 |
| 引用回复 | 点击消息引用，quote.content 随消息入库，支持"引用上一条方案继续创建/确认"。 | 第 3 步保存 quote，第 4/5 步用 quote 辅助确认和创建清单提取。 | 稳定 |
| 文件与附件 | 上传附件、展示附件、打开 Bot 生成文件和报告页。 | 用户附件进入第 8 步 prompt；Bot 文件由第 9 步解析 XIUXIU3_FILE、第 10 步写回。 | 稳定 |
| 已读与消息状态 | 消息已读、未读计数、会话切换后的读取状态。 | 第 12 步展示层能力，不改变任务执行。 | 稳定 |
| 搜索与历史 | 消息搜索、历史记录查看、按会话定位。 | 依赖 chat_messages 入库完整性；quote/content 保留越完整，搜索越可靠。 | 稳定 |
| 群组管理 | 创建/查看群、成员列表、添加/移出成员、Bot 入群状态展示。 | 影响第 4/11 步能否找到当前群内 Bot。 | 稳定 |
| Bot 管理 | 查看 Bot、添加公共 Bot、业务 Bot 入群、基础 Bot 维护入口。 | Bot 是否存在/启用会在第 7 步校验。 | 稳定 |
| 账号资料和偏好 | 个人资料、回复偏好、工作要求、额外要求等账号侧配置。 | 第 8 步 prompt 组装会读取账号资料和偏好，影响龙虾回复风格和边界。 | 稳定 |
| 报告页查看 | 长报告可以用链接打开，不把超长内容全部塞进聊天气泡。 | 第 9 步生成文件/报告，第 10 步写回链接，第 12 步展示。 | 稳定 |
手机端主要由 /home/halo/xiuxiu3-open-source/app/mobile.js 承载。手机端和电脑端共用同一套后端接口，所以 Bot 执行链路不因端不同而改变；差异主要在界面交互、路由、触摸操作和移动端状态管理。
| 功能区域 | 已实现功能说明 | 状态 |
|---|---|---|
| 移动登录 | 登录门禁、记住密码、自动登录、登录状态恢复。手机端发消息前必须有有效身份；后端仍会二次校验。 | 稳定 |
| 底部导航 | 聊天、通讯录、动态/朋友圈、我的等移动端页面切换。移动端有独立 route/history 状态，避免返回和切换错乱。 | 稳定 |
| 聊天列表 | 会话分组、未读数、隐藏会话、免打扰、置顶/最近消息。从后端会话和消息数据渲染，不参与 Bot 逻辑判断。 | 稳定 |
| 移动聊天 | 发送消息、接收消息、引用、@、附件、图片/文件入口、滚动和本地缓存合并。和电脑端共用第 1-12 步；移动端只负责触发和展示。 | 稳定 |
| 会话切换保护 | conversationSwitchSeq 防止旧请求覆盖新窗口。用户快速切换群或私聊时，避免把其它会话消息渲染到当前窗口。 | 稳定 |
| 通讯录 | 好友、群组、Bot 分类查看，好友请求，公共 Bot 搜索和添加。影响用户是否能把 Bot 拉入群、是否能找到业务 Bot。 | 稳定 |
| 群成员管理 | 移动端选择成员、加人、移人、群成员列表和管理权限判断。当前群是否包含目标 Bot，决定第 4/11 步能否派发成功。 | 稳定 |
| 个人资料 | 头像、昵称、资料编辑、账号相关配置。用户资料可进入第 8 步 prompt 作为上下文。 | 稳定 |
| 回复偏好 | overall_requirements、bot_reply_preferences、work_requirements、extra_requirements 等偏好字段。影响 Bot 回复风格、工作边界和输出要求。 | 稳定 |
| 动态/朋友圈 | 移动端动态列表、筛选、发布入口等社交展示能力。属于秀秀前端功能，不进入 Bot 任务链，除非消息被转为任务。 | 稳定 |
| 移动端管理员入口 | 公司管理、部分管理面板、成员和 Bot 相关操作入口。权限由后端校验；前端只是展示和提交操作。 | 稳定 |
| 功能点 | 说明 | 状态 | 备注 |
|---|---|---|---|
| 私聊 Bot | 用户直接进入某个 Bot 的私聊窗口，消息直接派给该 Bot。 | 稳定 | 已修复私聊回复末尾错误 @ 替身。 |
| 群聊行首 @ | 群里行首 @ 某个 Bot 时，系统把任务派给对应 Bot。 | 稳定 | 支持真实 mention 和文本 @。 |
| 引用回复 | 用户引用上一条 Bot 消息继续要求创建、确认或补充。 | 稳定 | quote.content 已验证完整保存。 |
| 确认执行 | 用户回复"确认执行"后，系统查找当前群唯一待确认工单并继续。 | 稳定 | 避免只把"确认执行"发给龙虾。 |
| 远端复制消息 | 跨服复制过来的消息只保存，不再二次派发。 | 稳定 | 防止循环转发。 |
| 前端展示防错 | 会话切换窗口时避免旧请求覆盖新窗口。 | 稳定 | 前端按当前 conversation 拉取。 |
这是你要求加入到第 5 步前的后台基础 Bot。它的目标不是直接回答用户，而是把用户原话、引用内容、上下文整理成后续任务链可以执行的正式工作要求。
| 子功能 | 详细说明 | 状态 |
|---|---|---|
| 基础 Bot 固化 | 各服务器都有基础 Bot：工作要求整理专家BOT，类似 001/002 的后台基础能力。 | 稳定 |
| 第 5 步前执行 | 用户消息发给替身后，先调用整理专家，整理出正式 execution_content。 | 稳定 |
| 五类任务 | 讨论、普通调用、Bot 创建、多 Bot/Loop、其它通用类型。 | 稳定 |
| 组合模式 | 支持"先讨论，确认后创建 Bot，再 Loop"这种多阶段任务；task_type 是当前阶段，task_modes 是后续可能阶段。 | 稳定 |
| 动态专家候选 | 讨论任务里专家类型根据业务主题生成，不再固定套方法论/业务落地/审核校验。 | 稳定 |
| 引用创建清单 | 引用上一轮讨论说"按这个方案创建对应 Bot"时，只从明确专家画像提取 Bot。 | 稳定 |
| 失败降级 | 整理专家失败时，降级到旧预分类/程序层逻辑，不阻断任务。 | 待观察 |
| 功能点 | 说明 | 状态 | 风险点 |
|---|---|---|---|
| 替身接单 | 替身是统筹者，负责理解、拆解、派发、验收和收口，不应该自己包办所有任务。 | 稳定 | 旧 prompt 里仍可能有"任何任务先工单"的历史规则，但第 9 步已加讨论保护。 |
| 标准执行工单 | 创建 Bot、明确执行类任务需要先确认，确认后才执行。 | 稳定 | 讨论任务不再强行套工单。 |
| 讨论型回复 | 讨论型任务直接给思路、专家视角和交付结构，不创建、不配置、不启动 Loop。 | 刚修复 | 需要继续看真实场景是否仍被旧人设影响。 |
| 确认执行续跑 | 用户确认后，系统把 pending 工单原文和 metadata 带入执行任务。 | 稳定 | 多个待确认工单时会要求用户明确。 |
| 数量冲突拦截 | 声明创建数量和实际解析数量不一致时，不直接创建，先让用户确认。 | 稳定 | 保护创建清单。 |
当前 Bot 创建已经从"直接创建"改为串行确认链路：替身锁清单，002 出方案，替身审核，001 配置，完成后自测和验收。
| 功能点 | 最小步骤 | 状态 |
|---|---|---|
| 单 Bot 创建 | 识别名称和职责；输出确认工单；确认后派 002；再派 001。 | 稳定 |
| 批量创建 Bot | 锁定清单；逐个 002 方案；逐个 001 配置；逐个自测；自动推进下一项。 | 稳定 |
| 清单锁定 | 后续所有步骤以 batch metadata 的锁定清单为准，避免旧批次串台。 | 稳定 |
| 002 创建方案 | 只输出当前一个 Bot 的完整方案，包含 SOUL/IDENTITY/USER/TOOLS/HEARTBEAT/MEMORY、合规自检、配置交接。 | 稳定 |
| 001 配置落地 | 输出 XIUXIU3_ACTION，由秀秀服务器创建账号、入群、绑定 Agent、自测。 | 稳定 |
| 创建后自测 | 普通 Bot 可快速职能自测；复杂任务可三轮自测。 | 基本稳定 |
| 不复用旧测试 Bot | 创建链路要求不混入旧批次、历史测试 Bot、相似名称。 | 稳定 |
| Bot 类型 | 定位 | 关键能力 | 状态 |
|---|---|---|---|
| 替身 BOT | 任务入口和统筹者，不主要亲自完成业务。 | 接收任务、调用工作要求整理、生成确认工单、派发 002/001、组织 Loop、验收回报、最终收口。 | 稳定 |
| 001 配置顾问 | 配置落地角色。 | 根据替身锁定清单和 002 方案输出 XIUXIU3_ACTION；创建/更新 Bot、拉群、绑定 Agent、自测、回报替身。 | 稳定 |
| 002 创建顾问 | Bot 方案设计角色。 | 单项输出完整创建方案；包含 SOUL/IDENTITY/USER/TOOLS/HEARTBEAT/MEMORY、合规自检、权限建议、001 交接。 | 稳定 |
| 工作要求整理专家BOT | 第 5 步前的后台基础 Bot。 | 把用户口语化、引用式、组合式要求整理成执行内容、任务类型、后续模式和候选 Bot 清单。 | 稳定 |
| 想象力激发BOT | 你要求保留的基础/正式 Bot。 | 用于创意、思路拓展、方案发散类任务；清理测试 Bot 时不动它。 | 稳定 |
| 普通文本业务 Bot | 由 001/002 创建的业务执行角色。 | 独立 Agent、独立 workspace、长期职责、公司资料继承、可被群聊 @ 或私聊调用，普通场景做快速职能自测。 | 基本稳定 |
| 健康/中医/西医类业务 Bot | 典型复杂业务 Bot 示例。 | 可根据职责做辨证、文献核验、西医分析、综合建议；必须保留风险提示和资料不足说明。 | 内容需谨慎 |
| 跨服远端 Bot | 不在当前服务器的 Bot。 | 通过链接模块转发到目标服务器处理；本机只负责路由和失败提示。 | 依赖对端 |
| 功能点 | 说明 | 状态 | 待观察点 |
|---|---|---|---|
| 已有 Bot 协同 | 替身按顺序行首 @ 已有业务 Bot，逐个验收。 | 基本稳定 | 长流程受模型运行态影响。 |
| 创建后 Loop | 批量创建完成后，如果原始任务包含后续协同，则继续组织本批新 Bot 执行。 | 待观察 | 复杂链路需要更多真实长任务验证。 |
| Loop 主题抽取 | 协同主题不应再使用"这个主题/当前任务"等占位符。 | 基本稳定 | 非常长的创建原文可能仍影响主题清洗。 |
| 多 Loop 记忆 | 同一群可以保存多个 Loop，并根据问题语义选择合适 Loop。 | 待观察 | 多个 Loop 都匹配时应让用户选择。 |
| 横向派发限制 | 业务 Bot 不直接横向 @ 其它业务 Bot，统一回替身/主持人。 | 稳定 | 私聊已额外防止误 @ 替身。 |
| 功能点 | 说明 | 状态 |
|---|---|---|
| 独立 Agent | 每个 Bot 绑定自己的 OpenClaw Agent 和 workspace。 | 稳定 |
| Prompt 组装 | 包含长期人设、公司资料、账号资料、群成员、当前任务、引用/附件、批量/Loop 上下文、工作要求整理结果。 | 稳定 |
| Session 隔离 | 私聊、群聊、不同发起人、创建/配置/附件任务使用隔离策略，减少串台。 | 基本稳定 |
| trajectory 恢复 | 如果 CLI 输出不完整，可从 trajectory 恢复真实回复。 | 稳定 |
| 多行回复抽取 | OpenClaw 普通多行输出现在会完整保留，不再只取最后一行。 | 刚修复 |
| 上下文压缩 | 遇到上下文过长时自动压缩或换 session 重试。 | 待观察 |
| 异常重试 | 空回复、模型超时、session locked、context overflow 会进入重试或失败提示。 | 待观察 |
| 功能点 | 说明 | 状态 |
|---|---|---|
| Bot 长期人设 | 每个 Bot 有稳定职责、触发规则、资料边界、回报规则。 | 稳定 |
| 独立 workspace | 每个 Bot 有自己的工作区，文件和记忆不混到源码目录。 | 稳定 |
| 长期交互沉淀 | Bot 回复后会把任务和回复沉淀到长期交互资料。 | 基本稳定 |
| 公司资料继承 | 业务相关回复优先读取公司资料，不足时说明缺项。 | 基本稳定 |
| 防单次任务固化 | 新建 Bot 人设不能把某一次会议轮次、临时顺序写成长期人格。 | 稳定 |
| 旧人设污染兜底 | 例如私聊里旧人设要求 @ 替身，已由程序层兜底清洗。 | 刚修复 |
| 功能点 | 说明 | 状态 |
|---|---|---|
| XIUXIU3_ACTION | 001 配置 Bot 时输出隐藏动作，由秀秀服务器落库执行。 | 稳定 |
| XIUXIU3_FILE | Bot 可生成文件、附件、报告页，不只回复服务器路径。 | 稳定 |
| 长内容报告页 | 长报告用概要 + 在线查看链接，完整正文归档。 | 稳定 |
| 文件任务校验 | 用户要求文件时，会检查是否真的生成文件。 | 稳定 |
| 协议解析失败处理 | JSON 不规范或文件生成失败时，会给出错误信息或兜底。 | 待观察 |
当前四台服务器已同步同一版核心代码和版本记录。同步原则是只同步代码和版本记录，不动各服务器已有 Bot、聊天记录、业务资料和 workspace。
| 服务器 | 当前状态 | 说明 |
|---|---|---|
| 立大志 / 总控 206 | active | 作为当前基准之一，核心代码已同步。 |
| 影子团队 | active | 本轮问题主要在影子 U1/U3 复现并修复。 |
| 南安 | active | 核心代码和版本记录同步。 |
| 守一 | active | 核心代码和版本记录同步。 |
当前同步哈希：standalone.py = 473519a86bc187b3a7fbad315021697091337127172a57c0158e59f236f8b8a9；xiuxiu3_version_records.md = 302e510b02de9e6d0d4cbc36480a8bb94179e86ed9830c98fb5fcc58fae24762。
| 稳定级别 | 功能 | 原因 |
|---|---|---|
| 已稳定 | 基础消息收发、入库、私聊 Bot、群聊 @、引用消息、确认执行、工作要求整理、讨论保护、引用讨论后创建、批量创建主链路、私聊不 @ 替身、多行回复写回、四台同步。 | 已有代码层保护，并完成函数级或真实场景验证。 |
| 基本稳定 | 复杂 Loop、创建后协同、长期记忆沉淀、公司资料继承、跨服调用。 | 主链路可用，但依赖语义判断、运行态和各服务器本地 Bot 状态。 |
| 待继续收敛 | 失败提示和后续成功并存、多 Loop 自动选择、OpenClaw session busy、空回复、上下文溢出、旧 Bot 人设残留。 | 这些不是单一固定代码分支，和异步 worker、模型运行、历史数据有关。 |
这部分按你要求的"不要留尾巴"整理：哪些场景已经进入测试矩阵，哪些测试属于函数级、静态级、真实群聊级。由于真实群聊测试会生成 Bot 和聊天记录，后续执行前仍应按你的确认范围控制。
| 测试项 | 覆盖目的 | 已覆盖内容 | 当前结论 |
|---|---|---|---|
| 简单回复 | 验证普通业务 Bot 能正常对话，不出现空回复或最后一句。 | OpenClaw 多行抽取修复；私聊/群聊普通问题均走第 8-10 步。 | 通过，需日常观察 |
| 私聊 Bot | 验证私聊直接派给目标 Bot，且不 @ 替身。 | 新增私聊 prompt 规则和写回前清洗函数。 | 通过 |
| 群聊行首 @ | 验证群内 @ 指定 Bot 可进入后台任务。 | mention 解析、行首 @ 派发、dispatch 幂等。 | 通过 |
| 引用确认 | 验证 quote.content 完整保存，引用上一条工单确认可续跑。 | 真实引用替身工单 + 确认执行时数据库保存完整 quote.content。 | 通过 |
| 讨论任务 | 验证"先讨论，不创建"不会被标准工单吞掉。 | 讨论保护、工作要求整理专家、动态专家候选。 | 已修复 |
| 讨论后创建 | 验证引用讨论回复说"按这个方案创建对应 Bot"时，按讨论中明确专家创建。 | explicit_bot_list 优先、旧 regex 不覆盖、创建前再次确认。 | 已修复 |
| 单 Bot 创建 | 验证创建一个 Bot 的完整 002/001 链路。 | 预分类/工作要求整理、确认工单、002、001、入群、绑定、自测。 | 通过 |
| 批量创建 2/3/4 个 Bot | 验证数量、名称、职责、串行推进。 | 锁定清单、数量冲突、逐个推进、001/002 受控派发。 | 通过主链路 |
| 数量不一致 | 验证"说 4 个、列 5 个"不误创建。 | 第 7 步拦截 expected/parsed，要求确认最终清单。 | 通过函数级 |
| 创建后 Loop | 验证创建完成后按本批新 Bot 继续协同。 | post_batch_loop_topic、参与 Bot 锁定、最终汇总基于真实回报。 | 基本通过，复杂长链路待观察 |
| 多 Loop 调用 | 验证同群多个 Loop 时能根据问题选择。 | 已有语义候选和记忆设计；多个匹配时建议确认。 | 未完全验收 |
| 用户插队 | 验证 Loop 运行中用户新任务优先，旧 Loop 暂停。 | 有暂停活跃 Loop 逻辑，但完整真实矩阵未最终复测。 | 需补测 |
| 文件/报告 | 验证要求网页、表格、文件时能生成真实可打开文件。 | XIUXIU3_FILE、bot-reports、附件 metadata 和报告页链接。 | 通过 |
| 动作协议 | 验证 001 配置动作能被程序执行。 | XIUXIU3_ACTION 解析、执行、回执、自测触发。 | 通过 |
| OpenClaw 异常 | 验证 empty、timeout、context overflow、session busy 的处理。 | 重试、压缩、trajectory 恢复、失败提示和自测兜底。 | 机制可用，运行态待观察 |
| 电脑端回归 | 验证桌面端消息、引用、@、文件、群组/Bot 管理不受后台修改影响。 | 本轮未改 web/web.js；共享后端接口保持兼容。 | 未改动，建议发版前冒烟 |
| 手机端回归 | 验证移动端消息、引用、@、附件、通讯录、群管理不受后台修改影响。 | 本轮未改 app/mobile.js；共享后端接口保持兼容。 | 未改动，建议发版前冒烟 |
| 跨服同步 | 验证各服务器三模块 active、源码哈希一致、各自 Bot/聊天/API 不被覆盖。 | 同步 standalone.py 和版本记录；重启三模块；核对状态和哈希。 | 已完成 |
| 依据文件/记录 | 用途 | 这份功能清单如何引用 |
|---|---|---|
/home/halo/xiuxiu3_20day_requirements_audit_20260803.html | 近 20 天问题与解决状态审计。 | 用于补充历史要求台账、未稳定项、同步/备份/测试结论。 |
/home/halo/xiuxiu3_task_reply_logic_report.html | 12 步任务回复链路详细解释。 | 用于说明每个功能对应哪一步，避免后续遇到问题从头乱改。 |
/home/halo/xiuxiu3_version_records.md | 版本定型和变更记录。 | 用于确认最近版本：工作要求整理专家、通用兜底、动态专家、引用创建、讨论保护、多行抽取、私聊不 @ 替身。 |
/home/halo/lidazhi_issue_evidence_20260803.json | 立大志数据库只读抽取证据。 | 用于区分当前新链路问题和历史任务/旧 Loop 残留问题。 |
/home/halo/xiuxiu3_loop_persist_sync_20260803T021404Z.md | Loop 持久化和同步记录。 | 用于说明 Loop 状态恢复、同步和历史待治理边界。 |
/home/halo/xiuxiu3_postbatch_topic_sync_20260803T035627Z.md | 创建后 Loop 主题修复和跨服同步记录。 | 用于说明"创建原文不应作为 Loop 执行主题"的修复来源。 |
/home/halo/xiuxiu30_actual_test_report.html | 早期真实测试报告。 | 用于补充已经跑过的创建、回复、协同类测试背景。 |
/home/halo/lidazhi_u3_hotfix_real_test*.py 等脚本 | 真实群聊热修测试脚本。 | 用于说明部分链路做过真实消息测试，不只是静态检查。 |
/home/halo/inspect_shadow_u2_stuck.py 等排查脚本 | 影子/守一等服务器卡点排查。 | 用于说明卡住问题按 task_events、chat_messages、worker 日志定位。 |
说明：本页是功能清单和稳定性总览，不会自动清理 Bot、不会重启服务、不会新增测试消息。后续如果要继续修复，应按 12 步定位到具体环节，只改问题所在层。
| 能力 | 源码位置 |
|---|---|
| 消息接收和派发入口 | send_im_message，约 standalone.py:24549 |
| 任务事件创建 | create_task_event，约 standalone.py:6003 |
| worker 执行 | process_bot_task，约 standalone.py:13985 |
| 工作要求整理专家 | run_requirement_organizer，约 standalone.py:17268 |
| 批量创建入口 | enforce_substitute_batch_creation_entry_reply，约 standalone.py:10394 |
| 讨论/标准工单保护 | enforce_substitute_work_order_entry_reply，约 standalone.py:10568 |
| Loop 入口 | enforce_substitute_collaboration_loop_entry_reply，约 standalone.py:9714 |
| OpenClaw 调用 | openclaw_agent_reply，约 standalone.py:19975 |
| OpenClaw 回复抽取 | extract_openclaw_reply，约 standalone.py:22917 |
| 私聊去除替身 @ | sanitize_private_bot_return_mentions，约 standalone.py:13206 |
| 文件协议 | extract_xiuxiu3_files，约 standalone.py:12713 |
| 动作协议 | extract_xiuxiu3_actions，约 standalone.py:12670 |
| 长期记忆沉淀 | append_bot_long_term_interaction，约 standalone.py:2116 |
| 跨服路由 | route_remote_bot_from_source，约 standalone.py:4634 |