v0.4.0 - OmO 智能体编排层集成

ZX-Code v0.4.0 — OmO 智能体编排层集成

🎉 新版本亮点

本版本集成了 oh-my-openagent (OmO) 架构优势，为 Agent 引擎接入生命周期钩子、计划审查、规则注入与意图路由，同时新增 AST-Grep/LSP 代码智能、内置 MCP 服务器、性能预算管理等高级能力。

✨ 新功能

OmO 智能体编排层

• 生命周期钩子框架 — 4 类事件（before_llm_call / after_llm_call / before_tool_call / after_tool_call），200ms 超时降级，失败隔离
• 4 个内置钩子 — session-recovery（畸形消息归一化）、todo-enforcer（强制完成 TODO）、ralph-loop（持续执行）、comment-checker（AI slop 检测）
• Slash 命令系统 — 新增 5 个 OmO 命令：/ulw、/plan、/start-work、/init-deep、/help
• 计划审查 — Momus 审查完整性 + Metis 分析缺口，本地预检 + LLM 复核，并行执行
• InitDeep 自动文档 — BFS 扫描目录并行生成 AGENTS.md
• IntentGate 意图分类 — 300ms 超时降级，8 类 Category 路由（sentinel 默认保持主对话模型不变）

6 个 Discipline Agent

• oracle — 预测角色
• librarian — 资料检索
• explore — 代码探索
• prometheus — 规划
• atlas — 图谱
• sisyphus-junior — 执行

每个角色拥有独立工具边界与系统提示，通过 task 工具分派。

代码智能工具

• AST-Grep — 基于 sg CLI 的 AST 感知代码搜索/重写
• LSP 集成 — JSON-RPC over stdio，诊断/跳转/引用/重命名，10 分钟空闲自动关闭
• Hash-Anchored Edit — SHA3-8 行内容哈希校验，消除 stale-line 错误
• 内置 MCP — Context7（官方文档）+ Grep.app（GitHub 代码搜索），免 API key

性能优化

• 性能预算 — 冷启动 ≤100ms、单消息 ≤500ms、流式 ≥30fps、停止中断 <100ms
• DB 自动清理 — 记录 >1000 自动清理，保留最近 500 条
• 钩子超时 — 默认 200ms 超时降级

其他改进

• 内置工具数量 17 → 23
• Slash 命令 16 → 21
• zx-web 代理引擎改进（freeProvider 路由、builtinMerge、MiMo 适配器）
• 窗口图标颜色匹配
• 设置页新增 5 个 tab：Rules / Hooks / Slash / Routing / Agents

📊 质量保障

• 230+ 单元测试全通过
• 50 个 E2E 验收测试覆盖 28 项需求
• 3 处关键集成缺口已修复（engine 钩子、builtin MCP、settings 默认值）
• 主对话模型不变性验证（7 项测试）
• 6 个 Discipline Agent 分发验证（14 项测试）

📦 下载

• ZX-Code-0.4.0-x64.exe — Windows NSIS 安装包（137 MB）
• 系统要求：Windows 10/11（x64）

---

完整更新日志：与 v0.3.0 的 33 个 commit

v0.30 - 接入真实社区 MCP/Skill 市场

新功能

• 接入 MCP 官方注册表（registry.modelcontextprotocol.io）
• 接入 Smithery 社区市场（registry.smithery.ai，7000+ 服务器）
• MarketCatalog 挂载时并发拉取真实社区条目
• 多 registry 错误隔离，全失败时回退到内置精选目录
• 安装后自动连接 MCP 服务器

Bug 修复

1. fetchListings 添加 User-Agent 头，避免被 API 返回 400
2. installListing 安装后自动调用 connectMcpServer，安装即可用
3. handleConnect 检查 connected 字段，连接失败时显示错误 toast 而非成功 toast

测试

33 个测试覆盖：4 个适配器 + 搜索 + 聚合 + 安装路由 + UI 挂载/渲染/安装/连接状态反馈

下载

• \ZX-Code-0.3.0-x64.exe\ - Windows NSIS 安装包（134.9 MB）

ZX-Code v0.3.0 - 技能进化引擎 + 定时Agent + 用户画像 + 执行轨迹 + 脚本沙箱 + 历史搜索

Bug Fixes (2026-07-13 重新构建)

Agent 系统修复

• autoAccept 绕过 deny 规则 — 修复 autoAccept=true 时跳过整个权限检查块导致 deny 规则失效的安全漏洞，现在 deny 规则在 autoAccept 下始终生效
• 工具参数解析失败仍执行 — 修复 JSON.parse 失败后 parsedArgs 保持空对象导致工具用空参数执行的问题，现在参数解析失败时返回 is_error 并跳过执行
• pendingQuestions 资源泄漏 — 修复 chat:stop 时未清理 onQuestion Promise 导致 10 分钟超时和资源泄漏的问题，新增 cleanupPendingQuestions 在 stop/forceReset 时调用

