---
title: "API 版本通道"
description: "文档 0.8.x / next 通道与协议目录的对应关系。"
source: https://carina.nebutra.com/zh-cn/api/versions/
---

# API 版本通道

> 文档 0.8.x / next 通道与协议目录的对应关系。

文档提供 **两个通道**。叙事类页面共享；**方法目录**与版本横幅随通道切换。

## 通道

| 通道 | 标记 | 目录文件 | 用途 |
| --- | --- | --- | --- |
| `0.8.x` | stable | `/data/rpc-catalog-0.8.x.json` | **0.8** 发布线文档面（当前产品） |
| `next` | preview | `/data/rpc-catalog-next.json` | 跟踪仓库内最新 `methods.json` |

顶栏 **Version** 选择会写入 `localStorage`，并在 `<html>` 上设置 `data-docs-version`。

## 刷新目录

在 `apps/docs` 下：

```bash title="sync-protocol.sh" frame="none"
pnpm sync-protocol
```

协议变更后请提交更新的 `src/data/rpc-catalog*.json` 与 `public/data/*`。生成器从同一份 `methods.json` 写出两个通道；release 分支上的 commit 即稳定钉扎。

## Try it

在 [方法目录](/zh-cn/api/methods/) 展开任意方法可使用 **Try it**：编辑并复制 JSON-RPC/CLI、使用本地 Mock，或通过 `ws://127.0.0.1:8777/gateway` 向经过认证的 WebSocket Gateway 发送已开放远程调用的方法。

## 权威来源

- 协议注册表：`protocol/jsonrpc/methods.json`
- 目录生成：`apps/docs` → `pnpm sync-protocol`
- 钉扎：`src/data/rpc-catalog-*.json` 与 `public/data/`
- 相关：[方法目录](/zh-cn/api/methods/) · [JSON-RPC](/zh-cn/api/json-rpc/) · [API 概览](/zh-cn/api/overview/)

## 下一步

- 在页眉切换 **Version**（`0.8.x` / `next`），再打开 [方法目录](/zh-cn/api/methods/)

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