Release list

AntNest v1.3.1 Latest

Latest

llxpy released this 29 Aug 07:37

v1.3.1

ae2b728

AntNest v1.3.1 Release Notes

版本：v1.3.1 · 日期：2026-08-29
安装包：AntNest-Setup.exe（单用户安装到 %LOCALAPPDATA%\AntNest，无需管理员权限）
GitHub Tag：v1.3.1

本次更新（v1.3.1）

🎨 UI 统一化修复

输入行水平对齐
- 技能选择 / 模型选择 / 文本输入框 / 发送按钮，四者统一为同一个 38px 水平面（等高、垂直居中、同一基线）。
- 修复前：select 默认内边距 + textarea 旧 padding 导致三者高低不一、视觉错位。
文本输入框自动换行增高
- 输入框由 input 改为 textarea：输入超长自动换行，内容多时自动向上涨高（最高 120px），不再横向滚出。
- Enter = 发送，Shift+Enter = 换行，可粘贴图片。
白色主题精修
- 白色主题全面优化：纯白卡片、更实边框、正文/次要文字对比度拉满、输入与下拉白底 + 聚焦光晕、气泡/思维块/下拉箭头全部适配白底。
- 黑色主题保持原有质感，两主题共用统一设计 token。
下拉框（Skill / 模型）美化
- 统一样式：自定义箭头（SVG）、hover 高亮、聚焦光圈，不再使用系统默认丑下拉。
工作空间（左侧栏）
- 可折叠：点 « 折叠为竖条，点竖条 / » 展开。
- 文件预览：点击工作空间列表项即在栏内预览该目录文件列表（目录优先），并可一键「进入此工作空间」。

🔴 关键修复回顾（v1.3.0→v1.3.1 之间）

停止按钮真正生效：agent_cancel 双命名空间同步（模块级 + AntNest 壳），流式推理可被真正中断、工蚁进程树可被强杀。
关闭窗口 = 真退出：移除 _on_closing 拦截与顶栏「退出」按钮，点 × 即干净退出，不再残留锁导致无法二次打开。
单实例锁自愈：锁文件带时间戳，进程不可达 / 锁龄超过 6 小时 / 上次异常退出（startup_error.log 存在）时自动清锁放行。

✅ 既有能力（v1.3.x 已包含）

蚁后/工蚁架构：任务拆解、工蚁隔离执行（独立进程 + 临时目录）、失败自动重试一次。
深度思考全程可见：任务进行中流式显示推理过程（小卡片内滚动），正文随文本长度自适应。
记忆层：B+ 树思想索引 + RAG 检索（memory_tree.py），每轮检索 NEST.md / hints.md 注入上下文。
自我反思策略：连续 3 次相同工具+同参数 → 注入《自我反思》换方法继续，不再卡死中断。
对话记录：只读「查看」历史（含思维过程）、「恢复上下文」、删除可用；启动不再自动载入全部历史（省 token）。
模型能力画像：按 /models 实测校准 TOKEN_CAP 并注入系统提示词。

安装包核对（上传前自查）

文件	大小	SHA-256
`AntNest-Setup.exe`	6,208,026 字节 (5.92 MB)	`29ce60c00db8ea88213672c167af1e161ec0392f2ff82730ed4b1cca03848170`

注：安装包于 2026-08-29 14:55 编译，版本号 1.3.1。
上传后可用 Get-FileHash .\AntNest-Setup.exe -Algorithm SHA256 校验。

测试验证

全量回归：82 passed + 17 subtests
py_compile 全核心模块通过
node --check JS 语法通过
输入行等高 / 白色主题 / 折叠 / 预览 DOM 渲染冒烟通过

致谢与定位

AntNest（蚁巢）——本地运行 · 蚁后/工蚁架构 · 深度思考实时可见 · 全程掌控本机。
你的 AI，你的电脑，你的规则。

Assets 3

AntNest v1.3.0

llxpy released this 25 Aug 05:03

v1.3.0

d428a36

AntNest v1.3.0 Release Notes

发布：2026-08-25 · Tag：v1.3.0 · Commit：2fe5bb6（main）
安装包：AntNest-Setup.exe（单用户安装到 %LOCALAPPDATA%\AntNest，无需管理员）

