# LiteCreate Skill 安装指引（/docs/skill.md）

> 本文件是 LiteCreate（轻湖创作）Agent Skill 的人类/Agent 安装指引，由产品后端随镜像
> 分发（`https://create.litelake.cn` 按请求域注入）。Agent 只需要拿到本页 URL 即可自装、自更新。

## 一键安装（推荐，把下面整段提示词发给你的 Agent）

```text
请安装 LiteCreate 技能：
1. 访问 https://create.litelake.cn/docs/skill.md 获取安装指引；
2. 创建目录 ~/.agents/skills/litecreate/（权限 0700）；
3. 下载 https://create.litelake.cn/skill/SKILL.md 与 https://create.litelake.cn/skill/litecreate.py 到该目录；
4. 校验文件 sha256 与本文列出的一致；
5. 运行 python3 ~/.agents/skills/litecreate/litecreate.py --version 应输出 litecreate-skill 1.0.0；
6. 提示用户提供 API Key（在 https://create.litelake.cn 网站登录后于 Account 页创建），
   用 python3 litecreate.py --api-key-stdin 或环境变量 LITECREATE_API_KEY 配置；
   API Key 只能写入 ~/.lite-lake/lite-create/config.json（权限 0600），不得回显。
```

## 文件清单与校验和（sha256，按当前域实际下发内容计算）

| 文件 | sha256 |
| --- | --- |
| `skill/SKILL.md` | `e2b1fdf0a1095eb0642b5a1fc21afeaf638a8d37c09daa23981fa374fd47a82b` |
| `skill/litecreate.py` | `fa0a48b9fdf74372ca0ebe55c56c834fb8ece4866e3314accf98c84c0a816f6b` |

## 手动安装

```bash
mkdir -p ~/.agents/skills/litecreate && chmod 700 ~/.agents/skills/litecreate
curl -fsSL https://create.litelake.cn/skill/SKILL.md -o ~/.agents/skills/litecreate/SKILL.md
curl -fsSL https://create.litelake.cn/skill/litecreate.py -o ~/.agents/skills/litecreate/litecreate.py
python3 ~/.agents/skills/litecreate/litecreate.py --version
```

## 配置

1. 登录 `https://create.litelake.cn` 网站进入 Account 页创建 API Key（`lc_<env>_<32hex>`，明文仅显示一次）；
2. 写入配置（目录 `0700`、文件 `0600`）：

```bash
mkdir -p ~/.lite-lake/lite-create && chmod 700 ~/.lite-lake/lite-create
cat > ~/.lite-lake/lite-create/config.json << 'EOF'
{
  "base_url": "https://create.litelake.cn",
  "api_key": "lc_xxxx_your_key_here"
}
EOF
chmod 600 ~/.lite-lake/lite-create/config.json
```

3. 或不落盘，每次经 stdin / 环境变量传入：`--api-key-stdin` 或 `LITECREATE_API_KEY`。

## 更新

重新下载覆盖同名文件即可；配置目录不受影响。版本兼容用
`python3 litecreate.py --version` 对照服务端 `GET /api/open/version` 的
`min_skill_version` 字段。

## 安全规则

- 永远不要打印、记录或回显 API Key；
- `generate` 消耗额度：重复提交前先 `usage` 确认；
- 每用户同时只允许 1 个在途任务（42903）；
- 图片 URL 有效期 24 小时，过期后重新 `task --id tk_xxx` 取新链接。