openchamber --port 8080              # 自定义端口
openchamber --ui-password secret     # 使用密码保护 UI
openchamber tunnel help              # 隧道生命周期管理命令
openchamber tunnel providers         # 查看各提供商的功能
openchamber tunnel profile add --provider cloudflare --mode managed-remote --name prod-main --hostname app.example.com --token <token>
openchamber tunnel start --profile prod-main
openchamber tunnel start --provider cloudflare --mode quick --qr
openchamber tunnel start --provider cloudflare --mode managed-local --config ~/.cloudflared/config.yml
openchamber tunnel status --all      # 显示所有实例的隧道状态
openchamber tunnel stop --port 3000  # 仅停止隧道（服务器继续运行）
openchamber logs                     # 查看最新实例的日志
OPENCODE_PORT=4096 OPENCODE_SKIP_START=true openchamber                    # 连接到外部 OpenCode 服务器
OPENCODE_HOST=https://myhost:4096 OPENCODE_SKIP_START=true openchamber  # 通过自定义主机/HTTPS 连接
openchamber stop                     # 停止服务器
openchamber update                   # 更新到最新版本

连接到现有 OpenCode 服务器：

OPENCODE_PORT=4096 OPENCODE_SKIP_START=true openchamber
OPENCODE_HOST=https://myhost:4096 OPENCODE_SKIP_START=true openchamber

将托管的 OpenCode 服务器绑定到所有网络接口（仅限于可信网络）：

OPENCHAMBER_OPENCODE_HOSTNAME=0.0.0.0 openchamber --port 3000

将 OpenChamber 和 OpenCode 分别作为持久化服务运行——这在您希望通过 VPN（例如 Tailscale）或局域网访问开发机器时非常有用，而无需使用 Cloudflare 隧道。

工作原理：

• OpenCode 以独立服务运行，仅绑定到 localhost。
• OpenChamber 通过 OPENCODE_HOST 连接到它，并使用 --host 0.0.0.0 使其可通过您的 VPN IP 地址访问。
• --foreground 使 CLI 进程保持运行，以便 systemd 能够跟踪并重启它。

~/.config/systemd/user/opencode.service

[Unit]
Description=OpenCode 服务器

[Service]
Type=simple
ExecStart=opencode serve --port 4095
Environment="PATH=/home/linuxbrew/.linuxbrew/bin:/home/linuxbrew/.linuxbrew/sbin:/home/YOU/.local/bin:/home/YOU/.npm-global/bin:/usr/local/bin:/usr/bin:/bin"
Environment=SSH_AUTH_SOCK=%t/ssh-agent.socket
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

为什么要设置 PATH 和 SSH_AUTH_SOCK？ systemd 用户服务启动时环境较为简单，不会加载 shell 配置文件。 如果不显式设置 PATH，OpenCode 将无法找到通过 Homebrew、npm 或 ~/.local/bin 安装的工具。 如果没有 SSH_AUTH_SOCK，通过 SSH 执行的 Git 操作（推送、拉取、克隆）将会失败，因为代理套接字未被继承。 请根据您自己的工具安装路径调整 PATH。 %t 会扩展为 $XDG_RUNTIME_DIR（例如 /run/user/1000），大多数 SSH 代理会将套接字写入该目录。

~/.config/systemd/user/openchamber.service

[Unit]
Description=OpenChamber Web 服务器
After=opencode.service

[Service]
Type=simple
ExecStart=openchamber serve --port 3000 --host 0.0.0.0 --ui-password your-password --foreground
Environment="OPENCODE_HOST=http://localhost:4095"
Environment="OPENCODE_SKIP_START=true"
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

systemctl --user daemon-reload
systemctl --user enable --now opencode openchamber

OpenChamber 将可通过 http://<your-vpn-hostname>:3000 在您的 VPN 网络中的任何设备上访问。

注意： --host 0.0.0.0 是必需的，用于监听所有网络接口。默认绑定地址是 127.0.0.1（仅限 localhost）。如果需要绑定到特定接口，可以使用 --host <ip> 或 OPENCHAMBER_HOST=<ip>。

docker compose up -d

服务将在 http://localhost:3000 提供。

UI 密码：

environment:
  UI_PASSWORD: your_secure_password

Cloudflare 隧道（可选）：

environment:
  OPENCHAMBER_TUNNEL_MODE: quick # quick | managed-remote | managed-local
  OPENCHAMBER_TUNNEL_PROVIDER: cloudflare

对于 managed-remote 模式，请提供：

environment:
  OPENCHAMBER_TUNNEL_MODE: managed-remote
  OPENCHAMBER_TUNNEL_HOSTNAME: app.example.com
  OPENCHAMBER_TUNNEL_TOKEN: <token>

对于 managed-local 模式，可选择性地提供：

