Skip to content

Releases: MagicalYuYu/agent-operating-system

Release list

v2.0.0-rc.1

v2.0.0-rc.1 Latest
Latest

Choose a tag to compare

View all tags
@MagicalYuYu MagicalYuYu released this 08 Oct 03:01
v2.0.0-rc.1
e5b1ec6

AOS 是运行在类 Claude Code agent harness 上的个人文件治理层：harness 提供运行时，AOS 提供数据治理与工作流约定。

v2 是一次重写。前身 v1 面向 TRAE 平台，通过文件模拟操作系统补足平台缺失的调度与状态能力；迁移到 DeepSeek Harness（DSH）后这层模拟不再必要，v2 回归纯粹的文件治理层，目录结构从 11 个精简为 8 个，常驻上下文开销降低约一个数量级。v1 已冻结于 tag v1.1.0，仍可正常使用。

本版内容

  • 8 目录宪章与 4 条铁律（AGENTS.md 内核，不足百行）
  • 指针表记忆（INDEX 指针 + 32KB 上限 + 历史剪切）
  • 双层日志（平台会话档案 + 人类可读叙事层，后者随平台迁移）
  • 7 个治理 skills 与 4 个校验 / 对齐 / 索引脚本
  • 平台支持：DSH 完整适配；任何读取 AGENTS.md 约定的工具通用适配

关于 rc

核心结构经一段时间实际使用检验，文档与细节仍在打磨，正式版前可能有少量调整。欢迎在 Discussions 交流使用体验。

上手

把这句话发给你在用的 AI 工具（DSH、Claude Code、Codex 等均可）即可完成部署：

部署 AOS：克隆 https://github.com/MagicalYuYu/agent-operating-system 到 <你的目标路径>，阅读仓库根目录的 AGENTS.md 理解目录约定，运行 python scripts/check_placement.py 验证结构、有报错按提示修复，最后告诉我使用时需要注意的约定要点。

手动步骤见 README。v1 用户请读 docs/MIGRATION.md。

文档

  • 架构参考：组成部分与运转机制（docs/architecture.md）
  • 设计思路：每个设计的依据与数据（docs/design-rationale.md）
  • 文件落位约定（docs/file-conventions.md）
  • v1 迁移指南（docs/MIGRATION.md）
Assets 2
Loading

AOS v1.1.0 — OS-form Agent Runtime Framework

AOS v1.1.0 — OS-form Agent Runtime Framework

Choose a tag to compare

View all tags
@MagicalYuYu MagicalYuYu released this 26 Jun 15:36
v1.1.0
53c7cc8

AOS v1.1.0 Release Notes

发布日期：2026-06-26
版本：1.1.0

版本亮点

v1.1.0 是 AOS 的第二个正式版本，本次更新的核心是 AOS Viewer 可视化界面——让你的 AI 操作系统有了自己的"控制台"。

新增功能

🖥 AOS Viewer 可视化界面

AOS 自带一个 Liquid Glass 玻璃拟态风格的仪表盘，让你一眼看清系统全貌：

  • 只读仪表盘：系统总览 / Skill 管理 / 项目工作区 / 记忆中心 / 知识库 / Loop 监控 / 日志查看器
  • 控制台：一键触发自检 / 迁移采集等内置脚本
  • 两种启动方式：
    • 桌面窗口模式（PyWebView）
    • 浏览器模式（直接打开 index.html）
  • i18n 国际化：内置 zh-CN / en-US 双语切换
  • Spotlight 全局搜索：搜索模块 / Skill / 项目 / 记忆 / 知识，含关键词高亮
  • 菜单栏 + 下拉菜单：文件 / 视图 / 工具 / 帮助 四大菜单
  • 三种主题：深色 / 浅色 / 极简
  • 启动动画：Boot Screen + 动态背景光晕

📊 数据生成脚本

