evomeme-dev 0.1.7

package/README.md

@@ -0,0 +1,247 @@
+# EvoMeme
+
+> 给第一次使用的同学看。不用写代码，按下面流程做就行。  
+> 用自然语言跟 AI 说话，就能做竖屏小游戏。
+
+npm 包名：`evomeme`。用 `npx` 安装到 AI 工具后，即可在对话里做游戏、生图、提交草稿。
+
+---
+
+## 一、这是什么？
+
+**EvoMeme** 是一套装在 AI 工具里的「做游戏助手」。
+
+你可以：
+
+- 用一句话描述想法，让 AI 帮你策划、做美术、写游戏
+- 让 AI 生成角色图、背景图，以及 3D 模型（按需要）
+- 把做好的游戏提交到 evomeme平台草稿
+
+产品重点：**手机竖屏（9:16）可玩的小游戏**。
+
+---
+
+## 二、开始前请准备
+
+| 需要准备 | 说明 |
+| -------- | ---- |
+| 一台电脑 | Windows / Mac / Linux 都可以 |
+| 网络 | 安装、登录、生图、提交都需要联网 |
+| Node.js | 没有的话，到 [Node.js 官网](https://nodejs.org/) 下载 **LTS** 版本并安装（建议 ≥ 18.14） |
+| 一个 AI 工具（任选） | **Codex**、**Cursor**、**Claude Code**、**WorkBuddy**、**Trae（国内版 SOLO）** |
+| 账号 | 安装过程中会弹出登录页，按提示登录即可 |
+
+---
+
+## 三、完整使用流程
+
+### 第 1 步：打开 AI 工具
+
+打开你平时用的 AI 工具（Codex / Cursor / Claude Code / WorkBuddy / Trae 等）。
+
+---
+
+### 第 2 步：创建新项目，并新建对话
+
+1. 创建一个**新项目**（空文件夹即可，例如「我的小游戏」）  
+2. 用 AI 工具打开这个项目  
+3. 在项目中**新建一个对话**
+
+---
+
+### 第 3 步：把下面整段话发给 AI
+
+把下面灰色框里的内容**整段复制**，粘贴到刚才的对话里发给 AI，让它帮你执行：
+
+```text
+一、安装 evomemeMCP
+npx -y evomeme@latest install --ide codex,cursor,claude,workbuddy,trae
+部分 Agent 安装后，可能需要重新启动
+
+二、初始化项目
+选择本地目录作为项目目录，在目录中执行：
+npx -y evomeme@latest init
+```
+
+AI 会帮你跑安装和初始化。
+
+只想装某一个工具时，也可以自己在终端执行，例如：
+
+```bash
+npx -y evomeme@latest install --ide cursor
+npx -y evomeme@latest init
+```
+
+---
+
+### 第 4 步：完成登录
+
+安装 / 初始化过程中，电脑会**弹出登录页面**。
+
+1. 在浏览器里按提示完成登录  
+2. 登录成功后，回到 AI 工具，等待安装与初始化跑完  
+
+> 如果浏览器没弹出来，看看是否被拦截了弹窗；也可以让 AI 再帮你执行一次登录。
+
+---
+
+### 第 5 步：重启 AI 工具
+
+安装完成后，**请重启一次 AI 工具**（关掉再打开），让插件正式生效。
+
+补充说明：
+
+- **WorkBuddy**：还要到「连接器 → 自定义连接器」里，对 `evomeme` 点一下**信任**  
+- **Trae**：到 **设置 → MCP** 确认列表里有 `evomeme`
+
+---
+
+### 第 6 步：创作游戏时带上 `/game-director`
+
+重启后，重新打开项目，新建或继续对话。
+
+**开始做游戏时，请附带入口技能 `/game-director`**，让 AI 按正式创作流程工作。
+
+不同工具附带技能的方式可能略有差别，常见写法是在消息里带上：
+
+```text
+/game-director
+```
+
+然后再写你的游戏需求，例如：
+
+```text
+/game-director
+
+我想做一个竖屏休闲游戏：手指左右滑动控制小猫躲障碍，碰到障碍就失败，坚持越久分越高。画风偏可爱卡通，先做能玩的第一版。
+```
+
+之后就可以继续用中文提修改：
+
+- 「帮我生成主角和障碍物图片，抠掉背景」  
+- 「开始页和结算页简单一点」  
+
+---
+
+### 第 7 步：提交到 evomeme平台草稿
+
+游戏差不多能玩、自己觉得可以了，就告诉 AI：
+
+```text
+帮我将作品提交到 evomeme平台草稿中
+```
+
+AI 会把当前项目（含可运行的 `dist/` 构建产物）提交到平台的草稿里。之后你可以在平台上继续查看、预览或再改。
+
+> 提交会以你电脑上这份项目为准，覆盖更新云端草稿。重要节点建议先自己备份一下项目文件夹。
+
+---
+
+## 四、一页速查
+
+```text
+1. 打开 AI 工具
+2. 创建新项目 + 新建对话
+3. 把「安装 + 初始化」那段话整段发给 AI
+4. 弹出登录页时完成登录
+5. 重启 AI 工具
+6. 创作时附带 /game-director，再用中文描述游戏想法
+7. 完成后告诉 AI：帮我将作品提交到 evomeme平台草稿中
+```
+
+---
+
+## 五、你能让 AI 帮你做什么？
+
+| 你想做的事 | 可以怎么说 |
+| ---------- | ---------- |
+| 从想法变成可玩小游戏 | 「帮我做一个……竖屏小游戏，先出能玩的版本」 |
+| 定玩法和规则 | 「核心玩法是……，失败和得分规则是……」 |
+| 定画面风格 | 「做成像素风 / 可爱卡通 / 扁平插画」 |
+| 生成图片素材 | 「生成主角、敌人、背景图，并抠图」 |
+| 做界面 | 「加开始页、暂停、结算，分数放右上角」 |
+| 做 3D 角色/道具 | 「用文字/图片生成 3D 模型，并接到游戏里」 |
+| 接背景音乐 | 「给游戏配一首轻松的 BGM」 |
+| 自测找问题 | 「帮我跑一遍，看看能不能正常开始和结算」 |
+| 提交到平台草稿 | 「帮我将作品提交到 evomeme平台草稿中」 |
+
+---
+
+## 六、使用建议
+
+1. **先做最小可玩版**  
+   先跑通「开始 → 玩一会儿 → 结束」，别一上来堆很多功能。
+
+2. **再补美术**  
+   玩法稳定后，再生成/替换图片和界面。
+
+3. **一次只改一类问题**  
+   例如先只调难度，再只改画风。
+
+4. **创作记得带 `/game-director`**  
+   这是正式入口，AI 才会按完整工作流来做。
+
+---
+
+## 七、常见问题
+
+### 1. 提示找不到 `npx` / 命令跑不起来
+
+多半还没装好 Node.js。安装 LTS 后，**关掉终端或 AI 工具再开一次**，重新发那段安装文字。
+
+### 2. 安装完了但感觉插件没生效
+
+- 确认已经**重启过 AI 工具**  
+- WorkBuddy：确认已信任 `evomeme`  
+- Trae：到 MCP 设置里确认已启用  
+- 把第 3 步那段话再发给 AI 跑一遍
+
+### 3. 一直让我登录 / 登录失败
+
+- 检查浏览器是否拦截了弹窗  
+- 换网络再试  
+- 让 AI「重新登录」  
+- 仍不行时，把完整报错原文发给支持同学
+
+### 4. 生图很慢，或一开始是空白图
+
+正常现象：系统会先给一个地址，后台继续生成，生成完后同一地址会变成真正的图。稍等再看即可。
+
+### 5. 我不会写代码，能用吗？
+
+可以。按本指南操作，平时用中文描述需求即可。
+
+### 6. 为什么一定要带 `/game-director`？
+
+这是做游戏的**统一入口**。带上它，AI 才会按策划 → 开发 → 美术 → 测试等正式流程推进。
+
+### 7. 如何升级到最新版？
+
+再执行一次安装命令即可（推荐带 `@latest`）：
+
+```bash
+npx -y evomeme@latest install --ide codex,cursor,claude,workbuddy,trae
+```
+
+---
+
+## 八、命令速查（可选）
+
+一般把命令交给 AI 执行即可；若你习惯自己在终端操作：
+
+```bash
+# 安装 / 更新到指定 AI 工具
+npx -y evomeme@latest install --ide cursor
+
+# 一次安装多个
+npx -y evomeme@latest install --ide codex,cursor,claude,workbuddy,trae
+
+# 在项目目录初始化（忽略规则、技能、登录态）
+npx -y evomeme@latest init
+```
+
+支持的 `--ide`：`codex`、`cursor`、`claude`、`workbuddy`、`trae`。
+
+---
+
+如果你卡在某一步，把「用的是哪个 AI 工具 + 做到哪一步 + 屏幕上的原文报错」发给支持同学，会最快被帮到。

package/bin/evomeme

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+
+/**
+ * evomemeplugin_client
+ * Entry point for CLI subcommands (e.g. `evomemeinstall --ide codex`) and
+ * MCP stdio server mode (`evomeme` with no arguments).
+ */
+
+import { join, dirname } from 'node:path';
+import { existsSync } from 'node:fs';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageRoot = join(__dirname, '..');
+const distPath = join(packageRoot, 'dist', 'index.js');
+const distUrl = pathToFileURL(distPath).href;
+
+if (existsSync(distPath)) {
+  import(distUrl).catch((error) => {
+    console.error('❌ Failed to start evomeme:', error);
+    process.exit(1);
+  });
+} else {
+  console.error('❌ evomemebundle not found. Please build the project first:');
+  console.error('   npm run build');
+  process.exit(1);
+}