mcpField
S
session-logger

session-logger

github.com/zhaono1Agent 工作流85744 次安装9 周前更新
代码仓库

关于 session-logger

session-logger 用于生成有范围限制且注重隐私的会话恢复记录。它支持通过宿主提供的 Agent Playbook hook 自动记录，也支持经用户授权后手动总结。

主要功能

  1. 01脱敏并限制记录内容
  2. 02私有本地文件存储
  3. 03可选仓库内输出
  4. 04手动交接摘要格式
  5. 05明确检查写入授权

适用场景

  1. 01记录会话以便后续工作
  2. 02准备简洁的任务交接
  3. 03在本地保存选定会话信息
  4. 04无 transcript 事件时创建摘要

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/zhaono1/agent-playbook --skill session-logger

安装后在 Claude Code 中输入/session-logger确认已加载。

附带文件README.md

详细介绍

会话记录器

创建简洁的恢复资料，而不要将原始对话历史视为持久记忆。

在以下情况下使用此技能

  • 用户明确要求保存或记录当前会话。
  • 受支持的宿主使用成绩单路径调用 Agent Playbook SessionEnd 钩子。
  • 后续任务需要简洁的交接资料，且用户已授权写入。

不要在未告知用户的情况下持久化原始记录、凭据、客户隐私数据或无限量的 Agent 输出。必须明确说明宿主支持情况和写入权限；仅有技能元数据并不会执行钩子。

CLI 运行时约定

Claude Code 安装可以调用：

agent-playbook session-log

该命令会读取宿主提供的 JSONL 记录，并仅存储有界且经过脱敏的详情：

  • 消息数量；
  • 脱敏后截断的最后一条用户提示；
  • 最多 12 条检测到的命令和文件引用；
  • 最多 8 个检测到的问题；
  • 经哈希处理的会话引用和项目标识。

默认情况下，文件是私有的本地资料：

~/.agent-playbook/sessions/<project-id>/YYYY-MM-DD-<topic>.md

设置 AGENT_PLAYBOOK_DATA_DIR 或传入 --data-dir，即可更改私有数据根目录。 只有选择加入时，才会写入仓库：

apb session-log --session-dir ./sessions

如果选择仓库本地目录，请在写入前核实其忽略和保留策略。切勿假定其他仓库会忽略 sessions/。

手动摘要约定

如果宿主无法提供记录事件，请根据当前会话中实际可见的上下文，创建经用户授权的摘要。仅包含：

  1. 结果和当前状态；
  2. 会影响后续工作的决定；
  3. 相关文件或命令；
  4. 未解决的问题和下一项验证关卡。

如实说明省略了哪些内容。除非活动运行时确实提供相应功能，否则不要声称完整捕获了对话、提取了结构化决策、会自动追加内容，或能跨会话回忆。

隐私与安全

  • 写入前，脱敏常见凭据、持有者令牌、私钥、电子邮件地址，以及密码或密钥赋值。
  • 在生成的元数据中，将当前项目根目录替换为项目标识。
  • 在平台支持的情况下，以仅所有者可访问的权限写入生成的摘要。
  • 除非用户另行授权提交、上传或分享，否则请将资料保留在本地。
  • 将脱敏视为降低风险的措施，而非任意机密文本都能安全保留的保证。

完成检查

  • 目标位置和写入权限明确。
  • 摘要内容有界，不包含已知的原始机密。
  • 已明确选择仓库本地存储，并检查忽略策略。
  • 返回的路径存在，且用户可读取。

评论

支持 Markdown