Document local MindSpace delivery links and block production URLs in dev.
Agents must deliver public pages via Portal 8081 with /MindSpace/<userId>/public/ paths; forbid mindspace.tkmind.cn and bare 5173/public links during local development. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -275,6 +275,7 @@ await client.deleteRow('dataset_name', rowId);
|
||||
| **本地开发** | `http://127.0.0.1:8081/MindSpace/<用户ID>/public/xxx.html`(Page Data API 走 Portal 8081;5173 仅 UI 预览) |
|
||||
| **生产** | `https://m.tkmind.cn/MindSpace/<用户ID>/public/xxx.html` |
|
||||
|
||||
- **本地开发禁止**使用 `https://mindspace.tkmind.cn/...` 或 `https://m.tkmind.cn/...` 作为交付链接(即使用户在本机浏览器验收)。
|
||||
- **禁止**交付占位 host(如 `http://本地服务/...`);聊天展示层不得把 `127.0.0.1:8081` 替换成不可点击文字。
|
||||
- `/u/用户名/pages/...` 仅作补充,用户可见主链接必须是 MindSpace `/public/` 路径。
|
||||
- bind 会同步工作区 HTML 到发布快照,但禁止先发布占位内容再补文件。
|
||||
@@ -347,7 +348,7 @@ await client.deleteRow('dataset_name', rowId);
|
||||
4. 通过 Portal 打开 `deliveryUrl` 时,页面源码含 `__MINDSPACE_PAGE_DATA__`
|
||||
5. HTML 含 `page-data-client.js`;已 bind 或发布后平台会注入 pageId
|
||||
6. HTML **不含**硬编码 `127.0.0.1:` 作为 API 基址;不含 `/api/survey/`、`PLACEHOLDER_PAGE_ID`
|
||||
7. 本地交付链接使用 `http://127.0.0.1:8081/MindSpace/...`;生产使用 `https://m.tkmind.cn/MindSpace/...`;禁止 `http://本地服务/...`
|
||||
7. 本地交付链接使用 `http://127.0.0.1:8081/MindSpace/...`;生产使用 `https://m.tkmind.cn/MindSpace/...`;**本地禁止** `mindspace.tkmind.cn` / `m.tkmind.cn`;禁止 `http://本地服务/...`
|
||||
8. 向用户说明:访客如何提交、管理员如何用口令查看记录
|
||||
9. HTML 未调用 `softDeleteRows` / `deleteRows` 等客户端不存在的方法;删除使用 `deleteRow(dataset, rowId)`
|
||||
10. 若 bind 报 `quota_exceeded` 且 `overQuota: true`,停止交付并提示清理空间;grace 仅适用于「当次写完、尚未超配额」场景
|
||||
@@ -356,6 +357,6 @@ await client.deleteRow('dataset_name', rowId);
|
||||
|
||||
除数据能力外,优先返回 **deliveryUrl / workspaceUrl** 的 Markdown 链接 `[标题](完整URL)`,并简要说明后台入口与口令(如有)。
|
||||
|
||||
- 本地:`http://127.0.0.1:8081/MindSpace/<用户ID>/public/xxx.html`
|
||||
- 本地:`http://127.0.0.1:8081/MindSpace/<用户ID>/public/xxx.html`(**禁止** `https://mindspace.tkmind.cn/...`)
|
||||
- 生产:`https://m.tkmind.cn/MindSpace/<用户ID>/public/xxx.html`
|
||||
- 必须附带 bind 返回的 `pageId`(UUID),便于用户在「页面数据」面板排查
|
||||
|
||||
@@ -80,6 +80,8 @@ description: 在专属 MindSpace 目录生成可公开访问的静态 HTML 报
|
||||
- **本地开发(经 5173 UI 代理)**:`http://127.0.0.1:5173/MindSpace/<用户ID>/public/...`(5173 会把 `/MindSpace` 转发到 Portal;**不是** `5173/public/...`)
|
||||
- **生产**:`https://m.tkmind.cn/MindSpace/<用户ID>/public/...` 或环境配置的 `H5_PUBLIC_BASE_URL`
|
||||
- **禁止的错误交付链接(anti-pattern)**:
|
||||
- ❌ `https://mindspace.tkmind.cn/<用户ID>/public/xxx.html` — 生产域名;**本地开发禁止**(即使用户在本机验收)
|
||||
- ❌ `https://m.tkmind.cn/...` — 生产域名;本地 dev 禁止,除非用户明确要求「生产链接」
|
||||
- ❌ `http://127.0.0.1:5173/public/xxx.html` — 5173 是 Vite SPA,不托管工作区 `public/`,会回退 `index.html`
|
||||
- ❌ `http://127.0.0.1:8081/public/xxx.html` — 缺少 `/MindSpace/<用户ID>/`
|
||||
- ❌ 把磁盘路径 `public/xxx.html` 直接拼到任意 host 后面
|
||||
|
||||
Reference in New Issue
Block a user