# @debugbundle/cli 中文文档

规范地址：https://npmcn.com/package/%40debugbundle/cli/

版本：1\.24\.0
npm 元数据更新时间：2026-11-11T23:22:29.838Z
中文译文更新时间：2026-11-12T02:44:48.670Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40debugbundle/cli
原文对照：https://npmcn.com/package/%40debugbundle/cli/?lang=original
项目主页：https://debugbundle.com/docs/cli
源码仓库：https://github.com/debugbundle/debugbundle

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

- 包体积（解压后）：3.6 MB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22 \<27
- 运行依赖：1 个
- 首次发布：2026-05-06T10:39:32.762Z
- 最新版本发布：2026-11-11T23:22:29.466Z
- 近 30 天下载量：3174（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：61（近 12 个月 61 个）

## 中文简介

调试程序的命令行接口

## 安装

```sh
npm install @debugbundle/cli
```

也可以使用：`pnpm add @debugbundle/cli`、`yarn add @debugbundle/cli`、`bun add @debugbundle/cli`

## README

# @ debugbundle/ cli (英语)

## 1.19.4 当地文物安全

保存的捆绑和复制路径必须保存在他们的克恩克当地文物中 目录. 不安全元数据返回 `invalid_local_artifact_path` 没有阅读, 重写或删除无关的文件 。 链接文件/ 指令失败 . 当地正常商店及其现有规模津贴得到保留;当地州 和处理写作 使用小心的原子替换。 这将取代先前的客户端 .

## 1.19.3 云缓存安全

在云请求和缓存写出之前,升级为 1.19.3,用于事件ID验证. 不安全的身份证返回 `invalid_incident_id`;UUID和现有的不透明ID仍然支持. Cloud 缓存读取、写取和保留 拒绝符号链接; 写出使用注意的 原子替换。 这纠正了早期客户端的路径倒转.

## 1.19.2 安装指导

优先每个系统一个项目跨越服务库,重新使用现有连接,并为不同的访问或隐私政策保留单独的项目. 在第一次连接之前检查已有的项目;名称匹配不会推断系统成员.

## 1.19.1 当地关联安全

追踪关联只在同一个项目和环境内交叉服务. 如果旧缓存包含混合保留源事件,则读取并递增 处理失败 `local_incident_scope_mismatch`保护当地商店, 并使用 `debugbundle process --preset <minimal|balanced|investigative>` 与预期 抓取预设。 重建当地事件/艺术状态 不更改云记录或保留的事件文件.

已连接 `doctor` 诊断检查API的健康,并用一个事件探测器保存了访问权限的验证,仅限于 `cloud_project_id`。在提出任何请求之前,缺失或空白连接的项目范围失败。 事件内容被丢弃,不列入报告. 本地独有的诊断不求云.

在一个相连的工作空间, `debugbundle incidents` 财务报告和审定财务报表 `--source cloud` 默认 他们的云请求连接的 `cloud_project_id`。 。 。 . `--project-id <id>` 覆盖默认值。 所有云页保留所选项目; 本地 证据保持其现有的选择。 无法连接的项目返回 `invalid_local_connection_config` 名单请求前:通过预定 `--project-id` 或修复连接。 全账户继续得到支持 在连接的工作空间之外.

DebugBundle 的命令行接口.

