314 lines
10 KiB
Markdown
314 lines
10 KiB
Markdown
# N8N 内容转化流水线工作流设计（v4）
|
||
|
||
> 用于：AI 英文文章 → 中文公众号/X/视频 内容转化
|
||
> 工作流ID：`iOf32aOKvTjfTDSM`
|
||
> 触发方式：OpenClaw 通过 Webhook 调用
|
||
> 管理平台：Mac mini 上的 n8n (`https://n8n.ishenwei.online`)
|
||
|
||
---
|
||
|
||
## 📋 工作流概述
|
||
|
||
**当前活跃版本：** v1 (`xQDabttYmLaY8qtr`) / v3 (`tOGMiC6qOJPOY89E`)
|
||
**最新开发版本：** v4 (`iOf32aOKvTjfTDSM`) — 未激活
|
||
|
||
```
|
||
OpenClaw (发现文章)
|
||
↓ (保存文件到 n8n-files 目录)
|
||
↓ (触发 Webhook)
|
||
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ N8N 工作流 (v4): content-translation-pipeline-v4 │
|
||
│ │
|
||
│ [Webhook] → [Read File] → [Extract Text] → [AI Agent] │
|
||
│ ↓ ↑ (DeepSeek) │
|
||
│ [Convert to File] → [Write File] → [Send Telegram] │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 🔌 节点详细设计（v4）
|
||
|
||
### 节点 1️⃣：Webhook Trigger
|
||
|
||
**类型：** Webhook
|
||
**名称：** `Webhook Trigger`
|
||
**Path：** `/content-translation-v4`
|
||
**Method：** POST
|
||
|
||
**接收数据格式：**
|
||
```json
|
||
{
|
||
"note_name": "article-2026-03-29.md",
|
||
"callback_url": "http://192.168.3.189:18789/webhook/yunce"
|
||
}
|
||
```
|
||
|
||
**注意：** v4 使用 `note_name`（文件名）而非 `note_path`，文件需预先上传到 n8n 容器的 `/home/node/.n8n-files/` 目录。
|
||
|
||
---
|
||
|
||
### 节点 2️⃣：Read Obsidian Note
|
||
|
||
**类型：** Read Binary File
|
||
**名称：** `Read Obsidian Note`
|
||
|
||
**配置：**
|
||
- File Path: `=/home/node/.n8n-files/{{ $json.body.note_name }}`
|
||
- n8n 容器内文件路径: `/home/node/.n8n-files/`
|
||
|
||
**输出：** 二进制文件数据，传递给 Extract from File 节点
|
||
|
||
---
|
||
|
||
### 节点 3️⃣：Extract from File
|
||
|
||
**类型：** Extract from File
|
||
**名称：** `Extract from File`
|
||
**Operation：** `text`
|
||
|
||
**功能：** 从二进制文件提取文本内容
|
||
|
||
**输出变量：**
|
||
- `original_content`（原文内容）
|
||
- `note_name`（文件名）
|
||
- `callback_url`（回调地址）
|
||
|
||
---
|
||
|
||
### 节点 4️⃣：DeepSeek Chat Model
|
||
|
||
**类型：** LM Chat DeepSeek
|
||
**名称：** `DeepSeek Chat Model`
|
||
|
||
**配置：**
|
||
- Model: `deepseek-chat`
|
||
- Credentials: `DeepSeek account`（在 n8n 中配置）
|
||
|
||
**连接：** → AI Agent（作为 languageModel 输入）
|
||
|
||
---
|
||
|
||
### 节点 5️⃣：AI Agent
|
||
|
||
**类型：** LangChain Agent
|
||
**名称：** `AI Agent`
|
||
**Version：** 3.1
|
||
|
||
**Prompt 模板：**
|
||
```
|
||
你是一个专业的中文内容编辑，擅长将英文文章转化为适合中国读者的高质量内容。
|
||
|
||
## 你的任务
|
||
|
||
将以下英文原文转化为：
|
||
1. 公众号风格的深度文章（2000-3000字）
|
||
2. X/Twitter 风格的短文案（280字内，带钩子）
|
||
3. 视频口播脚本（3-5分钟，适合抖音/YouTube）
|
||
|
||
## 内容要求
|
||
|
||
- 语言：地道中文，无翻译腔
|
||
- 风格：专业、有干货、适合中国读者
|
||
- 调性：公众号大V风格，有观点有案例
|
||
- 商业化：可自然植入 AI Agent / 知识管理相关内容（软性，不硬广）
|
||
|
||
## 文章主题方向（供校准时参考）
|
||
- AI Agent 落地实践与工具推荐
|
||
- AI 赋能商业的最佳实践
|
||
- AI 时代的网络安全与运维
|
||
|
||
## 输出格式（严格按此 JSON 返回）
|
||
|
||
{
|
||
"wechat_title": "中文标题",
|
||
"wechat_excerpt": "公众号摘要（100字内）",
|
||
"wechat_content": "完整公众号文章（Markdown格式）",
|
||
"twitter_copy": "X/Twitter文案（280字内，带emoji）",
|
||
"video_title": "视频标题",
|
||
"video_script": "口播脚本（含时间戳和字幕）",
|
||
"cover_keywords": ["关键词1", "关键词2", "关键词3"]
|
||
}
|
||
|
||
## 原文内容
|
||
{{ $json.data }}
|
||
```
|
||
|
||
---
|
||
|
||
### 节点 6️⃣：Convert to File
|
||
|
||
**类型：** Convert to File
|
||
**名称：** `Convert to File`
|
||
**Operation：** `toJson`
|
||
|
||
**功能：** 将 AI Agent 输出转换为 JSON 格式文件
|
||
|
||
---
|
||
|
||
### 节点 7️⃣：Read/Write Files from Disk
|
||
|
||
**类型：** Read/Write File
|
||
**名称：** `Read/Write Files from Disk`
|
||
**Operation：** `write`
|
||
|
||
**配置：**
|
||
- File Name: `=/home/node/.n8n-files/{{ $('Webhook Trigger').item.json.body.note_name }}_output.md`
|
||
|
||
**输出变量：**
|
||
- `output_file_name`
|
||
- `output_content`
|
||
|
||
---
|
||
|
||
### 节点 8️⃣：Send Telegram Message
|
||
|
||
**类型：** Telegram
|
||
**名称：** `Send Telegram Message`
|
||
|
||
**配置：**
|
||
- Chat ID: `5038825565`
|
||
- Text: "文章转换成功"
|
||
- Credentials: `Telegram XingJiang Bot`
|
||
|
||
**功能：** 通知星匠/用户工作流已完成
|
||
|
||
---
|
||
|
||
## 🔗 完整节点连接图（v4）
|
||
|
||
```
|
||
┌─────────────────────────────────┐
|
||
│ Webhook Trigger │
|
||
│ POST /content-translation-v4 │
|
||
└──────────────┬──────────────────┘
|
||
│
|
||
▼
|
||
┌─────────────────────────────────┐
|
||
│ Read Obsidian Note │
|
||
│ (Read Binary File) │
|
||
│ /home/node/.n8n-files/ │
|
||
└──────────────┬──────────────────┘
|
||
│
|
||
▼
|
||
┌─────────────────────────────────┐
|
||
│ Extract from File │
|
||
│ (text operation) │
|
||
└──────────────┬──────────────────┘
|
||
│
|
||
┌──────────┴──────────┐
|
||
│ │
|
||
│ ┌───────┴────────┐
|
||
│ │ DeepSeek │
|
||
│ │ Chat Model │
|
||
│ └───────┬────────┘
|
||
│ │
|
||
▼ ▼
|
||
┌─────────────────────────────────┐
|
||
│ AI Agent (LangChain) │
|
||
│ - system prompt │
|
||
│ - original content │
|
||
└──────────────┬──────────────────┘
|
||
│
|
||
▼
|
||
┌─────────────────────────────────┐
|
||
│ Convert to File (toJson) │
|
||
└──────────────┬──────────────────┘
|
||
│
|
||
▼
|
||
┌─────────────────────────────────┐
|
||
│ Read/Write Files from Disk │
|
||
│ (write output .md) │
|
||
└──────────────┬──────────────────┘
|
||
│
|
||
▼
|
||
┌─────────────────────────────────┐
|
||
│ Send Telegram Message │
|
||
│ 文章转换成功 │
|
||
└─────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 🔄 调用方式（OpenClaw 侧）
|
||
|
||
```bash
|
||
# 1. 将文章文件复制到 n8n-files 目录（通过 SFTP 或共享目录）
|
||
scp article.md macmini:/tmp/article.md
|
||
# 需要手动或通过 API 上传到 n8n 容器的 /home/node/.n8n-files/
|
||
|
||
# 2. 触发 n8n 工作流
|
||
curl -X POST "https://n8n.ishenwei.online/webhook/content-translation-v4" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"note_name": "article-2026-03-29.md",
|
||
"callback_url": "http://192.168.3.189:18789/webhook/yunce"
|
||
}'
|
||
```
|
||
|
||
---
|
||
|
||
## 📁 Obsidian / n8n 文件目录结构
|
||
|
||
```
|
||
# n8n 容器内
|
||
/home/node/.n8n-files/
|
||
├── article-2026-03-29.md # 原始文章（待处理）
|
||
└── article-2026-03-29.md_output.md # 成品笔记（转换后）
|
||
|
||
# MacMini Obsidian（OpenClaw 读取目录）
|
||
~/Workspace/nexus/openclaw/
|
||
├── content-queue/ # 待处理文章队列
|
||
└── content-output/ # 成品输出目录
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 各版本对比
|
||
|
||
| 版本 | ID | 状态 | AI Provider | 特点 |
|
||
|------|-----|------|-------------|------|
|
||
| **v1** | `xQDabttYmLaY8qtr` | ✅ 活跃 | DeepSeek (LangChain Agent) | 读 Obsidian 路径，写入 content-output |
|
||
| **v2** | `r0v9WAmed2THfN81` | ❌ 未激活 | OpenAI (n8n-nodes-langchain) | 基于 GPT-4o |
|
||
| **v3** | `tOGMiC6qOJPOY89E` | ✅ 活跃 | DeepSeek (直接 API) | 直接调用 DeepSeek API，稳定性更好 |
|
||
| **v4** | `iOf32aOKvTjfTDSM` | ❌ 未激活 | DeepSeek (LangChain Agent) | 最新版本，用 n8n-files 路径 |
|
||
|
||
---
|
||
|
||
## 🔧 环境变量 / Credentials
|
||
|
||
| 配置项 | 值 |
|
||
|--------|-----|
|
||
| DeepSeek API | 通过 n8n credential `DeepSeek account` (ID: `T7yJumbH684ClWfI`) |
|
||
| Telegram Bot | `Telegram XingJiang Bot` (ID: `y1NdRSaJwl0LoY37`) |
|
||
| Unsplash API | 在 v1/v2 中使用，v3/v4 未使用 |
|
||
|
||
---
|
||
|
||
## ✅ 验收标准
|
||
|
||
1. Webhook 被调用后，整个流程自动完成
|
||
2. 成品文件写入 `/home/node/.n8n-files/{note_name}_output.md`
|
||
3. Telegram 收到完成通知
|
||
4. 任意节点失败时，n8n 会中断流程并记录错误
|
||
|
||
---
|
||
|
||
## 📝 待完善项（v4）
|
||
|
||
- [ ] 成品文件需要写回 Obsidian 目录（目前只写到 n8n-files）
|
||
- [ ] 封面图搜索节点（v4 已移除 v1 的 Unsplash 配图功能）
|
||
- [ ] OpenClaw 回调通知（v4 改为 Telegram 通知，需确认是否符合预期）
|
||
- [ ] v4 激活前需完成联调测试
|
||
|
||
---
|
||
|
||
## 📝 后续扩展方向
|
||
|
||
- [ ] 加入封面图搜索（恢复 Unsplash 节点）
|
||
- [ ] 写回 Obsidian content-output 目录
|
||
- [ ] 支持 X/Twitter API 自动发布
|
||
- [ ] 支持抖音/YouTube 视频上传 API
|
||
- [ ] 加入人工审核节点（审批后再发布）
|