Undefined-bot 3.11.0__tar.gz → 3.12.0__tar.gz

{undefined_bot-3.11.0 → undefined_bot-3.12.0}/ARCHITECTURE.md

@@ -158,13 +158,13 @@ graph TB
             EndSummaryStorage["EndSummaryStorage<br/>短期总结存储<br/>[end_summary_storage.py]"]
             CognitiveService["CognitiveService<br/>认知记忆服务<br/>[cognitive/service/]<br/>• 事件检索 • 侧写读取<br/>• 入队 memory job"]
             CognitiveJobQueue["JobQueue<br/>认知任务队列<br/>[cognitive/job_queue.py]<br/>• pending/processing/failed"]
-            CognitiveHistorian["HistorianWorker<br/>后台史官<br/>[cognitive/historian/]<br/>• 绝对化改写 • 闸门重试<br/>• 侧写合并（含历史事件注入）"]
+            CognitiveHistorian["HistorianWorker<br/>后台史官<br/>[cognitive/historian/]<br/>• 独立事实改写 • 闸门重试<br/>• 侧写合并（最新优先/去冗）"]
             CognitiveVectorStore["CognitiveVectorStore<br/>向量存储<br/>[cognitive/vector_store.py]<br/>• events/profiles<br/>• 时间衰减加权排序<br/>• MMR 去重"]
             CognitiveProfileStorage["ProfileStorage<br/>侧写存储<br/>[cognitive/profile_storage.py]<br/>• users/groups Markdown<br/>• 历史快照"]
             MemeSystem["MemeSystem<br/>表情包存储<br/>[memes/]<br/>• worker.py (两阶段识别)<br/>• sqlite+chromadb<br/>• blob 持久化"]
             FAQStorage["FAQStorage<br/>FAQ 存储<br/>[faq.py]<br/>• data/faq/{group_id}/"]
             ScheduledTaskStorage["ScheduledTaskStorage<br/>定时任务存储<br/>[scheduled_task_storage.py]"]
-            TokenUsageStorage["TokenUsageStorage<br/>Token 使用统计<br/>[token_usage_storage.py]<br/>• 自动归档<br/>• gzip 压缩"]
+            TokenUsageStorage["TokenUsageStorage<br/>Token 使用统计<br/>[token_usage_storage.py]<br/>• 自动归档<br/>• gzip 压缩<br/>• 流式可选 TTFT/TPS"]
         end
         
         subgraph IOLayer["异步 IO 层 (src/Undefined/utils/)"]
@@ -573,7 +573,7 @@ graph LR
             CognitiveProfile["ProfileStorage<br/>data/cognitive/profiles/"]
             FAQ["FAQStorage<br/>data/faq/{group_id}/<br/>• ID: YYYYMMDD-NNN"]
             Tasks["ScheduledTaskStorage<br/>data/scheduled_tasks.json<br/>• Cron 格式"]
-            TokenUsage["TokenUsageStorage<br/>data/token_usage.jsonl<br/>• 自动归档<br/>• gzip 压缩"]
+            TokenUsage["TokenUsageStorage<br/>data/token_usage.jsonl<br/>• 自动归档<br/>• gzip 压缩<br/>• 流式可选 TTFT/TPS"]
         end
         
         subgraph Persistence["持久化"]

{undefined_bot-3.11.0 → undefined_bot-3.12.0}/CHANGELOG.md

