Output Forge

将AI原始输出自动转换为平台适配的格式，支持清理AI语气并批量处理。

已扫描

项目

内容

适合谁

内容创作者、数字营销人员

不适合谁

无技术基础且不愿学习命令行的用户、需要云端同步或账号登录功能的用户

国内可用性

需网络配置。可能需要网络配置或第三方服务可访问。

安装难度

新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

复制命令安装

openclaw skills install @theshadowrose/output-forge

官方 ZIP下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

OutputForge AI 输出格式化工具

将原始 AI 输出转换为平台就绪的内容，包含正确格式、元数据和清理。支持 Markdown、HTML、纯文本及结构化数据输出。

将原始 AI 输出自动转换为平台就绪的内容，包括格式化、元数据添加和清理。

作者：Shadow Rose

许可证：MIT

质量：已验证质量

功能说明

你刚刚从 AI 助手获得了优质内容。接下来该怎么做？手动复制粘贴到 WordPress、Medium 或社交媒体平台意味着：

手动进行格式清理
移除“作为 AI…”等免责声明
将长内容拆分为多条推文
添加元数据和结构化信息
转换为特定平台的格式

OutputForge 可以自动完成所有这些操作。

粘贴原始 AI 文本 → 几秒内获得平台就绪的内容。

快速开始

# 基础用法 - 为 WordPress 格式化
python output_forge.py my_ai_output.txt -f wordpress -o post.html

# 清理 AI 用语并格式化为 Medium
python output_forge.py raw_output.txt -f medium --title "我的文章" --author "Jane Doe"

# 将长内容拆分为 Twitter 推文线程
python output_forge.py long_article.txt -f twitter -o thread.txt

# 批量处理整个目录
python output_forge.py --batch input_dir/ output_dir/ -f markdown

# 从标准输入读取
cat ai_response.txt | python output_forge.py -f plain

功能特性

📝 多种输出格式

WordPress — 带有正确区块编辑器结构的 HTML
Medium — 渲染效果完美的干净 Markdown
电子邮件简报 — 响应式 HTML，使用内联 CSS
Twitter/X — 智能线程拆分，带编号
LinkedIn — 专业格式，含话题标签
Markdown — 带 frontmatter 元数据的干净 Markdown
LaTeX — 学术文档格式
纯文本 — 最小化格式，适用于任意场景

🧹 AI 用语清理

自动移除常见的 AI 表达和免责声明：

“作为 AI 语言模型……”
“重要的是要指出……”
“我没有个人观点，但……”
重复的“然而”过渡词
过度谨慎表达（如“也许可能或许可能会”）
关于训练截止日期的无必要声明

使你的内容听起来更自然、更有信心。

🎯 智能功能

线程拆分 — 智能将长内容拆分为符合推文长度的片段（按段落或句子）
元数据注入 — 为任意格式添加标题、作者、日期、标签、描述
模板系统 — 创建自定义输出格式以满足特定需求
批量模式 — 一次性处理数百个文件
图像占位符 — 使用平台特定语法标记图片插入位置
链接格式化 — 自动为各平台格式化链接

⚙️ 高度可配置

编辑 config_example.json（复制 config.json）来自定义：

默认作者和元数据
自定义清理规则（正则表达式）
自定义输出模板
各平台的线程长度限制
清理强度（保守 / 中等 / 激进）
平台特定偏好设置

使用示例

示例 1：WordPress 博客文章

python output_forge.py ai_draft.txt \
  -f wordpress \
  -o blog_post.html \
  --title "提升效率的 10 个技巧" \
  --author "Alex Johnson" \
  --tags "效率, 技巧, 工作" \
  --description "发现提升每日工作效率的实用方法"

输出： 带有正确区块、元数据和标签的干净 WordPress HTML，可直接粘贴至编辑器。

示例 2：Twitter 推文线程

python output_forge.py long_article.txt -f twitter -o thread.txt

输入： 2000 字文章

输出： 自动拆分为 8 条编号推文，每条不超过 280 字符，按自然句段边界断开。

1/8 第一条推文内容在此...

---THREAD BREAK---

2/8 第二条推文继续阐述观点...

---THREAD BREAK---

...

示例 3：清理后用于 Medium 的文章

python output_forge.py ai_output.txt \
  -f medium \
  --title "理解量子计算" \
  --tags "科学, 技术, 量子"

原始内容：

作为 AI 语言模型，我认为量子计算非常有趣。然而，必须指出的是，这个领域很复杂。我没有个人观点，但我可以解释……

清理后：

量子计算非常有趣。这个领域虽然复杂，但可以理解……

简洁、自信、专业。

示例 4：批量处理目录

# 处理 drafts/ 目录下的所有 .txt 文件，并输出到 published/
python output_forge.py --batch drafts/ published/ -f markdown --author "团队博客"

自动处理每个文件，保留原文件名并添加新扩展名。

示例 5：电子邮件简报

python output_forge.py newsletter_draft.txt \
  -f email \
  -o newsletter.html \
  --title "每周洞察 - 2026 年 2 月"

输出： 响应式 HTML 邮件，样式完整，可直接发送或粘贴至邮件平台。

命令行选项

位置参数：
  input                 输入文件（或 - 表示标准输入）

必需参数：
  -f, --format         输出格式：wordpress, medium, email, twitter,
                       linkedin, markdown, latex, plain

