From ab6740017480f1fb1c7dd1cb386870732149b4e1 Mon Sep 17 00:00:00 2001 From: kicer Date: Sat, 24 Oct 2026 07:46:13 +0800 Subject: [PATCH] =?UTF-8?q?=E6=8A=80=E8=83=BD=E9=A1=B5=E9=9D=A2=E6=94=B9?= =?UTF-8?q?=E7=94=A8=E7=AC=A6=E5=8F=B7=E9=93=BE=E6=8E=A5=E5=8F=91=E5=B8=83?= =?UTF-8?q?=EF=BC=8C=E4=B8=8D=E5=86=8D=E6=AF=8F=E4=BC=9A=E8=AF=9D=E5=A4=8D?= =?UTF-8?q?=E5=88=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit core 的 /app 静态托管已放行指向技能根目录的链接,两个技能改成链过去: - document-photo-to-pdf:.app/doc-review/index.html 链到 web/index.html,缩略图仍写实目录; - data-page:*.html 与 base.css 链到 templates/,config-*.js 仍是每会话实体文件。 旧会话里的实体副本会在下次发布时自动替换;模板改动从此对所有会话即时生效。 --- skills/data-page/SKILL.md | 4 +-- skills/data-page/run.py | 35 ++++++++++++++----- skills/document-photo-to-pdf/REVIEW.md | 9 ++--- .../doc_deskew/review_page.py | 31 ++++++++++++---- 4 files changed, 59 insertions(+), 20 deletions(-) diff --git a/skills/data-page/SKILL.md b/skills/data-page/SKILL.md index 72d3044..4486560 100644 --- a/skills/data-page/SKILL.md +++ b/skills/data-page/SKILL.md @@ -31,14 +31,14 @@ visit_url: /app/{task_id}/ ## 初始化 -调用 `skill {"op":"run","name":"data-page"}`,无需参数。它会把以下文件复制到 `.app/`: +调用 `skill {"op":"run","name":"data-page"}`,无需参数。它会把以下文件发布到 `.app/`: - `table.html` / `dashboard.html` / `kanban.html` —— 三个数据页模板 - `nav.html` —— 多页导航首页模板(静态卡片,无 config) - `base.css` —— 共用样式 - `config-table.js` / `config-dashboard.js` / `config-kanban.js` —— 配置骨架 -重跑行为按资产所有权分流:`table/dashboard/kanban/nav.html` 与 `base.css` 每次**覆盖刷新**(模板修复自动到达旧会话;这些文件契约禁止修改,覆盖无副作用);`config-*.js` 仅缺失时补默认骨架,不覆盖已写好的配置;`.app/index.html` 永不被碰。 +重跑行为按资产所有权分流:`table/dashboard/kanban/nav.html` 与 `base.css` 是指向技能的符号链接,技能更新立即生效(这些文件契约禁止修改);`config-*.js` 仅缺失时补默认骨架,不覆盖已写好的配置;`.app/index.html` 永不被碰。 ## 数据 API diff --git a/skills/data-page/run.py b/skills/data-page/run.py index 75f0a50..f29ea94 100644 --- a/skills/data-page/run.py +++ b/skills/data-page/run.py @@ -1,13 +1,13 @@ #!/usr/bin/env python3 -# data-page 技能入口:把技能自带 templates/ 下的文件复制到会话任务目录的 .app/。 +# data-page 技能入口:把技能自带 templates/ 下的文件发布到会话任务目录的 .app/。 # 目标目录固定为 <任务目录>/.app/(不带 dest 参数:manager 对绝对路径参数不做沙箱 # 校验,开放 dest 等于开放任意目录写入;路径也已写死在文档流程里,可配置只会造成漂移)。 -# 复制内容: -# *.html / base.css → .app/ 页面模板与共用样式(每次覆盖刷新) -# config-*.js → .app/ 配置骨架(仅缺失时补,AI 只改这些) -# 复制语义按资产所有权分流: -# *.html / *.css → .app/ 模板与共用样式——每次运行覆盖刷新(SKILL 契约禁止改这些文件, -# 覆盖无副作用;不覆盖则旧会话永远吃不到模板修复)。index.html 不在复制清单,永不碰。 +# 发布内容: +# *.html / base.css → .app/ 页面模板与共用样式(符号链接,技能是唯一真源) +# config-*.js → .app/ 配置骨架(实体文件,仅缺失时补,AI 只改这些) +# 发布语义按资产所有权分流: +# *.html / *.css → .app/ 模板与共用样式——技能只读,链接后永远是最新版本; +# SKILL 契约本来就禁止改这些文件,所以不必留副本。 # config-*.js → .app/ 配置骨架——仅缺失时补默认,不覆盖 AI 已写好的配置。 # 纯 stdlib,无 requirements。 # cwd 契约:生产模式下 cwd 即会话任务目录;本地直跑时 cwd 是技能目录—— @@ -19,6 +19,25 @@ import sys from pathlib import Path +def link_asset(src, dst): + """模板/样式是技能的只读资产:用符号链接发布,永远跟随技能最新版本。 + + core 的 /app 静态托管只放行指向技能根目录的链接(其余 404), + 所以这里必须链到技能的绝对路径。config-*.js 是每会话的数据,仍然复制。 + """ + src = str(Path(src).resolve()) + if dst.is_symlink(): + try: + if os.path.realpath(dst) == os.path.realpath(src): + return + except OSError: + pass + dst.unlink() + elif dst.exists(): + dst.unlink() # 旧会话的实体副本:删掉换成链接 + os.symlink(src, str(dst)) + + def main(): # ── 参数校验:本技能无参数 ───────────────────────────── if len(sys.argv) >= 2 and sys.argv[1].strip(): @@ -60,7 +79,7 @@ def main(): # ── 模板/样式:无条件覆盖刷新;config:仅补缺 ──────────── refreshed = [] for f in assets: - shutil.copy2(f, app_dir / f.name) + link_asset(f, app_dir / f.name) refreshed.append(f.name) created, kept = [], [] for f in cfgs: diff --git a/skills/document-photo-to-pdf/REVIEW.md b/skills/document-photo-to-pdf/REVIEW.md index a86eb77..0e753df 100644 --- a/skills/document-photo-to-pdf/REVIEW.md +++ b/skills/document-photo-to-pdf/REVIEW.md @@ -14,20 +14,21 @@ skills/document-photo-to-pdf/ run.py ← 入口 doc_deskew/ ← 检测/几何/出页/检验 review_store.py ← data.db 的 doc_review_* 表 - review_page.py ← 模板副本 + 缩略图发布 + review_page.py ← 模板链接 + 缩略图发布 web/index.html ← 审核页模板的单一事实源 tasks// .app/doc-review/ - index.html ← 每次发布覆盖的模板副本(不含数据注入) + index.html ← 指向 web/index.html 的符号链接(不含数据注入) /p1.jpg ... ← 本批缩略图(长边 1200,JPEG) data.db ← doc_review_batch / doc_review_page / doc_review_job .pdf .state.json ← state v2,供恢复自动/调试 ``` -core 只托管会话 `.app/`,不托管 skill 目录,所以模板必须复制一份到会话;源仍只有 -`web/index.html` 一份,副本不是第二份源码。 +core 只托管会话 `.app/`,不托管 skill 目录,所以会话里要有一个入口文件;用符号链接而不是 +副本——源仍只有 `web/index.html` 一份,改模板即刻对所有会话生效。`/app` 静态托管会 +realpath,只放行落在会话目录或技能根目录内的链接(其余 404,防止链接把 config.yml 带出来)。 ## 对 AI 隐藏的参数 diff --git a/skills/document-photo-to-pdf/doc_deskew/review_page.py b/skills/document-photo-to-pdf/doc_deskew/review_page.py index 4399bd6..f62cd57 100644 --- a/skills/document-photo-to-pdf/doc_deskew/review_page.py +++ b/skills/document-photo-to-pdf/doc_deskew/review_page.py @@ -1,10 +1,10 @@ # -*- coding: utf-8 -*- -"""审核页发布:模板副本 + 每批缩略图,落会话 .app/doc-review/。 +"""审核页发布:模板链接 + 每批缩略图,落会话 .app/doc-review/。 -模板的单一事实源在 skill 目录的 web/;会话里的 index.html 只是发布副本, -不含任何数据注入。页面运行时通过 /api/db 读 doc_review_* 表,因此同一份 -HTML 可服务所有批次。core 只托管会话 .app/,不托管 skill 目录,这是必须 -复制一次的原因(不是第二份源码)。 +模板的单一事实源在 skill 目录的 web/;会话里的 index.html 只是指向它的符号链接, +不含任何数据注入。core 的 /app 静态托管放行指向技能根目录的链接(其余位置 404), +所以改一次模板就对所有会话生效,不用重新生成。页面运行时通过 /api/db 读 doc_review_* +表,因此同一份 HTML 可服务所有批次。缩略图是每会话的数据,仍写真目录。 """ import os import shutil @@ -17,6 +17,25 @@ THUMB_LONG = 1200 THUMB_Q = 80 +def _link(src, dst): + """把技能里的静态文件以符号链接发布到会话目录。 + + 旧版本是复制副本,模板改动到不了已有会话;改链接后技能就是唯一真源。 + 链接目标用绝对路径:executor 与 core 都把技能挂在同一位置,两边都能解析。 + """ + src = os.path.abspath(src) + if os.path.islink(dst): + try: + if os.path.realpath(dst) == os.path.realpath(src): + return + except OSError: + pass + os.unlink(dst) + elif os.path.exists(dst): + os.unlink(dst) # 旧会话的实体副本:删掉换成链接 + os.symlink(src, dst) + + def publish(session_root, batch_id, pages): """发布模板与缩略图。 @@ -27,7 +46,7 @@ def publish(session_root, batch_id, pages): for name in sorted(os.listdir(WEB_DIR)): src = os.path.join(WEB_DIR, name) if os.path.isfile(src): - shutil.copy2(src, os.path.join(app_dir, name)) + _link(src, os.path.join(app_dir, name)) thumb_dir = os.path.join(app_dir, batch_id) os.makedirs(thumb_dir, exist_ok=True)