Desktop
Desktop 把工作区、会话、diff、计划、模型配置和运行状态放进同一个窗口，用图形界面驱动 Agent，不用记命令。第一次接触 DotCraft，从这里开始最省事。
下载安装、选工作区、配模型这几步见快速开始。本页讲装好之后 Desktop 能帮你做什么。
看清 Agent 做了什么
Agent 的每一步都摊在窗口里。打开一个会话就能逐条回看它读了什么、改了什么，文件改动以 diff 呈现，写文件和执行命令前会停下来等你批准。自动化与目标跑出的结果同样在这里等你过目。
想追得更细，就打开 Trace 或 Dashboard，看这次任务调用了哪些工具、花了多少 token。
回复里标了 mermaid 的代码块会直接渲染成图，渲染不出来时回落显示源码。粘进对话的图片重启后仍然保留，重新打开会话，缩略图还在。
探索交互式可视化
让 DotCraft 把对比、解释或结果做成交互式可视化，也可以直接调用 $visualize。视图会出现在回复中，不用离开对话就能操作和查看。
通过视图操作可以在确认问题内容后继续追问，也可以把当前状态复制为图片。
一个窗口里管多个项目
换一个工作区就换一个项目，配置、技能、记忆和自动化任务都跟着项目走，互不干扰。项目的记忆开关、梦境和一键重置记忆在设置 → 个性化里，它们各自管什么见长期记忆与梦境。
配好模型
在设置 → 模型提供商里添加提供商、填凭据、挑模型。凭据和 endpoint 写进个人配置 ~/.craft/config.json，不进工作区，把工作区配置分享给同事也不会带上密钥。保存前用测试确认凭据和模型列表可达。提供商不支持列出模型时，手填模型名照样能存。Desktop 目前支持 OpenAI 和 Anthropic。
这里选的模型只决定新会话的默认值。已有会话保留自己创建时的设置，也可以在它自己的输入框里单独换。Subagents 默认沿用主 Agent 的模型，需要时可以给它指定一个更快或更便宜的。
看 token 花在哪
设置 → 个人资料里有一张 Token 活动图，像 GitHub 贡献图那样按天铺开当前工作区所有会话的用量，旁边是累计 Token、单日峰值和连续使用天数。需要先为这个工作区开启 tracing，这张图才有数据。
连本地，也能连远程
默认情况下 Desktop 在本机启动或接管当前工作区的 AppServer，其他入口共用同一个进程，不用你操心。在这里开的会话也不会被锁在 Desktop 里，换个入口可以接着聊。
要连服务器上的 DotCraft，在设置 → 连接 → 工作区里填远程 AppServer 地址。保存前 Desktop 会先试连一次，连不上就不保存，下次启动也不会卡在一个坏地址上。整套服务端部署见服务器部署。
远程工具调用让 Agent 在另一台电脑上工作，对话仍留在这里。在设置 → 连接 → 卫星中完成配对，再到输入框的执行位置中选中它。连接步骤和屏幕查看方式见 DotCraft 卫星。
跟上新版本
启动时 DotCraft 会检查 GitHub Releases 有没有更新的版本。当前平台有安装包时，标题栏会出现下载按钮，点开可以看版本说明、下载并看到进度，下完 DotCraft 退出并打开安装包。
升级后第一次进入工作区会弹出一次最新功能，用动图介绍这个版本新增的能力。之后从帮助 → 最新功能或侧边栏底部的版本号可以随时再打开。