菜单
自媒体运营自动化技能，支持小红书、抖音、微信公众号、视频号等平台的内容生成、图片生成、数据管理和自动化发布。包含 Tavily API 搜索、内容生成、图片生成、HAP 数据管理和自动化发布等完整流程。新增每日热点内容推荐功能。图片生成支持并行生成、自动下载、自动跳过已存在图片等优化功能。强制要求从 HAP "账号人设" 表读取账号人设配置，禁止使用本地文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
明道云 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) 两种文档类型。
使用明道云 HAP V3 接口搭建页面和操作数据的专业技能。**立即触发条件**：用户提到"HAP V3"、"HAP API"、"接口调用"、"数据接口"、"Appkey"、"Sign"、"接口鉴权"、"Filter 筛选"、"查询数据"、"创建记录"。提供完整的 API 使用指南：鉴权配置、接口调用、筛选器使用、数据操作等。如果用户已配置 HAP MCP，AI 应该自动从 MCP 配置中提取鉴权密钥。
创建和开发明道云 HAP 自定义视图插件的技能。**立即触发条件**：用户提到"HAP 视图插件"、"自定义视图"、"mdye"、"视图开发"、"插件开发"、"初始化视图项目"、"启动视图调试"。提供完整的开发工作流程、API 使用指南和最佳实践。
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
| 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 配置：
配置管理：
工作表识别（重要）：