Commit Graph
225 Commits
Author SHA1 Message Date
kicer 3eb3117fac executor 两项评审加固。① /exec 拒绝 cwd 恰为任务根(评审意见成立):任务根是全部会话目录的父目录,此前缺省 cwd 或显式传任务根会命中 isolatedCommand 的不隔离分支、暴露所有会话;现 handleExec 以 REAL_TASK_ROOT(启动时 realpath)显式拦截返回 400,缺省落任务根同样被拒、等效 cwd 必填——「任务根下的命令必进隔离 wrapper」自此成为硬不变式。评审给的 checkCwd 内比较 root===DEFAULT_CWD 的写法在本配置(ROOTS=/workspace)下永不命中,改为对 realpath 相等判断。core 侧三个调用点(terminal 传 taskDir、skills 传 skillDir)均在边界外零影响。② 写后断连守卫(评审意见方向成立但原方案有误,已修正实现):实测 Node 20 对 destroyed res 的 write/end 静默丢弃,未复现声称的崩溃;且原补丁用 writableEnded 判断(断连路径恒 false、永不命中)、finish 顶部 return 会跳过 clearInterval(ping) 泄漏定时器。改为:sseWrite/ping 统一 writableEnded||destroyed 前置拦截,finish 清理与 exit 日志先行、断开时不再触碰 res。smoke 主套 cwd 移到任务根外 .taskroot 边界目录并全部显式传参,新增缺省 cwd 400 / 任务根 400 / 半路断连不击穿服务三用例,宿主机与容器内均 21/21。ARCHITECTURE.md §6 同步。 2026-09-06 10:48:00 +08:00
kicer 4c5437e78a agent-executor 降权:privileged: true 改最小权限 cap_add SYS_ADMIN + security_opt apparmor=unconfined(评审意见,方向成立但需补 apparmor 一项)。实测 Docker 29(Ubuntu,AppArmor 启用):默认 AppArmor profile(docker-default)拦 mount(2),单加 SYS_ADMIN 连 mount --bind 都 Permission denied;seccomp 单独放开无用、apparmor unconfined 即全通;默认 seccomp profile 对持 CAP_SYS_ADMIN 进程本就放行 unshare(2)/mount(2),无需改动。相比 privileged 收回:宿主机设备透传(/dev 裸盘)、全套 capability、seccomp 封锁。容器已重建(privileged=false cap_add=[CAP_SYS_ADMIN]),容器内 smoke 16/16 全过(隔离用例真实执行非 SKIP)。compose 原注释里 apt-get install 需 privileged 的说法有误一并清理(该镜像就是在默认 seccomp 下构建的)。server.js/ARCHITECTURE.md 头注同步。注:privileged 顺带提供的 SYS_PTRACE/NET_ADMIN/设备访问随之收回,AI 如需调试类工具再按需显式 cap_add 2026-09-06 10:35:35 +08:00
kicer a2ea5baf77 agent-executor per-task 挂载隔离:任务根下的命令 spawn 前包一层 unshare --mount wrapper(isolatedCommand),先 bind 会话根到 /tmp anchor,再把任务根覆盖为 tmpfs、仅把当前会话根 bind 回原路径——AI 命令只能读写自己会话,看不到别人的 task 目录;深层子目录随 bind 自然保留(terminal 的 cd 不断),mount ns 随进程退出销毁。cwd 恰在任务根或其外(skill 入口等)不隔离直接 spawn;core 侧 terminal 的 cwd 恒为 taskDir 且 cd 被 resolveInTask 钳住,AI 无法把 cwd 挪出任务根绕开隔离。compose 移除 cap_drop 改 privileged: true(默认 seccomp/apparmor 拦 unshare/mount),cgroup 资源护栏不变,容器仍仅内网 expose 9000。smoke 新增隔离三用例(无 mount 权限自动 SKIP),并修两处断言误判:cat 成功只回显内容不含文件名;cd 失败信息含兄弟目录名污染 ls 段断言,改分隔符切段 + leaked/blocked 标记,16/16 全过。compose 注释错别字兑住→兜住;ARCHITECTURE.md §6 同步隔离与 privileged 说明 2026-09-06 10:19:49 +08:00
kicer 3b3106fa20 docs/ARCHITECTURE.md:AI 助手的项目代码导览(复盘全项目后整理)
15 章:项目一句话 / 目录结构 / 部署拓扑图 / 启动流程 / 数据模型(sessions 状态机图) / 11 个核心模块逐一拆(engine/llm/mcp/tools/executor/skills/remote-exec/auth/config/db/sse/balance 各自职责与踩坑点) / executor 容器端点与护栏 / HTTP 路由全表 + SSE 事件清单 / 前端 / 配置字段 / 3 张关键时序图(发消息到 AI 回复、terminal/skill 走 executor、登录)/ 7 类扩展点(加工具/技能/MCP/模型/路由/平台类型/日志的标准化改动步骤)/ 12 项约定(日志/错误/路径/异步/进程组/注释语言等)/ 15 条常见陷阱 / 进一步阅读索引

