gaoding-design

# Gaoding Design

通过自然语言在稿定设计 (gaoding.com) 搜索模板、编辑设计并导出成品。

## 首次安装

```bash
cd ~/.openclaw/skills/gaoding-design && npm install && npx playwright install chromium
```

在 `~/.openclaw/skills/gaoding-design/.env` 中配置稿定账号：

```
GAODING_USERNAME=你的手机号或邮箱
GAODING_PASSWORD=你的密码
```

## 可用工具

### search_templates — 搜索设计模板

根据关键词搜索稿定设计模板，返回模板列表和搜索结果截图。

```bash
cd ~/.openclaw/skills/gaoding-design && npx tsx scripts/search.ts "<关键词>" [--max <数量>]
```

输入参数：
- `keywords`（必填）：搜索关键词，如"电商海报"、"名片 简约"、"618大促"
- `type`（可选）：设计类型，如 poster、ppt、h5、video、image
- `max`（可选）：最大返回数量，默认 6

输出 JSON：

```json
{
  "query": "电商海报",
  "count": 6,
  "screenshotPath": "~/.openclaw/skills/gaoding-design/output/search-result.png",
  "templates": [
    { "id": "193439734", "title": "美容美妆产品展示宣传推广电商竖版海报", "previewUrl": "https://..." }
  ]
}
```

回复用户时：
1. 将 `screenshotPath` 指向的截图发送给用户
2. 列出模板标题供用户选择
3. 每个模板可通过 `https://www.gaoding.com/template/{id}` 预览

### select_template — 选择模板

从搜索结果中选择一个模板进入编辑流程。

输入参数：
- `index`（必填）：模板序号（从 1 开始）

### preview_design — 预览设计

截取模板或当前设计的预览图。

输入参数：
- `templateId`（可选）：模板 ID，不填则预览当前选中的模板

### edit_text — 编辑文字

替换设计中的文字内容。需要先调用 select_template 选择模板。

输入参数：
- `replacements`（必填）：文字替换映射，如 `{"原文本": "新文本"}`
- `templateId`（可选）：模板 ID

### export_design — 导出设计

将当前设计导出为文件。需要先选择模板。

输入参数：
- `format`（可选）：导出格式，支持 png、jpg、pdf，默认 png

## 对话流程示例

```
用户：帮我做一张618电商海报
→ 调用 search_templates(keywords="618电商海报")
→ 展示搜索结果截图和模板列表

用户：用第3个
→ 调用 select_template(index=3)
→ 回复已选择的模板名称

用户：把标题改成"夏日特惠 全场5折"
→ 调用 edit_text(replacemen...

# gaoding-design

OpenClaw Skill — 通过自然语言对话在[稿定设计](https://www.gaoding.com)搜索模板、编辑设计并导出成品。

## 前置条件

- Node.js >= 22.12.0
- [OpenClaw](https://github.com/nicepkg/openclaw) 已安装
- 稿定设计账号（用于浏览器自动化）

## 安装

```bash
git clone git@git.intra.gaoding.com:editor/gaoding-claw.git
cd gaoding-claw
npm install
npx playwright install chromium
cp .env.example .env  # 编辑 .env 填入凭证
npm run build
```

## 使用

### 作为 OpenClaw Skill

```bash
openclaw skill install ./
openclaw chat "帮我找一个618电商海报模板"
```

### 独立脚本调用

```bash
npx tsx scripts/search.ts "电商海报"
```

输出 JSON 包含 `templates` 数组和 `screenshotPath` 截图路径。

## 配置

编辑 `.env` 文件：

| 变量 | 说明 | 必填 |
|------|------|------|
| `GAODING_USERNAME` | 稿定账号（手机号或邮箱） | 是 |
| `GAODING_PASSWORD` | 稿定密码 | 是 |
| `ANTHROPIC_API_KEY` | Anthropic API Key | 是（或用 OpenAI） |
| `FEISHU_APP_ID` | 飞书应用 ID | 否（飞书集成时需要） |
| `FEISHU_APP_SECRET` | 飞书应用密钥 | 否（飞书集成时需要） |

## 项目结构

```
├── SKILL.md              # OpenClaw Skill 定义
├── src/
│   ├── index.ts          # 入口：意图解析 + 流程编排
│   ├── browser/
│   │   ├── auth.ts       # 登录态管理（Cookie 持久化）
│   │   ├── search.ts     # 模板搜索
│   │   ├── preview.ts    # 模板预览
│   │   ├── edit.ts       # 模板编辑
│   │   └── export.ts     # 设计导出
│   ├── llm/
│   │   └── intent.ts     # 意图解析
│   └── utils/
│       ├── image.ts      # 图片处理
│       └── feishu.ts     # 飞书消息卡片
└── scripts/
    ├── search.ts         # 独立搜索脚本
    └── smoke-test.ts     # 冒烟测试
```

## 已知限制

- 搜索依赖稿定网页 DOM 结构，网站改版可能导致选择器失效
- 仅支持中文关键词搜索
- 需要有效的稿定登录态（Cookie 过期后需重新登录：`npm run login`）