一、这次更新了什么（按模块）

1. 严重 Bug 修复（重构拆分遗留的 import 缺失，5 处）

位置	问题	修复
`antnest_queen.py`	`IS_WINDOWS` / `admin_utils` 未导入 → 文件类工具全 NameError	→ `_A().IS_WINDOWS` / 补 `import admin_utils`
`antnest_loop.py`	缺 `import re`、`ThinkRepeatError` 裸用	补 import / → `_A().ThinkRepeatError`
`antnest_loop.py` / `antnest_memory.py`	`COMPACT_PROMPT` 裸用	→ `_A().COMPACT_PROMPT`
`AntNest.py`	无版本号	新增 `__version__ = "1.3.0"`

2. Agent 行为升级

重复调用自我反思：连续 3 次同一工具 + 相同参数 → 不再「中断任务」，改注入《自我反思》指引（重分析目标 → 找失败原因 → 换不同工具/参数/思路继续），清空计数后继续循环。

3. 深度思考实时可见（核心体验）

修复流式思考不可见：UI_STREAM_CB 双命名空间注入（bridge 之前只设 AntNest 壳，而 _stream_emit 读的是 antnest_config 模块变量 → 注入落空）。
思维块任务进行中逐字实时流式显示（小卡片内滚动）。
正文卡片随文本长度自适应（去掉 340px 内滚截断），聊天容器整体滚动。

4. UI 重构

主题精简为：黑色 / 白色 / 自定义色（取色器 + 持久化）。
立绘 → 启动 splash（一次登场、自动淡出、可点击跳过、尊重减少动效）。
右下日志 → 结构化任务状态卡（当前任务 / 开始时间 / 工蚁创建与存活）。
子任务 / 工蚁「展开」→ 卡片式总览模态；长路径 / 长文本自动换行防溢出。
任务多不卡顿：模态网格只在数据变更时同步（不再每 150ms 全量重灌）+ 渲染条数上限（面板 6 / 模态 80，超出显示「还有 N 个」）。
对话记录：主按钮改「查看」→ 只读弹窗（含思维过程）不替换当前上下文；删除真正生效（不再依赖核心懒加载）；保留「恢复上下文」。
模型列表去掉 auto 冗余标签。
窗口 / 任务栏图标 = 应用图标（签名探测兼容旧版 pywebview + Windows API WM_SETICON 兜底）。

5. 记忆与配置

启动自动创建 NEST.md / hints.md 占位（修复记忆线索层静默失效）。
NEST.md 版本评估更新到 1.3.0。
prompts/queen_system.md 增加工蚁 PowerShell 5.1 语法约束。
API Key 独立存 *.key 文件（0600），config.json 不落明文。

二、采用的技术（按大类）

🧠 架构与工程

技术	应用点
单文件 → 多模块拆分	`AntNest.py` 拆出 `antnest_config / llm / loop / memory / queen / bridge / session / runtime_state / schemas / toolforge`
蚁后/工蚁（Queen/Worker）架构	蚁后决策，工蚁隔离执行（独立进程 + 临时目录）
事件驱动 UI	`antnest_bridge` 订阅事件 → 150ms 合并刷新 → 局部更新 DOM
流式事件模型	`phase: start / reasoning_start / reasoning / reasoning_end / content / end`
依赖解耦	主题文件 `queen_system.md` 懒加载；配置 / 密钥分文件存储

🧠 AI / Agent 技术

技术	应用点
流式 LLM 调用	OpenAI 兼容接口，`stream: true` 分块接收
ReAct 循环	`llm_chat_stream` ↔ 工具调用 ↔ 结果回传（`agent_single_loop`）
深度思考（reasoning）透明化	把模型 `reasoning_content` 流式注入 UI（此前仅终端可见）
自我反思策略	重复检测 → 注入反思指令 → 换方法（防死循环）
Rabin-Karp 滚动哈希	检测 thinking 重复内容，自动打断擦除
模型能力画像	`/models` 探测 → 注入系统提示词（TOKEN_CAP / vision / reasoning）

