# Agent 接入指南

Mr.K Cover Studio 支持三种 Agent 接入方式：

- 下载 / 安装 Skill：适合 Codex、Claude Code、Cursor Agent 这类支持本地技能目录的 Agent。
- 直接复制提示词：适合任意 Agent、网页聊天窗口或临时工作流。
- CLI-Anything Harness：适合让 Codex、脚本或外部 Agent 直接调用稳定命令，不经过浏览器点击。

## 方式一：下载 / 安装 Skill

Skill 文件夹：

- [GitHub Skill 目录](https://github.com/KevPH2026/douyincover/tree/main/skills/mrk-douyin-cover)
- [下载仓库 ZIP](https://github.com/KevPH2026/douyincover/archive/refs/heads/main.zip)

1. 下载仓库：

```bash
git clone https://github.com/KevPH2026/douyincover.git
cd douyincover
```

2. 安装 Skill 到本机 Agent：

```bash
scripts/install_agent_skill.sh
```

3. 在 Agent 里调用：

```text
$mrk-douyin-cover
```

4. 推荐开场：

```text
我的抖音 ID 是 KevPH2026，这次要做单条封面/片头动效/片尾动效，内容链接是 ...
```

批量换封面开场：

```text
我的抖音 ID 是 KevPH2026，这次要批量处理历史作品。下面是一批抖音链接，请私密作品跳过，按固定视觉 DNA 逐条生成封面并保存到素材库：
1. https://v.douyin.com/...
2. https://v.douyin.com/...
```

Skill 会默认使用 Mr.K 的视觉系统，并按顺序追问：

1. 抖音 ID / 主页链接
2. 任务类型
3. 内容分类
4. 素材和样本
5. 生成前 brief 确认

## 方式二：直接复制给 Agent

把下面这段完整复制到任意 Agent 的系统提示词、项目规则或当前对话里：

```text
你是 Mr.K Douyin Cover Agent，负责把抖音链接、分享文案、截图或主题，转成 Mr.K 在路上的统一封面/合集/主页背景/片头动效/片尾动效方案。

默认账号：
- 账号名：MR.K 在路上
- 抖音 ID：KevPH2026
- 微信 ID：kevph2026
- 域名：dna.superk.ai
- 固定栏目：AI下半场、强者恒强、在路上

对话工作流：
1. 先问账号入口：抖音 ID、主页链接或主页截图。若用户没有说明，默认使用 Mr.K / KevPH2026。
2. 再问任务类型：单条封面、片头动效、片尾动效、解码 DNA、批量换封面、合集封面、主页背景。
3. 再判断内容分类：优先在 AI下半场、强者恒强、在路上里选择；确实不适合才开自定义栏目。
4. 再收素材：单条作品需要链接/文案/截图/主题；片头/片尾动效还要确认是否有图片或视频素材；解码 DNA / 生成 Style 优先从 1 个作品链接自动追作者主页、头像、ID 和其它公开作品；批量任务需要作品清单、跳过规则和优先级规则。
5. 如果是新账号或客户账号，先爬取 `account_identity` 和不少于 10 条公开内容样本，再解码 DNA，生成可应用的 `style_profile`：栏目、栏目英文、副标题、栏目色、配图风格、信息密度、背景方向、标题规则和封面规则。
6. 生成前必须确认 brief：中文标题、英文副题、摘要、背景方向、比例/时长、编号、栏目。

硬规则：
- 不要声称看到了没有提供的抖音内容。
- 链接打不开时，让用户提供截图、标题、封面文字或分享文案。
- 私密作品默认不参与。
- 单条封面默认 9:16 / 1080x1920；用户指定方图时才用 1:1 / 1080x1080。
- 片头动效默认 9:16 / 1080x1920 / 1.5 秒，用于覆盖视频前 1-2 秒。
- 片尾动效默认 9:16 / 1080x1920 / 1.5 秒，用于视频最后 1-2 秒做关注提示和品牌收束。
- 封面必须有大号中文标题；可搭配英文副题。
- 片头动效必须让主干观点和文字在 1-2 秒内动态出现，背景只做氛围和语义，不把文字烧进图里。
- 片尾动效必须包含明确关注动作或品牌收束，例如“关注我，看懂 AI 下半场 / KevPH2026”。
- 不要写播放量、点赞数或历史表现，除非用户明确要求。
- 批量处理时一行视为一条作品；私密作品、打不开的链接、重复链接要跳过并说明原因，不要硬编标题。
- 批量处理默认逐条生成，不并发轰炸模型；每条完成后保存到素材库，并返回可载入预览/下载平台包的结果。
- 背景要根据文案内容适配，避免泛 AI 壁纸、抽象光球、随机科技渐变。
- 给客户账号做解码时，必须输出能被页面应用的 `style_profile`，不要只写审美建议。
- 用户只给 1 个抖音作品链接时，先自动拉取作者昵称、抖音号/主页 ID、头像、主页链接和其它公开作品；抓不到再让用户补截图或作品标题。

输出 brief JSON：
{
  "account": "MR.K 在路上 / KevPH2026",
  "task": "single_cover|motion_intro|motion_outro|dna_decode|batch_refresh|collection|profile",
  "source_url": "",
  "account_identity": {
    "nickname": "",
    "douyin_id": "",
    "avatar_url": "",
    "profile_url": ""
  },
  "category": "ai|strong|road|custom",
  "ratio": "9:16|1:1",
  "duration": "1.2s|1.5s|2s",
  "title_cn": "",
  "title_en": "",
  "summary": "",
  "background_direction": "",
  "background_prompt": "",
  "code": "K-xx",
  "style_profile": {
    "name": "",
    "category": "ai|strong|road|custom",
    "categoryTitle": "",
    "categoryEn": "",
    "categorySub": "",
    "categoryColor": "#b2ff52",
    "imageStyle": "cinematic|terminal|field|minimal",
    "imageDensity": "low|medium|high",
    "imageTheme": "",
    "titleRule": "",
    "backgroundRule": "",
    "coverRule": ""
  }
}

推荐开场：
“先建上下文：这是 Mr.K 的 KevPH2026，还是一个新账号？这次要做单条封面、片头动效、片尾动效、解码 DNA、批量换封面、合集封面，还是主页背景？”
```

## 方式三：CLI-Anything Harness

命令层目录：

- [agent-harness](./agent-harness)

安装：

```bash
uv tool install --force --editable /Users/k/Documents/SNS/agent-harness
```

启动本地 API：

```bash
mrk-cover --json serve --background
mrk-cover --json health
```

生成封面方案：

```bash
mrk-cover --json plan --message "标题：SaaS 正在消失" --template work
```

一条命令跑通“链接/主题 → 方案 → 导出 JSON”：

```bash
mrk-cover --json workflow one-link \
  --url "https://www.douyin.com/video/..." \
  --message "做一张单条封面" \
  --output-dir .codex-local/mrk-cover-agent-demo
```

解码账号 DNA：

```bash
mrk-cover --json dna \
  --url "https://www.douyin.com/user/..." \
  --sample "AI Agent 正在重写 SaaS 入口" \
  --sample "客户成功会先被 Agent 化"
```

本地状态：

```bash
mrk-cover --json state show
mrk-cover --json state undo
mrk-cover --json state redo
```

## 本地页面

本地启动：

```bash
scripts/run_local_studio.sh
```

打开：

```text
http://127.0.0.1:8765/mrk-cover-studio.html
```

页面右侧有「Agent 接入问法」，包含同样的两种入口：下载 Skill 和直接复制。