通知偏好支助账户和项目范围、个人电子邮件或共享 目的地,每个频道暂停/重播,以及每日带有本地时间和时区的电子邮件. 使用 `debugbundle --help` 编辑 [通知 CLI 指南](https://debugbundle.com/docs/cli/alerts/)。 。 。 .

## 安装

```sh
npm install -g @debugbundle/cli
```

所支持的Node.js版本:22.x至 26.x.

无法读取的响应、 连接丢失或服务器错误 事件/改进生命周期撰写报告 `mutation_outcome_unconfirmed`。 。 。 . JSON 输出包括 `outcome: "unknown"` 财务报告和审定财务报表 `retry_safe: false`; 退出代码 1 表示无法确认, 而非写入失败 。 检查当前 状态在重试前为读取。 CLI 不自动重复写作 . 如果本地缓存更新失败, 确认的云结果仍然成功 ; 事件带有 `cache_warning: "cloud_cache_update_unavailable"`。 。 。 . `doctor` 当其报告含有错误时, 退出 1 ; 仍然只有警告的报告 0号出口. `doctor --auth-file <path>` 能够检查已明确保存的登录.

检查已安装的 CLI 版本 `debugbundle --version` 或者说 `debugbundle -v`。 。 。 .

或安装为项目开发依赖:

```sh
npm install --save-dev @debugbundle/cli
```

## 快开始

```sh
debugbundle setup --non-interactive
debugbundle doctor --privacy
debugbundle verify local
debugbundle verify cloud --project-id <id> --trigger-5xx
debugbundle verify cloud --project-id <id> --trigger-4xx 403
debugbundle process
debugbundle incidents
debugbundle explain <incident-id> --source cloud
```

## 代理意识设置

```sh
debugbundle setup --agent codex --agent claude-code --agent gemini-cli --agent muse-code --non-interactive
debugbundle doctor --json
debugbundle validate --fix --json
```

互动设置服务被检测为默认代理 。 重复 `--agent` 以明确选择集成; JSON/非交互运行从不提示或推断出新的代理。 所保存的选择被再利用 。 编码、双子星CLI和Muse代码发现 `.agents/skills/debugbundle/` 直接说 Claude 代码接收到一个相对链接 `.claude/skills/debugbundle/`,在无法链接时带有自有副本倒置。 仅管理所选的本地指令文件;保留了现有的引用/进口.

保留 `.debugbundle/agent-setup.json` 以克能为能. 它储存所有权散列和选择,没有证书。 医生和鉴定报告 犬科健康与本地发现分开。 修理刷新未变的生成文物,并保存用户编辑,供人工审查. 重复设置保存被审查的剖面和云连接. 未知的遗留文件被保留;准确的已知的1.10.0模板可以安全地升级.

`debugbundle setup --agent none --non-interactive` 仅去除未变的自有本地融合,同时保留犬科技能和配置. 已编辑的冲突依然存在并需要审查。 烂透了 `.debugbundle/agent-setup.lock` 只有在确认没有运行设置/修复后才能删除.

Muse 代码使用 `--agent muse-code` (代理可执行文件是: `muse`) (中文(简体) ). 它尊重Muse现有的教学优先,创建 `AGENTS.md` 仅当没有支持的指令文件时,并安全地与其他代理共享拥有的块。 检测用途 `.muse` 项目证据; `AGENTS.md` 单选不选择 Muse 。 在等待项目技能加载前信任 Muse 的寄存器, 然后检查 `muse skills list --source project --json`。 。 。 .

可移植插件技能补充了项目的简介和工作流程. 设置不会安装插件,配置MCP,或更改认证. 工程插件设置是提示; 博士不会证明正在运行的代理已装入技能 。 设置后重新启动/ 重新装入代理 。 见 [完整合同和回滚指导](https://github.com/debugbundle/debugbundle/blob/main/spec/agent-aware-cli-setup.md)。 。 。 .

## 配置

CLI 读取本地工程配置 `.debugbundle/` ,并可用于连接的云操作使用访问端验证. 使用 `debugbundle connect` 来配置云访问,或通过 `--auth-file` 以命令支持显式认证状态.

## 公共状况页面

拥有者可以通过稳定的公共联系,公布自己项目的某些健康检查:

```sh
debugbundle health status get --project-id <id> --json
debugbundle health status options --project-id <id> --json
debugbundle health status save --project-id <id> --settings-json '<settings>' --json
debugbundle health status preview --project-id <id> --json
```

设置包含 `title`, (中文(简体) ), `enabled` 和明确 `projects` 条目为 `project_id` 财务报告和审定财务报表 `check_ids`保存为 `enabled: false` 在保留 URL 时撤销. 只有选定的名称和总可用性是公开的;端点 URL 和 诊断要保密 新支票仍为私人支票。 使用访问脚本认证 并且只根据主人的指示出版。 见 [状态页面指南](https://debugbundle.com/docs/availability-checks/)。 。 。 .

## 分析对话框

公共项目流量支持不同地点的客户确定的购置和激活步骤, 认证页面和应用程序。 阅读定义和汇总报告:

```bash
debugbundle analytics flows list --project <project-id> --json
debugbundle analytics flows report --project <project-id> --key onboarding --window 30d --json
```

业主/管理人员可以使用 `analytics flows save --project <project-id> --definition-json '<JSON>'` 财务报告和审定财务报表 `analytics flows archive --project <project-id> --key onboarding`见 [流动合同](https://debugbundle.com/docs/api/analytics/#public-acquisition-and-activation-flows) 定义、捕获、UTC全天报告窗口和部分覆盖.

Analytics 命令需要连接到的 Access-token 认证,以及一个启用 AnalyticsBundle 的工程. 他们查询集合卷或要求同步分析文物;他们不读取原始分析事件.

```sh
debugbundle analytics filter-options --project <project-id> --last 7d --json
debugbundle analytics summary --project <project-id> --last 7d
debugbundle analytics devices --project <project-id> --last 7d
debugbundle analytics journeys --project <project-id> --last 7d
debugbundle analytics opportunities --project <project-id>
debugbundle analytics opportunities --all-projects
debugbundle analytics bundle create --project <project-id> --kind journey_friction --last 7d
debugbundle analytics bundle list --project <project-id>
debugbundle analytics bundle list --all-projects
debugbundle analytics saved-funnels list --project <project-id>
debugbundle analytics saved-funnels create --project <project-id> --key signup --name "Signup" --steps-json '[{"step_key":"landing","display_name":"Landing"},{"step_key":"complete","display_name":"Complete"}]'
```

`analytics filter-options` 列出选定时间、颗粒性和服务/环境的已观测到的路由/分解选择。 每一集的界限 `values` (单位:千美元) `truncated` 标记; 包含当前核准的自定义密钥。 空集没有可用的选择 。 不安全的文字被省略而不是更改. 此读作不产生捆绑或消耗生成配额 .

使用 `debugbundle analytics settings get --project <project-id>` 检查可用性和捕获/保留设置。 拥有者和管理者可以通过 `debugbundle analytics settings set --project <project-id> --enabled true`;团队项目可以额外管理批准的定制层面. 被保存的漏斗是可重复使用的项目定义,而不是每访问包;成员可以列出它们,所有者/管理员可以创建,更新,或者将其存档于独立的分级封顶. 项目令牌仍然是SDK-摄入的,不能读取分析.

## 文档

完整的CLI文档 : [https://debugbundle.com/docs/cli (中文(简体) )](https://debugbundle.com/docs/cli)

## 许可证

阿帕奇 - 2.0

## 常见问题

### @debugbundle/cli 是什么？

调试程序的命令行接口

### 如何安装 @debugbundle/cli？

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

### @debugbundle/cli 支持 TypeScript 吗？

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

### @debugbundle/cli 支持 ESM 还是 CommonJS？

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

### @debugbundle/cli 需要什么版本的 Node\.js？

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

### @debugbundle/cli 可以商用吗？

@debugbundle/cli 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @debugbundle/cli 的下载量有多少？

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

### @debugbundle/cli 还在维护吗？

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