@ 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 指南。 。 。 .
安装
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。 。 。 .
或安装为项目开发依赖:
npm install --save-dev @debugbundle/cli
快开始
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
代理意识设置
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,或更改认证. 工程插件设置是提示; 博士不会证明正在运行的代理已装入技能 。 设置后重新启动/ 重新装入代理 。 见 完整合同和回滚指导。 。 。 .
配置
CLI 读取本地工程配置 .debugbundle/ ,并可用于连接的云操作使用访问端验证. 使用 debugbundle connect 来配置云访问,或通过 --auth-file 以命令支持显式认证状态.
公共状况页面
拥有者可以通过稳定的公共联系,公布自己项目的某些健康检查:
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 和
诊断要保密 新支票仍为私人支票。 使用访问脚本认证
并且只根据主人的指示出版。 见
状态页面指南。 。 。 .
分析对话框
公共项目流量支持不同地点的客户确定的购置和激活步骤, 认证页面和应用程序。 阅读定义和汇总报告:
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见
流动合同
定义、捕获、UTC全天报告窗口和部分覆盖.
Analytics 命令需要连接到的 Access-token 认证,以及一个启用 AnalyticsBundle 的工程. 他们查询集合卷或要求同步分析文物;他们不读取原始分析事件.
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 (中文(简体) )
许可证
阿帕奇 - 2.0