From 8a9944a6225ee8c6735cc8378fe9584c1bb7cc4f Mon Sep 17 00:00:00 2001 From: kicer Date: Thu, 24 Sep 2026 00:02:13 +0800 Subject: [PATCH] =?UTF-8?q?=E6=95=B0=E6=8D=AE=E9=A1=B5=E9=9D=A2=E7=9B=AE?= =?UTF-8?q?=E5=BD=95=20app/=20=E6=94=B9=E5=90=8D=20.app/(=E5=B8=A6?= =?UTF-8?q?=E7=82=B9=E7=9B=AE=E5=BD=95,=E4=BB=BB=E5=8A=A1=E6=96=87?= =?UTF-8?q?=E4=BB=B6=E9=9D=A2=E6=9D=BF=E9=BB=98=E8=AE=A4=E9=9A=90=E8=97=8F?= =?UTF-8?q?,files=20=E8=B7=AF=E7=94=B1=E6=9C=AC=E5=B0=B1=E4=BB=A5=20=3Fhid?= =?UTF-8?q?den=3D1=20=E6=89=8D=E5=88=97=E7=82=B9=E6=96=87=E4=BB=B6);?= =?UTF-8?q?=E5=AF=B9=E5=A4=96=20URL=20=E4=BF=9D=E6=8C=81=20/app/{task=5Fid?= =?UTF-8?q?}/=20=E4=B8=8D=E5=8F=98=E2=80=94=E2=80=94=E7=9B=AE=E5=BD=95?= =?UTF-8?q?=E5=90=8D=E4=B8=8E=E8=B7=AF=E7=94=B1=E8=B7=AF=E5=BE=84=E5=9C=A8?= =?UTF-8?q?=20routes/data-page.js=20=E8=A7=A3=E8=80=A6,=E8=AE=BF=E9=97=AE?= =?UTF-8?q?=E5=9C=B0=E5=9D=80/visit=5Furl/FAB=20=E6=B7=B1=E9=93=BE?= =?UTF-8?q?=E5=85=A8=E4=B8=8D=E5=8F=97=E5=BD=B1=E5=93=8D;run.py=20?= =?UTF-8?q?=E7=9B=AE=E6=A0=87=E7=9B=AE=E5=BD=95/SKILL.md=20=E5=A5=91?= =?UTF-8?q?=E7=BA=A6(=E7=8E=AF=E5=A2=83=E7=BA=A6=E5=AE=9A+=E6=B5=81?= =?UTF-8?q?=E7=A8=8B+=E5=B8=B8=E8=A7=81=E9=94=99=E8=AF=AF:=E7=9B=AE?= =?UTF-8?q?=E5=BD=95=E5=B8=A6=E7=82=B9=20URL=20=E4=B8=8D=E5=B8=A6=E7=82=B9?= =?UTF-8?q?=E5=88=AB=E5=86=99=E5=8F=8D)=E5=90=8C=E6=AD=A5;=E7=BA=BF?= =?UTF-8?q?=E4=B8=8A=E4=BC=9A=E8=AF=9D=E7=9B=AE=E5=BD=95=20mv,=E9=A1=BA?= =?UTF-8?q?=E6=89=8B=E5=8F=91=E7=8E=B0=E5=B9=B6=E6=94=B6=E7=BA=B3=E4=BB=BB?= =?UTF-8?q?=E5=8A=A1=E6=A0=B9=E4=B8=8B=204=20=E4=B8=AA=2023:28=20=E7=9A=84?= =?UTF-8?q?=E9=99=88=E6=97=A7=E9=A1=B5=E9=9D=A2=E5=89=AF=E6=9C=AC(?= =?UTF-8?q?=E6=97=A0=20FAB=20=E7=89=88)=E8=BF=9B=20.app/=5Fstale=20?= =?UTF-8?q?=E5=BE=85=E7=94=A8=E6=88=B7=E7=A1=AE=E8=AE=A4=E6=B8=85=E7=90=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- app/server/routes/data-page.js | 11 ++++++----- skills/data-page/SKILL.md | 22 +++++++++++----------- skills/data-page/run.py | 9 +++++---- 3 files changed, 22 insertions(+), 20 deletions(-) diff --git a/app/server/routes/data-page.js b/app/server/routes/data-page.js index 5811e92..6ce873d 100644 --- a/app/server/routes/data-page.js +++ b/app/server/routes/data-page.js @@ -1,6 +1,7 @@ // data-page 技能的服务端承载,两条通道(配套 skills/data-page/SKILL.md 的契约): -// 1. GET /app/{task_id}/... —— 静态托管任务目录的 app/ 子树(index.html 兜底,不给列目录); -// 只暴露 app/ 而非整个任务目录,其余任务文件不从 URL 泄漏。 +// 1. GET /app/{task_id}/... —— 静态托管任务目录的 .app/ 子树(index.html 兑底,不给列目录); +// 目录名刻意带点:任务文件面板默认隐藏(?hidden=1 才列); +// 只暴露 .app/ 而非整个任务目录,其余任务文件不从 URL 泄漏。 // 2. POST /api/db/{task_id}/query —— 任务 data.db 的 SQL API(页面前端 fetch 调):任意单语句, // 执行核心与 db 工具共用 runTaskSql(executor.js),语义单一事实源。 // 认证:挂在 server.js 的 auth.middleware 之后——信任模型与 files 路由一致(登录 ≈ 运维,可跨会话)。 @@ -22,17 +23,17 @@ function notFound(res, msg) { res.status(404).json({ error: msg }); } -// ---------- /app/{task_id}/...:任务 app/ 子树静态托管 ---------- +// ---------- /app/{task_id}/...:任务 .app/ 子树静态托管(URL 路径与目录名解耦)---------- router.use('/app', (req, res) => { try { const segs = req.path.replace(/^\/+/, '').split('/'); const sessionId = segs[0]; if (!sessionId) return notFound(res, '会话不存在'); if (!engine.getSession(sessionId)) return notFound(res, '会话不存在'); - const appRoot = path.join(engine.taskDirOf(sessionId), 'app'); + const appRoot = path.join(engine.taskDirOf(sessionId), '.app'); let abs; try { - abs = resolveInTask(appRoot, segs.slice(1).join('/') || 'index.html'); // 越界即挡,限 app/ 子树 + abs = resolveInTask(appRoot, segs.slice(1).join('/') || 'index.html'); // 越界即挡,限 .app/ 子树 } catch (_) { return notFound(res, '非法路径'); } diff --git a/skills/data-page/SKILL.md b/skills/data-page/SKILL.md index 1105a37..ad8363d 100644 --- a/skills/data-page/SKILL.md +++ b/skills/data-page/SKILL.md @@ -1,6 +1,6 @@ --- name: data-page -description: 数据页面脚手架:把 table/dashboard/kanban 模板复制到任务目录 app/templates/,配合 db 工具产出 /app/{task_id}/ 可访问、经 /api/db/{task_id}/query 读写 data.db 的查看/管理页 +description: 数据页面脚手架:把 table/dashboard/kanban 模板复制到任务目录 .app/templates/,配合 db 工具产出 /app/{task_id}/ 可访问、经 /api/db/{task_id}/query 读写 data.db 的查看/管理页 visit_url: /app/{task_id}/ --- @@ -22,16 +22,16 @@ visit_url: /app/{task_id}/ 每个会话有独立的任务目录: - 数据库:任务目录下的 `data.db` -- 页面目录:任务目录下的 `app/` -- 页面入口:`app/index.html` -- 访问地址:`/app/{task_id}/`(完整 URL = 站点地址 + 该路径;run 输出末尾的「访问地址」已拼好,直接转发) +- 页面目录:任务目录下的 `.app/`(带点目录,任务文件面板默认隐藏;URL 路径与目录名在路由层解耦) +- 页面入口:`.app/index.html` +- 访问地址:`/app/{task_id}/`(注意:URL 无点、目录有点,别写错路径;完整 URL = 站点地址 + 该路径,run 输出末尾的「访问地址」已拼好,直接转发) - 数据 API:`/api/db/{task_id}/query` `{task_id}` 是任务目录的名称。页面通过 URL 动态解析,不要硬编码。 ## 初始化 -生成页面前,调用 `skill(name="data-page", op="run")`(无需参数,模板固定复制到 `app/templates/`)。已存在则跳过,不会覆盖修改过的文件(重跑幂等)。 +生成页面前,调用 `skill(name="data-page", op="run")`(无需参数,模板固定复制到 `.app/templates/`)。已存在则跳过,不会覆盖修改过的文件(重跑幂等)。 ## 数据 API @@ -74,7 +74,7 @@ const taskId = location.pathname.split('/').filter(Boolean)[1]; 1. **明确数据结构**:与用户确认字段。如果描述模糊,可以建议合理的结构。 2. **创建表并录入数据**:用 `db` 工具完成。 3. **初始化模板**:调用 `skill(name="data-page", op="run")`(无参数)。 -4. **生成页面**:从 `app/templates/` 选合适的模板,根据表结构调整字段和 SQL,写入 `app/index.html`。 +4. **生成页面**:从 `.app/templates/` 选合适的模板,根据表结构调整字段和 SQL,写入 `.app/index.html`。 5. **告知用户**:把 run 输出末尾「访问地址」那行的**完整 URL**(含域名)发给用户——只给 `/app/...` 相对路径用户打不开;再简要说明页面功能。 页面必须包含: @@ -83,11 +83,11 @@ const taskId = location.pathname.split('/').filter(Boolean)[1]; - 桌面优先、移动兼容的样式:容器宽度按页面类型给足(表格类 1200px、看板类 1400px 或不设、统计类 1080px),不要照搬 800px 级别的移动端尺寸 - 通过 `fetch` 调用数据 API - 错误处理和加载状态 -- **返回应用入口**:右下角 FAB(房子图标),`backToApp()` 跳主界面深链 `/?s=`——数据页面的 task_id 就是会话 id,一点直达发起本页的对话;若未来 APK 提供 JS 桥,只需替换 `backToApp()` 一处。**每一个 `app/*.html` 页面(含 index.html)都要带**——用户可能从任意子页直入,缺出口即被困住 +- **返回应用入口**:右下角 FAB(房子图标),`backToApp()` 跳主界面深链 `/?s=`——数据页面的 task_id 就是会话 id,一点直达发起本页的对话;若未来 APK 提供 JS 桥,只需替换 `backToApp()` 一处。**每一个 `.app/*.html` 页面(含 index.html)都要带**——用户可能从任意子页直入,缺出口即被困住 ## 模板 -模板位于 `app/templates/`。 +模板位于 `.app/templates/`。 - **table.html**:标准表格,适合清单、列表。含排序、搜索、分页。 - **dashboard.html**:统计看板,顶部卡片 + 简单图表 + 明细表。 @@ -205,16 +205,16 @@ const taskId = location.pathname.split('/').filter(Boolean)[1]; 3. 没检查 `error` 字段 —— API 错误时仍返回 200 4. 表名或字段名拼错 5. 引入 CDN 外部库 —— 容器可能无网络,优先纯原生 -6. 页面文件不在 `app/` 下 —— 无法通过 `/app/{task_id}/` 访问 +6. 页面文件不在 `.app/` 下 —— 无法通过 `/app/{task_id}/` 访问(目录带点、URL 不带点,两者别写反) 7. SQL 占位符与参数数量不匹配 —— 优先用结构化 insert,避免手写 ## 检查清单 - [ ] 数据库表已创建 - [ ] 数据已录入 -- [ ] `app/index.html` 已写入 +- [ ] `.app/index.html` 已写入 - [ ] 页面动态解析 task_id - [ ] 包含错误处理和加载状态 - [ ] 用户输入渲染时已转义 -- [ ] 每个 `app/*.html` 页面右下角都有「返回会话」FAB(backToApp → `/?s=` 深链) +- [ ] 每个 `.app/*.html` 页面右下角都有「返回会话」FAB(backToApp → `/?s=` 深链) - [ ] 已告知用户完整访问 URL(run 输出「访问地址」那行,含域名,非相对路径) diff --git a/skills/data-page/run.py b/skills/data-page/run.py index 5380cc1..fe8f115 100644 --- a/skills/data-page/run.py +++ b/skills/data-page/run.py @@ -1,6 +1,7 @@ #!/usr/bin/env python3 -# data-page 技能入口:把技能自带 templates/*.html 复制到会话任务目录的 app/templates/。 -# 目标目录固定(SKILL.md 环境约定:页面必须在 app/ 下才能被 /app/{task_id}/ 访问)。 +# data-page 技能入口:把技能自带 templates/*.html 复制到会话任务目录的 .app/templates/。 +# 目标目录固定(SKILL.md 环境约定:页面必须在 .app/ 下才能被 /app/{task_id}/ 访问; +# 带点是为了任务文件面板默认隐藏,URL 路径与目录名已在路由层解耦)。 # 不开 dest 参数:manager 对已是绝对路径的参数不做沙箱校验,开放 dest = 开放任意目录写入; # 且路径写死在文档流程里,可配置只会造成漂移。 # 已存在的同名文件跳过不覆盖(AI 改过的模板要能经受重跑);纯 stdlib,无 requirements。 @@ -20,7 +21,7 @@ def main(): if not isinstance(args, dict): raise ValueError('input_args 必须是 JSON 对象') if args: - print('本技能无参数(模板固定复制到任务目录 app/templates/),收到:' + print('本技能无参数(模板固定复制到任务目录 .app/templates/),收到:' + json.dumps(args, ensure_ascii=False), file=sys.stderr) return 1 except (ValueError, json.JSONDecodeError) as e: @@ -37,7 +38,7 @@ def main(): print('templates/ 下没有 .html 模板', file=sys.stderr) return 1 - dest = (Path.cwd() / 'app' / 'templates').resolve() + dest = (Path.cwd() / '.app' / 'templates').resolve() if str(dest) == str(skill_dir) or str(dest).startswith(str(skill_dir) + os.sep): print('当前工作目录不是会话任务目录(本地直跑 cwd=技能目录会污染技能;' '生产经 executor 运行天然正确,手动调试请 cd 到任务目录再跑)', file=sys.stderr)