Undefined-bot 3.4.0__tar.gz → 3.4.2__tar.gz

{undefined_bot-3.4.0 → undefined_bot-3.4.2}/ARCHITECTURE.md

@@ -452,7 +452,6 @@ sequenceDiagram
             OH->>OB: WebSocket API
             OB->>U: 显示回复
         end
-        end
     end
 ```
 
@@ -901,6 +900,6 @@ description: 从 PDF 文件中提取文本和表格，填写表单。当用户
 
 ---
 
-**架构图版本**: v2.15.0
-**更新日期**: 2026-02-23  
+**架构图版本**: v3.4.1
+**更新日期**: 2026-05-10
 **基于代码版本**: 最新 main 分支

{undefined_bot-3.4.0 → undefined_bot-3.4.2}/CHANGELOG.md

@@ -1,3 +1,33 @@
+## v3.4.2 总结更准、上下文可配、高并发更稳
+
+本版本主要解决三类实际问题：群聊消息变长、合并发送变多之后，`/summary` 容易慢、容易编、分块预算也不准；主对话注入历史的 200 条硬顶与模型真实窗口脱节；高并发下用户连问「在吗」「好了吗」时，机器人仍可能把旧任务当新活重跑。围绕这些痛点，版本把「用户主动要总结」和「AI 自己调总结能力」拆成两条更合适的链路，用可配置的上下文窗口统一约束注入与分块，并同步收紧提示词、史官侧写与定时任务持久化，让总结更可信、配置更贴近上游模型、并发场景下更少重复劳动。
+
+- 提升消息总结的质量与效率。用户通过 `/summary`、`/sum` 获取总结时，改为直连 summary 模型一次性完成，不再绕 Agent 工具链，响应更快、路径更简单；AI 在对话里调用总结能力时，仍保留 Agent + 拉取历史的灵活流程。长会话按模型上下文窗口自动分段、队列内合并，并配套「只读原始记录、禁止编造」的专用提示词，减少幻觉与无关发挥。
+- 理顺上下文与模型配置边界。取消历史注入 200 条的隐性上限，改由 `context_recent_messages_limit` 与历史存储上限共同决定；各模型节新增 `context_window_tokens`，总结分块、Prompt 预算与实际上游窗口对齐，不再依赖硬编码或误用 `max_tokens`。同时补齐 `reasoning_content_replay`、`system_prompt_as_user`，便于 MiMo、DeepSeek 等 thinking 模型在多轮工具调用时正确续传思维链，或按网关要求改写 system 注入方式。
+- 强化高并发下的任务边界。系统提示词与 each 规则进一步明确：催促、寒暄不等于新任务，历史未完成任务不得自动拾取；启动业务工具前须检查是否已有同类或语义等价操作在处理，有则熔断为简短进度回复而非重跑；无依赖的工具与 Agent 仍鼓励并行，有数据依赖则必须串行，与 MessageBatcher 的批次语义一致。
+- 优化认知侧写的长期画像质量。史官合并侧写时必须先读取再更新，以增量补充稳定特征为主，一次性闲聊或无法沉淀为长期特质的事件应跳过，避免侧写被单轮对话冲散或写成流水账。
+- 修复「向未来的自己发指令」定时任务无法恢复。持久化任务若包含 `self_instruction`，此前会导致整表反序列化失败；现已补齐字段定义，自调用类定时任务可正常加载与执行。
+- 更新配置文档、WebUI 表单与相关测试，覆盖总结直连、上下文窗口、模型对接选项与并发防重复等关键路径。
+
+---
+
+## v3.4.1 附件缓存治理、隐私安全防线与B站管线重构
+
+本版本围绕三大主线展开：一是附件系统的缓存容量治理与 URL 引用回退机制，防止本地缓存无限制膨胀；二是系统提示词新增 P0 级隐私与危险动作边界规则，从源头约束 AI 对敏感信息和安全请求的处理行为；三是 B 站自动管线全面重构——移除外部下载依赖、内联实现 API 客户端与 WBI 签名、新增弹幕获取并以合并转发形式发送提取结果。同步新增 `/feedback` 反馈命令、恢复发布说明中的分类提交详情，并修正提示词优先级体系。
+
+- 新增附件缓存容量管理。`[attachments]` 下新增 `attachment_cache_max_mb`、`attachment_cache_max_records`、`attachment_url_reference_max_records`、`attachment_url_max_length` 四种配置，分别控制本地缓存总大小、缓存记录数、URL 引用记录数和 URL 长度上限；超出容量时自动淘汰最旧记录；`remote_download_max_size_mb` 现支持热重载。`send_message` / `send_private_message` 工具调用时自动登记关联附件 UID，AI 客户端发送消息前校验本地路径有效性，文件缺失时自动回退到 URL 引用。
+- 新增 P0 级隐私与危险动作边界规则。系统提示词新增 `<privacy_and_safety_controls>` 规则块，分层约束：隐私方面禁止泄露好友/群/成员列表、完整 QQ 号等敏感信息，对外默认脱敏，第三方信息查询需授权；危险动作方面拒绝涉黄、涉政、违法、骚扰、人肉、社工等请求，不做解释也不给绕过方案；时序方面明确隐私/敏感话题不改变回复时机，必须先满足回复触发逻辑。附加 3 条 P0 硬性约束覆盖隐私泄露、危险动作和触发时序。
+- 新增 `/feedback(/fb)` 反馈命令。支持 `add` / `view` / `del` 三个子命令，`add` 和 `view` 为 public 权限，`del` 为 superadmin；声明式子命令推断按 ID 格式匹配优先 `view`，其余 fallback 到 `add`，无参数默认 `view`；私聊可用，显示在 help 列表。
+- 重构 B 站视频下载链路。移除对 `oh-my-bilibili` 外部 Python 包的依赖，内联实现同步 API 客户端（`api_client.py`）、下载核心（`download_core.py`）、WBI 签名模块（`wbi.py`）与错误模型，所有请求在 `asyncio.to_thread` 线程内执行，降低依赖复杂度与跨版本兼容风险。
+- 增强 B 站自动提取管线。新增弹幕获取模块（`danmaku.py`），基于 protobuf wire 格式解析分段弹幕数据；自动提取结果改为以合并转发节点形式发送，单条包含视频信息卡片与弹幕预览片段；`MessageSender` 扩展合并转发本地附件递归登记，确保转发中的图片/文件能正确注册为会话附件 UID。
+- 恢复发布说明详细变更列表。`scripts/release_notes.py` 新增 `build_detailed_change_sections` 与 `render_detailed_changes`，从 git log 按 feat / fix / other 自动分类提取两个版本间的提交，与 CHANGELOG 条目合并输出完整 Release notes。
+- 修正提示词优先级体系。明确所有 P0-P3 规则均可被 Null 明文指令覆盖，创造者权限作为绝对最高优先级可覆盖所有规则（含隐私与危险动作边界）；同步更新 NagaAgent 版提示词的对应表述。
+- 补强测试覆盖。新增附件缓存配置、容量淘汰、URL 回退和文件分析 UID 注册测试；新增反馈命令全路径测试（add / view / del / 推断 / 权限）；更新 B 站下载适配器测试；同步更新系统提示词约束验证。
+- 更新架构图与文档。
+- 新增附件 UID ↔ URL 双向查找工具。`AttachmentRegistry` 新增 `get_url_by_uid(uid)` 和 `get_uid_by_url(url)` 两个异步方法，并注册为 skills 工具 `attachments.get_url_by_uid` 和 `attachments.get_uid_by_url`。
+
+---
+
 ## v3.4.0 同sender消息合并、数字人格精炼与系统治理
 
 本版本核心解决"用户一口气连发几条消息时，机器人过早开工或只理解最后一句"的问题。新增同 sender 短时消息合并器，将同一会话中连续的多条消息合并为一个"当前输入批次"发送给 AI，由 AI 整批理解哪些是独立请求、哪些是补充或修正。同步支持可取消的投机预发送以降低感知延迟。围绕消息合并，提示词、幽灵任务防御、记忆记录和关闭流程都做了同步适配。此外，精炼了数字人格设定、明确了项目归属边界、重构了管线与命令体系、加入了 HTML 渲染缓存，并增强了 AI 工具调用的稳定性。

{undefined_bot-3.4.0 → undefined_bot-3.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Undefined-bot
-Version: 3.4.0
+Version: 3.4.2
 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
@@ -26,7 +26,6 @@ Requires-Dist: markdown>=3.10
 Requires-Dist: matplotlib
 Requires-Dist: mdit-py-plugins>=0.5.0
 Requires-Dist: numba>=0.61.0
-Requires-Dist: oh-my-bilibili>=0.1.2
 Requires-Dist: openai>=2.30.0
 Requires-Dist: openpyxl>=3.1.5
 Requires-Dist: pillow
@@ -75,7 +74,7 @@ Description-Content-Type: text/markdown
       </div>
       <h3>项目简介</h3>
       <p>
-        <strong>Undefined</strong> 是一个基于 Python 异步架构的高性能 QQ 机器人平台，搭载<strong>认知记忆架构</strong>，采用自研 <strong>Skills</strong> 系统，内置多个智能 Agent，支持代码分析、网络搜索、娱乐互动等多模态能力，并提供 <strong>Management-first WebUI</strong> 在线管理，以及可连接同一管理服务的 <strong>Desktop / Android App</strong>。
+        <strong>Undefined</strong> 是一个基于 Python 异步架构的高性能 QQ 机器人平台，搭载<strong>认知记忆架构</strong>，采用自研 <strong>Skills</strong> 系统，内置多个智能 Agent，支持代码分析、网络搜索、娱乐互动等多模态能力，并提供 <strong>WebUI</strong> 在线管理，以及可连接同一管理服务的 <strong>跨平台 App</strong>。
       </p>
     </td>
   </tr>
@@ -83,6 +82,8 @@ Description-Content-Type: text/markdown
 
 ### _与 [NagaAgent](https://github.com/Xxiii8322766509/NagaAgent) 进行联动！_
 
+> 学业繁忙，暂缓更新至六月下旬，在此期间仅作必要bugfix。
+
 ---
 
 ## ⚡ 立即体验

{undefined_bot-3.4.0 → undefined_bot-3.4.2}/README.md

@@ -15,7 +15,7 @@
       </div>
       <h3>项目简介</h3>
       <p>
-        <strong>Undefined</strong> 是一个基于 Python 异步架构的高性能 QQ 机器人平台，搭载<strong>认知记忆架构</strong>，采用自研 <strong>Skills</strong> 系统，内置多个智能 Agent，支持代码分析、网络搜索、娱乐互动等多模态能力，并提供 <strong>Management-first WebUI</strong> 在线管理，以及可连接同一管理服务的 <strong>Desktop / Android App</strong>。
+        <strong>Undefined</strong> 是一个基于 Python 异步架构的高性能 QQ 机器人平台，搭载<strong>认知记忆架构</strong>，采用自研 <strong>Skills</strong> 系统，内置多个智能 Agent，支持代码分析、网络搜索、娱乐互动等多模态能力，并提供 <strong>WebUI</strong> 在线管理，以及可连接同一管理服务的 <strong>跨平台 App</strong>。
       </p>
     </td>
   </tr>
@@ -23,6 +23,8 @@
 
 ### _与 [NagaAgent](https://github.com/Xxiii8322766509/NagaAgent) 进行联动！_
 
+> 学业繁忙，暂缓更新至六月下旬，在此期间仅作必要bugfix。
+
 ---
 
 ## ⚡ 立即体验

{undefined_bot-3.4.0 → undefined_bot-3.4.2}/config.toml.example

@@ -22,8 +22,8 @@ process_private_message = true
 # zh: 是否响应拍一拍。关闭后拍一拍事件将被忽略。
 # en: Respond to poke events. If disabled, poke events are ignored.
 process_poke_message = true
-# zh: 注入给模型的最近历史消息条数上限（0-200，0 表示不注入历史）。
-# en: Max number of recent messages injected as model context (0-200; 0 disables history injection).
+# zh: 注入给模型的最近历史消息条数（0 表示不注入；无固定上限，受 max_records 与存储约束）。
+# en: Recent messages injected as model context (0 disables; no fixed cap; bounded by max_records/storage).
 context_recent_messages_limit = 20
 # zh: 单次 LLM 请求失败时最大静默重试次数（0=不重试，默认2）。失败的请求会回到原队列的第 2 个位置。
 # en: Max silent retries for a single failed LLM request (0=no retry, default 2). Failed requests are reinserted at position 2 of their original queue lane.
@@ -89,6 +89,10 @@ model_name = ""
 # zh: 最大生成 tokens。
 # en: Max generation tokens.
 max_tokens = 8192
+
+# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
+# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
+context_window_tokens = 32768
 # zh: 队列发车间隔（秒，0 表示立即发车）。
 # en: Queue interval (seconds; 0 dispatches immediately).
 queue_interval_seconds = 1.0
@@ -113,9 +117,15 @@ thinking_include_budget = true
 # zh: reasoning effort 传参风格：openai（reasoning.effort）/ anthropic（output_config.effort）。
 # en: Reasoning effort wire format: openai (reasoning.effort) / anthropic (output_config.effort).
 reasoning_effort_style = "openai"
-# zh: 思维链工具调用兼容：启用后在多轮工具调用中回传 reasoning_content，避免部分模型返回 400。
-# en: Thinking tool-call compatibility: pass back reasoning_content in multi-turn tool calls to avoid 400 errors from some models.
+# zh: 思维链工具调用兼容：多轮工具调用时在本地历史回填 reasoning_content（日志/回放），不向上游续传。
+# en: Thinking tool-call compatibility: locally store reasoning_content in history for multi-turn tool calls (logging/replay), not upstream replay.
 thinking_tool_call_compat = true
+# zh: 多轮工具调用时是否将 CoT 续传给上游（Chat: reasoning_content；Responses: output items）。默认 false。
+# en: Relay chain-of-thought to upstream on multi-turn tool calls (Chat: reasoning_content; Responses: output items). Default false.
+reasoning_content_replay = false
+# zh: 是否将所有 system 提示词合并注入第一条 user 消息（适配不支持 system role 的模型）。默认 false。
+# en: Merge all system prompts into the first user message (for models without system role). Default false.
+system_prompt_as_user = false
 # zh: Responses API 的 tool_choice 兼容模式：仅在关闭时请求仍返回 500、怀疑上游不兼容对象型 tool_choice 时再尝试开启；开启后上报为 "required" 并只保留目标工具。当前已在 new-api v0.11.4-alpha.3 发现该问题。默认关闭。
 # en: Responses API tool_choice compatibility mode: only try enabling this when requests still return 500 with the default setting and you suspect the upstream does not support object-style tool_choice; it sends "required" and keeps only the selected tool. This issue is currently observed on new-api v0.11.4-alpha.3. Disabled by default.
 responses_tool_choice_compat = false
@@ -161,6 +171,10 @@ model_name = ""
 # zh: Vision 模型最大输出 tokens。启用 thinking 时建议设大（如 8192），确保思维链消耗后仍有余量输出工具调用。
 # en: Vision model max output tokens. When thinking is enabled, use a larger value (e.g. 8192) so there is still room for tool-call output after thinking.
 max_tokens = 8192
+
+# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
+# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
+context_window_tokens = 32768
 # zh: 队列发车间隔（秒，0 表示立即发车）。
 # en: Queue interval (seconds; 0 dispatches immediately).
 queue_interval_seconds = 1.0
@@ -185,9 +199,15 @@ thinking_include_budget = true
 # zh: reasoning effort 传参风格：openai（reasoning.effort）/ anthropic（output_config.effort）。
 # en: Reasoning effort wire format: openai (reasoning.effort) / anthropic (output_config.effort).
 reasoning_effort_style = "openai"
-# zh: 思维链工具调用兼容：启用后在多轮工具调用中回传 reasoning_content，避免部分模型返回 400。
-# en: Thinking tool-call compatibility: pass back reasoning_content in multi-turn tool calls to avoid 400 errors from some models.
+# zh: 思维链工具调用兼容：多轮工具调用时在本地历史回填 reasoning_content（日志/回放），不向上游续传。
+# en: Thinking tool-call compatibility: locally store reasoning_content in history for multi-turn tool calls (logging/replay), not upstream replay.
 thinking_tool_call_compat = true
+# zh: 多轮工具调用时是否将 CoT 续传给上游（Chat: reasoning_content；Responses: output items）。默认 false。
+# en: Relay chain-of-thought to upstream on multi-turn tool calls (Chat: reasoning_content; Responses: output items). Default false.
+reasoning_content_replay = false
+# zh: 是否将所有 system 提示词合并注入第一条 user 消息（适配不支持 system role 的模型）。默认 false。
+# en: Merge all system prompts into the first user message (for models without system role). Default false.
+system_prompt_as_user = false
 # zh: Responses API 的 tool_choice 兼容模式：仅在关闭时请求仍返回 500、怀疑上游不兼容对象型 tool_choice 时再尝试开启；开启后上报为 "required" 并只保留目标工具。当前已在 new-api v0.11.4-alpha.3 发现该问题。默认关闭。
 # en: Responses API tool_choice compatibility mode: only try enabling this when requests still return 500 with the default setting and you suspect the upstream does not support object-style tool_choice; it sends "required" and keeps only the selected tool. This issue is currently observed on new-api v0.11.4-alpha.3. Disabled by default.
 responses_tool_choice_compat = false
@@ -223,6 +243,10 @@ model_name = ""
 # zh: 可选限制：最大生成 tokens。
 # en: Optional limit: max generation tokens.
 max_tokens = 100
+
+# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
+# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
+context_window_tokens = 8192
 # zh: 队列发车间隔（秒，0 表示立即发车）。
 # en: Queue interval (seconds; 0 dispatches immediately).
 queue_interval_seconds = 1.0
@@ -247,9 +271,15 @@ thinking_include_budget = true
 # zh: reasoning effort 传参风格：openai（reasoning.effort）/ anthropic（output_config.effort）。
 # en: Reasoning effort wire format: openai (reasoning.effort) / anthropic (output_config.effort).
 reasoning_effort_style = "openai"
-# zh: 思维链工具调用兼容：启用后在多轮工具调用中回传 reasoning_content，避免部分模型返回 400。
-# en: Thinking tool-call compatibility: pass back reasoning_content in multi-turn tool calls to avoid 400 errors from some models.
+# zh: 思维链工具调用兼容：多轮工具调用时在本地历史回填 reasoning_content（日志/回放），不向上游续传。
+# en: Thinking tool-call compatibility: locally store reasoning_content in history for multi-turn tool calls (logging/replay), not upstream replay.
 thinking_tool_call_compat = true
+# zh: 多轮工具调用时是否将 CoT 续传给上游（Chat: reasoning_content；Responses: output items）。默认 false。
+# en: Relay chain-of-thought to upstream on multi-turn tool calls (Chat: reasoning_content; Responses: output items). Default false.
+reasoning_content_replay = false
+# zh: 是否将所有 system 提示词合并注入第一条 user 消息（适配不支持 system role 的模型）。默认 false。
+# en: Merge all system prompts into the first user message (for models without system role). Default false.
+system_prompt_as_user = false
 # zh: Responses API 的 tool_choice 兼容模式：仅在关闭时请求仍返回 500、怀疑上游不兼容对象型 tool_choice 时再尝试开启；开启后上报为 "required" 并只保留目标工具。当前已在 new-api v0.11.4-alpha.3 发现该问题。默认关闭。
 # en: Responses API tool_choice compatibility mode: only try enabling this when requests still return 500 with the default setting and you suspect the upstream does not support object-style tool_choice; it sends "required" and keeps only the selected tool. This issue is currently observed on new-api v0.11.4-alpha.3. Disabled by default.
 responses_tool_choice_compat = false
@@ -284,6 +314,10 @@ model_name = ""
 # zh: 可选限制：最大生成 tokens。
 # en: Optional limit: max generation tokens.
 max_tokens = 160
+
+# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
+# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
+context_window_tokens = 8192
 # zh: 队列发车间隔（秒，0 表示立即发车）。
 # en: Queue interval (seconds; 0 dispatches immediately).
 queue_interval_seconds = 1.0
@@ -308,9 +342,15 @@ thinking_include_budget = true
 # zh: reasoning effort 传参风格：openai（reasoning.effort）/ anthropic（output_config.effort）。
 # en: Reasoning effort wire format: openai (reasoning.effort) / anthropic (output_config.effort).
 reasoning_effort_style = "openai"
-# zh: 思维链工具调用兼容：启用后在多轮工具调用中回传 reasoning_content，避免部分模型返回 400。
-# en: Thinking tool-call compatibility: pass back reasoning_content in multi-turn tool calls to avoid 400 errors from some models.
+# zh: 思维链工具调用兼容：多轮工具调用时在本地历史回填 reasoning_content（日志/回放），不向上游续传。
+# en: Thinking tool-call compatibility: locally store reasoning_content in history for multi-turn tool calls (logging/replay), not upstream replay.
 thinking_tool_call_compat = true
+# zh: 多轮工具调用时是否将 CoT 续传给上游（Chat: reasoning_content；Responses: output items）。默认 false。
+# en: Relay chain-of-thought to upstream on multi-turn tool calls (Chat: reasoning_content; Responses: output items). Default false.
+reasoning_content_replay = false
+# zh: 是否将所有 system 提示词合并注入第一条 user 消息（适配不支持 system role 的模型）。默认 false。
+# en: Merge all system prompts into the first user message (for models without system role). Default false.
+system_prompt_as_user = false
 # zh: Responses API 的 tool_choice 兼容模式。
 # en: Responses API tool_choice compatibility mode.
 responses_tool_choice_compat = false
@@ -340,6 +380,10 @@ model_name = ""
 # zh: 可选限制：最大生成 tokens。
 # en: Optional limit: max generation tokens.
 max_tokens = 4096
+
+# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
+# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
+context_window_tokens = 32768
 # zh: 队列发车间隔（秒，0 表示立即发车）。
 # en: Queue interval (seconds; 0 dispatches immediately).
 queue_interval_seconds = 1.0
@@ -364,9 +408,15 @@ thinking_include_budget = true
 # zh: reasoning effort 传参风格：openai（reasoning.effort）/ anthropic（output_config.effort）。
 # en: Reasoning effort wire format: openai (reasoning.effort) / anthropic (output_config.effort).
 reasoning_effort_style = "openai"
-# zh: 思维链工具调用兼容：启用后在多轮工具调用中回传 reasoning_content，避免部分模型返回 400。
-# en: Thinking tool-call compatibility: pass back reasoning_content in multi-turn tool calls to avoid 400 errors from some models.
+# zh: 思维链工具调用兼容：多轮工具调用时在本地历史回填 reasoning_content（日志/回放），不向上游续传。
+# en: Thinking tool-call compatibility: locally store reasoning_content in history for multi-turn tool calls (logging/replay), not upstream replay.
 thinking_tool_call_compat = true
+# zh: 多轮工具调用时是否将 CoT 续传给上游（Chat: reasoning_content；Responses: output items）。默认 false。
+# en: Relay chain-of-thought to upstream on multi-turn tool calls (Chat: reasoning_content; Responses: output items). Default false.
+reasoning_content_replay = false
+# zh: 是否将所有 system 提示词合并注入第一条 user 消息（适配不支持 system role 的模型）。默认 false。
+# en: Merge all system prompts into the first user message (for models without system role). Default false.
+system_prompt_as_user = false
 # zh: Responses API 的 tool_choice 兼容模式：仅在关闭时请求仍返回 500、怀疑上游不兼容对象型 tool_choice 时再尝试开启；开启后上报为 "required" 并只保留目标工具。当前已在 new-api v0.11.4-alpha.3 发现该问题。默认关闭。
 # en: Responses API tool_choice compatibility mode: only try enabling this when requests still return 500 with the default setting and you suspect the upstream does not support object-style tool_choice; it sends "required" and keeps only the selected tool. This issue is currently observed on new-api v0.11.4-alpha.3. Disabled by default.
 responses_tool_choice_compat = false
@@ -412,6 +462,10 @@ model_name = ""
 # zh: 可选限制：最大生成 tokens。
 # en: Optional limit: max generation tokens.
 max_tokens = 4096
+
+# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
+# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
+context_window_tokens = 32768
 # zh: 队列发车间隔（秒，0 表示立即发车）。
 # en: Queue interval (seconds; 0 dispatches immediately).
 queue_interval_seconds = 1.0
@@ -436,9 +490,15 @@ thinking_include_budget = true
 # zh: reasoning effort 传参风格：openai（reasoning.effort）/ anthropic（output_config.effort）。
 # en: Reasoning effort wire format: openai (reasoning.effort) / anthropic (output_config.effort).
 reasoning_effort_style = "openai"
-# zh: 思维链工具调用兼容：启用后在多轮工具调用中回传 reasoning_content，避免部分模型返回 400。
-# en: Thinking tool-call compatibility: pass back reasoning_content in multi-turn tool calls to avoid 400 errors from some models.
+# zh: 思维链工具调用兼容：多轮工具调用时在本地历史回填 reasoning_content（日志/回放），不向上游续传。
+# en: Thinking tool-call compatibility: locally store reasoning_content in history for multi-turn tool calls (logging/replay), not upstream replay.
 thinking_tool_call_compat = true
+# zh: 多轮工具调用时是否将 CoT 续传给上游（Chat: reasoning_content；Responses: output items）。默认 false。
+# en: Relay chain-of-thought to upstream on multi-turn tool calls (Chat: reasoning_content; Responses: output items). Default false.
+reasoning_content_replay = false
+# zh: 是否将所有 system 提示词合并注入第一条 user 消息（适配不支持 system role 的模型）。默认 false。
+# en: Merge all system prompts into the first user message (for models without system role). Default false.
+system_prompt_as_user = false
 # zh: Responses API 的 tool_choice 兼容模式：仅在关闭时请求仍返回 500、怀疑上游不兼容对象型 tool_choice 时再尝试开启；开启后上报为 "required" 并只保留目标工具。当前已在 new-api v0.11.4-alpha.3 发现该问题。默认关闭。
 # en: Responses API tool_choice compatibility mode: only try enabling this when requests still return 500 with the default setting and you suspect the upstream does not support object-style tool_choice; it sends "required" and keeps only the selected tool. This issue is currently observed on new-api v0.11.4-alpha.3. Disabled by default.
 responses_tool_choice_compat = false
@@ -456,8 +516,8 @@ stream_enabled = false
 # en: Extra request-body params (optional), e.g. temperature or vendor-specific fields.
 [models.historian.request_params]
 
-# zh: 消息总结模型配置（/summary /sum 专用；未配置时回退到 agent 模型）。
-# en: Message-summary model config (used by /summary and /sum; falls back to the agent model when unset).
+# zh: 消息总结模型配置（/summary /sum 与 SummaryService 专用；未配置时回退到 agent 模型；主 AI 调用 summary_agent 不使用此段配置）。
+# en: Message-summary model config (used by /summary, /sum, and SummaryService; falls back to the agent model when unset; summary_agent invoked by the main AI does not use this section).
 [models.summary]
 # zh: OpenAI-compatible 基址 URL，例如 https://api.openai.com/v1（legacy "/chat/completions" 已弃用但仍兼容）。
 # en: OpenAI-compatible base URL, e.g. https://api.openai.com/v1. Note: legacy "/chat/completions" is deprecated but still supported.
@@ -471,6 +531,10 @@ model_name = ""
 # zh: 可选限制：最大生成 tokens。
 # en: Optional limit: max generation tokens.
 max_tokens = 4096
+
+# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
+# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
+context_window_tokens = 32768
 # zh: 队列发车间隔（秒，0 表示立即发车）。
 # en: Queue interval (seconds; 0 dispatches immediately).
 queue_interval_seconds = 1.0
@@ -495,9 +559,15 @@ thinking_include_budget = true
 # zh: reasoning effort 传参风格：openai（reasoning.effort）/ anthropic（output_config.effort）。
 # en: Reasoning effort wire format: openai (reasoning.effort) / anthropic (output_config.effort).
 reasoning_effort_style = "openai"
-# zh: 思维链工具调用兼容：启用后在多轮工具调用中回传 reasoning_content，避免部分模型返回 400。
-# en: Thinking tool-call compatibility: pass back reasoning_content in multi-turn tool calls to avoid 400 errors from some models.
+# zh: 思维链工具调用兼容：多轮工具调用时在本地历史回填 reasoning_content（日志/回放），不向上游续传。
+# en: Thinking tool-call compatibility: locally store reasoning_content in history for multi-turn tool calls (logging/replay), not upstream replay.
 thinking_tool_call_compat = true
+# zh: 多轮工具调用时是否将 CoT 续传给上游（Chat: reasoning_content；Responses: output items）。默认 false。
+# en: Relay chain-of-thought to upstream on multi-turn tool calls (Chat: reasoning_content; Responses: output items). Default false.
+reasoning_content_replay = false
+# zh: 是否将所有 system 提示词合并注入第一条 user 消息（适配不支持 system role 的模型）。默认 false。
+# en: Merge all system prompts into the first user message (for models without system role). Default false.
+system_prompt_as_user = false
 # zh: Responses API 的 tool_choice 兼容模式：仅在关闭时请求仍返回 500、怀疑上游不兼容对象型 tool_choice 时再尝试开启；开启后上报为 "required" 并只保留目标工具。默认关闭。
 # en: Responses API tool_choice compatibility mode: only try enabling this when requests still return 500 with the default setting and you suspect the upstream does not support object-style tool_choice; it sends "required" and keeps only the selected tool. Disabled by default.
 responses_tool_choice_compat = false
@@ -530,6 +600,10 @@ model_name = ""
 # zh: 可选限制：最大生成 tokens。
 # en: Optional limit: max generation tokens.
 max_tokens = 8192
+
+# zh: 模型上下文窗口上限（token），用于 /summary 分块与 Prompt 预算；须与上游模型能力一致。
+# en: Model context window cap (tokens) for /summary chunking and prompt budgeting; must match upstream capability.
+context_window_tokens = 32768
 # zh: 队列发车间隔（秒，0 表示立即发车）。
 # en: Queue interval (seconds; 0 dispatches immediately).
 queue_interval_seconds = 1.0
@@ -574,6 +648,10 @@ api_key = ""
 # zh: Embedding 模型名称。
 # en: Embedding model name.
 model_name = ""
+
+# zh: 模型上下文窗口上限（token，可选）；嵌入/重排场景通常保持默认即可。
+# en: Model context window cap (tokens, optional); embedding/rerank can usually keep the default.
+context_window_tokens = 8192
 # zh: 队列发车间隔（秒，0 表示立即发车）。
 # en: Queue interval (seconds; 0 dispatches immediately).
 queue_interval_seconds = 0.0
@@ -603,6 +681,10 @@ api_key = ""
 # zh: Rerank 模型名称。
 # en: Rerank model name.
 model_name = ""
+
+# zh: 模型上下文窗口上限（token，可选）；嵌入/重排场景通常保持默认即可。
+# en: Model context window cap (tokens, optional); embedding/rerank can usually keep the default.
+context_window_tokens = 8192
 # zh: 队列发车间隔（秒，0 表示立即发车）。
 # en: Queue interval (seconds; 0 dispatches immediately).
 queue_interval_seconds = 0.0
@@ -812,11 +894,11 @@ filtered_result_limit = 200
 # zh: 工具过滤搜索时扫描的最大消息条数。
 # en: Max messages to scan when tools perform filtered searches.
 search_scan_limit = 10000
-# zh: 总结 agent 单次拉取的最大消息条数。
-# en: Max messages the summary agent can fetch per call.
+# zh: /summary 按条数拉取时的最大消息条数（可配置，无固定 500 上限；受 max_records 约束）。
+# en: Max messages fetched per /summary count request (configurable; no fixed 500 cap; bounded by max_records).
 summary_fetch_limit = 1000
-# zh: 总结 agent 按时间范围查询时的最大拉取条数。
-# en: Max messages the summary agent fetches for time-range queries.
+# zh: /summary 按时间范围查询时的最大扫描条数（可配置）。
+# en: Max messages scanned for /summary time-range queries (configurable).
 summary_time_fetch_limit = 5000
 # zh: OneBot API 回退获取的最大消息条数。
 # en: Max messages to fetch via OneBot API fallback.
@@ -831,6 +913,21 @@ group_analysis_limit = 500
 # zh: 远程附件自动下载并缓存的最大大小（MB）。超过上限或设为 0 时只保留 URL 引用，不下载文件内容。
 # en: Max remote attachment size (MB) to download into cache. Above the limit, or 0, keeps only a URL reference.
 remote_download_max_size_mb = 25
+# zh: 附件缓存文件总大小上限（MB）。0 表示不按总容量清理；达到上限时优先删除最旧的本地缓存副本，若记录有 URL 则保留 UID 与 URL 以便后续回源。
+# en: Total attachment cache file size limit (MB). 0 disables total-size pruning; when exceeded, oldest local cache copies are removed while URL-backed UIDs keep their URL for later re-download.
+cache_max_total_size_mb = 0
+# zh: 附件登记记录最大数量。0 表示不限制数量。
+# en: Max attachment registry records. 0 disables record-count pruning.
+cache_max_records = 2000
+# zh: 附件本地缓存最长保留天数。0 表示不按时间清理；有 URL 的记录只删除本地副本并保留 UID/URL，无 URL 的老记录会被删除。
+# en: Max local attachment cache age in days. 0 disables age-based pruning; URL-backed records keep UID/URL while their local copy is removed, records without URL are deleted.
+cache_max_age_days = 7
+# zh: 仅 URL 引用的附件记录最大数量。0 表示不限制。
+# en: Max URL-only attachment reference records. 0 disables URL-reference-count pruning.
+url_reference_max_records = 2000
+# zh: 允许登记的远程附件 URL 最大长度。0 表示不限制长度。
+# en: Max remote attachment URL length. 0 disables URL length checks.
+url_max_length = 8192
 
 # zh: Skills 热重载配置（可选）。
 # en: Skills hot reload settings (optional).
@@ -1013,6 +1110,15 @@ max_file_size = 100
 # zh: 超限策略: "downgrade"=降低清晰度重试, "info"=发送封面+标题+简介。
 # en: Oversize strategy: "downgrade"=retry at lower quality, "info"=send cover+title+description.
 oversize_strategy = "downgrade"
+# zh: 是否在自动提取合并转发中附带弹幕。
+# en: Include danmaku in the auto-extraction merged-forward message.
+danmaku_enabled = true
+# zh: 每个内层弹幕合并转发包含的弹幕条数。
+# en: Number of danmaku messages per nested forward group.
+danmaku_batch_size = 100
+# zh: 最多提取多少条弹幕，0=不限。
+# en: Max danmaku count to extract. 0=unlimited.
+danmaku_max_count = 0
 # zh: 自动提取功能的群聊白名单（空=跟随全局 access.allowed_group_ids）。
 # en: Group allowlist for auto-extraction (empty = follow global access.allowed_group_ids).
 auto_extract_group_ids = []

{undefined_bot-3.4.0 → undefined_bot-3.4.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "Undefined-bot"
-version = "3.4.0"
+version = "3.4.2"
 description = "QQ bot platform with cognitive memory architecture and multi-agent Skills, via OneBot V11."
 readme = "README.md"
 authors = [
@@ -45,7 +45,6 @@ dependencies = [
     "psutil>=7.2.2",
     "pyyaml>=6.0.3",
     "pypinyin>=0.53.0",
-    "oh-my-bilibili>=0.1.2",
     "chromadb>=1.5.5",
     "numba>=0.61.0",
 ]

{undefined_bot-3.4.0 → undefined_bot-3.4.2}/res/IMPORTANT/each.md

@@ -1,7 +1,7 @@
 <rule num="0" priority="P0" id="严防并发导致的重复">
   <step num="1">明确你这轮的目标（例如：写一个文章；对本条消息/当前输入批次做出合适回应等）或是最后产生的结果或进行的调用（例如：会产生一条消息；会调用某个agent等）</step>
-  <step num="2">回看当前输入批次之外的历史消息，确认不会有旧消息线程导致你产生同样的目标、结果或调用。若有，立刻停止所有操作！！！改为根据情景发送应付性回答（例如："在做了在做了"等）。</step>
-  <MUST priority="P0">以上步骤**必须**在进行任何操作之前进行执行、判断！！始终遵循规则：幽灵任务绝对隔离！！以前的消息仅做辅助判断和上下文补全，不要因为乐于助人处理之前消息列表里的任何消息！哪怕它是你必须要执行、处理的或没有回复！！以下规则仅适用于当前消息/当前输入批次，对以前消息不作数！！！</MUST>
+  <step num="2">回看当前输入批次之外的历史消息，扫描相同或语义等价的工具/Agent 调用或消息发送；若已在处理或已完成，立刻停止所有操作！！！改为根据情景发送应付性回答（例如："在做了在做了"、"已经在处理了"等）。</step>
+  <MUST priority="P0">以上步骤**必须**在进行任何操作之前进行执行、判断！！始终遵循规则：幽灵任务绝对隔离！！以前的消息仅做辅助判断和上下文补全，不要因为乐于助人处理之前消息列表里的任何消息！哪怕它是你必须要执行、处理的或没有回复！！「催促」「在吗」「好了吗」不等于新任务或重做许可；历史未完成任务永不自动拾取，除非当前输入批次明确重新发起并给出完整参数。以下规则仅适用于当前消息/当前输入批次，对以前消息不作数！！！</MUST>
 </rule>
 
 <current_input_batch_definition priority="P0">
@@ -15,7 +15,7 @@
 <pre_action_mandatory_check priority="P0">
   **发信息前或调用任何工具前的必须判断（每次操作前强制执行）：**
   1. 明确本次操作的目标：将发送的消息内容 / 将调用的工具及参数
-  2. 回看当前输入批次之外的历史消息，确认不会有旧消息线程导致你（bot）产生同样的工具调用或内容相似的消息发送
+  2. 回看当前输入批次之外的历史消息，扫描相同或语义等价的工具/Agent 调用或相似消息发送
      - 若无 → 允许继续
-     - 若有 → **立刻停止所有操作！！！** 改为根据情景发送应付性回答（例如："在做了在做了"、"已经在处理了"等），然后调用 end。不可以发送临时的、不过脑子的错误回复！
+     - 若有 → **硬性熔断**：立刻停止所有业务工具/Agent，仅口头回应（例如："在做了在做了"、"已经在处理了"等），然后调用 end。不可以发送临时的、不过脑子的错误重跑！
 </pre_action_mandatory_check>

{undefined_bot-3.4.0 → undefined_bot-3.4.2}/res/prompts/historian_profile_merge.md

@@ -57,12 +57,16 @@
 7. **核心画像要抓独特性**：第一句要写出"这个人区别于其他人的本质"，而非通用描述（如"开发者"太泛，"把系统当产线打理的工程型开发者"才有辨识度）
 8. 若 `current_profile` 本身不符合以上规范，可直接整体重写为合规版本（不必保留其原有写法）
 
+侧写 = **长期高层画像**：只保留身份、风格、偏好、能力等核心抽象，应能脱离具体聊天记录独立理解「这个人/群是谁」，而非「他做了什么」。
+
 严禁写入以下内容（这些属于事件记忆，不应进入侧写）：
-- 某次/近期/今天/昨天的具体经过
+- 任何具体事件、时间线、单次对话经过
+- 某次/近期/今天/昨天/「曾/刚/最近」类时序描述
 - 具体数字统计（如 token 消耗、日均、高峰值）
 - 具体分支名、提交细节、安装排障步骤、一次性报错
 - "曾讨论/刚确认/近期提及/某次分享"等时序性描述
 
+若新信息仅为一次性事件、无法提炼为稳定特征，必须 `skip=true`。
 若本轮只有事件细节、无法抽象为长期稳定特征，必须 `skip=true`。
 
 `summary` 输出格式约束：

undefined_bot-3.4.2/res/prompts/merge_message_summaries.txt

@@ -0,0 +1,12 @@
+下方是用「---」分隔的多段聊天总结。它们来自同一段较长聊天记录的不同片段，可能存在少量重复。
+
+请合并为一份完整、去重后的总结。
+
+要求：
+- 只能综合各分段中已出现的信息，不得新增分段里没有的内容
+- 去除重复表述，保留关键话题、事实、链接与结论
+- 不要编造参与者、决策、待办或链接
+- 使用 2 到 4 个短段落，朴素中文，不要 emoji，不要 markdown
+- 直接输出合并后的总结正文，不要说明合并过程
+
+分段总结如下：

undefined_bot-3.4.2/res/prompts/message_summary.txt

@@ -0,0 +1,33 @@
+你是一个聊天消息总结助手。你的唯一信息来源是用户提供的原始聊天记录。
+
+## 核心原则（必须遵守）
+1. **只读原始记录**：只能依据 `<message>` 块及其中的 `<content>` 总结；不得使用训练知识、常识推断或想象补全。
+2. **禁止编造**：不得虚构或猜测未在记录中出现的参与者、昵称、QQ 号、链接、文件、代码、决策、共识、待办、结论、时间线或因果关系。
+3. **信息不足就明说**：某类信息在记录里没有时，直接省略；不要写「可能」「大概」「应该是」；必要时可写「消息中未提及」。
+4. **不要复述原文**：不要大段复制聊天记录，不要输出 XML/HTML/JSON，不要逐条翻译消息。
+5. **不要元评论**：不要描述「我将如何总结」「以上是对 N 条消息的总结」等过程性文字；直接给出总结正文。
+
+## 如何阅读输入
+- 每条 `<message>` 代表一条历史消息；正文在 `<content>` 内。
+- `sender` / `sender_id` / `time` / `group_name` 等属性仅用于识别发言者与时间，不要把属性值当成额外事实来源。
+- 若记录主要是表情、短回复、复读、寒暄或无效内容，简要说明即可，不要强行提炼「深度话题」。
+- 忽略与聊天内容无关的系统说明、占位文本或格式标记。
+
+## 总结内容（按需选取，有则写、无则跳过）
+- 主要讨论话题（可多个，按重要性排序）
+- 明确出现的事实、请求、答复、约定或结论
+- 记录里真实出现的重要链接、命令、文件名、错误信息
+- 若用户指定了重点关注方向，优先覆盖该方向，但仍不得超出记录范围
+
+## 输出格式
+- 使用 2 到 4 个短段落，朴素中文叙述
+- 不要使用 emoji
+- 不要使用复杂 markdown（不要列表、标题，可以使用 - ）
+- 保持客观中立，信息密度高，避免流水账
+- 没有实质内容时，用一两句话说明「消息中主要是……，未涉及具体议题」
+
+## 禁止输出
+- 编造的待办、决策、项目进展、人物关系
+- 对聊天意图的心理揣测
+- 工具调用、函数名、JSON、XML 片段
+- 英文模板句或与记录无关的套话