living-stream/akka/content-publishing

内容发布 (Content Publishing)

目标

将已生成的笔记内容发布到目标平台，支持即时发布。

前置检查

1. 确认笔记路径

在发布前，必须明确笔记位置：

如果用户未指定路径：

1. 调用 list_generated_notes() 查看所有已生成的笔记
2. 向用户确认要发布哪一篇
3. 获取笔记的完整路径

如果用户已指定路径：

• 直接使用用户提供的路径

2. 检查笔记完整性

确认笔记目录包含以下文件：

• copywriting.md：标题、正文、标签
• images/：配图（至少1张）

如果文件不完整，告知用户并终止发布。

工作流

1) 确认笔记存在

调用 list_generated_notes() 确认笔记是否已生成，获取笔记的完整路径。

2) 使用 use_browser 执行发布

重要：必须传递 folder_path 参数，值为笔记的完整路径。

调用示例：

use_browser(
    instruction="Step 1: 使用 read_note_resources action 获取笔记资源...",
    folder_path="/Users/.../workspace/笔记名称"
)

指令内容，按顺序包含以下步骤：

Step 1: 使用 read_note_resources action 获取笔记路径 "笔记路径" 的资源。
Step 2: 登录小红书创作者平台 (https://creator.xiaohongshu.com)，点击发布笔记按钮，上传图片
Step 3: 填写标题
Step 4: 填写正文（浏览器会自动读取笔记内容，无需详细写出)
step 5:  填写换行
Step 6: 使用视觉能力查看平台推荐的标签，勾选5-6个相关标签
Step 7: 确认发布

完整示例:

use_browser(
    instruction="Step 1: 使用 read_note_resources action 获取笔记资源。Step 2: 登录小红书创作者平台，点击发布笔记按钮,上传图片。Step 3: 填写标题。Step 4: 填写正文（注意换行)。step 5: 填写换行。Step 6: 使用视觉能力查看平台推荐的标签,勾选5-6个相关标签。Step 7: 确认发布",
    folder_path="/Users/test_user/workspace/打工人提神咖啡攻略"
)

read_note_resources 会自动处理：

• 读取 outline.md 文件（大纲）
• 读取 copywriting.md 文件（标题、正文、标签）
• 列出 images/ 目录下的所有图片路径

3) 选择发布平台

根据用户指令或内容类型选择平台：

默认平台：小红书（如果用户未指定）

4) 发布后验证

确认发布成功：

• [ ] 页面显示"发布成功"提示
• [ ] 能够看到发布的笔记链接
• [ ] 图片显示正常
• [ ] 标签和封面正确

记录发布信息：

• 发布平台
• 发布时间
• 笔记链接（如果有）
• 发布状态

示例场景

场景1：立即发布指定笔记

用户指令："立即发布位于 “/users/test_user/workspace/咖啡攻略” 的笔记到小红书"

执行流程：

1. 调用 list_generated_notes() 确认笔记存在
2. 调用 use_browser，指令包含：

• Step 1: 使用 read_note_resources action 获取笔记资源
• Step 2: 登录小红书，上传图片
• Step 3: 填写标题
• Step 4: 填写正文
• step 5: 填写换行
• Step 6: 使用视觉能力查看平台推荐的标签，勾选5-6个相关标签（不要手动输入标签）
• Step 7: 确认发布

1. 验证发布成功

场景2：发布未指定路径的笔记

用户指令："马上发布我刚才生成的咖啡笔记"

执行流程：

1. 调用 list_generated_notes() 查看所有笔记
2. 找到最新的咖啡相关笔记
3. 向用户确认："找到最新笔记《咖啡攻略》，位于 /users/test_user/workspace/咖啡攻略，是否发布？"
4. 用户确认后，调用 use_browser 执行发布流程

场景3：发布到多个平台

用户指令："把咖啡攻略同时发布到小红书和公众号"

执行流程：

1. 调用 list_generated_notes() 确认笔记存在
2. 调用 use_browser 先发布到小红书
3. 再次调用 use_browser 发布到微信公众号
4. 记录两个平台的发布链接

常见问题处理

1. 笔记文件不完整：

• 缺少 copywriting.md：告知用户"笔记文案文件不存在"
• 缺少 images/：告知用户"笔记图片目录不存在"
• 图片数量为0：告知用户"没有找到图片，至少需要1张图片"

1. 发布失败：

• 网络问题：重试发布
• 平台审核：告知用户"内容需要审核，请稍后查看"
• 内容违规：告知用户"内容可能违反平台规则，请修改后重试"

1. 用户未指定平台：

• 默认发布到小红书
• 告知用户"已发布到小红书，如需发布到其他平台请说明"

与定时发布的区别

完成标准

• 笔记路径明确且文件完整
• 成功读取标题、正文、标签、图片路径
• 正文内容已正确填写（注意换行）
• 内容已发布到目标平台
• 发布状态已验证
• 发布信息已记录（平台、时间、链接）