v1.0 指南

OpenChamber
新手使用教程

OpenChamber 是基于 OpenCode 构建的 AI 辅助开发平台，支持项目管理、智能会话、定时任务等功能，帮助你更高效地与 AI 协作完成软件工程任务。

📁

项目管理

为每个工作区创建独立项目，隔离配置与上下文

💬

多会话

同时运行多个会话，各自拥有独立的对话历史

🤖

智能体

内置多种角色智能体，适应不同开发场景

⏰

定时任务

按计划自动执行 AI 任务，无需人工值守

📦 安装与环境

前置条件

确保已安装以下工具：

安装 OpenChamber

# 全局安装
npm install -g openchamber

# 验证安装
openchamber --versionTerminal
💡 提示

建议使用 pnpm 安装，速度更快且磁盘占用更少。

🚀 首次运行

1

进入工作目录

导航到你想要管理的代码项目根目录。

cd ~/projects/my-appTerminal
2

启动 OpenChamber

在终端中直接运行命令，进入交互式界面。

openchamberTerminal
3

选择智能体

首次启动时，系统会提示你选择默认智能体。可以根据需求选择 build、general 或其他角色。

4

开始对话

输入你的需求，AI 将自动分析代码库并给出建议或执行操作。

📁 项目 (Projects)

项目是 OpenChamber 的组织单元。每个项目拥有独立的配置文件和上下文，方便在不同工作区之间切换。

常用项目命令

# 列出所有项目
openchamber projects list

# 查看当前项目配置
openchamber projects showTerminal
💡 提示

项目配置通常存储在项目根目录的 .opencode/ 文件夹中，可以在不同项目间共享相同配置模板。

💬 会话 (Sessions)

会话是与 AI 的一次独立对话，每个会话拥有独立的上下文和对话历史。

会话管理命令

# 列出所有会话
openchamber session list

# 创建新会话
openchamber session create --name "bug-fix-001"

# 进入指定会话
openchamber session send --session-id abc123 --prompt "修复登录接口的 bug"Terminal
⚠️ 注意

会话数据默认保存在本地，建议定期备份重要的对话历史。

🤖 智能体 (Agents)

智能体是不同角色的 AI 助手，每个智能体拥有独特的行为模式和专长领域。

智能体 用途 适用场景
build 代码构建与编译 解决编译错误、构建配置
general 通用开发任务 日常编码、代码审查
customize-opencode 配置与定制 修改 OpenCode 自身配置 
# 查看可用智能体
openchamber models list

# 设置默认智能体
openchamber models set --default buildTerminal

⏰ 定时任务

定时任务允许你在指定时间自动执行 AI 提示，实现无人值守的自动化开发工作流。

# 创建每日定时任务（每天早上9点运行）
openchamber schedule create \
  --name "daily-review" \
  --daily "09:00" \
  --prompt "检查代码仓库中的潜在问题" \
  --model general

# 列出所有定时任务
openchamber schedule list

# 立即执行某个任务
openchamber schedule run --task-id daily-review

# 启用/禁用任务
openchamber schedule toggle --task-id daily-reviewTerminal
💡 提示

支持 cron 表达式、每天固定时间、每周特定日期等多种调度方式。

⌨️ 命令速查表

命令 说明
openchamber --help显示帮助信息
openchamber --version查看版本号
openchamber session create创建新会话
openchamber session list列出所有会话
openchamber session send向会话发送消息
openchamber schedule create创建定时任务
openchamber schedule list列出定时任务
openchamber schedule run立即运行定时任务
openchamber models list查看可用模型
openchamber models set设置默认模型

✨ 实用技巧

1

使用 Fork 复制会话

通过 session fork 可以基于已有会话创建分支，保留历史上下文的同时尝试不同方向。

2

明确描述你的需求

提供更具体的上下文（文件路径、错误信息、期望行为）能让 AI 给出更精准的响应。

3

善用配置模板

将常用配置保存到 .opencode/ 目录下，新项目可以直接复用，保持团队一致性。

4

组合使用定时任务

可以设置定时代码审查、自动生成文档等任务，让 AI 在后台持续工作。