Releases: yubinbin32-ops/ContextOS
Release list
ContextOS v2.6.0
ContextOS v2.6.0 发布说明 (Release Notes)
ContextOS v2.6.0 是一次关键架构与执行能效跃升里程碑。本次更新针对复杂跨系统工程开发中 AI Agent 的上下文膨胀瓶颈进行了深层治理,全面重构了执行脚手架、索引引擎与输出透出机制,并实现了全平台无感动的版本自动演化。
🚀 核心更新内容与重大改进
1. 深度执行脚手架升级与反 ReAct 惯性治理
-
问题痛点:以往大模型在编码时容易陷入“单步试探”(Think-1-Step
$\to$ Run-1-Cmd)的惯性循环,导致轮次成百上千次往返,上下文平方级累积重投,消耗数千万 Token。 -
重构落地:
- 重塑
SKILL.md为开发周期执行脚手架(Execution Scaffolding),建立明确的四阶段状态机(explore全局感知$\to$ inspect/pipeline批量摄取$\to$ change(verify)原子突变$\to$ ship证据收尾); - 引入 “阅读不过二原则” 与批处理反射机制,强制要求跨文件查验与多区间阅读在单轮内一次性聚合请求;
- 实测将复杂多系统任务的交互轮次从 200+ 轮骤降至 10 余轮,Token 消耗直降 90% 以上。
- 重塑
2. 全仓工程资产一等公民化(All-Artifact Topology Indexing)
- 功能升级:彻底打破原有仅索引源码扩展名的限制,解除 AST Bias;
- 覆盖范围:除常见源码外,全面纳管全仓配置文件与工程元数据(
.json、.toml、.yaml、.plist、.env、GitHub Actions Workflow、Docker 及构建脚本); - 收益体验:
explore探索工具可在第一轮首动中即时提取跨端 Manifest(如Cargo.toml、tauri.conf.json、Info.plist等)的结构化槽位([M1],[M2]),杜绝 AI 在未知工程中发起盲目全局搜索。
3. 输出透出机制革新(彻底告别致盲性折叠)
- 智能语义分流:
- 构建与编译日志类输出在成功时保持静默精简;
- 查询检索类命令(
rg、grep、find、cat、sed、git diff等)彻底杜绝单句截断,系统自动聚合输出 唯一匹配文件清单(Distinct Files) 与 Top 20 核心命中。
- 透出控制支持:
pipeline与verify显式支持raw: true与自定义maxChars,使 AI 能在完全受控的前提下获取高信噪比原文,彻底切断 AI 因看不到信息而逃逸至原生 shellcat log的漏洞。
4. 全平台全自动化版本同步(Zero-Manual-Sync Versioning)
- 单一真实源:统一以根目录
package.json为全工程唯一版本来源; - 打包自愈与无感知同步:
- 插件打包(
plugin:build):自动提取根版本并捆绑写入plugin.json与server.json; - macOS 桌面端:打包脚本与 Xcode 生成工程自动对齐
ContextOSVersion.swift、Info.plist与project.pbxproj; - Windows 桌面端:打包与编译期自动更新
Cargo.toml与tauri.conf.json; - 测试挂钩:
npm test自动前置执行全仓版本对齐校验。开发者与 CI 仅需调整根package.json,打包与测试命令执行时即可全自动生效,彻底免去手动执行 sync 脚本的认知负担。
- 插件打包(
5. 源码纯净化与伪代码清理
- 清理 Cloud Hub 及 Worker 中的硬编码 mock 回复与未知假成功响应,恢复严格报错规范;
- 管理 CLI 测试桩全面替换为真实的 SHA-256 架构锚点哈希;
- 移除历史无引用的孤立适配器空目录,平台注入工具全面直连根版本。
💻 下载与安装指引
Windows 用户
- 标准安装包:下载
ContextOS_2.6.0_x64-setup.exe,按安装向导操作即可。 - 免安装绿色版:下载
ContextOS-windows-x64.zip,解压即用。 - 环境要求:Windows 10 / 11 64 位,需配置 Node.js 22+。
macOS 用户
- Apple Silicon (M1/M2/M3/M4):推荐下载内置运行时的
ContextOS-macos-full-arm64.zip(开箱即用,免配置环境)。 - Intel Mac (x86_64):推荐下载内置运行时的
ContextOS-macos-full-x64.zip。 - 轻量版:若本机已具备 Node.js 22+,可下载体积精简的
ContextOS-macos-arm64.zip或x64.zip。 - Gatekeeper 放行:首次运行若提示未验证开发者,可在“访达”中右键选择“打开”放行。
Full Changelog: v2.5.5...v2.6.0
ContextOS v2.5.5
ContextOS macOS 下载与安装
本 Release 使用 ad-hoc 无签名构建。首次启动时 macOS 可能显示安全提示,这是预期行为,按下方步骤处理即可。
1. 先确认 Mac 芯片类型
打开左上角 菜单,选择“关于本机”:
- Apple Silicon(M1、M2、M3、M4 及后续 M 系列芯片):下载文件名中包含
arm64的版本。 - Intel Mac(x86_64):下载文件名中包含
x64的版本。这里的x64就是 Intel 版本,不要选择arm64。
也可以在“终端”执行:
uname -m输出 arm64 代表 Apple Silicon;输出 x86_64 代表 Intel。
2. 选择正确的下载文件
| Mac 类型 | 推荐下载 | 适合谁 |
|---|---|---|
| Apple Silicon | ContextOS-macos-full-arm64.zip |
大多数 M 系列 Mac 用户;已内置 Node.js 22,无需单独安装 |
| Intel | ContextOS-macos-full-x64.zip |
大多数 Intel Mac 用户;已内置 Node.js 22,无需单独安装 |
| Apple Silicon | ContextOS-macos-arm64.zip |
体积更小;要求本机已经安装 Node.js 22 或更高版本 |
| Intel | ContextOS-macos-x64.zip |
体积更小;要求本机已经安装 Node.js 22 或更高版本 |
Full 与 Standard 的区别:
full:完整版,内置 Node.js 22,安装最简单,推荐普通用户下载。- 不带
full:轻量版,不包含 Node.js,只适合已经配置 Node.js 22+ 的开发者。
如果不知道选哪个,请按芯片选择对应的 full 版本。
3. 安装 ContextOS
- 下载对应架构的
.zip文件。 - 双击 zip 解压,得到
ContextOS.app。 - 将
ContextOS.app拖入“应用程序”文件夹。 - 首次启动时,在 Finder 的“应用程序”中右键点击
ContextOS.app,选择“打开”,再确认“打开”。 - 如果系统仍提示无法验证开发者,请在“系统设置 → 隐私与安全性”中允许本次打开。
如果提示应用“已损坏”或“Apple 无法检查是否包含恶意软件”,这是无签名构建被 macOS 添加隔离属性导致的。可执行:
xattr -dr com.apple.quarantine /Applications/ContextOS.app
open /Applications/ContextOS.app不要从其他网站下载 ContextOS;只使用本 Release 页面中的资产。
4. 校验下载文件
同时下载 SHA256SUMS,然后在下载目录执行:
shasum -a 256 ContextOS-macos-full-arm64.zipIntel 用户请将文件名替换为:
shasum -a 256 ContextOS-macos-full-x64.zip将输出与 SHA256SUMS 中同名文件对应的 64 位哈希值比对。两者一致才建议安装。
5. 更新说明
- 从本次修复后的版本开始,ad-hoc 无签名版本可以继续通过应用内更新升级到后续 ad-hoc 版本。
- 已安装的 2.5.1 / 2.5.2 由于旧更新器对 ad-hoc 签名的判定有缺陷,无法通过应用内更新升级;请先按本文档手动覆盖安装一次。
- 覆盖安装只需要替换“应用程序”中的
ContextOS.app。项目数据保存在各项目的.contextos目录中,不会因为替换应用而删除。 - 覆盖安装前请先退出正在运行的 ContextOS。
6. 系统要求
- macOS 14.0 或更高版本。
- Apple Silicon 用户选择
arm64;Intel 用户选择x64。 - Standard 版本需要本机已有 Node.js 22+;Full 版本已内置 Node.js 22。
Full Changelog: v2.5.4...v2.5.5
ContextOS v2.5.4
ContextOS macOS 下载与安装
本 Release 使用 ad-hoc 无签名构建。首次启动时 macOS 可能显示安全提示,这是预期行为,按下方步骤处理即可。
1. 先确认 Mac 芯片类型
打开左上角 菜单,选择“关于本机”:
- Apple Silicon(M1、M2、M3、M4 及后续 M 系列芯片):下载文件名中包含
arm64的版本。 - Intel Mac(x86_64):下载文件名中包含
x64的版本。这里的x64就是 Intel 版本,不要选择arm64。
也可以在“终端”执行:
uname -m输出 arm64 代表 Apple Silicon;输出 x86_64 代表 Intel。
2. 选择正确的下载文件
| Mac 类型 | 推荐下载 | 适合谁 |
|---|---|---|
| Apple Silicon | ContextOS-macos-full-arm64.zip |
大多数 M 系列 Mac 用户;已内置 Node.js 22,无需单独安装 |
| Intel | ContextOS-macos-full-x64.zip |
大多数 Intel Mac 用户;已内置 Node.js 22,无需单独安装 |
| Apple Silicon | ContextOS-macos-arm64.zip |
体积更小;要求本机已经安装 Node.js 22 或更高版本 |
| Intel | ContextOS-macos-x64.zip |
体积更小;要求本机已经安装 Node.js 22 或更高版本 |
Full 与 Standard 的区别:
full:完整版,内置 Node.js 22,安装最简单,推荐普通用户下载。- 不带
full:轻量版,不包含 Node.js,只适合已经配置 Node.js 22+ 的开发者。
如果不知道选哪个,请按芯片选择对应的 full 版本。
3. 安装 ContextOS
- 下载对应架构的
.zip文件。 - 双击 zip 解压,得到
ContextOS.app。 - 将
ContextOS.app拖入“应用程序”文件夹。 - 首次启动时,在 Finder 的“应用程序”中右键点击
ContextOS.app,选择“打开”,再确认“打开”。 - 如果系统仍提示无法验证开发者,请在“系统设置 → 隐私与安全性”中允许本次打开。
如果提示应用“已损坏”或“Apple 无法检查是否包含恶意软件”,这是无签名构建被 macOS 添加隔离属性导致的。可执行:
xattr -dr com.apple.quarantine /Applications/ContextOS.app
open /Applications/ContextOS.app不要从其他网站下载 ContextOS;只使用本 Release 页面中的资产。
4. 校验下载文件
同时下载 SHA256SUMS,然后在下载目录执行:
shasum -a 256 ContextOS-macos-full-arm64.zipIntel 用户请将文件名替换为:
shasum -a 256 ContextOS-macos-full-x64.zip将输出与 SHA256SUMS 中同名文件对应的 64 位哈希值比对。两者一致才建议安装。
5. 更新说明
- 从本次修复后的版本开始,ad-hoc 无签名版本可以继续通过应用内更新升级到后续 ad-hoc 版本。
- 已安装的 2.5.1 / 2.5.2 由于旧更新器对 ad-hoc 签名的判定有缺陷,无法通过应用内更新升级;请先按本文档手动覆盖安装一次。
- 覆盖安装只需要替换“应用程序”中的
ContextOS.app。项目数据保存在各项目的.contextos目录中,不会因为替换应用而删除。 - 覆盖安装前请先退出正在运行的 ContextOS。
6. 系统要求
- macOS 14.0 或更高版本。
- Apple Silicon 用户选择
arm64;Intel 用户选择x64。 - Standard 版本需要本机已有 Node.js 22+;Full 版本已内置 Node.js 22。
Full Changelog: v2.5.3...v2.5.4
ContextOS v2.5.3
ContextOS macOS 下载与安装
本 Release 使用 ad-hoc 无签名构建。首次启动时 macOS 可能显示安全提示,这是预期行为,按下方步骤处理即可。
1. 先确认 Mac 芯片类型
打开左上角 菜单,选择“关于本机”:
- Apple Silicon(M1、M2、M3、M4 及后续 M 系列芯片):下载文件名中包含
arm64的版本。 - Intel Mac(x86_64):下载文件名中包含
x64的版本。这里的x64就是 Intel 版本,不要选择arm64。
也可以在“终端”执行:
uname -m输出 arm64 代表 Apple Silicon;输出 x86_64 代表 Intel。
2. 选择正确的下载文件
| Mac 类型 | 推荐下载 | 适合谁 |
|---|---|---|
| Apple Silicon | ContextOS-macos-full-arm64.zip |
大多数 M 系列 Mac 用户;已内置 Node.js 22,无需单独安装 |
| Intel | ContextOS-macos-full-x64.zip |
大多数 Intel Mac 用户;已内置 Node.js 22,无需单独安装 |
| Apple Silicon | ContextOS-macos-arm64.zip |
体积更小;要求本机已经安装 Node.js 22 或更高版本 |
| Intel | ContextOS-macos-x64.zip |
体积更小;要求本机已经安装 Node.js 22 或更高版本 |
Full 与 Standard 的区别:
full:完整版,内置 Node.js 22,安装最简单,推荐普通用户下载。- 不带
full:轻量版,不包含 Node.js,只适合已经配置 Node.js 22+ 的开发者。
如果不知道选哪个,请按芯片选择对应的 full 版本。
3. 安装 ContextOS
- 下载对应架构的
.zip文件。 - 双击 zip 解压,得到
ContextOS.app。 - 将
ContextOS.app拖入“应用程序”文件夹。 - 首次启动时,在 Finder 的“应用程序”中右键点击
ContextOS.app,选择“打开”,再确认“打开”。 - 如果系统仍提示无法验证开发者,请在“系统设置 → 隐私与安全性”中允许本次打开。
如果提示应用“已损坏”或“Apple 无法检查是否包含恶意软件”,这是无签名构建被 macOS 添加隔离属性导致的。可执行:
xattr -dr com.apple.quarantine /Applications/ContextOS.app
open /Applications/ContextOS.app不要从其他网站下载 ContextOS;只使用本 Release 页面中的资产。
4. 校验下载文件
同时下载 SHA256SUMS,然后在下载目录执行:
shasum -a 256 ContextOS-macos-full-arm64.zipIntel 用户请将文件名替换为:
shasum -a 256 ContextOS-macos-full-x64.zip将输出与 SHA256SUMS 中同名文件对应的 64 位哈希值比对。两者一致才建议安装。
5. 更新说明
- 从本次修复后的版本开始,ad-hoc 无签名版本可以继续通过应用内更新升级到后续 ad-hoc 版本。
- 已安装的 2.5.1 / 2.5.2 由于旧更新器对 ad-hoc 签名的判定有缺陷,无法通过应用内更新升级;请先按本文档手动覆盖安装一次。
- 覆盖安装只需要替换“应用程序”中的
ContextOS.app。项目数据保存在各项目的.contextos目录中,不会因为替换应用而删除。 - 覆盖安装前请先退出正在运行的 ContextOS。
6. 系统要求
- macOS 14.0 或更高版本。
- Apple Silicon 用户选择
arm64;Intel 用户选择x64。 - Standard 版本需要本机已有 Node.js 22+;Full 版本已内置 Node.js 22。
Full Changelog: v2.5.2...v2.5.3
ContextOS v2.5.2
Full Changelog: v2.5.1...v2.5.2
Full Changelog: v2.5.1...v2.5.2
ContextOS v2.5.1
Full Changelog: v2.5.0...v2.5.1
Full Changelog: v2.5.0...v2.5.1
Full Changelog: v2.5.0...v2.5.1
Full Changelog: v2.5.0...v2.5.1
Full Changelog: v2.5.0...v2.5.1
Full Changelog: v2.5.0...v2.5.1
ContextOS v2.5.0
Full Changelog: v2.4.0...v2.5.0
Full Changelog: v2.4.0...v2.5.0
ContextOS v2.4.0
Full Changelog: v2.2.3...v2.4.0
v2.2.2
ContextOS v2.2.2
Spatial architecture canvas and context optimization OS for AI coding agents. Surgical AST code reading/writing across 10+ languages, out-of-context sanitized command execution, persistent project knowledge, read-only documentation drawer, and verified C-D-C-S task lifecycles via MCP.
Downloads & Getting Started
- macOS Full Standalone (Recommended, ~35MB): download
ContextOS-macos-full.zip(unzip and dragContextOS.appto Applications). Bundles a standalone Node 22 runtime engine. Zero external dependencies or Node installation required. - macOS Standard Lite (~1.6MB): download
ContextOS-macos.zip(unzip and dragContextOS.appto Applications). Ultra-lightweight edition for developers who already have Node.js 22+ installed on macOS (via Homebrew, nvm, or official installer). - Headless MCP / CLI:
npx -y github:yubinbin32-ops/ContextOS@v2.2.2(for remote servers, Docker, or CLI-only setups with Node 22+). - Integrity Verification: compare your downloaded files with
SHA256SUMS.
The macOS build is currently ad-hoc signed. On first launch, Control-click the app and choose Open if macOS blocks it.
Full Changelog: v2.2.1...v2.2.2
v2.2.1
ContextOS v2.2.1
Spatial architecture canvas and context optimization OS for AI coding agents. Surgical AST code reading/writing across 10+ languages, out-of-context sanitized command execution, persistent project knowledge, read-only documentation drawer, and verified C-D-C-S task lifecycles via MCP.
Downloads & Getting Started
- macOS Full Standalone (Recommended, ~35MB): download
ContextOS-macos-full.zip(unzip and dragContextOS.appto Applications). Bundles a standalone Node 22 runtime engine. Zero external dependencies or Node installation required. - macOS Standard Lite (~1.6MB): download
ContextOS-macos.zip(unzip and dragContextOS.appto Applications). Ultra-lightweight edition for developers who already have Node.js 22+ installed on macOS (via Homebrew, nvm, or official installer). - Headless MCP / CLI:
npx -y github:yubinbin32-ops/ContextOS@v2.2.1(for remote servers, Docker, or CLI-only setups with Node 22+). - Integrity Verification: compare your downloaded files with
SHA256SUMS.
The macOS build is currently ad-hoc signed. On first launch, Control-click the app and choose Open if macOS blocks it.
Full Changelog: v2.2.0...v2.2.1