新增 aos_generate_data.py，扫描 AOS 文件系统自动生成 data.js：

  • 解析 00_BOOT/SYSTEM_STATE.md → 组件状态、运行时统计、事件日志
  • 解析 00_BOOT/SKILL_REGISTRY.md → Skill 列表
  • 扫描 01_PROJECTS/ → 项目列表（AGENTS.md + STATUS.md + README.md）
  • 扫描 04_MEMORY/ → 记忆索引和内容
  • 扫描 09_REFERENCE/ → 知识库索引和内容

📋 巡检规范

新增系统级 + 项目级双层巡检规范：

  • 00_BOOT/SYSTEM_INSPECTION.md — 系统级巡检（独立专用会话执行）
  • 00_BOOT/PROJECT_INSPECTION.md — 项目级巡检（项目工作会话前置）
  • 四类文件分类标准（A 冗余 / B 过时 / C 留存 / D 迁移）
  • 统一的路径层级规范（项目名 → 模块名 → 类型 → 日期）

改进

项目类型识别

  • 新增"项目集"识别：AGENTS.md 含"子项目清单" section 即自动判定为项目集
  • 支持插件集、微服务集等多种项目集形态

项目状态解析

  • 重写状态解析逻辑，支持 4 级优先级（元信息状态 → 当前阶段 → 阶段统计 → 全文搜索）
  • 支持中文状态标记（✅完成 / 🔄进行中 / ⏳待办）和无 emoji 格式
  • 支持英文状态标记（completed / pending / in_progress）

项目描述解析

  • 跳过标题 / 引用 / 分割线 / 徽章 / 图片 / 目录 / 表格 / 代码块行
  • 取第一个完整段落，截断到 300 字符

示例项目

新增 3 个精心制作的示例项目，演示不同项目类型的标准结构：

  • _example_cli_tool — 单一项目（Python 日志分析工具，零外部依赖）
  • _example_game_localization — 单一项目（游戏本地化，翻译文件 + 完整流程文档）
  • _example_plugin_suite — 项目集（聊天机器人插件集合，含 3 个独立插件 + EventBus 通信）

文档体系

  • 所有目录 README 统一更新为 v1.1.0
  • 新增 5 个目录 README：01_PROJECTS / 05_CACHE / 06_LOGS / 08_INBOX / 99_ARCHIVE
  • 跨平台适配说明（TRAE / Claude Code / Codex）

升级指南

从 v1.0.0 升级

v1.1.0 引入了 AOS Viewer 可视化界面、项目类型识别、巡检规范拆分等多项变更。为不同使用习惯的用户提供两种升级方式：

方式一：Agent 辅助更新（推荐）

在 Trae / Claude Code / Codex 对话框中输入："请通过 WebFetch 读取 https://raw.githubusercontent.com/MagicalYuYu/agent-operating-system/main/07_EXPORTS/aos_viewer/AOS_UPDATE_PROMPT_1.1.0.md 并执行其中的更新流程"，Agent 将自动执行完整的 8 步升级流程（需 GitHub 网络访问权限）：

  1. 环境扫描（检测当前版本 / 用户项目 / 自定义规则）
  2. 备份（含 MD5 清单，可回滚）
  3. 获取 1.1.0 文件（支持 GitHub Release 下载 / git clone / 本地目录三种方式）
  4. 合并修改文件（分级处理：L1 直接覆盖 24 新增 / L2 智能合并 12 修改 / L3 删除迁移 1 文件）
  5. 版本号同步（14 处文件位置）
  6. 生成 data.js（AOS Viewer 数据源）
  7. 一致性自检
  8. 验证 AOS Viewer

备选：若 Agent 不支持 WebFetch 或无 GitHub 访问权限，请先从 Release 下载 aos-1.1.0-source.zip 解压后，改用本地路径："请读取 <解压路径>/07_EXPORTS/aos_viewer/AOS_UPDATE_PROMPT_1.1.0.md 并执行其中的更新流程"

方式二：手动升级

参照 MIGRATION_GUIDE_1.1.0.md 手动完成 10 步升级，含完整 PowerShell 命令示例、回滚方案和常见问题排查。

关键变更点

