返回目录 / Agent 工作流
浏览、归档并分支agent会话
在本地项目侧栏列出历史session、读取消息、加标题/标签,并从旧对话分支续跑而保留原文。
目标
让用户找回和安全续接过去的agent工作。
步骤
- 用
list_sessions(directory=project_dir)按最近修改时间列出session,并用get_session_info显示摘要、branch及文件大小。 [sessions] - 点击时用
get_session_messages读取历史;用rename_session命名、tag_session标记,默认将隐藏项软隐藏而非删除。 [sessions] - 需要尝试新方向时用
fork_session(session_id, up_to_message_id=...)创建分支,再以ClaudeAgentOptions(resume=fork.session_id)续跑并确认源session未改变。 [sessions]
验证方式
侧栏列表和消息顺序与transcript一致;分支具有独立session ID,续跑写入分支且原始历史保留。
故障处理
若列表为空,确认`directory`与创建session时的`cwd`一致;硬删除会移除transcript,优先使用隐藏tag。
权限边界
前置条件
- Python 3.11+、claude-agent-sdk v0.1.51+、Claude Code CLI、Anthropic API key及本地项目transcript目录访问权限。
权限边界
- session浏览器可读写当前project的本地对话transcript;默认隐藏用tag软删除,只有明确执行`delete_session`才硬删除。
限制
这些函数操作`~/.claude/projects/`中的本地transcript,不会启动agent或调用API;tag是单个字符串而非多标签数组。
固定上游来源
- 仓库
- anthropics/anthropic-cookbook
- 文件路径
- claude_agent_sdk/05_Building_a_session_browser.ipynb
- 固定提交
9c1e493ddd2b82df399d2a61b9c806c539e18be6- 来源检查
- 2026-10-14 · 已按固定上游来源核对
仓库指标
以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。
- Stars
- 未取得
- Forks
- 未取得
- 观测时间
- 未取得
尚未取得指标快照。
许可证: MIT