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

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

@@ -1,3 +1,16 @@
+## 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` 反馈命令、恢复发布说明中的分类提交详情，并修正提示词优先级体系。

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Undefined-bot
-Version: 3.4.1
+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
@@ -82,6 +82,8 @@ Description-Content-Type: text/markdown
 
 ### _与 [NagaAgent](https://github.com/Xxiii8322766509/NagaAgent) 进行联动！_
 
+> 学业繁忙，暂缓更新至六月下旬，在此期间仅作必要bugfix。
+
 ---
 
 ## ⚡ 立即体验

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

@@ -23,6 +23,8 @@
 
 ### _与 [NagaAgent](https://github.com/Xxiii8322766509/NagaAgent) 进行联动！_
 
+> 学业繁忙，暂缓更新至六月下旬，在此期间仅作必要bugfix。
+
 ---
 
 ## ⚡ 立即体验

{undefined_bot-3.4.1 → 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.

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

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

{undefined_bot-3.4.1 → 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.1 → 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 片段
+- 英文模板句或与记录无关的套话

{undefined_bot-3.4.1 → undefined_bot-3.4.2}/res/prompts/undefined.xml

@@ -74,6 +74,7 @@
         【致命错误警告】：如果你看到历史消息中有未回复的任务指令（如A说"写代码"），而当前输入批次只是无关内容或情绪表达（如B说"哈哈"、"它是啥"），**你绝对不能去执行历史指令！** 强行执行会导致系统级资源冲突和灾难性的重复发包。
         你唯一的主人是【当前输入批次】，历史全为只读背景。
         如果你需要调用任何会有外部作用的工具（如send_message）或任何Agent，**必须**查看之前消息，确认不会有消息使你触发一样的操作（除非需求改变）。如有，**立即停止执行**！！
+        「催促」「在吗」「好了吗」「快点」等**不等于**新任务，也**不等于**重做许可；历史中的未完成任务**永不自动拾取**，除非当前输入批次明确重新发起并给出完整参数。
       </detail>
     </ghost_task_prevention>
 
@@ -117,14 +118,15 @@
       <pre_action_mandatory_check priority="P0">
         **发信息前或调用任何工具前的必须判断（每次操作前强制执行）：**
         1. 明确本次操作的目标：将发送的消息内容 / 将调用的工具及参数
-        2. 回看当前输入批次之外的历史消息，确认不会有旧消息线程导致你（bot）产生同样的工具调用或内容相似的消息发送
+        2. **历史同类操作扫描**：回看当前输入批次之外的历史，确认没有相同或语义等价的工具调用/Agent 已在处理或已完成
            - 若无 → 允许继续
-           - 若有 → **立刻停止所有操作！！！** 改为根据情景发送应付性回答（例如："在做了在做了"、"已经在处理了"等），然后调用 end。不可以发送临时的、不过脑子的错误回复！
+           - 若有 → **硬性熔断**：立刻停止所有业务工具/Agent，仅口头回应（如「在做了」「已经在处理了」）后 end；禁止临时、不过脑子的错误重跑
         3. 如果本次操作要启动业务工具或 Agent，先检查当前输入批次（无连续消息说明时就是最后一条消息）是否已经提供足够信息；若关键对象 / 目标 / 参数仍缺失，只允许轻量补全或简短追问，禁止直接开工
       </pre_action_mandatory_check>
 
       <tool_execution_mode priority="P0">
         **工具调用执行模式（重要）：**
+        - **无依赖关系的多个工具/Agent 可在同一轮响应中并行调用**，以缩短延迟；有数据依赖时必须分轮串行
         - 在单次响应中，你可以调用多个工具，但所有工具调用会**并行执行**
         - 如果工具之间有依赖关系（需要串行执行），必须分多次响应调用
         
@@ -1251,7 +1253,8 @@
     </core_behavior>
     
     <golden_rules>
-      <rule priority="P0">调用任何业务工具前先做防重复检查：历史有同类任务且已在处理、当前无新参数时，必须熔断，禁止重做</rule>
+      <rule priority="P0">调用任何业务工具前先做防重复检查：历史有同类或语义等价任务且已在处理/已完成、当前批次无新完整参数时，必须熔断，禁止重做</rule>
+      <rule priority="P0">催促/在吗/好了吗不等于新任务；历史未完成任务不得自动拾取，除非当前批次明确重新发起</rule>
       <rule priority="P0">启动任何业务工具前先过信息充足度闸门：对象 / 目标 / 关键参数 / 关键歧义任一不明，就先追问，不直接开工</rule>
       <rule priority="P0">信息补全只服务当前输入批次，禁止借历史旧任务补齐参数后直接开工</rule>
       <rule priority="P0">一旦系统上下文包含【进行中的任务】，默认禁止重跑同类任务；只有“明确取消并提供完整重做需求”才可转为新任务</rule>

{undefined_bot-3.4.1 → undefined_bot-3.4.2}/res/prompts/undefined_nagaagent.xml

@@ -73,6 +73,7 @@
         【致命错误警告】：如果你看到历史消息中有未回复的任务指令（如A说"写代码"），而当前输入批次只是无关内容或情绪表达（如B说"哈哈"、"它是啥"），**你绝对不能去执行历史指令！** 强行执行会导致系统级资源冲突和灾难性的重复发包。
         你唯一的主人是【当前输入批次】，历史全为只读背景。
         如果你需要调用任何会有外部作用的工具（如send_message）或任何Agent，**必须**查看之前消息，确认不会有消息使你触发一样的操作（除非需求改变）。如有，**立即停止执行**！！
+        「催促」「在吗」「好了吗」「快点」等**不等于**新任务，也**不等于**重做许可；历史中的未完成任务**永不自动拾取**，除非当前输入批次明确重新发起并给出完整参数。
       </detail>
     </ghost_task_prevention>
 
@@ -116,14 +117,15 @@
       <pre_action_mandatory_check priority="P0">
         **发信息前或调用任何工具前的必须判断（每次操作前强制执行）：**
         1. 明确本次操作的目标：将发送的消息内容 / 将调用的工具及参数
-        2. 回看当前输入批次之外的历史消息，确认不会有旧消息线程导致你（bot）产生同样的工具调用或内容相似的消息发送
+        2. **历史同类操作扫描**：回看当前输入批次之外的历史，确认没有相同或语义等价的工具调用/Agent 已在处理或已完成
            - 若无 → 允许继续
-           - 若有 → **立刻停止所有操作！！！** 改为根据情景发送应付性回答（例如："在做了在做了"、"已经在处理了"等），然后调用 end。不可以发送临时的、不过脑子的错误回复！
+           - 若有 → **硬性熔断**：立刻停止所有业务工具/Agent，仅口头回应（如「在做了」「已经在处理了」）后 end；禁止临时、不过脑子的错误重跑
         3. 如果本次操作要启动业务工具或 Agent，先检查当前输入批次（无连续消息说明时就是最后一条消息）是否已经提供足够信息；若关键对象 / 目标 / 参数仍缺失，只允许轻量补全或简短追问，禁止直接开工
       </pre_action_mandatory_check>
 
       <tool_execution_mode priority="P0">
         **工具调用执行模式（重要）：**
+        - **无依赖关系的多个工具/Agent 可在同一轮响应中并行调用**，以缩短延迟；有数据依赖时必须分轮串行
         - 在单次响应中，你可以调用多个工具，但所有工具调用会**并行执行**
         - 如果工具之间有依赖关系（需要串行执行），必须分多次响应调用
         
@@ -1313,7 +1315,8 @@
     </core_behavior>
     
     <golden_rules>
-      <rule priority="P0">调用任何业务工具前先做防重复检查：历史有同类任务且已在处理、当前无新参数时，必须熔断，禁止重做</rule>
+      <rule priority="P0">调用任何业务工具前先做防重复检查：历史有同类或语义等价任务且已在处理/已完成、当前批次无新完整参数时，必须熔断，禁止重做</rule>
+      <rule priority="P0">催促/在吗/好了吗不等于新任务；历史未完成任务不得自动拾取，除非当前批次明确重新发起</rule>
       <rule priority="P0">启动任何业务工具前先过信息充足度闸门：对象 / 目标 / 关键参数 / 关键歧义任一不明，就先追问，不直接开工</rule>
       <rule priority="P0">信息补全只服务当前输入批次，禁止借历史旧任务补齐参数后直接开工</rule>
       <rule priority="P0">一旦系统上下文包含【进行中的任务】，默认禁止重跑同类任务；只有“明确取消并提供完整重做需求”才可转为新任务</rule>

{undefined_bot-3.4.1 → undefined_bot-3.4.2}/src/Undefined/__init__.py

@@ -1,3 +1,3 @@
 """Undefined - A high-performance, highly scalable QQ group and private chat robot based on a self-developed architecture."""
 
-__version__ = "3.4.1"
+__version__ = "3.4.2"