🧠 记忆技术

技术	应用点
B+ 树思想索引	`memory_tree.py` 层级索引记忆条目
RAG 检索	每轮检索 NEST.md / hints.md 相关段落注入上下文
BM25 关键词检索	中文双字滑动窗口（零依赖）
动态用户画像	行为偏好 → 策略参数（verification / autonomy / clarification）
停止快照	`runtime_state.json` 保存决策摘要 / 证据 / 下一步

💻 工程 / 桌面技术

技术	应用点
pywebview	桌面窗口（webview / 浏览器双模式回退）
Windows API	`WM_SETICON`（标题栏/任务栏图标）、`taskkill /T`（进程树）、UAC 检测
Inno Setup	单用户安装包（`%LOCALAPPDATA%`，无管理员权限）
uv	依赖管理（pyproject + uv.lock）
MCP 客户端	stdio / HTTP（Streamable）/ SSE 三种传输

🔧 安全技术

技术	应用点
危险命令过滤	正则拦截递归删除 / 格式化 / 关机等模式
工蚁进程隔离	隔离目录 + 独立子进程
进程树强杀	`taskkill /T` / `os.killpg` 防孤儿进程
输出限额	stdout/stderr 5MB 泵取防管道死锁；TOOL_RESULT_LEN 截断
密钥隔离	独立 `.key` 文件（0600），config.json 不落明文
路径越界校验	文件工具末尾 `is_relative_to(project_dir)` 防路径穿越

三、总结

v1.3.0 = 架构重构落地（多模块拆分）＋深度思考从「黑盒」变「实时可见」＋ Agent 从「会卡死」变「会自我反思」＋ UI 从「堆功能」变「结构化不卡顿」＋记忆从「文件缺失静默失效」变「自动占位可检索」。
全程用事件驱动、流式推送、B+ 树 / RAG 记忆、进程隔离这些本地方案的技术，让你的 AI 真正掌控你的电脑。

四、验证

全量回归：82 passed + 17 subtests；关键文件 py_compile 通过。
启动路径旧版 / 新版 pywebview 双模拟实测通过；图标兜底线程验证接入。

Assets 3

AntNest v1.2.4

llxpy released this 22 Aug 03:37

v1.2.4

1152c2b

🆕 新功能

功能	说明
管理员模式	新增 admin_utils.py（350 行），检测管理员权限，危险命令执行前弹窗确认
Android 客户端 v1.0.0	全新 Android 应用（Kotlin + Jetpack Compose），含聊天、设置、记忆管理
单实例锁	防止多开，重复启动弹窗提示并退出
最小化到任务栏	关闭窗口时最小化而非退出，后台持续运行
会话自动加载	启动时自动恢复上次对话记录
工蚁超时可配置	新增 config/agent/worker_timeout（默认 300 秒），支持 ANT_WORKER_TIMEOUT 环境变量

🐛 Bug 修复

修复	说明
Base URL 校验	启动时校验 API Base URL，空值或缺协议前缀自动回退默认值
WebView2 失败日志	初始化失败时写入 .antnest/startup_error.log [blocked]，不再静默崩溃
task_manager.py 打包遗漏	补入工蚁依赖复制列表和安装器清单
管理员模式 IME 修复	WebView2 在 UAC 提升后输入法候选框被遮挡，设置独立用户数据目录解决
_start_webview 缺失 import	补 import os，修复 UnboundLocalError

Assets 3

AntNest v1.2.3

llxpy released this 21 Aug 05:28

v1.2.3

dc1c6c9

