mcpField
S
session-info

session-info

github.com/terrylicaAgent 工作流2126 次安装1 天前更新
代码仓库

关于 session-info

面向 Claude Code 的技能，通过脚本报告当前会话 UUID 和注册表信息，适用于调试会话历史及检查注册表状态。

主要功能

  1. 01获取当前会话 UUID
  2. 02获取简短会话 ID
  3. 03查看项目与注册表路径
  4. 04查看会话链长度
  5. 05查看最后更新时间

适用场景

  1. 01调试时确认会话身份
  2. 02检查会话链历史
  3. 03核实注册表是否正常工作

安装

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

$npx skills add https://github.com/terrylica/cc-skills --skill session-info

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

附带文件references/evolution-log.mdreferences/registry-format.md

详细介绍

导航：插件 CLAUDE.md | 根目录 CLAUDE.md

会话信息技能

返回当前 Claude Code 会话 UUID 和注册表信息。

自我演进技能：此技能会在使用过程中不断改进。如果指令有误、参数发生变化或需要采用变通方法，请立即修复此文件，不要拖延。仅针对真实且可复现的问题进行更新。

何时使用此技能

在以下情况下使用此技能：

  • 需要知道当前会话 UUID 以进行调试
  • 想要查看会话链历史记录
  • 验证会话注册表是否正常工作
  • 查找会话与转录记录之间的关联

实现

运行会话信息脚本：

bun $HOME/.claude/plugins/marketplaces/cc-skills/plugins/statusline-tools/scripts/get-session-info.ts

输出格式

脚本会输出结构化的会话信息：

Current Session: c1c1c149-1abe-45f3-8572-fd77aa046232
Short ID: c1c1c149
Project: ~/.claude
Registry: ~/.claude/projects/-Users-you--claude/.session-chain-cache.json
Chain Length: 3 session(s)
Last Updated: 2026-01-15T21:30:00.000Z

注意：本文档早期版本中显示的 Managed By、Metadata（Repo、Hash、Branch、Model、Cost）和 Recent Sessions 部分尚未在 get-session-info.ts 中实现。该脚本目前仅输出上述 6 个字段。

注册表位置

会话注册表遵循 Claude Code 的原生路径编码方式：

~/.claude/projects/{encoded-path}/.session-chain-cache.json

其中，encoded-path 会将 / 替换为 -：

  • /Users/username/eon/cc-skills → -Users-username-eon-cc-skills

参考

故障排查

问题原因解决方案
找不到脚本未安装插件运行 claude plugin list 验证安装情况
JSONL ID 未定义没有活动会话请先启动 Claude Code 会话
找不到注册表文件项目中的第一个会话注册表会在第一个会话期间自动创建
链长度为 0新项目新项目中属于正常情况，链会随着时间增长
路径编码看起来不正确路径中包含特殊字符Claude Code 会使用 - 替换路径中的 /
找不到 Bun未安装 Bun使用 brew install oven-sh/bun/bun 安装
权限被拒绝注册表文件权限问题检查 ~/.claude 权限（应可读取）

执行后反思

此技能执行完毕后，请在结束前检查：

  1. 命令是否成功？ — 如果没有成功，请修复导致失败的指令或错误表格。
  2. 参数或输出是否发生变化？ — 如果底层工具的接口发生变化，请更新用法示例和参数表，使其与之匹配。
  3. 是否需要采用变通方法？ — 如果需要临时变通（不同的标志、额外步骤），请更新此 SKILL.md，避免下次调用时再次需要相同的变通方法。

仅在问题真实且可复现时进行更新，不要针对推测性问题更新。

评论

支持 Markdown