YuGalk v3.8.29-beta.1-安装包发布

YuGalk v3.8.29-beta.1

基于 v3.8.29-beta 的修复版本，主要修复上个测试版的已知问题。

修复上个版本的已知问题

• 安装器回归默认行为：此前自定义安装脚本会强制安装到 C:\Program Files 且无法选择目录。现恢复 Tauri 内置 NSIS 安装器，安装时可选「为所有用户 / 仅为我」并自定义安装路径。
• 修复启动报错「无法创建数据目录」：WebView2 数据目录原固定写在安装目录下（C:\Program Files\YuGalk\webview-data），普通用户无写权限导致启动失败。现改为写入用户可写目录 %LOCALAPPDATA%\YuGalk\webview-data。

已知变更

• 升级安装时不再自动进行，会回到 NSIS 默认提示（恢复默认安装器的预期代价）。
• 本版本为测试版，可能仍有未发现的稳定性问题，建议不要在重要工作环境长期使用。

完整落地页视觉/文案打磨已随 GitHub Pages 同步上线。

YuGalk v3.8.29-beta-安装包发布

v3.8.29 beta —— 对比 v3.8.18 beta

新增功能

1. IDE 主题正式上线

• 配色方案落地：黑色活动栏、深紫色画布、浅紫色会话/文件树、绿色强调、终端配色、用户气泡等。

2. IDE 主题预览 + Claw 布局禁用 IDE 主题

3. 设置页「检查更新」真实功能

• 接入 GitHub 拉取最新发布，与本机版本语义化比对（同号时正式版 > beta 版）。
• 发现新版本内联提示「发现新版本」+「前往下载」（唤起默认浏览器），无更新/失败各给内联提示。四语支持。

4. 自启动设置改为布局无关

• 去掉门控，自启动开关在 Claw / IDE 两种布局都可设置；清理三处强制 IDE 拉起的逻辑。

体验优化 / 修复

• 退出应用不再闪系统终端黑框。
• 账号面板图标与文本严格对齐。
• 底部「+」下拉项图标对齐修复。
• Claw 会话透明悬浮输入坞曾挡住底部右侧滚动条；现已修复。
• 用户气泡右侧为经典占宽滚动条，右内边距调整，使气泡到屏边严格比左侧少，左右视觉等距。
• 消息间距统一16px。
• 账号面板入口动画修复。

安装 / 升级

• 自定义 NSIS 安装模板效果：任何人已安装旧版本时双击安装包升级，直接出现进度条、不弹任何「所有用户/仅为我」选择页或「卸载旧版」页，自动卸旧装新。
• 去掉韩语安装语言：消除 NSIS 韩文缺失警告。

维护

• 版本号 3.8.18-beta → 3.8.29-beta。

升级说明 / 注意事项

• 数据（聊天记录、项目记忆、笔记、MCP、模型）沿用，无破坏性格式变更。
• 未签名安装包首次运行仍可能被提示，选「仍要运行」即可。

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 起完全新增的能力

1. 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 终端是纯人工输入框、模型驱动不了。

2. 文件沙箱 + 系统级确认

   • 多根白名单：只读根 = 工作空间 + 账号目录 + 安装目录/OKF知识库（全局记忆/知识可直接检视）；改动根仅限工作空间（写/删永不落全局记忆/知识目录）。
   • 沙箱开关 UI（会话底部工具栏，联网搜索左侧，Shield 图标）：开 = 仅限工作空间，关 = 开放全文件系统。
   • 系统级确认框：所有改动操作（写/建/改名/删）无论开关状态都弹原生确认框，用户允许才执行，拒绝则回灌「用户已拒绝」给模型。v2.0.21 无此机制。

3. 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 互通。

4. 模型管理大幅增强

   • 本地性能检测：CPU / 内存 / 显卡 / 磁盘 + 推荐配置，可折叠卡片，推荐自动写入全局默认（用户仍可手动改）。
   • 推理引擎选择器：auto / cpu / CUDA / Vulkan（新增 CUDA / Vulkan 支持）；无 N 卡驱动时自动禁用 CUDA 选项。
   • 工具调用能力探测：本地模型卡片显示是否支持工具调用，引导换用支持工具的模型。
   • 导入改为真实复制进统一模型库，带「模型文件导入中…」遮罩与分块复制进度。

5. 长任务模式

   • 新增开关：开启后取消工具调用上限，靠输入框手动打断终止（常规单次对话累计上限 30 次）。

6. 工具结果体积封顶

   • run_runtime 超长输出完整落盘、内联仅保留头部 + 截断提示；前端统一兜底封顶，根治超长输出撑爆模型上下文（v2.0.21 无封顶，易溢出）。