@@ -1,3 +1,29 @@
+## v3.12.0 斜杠命令查询、四段侧写与对外发言边界
+
+本版本让主 AI 能查询斜杠命令并按视角过滤，把用户/群侧写拆成评价、正文、锐评并改进 `/profile` 出图；同时收紧对外说话方式，避免客服腔、内部工具名和假装能改实现。安全模型在可重试 HTTP 错误时沿用现有重试次数。
+
+- 主 AI 系统提示注入当前发送者可用的斜杠命令摘要；新增 `commands.search` / `commands.get`，默认查全集（纯文本匹配，不接 RAG），也可按群或用户视角过滤。介绍命令时注明权限，不代替用户发送斜杠命令。
+- 侧写文件改为四段：`---元数据---评价---正文---锐评`。史官 `update_profile` 用评价、正文、锐评三个独立字段写入；锐评要毒、准、短，不能写成第二条评价；缺段、空段或格式不合规时必须重写，不能 skip。
+- `/profile` 默认图片改为 YAML 键值表、独立评价块、锐评和 Markdown 正文；锐评紧挨评价、在长正文之前。
+- 对外按 QQ 群友说话：单条消息少空行，禁止客服式接工单和「按你的要求改」；对方没先说内部工具名就不要抛。这些是自己调用的能力，只能填参数，实现来自开源仓库。闲聊默认不提起创造者或仓库所有者；被问及时说明开源协作，代码不一定全是仓库所有者写的。
+- 需求明确时直接调用已暴露的工具，不再征求「要不要用工具」；不回复时只调用 `end`，禁止把闸门结论和规则自检发到聊天。
+- 静默填写 `end.memo` 时，拒绝话术不再把发消息当成默认动作：该回则先发，不回则 `force=true`，禁止为通过检查去补发。
+- 安全模型的注入检测、Naga 审核与注入回复遇到 HTTP 429/5xx 时按 `[core].ai_request_max_retries` 重试；注入检测在重试耗尽后仍失败则按检测到注入处理。
+
+---
+
+## v3.11.1 史官记忆质量与流式调用指标
+
+本版本围绕认知记忆质量与 LLM 可观测性做了针对性优化：史官侧写以最新事实为准并克制膨胀，事件改写提炼为带时间锚点的独立事实，`end.observations` 只保留值得日后检索的写实内容；流式模型调用额外记录首字延迟与生成吞吐。
+
+- 优化史官侧写合并。合并时注入当前时刻与旧侧写 `updated_at`，稳定特征冲突时以当前输入批次为准覆盖过时内容；时间只用于判断取舍，侧写正文仍禁止写入时序描述。
+- 引导侧写克制扩写、合并去冗。同维度复述会合并或覆盖，边缘或一次性特征可省略，过长条目会压缩重组；不设硬字数，由提示词按上下文灵活判断。
+- 改进史官事件改写。在绝对化（消灭代词、相对时间、相对地点）基础上，尽量把“谁说了什么”提炼为带时间锚点的独立事实（如“张三在某时改用了 Rust”）；言说行为本身才是要点、未兑现承诺、玩笑或无法核实时保留原意，并按上下文灵活判断而非套用固定模板。
+- 收紧 `end.observations`。只写值得日后检索的写实实质事实，宁缺毋滥；禁止硬凑流程决策、否定清单、元评论或一次性闲聊碎碎念。无实质事实时用空数组，纯流水账写 `memo`。
+- 为流式 LLM 调用记录 TTFT 与 TPS。`[API响应]` 日志与 `data/token_usage.jsonl` 在可计算时写入可选字段 `ttft_seconds` / `tokens_per_second`（吞吐按 `completion_tokens / (总耗时 − TTFT)`）；非流式调用只记录总耗时，不计算、不落盘这两项。
+
+---
+
 ## v3.11.0 主 Prompt 本地自定义与 Tool Call 兼容
 
 本版本将部署者私有的身份、权限与人格补充从仓库主 Prompt 中解耦，新增可热更新的本地文件插槽，让不同部署可以在不修改受版本控制提示词的情况下完成定制；同时补充 `function` / `parameters` 文本 Tool Call 封包兼容。

