anno (dsh-native)

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

[图片: Anno]

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

# Anno

Anno is a local-first HTML review workspace for AI coding agents. It opens an isolated copy of a local HTML file in a browser, supports direct text and formatting edits, element comments, area annotations, and slide-aware review, then returns a durable handoff that an agent can claim and resolve into a verified standalone HTML file.

The repository contains one shared MCP server and host-neutral skill, native plugin manifests where a host supports them, and copy-ready MCP templates for Cursor, Google Antigravity, Windsurf, GitHub Copilot, and Meta Muse Code. DeepSeek Harness support is maintained separately in [`philmingdao/anno-dsh-native`](https://github.com/philmingdao/anno-dsh-native), an in-process native plug-in built with DeepSeek Harness; Muse Code support remains experimental.

## Highlights

- Local-only HTTP editor bound to `127.0.0.1`
- Source files are never overwritten
- Direct text, typography, color, position, page-note, element, and area editing
- Durable, idempotent agent handoffs
- Legacy compatibility with existing `needs_codex` sessions
- Shared MCP and `SKILL.md` implementation across supported hosts
- Simplified Chinese and English UI, light and dark themes

## Screenshots

The review editor opens an isolated copy of your HTML in the browser. Edit text and styles directly, leave element or area comments, and hand the collected changes back to the agent in one click.

![Anno review editor, light theme, annotations tab](plugins/anno/assets/screenshots/anno-editor-light.png)

![Anno review editor, dark theme, format controls](plugins/anno/assets/screenshots/anno-editor-dark.png)

![Element comment popover](plugins/anno/assets/screenshots/anno-comment.png)

## Requirements

- Node.js 22 or newer
- A host that supports local stdio MCP servers and can access local files
- A browser for the review editor

## Supported agent tools

Codex, Claude Code, WorkBuddy, and CodeBuddy use packaged plugin manifests. Cursor, Google Antigravity, Windsurf, GitHub Copilot CLI/Chat, and Muse Code connect to the same local stdio MCP server through host-specific configuration templates. DeepSeek Harness uses the independent native [`anno-dsh-native`](https://github.com/philmingdao/anno-dsh-native) repository, which integrates directly with the DSH profile, tool registry, and agent lifecycle without an MCP bridge.

See [Agent tool integrations](docs/agent-tools.md) for copy-ready configuration and host limitations.

| Agent tool | Integration | Status |
| --- | --- | --- |
| Codex | Native plugin + MCP | Supported |
| Claude Code | Native plugin + MCP | Supported |
| WorkBuddy / CodeBuddy | Native plugin + MCP | Supported |
| Cursor | Local stdio MCP | Supported |
| Google Antigravity | Local stdio MCP | Supported |
| Windsurf | Local stdio MCP | Supported |
| GitHub Copilot CLI / Chat | Local stdio MCP | Supported locally |
| DeepSeek Harness | Independent native DSH plug-in | Verified on 0.1.0-rc.6 |
| Meta Muse Code | Local stdio MCP | Experimental |

## One-command install

No clone or build is required. The installer detects available agent tools, lets you choose them interactively, merges only the `anno` entry into existing JSON/JSONC configuration, installs the shared skill, creates a timestamped backup before changes, and runs an MCP handshake.

```bash
npx -y @philmingdao/anno@0.4.0 setup
```

For unattended or host-specific installation:

```bash
npx -y @philmingdao/anno@0.4.0 setup --host cursor
npx -y @philmingdao/anno@0.4.0 setup --host cursor,windsurf,copilot
npx -y @philmingdao/anno@0.4.0 setup --host antigravity --scope project
```

Use the same command on macOS, Linux, and Windows. Node.js 22+ is the only shared prerequisite. Verify or safely remove Anno with:

```bash
npx -y @philmingdao/anno@0.4.0 doctor --host cursor
npx -y @philmingdao/anno@0.4.0 uninstall --host cursor
```

DeepSeek Harness has a dedicated native implementation in a separate repository. Install the current source directly from GitHub:

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

See [`philmingdao/anno-dsh-native`](https://github.com/philmingdao/anno-dsh-native) for installation, architecture, compatibility, and source-checkout testing. That plug-in was developed and validated through DeepSeek Harness itself and is the maintained DeepSeek solution for Anno.

Codex, Claude Code, WorkBuddy, and CodeBuddy are installed through their native plugin systems. Cursor receives a native plugin-compatible MCP/Skill layout; Antigravity receives a complete native plugin bundle; Windsurf receives MCP plus Skill configuration; and Copilot receives MCP plus Skill configuration. Muse Code requires the confirmed config path because its public configuration contract is not stable:

```bash
npx -y @philmingdao/anno@0.4.0 setup --host muse --config /absolute/path/to/mcp.json
```

Native shortcuts are also available:

```bash
copilot plugin install philmingdao/anno:plugins/anno
```

After Anno is accepted into Cursor Marketplace, Cursor users can install the repository's native plugin directly from the marketplace. Antigravity CLI can install the packaged directory with `agy plugin install /path/to/host-plugins/antigravity` when working from a downloaded package.

## Manual configuration fallback

The universal installer is recommended. These version-pinned templates are retained for managed environments that require review and manual merging:

| Agent tool | Template | Configuration destination |
| --- | --- | --- |
| Cursor | [`cursor/mcp.json`](plugins/anno/integrations/cursor/mcp.json) | Project `.cursor/mcp.json` or `~/.cursor/mcp.json` |
| Google Antigravity | [`antigravity/mcp_config.json`](plugins/anno/integrations/antigravity/mcp_config.json) | Project `.agents/mcp_config.json` or `~/.gemini/config/mcp_config.json` |
| Windsurf | [`windsurf/mcp_config.json`](plugins/anno/integrations/windsurf/mcp_config.json) | Merge into `~/.codeium/windsurf/mcp_config.json` |
| GitHub Copilot CLI | [`github-copilot/mcp-config.json`](plugins/anno/integrations/github-copilot/mcp-config.json) | Merge into `~/.copilot/mcp-config.json` |
| GitHub Copilot Chat in VS Code | [`github-copilot/vscode-mcp.json`](plugins/anno/integrations/github-copilot/vscode-mcp.json) | Project `.vscode/mcp.json` |
| Meta Muse Code | [`muse-code/mcp.json`](plugins/anno/integrations/muse-code/mcp.json) | Import through the build's MCP manager; experimental |

Copilot CLI can also be configured directly through MCP:

```bash
copilot mcp add anno --env ANNO_HOST=copilot -- npx -y @philmingdao/anno@0.4.0 mcp
```

Restart or refresh the host's MCP server list after saving. GitHub's cloud coding agent cannot expose Anno's loopback review URL; use Copilot locally. Muse Code support remains experimental because its public MCP configuration contract is not yet stable.

## Use the MCP server directly

Any stdio MCP client can launch:

```bash
npx -y @philmingdao/anno@0.4.0 mcp
```

## Development

```bash
npm install
npm test
npm run pack:check
```

The core MCP package lives in `plugins/anno`. The DeepSeek Harness implementation is maintained in the independent [`anno-dsh-native`](https://github.com/philmingdao/anno-dsh-native) repository. Generated dependencies and local review sessions are not committed.

## Data and privacy

Anno processes HTML and annotations locally. The editor binds only to loopback and validates host and origin headers. Generic hosts store sessions under `~/.anno`; Codex keeps its compatible default under `~/Library/Application Support/Codex/anno` on macOS. Set `ANNO_DATA_DIR` to choose another directory.

Anno does not upload reviewed files. The connected agent host may process the draft and annotations according to that host's own data policy.

## Compatibility

See [docs/compatibility.md](docs/compatibility.md) for host-specific behavior and limitations.

## License

MIT. The bundled WDXL Lubrifont font remains covered by its separate SIL Open Font License in `plugins/anno/assets/OFL-WDXL-Lubrifont.txt`.