Commit Graph
2 Commits
Author SHA1 Message Date
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