Commit Graph
720 Commits
Author SHA1 Message Date
kicer 351662d18c feat(ui): 文件树在回合结束/回前台/重连后自动刷新
- 新增 reloadFileTree():保留展开与勾选,只重拉已展开的目录;250ms debounce + 1s 去重,多路触发合并
- 一轮跑完(engine 循环退出才发的 done)就地刷新;回前台 visibilitychange 与窗口重新聚焦也刷;断线重连补拉后补一次
- 修掉「切回文件树面板仍用旧缓存」:showFileTree 先失效再渲染
- 上传后改用 reloadFileTree,不再把用户已展开的目录收起来
2026-11-13 09:40:31 +08:00
kicer 4c4076ba13 feat(ui): 侧栏面板模式写进地址栏,刷新后保持文件树/会话列表
- syncUrl 改为无参,按 state.sessionId + #drawer 的 drawer-mode-files 拼 ?s=<id>[&files=1]
- setDrawerPane 切换成功后同步地址栏:点底部文件树图标、切回列表都会改写 URL
- 新窗口带 files=1 进来落地即文件树,F5 不再退回会话列表;窄屏 setDrawerPane 直接 return,地址栏不会写上 files=1
2026-11-13 09:27:47 +08:00
kicer 65d05d2656 feat(ui): 新窗口打开落地即进文件树,调换行内按钮顺序
- 行内按钮改为删除在最右、新窗口在它左边(误触删除的概率更低)
- 会话行新窗口链接带 files=1,打开会话后把侧栏切到文件树,省一次点击
- 手机端本来就不显示行内按钮(hover:hover + pointer:fine),窄屏 setDrawerPane 也会拒绝切文件树
2026-11-13 09:25:22 +08:00
kicer e50015cdc1 feat(ui): 侧栏会话支持在新窗口打开,地址栏常驻当前会话
- 会话行 hover 增加「在新窗口打开」按钮,走已有的 /?s=<id> 深链;触屏媒体查询下不显示
- 地址栏改为跟随当前会话:切会话写 ?s=,新建/删除回 /;原先深链消费一次就抹成 /,
  导致新窗口刷新或复制地址会丢会话
- 打开失败(会话已删/链接失效)时清回 / 并落回 welcome,不留「加载中…」和亮着的顶部按钮
2026-11-13 09:22:57 +08:00
kicer 6d4b41ebfe feat(ui): 文件树支持勾选批量下载 / 删除,去掉展开箭头
窄屏的旧文件面板一直有全选和批量操作,桌面端接管后的文件树没有。这次补上:

- 行内勾选框(hover 或已选中时淡入,占位常驻,不挤动文件名),目录行也能勾,
  勾目录表示整个目录;勾子项会把祖先目录降级,提交前再按目录折叠一次,避免
  zip 里重复。
- 树底部新增一条:全选(作用域=当前已展开可见的行,部分选中显示横杠)、已选
  计数、批量下载、批量删除。没选中时按钮禁用。
- 批量下载沿用旧面板两条链路:含目录交给 /files/zip-token 打包一次下载;纯文件
  先取完全部 download-token 再逐个触发,避免被浏览器当弹窗拦掉。
- 批量删除一次确认后逐项 DELETE,完成清空选中并刷新,预览里正开着的文件一起关。
- 行内动作保持原样:服务器端文件「下载/删除」、目录「删除」;本地端「在 Finder
  中显示/删除」。本地端底栏隐藏批量下载——文件就在本机,没意义。
- 去掉目录前的展开箭头:文件夹图标已说明可以点,点行任意位置都能展开。
2026-11-12 15:15:27 +08:00
kicer a4897c1ace docs: README 改成项目概览,加界面截图
483 行压到 77 行,只留定位、快速开始(服务器 / 本机)、组成、配置、升级、
安全、License。特性表、内置工具表、技能规范、目录树、环境变量、常见问题这些
细节删掉,各子目录的能力看 app/、mcp/、wxbot/、skills/、local/ 自己的 README。