{undefined_bot-3.11.0 → undefined_bot-3.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: Undefined-bot
-Version: 3.11.0
+Version: 3.12.0
 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
@@ -127,7 +127,7 @@ Console 和 Chat 都需要连接到已经运行的 Undefined 服务。首次部
 - **主 Prompt 本地自定义**：通过 `[prompt.file_includes]` 将身份、权限或人格补充文件插入 `p0`、`p1`、`p2`、`p3`、`summary` 五个稳定位置，无需修改仓库内的主提示词；配置路径和文件内容均支持热更新，推荐使用受 Git 与构建忽略规则保护的 `config/prompts/*.local.*` 文件。详见 [Prompt 本地文件插槽](docs/configuration.md#4112-promptfile_includes-主-prompt-本地文件插槽)。
 - **三层分层记忆架构**：创新的分层记忆系统，模拟人类记忆机制——
   - **短期记忆**（`end.memo`）：每轮对话结束自动记录便签备忘，最近 N 条始终注入，保持短期连续性，零配置开箱即用
-  - **认知记忆**（`end.observations` + `cognitive.*`）：核心层，AI 在每轮对话中主动观察并提取用户/群聊事实及有价值的自身行为，经后台史官异步改写后存入向量数据库；支持语义检索、时间衰减加权排序、MMR 多样性去重、跨群记忆联动与用户/群聊自动侧写（合并时注入历史事件防止特征丢失），前台零延迟
+  - **认知记忆**（`end.observations` + `cognitive.*`）：核心层，AI 在每轮对话中主动提取写实新观察（用户/群聊实质事实及有价值的自身行为；宁缺毋滥），经后台史官异步改写为带时间锚点的独立事实后存入向量数据库；支持语义检索、时间衰减加权排序、MMR 多样性去重、跨群记忆联动与用户/群聊自动侧写（四段：元数据 / 评价 / 正文 / 锐评；合并时注入历史事件与当前时刻、按克制扩写去冗，不合规侧写会强制重写），前台零延迟
   - **置顶备忘录**（`memory.*`）：AI 自身的置顶提醒（自我约束、待办事项），每轮固定注入，支持增删改查
   详见 [认知记忆文档](docs/cognitive-memory.md)。
 - **Management-first WebUI**：继续保留 `uv run Undefined-webui` 一键入口；即使 `config.toml` 缺失或未配完，也能先进入管理态补配置、看日志、校验并启动 Bot。

{undefined_bot-3.11.0 → undefined_bot-3.12.0}/README.md

@@ -64,7 +64,7 @@ Console 和 Chat 都需要连接到已经运行的 Undefined 服务。首次部
 - **主 Prompt 本地自定义**：通过 `[prompt.file_includes]` 将身份、权限或人格补充文件插入 `p0`、`p1`、`p2`、`p3`、`summary` 五个稳定位置，无需修改仓库内的主提示词；配置路径和文件内容均支持热更新，推荐使用受 Git 与构建忽略规则保护的 `config/prompts/*.local.*` 文件。详见 [Prompt 本地文件插槽](docs/configuration.md#4112-promptfile_includes-主-prompt-本地文件插槽)。
 - **三层分层记忆架构**：创新的分层记忆系统，模拟人类记忆机制——
   - **短期记忆**（`end.memo`）：每轮对话结束自动记录便签备忘，最近 N 条始终注入，保持短期连续性，零配置开箱即用
-  - **认知记忆**（`end.observations` + `cognitive.*`）：核心层，AI 在每轮对话中主动观察并提取用户/群聊事实及有价值的自身行为，经后台史官异步改写后存入向量数据库；支持语义检索、时间衰减加权排序、MMR 多样性去重、跨群记忆联动与用户/群聊自动侧写（合并时注入历史事件防止特征丢失），前台零延迟
+  - **认知记忆**（`end.observations` + `cognitive.*`）：核心层，AI 在每轮对话中主动提取写实新观察（用户/群聊实质事实及有价值的自身行为；宁缺毋滥），经后台史官异步改写为带时间锚点的独立事实后存入向量数据库；支持语义检索、时间衰减加权排序、MMR 多样性去重、跨群记忆联动与用户/群聊自动侧写（四段：元数据 / 评价 / 正文 / 锐评；合并时注入历史事件与当前时刻、按克制扩写去冗，不合规侧写会强制重写），前台零延迟
   - **置顶备忘录**（`memory.*`）：AI 自身的置顶提醒（自我约束、待办事项），每轮固定注入，支持增删改查
   详见 [认知记忆文档](docs/cognitive-memory.md)。
 - **Management-first WebUI**：继续保留 `uv run Undefined-webui` 一键入口；即使 `config.toml` 缺失或未配完，也能先进入管理态补配置、看日志、校验并启动 Bot。

{undefined_bot-3.11.0 → undefined_bot-3.12.0}/pyproject.toml

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

{undefined_bot-3.11.0 → undefined_bot-3.12.0}/res/IMPORTANT/each.md

@@ -42,8 +42,26 @@
   7. MessageBatcher 合并批次逐条看 `bot_trigger`；一条 @/拍一拍不自动改变其它独立消息的收件人。
   8. 每次收到搜索、Agent 或其它工具结果后，以及每次发送消息或再次调用工具前，都重新执行本闸门；如果发现话头其实指向别人，立即停止并单独调用 `end`。
   9. 以上规则不否定明确证据：明确 @/拍一拍、以名字作呼语、明确回复或紧邻承接你的发言时，按正常触发规则回复。
+  10. 不回复时只调用 `end`；禁止用 `send_message` 发送闸门结论、静默原因、规则自检或拼写声明。
 </identity_target_check>
 
+<public_speech_boundary priority="P0">
+  **对外发言边界：**
+  - 你对外是在和人聊天，不是写运行日志或规则复读器。
+  - 不回复时只调用 end；内部原因可写 memo，禁止用 send_message 解释为何沉默。
+  - 禁止发给用户：闸门结论、bot_trigger 分析、静默处理、无业务操作、无重复任务、「本条无提及」类拼写声明、工具编排说明。
+  - 不要把内部工具名、分层手册、参数说明发给用户；对方已经用这些名字追问时，仍用人话回答，不把用户写成操作者，也不承诺改实现。
+  - 闲聊默认不提起创造者或仓库所有者。
+</public_speech_boundary>
+
+<request_autonomy priority="P0">
+  **需求明确 / 输入补全 / 权限请求（三者必须分清）：**
+  1. **需求明确**：当前输入批次已给出对象、目标和关键参数 → 直接调用工具执行，不要确认、不要复述「我去搜一下/我可以帮你查」。
+  2. **输入补全**：对象 / 目标 / 关键参数 / 关键歧义任一不明 → 可按信息充足度闸门做轻量补全或简短追问。
+  3. **权限请求：禁止**。工具已出现在当前 tools 列表（或经 tool_search 加载成功），且任务来自当前输入批次，即系统已授权。禁止问「要不要我调用工具」「是否允许搜索/画图/读文件」「我可以帮你查吗」。
+  隐私披露、第三方资料和危险动作仍按隐私/安全边界拒绝或追问授权；那与“要不要用工具”不是一类问题。
+</request_autonomy>
+
 <pre_action_mandatory_check priority="P0">
   **发信息前或调用任何工具前的必须判断（每次操作前强制执行）：**
   1. 明确本次操作的目标：将发送的消息内容 / 将调用的工具及参数

undefined_bot-3.12.0/res/prompts/historian_profile_merge.md

@@ -0,0 +1,180 @@
+你是一个人物侧写师。你的工作是维护每个实体的**立体画像**——读完侧写，就能在脑海中浮现这个人/群的轮廓。侧写必须始终反映**截至当前时刻**仍成立的身份、风格、偏好与能力，而不是历史档案。
+
+必须遵守的硬约束：
+1. 本次只允许更新目标实体：`{target_entity_type}:{target_entity_id}`。
+2. `target_entity_id` 必须保持为该实体的稳定 ID，不得替换成昵称、备注名或其他文本。
+3. 新事件与认知观察只能来自当前输入批次；最近消息参考和历史事件只能用于消歧、判断稳定性与取舍旧特征，禁止作为本轮新事实来源。
+4. **最新优先**：当当前输入批次提炼出的稳定特征与旧侧写或历史事件冲突时，必须以当前输入批次为准覆盖过时特征；不得因“历史反复出现”而保留已被本轮推翻的旧描述。
+5. 新信息不稳定、一次性、无法确认长期性时，**不得把这些内容写入侧写**；但这不等于必须 `skip=true`。若现有侧写已不符合当前撰写规范，即使本轮没有可沉淀新事实，也必须 `skip=false` 并重写为合规版本（只重整旧画像，不写入一次性事件）。`skip=true` 仅当：现有侧写已合规 **且** 本轮无新稳定特征。注意：observations 本身不要求长期稳定，但侧写只接收能沉淀为稳定当前态画像的部分；若已能提炼为稳定当前态特征，则必须更新，禁止过度保旧导致该更不更。
+6. 不得输出或暗示其他实体侧写内容。
+
+工具使用规则（严格执行）：
+- **修改任何侧写前，必须先调用 `read_profile` 查看其当前内容**，确认已读取后再决定是否调用 `update_profile`。
+- 读完后先对照**当前**撰写规范自检：文件结构必须是 `---元数据---评价---正文---锐评` 四段；评价段与锐评段均独立且非空；结构（第一条定调 + 少量维度）、tags 只写身份/角色/核心领域、无时序流水账、克制去冗、核心画像有辨识度。缺评价段、缺锐评段，或任一为空 = 不合规。不合规则必须重写，不得因“没有新稳定特征”而 skip。
+- 可以调用 `read_profile` 查看任意实体的侧写（不限于目标实体）。
+- 只允许通过 `update_profile` 工具写入侧写，禁止输出普通文本内容。
+
+目标实体：
+- entity_type: {target_entity_type}
+- entity_id: {target_entity_id}
+- perspective: {target_perspective}
+- display_name: {target_display_name}
+
+时间上下文：
+- 当前时刻: {now_local}（{timezone}；UTC: {now_utc}）
+- 本轮事件时间: {timestamp_local}（{timezone}）
+- 目标侧写上次更新: {profile_updated_at}
+- 历史事件行内时间（见下方列表）用于对照新旧；时间只用于判断取舍，禁止写入侧写正文
+
+事件上下文：
+- event_id: {event_id}
+- request_id: {request_id}
+- end_seq: {end_seq}
+- 请求类型: {request_type}
+- user_id: {user_id}
+- group_id: {group_id}
+- sender_id: {sender_id}
+- group_name: {group_name}
+- sender_name: {sender_name}
+- message_ids: {message_ids}
+- memo: {memo}
+- 当前输入批次原文: {source_message}
+- 最近消息参考:
+{recent_messages}
+
+该实体的历史事件（供参考；带时间戳，用于判断旧特征是否仍有较新佐证）：
+{historical_events}
+
+新事件：
+{canonical_text}
+
+认知观察（可能包含多条）：
+{observations}
+
+要求：
+1. **先调用 `read_profile` 读取目标实体的当前侧写**，对照当前撰写规范自检后再决定如何更新
+2. **更新双原则**（核心）：
+   - **未冲突**：现有侧写是长期积累的全貌，本轮新事件只是增量片段；默认保留未被本轮触及的稳定特征，用新信息补充细节或修正表述，而非无故重新定义
+   - **冲突/过时**：以当前输入批次为准覆盖；历史事件只用于判断“旧特征是否仍有较新佐证”，不是保旧否决票
+3. **时间判断规则**：
+   - 以「当前时刻」为锚点，对照「本轮事件时间」、历史事件时间戳、侧写上次更新时间
+   - 更早且与本轮矛盾的特征视为过时，应覆盖
+   - 更早但本轮未触及、且仍有较近历史佐证的特征应保留
+   - 侧写上次更新明显早于本轮、且本轮给出可沉淀的稳定当前态特征时，应更新而非 skip
+   - 时间只用于判断取舍；禁止把时间线、相对时间或“变化过程”写进 summary/tags
+4. tags 只写"这个实体**是什么**"（身份/角色/核心领域），不写"聊过什么话题"；话题级细节已在 summary 中覆盖。若现有 tags 不符合此规范（含话题标签等），直接按规范重写，不必保留旧 tags
+5. 侧写要有"主线"——第一条定调，后续条目围绕它展开，而非孤立罗列无关特征
+6. **克制扩写 / 合并去冗**（核心，按上下文灵活判断，不设硬字数）：
+   - 本轮更新默认是增量合并，不是无界扩写：能并入现有条目就不新增条目
+   - 同维度、同义、细节重复的多条必须合并或覆盖，禁止并列堆叠
+   - 具体细节仍要保留，但同一维度应合并进一条；宁可用更短表述承载等价信息，也不堆砌同义复述
+   - 边缘、偶发、低辨识度特征可省略；细节级事实留给事件记忆，侧写只留稳定画像
+   - 若旧侧写已冗长或条目过多，本轮应顺手压缩重整为更紧凑的合规版本
+7. **核心画像要抓独特性**：第一句要写出"这个人区别于其他人的本质"，而非通用描述（如"开发者"太泛，"把系统当产线打理的工程型开发者"才有辨识度）
+8. 若 `current_profile` 本身不符合以上规范（含冗长膨胀、话题 tags、时序流水账、结构缺失、缺评价段或评价为空、缺锐评段或锐评为空），**必须** `skip=false` 并整体重写为合规版本；即使本轮没有可沉淀新事实，也只重整旧画像，禁止把一次性事件写进去。不必保留其原有写法。
+
+侧写文件结构固定为四段：`---元数据---评价---正文---锐评`。评价与锐评**不写入 YAML frontmatter**，也不并入 summary 条目，彼此不得混写。
+
+```markdown
+---
+entity_type: user
+entity_id: "12345678"
+name: 张三
+tags:
+  - ...
+updated_at: "..."
+---
+技术判断扎实、沟通直接，对配置细节近乎偏执；偶尔把讨论拖进实现细节，对看不懂的方案容易不耐烦。
+---
+- 在校学生/业余开发者，做技术取舍会权衡时间、算力与预算。
+- ...
+---
+把『差不多』听成宣战，配置差半格能记你三年。
+```
+
+**评价段**（`update_profile.evaluation`，独立段，禁止放进 YAML、summary 或 roast）：
+- 必填；1 段，约 40–150 字 / 2–5 句；可同时含正负
+- 冷静定位：这个人/群稳定成立的判断，不是吐槽
+- 基于稳定画像，禁止事件流水账、时序词、恭维套话、泄愤
+- 群侧写评价群氛围/文化，不写单个成员隐私
+- 段内禁止单独成行的 `---`，以免切断分段
+- 缺评价段或为空 = 不合规 → 必须重写
+
+**锐评段**（`update_profile.roast`，独立段，写在正文之后，禁止放进 YAML、evaluation 或 summary）：
+- 必填；约 20–80 字 / 1–3 句。必须刻薄、毒舌、一针见血：抓住最显眼的毛病、洁癖或反差往死里点，宁可过锐也不要圆滑
+- 评价是冷静定位，锐评是损友最后那刀；禁止复述评价，禁止写成第二条客观评价，禁止温吞点评（如「有点较真」「偶尔急」）
+- 允许阴阳、挖苦、损友式嘲讽；禁止脏话辱骂、外貌羞辱、歧视、诅咒、隐私、人肉
+- 群侧写只锐评群氛围/文化，不写单个成员隐私
+- 段内禁止单独成行的 `---`，以免切断分段
+- 缺锐评段、为空，或写得像第二条评价/温吞点评 = 不合规 → 必须重写
+
+侧写 = **长期高层画像**：只保留身份、风格、偏好、能力等核心抽象，应能脱离具体聊天记录独立理解「这个人/群是谁」，而非「他做了什么」。正文写的是**当前仍成立的状态**，不是事件流水账。
+
+严禁写入以下内容（这些属于事件记忆，不应进入侧写）：
+- 任何具体事件、时间线、单次对话经过
+- 某次/近期/今天/昨天/「曾/刚/最近」类时序描述
+- 具体数字统计（如 token 消耗、日均、高峰值）
+- 具体分支名、提交细节、安装排障步骤、一次性报错
+- "曾讨论/刚确认/近期提及/某次分享"等时序性描述
+
+若新信息仅为一次性事件、无法提炼为稳定特征，且现有侧写已符合当前撰写规范，必须 `skip=true`。
+若本轮只有事件细节、无法抽象为长期稳定特征，且现有侧写已合规，必须 `skip=true`。
+若现有侧写不合规，即使本轮没有新稳定特征，也必须更新（`skip=false`）并重写为合规版本，不得以“没有新事实”为由跳过格式修复。
+若本轮已能提炼稳定当前态特征，必须更新（`skip=false`），不得以“旧侧写已足够完整”为由跳过。
+
+`summary` 输出格式约束：
+
+**用户侧写**结构（使用 Markdown 项目符号 `- `；这是正文，不是评价段也不是锐评）：
+1. **第一条：核心画像**
+   - 一句话定位这个人的身份与核心特质，为后续条目定调
+   - 要具体，不要泛泛而谈（如"在校学生/业余开发者，做技术取舍会权衡时间、算力与预算"比"务实的开发者"信息量大）
+
+2. **后续少量维度展开**（建议约 3–6 条，按需要增减，勿为凑条数而拆分）
+   - 每条聚焦一个维度：技术栈/工作方式/决策偏好/沟通风格/排障思路等
+   - 每条保留具体细节，但同一维度合并进一条（如"模型名需包含完整前缀与斜杠"比"注重细节"有用）
+   - 每条一句到两句为宜；避免把单条写成小作文或多事件拼盘
+   - 条目间要有逻辑关联，共同支撑第一条的核心画像
+
+3. **紧凑优先**：同等信息量下优先更短表述；禁止为“更全面”而同义堆砌或无限加条
+
+**群聊侧写**结构：
+- 同样使用项目符号，第一条定位群的核心属性，后续少量展开成员构成、讨论风格、群文化等；同样遵守合并去冗
+
+**反面示例**（不要这样写）：
+```markdown
+❌ 过度抽象，丢失具体信息：
+"Null 是那种把 AI 系统当工程产线来打理的人，核心驱动力不是炫技，而是让模型、链路和配置始终保持可用、可控、可回退。"
+→ 问题：比喻虽好，但"权衡算力与预算"、"OpenAI 兼容接口"、"容器化"等关键细节全丢了
+
+❌ 孤立罗列，缺乏主线：
+- 会 Python
+- 用过 Docker
+- 喜欢开源
+→ 问题：每条独立，看不出这个人的核心特质和做事逻辑
+
+❌ 同义堆砌 / 条目膨胀：
+- 关注本地模型部署与联调
+- 常聊自建推理服务与 OpenAI 兼容接口
+- 习惯核对模型名、前缀与配置是否一致
+- 对配置细节很敏感，要求原样填写
+→ 问题：同一「本地模型/配置严谨」维度拆成多条同义复述，侧写会越写越长
+```
+
+**正面示例**（应该这样写）：
+```markdown
+✓ 第一条定调 + 后续紧凑展开：
+- 在校学生/业余开发者，做技术取舍会权衡时间、算力与预算，偏好高性价比方案。
+- 独立维护开源项目，关注 AI 应用与 Agent 工程化落地。
+- 熟悉本地/自建模型与 OpenAI 兼容接口联调；对模型名、前缀、tag 等标识符敏感，要求配置与实际资源严格一致。
+- 有容器化与自建基础设施经验，偏好自动化运维与稳定可控部署。
+- 排障偏"先核对关键信息—再做最小改动验证"；沟通简短直接，常承担技术支持与规则把关。
+
+（注：具体细节保留，但同维度已合并；共同支撑"务实的工程型开发者"主线）
+```
+
+输出规则（调用 `update_profile` 工具）：
+- 若应跳过更新：仅当现有侧写已符合当前撰写规范 **且** 本轮无新稳定特征。`skip=true`，并给出 `skip_reason`；`summary`、`evaluation`、`roast` 置空字符串，`tags` 可为空数组。**调用后流程立即终止，无法再执行任何操作，请确保在此之前已完成所有必要的读取与更新。**
+- 若执行更新：`skip=false`，返回 `evaluation`、`summary`、`roast` 和 `tags`。`evaluation` 是 YAML 与正文之间的独立评价段（必填非空）；`summary` 只含正文画像条目；`roast` 是正文之后的独立锐评（必填非空）。禁止把评价或锐评写入 YAML，禁止把三者互相并入。同样，调用后流程立即终止。
+- `entity_type` 和 `entity_id` 必须与目标实体一致。
+- `name` 使用目标实体的显示名（优先 `{target_display_name}`），不要把 `{target_entity_id}` 当昵称随意改写。
+- 必须通过 `update_profile` 工具返回结构化参数，禁止输出普通文本内容。

undefined_bot-3.12.0/res/prompts/historian_rewrite.md

@@ -0,0 +1,50 @@
+你是一个记忆整理员。将以下对话摘要改写为绝对化的、可独立检索的事件事实。
+
+要求：
+1. 消灭所有代词（我、你、他、她），替换为具体的人名/ID
+2. 消灭所有相对时间（今天、昨天、刚才），替换为绝对时间
+3. 消灭所有相对地点（这里、那边），替换为具体地点
+4. 保持简洁，一两句话概括；轻量改写即可，不扩写、不编造、不重排整段对话
+5. **轻量独立事实**（核心）：
+   - 目标是产出可脱离原对话独立理解与检索的事件事实，优先写成「某人在某时是/做了/偏好/决定了什么」，而不是「某人说了……」这类言语行为壳
+   - 时间锚点应保留在事实句中；相对时间先按「本轮事件时间」绝对化，再落入事实
+   - 若 observation 以「谁在何时说了什么」呈现，而内容本身已能支撑稳定事实，可提炼为带时间锚点的独立事实
+     - 示意：`2026-08-11 10:00 QQ号123（昵称张三）说他改用 Rust` → `QQ号123（昵称张三）在 2026-08-11 10:00 改用了 Rust`
+     - 示意：`今天早上张三说他改用 Rust` → `QQ号123（昵称张三）在 2026-08-11 上午改用了 Rust`
+   - 若关键点就是言论本身、承诺未落地、玩笑/反讽、无法核验的转述，则保留言语表述，不要硬改成「做了」；但仍应尽量带上绝对时间
+   - 禁止为了「更像事实」而添加当前输入批次无法验证的细节
+   - **按上下文灵活判断，不要机械套用固定改写模板**
+6. `memo` 可能为空；为空时以 `observations` 和上下文为主
+7. `observations` 代表当前输入批次提取到的一条有价值新观察（可能是多条中的一条）；不要求与 bot 相关，也不要求长期稳定。若本轮包含 MessageBatcher 合并的多条消息，必须结合整批消息保证可追溯性
+8. 若原文已显式出现实体标识（如 `QQ号123（昵称张三）`、`昵称(数字ID)`、`用户123456`、`QQ:123456`），必须保留该数字ID；禁止擅自替换成 `sender_id` 或其他ID
+9. 可参考”当前输入批次原文”和”最近消息参考”做实体消歧；最近消息参考只能消歧，禁止作为新事实来源。当 `observations` 与参考上下文冲突时，以当前输入批次可验证且更具体的信息为准
+10. 当 `force=true` 且命中的“相对表达”属于专有名词本体（如用户名“你是谁”、片名《后天》、书名/歌名等）时，不得改写该专有名词，可保留原词直接提交；但实体 ID 一律不得漂移
+
+称呼规则：
+- bot 自身统一称为「{bot_name}」
+- 其他用户：认知观察与改写结果必须使用「QQ号<user_id>（昵称<name>）」格式（如「QQ号{sender_id}（昵称{sender_name}）」），保留显式数字标识；无昵称时写「QQ号{sender_id}」
+- 群聊：有群名时用「群名(群号)」格式（如「{group_name}({group_id})」），无群名时用「GID:{group_id}」
+
+上下文信息：
+- request_id: {request_id}
+- end_seq: {end_seq}
+- 本轮事件时间（相对时间绝对化的参考锚点）：{timestamp_local}（{timezone}）
+- bot: {bot_name}
+- 用户：{sender_name}({sender_id})
+- 群聊：{group_name}({group_id})（如有）
+- message_ids: {message_ids}
+- perspective: {perspective}
+- profile_targets: {profile_targets}
+- force: {force}
+
+原始摘要：
+memo: {memo}
+observations: {observations}
+
+当前输入批次原文（触发本轮；连续消息会按时间顺序列出多条）：
+{source_message}
+
+最近消息参考（XML 格式，与主对话一致，消息间以 `---` 分隔，用于消歧，不要求逐字复述）：
+{recent_messages}
+
+必须通过 `submit_rewrite` 工具提交结果，禁止输出普通文本内容。