From a2c62717f3c3a14dc732a6298c1bdb65c05a47ca Mon Sep 17 00:00:00 2001 From: kicer Date: Thu, 24 Sep 2026 09:41:20 +0800 Subject: [PATCH] =?UTF-8?q?data-page=E9=87=8D=E6=9E=84=E8=AF=84=E5=AE=A1?= =?UTF-8?q?=E5=90=8E=E4=B8=A4=E9=A1=B9=E4=BF=AE=E8=A1=A5:=E2=91=A0?= =?UTF-8?q?=E8=87=AA=E5=AE=9A=E4=B9=89=E9=A1=B5=E9=9D=A2=E6=8A=A4=E6=A0=8F?= =?UTF-8?q?=E5=9B=9E=E5=A1=AB=E2=80=94=E2=80=94=E9=87=8D=E6=9E=84=E7=A0=8D?= =?UTF-8?q?=E6=8E=89=E7=9A=84=E6=97=A7=E7=89=88=E6=9C=80=E4=BD=B3=E5=AE=9E?= =?UTF-8?q?=E8=B7=B5=E6=81=B0=E6=98=AF=E6=89=8B=E5=86=99=E9=A1=B5=E6=9C=80?= =?UTF-8?q?=E9=9C=80=E8=A6=81=E7=9A=84=E5=BA=95=E7=BA=BF(=E9=AA=A8?= =?UTF-8?q?=E6=9E=B6=E4=B8=89=E4=BB=B6=E5=A5=97/=E7=94=A8=E6=88=B7?= =?UTF-8?q?=E6=95=B0=E6=8D=AE=E5=BF=85=E8=BD=AC=E4=B9=89=E4=BC=98=E5=85=88?= =?UTF-8?q?textContent=E3=80=81innerHTML=E5=85=88=E8=BF=87esc/SQL=E5=8F=82?= =?UTF-8?q?=E6=95=B0=E5=8C=96+=E6=9F=A5error=E5=AD=97=E6=AE=B5+=E5=8A=A0?= =?UTF-8?q?=E8=BD=BD=E9=94=99=E8=AF=AF=E6=80=81/=E5=A4=A7=E8=A1=A8LIMIT?= =?UTF-8?q?=E8=B6=852000=E8=A1=8C=E6=9C=8D=E5=8A=A1=E7=AB=AF=E6=8A=A5error?= =?UTF-8?q?),=E6=A8=A1=E6=9D=BF=E8=87=AA=E5=B8=A6=E8=BF=99=E5=B1=82?= =?UTF-8?q?=E4=BF=9D=E6=8A=A4=E3=80=81AI=E8=87=AA=E7=94=B1=E5=8F=91?= =?UTF-8?q?=E6=8C=A5=E7=9A=84custom.html=E6=B2=A1=E6=9C=89,SKILL.md?= =?UTF-8?q?=E8=A1=A5=E4=B8=BA=E7=A1=AC=E8=A6=81=E6=B1=825-8=E5=B9=B6?= =?UTF-8?q?=E6=8A=8A=E6=A3=80=E6=9F=A5=E6=B8=85=E5=8D=95=E6=89=A9=E6=88=90?= =?UTF-8?q?=E5=9B=9B=E9=A1=B9=E8=81=94=E5=8A=A8;=E2=91=A1dashboard=20count?= =?UTF-8?q?=E6=A8=A1=E5=BC=8F=E5=8E=BB=E9=87=8D=E5=A4=8D=E5=8D=A1=E2=80=94?= =?UTF-8?q?=E2=80=94metric=E4=B8=BAcount=E6=97=B6=E4=B8=8E=E5=9B=BA?= =?UTF-8?q?=E5=AE=9A=E3=80=8C=E6=80=BB=E6=9D=A1=E6=95=B0=E3=80=8D=E5=8D=A1?= =?UTF-8?q?=E5=90=8C=E5=80=BC,=E5=8F=AA=E6=B8=B2=E4=B8=A4=E5=BC=A0?= =?UTF-8?q?=E4=B8=94=E7=9C=81=E4=B8=80=E6=9D=A1=E5=86=97=E4=BD=99COUNT(*)?= =?UTF-8?q?=20SQL,metric=E6=9F=A5=E8=AF=A2=E6=8C=89isCount=E7=9F=AD?= =?UTF-8?q?=E8=B7=AF=E4=B8=BAnull(=E6=B8=B2=E6=9F=93=E5=88=86=E6=94=AF?= =?UTF-8?q?=E5=90=8C=E5=AE=88=E5=8D=AB);=E5=8F=A6=E8=AF=84=E5=AE=A1?= =?UTF-8?q?=E7=A1=AE=E8=AE=A4:=E6=A8=A1=E6=9D=BF/config/base.css=E4=B8=89?= =?UTF-8?q?=E5=B1=82=E8=81=8C=E8=B4=A3=E5=88=87=E5=88=86=E6=88=90=E7=AB=8B?= =?UTF-8?q?,=E7=B1=BB=E8=A6=86=E7=9B=96=E6=97=A0=E6=82=AC=E7=A9=BA,kanban-?= =?UTF-8?q?card=E6=94=B9=E5=90=8D=E6=8E=A5=E7=BA=BF=E4=B8=80=E8=87=B4,conf?= =?UTF-8?q?ig=E7=BC=BA=E5=A4=B1=E9=9D=99=E9=BB=98=E5=9B=9E=E9=80=80DEFAULT?= =?UTF-8?q?=E5=B1=9E=E5=8F=AF=E6=8E=A5=E5=8F=97=E9=99=8D=E7=BA=A7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- skills/data-page/SKILL.md | 195 +++++++----------- skills/data-page/run.py | 61 ++++-- skills/data-page/templates/base.css | 150 ++++++++++++++ .../data-page/templates/config-dashboard.js | 12 ++ skills/data-page/templates/config-kanban.js | 10 + skills/data-page/templates/config-table.js | 0 skills/data-page/templates/dashboard.html | 98 +++------ skills/data-page/templates/kanban.html | 75 ++----- skills/data-page/templates/table.html | 139 +++++-------- 9 files changed, 371 insertions(+), 369 deletions(-) create mode 100644 skills/data-page/templates/base.css create mode 100644 skills/data-page/templates/config-dashboard.js create mode 100644 skills/data-page/templates/config-kanban.js create mode 100644 skills/data-page/templates/config-table.js diff --git a/skills/data-page/SKILL.md b/skills/data-page/SKILL.md index ad8363d..56805a1 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/,配合 db 工具产出 /app/{task_id}/ 可访问、经 /api/db/{task_id}/query 读写 data.db 的查看/管理页 visit_url: /app/{task_id}/ --- @@ -24,14 +24,20 @@ visit_url: /app/{task_id}/ - 数据库:任务目录下的 `data.db` - 页面目录:任务目录下的 `.app/`(带点目录,任务文件面板默认隐藏;URL 路径与目录名在路由层解耦) - 页面入口:`.app/index.html` -- 访问地址:`/app/{task_id}/`(注意:URL 无点、目录有点,别写错路径;完整 URL = 站点地址 + 该路径,run 输出末尾的「访问地址」已拼好,直接转发) +- 访问地址:`/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/`: + +- `table.html` / `dashboard.html` / `kanban.html` —— 三个页面模板 +- `base.css` —— 共用样式 +- `config-table.js` / `config-dashboard.js` / `config-kanban.js` —— 配置骨架 + +已存在则跳过,不会覆盖(重跑幂等)。 ## 数据 API @@ -73,130 +79,77 @@ 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`。 -5. **告知用户**:把 run 输出末尾「访问地址」那行的**完整 URL**(含域名)发给用户——只给 `/app/...` 相对路径用户打不开;再简要说明页面功能。 +3. **初始化**:调用 `skill(name="data-page", op="run")`。 +4. **为每个要生成的页面写 config 文件**(见下一节)。**不要读也不要改模板本身**。 +5. **选定入口页**:把要作为首页的模板复制为 `.app/index.html`(同目录复制,引用路径不变),或直接保留多个页面并在 index.html 里做导航。 +6. **告知用户**:把 run 输出末尾「访问地址」那行的完整 URL 发给用户,再简要说明页面功能。 -页面必须包含: +默认只写 config 就够。模板无法覆盖需求时,才走自定义路径(见「自定义页面」一节)。 -- HTML 骨架(``、``、UTF-8) -- 桌面优先、移动兼容的样式:容器宽度按页面类型给足(表格类 1200px、看板类 1400px 或不设、统计类 1080px),不要照搬 800px 级别的移动端尺寸 -- 通过 `fetch` 调用数据 API -- 错误处理和加载状态 -- **返回应用入口**:右下角 FAB(房子图标),`backToApp()` 跳主界面深链 `/?s=`——数据页面的 task_id 就是会话 id,一点直达发起本页的对话;若未来 APK 提供 JS 桥,只需替换 `backToApp()` 一处。**每一个 `.app/*.html` 页面(含 index.html)都要带**——用户可能从任意子页直入,缺出口即被困住 +## 页面配置 -## 模板 +三个模板对应三份 config: -模板位于 `.app/templates/`。 +| 模板 | config 文件 | 用途 | +|---|---|---| +| `table.html` | `config-table.js` | 清单、列表、增删改 | +| `dashboard.html` | `config-dashboard.js` | 统计、汇总、明细 | +| `kanban.html` | `config-kanban.js` | 按字段分列,状态流转 | -- **table.html**:标准表格,适合清单、列表。含排序、搜索、分页。 -- **dashboard.html**:统计看板,顶部卡片 + 简单图表 + 明细表。 -- **kanban.html**:分组看板,按字段分列展示。 +每份 config 的结构: -优先使用模板。模板都不合适时才从零写。 - -## 最小示例 - -```html - - - - - - 采购清单 - - - -

采购清单

-
加载中…
- - - - +```javascript +window.PAGE_CONFIG = { + table: '表名', + pk: 'id', + title: '页面标题', + // ...字段见下 +}; ``` -## 最佳实践 +只写实际需要的字段,其余用模板默认值。 -**前端** +### config-table.js 字段 -- 用原生 JS + fetch,不引入框架 -- 样式用内联 `

数据看板

-
+

分布

-
+

明细

@@ -75,17 +27,19 @@ body { padding-bottom: calc(72px + env(safe-area-inset-bottom)); } +