用途:session-info 用于查看当前 hive 会话的详细信息,包括会话 ID、名称、所属仓库、收件箱主题、会话目录路径和状态。当需要知道当前会话 ID、向其他智能体提供收件箱主题、设置智能体间协调、排查消息问题或确认会话上下文时使用。
主要能力:提供人类可读输出和 JSON 输出两种形式。人类可读命令为 hive session info;JSON 命令为 hive session info --json。输出字段包括 id(6 位唯一会话标识,如 26kj0c)、name(会话名称)、repository(Git 仓库名)、inbox(完整收件箱主题,格式为 agent.<session-id>.inbox)、path(会话目录绝对路径)、state(会话状态)。会话状态有 active(正常可用)、recycled(已停止并清理)、corrupted(目录或文件损坏)。
使用方式:在 hive 会话目录内运行 hive session info 查看信息;需要脚本处理时加 --json,例如用 jq 提取收件箱:hive session info --json | jq -r '.inbox',或提取会话 ID 与收件箱用于脚本变量。发送消息前可先运行 hive session info 确认上下文,再用 hive msg inbox 检查收件箱。
会话检测机制:命令根据当前工作目录判断会话,依据包括工作目录位于 hive 会话目录内、会话目录命名模式 $XDG_DATA_HOME/hive/repos/<repo>-<session-id>,以及目录中的 .hive-session 文件。若不在 hive 会话目录中,命令会报错。
适用场景:多智能体协作时共享收件箱主题、脚本化提取会话标识、调试消息收发问题、验证会话上下文是否正确。
限制:必须在 hive 会话目录内运行,否则失败;资料未提供安装方式、收费信息、支持平台及其他高级用法,相关排障可参考 references/troubleshooting.md。相关技能包括 /hive:inbox、/hive:publish、/hive:wait。