CDN.MN

现已上线

设备码注册、按作用域划分的访问权限、每个作用域的审批阀门与即时撤销、机器可读的发现机制（auth.md、llms.txt、OpenAPI 以及 SKILL.md 工作流），以及包含 43 个工具的 MCP 服务器——读取操作、公开站点图片分析与节省估算、项目创建、缓存清除、域名验证，以及所有置于敏感作用域之后的生产变更操作：主机名激活、充值、源站配置、项目归档以及应用交付配置。每一项都能为自主代理独立运行——唯独资金操作例外，它始终等待你的批准——或者在你要求参与其中时弹出审批卡片。已发布的 @cdnmn/cli + @cdnmn/sdk 让代理能够直接从项目中检测、配置、重写、测试和验证——并遵循仓库的 AGENTS.md。

逐步推出

集成规划 + 预览工具集（集成计划、非生产预览）以及匿名免认领注册路径已在路线图中——凡出现之处均已在下方标注。

面向机器的接口

身份验证与发现机制已在 well-known 位置上线——代理今天即可注册并持有作用域令牌：

GET  /auth.md                → the human-readable access guide
GET  /llms.txt               → machine index of the agent surfaces
GET  /openapi.json           → OpenAPI 3.1 for the REST endpoints
GET  /.well-known/oauth-protected-resource
GET  /.well-known/oauth-authorization-server
POST /api/agent/register     → device_code + user_code
POST /api/agent/token        → poll → cdnmn_at_… bearer token
POST /api/mcp                → MCP 2025-06-18: tools/list, tools/call

由 CDN.MN 应用实时提供

两种实时接入方式：普通设备认领路径将代理与你的账户配对——你打开认领链接（/agents/claim）并授予作用域；或者，持有你邮箱的代理通过 provision_workspace 注册，立即获得一个实时工作区和令牌，无需任何人工步骤，你之后可通过邮件接管。在你接管之前，计费和删除功能保持锁定。

代理技能工作流已上线

安装工作流已发布在 /SKILL.md——一份基于实时工具（验证 → 激活 → 充值）的分步操作手册。下方打包的平台参考文档和验证脚本仍在逐步推出：

cdn-mn-agent/
├── SKILL.md
├── scripts/
│   ├── detect-platform
│   ├── analyze-images
│   ├── create-preview
│   └── verify-installation
├── references/
│   ├── nextjs.md · wordpress.md · nuxt.md
│   ├── static-sites.md · nginx.md
│   └── rollback.md
└── assets/
    ├── config-templates/
    └── report-template.md

计划中的打包布局——SKILL.md 工作流今日已上线。

精确作用域，而非万能密钥

代理只请求其确切需要的能力。没有类似 api.write 这样的通用权限。

site:analyze分析公开网站或源站

project:read查看 CDN.MN 项目

project:create创建新项目

origin:read查看源站配置

origin:write配置或更改源站

integration:plan生成集成计划

integration:preview创建非生产预览

integration:apply将已批准的更改应用到生产环境

domain:read查看域名状态

domain:verify对站点运行源站所有权验证

domain:activate激活生产交付

analytics:read读取用量和节省数据

cache:purge清除选定对象

billing:read读取套餐和用量

billing:write更改套餐或授权支出

project:delete删除项目

files:read列出文件集合和文件

files:write创建集合并上传文件

files:publish将集合设为公开或私有

precheck:read运行 CDN.MN Domains 预检查并读取访问状态

precheck:download列出并下载已批准的 Domains 数据集

precheck:write请求 Domains 访问权限或数据集下载

registry:read读取注册表源和运行记录

registry:write推送实时更新、上传区域文件（每次上传都需要你的批准）、更改源设置并请求抓取

红色标注的作用域（origin:write、integration:apply、domain:activate、billing:write、project:delete、files:publish、precheck:write、registry:write）默认永不授予。当你确实授予某一项时，代理会在该作用域内自主行动——除非你在连接时勾选“每次都需要我的批准”，以保留每次使用的审批卡片。资金操作（billing:write）始终需要该批准——其阀门已锁定，无法选择退出。

代理如何接入

遵循 auth.md 模型——配有实用的回退方案，而非“适用于所有代理”的宣称。

01 · 预配工作区

已上线

启动无需人工步骤

持有你邮箱的代理通过 provision_workspace 注册，立即获得一个实时工作区和作用域令牌——它可以分析、创建项目、验证域名，并使用一次性 $5 启动额度提供服务，开始时无需批准。你之后可通过邮件接管该工作区；在你接管之前，计费、删除和自定义源站保持锁定。

