Agent Space Preview加载慢可优化：禁用全量工具预加载、跳过冗余记忆加载、启用模型权重mmap加载、裁剪前端UI资源，整体首次可交互时间缩短60%以上。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Agent Space Preview加载慢直接影响开发调试效率，页面长时间空白或卡在“Initializing Agent Context”状态，常见于首次启动、大模型权重加载、上下文重建或依赖模块全量导入阶段。
检查冷启动资源加载路径
打开终端，执行 AGENT_DEBUG=1 agent-space preview --verbose 启动预览服务，观察日志中耗时最长的模块初始化环节。若日志首屏出现 loading tools/validator.py (3.2s) 或 importing llm_providers.hermes (4.7s)，说明非核心模块被提前同步加载。
编辑项目根目录下的 agent-space.config.js，将 preloadTools: true 改为 preloadTools: false。该配置默认启用全量工具预加载，但实际调试中仅需按需加载当前用到的 1～2 个工具即可节省 2～5 秒冷启动时间。
【preloadTools 设为 false 后，首次调用某工具会多出 300～800ms 延迟，但整体预览页首次可交互时间缩短 60% 以上】
禁用冗余记忆加载与向量检索
Agent Space Preview 默认启动时会从本地向量库拉取最近 10 条技能记忆（skills），并执行 Top-K=8 的语义匹配。这对调试单个 Prompt 场景毫无必要，反而引发 IO 阻塞。
方法一：临时跳过记忆加载
在启动命令后添加环境变量：MEMORY_SKIP_LOAD=1 agent-space preview。此变量会绕过 memory.load() 调用，直接进入空上下文预览模式。
方法二：精简记忆检索范围
进入 ./config/memory.yaml，将 top_k: 8 改为 top_k: 2，并将 auto_load_on_start: true 改为 auto_load_on_start: false。保存后重启服务。
启用模型权重内存映射加载
第一步：确认模型缓存目录可写
运行 ls -ld $(agent-space config get model.cacheDir)，输出中必须包含 drwxr-xr-x 且当前用户有写权限。若权限不足，执行 chmod u+w $(agent-space config get model.cacheDir)。
第二步：强制启用 mmap 加载模式
编辑 agent-space/src/runtime/model_loader.py，定位到第 87 行附近 load_model_from_disk(path, device="cpu") 调用处，在其前插入一行：kwargs["mmap"] = True。
第三步：清除旧缓存并重启
执行 agent-space cache clear --models，再运行 agent-space preview。首次加载仍需解压，但后续启动将直接从内存映射页读取权重，模型加载耗时从平均 6.4s 降至 1.1s 左右。
注意：mmap 模式要求模型文件未被其他进程锁定，若提示 OSError: Cannot load mmap file，请先关闭所有正在运行的 agent-space 实例。
裁剪前端预构建资源
Agent Space Preview 内置的 Dev UI 默认打包了完整的 Monaco 编辑器 + React DevTools + Schema Validator 组件，总 JS 体积达 8.2MB。调试阶段无需全部加载。
执行 npx agent-space-cli build-ui --light，该命令会生成轻量版 UI 构建产物，剔除 Monaco 的语言服务、React DevTools 的 profiler 和 schema 校验器，JS 总体积压缩至 2.1MB。
然后运行 agent-space preview --ui-dist ./dist/ui-light 启动，浏览器首次下载资源时间减少约 3.8 秒，页面渲染阻塞明显缓解。
