87 lines
2.5 KiB
Markdown
87 lines
2.5 KiB
Markdown
# 对象存储发布 URL 规范（全局）
|
||
|
||
Make 客户端「发布到对象存储」与脚本/Agent 批量发布**必须使用同一套公网路径**，避免维护两套链接。
|
||
|
||
配置来源：`.axhub/make/axhub.config.json` → `cloudPublishing.s3`
|
||
|
||
---
|
||
|
||
## 标准 URL 形态
|
||
|
||
```text
|
||
{baseUrl}/{objectPrefix}/index.html
|
||
```
|
||
|
||
| 项 | 默认值 | 示例 |
|
||
|---|---|---|
|
||
| `baseUrl` | `https://prototype.lnoneos.com` | — |
|
||
| 原型页 `objectPrefix` | `{prototype-id}` | `lease-business-detail` |
|
||
| 主题页 `objectPrefix` | `themes/{theme-id}` | `themes/claude` |
|
||
| 入口文件名 | **固定** `index.html` | 不得改为 `/`、`.html` 省略或 `index.htm` |
|
||
|
||
**租赁业务明细（范例）**
|
||
|
||
```text
|
||
https://prototype.lnoneos.com/lease-business-detail/index.html
|
||
```
|
||
|
||
---
|
||
|
||
## 禁止的改写
|
||
|
||
| ❌ 禁止 | 说明 |
|
||
|--------|------|
|
||
| 加 `prototypes/` 前缀 | 不得发布为 `/prototypes/lease-business-detail/index.html` |
|
||
| 去掉 `index.html` | 不得改为目录根 `/lease-business-detail/` |
|
||
| 改 `baseUrl` 域名 | 以 `axhub.config.json` 的 `s3.baseUrl` 为准 |
|
||
| 自造路径别名 | 仅 `pathAliases` 中已声明的 id 可例外 |
|
||
|
||
---
|
||
|
||
## pathAliases（例外）
|
||
|
||
仅在 `axhub.config.json` → `cloudPublishing.s3.pathAliases` 中显式配置时覆盖默认前缀，例如：
|
||
|
||
```json
|
||
"pathAliases": {
|
||
"oneos-prototype-nav": "oneos-prototype-nav"
|
||
}
|
||
```
|
||
|
||
新增别名须**同时**更新：
|
||
|
||
1. `axhub.config.json` → `pathAliases`
|
||
2. `src/prototypes/oneos-prototype-nav/nav-data.ts` → `CLOUD_PUBLISH_PATH_ALIASES`
|
||
3. `prototype-registry.json` 变更说明（如有）
|
||
|
||
---
|
||
|
||
## 实现对照
|
||
|
||
| 场景 | 路径解析 |
|
||
|------|----------|
|
||
| Make 客户端发布 | `/{prototype-id}/index.html` |
|
||
| `scripts/publish-all-to-s3.mjs` | `resolveObjectPrefix()` → 同上 |
|
||
| 导航页 `resolvePrototypeHref()` | 云主机上 `/{segment}/index.html` |
|
||
| 本地开发 | `/prototypes/{prototype-id}`（仅 dev，不是发布 URL） |
|
||
|
||
---
|
||
|
||
## Agent / AI 发布检查清单
|
||
|
||
发布或向用户回报链接前：
|
||
|
||
- [ ] 使用 `axhub.config.json` 中的 `baseUrl`
|
||
- [ ] 原型链接以 `/index.html` 结尾
|
||
- [ ] 未擅自添加 `prototypes/` 前缀
|
||
- [ ] 与 Make 工具弹窗中的 URL 逐字一致
|
||
- [ ] 未将 dev 路径（`/prototypes/...`）当作对象存储链接写入 PRD/导航
|
||
|
||
---
|
||
|
||
## 关联文件
|
||
|
||
- `scripts/publish-all-to-s3.mjs` — `resolveObjectPrefix`、`resolvePublicUrl`
|
||
- `src/prototypes/oneos-prototype-nav/nav-data.ts` — 静态站跳转
|
||
- `.cursor/rules/cloud-publish-url.mdc` — Agent 强制规则
|