owner_email + provision_workspace → 首次轮询即获得令牌 · 通过邮件接管 · 未接管的工作区约 72 小时后被清理

02 · 用户认领

已上线

你确认认领码

代理注册设备码并向你展示认领链接。你登录 CDN.MN，查看它请求的确切作用域并批准——随后代理轮询并获得作用域持有者令牌。当你更愿意预先授予访问权限时，这是一条实时路径。

在 CDN.MN 自有页面上进行设备码仪式 · 令牌以哈希形式存储

03 · 匿名预览

计划中

无用户身份

在任何人工参与之前，代理可以请求的只读预览作用域——分析公开站点，但不触碰任何客户拥有的内容。免认领路径及其计划/预览工具仍在逐步推出。

site:analyze · analytics:read · billing:read（计划/预览作用域在其工具发布前保留）

04 · 代理验证

计划中

提供商证明身份

在代理提供商支持身份断言的情况下，代理将在你同意后请求特定受众的断言；CDN.MN 验证后返回作用域凭证。计划中，且永远不会是唯一路径。

随提供商采用而到来——上述路径始终可用

高层级、幂等的 MCP 工具 43 个工具已上线

43 个工具今日可在 /api/mcp 调用——读取操作、公开站点图片分析、项目创建、域名验证、缓存清除，以及所有敏感的生成变更操作。敏感工具会为自主代理独立运行——唯独充值例外，它始终等待你的批准——或者在你要求参与其中时弹出审批卡片；集成计划 + 预览工具仍在逐步推出，代理绝不会盲目拼装底层配置：

list_projects

get_analytics

get_billing

get_domains

get_approval_status

activate_hostname

verify_domain

add_funds

change_plan

configure_origin

delete_project

apply_integration

purge_urls

create_project

rollback_configuration

analyze_website

estimate_image_savings

detect_integration_strategy

list_collections

list_files

create_collection

upload_file

set_collection_access

get_share_access_log

list_share_links

get_share_agreement

revoke_share_link

create_share_link

publish_share_agreement

invite_to_share_link

revoke_share_invite

check_domains

check_label

get_domains_access

list_domain_downloads

request_domains_access

request_domain_download

list_registry_feeds

push_registry_updates

fetch_registry_feed

update_registry_feed

create_domain_zone_upload

get_domains_stats

create_preview

generate_integration_plan

verify_image_delivery

绿色 = 现在可调用 · 灰色 = 逐步推出中

每个变更类工具都支持

设计目标是让意外创建重复项、路由到错误的源站或产生无上限账单变得困难。今日已在每个敏感工具上生效（此处以 activate_hostname 为例）：dry_run 和 idempotency_key 会被接受并绑定到该操作，使用相同键的重复调用绝不会执行两次。

accepted on every sensitive tool (example: activate_hostname):
  site_id: "s_..."
  dry_run: true
  idempotency_key: "..."

→ returns now, when autonomous:
  status: executed · execution.hostname
  (the action ran inline)

→ returns now, when you require approval:
  approval_required · approval_id
  poll_with: get_approval_status

→ every sensitive action returns a self-describing contract:
  proposed_changes · warnings
  rollback_plan · verification_steps
  (on the tool response, on get_approval_status,
   and on the owner's approval card)

可复制的代理提示词

这些内容出现在主页、代码仓库、代理技能和框架指南中。

Add CDN.MN to this website.

Keep the current origin and existing application behavior. Analyze the
image pipeline, estimate potential savings, detect the safest
integration strategy, create the CDN.MN project, configure responsive
image delivery and modern formats, run the project tests, and ask me
before changing DNS, billing, or production deployment.

可选的 AGENTS.md 项目片段

AGENTS.md 是为编码代理提供持久项目指导的新兴惯例。如果你的代理遵循它，请添加此部分，使每次 CDN.MN 变更都遵循你项目的规则——你的直接指令始终优先。

## CDN.MN image delivery

- Read the current CDN.MN project configuration before changing image URLs.
- Keep the existing image origin as the fallback unless explicitly instructed.
- Never commit CDN.MN access tokens, claim tokens, or API credentials.
- Create integration changes in a separate branch.
- Run the project build, tests, and broken-image verification before completion.
- Use a CDN.MN preview before requesting production activation.
- Do not modify DNS, billing, or production deployment without explicit approval.
- Report all changed files, configuration changes, verification results,
  and rollback steps.