USAGE / DEPLOYMENT

使用与部署

从安装到查看审查报告的完整工作流，以及可配置的环境参数。

SPEC.USE.001 · CLI · PYTHON 3.14

FLOW.01

使用流程

五步完成一次稿件初审：准备稿件、配置 Key、运行命令、查看产物。

01 准备稿件 DOCX / PDF / TXT

→

02 配置 API Key .env 文件

→

03 运行命令 python -m src.workflow

→

04 查看 output output/ 目录

→

05 打开报告 HTML / DOCX

INSTALL.02

安装步骤

terminal

# 克隆项目并进入目录
cd AiPreView

# 创建虚拟环境
python3 -m venv .venv
source .venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 复制环境变量模板
cp .env.example .env

CONFIG.03

API Key 配置

系统使用 DeepSeek V4 Pro 或 OpenAI 兼容 API。在 .env 文件中配置：

.env

# DeepSeek API
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx
DEEPSEEK_BASE_URL=https://api.deepseek.com/v1

# 或使用 OpenAI 兼容 API
# OPENAI_API_KEY=sk-...
# OPENAI_BASE_URL=https://api.openai.com/v1

# 无 API Key 时系统自动跳过 LLM 技能
# 代码技能仍然正常运行

RUN.04

运行命令

terminal

# 基本用法：指定稿件路径
python -m src.workflow path/to/manuscript.docx

# 断点续跑：从上次中断处继续
python -m src.workflow path/to/manuscript.docx --resume

# 支持 PDF 输入
python -m src.workflow path/to/manuscript.pdf

# 支持 TXT 输入
python -m src.workflow path/to/manuscript.txt

OUTPUT.05

输出目录结构

每次审查会在 output/ 下生成一个以稿件名命名的子目录：

file tree

output/output_{doc_name}/
├── 初审报告.html              # HTML 初审报告
├── editor_explanation.html    # 决策追溯可视化
├── review_result.json         # 完整审查数据
├── *_初审标注.docx            # 初审标注稿
├── *_审阅标注.docx            # 结构化审阅稿
└── *_标注.pdf                 # PDF 标注稿

PARAMS.06

常见配置参数

通过环境变量或 .env 文件配置系统行为：

参数	说明	默认值
`AIPREVIEW_MAX_PAGES`	PDF 最大解析页数	200
`AIPREVIEW_CHUNK_SIZE`	分块大小（段落数）	40
`AIPREVIEW_CHUNK_OVERLAP`	分块重叠（段落数）	10
`AIPREVIEW_MAX_AGENTS`	最大并发审稿技能数	3
`AIPREVIEW_LLM_TIMEOUT`	LLM 调用超时（秒）	120
`AIPREVIEW_ANNOTATE_DOCX`	是否生成标注 DOCX	true