使用iFlow创建自定义Command：网页文章下载与翻译工具

环境信息

• iFlow版本：v0.3.28
• 使用模型：GLM-4.6
• 文档日期：2025年11月28日

背景和需求

作为技术人员，我经常需要阅读海外技术文章和文档。由于英文水平有限，通常需要通过浏览器插件进行翻译。同时，为了长期保存有价值的内容，需要将喜欢的文章收藏到本地。

面临的主要问题：

1. 语言障碍：英文技术文档阅读效率低
2. 链接失效风险：网页内容可能随时间消失
3. 浏览器插件限制：功能单一，难以批量处理
4. 资源分散：图片等资源容易丢失

基于这些痛点，我决定利用iFlow平台开发一个自动化工具，实现网页内容的下载、格式转换和翻译功能。

需求分析

在开始实现之前，我明确了以下核心需求：

功能需求

• 网页内容下载：获取指定URL的完整HTML内容
• 格式转换：将HTML转换为干净的Markdown格式
• 资源处理：下载并本地化所有图片资源
• 自动翻译：将英文内容翻译为中文
• 文件管理：规范的文件命名和目录结构

技术需求

• 无外部API依赖：利用iFlow内置AI能力
• 错误处理：网络异常、格式转换失败等场景
• 批量处理：支持多个URL处理
• 可配置性：支持不同参数组合

用户体验需求

• 简单易用：单一命令完成所有操作
• 进度反馈：实时显示处理进度
• 结果清晰：明确的输出文件位置

实现过程

我先通过自然语言告诉他这个任务：

帮我将网页内容下载到本地以markdown格式保存，存好后将文章翻译成中文。 地址是： xxx

结果：

他可以实现这个功能之后，我告诉他我要做一个command。

由于在上面指令他考虑配置API，这里我告诉他不需要。

我是在iflow里操作对文章进行翻译，他可以直接使用iflow的AI而不是配置其他API进行翻译。 通过分析调用subagent 进行返回或查询其他指令等功能，记住不需要额外的API。

后面我对这个指令进行了补充： 我有安装一些subagent，所以告诉他通过调用subagent去实现翻译。

最终他实现了此指令的功能。

测试结果：
iflow cli 里输入指令： /mdt https://www.ollama.com/blog/minimax-m2

获得的产物：

会获得原文的markdown和中文版本两个文件。此图用中文和原网页对比。

最终我们获得了一个iflow command 文件。 将此command 放入 ~/.iflow/command 目录即可。

iFlow Command的核心价值

通过这次实践，我深刻体会到iFlow平台的强大之处：

🎯 自然语言编程

• 零代码门槛：通过自然语言描述即可实现复杂功能
• 智能理解：iFlow能够准确理解用户意图并生成相应代码
• 迭代优化：支持通过对话逐步完善功能

🚀 Command机制优势

• 快捷方式：将复杂操作封装为简单命令
• 参数化设计：支持动态输入，实现"指令+变量"模式
• 可重用性：一次定义，多次使用

💡 开发效率

• 快速原型：从想法到可用工具仅需几分钟
• 无需环境配置：iFlow提供完整的运行环境
• 内置AI能力：直接调用平台AI服务，无需额外配置

技术亮点

智能翻译集成

iFlow的subagent机制让翻译功能变得异常简单：

# 无需配置外部API，直接调用内置AI
iFlow自动识别语言并调用合适的翻译模型

资源本地化

自动处理网页中的图片资源：

• 识别所有图片链接
• 创建本地图片目录
• 更新Markdown中的图片引用

错误恢复机制

完善的异常处理确保工具稳定性：

• 网络超时重试
• 格式转换失败时的备用方案
• 部分资源丢失时的继续处理

---

本文档展示了iFlow v0.3.28在GLM-4.6模型下的实际应用案例，为类似需求提供了参考实现。欢迎各位开发者交流讨论，分享更多实用的Command工具。

测试验证

测试环境

• 操作系统：macOS Darwin 15.7.1
• iFlow版本：v0.3.28
• 模型：GLM-4.6
• 测试URL：https://www.ollama.com/blog/minimax-m2

测试步骤

# 在iFlow CLI中执行
/mdt https://www.ollama.com/blog/minimax-m2

测试结果

✅ 成功生成文件：

• ollama-com-blog-minimax-m2-20251128-143045-original.md（原文）
• ollama-com-blog-minimax-m2-20251128-143045-chinese.md（译文）
• minimax-m2-images/（图片资源目录）

✅ 功能验证：

• 网页内容完整下载
• 图片资源本地化成功
• Markdown格式转换正确
• 中文翻译质量良好

Command文件详解

最后附上iFlow生成的完整Command文件：

---
description: 自动下载英文文章并翻译成中文的工具，支持图片资源下载
---
# mdt - My downloads and translations

