# 基础

> 概览、Space、项目与房间

## 概览

*你说一句话，它把事做完；只有该你拍板的，才回到你手上。*

GenkiAI（Genki Studio）是跑在团队自己的 Space 里的 AI 工作空间。每个项目是一个代码仓库加一个团队聊天，AI 席位在里面按阶段干活：设计、开发、验收、上线、维护。Bug 和 Feature 进队列，由 Auto-Run 一条条做完，每一条都要过另一个会话的独立审查。

| 术语 | 是什么 |
| --- | --- |
| Space | 一个团队的工作空间：一台自己的主机、一组成员、一份数据，地址是 `<space>.rsi.am` |
| 项目 | 一个代码目录加一个聊天；状态写在仓库里的 STATUS / DESIGN / PLAN / VERIFY / AUDIT |
| 席位 | 一个在跑的 AI 会话，担任一个角色：Design、Dev、Chat、Review，以及每个人自己的 Assistant |
| 阶段 | DESIGN → DEVELOP → VERIFY → DEPLOY → MAINTAIN，由服务器掌握 |
| 门禁 | 阶段之间的卡片，你批准了才过 |
| 队列 | 项目的 Bug / Feature 清单 |
| Auto-Run | 把队列里的条目按「实现或查根因 → 审查 → 评分」一条条做完 |
| Assistant | 只属于你的助理，带四层记忆，能替你开新项目 |

### 一件事怎么走完

1. 你在 Assistant 里把想法聊清楚，它带着需求简报替你建项目；或者直接在项目聊天里开口。
2. DESIGN：引擎席先问关键问题，再写需求、架构、计划，A / B / C 三道门逐一等你点头。
3. DEVELOP → VERIFY → DEPLOY：按计划一个任务一个任务做，逐条验收、独立审查、发布；每换一个阶段都等你批准。
4. MAINTAIN：上线之后的新需求和 bug 进队列，Auto-Run 实现 → 审查 → 必要时评分，发现的问题回到 Dev 席再来一轮。
5. 要你决定的事以卡片出现，手机上也能点；你不在时推送给你；额度用完就原地等，恢复后接着跑。

## Space

*每个 Space 有自己的子域名、主机、成员和数据。*

- **地址**: `https://<space>.rsi.am`；门户在 `rsi.am/console`，用 Google 账号登录
- **主机**: 每个 Space 一台自己的云主机（Ubuntu 24.04，arm64），常开，不休眠
- **数据**: 每个 Space 一块自己的加密数据盘，项目、Assistant、skills 都在上面，主机本身可以替换。数据盘每天快照、保留 14 天；应用数据库每 12 小时快照一次
- **连接**: 主机主动向入口（relay）建一条出站连接，relay 按子域名转发；主机没连上就没有路由。Studio 本身只监听本机
- **relay 存什么**: 门户账号、登录会话、Space 归属和计费编号；转发经过的项目与聊天内容不落盘

### 开通

1. 准备：数据盘、这个 Space 专属的云权限、一次性的密钥包（主机读一次就删）。
2. 部署：主机启动，完成初始化。
3. 上线：主机连上 relay，Space 变为可用。

三步都显示在门户的 Space 卡片上，全自动；卡住的开通会被自动标为失败并清理。一个账号最多拥有 3 个 Space。

### 方案

|  | Standard | Pro |
| --- | --- | --- |
| 账号（含所有者） | 6 | 20 |
| 存储 | 50 GB | 200 GB |
| 实时通话 | 每人每周 60 分钟 | 每人每周 60 分钟 |
| 会议转写 | 每人每周 5 小时 | 每人每周 5 小时 |

按月订阅，可以从 Standard 升到 Pro。GenkiAI 已正式上线：任何 Google 账号登录即可创建 Space、开始使用；被某个 Space 邀请（加进团队或持有邀请）的人不用排候补，登录后在 Space 目录里就能打开那个 Space。遇到限流临时开启候补时，登录页会写明：不在名单上的人登录后看到候补页，点「加入候补」排队，账号开通时会收到邮件。

### 成员与团队

创建 Space 的人是所有者。所有者建团队、决定每个团队看得到哪些项目、按邮箱邀请成员（到方案上限为止）；内置的 Admin 团队看得到全部项目。只有所有者能直接创建项目；其他成员经自己的 Assistant 提申请，卡片弹到所有者那里，所有者一键创建，项目自动放进申请人所在的团队。

## 项目与房间

*一个项目是一个代码目录加一个团队聊天。人的消息进「对话」房，Auto-Run 和定时任务的输出进「任务」房。*

- **对话房 `chat`**: 人的消息都在这里。DESIGN 到 DEPLOY 阶段由引擎席回答，MAINTAIN 阶段由对话席回答
- **任务房 `task`**: Auto-Run 的输出和定时任务的回执；任务日志显示最近 72 小时
- **引擎席**: 跑阶段的长会话：DESIGN 用 Design 模型，DEVELOP / VERIFY / DEPLOY 用 Dev 模型；Auto-Run 的实现与修复也在这里
- **对话席**: MAINTAIN 阶段的项目对话，用 Dev 模型

项目进入 MAINTAIN 时，引擎席还没回复的消息交给对话席接着回。谁能看到一个项目由团队决定：成员只看得到分给自己团队的项目。
