@changehow/oc-insight

中文文档
1.2.1发布于 2026/11/09GPL-3.0-onlyES Module近 30 天下载 2110

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

中文使用文档
文档目录5 节
  1. 盘子
  2. 从 npm( 建议)
  3. 从源
  4. OpenCode + OpenChamber 插件
  5. 主机共享实例

打开代码透视

Node pnpm

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

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

Dashboard showing usage totals, token composition, and activity trends with synthetic data

Insight panel showing generation speed, token composition, and tool timing with synthetic data

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

使用量

盘子

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

npm install -g @changehow/[email protected]
opendash server

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

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

OPENDASH_ENV=.env.local opendash server

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

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

从源

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

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。 。 。 .

pnpm build
node scripts/opendash.mjs server

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

对于活的V2会话度量,在下面安装捕获插件,然后使用 检查 OpenCode V2 会话 关于概览。 可选多机同步记录于 连接另一台机器。 。 。 .

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,保留现有条目:

{
  "$schema": "https://opencode.ai/config.json",
  "plugins": ["@changehow/[email protected]"],
}

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

npm install -g @changehow/[email protected]
opendash extension-path openchamber

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

OpenCode 必须在装入的捕获插件下运行 。 透视从不开始或重启. 见 透视指南 用于源构建、远程连接、升级和测量限制.

主机共享实例

透视 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安装的相同能力。 见 主机共享连接 对交货的限制.

许可证

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

版本与发布记录

@changehow/oc-insight 共发布 20 个版本,首次发布于 2026/08/21;过去 12 个月发布了 20 个版本。

版本发布日期距今
1.2.1latest2026/11/091 天前
1.2.02026/11/081 天前
1.1.02026/10/2317 天前
1.1.0-beta.12beta2026/10/2317 天前
1.1.0-beta.112026/10/2317 天前
1.1.0-beta.102026/10/2218 天前

关于 @changehow/oc-insight 的常见问题

@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 和提交记录判断。