与 README 互补:README 是设计文档(API/表结构/伪代码),本文件是代码导览(精确到文件行号/函数名,专注改代码时的定位表)
2026-09-06 09:29:06 +08:00
kicer c465ba9acd agent-executor 容器加资源护栏:compose 层 cgroup/ulimit 限制兜住 AI 失控命令——cpus 2.0(烧 CPU 限流不杀)、mem_limit 2g(内存失控 OOM kill 由 restart 拉起)、pids_limit 512(防 fork 炸弹)、ulimits.fsize 2G(dd/cat 写巨型文件 SIGXFSZ 拦截,内核层对 bind 卷同样生效);server.js 头注释说明护栏在部署层实现。残余缺口已在注释标注:fsize 只限单文件,大量文件堆满磁盘需宿主机配额兜底 2026-09-06 09:15:54 +08:00
kicer 7f88f0c96d executor 分级日志 + core 登录日志:executor 新增 EXECUTOR_LOG_LEVEL(debug|info|warn|error|none,默认 info,语义对齐 core log.js),debug 时逐条打印与 core 的完整交互(请求行、/exec 请求体、每条 SSE 下发帧、JSON 响应,超长截断 2000 字符),info 保留 listening/start/exit 等关键动作,鉴权拒绝升 warn、spawn 错误与处理异常升 error;Dockerfile/compose 接线环境变量。core 在 /api/login 补用户进入日志:成功 info(含 ip)、密码错误 warn;login_restore 自动恢复记 debug 防 APK 冷启动刷屏 2026-09-06 08:49:39 +08:00
kicer e819586ea3 fix issues 2026-09-06 08:23:50 +08:00
kicer 120726b7fe 修复 smoke 全部过时用例并顺带修两处真 bug:messages 路由丢失 attachments(纯附件消息被 400、【系统通知】不再拼入),api_key/password 脱敏正则误伤空串值("" 变 ***");smoke 适配新建即 held 预留语义与平台名/模型id 唯一键;process.exit 改 exitCode 防跳过 finally 残留 mock/server 占端口;测试配置隔离 data_root;68/68 全过 2026-09-06 08:21:49 +08:00
kicer 548ce651f6 core 接入 agent-executor:terminal 工具与技能执行/依赖安装支持远端执行(cfg.executor.url 或 EXECUTOR_URL/TOKEN 环境变量,SSE 收流、run.procs 注册 remoteKill 句柄与取消/超时联动、engine.killRunProcs 兼容);设置页服务状态显示命令执行方式;附 remote-exec 集成测试 2026-09-06 08:21:41 +08:00
kicer 232f768783 构建内网和外部隔离 2026-09-06 07:58:11 +08:00
kicer 6f7bff27af 新增 agent-executor 服务:9000 端口接收命令并以 SSE 实时回传输出(零依赖单文件;cwd 白名单/可选 token 鉴权/超时与取消杀进程组);补回 compose 顶层 external 网络定义;附冒烟测试 2026-09-06 07:56:07 +08:00
kicer 98b1069b54 init v3 branch 2026-09-06 07:48:45 +08:00
kicer fd88870d83 修改程序默认路径 2026-09-06 07:34:41 +08:00
kicer 7b532ef82b 桌面端设置页自动收起侧栏;模型删除本地标记隐藏;MCP 支持 enable 字段 2026-09-05 21:43:07 +08:00
kicer 600aabd74e 侧边栏搜索框加描边与阴影,浅灰底上更突出 2026-09-05 21:18:40 +08:00
kicer 90a38fa640 侧边栏底色改浅灰,搜索框改白底 2026-09-05 21:15:26 +08:00
kicer 96b0a70183 适配桌面端:侧边栏常驻左侧可折叠,会话区占满右侧并居中 2026-09-05 20:45:22 +08:00
kicer c46cf0035f 优化输入体验 2026-09-05 20:15:16 +08:00
kicer 73b2e93cfc fix prompt 2026-09-05 19:26:47 +08:00
kicer fc68094a97 fix issues 2026-09-05 18:55:15 +08:00
kicer 9002e471bb prompt dump 改为完整请求内容三部分,落盘 data/system-prompt.txt
- 路径按需求调整:workspace_root/system-prompt.txt(去点号,宿主机 <repo>/data/)
- 内容扩为模型实际收到的三部分(各带中文节标题注释):
  1. system 消息:模板 + 可用技能 + 语言指令
  2. tools 数组:内置 definitions.json + 启动时发现的 MCP 工具,与请求 tools 字段一致
  3. 会话上下文:首条 user 消息示例(占位会话 id + 首个启用模型渲染;实际每会话动态生成)
- engine.js 导出 sessionContextContent 供示例渲染;dump 失败仅警告不阻塞启动
2026-09-05 18:51:36 +08:00
kicer a4aed4fc9b 启动成功后 dump 当前完整 system prompt 到 workspace_root/.system-prompt.txt
原样输出模板 + 可用技能列表 + 语言指令的最终拼接结果,方便人工核对;
写文件失败只警告不阻塞启动。宿主机对应 <repo>/data/,已在 gitignore 内。
2026-09-05 18:32:58 +08:00
kicer 1d0ab8fc04 system prompt 注入可用技能列表,免去模型先 list_skills 探索
- tools/skills.js 新增 formatSkillListForPrompt:技能列表格式化为
  “## Available Skills” 段落(名称 + 描述,每行一个)
- llm.js 新增 setSkillListText:技能段落拼在模板之后、语言指令之前;
  列表变化时失效 systemPromptText 缓存。仅技能增删/描述变化时更新,
  否则进程内恒定,不破坏上游前缀缓存
- server.js 启动时对技能根目录做快照并注入,启动日志输出技能名
- routes/skills.js 六个变更入口(创建/重命名/删除/文件写/文件删/上传)
  成功后 fire-and-forget 刷新列表:UI 增删改技能无需重启即生效;
  list_skills 保留作实时兜底
- system-prompt.txt Skill Usage 措辞更新:直接信任系统 prompt 中的
  技能列表,列表缺失或疑似过期时才调 list_skills
2026-09-05 18:28:06 +08:00
kicer 7375cdbae5 llm.js:system prompt 拼接与含图行解析加缓存
- systemPromptText 按语言缓存拼接结果:每次请求都随 messages 发出,
  不再重复分配模板大字符串(内容进程内恒定,不破坏上游前缀缓存)
- 含图行哨兵 JSON(带 base64 大字段)的解析结果按行 id 挂在 session 上,
  工具循环里同一行只解析一次;缓存原始块数组而非消费后投影,
  消费与否仍按 lastAssistant 实时判定,删除后续 assistant 让图片
  回到「未消费」需重带 base64 时自然正确
- 行被删除后残留缓存条目顺手修剪,防缓慢泄漏
2026-09-05 18:21:28 +08:00
kicer b7aaf8cc10 fix tools definitions.json 2026-09-05 18:04:40 +08:00
kicer 5484d4a1d9 优化系统提示词 2026-09-05 17:30:09 +08:00
kicer 3dea3243c4 上传文件后提示消息去掉 2026-09-05 17:29:56 +08:00
kicer 8cacc20121 fix login issues 2026-09-05 17:19:45 +08:00
kicer d778ab12da fix: 修复切换用户后会话列表返回错误用户数据
根因:cookie残留/污染 + localStorage autoRestore 自动恢复旧用户
- 浏览器清cookie不会清localStorage,autoRestore用旧token自动恢复登录
- 前端req()未发Authorization头,完全依赖cookie认证
- 当cookie失效时req.user为空,后端不过滤会话返回所有数据

修复:
- 登录成功后存凭据到sessionStorage,req()自动加Basic auth头
- logout彻底清理:sessionStorage + localStorage + POST /api/logout
- autoRestore失败时清除无效token,成功时续期token
- 退出跳转带logged_out参数,login页兜底清除所有凭据
2026-09-05 16:26:03 +08:00
kicer bbacf48dcf fix: 修复切换用户后会话列表返回错误用户数据的cookie残留问题
- 登录成功后将凭据存入sessionStorage
- req()自动附加Authorization:Basic header避免依赖易污染的cookie
- logout同步清除前端凭据和服务端cookie
2026-09-05 16:15:41 +08:00
kicer 763fc38882 refactor(pwa): 精简 PRECACHE_URLS,仅预缓存缓存优先的图标与 manifest
- 移除 / 和 /login.html: 网络优先 HTML 不预缓存离线更稳(避免 STATIC_CACHE 旧版遮蔽 RUNTIME_CACHE 新版本)
- 移除 /css/style.css: 同上,CSS 在线时每次都写 RUNTIME_CACHE; 离线回退拿最新的
- 移除 /js/core.js 等 5 个 js 文件: 仅 v1.html(遗留版)引用,index.html 全内联无依赖
- 移除 /vendor/marked.min.js: 没有任何页面引用(CDN 加载),是死资源
- 保留 /manifest.json + 3 个 icon .png: 缓存优先的静态资源,安装时预置秒开
2026-09-05 16:00:04 +08:00
kicer 9b00e7ce58 refactor(pwa): 回撤至 eb4ae32 网络优先策略,图片/JSON 改为缓存优先
- git reset --hard 回撤 3cc9296(纯网络转发版,该提交未推送远程),恢复 eb4ae32
- HTML/CSS/JS 保持网络优先、失败回退缓存,代码改动即时生效无需升版本
- 图片(.png/.jpg/.gif/.webp/.svg/.ico/.avif/.bmp)与 JSON(manifest.json 等)
  改为缓存优先:内容稳定,命中即返回省流量、弱网加载快,改动时升 CACHE_VERSION 刷新
- /api/ 与 /sse 仍完全跳过,登录验证与流式接口不受缓存影响
2026-09-05 15:56:49 +08:00
kicer eb4ae32d4a refactor(pwa): 静态资源改为网络优先,免除每次手动升 CACHE_VERSION
原缓存优先策略下,每次改 CSS/JS 都要手动改 CACHE_VERSION 才能清旧缓存,
漏改就会像之前那样移动端拿到旧样式。改为网络优先:在线时始终取最新,
离线/失败时回退预缓存,与 HTML 文档的处理一致,CACHE_VERSION 仅作命名空间。
2026-09-05 15:44:18 +08:00
kicer 6c71316f13 fix(pwa): 升 Service Worker 缓存版本,移动端任务文件目录图标显示为黑块
根因:sw.js 对 /css/style.css 走缓存优先且 CACHE_VERSION 一直是 agent-v1,
上一轮给 style.css 新增的 .file-dir-* 目录图标样式没送达移动端,
目录头里的 <svg> 缺尺寸/fill:none 样式,按 SVG 默认规则渲染成又大又黑的一团。
桌面端没被旧缓存拦截所以正常。
升到 agent-v2:install 时重新预缓存新资源,activate 时清理 agent-v1-* 旧缓存。
2026-09-05 15:41:59 +08:00
kicer c2ac2cd463 refactor(ui): 移除启动时请求 /api/config 的 debug 开关,删除按钮常驻
- 删除内联 <style> 里隐藏 .act-del 的规则(body 默认隐藏 + log-debug 才显示)
- 删除 applyLogLevelFlag() 函数及其启动调用,不再首屏拉 /api/config
- 消息删除按钮(.act-del)改为始终显示(由 style.css 的 .msg-actions .act 提供 display:flex)
2026-09-05 15:28:31 +08:00
kicer 359b16c9a4 feat(files): 任务文件面板支持目录分组与折叠
- 后端返回扁平文件列表(路径可含子目录),前端按路径组树渲染
- 每一级目录在上、文件在下;同级目录按名称排,同级文件按时间倒序
- 点击目录头切换折叠/展开,折叠状态在上传/删除重渲染后保持
- 嵌套目录按层级缩进(封顶防深层目录挤占屏幕)
- 多选/全选/批量下载删除基于 data-path,嵌套行不受影响
2026-09-05 15:20:00 +08:00
kicer 33ee43e730 仅摘要语义修正:摘要落库标 type='summary',之前历史标 archived 不再发给模型;重进会话恢复摘要卡片 + 淡色存档段说明 2026-09-05 12:58:24 +08:00
kicer 5c19c76b59 修复压缩根因:summarize_request 指令从未发给模型
buildMessages 之前无条件跳过 type='summarize_request' 行,导致 compress.prompt
落库但从不进入模型上下文,AI 收不到总结指令。改为条件携带:仅在压缩回合进行中
(指令行位于最后一次无 tool_calls 的 assistant 收尾回复之后)发给模型,回合完成
后照旧跳过,保留防旧指令污染后续轮次的语义(generate_only 残留、工具循环中间
迭代等场景均已覆盖验证)。
2026-09-05 12:44:39 +08:00
kicer 71b4c81c99 压缩功能基本可用 2026-09-05 12:24:56 +08:00
kicer a464a24fde 修「仅摘要」重复渲染:按消息 id 去重 + 总结改成折叠面板
- 加 state.lastAssistantMsgId 防重:SSE assistant_message 同 id 只处理一次(防御
  EventSource 自动重连/服务端重发导致 handler 被二次触发)。
- 「上下文总结」UI 改造:去掉 emoji 小标,改成 details/summary 折叠面板(复用
  .msg-think 视觉风格,summary 文字「上下文总结」),刚收到时默认 open 便于阅读,
  收尾后随同思考面板一起折起,避免占住后续气泡的空间。
- 防重插入:同 streamWrap 里已存在 .msg-summary 时不重复插入。
2026-09-05 11:22:55 +08:00
kicer 937a3fb719 压缩按钮样式:复用现有 primary/danger;右对齐蓝色图标
- 弹窗三按钮复用现有按钮语义:取消=ghost-btn、仅摘要=primary-btn(蓝/确定风)、
  压缩总结=ghost-btn.danger(红/删除风);删除之前临时编的 .warn / .outline 样式。
- 压缩按钮 SVG 加 .icon-primary(用 var(--active) 主蓝)+ .phase-bar-right(margin-left:auto
  推到 phase-bar 最右侧),与其他 stop-link 视觉区分。
2026-09-05 11:12:52 +08:00
kicer eaf2cd68f5 上下文压缩:phase-bar 加压缩按钮,弹窗选「仅摘要/压缩总结」自动走流程
- 后端:config.yml 加 compress.prompt;engine.summarizeContext(sessionId, mode)
  把 prompt 落为 type='summarize_request' 的 user 消息;runLoopInner 在
  assistant_message SSE 上带 is_summary + mode 给前端;llm.buildMessages 跳过
  summarize_request / archived 行避免指令污染上下文;路由 POST /:id/summarize
  校验 mode ∈ {generate_only, compress_and_clear}。
- 前端:phase-bar「压缩」按钮(硬盘+下箭头 SVG 图标)取代原清空按钮;
  点击弹窗三按钮(取消 / 仅摘要蓝描边 / 压缩总结警示橙);选定后后端丢请求,
  SSE 收到总结时按模式自动调 DELETE 清空(仅 compress_and_clear)。
- 移除 phase-bar「清空」按钮;clearChat 保留为 no-op 防外部误调。
2026-09-05 11:08:11 +08:00
kicer 360169a489 仅在debug模式下才显示清空消息按钮 2026-09-05 10:26:49 +08:00
kicer 49b501da1d 调用出错的工具需要显示红色 2026-09-05 10:24:46 +08:00
kicer 72ec733a92 修改错误工具调用时候的提示词 2026-09-05 10:08:16 +08:00
kicer 734039d917 日志模块拆分 category 参数:log.xxx(category, ...args) 输出 timestamp [level] [category]
- log.js 签名改为 log.xxx(category, ...args);头三段为时间戳 [level] [category],后续参数(含 Error/对象)透传 console 走 util.format
- 所有调用点迁移:从 log.info('[msg] xxx') → log.info('msg', 'xxx');server 启动行无前缀,统一归入 startup
- 实测输出:2026-09-05 09:27:12.068 [debug] [sse] task-20260904-012 event: ping
2026-09-05 09:27:23 +08:00
kicer 3538526c41 工具/任务执行卡片支持删除:单删 tool 回执同步摘除父 assistant 的对应调用
- deleteToolMessage:删工具回执行后,把该 tool_call 从父 assistant 的 tool_calls 里摘除;纯工具轮(无文本)且无剩余调用则父行整删,避免「有调用无结果」被上游拒收
- tool_result 事件先落库再广播,带 msg_id;前端工具卡时间行(复制旁)挂 × 删除按钮,历史与实时均可删
- 删除走统一 .act-del 委托:confirm → DELETE 接口 → 重拉详情重建消息区
2026-09-05 09:10:15 +08:00
kicer ad6ed51fd4 新增删除单条消息:DELETE /api/sessions/:id/messages/:messageId + 消息行删除按钮
- engine.deleteMessage:assistant 的 tool_calls 轮连带删除其 tool 回执,防孤儿 tool 行破坏协议;tool 行拒绝单独删
- 删除后库行消失,下次发给模型的历史自然不含该条(buildMessages 只看库)
- index.html:复制按钮后加删除按钮(× 图标),点击 confirm 后调接口并重拉详情重建消息区;发送成功的实时用户消息也带删除按钮
- style.css:删除按钮悬停变红、请求中禁用态
2026-09-05 09:00:30 +08:00
kicer 848937c156 AI 坏 tool call 标记 errAck:入库留痕但移出模型上下文,防模仿死循环
- messages 新增 type 列,参数非法(JSON 坏/缺必填)的 assistant 轮标 errAck
- buildMessages 跳过 errAck 行及其关联 tool 回执,改发一条 user 错误提示引导重新生成
- tool_calls 落库时补全缺失 id,保证与 tool 回执配对一致
- safeParse 升级为 checkToolArgs:区分非法 JSON 与缺必填,执行前统一挡下
2026-09-05 08:55:31 +08:00
kicer 9e583afaf5 修复 callModel 没透传 onMeta/onBadData 导致 SSE meta 行被丢弃
callModel 内部 await forEachSSEData(res, evt => {...}) 只传了 1 个参数,
opts.onMeta / opts.onBadData 永远没被接通到 forEachSSEData。结果是
forEachSSEData 收到的非 data 行(event:/id:/retry:/注释)全部被静默丢弃,
onMeta 回调从未触发。这是 893281c commit 那次'应该已经修了'的回归 bug,
由于之前的烟雾测试只覆盖了 onEvent / onText / onBadEvent,没发现 meta 链
完全断的事实。

这次用含 event:/id:/注释行的 SSE 序列烟雾测试,验证 onMeta 收到所有行。
engine.js 的 handleSseMeta 解析逻辑(a349942)此前一直正确,只是链路没
接通,这次修复后能正常按 6 条规则分发。
2026-09-05 07:29:12 +08:00