메뉴
自媒体运营自动化技能，支持小红书、抖音、微信公众号、视频号等平台的内容生成、图片生成、数据管理和自动化发布。包含 Tavily API 搜索、内容生成、图片生成、HAP 数据管理和自动化发布等完整流程。新增每日热点内容推荐功能。图片生成支持并行生成、自动下载、自动跳过已存在图片等优化功能。强制要求从 HAP "账号人设" 表读取账号人设配置，禁止使用本地文件。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/garfield-bb/hap-skills-collection --skill social-media-automation명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
明道云 HAP MCP 自动化配置技能。**立即触发条件**：用户提到"配置 MCP"、"添加 MCP"、"MCP 配置"、"MCP 连接"、"设置 MCP"、提供包含"hap-mcp-"的配置、提供包含"HAP-Appkey"和"HAP-Sign"的 URL。支持 9 种 AI 工具的自动化配置，配置完成后自动验证连通性。
COO 社交媒体运营技能，使用 Playwright MCP 实现小红书、抖音、微信公众号、视频号的自动化运营
专门用于维护和更新明道云 HAP 接口文档的技能。当用户需要在 HAP API 文档中新增、修改、删除接口,或需要同步中英文版本文档时使用此技能。支持组织授权 API (en/zh-Hans) 和应用 API (application) 两种文档类型。
SOC 직업 분류 기준
SKILL.md 표시 중
| name | social-media-automation |
| description | 自媒体运营自动化技能，支持小红书、抖音、微信公众号、视频号等平台的内容生成、图片生成、数据管理和自动化发布。包含 Tavily API 搜索、内容生成、图片生成、HAP 数据管理和自动化发布等完整流程。新增每日热点内容推荐功能。图片生成支持并行生成、自动下载、自动跳过已存在图片等优化功能。强制要求从 HAP "账号人设" 表读取账号人设配置，禁止使用本地文件。 |
| version | 1.7.0 |
当用户提到以下内容时自动触发：
本 Skill 是通用的，不包含任何硬编码的 MCP 配置或密钥信息。
用户提供 MCP 配置
{"hap-mcp-{应用名称}": {"url": "https://api.mingdao.com/mcp?HAP-Appkey=...&HAP-Sign=..."}}确认当前连接的 MCP
mcp_hap-mcp-_get_app_info() 确认当前连接的 HAP 应用从 HAP 动态读取配置
get_app_worksheets_list() 动态获取工作表列表工作表动态识别（重要）
get_app_worksheets_list() 获取工作表列表alias 字段匹配，如果不存在则使用 name 字段匹配get_worksheet_structure() 获取工作表结构用户请求
↓
1. 识别用户提供的 MCP 配置或指定的 MCP
↓
2. 调用 get_app_info() 确认当前连接的 MCP 应用
↓
3. 对比：当前连接 vs 用户指定的 MCP
↓
4. 如果不匹配 → 与用户确认
↓
5. 确认后执行操作
用户输入主题
↓
Step 1: 从 HAP "API服务配置" 表动态读取搜索 API 配置（Tavily/Serper）
↓
Step 2: 调用搜索 API 获取主题相关资料（Tavily API）
↓
Step 3: **【强制要求】从 HAP "账号人设" 表读取账号人设配置（必须在生成内容之前执行）**
- **禁止使用本地文件**：绝对不允许使用 `AGENTS.md` 或其他本地文件作为账号人设来源
- **必须调用 HAP MCP**：必须通过 MCP 调用 `get_record_list()` 从 HAP "账号人设" 表读取
- **读取流程**：
1. 确认当前连接的 HAP MCP 应用（通过 `get_app_info()`）
2. 动态获取"账号人设"表的 ID（通过别名 `account_persona` 或名称 `账号人设` 匹配）
3. 根据 `platform_type` 查询对应平台的账号人设（如：小红书）
4. **读取所有必需字段**：
- 账号定位（positioning）
- 目标受众（target_audience）
- 内容方向（content_direction）
- 内容风格（content_style）**【必须严格遵循】**
- 内容原则（content_principles）**【必须严格遵守】**
- 图片生成提示词（image_generation_prompt）
- **验证要求**：如果未找到账号人设配置，必须抛出异常，不允许继续生成内容
↓
Step 4: 根据搜索结果和账号人设撰写内容
- **严格遵循账号人设**：必须严格按照从 HAP 读取的 `content_style` 和 `content_principles` 生成内容
- **禁止使用本地人设**：不允许参考或使用本地 `AGENTS.md` 文件中的内容
- **结合搜索资料**：将搜索到的资料与从 HAP 读取的账号人设结合，生成符合账号定位的内容
- **确保符合人设**：确保内容符合目标受众、内容方向和账号定位
↓
Step 5: 生成封面标题（5-10个备选）
- 根据账号人设的内容风格生成标题
- 符合账号定位和目标受众
↓
Step 6: 选择话题标签（从 HAP 话题库）
- 根据内容主题和账号人设的内容方向选择
↓
Step 7: 生成配图建议
- 结合账号人设的图片生成提示词风格
- 根据内容主题生成配图建议
↓
Step 8: 保存到本地文件（预览，按笔记目录结构组织）
↓
Step 9: 与用户确认内容、标题、图片
↓
Step 10: 用户确认后，从 HAP "账号人设" 表读取图片生成提示词（图片风格）
↓
Step 11: 从 HAP "API服务配置" 表动态读取图片生成功能配置
↓
Step 12: 结合图片风格提示词和配图建议，生成完整提示词
↓
Step 13: 提取密钥，生成图片（可选，使用配置的 API 服务）
↓
Step 14: 与用户确认是否直接发布至小红书
↓
Step 15: 与用户确认是否同步到 HAP，确认后才上传
- **小红书笔记**：只上传图片 URL（封面图和其他配图），不上传 Markdown 文档
- **其他平台**：根据平台需求上传图片和文档
- **关联选题（如果适用）**：
- 如果内容是基于选题库中的选题创作的，在创建内容记录时关联对应的选题（`related_topic` 字段）
- 如果内容不是基于选题创作的，不关联选题
↓
Step 16: 发布到目标平台（使用 Playwright MCP，如用户确认）
用户请求热点内容推荐
↓
Step 1: 从 HAP "热点平台关注表" 读取用户关注的平台（is_followed = 1）
- 按优先级（priority）排序
- 获取平台代码（platform_code）
↓
Step 2: 从 HAP "API服务配置" 表读取热点新闻 API 配置
- 功能名称：热点新闻API
- 服务类型：热点新闻
- Endpoint URL: https://orz.ai/api/v1/dailynews
↓
Step 3: 调用热点新闻 API 获取各平台热点
- 对每个关注的平台调用：GET https://orz.ai/api/v1/dailynews/?platform={platform_code}
- 获取热点标题、URL、评分、描述等信息
- 合并所有平台的热点数据
↓
Step 4: 从 HAP "账号人设" 表读取账号人设配置
- 账号定位（positioning）
- 目标受众（target_audience）
- 内容方向（content_direction）
- 内容风格（content_style）
- 内容原则（content_principles）
↓
Step 5: 基于热点和账号人设分析选题
- 筛选与账号定位和内容方向相关的热点
- 分析每个热点的选题价值（热度、相关性、可创作性）
- 生成 5-10 个选题建议，每个选题包含：
- 选题标题
- 来源平台
- 选题角度（如何结合账号人设）
- 预期内容方向
- 推荐理由
- 相关度评分（1-10分）
- **按相关度评分排序，标注最推荐的选题**
↓
Step 6: 以 Markdown 表格形式展示选题建议，供用户选择
- **必须使用 Markdown 表格格式展示**，更加直观
- **表格结构**：
- 最推荐选题表格（AI 相关或评分 10/10 的选题）
- 其他推荐选题表格（评分 6-9/10 的选题）
- **表格列**：序号、选题标题、来源平台、选题角度、推荐理由、相关度评分
- **明确标注最推荐的选题**（如：⭐ 最推荐选题）
- 展示所有选题建议
- 用户选择一个或多个选题
↓
Step 6.5: 询问用户是否将选题加入选题库
- **询问用户**：是否将推荐的选题加入 HAP "选题库" 表
- **询问方式**：在展示选题建议后，询问"是否将这些选题加入选题库？"
- 如果用户确认，将用户选择的选题保存到 HAP "选题库" 表：
- `topic_title`: 选题标题
- `source_platform`: 来源平台（关联热点平台关注表，使用平台记录的 rowid）
- `topic_angle`: 选题角度
- `recommendation_reason`: 推荐理由
- `relevance_score`: 相关度评分
- `source_url`: 原文链接
- `content_preview`: 内容预览
- `topic_status`: 选题状态（默认：待创作）
- 如果用户不加入，跳过此步骤
- **批量保存**：如果用户选择了多个选题，使用 `batch_create_records` 批量保存
↓
Step 7: 用户选择选题后，深度搜索相关资料
- 从 HAP "API服务配置" 表读取搜索 API 配置（Tavily）
- 基于选题标题和角度，调用搜索 API 获取深度资料
- 结合热点新闻中的原始信息
↓
Step 8: 基于热点信息和搜索资料生成内容
- 结合热点信息（原始标题、描述、URL）
- 结合搜索到的深度资料
- 严格遵循账号人设中的内容风格和内容原则
- 生成符合账号定位的内容
↓
Step 9: 后续流程与标准内容生成流程相同
- 生成封面标题（5-10个备选）
- 选择话题标签（从 HAP 话题库）
- 生成配图建议
- 保存到本地文件（预览）
- 与用户确认内容、标题、图片
- 生成图片（用户确认后）
- 同步到 HAP（用户确认后）：
- **如果内容是基于选题库中的选题创作的**：
- 在创建内容记录时，关联对应的选题（`related_topic` 字段）
- 更新选题状态为"创作中"或"已创作"
- 选题库中的 `related_content` 字段会自动关联已创作的内容（双向关联）
- **如果内容不是基于选题创作的**：
- 不关联选题，`related_topic` 字段留空
- 发布到目标平台（用户确认后）
热点新闻 API 使用说明：
API 地址： https://orz.ai/api/v1/dailynews
请求方式： GET
参数：
platform: 平台代码（必需），支持的平台代码见"热点平台关注表"说明请求示例：
GET https://orz.ai/api/v1/dailynews/?platform=baidu
GET https://orz.ai/api/v1/dailynews/?platform=weibo
GET https://orz.ai/api/v1/dailynews/?platform=zhihu
响应格式：
{
"status": "200",
"data": [
{
"title": "热点标题",
"url": "热点链接",
"score": "热度评分",
"desc": "热点描述"
}
],
"msg": "success"
}
配置说明：
热点平台关注表配置：
is_followed = 1（勾选）表示关注此平台priority（优先级，1-10）控制获取顺序platform_code 必须与热点新闻 API 支持的平台代码一致选题建议展示格式（重要）：
## ⭐ 最推荐选题（AI 相关，强烈推荐）
| 序号 | 选题标题 | 来源平台 | 选题角度 | 推荐理由 |
|------|---------|---------|---------|---------|
| 1 | 选题标题1 | 平台1 | AI 技术科普 | 符合账号定位... |
## 📌 其他推荐选题
| 序号 | 选题标题 | 来源平台 | 选题角度 | 推荐理由 | 相关度 |
|------|---------|---------|---------|---------|--------|
| 1 | 选题标题2 | 平台2 | 技术趋势解读 | 符合内容方向... | 8/10 |
内容格式：
发布流程：
https://creator.xiaohongshu.com/publish/publish?type=image_textsetInputFiles）HAP 工作表：
内容管理（通用表，支持多平台）platform_type: 平台类型（SingleSelect: 小红书/抖音/微信公众号/视频号/其他）content_title: 内容标题（标题字段）cover_title: 封面标题content: 正文内容tags: 话题标签（空格分隔）cover_image: 封面图（附件）other_images: 其他配图（附件）markdown_doc: Markdown 文档（附件）publish_status: 发布状态（草稿/待发布/已发布/已取消）publish_time: 发布时间note_url: 内容链接（发布后更新，不同平台可能叫法不同）views: 浏览量likes: 点赞数collections: 收藏数comments: 评论数内容格式：
发布流程：
https://creator.douyin.com/内容格式：
发布流程：
https://mp.weixin.qq.com/内容格式：
发布流程：
API 服务配置管理：
搜索 API 配置统一存储在 HAP "API服务配置" 表中，按功能分类，每个功能一条记录包含所有配置字段。
重要：配置是动态获取的，不硬编码
配置读取流程：
get_app_info()）function_name（功能名称，如"Tavily 搜索API"）或 service_type（服务类型：搜索API）匹配配置config_status（配置状态）为"启用"Tavily API 配置示例：
# Step 1: 确认当前连接的 MCP 应用
current_app = mcp_hap-mcp-_get_app_info()
current_app_name = current_app['data']['name']
# Step 2: 动态获取工作表列表，通过别名匹配找到"API服务配置"表
# 重要：优先使用别名（alias）匹配，不要使用硬编码的 ID
worksheets = mcp_hap-mcp-_get_app_worksheets_list()
api_config_worksheet_id = None
for ws in worksheets:
# 优先通过别名匹配，如果别名不存在则使用名称匹配
if ws.get('alias') == 'api_service_config' or ws.get('name') == 'API服务配置':
api_config_worksheet_id = ws['id']
break
if not api_config_worksheet_id:
raise Exception(f"在应用「{current_app_name}」中未找到「API服务配置」表（别名：api_service_config）")
# Step 3: 查询 Tavily 搜索 API 配置
configs = mcp_hap-mcp-_get_record_list(
worksheet_id=api_config_worksheet_id,
filter={
"type": "group",
"logic": "AND",
"children": [
{
"type": "condition",
"field": "function_name",
"operator": "contains",
"value": ["Tavily"]
},
{
"type": "condition",
"field": "config_status",
"operator": "eq",
"value": ["启用"]
}
]
}
)
# Step 4: 提取配置并调用 API
if configs and len(configs) > 0:
config = configs[0]
api_key = config.get('api_key') # Tavily API Key（必需）
endpoint_url = config.get('endpoint_url') # Endpoint URL（必需）
# 验证必需字段
if not api_key:
raise Exception("Tavily API Key 未配置，请在 HAP 'API服务配置' 表中填写 api_key 字段")
if not endpoint_url:
raise Exception("Endpoint URL 未配置，请在 HAP 'API服务配置' 表中填写 endpoint_url 字段")
# 调用 Tavily API 搜索
import requests
response = requests.post(
f"{endpoint_url}/search",
headers={"Content-Type": "application/json"},
json={
"api_key": api_key,
"query": topic, # 用户输入的主题
"search_depth": "basic",
"max_results": 5,
"topic": "general",
"include_answer": False,
"include_raw_content": False,
"include_images": False
}
)
search_results = response.json().get('results', [])
# 使用搜索结果生成内容
Tavily API 配置字段说明（必需字段）：
function_name: 功能名称（Text，标题字段，如："Tavily 搜索API"）provider: 服务提供商（Text，如："Tavily"）service_type: 服务类型（SingleSelect: 搜索API/图片生成/内容生成/数据分析/其他）api_key: API Key（Text，必需） - Tavily API Key，如：tvly-dev-xxx...
endpoint_url: Endpoint URL（Text，必需） - API 基础地址，如：https://api.tavily.com
config_status: 配置状态（SingleSelect: 启用/禁用）purpose: 用途说明（Text，如："用于搜索主题相关资料"）搜索流程：
搜索参数说明：
query: 搜索主题（用户输入）search_depth: 搜索深度（basic/advanced，推荐 basic）max_results: 最大结果数（推荐 5）topic: 主题类型（general/tech/business 等）include_answer: 是否包含答案摘要（False）include_raw_content: 是否包含原始内容（False）include_images: 是否包含图片（False）功能配置示例（HAP 表中）：
热点新闻 API 配置示例（HAP 表中）：
重要提示：
api_key 和 endpoint_url 是搜索 API 的必需字段，必须填写api_key 用于 API 认证endpoint_url 用于指定 API 的访问地址，格式如：https://api.tavily.comapi_key，只需要填写 endpoint_url必须从 HAP "账号人设" 表读取账号人设配置：
重要原则：生成内容之前，必须先从 HAP "账号人设" 表读取账号人设配置，严格遵循账号定位和内容规则。
强制要求：
AGENTS.md 或其他本地文件作为账号人设来源get_record_list() 从 HAP "账号人设" 表读取content_style 和 content_principles 执行读取流程：
platform_name 或 platform_type 查询对应平台的账号人设账号人设表字段：
platform_name: 平台名称（Text，标题字段）platform_type: 平台类型（SingleSelect: 小红书/抖音/微信公众号/视频号）positioning: 账号定位（Text，必需） - 账号的核心定位，用于指导内容方向target_audience: 目标受众（Text，必需） - 内容面向的受众群体，用于调整内容风格和深度content_direction: 内容方向（Text，必需） - 内容的主要方向，用于确定内容主题和范围content_style: 内容风格（Text，必需） - 内容应该采用的风格，必须严格遵循
content_principles: 内容原则（Text，必需） - 内容创作的原则和注意事项，必须严格遵守
image_generation_prompt: 图片生成提示词（Text） - 用于生成图片的风格提示词
使用示例（必须严格按照此流程执行）：
# Step 1: 确认当前连接的 HAP MCP 应用
current_app = mcp_hap-mcp-_get_app_info()
current_app_name = current_app['data']['name']
print(f"当前连接的 HAP 应用：{current_app_name}")
# Step 2: 通过别名匹配找到"账号人设"表（不要使用硬编码 ID）
worksheets = mcp_hap-mcp-_get_app_worksheets_list()
persona_worksheet_id = None
for ws in worksheets:
# 优先通过别名匹配，如果别名不存在则使用名称匹配
if ws.get('alias') == 'account_persona' or ws.get('name') == '账号人设':
persona_worksheet_id = ws['id']
break
if not persona_worksheet_id:
raise Exception(f"在应用「{current_app_name}」中未找到「账号人设」表（别名：account_persona）。请确保 HAP 应用中存在此表。")
# Step 3: 查询小红书账号人设（重要：必须在生成内容之前读取）
personas = mcp_hap-mcp-_get_record_list(
worksheet_id=persona_worksheet_id, # 使用通过别名匹配获取的 ID
filter={
"type": "group",
"logic": "AND",
"children": [
{
"type": "condition",
"field": "platform_type",
"operator": "eq",
"value": ["小红书"]
}
]
}
)
# Step 4: 验证是否读取到账号人设（强制要求）
if not personas or len(personas) == 0:
raise Exception(f"在应用「{current_app_name}」的「账号人设」表中未找到小红书账号人设配置。请先在 HAP 中添加账号人设记录。")
persona = personas[0]
# Step 5: 读取所有账号人设字段（必需）
positioning = persona.get('positioning') # 账号定位
target_audience = persona.get('target_audience') # 目标受众
content_direction = persona.get('content_direction') # 内容方向
content_style = persona.get('content_style') # 内容风格（必须严格遵循）
content_principles = persona.get('content_principles') # 内容原则（必须严格遵守）
image_prompt_base = persona.get('image_generation_prompt', '') # 图片风格基础提示词
# Step 6: 验证必需字段是否存在
if not content_style:
raise Exception(f"账号人设配置中缺少「内容风格」（content_style）字段，无法生成内容。")
if not content_principles:
raise Exception(f"账号人设配置中缺少「内容原则」（content_principles）字段，无法生成内容。")
# Step 7: 打印账号人设信息（用于确认）
print(f"\n✅ 已从 HAP 读取账号人设配置：")
print(f" - 账号定位：{positioning}")
print(f" - 目标受众：{target_audience}")
print(f" - 内容方向：{content_direction}")
print(f" - 内容风格：{content_style[:100]}...")
print(f" - 内容原则：{content_principles[:100]}...")
# Step 8: 根据账号人设和搜索结果生成内容
# **必须严格遵循从 HAP 读取的 content_style 和 content_principles**
# **禁止使用本地 AGENTS.md 文件或其他本地文件**
# 生成内容示例：
# 1. 根据 content_style 确定写作风格（如：通俗易懂、专业但不高冷等）
# 2. 根据 content_principles 确定内容原则（如：用简单语言解释复杂技术、避免专业术语堆砌等）
# 3. 根据 positioning 确定内容定位（如：IT公司产品经理视角）
# 4. 根据 target_audience 调整内容深度和表达方式
# 5. 根据 content_direction 确定内容主题和范围
# 6. 结合搜索结果中的资料，生成符合账号人设的内容
# 生成标题时，也要遵循从 HAP 读取的 content_style 和 positioning
# 生成配图建议时，要结合从 HAP 读取的 image_prompt_base
# 生成图片时，将从 HAP 读取的 image_prompt_base 与具体内容结合
内容生成流程：
content_style（内容风格）来撰写content_principles（内容原则）positioning（账号定位）target_audience（目标受众）content_direction（内容方向）小红书笔记（300-400字）通用要求：
内容生成流程（参考 wechat-article-writer skill）：
微信公众号文章（2000-5000字）通用要求：
注意：以上是通用要求，实际撰写时必须严格遵循账号人设中的 content_style 和 content_principles。
生成 5-10 个备选标题，参考小红书爆款标题特点：
标题类型：
重要：
content_style（内容风格）positioning（账号定位）和 target_audience（目标受众）从 HAP 话题库表中选取：
选择策略：
content_direction（内容方向）和 target_audience（目标受众）查询方法：
# Step 1: 通过别名匹配找到"话题库"表（不要使用硬编码 ID）
worksheets = mcp_hap-mcp-_get_app_worksheets_list()
topics_worksheet_id = None
for ws in worksheets:
# 优先通过别名匹配，如果别名不存在则使用名称匹配
if ws.get('alias') == 'topic_library' or ws.get('name') == '话题库':
topics_worksheet_id = ws['id']
break
if not topics_worksheet_id:
raise Exception(f"在应用「{current_app_name}」中未找到「话题库」表（别名：topic_library）")
# Step 2: 查询高热度话题
mcp_hap-mcp-_get_record_list(
worksheet_id=topics_worksheet_id, # 使用通过别名匹配获取的 ID
filter={
"type": "group",
"logic": "AND",
"children": [
{
"type": "condition",
"field": "heat_level",
"operator": "eq",
"value": ["高热度"]
}
]
}
)
# 查询特定平台的内容（通过别名匹配获取工作表ID）
# Step 1: 通过别名匹配找到"内容管理"表（不要使用硬编码 ID）
worksheets = mcp_hap-mcp-_get_app_worksheets_list()
content_worksheet_id = None
for ws in worksheets:
# 优先通过别名匹配，如果别名不存在则使用名称匹配
if ws.get('alias') == 'content_management' or ws.get('name') == '内容管理':
content_worksheet_id = ws['id']
break
if not content_worksheet_id:
raise Exception(f"在应用「{current_app_name}」中未找到「内容管理」表（别名：content_management）")
# Step 2: 查询小红书内容
mcp_hap-mcp-_get_record_list(
worksheet_id=content_worksheet_id,
filter={
"type": "group",
"logic": "AND",
"children": [
{
"type": "condition",
"field": "platform_type",
"operator": "eq",
"value": ["小红书"]
}
]
}
)
API 服务配置管理：
所有 API 服务配置统一存储在 HAP "API服务配置" 表中，按功能分类，每个功能一条记录包含所有配置字段。
重要：配置是动态获取的，不硬编码
多配置选择机制：
is_default（是否默认）字段控制使用哪个配置
config_status（配置状态）为"启用"的配置才会被使用配置读取流程：
get_app_info()）service_type = 图片生成 且 config_status = 启用）is_default = 1（是默认）的配置配置选择示例：
# Step 1: 确认当前连接的 MCP 应用
current_app = mcp_hap-mcp-_get_app_info()
current_app_name = current_app['data']['name']
# Step 2: 通过别名匹配找到"API服务配置"表
worksheets = mcp_hap-mcp-_get_app_worksheets_list()
api_config_worksheet_id = None
for ws in worksheets:
if ws.get('alias') == 'api_service_config' or ws.get('name') == 'API服务配置' or ws.get('name') == '密钥管理':
api_config_worksheet_id = ws['id']
break
if not api_config_worksheet_id:
raise Exception(f"在应用「{current_app_name}」中未找到「API服务配置」表（别名：api_service_config）")
# Step 3: 查询所有图片生成 API 配置（启用状态）
configs = mcp_hap-mcp-_get_record_list(
worksheet_id=api_config_worksheet_id,
filter={
"type": "group",
"logic": "AND",
"children": [
{
"type": "condition",
"field": "service_type",
"operator": "eq",
"value": ["图片生成"]
},
{
"type": "condition",
"field": "config_status",
"operator": "eq",
"value": ["启用"]
}
]
}
)
# Step 4: 选择配置（优先使用默认配置）
if configs and len(configs) > 0:
# 优先选择标记为"默认"的配置
default_config = None
for config in configs:
if config.get('is_default') == 1:
default_config = config
break
# 如果没有默认配置，使用第一个启用的配置
if not default_config:
default_config = configs[0]
config = default_config
# 根据服务提供商读取对应的配置字段
provider = config.get('provider', '').upper()
if 'TUZI' in provider:
# TUZI API (OpenAI 兼容接口)
api_key = config.get('api_key') # 必需
endpoint_url = config.get('endpoint_url', 'https://api.tu-zi.com/v1') # 必需
# 使用 OpenAI SDK 调用
elif '火山引擎' in provider or '即梦' in config.get('function_name', ''):
# 火山引擎即梦 API
access_key_id = config.get('access_key_id') # 必需
secret_access_key = config.get('secret_access_key') # 必需
region = config.get('region', 'cn-beijing')
service = config.get('service', 'cv')
api_version = config.get('api_version', 'jimeng_t2i_v31')
sdk_name = config.get('sdk_name', 'volcenginesdkcv20240606')
# 使用火山引擎 SDK 调用
生成流程：
image_generation_prompt（图片生成提示词）is_default = 1（是默认）的配置api_key、endpoint_urlaccess_key_id、secret_access_key、region、service 等{image_generation_prompt}，{具体配图内容描述}手绘风格插画，清新活泼的卡通插画风格，{具体图片内容}response_format="url" 参数：确保 API 返回 URL 格式而非 base64model、prompt、n=1、response_format="url"、size="{width}x{height}"配图/image_urls.json（只保存 URL，不保存 base64）配图/{图片名称}.png，方便本地查看和展示图片格式要求（小红书）：
图片类型（必须遵循账号人设）：
手绘风格插画特点（参考）：
重要：
image_generation_prompt（图片生成提示词）来生成图片提示词生成规则：
image_generation_prompt（图片风格基础提示词）{image_generation_prompt}，{具体图片内容描述，与内容强相关}{image_generation_prompt}，封面图内容: {具体内容描述}，标题文字: "{封面标题}"，使用粗体装饰性字体，带笔画和渐变效果创建一个手绘风格的插画作品,具有以下特点: 整体风格: 清新活泼的卡通插画风格,充满正能量和活力...展示"agentic 是什么"的核心概念,中心是一个可爱的大脑图标,大脑周围有多个小机器人或执行箭头,表示自主规划和执行能力3分钟搞懂 agentic AI！{image_generation_prompt}，封面图内容: 展示"agentic 是什么"的核心概念,中心是一个可爱的大脑图标,大脑周围有多个小机器人或执行箭头,表示自主规划和执行能力。上方有粗体装饰性标题文字"3分钟搞懂 agentic AI！",使用粗体装饰性字体,带笔画和渐变效果,增强视觉冲击力。标题文字要醒目,占据封面重要位置,符合小红书封面图设计规范。创建一个手绘风格的插画作品...左右分屏对比,左侧展示传统AI - 一个简单的问答机形象,只能被动回答问题,用问号表示。右侧展示agentic AI - 一个智能助手形象,正在自主规划任务、执行操作,用执行箭头和任务卡片表示。中间用粗箭头连接,表示从"被动响应"到"主动执行"的转变。整体清晰易懂,色彩对比鲜明。{image_generation_prompt}，{具体图片内容描述}内容管理表（通用表，支持多平台）：
platform_type: 平台类型（SingleSelect: 小红书/抖音/微信公众号/视频号/其他）content_title: 内容标题（Text，标题字段）cover_title: 封面标题（Text）content: 正文内容（Text）tags: 话题标签（Text）cover_image: 封面图（Attachment）other_images: 其他配图（Attachment）markdown_doc: Markdown 文档（Attachment，小红书笔记不使用此字段）related_topic: 关联选题（Relation，关联选题库表，单选，双向关联）publish_status: 发布状态（SingleSelect: 草稿/待发布/已发布/已取消）publish_time: 发布时间（DateTime）note_url: 内容链接（Text，不同平台可能叫法不同）views: 浏览量（Number）likes: 点赞数（Number）collections: 收藏数（Number）comments: 评论数（Number）重要说明：
markdown_doc 字段仅用于其他平台（如微信公众号），小红书笔记不使用此字段related_content 字段会自动关联已创作的内容设计说明：
platform_type 字段区分不同平台话题标签库表：
topic_name: 话题名称（Text）topic_type: 话题类型（SingleSelect）heat_level: 热度等级（SingleSelect: 高热度/中热度/低热度）description: 说明（Text）last_updated: 最后更新（DateTime）选题库表：
topic_title: 选题标题（Text，标题字段）source_platform: 来源平台（Relation，关联热点平台关注表，单选）topic_angle: 选题角度（Text，如何结合账号人设）recommendation_reason: 推荐理由（Text）relevance_score: 相关度评分（Number，1-10分）source_url: 原文链接（Text）content_preview: 内容预览（Text，多行文本）topic_status: 选题状态（SingleSelect: 待创作/创作中/已创作/已取消）related_content: 关联内容（Relation，关联内容管理表，多选，双向关联）notes: 备注（Text，多行文本）设计说明：
related_content 字段可以关联多个已创作的内容related_topic 字段可以关联对应的选题账号人设表：
platform_name: 平台名称（Text，标题字段）platform_type: 平台类型（SingleSelect: 小红书/抖音/微信公众号/视频号）positioning: 账号定位（Text）target_audience: 目标受众（Text）content_direction: 内容方向（Text）content_style: 内容风格（Text）content_principles: 内容原则（Text）image_generation_prompt: 图片生成提示词（Text）
热点平台关注表：
platform_name: 平台名称（Text，标题字段，如："百度热搜"、"微博热搜"）platform_code: 平台代码（Text，如："baidu"、"weibo"，对应热点新闻 API 的平台代码）platform_type: 平台类型（SingleSelect: 综合新闻/科技/社交媒体/财经/技术社区/其他）is_followed: 是否关注（Checkbox）- 用户是否关注此平台的热点priority: 优先级（Number，1-10，数字越大优先级越高）description: 平台说明（Text，描述平台特点和内容类型）last_fetch_time: 最后获取时间（DateTime，记录最后一次获取该平台热点的时间）支持的平台代码（对应热点新闻 API）：
baidu: 百度热搜（社会热点、娱乐、事件）sspai: 少数派（科技、数码、生活方式）weibo: 微博热搜（社交媒体热点、娱乐、事件）zhihu: 知乎热榜（问答、深度内容、社会热点）tskr: 36氪（科技创业、商业资讯）ftpojie: 吾爱破解（技术、软件、安全）bilibili: 哔哩哔哩（视频、动漫、游戏、生活）douban: 豆瓣（书影音、文化、讨论）hupu: 虎扑（体育、游戏、数码）tieba: 百度贴吧（兴趣社区、话题讨论）juejin: 掘金（编程、技术文章）douyin: 抖音（短视频热点、娱乐）vtex: V2EX（技术、编程、创意）jinritoutiao: 今日头条（新闻、热点事件）stackoverflow: Stack Overflow（编程问答、技术讨论）github: GitHub Trending（开源项目、编程语言）hackernews: Hacker News（科技新闻、创业、编程）sina_finance: 新浪财经（财经新闻、股市资讯）eastmoney: 东方财富（财经资讯、投资理财）xueqiu: 雪球（股票投资、财经社区）cls: 财联社（财经快讯、市场动态）tenxunwang: 腾讯网（综合新闻、娱乐、科技）API服务配置表：
function_name: 功能名称（Text，标题字段，如："Tavily 搜索API"、"TUZI 图片生成"、"即梦图片生成"、"热点新闻API"）provider: 服务提供商（Text，如："Tavily"、"TUZI"、"火山引擎"、"orz.ai"）service_type: 服务类型（SingleSelect: 搜索API/图片生成/内容生成/数据分析/热点新闻/其他）purpose: 用途说明（Text，如："用于搜索主题相关资料"、"用于生成图片"、"用于获取热点新闻"）is_default: 是否默认（Checkbox） - 用于控制使用哪个图片生成 API 配置
is_default = 1（是默认）的配置，如果没有默认配置则使用第一个启用的配置endpoint_url: Endpoint URL（Text，必需） - API 基础地址
https://orz.ai/api/v1/dailynews密钥字段（用户可填写）：
api_key: API Key（Text，必需） - 用于 API 认证
endpoint_url: Endpoint URL（Text，必需） - API 基础地址
https://api.tavily.comhttps://api.openai.com/v1https://proxy.example.comaccess_key_id: Access Key ID（Text）
secret_access_key: Secret Access Key（Text）
api_secret: API Secret（Text）
token: Token（Text）
app_id: App ID（Text）
app_secret: App Secret（Text）
配置字段：
endpoint_url: Endpoint URL（Text，必需） - API 基础地址
https://api.tavily.comhttps://api.openai.com/v1https://ark.cn-beijing.volces.com/api/v3https://proxy.example.comregion: Region（Text）
service: Service（Text）
api_version: API版本（Text）
sdk_name: SDK名称（Text）
extra_config: 其他配置（Text）
config_status: 配置状态（SingleSelect: 启用/禁用）notes: 备注（Text）使用说明：
endpoint_url（API 基础地址）api_key 和 endpoint_urlaccess_key_id、secret_access_key 和 endpoint_urlapi_key 和 endpoint_urlapp_id、app_secret 和 endpoint_urlendpoint_url 格式：完整的 API 基础地址，如 https://api.tavily.com 或 https://api.openai.com/v1功能配置示例：
Tavily 搜索API：用于搜索主题相关资料
TUZI 图片生成：用于生成图片（OpenAI 兼容接口）
即梦图片生成：用于生成图片（文生图3.1）
重要：
1. 搜索资料（Tavily API）→ 获取最新信息
2. 生成内容 → 保存到本地文件（预览，按笔记目录结构：`内容/{平台}/{笔记标题}/{笔记标题}.md`）
3. 与用户确认内容、标题、图片
4. 用户确认后生成图片 → 保存到笔记目录的配图文件夹（`内容/{平台}/{笔记标题}/配图/`）
5. 与用户确认是否发布和同步
6. 用户确认后同步到 HAP：
- **小红书笔记**：只上传图片 URL（封面图和其他配图），不上传 Markdown 文档
- **其他平台**：根据平台需求上传图片和文档
7. 用户确认后发布 → 使用 Playwright 发布到目标平台
8. 发布成功 → 更新发布状态和笔记链接
目录结构说明：
- `内容/`：根目录
- `内容/{平台}/`：平台目录（小红书/抖音/微信公众号/视频号）
- `内容/{平台}/{笔记标题}/`：笔记目录，使用封面标题作为目录名
- `内容/{平台}/{笔记标题}/{笔记标题}.md`：Markdown 文档（仅本地保存，小红书不同步到 HAP）
- `内容/{平台}/{笔记标题}/配图/`：配图文件夹
重要说明：
- **小红书笔记的 Markdown 文档不同步到 HAP**，只同步图片 URL
- Markdown 文档仅保存在本地，用于预览和编辑
- 图片生成后：
1. 保存图片 URL 到 `配图/image_urls.json`
2. **下载图片到本地**：保存图片文件到 `配图/{图片名称}.png`（如：封面图.png、对比图.png），方便本地查看和展示
3. 通过 MCP 上传 URL 到 HAP（上传时使用 URL，不需要 base64）
发布前准备：
发布流程（小红书示例）：
// 1. 导航到发布页面
await page.goto('https://creator.xiaohongshu.com/publish/publish?type=image_text');
// 2. 上传图片
const fileInput = await page.locator('input[type="file"]').first();
await fileInput.setInputFiles(imageFiles);
// 3. 填写标题
await page.getByRole('textbox', { name: '填写标题会有更多赞哦～' }).fill(title);
// 4. 填写正文（包含话题标签）
await page.getByRole('textbox').nth(1).fill(content + '\n\n' + tags);
// 5. 点击发布
await page.getByRole('button', { name: '发布' }).click();
// 6. 等待发布成功，获取笔记链接
// 7. 更新 HAP 记录：发布状态、发布时间、笔记链接
发布后处理：
platform_type: 目标平台（小红书/抖音/微信公众号/视频号）publish_status: 已发布publish_time: 当前时间note_url: 内容链接用户：帮我生成一篇关于 "Skills 科普介绍" 的小红书笔记并发布
执行流程：
1. **确认 MCP**：确认当前连接的 HAP 应用 MCP（通过用户提供或指定）
2. **读取搜索配置**：从 HAP "API服务配置" 表读取 Tavily 搜索 API 配置
3. **搜索资料**：调用 Tavily API 搜索主题相关资料（获取最新 5 条结果）
4. **【强制要求】读取账号人设**（必须在生成内容之前执行）：从 HAP "账号人设" 表读取账号人设配置
- **禁止使用本地文件**：绝对不允许使用 `AGENTS.md` 或其他本地文件
- **必须调用 HAP MCP**：必须通过 MCP 调用 `get_record_list()` 从 HAP "账号人设" 表读取
- **读取所有必需字段**：
- **账号定位**（positioning）：了解账号的核心定位
- **目标受众**（target_audience）：了解内容面向的受众群体
- **内容方向**（content_direction）：了解内容的主要方向
- **内容风格**（content_style）：了解内容应该采用的风格（必须严格遵循）
- **内容原则**（content_principles）：了解内容创作的原则和注意事项（必须严格遵守）
- **图片生成提示词**（image_generation_prompt）：了解图片风格要求
- **验证要求**：如果未找到账号人设配置，必须抛出异常，不允许继续生成内容
5. **撰写内容**：根据搜索结果和从 HAP 读取的账号人设撰写内容
- **严格遵循账号人设**：必须严格按照从 HAP 读取的 `content_style` 和 `content_principles` 来撰写
- **禁止使用本地人设**：不允许参考或使用本地 `AGENTS.md` 文件中的内容
- **结合搜索资料**：将搜索到的资料与从 HAP 读取的账号人设结合，生成符合定位的内容
- **符合目标受众**：确保内容适合目标受众阅读
6. **生成封面标题**：根据账号人设的内容风格生成 5-10 个封面标题
- 标题风格必须符合账号人设的内容风格
- 标题要符合账号定位和目标受众
7. **选择话题标签**：从 HAP 话题库选择 5-8 个话题标签（动态查询）
- 根据内容主题和账号人设的内容方向选择
8. **生成配图建议**：结合账号人设的图片生成提示词风格，生成配图建议
9. **保存预览**：保存到本地文件（按笔记目录结构：`内容/小红书/{笔记标题}/{笔记标题}.md`）
10. **与用户确认**：与用户确认内容、标题、图片
11. **生成图片**（用户确认后）：从 HAP "账号人设" 表读取图片生成提示词，从 HAP "API服务配置" 表读取图片生成配置，生成图片
12. **与用户确认发布**：与用户确认是否直接发布至小红书
13. **与用户确认同步**：与用户确认是否同步到 HAP，确认后才上传
14. **同步 HAP**（用户确认后）：同步到 HAP "内容管理" 表（platform_type = 小红书）
- **只上传图片**：上传封面图和其他配图的 URL 到 HAP
- **不上传 Markdown 文档**：小红书笔记的 Markdown 文档不同步到 HAP
15. **发布内容**（用户确认后）：使用 Playwright 发布到小红书
16. **更新状态**：更新 HAP 发布状态和内容链接
用户：帮我生成一周的小红书笔记（7篇），主题如下：
1. Claude Code 新功能
2. AI 工具推荐
3. 大模型应用场景
...
执行流程：
1. **确认 MCP**：确认当前连接的 HAP 应用 MCP
2. **批量生成**：对每个主题重复上述流程
3. **动态读取配置**：每次生成图片时从 HAP "API服务配置" 表动态读取配置
4. **批量保存**：批量生成并保存到 HAP "内容管理" 表（platform_type = 小红书）
用户：将这篇笔记发布到小红书和微信公众号
执行流程：
1. **确认 MCP**：确认当前连接的 HAP 应用 MCP
2. **读取内容**：从 HAP "内容管理" 表读取内容（platform_type = 小红书）
3. **动态获取工作表**：动态获取"内容管理"表的 ID 和字段结构
4. **适配格式**：适配不同平台的格式要求：
- 小红书：300-400字，5-8个话题标签
- 微信公众号：2000-5000字，HTML格式
5. **发布内容**：分别发布到两个平台
6. **更新 HAP**：在 HAP "内容管理" 表中创建新记录（platform_type = 微信公众号），或更新现有记录的发布状态
用户需要提供：
Skill 会自动：
social-media-operation/
├── AGENTS.md # 账号人设配置（可选，本地参考文件）
├── 笔记生成工作流.md # 工作流说明
├── 内容/ # 内容根目录
│ └── 小红书/ # 平台分类（小红书/抖音/微信公众号/视频号）
│ └── {笔记标题}/ # 每个笔记一个目录，使用封面标题作为目录名
│ ├── {笔记标题}.md # Markdown 文档（使用笔记标题命名）
│ └── 配图/ # 配图目录
│ ├── 封面图.png
│ ├── 架构图.png
│ └── 应用场景图.png
├── 话题库/ # 话题标签库（可选，本地参考文件）
│ └── {类型}.md
└── README.md # 项目说明
目录结构说明：
- 内容/：根目录，包含所有平台的内容
- 小红书/：平台目录，展示该平台的所有笔记标题（目录名）
- {笔记标题}/：笔记目录，使用封面标题作为目录名，更清晰直观
- {笔记标题}.md：Markdown 文档，使用笔记标题命名
- 配图/：配图文件夹，包含该笔记的所有配图
示例：
内容/
└── 小红书/
└── MCP 是什么？/ # 笔记标题作为目录名
├── MCP科普介绍.md # Markdown 文档
└── 配图/
├── 封面图.png
├── 架构图.png
└── 应用场景图.png
注意：
- 账号人设和话题库数据统一存储在 HAP 中
- 本地文件仅作为参考，实际使用时从 HAP 表读取
- 内容按笔记目录结构组织，每个笔记包含 md 文档和配图
- 目录名使用笔记标题，更清晰直观
重要：应用名称和 MCP 配置由用户提供，不硬编码
通用工作表结构（用户需要在 HAP 中创建）：
工作表创建：
get_app_worksheets_list() 动态获取工作表列表MCP 配置由用户提供：
MCP 应用确认：
get_app_info() 确认当前连接的 MCP 应用动态读取配置：
get_record_list() 查询配置，根据功能名称或服务类型匹配工作表动态识别（重要）：
get_app_worksheets_list() 动态获取工作表列表账号人设读取检查清单（必须严格执行）：
get_app_info() 确认当前连接的 HAP MCP 应用get_app_worksheets_list() 动态获取工作表列表，通过别名 account_persona 或名称 账号人设 匹配get_record_list() 根据 platform_type 查询对应平台的账号人设记录content_style 和 content_principles 字段，如果缺失则抛出异常AGENTS.md 或其他本地文件作为账号人设来源content_style 和 content_principles 执行其他注意事项：
5. 内容预览：生成内容后先保存到本地文件，用户确认后再同步到 HAP
6. 图片生成：图片生成可能失败（SSL 错误），需要重试或手动制作
7. 发布登录：发布前需要用户先登录目标平台
8. 字数控制：不同平台的字数要求不同，需要适配
9. 话题标签：必须从 HAP 话题库中选取，不要自己编造
10. 账号人设：必须从 HAP "账号人设" 表中读取，禁止使用本地文件，包括图片生成提示词
11. 图片风格：生成图片时，将从 HAP 读取的账号人设中的 image_generation_prompt 与具体配图建议结合
MCP 配置：
配置管理：
工作表识别（重要）：