数模论文同步

数模论文同步是一款面向受支持数学建模队伍的 VS Code 扩展。它把论文创建、加入、导入、编译和同步集中在中文图形界面中，日常使用不需要手动执行 Git 命令。

当前版本为 0.1.0 Beta。

功能

• 在“论文协作中心”查看登录、保存位置和同步状态。
• 通过浏览器登录 AtomGit；退出登录前会再次确认。
• 选择论文保存位置，并在创建前检查路径是否适合 LaTeX 与协作工具使用。
• 使用最新版模板新建论文；有可选模板版本时，可在创建时选择。
• 加入已有远端论文，或导入已有的本地论文目录。
• 手动同步论文；远端出现分歧或内容冲突时停止操作，不强制覆盖文件。
• 管理远端论文仓库；删除前需要再次输入仓库名确认，并保留本地论文文件。
• 使用项目固定的 XeLaTeX 配置编译 PDF，并提供“修复 XeLaTeX 编译配置”按钮。

使用要求

• Windows
• VS Code 1.95.0 或更高版本
• LaTeX Workshop
• 能够使用 XeLaTeX 的 TeX Live
• 能够访问 AtomGit 的网络连接
• 已加入本扩展支持的 AtomGit 队伍，并拥有该队伍私有模板和论文仓库的访问权限

安装扩展时，VS Code 会尝试一并安装 LaTeX Workshop。扩展运行时不要求另外安装 Git、Node.js 或 Python。

安装

1. 在 VS Code 中打开“扩展”视图。
2. 搜索 @id:math-paper-sync.math-paper-sync。
3. 打开“安装”按钮旁的菜单，选择安装预发布版本。
4. 安装完成后，从活动栏打开“数模论文同步”。

离线使用时，也可以从扩展视图右上角的“…”菜单选择“从 VSIX 安装…”，然后选择获得的 .vsix 文件。

基本使用

1. 点击“登录 AtomGit”，在浏览器中完成登录。
2. 选择一个不含中文、空格或特殊字符的论文保存位置。
3. 点击“新建论文”“加入已有论文”或“导入本地论文”。
4. 点击“编译 PDF”生成论文；遇到项目编译配置异常时，可先点击“修复 XeLaTeX 编译配置”。
5. 需要交换修改时，点击“立即同步”。

模板只用于生成新论文的初始文件。创建、加入或导入完成后，论文不会自动跟随模板变化。

数据处理与隐私

• 扩展不包含广告，也不发送独立的使用情况遥测。

• 登录时会打开 AtomGit 授权页面，并通过由 Cloudflare Workers 承载的登录中转服务完成授权结果的一次性交接。该服务为限流使用由连接 IP 派生的摘要；登录会话有效期为 10 分钟，访问令牌的加密交接有效期最长为 90 秒，领取后会立即清除，过期数据由清理任务清除。服务处理位置未固定为单一地区，论文内容不会经过该服务。

• 登录成功后，访问令牌保存在 VS Code 的加密凭据存储（SecretStorage）中，不会写入论文文件或 Git 配置；退出登录会删除扩展保存的令牌。

• 登录验证、仓库列表、模板下载以及用户发起的创建、加入、同步和删除操作会直接与 AtomGit 交换必要的账号、仓库元数据和论文内容。AtomGit 和 VS Code 对这些数据的处理同时受各自服务规则约束。

• 论文保存位置记录在 VS Code 扩展状态中；论文文件、项目元数据、模板缓存和编译结果保存在本机。XeLaTeX 编译在本机执行。

• 导入操作不会删除或修改原始论文目录。

• 同步不会强制推送，也不会静默覆盖发生冲突的内容。

• 上传前会检查常见凭据、私钥和访问令牌，并排除常见 LaTeX 构建产物。

• 删除远端仓库不会删除本地论文；操作前会显示目标并要求二次确认。

• 创建、导入或同步失败时，本地可恢复文件会被保留，并在界面中显示下一步建议。

请勿把访问令牌写入扩展设置、论文文件或 Git 配置。网络中断或冲突导致同步停止时，请先保留本地论文，再根据界面提示重试或处理冲突。