UI 修复

• Toggle 开关白点卡死 — 修复 framer-motion layout 属性与手动 style.transform 冲突导致开关白点关闭再打开后锁在左边的问题，改用 animate.x 管理位置
• 自动接受工具调用开关失效 — 修复 Toggle 视觉状态与实际 checked 值不同步导致自动接受工具调用开关显示为开但实际为关的问题

测试

• 新增 4 个 Toggle 测试 + 3 个 engine.handleToolCalls 测试 + 2 个 chat.ipc.questions 测试
• 全部 610 个 renderer 测试通过

---

ZX-Code v0.3.0 更新日志 ## 新增功能 ### 技能进化引擎 - GEPA 自我改进 — 基于 Reflective Evolution 理念，自动生成技能变体并用 LLM-as-Judge 评分（adherence / correctness / conciseness） - 语义保留检查 — 进化变体需通过语义偏差检测，确保核心意图不变 - 提升阈值部署 — 仅当变体分数 ≥ 基线 × 1.1 时才部署新版本，避免退化 - 技能自动创建 — Agent 完成复杂任务后自动抽取经验沉淀为可复用技能（skill_create 工具） - 版本管理 — 每次进化保留完整版本历史，可回滚到任意版本 ### 定时 Agent (Cron) - Cron 表达式调度 — 标准 5 字段 cron 格式，如 0 9 * * * 每天 9 点执行 - 自主创建 — Agent 通过 cron_manage 工具创建/列出/删除/切换定时任务 - 安全约束 — allowWriteTools=false 时自动过滤写入类工具 - 执行记录 — 记录每次运行结果、运行时长、摘要 ### 用户画像学习 - 自动抽取 — 对话结束后异步抽取用户画像（技术栈、编码风格、工作模式、沟通偏好、专业水平、语言偏好） - 置信度评分 — 每条画像条目携带 confidence 值 - System Prompt 注入 — 自动将用户画像摘要注入 system message，让 Agent 更懂你 ### 执行轨迹追踪 - 全量记录 — 记录每次 Agent 执行的完整轨迹：迭代轮次、工具调用、参数摘要、结果摘要、耗时、成功/失败 - 统计分析 — 轨迹统计：总轨迹数、总工具调用数、平均耗时、成功率、Top 工具排行 - 多维查询 — 支持按对话 ID、工具名、成功/失败、时间范围查询 - 技能进化数据源 — 执行轨迹作为技能进化评估数据集，实现闭环优化 ### 脚本沙箱 (run_script) - 隔离执行 — 在安全沙箱中执行 JavaScript 代码，可通过 tools.<name>(args) RPC 调用所有已注册工具 - 安全隔离 — 沙箱中不提供 require / process / Buffer 等危险全局对象 - 批量操作 — 适用于批量文件操作、组合工具调用、数据清洗 ### 历史全文搜索 - FTS5 全文索引 — 对话历史基于 SQLite FTS5，支持消息级和对话级搜索 - 文件搜索增强 — 支持文件名 / 内容 / 全部模式，支持正则、大小写、全词匹配 ### 新增内置工具 - cron_manage — 管理定时 Agent 任务（创建/列出/删除/切换） - run_script — 在隔离沙箱中执行 JavaScript 脚本 - skill_create — 从当前任务经验中创建可复用技能 --- ## Changelog (English) ### New Features #### Skill Evolution Engine - GEPA self-improvement — Auto-generates skill variants and scores them with LLM-as-Judge (adherence / correctness / conciseness) - Semantic preservation check — Variants must pass semantic deviation detection - Improvement threshold deployment — New versions deployed only when score ≥ baseline × 1.1 - Auto skill creation — Agent extracts reusable skills from complex task experiences (skill_create tool) - Version management — Full version history with rollback support #### Scheduled Agent (Cron) - Cron expression scheduling — Standard 5-field cron format - Self-managed — Agent creates/lists/deletes/toggles scheduled tasks via cron_manage tool - Safety constraints — allowWriteTools=false auto-filters write tools - Execution records — Logs each run's result, duration, and summary #### User Profile Learning - Auto-extraction — Async extraction of user profile (tech stack, coding style, work patterns, communication preferences, expertise level, language preference) - Confidence scoring — Each profile entry carries a confidence value - System prompt injection — Automatically injects user profile summary into system message #### Execution Trace Tracking - Full recording — Records complete traces: iteration rounds, tool calls, parameter summaries, result summaries, duration, success/failure - Analytics — Trace stats: total traces, total tool calls, average duration, success rate, top tools - Multi-dimensional queries — Query by conversation ID, tool name, success/failure, time range - Skill evolution data source — Traces serve as evaluation datasets for skill evolution #### Script Sandbox (run_script) - Isolated execution — Execute JavaScript in a secure sandbox with RPC access to all registered tools - Security isolation — No dangerous globals (require / process / Buffer) - Batch operations — Suitable for batch file operations, combined tool calls, data cleaning #### Full-text History Search - FTS5 full-text index — Conversation history indexed via SQLite FTS5 - Enhanced file search — Supports filename / content / all modes with regex, case-sensitive, whole-word matching #### New Built-in Tools - cron_manage — Manage scheduled Agent tasks (create/list/delete/toggle) - run_script — Execute JavaScript scripts in an isolated sandbox - skill_create — Create reusable skills from current task experiences

