# cube-ide

**Repository Path**: biparadox/cube-ide

## Basic Information

- **Project Name**: cube-ide
- **Description**: cube架构的一个开源IDE环境，目前使用Zcode+GLM-5.2开发
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-19
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cube-IDE

> dev-workflow（R0→R1→R2→R3）四阶段流程的开发平台。前端 html+JavaScript 渲染界面，后端启动若干 cube hub 实例提供数据、接收命令并执行操作。

## 项目定位

cube-ide 是 [`cubeos-1.5/documents/dev-workflow/`](../cubeos-1.5/documents/dev-workflow/) 描述的开发流程的**实施平台**。把 dev-workflow 的"分区+分层"框架从纯文档操作升级为"可视化+自动化+可验证"。

- **参考架构**：[`cubeos-1.5/example/monitor_starter/`](../cubeos-1.5/example/monitor_starter/)（多 hub 实例 + WS 前端 + cmdlist 控制）
- **标准设计源**：[`cube_works_test/alicebob_monitor/R1-设计/`](../cube_works_test/alicebob_monitor/R1-设计/)（AliceBob R1 设计层 + 实现层）
- **验证对象**：AliceBob 用例（origin/teardrop/crypt/forceattack 四场景）

## 五条核心原则

| 原则 | 落地 |
|------|------|
| 1. 前端 html+js，后端多 hub 实例 | 前端纯静态；后端按角色分 hub（`ide_hub` 控制中枢） |
| 2. hub 可与 AI 也可与 console 互动 | 同源两套入口：WS（前端）+ msgfile_send（console .msg），任一可独立驱动 |
| 3. 四阶段独立 UI + 独立 hub + 中间产物落地 | workspace/projects/<case>/R0-R3/ 各阶段产物 json 落盘 |
| 4. cubeos 环境+开发目录用 json 配置 + 记录项 | `config/*.json` + `config/schema/*.schema.json` |
| 5. 不依赖大框架，OOP 设计，先定接口后实现 | 纯原生 JS（无 Vue/React）；core/components/stages 三层 |

## 目录结构

```
cube-ide/
├── config/         # 【原则4】全 json 配置 + schema 记录项定义
│   ├── env.json    # cubeos 路径 / ide_hub 端口 / 基座模块清单
│   ├── cases.json  # 用例注册表（AliceBob 四场景）
│   ├── workspace.json
│   └── schema/     # design / cube-mapping / requirements 三 schema
├── ui/             # 【原则5】纯原生 JS + OOP
│   ├── index.html  # 单页入口，R0/R1/R2/R3 切 tab
│   ├── css/main.css
│   ├── js/
│   │   ├── core/        # cube-msg / hub-client / artifact-store / event-bus
│   │   ├── components/  # trace-log / result-table / stage-panel
│   │   └── stages/      # r0/r1/r2/r3 阶段面板
│   └── mock/            # mock 响应（msg2channel 分块 bug 兜底）
├── hub/            # 【原则1/2/3】cube hub 实例 + 工作目录
│   ├── ide_hub/    # 控制中枢（本轮唯一常驻 hub）
│   └── workspace/  # 中间产物落地处（projects/<case>/R0-R3/）
├── scripts/        # 【原则2】WSL 端脚本（UI 崩溃时可独立驱动）
└── docs/           # 架构设计 / 四阶段路线 / 验证方案
```

## 当前阶段：R1（设计阶段）

- ✅ Step 1 项目骨架 + config 层
- ⏳ Step 2-7 前端 core/components/R1 面板 + ide_hub + scripts + 验证

### R1 阶段对 AliceBob 的验证

把 `cube_works_test/alicebob_monitor/R1-设计/` 的设计层 + 实现层 markdown 解析为 json 落盘到 `hub/workspace/projects/alicebob/R1/`，UI 加载展示，并通过 cmdlist_run 触发真实 alicebob_origin.sh + verify_stage1.sh 跑通 5/5 验收。

## 快速启动

```bash
# 1. WSL 端启动 ide_hub（常驻）
wsl -d Ubuntu-22.04 bash /home/player/cube_arch/cube-ide/scripts/start_ide_hub.sh

# 2. Windows 浏览器打开
#    \\wsl.localhost\Ubuntu-22.04\home\player\cube_arch\cube-ide\ui\index.html

# 3. R1 tab → 加载 AliceBob 设计 → 运行验证 → 看验收矩阵

# 备用：UI 崩溃时用 console 驱动（原则 2 fallback）
wsl -d Ubuntu-22.04 bash /home/player/cube_arch/cube-ide/scripts/console_send_msg.sh start_alicebob_r1
```

## 严格遵循的纪律（来自 monitor_starter 真实代价）

- cfg 纯 JSON 不写 `#` 注释（多块解析器对 # 不可靠）
- 启动前 CRLF→LF 强制转换
- 跨实例路由同名约束（debug_query / load_shell / run_shell）
- main_proc 按 cwd 清理（避免 pkill 误杀）
- monitor_proc 符号链接让 hub 独立 comm 名
- wait_port 替代固定 sleep（修正 monitor_starter 已知差距）
- mock 模式兜底 msg2channel 分块 bug

详见 [`docs/架构设计.md`](docs/架构设计.md) 与 [`docs/alicebob-R1验证方案.md`](docs/alicebob-R1验证方案.md)。