Desktop
设置地图、Files / Git / Browser、市场、自动化，以及本机 Web Host 配对。
Desktop 是图形宿主。它与 CLI 共用本机守护进程。安装见 安装 Desktop。
设置地图
基础
| 标签 | 内容 |
|---|---|
| 通用 | 通知、托盘 / 菜单栏图标 |
| 外观 | 主题、字体、界面语言、云母 / 模糊、指针 |
能力
| 标签 | 内容 |
|---|---|
| 模型 | 提供商连接、模型列表、Key |
| 智能体 | LSP、Commit / PR 署名 |
| Tab | 编辑器 Tab 补全 |
| Skills | 发现和生成 Skills |
| 规则 | Rules 槽位 |
| MCPs | MCP 服务器 |
| Hooks | Hooks |
| 梦境 | 梦境（Beta） |
连接
| 标签 | 内容 |
|---|---|
| 网络 | LLM HTTP 版本、Web 远程访问 |
| 集成 | GitHub Device Login |
| 扩展 | 已装扩展、ZIP 导入 |
Developer 标签只在 Vite 开发构建里出现。
工作区面板
| 标签 | 作用 |
|---|---|
| Files | 文件树、Monaco、Markdown 预览、plans/ |
| Git | 变更、历史、commit / push / merge chip |
| Browser | 嵌入浏览器 + 元素选取（仅 Electron） |
| Shell | 嵌入 PTY（仅 Electron） |
Shell
Desktop（仅 Electron）有 Shell 标签和嵌入式 PTY。那是给你用的。Agent 仍然走 shell 和审批，不会往你的 PTY 里打字。
CLI 没有嵌入式 PTY 面板。命令仍通过共用守护进程上的同一个 shell 工具执行。
需要指定 Desktop PTY 的 shell 时，用 SPIRIT_TERMINAL_SHELL。
Git
Git 标签显示变更和历史。输入框上的 chip 可以发起 commit、push 或 merge。这是宿主 UI，不是 Skill 包。
Chip 会注入固定提示。随后 Agent 用工作区和 shell 工具。
LSP
到 设置 → 智能体 打开语言服务器，缺哪个提供商就装哪个。装好后 Agent 可用 get_diagnostics。
| Id | 语言 | 安装方式 |
|---|---|---|
typescript-language-server | TypeScript、JavaScript | npm（typescript-language-server） |
pyright | Python | npm（pyright） |
gopls | Go | Go 工具链 |
rust-analyzer | Rust | rustup |
clangd | C、C++ | 平台包（例如 Homebrew 或 winget） |
jdtls | Java | 手动 |
omnisharp | C# | .NET |
clangd 和 jdtls 不随包装。自己装好，再回到 设置 → 智能体。
Tab
Tab 是 Monaco 内联补全，按一次 Tab 接受幽灵文字。到 设置 → Tab 打开代码补全（codeCompletionEnabled），并在 设置 → 模型 指定轻量对话模型。这个槽位也给其他轻量后台任务用。
没有建议时，检查轻量对话模型是否已连接，以及开关是否打开。这不是 Agent 对话。
市场与自动化
Web Host 配对
Desktop 可以在本机给 Web 客户端提供服务。
- 默认监听：
127.0.0.1:7788 - 设置 → 网络 → Web 远程访问
- 首次访问要输入该设置页上的 6 位配对码
- 失败 5 次会锁定，直到你重启 Web Host
- Token 存在浏览器的
spirit-agent-web-host-token
Agent 仍在共用守护进程里跑。Web 客户端拿到的是已鉴权快照，不是第二套 Agent。
把 0.0.0.0 绑出去做远程局域网访问，不是已开放的产品路径。 守护进程和 Web Host 默认留在 loopback。网络设置里的局域网 IPv4 是给你控制的那台机器，不是公网服务器。
开发覆盖：SPIRIT_DESKTOP_WEB_HOST=1、SPIRIT_WEB_HOST、SPIRIT_WEB_PORT。