environment:
  OPENCHAMBER_TUNNEL_MODE: managed-local
  OPENCHAMBER_TUNNEL_CONFIG: /home/openchamber/.cloudflared/config.yml

关于 managed-local 的说明：OPENCHAMBER_TUNNEL_CONFIG 必须指向容器用户主目录内的路径（例如 /home/openchamber/...）。如果您的 Cloudflare 配置引用了凭据 JSON 文件，则该文件路径也必须在容器内可访问（需通过 volumes 挂载）。

隧道行为注意事项

• OpenChamber 支持每个运行实例（即每个端口）同时运行一个活动隧道。
• 在同一实例上启动不同模式或不同提供商的隧道会替换当前隧道。
• 替换或停止隧道会导致现有连接链接失效，并使该实例的远程隧道会话无效。
• 连接链接是一次性令牌；生成新链接会撤销之前的未使用链接。

数据目录权限说明： data/ 目录会被挂载到容器中，用于持久化存储（配置、会话、SSH 密钥、工作区）。在运行之前，请确保该目录存在并具有正确的权限：

mkdir -p data/openchamber data/opencode/share data/opencode/config data/ssh
chown -R 1000:1000 data/

SSH/Git： 如果 Git 推送/拉取失败，请在终端中运行 ssh -T git@github.com。

• 可分支的聊天时间线，支持 /undo、/redo 以及从任意回合一键分叉
• 多智能体协作，通过隔离的工作树实现安全并行比较
• 语音模式，支持语音输入和朗读回复，满足免提工作流需求
• 计划/构建模式，配备专门的计划视图，便于草拟和迭代步骤
• 在差异、文件和计划中直接添加评论草稿，将反馈发送回智能体
• 通过前缀 ! 启用 Shell 模式，并显示内联输出
• 支持将消息分享为图片
• 内嵌 Mermaid 图表渲染，提供复制和下载功能
• 针对差异、文件操作、权限和任务进度的智能工具界面

• 完整的 Git 侧边栏，包含暂存、提交、推送/拉取、分支管理以及变基/合并流程
• 自动化创建 Pull Request，支持 AI 生成描述、状态检查和合并操作
• 可从 GitHub 问题和 Pull Request 中启动会话，并自动加载上下文
• 支持多远程仓库推送及分叉感知的 PR 创建
• 工作树集成：每个分支独立会话，合并时可处理冲突
• Git 用户身份、gitmoji 支持以及多账号 GitHub 身份验证

• 工作区文件浏览器，支持内联编辑、语法高亮和 Markdown 预览
• 美观的差异查看器，提供堆叠式/内联式两种模式，并针对大型变更集采用懒加载
• 集成终端，支持按目录划分会话、标签页界面以及稳定处理大量输出
• 消息中可点击文件路径，直接跳转到指定行位置
• 所有视图中均显示文件类型图标，方便快速浏览

• Cloudflare 隧道，提供快速托管远程、托管本地模式，支持安全的一次性连接链接和二维码引导
• 移动优先设计：优化聊天控件、键盘友好布局，支持拖拽重新排序项目
• 后台通知与跨标签页会话跟踪
• 自我更新 + 重启流程，确保服务器设置保持不变
• 可安装为 PWA，具备项目感知命名功能

• 通过 SSH 连接到远程 OpenChamber 实例，拥有专用的生命周期管理流程
• 项目操作：运行开发服务器、SSH 端口转发、在本地打开远程 URL
• 多窗口支持，便于并行处理多个项目
• “在…中打开”快捷方式，适用于 Finder、终端及您首选的编辑器
• 快速切换本地与远程实例
• 原生 macOS 菜单、深度链接处理以及精美的启动体验

• 编辑器原生集成：从工具输出中打开文件，让会话与代码并排显示
• 智能体管理器，支持从单个提示中并行运行多模型
• 右键操作：添加上下文、解释选区、就地改进代码
• 会话编辑器面板，响应式布局，并可根据您的编辑器主题进行映射
• 编辑风格的工具结果会直接在聚焦的差异视图中打开

• 内置 18 种以上主题，支持浅色/深色变体
• 可通过 ~/.config/openchamber/themes/ 目录下的 JSON 文件自定义主题，支持热重载，无需重启
• 可配置的聊天、面板和服务相关的快捷键
• 字体大小、间距、圆角半径和布局控制
• 可自定义项目图标，支持上传自定义图标并自动发现 Favicon
• 技能目录及本地技能管理，用于可复用的自动化流程

阅读指南：自定义主题

• 会话面板展示 Token 使用量、费用明细及原始消息内容
• 跨多个服务提供商的使用配额跟踪，提供速率和预测指标
• 支持通过快捷键循环选择常用模型
• 会话文件夹及子文件夹支持拖拽排序
• 每个项目可保存持久化的笔记和待办事项
• 会话级草稿持久化，并提供扩展专注模式以应对较长的提示