Obsidian 插件：Annoteca 添加可供多人或 AI 协作的批注

经验分享
,
1

[!example] 插件名片

  • 插件名称：Annoteca
  • 插件作者：Charles Kelsoe
  • 插件版本：1.10.1（2026 年 5 月 26 日首发，截止至 2026 年 6 月 23 日，共发 29 版）
  • 插件概述：Annoteca插件专为长文的审阅设计，用户可为草稿需要修改处添加批注并设置需要修改的场景，同一处批注可让多位用户回复，让 AI 提交修改意见后人工复审
  • 插件项目地址：点我跳转
  • 国内下载地址：下载安装

术语解说

Annoteca所创建的批注由 html 写成，储存在被批注文本处，但在源码模式下，html 标记符也处于渲染状态，不会干扰阅读，例：The pricing model needs revisiting before Q3. <!-- annoteca/clarify: which products? -->；

对话、元数据和接受状态也储存在同样的位置，例：

The Q3 forecast assumes a hiring freeze through December.
<!-- annoteca/tone: too blunt for the board deck
[id=a3b9c2x7]
[date=2026-05-23]
[anchor=assumes a hiring freeze through December]
[reply ai 2026-05-23]: Consider "reflects current headcount planning through December."
[reply charles 2026-05-24]: Better. Softening it.
[resolved charles 2026-05-25]: reworded the assumption
-->

在 AI 对笔记进行过读写之后，AI 的修改意见将被储存在以[adressed ...]开始的一行里，原文不会被改变，例：

<!-- annoteca/clarify: hedging
[id=6raa4103]
[anchor=it landed as a shock]
[addressed claude 2026-06-20]: removed the hedging; original preserved inside the marker
-->
The discovery reframed the passage entirely.

每个批注都属于某一个类别，类别在这里表明的是该批注所属的审阅类型。除了一般的审阅类型外，更为学术、虚构、代码和计划写作准备了特殊的预设：

  • General editing
    • Tone：
    • Clarify：
    • Cut：
    • Expand：
    • Tighten：
    • Source needed：
  • Scholarly/Theology
    • Versus needed：
    • Meditation：
    • Exegesis：
    • Translation：
  • Fiction writing
    • Character：
    • Plot：
    • Pacing：
    • Dialogue：
    • Setting：
  • Code review：
    • Security：
    • Performance：
    • Style：
    • Architecture：
    • Test Coverage：
    • Nit：
  • Project planning
    • Blocker：
    • Decision needed：
    • Risk：
    • Opportunity：
    • Follow-up

用户可对同一处批注进行多次回复，每条回复都会显示作者名和批注日期可使多位用户留下自己的意见，可为每个用户设置独立的批注颜色

Pasted image 20260706204907.png
Pasted image 20260706204907.png916×963 37.4 KB

不仅真人用户可以对批注进行回复，任何能够读写 Markdown 的 AI 都能阅读并修改由Annoteca创建的批注，可在命令面板中执行Annoteca: Export AI skill导出一份 skill 文件到库中为 AI 规定格式和词汇表。AI 在读取批注后，同样可以根据用户留下的修改意见对段落进行改写，而且改写后的段落不会立刻取代原文，而是需要用户进行复核，用户可以选择接受（accept）、再议（revise）或驳回（reject），有点类似于 Word 中的修订功能

Pasted image 20260706204907.png
Pasted image 20260706204907.png916×963 37.4 KB

可在命令面板中执行Annoteca: Convert every comment to canonical format，唤出的弹窗，点击Run conversion按钮后，可将库内的 Obsidian 原生注释格式%% %%转换为Annoteca插件所支持的批注

Pasted image 20260706203457.png
Pasted image 20260706203457.png999×586 46.5 KB

基本用法

[!NOTE] 如何添加批注？
选中想要批注的文本，在命令面板中执行Annoteca: Add comment for selection或直接右键点击执行Annoteca: Add comment to selection命令，即可唤出添加批注（Compose comment）界面

Pasted image 20260706142351.png
Pasted image 20260706142351.png951×871 27.9 KB

