Compare commits
2
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ab67400174 | ||
|
|
13b493eada |
@@ -1,7 +1,9 @@
|
|||||||
// 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 兑底,不给列目录);
|
||||||
// 目录名刻意带点:任务文件面板默认隐藏(?hidden=1 才列);
|
// 目录名刻意带点:任务文件面板默认隐藏(?hidden=1 才列);
|
||||||
// 只暴露 .app/ 而非整个任务目录,其余任务文件不从 URL 泄漏。
|
// 只暴露 .app/ 而非整个任务目录,其余任务文件不从 URL 泄漏;
|
||||||
|
// 允许符号链接(技能页面链回技能目录,不必每会话复制),
|
||||||
|
// 但 realpath 必须落在会话目录或技能根目录内。
|
||||||
// 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 路由一致(登录 ≈ 运维,可跨会话)。
|
||||||
@@ -13,6 +15,7 @@ const fs = require('fs');
|
|||||||
const path = require('path');
|
const path = require('path');
|
||||||
const engine = require('../engine');
|
const engine = require('../engine');
|
||||||
const { resolveInTask, runTaskSql } = require('../tools/executor');
|
const { resolveInTask, runTaskSql } = require('../tools/executor');
|
||||||
|
const { skillsRoot } = require('../tools/skills');
|
||||||
|
|
||||||
// 页面忘写 LIMIT 的服务端兜底:iterate 到量即停(不全量物化),超限报错引导分页。
|
// 页面忘写 LIMIT 的服务端兜底:iterate 到量即停(不全量物化),超限报错引导分页。
|
||||||
const API_MAX_ROWS = 2000;
|
const API_MAX_ROWS = 2000;
|
||||||
@@ -23,6 +26,19 @@ function notFound(res, msg) {
|
|||||||
res.status(404).json({ error: msg });
|
res.status(404).json({ error: msg });
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// 符号链接白名单:技能页面不必每个会话复制一份,发布时链回技能目录(见各技能的 run.py)。
|
||||||
|
// 链接只是字符串:executor 里看不到的目标也能被链上,而解析发生在 core 的命名空间
|
||||||
|
// (例如 core 把 ./config.yml 挂在 /app/config.yml),所以 realpath 后必须落在
|
||||||
|
// 「本会话目录」或「技能根目录」内,其余一律 404。
|
||||||
|
function realInside(abs, roots) {
|
||||||
|
let real;
|
||||||
|
try { real = fs.realpathSync(abs); } catch (_) { return null; }
|
||||||
|
for (const root of roots) {
|
||||||
|
if (real === root || real.startsWith(root + path.sep)) return real;
|
||||||
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
// ---------- /app/{task_id}/...:任务 .app/ 子树静态托管(URL 路径与目录名解耦)----------
|
// ---------- /app/{task_id}/...:任务 .app/ 子树静态托管(URL 路径与目录名解耦)----------
|
||||||
router.use('/app', (req, res) => {
|
router.use('/app', (req, res) => {
|
||||||
try {
|
try {
|
||||||
@@ -44,7 +60,15 @@ router.use('/app', (req, res) => {
|
|||||||
try { st = fs.statSync(abs); } catch (_) { return notFound(res, '页面不存在'); }
|
try { st = fs.statSync(abs); } catch (_) { return notFound(res, '页面不存在'); }
|
||||||
}
|
}
|
||||||
if (!st.isFile()) return notFound(res, '页面不存在');
|
if (!st.isFile()) return notFound(res, '页面不存在');
|
||||||
res.sendFile(abs, err => {
|
const candidates = [engine.taskDirOf(sessionId)];
|
||||||
|
try { candidates.push(skillsRoot({ cfg: engine.getConfig() })); } catch (_) {}
|
||||||
|
const roots = [];
|
||||||
|
for (const dir of candidates) {
|
||||||
|
try { roots.push(fs.realpathSync(dir)); } catch (_) {}
|
||||||
|
}
|
||||||
|
const real = realInside(abs, roots);
|
||||||
|
if (!real) return notFound(res, '页面不存在');
|
||||||
|
res.sendFile(real, err => {
|
||||||
if (err && !res.headersSent) notFound(res, '页面不存在');
|
if (err && !res.headersSent) notFound(res, '页面不存在');
|
||||||
});
|
});
|
||||||
} catch (err) {
|
} catch (err) {
|
||||||
|
|||||||
@@ -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` —— 三个数据页模板
|
- `table.html` / `dashboard.html` / `kanban.html` —— 三个数据页模板
|
||||||
- `nav.html` —— 多页导航首页模板(静态卡片,无 config)
|
- `nav.html` —— 多页导航首页模板(静态卡片,无 config)
|
||||||
- `base.css` —— 共用样式
|
- `base.css` —— 共用样式
|
||||||
- `config-table.js` / `config-dashboard.js` / `config-kanban.js` —— 配置骨架
|
- `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
|
## 数据 API
|
||||||
|
|
||||||
|
|||||||
+27
-8
@@ -1,13 +1,13 @@
|
|||||||
#!/usr/bin/env python3
|
#!/usr/bin/env python3
|
||||||
# data-page 技能入口:把技能自带 templates/ 下的文件复制到会话任务目录的 .app/。
|
# data-page 技能入口:把技能自带 templates/ 下的文件发布到会话任务目录的 .app/。
|
||||||
# 目标目录固定为 <任务目录>/.app/(不带 dest 参数:manager 对绝对路径参数不做沙箱
|
# 目标目录固定为 <任务目录>/.app/(不带 dest 参数:manager 对绝对路径参数不做沙箱
|
||||||
# 校验,开放 dest 等于开放任意目录写入;路径也已写死在文档流程里,可配置只会造成漂移)。
|
# 校验,开放 dest 等于开放任意目录写入;路径也已写死在文档流程里,可配置只会造成漂移)。
|
||||||
# 复制内容:
|
# 发布内容:
|
||||||
# *.html / base.css → .app/ 页面模板与共用样式(每次覆盖刷新)
|
# *.html / base.css → .app/ 页面模板与共用样式(符号链接,技能是唯一真源)
|
||||||
# config-*.js → .app/ 配置骨架(仅缺失时补,AI 只改这些)
|
# config-*.js → .app/ 配置骨架(实体文件,仅缺失时补,AI 只改这些)
|
||||||
# 复制语义按资产所有权分流:
|
# 发布语义按资产所有权分流:
|
||||||
# *.html / *.css → .app/ 模板与共用样式——每次运行覆盖刷新(SKILL 契约禁止改这些文件,
|
# *.html / *.css → .app/ 模板与共用样式——技能只读,链接后永远是最新版本;
|
||||||
# 覆盖无副作用;不覆盖则旧会话永远吃不到模板修复)。index.html 不在复制清单,永不碰。
|
# SKILL 契约本来就禁止改这些文件,所以不必留副本。
|
||||||
# config-*.js → .app/ 配置骨架——仅缺失时补默认,不覆盖 AI 已写好的配置。
|
# config-*.js → .app/ 配置骨架——仅缺失时补默认,不覆盖 AI 已写好的配置。
|
||||||
# 纯 stdlib,无 requirements。
|
# 纯 stdlib,无 requirements。
|
||||||
# cwd 契约:生产模式下 cwd 即会话任务目录;本地直跑时 cwd 是技能目录——
|
# cwd 契约:生产模式下 cwd 即会话任务目录;本地直跑时 cwd 是技能目录——
|
||||||
@@ -19,6 +19,25 @@ import sys
|
|||||||
from pathlib import Path
|
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():
|
def main():
|
||||||
# ── 参数校验:本技能无参数 ─────────────────────────────
|
# ── 参数校验:本技能无参数 ─────────────────────────────
|
||||||
if len(sys.argv) >= 2 and sys.argv[1].strip():
|
if len(sys.argv) >= 2 and sys.argv[1].strip():
|
||||||
@@ -60,7 +79,7 @@ def main():
|
|||||||
# ── 模板/样式:无条件覆盖刷新;config:仅补缺 ────────────
|
# ── 模板/样式:无条件覆盖刷新;config:仅补缺 ────────────
|
||||||
refreshed = []
|
refreshed = []
|
||||||
for f in assets:
|
for f in assets:
|
||||||
shutil.copy2(f, app_dir / f.name)
|
link_asset(f, app_dir / f.name)
|
||||||
refreshed.append(f.name)
|
refreshed.append(f.name)
|
||||||
created, kept = [], []
|
created, kept = [], []
|
||||||
for f in cfgs:
|
for f in cfgs:
|
||||||
|
|||||||
@@ -14,20 +14,21 @@ skills/document-photo-to-pdf/
|
|||||||
run.py ← 入口
|
run.py ← 入口
|
||||||
doc_deskew/ ← 检测/几何/出页/检验
|
doc_deskew/ ← 检测/几何/出页/检验
|
||||||
review_store.py ← data.db 的 doc_review_* 表
|
review_store.py ← data.db 的 doc_review_* 表
|
||||||
review_page.py ← 模板副本 + 缩略图发布
|
review_page.py ← 模板链接 + 缩略图发布
|
||||||
web/index.html ← 审核页模板的单一事实源
|
web/index.html ← 审核页模板的单一事实源
|
||||||
|
|
||||||
tasks/<session-id>/
|
tasks/<session-id>/
|
||||||
.app/doc-review/
|
.app/doc-review/
|
||||||
index.html ← 每次发布覆盖的模板副本(不含数据注入)
|
index.html ← 指向 web/index.html 的符号链接(不含数据注入)
|
||||||
<batch_id>/p1.jpg ... ← 本批缩略图(长边 1200,JPEG)
|
<batch_id>/p1.jpg ... ← 本批缩略图(长边 1200,JPEG)
|
||||||
data.db ← doc_review_batch / doc_review_page / doc_review_job
|
data.db ← doc_review_batch / doc_review_page / doc_review_job
|
||||||
<output>.pdf
|
<output>.pdf
|
||||||
<output>.state.json ← state v2,供恢复自动/调试
|
<output>.state.json ← state v2,供恢复自动/调试
|
||||||
```
|
```
|
||||||
|
|
||||||
core 只托管会话 `.app/`,不托管 skill 目录,所以模板必须复制一份到会话;源仍只有
|
core 只托管会话 `.app/`,不托管 skill 目录,所以会话里要有一个入口文件;用符号链接而不是
|
||||||
`web/index.html` 一份,副本不是第二份源码。
|
副本——源仍只有 `web/index.html` 一份,改模板即刻对所有会话生效。`/app` 静态托管会
|
||||||
|
realpath,只放行落在会话目录或技能根目录内的链接(其余 404,防止链接把 config.yml 带出来)。
|
||||||
|
|
||||||
## 对 AI 隐藏的参数
|
## 对 AI 隐藏的参数
|
||||||
|
|
||||||
|
|||||||
@@ -1,10 +1,10 @@
|
|||||||
# -*- coding: utf-8 -*-
|
# -*- coding: utf-8 -*-
|
||||||
"""审核页发布:模板副本 + 每批缩略图,落会话 .app/doc-review/。
|
"""审核页发布:模板链接 + 每批缩略图,落会话 .app/doc-review/。
|
||||||
|
|
||||||
模板的单一事实源在 skill 目录的 web/;会话里的 index.html 只是发布副本,
|
模板的单一事实源在 skill 目录的 web/;会话里的 index.html 只是指向它的符号链接,
|
||||||
不含任何数据注入。页面运行时通过 /api/db 读 doc_review_* 表,因此同一份
|
不含任何数据注入。core 的 /app 静态托管放行指向技能根目录的链接(其余位置 404),
|
||||||
HTML 可服务所有批次。core 只托管会话 .app/,不托管 skill 目录,这是必须
|
所以改一次模板就对所有会话生效,不用重新生成。页面运行时通过 /api/db 读 doc_review_*
|
||||||
复制一次的原因(不是第二份源码)。
|
表,因此同一份 HTML 可服务所有批次。缩略图是每会话的数据,仍写真目录。
|
||||||
"""
|
"""
|
||||||
import os
|
import os
|
||||||
import shutil
|
import shutil
|
||||||
@@ -17,6 +17,25 @@ THUMB_LONG = 1200
|
|||||||
THUMB_Q = 80
|
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):
|
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)):
|
for name in sorted(os.listdir(WEB_DIR)):
|
||||||
src = os.path.join(WEB_DIR, name)
|
src = os.path.join(WEB_DIR, name)
|
||||||
if os.path.isfile(src):
|
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)
|
thumb_dir = os.path.join(app_dir, batch_id)
|
||||||
os.makedirs(thumb_dir, exist_ok=True)
|
os.makedirs(thumb_dir, exist_ok=True)
|
||||||
|
|||||||
Reference in New Issue
Block a user