SAFTOP-Manual - AI 接入文档

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

一、项目信息

项目名：SAFTOP-Manual
描述：SAFTOP IoT Platform Manual
站点地址：http://192.168.11.70:5070/s/SAFTOP-Manual/
文件数：1 | 提交数：1 | 状态：公开

二、API Token

Authorization: Bearer 1603a7aecc151c82164f168244a74cd2

三、API 总览

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

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

四、写入文本文件

POST http://192.168.11.70:5070/api/projects/SAFTOP-Manual/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/SAFTOP-Manual/upload
Authorization: Bearer <token>
files[]=<二进制文件>&path=images/&message=上传图片

六、托管访问

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

七、说明书 Wiki（Markdown）

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

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

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

写入页面示例

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

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