快速开始
Zagens 是面向 DeepSeek V4 生态的 Agent Harness。同一产品族覆盖聊天、编码与文档工作流，并按任务类型切换工程向与办公向工具面。
当前公开版本：v0.8.9 — 运行在 Kernel V3（事件溯源、log-first 会话恢复）之上，亮点包括：
- 流式 UX 打磨 — 深工具循环中 transcript 不再空白；SSE 重连；紧凑 Hold 面板
- Harness 文件变更卡片 — 实时会话编辑列表（+/- 统计）；点击跳转 Diff
- 工具证据 & 意图复合工具 —
investigate/answer_from_repo/change_and_verify；引用审计 - Desktop Browser + Diff Git — 内置浏览器工具；工作区 status / changes / file-diff / 只读 PR
- Moonshot / Kimi K3 — 模型接入面板一等公民（共享 model catalog SSOT）
- 夜间队列 + Gate-as-Code — 批量任务、谓词门禁、早会 briefing
以 Windows 桌面应用 + 全平台全屏 zagens-tui 终端 UI 发布。
准备工作
- Windows 桌面： Windows 10/11 x64
- 终端 TUI 或 CLI： Windows / macOS / Linux — 下载
zagens-tui/zagens（最新zagens-v0.8.9） - DeepSeek API Key
- 用作工作区的文件夹（代码仓库或办公 inbox）
选择入口
| 入口 | 适用场景 |
|---|---|
| 桌面应用 | Windows 图形界面 — diff、replay、内嵌终端、Browser、办公模式 |
| 终端 TUI | 任意 OS 全屏终端 Agent |
| Headless CLI | 脚本、CI、serve --http、夜间队列 |
三者均运行 Kernel V3 — 见 Kernel V3 引擎。
首次启动（桌面）
从下载页获取最新 Windows 安装包。
若 SmartScreen 拦截未签名安装包，请参阅安装指引。
打开 Zagens，填入 API Key（或在设置 → 模型配置多提供商），选择任务类型：
- 代码 — 终端、diff、重构、测试、Browser
- 办公 — 读表、联网检索，交付 DOCX / XLSX / PPTX / PDF
选型说明见任务类型。
为会话选择工作区目录。
（代码模式推荐） 侧栏打开 沙箱，完成首次向导 — 提升沙箱（需 UAC）或非提升沙箱。详见 Windows 沙箱。
首次启动（TUI）
zagens-tui # 引导 + 恢复上次会话
zagens-tui --fresh # 新会话
布局、composer 快捷键与 slash 命令见 终端 TUI。
熟悉界面
- 桌面： 界面导览 — 图标栏、对话时间线、工作区、Browser、夜间队列。
- TUI： 三栏 — 会话、transcript/composer、inspector + LHT pane。
下一步
| 目标 | 文档 |
|---|---|
| 引擎与恢复 | Kernel V3 |
| 安全与 shell | Windows 沙箱 · 执行策略 |
| 工程开发 | 代码模式 · 内置浏览器 · 内嵌终端 |
| 批量与门禁 | 夜间队列 · Gate-as-Code |
| 文档办公 | 办公模式 · P0 示范 |
| 终端优先 | 终端 TUI · Headless CLI |
| 自动化 | Hooks · 定时任务 |
| 排错 | 常见问题 · Agent 体检 |