ZX-Code v0.2.0 - 记忆系统 + TTS语音 + 目标看板 + 自动同步

ZX-Code v0.2.0 更新日志

新增功能

记忆与编排系统

• 记忆树架构 — 六分区结构（project / decision / error / preference / subconscious / general），基于 SQLite 持久化
• 自动抽取与召回 — 对话结束后异步抽取关键信息写入记忆；发送消息时按关键词检索 Top-K 记忆注入 system prompt
• Obsidian 导出 — 一键导出为 YAML frontmatter + 按分区子目录的 Markdown vault
• SuperContext 上下文预热 — 发送消息前自动构建简报（相关文件、记忆、历史），800ms 超时降级不阻塞
• TokenJuice 输出压缩 — 工具输出超长时自动压缩，降低 token 消耗 ≥50%
• 持久化目标与看板 — Goal/Task 双层模型，三列看板（todo/doing/done）支持拖拽流转，Agent 可自主管理
• 自动同步与潜意识 — SchedulerService 周期调度 + SubconsciousService 工作区变更摘要 + AutoFetchService 外部数据源拉取
• 托盘"立即同步" — 一键触发自动同步，完成后系统通知

TTS 语音合成

• 三大引擎 — Edge TTS（微软 Neural 音色，免费）/ OpenAI TTS / 自定义 OpenAI 兼容端点
• 双模式 — auto（自动朗读 AI 回复）/ manual（点击按钮手动朗读）
• 语音克隆 — 上传音频样本 + 参考文本，创建专属克隆音色
• 参数调节 — 语速（0.52.0）、音量（0.01.0）、音频格式（mp3/wav）

九宫格新增

• 看板面板 — 九宫格新增"看板"类型，可自由布局

---

Changelog (English)

New Features

Memory & Orchestration System

• Memory tree architecture — Six-partition structure persisted in SQLite
• Auto extraction & recall — Async extraction after conversation; Top-K recall on message send
• Obsidian export — One-click export to Markdown vault with YAML frontmatter
• SuperContext warm-up — Auto-builds briefing before sending (files, memories, history); 800ms timeout fallback
• TokenJuice compression — Auto-compresses oversized tool output, reducing token usage by ≥50%
• Persistent goals & Kanban — Goal/Task dual-layer model with 3-column Kanban and drag-and-drop
• Auto-sync & subconscious — SchedulerService + SubconsciousService + AutoFetchService
• Tray "Sync Now" — One-click sync trigger with system notification

TTS Voice Synthesis

• Three engines — Edge TTS (free) / OpenAI TTS / Custom endpoint
• Dual mode — auto (auto-read replies) / manual (button-triggered)
• Voice cloning — Custom cloned voice from audio sample
• Parameter control — Rate, volume, audio format

9-Grid Addition

• Kanban panel — New "Kanban" panel type for the 9-grid workspace

ZX-Code v0.1.0

ZX-Code 首个发布版本 - Windows 桌面端编程 Agent 智能体应用。

安装

下载下方 \ZX-Code-0.1.0-x64.exe\ 安装包，双击运行即可安装。

主要功能

• AI 对话与多模型支持（OpenAI / Anthropic / Gemini 兼容接口）
• 内置代理引擎与 MCP 工具系统
• 九宫格多会话并行、Live2D/VRM 桌宠、3D 模型渲染
• 文件系统访问权限系统（工作区/外部文件分级授权）
• SQLite 本地存储、终端、项目与工作区管理

系统要求

• Windows 10/11 (x64)

技术栈

Electron + React + TypeScript + Tailwind CSS + Zustand + SQLite