新增功能
🐜 任务状态机与验证工蚁
新增 task_manager.py：任务全生命周期管理（pending → running → done → verified）
spawn_clone 新增 verify 参数：设为 true 时自动派验证工蚁确认执行结果
新增 get_task_status 工具：蚁后可随时查看任务状态
返回结果自动注入 task_id 和 task_status 字段
🪟 窗口持久化与会话恢复
单实例锁：防止多开，重复启动时弹窗提示
最小化到任务栏：关闭窗口时最小化而非退出，后台持续运行
会话自动加载：启动时自动恢复上次对话记录，打开即可继续
标题栏新增「⏻ 退出」按钮用于真正退出应用
⏱ 工蚁超时可配置
新增配置项 agent.worker_timeout（默认 300 秒）
支持环境变量 ANT_WORKER_TIMEOUT
spawn_clone 的 timeout 参数默认使用配置值
错误修复
🌐 API 配置校验
启动时校验 Base URL：空值或缺少协议前缀时自动回退默认值并提示
detect_model_len() 对无效 URL 安全回退，不再抛出 ValueError
GUI 模型检测拒绝无效 URL，返回结构化错误
🖥 WebView2 稳定性
WebView2 初始化失败时自动回退到浏览器模式，不再崩溃
失败详情写入 .antnest/startup_error.log，包含完整 traceback
🔧 MCP 服务端容错
单个 MCP server 初始化失败不再阻塞其他 server
新增 server_status 字段，追踪每个 server 的状态（ready / failed / starting）
工程改进
📦 发布流程
新增 tools/release_check.ps1：26 项发布前检查
版本号统一由 pyproject.toml 管理，构建脚本自动同步
GitHub Actions 先安装项目依赖再运行测试
安装方式
安装包（推荐）
下载 AntNest-Setup.exe，双击运行。

便携使用
bash

git clone https://github.com/llxpy/AntNest.git
cd AntNest
uv sync
uv run python prototype_antnest.py
直接启动
双击项目根目录 AntNest.exe（GUI 启动器，无控制台窗口）。

系统要求
Windows 10/11（64 位）
Python 3.12+
uv（首次运行自动安装）
WebView2 Runtime（Windows 11 自带）

Assets 3

AntNest v1.2.2

llxpy released this 16 Aug 09:56

v1.2.2

fc6d462

更新日志

[1.2.2] — 2026-08-16

当前发布版本。相对 1.2.1 的修复汇总；此前测试期已合入代码、但记在错误版本号下的改动，一并归并到本条。

安全加固（1.2.2 核心）

S1 · API Key 不再明文落盘：新增独立密钥文件 config.json.key（权限 0600，已 gitignore）；config.json 只保留空 api_key，UI 保存时改写密钥文件、不再回写明文。AntNest.py 启动与 antnest_bridge.load_settings 均优先从密钥文件读取。
S2 · 危险命令过滤覆盖递归删除：重写蚁后 _DANGER_CLI_PATTERNS 与工蚁 dangerous_patterns，拦截 rm -rf /、盘符、~/$HOME、..、.、*、裸 rm -r/-R 绝对路径，以及 format/shutdown/halt/mkfs/dd if=/dev/zero/Remove-Item -Recurse|-Force/fork bomb；项目内相对递归删除（如 rm -rf node_modules）仍放行。
S3 · 蚁后不再主进程直执行 run_python：get_queen_tools 移除 run_python_schema，需要跑 Python 改走工蚁隔离目录执行（复用 S2 过滤）。run_python 函数保留但不再作为蚁后可达工具。
S4 · 路径越界校验：code_tools.resolve_path 末尾加 is_relative_to(project_dir) 校验，越界（绝对路径 / ../）直接 raise；五个文件工具 try/except 返回错误 JSON，杜绝路径穿越传給工蚁。
S5 · web_fetch 协议白名单：先 urlparse 校验 scheme，仅允许 http/https，拒绝 file:///ftp:// 等（防本地文件读取与 SSRF）。
工蚁调用无限递归 / OOM 修复：antnest_clone_worker.run_if_clone_mode 启动命令子进程前，显式 pop 掉全部 AN_CLONE_* 控制环境变量。命令内 import AntNest 不再 re-enter clone 模式，从源头断开进程无限堆叠。

稳定性与资源上限

单任务轮次上限（默认 60，ANT_MAX_ROUNDS 可调），超限强制总结，根治自检循环卡死。
工蚁 stdout/stderr 各限 5MB（双线程泵取防管道死锁）；run_python 输出超 2MB 截断。
ui_trace.log 5MB 轮转；产出归档 .antnest/artifacts/ 仅留最近 50 个；UI 聊天 DOM 仅渲染最近 300 条。
重复调用检测：连续 3 次以相同参数调用同一工具自动中断循环。
克隆目录自愈：spawn_clone 前仅保留最近 20 个，强杀残留下次自动清。