[!NOTE] 批注侧边栏有什么功能？
批注侧边栏包括三个界面，可通过上方的按钮进行切换，依次是：Thread、Outline 和 Starred。
在 Thread 界面中，可通过上方下拉菜单选择列举当前笔记、当前笔记所在文件夹、当前笔记所在文件夹及其子文件夹、全库、与当前笔记拥有某个相同属性或标签的笔记的所有批注
用户可单击某一批注标题左边的箭头将其展开，并对其进行操作
在 Outline 界面中，可在笔记大纲中查看某标题下的批注数量及其状态
鼠标悬浮于某批注上，点击弹窗右上角的星号将其添加到 Starred 界面中

设置说明

  • Categories：
    • Browse presets：插件自带General editing、Scholarly/Theology、Fiction Writing、Code review和Project Planning的五种预设场景下的二十六个类别，可在下拉菜单中切换场景并将需要的类别添加到自定义场景中
    • Save current as preset：在上一个选项的系统自带类别中选择，或在下面的Add category中添加自定义类别，然后按Save按钮后，在空白栏处填入的文本将被视为自定义预设场景添加到插件数据中
    • Index-entry preset：如启用，则增加Index-entry类型，这种类型旨在标出文中应该加到索引中的概念，可在命令面板中执行Annoteca: Open index entries view命令打开索引页
      Pasted image 20260707142407.png
      Pasted image 20260707142407.png1595×441 24.8 KB
    • Default category：在下拉菜单中选择添加新批注时默认选择的批注类型
    • 在Default category和Add category之间我们可以看到自定义场景下目前存在的类型，在每个类别的开头六点长按拖拽可排序，点击类别可对类别的显示名称（Display name）、图标（Icon）、颜色（Color）和优先级（Tier）进行自定义，点击Remove category即可从自定义场景中删除该类别
  • Editor indicators
    • Indicator style：在下拉菜单中选择被批注文字在文中的显示方式，可为被批注文字下划线，标识符号则提示了批注文本在文中的位置，如果选择Anchor underline only或Hidden，则在编辑模式下会显示 html 代码
    • Indicator size：在下拉菜单中选择标识符号的显示大小
    • Marker hover preview：如启用，则鼠标悬浮于标识符号或被批注文字上时会显示预览窗口，用户可在此编辑标注
    • Anchor underline style：在下拉菜单中选择下划线的样式
    • Anchor underline thickness：在下拉菜单中选择下划线的粗细
    • Default visibility on file open：在下拉菜单中选择打开文件时是否显示批注
  • Resolved comments
    • Resolved comment display：在下拉菜单中选择已标记完成的批注的显示方式
    • Delete on resolve：如启用，则批注会在被标记完成时直接删除
    • Resolved brightness：在下拉菜单中选择已标记完成的批注的显示亮度
  • Composer
    • Composer location：在下拉菜单中选择添加批注窗口的位置
    • Send comment on Enter：如启用，则按Enter发送批注，按Shift Enter在批注中换行；否则按Ctrl Enter发送批注，按Enter在批注中换行
    • Selection comment button：如启用，则在选中文本后，会出现浮动按钮，可一键添加批注
  • Reading view
    • Reading view indicator：在下拉菜单中选择阅读模式下是否显示总览按钮
  • Panel and navigation
    • Auto-collapse other files in scope：如启用，当批注侧边栏显示来自多个文件的批注时，自动折叠当前笔记以外的笔记批注，点击其它笔记名即可展开
    • Marker position when navigating：在下拉菜单中选择在跳转到某批注时，正文滑动到哪个位置
  • Authors
    • Author tag：如启用，则新添加的批注将多一行[author=...]，一般用于与它人或 AI 协作时
    • Author identifier：在空白栏中填入的文本将视为批注者的默认名称
    • Collaborators and authors：在下方添加协作者及其颜色
  • AI integration
    • Skill export destination：在下拉菜单中选择 skill 的写作格式
    • Export AI skill：点击Export按钮即可导出一份 skill 文件