zuno debug

zuno debug 回答的是"这套安装实际认为什么是真的？"它报告解析后的路径与配置、为某次 Provider 请求发送的确切提示、生效的权限规则集、某个沙箱模式是否可部署、文件搜索后端看到 什么、语言服务器报告什么，以及快照存储中持有什么。

这些都是用于诊断的读取并报告的面。当行为与配置不一致、当权限提示出现在你没预料到的地方， 或者当某个约束模式在运行时失败时，就该找它们。

用法

zuno debug [OPTIONS] <COMMAND>

选项

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

子命令

子命令	说明
paths
config
agent
prompt
permissions
skill
sandbox
rg
lsp
snapshot
help	打印本消息或给定子命令的帮助

zuno debug paths

zuno debug paths [OPTIONS]

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug config

zuno debug config [OPTIONS]

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug agent

zuno debug agent [OPTIONS] <NAME>

参数	说明
<NAME>

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug prompt

zuno debug prompt [OPTIONS]

选项	说明	默认值
--session <ID>	应显示其提示回执的 session；默认为最新的回执
-v, --version	显示 Zuno 包版本
--step <N>	所选 session 内从 1 开始计数的 Provider 请求步骤
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--show-sensitive	包含模型可见的指令、AGENTS、Skill 与记忆内容
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

--show-sensitive 会原样打印指令、AGENTS、Skill 与记忆内容。把那份输出粘贴进工单之前， 按敏感信息对待。

zuno debug permissions

zuno debug permissions [OPTIONS]

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug skill

zuno debug skill [OPTIONS]

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug sandbox

zuno debug sandbox [OPTIONS]

选项	说明	默认值
--mode <MODE>	要探测的沙箱策略；受限模式会验证 bubblewrap 的部署情况。可选值：read-only、workspace-write、danger-full-access	workspace-write
-v, --version	显示 Zuno 包版本
--network <NETWORK>	要验证的网络权限。受约束模式默认为 deny，danger-full-access 默认为 allow。可选值：deny、allow
--check	当所请求的策略不可部署时以失败状态退出
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	在这次受信调用策略下报告降级解析。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

报告会区分请求与实际的模式/网络权限，给出解析类型、降级资格和类型化原因。ready 字段与 --check 始终保持严格：具备降级资格不会让请求的约束部署通过。

zuno debug rg

zuno debug rg [OPTIONS] <COMMAND>

嵌套命令	说明
files
search
help	打印本消息或给定子命令的帮助

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug rg files

zuno debug rg files [OPTIONS]

选项	说明	默认值
--query <QUERY>
-v, --version	显示 Zuno 包版本
--glob <GLOB>
--limit <LIMIT>
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug rg search

zuno debug rg search [OPTIONS] <PATTERN>

参数	说明
<PATTERN>

选项	说明	默认值
--glob <GLOB>
-v, --version	显示 Zuno 包版本
--limit <LIMIT>
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug lsp

zuno debug lsp [OPTIONS] <COMMAND>

嵌套命令	说明
diagnostics
symbols
document-symbols
help	打印本消息或给定子命令的帮助

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug lsp diagnostics

zuno debug lsp diagnostics [OPTIONS] <FILE>

参数	说明
<FILE>

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug lsp symbols

zuno debug lsp symbols [OPTIONS] <QUERY>

参数	说明
<QUERY>

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug lsp document-symbols

zuno debug lsp document-symbols [OPTIONS] <URI>

参数	说明
<URI>

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug snapshot

zuno debug snapshot [OPTIONS] <COMMAND>

嵌套命令	说明
track
patch
diff
help	打印本消息或给定子命令的帮助

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug snapshot track

zuno debug snapshot track [OPTIONS]

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug snapshot patch

zuno debug snapshot patch [OPTIONS] <HASH>

参数	说明
<HASH>

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

zuno debug snapshot diff

zuno debug snapshot diff [OPTIONS] <HASH>

参数	说明
<HASH>

选项	说明	默认值
-v, --version	显示 Zuno 包版本
--print-logs	除结构化本地日志存储之外，同时把日志打印到 stderr
--log-level <LOG_LEVEL>	设置最低日志级别。可选值：TRACE、DEBUG、INFO、WARN、ERROR
--sandbox <SANDBOX>	为本次调用选择 Shell 约束。可选值：read-only、workspace-write、danger-full-access
--sandbox-on-unavailable <ACTION>	选择受限 Shell 无法部署时的处理方式。可选值：deny、run-unconfined	deny
-h, --help	打印帮助（用 -h 查看摘要）

示例

报告本安装解析出的数据、配置与日志路径。

zuno debug paths

当某个工具调用被意外拦下时，打印生效的权限规则集。

zuno debug permissions

验证某个约束模式是否可部署，并在不可部署时让命令失败。

zuno debug sandbox --mode read-only --check

检视为某个具体 Provider 请求步骤实际发送的提示。

zuno debug prompt --session ses_1a2b3c --step 2

参见

• 全局选项
• zuno agent
• zuno session
• zuno plugin
• 配置参考
• Harness 运行时
• 日志