# @changehow/oc-insight 中文文档

规范地址：https://npmcn.com/package/%40changehow/oc-insight/

版本：1\.2\.1
npm 元数据更新时间：2026-11-08T17:07:54.755Z
中文译文更新时间：2026-11-09T17:30:15.285Z
软件包许可：GPL-3\.0-only

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40changehow/oc-insight
原文对照：https://npmcn.com/package/%40changehow/oc-insight/?lang=original
项目主页：https://github.com/ChangeHow/opencode-insight#readme
源码仓库：https://github.com/ChangeHow/opencode-insight

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：8.9 MB，62 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24\.0\.0
- 运行依赖：9 个
- 首次发布：2026-08-21T14:11:31.984Z
- 最新版本发布：2026-11-08T17:07:54.602Z
- 近 30 天下载量：2110（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

OpenCode 会话的本地首个符号使用仪表板 .

## 安装

```sh
npm install @changehow/oc-insight
```

也可以使用：`pnpm add @changehow/oc-insight`、`yarn add @changehow/oc-insight`、`bun add @changehow/oc-insight`

## README

# 打开代码透视

[![Node](https://img.shields.io/badge/node-%E2%89%A524-026E00?logo=node.js&logoColor=white)](https://nodejs.org/) [![pnpm](https://img.shields.io/badge/pnpm-%E2%89%A510-F69220?logo=pnpm&logoColor=white)](https://pnpm.io/)

OpenCode 本地第一使用分析和会话见解.

-   **盘子 :** 探讨象征性使用、估计费用、活动趋势和模型/提供者细目。 钻入会话和消息/工具时间表,查询来自 CLI 的用法,以及可选同步跨机集合. 读取本地的 OpenCode 使用和 Codex 笔录 .
-   **OpenCode + OpenChamber 透视 :** 一个 OpenCode V2 捕获插件和一个 OpenChamber 面板,用于生成速度、上下文源估计、报告符号使用和工具时间安排。 面板的工作没有仪表板;仪表板也可以显示V2会话的洞察.

![Dashboard showing usage totals, token composition, and activity trends with synthetic data](https://raw.githubusercontent.com/ChangeHow/opencode-insight/main/docs/images/dashboard.webp)

![Insight panel showing generation speed, token composition, and tool timing with synthetic data](https://raw.githubusercontent.com/ChangeHow/opencode-insight/main/docs/images/insight.webp)

截图使用合成数据. 透视图像是实际面板的独立预览,而不是OpenChamber应用程序外壳. 源估计不是计费测量,捕获开始于插件加载时.

# 使用量

## 盘子

### 从 npm( 建议)

要求数 **节点.js 24+**。不需要进行源检出、pnpm或本地建设.

```bash
npm install -g @changehow/oc-insight@1.2.1
opendash server
```

打开 [本地主机: 8787](http://127.0.0.1:8787/)。保持默认回回转绑定:仪表板有 **无认证** 并可以显示私有会话内容.

仪表板从默认本地目录和代码记录从 `CODEX_HOME`,默认为 `~/.codex`对于自定义数据路径或同步设置,创建 `.env.local` 文档。 设定 `OPENCODE_DATA_DIR` 到您的 OpenCode 数据目录( 包含) `opencode.db` 遗产 `storage/`),然后在启动全球安装的 CLI 时明确加载文件 :

```bash
OPENDASH_ENV=.env.local opendash server
```

相对 `OPENDASH_ENV` 从运行命令的目录中解析路径。 如果守护进程已经运行, 请运行 `opendash stop` 在重新启动配置之前.

```bash
opendash summary --range month
opendash models --json
opendash stop
```

### 从源

要求数 **节点.js 24+** 财务报告和审定财务报表 **页:1**. 将这一选项用于发展或当地建筑.

```bash
git clone https://github.com/ChangeHow/opencode-insight.git
cd opencode-insight
pnpm install
cp .env.example .env.local
```

设定 `OPENCODE_DATA_DIR` 内 `.env.local` 到您的 OpenCode 数据目录( 包含) `opencode.db` 遗产 `storage/`) (中文(简体) ). 代码记录从 `CODEX_HOME`,默认为 `~/.codex`。 。 。 .

```bash
pnpm build
node scripts/opendash.mjs server
```

对于此安装, 使用 `node scripts/opendash.mjs` 替换 `opendash` 用于查询和停止上面的命令.

对于活的V2会话度量,在下面安装捕获插件,然后使用 **检查 OpenCode V2 会话** 关于概览。 可选多机同步记录于 [连接另一台机器](https://npmcn.com/package/%40changehow/oc-insight/ADD_MACHINE.md)。 。 。 .

## OpenCode + OpenChamber 插件

**透视 1.2.0** 需求 **节点.js 24+** 财务报告和审定财务报表 **开堂 2.7.0+** 用于主机共享面板。 OpenChamber 2.7.0 要求 **打开代码 2.2.4+**; 此集成用 **开放代码 2.2.5**。面板遵循 OpenChamber 选定的实例,没有主机补丁。 透视 1.1.0 取而代之的是独立连接发现.

OpenChamber可以将捆绑的捕捉插件装入它所管理的OpenCode. 对于外部管理的本地 OpenCode 或独立的仪表板,请在 `plugins` 在您的全球范围内 `~/.config/opencode/opencode.jsonc` 或项目-当地 `opencode.jsonc`,保留现有条目:

```jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "plugins": ["@changehow/oc-insight@1.2.1"],
}
```

OpenCode安装并加载捕获插件本身. 要安装 OpenChamber 面板 :

```bash
npm install -g @changehow/oc-insight@1.2.1
opendash extension-path openchamber
```

在 OpenChamber 中打开 **设置 – 扩展 – 添加**,选择打印 `openchamber/` 文件夹,并批准本地服务,读取 OpenCode,并捆绑 OpenCode 插件。 打开 **透视** 并选择一个 OpenCode 会话。 升级时, 将面板和任何单独配置的抓取插件更新到同一版本; 避免在主机管理的捆绑旁加载旧的抓取构建 .

OpenCode 必须在装入的捕获插件下运行 。 透视从不开始或重启. 见 [透视指南](https://npmcn.com/package/%40changehow/oc-insight/docs/v2-insight.md) 用于源构建、远程连接、升级和测量限制.

### 主机共享实例

**透视 1.2.0** 包括共享支持。 这需要 **开堂 2.7.0+**,与 **无主机补丁**,以及来自 **相同的透视建筑**。 。 。 .

这个 **OpenChamber 后端和 OpenCode 必须在同一台机器上运行**。浏览器可能远程连接。 在另一台机器上指向 OpenCode 的 OpenChamber 后端不支持此模式 。 小组完全遵循东道主选定的实例;它从不回到 `Service.discover()` 或者说 `connection.json`。 。 。 .

用于源安装,使用 `pnpm install` 财务报告和审定财务报表 `pnpm build:extensions`,然后安装打印的文件夹 `node scripts/opendash.mjs extension-path openchamber`. 核准上述npm安装的相同能力。 见 [主机共享连接](https://npmcn.com/package/%40changehow/oc-insight/docs/v2-insight.md#host-shared-panel) 对交货的限制.

# 许可证

版权 (C) 2026 ChangeHow. 原项目代码根据 [GNU 通用公共许可证,仅3版](https://npmcn.com/package/%40changehow/oc-insight/LICENSE) (单位:千美元)`GPL-3.0-only`) (中文(简体) ). 在分发所覆盖的版本时,提供GPL下的相应来源;私人使用和修改不需要公开披露. 供应商代理Prism代码保留其上游麻省理工学院许可证和通知 [第三次议会 NoTICES.md](https://npmcn.com/package/%40changehow/oc-insight/THIRD_PARTY_NOTICES.md)。 。 。 .

## 常见问题

### @changehow/oc-insight 是什么？

OpenCode 会话的本地首个符号使用仪表板 \.

### 如何安装 @changehow/oc-insight？

在项目目录运行 npm install @changehow/oc-insight，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 opendash，可以用 npx opendash 直接运行。

### @changehow/oc-insight 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/changehow\_\_oc-insight 是否存在。

### @changehow/oc-insight 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @changehow/oc-insight 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @changehow/oc-insight 可以商用吗？

@changehow/oc-insight 使用 GPL-3\.0-only 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以 GPL-3\.0 兼容许可开源，并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @changehow/oc-insight 的下载量有多少？

根据 npm 官方下载统计，@changehow/oc-insight 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,110 次，日均约 70 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @changehow/oc-insight 还在维护吗？

最新版本 1\.2\.1 发布于 2026/11/09（1 天前）；至今共发布 20 个版本，其中过去 12 个月发布了 20 个；首次发布于 2026/08/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。