# 活点地图接入指引（给 Agent 看的） > 用户要求把「活点地图」接入当前项目。你是 Agent，按本指引从上到下逐步执行。 > **铁律：每一步失败就停下，向用户报告哪一步、什么错、你打算怎么补救；不要静默跳过，不要假装成功。** > 全程只需要一次手动操作（最后一步用户自己点「打开项目文件夹」），其余都由你完成。 ## 下载源（按顺序兜底，一个失败换下一个） | 源 | 地址前缀 | 说明 | |---|---|---| | 源 A | `https://livedotmap.top` | 自有域名（EdgeOne），国内不开代理可直连，海外也可访问，**首选** | | 源 B | `https://app.live-dot-map.workers.dev` | Cloudflare，海外/挂代理时更稳 | | 源 C | `https://test-d0gims26n5c5ce096-1425841737.tcloudbaseapp.com` | CloudBase 国内节点兜底 | 要下载的文件（三个源路径相同）： - `/app.html` —— 画布程序本体（零依赖单文件） - `/favicon.ico` —— 图标（快捷方式用） - `/agent-kit/AGENTS.snippet.md` —— 协议段（第 4 步用） - `/agent-kit/map.template.json` —— 空白地图模板（第 5 步用） **注意：本机可能挂着代理（Clash 等），curl 被拦不是活点地图的问题——换源、换工具再试，都失败才报告。** ## 第 1 步：安装画布程序到 `~/.live-dot-map/` 程序装一次、所有项目共用；已存在则覆盖为最新版，不用担心重复执行。 ```bash # macOS / Linux / Windows 的 Git Bash 通用： mkdir -p ~/.live-dot-map curl -fsSL -o ~/.live-dot-map/app.html "https://livedotmap.top/app.html" \ || curl -fsSL -o ~/.live-dot-map/app.html "https://app.live-dot-map.workers.dev/app.html" \ || curl -fsSL -o ~/.live-dot-map/app.html "https://test-d0gims26n5c5ce096-1425841737.tcloudbaseapp.com/app.html" curl -fsSL -o ~/.live-dot-map/favicon.ico "https://livedotmap.top/favicon.ico" \ || curl -fsSL -o ~/.live-dot-map/favicon.ico "https://app.live-dot-map.workers.dev/favicon.ico" \ || curl -fsSL -o ~/.live-dot-map/favicon.ico "https://test-d0gims26n5c5ce096-1425841737.tcloudbaseapp.com/favicon.ico" ``` curl 不可用或全被拦时，Windows 换 PowerShell： ```powershell mkdir "$env:USERPROFILE\.live-dot-map" -Force Invoke-WebRequest "https://livedotmap.top/app.html" -OutFile "$env:USERPROFILE\.live-dot-map\app.html" # 失败则把网址依次换成源 B、源 C 再试；favicon.ico 同理 ``` **验证**：确认 `app.html` 非空且开头是 ` 画布已打开。浏览器安全限制，最后一步只能你来：点画布里的「打开项目文件夹」，选中本项目目录（`<项目路径>`），画布就会和 `.live-dot-map/map.json` 连上，之后我（Agent）每次改地图你的画布自动刷新。 > 以后随时对我说「打开画布」就行；双击桌面的「活点地图」图标也可以。然后按协议「会话开始铁律」输出一次地图摘要，接入完成。