进程与工蚁生命周期

超时 / 停止 / 取消改杀进程树（taskkill /T 或 os.killpg），根治 python.exe 孤儿堆积。
HTTP 400「insufficient tool messages」兜底：工具循环中断后从后往前补齐 assistant tool_calls 缺失的 tool 响应，避免消息永久损坏。
工蚁失败自动重试一次；产出文件回收归档到 .antnest/artifacts/<clone_id>/；并行工蚁统一登记，「停止」可终止全部。

记忆与工具

BM25 记忆检索（新增 memory_retrieval.py，零依赖，中文双字滑动窗口），每轮思考前注入 NEST.md / hints.md 相关段落。
run_python（经工蚁隔离执行）、web_fetch（urllib 实现，无第三方依赖）工具；run_cli 危险命令保护。

UI / 体验

多会话「🕘 对话记录」：历史会话列表可恢复 / 删除 / 新建，兼容旧版单会话文件自动迁移。
token 用量实时显示；工蚁产出文件浏览标签；深度思考内联展开；暗色主题暖色光晕层次；新应用图标 antnest.ico；日志 DOM 超过 500 条自动重置同步。

打包与测试

pyproject.toml 补 memory_retrieval 模块（editable/whl 安装下 import 不再失败）；测试依赖补 pytest。
安装包配置模板 installer/config.template.json 补齐 thinking_mode / skip_model_check / default_token_cap（与 config.example.json 对齐）。
死代码清理（_memory_tokenize、_summarize_tool_kwargs）；魔法数字统一为命名常量（_ARTIFACTS_MAX_KEEP / _CLONE_POOL_MAX_KEEP / _RUN_PYTHON_OUTPUT_CAP / _MEMORY_TOP_K / _DUP_CALL_LIMIT / MAX_CHATS 等）。
全量单元测试 47 passed / 17 subtests passed。

文档

README §5.1 配置详解补充 thinking_mode / skip_model_check / default_token_cap 字段示例与说明。

[1.2.0] — 2026-08-13

架构与核心

蚁后不再直接读写磁盘：文件操作全部经工蚁执行（view_file / list_dir / grep_files / write_file / search_replace）
新增 code_tools.py：路径解析、工蚁脚本构建、结果解包
拆分模块：antnest_clone_worker.py（工蚁入口）、antnest_session.py（会话持久化）
工蚁隔离目录随包复制依赖模块，修复拆分后 spawn_clone 无法 import 的问题
记忆压缩 leave_memory_hints 修复 UI 模式下 nest_md 未定义崩溃

Skills（Hermes 兼容）

新增 skills_loader.py：解析 SKILL.md YAML frontmatter，递归扫描目录
选中 Skill 时将完整正文注入上下文（不再只是 [Skill: xxx] 前缀）
设置面板支持 Skills 目录配置与管理页刷新

MCP

新增 mcp_client.py：最小 stdio MCP 客户端
设置中启用 MCP 后，蚁后可调用 mcp_call / mcp_list_tools
提供 mcp.json.example 配置示例

UI / 体验

聊天气泡流式输出；深度思考可折叠展示
■ 停止：强行中断 LLM 流与正在运行的工蚁
每轮新任务清空右侧子任务 / 工蚁监控
设置面板重设计（分区、开关、密码框 API Key）
CSS / JS 拆至 ui_assets/，ui_render.py 负责渲染
修复设置按钮打不开（app.js 语法错误）
修复 Skill 下拉一点就消失（焦点抢夺冲突）
文本可选中；运行日志按行追加，不做字符级流式刷新

Assets 3

AntNest v1.2.1

llxpy released this 14 Aug 02:32

v1.2.1

d18e10e

相对 v1.1.0 的变更

1. 多模型 API 兼容层（新增 `api_compat.py`）

之前不同大模型 API 参数不兼容：Kimi 拒绝空 assistant content、MiniMax 不支持 thinking 字段、模型列表接口差异导致校验误报。本版新增提供商识别与自适应：

