feat(summary): 增加项目级总结记忆 - #727
Merged
Merged
Conversation
Co-authored-by: TRAE CLI <noreply@bytedance.com>
1330482928
self-requested a review
August 4, 2026 08:39
Co-authored-by: TRAE CLI <noreply@bytedance.com>
Co-authored-by: TRAE CLI <noreply@bytedance.com>
Co-authored-by: TRAE CLI <noreply@bytedance.com>
bots-json 与 slash-commands（中英文）补充项目 summary 记忆的新语义: - summaryMemory 开关 + summaryMemoryPath 路径字段(相对项目根/绝对路径,默认 summary.md) - 仅记忆开启时 /summary 后随文字作为硬边界、miss 不回退宽范围 - 关闭时后随文字仅为侧重提示 - 沙盒下绝对路径需自行加进 sandboxPaths.readWrite 的提示
按 codex 复审: - 边界选择改「最近一条」(实现取最后命中,非第一条) - miss 行为改「向 agent 交 boundary-not-found 错误+空历史,写入指令仍执行」(daemon 不直接向用户报错) - 沙盒提示改「加已存在父目录」(worker spawn 过滤不存在路径,新文件会被丢),并覆盖 ../ 逃逸的相对路径 - safety cap 说明标注显式边界会越过上限(话题群全绕/普通群 sinceHours 未约束)
申晗拍板方案 B:接受「显式边界优先于 limit/sinceHours」为有意产品语义 (用户明确说从哪条起就从哪条起),不改代码。文档从「注意/越过上限」的 告警口吻改为「按设计优先」,并提示不想读旧内容就别带边界文字。
按 codex 收尾建议:显式边界在话题群/sinceHours 不受 summaryRange 约束, 末句改为「不带边界文字最可靠;普通群可再调低 limit」,避免误以为 cap 仍生效。
wunameya
changed the title
|
🚀 Released in v3.9.0 |
This was referenced Aug 5, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
改了什么
summaryMemory和summaryMemoryPath：summaryMemory控制是否启用/summary项目级记忆。summaryMemoryPath控制记忆文件路径，默认summary.md，支持相对当前项目根目录或绝对路径。/summary记忆配置：开启记忆开关。记忆文件路径输入框。@bot /summary会要求 agent 只把本次总结追加写入配置的记忆文件，并把实际写入的 Markdown 原样发给用户确认。/summary xxx的尾部文字只在summaryMemory开启时作为硬边界生效；未开启记忆的 bot 保持原有/summary语义。limit、sinceHours和上次本 bot/summary边界约束，避免边界未命中时翻完整个群历史。为什么
现有
/summary只生成一次性总结，不能把排查结果沉淀到项目目录。这个改动提供一个用户显式触发、项目本地保存的问题解决记录本，用于后续相同条件问题的保守复用。同时，记忆行为必须是 opt-in：不开
summaryMemory的 bot 不应因为/summary后带文字而改变原有历史窗口语义，避免影响所有现有用户。影响面
/summary行为；只有配置summaryMemory: true的 bot 会启用写入记忆和显式边界语义。summary.md；配置summaryMemoryPath后，agent 会按该路径写入和读取。/botconfig配置卡和/summaryprompt 构造均同步支持新字段。验证
PATH="$HOME/.nvm/versions/node/v22.23.1/bin:$PATH" pnpm tsc --noEmitPATH="$HOME/.nvm/versions/node/v22.23.1/bin:$PATH" pnpm vitest run test/summary-command-window.test.ts test/event-dispatcher.test.ts test/bot-registry-grant.test.ts test/dashboard-bot-payload.test.ts test/codex-app-clean-prompt.test.tsPATH="$HOME/.nvm/versions/node/v22.23.1/bin:$PATH" pnpm vitest run test/dashboard-bot-defaults-layout.test.ts test/dashboard-bot-payload.test.ts test/bot-config-store.test.ts