Agent Session

Agent Session 是会话的云端归档与共享层：每轮对话（提问 + 回复 + 工具调用轨迹）上传后，可以在网页端浏览、按文件夹归档、跨机器恢复续跑、按链接分享给同事，也可以通过 --issue 参数挂进 Multica issue 供看板侧读取。上传永远是显式动作，不会自动发生。

前置条件

命令可用性可用一条命令确认（缺失会报 unknown subcommand）：

ginit context upload --help

上传

会话内：让 agent 上传

会话里预置了 upload skill——直接用自然语言让 agent 上传即可，例如「把这个会话上传到云端，标题叫 XXX，挂到 SII-1234」。agent 会执行 ginit context upload-current 并带齐你要求的元数据（--title / --public / --issue），完成后报告结果。

CLI：指定文件上传

首选 --path 直接给 transcript 绝对路径（不用翻找 provider + UUID）：

ginit context upload --provider codex --path /root/.codex/sessions/2026/09/12/rollout-9f1c.jsonl --title "发布流水线排查"

ginit context upload --provider claude_code --path ~/.claude/projects/-root-src-homepage/abc123.jsonl

也可以按 provider:session-id 定位（适合已拿到 session id 的场景），批量用 upload-many：

ginit context upload codex:9f1c2a4b-...

ginit context upload-many claude_code:abc123 claude_code:def456 --continue

upload-current 自动定位当前工作目录的活跃会话；全部命令都支持 --title / --folder-id / --public / --issue 元数据。

与 Multica issue 的关联

关联不是自动的——两种显式方式：

1. 上传时带 --issue <url>（可重复多个）：

ginit context upload-current --issue https://multica.ginit.opensii.ai/w/demo/i/SII-1234 --title "登录 bug 排查"

2. 会话开工时先做 issue 绑定（$ginit-issue-binding，agent 侧 skill），之后上传会自动带上该 issue 关联。

挂进 issue 后，看板 issue 详情页的 Agent Session 区即可看到这次会话（列表、按轮次展开、关键词筛选）。

文件夹

文件夹用来组织 session（v1.4.109+）：

ginit context folder create "本周排查记录"

ginit context folder list

ginit context folder create "子目录" --parent-id <父文件夹 ID>

• 上传时 --folder-id <ID> 把 session 归档进文件夹（配合 issue 绑定使用时，issue 页与文件夹视图都能找到同一次会话）
• folder list 带 --parent-id 可以逐层浏览层级
• 可见性：文件夹默认私有；共享/收回用 ginit context folder share（--public 全组织 / --mode members --members <ids> 指定成员 / --private 收回）
• 其余子命令：rename / move / read / download / prompt（往文件夹挂 agent 提示）
• 网页端（session.opensii.ai）的文件夹树与 CLI 一致

浏览、分享与恢复

• 网页端：session.opensii.ai——session 列表、详情、按轮次展开阅读、文件夹树
• 可见性：默认私有；--public 直接共享，或移入组织共享文件夹
• 分享：每个 session 有稳定链接，别人拿到链接用 read 读取（按 Drive ACL 控权）：

ginit agent session read https://session.opensii.ai/s/<node-id>

跨机器恢复续跑（下载 provider 原生 JSONL 放回本机，交给 Claude/Codex 原生 resume）：

ginit context resume claude_code <session-id> --cwd /path/to/project

目录绑定（会话与工作目录配对，恢复时自动进目录，v1.4.114+）：

ginit agent session bind-dir <session-id> --dir /path/to/project

ginit agent session attach-dir <session-id>

常见问题

session 会自动上传吗？ 不会。没有任何 hook 或后台进程替你上传——每次都是你（或你让会话里的 agent 执行 upload skill）发起的显式动作。

上传的东西去哪了？ 会话 JSONL 归档在云端（ginit-server 管理的对象存储），标题/文件夹/可见性/issue 关联等元数据在服务端索引。Multica 通过桥接只读被显式关联的会话。

误传了敏感内容？ 私有 session 只有你可见；改名用 ginit agent session rename <session-id> <new-title>，删除请联系平台。