提供商自动识别：按 base_url 识别 DeepSeek / MiniMax / Kimi / OpenAI / 本地兼容（Ollama 等），无需手动配置。
参数自适应：
- Kimi：temperature 强制 1.0、自动关闭 thinking、发送前规范化 messages（空 assistant content 补占位符、剥离 reasoning_content）
- MiniMax：自动关闭 thinking、跳过 /models 检测（部分服务该接口不可用）
- DeepSeek：保留 reasoning_content，thinking 按 auto 适配
- OpenAI / 本地兼容：按默认参数走
strict 消息键过滤：Kimi / MiniMax / OpenAI 兼容服务发送前只保留 role/content/name/tool_calls/tool_call_id 五个键，杜绝多余字段被拒。
涉及文件：api_compat.py（新增）、antnest_bridge.py、prototype_antnest.py。

2. MCP 空问题修复

MCP 配置文件不存在时优雅跳过（之前空配置会走加载流程导致报错/卡顿），并提示「复制 mcp.json.example 为 mcp.json，或在设置中关闭 MCP」。
空 mcp_config 设置不再触发异常路径。
涉及文件：antnest_bridge.py、mcp_client.py。

3. 大模型检测（设置面板「检测模型列表」）

后台拉取 /models 列表：新增 list_models_async，设置面板可一键检测当前 API 下所有可用模型。
模型能力标注：每个模型标注是否支持图片输入（vision），新增 MiniMax / abab / vl- / -vl 视觉关键词。
推荐参数随模型联动：每个检测到的模型附带推荐配置（thinking / skip_model_check / 提示语），选择后自动应用。
涉及文件：antnest_bridge.py、ui_assets/app.js。

4. 配置新增

{
  "api": {
    "base_url": "https://api.deepseek.com/v1",
    "model_name": "deepseek-chat",
    "api_key": "sk-你的密钥",
    "thinking_mode": "auto",
    "skip_model_check": false
  }
}

thinking_mode：auto / on / off，按提供商自动适配，可手动覆盖。
skip_model_check：跳过 /models 校验（部分服务该接口返回异常）。
安装包内置空 key 模板，不携带真实密钥；首次运行后在设置界面填自己的 key。

5. 测试与质量

新增测试：test_api_compat.py（169 行）、test_mcp_client.py（174 行）、test_skills_bridge.py（103 行）。
测试套件 38 项全部通过（3.97s）。
CI 沿用 .github/workflows/test.yml，改动即时回归。

已知限制

安装包 / uvx 分发未签名，无 SmartScreen 信任（首次运行点「更多信息 → 仍要运行」）。
第三方输入法候选悬浮窗在 WebView2 后端可能不弹（微软拼音开「兼容性 → 使用以前版本」即可；或 ANT_WEBVIEW_GUI=cef 换 CEF 后端）。
仅 Windows 桌面 UI（WebView2/CEF）；macOS/Linux 暂未验证。
单用户安装（%LOCALAPPDATA%），全机 / Program Files 安装未做。
/models 检测依赖服务端支持该接口；不支持的提供商（如部分 MiniMax 区域）会自动走 skip_model_check。

完整文档

见仓库 README.md。

Assets 3

AntNest v1.2.0

llxpy released this 13 Aug 10:23

v1.2.0

9872227

蚁后 / 工蚁架构的 AI 编程助手，带原生桌面界面（pywebview + WebView2）。
v1.1.0 已稳定了启动性能、桌面 UI 打磨、安装器简体中文向导与依赖预装等基础问题；本版本（v1.2.0）在此基础上重点扩展工蚁能力，并将桌面 UI 整体重构为暗面构建风格（PHtmlWin）。

⚠️ 本次发布的安装包包含一项关键修复（见文末「安装包修复」）。在此之前用旧安装包装出的实例启动即崩溃，请下载本版本安装包。

相对 v1.1.0 的主要更新

