OverTree

OverTree 是一个在自己电脑上运行的论文写作助手。它可以阅读论文文件夹中的草稿、笔记、参考文献、图片和数据，帮助你整理思路、撰写内容、润色表达并检查投稿准备。

安装后只需使用邮箱创建账号并登录，即可开始使用，不需要进行额外的技术配置。

安装

支持 Windows 10/11、macOS 和 Linux。请先安装 Node.js 22 或更新版本，然后重新打开终端。

npm install -g overtree

检查是否安装成功：

overtree --version

开始写论文

先进入你的论文文件夹，再启动 OverTree：

cd /path/to/your-paper
overtree paper

Windows PowerShell 示例：

mkdir "$HOME\Documents\my-paper"
cd "$HOME\Documents\my-paper"
overtree paper

macOS Terminal 示例：

mkdir -p "$HOME/Documents/my-paper"
cd "$HOME/Documents/my-paper"
overtree paper

浏览器会自动打开论文助手。第一次使用时：

1. 点击右上角“登录 / 注册”。
2. 使用邮箱创建账号；新账号会自动获得体验积分。
3. 选择基础模式、深度模式或全域模式。
4. 点击一个常用任务，或直接描述你想完成的工作。
5. 在“文件预览”中检查结果和保存的文件。

账号与积分

• 账号和积分绑定邮箱，不绑定某个浏览器或电脑类型。
• 同一账号可在 Windows、macOS 和不同浏览器中登录；换电脑后重新登录即可。
• 基础模式适合日常阅读、整理和写作，优先节省积分。
• 深度模式适合复杂分析、关键论证和最终润色，积分消耗约为基础模式的 10 倍。
• 全域模式适合完整的代码、数据和论文工作区任务，并与深度模式采用相同积分费率。本地版的全域运行环境依赖 Codex CLI，首次使用前运行 npm install -g @openai/codex 和 codex login，并在 OverTree 登录邮箱账号。
• 当前处于试用阶段，积分由平台发放，真实支付暂未开放。

文件与隐私

论文文件保存在你自己的电脑中，不会因为登录而自动同步整个文件夹。使用写作助手时，为完成当前任务，相关内容会发送到在线智能服务进行处理。

OverTree 不会把论文内容保存在浏览器缓存中。重新打开页面时，会从当前论文文件夹和已保存的任务记录加载内容。

更新与卸载

更新到最新版：

npm install -g overtree@latest

卸载：

npm uninstall -g overtree

常见问题

找不到 overtree 命令

关闭终端后重新打开，再运行 overtree --version。仍然找不到时，确认 Node.js 和 npm 已正确安装。

浏览器没有自动打开

打开终端中打印的本地地址，通常是 http://127.0.0.1:3210/paper-ui/。端口被占用时，OverTree 会自动选择下一个可用端口。

换浏览器或换电脑后怎么办

重新安装并使用同一个邮箱账号登录。积分会保留，但论文文件需要由你自己复制到新电脑。

积分不足怎么办

先切换到基础模式。试用阶段需要由平台补充积分，后续会开放正式充值。

全域模式提示本机环境未就绪

先在终端运行 codex --version 和 codex login status。未安装时运行 npm install -g @openai/codex，未登录时运行 codex login，然后回到 OverTree 重新选择该模式。

更详细的操作说明见 OverTree 使用指南。问题和建议可提交到 GitHub Issues。

本地开发

npm install
npm link
npm run check
npm run smoke:paper-ui

界面和代码结构说明见 UI 与项目架构文档。

License: Apache-2.0