PaperLab

Overleaf 式论文迭代修改工作台：左侧编辑 LaTeX 源码，中间实时渲染 PDF，选中任意文字即可批注；AI 引擎是 DeepSeek Harness 的一个官方 bundle 插件，按批注逐条改写论文、编译验证并提交 git 修订。

main.tex ──XeLaTeX/latexmk──▶ PDF 预览 ──选中文字──▶ 批注（页码+矩形高亮）
   ▲                                                      │
   │                                             点击「AI 修改」
   │                                                      ▼
   └──── 自动重编译 ◀── git 提交 ◀── dsh agent 改写 tex ◀── DeepSeek Harness

✨ 特性

Overleaf 式界面：三栏可拖动（源码 / PDF / 面板），源码编辑即自动保存、自动编译
真实 PDF 预览：PDF.js 渲染，公式、图表、排版与成品一致；内置 CMap 支持中文
任意文字批注：在 PDF 上选中任意文字写意见，黄色高亮按页面坐标落位；点「定位」用红色浮窗对照修改前原文
AI 修改：基于 DeepSeek Harness 的 dsh-paperlab bundle 插件，agent 执行 读论文与批注 → 唯一匹配编辑 → 编译检查 → git 提交 → 标记批注已解决
实时执行轨迹：宽屏大视图直播 agent 的思考过程、工具调用时间线与执行输出（带计时 / LIVE 状态）
模型与编排可控：工作台内直接切换 provider / 模型 / 思考强度（写入 dsh 设置）和 agent preset 编排模式（标准 / 极简 / PTC / 创造 / 自定义，按项目保存）
完整版本管理：每个项目是一个 git 仓库；AI 修订前后自动 checkpoint，可浏览历史、查看任意 diff、一键 git revert 回滚
一键导出：按需打包论文源文件（含批注记录）/ 编译 PDF / 完整 git 历史为 zip
多引擎编译：自动尊重 latexmkrc，自动识别 xeCJK/fontspec 使用 XeLaTeX，支持 latexmk / xelatex / pdflatex / tectonic

🏗 架构

PaperLab 由三部分组成，AI 执行引擎完全运行在 DeepSeek Harness 里：

部分	技术	职责
`web/`	React + Vite + PDF.js	Overleaf 式三栏界面、PDF 选中批注、轨迹大视图、历史/导出
`server/`	FastAPI	项目管理、LaTeX 编译、批注与 git 版本管理、静态托管前端
`plugin/`	DeepSeek Harness bundle（TypeScript）	给 dsh agent 注册论文修改专用工具 + 内嵌 HTTP 端点 + 模型/预设设置代理

浏览器 ⇄ FastAPI ──(HTTP 127.0.0.1:3923)──▶ dsh-paperlab 插件 ──▶ dsh agent loop
                                              ctx.tools / systemPrompt / agents
                                                        │
                                              dsh LLM 适配器 ──▶ DeepSeek/OpenAI/…

更详细的数据流与设计决策见 docs/architecture.md。

🚀 快速开始

前置：Node.js ≥ 20、pnpm ≥ 10、Python ≥ 3.11、git、DeepSeek Harness（dsh）。 LaTeX 可选（无则预览降级为文本抽取）。

git clone https://github.com/maple-pwn/paperlab.git
cd paperlab
./start.sh                  # 或 make start

start.sh 会自动：装缺失依赖 → 构建前端与插件 → 把 dsh-paperlab 安装进 dsh profile → 启动 DeepSeek Harness → 启动工作台。

浏览器打开 **http://127.0.0.1:8210**。模型凭据无需配置到 PaperLab：在 **dsh Web UI（http://127.0.0.1:3080）的「模型」页**填入即可，PaperLab 不接触任何 API key。

新建示例项目，或「导入论文(zip)」/「复制项目目录」直接把文件拷进项目
点「编译」生成 PDF
在 PDF 上选中文字 → 写批注
「AI 修订」Tab → 根据批注修改论文 → 宽屏轨迹直播进度
审阅 diff / 历史 / 导出

完整说明见 docs/快速开始.md。

📦 安装插件（dsh 用户）

本仓库根目录即一个符合官方规范的 dsh bundle（dsh.bundle + cordis.patch.yml + 已构建的 lib/），任选一种方式安装：

# npm
dsh plugin --profile paperlab add dsh-paperlab

# GitHub（构建产物已提交，无需本地构建）
dsh plugin --profile paperlab add github:maple-pwn/paperlab

# 本地源码（开发用，先 make plugin-build）
dsh plugin --profile paperlab add .

⚠️ 安装插件等于在本机运行第三方代码（拥有你的权限）。请先阅读源码，并在不保存密钥的环境中试用。

🔧 模型与编排

工作台右侧「设置」Tab 可实时切换（无需改代码）：

模型提供方 / 模型 / 思考强度：经插件读写 dsh 设置（agentDefaultModel），与 dsh Web UI 同步
编排模式（agent preset）：自动发现 dsh 自带 preset（标准 / 极简 / PTC / 创造）与 $DSH_HOME/.agent-presets 中的自定义 preset，按项目保存

PaperLab 不直接调用任何模型 API：凭据、模型路由、agent loop、权限沙箱全部由 DeepSeek Harness 提供。

🧪 测试

make test
# server: pytest（项目/文件/编译/批注/修订/导出 API）
# web:    tsc + vite build
# plugin: tsc + tsup + 无模型工具单测

📂 目录结构

paperlab/
├── web/            # React 前端（含 PDF.js 文本层与批注交互）
├── server/         # FastAPI 后端
├── plugin/         # dsh-paperlab（DeepSeek Harness bundle）
├── examples/paper/ # 示例论文模板
├── docs/           # 快速开始与架构文档
├── scripts/        # 兼容入口
├── start.sh        # 一键启动
└── Makefile

🤝 参与贡献

欢迎 issue / PR，见 CONTRIBUTING.md。

📄 许可证

🔗 社区

本项目按 DeepSeek Harness 插件规范打包（dsh.bundle），可在仓库 Topics 中添加 dsh-plugin 以加入插件生态。

dsh-paperlab

AI 分析

安裝

說明文件