使用文档

快速开始

搭建运行环境，配置模型，并创建第一个论文工作台。

环境要求

• Linux 系统，已安装 Python 3.11 或更高版本。
• 已安装 Docker Engine 和 Docker Compose。
• 已安装 Poppler 工具，包括 pdffonts。
• 至少一个可用的模型 API Key。
• 可以使用 GPU 加快 PDF 解析。

安装

git clone <repository-url>
cd CCIIP_Scope
./install.sh

安装脚本会逐项检查并安装依赖，在进行一些需要修改系统环境的操作前，会先进行说明，并要求用户确认。

启动应用

./start.sh

项目可视化界面的默认访问地址是 http://127.0.0.1:8010。

局域网访问

安装脚本默认配置一个 Nginx 反向代理，用于从同一局域网中的其他设备访问 CScope。运行 start.sh 后，终端会列出可用的 LAN access 地址。

默认配置允许本机、常见私有网络和 Tailscale 地址访问。可以在安装时使用 --allow-cidr 增加允许的网段，或配合 --replace-default-cidrs 仅保留指定网段；不需要局域网访问时可使用 --skip-nginx。

配置模型

如果安装脚本没有创建 .env，则基于示例文件生成：

cp .env.example .env

并在 .env 中填写 MiniMax 或其他兼容模型的名称、Base URL 和 API Key。也可以在可视化界面中做 API 的配置。

创建第一个项目

1. 打开项目的可视化页面，上传 PDF 或 LaTeX ZIP。
2. 选择准备投稿的会议；如果上传的论文为 LaTeX 包的形式，还要指定主 .tex 文件。
3. 点击按钮创建项目，创建后会显示 ppr_... Token，保存好该 Token 以方便后续访问。
4. 进入工作台，等待项目处理完成。

Token 就是该项目的访问凭据。丢失后无法从公开页面找回。

停止服务

在运行 start.sh 的终端中通过 Ctrl+C 可以直接关闭项目和对应的 Docker 服务。