可选参数：
  -o, --output         输出文件（默认：标准输出）
  --batch              批量模式：input_dir output_dir

元数据参数：
  --title              内容标题
  --author             内容作者
  --date               发布日期（默认：今天）
  --tags               逗号分隔的标签
  --description        SEO 描述

处理参数：
  --no-clean           禁用 AI 用语清理
  --max-thread-length  线程帖子最大长度（默认：280）
  --image-placeholders 添加图像占位符标记

自定义模板

通过编辑 config_example.json 创建自己的输出格式。

# Output Forge

## 简介

Output Forge 是一个用于格式化和清理 AI 生成文本的工具，帮助将原始输出转换为适合发布的高质量内容。

---

## 自定义模板示例

def custom_blog_template(content, metadata, options):

title = metadata.get('title', 'Untitled')

author = metadata.get('author', 'Anonymous')

return f"""

{title}

*by {author}*

{content}

Published with OutputForge

""".strip()

注册你的模板

CUSTOM_TEMPLATES['myblog'] = custom_blog_template

使用方法：

python output_forge.py input.txt -f myblog -o output.md

---

## AI 语气清理功能详情

清理引擎会移除使 AI 生成文本过于明显的常见模式：

### 被移除的模式

✅ **直接提及 AI 的表达**
- "As an AI language model..."
- "I'm an AI assistant and..."

✅ **犹豫性措辞**
- "It's important to note that..."
- "It should be noted that..."
- "Keep in mind that..."

✅ **不必要的免责声明**
- "I don't have personal opinions, but..."
- "I can't access the internet, but..."
- "My training data ends in..."

✅ **过度的注意事项**
- 重复使用 "However,"（限制为最多 2-3 次）
- 过度使用 "That being said,"

✅ **冗余词语**
- "very very" → "very"
- "really really" → "really"

### 分析模式

想查看清理效果但不实际修改文本？

python output_clean.py "Your AI text here"

输出内容包括：
- 模式出现次数统计
- 犹豫性表达比例
- 被动语态检测结果
- 改进建议

---

## 使用场景

### 内容创作者
- 将 AI 草稿转换为博客文章
- 生成新闻稿 HTML
- 格式化社交媒体内容

### 作家
- 清理 AI 辅助写作内容
- 导出至多种格式
- 保持元数据一致性

### 市场营销人员
- 批量处理营销活动内容
- 适配不同平台格式
- 移除文案中的 AI 特征

### 开发者
- 自动生成文档
- 将代码注释转为文档
- 批量处理技术文档

### 团队协作
- 统一输出格式标准
- 共享自定义模板
- 批量处理团队内容

---

## 系统要求

**Python 3.7+**（仅依赖标准库 — 无外部依赖）

---

## 安装方式

克隆或下载文件

cd output-forge/

完成！无需安装额外依赖。

直接运行

python output_forge.py --help

或设置可执行权限（Linux/Mac）

chmod +x output_forge.py

./output_forge.py --help

---

## 文件结构

output-forge/

├── output_forge.py # 主要格式化引擎

├── output_templates.py # 平台模板（WordPress、Medium 等）

├── output_clean.py # AI 语气检测与清理

├── config_example.json # 配置模板

├── README.md # 此文件

├── LIMITATIONS.md # 本工具不支持的功能

└── LICENSE # MIT 许可证

---

## 使用建议与最佳实践

### 1. 初期保持保守
优先使用默认清理设置。若输出仍显“AI 风格”，可在配置中适度提高清理强度。

### 2. 发布前人工审阅
始终在发布前检查输出内容。自动化清理虽好，但人类判断更可靠。

### 3. 创建自定义模板
若频繁发布到同一平台，建议创建符合你格式偏好的自定义模板。

### 4. 批量处理技巧
处理目录时，使用一致的输入文件名以方便后续整理。

### 5. 元数据的重要性
请包含标题、作者、标签、描述等信息 — 多数平台依赖这些字段进行 SEO 优化与内容管理。

### 6. 推文分段策略
撰写 Twitter 系列推文时，每条控制在 260 字以内（而非 280），为链接或图片留出空间。

---

## 贡献指南

这是一个开源项目，采用 MIT 许可证。欢迎参与：

- 分支并根据需求修改
- 提交改进方案
- 分享自定义模板
- 报告问题

---

## 许可证

MIT 许可证 — 详情请见 LICENSE 文件。

可用于个人及商业用途。

---

## 作者

**Shadow Rose**

---

## 常见问题

**Q：是否适用于所有 AI 输出？**
A：是的 —— 包括 ChatGPT、Claude、Gemini、本地模型等任何生成文本的系统。

**Q：能否添加自己的清理规则？**
A：可以。编辑 `config_example.json`，在 `DEFAULT_CLEANUP_RULES` 中添加正则表达式规则。

**Q：清理会完全移除所有犹豫性表达吗？**
A：不会。它仅针对明显 AI 特征和过度使用的犹豫表达。合理的不确定性表述将保留。

**Q：能否用于商业项目？**
A：可以！MIT 许可证允许商业使用。

**Q：如果缺少所需格式怎么办？**
A：可创建自定义模板（参见“自定义模板”部分）或提出功能请求。

**Q：是否会修改原始文件？**
A：不会。原始输入文件从不被修改。输出仅发送至标准输出或你指定的新文件。

---

**准备好了吗？立即开始：**