text-code

---
name: text-code
description: "使用 meitu-cli 从零生成 React/TSX 页面代码，支持素材参考与 prompt 扩写。仅当用户明确要求生成 React/TSX/HTML 前端代码文件时触发；普通页面设计讨论、产品方案、视觉设计需求不触发。"
version: "1.0.0"
metadata: {"openclaw":{"requires":{"bins":["meitu"],"env":["MEITU_OPENAPI_ACCESS_KEY","MEITU_OPENAPI_SECRET_KEY","MEITU_OPENAPI_TOOL_TASK_MODE"],"paths":{"read":["~/.meitu/credentials.json","~/.meitu/tool-registry.json","~/.openclaw/workspace/visual/","./openclaw.yaml"],"write":["~/.openclaw/workspace/visual/","./output/"]}},"primaryEnv":"MEITU_OPENAPI_ACCESS_KEY","security":{"dataFlow":"Inputs, selected local context, and generated prompts may be sent to Meitu OpenAPI when used by the workflow.","credentials":"Credentials are used only for CLI authentication and must not be disclosed."}}}
security:
  credential_use: "Uses Meitu OpenAPI credentials from env or ~/.meitu/credentials.json for CLI calls; credentials must not be echoed, logged, or embedded in prompts."
  remote_processing: "Page prompts and referenced media may be sent to Meitu OpenAPI for code generation."
  persistence: "Generated source files may be written to ./output/ in project mode or visual output directories in one-off mode."
requirements:
  credentials:
    - name: MEITU_OPENAPI_ACCESS_KEY
      source: env | ~/.meitu/credentials.json
    - name: MEITU_OPENAPI_SECRET_KEY
      source: env | ~/.meitu/credentials.json
  env:
    MEITU_OPENAPI_TOOL_TASK_MODE: command
  permissions:
    - type: file_read
      paths:
        - ~/.meitu/credentials.json
        - ~/.meitu/tool-registry.json
        - ~/.openclaw/workspace/visual/
        - ./openclaw.yaml
    - type: file_write
      paths:
        - ~/.openclaw/workspace/visual/
        - ./output/
    - type: exec
      commands:
        - meitu
---

# Text Code（代码生成）

## Overview

从零生成 React/TSX 页面代码，支持素材参考（图片/视频）与 prompt 扩写。适用于落地页、活动页、数据可视化页面、界面原型、React 组件快速搭建。不处理：修改已有源码、非 React/HTML 框架、后端代码（Python/Java 等）、像素级还原设计稿、复杂后端对接。

## API Mapping

| 场景 | 后端 API |
|------|---------|
| React/TSX 页面代码生成 | `text_code` |

model 映射：

- `auto`（默认）/ 不传 → 按路由规则决策
- `pretzel_pro` / `pretzel_lite` → 直接指定模型
- 模型回退链：`pretzel_pro` → `pretzel_lite`

## Dependencies

- **meitu-cli**: `>=2.0.6`
- **凭证**：CONFIG AKSK → `meitu tools update`；EXEC AKSK → 跑命令（见根 `CONFIG.md`）
- **环境变量**：`MEITU_OPENAPI_TOOL_TASK_MODE=command`

## Core Workflow

```
Preflight → Execute → Deliver
```

### Preflight

1. `meitu --version` ≥ 2.0.6，未装则 `npm install -g meitu-cli@latest`
2. `meitu auth verify --json` → 凭证无效走 CONFIG.md SOP
3. 确认本地 `~/.meitu/tool-registry.json` 已包含 `text-code`，否则 `meitu tools update`
4. 解析 output_dir：`openclaw.yaml` → `./output/`；else → `~/.openclaw/workspace/visual/output/text-code/`；`mkdir -p {output_dir}`

### Execute

**触发信号 / 路由规则**

| 场景 | 判定关键词 | 路由 |
|------|-----------|------|
| 从零生成 React 页面 | 做个页面、生成网页、落地页、活动页、数据可视化、生成组件 | `text_code` |
| 简短 prompt + 有 prompt_name | `prompt` < 10 字符 | 自动扩写后调用 |
| 提供 source_code_url + 修改意图 | 改代码、加按钮、调样式 | 不属于本工具（走 text-code-edit） |
| 要求生成非 React/HTML 代码 | 后端、Python、Java | 告知仅支持 React/TSX |

**参数定义**

| 参数 | 类型 | 必填 | 范围 | 默认值 | 说明 |
|------|------|------|------|--------|------|
| `prompt` | STRING | 是 | -- | -- | 页面描述，尽量详细。缺失 → 追问 |
| `model` | ENUM | 否 | auto / pretzel_pro / pretzel_lite | pretzel_pro | 模型选择，非法值回退 pretzel_pro |
| `image_list` | ARRAY | 否 | -- | [] | 参考图片 URL 列表，无效项静默过滤 |
| `video_list` | ARRAY | 否 | -- | [] | 参考视频 URL 列表，无效项静默过滤 |
| `prompt_name` | STRING | 否 | -- | -- | 系统提示词名称 |

**工具调用**

基础生成：
```bash
meitu text-code --prompt "{page_description}" --json --download-dir {output_dir}  --skill_name skill_text-code
```

指定模型 + 参考素材：
```bash
meitu text-code \
  --skill_name skill_text-code \
  --prompt "{page_description}" \
  --model pretzel_pro \
  --image_list "{url1}" --image_list "{url2}" \
  --json --download-dir {output_dir}
```

简短 prompt + prompt_name（自动扩写）：
```bash
meitu text-code --prompt "做个页面" --prompt_name "{template_name}" --json --download-dir {output_dir} --skill_name skill_text-code
```

**错误降级**

| 场景 | 处理方式 |
|------|---------|
| `prompt` 缺失 | 提示"请描述你想生成的网页" |
| `prompt` < 10 字符 + 有 `prompt_name` | 自动扩写 |
| `prompt` < 10 字符 + 无 `prompt_name` | 原样传入 |
| `model` 非法值 | 回退至 `pretzel_pro` |
| `image_list` 全部无效但用户有参考意图 | 提示"请提供有效的图片链接" |
| 请求非 React/HTML 代码 | 告知仅支持 React/TSX |
| 超时 | 沿 `pretzel_pro → pretzel_lite` 重试，链尽返回错误 |
| 代码不完整 | 原模型重试 1 次 → 返回错误 |
| 内容合规拦截 | 直接返回合规提示，不重试 |

### Deliver

解析 `--json`：
- `ok: true` → `downloaded_files[0].saved_path` 为本地 `.tsx` 源码；或 `media_urls[0]` 为 code_url
- `ok: false` → 输出 `code` + `hint`

落盘：`mv {file} {output_dir}/{YYYY-MM-DD}_{descriptive-name}.tsx`，记录 `code_url` 以便后续 `text-code-edit` 自动引用。

## Output

- **格式**: `.tsx` / `.jsx` 源码文件
- **命名**: `{YYYY-MM-DD}_{descriptive-name}.tsx`
- **位置**: 由 Deliver 步骤决定（项目 → `./output/`，一次性 → `~/.openclaw/workspace/visual/output/text-code/`）

## 基线 Task ID

见根目录 `references/task-id-baseline.md` 中 `text-code` 条目。