其他
用户要求记录会话或宿主触发会话结束时,生成有界、脱敏…
当用户明确要求保存/记录当前会话,或受支持宿主在 SessionEnd 提供 transcript 路径时,用有界、脱敏、可恢复的本地摘要保存会话交接信息。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 39/100 ×0.15
适用场景
用户要求记录会话或宿主触发会话结束时,生特定
解决思路
- 使用 `agent-playbook session-log`(Claude Code 安装中可调用)读取宿主提供的 JSONL transcript,并只存储有界、脱敏的细节。
- 记录消息数量。
- 记录最后一条用户提示,并在脱敏后截断。
- 最多记录 12 条检测到的命令和文件引用。
- 最多记录 8 条检测到的问题。
- 记录哈希后的会话引用和项目身份。
- 默认将文件存为私有本地产物:`~/.agent-playbook/sessions/<project-id>/YYYY-MM-DD-<topic>.md`。
- 通过设置 `AGENT_PLAYBOOK_DATA_DIR` 或传入 `--data-dir` 来移动私有数据根目录。
- 仅在明确选择时才写入仓库内部:`apb session-log --session-dir ./sessions`。
- 如果选择仓库本地目录,写入前验证其 ignore 和保留策略。
- 不要假设其他仓库会忽略 `sessions/`。
- 当宿主无法提供 transcript 事件时,根据当前会话实际可见的上下文创建经用户授权的摘要。
- 手动摘要只包含:结果和当前状态。
- 手动摘要只包含:影响未来工作的决策。
- 手动摘要只包含:相关文件或命令。
- 手动摘要只包含:未决问题和下一个验证门槛。
- 如实说明遗漏内容。
- 除非当前运行时能够明确证明,否则不要声称完整对话捕获、结构化决策提取、自动追加行为或跨会话召回。
- 写入前脱敏常见凭证、bearer token、私钥、电子邮件地址,以及 password/secret 赋值。
- 在生成的元数据中用项目身份替换当前项目根路径。
- 在平台支持时,以仅所有者权限写入生成的摘要。
- 除非用户另行授权提交、上传或分享,否则将产物保留在本地。
- 把脱敏视为风险降低,而不是任意机密文本都安全的保证。
- 完成检查:目标和写入权限清晰。
- 完成检查:摘要是有界的,并且不包含已知的原始秘密。
- 完成检查:仓库本地存储被明确选择,并且已检查 ignore 策略。
- 完成检查:返回路径存在且用户可读。
适用边界 · 注意事项
- 未获得明确写入授权、宿主支持或目标不清晰时,不要保存会话;仅凭技能元数据不会执行 hook。
- 不要持久化原始 transcript、凭证、私有客户数据或无界 agent 输出。
- 未显式选择仓库内存储并检查其 ignore 和保留策略时,不要写入仓库本地 `sessions/`,也不要假设其他仓库会忽略它。