类别 处理方式 说明
03_TOOLS/aos_viewer/ 直接复制 1.0.0 不存在，整个目录新增
03_TOOLS/scripts/aos_generate_data.py 直接复制 数据生成脚本，1.0.0 不存在
AGENTS.md 智能合并 新增"项目内标准结构"章节，保留你的自定义规则
00_BOOT/SYSTEM_STATE.md 智能合并 更新版本号至 1.1.0，保留你的运行时统计与事件日志
00_BOOT/DAILY_INSPECTION.md 删除并迁移 拆分为 SYSTEM_INSPECTION.md + PROJECT_INSPECTION.md
14 处版本号引用 同步更新 1.0.0 → 1.1.0（详见升级指南中的版本号同步表）

验证

升级完成后运行自检脚本：

python 03_TOOLS/scripts/aos_check.py

输出 一致性验证：通过 即表示升级成功。

完整变更日志

新增文件

  • 03_TOOLS/aos_viewer/ — AOS Viewer 可视化界面（前端 + 服务端 + 打包配置）
  • 03_TOOLS/scripts/aos_generate_data.py — 数据生成脚本
  • 00_BOOT/SYSTEM_INSPECTION.md — 系统级巡检规范
  • 00_BOOT/PROJECT_INSPECTION.md — 项目级巡检规范
  • 01_PROJECTS/_example_cli_tool/ — CLI 工具示例项目
  • 01_PROJECTS/_example_game_localization/ — 游戏本地化示例项目
  • 01_PROJECTS/_example_plugin_suite/ — 插件集示例项目
  • 01_PROJECTS/README.md — 01_PROJECTS 目录说明
  • 05_CACHE/README.md — 05_CACHE 目录说明
  • 06_LOGS/README.md — 06_LOGS 目录说明
  • 08_INBOX/README.md — 08_INBOX 目录说明
  • 99_ARCHIVE/README.md — 99_ARCHIVE 目录说明

修改文件

  • README.md — 补充 AOS Viewer 介绍、修正 TRAE 品牌、新增 v1.1.0 特性
  • AGENTS.md — 巡检规范引用更新
  • 00_BOOT/SYSTEM_STATE.md — 版本号同步至 1.1.0
  • 00_BOOT/SKILL_REGISTRY.md — 版本号同步
  • 所有目录 README.md — 版本号统一更新为 v1.1.0
  • 03_TOOLS/scripts/aos_check.py — 排除范围调整
  • .gitignore — 白名单模式更新
Loading

AOS v1.0.0 — Initial Release

AOS v1.0.0 — Initial Release

Choose a tag to compare

View all tags
@MagicalYuYu MagicalYuYu released this 21 Jun 12:24
v1.0.0
fac7948

AOS v1.0.0 — Initial Release

给 AI 一个规范的工作台，而不是一个空聊天框。

核心特性

  • 纯文件系统方案 — 零代码依赖，克隆即用或下载解压即用
  • 11个标准目录 — 每个目录有明确职责和约束
  • 规则体系 — AGENTS.md + Rules 双层规则
  • Skill 可演化 — 每个 Skill 持续积累经验与坑点
  • 可视化执行 — 每步操作向用户展示进度
  • 项目级配置 — 每个项目独立 AGENTS.md，自动识别加载

内置功能

  • WKIS (SK_0001) — 网页知识入库，URL → 结构化知识 → 参考知识库
  • Migration (SK_0002) — 存量内容迁移，三阶段：采集→分类→入库，含 Phase 0 安全准备
  • 一致性自检 — python 03_TOOLS/scripts/aos_check.py
  • 跨平台适配 — TRAE Work（最优适配）/ Claude Code / Codex 模板和映射说明

快速开始

git clone https://github.com/MagicalYuYu/agent-operating-system.git
# 或直接下载 ZIP 解压到任意位置
# 在 TRAE Work 中打开目录 → 切换到 Code 模式 → 配置 3 条 Rules → 完成
python 03_TOOLS/scripts/aos_check.py

详细配置步骤见 TRAE Work 配置指南

迁移操作指南见 迁移指南

许可证

MIT License with Additional Terms

  • 个人使用无任何限制
  • 禁止将 AOS 单独封装后商用售卖
  • 衍生项目鼓励标注来源，但不强制
Loading