数据页面目录 app/ 改名 .app/(带点目录,任务文件面板默认隐藏,files 路由本就以 ?hidden=1 才列点文件);对外 URL 保持 /app/{task_id}/ 不变——目录名与路由路径在 routes/data-page.js 解耦,访问地址/visit_url/FAB 深链全不受影响;run.py 目标目录/SKILL.md 契约(环境约定+流程+常见错误:目录带点 URL 不带点别写反)同步;线上会话目录 mv,顺手发现并收纳任务根下 4 个 23:28 的陈旧页面副本(无 FAB 版)进 .app/_stale 待用户确认清理
This commit is contained in:
@@ -1,6 +1,7 @@
|
|||||||
// data-page 技能的服务端承载,两条通道(配套 skills/data-page/SKILL.md 的契约):
|
// data-page 技能的服务端承载,两条通道(配套 skills/data-page/SKILL.md 的契约):
|
||||||
// 1. GET /app/{task_id}/... —— 静态托管任务目录的 app/ 子树(index.html 兜底,不给列目录);
|
// 1. GET /app/{task_id}/... —— 静态托管任务目录的 .app/ 子树(index.html 兑底,不给列目录);
|
||||||
// 只暴露 app/ 而非整个任务目录,其余任务文件不从 URL 泄漏。
|
// 目录名刻意带点:任务文件面板默认隐藏(?hidden=1 才列);
|
||||||
|
// 只暴露 .app/ 而非整个任务目录,其余任务文件不从 URL 泄漏。
|
||||||
// 2. POST /api/db/{task_id}/query —— 任务 data.db 的 SQL API(页面前端 fetch 调):任意单语句,
|
// 2. POST /api/db/{task_id}/query —— 任务 data.db 的 SQL API(页面前端 fetch 调):任意单语句,
|
||||||
// 执行核心与 db 工具共用 runTaskSql(executor.js),语义单一事实源。
|
// 执行核心与 db 工具共用 runTaskSql(executor.js),语义单一事实源。
|
||||||
// 认证:挂在 server.js 的 auth.middleware 之后——信任模型与 files 路由一致(登录 ≈ 运维,可跨会话)。
|
// 认证:挂在 server.js 的 auth.middleware 之后——信任模型与 files 路由一致(登录 ≈ 运维,可跨会话)。
|
||||||
@@ -22,17 +23,17 @@ function notFound(res, msg) {
|
|||||||
res.status(404).json({ error: msg });
|
res.status(404).json({ error: msg });
|
||||||
}
|
}
|
||||||
|
|
||||||
// ---------- /app/{task_id}/...:任务 app/ 子树静态托管 ----------
|
// ---------- /app/{task_id}/...:任务 .app/ 子树静态托管(URL 路径与目录名解耦)----------
|
||||||
router.use('/app', (req, res) => {
|
router.use('/app', (req, res) => {
|
||||||
try {
|
try {
|
||||||
const segs = req.path.replace(/^\/+/, '').split('/');
|
const segs = req.path.replace(/^\/+/, '').split('/');
|
||||||
const sessionId = segs[0];
|
const sessionId = segs[0];
|
||||||
if (!sessionId) return notFound(res, '会话不存在');
|
if (!sessionId) return notFound(res, '会话不存在');
|
||||||
if (!engine.getSession(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;
|
let abs;
|
||||||
try {
|
try {
|
||||||
abs = resolveInTask(appRoot, segs.slice(1).join('/') || 'index.html'); // 越界即挡,限 app/ 子树
|
abs = resolveInTask(appRoot, segs.slice(1).join('/') || 'index.html'); // 越界即挡,限 .app/ 子树
|
||||||
} catch (_) {
|
} catch (_) {
|
||||||
return notFound(res, '非法路径');
|
return notFound(res, '非法路径');
|
||||||
}
|
}
|
||||||
|
|||||||
+11
-11
@@ -1,6 +1,6 @@
|
|||||||
---
|
---
|
||||||
name: data-page
|
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}/
|
visit_url: /app/{task_id}/
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -22,16 +22,16 @@ visit_url: /app/{task_id}/
|
|||||||
每个会话有独立的任务目录:
|
每个会话有独立的任务目录:
|
||||||
|
|
||||||
- 数据库:任务目录下的 `data.db`
|
- 数据库:任务目录下的 `data.db`
|
||||||
- 页面目录:任务目录下的 `app/`
|
- 页面目录:任务目录下的 `.app/`(带点目录,任务文件面板默认隐藏;URL 路径与目录名在路由层解耦)
|
||||||
- 页面入口:`app/index.html`
|
- 页面入口:`.app/index.html`
|
||||||
- 访问地址:`/app/{task_id}/`(完整 URL = 站点地址 + 该路径;run 输出末尾的「访问地址」已拼好,直接转发)
|
- 访问地址:`/app/{task_id}/`(注意:URL 无点、目录有点,别写错路径;完整 URL = 站点地址 + 该路径,run 输出末尾的「访问地址」已拼好,直接转发)
|
||||||
- 数据 API:`/api/db/{task_id}/query`
|
- 数据 API:`/api/db/{task_id}/query`
|
||||||
|
|
||||||
`{task_id}` 是任务目录的名称。页面通过 URL 动态解析,不要硬编码。
|
`{task_id}` 是任务目录的名称。页面通过 URL 动态解析,不要硬编码。
|
||||||
|
|
||||||
## 初始化
|
## 初始化
|
||||||
|
|
||||||
生成页面前,调用 `skill(name="data-page", op="run")`(无需参数,模板固定复制到 `app/templates/`)。已存在则跳过,不会覆盖修改过的文件(重跑幂等)。
|
生成页面前,调用 `skill(name="data-page", op="run")`(无需参数,模板固定复制到 `.app/templates/`)。已存在则跳过,不会覆盖修改过的文件(重跑幂等)。
|
||||||
|
|
||||||
## 数据 API
|
## 数据 API
|
||||||
|
|
||||||
@@ -74,7 +74,7 @@ const taskId = location.pathname.split('/').filter(Boolean)[1];
|
|||||||
1. **明确数据结构**:与用户确认字段。如果描述模糊,可以建议合理的结构。
|
1. **明确数据结构**:与用户确认字段。如果描述模糊,可以建议合理的结构。
|
||||||
2. **创建表并录入数据**:用 `db` 工具完成。
|
2. **创建表并录入数据**:用 `db` 工具完成。
|
||||||
3. **初始化模板**:调用 `skill(name="data-page", op="run")`(无参数)。
|
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/...` 相对路径用户打不开;再简要说明页面功能。
|
5. **告知用户**:把 run 输出末尾「访问地址」那行的**完整 URL**(含域名)发给用户——只给 `/app/...` 相对路径用户打不开;再简要说明页面功能。
|
||||||
|
|
||||||
页面必须包含:
|
页面必须包含:
|
||||||
@@ -83,11 +83,11 @@ const taskId = location.pathname.split('/').filter(Boolean)[1];
|
|||||||
- 桌面优先、移动兼容的样式:容器宽度按页面类型给足(表格类 1200px、看板类 1400px 或不设、统计类 1080px),不要照搬 800px 级别的移动端尺寸
|
- 桌面优先、移动兼容的样式:容器宽度按页面类型给足(表格类 1200px、看板类 1400px 或不设、统计类 1080px),不要照搬 800px 级别的移动端尺寸
|
||||||
- 通过 `fetch` 调用数据 API
|
- 通过 `fetch` 调用数据 API
|
||||||
- 错误处理和加载状态
|
- 错误处理和加载状态
|
||||||
- **返回应用入口**:右下角 FAB(房子图标),`backToApp()` 跳主界面深链 `/?s=<task_id>`——数据页面的 task_id 就是会话 id,一点直达发起本页的对话;若未来 APK 提供 JS 桥,只需替换 `backToApp()` 一处。**每一个 `app/*.html` 页面(含 index.html)都要带**——用户可能从任意子页直入,缺出口即被困住
|
- **返回应用入口**:右下角 FAB(房子图标),`backToApp()` 跳主界面深链 `/?s=<task_id>`——数据页面的 task_id 就是会话 id,一点直达发起本页的对话;若未来 APK 提供 JS 桥,只需替换 `backToApp()` 一处。**每一个 `.app/*.html` 页面(含 index.html)都要带**——用户可能从任意子页直入,缺出口即被困住
|
||||||
|
|
||||||
## 模板
|
## 模板
|
||||||
|
|
||||||
模板位于 `app/templates/`。
|
模板位于 `.app/templates/`。
|
||||||
|
|
||||||
- **table.html**:标准表格,适合清单、列表。含排序、搜索、分页。
|
- **table.html**:标准表格,适合清单、列表。含排序、搜索、分页。
|
||||||
- **dashboard.html**:统计看板,顶部卡片 + 简单图表 + 明细表。
|
- **dashboard.html**:统计看板,顶部卡片 + 简单图表 + 明细表。
|
||||||
@@ -205,16 +205,16 @@ const taskId = location.pathname.split('/').filter(Boolean)[1];
|
|||||||
3. 没检查 `error` 字段 —— API 错误时仍返回 200
|
3. 没检查 `error` 字段 —— API 错误时仍返回 200
|
||||||
4. 表名或字段名拼错
|
4. 表名或字段名拼错
|
||||||
5. 引入 CDN 外部库 —— 容器可能无网络,优先纯原生
|
5. 引入 CDN 外部库 —— 容器可能无网络,优先纯原生
|
||||||
6. 页面文件不在 `app/` 下 —— 无法通过 `/app/{task_id}/` 访问
|
6. 页面文件不在 `.app/` 下 —— 无法通过 `/app/{task_id}/` 访问(目录带点、URL 不带点,两者别写反)
|
||||||
7. SQL 占位符与参数数量不匹配 —— 优先用结构化 insert,避免手写
|
7. SQL 占位符与参数数量不匹配 —— 优先用结构化 insert,避免手写
|
||||||
|
|
||||||
## 检查清单
|
## 检查清单
|
||||||
|
|
||||||
- [ ] 数据库表已创建
|
- [ ] 数据库表已创建
|
||||||
- [ ] 数据已录入
|
- [ ] 数据已录入
|
||||||
- [ ] `app/index.html` 已写入
|
- [ ] `.app/index.html` 已写入
|
||||||
- [ ] 页面动态解析 task_id
|
- [ ] 页面动态解析 task_id
|
||||||
- [ ] 包含错误处理和加载状态
|
- [ ] 包含错误处理和加载状态
|
||||||
- [ ] 用户输入渲染时已转义
|
- [ ] 用户输入渲染时已转义
|
||||||
- [ ] 每个 `app/*.html` 页面右下角都有「返回会话」FAB(backToApp → `/?s=<task_id>` 深链)
|
- [ ] 每个 `.app/*.html` 页面右下角都有「返回会话」FAB(backToApp → `/?s=<task_id>` 深链)
|
||||||
- [ ] 已告知用户完整访问 URL(run 输出「访问地址」那行,含域名,非相对路径)
|
- [ ] 已告知用户完整访问 URL(run 输出「访问地址」那行,含域名,非相对路径)
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
#!/usr/bin/env python3
|
#!/usr/bin/env python3
|
||||||
# data-page 技能入口:把技能自带 templates/*.html 复制到会话任务目录的 app/templates/。
|
# data-page 技能入口:把技能自带 templates/*.html 复制到会话任务目录的 .app/templates/。
|
||||||
# 目标目录固定(SKILL.md 环境约定:页面必须在 app/ 下才能被 /app/{task_id}/ 访问)。
|
# 目标目录固定(SKILL.md 环境约定:页面必须在 .app/ 下才能被 /app/{task_id}/ 访问;
|
||||||
|
# 带点是为了任务文件面板默认隐藏,URL 路径与目录名已在路由层解耦)。
|
||||||
# 不开 dest 参数:manager 对已是绝对路径的参数不做沙箱校验,开放 dest = 开放任意目录写入;
|
# 不开 dest 参数:manager 对已是绝对路径的参数不做沙箱校验,开放 dest = 开放任意目录写入;
|
||||||
# 且路径写死在文档流程里,可配置只会造成漂移。
|
# 且路径写死在文档流程里,可配置只会造成漂移。
|
||||||
# 已存在的同名文件跳过不覆盖(AI 改过的模板要能经受重跑);纯 stdlib,无 requirements。
|
# 已存在的同名文件跳过不覆盖(AI 改过的模板要能经受重跑);纯 stdlib,无 requirements。
|
||||||
@@ -20,7 +21,7 @@ def main():
|
|||||||
if not isinstance(args, dict):
|
if not isinstance(args, dict):
|
||||||
raise ValueError('input_args 必须是 JSON 对象')
|
raise ValueError('input_args 必须是 JSON 对象')
|
||||||
if args:
|
if args:
|
||||||
print('本技能无参数(模板固定复制到任务目录 app/templates/),收到:'
|
print('本技能无参数(模板固定复制到任务目录 .app/templates/),收到:'
|
||||||
+ json.dumps(args, ensure_ascii=False), file=sys.stderr)
|
+ json.dumps(args, ensure_ascii=False), file=sys.stderr)
|
||||||
return 1
|
return 1
|
||||||
except (ValueError, json.JSONDecodeError) as e:
|
except (ValueError, json.JSONDecodeError) as e:
|
||||||
@@ -37,7 +38,7 @@ def main():
|
|||||||
print('templates/ 下没有 .html 模板', file=sys.stderr)
|
print('templates/ 下没有 .html 模板', file=sys.stderr)
|
||||||
return 1
|
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):
|
if str(dest) == str(skill_dir) or str(dest).startswith(str(skill_dir) + os.sep):
|
||||||
print('当前工作目录不是会话任务目录(本地直跑 cwd=技能目录会污染技能;'
|
print('当前工作目录不是会话任务目录(本地直跑 cwd=技能目录会污染技能;'
|
||||||
'生产经 executor 运行天然正确,手动调试请 cd 到任务目录再跑)', file=sys.stderr)
|
'生产经 executor 运行天然正确,手动调试请 cd 到任务目录再跑)', file=sys.stderr)
|
||||||
|
|||||||
Reference in New Issue
Block a user