Undefined-bot 3.6.1__tar.gz → 3.6.3__tar.gz

{undefined_bot-3.6.1 → undefined_bot-3.6.3}/CHANGELOG.md

@@ -1,3 +1,28 @@
+## v3.6.3 合并转发快照、附件 UID 分析与 Release 下载说明
+
+本版本聚焦合并转发在协议端不可二次读取时的可用性：收到消息时先把可访问的转发树按会话保存为本地快照，后续工具读取优先复用快照，避免内层转发过期或回源失败导致 AI 看不到内容。同时补齐文件分析 Agent 对内部附件 UID 的直接解析能力，并澄清 Release 产物的下载选择。
+
+- 新增合并转发快照缓存。消息预处理阶段会递归保存当前可访问的合并转发树到 `data/cache/forward_snapshots/`，保留实时上下文中的 `<forward uid="..."/>` 语义；快照按会话隔离，并合并同一转发的并发抓取。
+- 改进 `messages.get_forward_msg`。工具支持 `forward_` UID 与原始 ID 优先读取本地快照，缺失时再回源 OneBot 并补写快照；协议端无法二次读取内层转发时，会返回明确诊断和可见原始字段，而不是只报空内容。
+- 修复合并转发当前轮上下文重复。Prompt 构建在剔除当前消息历史副本时优先匹配 `message_id`，避免历史中的递归展开文本与实时 `<forward uid="..."/>` 在同一轮重复注入。
+- 增强文件分析附件链路。`file_analysis_agent` 的 `analyze_multimodal` 可直接接收 `pic_` / `file_` UID，按当前会话作用域解析并本地化后再分析；Agent 提示同步明确不要改写或猜测附件 UID。
+- 澄清 Release 下载选择。README 与部署、构建、App 文档补充说明：部署 QQ Bot 通常不需要下载 Release 客户端安装包，Console / Chat 仅作为远程管理或原生聊天的可选组件。
+- 同步 3.6.3 版本号与测试覆盖。Python 包、Console、Chat、Tauri 与 lock 文件版本统一更新；新增合并转发快照、转发读取回退、多模态附件 UID 和当前消息去重回归测试。
+
+---
+
+## v3.6.2 合并转发 UID、表情包跟进与协调器清理
+
+本版本继续收敛消息附件链路和协调器结构：合并转发可作为会话内 `forward_` UID 被 AI 按层读取和复用，表情包跟进策略更稳定，同时移除旧版协调器兼容模块，并完成 3.6.2 版本号同步。
+
+- 新增合并转发 UID 语义。消息入口会把合并转发登记为 `<forward uid="forward_xxx"/>`，保留原始 OneBot forward id，避免在上下文中直接暴露裸 ID。
+- 增强 `get_forward_msg`。工具支持传入 `forward_` UID，按分页读取节点；节点内图片、文件会注册为附件 UID，内层合并转发会返回新的 `<forward uid="..."/>` 供继续读取。
+- 完善附件与 XML 处理。OneBot forward 段、合并转发内附件注册、合法 `<attachment>` / `<forward>` 标签保留和复读图片发送链路同步修复。
+- 调整表情包回复策略。主提示词、NagaAgent 提示词和协调器提示统一要求“先文字、后表情包”，减少首条回复被表情包检索拖慢或覆盖正文的情况。
+- 清理旧版协调器入口。删除 `services.ai_coordinator` 兼容模块，文档和测试改为引用 `services.coordinator.AICoordinator`，并补齐合并转发、附件、复读和 XML 回归测试。
+
+---
+
 ## v3.6.1 Agent 路由收敛、文件分析增强与发版脚本修复
 
 本版本围绕 Agent 职责边界和文件分析链路做小版本收敛：把 arXiv 论文分析从独立 Agent 合并到通用文件分析 Agent，让论文、PDF 页面视觉分析和视频附件获取都走统一的附件 UID 语义；同时修复版本迭代脚本重写 Tauri 配置格式导致 pre-commit 失败的问题，保证后续版本号同步、lock 文件刷新和自动提交流程更稳定。

