# open-article-hub

**Repository Path**: luotianding/open-article-hub

## Basic Information

- **Project Name**: open-article-hub
- **Description**: ai软文发布助手
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-01
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenArticleHub 开源软文发布助手

OpenArticleHub 是一个本地运行的 AI 软文生成与多平台发布工具，适合餐饮店、汽车销售、本地服务、教育培训、装修建材等普通企业使用。

它的目标不是替你偷偷发广告，而是把“企业资料维护、软文生成、人工审核、配图发布、发布台账”放到一个网页工作台里，让非技术人员也能按步骤完成内容发布。

![工作台总览](docs/images/01-dashboard.png)

## 适合谁

- 小店老板：想给门店、产品、活动写文章，但不会排版和多平台发布。
- 运营人员：需要把同一个主题改写成 CSDN、知乎、今日头条等不同平台的表达方式。
- 开发者：想学习本地网页工具、平台授权、发布台账和安全发布层的实现方式。
- 企业服务商：想在此基础上二次开发行业版内容发布工具。

## 当前能力

| 功能 | 状态 | 说明 |
|---|---|---|
| 企业资料维护 | 可用 | 维护企业名称、城市、卖点、目标客户、禁止表达 |
| AI 软文生成 | 可用 | 支持 OpenAI-compatible 模型，也支持本地兜底生成 |
| 人工审核 | 可用 | 发布前必须审核通过，避免一键误发 |
| CSDN 发布 | 可用 | 支持自检、草稿、公开发布、封面和正文图片上传 |
| 知乎发布 | 可用 | 支持授权缓存、草稿、公开发布、本地重复发布保护 |
| 今日头条 | 受保护可用 | 接口发布受平台风控影响，推荐浏览器原生提交；工具提供文章化和微头条衍生检查 |
| 发布台账 | 可用 | 阻止同标题、同正文重复发布 |
| Windows 一键安装 | 可用 | 支持安装到用户目录、创建桌面快捷方式 |

> 说明：本项目不是 CSDN、知乎、今日头条官方工具。平台规则、登录风控、审核策略会变化，请按平台要求合规使用。

## 5 分钟启动

### 1. 安装 Node.js

先安装 Node.js 20 LTS 或更高版本。

打开命令行后检查：

```powershell
node -v
```

能看到版本号即可，例如：

```text
v20.11.0
```

### 2. 下载源码

```powershell
git clone https://gitee.com/luotianding/open-article-hub.git
cd open-article-hub
```

也可以从 GitHub 下载：

```powershell
git clone https://github.com/lutianding118-cmd/open-article-hub.git
cd open-article-hub
```

### 3. 启动工具

Windows 用户双击或执行：

```powershell
powershell -ExecutionPolicy Bypass -File .\start.ps1
```

浏览器打开：

```text
http://127.0.0.1:18765
```

![企业资料](docs/images/02-company-profile.png)

### 4. 生成文章

进入“内容生成”，填写推广主题、产品服务、核心卖点和希望用户做什么。

![内容生成](docs/images/03-content-generate.png)

### 5. 人工审核

进入“审核发布”，检查标题、正文、标签、风险提示。确认无误后点击通过审核。

![审核发布](docs/images/04-review.png)

### 6. 平台发布

进入“平台发布”，先自检，再保存草稿或公开发布。

![平台发布](docs/images/05-platform-publish.png)

## 配置模型

进入“设置”，填写 OpenAI-compatible 接口地址、模型名称和 API Key。

![设置](docs/images/06-settings.png)

常见配置项：

| 配置 | 示例 | 说明 |
|---|---|---|
| Base URL | `https://api.example.com/v1` | 兼容 OpenAI 格式的接口地址 |
| Model | `gpt-4o-mini` | 实际以你的服务商支持为准 |
| API Key | `sk-...` | 只保存在本机 Windows 加密存储中 |

如果暂时不配置模型，工具仍可使用本地兜底生成，适合演示流程。

## 图文教程

- [小白图文操作手册](docs/小白图文操作手册.md)
- [换电脑迁移配置指南](docs/换电脑迁移配置指南.md)
- [安全发布说明](docs/安全发布说明.md)
- [常见问题](docs/常见问题.md)

同时提供 Word 版本，适合发给客户：

- `docs/OpenArticleHub-小白图文操作手册.docx`
- `docs/OpenArticleHub-换电脑迁移配置图文指南.docx`

## 目录说明

```text
open-article-hub/
  articles/                    示例文章和待发布文章目录
  docs/                        图文教程
  tools/
    publisher_hub/             本地网页工作台
    csdn_publisher/            CSDN 发布 provider
  start.ps1                    Windows 一键启动
  stop.ps1                     Windows 关闭服务
```

## 安全边界

- 不提交 `.open-article-hub/auth/*.dpapi`。
- 不提交平台 Cookie、模型 API Key、发布台账和浏览器缓存。
- 真实发布前必须人工审核。
- 真实发布失败不会自动重试，避免重复投稿。
- 今日头条优先走浏览器原生发布，避免触发平台接口风控。

## 开源协议

MIT License。