YuGalk v3.8.18-beta-安装包发布
v3.8.18 beta —— 对比首个发布版 v2.0.21
首个发布版 v2.0.21是 YuGalk 第一个可安装版本。自彼时起,经 68 个提交迭代至 v3.8.18-beta。本文逐项对比两者差异。
一、v2.0.21 基线能力
YuGalk 2.0.21 已具备以下基础能力,全部沿用到 v3.8.18-beta:
- 本地推理 + 云端兼容:llama.cpp 跑用户自备 GGUF 本地模型,同时兼容任意 OpenAI 兼容云端大模型接口。
- 开箱即用的内置运行时:安装包内置 Node.js / Python / Git/ llama.cpp / Playwright,免用户配置即可运行工具链与本地推理(仅 GGUF 模型文件需自备)。
- 一键 NSIS 安装包:内置 WebView2 离线安装、简体中文 / 英文 / 日文 / 韩文四语界面、许可证页面、可选安装目录。
- 多工作空间:每条对话可绑定独立工作目录,聊天记录与项目记忆按工作空间隔离。
- Skills:纯提示词 / 指令增强,零代码、零权限,作为上下文被模型读取。
- MCP 支持(手动):经 Node 桥接进程接入 Model Context Protocol 服务器(stdio),需手动编辑配置。
- IDE 布局:文件树 + 编辑器 + 聊天的开发布局,便于边写代码边与 Agent 协作。
- 多主题 / 多语言:浅色 / 深色 / 纪念 三主题;四语界面。
- 本地持久化:对话记录、项目记忆与笔记收藏均落地本地工作空间。
- 应用图标:AI 生成的熊猫吉祥物,iOS 风格超椭圆(squircle)裁切。
二、自 v2.0.21 起完全新增的能力
-
Agent 文件能力(#10)
- 模型首次拥有真实文件 I/O,暴露为 7 个 Agent 工具:read_file / list_directory / search_files / write_file / create_directory / rename_path / delete_path。
- v2.0.21 时模型只能经 run_code 写脚本间接操作文件,且无原生文件工具,IDE 终端是纯人工输入框、模型驱动不了。
-
文件沙箱 + 系统级确认
- 多根白名单:只读根 = 工作空间 + 账号目录 + 安装目录/OKF知识库(全局记忆/知识可直接检视);改动根仅限工作空间(写/删永不落全局记忆/知识目录)。
- 沙箱开关 UI(会话底部工具栏,联网搜索左侧,Shield 图标):开 = 仅限工作空间,关 = 开放全文件系统。
- 系统级确认框:所有改动操作(写/建/改名/删)无论开关状态都弹原生确认框,用户允许才执行,拒绝则回灌「用户已拒绝」给模型。v2.0.21 无此机制。
-
MCP 引导一键配(#9,闭环升级)
- 三传输全支持:stdio / Streamable HTTP / SSE(v2.0.21 仅 stdio)。
- AI 一句话配 MCP:MCP 管理完全暴露为 Agent 工具,用户用大白话讲需求、AI 自动配置;移除手工表单与 JSON 粘贴(v2.0.21 需手动配置)。
- 内置 8 个常见服务器目录(filesystem / github / fetch / git / sqlite / sequentialthinking / brave-search / puppeteer),AI 配 MCP 时直接套用。
- 磁盘 mcp.json 写标准 mcpServers 对象,与 Claude Desktop / VS Code / Cursor 互通。
-
模型管理大幅增强
- 本地性能检测:CPU / 内存 / 显卡 / 磁盘 + 推荐配置,可折叠卡片,推荐自动写入全局默认(用户仍可手动改)。
- 推理引擎选择器:auto / cpu / CUDA / Vulkan(新增 CUDA / Vulkan 支持);无 N 卡驱动时自动禁用 CUDA 选项。
- 工具调用能力探测:本地模型卡片显示是否支持工具调用,引导换用支持工具的模型。
- 导入改为真实复制进统一模型库,带「模型文件导入中…」遮罩与分块复制进度。
-
长任务模式
- 新增开关:开启后取消工具调用上限,靠输入框手动打断终止(常规单次对话累计上限 30 次)。
-
工具结果体积封顶
- run_runtime 超长输出完整落盘、内联仅保留头部 + 截断提示;前端统一兜底封顶,根治超长输出撑爆模型上下文(v2.0.21 无封顶,易溢出)。
-
系统提示词强化
- 重写为部署无关 + 强化忠实遵循指令;新增「规划-执行-反思」与「记忆主动利用」小节;身份明确为「运行在用户设备上的 AI Agent 应用」。
三、改进
- IDE 布局打磨:模型切换遮罩、右键菜单、文件树操作、弹窗统一与关闭动画;强制自动启动本地模型并隐藏开关。
- MCP 格式标准化:从内部数组改为标准 mcpServers 对象,跨工具互通。
- UI 红线落地:彻底移除右上角 Toast 通知,所有反馈改为内联(模型/笔记/UI);禁用浏览器原生悬停,改用自定义 Tooltip。
- 推理引擎切换真实生效:启动 / 切换 / 退出统一清理,CUDA / Vulkan 子树 + 孤儿进程强杀,切换带遮罩动画。
- 上下文容量显示改为百分比圆环;搜索态内重命名 / 删除 / 新建不再跳出搜索;移除硬编码扫描,模型列表只扫模型目录。
四、修复
- 任务管理器子进程图标黑线:icon.ico 原仅单帧 256×256,小尺寸强缩放出黑色伪影;从干净 icon.png 重新生成 16 / 20 / 24 / 32 / 40 / 48 / 64 / 128 / 256 多帧 ICO。
- 各类 UI 对齐、布局、动画修复。
五、已知问题 / 注意事项
- 未签名安装包:首次运行可能被 SmartScreen 提示「未知发布者」,选「仍要运行」即可。
- bundle identifier com.yugalk.app:以 .app 结尾仅影响未来 macOS 构建,Windows 无碍;做 macOS 前须改。
- 本地模型需自备 GGUF:安装包不含模型文件,需自行导入或接入云端接口。
- 工具调用依赖模型能力:通用对话模型(如 Mistral-7B-Instruct)与部分蒸馏推理模型(如 Qwen2.5 系 DeepSeek-R1-Distill)不支持 function calling,无法使用工具;建议使用 Qwen Instruct / Llama-3.1 / 远程 OpenAI 兼容接口。应用不为弱模型做文本协议降级,而是在模型选择处明确标示并引导换模型。
六、升级说明
- 无破坏性数据格式变更:本次为纯增量功能,配置兼容。
- 升级后建议:首次打开检查「模型」页性能检测推荐配置;如需让模型操作文件,留意底部沙箱开关状态(默认开 = 仅限工作空间,改动仍需手动确认)。