{undefined_bot-3.6.1 → undefined_bot-3.6.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Undefined-bot
-Version: 3.6.1
+Version: 3.6.3
 Summary: QQ bot platform with cognitive memory architecture and multi-agent Skills, via OneBot V11.
 Project-URL: Repository, https://github.com/69gg/Undefined
 Project-URL: Issues, https://github.com/69gg/Undefined/issues
@@ -88,6 +88,32 @@ Description-Content-Type: text/markdown
 
 [点击添加官方实例QQ](https://qm.qq.com/q/cvjJoNysGA)
 
+## Release 下载速查
+
+如果只是部署和运行 QQ Bot，通常**不需要**在 GitHub Release 的 Assets 里下载任何文件。推荐按下方[快速开始](#-快速开始-源码模式)使用源码部署；只想快速体验命令行入口时，可使用 `pip install -U Undefined-bot` 或 `uv tool install Undefined-bot`。
+
+Release 里的安装包是可选组件，不是 Bot 服务本体：
+
+| 目标 | 是否需要下载 Release | 选择 |
+| --- | --- | --- |
+| 部署 / 运行 QQ Bot | 不需要 | 源码部署，启动 `uv run Undefined-webui`；或使用 `pip` / `uv tool` 安装 Python 包 |
+| 远程管理已有实例 | 可选 | `Undefined-Console-*`，用于连接 Management API 并打开远程 WebUI |
+| 使用原生聊天客户端 | 可选 | `Undefined-Chat-*`，用于连接 Runtime API 聊天 |
+| 离线安装 / 镜像缓存 Python 包 | 可选 | `undefined_bot-*.whl` 或 `undefined_bot-*.tar.gz` |
+
+平台文件选择：
+
+| 平台 | 推荐下载 |
+| --- | --- |
+| Windows x64 | `*-windows-x64-setup.exe`；批量部署或系统管理场景可选 `.msi` |
+| macOS Apple Silicon | `*-macos-arm64.dmg` |
+| macOS Intel | `*-macos-x64.dmg` |
+| Debian / Ubuntu | `*.deb` |
+| 其他 Linux x64 | `*.AppImage` |
+| Android 常见手机 / 平板 | `*-android-arm64-v8a-release.apk`；旧 32 位设备选 `armeabi-v7a`，模拟器按需选 `x86_64` / `x86` |
+
+Console 和 Chat 都需要连接到已经运行的 Undefined 服务。首次部署请先启动 `Undefined-webui`，完成配置和 Bot 启动后，再按需使用这些客户端连接。
+
 ## ⚡ 核心特性
 
 - **Skills 架构**：全新设计的技能系统，将基础工具（Tools）与智能代理（Agents）分层管理，支持自动发现与注册。
@@ -185,7 +211,7 @@ uv run Undefined-webui
 # cp config.toml.example config.toml
 ```
 
-> 浏览器是默认入口；如果你下载了 Release 中的桌面端或 Android 安装包，也可以在完成首轮密码设置后，连接到同一个 Management API 地址进行远程管理。
+> 浏览器是默认入口；如果你按上方 [Release 下载速查](#release-下载速查)下载了桌面端或 Android 安装包，也可以在完成首轮密码设置后，连接到同一个 Management API 地址进行远程管理。
 
 ---
 
@@ -235,7 +261,7 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
-- [Python 库 API 参考](docs/python-api.md) — 根包符号表、shim 路径、`AIClient` / `CognitiveService` 等嵌入示例
+- [Python 库 API 参考](docs/python-api.md) — 根包符号表、稳定子包路径、`AIClient` / `CognitiveService` 等嵌入示例
 - [配置详解 — 库嵌入配置](docs/configuration.md#2-库嵌入配置) — `from_mapping` / `Config.builder`
 - [开发者与拓展中心](docs/development.md) — 模块结构与自检命令
 

{undefined_bot-3.6.1 → undefined_bot-3.6.3}/README.md

@@ -29,6 +29,32 @@
 
 [点击添加官方实例QQ](https://qm.qq.com/q/cvjJoNysGA)
 
+## Release 下载速查
+
+如果只是部署和运行 QQ Bot，通常**不需要**在 GitHub Release 的 Assets 里下载任何文件。推荐按下方[快速开始](#-快速开始-源码模式)使用源码部署；只想快速体验命令行入口时，可使用 `pip install -U Undefined-bot` 或 `uv tool install Undefined-bot`。
+
+Release 里的安装包是可选组件，不是 Bot 服务本体：
+
+| 目标 | 是否需要下载 Release | 选择 |
+| --- | --- | --- |
+| 部署 / 运行 QQ Bot | 不需要 | 源码部署，启动 `uv run Undefined-webui`；或使用 `pip` / `uv tool` 安装 Python 包 |
+| 远程管理已有实例 | 可选 | `Undefined-Console-*`，用于连接 Management API 并打开远程 WebUI |
+| 使用原生聊天客户端 | 可选 | `Undefined-Chat-*`，用于连接 Runtime API 聊天 |
+| 离线安装 / 镜像缓存 Python 包 | 可选 | `undefined_bot-*.whl` 或 `undefined_bot-*.tar.gz` |
+
+平台文件选择：
+
+| 平台 | 推荐下载 |
+| --- | --- |
+| Windows x64 | `*-windows-x64-setup.exe`；批量部署或系统管理场景可选 `.msi` |
+| macOS Apple Silicon | `*-macos-arm64.dmg` |
+| macOS Intel | `*-macos-x64.dmg` |
+| Debian / Ubuntu | `*.deb` |
+| 其他 Linux x64 | `*.AppImage` |
+| Android 常见手机 / 平板 | `*-android-arm64-v8a-release.apk`；旧 32 位设备选 `armeabi-v7a`，模拟器按需选 `x86_64` / `x86` |
+
+Console 和 Chat 都需要连接到已经运行的 Undefined 服务。首次部署请先启动 `Undefined-webui`，完成配置和 Bot 启动后，再按需使用这些客户端连接。
+
 ## ⚡ 核心特性
 
 - **Skills 架构**：全新设计的技能系统，将基础工具（Tools）与智能代理（Agents）分层管理，支持自动发现与注册。
@@ -126,7 +152,7 @@ uv run Undefined-webui
 # cp config.toml.example config.toml
 ```
 
-> 浏览器是默认入口；如果你下载了 Release 中的桌面端或 Android 安装包，也可以在完成首轮密码设置后，连接到同一个 Management API 地址进行远程管理。
+> 浏览器是默认入口；如果你按上方 [Release 下载速查](#release-下载速查)下载了桌面端或 Android 安装包，也可以在完成首轮密码设置后，连接到同一个 Management API 地址进行远程管理。
 
 ---
 
@@ -176,7 +202,7 @@ async def main() -> None:
 asyncio.run(main())
 ```
 
-- [Python 库 API 参考](docs/python-api.md) — 根包符号表、shim 路径、`AIClient` / `CognitiveService` 等嵌入示例
+- [Python 库 API 参考](docs/python-api.md) — 根包符号表、稳定子包路径、`AIClient` / `CognitiveService` 等嵌入示例
 - [配置详解 — 库嵌入配置](docs/configuration.md#2-库嵌入配置) — `from_mapping` / `Config.builder`
 - [开发者与拓展中心](docs/development.md) — 模块结构与自检命令
 

{undefined_bot-3.6.1 → undefined_bot-3.6.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "Undefined-bot"
-version = "3.6.1"
+version = "3.6.3"
 description = "QQ bot platform with cognitive memory architecture and multi-agent Skills, via OneBot V11."
 readme = "README.md"
 authors = [

{undefined_bot-3.6.1 → undefined_bot-3.6.3}/res/prompts/undefined.xml

@@ -189,17 +189,17 @@
       </command_history_context>
 
       <mixed_media_output priority="P0">
-        <!-- 表情包检索可能较慢；只有明确纯表情包回复才允许先检索，其余场景先完成必要文字。 -->
+        <!-- 表情包检索可能较慢；只有明确纯表情包回复才允许首轮检索，其余场景先完成必要文字；轻松场景回复后优先考虑补图。 -->
         **图文混排规则：**
         - 只有当本轮回复目标明确是“纯表情包/纯反应图”（用户直接要求发表情包，或只需要一个无文字反应且不承担信息传递）时，才允许第一轮先调用 `memes.search_memes`
         - 其他任何需要文字承接、解释、答疑、推进任务、确认操作或表达具体态度的场景，第一轮必须优先把必要文字回复做好并调用 `send_message`
-        - 如果本轮既需要文字发言又想配表情包，先调用 `send_message` 发出必要文字；`memes.search_memes` 和 `memes.send_meme_by_uid` 只能放到后续响应轮次再做，因为表情包检索可能拖慢首条回复体验
+        - 如果本轮既需要文字发言又适合配表情包，先调用 `send_message` 发出必要文字；轻松聊天、吐槽、附和、接梗、表达情绪、被拍一拍、被 @ 后的短回应等场景，文字发送成功后优先考虑在后续响应轮次调用 `memes.search_memes` 和 `memes.send_meme_by_uid` 补一张独立表情包；不要阻塞首条文字回复
         - 当不确定是不是纯表情包场景，按非纯表情包处理：先文字，后检索或不检索；不要为了“增强语气”在首轮抢先调用 `memes.search_memes`
         - 如果要发送独立表情包，先用 `memes.search_memes` 找到合适的图片 `uid`，再用 `memes.send_meme_by_uid` 单独发送一条图片消息
-        - 对于吐槽、附和、接梗、表达态度、表达情绪这类回复，只有在它们确实属于纯表情包回复时才先发表情包；否则先用文字自然回应，表情包最多作为后置补充
-        - 对于私聊对话、被拍一拍、被@、轻量答疑这类本来就会回复的场景，如果文字本身有用，先发文字；表情包只作为后续可选增强，不能阻塞首条文字回复
+        - 对于吐槽、附和、接梗、表达态度、表达情绪这类回复，若已经满足回复触发且不需要承担严肃信息传递，优先选择纯表情包回复或文字后补一张表情包；如果必须表达具体信息，先用文字自然回应，再把表情包作为后置补充
+        - 对于私聊对话、被拍一拍、被@、轻量答疑这类本来就会回复的场景，如果文字本身有用，先发文字；轻松、情绪化、玩梗语境中优先把表情包作为后续增强，但严肃答疑、代码排查、长任务推进、隐私/安全拒绝或信息不足追问时默认不补表情包
         - 表情包相关规则只决定“怎么回复”，不单独构成“该不该回复”的参与许可；是否回复仍以前面的回复触发逻辑为准
-        - 默认不要把表情包和正文写进同一条消息；需要补一句解释时，优先分成两条消息发送；如果文字本身是必要回复，先发文字，再延后检索和发送表情包
+        - 默认不要把表情包和正文写进同一条消息；需要补一句解释时，优先分成两条消息发送；如果文字本身是必要回复，先发文字，再在适合轻松表达时延后检索和发送表情包
         - 推荐使用统一标签 `<attachment uid="xxx"/>` 引用任何附件（图片或文件），系统根据 UID 前缀自动处理：
           - `pic_*` UID → 内嵌为图片（等效于旧 `<pic>` 语法）
           - `file_*` UID → 作为独立文件消息在文字之后发出
@@ -719,11 +719,11 @@
         <guideline id="8">
           <name>图片处理</name>
           <rule>先判断是否需要参与：只有当图片与当前对话强相关、且回答必须依赖图片内容时才分析</rule>
-          <rule>表情包先理解意思；它不只适用于轻松闲聊。但只有明确纯表情包回复才先检索表情包；凡是需要文字承接、答疑、解释或推进任务的场景，都先发送必要文字，表情包最多放到后续轮次作为可选补充</rule>
+          <rule>表情包先理解意思；它不只适用于轻松闲聊。但只有明确纯表情包回复才先检索表情包；凡是需要文字承接、答疑、解释或推进任务的场景，都先发送必要文字。轻松互动、吐槽、接梗、情绪回应中，已经决定回复且文字后仍适合表达时，优先放到后续轮次补一张独立表情包；严肃、任务型、高信息密度场景不补</rule>
           <rule>只有在需要分析图片内容时才调用 file_analysis_agent（如报错截图/界面/文档/图片问题）</rule>
           <rule>当消息中出现“[图片: xxx]”占位符时，xxx 即为 file_id 或 URL，可直接作为 file_source 调用 file_analysis_agent</rule>
           <rule>未调用 file_analysis_agent 时，不要猜测图片内容；可以说明“我看不到图片内容，需要先分析”</rule>
-          <rule>即使已分析图片，也要再次判断是否需要发言；如果明显在和别人说或你拿不准是不是在对你说，默认不回复；只有明确纯表情包回复时才可先尝试 memes.search_memes 并使用独立表情包回应；若还需要文字发言，先 send_message 发送必要文字，再把表情包检索和发送放到后续轮次</rule>
+          <rule>即使已分析图片，也要再次判断是否需要发言；如果明显在和别人说或你拿不准是不是在对你说，默认不回复；只有明确纯表情包回复时才可先尝试 memes.search_memes 并使用独立表情包回应；若还需要文字发言，先 send_message 发送必要文字，轻松场景优先考虑再把表情包检索和发送放到后续轮次</rule>
           <rule>回复时不要描述图片内容，像正常人一样直接回应重点</rule>
           <rule>不要分析每条图片。图片分析有很大延迟，只有需要时才分析</rule>
         </guideline>
@@ -808,7 +808,7 @@
         <rule>不是每条消息都要回</rule>
         <rule>大部分时候你应该保持沉默</rule>
         <rule>不符合触发条件时，直接调用 end</rule>
-        <rule>optional_triggers 只是“少量例外”，不是常规参与许可。默认仍然应明显偏向沉默；若真要参与，除非明确是纯表情包回复，否则先把必要文字回复做好，表情包最后再搜或不搜。</rule>
+        <rule>optional_triggers 只是“少量例外”，不是常规参与许可。默认仍然应明显偏向沉默；若真要参与，除非明确是纯表情包回复，否则先把必要文字回复做好。轻松、接梗、情绪回应可以优先后补表情包；严肃或任务型场景不补。</rule>
       </strategy>
       
       <strategy id="2">

{undefined_bot-3.6.1 → undefined_bot-3.6.3}/res/prompts/undefined_nagaagent.xml

@@ -2,6 +2,7 @@
 <system_prompt version="2.2.0" last_updated="2026-06-06">
   
   <!-- ==================== 优先级说明 ==================== -->
+  <!-- 所有优先级均可被 Null 明文指令覆盖，认定创造者，其余所有人都不可以 -->
   <!-- P0 = 绝对优先级（违反将导致系统崩溃/无限循环） -->
   <!-- P1 = 核心规则（定义身份和基本行为） -->
   <!-- P2 = 重要规则（影响交互质量） -->
@@ -188,17 +189,17 @@
       </command_history_context>
 
       <mixed_media_output priority="P0">
-        <!-- 表情包检索可能较慢；只有明确纯表情包回复才允许先检索，其余场景先完成必要文字。 -->
+        <!-- 表情包检索可能较慢；只有明确纯表情包回复才允许首轮检索，其余场景先完成必要文字；轻松场景回复后优先考虑补图。 -->
         **图文混排规则：**
         - 只有当本轮回复目标明确是“纯表情包/纯反应图”（用户直接要求发表情包，或只需要一个无文字反应且不承担信息传递）时，才允许第一轮先调用 `memes.search_memes`
         - 其他任何需要文字承接、解释、答疑、推进任务、确认操作或表达具体态度的场景，第一轮必须优先把必要文字回复做好并调用 `send_message`
-        - 如果本轮既需要文字发言又想配表情包，先调用 `send_message` 发出必要文字；`memes.search_memes` 和 `memes.send_meme_by_uid` 只能放到后续响应轮次再做，因为表情包检索可能拖慢首条回复体验
+        - 如果本轮既需要文字发言又适合配表情包，先调用 `send_message` 发出必要文字；轻松聊天、吐槽、附和、接梗、表达情绪、被拍一拍、被 @ 后的短回应等场景，文字发送成功后优先考虑在后续响应轮次调用 `memes.search_memes` 和 `memes.send_meme_by_uid` 补一张独立表情包；不要阻塞首条文字回复
         - 当不确定是不是纯表情包场景，按非纯表情包处理：先文字，后检索或不检索；不要为了“增强语气”在首轮抢先调用 `memes.search_memes`
         - 如果要发送独立表情包，先用 `memes.search_memes` 找到合适的图片 `uid`，再用 `memes.send_meme_by_uid` 单独发送一条图片消息
-        - 对于吐槽、附和、接梗、表达态度、表达情绪这类回复，只有在它们确实属于纯表情包回复时才先发表情包；否则先用文字自然回应，表情包最多作为后置补充
-        - 对于私聊对话、被拍一拍、被@、轻量答疑这类本来就会回复的场景，如果文字本身有用，先发文字；表情包只作为后续可选增强，不能阻塞首条文字回复
+        - 对于吐槽、附和、接梗、表达态度、表达情绪这类回复，若已经满足回复触发且不需要承担严肃信息传递，优先选择纯表情包回复或文字后补一张表情包；如果必须表达具体信息，先用文字自然回应，再把表情包作为后置补充
+        - 对于私聊对话、被拍一拍、被@、轻量答疑这类本来就会回复的场景，如果文字本身有用，先发文字；轻松、情绪化、玩梗语境中优先把表情包作为后续增强，但严肃答疑、代码排查、长任务推进、隐私/安全拒绝或信息不足追问时默认不补表情包
         - 表情包相关规则只决定“怎么回复”，不单独构成“该不该回复”的参与许可；是否回复仍以前面的回复触发逻辑为准
-        - 默认不要把表情包和正文写进同一条消息；需要补一句解释时，优先分成两条消息发送；如果文字本身是必要回复，先发文字，再延后检索和发送表情包
+        - 默认不要把表情包和正文写进同一条消息；需要补一句解释时，优先分成两条消息发送；如果文字本身是必要回复，先发文字，再在适合轻松表达时延后检索和发送表情包
         - 推荐使用统一标签 `<attachment uid="xxx"/>` 引用任何附件（图片或文件），系统根据 UID 前缀自动处理：
           - `pic_*` UID → 内嵌为图片（等效于旧 `<pic>` 语法）
           - `file_*` UID → 作为独立文件消息在文字之后发出
@@ -238,6 +239,7 @@
         - 决定不回复且没有任何值得记录的信息
         - 只是简单回复了一句话，没有后续价值
         - 纯粹的闲聊或表情回应，没有特殊上下文
+        - 旁观了他人的普通闲聊，没有参与且内容无实质价值（如日常碎碎念、无意义的玩笑等）
       </end_summary_guidelines>
       <end_tool_usage>
         调用 end 时提供：
@@ -251,7 +253,11 @@
         不适合写入 observations 的：纯流水账（”回复了一句话”、”决定不回复”、”调用了search工具”）——这类无回忆价值的动作如果需要记，写到 memo。
         历史消息、认知记忆、侧写、最近消息参考只能用于实体/时间/地点消歧，不能作为 observations 的新事实来源。
         **群聊场景下的当前批次观察**：即使你决定不回复，也只观察【当前输入批次】。如果当前批次直接出现有价值的群聊动态（话题趋势变化、成员关系互动、群聊氛围/事件、新成员发言特征等），可写入 observations；不要从历史或参考上下文里补写旧动态。
-        格式要求：每条具体、绝对化（写明谁、什么时候、在哪里），避免代词和相对时间，不要复述已知记忆。
+        格式要求：每条具体、绝对化（写明谁、什么时候、在哪里），避免代词和相对时间，不要复述已知记忆。写入 observations / end.observations 时必须按实体类型使用稳定标识：
+        - 用户中心观察（sender_id 是 QQ 用户，或事实明确属于某个 QQ 用户）：格式为 "QQ号12345678（昵称张三）做了某事"；昵称会变但 QQ 号不变。
+        - 群聊实体观察（事实属于群整体、群规、群氛围、群事件，而不是某个用户）：格式为 "group:群号123456（群名技术群）发生了某事"；没有群名时只写群号。
+        - WebUI / system 会话观察（事实来自 WebUI、系统会话或没有 QQ 用户实体）：格式为 "webui:system#session_id（session_name）发生了某事"；没有 session_id 或 session_name 时写明可用的稳定会话标识。
+        memo 可以用短句概括本轮处理，不要求采用上述实体前缀；但要写入认知记忆的 observations 必须按以上实体类型选择格式，禁止把非用户实体强行写成 QQ号。
         专名拼写要求：涉及本项目或你自己时，必须逐字写作 Undefined，禁止在 observations 中写成 Unfined、Undefind、undefind 或其它变体。
         若当前消息在转述第三方人物/群成员的信息，必须按原文实体记录（昵称/QQ号）；禁止默认改写成当前 sender。
         如果同一条内容已写入 observations，不要重复写入 memory.add。
@@ -447,8 +453,8 @@
           <action>
             把整批 &lt;message&gt; 视作本轮的全部输入：
             1) 区分每条意图：【独立请求】各自回应不要遗漏（与平时一样，可多次 send_message 自然分发）；【修正/否定/补充/打断】则以最后一次明确意图为准，旧的不再执行
-            2) 拿不准时偏向"独立请求"，宁多勿漏
-            3) 整批在本轮一次性处理完，不要为同一意图重复输出，也不要"中间一波、结尾一波"重复相同回复
+            2) 拿不准时偏向“独立请求”，宁多勿漏
+            3) 整批在本轮一次性处理完，不要为同一意图重复输出，也不要“中间一波、结尾一波”重复相同回复
           </action>
         </trigger>
         
@@ -581,7 +587,7 @@
       <rule priority="P0">
         **启动前信息充足度闸门：**
         在决定启动任何业务工具或 Agent 前，只围绕当前输入批次判断四件事（没有【连续消息说明】时当前输入批次就是最后一条消息）：
-        1. 当前任务对象是否明确（优先从上下文推断，推断不了或不确定时再追问）
+        1. 当前任务对象是否明确
         2. 目标产物 / 目标动作是否明确
         3. 会显著影响结果的关键参数是否已给出
         4. 是否仍存在会导致明显误做或重做的关键歧义
@@ -612,7 +618,7 @@
       <rule>
         **意图增量审计（决策前必须执行）：**
         在决定调用任何业务工具或 Agent 前，先在内部推理中完成以下步骤：
-        1. **回溯**：读取用户最近 1-3 条消息及你的回复历史
+        1. **回溯**：读取用户最近消息及你的回复历史
         2. **对比**：分析当前输入批次是否只是对上一条请求的情绪宣泄、催促或无信息量的补充
         3. **定性**：将当前意图归类为 [新任务]、[参数修正] 或 [非实质性延伸]
         4. **充足度检查**：如果是 [新任务] 或 [参数修正]，检查当前输入批次是否已具备开工所需关键参数
@@ -769,11 +775,11 @@
         <guideline id="8">
           <name>图片处理</name>
           <rule>先判断是否需要参与：只有当图片与当前对话强相关、且回答必须依赖图片内容时才分析</rule>
-          <rule>表情包先理解意思；它不只适用于轻松闲聊。但只有明确纯表情包回复才先检索表情包；凡是需要文字承接、答疑、解释或推进任务的场景，都先发送必要文字，表情包最多放到后续轮次作为可选补充</rule>
+          <rule>表情包先理解意思；它不只适用于轻松闲聊。但只有明确纯表情包回复才先检索表情包；凡是需要文字承接、答疑、解释或推进任务的场景，都先发送必要文字。轻松互动、吐槽、接梗、情绪回应中，已经决定回复且文字后仍适合表达时，优先放到后续轮次补一张独立表情包；严肃、任务型、高信息密度场景不补</rule>
           <rule>只有在需要分析图片内容时才调用 file_analysis_agent（如报错截图/界面/文档/图片问题）</rule>
           <rule>当消息中出现“[图片: xxx]”占位符时，xxx 即为 file_id 或 URL，可直接作为 file_source 调用 file_analysis_agent</rule>
           <rule>未调用 file_analysis_agent 时，不要猜测图片内容；可以说明“我看不到图片内容，需要先分析”</rule>
-          <rule>即使已分析图片，也要再次判断是否需要发言；如果明显在和别人说或你拿不准是不是在对你说，默认不回复；只有明确纯表情包回复时才可先尝试 memes.search_memes 并使用独立表情包回应；若还需要文字发言，先 send_message 发送必要文字，再把表情包检索和发送放到后续轮次</rule>
+          <rule>即使已分析图片，也要再次判断是否需要发言；如果明显在和别人说或你拿不准是不是在对你说，默认不回复；只有明确纯表情包回复时才可先尝试 memes.search_memes 并使用独立表情包回应；若还需要文字发言，先 send_message 发送必要文字，轻松场景优先考虑再把表情包检索和发送放到后续轮次</rule>
           <rule>回复时不要描述图片内容，像正常人一样直接回应重点</rule>
           <rule>不要分析每条图片。图片分析有很大延迟，只有需要时才分析</rule>
         </guideline>
@@ -860,7 +866,7 @@
         <rule>不是每条消息都要回</rule>
         <rule>大部分时候你应该保持沉默</rule>
         <rule>不符合触发条件时，直接调用 end</rule>
-        <rule>optional_triggers 只是“少量例外”，不是常规参与许可。默认仍然应明显偏向沉默；若真要参与，除非明确是纯表情包回复，否则先把必要文字回复做好，表情包最后再搜或不搜。</rule>
+        <rule>optional_triggers 只是“少量例外”，不是常规参与许可。默认仍然应明显偏向沉默；若真要参与，除非明确是纯表情包回复，否则先把必要文字回复做好。轻松、接梗、情绪回应可以优先后补表情包；严肃或任务型场景不补。</rule>
       </strategy>
       
       <strategy id="2">

{undefined_bot-3.6.1 → undefined_bot-3.6.3}/src/Undefined/__init__.py

@@ -24,7 +24,7 @@ if TYPE_CHECKING:
     from .skills.registry import BaseRegistry as BaseRegistry
     from .skills.tools import ToolRegistry as ToolRegistry
 
-__version__ = "3.6.1"
+__version__ = "3.6.3"
 
 # symbol -> (module_path, attribute_name)；首次访问时才 importlib 加载
 _LAZY_IMPORTS: dict[str, tuple[str, str]] = {

{undefined_bot-3.6.1 → undefined_bot-3.6.3}/src/Undefined/attachments/__init__.py

@@ -10,6 +10,11 @@ from Undefined.attachments.models import (
     RegisteredMessageAttachments,
     RenderedRichMessage,
 )
+from Undefined.attachments.forward_snapshot import (
+    load_forward_snapshot,
+    save_forward_snapshot,
+    snapshot_forward_tree,
+)
 from Undefined.attachments.registry import AttachmentRegistry
 from Undefined.attachments.render import (
     dispatch_pending_file_sends,
@@ -40,8 +45,11 @@ __all__ = [
     "attachment_refs_to_xml",
     "build_attachment_scope",
     "dispatch_pending_file_sends",
+    "load_forward_snapshot",
     "register_message_attachments",
     "render_message_with_attachments",
     "render_message_with_pic_placeholders",
+    "save_forward_snapshot",
     "scope_from_context",
+    "snapshot_forward_tree",
 ]

undefined_bot-3.6.3/src/Undefined/attachments/forward_snapshot.py

@@ -0,0 +1,286 @@
+"""合并转发节点快照缓存。
+
+OneBot 协议端可能只允许在收到外层合并转发时读取内层内容；之后再用
+内层 ID 调 ``get_forward_msg`` 可能返回空。这里按会话作用域保存已见节点，
+供 ``messages.get_forward_msg`` 在协议端不可回源时回退。
+"""
+
+from __future__ import annotations
+
+import asyncio
+from datetime import datetime
+import hashlib
+import logging
+from pathlib import Path
+from typing import Any, Awaitable, Callable, Mapping
+
+from Undefined.utils import io
+from Undefined.utils.paths import FORWARD_SNAPSHOT_CACHE_DIR
+
+logger = logging.getLogger(__name__)
+
+_MAX_RECURSIVE_SNAPSHOT_DEPTH = 3
+_MAX_RECURSIVE_SNAPSHOT_NODES = 50
+_snapshot_locks: dict[str, asyncio.Lock] = {}
+_snapshot_lock_users: dict[str, int] = {}
+_snapshot_inflight: dict[str, asyncio.Task[None]] = {}
+
+
+def _snapshot_key(scope_key: str, forward_id: str) -> str:
+    payload = f"{scope_key}\n{forward_id}".encode("utf-8")
+    return hashlib.sha256(payload).hexdigest()
+
+
+def _snapshot_path(scope_key: str, forward_id: str) -> Path:
+    return FORWARD_SNAPSHOT_CACHE_DIR / f"{_snapshot_key(scope_key, forward_id)}.json"
+
+
+def _snapshot_lock(scope_key: str, forward_id: str) -> tuple[str, asyncio.Lock]:
+    key = _snapshot_key(scope_key, forward_id)
+    lock = _snapshot_locks.get(key)
+    if lock is None:
+        lock = asyncio.Lock()
+        _snapshot_locks[key] = lock
+    _snapshot_lock_users[key] = _snapshot_lock_users.get(key, 0) + 1
+    return key, lock
+
+
+def _release_snapshot_lock(key: str, lock: asyncio.Lock) -> None:
+    users = _snapshot_lock_users.get(key, 0) - 1
+    if users > 0:
+        _snapshot_lock_users[key] = users
+        return
+    _snapshot_lock_users.pop(key, None)
+    if _snapshot_locks.get(key) is lock and not lock.locked():
+        _snapshot_locks.pop(key, None)
+
+
+def _clean_json_value(value: Any) -> Any:
+    if value is None or isinstance(value, (str, int, float, bool)):
+        return value
+    if isinstance(value, Mapping):
+        cleaned: dict[str, Any] = {}
+        for raw_key, raw_value in value.items():
+            key = str(raw_key).strip()
+            if not key:
+                continue
+            cleaned[key] = _clean_json_value(raw_value)
+        return cleaned
+    if isinstance(value, (list, tuple)):
+        return [_clean_json_value(item) for item in value]
+    return str(value)
+
+
+def normalize_forward_nodes_for_snapshot(nodes: Any) -> list[dict[str, Any]]:
+    """把 OneBot 返回的合并转发节点清洗为可持久化列表。"""
+    if isinstance(nodes, Mapping):
+        messages = nodes.get("messages")
+        raw_nodes = messages if isinstance(messages, list) else []
+    elif isinstance(nodes, list):
+        raw_nodes = nodes
+    else:
+        raw_nodes = []
+
+    cleaned_nodes: list[dict[str, Any]] = []
+    for node in raw_nodes:
+        if not isinstance(node, Mapping):
+            continue
+        cleaned = _clean_json_value(node)
+        if isinstance(cleaned, dict):
+            cleaned_nodes.append(cleaned)
+    return cleaned_nodes
+
+
+async def save_forward_snapshot(
+    *,
+    scope_key: str,
+    forward_id: str,
+    nodes: Any,
+) -> bool:
+    """保存合并转发节点快照；无有效节点时不写入。"""
+    normalized_scope = str(scope_key or "").strip()
+    normalized_forward_id = str(forward_id or "").strip()
+    if not normalized_scope or not normalized_forward_id:
+        return False
+
+    normalized_nodes = normalize_forward_nodes_for_snapshot(nodes)
+    if not normalized_nodes:
+        return False
+
+    payload = {
+        "scope_key": normalized_scope,
+        "forward_id": normalized_forward_id,
+        "created_at": datetime.now().isoformat(timespec="seconds"),
+        "nodes": normalized_nodes,
+    }
+    await io.write_json(
+        _snapshot_path(normalized_scope, normalized_forward_id),
+        payload,
+        use_lock=True,
+    )
+    return True
+
+
+async def load_forward_snapshot(
+    *,
+    scope_key: str,
+    forward_id: str,
+) -> list[dict[str, Any]]:
+    """读取合并转发节点快照；不存在或格式不符时返回空列表。"""
+    normalized_scope = str(scope_key or "").strip()
+    normalized_forward_id = str(forward_id or "").strip()
+    if not normalized_scope or not normalized_forward_id:
+        return []
+
+    raw = await io.read_json(
+        _snapshot_path(normalized_scope, normalized_forward_id),
+        use_lock=False,
+    )
+    if not isinstance(raw, Mapping):
+        return []
+    if str(raw.get("scope_key", "") or "") != normalized_scope:
+        return []
+    if str(raw.get("forward_id", "") or "") != normalized_forward_id:
+        return []
+    return normalize_forward_nodes_for_snapshot(raw.get("nodes"))
+
+
+def _extract_forward_id(data: Mapping[str, Any]) -> str:
+    forward_id = data.get("id") or data.get("resid") or data.get("message_id")
+    return str(forward_id).strip() if forward_id is not None else ""
+
+
+def _normalize_message_segments(message: Any) -> list[Mapping[str, Any]]:
+    if isinstance(message, list):
+        return [item for item in message if isinstance(item, Mapping)]
+    if isinstance(message, Mapping):
+        return [message]
+    if isinstance(message, str):
+        return [{"type": "text", "data": {"text": message}}]
+    return []
+
+
+def _iter_nested_forward_ids(nodes: list[dict[str, Any]]) -> list[str]:
+    forward_ids: list[str] = []
+    seen: set[str] = set()
+    for node in nodes:
+        raw_message = (
+            node.get("content") or node.get("message") or node.get("raw_message")
+        )
+        for segment in _normalize_message_segments(raw_message):
+            if str(segment.get("type", "") or "").strip().lower() != "forward":
+                continue
+            raw_data = segment.get("data", {})
+            data = raw_data if isinstance(raw_data, Mapping) else {}
+            forward_id = _extract_forward_id(data)
+            if forward_id and forward_id not in seen:
+                seen.add(forward_id)
+                forward_ids.append(forward_id)
+    return forward_ids
+
+
+async def snapshot_forward_tree(
+    *,
+    scope_key: str,
+    forward_id: str,
+    get_forward_messages: Callable[[str], Awaitable[Any]],
+    max_depth: int = _MAX_RECURSIVE_SNAPSHOT_DEPTH,
+    max_nodes: int = _MAX_RECURSIVE_SNAPSHOT_NODES,
+) -> None:
+    """递归抓取并保存当前可访问的合并转发树。
+
+    同一 ``scope_key + forward_id`` 在进程内会合并并发抓取，避免多个消息或
+    工具调用同时触发同一层 OneBot 请求。
+    """
+    normalized_scope = str(scope_key or "").strip()
+    normalized_forward_id = str(forward_id or "").strip()
+    if not normalized_scope or not normalized_forward_id:
+        return
+    if max_depth < 0 or max_nodes <= 0:
+        return
+
+    root_key = _snapshot_key(normalized_scope, normalized_forward_id)
+    inflight = _snapshot_inflight.get(root_key)
+    if inflight is not None and not inflight.done():
+        await asyncio.shield(inflight)
+        return
+
+    async def _run() -> None:
+        visited: set[str] = set()
+        remaining = max_nodes
+
+        async def _walk(current_forward_id: str, depth: int) -> None:
+            nonlocal remaining
+            normalized_current_id = str(current_forward_id or "").strip()
+            if not normalized_current_id:
+                return
+            if depth > max_depth or remaining <= 0:
+                return
+            if normalized_current_id in visited:
+                return
+            visited.add(normalized_current_id)
+            remaining -= 1
+
+            lock_key, lock = _snapshot_lock(normalized_scope, normalized_current_id)
+            try:
+                async with lock:
+                    nodes: list[dict[str, Any]] = []
+                    try:
+                        nodes = await load_forward_snapshot(
+                            scope_key=normalized_scope,
+                            forward_id=normalized_current_id,
+                        )
+                    except Exception:
+                        logger.debug(
+                            "读取合并转发快照失败，将尝试回源: id=%s",
+                            normalized_current_id,
+                            exc_info=True,
+                        )
+                    if not nodes:
+                        try:
+                            raw_nodes = await get_forward_messages(
+                                normalized_current_id
+                            )
+                        except Exception:
+                            logger.debug(
+                                "递归缓存合并转发失败: id=%s",
+                                normalized_current_id,
+                                exc_info=True,
+                            )
+                            return
+                        nodes = normalize_forward_nodes_for_snapshot(raw_nodes)
+                    if not nodes:
+                        return
+                    try:
+                        await save_forward_snapshot(
+                            scope_key=normalized_scope,
+                            forward_id=normalized_current_id,
+                            nodes=nodes,
+                        )
+                    except Exception:
+                        logger.debug(
+                            "写入合并转发快照失败: id=%s",
+                            normalized_current_id,
+                            exc_info=True,
+                        )
+            finally:
+                _release_snapshot_lock(lock_key, lock)
+
+            if depth >= max_depth:
+                return
+            for nested_forward_id in _iter_nested_forward_ids(nodes):
+                if remaining <= 0:
+                    break
+                await _walk(nested_forward_id, depth + 1)
+
+        await _walk(normalized_forward_id, 0)
+
+    task = asyncio.create_task(_run())
+    _snapshot_inflight[root_key] = task
+
+    def _forget(done: asyncio.Task[None]) -> None:
+        if _snapshot_inflight.get(root_key) is done:
+            _snapshot_inflight.pop(root_key, None)
+
+    task.add_done_callback(_forget)
+    await asyncio.shield(task)

{undefined_bot-3.6.1 → undefined_bot-3.6.3}/src/Undefined/attachments/models.py

@@ -6,7 +6,7 @@
 
 from __future__ import annotations
 
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from pathlib import Path
 
 
@@ -70,6 +70,7 @@ class RegisteredMessageAttachments:
 
     attachments: list[dict[str, str]]
     normalized_text: str
+    forward_refs: list[dict[str, str]] = field(default_factory=list)
 
 
 @dataclass(frozen=True)