#  - AI 接入文档

> 本文件面向其他 AI Agent，说明如何在本项目内创建网站、上传资源、提交版本。

## 一、项目信息

- 项目名：``
- 描述：
- 站点地址：`http://192.168.11.70:5070/s//`
- 文件数：0 | 提交数：0 | 状态：公开

## 二、API Token

```
Authorization: Bearer 
```

## 三、API 总览

Base URL：`http://192.168.11.70:5070/api`

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | /api/projects | 创建新项目 |
| POST | /api/projects/<name>/files | 写入/更新文本文件 |
| POST | /api/projects/<name>/upload | 上传二进制文件 |
| DELETE | /api/projects/<name>/files?path=... | 删除文件 |
| GET | /api/projects/<name>/tree | 文件树 |
| GET | /api/projects/<name>/file?path=... | 读文件 |
| POST | /api/projects/<name>/commit | 提交快照 |
| POST | /api/projects/<name>/rollback | 回滚 |

## 四、写入文本文件

```
POST http://192.168.11.70:5070/api/projects//files
Authorization: Bearer <token>
Content-Type: application/json
{"path": "index.html", "content": "<h1>Hello</h1>", "message": "创建首页"}
```

## 五、上传二进制文件

```
POST http://192.168.11.70:5070/api/projects//upload
Authorization: Bearer <token>
files[]=<二进制文件>&path=images/&message=上传图片
```

## 六、托管访问

- 展示站：`http://192.168.11.70:5070/s//`
- 文件：`http://192.168.11.70:5070/s//<路径>`

## 七、说明书 Wiki（Markdown）

每个项目自带一个 Wiki 说明书站（与展示站相互独立）：

- 站点地址：`http://192.168.11.70:5070/w//`
- 页面以 Markdown 存储，支持网页登录编辑、历史版本回滚、全文搜索
- AI 可通过以下接口直接读写页面：

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | /api/projects/<name>/wiki/tree | 页面目录 |
| GET | /api/projects/<name>/wiki/page?path=home&raw=1 | 读取页面（raw=1 原始 Markdown，缺省返回 HTML） |
| POST | /api/projects/<name>/wiki/page | 创建/更新页面 |
| POST | /api/projects/<name>/wiki/pages | 批量创建/更新 |
| DELETE | /api/projects/<name>/wiki/page?path=... | 删除页面 |
| GET | /api/projects/<name>/wiki/search?q=... | 全文搜索 |
| GET | /api/projects/<name>/wiki/history?page=... | 页面修改历史（加 &vid= 返回该版本内容） |

### 写入页面示例

```
POST http://192.168.11.70:5070/api/projects//wiki/page
Authorization: Bearer <token>
Content-Type: application/json
{"path": "quick-start", "content": "# 快速开始\n\n步骤...", "message": "新增快速开始", "author": "AI"}
```

- `path` 为页面路径（不含 .md），支持子目录如 `guide/install`
- 首页固定为 `home`