Repository navigation
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）