# Maidang

> 麦当的个人手册：作品集、博客，以及一个可通过 npx maidang 调用的命令行。只要一直 build 就有好事发生。

## 与 Agent 交互

机器可读的能力清单（推荐先读）：

- https://maidang.me/.well-known/ai-agent.json

CLI：

- `npx maidang` — 读取所有内容；任何命令加 `--json` 得到结构化输出。
- 子命令：whoami, manifest, posts, skills, projects, links, tools, contact

## 内容接口（只读，无需鉴权）

所有接口统一返回 `{ code, message, data }`，code 为 0 表示成功。

- GET  /api/posts    博客文章（可选 ?page=&pageSize=）
- GET  /api/changelog    已发布的产品更新
- GET  /api/skills   技能
- GET  /api/projects 项目
- GET  /api/links    链接
- POST /api/contact  给麦当留言（有 IP 限流）

## 说明

以上接口均为只读内容或表单提交，不暴露需要付费 token 的对话能力。