TeXlyre 协作评审实战指南:行内评论与修订追踪,让学术论文同行评审更高效

原创2026-10-21 10:36:361,445 阅读

TeXlyre 协作评审实战指南:行内评论与修订追踪,让学术论文同行评审更高效

TeXlyre 是一款本地优先(local-first)的 LaTeX 与 Typst 在线协作编辑器,支持实时协作、离线编辑,并内置行内评论与**修订追踪(Track Changes)**功能,专为学术论文同行评审和多作者协作设计。下面这篇教程将带你从零搭好协作环境,掌握用评论讨论修改意见、用修订面板逐条"接受/拒绝"改动的高效评审工作流。

一、为什么用 TeXlyre 做学术协作

写论文最怕的场景:作者 A 改了一段话,作者 B 不知道改在哪、为什么改;审稿意见散落在邮件里,最后无法对号入座。TeXlyre 的解法是把"讨论"和"改动"都锚定到文档的具体位置:

  • 行内评论(Comments):选中任意文字即可挂评论,支持回复、搜索、标记"已解决";
  • 修订追踪(Tracked Changes):所有插入和删除以删除线/下划线形式保留在原文中,集中出现在右侧 Changes 面板中逐条处理;
  • 无冲突同步:底层使用 Yjs CRDT 与 WebRTC 点对点连接,多人同时编辑自动合并,无需中央服务器;
  • 离线可用:编辑数据保存在浏览器本地(IndexedDB),断网不丢稿。

TeXlyre协作光标演示:多人在同一LaTeX文档中实时编辑

二、一键开启实时协作

  1. 创建或打开一个项目,点击顶部的 Collab 按钮,在"Real-time Document Synchronization"弹窗中查看连接状态;
  2. 把项目 URL(形如 /#yjs:abc123def456)分享给合作者,对方打开链接即进入同一协作空间;
  3. 所有人的光标、选区都会以不同颜色实时显示在彼此屏幕上(见上图),沟通可以直接用右下角的 Project Chat。

TeXlyre项目聊天面板:在协作编辑时进行实时讨论

💡 提示:协作功能需要浏览器支持 WebRTC,推荐使用最新版 Chrome/Edge/Firefox。

三、行内评论:把反馈钉在原文上

添加评论的操作非常简单:在编辑器中用鼠标选中想要讨论的文字(如某个术语、某句表述),选中区域旁会弹出 Add Comment 按钮,点击后在弹窗中输入内容即可。

TeXlyre添加行内评论弹窗:选中LaTeX文字后弹出Add Comment

评论发出后,会在右侧 Comments 面板中集中呈现,并带有行号锚点(如 Line 122):

  • Active / Resolved 双标签页:待处理与已解决的评论分开管理,评审进度一目了然;
  • 全文搜索:面板顶部支持按评论内容、回复内容、用户名过滤,长文档也能秒定位;
  • 回复与讨论:每条评论下方可继续 Add response,形成完整讨论线程;
  • 点击评论即跳转:在面板中点击某条评论,编辑器会直接定位并高亮对应原文位置,评审时"观点 ↔ 原文"双向对照,不再来回翻找。

TeXlyre评论面板:行内评论列表、搜索与跳转原文

评论的挂载逻辑实现在 CommentExtension 与 CommentPanel.tsx 中,数据结构定义见 types/comments.ts。

四、修订追踪:让每处修改可追溯

这是 TeXlyre 区别于普通协作文档编辑器的杀手级功能,也非常接近 Word 的"修订"体验:

  1. 开启追踪:点击工具栏的 Track Changes 按钮。下拉菜单提供两个粒度——
    • Track my changes in this file:只追踪我本人在这个文件里的修改;
    • Track changes for all collaborators:把该文件加入项目的 trackedFiles 列表,所有协作者的改动都被记录,这正是团队评审模式;
  2. 查看修改:打开 Changes 面板,每处插入以下划线标出、删除以删除线标出,并自动计算前后文本差异;
  3. 批量处理:面板顶部提供 Accept all / Reject all / Resolve all 三个批量按钮,也可以对单条评论卡片逐条操作——
    • ✅ Accept:接受该处修改,修订标记从原文消失;
    • ❌ Reject:拒绝修改,恢复为原文;
    • ⤼ Resolve:仅标记为已解决(不改动文本);
    • 每条修订同样支持 Add response,先讨论再定夺;
  4. 滚动同步:Changes 面板与编辑器滚动位置自动对齐,面板顶部还有"重置位置"按钮,长文档里也不会"找不到对应段落"。

TeXlyre修订追踪面板:Changes与Comments双面板、批量接受拒绝修订

追踪功能的核心在 trackChanges.ts:它作为 CodeMirror 扩展监听每次用户编辑,把变化拆分为 insert / delete 片段并与原文快照对比;面板的布局、滚动同步逻辑见 ReviewPanel.tsx,类型定义见 types/review.ts。

五、推荐的同行评审工作流

把上面的功能串起来,就是一套完整的"返修周期":

  1. 作者阶段:开启"Track changes for all collaborators",共同起草初稿,所有改动透明可见;
  2. 评审阶段:作者暂存修订,评审人用行内评论对关键句提出质疑,面板里逐条回复讨论;
  3. 定稿阶段:讨论结束后,评审人/作者用 Accept all 一次性合并修改,或逐条 Reject 保留原稿,再 Resolve all 归档本轮意见;
  4. 全程离线安全:即使断网,评论与修订都存在本地,恢复网络后自动同步。

这套流程让"改了什么、为什么改、谁决定的"全部沉淀在文档本身,评审记录即版本历史。

六、相关代码与模块索引

模块 路径 说明
评论扩展 src/extensions/codemirror/CommentExtension.ts 选中文字后弹出评论入口
评论面板 src/components/comments/CommentPanel.tsx Active/Resolved 标签与搜索
修订核心 src/extensions/codemirror/review/trackChanges.ts 编辑监听与差异片段计算
修订面板 src/components/review/ReviewPanel.tsx 批量接受/拒绝/解决按钮
追踪开关 src/components/review/ReviewToggleButton.tsx 个人/全员追踪选项
状态管理 src/contexts/ReviewContext.tsx 本地与共享追踪状态合并
协作弹窗 src/components/collab/CollabModal.tsx 连接状态与项目 ID 展示

🎯 总结:TeXlyre 用"行内评论 + 修订追踪 + 实时同步"三件套,把学术论文同行评审从邮件往返变成了文档内闭环协作。新手只需记住三步——分享 URL 开协作、选中文字加评论、Changes 面板定稿——就能显著提升多作者写作与评审效率。

登录后查看全文
texlyre