Commit Graph
69 Commits
Author SHA1 Message Date
kicer 25f9e157ad docs(skills): 排错清单统一成「报错 → 怎么办 → 命令」,office 改为建软链
技能目录的 AGENTS.md 只在报错时被读,所以只写「报错原文 → 怎么办 → 命令」,一节一个
现象,不写背景。命令块前统一声明「仅为示例,具体以本机平台实际情况为准」——路径分隔符、
可执行名、包管理器交给模型按本机情况自愈,不逐平台列出。

office:`command not found` 从按次拼 PATH 前缀改成建一次 $HOME/.local/bin/office 软链。
每条 terminal 命令都是新 shell,前缀不跨命令生效,按次拼的写法容易被反复踩。
image-process:PIL 缺包与「中文水印缺字体」拆成两节。
x2pdf:后端代价表压成三条列表,四个现象(ModuleNotFoundError / 没有可用排版能力 /
could not import some external libraries / 排版降级)各自成节。
document-photo-to-pdf:单节化,保留 fitz 是 pymupdf 的 import 名这条坑。
data-page 只用标准库,不需要 AGENTS.md。
2026-11-12 10:05:46 +08:00
kicer b3a0d5370c feat(local): 本地自建 office 预览网关,技能恢复服务器同源行为
- 新增 local/preview-gateway.js:零依赖复刻 executor :3100 的数据面(/preview 转发、SSE 与
  /api/* 按 Referer 认领槽位、4 槽 LRU + 闲置回收、缺二进制给安装页而不是无限转圈),
  不复刻 unshare/nsenter/mount 牢笼——本地没有沙箱,命令与 watch 本就同机同盘
- local/start.sh:选空闲端口起网关,经 PREVIEW_PROXIES 登记进 core 反代;端口写入
  .runtime/preview.port;local/stop.sh 兜底清理时一并收掉
- skills/office 回到 v2.5.0 行为:本地也发预览卡片、watch 族照旧隐藏,不再有 LOCAL 分支;
  binary missing 的报错改为指向技能自己的 AGENTS.md(平台中立)
- 网关按平台分支:进程回收(POSIX 进程组 / Windows taskkill /T)、二进制名(.exe、也认
  officecli-* 资产名)、POSIX 自动补 chmod +x;会话目录解析修正为读 {session:{work_dir}} 并限流
- 文档:docs/local-mode.md 补 4.15 与验证结果,local/README.md 补预览、日志与端口
2026-11-11 22:12:14 +08:00
kicer 77ef1ec11c feat(skills): office 本地放行 watch、x2pdf 加浏览器后端
office 封装层:本地直跑(AGENT_LOCAL_PICK)没有预览网关,不发 ui_card、
不 POST __pv-touch;watch/unwatch 与 mark/goto 族放行,watch 改后台拉起 +
等端口就绪后报地址退出(前台透传会卡到 terminal 超时)。

x2pdf:文本类分派改为 WeasyPrint → 无头浏览器 → LibreOffice,浏览器后端只需
装了 Chrome 系,不要求用户为转 PDF 现编 pango;CSS/base 注入到 head,无 @page 时
补 A4(浏览器默认 Letter)。吞掉 WeasyPrint 导入失败时裸 print 到 stdout 的告警。
对外文案只讲结果(排版降级/无可用排版能力),实现细节留在 AGENTS.md。
2026-11-11 20:50:18 +08:00
kicer 0234bc85e5 feat(local): 技能通用规则进提示词,移除 skills/AGENTS.md 中转
- env-local 加两条:长任务后台写日志+10 秒轮询;国内 pip/npm/GitHub/brew 换源
- 4 个技能 AGENTS.md 删掉指向根文档的指针行;pip 命令补 --upgrade
- document-photo-to-pdf:自检未能执行时单独给摘要,不再伪装成「建议确认」
- SKILL.md 示例去掉真实域名,改成 <站点地址>
- 删除 skills/AGENTS.md(根级中转文档,靠出错时翻文件拉不动)
2026-11-11 20:15:52 +08:00
kicer 24d7f023ba docs(skills): 网络清单去掉说明性文字,只留规则 2026-11-11 19:39:42 +08:00
kicer d03d8ba95b docs(skills): AGENTS.md 平台中立化,国内网络换源抽到技能根目录一份 2026-11-11 19:38:21 +08:00
kicer 0ec9aec93e docs(skills): README 与现状对齐——不写版本号、AGENTS.md 约定、image-process 依赖 2026-11-11 19:18:24 +08:00
kicer 5959b4a674 docs(skills): AGENTS.md 改成「现象 → 命令」排错清单
删掉服务器背景、agent-executor-init、SKILL.md 说明之类的旁白。只保留:
报什么错 → 敲什么命令。四份都在 20 行内。
2026-11-11 19:13:34 +08:00
kicer 4e1c1f36d0 refactor(skills): 本机环境说明改放技能目录的 AGENTS.md,启动器不再特判任何技能
上一版把安装说明写成 INSTALL.md 并在 SKILL.md 里加段落,两处都不对:SKILL.md 是用法说明,
不该塞安装内容;启动器为 office 单独注入 PATH 也不成立,再加技能就得逐条改 start.sh。

- 删除 4 个 INSTALL.md,改为各技能目录下的 AGENTS.md(只写命令:下载/安装/验证、
  平台资产名、字体路径),SKILL.md 恢复原样
- start.sh 去掉 office 的 PATH 注入;技能要命令入口时由 AGENTS.md 指导按次前缀
  (PATH="$SK/scripts:$PATH" office ...)。启动器只保留 AGENT_SKILLS_DEPS 这个路径变量
- 找不到依赖时的指路不放在 core 里做特征匹配,而是各自报错带自己 AGENTS.md 的绝对路径
  (office 封装层 ENOENT / x2pdf 缺包或无后端 / image-process 缺字体)
- env-local 提示词加一句:技能失败就读其目录下的 AGENTS.md

实测:无 PATH 时 office 报 command not found,按 AGENTS.md 加前缀后 --version 正常;
三条缺依赖报错均给出 AGENTS.md 绝对路径。
2026-11-11 19:12:01 +08:00
kicer a52b227d8b refactor(skills): 本地安装改成「README 式说明」,install.sh/requirements.txt 归服务器
按三条原则收紧:
1) 线上零影响:office/install.sh 回退成原来的 linux-only 版本(本地本来就不该跑它);
   image-process 的字体候选表撤回(那是在代码里写环境兼容,方向错了)。
2) install.sh / requirements.txt 只做服务器工件:镜像构建与 agent-executor-init 读它们,
   行为一字未变。
3) 本机缺东西时由 .md 指路,模型自己去装:四个技能各加 INSTALL.md(具体命令 + 平台
   资产/字体表 + 验证方式),并在 SKILL.md 里各加一行指向它(skill get 就能看到)。
   报错文案带上 INSTALL.md 的绝对路径,所以「撞到缺依赖」的那一刻就能拿到说明书。

保留的两处代码钩子都不是环境探测,而是「说明书里写的安装方式得真能生效」:
- office: start.sh 把 skills/office/scripts 塞进 PATH(本地没 root 写 /usr/local/bin);
  封装层 ENOENT 指向 INSTALL.md。
- x2pdf: find_soffice() 探 macOS app bundle(brew cask 装的 soffice 不在 PATH);
  WeasyPrint 不可用时回落 LibreOffice,让本地只需一个后端而不是 pango+WeasyPrint 两条链。

INSTALL.md 里 officecli 指向 releases/latest(它会自更新,实测 1.0.157 跑一次变 1.0.160),
不要求与服务器 pin 对齐。

实测:office --version / office create / office view outline 正常;x2pdf 缺 markdown 与
image-process 缺字体两条报错都给出 INSTALL.md 绝对路径,按 font 参数即通过。
2026-11-11 17:34:30 +08:00
kicer 317397154e feat(office): 本地可用——install.sh 跨平台取资产,PATH 直塞 scripts 目录
office 技能本体(SKILL.md + Node 封装层 + officecli 二进制)本来就是跨平台的,
坏在两处容器假设:install.sh 只认 linux-x64、PATH 入口只写 /usr/local/bin。

- install.sh: 按 uname -s/-m 选资产(linux x64/arm64、mac x64/arm64),校验和 pin 到
  上游 release 的 SHA256SUMS(八平台齐全,linux-x64 那行与原有 pin 完全一致);
  mac 没有 sha256sum,补 shasum -a 256 兜底;构建阶段判定提前到平台探测之前,
  避免构建机架构未被识别时中断镜像构建
- 已在且能跑就沿用:officecli 会自更新到上游 latest(实测 1.0.157 跑一次变 1.0.160,
  文件大小与 latest 资产一字节不差),用 pin 去比对只会反复重拉 34MB。服务器卷 :ro、
  二进制不会漂,正常仍走 sha 比对,行为不变
- local/start.sh: 起 core 时把 skills/office/scripts 塞进 PATH(服务器靠镜像里的
  /usr/local/bin 软链;本地没 root 写不了系统目录)。无需复制、无需改 app/
- 封装层 ENOENT 报错带上 install.sh 绝对路径,模型看到即可自行补装

本地实测(macOS x86_64):office create / view outline 正常;启动器不预下载,首次用到时
按报错跑一次 install.sh(GitHub 慢时自动换 gh-proxy,实测 27s)。
预览仍不可用(缺 executor 的 :3100 网关),已记入文档。
2026-11-11 17:31:04 +08:00
kicer 0f9cc241bb feat(image-process): 中文字体候选补 macOS/Windows 路径
原来只认 /usr/share/fonts 下的文泉驿与 Noto,本地端(mac/win)这些路径都不存在,
中文水印直接报「缺少字体」,而英文水印走 load_default 看不出问题。

只扩候选表:Linux 路径仍排前,服务端行为不变;mac 用 Hiragino Sans GB(索引 0 是简体
W3,PingFang.ttc 索引 0 是 HK 字形,Songti 是 Black,依次作为次选),Windows 用雅黑/宋体。
报错文案改成平台中立(传 font 参数指定 TTF/TTC)。

本机实测 info/convert/resize/watermark(en)/slice/grid 均正常,中文水印补装后出图。
2026-11-11 17:23:28 +08:00
kicer 69e44c27ae feat(x2pdf): 本地可用——LibreOffice 探测覆盖 mac/win 路径,WeasyPrint 缺失时回落
本地形态原先 docx/xlsx/pptx 必失败,原因不是没装 LibreOffice,而是它的可执行文件
不在 PATH 里(macOS 在 app bundle 内、Windows 在 Program Files 内,正常安装都如此),
只用 shutil.which() 会把「装了」误判成「没装」。

- find_soffice(): PATH → macOS 两个 app bundle → Windows 两个默认目录
- 文本分支:WeasyPrint 不可用(ImportError 或缺 libpango 的 OSError)时回落 LibreOffice,
  先把文档写成临时 HTML 再走同一个转换函数;返回值带一行后端提示,说明 @page/CSS 只部分生效
- 缺 markdown 包时报错点明依赖清单路径,交给模型按 requirements 自行补装
- requirements.txt:markdown 去掉版本 pin(3.x API 稳定,pin 了反而会在服务端 init
  探测失败时往 skills/deps 塞一份遮蔽系统包);weasyprint==65.1 保留,那个 pin 编码的是
  pydyf 兼容约束

线上不变:WeasyPrint 在 → 主路径照旧;仅多了一次 fallback 与更宽的 soffice 探测。
本机实测:html/txt 走回落出件正常,md 在缺 markdown 时给出可执行报错。
2026-11-11 17:20:45 +08:00
kicer 8764fedabc feat(local): 声明技能 Python 依赖,并放开「缺包自装进 skills/deps」
本地没有 agent-executor-init,技能的 requirements.txt 从来没人读:
document-photo-to-pdf(numpy/Pillow/pymupdf)与 image-process(Pillow)
在本机只是碰巧用户的 python 里已经装了。

- 两个技能补 requirements.txt,一律不写版本号:服务端 init 用
  pip install --no-index --dry-run 探测,pin 到与镜像不同的版本会让探测失败,
  反而往 skills/deps 装一份旧的(PYTHONPATH 优先级高于系统 site-packages)
- start.sh 起 core 时注入 AGENT_SKILLS_DEPS(该目录本来就在 PYTHONPATH 里),
  把路径交给模型;terminal 与技能子进程都继承 core 的 env,装完下次运行即生效
- env-local.txt 把「永远不要自己装任何东西」换成「缺包时 --target 装进共享依赖层,
  别动系统 Python」。用 --target 是因为 pip 对它的 PEP 668 拦截明确豁免,
  Homebrew 那种 externally-managed 解释器也能装
- 文档同步:local/README 已知限制、docs/local-mode.md 新增 4.13 记录取舍

服务端不受影响:这三行在 executor 镜像里都已满足(实测 --no-index --dry-run
均 exit 0),init 只写一个 gitignore 里的 .deps_installed 就跳过。
2026-11-11 16:59:28 +08:00
kicer dca4e6be70 优化document-photo-to-pdf技能 2026-10-24 23:17:33 +08:00
kicer 516b4a5d86 fix issues 2026-10-24 09:59:48 +08:00
kicer e39273e97f feat(document-photo-to-pdf): raw PNG 页图导出到 out/,PDF 从 raw 派生
出件改为一次透视:PIL 按四边形自然尺寸 warp 出 raw 页图(只裁剪+拉正,不调色、不缩放、无白边),直接写 out/<PDF 主名>-NN.png;PDF 页再由 raw 调色 + LANCZOS 缩到画布内容区派生。相比「PDF 目标尺寸一次 + raw 自然尺寸一次」少一次 warp,10MP 自然尺寸从 numpy 的 3.0s/页降到 PIL 的 0.3s/页。

不新增输入参数:每次运行 PDF 与 PNG 全出,AI 不需要判断格式;SKILL.md 只补 out/ 说明、images 返回字段,以及 description 里的产出(PDF + out/ 下的 PNG 原图)。

页序先定后渲染,PNG 编号跟最终 PDF 页序;PDF 落盘成功后才清理同前缀的多余编号(失败保留上一份),不碰 out/ 里其它文件。numpy warp 与旧 warp_page 保留作回退路径。

真实样张(task-20261021-004,3 页)A/B:state.json 完全一致;PDF 逐页平均差 0.7 / 0.7 / 1.2 灰度级;raw PNG 与 numpy 自然尺寸 warp 平均差 0.02;3 页端到端 4.8s,PNG 0.58/0.69/0.90MB。注:doc_deskew/smoke_test.py 自 fe1c6d1 起未同步返回契约,属既有问题,本次未改。
2026-10-24 09:54:37 +08:00
kicer 8b8fbddb4f refactor(prompt): 精简默认提示词、强化技能优先,校正两个图像技能描述
profile-default.txt 109 行 → 74 行(5.6KB → 3.4KB)。删除 in-scope 能力枚举(与工具/技能清单重复且会随新 MCP 过期)、通用建议与三处重复表述;保留反造假护栏、能力判断规则、mint_public_link 机密禁令,环境事实逐条与 executor 镜像核对后保留。

新增 ## Skill Use 紧贴技能清单:写脚本/装包前先查技能,首次运行前 get 一次接口、同会话不重复 get。规则覆盖全部技能,required 降级为「该域不要手写等价实现」,不必给所有技能加 required。能力判断顺序改为先查技能再考虑工具组合。

两个图像技能描述改为自足表述、互不引用:document-photo-to-pdf 补纸质文档触发词,image-process 明确普通图片/截图。skills/README.md 补 required 字段说明。
2026-10-24 09:21:54 +08:00
kicer 43e77e569e 审核页加载失败时保留可用的返回按钮
- #back / #pdf 的绑定从 boot() 移到 start():boot 只在加载成功后执行,
  空状态下 X 之前是死的,点了没反应。
- 加载失败时给 body 加 is-empty,隐藏工具栏/底栏/预览区,只留白色标题条。
- data.db 缺 doc_review_batch 表时改成人话提示,不再直接抛 SQLite 错误。
2026-10-24 08:43:57 +08:00
kicer ab67400174 技能页面改用符号链接发布,不再每会话复制
core 的 /app 静态托管已放行指向技能根目录的链接,两个技能改成链过去:
- document-photo-to-pdf:.app/doc-review/index.html 链到 web/index.html,缩略图仍写实目录;
- data-page:*.html 与 base.css 链到 templates/,config-*.js 仍是每会话实体文件。
旧会话里的实体副本会在下次发布时自动替换;模板改动从此对所有会话即时生效。
2026-10-24 07:46:13 +08:00
kicer 7fc945a4c8 修复桌面端预览不显示,翻页按钮移到图片两侧
- 桌面媒体查询漏了 #prevwrap 的 display:flex,右栏一直是空网格;补上后左裁切、右预览常显。
- 上一页/下一页从顶栏移入裁切区,桌面端浮在图片左右两侧(48px 圆形),
  移动端仍走滑动 + 底栏箭头。
- 同步 REVIEW.md 的桌面/移动端交互约定。
2026-10-24 01:18:59 +08:00
kicer fbe78d362f 完善文档审核页:模式标签、签名下载、自检产物清理
- 顶栏操作按钮在移动端带文字(切换/旋转/重置/设置),视图按钮固定叫「切换」;
  图片左上角常驻当前模式(手动定位/校正预览),右上角浮页码 1/n,不再占顶栏。
- 下载改走 files/download-token 的签名直链:APK/系统下载器不携带 cookie,
  原先直连 /files/download 会 401 且只能落成 download.pdf。
- 全局设置去掉「N 页已生成」摘要行,右上角加关闭 X;底部保留完成按钮。
- 重新生成 PDF 仅在有未保存修改时出现,成功后消失;新增左右滑动翻页。
- 自检渲染图(.tmp/pdfcheck 下的 PPM)在 inspect_pdf 结束时删除,不再残留在会话目录。
2026-10-24 01:12:44 +08:00
kicer fe1c6d106f 收敛 document-photo-to-pdf 的 AI 契约:默认审核页、精简返回值
SKILL.md 只保留 images/output;默认 review=always;stdout 只回 ok/summary/pdf,完整审核地址由 visit_url 追加;内部协议移到 REVIEW.md;审核页补充警告/状态展示,手机默认进预览。
2026-10-23 23:44:58 +08:00
kicer a86b748a6f 重构 document-photo-to-pdf:审核页改为 data.db 驱动并支持一键重生成
run.py 接上 edits/enhance/dpi/status/review,并把运行记录写进会话 data.db;审核页模板移到 skill/web,运行时发布到 .app/doc-review/,页面通过 /api/db 水合并调用通用技能执行接口重生成;移除 make_review.py 与模板注入。
2026-10-23 23:15:52 +08:00
kicer deb622095f 自动识别边框 2026-10-22 22:11:33 +08:00
kicer 09cf474c2d 加入照片转pdf功能支持 2026-10-22 09:54:39 +08:00
kicer 29e46692fc fix(skill): 参数改回 op/name/args 的扁平结构,压缩描述并修正调用示例 2026-10-21 20:53:33 +08:00
kicer 69a1ee0bdf refactor(skills): img-utils 改名 image-process;office 标记 required
- image-process:原名 img-utils 的 "utils" 没有边界,且和 image_task(AI 生成)
  只差一个语义,容易让模型把确定性处理当成生成能力。目录名即技能名
  (listSkills 取 e.name、skillDir 按名解析),同步 SKILL.md、run.py 注释与
  skills/README.md 的两处引用。
- office:加 required: true,避免模型绕过技能自己拼 libreoffice 命令。
2026-10-21 17:22:07 +08:00
kicer 955e550b29 feat(mcp): 增加 mode=skill,把 MCP 工具以技能形式暴露
mode 三态改为 advertise / skill / disable:
- skill 不下发到 tools 数组,由 skill 工具的 list/get/run 暴露
- get 返回 MCP 原始的 description + input_schema;run 直接转发,不做路径改写与 required 预检
- 移除 mode: silent(不设专门迁移文案)与 front matter mcp_tool 包装
- 删除 skills/image、skills/video,改由 image_task / video_task 的 mode: skill 提供
- 技能清单改用 listCallableSkills(目录 + MCP,同名时目录胜出);设置页仍只列目录
- init.sh 配了 BIGMODEL_KEY 时给 image_task / video_task 写 mode: skill
- image_task / video_task 的 tool description 首行改为自解释的一句话(技能清单取首行)
2026-10-21 11:01:50 +08:00
kicer 76a0e9ad86 refactor(skill): 参数改为动词作键,去掉 op/name/input_args
形状:{"list":"all"} / {"get":"<名>"} / {"run":"<名>","args":{...}},三者恰好给一个。
- 互斥无法用 required 表达,校验与报错回显放在 toolSkill
- list 取值是字符串范围而非布尔,为将来的技能分类留扩展位;今天只认 all
- list/get 带非空 args 一律报错,不静默丢弃
- 旧形状 {op,name,input_args} 仍由 toolSkill 兜底翻译,只为兼容存量技能文档,不再对外文档化
- README/AGENTS/skills 文档与内置技能调用示例同步为新形态
2026-10-21 09:25:25 +08:00
kicer 767caa8574 feat(skills): 技能支持 MCP 后端(front matter mcp_tool)
SKILL.md 声明 mcp_tool 时,op=run 不落 executor 沙箱,由 core 直接 mcp.callTool
转发:凭证留在 core(沙箱的 env 白名单本就会丢掉 *KEY/*TOKEN),模型只看到技能清单
里的一行描述。配合 mcp_servers[].mode: silent,工具不再进每轮请求的 tools 数组。

- skills.js: runSkill 在 absolutizeArgs 之前分流(否则 URL / 含斜杠的 prompt 会被
  当路径改写);不做 input_schema.required 预检(参数与 op 相关,交给 MCP 服务)
- listSkills 带出 mcp_tool;设置页技能卡显示 mcp 后端徽章
- server.js: 启动期自检,缺失后端 warn、两条路并存 info
- 新增 skills/image、skills/video 两个纯文档技能(无 run.py)
- skills/README、README、app/AGENTS 同步
2026-10-21 09:08:57 +08:00
kicer a911ff2fe9 修复officecli预览的问题 2026-10-19 20:04:32 +08:00
kicer 5f4b3ec28b officecli 迁入技能层:skills/office 封装 + executor 预览托管,双盘同步整条退役
- skills/office:SKILL.md + scripts/office 封装层(命令闸门/help 对齐/get-pos 语义糖/create、open 出 ui_card
  marker);install.sh 按技能双跑约定把二进制拉到技能卷 bin/(不进 git/不进镜像,GitHub→gh-proxy 备源)
- executor/preview.js:预览槽位+网关(原 mcp 侧 watch/gateway 移植),工作区=tasks 卷真实文件,
  /__session-kill 供 core 清槽;Dockerfile 零 officecli 痕迹,入口符号链接进 /usr/local/bin/office
- core:preview-proxy 默认上游改 agent-executor:3100;tools/executor.js 通用 drainUiCards(terminal 输出
  ::ui_card 标记行 → 剥离 + ctx.onCard,任意命令可产卡);engine 删会话改走 rexec.killPreviewSession
- compose:agent-executor expose 3100(只走内网);.gitignore 排除技能二进制
2026-10-19 11:30:12 +08:00
kicer 9d8049a80a remove sheet skill 2026-10-18 23:34:52 +08:00
kicer 81025a7929 优化skills的提示 2026-09-29 17:09:01 +08:00
kicer 37d8c356a0 sheet-edit 更名 sheet 并扩语义为「读+安全修改」:① 目录/frontmatter/文档全部改名(引用面零残留);description 重写为路由优先——列全格式 xls/xlsx/csv/ods、inspect 读结构与定位、apply/cells 最小改动、自带四重保障、明确「不用于新建工作簿」。命名讨论定稿:弃 excel/xlsx(名字越强,「帮我生成个excel」的误召唤越难用描述压住),sheet 中性、召回靠 description 行补足。② set/cells 的 old 改为可选:省略=断言目标格为空再写入(填空/补列/给插入行补公式的正经出口),非空拒写并报当前值;改已有值必须给 old——保障链不变,只是把「写新内容」纳入技能,杜绝 AI 为此绕道手改。③ skills.js 落地 required 机制:frontmatter required:true → prompt 列表行首标 **required**,用户在 system-prompt 模板写的「Skills marked **required** must be used」条款自此有了作用对象(sheet 首个标记);此前该条款空转。④ 重启验证:skills=data-page,img-utils,sheet,x2pdf,prompt 快照含 **required** sheet 且零 sheet-edit 残留;容器 8 项功能回归全过 2026-09-28 11:24:42 +08:00
kicer d759c6cde3 sheet-edit 多级表头审计修复(上轮讨论定稿的「立即做」批次):① locate.detect_multi_level 识别「分组行+重复子列名行」相邻形态,inspect 每 sheet 返回 multi_level_header——AI 第一轮即可判型,不再烧两轮试错;build_col_map 重复列名报错、_resolve_change 命中分组行时报错,文案一律直指 change.cells 出口(审计指正:这类表任何 header_row 都无解,此前建议修正 suggest 行号其实救不了,改口径为「检测并拒得明白」)。② apply 新增 cells 地址模式({sheet, cells:{D4:{old,new}}},与 match+set 互斥,允许可选 $)——多级表头从「不支持」降级为「坐标多确认一步」,old 校验/合并区防护/全簿逐格自检/LO 重算与列名模式完全同源,真正封死「terminal 裸改交付物」的危险兜底动机。③ header_row 支持 change 级覆盖(多 sheet 表头位置不一的隐患提前拆掉)。④ SKILL.md:工作流程/返回字段/cells 小节/硬约束加「禁止绕开技能手改」/边界与常见错误同步;清理 MergedCell 死 import。事故同款结构(大标题+合并分组+重复子列)16 项容器实测全过,含 old 校验拒绝无产物、非法地址、per-change 混单、插删链与 CSV 防回归 2026-09-28 10:58:59 +08:00
kicer 1449f4c513 修复 sheet-edit output 参数必死 bug(线上首炸复盘):上一轮加的「output 只能是文件名」消毒与 skills.js 平台路径预处理冲突——absolutizeValue 对 out|dest|target|save 类键自动按会话目录解析成绝对路径(本意是让技能脚本对路径无感知),结果 run.py 收到的永远是绝对路径、含 / 一律被拒,裸文件名 output 变成传啥都报错。改为:绝对路径原样接受(防越权本来就该由执行容器的会话隔离担责,文件名层面防不住),相对名维持同目录语义(直调 run.py 兼容),仅拒 '.'/'..';SKILL.md output 说明同步。实测复刻线上入参(.xls+预处理绝对路径)通过 2026-09-28 10:40:40 +08:00
kicer afea58fe17 sheet-edit 公式自动重算(评审确认版):写操作产物交付前经 LibreOffice 同格式转换强制求值写回缓存——openpyxl 产物无缓存、LO 保存必须求值,实测重算必达且公式文本保留,产物可直接进预览/转PDF/data_only 读取,不再依赖用户手动打开;_libreoffice 全链路加 -env:UserInstallation 隔离 profile(实测无隔离时 read-only rootfs 下 rc=77 必崩,顺带根治并发转换单实例锁冲突);重算作为可用性增强置于正确性门禁之后且需再过一次自检,任何失败自动回退交付已验证的未重算版并标 recalc=failed,结果加 recalc 字段(done/skipped/failed);否决评审的宏 calculateAll 方案(实测连 OOXMLRecalcMode 都不用设);csv 跳过;SKILL.md 边界同步改口径 2026-09-28 10:23:42 +08:00
kicer d4f83b0694 sheet-edit 首战复盘两改进:① 内层动作键 op→action(run.py 兼容旧键 op 缺省 inspect),消除与 skill 工具外层 op=run 的撞名——AI 照抄示例漏外层参数、或把内层值填进外层枚举的根因;SKILL.md 顶部新增「调用形式」章节给出完整外层调用并声明下文均为 input_args。② 表头行不再靠 AI 自觉:locate.detect_header_row 扫描前 10 行(候选=非空全字符串且互不重复取最多列),inspect 每 sheet 返回 suggested_header_row;build_col_map 只解析出 1 列(典型:横跨全行的合并标题被当表头)且检测到不同行时直接报错给出 header_row=N 建议——跳过 inspect 直接 apply 也能一次报错自愈,正是「标题行+表头行」中文表格翻车现场的兜底 2026-09-28 10:16:17 +08:00
kicer 17d6292dfa sheet-edit 技能评审修复(P0/P1 全绿):公式调整弃裸正则、改用官方 Tokenizer 按 subtype=RANGE 逐 token 重写——LOG10/ATAN2 函数名、"B2" 字符串、本表引用他表不再被错改,他表→目标表跨表引用获得调整(同 Excel),区间删除按 Excel 语义收缩而非裸 #REF!,已失效 #REF! 透传不炸;合并区域随插删移动(修 mv 误同时移行移列致 D4:D5→E5:E6 吞数据的笔误;跨界删除拒绝)、合并区非锚点写入显式报错;insert/delete 补结构化自检(逐格坐标映射+公式预期+尺寸+新带 fill 校验),校验失败自动删产物兑现「不交付」;inspect 日期/ArrayFormula JSON 化(旧版含日期表直接崩)、formulas 上限 500+truncated、返回 merged;CSV 不再 coerce(007/1.10 保真),value_eq 数字↔数字文本互认;openpyxl 丢公式缓存值的对策=保存置 fullCalcOnLoad;output 文件名消毒;SKILL.md 边界/常见错误同步重写 2026-09-28 09:57:50 +08:00
kicer 511c884e2b md2pdf重构为x2pdf:渲染层reportlab→WeasyPrint(md/txt/html)+LibreOffice(docx/xlsx/pptx/odt*),md/txt套默认黑白CSS并页码、html不套仅显式page生效,page/css参数化版式(默认CSS<page<css文件),依赖自带声明(requirements锁weasyprint==65.1/markdown==3.6——62.x对pydyf≥0.11无上界致transform崩,63+已适配;install.sh自检pango/cairo与CJK字体),删md2pdf整目录与cjk.ttf提取逻辑,img-utils改认系统wqy,README范例改指img-utils/x2pdf,system-prompt加PDF一律走x2pdf,技能清单段落格式改为名字:描述(listSkills已排序不动) 2026-09-25 16:59:11 +08:00
kicer 1a49544d95 data-page返回键重做(评审:独立成行的「←首页」crumb白占一行垂直空间):改为标题行内嵌28px圆形「‹」返回键——table塞进card的.hd(h1加flex:1撑开,新增钮仍居右),dashboard/kanban加.page-hd flex行包h1(h1的textContent更新逻辑不受影响,crumb是兄弟节点);base.css换.crumb规则(圆形/hover淡蓝底/不占额外行高)并新增.page-hd;单页守卫不变(副本即index时querySelector移除crumb,标题行自然回落为h1);SKILL.md步骤5口径同步;测试会话手工刷模板(index导航副本不碰) 2026-09-24 10:17:51 +08:00
kicer e3ada6d513 data-page重跑语义按资产所有权分流(测试2暴露:同会话重跑skill,旧「已存在则跳过」把无crumb的旧模板全skip,导航页有了但子页回不去;根因:skip保护的是「AI改过的模板副本」,重构后契约已禁改模板、AI资产只剩config——skip语义保护的资产已不存在,反使模板修复永远到不了旧会话):run.py分流——*.html/*.css(版本化禁改资产)每次覆盖刷新,index.html不进复制清单永不碰,config-*(AI资产)仅缺失时补;SKILL.md初始化同步分流说明;测试会话task-20260924-002的.app已按新语义手工刷到位(config/index未动) 2026-09-24 10:07:47 +08:00
kicer 2f53c6f57e data-page补导航通路(测试暴露:AI按步骤5分支一cp模板为index,dashboard/kanban成孤儿页——分支二「做导航」无模板无约定不可执行,与重构「只写config别即兴」哲学自相矛盾):①新增nav.html静态导航模板(三卡片链table/dashboard/kanban,复用base.css+FAB,零config,run.py的glob自动纳入);②三数据页顶部加「←首页」面包屑(href=./,与右下FAB分职:FAB=跨应用退出回会话,crumb=应用内回导航页,评审分层「顶部页面内/底部跨应用」补齐下半),尾行守卫:URL为站点根或index.html时自动移除(单页场景index=本页副本,crumb指自身);③SKILL.md步骤5改可执行双分支(≥2页cp nav为index+删未启用卡片防no such table裸奔;单页维持cp模板,守卫自动隐藏crumb无需处理),初始化/页面配置/检查清单同步nav;旧会话重跑skill幂等补nav.html不伤已改文件 2026-09-24 10:02:13 +08:00
kicer 920fac9b6e SKILL.md第8条精确化(评审质疑核实):超2000行报error是页面数据API契约(routes/data-page.js,truncate会让页面统计/分页在无声中算错,故显式error),与db工具的500行/100KB截断(executor.js,消费方是LLM,截断后数据仍有价值)是两层有意不同的行为——评审把两者混为一谈,但被混即说明措辞未承载区分,原文案「服务端超2000行报错」补成API/工具对照写明,防AI未来据此劝退LIMIT意识或反被骗 2026-09-24 09:45:10 +08:00
kicer a2c62717f3 data-page重构评审后两项修补:①自定义页面护栏回填——重构砍掉的旧版最佳实践恰是手写页最需要的底线(骨架三件套/用户数据必转义优先textContent、innerHTML先过esc/SQL参数化+查error字段+加载错误态/大表LIMIT超2000行服务端报error),模板自带这层保护、AI自由发挥的custom.html没有,SKILL.md补为硬要求5-8并把检查清单扩成四项联动;②dashboard count模式去重复卡——metric为count时与固定「总条数」卡同值,只渲两张且省一条冗余COUNT(*) SQL,metric查询按isCount短路为null(渲染分支同守卫);另评审确认:模板/config/base.css三层职责切分成立,类覆盖无悬空,kanban-card改名接线一致,config缺失静默回退DEFAULT属可接受降级 2026-09-24 09:41:20 +08:00
kicer 8a9944a622 数据页面目录 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 待用户确认清理 2026-09-24 00:02:13 +08:00
kicer 04a2e436d6 「返回应用」升级为回到源会话:FAB链简化为深链——数据页task_id即会话id(engine里1:1),backToApp()直接跳/?s=<id>;前端启动(settings.js文末init)消费一次:命中即openSession+replaceState抹参数(防刷新钉回),会话已删走openSession自带报错落在welcome。JS桥/?from=/history.back整条链移除——back在多页数据应用里退的是上一张数据页(那是「上一页」语义,归顶部返回导航管),桥与from均无真实消费方,确定性跳转胜过猜环境;按钮文案返回应用→返回对话(房子图标不变,语义终于配得上图标);SKILL.md契约同步 2026-09-23 23:57:26 +08:00
kicer efe5db2e88 data-page模板补「返回应用」FAB(评审方案按库内实际修正):returnToApp优先级链=APK JS桥(Android.backToApp/webkit handler)→?from=(限站内绝对路径,堵开放重定向)→history.back→根路径——不写死'/chat'(本库主界面是public根,已核实),纯浏览器自然落在回上一页/首页无需环境判断;位置选FAB弃footer(桌面优先方针下footer吃垂直空间,看板列高/长表分页首当其冲);图标用内联SVG(⌂码位WebView字体不保证);SKILL.md成文:每个app/*.html(含index)必带,检查清单同步;线上四页一并补齐 2026-09-23 23:45:50 +08:00