工蚁能力扩展
文件操作（code_tools.py）：工蚁新增对本地文件的读写 / 操作能力，能在实际任务里直接改文件、跑命令，而不只是输出建议。
克隆工蚁并行（antnest_clone_worker.py）：支持多只工蚁并行执行子任务，蚁后派发后各自归巢汇总。
MCP 工具接入（mcp_client.py）：蚁后 / 工蚁可接入外部 MCP 工具，扩展可用工具面。
会话管理（antnest_session.py）：新增会话相关能力。
Skills 系统（skills_loader.py）
内置 / 用户 Skills 的加载与管理更顺手，设置页「管理 Skills」弹窗可列出 .baim 与含 SKILL.md 的目录。
桌面 UI 重构 —— 暗面构建 / PHtmlWin
UI 层整体重构为 ui_render.py + ui_assets_loader.py，样式 / 脚本抽到 ui_assets/（app.css / app.js），统一为暗面构建视觉语言。
延续既有体验：思考状态提示、图片输入 + vision 检测、Skill 选择等。
Bug 修复
修复若干已知问题（含聊天发送按钮等致命问题）。
安装包修复（本版本关键）
此前 v1.2.0 的安装包（AntNest-Setup.exe）在打包时漏打了 v1.2.0 新增的 7 个 Python 模块与 ui_assets/ 资源，导致安装后双击 AntNest.exe 立即 ImportError 崩溃。本版本安装包已修复：

补打包：code_tools.py、skills_loader.py、mcp_client.py、antnest_clone_worker.py、antnest_session.py、ui_render.py、ui_assets_loader.py
补打包资源目录：ui_assets/（含 app.css / app.js）
AntNest.exe 文件版本号从 1.1.0 同步修正为 1.2.0
请重新下载本版本安装包覆盖安装；已用旧安装包装出的目录建议先卸载再装，确保模块完整。

分发方式（三选一）
安装包（推荐普通用户）：下载 AntNest-Setup.exe，双击安装到 %LOCALAPPDATA%\AntNest，开始菜单 + 桌面快捷方式。
uvx（开发者）：uvx --from git+https://github.com/llxpy/AntNest antnest
launch.bat（免安装）：下载 zip，双击 launch.bat（自动装 uv 拉起）。
已知限制
安装包 / uvx 分发未签名，无 SmartScreen 信任（首次运行点「更多信息 → 仍要运行」）。
首次运行需联网：uv 建 venv + 装 pywebview，以及 WebView2 运行时（已装则跳过）。
第三方输入法候选悬浮窗在 WebView2 后端可能不弹（微软拼音开「兼容性 → 使用以前版本」；或 ANT_WEBVIEW_GUI=cef 换 CEF 后端，需 Python<3.12）。
仅 Windows 桌面 UI；macOS / Linux 暂未验证。
单用户安装（%LOCALAPPDATA%），全机 / Program Files 安装未做。
完整文档
见仓库 README.md。

Assets 3

AntNest v1.1.0

llxpy released this 10 Aug 08:24

v1.1.0

1beeb77

AntNest v1.1.0

蚁后 / 工蚁架构的 AI 编程助手，带原生桌面界面（pywebview + WebView2）。
本版本聚焦启动性能修复与桌面 UI 打磨，并新增内置更新检查、赞助作者二维码与设置弹窗体验优化，无破坏性变更，分发方式与 v0.1.0 一致。

相对 v0.1.0 的变更

1. 启动性能修复（GitHub Issue：双击 AntNest.exe 每次等 ~30s 且必须联网）

根因：installer/ 下 4 个 ps1 硬编码路径检测逻辑在常见环境误判，每次启动都重跑预检查。

uv 检测补全路径：除 %LOCALAPPDATA%\uv\uv.exe 外，新增 ~\.local\bin、%LOCALAPPDATA%\uvx 等回退，避免新版 uv 被误判为未装。
WebView2 检测改为「文件系统存在性 + 多注册表键」（HKLM/HKCU × WOW6432Node/正常），兼容 Win11 中国版（本机装了但缺某注册表键）。
新增 marker 文件 %LOCALAPPDATA%\AntNest\.prereq_ok：预检查通过后写入，下次启动做轻量本地复检即跳过，不再每次联网重装。

2. 桌面 UI 打磨