界面截图从仓库根移到 docs/agent.jpg,README 开头直接引用。
2026-11-12 10:38:20 +08:00
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 8a92f2543d feat(engine): 会话目录改为首次调工具时才建,纯文本对话不再留空目录
建目录原来在 createSession 里,纯文本会话也照建,磁盘上越积越多(线上 119 个
会话目录里 39 个是空的)。改成在 executeTool 入口懒建:会话只算路径,第一次
真正用到工具(含技能递归调用)才 mkdir;上传/写文件本来就自带 mkdir,只读路径
(文件树、下载、公链、预览)维持「不存在即空/404」。
2026-11-12 09:46:52 +08:00
kicer 90158ab590 fix(local): 启动器改用 detached 方式起,关终端不再连带停服
nohup + & 起的后台副本仍在终端 shell 的作业表和进程组里:关窗口时 HUP 打到它,
脚本里的 trap HUP 又覆盖了 nohup 的忽略位,于是走 on_signal 把 core 和 MCP 一起
收掉(Terminal 上实测会挂,iTerm2 只是送信号方式不同)。同时 shell 因残留后台
作业,退出时还会卡一下。

改成 node 的 child_process.spawn({detached:true}),子进程 setsid 成独立会话、
无控制终端;pid 仍是本脚本,stop.sh 的 pid 文件逻辑不变。
2026-11-12 09:22:08 +08:00
kicer f587eb5b52 fix(llm): 深度思考状态随会话落库,压缩不再断前缀缓存
deepThink 只在发消息时写进 sessions.deep_think,重进会话按它回填按钮,压缩回合
沿用会话当前状态而不是强制关思考。

压缩回合照常发 tools、system prompt 不动,请求与上一发常规请求只差尾部那条压缩
指令,前缀缓存整段命中(原来压缩去 tools、关思考,前缀从最前面就断了)。

reasoning_content 只在开思考时回传:关思考不发历史思维链;开思考时带 tool_calls
却没有思维链的行用空串占位,避免上游 400。
2026-11-12 09:02:23 +08:00
kicer 57ff5073d8 feat(config): 模型可配 max_context,到线自动压缩上下文
max_context 是用户自定义的用量线,不是模型真实窗口:回合内 In 峰值到了,就在
下一发请求之前切成压缩回合,摘要落库后清零,支持连续压缩。

回合起点用上一发上游实报的 prompt_tokens 播种峰值,否则新回合第一发的判据永远是
0,历史早就超线也会整段再打一次(实测 123903 ≥ 120000 那发就是白打的)。
2026-11-12 08:42:07 +08:00
kicer b657a22fe2 fix(server): 下载响应接住 sendFile 异步错误,点文件不再 404 也不再吐堆栈
- sendDownload 加 dotfiles:'allow' 与图片分支对齐:.env / .gitignore 这类点文件
  本来存在,却被 send 的默认 ignore 策略当成不存在抛 NotFoundError
- sendDownload / sendInlineImage 都补上 sendFile 回调,失败统一走 sendFileError:
  4xx 折叠成 404、正文只留一行纯文本。此前错误没人接,落进 Express 默认处理器,
  非 production 环境下把 err.stack 拼成 HTML 吐给请求方(服务端绝对路径、源码
  文件名+行号、依赖版本),而 /p/<id> 是挂在 auth 之前的匿名可达端点
- 新增 error-handler.js 作统一错误出口,末尾挂在 server.js:任意路由漏出的异常
  同样只回一行纯文本,栈只进日志、不再进响应体
2026-11-12 07:45:06 +08:00
kicer ffca861dc1 fix(local): 预览网关按 executor/preview.js 对齐数据面,去掉白屏与冷启动卡顿
对照服务器实现(executor/preview.js)逐条补齐,这些不是优化而是缺功能:

