Anno

English · 简体中文 · 日本語 · 한국어 · Français · Español · Deutsch · Italiano · Português · ไทย

Anno

Anno 是一款本地优先的 HTML 审阅工作区，专为 AI 编码 Agent 打造。它会在浏览器中打开本地 HTML 文件的隔离副本，支持直接编辑文本和格式、添加元素评论和区域批注，以及感知幻灯片的审阅；之后会返回持久化交接内容，供 Agent 领取并将修改落实为经过验证的独立 HTML 文件。

此代码仓库包含一个共用的 MCP 服务和与宿主无关的技能、宿主支持时可用的原生插件清单，以及适用于 Cursor、Google Antigravity、Windsurf、GitHub Copilot 和 Meta Muse Code 的即用型 MCP 模板。DeepSeek Harness 支持由 philmingdao/anno-dsh-native 独立维护；这是一个使用 DeepSeek Harness 构建的进程内原生插件。Muse Code 支持仍处于实验阶段。

亮点

• 仅限本地访问的 HTTP 编辑器，绑定到 127.0.0.1
• 永不覆盖源文件
• 可直接编辑文本、字体排版、颜色、位置、页面备注、元素和区域
• 持久化且幂等的 Agent 交接
• 兼容现有的 needs_codex 会话
• 所有受支持宿主共用 MCP 和 SKILL.md 实现
• 简体中文和英文界面、浅色和深色主题

截图

审阅编辑器会在浏览器中打开 HTML 的隔离副本。可直接编辑文本和样式、添加元素或区域评论，并一键将收集到的修改交还给 Agent。

要求

• Node.js 22 或更高版本
• 支持本地 stdio MCP 服务且可访问本地文件的宿主
• 用于审阅编辑器的浏览器

支持的 Agent 工具

Codex、Claude Code、WorkBuddy 和 CodeBuddy 使用打包的插件清单。Cursor、Google Antigravity、Windsurf、GitHub Copilot CLI/Chat 和 Muse Code 通过各宿主专用的配置模板连接到同一个本地 stdio MCP 服务。DeepSeek Harness 使用独立的原生 anno-dsh-native 代码仓库，该仓库直接集成 DSH 配置文件、工具注册表和 Agent 生命周期，无需 MCP 桥接。

请参阅Agent 工具集成，了解即用型配置和宿主限制。

Agent 工具	集成方式	状态
Codex	原生插件 + MCP	支持
Claude Code	原生插件 + MCP	支持
WorkBuddy / CodeBuddy	原生插件 + MCP	支持
Cursor	本地 stdio MCP	支持
Google Antigravity	本地 stdio MCP	支持
Windsurf	本地 stdio MCP	支持
GitHub Copilot CLI / Chat	本地 stdio MCP	本地支持
DeepSeek Harness	独立的原生 DSH 插件	已在 0.1.0-rc.6 上验证
Meta Muse Code	本地 stdio MCP	实验性

一条命令安装

无需克隆或构建。安装程序会检测可用的 Agent 工具，供你交互式选择；仅将 anno 条目合并到现有 JSON/JSONC 配置中；安装共享技能；在更改前创建带时间戳的备份；并执行 MCP 握手。

npx -y @philmingdao/[email protected] setup

如需无人值守安装或针对特定宿主安装：

npx -y @philmingdao/[email protected] setup --host cursor
npx -y @philmingdao/[email protected] setup --host cursor,windsurf,copilot
npx -y @philmingdao/[email protected] setup --host antigravity --scope project

在 macOS、Linux 和 Windows 上使用同一条命令。Node.js 22+ 是唯一的通用前置条件。可通过以下命令验证或安全移除 Anno：

npx -y @philmingdao/[email protected] doctor --host cursor
npx -y @philmingdao/[email protected] uninstall --host cursor

DeepSeek Harness 在单独的仓库中提供专用的原生实现。直接从 GitHub 安装当前源代码：

dsh plugin --profile web add github:philmingdao/anno-dsh-native
dsh web

参见 philmingdao/anno-dsh-native，了解安装、架构、兼容性和源代码检出测试。该插件通过 DeepSeek Harness 本身开发并验证，是 Anno 的受维护 DeepSeek 解决方案。

Codex、Claude Code、WorkBuddy 和 CodeBuddy 通过各自的原生插件系统安装。Cursor 使用兼容原生插件的 MCP/技能布局；Antigravity 使用完整的原生插件包；Windsurf 使用 MCP 和技能配置；Copilot 使用 MCP 和技能配置。Muse Code 需要提供已确认的配置路径，因为其公开配置约定尚不稳定：

npx -y @philmingdao/[email protected] setup --host muse --config /absolute/path/to/mcp.json

也提供原生快捷安装方式：

copilot plugin install philmingdao/anno:plugins/anno

Anno 被 Cursor Marketplace 收录后，Cursor 用户即可直接从 Marketplace 安装仓库中的原生插件。使用下载的软件包时，Antigravity CLI 可通过 agy plugin install /path/to/host-plugins/antigravity 安装打包后的目录。

手动配置备用方案

建议使用通用安装程序。对于需要审核并手动合并配置的受管环境，仍保留以下固定版本模板：

Agent 工具	模板	配置目标位置
Cursor	cursor/mcp.json	项目 .cursor/mcp.json 或 ~/.cursor/mcp.json
Google Antigravity	antigravity/mcp_config.json	项目 .agents/mcp_config.json 或 ~/.gemini/config/mcp_config.json
Windsurf	windsurf/mcp_config.json	合并到 ~/.codeium/windsurf/mcp_config.json
GitHub Copilot CLI	github-copilot/mcp-config.json	合并到 ~/.copilot/mcp-config.json
VS Code 中的 GitHub Copilot Chat	github-copilot/vscode-mcp.json	项目 .vscode/mcp.json
Meta Muse Code	muse-code/mcp.json	通过此版本的 MCP 管理器导入；实验性支持

也可以直接通过 MCP 配置 Copilot CLI：

copilot mcp add anno --env ANNO_HOST=copilot -- npx -y @philmingdao/[email protected] mcp

保存后，重启宿主或刷新其 MCP 服务列表。GitHub 的云端编码 Agent 无法访问 Anno 的回环审查 URL；请在本地使用 Copilot。由于 Muse Code 的公开 MCP 配置约定尚不稳定，其支持仍处于实验阶段。

直接使用 MCP 服务

任何 stdio MCP 客户端都可以启动：

npx -y @philmingdao/[email protected] mcp

开发

npm install
npm test
npm run pack:check

核心 MCP 软件包位于 plugins/anno。DeepSeek Harness 实现在独立的 anno-dsh-native 仓库中维护。生成的依赖项和本地审查会话不会提交到版本库。

数据与隐私

Anno 在本地处理 HTML 和批注。编辑器仅绑定到回环地址，并验证主机和来源标头。通用主机将会话存储在 ~/.anno 下；在 macOS 上，Codex 将兼容的默认目录设为 ~/Library/Application Support/Codex/anno。设置 ANNO_DATA_DIR 可选择其他目录。

Anno 不会上传已审阅的文件。连接的 Agent 主机可能会根据其自身的数据政策处理草稿和批注。

兼容性

有关针对特定主机的行为和限制，请参阅 docs/compatibility.md。

许可证

MIT。捆绑的 WDXL Lubrifont 字体仍受其单独的 SIL Open Font License 约束，许可证文件位于 plugins/anno/assets/OFL-WDXL-Lubrifont.txt。