North Coder 文档
North Coder 用户操作手册。
North Coder 是本地优先的 AI coding agent，支持桌面端使用，也支持完整的浏览器远程访问。本文档面向日常用户，覆盖从安装、创建工作区、发起任务到审阅改动和远程访问的完整操作路径。
从这里开始
如果你是第一次使用，建议按下面顺序阅读：
| 目标 | 阅读 |
|---|---|
| 先跑通一次完整流程 | 快速开始 |
| 安装桌面端或 Server | 安装 |
| 连接真实代码仓库 | 项目与工作区 |
| 和 Agent 协作完成任务 | Agent 会话 |
| 先做设计再拆任务 | RFC Mode |
| 先探索代码再生成计划 | Plan Mode |
| 审阅文件和改动 | 文件与改动审阅 |
| 打开 IDE、终端或浏览器 | 外部应用 |
| 从浏览器远程访问 | 远程访问 |
| 调整模型、外观和能力 | 设置 |
常见路径
桌面客户端
桌面客户端适合在自己的电脑上处理本地项目。安装后打开 North Coder，添加项目，创建工作区，然后在会话里描述任务即可。需要在浏览器里继续查看同一个客户端时，可以通过外部应用菜单里的浏览器入口打开。
Linux Server
Linux Server 适合把 North Coder 运行在远程机器上，再通过浏览器访问。这个方式需要显式配置访问 token，并优先放在可信网络、VPN 或带 TLS 的入口后面。
Windows
Windows 使用原生桌面安装器。安装后可以直接打开本地项目，也可以结合 WSL 或远程机器处理 Linux 环境里的代码。
操作手册目录
- 快速开始：第一次启动、创建工作区和发送第一条任务。
- 项目与工作区：项目、分支、工作区、checkpoint 和归档。
- Agent 会话：消息、任务推进、模型配置和上下文。
- RFC Mode：需求澄清、RFC 设计、子任务拆分和一键执行。
- Plan Mode：只读探索、生成实现计划，并交接到执行会话。
- 文件与改动审阅：文件浏览、diff、终端、PR 和 CI 状态。
- 外部应用：打开 IDE、终端、文件管理器和浏览器。
- 远程访问：桌面客户端浏览器入口和 Linux Server 访问。
- 设置：模型、Agent 配置、技能、外观和通用设置。
- 本地日志查询：查找后端、桌面壳和 CLI daemon 日志。
- 故障排查：安装、访问、外部应用和工作区常见问题。