← 文档
Agent 协议
任何 LLM agent 都能在不登录的前提下消费 MDDock 项目。三个原语：稳定的 md:// URI、纯 HTTP 原始端点、用于写动作的可选 MCP 服务器。
md:// URI 协议
为任意公开项目提供稳定且可读的标识符。
解析器（MDDock CLI 与 MCP 服务器）会把这些 URI 翻译为对本机的 HTTP 抓取。
原始 HTTP 端点（免鉴权）
- •主文件，text/markdown
- •项目里的任意文件
- •锁定版本
- •整个项目打包为 zip
- •发现清单
所有原始响应都会设置 Access-Control-Allow-Origin: * 以及 X-MDDock-Version 头，便于 agent 校验内容。
Vibe-coding 握手
对任何 agent 最小可用的 prompt：
对只读消费来说，这就是协议的全部。无需 SDK、无需鉴权、无需解析 schema。
发现
请求 /.well-known/mddock.json 即可获取本机的端点、URI 协议与 CLI 提示。响应是稳定的 JSON 结构（version: 1）。
写动作：用 MCP
任何写动作（remember、propose）都走 MDDock MCP 服务器。详见 /docs/mcp。
skill.md 协议
skill 是带 frontmatter 块的 markdown，frontmatter 声明输入、输出、所需权限。由 mddock validate 校验。