常见问题
代码模式 vs 办公模式
| 代码 | 办公 | |
|---|---|---|
| 目标 | 仓库/工作区内工程任务 | DOCX/XLSX/PPTX 交付物 |
| Shell | 有（启用时） | 无 |
| 终端 | 有 | 无 |
| Browser | 有（桌面） | 通常不用 |
| 典型产出 | 修改后的源码 | deliverables/ 文档 |
Agent 提示 browser_host_missing
内置浏览器仅存在于 Windows 桌面。请先打开侧栏 浏览器（或 Ctrl+Shift+B），再让 Agent 调用 browser_*。TUI/CLI 无此宿主。见内置浏览器。
夜间队列和定时任务有何区别？
- 夜间队列：工作区内一批 pending Agent 任务 + Gate 验收（侧栏或
zagens queue）。 - 定时任务：按 RRULE 触发 — 可入队后台 Task，也可「夜间队列入队 / 运行夜间队列」。
Agent 体检是什么？
侧栏 Agent 体检 = 本机工具/harness telemetry 只读报告，与 zagens doctor --tools 同源。见 Agent 体检。
Runtime 未连接 / 文档 API 500
官网文档 API 需前后端一起跑。在 zagens_website 仓库根目录执行 npm run dev。仅跑 frontend 会连接失败。
桌面应用请查看侧栏连接状态 — runtime 侧车须在 localhost 运行。
SmartScreen 与未签名安装包 {#smartscreen}
安装包尚未 Authenticode 签名。推荐： 下载 zip → 属性解除锁定 → 解压安装，通常可避开 SmartScreen。
详见 SmartScreen 安装指引。
Windows 沙箱（v0.7.4+）
Agent 能访问整台电脑吗？
在 Windows 上，exec_shell 可走 OS 级沙箱（受限 Token + ACL + WFP），而非裸用户权限。推荐完成侧栏 沙箱 首次向导并选用 Elevated 模式；配合 workspace-write 与工具审批。详见 Windows 沙箱。
Elevated 和 Unelevated 区别？
Elevated 需一次性 UAC setup，提供工作区外写保护、profile 读隔离与 WFP 出站控制。Unelevated 无需管理员，仅有工作区写隔离，不能隔离 .ssh 等 profile 读取。
Linux 也有同样沙箱吗？
Linux 当前为 degraded（策略已声明，OS 强制待完善）。macOS 使用 Seatbelt。
CLI 与桌面
只有 Windows 桌面包吗？ macOS / Linux 请用 zagens-tui（全屏终端 UI）和/或 Headless CLI（zagens）— 三者共用 Kernel V3 与 ~/.zagens/config.toml。见 终端 TUI、Headless CLI与安装指引。
更新
应用内更新读取 CDN 的 latest.json。见应用内更新与下载页。当前文档对齐产品线 v0.8.9。
API Key 存储
密钥保存在本机。Zagens 默认使用 ~/.zagens/config.toml；从旧版 deepseek-tui 迁移时也可能读取 ~/.deepseek/config.toml。多提供商可在 设置 → 模型 配置。见隐私摘要与隐私政策。
工作区与交付物
- 代码： 工作区指向 git 仓库根。
- 办公： 使用
inbox/、data/、deliverables/— 办公工作区。
支持
反馈请发邮件至 didclawapp@gmail.com。