7. 系统提示词强化

   • 重写为部署无关 + 强化忠实遵循指令；新增「规划-执行-反思」与「记忆主动利用」小节；身份明确为「运行在用户设备上的 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 兼容接口。应用不为弱模型做文本协议降级，而是在模型选择处明确标示并引导换模型。

六、升级说明

• 无破坏性数据格式变更：本次为纯增量功能，配置兼容。
• 升级后建议：首次打开检查「模型」页性能检测推荐配置；如需让模型操作文件，留意底部沙箱开关状态（默认开 = 仅限工作空间，改动仍需手动确认）。

---

YuGalk v2.0.21-安装包发布

YuGalk 2.0.21

这是 YuGalk 的第一个官方安装包版本。

YuGalk 是一个使用 Agent 开发的开源 Agent 项目，基于 Tauri + React + Rust 构建，将大模型对话、工具调用、本地推理与可扩展的技能 / 插件体系整合进一个轻量、可离线运行的桌面应用。

安装包说明

本 Release 提供 Windows x64 一键安装包 YuGalk_2.0.21_x64-setup.exe（约 327 MB）。安装包已内置运行所需的全部依赖，下载后直接安装即可使用，无需手动配置开发环境。

• 内置 WebView2 运行环境（离线安装，无需联网下载）
• 内置 Node.js / Python / Git / Playwright 运行时
• 内置 llama.cpp 推理引擎

主要功能

• 大模型对话与工具调用：连接 OpenAI 兼容接口，支持多轮对话与工具编排。
• 本地推理：内置 llama.cpp 引擎，可加载 GGUF 模型在本地离线运行（模型文件需自备）。
• 可扩展体系：支持三类扩展——纯提示词技能（Skills）、原生扩展包（.galk）、以及 MCP 协议接入。
• 开箱即用：运行依赖随安装包分发，离线环境下也能正常启动与使用。
• 轻量桌面体验：基于 Tauri，体积小、资源占用低。

安装步骤

1. 在下方 Assets 中下载 YuGalk_2.0.21_x64-setup.exe。
2. 双击运行，按向导选择安装目录并阅读许可协议。
3. 完成安装后启动 YuGalk，在「设置」中配置模型：
   • 使用本地推理：将自备的 GGUF 模型放入「模型」目录并选择；
   • 或使用任意 OpenAI 兼容的云端 / 本地接口地址与密钥。

注意事项

• 安装包体积较大，是因为打包了运行时与 WebView2，属正常现象。
• 本地推理需要用户自行准备 GGUF 模型文件，本安装包不包含任何模型权重。
• 应用窗口任务栏 / Alt+Tab 显示名称为 YuGalk。
• 当前仅提供 Windows x64 版本。

许可证

本项目以 MIT 许可证发布，并附带附加条款：衍生或再分发本软件时须显式标注「基于 YuGalk」及本项目仓库地址，且不得将本软件用于背书宣传。详见仓库内 LICENSE 文件。

---

YuGalk 2.0.21 (English)

This is the first official installer release of YuGalk.

YuGalk is an open-source Agent project built with Agents, powered by Tauri + React + Rust. It integrates LLM conversations, tool invocation, local inference, and an extensible skills / plugin system into a lightweight, offline-capable desktop application.

About the Installer

This release ships a Windows x64 one-click installer, YuGalk_2.0.21_x64-setup.exe (~327 MB). All runtime dependencies are bundled, so you can install and run it directly after download — no manual environment setup required.

• Bundled WebView2 runtime (offline install, no network needed)
• Bundled Node.js / Python / Git / Playwright runtimes
• Bundled llama.cpp inference engine

Key Features

• LLM chat & tool use: Connect to any OpenAI-compatible endpoint, with multi-turn dialogue and tool orchestration.
• Local inference: Built-in llama.cpp engine can load GGUF models and run fully offline (model weights not included).
• Extensible: Three extension types — prompt-only Skills, native .galk packages, and MCP protocol integration.
• Zero-config runtime: Dependencies ship with the installer, so it works even in offline environments.
• Lightweight desktop: Built on Tauri for a small footprint and low resource usage.

Installation

1. Download YuGalk_2.0.21_x64-setup.exe from the Assets below.
2. Run it and follow the wizard to choose an install directory and accept the license.
3. Launch YuGalk and configure a model in Settings:
   • Local inference: place your GGUF model in the Models folder and select it;
   • Or use any OpenAI-compatible cloud / local endpoint with its key.

Notes

• The large installer size is expected — it bundles runtimes and WebView2.
• Local inference requires a user-supplied GGUF model; no model weights are included.
• The app shows as YuGalk in the taskbar / Alt+Tab.
• Windows x64 only at this time.

License

Released under the MIT License with additional terms: redistributions must clearly state "Based on YuGalk" with a link to this repository, and the software may not be used for endorsement. See the LICENSE file.