首次连上之后怎么用 KKCode。

发第一条提示之前

三件事决定下一条指令最终落到哪里：

1. 连接（Connection） —— 连接页展示当前服务器 URL 和用户名。绿色状态徽章说明 SSE 流是通的。
2. 项目（Project） —— Workspace 标签页展示将接收下一条请求的项目目录。当前选中的项目会跨启动保留。
3. 会话（Session） —— Chat 标签页展示当前的工作线。一条会话只承载一个完整结果，便于上下文管理与回看。

最贵的一个错误是：把对的指令发到了错的项目或错的会话。发送前一定确认项目名与会话标题。

Chat

Chat 标签页是 AI 文本、思考、工具调用、文件 I/O 的实时流。底部编辑器接受文本提示词，以及来自系统分享面板的附件。顶部的会话标题跟你在桌面 OpenCode 里看到的保持一致。

流式对话

AI 文本、思考链路、工具调用和文件读取以跟桌面同样的打字机节奏流入。如果连接断了，KKCode 用指数退避重连 SSE 流，在飞行中的工具调用从上一个服务端检查点恢复。

权限弹窗

当 OpenCode 想读文件、改文件或跑命令时，聊天里会出现一张卡片。三选一：Allow Once（本次允许）、Always（对当前项目持久允许）、Reject（拒绝）。把每次弹窗都当作一次安全决策 —— 看清楚项目、命令、路径再批准。完整威胁模型见 安全指南。

代码块与文件 diff

工具输出和文件编辑以合适的语法高亮展示。diff 用并排视图，点行号跳到源文件。Chat 内部不带文件编辑器 —— 改文件只能让 agent 改，然后你自己 review。

会话历史

所有对话都保存在开发机上。打开会话列表浏览、搜索、恢复任意一条历史线程 —— 上下文完整。要开新线，用 New Session；长按会话条目可以重命名、删除或分享 URL。

听写

用 iOS 系统键盘的听写键把提示词口述下来。KKCode 不跑免提语音循环 —— 所有听写内容都先进编辑器，你审过、编辑过再发。

Workspace

Workspace 是项目选择器。第一次连上，KKCode 会列出开发机上 OpenCode 暴露的所有项目目录。当前选中的项目就是之后每一条会话、每一个文件事件、每一个权限弹窗的归属范围，直到你切换为止。

多项目切换

点项目头切换。不同项目的会话彼此隔离，永远不会混进当前项目。这条模型边界保证了 A 项目的一次小改不会误落到 B 项目。

状态指示

顶部状态徽章实时反映 SSE 流的状态：Connected / Connecting / Error。徽章变红时，先打开连接页查清底层错误再继续发提示词。

刷新项目列表

下拉刷新项目列表。如果开发机上新增了目录，下一次刷新就会冒出来。

Settings

Settings 管外观、语言、连接和凭证重置。整个 app 跟随当前主题 —— 终端、代码块和强调色一起切换。

主题

三档：Light、Dark、Auto（跟随系统）。默认 Dark，匹配 OpenCode 终端美学。

语言

21 种语言，覆盖 shell、agent、chat 的 CJK 输入。遵循 CLDR 复数规则，缺失的 key 回退到英文。语言设置与开发机独立，可以随时切换，不用重连。

连接

编辑服务器 URL、用户名或密码。编辑不会自动触发重连 —— 点 Reconnect 才生效。Sign out 把加密凭证从设备 keystore 里清掉，下一次启动会回到连接页。

离线凭证

连接 profile 在 iOS Keychain（或 Android Keystore 背书的 SecureStore）里加密保存，可以免输入密码重连到任意已知主机。要清空，就用 Sign out 或重装 app。

KKCode 还做不到的（暂不支持）

KKCode 是聚焦的控制面板，不是完整的桌面 IDE 替代品。下面这些在当前版本里刻意没做，列出来让你不要去找：

• 推送通知。 后台送达任务完成还没实现。让 KKCode 保持在前台，或者用能保持 SSE 流活跃的远程接入路径。
• 设备上的终端 / 文件编辑 / worktree 控制。 多文件编辑、终端命令、分支管理都通过 OpenCode 本身在开发机上完成。
• Provider / 模型选择器。 Provider key 和模型选择都在开发机上 opencode serve 的配置里。KKCode 只显示服务端暴露的内容。
• MCP / LSP / 诊断面板。 可选端点因服务端而异，KKCode 不单独暴露诊断面板。

要大范围代码导航、长时间终端交互、复杂冲突解决或细致视觉审阅，请回桌面 OpenCode。手机是它的补充。