思考状态透明提示：聊天框上方小字透明显示蚁后 / 工蚁当前状态（拆解任务、派发子任务、工蚁执行中 / 归巢）。
图片输入 + 发送前 vision 检测：支持 Ctrl+V 粘贴图片、点击图片按钮上传；必须「已配置 API Key 且模型支持图片」才放行，否则图片按钮灰化禁用并提示原因。
Skill 选择：聊天框左侧下拉选择要附加的 Skill，发送时自动加 [Skill: xxx] 前缀。
Skills 目录配置更顺手：设置页加「浏览…」按钮（tkinter 文件夹对话框）+「管理 Skills」弹窗。
Bug 修复：设置页 Skills 目录输入框误显示 [<phtmlwin.El object ...>] 已修复。

3. 安全模型（同 v0.1.0）

进程级隔离（工蚁独立子进程、临时目录执行，完即销毁）+ 危险命令过滤。工蚁不加载 LLM、不连 API。

4. 配置（同 v0.1.0）

config.example.json 复制为 config.json 填 key（或环境变量 ANT_API_KEY）。安装包内置空 key 模板，不携带真实密钥。

5. 内置更新检查（仅提示，不自动下载）

启动后后台线程查询 GitHub Release releases/latest，发现新版本顶部弹提示条 +「查看更新」「忽略」。
「查看更新」在浏览器打开 Release 页；不自动下载/执行，规避未签名分发的供应链投毒风险。
离线 / 限流 / 解析失败全部静默；走 urllib 标准库，零新增依赖。

Assets 3

v1.0.0 正式版

llxpy released this 10 Aug 01:48

v1.0.0

b139910

AntNest 1.0 正式版

首个完整发行安装包
安装向导简体中文界面
安装时自动安装 uv 并预装依赖（install_deps.ps1，可见窗口避免假死）
内置中文语言包 ChineseSimplified.isl，不依赖 Inno Setup 自带

安装包

AntNest-Setup.exe

Assets 3

Releases: llxpy/AntNest

Release list

AntNest v1.3.1

AntNest v1.3.1 Release Notes

本次更新（v1.3.1）

🎨 UI 统一化修复

🔴 关键修复回顾（v1.3.0→v1.3.1 之间）

✅ 既有能力（v1.3.x 已包含）

安装包核对（上传前自查）

测试验证

致谢与定位

Uh oh!

AntNest v1.3.0

AntNest v1.3.0 Release Notes

一、这次更新了什么（按模块）

1. 严重 Bug 修复（重构拆分遗留的 import 缺失，5 处）

2. Agent 行为升级

3. 深度思考实时可见（核心体验）

4. UI 重构

5. 记忆与配置

二、采用的技术（按大类）

🧠 架构与工程

🧠 AI / Agent 技术

🧠 记忆技术

💻 工程 / 桌面技术

🔧 安全技术

三、总结

四、验证

Uh oh!

AntNest v1.2.4

Uh oh!

AntNest v1.2.3

Uh oh!

AntNest v1.2.2

更新日志

[1.2.2] — 2026-08-16

安全加固（1.2.2 核心）

稳定性与资源上限

进程与工蚁生命周期

记忆与工具

UI / 体验

打包与测试

文档

[1.2.0] — 2026-08-13

架构与核心

Skills（Hermes 兼容）

MCP

UI / 体验

Uh oh!

AntNest v1.2.1

相对 v1.1.0 的变更

1. 多模型 API 兼容层（新增 api_compat.py）

2. MCP 空问题修复

3. 大模型检测（设置面板「检测模型列表」）

4. 配置新增

5. 测试与质量

已知限制

完整文档

Uh oh!

AntNest v1.2.0

Uh oh!

AntNest v1.1.0

AntNest v1.1.0

相对 v0.1.0 的变更

1. 启动性能修复（GitHub Issue：双击 AntNest.exe 每次等 ~30s 且必须联网）

2. 桌面 UI 打磨

3. 安全模型（同 v0.1.0）

4. 配置（同 v0.1.0）

5. 内置更新检查（仅提示，不自动下载）

Uh oh!

v1.0.0 正式版

AntNest 1.0 正式版

安装包

Uh oh!

1. 多模型 API 兼容层（新增 `api_compat.py`）