Markdown

会话

创建、控制、流式读取与导出 Carina 会话。

会话绑定对话状态、能力配置与工作区根目录。工作区在 session.create 时通过 workspace_root 绑定 — 没有单独的注册方法。

生命周期

create → (pause / resume) → close
         ↘ submit tasks / stream events
         ↘ fork / checkpoint / goal

writelocal socket

创建绑定工作区与权限配置的会话。

参数

workspace_rootstring必填请求体

工作区目录的绝对路径。会话存活期间保持绑定。

profilestring请求体默认 safe-edit

权限配置名（如 safe-edit、read-only）。由能力内核评估。

结果

session_idstring必填

不透明会话 id，供后续 session.* / task.* 调用使用。

workspace_idstring必填

绑定的工作区 id。

profilestring必填

生效的能力配置。

requestjson

{
"jsonrpc": "2.0",
"id": 1,
"method": "session.create",
"params": {
  "workspace_root": "/repo",
  "profile": "safe-edit"
}
}

resultjson

{
"jsonrpc": "2.0",
"id": 1,
"result": {
  "session_id": "sess_01J…",
  "workspace_id": "ws_01J…",
  "profile": "safe-edit"
}
}

方法	用途
`session.create`	创建会话（工作区 + 配置）
`session.get` / `session.list`	元数据与活跃/已归档列表
`session.archive` / `session.unarchive`	可恢复的归档与还原；存在活动任务时拒绝归档
`session.pause` / `session.resume`	挂起 / 继续
`session.close`	归档操作的兼容别名
`session.replay`	回放原始审计事件流
`session.items`	UI/SDK 用归一化 item 流
`session.review`	治理投影
`session.events.stream`	实时通知

JSONL / SQLite 导出由 audit.export 提供，不是 session.*。

方法	用途
`execution.start`	提交 prompt/任务
`execution.cancel`	取消运行中任务
`execution.status`	查询状态
`governance.action.approve` / `governance.action.deny`	解决待审批

任务事件通过 session.events.stream 消费。

生命周期：docs/tui-session-lifecycle.md
RPC：session.* · goal.* · session.checkpoint.*
CLI：carina sessions · carina resume · carina items · carina session review
相关：JSON-RPC · 方法目录 · 审计

这个页面有帮助吗？

本次会话中每个页面仅记录一次投票。