> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orriven.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 开发工具

> API 指标、API 密钥、Webhook、Salesforce 连接、请求日志，以及浏览器 Shell——集中在一个抽屉里，范围限定为单个业务单元。

**开发工具**是控制台顶部栏的抽屉——通知铃铛旁的终端图标。打开后覆盖在当前页面之上。关闭（Esc、关闭按钮或点击遮罩）后页面位置不变。

抽屉中的内容属于**一个业务单元**。标题旁的选择器决定是哪一个：默认跟随控制台当前打开的业务单元，在组织页面上默认第一个，也可以在抽屉内切换而不改变控制台位置。尚无业务单元的组织看到空抽屉。

## 谁能打开

抽屉面向组织的**所有者（Owner）和管理员（Admin）**——与能签发 [API 密钥](/zh/developers/api-keys)的是同一批人。指标、密钥、日志与 Shell 需要密钥管理权限；Webhook 与 CRM 需要将本单元数据接入外部系统的权限。其他角色看不到抽屉内容。

[命令行工具](/zh/developers/cli)与 [MCP 服务](/zh/agent/tools)在终端与 Agent 中完成同样的操作。

## 指标

所选业务单元的[开放 API](/zh/developers/overview) 流量图表，时间范围为**最近 24 小时、7 天或 30 天**。每张卡片给出一个数字和一张图：

* **API 请求量**——总请求数，每格内成功与失败堆叠显示。
* **错误分布**——总错误数，按状态类别（4xx、5xx）拆分。所选范围内没有错误时直接说明，不画空图。
* **响应耗时**——按请求数加权的平均值，以及**平均**与 **p95** 两条随时间变化的曲线。

时间轴恒为 **48 格**，将窗口等分（24 小时每格 30 分钟，7 天每格 3.5 小时，30 天每格 15 小时）。切换范围只换刻度，不改变格数。网格下方的「更新于 …」是数据取回的时间。

## API Key

生成与撤销 Secret 密钥，创建 Publishable 公开密钥并设置允许的 Origin。密钥只在此标签页管理，侧边栏没有对应页面。生成 Secret 密钥后，安装了 1Password 扩展的浏览器会在**复制**旁显示 **Save in 1Password**。完整规则见 [API 密钥](/zh/developers/api-keys)。

## Webhooks

登记端点、选择接收的事件、查看签名密钥、发送测试、查看并重新投递。见 [Webhook](/zh/developers/webhooks)。

## CRM

将业务单元连接到 Salesforce，并查看同步状态。见 [Salesforce](/zh/developers/salesforce)。

## 日志

开放 API 使用本单元密钥处理过的每一个请求，最新在前，每页 25 条，**上一页 / 下一页**为真实翻页。未通过认证的请求无法归属业务单元，不予记录。

过滤条在服务端收窄列表——**状态类别**（2xx–5xx）、**方法**、**API 密钥**、**路径包含**。修改任何过滤条件都回到第一页。

选中一行，右侧显示详情：方法与路径、状态、**请求 ID**、时间、耗时、**IP 地址**、**API 版本**、**用户代理**、所用密钥，以及采集到的**响应主体**与**请求主体**，以格式化 JSON 展示并可复制。

<Note>
  主体是选择性采集的。只有**写操作与出错的应答**会保留主体——普通 `GET` 显示「此请求未采集主体」。单侧截断上限 **16 KB**。登录相关路径（`/auth/…`）整体存储为 `[redacted]`，验证码与令牌不写入日志。
</Note>

## Shell

浏览器里的终端：一个隔离的 Linux 沙箱，**orriven CLI 已登录并限定于所选业务单元**，另有 `curl`、`jq`、`node` 与 `python3`。无需安装，也无需 `orriven login`。

* 标签页不会自动启动——选择**启动 Shell**。当日首次启动可能需要数秒。
* 切换抽屉的业务单元即切换到该单元的会话。家目录在各会话间共享。
* 空闲 **10 分钟**后休眠。单次会话最长 **12 小时**。**结束会话**吊销该 Shell 的登录并关闭终端。Shell 会话也会出现在账号页，可从那里吊销。
* 关闭抽屉再打开，会重新连接同一会话并回放之前的输出。
* 未配置 Shell 服务的部署显示「此环境尚未启用 Shell」，其余标签页不受影响。

## 注意事项

* **一个抽屉，一次一个业务单元。** 标题旁的选择器是抽屉的范围，不是控制台的范围。
* **仅限所有者/管理员。** 抽屉各标签页与签发密钥属于同一级权限。
* **日志与主体只对本来就能用密钥读到同样数据的人可见。**
* **抽屉不是页面。** 打开抽屉不改变控制台中的当前位置。

## 相关页面

<CardGroup cols={2}>
  <Card title="API 密钥" icon="key" href="/zh/developers/api-keys">
    在抽屉中生成的 Secret 与公开密钥。
  </Card>

  <Card title="Webhook" icon="webhook" href="/zh/developers/webhooks">
    端点、签名、重试与投递记录。
  </Card>

  <Card title="命令行工具" icon="square-terminal" href="/zh/developers/cli">
    在终端中完成同样的操作。
  </Card>

  <Card title="成员与角色" icon="users" href="/zh/organization/members-roles">
    为什么抽屉只属于所有者/管理员。
  </Card>
</CardGroup>