自动下载英文文章并翻译成中文的 iFlow 命令，支持完整图片资源下载和嵌入。

## 执行流程：

1. **接收用户提供的URL**
   - 验证URL格式和有效性
   - 确认用户想要下载的文章链接

2. **下载文章内容**
   - 使用curl工具获取网页HTML内容
   - 处理可能的网络错误和访问限制
   - 提取文章标题和主要内容

3. **提取并下载图片资源**
   - 扫描HTML中的所有图片链接
   - 创建专用图片目录：`<文章名>-images/`
   - 批量下载所有图片并重命名（image_1.jpg, image_2.jpg等）
   - 在Markdown中更新图片引用路径

4. **转换为Markdown格式**
   - 使用pandoc工具将HTML转换为干净的Markdown
   - 清理格式，保留重要结构
   - 添加文章标题作为文件标题
   - 确保图片引用正确指向本地下载的图片

5. **翻译为中文**
   - 使用iFlow的subagent进行专业翻译
   - 直接调用general-purpose agent处理翻译任务
   - 保持技术术语准确性和中文表达流畅性
   - 同步更新图片的中文说明文字

6. **保存文件**
   - 生成基于URL和时间戳的文件名
   - 保存原文为 `<filename>-original.md`
   - 保存译文为 `<filename>-chinese.md`
   - 创建图片目录 `<filename>-images/`
   - 向用户报告保存位置和文件信息

## 使用示例：

用户输入：`/mdt https://www.ollama.com/blog/minimax-m2`

系统将：
1. 下载该URL的文章内容和所有图片
2. 转换为Markdown格式并嵌入本地图片
3. 翻译成中文
4. 保存为：
   - `ollama-com-blog-minimax-m2-20251128-143045-original.md`
   - `ollama-com-blog-minimax-m2-20251128-143045-chinese.md`
   - `minimax-m2-images/` 目录（包含所有图片文件）

## 可选参数：

- `--no-images`：跳过图片下载，仅处理文本内容
- `--images-only`：仅下载图片，不进行翻译处理

## 配置要求：

**必需依赖：**
- curl（用于下载网页和图片）
- pandoc（用于HTML转Markdown）

**iFlow集成：**
- 自动使用iFlow的subagent进行翻译
- 无需配置外部API密钥
- 内置专业术语翻译能力

## 错误处理：

- URL无效时提示用户重新输入
- 网络连接失败时提供重试建议
- 文件转换失败时提供替代方案（Python提取）
- 图片下载失败时继续处理文本，并报告失败图片数量
- 翻译失败时自动重试或提供错误详情

## 输出报告：

命令完成后会显示：
- 文章标题和字数统计
- 成功下载的图片数量和文件大小
- 原文和译文文件路径
- 图片目录路径

使用指南

安装步骤

1. 创建Command目录（如果不存在）：

mkdir -p ~/.iflow/command

2. 保存Command文件：

# 将上述mdt.md内容保存到
~/.iflow/command/mdt.md

3. 验证安装：

# 在iFlow CLI中测试 
/mdt

基本用法

# 基本用法
/mdt https://example.com/article

# 跳过图片下载
/mdt --no-images https://example.com/article

# 仅下载图片
/mdt --images-only https://example.com/article

故障排除

常见问题

1. 依赖工具缺失

问题：curl或pandoc未安装

# macOS安装
brew install curl pandoc

# Ubuntu/Debian安装
sudo apt-get install curl pandoc

# CentOS/RHEL安装
sudo yum install curl pandoc

2. 网络连接问题

问题：URL无法访问或超时

• 检查网络连接
• 确认URL可访问性
• 考虑使用代理（iFlow支持代理配置）

3. 权限问题

问题：文件写入权限不足

# 检查目录权限
ls -la ~/.iflow/command/

# 修改权限（如需要）
chmod 755 ~/.iflow/command/

4. 翻译质量问题

问题：专业术语翻译不准确

• 在Command中添加术语词典
• 使用特定的翻译提示词
• 考虑后编辑优化

性能优化建议

大文件处理

• 分块下载和处理
• 进度条显示
• 断点续传支持

内存优化

• 流式处理大文档
• 及时清理临时文件
• 限制并发下载数量

网络优化

• 连接池复用
• 智能重试机制
• 带宽限制选项

---

总结

通过iFlow平台，我们成功实现了一个功能完整的网页文章下载和翻译工具。这个案例展示了：

1. 低代码开发：通过自然语言即可创建实用工具
2. AI集成：充分利用平台内置AI能力
3. 扩展性：Command机制支持功能持续迭代
4. 实用性：解决了实际工作中的痛点问题

这个工具不仅提高了个人工作效率，也为类似需求提供了可复制的解决方案。随着iFlow平台的不断发展，相信会有更多创新的应用场景涌现。