skill工具op=run支持visit_url契约:front matter声明访问路径模板({task_id}占位),run成功后executor层拼public_link.base_url(与mint同源)在输出末尾追加完整「访问地址」行——技能进程在executor隔离视图里不知公网前缀,AI拿相对路径会原样转用户导致打不开;data-page落实:去dest参数(路径本就是文档固定的app/templates,且manager对绝对路径参数不设防,开放=开放任意写),run.py固定cwd相对+本地模式落技能目录即拒跑,SKILL.md流程与检查清单改为转发run输出的完整URL;README/ARCHITECTURE同步front matter字段

This commit is contained in:
2026-09-23 23:29:20 +08:00
parent 1addf0d95d
commit 5ede5cfd4e
5 changed files with 52 additions and 27 deletions
+6 -11
View File
@@ -1,12 +1,7 @@
---
name: data-page
description: 数据页面脚手架:把 table/dashboard/kanban 模板复制到任务目录 app/templates/,配合 db 工具产出 /app/{task_id}/ 可访问、经 /api/db/{task_id}/query 读写 data.db 的查看/管理页
input_schema:
type: object
properties:
dest:
type: string
description: 模板输出目录(相对会话任务目录,自动预转绝对路径;缺省 app/templates,已存在的文件跳过不覆盖)
visit_url: /app/{task_id}/
---
# data-page
@@ -29,14 +24,14 @@ input_schema:
- 数据库:任务目录下的 `data.db`
- 页面目录:任务目录下的 `app/`
- 页面入口:`app/index.html`
- 访问地址:`/app/{task_id}/`
- 访问地址:`/app/{task_id}/`(完整 URL = 站点地址 + 该路径;run 输出末尾的「访问地址」已拼好,直接转发)
- 数据 API:`/api/db/{task_id}/query`
`{task_id}` 是任务目录的名称。页面通过 URL 动态解析,不要硬编码。
## 初始化
生成页面前,调用 `skill(name="data-page", op="run", input_args={"dest": "app/templates"})` 复制模板到任务目录的 `app/templates/`。已存在则跳过,不会覆盖修改过的文件(重跑幂等)。
生成页面前,调用 `skill(name="data-page", op="run")`(无需参数,模板固定复制到 `app/templates/`)。已存在则跳过,不会覆盖修改过的文件(重跑幂等)。
## 数据 API
@@ -78,9 +73,9 @@ const taskId = location.pathname.split('/').filter(Boolean)[1];
1. **明确数据结构**:与用户确认字段。如果描述模糊,可以建议合理的结构。
2. **创建表并录入数据**:用 `db` 工具完成。
3. **初始化模板**:调用 `skill(name="data-page", op="run", input_args={"dest": "app/templates"})`。
3. **初始化模板**:调用 `skill(name="data-page", op="run")`(无参数)。
4. **生成页面**:从 `app/templates/` 选合适的模板,根据表结构调整字段和 SQL,写入 `app/index.html`。
5. **告知用户**:访问地址为 `/app/{task_id}/`,简要说明页面功能。
5. **告知用户**:把 run 输出末尾「访问地址」那行的**完整 URL**(含域名)发给用户——只给 `/app/...` 相对路径用户打不开;再简要说明页面功能。
页面必须包含:
@@ -218,4 +213,4 @@ const taskId = location.pathname.split('/').filter(Boolean)[1];
- [ ] 页面动态解析 task_id
- [ ] 包含错误处理和加载状态
- [ ] 用户输入渲染时已转义
- [ ] 已告知用户访问地址 `/app/{task_id}/`
- [ ] 已告知用户完整访问 URL(run 输出「访问地址」那行,含域名,非相对路径)
+20 -13
View File
@@ -1,6 +1,11 @@
#!/usr/bin/env python3
# data-page 技能入口:把技能自带 templates/*.html 复制到会话任务目录的 app/templates/。
# 目标目录固定(SKILL.md 环境约定:页面必须在 app/ 下才能被 /app/{task_id}/ 访问)。
# 不开 dest 参数:manager 对已是绝对路径的参数不做沙箱校验,开放 dest = 开放任意目录写入;
# 且路径写死在文档流程里,可配置只会造成漂移。
# 已存在的同名文件跳过不覆盖(AI 改过的模板要能经受重跑);纯 stdlib,无 requirements。
# cwd 契约:远端模式(生产)cwd 即会话任务目录;本地模式 cwd 是技能目录——
# 那会把模板抄进技能家,检测到直接报错拒跑(手动调试请 cd 到任务目录再运行)。
import json
import os
import shutil
@@ -9,13 +14,18 @@ from pathlib import Path
def main():
try:
args = json.loads(sys.argv[1]) if len(sys.argv) >= 2 and sys.argv[1].strip() else {}
if not isinstance(args, dict):
raise ValueError('input_args 必须是 JSON 对象')
except (ValueError, json.JSONDecodeError) as e:
print('参数解析失败:' + str(e), file=sys.stderr)
return 1
if len(sys.argv) >= 2 and sys.argv[1].strip():
try:
args = json.loads(sys.argv[1])
if not isinstance(args, dict):
raise ValueError('input_args 必须是 JSON 对象')
if args:
print('本技能无参数(模板固定复制到任务目录 app/templates/),收到:'
+ json.dumps(args, ensure_ascii=False), file=sys.stderr)
return 1
except (ValueError, json.JSONDecodeError) as e:
print('参数解析失败:' + str(e), file=sys.stderr)
return 1
skill_dir = Path(__file__).resolve().parent
src = skill_dir / 'templates'
@@ -27,13 +37,10 @@ def main():
print('templates/ 下没有 .html 模板', file=sys.stderr)
return 1
# dest 建议显式传入(key 含 "dest",skill manager 会按会话目录预转绝对路径)。
# 缺省退回 cwd:远端模式 cwd 即会话目录;若退到技能目录内则明确报错,避免污染技能。
dest = Path(args.get('dest') or os.path.join(os.getcwd(), 'app', 'templates'))
if not dest.is_absolute():
dest = dest.resolve()
dest = (Path.cwd() / 'app' / 'templates').resolve()
if str(dest) == str(skill_dir) or str(dest).startswith(str(skill_dir) + os.sep):
print('dest 必须落在会话任务目录(请传 input_args {"dest": "app/templates"})', file=sys.stderr)
print('当前工作目录不是会话任务目录(本地直跑 cwd=技能目录会污染技能;'
'生产经 executor 运行天然正确,手动调试请 cd 到任务目录再跑)', file=sys.stderr)
return 1
dest.mkdir(parents=True, exist_ok=True)