---
title: "会话"
description: "创建、控制、流式读取与导出 Carina 会话。"
source: https://carina.nebutra.com/zh-cn/api/sessions/
---

# 会话

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

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

  </div>

## 核心方法

| 方法 | 用途 |
| --- | --- |
| `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` 消费。

  在 [方法目录](/zh-cn/api/methods/) 打开任意方法，可用 **Playground → Mock** 无需本机 daemon 即可预览响应形状。

## 权威来源

- 生命周期：`docs/tui-session-lifecycle.md`
- RPC：`session.*` · `goal.*` · `session.checkpoint.*`
- CLI：`carina sessions` · `carina resume` · `carina items` · `carina session review`
- 相关：[JSON-RPC](/zh-cn/api/json-rpc/) · [方法目录](/zh-cn/api/methods/) · [审计](/zh-cn/concepts/audit/)

## 下一步

- [快速上手](/zh-cn/getting-started/quickstart/) — 从 CLI 建会话
- [可观测性](/zh-cn/observability/traces/) — items / events / cost

---
Source: https://carina.nebutra.com/zh-cn/api/sessions/
Markdown: https://carina.nebutra.com/zh-cn/api/sessions/index.md