- vendor 页把根绝对 `/` 当作「自身最新 HTML」比对,网关必须按 Referer 把它转给 watch。
  原来只转 `/events`、`/api/*`,`/` 回 404 → 页面判定自身过期 → location.reload(),
  用户看到的就是白屏后重新加载
- 就绪判定改为真发一次 `GET /`(首帧渲染在那次请求里完成);裸 TCP 连上只说明 Kestrel bind 好了
- HEAD 探针等槽位就绪(上限 15s)再回 200:冷启动渲染不再落到 iframe 的导航请求上
- 导航请求绝不为启动/自愈阻塞:未就绪或外部改动 → 立刻中转页 + 后台热槽;缺尾斜杠补 301
- 外部写盘靠 mtime 指纹 + 2s 轮询 POST /api/switch 触发重读;实现 __pv-touch(编辑命令的事后一脚)
- 转发看门狗、conns 计数、失败摘槽并原地复活重试一次、404 带 no-store

本地实测:冷 HEAD 3.3s 回 200、热导航 10ms、根绝对 / 与页面 HTML 逐字节相同、冷启动导航
2.7ms 回中转页、touch 后 SSE 收到 action:full、kill -9 watch 后自动换代重起。

顺带给 office 封装层注入 OFFICE_GATEWAY_PORT(它那段 __pv-touch 写死 3100)。
2026-11-11 22:34:47 +08:00
kicer f6665e904e fix(local): 预览槽位加活性校验,watch 退出后不再卡在 502
watch 进程被外部杀掉或 vendor 崩溃后,槽位仍留在网关里,于是所有转发都打到死端口,
面板上只有一句「预览服务不可达」(HEAD 探针只查文件存在性,还回 200,所以更像死链)。
- ensureWatch 拿槽位前先探活,死了就丢掉重起(HEAD 探针也会间接触发)
- forward 转发失败时立即丢槽位,下一次导航/刷新即可恢复,不必等 6h 闲置回收
- killSlot 对已退出的子进程不再按 pid 杀(pid 可能已被系统复用)
2026-11-11 22:20:42 +08:00
kicer 893fc92f6d fix(local): 变量名紧贴全角括号导致 unbound variable / 报错消息中断
bash 3.2 在 UTF-8 下把紧跟变量名的全角字符算进标识符,`"$PREVIEW_PORT(office 文档)"`
会被当成 $PREVIEW_PORT(office 这个变量 → set -u 下直接炸,启动器在 preview 那步退出。
四处一律改成 ${VAR} 形式;其中 `$SKILLS_DIR(python3 未安装…` 是原有问题(只在没 python3 时触发)。
2026-11-11 22:17:43 +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 8effba36dd feat(local): 工作目录拆成 data/skills/tasks,技能复制到用户目录
启动器不再把技能软链回仓库,改为首次启动把内置技能复制到 <工作目录>/skills,
之后每次启动只补缺不覆盖(用户/AI 改过的不会被冲掉)。deps 不复制,只建空目录,
pip 装进 <工作目录>/skills/deps,PYTHONPATH 与 AGENT_SKILLS_DEPS 都指过去。

工作目录据此变成三件套:tasks=会话工作区(AI 的文件根,与服务器 /workspace/tasks
同语义)、data=SQLite 与 prompt dump、skills=技能。仓库里不再有用户数据。

配置仍只由首次启动生成:workspace_root=<ws>/tasks、data_root=<ws>/data、
skills_root=<ws>/skills。新增 cfg_get/skills_dir 从配置读技能根,不自己发明路径。
2026-11-11 21:31: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 10bf2f554b feat(local): 无公网前缀时链接回落回环地址;读图回传改内联 base64 2026-11-11 19:29:44 +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 469e801319 chore(local): 提示词只给安装位置,不写「只在缺密码时才问」这种条件
「安装前先问用户」是允许的,没必要用条件句把它收窄成「仅当需要密码时」。
env-local 现在只说一句:需要装就装,Python 包装进 $AGENT_SKILLS_DEPS。
知不知会用户交给模型按场合判断。docs/local-mode 4.13 同步。
2026-11-11 17:11:51 +08:00
kicer 5b45368f58 feat(local): 少说教、多干活——缺什么让模型自己装,提示压到一句
本地形态是用户自己的机器 + 用户自己的 agent,目标是事做成,不是按生产环境守着:
- env-local 去掉「先问用户才能装运行时」这道闸,也不再把 sudo/系统包列成禁令。
  改为「需要什么就装、装完继续;只有需要用户密码时才停下来问」——sudo 本来就卡在
  密码上,不必用规则去禁。
- 启动器与终端的提示去掉解释性长句:探活只报版本或「未安装」,启动总结压成
  「技能:已启用 / python3 未安装」「语音:可用 / 未启用」这类一行话。

docs/local-mode(4.4 / 4.13 / 限制表)与 local/README 同步。
2026-11-11 17:08:45 +08:00
kicer a7eecdbe97 feat(local): 技能不再因缺 python3 整体隐藏;缺解释器时先问用户再装
A1:link_skills 恒指向仓库 skills。原来没有 python3 就把 skills_root 指到空目录,
把所有技能一起藏掉——但技能不一定是 Python 的(office 是 SKILL.md + terminal 里调
officecli,跟 python3 无关),一刀切会误伤。而 run.py 类技能缺解释器时 skills.js
的 runEntry 对 spawn error 有处理,模型拿到「技能入口启动失败:spawn python3 ENOENT」,
干净可读,不需要靠藏清单避险。状态页/终端文案同步改成「python3 未安装:Python 技能
会失败,非 Python 技能不受影响」。

B2:env-local 允许模型装运行时,但必须先问用户;仍禁止 sudo 与装系统包。
macOS 的 /usr/bin/python3 是 CLT 桩,真装要走 brew 或官方安装器,耗时长且可能改
PATH / 要管理员权限,这种改动不能默许自主执行。

文档同步:docs/local-mode 4.4 重写(记录为什么不再切换)、4.13 补 B2 理由、
验证表该行标为待复测;local/README 的可选能力表与已知限制同步。
2026-11-11 17:07:20 +08:00
kicer c7394dc45f chore(local): 提示词只指路,不教模型怎么装包
env-local 关于 Python 缺包那段从 7 行压到 3 行:只说「缺模块就装进
$AGENT_SKILLS_DEPS 再重试」,不提 pip/--target,也不提镜像源。
具体怎么装、走不走镜像,让模型自己判断;我们只负责给出那个
已经在 PYTHONPATH 上的路径,避免它装到别处或去动系统 Python。

docs/local-mode 4.13 与 local/README 同步措辞。
2026-11-11 17:01:20 +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 29e4f6e6ea fix(settings): MCP 卡片地址不再追加「自定义」标记
只显示真实地址即可,多余的标注反而干扰阅读。
2026-11-11 16:46:10 +08:00
kicer 59994b688a fix(settings): MCP 卡片与编辑器以真实配置为准,预设只做缺省值
本地形态的 MCP 地址是 127.0.0.1:8091~8094,容器形态是 mcp_*:3000;
之前内置服务卡和编辑框一律显示 presets.json 里的地址,且 url 输入框锁只读,
于是出现「显示容器地址 + 亮着已连接」的矛盾,用户也改不动真实地址。

- 卡片地址改为读 config(s.url),与预设不同时标「(自定义)」
- 编辑框预填 当前配置 > 预设缺省,name 仍只读、url 放开
- 保存时内置服务也按需写 url(name/mode 仍是契约)
2026-11-11 16:44:45 +08:00
kicer 50c53fd885 fix(local): 无公网前缀时 visit_url 用回环地址拼出可点开的访问地址 2026-11-11 16:33:07 +08:00
kicer 870033f26d fix(data-page): 目录地址缺尾斜杠时补斜杠跳转,修复页面相对链接白屏 2026-11-11 16:26:17 +08:00
kicer c892703673 fix(skills): 无 executor 时技能 cwd 也用会话任务目录,修复 data-page 等按 cwd 干活的技能 2026-11-11 16:21:33 +08:00
kicer 01757d4f4b feat(prompt): 环境段按部署形态二选一,修正本地模式的环境事实 2026-11-11 16:08:42 +08:00
kicer c0488938ff refactor(ui): 去掉侧栏预览按钮,预览只从文件树点文件开窗 2026-11-11 15:52:50 +08:00
kicer 20824dc42e fix(ui): 未开始会话时不切到文件树,空树直接退回会话列表 2026-11-11 15:48:23 +08:00
kicer 419e3fc914 fix(ui): 未开始会话时点击预览按钮不做任何事 2026-11-11 15:46:26 +08:00
kicer 83644c09e7 fix(auth): 无认证形态下 /api/me 也注册,返回 auth:false 而非 404 2026-11-11 15:44:35 +08:00
kicer d06cd6cedf fix(ui): 窄屏只保留旧文件面板;修正设置图标偏上
- 窄屏(<960px)隐藏左栏的「文件树」图标:手机上只保留输入行右侧的旧「任务文件」面板,
  不做两套文件 UI;setDrawerPane 增加窄屏防线,跨断点缩小时自动退回会话列表
- 设置齿轮换成正中且四周留白的图标:原路径外接框垂直中心在 10.5(画布中心 12),
  整枚图标偏上,20px 下看起来像顶部被切掉
2026-11-11 15:42:19 +08:00
kicer 4e97194b04 feat(ui): 预览分栏挪到文件树右侧,底部操作栏收成三个按钮
IDE 式三栏:文件树 | 预览 | 会话。点文件后内容就在旁边,不用横跨会话区。

- 预览分栏从窗口右缘移到文件树右侧:侧栏展开时 left=--sidebar-w,折叠时贴窗口最左;
  会话区改成往右让位;拖拽手柄随之换到预览右缘,拖动方向取反
- .pv-head 定死高度 49px:预览头有地址条、文件树头只有图标钮,靠内容撑会差几像素,
  两栏下边框对不齐
- 文件树头部去掉地址条(280px 里路径必然截断,没有信息量),只留右侧操作钮
- 底部操作栏收成三个按钮(文件树 / 预览 / 设置):「文件树」现在是
  会话列表 ↔ 文件树的切换开关,当前在文件页时高亮
- 窄屏不再误藏文件树按钮(只藏预览,因为窄屏没有右侧分栏);窄屏点文件后收起抽屉
- 切会话不再自动关预览:中间这一列是常驻参考区,关掉会让人反复重开
- 打开预览时无条件把侧栏切到文件树(已在文件页则空操作)
2026-11-11 15:26:01 +08:00
kicer 8ef4ec1ee4 feat(local): 文件树提升为桌面端通用入口,接管旧文件面板
桌面端(含服务器形态)用左栏懒加载文件树取代输入行右侧的旧「任务文件」浮层:
点文件进右侧预览,行内可下载 / 删除;local 形态额外提供「在 Finder 中显示」。

- routes/files.js:新增 GET /:id/tree(单层懒加载、忽略大目录、上限 500、
  字面 + realpath 双重越界校验),替代会同步递归整棵目录的 GET /:id/files
- routes/local.js:移除 /tree(上收为通用接口),只留 pick-dir / reveal / terminal
- local-files.js → files-tree.js:两种形态共用;local 能力靠 /api/local/info 探测,
  服务器形态自动隐藏 Finder/终端入口
- 树头部复用预览栏的 .pv-head / .pv-addr / .pv-actions / .icon-btn:
  左右并排时高度、图标尺寸与描边完全一致
- 树头不再显示会话标题(原样搬过来容易和会话列表重复),改为显示工作目录路径
- 桌面端隐藏 #files-btn;手机端保留旧面板
- 上传完成后同步刷新文件树
2026-11-11 15:03:04 +08:00
kicer 2d5467203b feat(local): 左栏改为图标操作栏,本地端 IDE 式文件树 + 预览
侧栏底部原来的整行用户区换成四个图标:会话 / 文件树 / 预览 / 设置,
当前生效的那一项高亮;设置与预览图标都是开关(再点一次关闭)。
去掉顶部「会话/文件」分段切换,改用底部图标切换互斥面板。

- local-files.js(新增):只读文件树,懒加载单层、展开才请求、忽略大目录,
  点文件进右侧预览;支持在 Finder / 终端中打开
- routes/local.js:新增 /tree(单层、越界双重校验)、/reveal、/terminal
- preview.js:记录最后预览的文件,预览图标可重开上次文件;开合时同步图标高亮
- files.js:底部操作栏接线,设置图标点击切换开合
- settings.js:打开设置不再折叠左栏;图标选中态同步
- 纯前端 + local 路由(AGENT_LOCAL_PICK 门控),服务器/手机形态行为不变
2026-11-11 14:49:57 +08:00
kicer 80e9dcb0aa feat(local): 新建会话可手选工作目录,AI 直接在所选目录干活
- 后端核心只动 taskDirOf:sessions.work_dir 非空即会话工作目录,不建 task-* 子目录;空串行为与旧版一致(服务器形态恒为空)
- db 幂等迁移加 work_dir 列
- createSession 校验并接受手选目录(必须已存在、拒绝根目录与平台数据目录);deleteSession 绝不删用户所选目录
- fsRoot 优先 ctx.workDir;@会话 按目标会话 work_dir 解析
- 新增 routes/local.js:osascript/zenity/kdialog 原生选目录,仅 AGENT_LOCAL_PICK=1 时挂载
- 欢迎页加工作目录 chip:选择只暂存前端,建档时随 POST /api/sessions 提交
- local/start.sh 注入 AGENT_LOCAL_PICK=1;同步 AGENTS/README/docs
2026-11-11 13:59:15 +08:00
kicer b5cfa36832 feat(local): 依赖安装自愈:源探测 + 换源重试 + 本地缓存 + 看门狗
国内网络下首装依赖最容易卡死,启动器现在自己处理,用户不用懂环境:

- 自动选源:并行探 npmmirror 与官方源(各 3s 超时)取最快,缓存一天;
  只在命令行传 --registry,不写 ~/.npmrc、不改用户全局配置。
- 换源重试:公共源之间自动互换,换源成功即记住;显式指定或公司私有源不兜底
  (乱兜底可能装错东西)。重试前清掉半成品 node_modules。
- 本地缓存:装成功后把 node_modules 打成
  ~/.cache/agent-local/deps-<平台>-<架构>-abi<ABI>-<依赖哈希>.tgz,
  重启/删 node_modules/换 clone 都解压恢复(零网络),只留最近 3 份。
- 看门狗:npm 10 + Node 22 断网时既不报错也不退出(Exit handler never called),
  超过 AGENT_LOCAL_NPM_TIMEOUT(默认 240s)直接 SIGKILL 整棵树再换源。
- 报错翻译:状态页只显示「网络没通 / 缺编译工具链 / 没有写权限 / 源没响应」,
  npm 原文仍完整落 npm-install.log。

同时修掉两个埋着的 bug:

- kill_tree 先把参数赋给变量再递归,POSIX sh 无局部变量导致递归覆盖,
  回到外层 kill 的是子进程,留下 PPID=1 的孤儿 npm。改为只用 $1。
- 看门狗不能先 TERM:TERM 先杀掉外壳会让 npm 变孤儿,kill -0 判不到。
  改为直接递归 SIGKILL(先子后己)。

全部改动只在 local/ 与文档,app/ 未动。
2026-11-11 12:16:35 +08:00