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:
john
2026-09-02 14:51:41 +08:00
parent 49758568bb
commit eb0c697c4e
4 changed files with 43 additions and 3 deletions
+3 -2
View File
@@ -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 80815173 仅 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),便于用户在「页面数据」面板排查
+2
View File
@@ -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 后面