• 人工智能
• AI 应用
• AI 写作
• 提示工程
• AI 技能
• 后端
• 前端

baibaiAIGC 是一款面向中文论文的去 AI 味工具，能按两轮顺序对论文和技术文档做分段降 AIGC 改写，让表达更自然，同时保留原有的术语、结构与格式。本教程教你用一键脚本start-web.bat快速搭建 Web 环境：自动装依赖、启动前后端，然后在浏览器里完成上传、模型配置、执行轮次和导出。

一、baibaiAIGC 能做什么？

先认识一下这个项目的核心能力：

• 📝两轮降 AIGC：中文模式按固定顺序使用 prompts/baibaiaigc1.md 和 prompts/baibaiaigc2.md，先改书面腔，再清 AI 套话
• ✂️分段改写：长文档先按段落切块（每块最多 850 字），逐块改写后按原段落结构还原
• 📄格式保留：支持.txt和.docx，导出的 Word 会以原始文档为模板，保留页面、样式、表格、图片和页眉页脚
• 🧩四种使用方式：对话 skill 模式、脚本 API 模式、Web 模式、桌面 App

💡 官方推荐使用顺序：Web 端 > 脚本 > skill。本教程聚焦最省心的 Web 模式。

二、环境准备与获取代码

start-web.bat本质上是调用 scripts/start_web_dev.ps1 这个 PowerShell 脚本，所以请在Windows系统下操作，并确保已安装：

1. Python 3（脚本会自动创建.venv虚拟环境）
2. Node.js（含 npm，用于前端 React + Vite 工程）

在终端中克隆仓库并进入目录：

git clone https://gitcode.com/gh_mirrors/ba/baibaiAIGC cd baibaiAIGC

三、一键 start-web.bat 搭建步骤（核心教程）

🚀 只需一条命令，在仓库根目录运行：

.\start-web.bat

这条命令会自动完成 4 件事，全程无需手动操作：

启动成功后，终端会打印两个入口地址，各弹出一个新窗口（Backend / Frontend）：

• 前端：http://127.0.0.1:1420（浏览器访问这个页面）
• 后端：http://127.0.0.1:8765（前端会自动代理/api请求到本地后端）

⚡依赖已装好、只想直接启动？跳过安装环节，运行：

powershell -ExecutionPolicy Bypass -File .\scripts\start_web_dev.ps1 -SkipInstall

四、Web 环境手动启动方式（备选方案）

如果不想用一键脚本，可以分开手动启动。首次需先安装依赖（pip install -r requirements.txt，以及cd app后执行npm install）：

启动 Python 后端（入口 scripts/web_app.py）：

python scripts/web_app.py

再启动前端开发服务器：

cd app npm run dev:web

前端端口固定在 1420（见 app/vite.config.ts），启动后同样按终端输出的本地地址在浏览器访问即可。

五、Web 界面完成第一次处理

环境搭好后，浏览器里的操作流程很简单：

1. 上传文件：上传.txt或.docx，系统会自动保存到origin/chat-uploads/
2. 配置模型：填写baseUrl、apiKey、model三个字段，默认promptProfile为cn（中文两轮模式），点击测试连接
3. 执行第 1 轮：按段落自动切块、逐块改写，结果写入finish/intermediate/
4. 执行第 2 轮：以上一轮结果作为输入，重点清除 AI 套话与机械连接词
5. 导出成品：导出.txt或.docx到finish/web_exports/，DOCX 输出保留原始 Word 模板格式

六、常见问题排查

Q：脚本报 “Python 3 was not found”？系统没有可用的py或python命令，安装 Python 3 后重新运行start-web.bat即可，脚本会自动重建虚拟环境。

Q：端口 8765 或 1420 被占用？前端配置了strictPort，端口占用会直接报错。关闭占用端口的程序，或修改 app/vite.config.ts 与启动脚本中的端口。

Q：每次都要重新安装依赖吗？不用。首次安装完成后，再次运行start-web.bat会跳过已存在的虚拟环境，依赖检查速度很快；想更快可加-SkipInstall参数。

Q：不用 Web，想用命令行批处理？可改用脚本 API 模式 scripts/run_aigc_round.py，需配置环境变量BAIBAIAIGC_API_KEY、BAIBAIAIGC_MODEL、BAIBAIAIGC_BASE_URL；不想调用模型时可加--dry-run仅校验切块。

七、总结

搭建 baibaiAIGC 的 Web 环境只需记住 4 步：装好 Python 和 Node.js → 克隆仓库 → 运行.\start-web.bat→ 浏览器访问http://127.0.0.1:1420。环境一次性搭好后，上传、配置、执行、导出全部在浏览器中完成。想深入了解两轮改写的详细规则，可阅读 SKILL.md。

• 人工智能
• AI 应用
• AI 写作
• 提示工程
• AI 技能
• 后端
• 前端