03-10~12:项目立项与 PRD 形成¶
Dad 的关键产品决策¶
从像素风网页到 RTS 游戏界面¶
03-10 背景:最初目标是做一个"项目管理平台",基于 shadcn/ui 设计。
03-11 转折: - Dad 对初版反馈"太简单""太普通,看不出项目更新感" - 明确要求:不要传统企业 Admin Dashboard,要突出"研究型项目"氛围 - 最终定调:把整个 OpenClaw 系统可视化成类似 Age of Empires / RTS 的游戏界面
关键语录:
"目标不是'像素字体网页',而是真正有游戏感的系统操作界面"
技术路线选择¶
放弃 Next.js 的原因: - Next.js 16 / Turbopack 在当前服务器环境构建卡死 - 响应慢、难以稳定部署 - 目标是快速验证"游戏化交互",不需要 SSR
最终选型: - Vite + React + TypeScript + shadcn/ui - 先用纯 HTML/JS/CSS 做像素风原型,再逐步演进
产品命名¶
03-11 深夜: - Dad 决定将"OpenClaw 系统游戏化展示"作为全新研究项目 - bot 提出多个名字,最终采用 ClawCraft
技术问题与根因分析¶
早期原型迭代中的数据问题¶
问题:项目卡片出现 undefined
根因:数据库缺少 emoji 列,前端直接渲染导致显示 undefined
解决:
1. 补数据库 emoji 字段
2. 检查 server.js 查询逻辑与 init schema
3. 同步修正项目阶段数据
解决方案¶
多模型头脑风暴机制¶
Dad 决策:拉起子代理,用 github-copilot/gemini-3.1-pro-preview 进行 10 轮头脑风暴
10 轮辩论核心主题: 1. 2.5D 等距像素风是否合适 2. OpenClaw 实体如何映射到 RTS 世界 3. 实时数据如何驱动世界状态 4. 多实例/多系统如何展示 5. 资源系统、建筑、科技树 6. MVP 范围界定
辩论结论: - ClawCraft 不应只是"监控面板套游戏皮肤" - 应是可操作的系统控制界面 - 世界中的对象需要和 OpenClaw 核心概念一一映射
架构方案定型(03-12 凌晨)¶
Plugin + Frontend 方案: - ClawCraft 作为 OpenClaw plugin + 独立 frontend 实现 - Plugin 能直接接入 Gateway 事件流与运行时 API - 比外部轮询脚本更稳定
源码调研成果:
- Gateway 事件列表
- RPC 方法
- Plugin SDK TypeScript 类型
- runtime 对象能力
OpenClaw 概念映射¶
| OpenClaw 概念 | RTS 映射 | 说明 |
|---|---|---|
gateway |
王国核心/主城 | 系统入口 |
agents |
领主/指挥官 | 执行单元 |
sessions |
探险者/单位 | 会话实例 |
channels |
港口/使馆 | 通信通道 |
skills |
技能工坊 | 能力扩展 |
plugins |
插件工厂 | 功能模块 |
memory |
记忆宝库 | 持久存储 |
models |
模型熔炉 | AI 模型 |
tools |
工具库 | 可用工具 |
files / agent docs |
领主档案/铭文编辑器 | 配置文件 |
PRD 演进¶
v1.0:概念映射、前端世界观、插件架构、MVP 范围
v1.1:增加阶段划分(MVP、Wave 1、Wave 2...)
v1.2/v1.3(关键纠偏): - Dad 指出价值优先级不对 - 监控和操作都很重要 - 目标是用 RTS 界面替代传统 channel 对话和配置工作
v2.0: - 每个场景包含操作步骤、涉及组件、API 调用、验收标准 - 生成 HTML 在线版
里程碑¶
03-10¶
- [x] 前端技术选型确定:Vite + React + TypeScript + shadcn/ui
- [x] 项目管理原型搭建完成
03-11¶
- [x] 产品方向从"项目管理网页"升级为"RTS 游戏化界面"
- [x] 项目正式命名为 ClawCraft
- [x] 代码入库
03-12¶
- [x] 确定 Plugin + Frontend 架构方案
- [x] 完成 OpenClaw 概念到 RTS 世界的映射
- [x] PRD v2.0 定稿
- [x] MVP 正式开工
- [x] 首次跑通前端白模 + HUD + 实时事件流
- [x] E2E 测试 7/7 通过
- [x] UI 重构为真正 RTS 布局(WorldCanvas 全屏 + 浮窗化 HUD)
- [x] 频道管理设计完成("港口使馆"概念)
- [x] 技能工坊支持搜索、评分、一键安装