Orrery v0.3.1

Orrery v0.3.1

Windows 上使用 v0.3.0 的用户应升级到 v0.3.1。 这一补丁修复了正常启动 Orrery 时可能连续闪现多个命令窗口，以及重复点击启动器会发起第二次 supervisor 启动的问题。

升级后，Windows 默认无界面运行链会统一隐藏 Git 等控制台子进程；如果 Orrery 已经健康运行，再次启动会直接复用相同的进程、端口和本地页面。

如何升级

1. 下载 project-orrery-v0.3.1.zip 和 project-orrery-v0.3.1.sha256。

2. 校验 ZIP 的 SHA-256 与 checksum 文件一致。

3. 解压后先预演托管工具升级：

   python project-orrery/scripts/install_project_orrery.py --target <项目目录> --upgrade-tools --dry-run

4. 检查替换范围和备份位置，再去掉 --dry-run 执行升级。

5. 运行 python project-orrery/scripts/validate_installation.py --target <项目目录>，然后重新启动 Orrery。

作者文档不会被批量覆盖；被替换的托管文件仍会先备份到 .project-orrery-backup/<时间戳>/。

技术说明

• Windows 默认 headless 路径对控制台子进程应用 CREATE_NO_WINDOW。
• 正常重复启动会在构建 Observatory 前检查并复用健康 runtime。
• 显式 --console 仍保留一个可见 supervisor 控制台、正常错误输出和 Ctrl+C 关闭行为。
• Team Mode、Authority 默认值、schema、DSH Store、orrery 别名、scheduler 与自动删除均未改变。

v0.3.0 的 tag 和资产保持原样；本补丁没有替换历史下载内容。

Orrery v0.3.0

Warning

Windows 用户请升级到 v0.3.1。 v0.3.0 的默认启动路径可能连续闪现多个命令窗口；v0.3.1 修复了该问题。为保留发布历史，v0.3.0 的 tag 与资产未被替换。

Orrery v0.3.0

这一版的重点很简单：让 Orrery 从“能整理项目文档”，变成一个真正能看懂项目现状、任务关系和多 Agent 协作情况的本地工作台。

你会直接感受到的变化

一个入口看完整个项目

启动 Orrery 后，项目总览、文档搜索、文档问答、当前任务、团队协作、任务关系和工作区维护都集中在同一个本地页面里，不需要再打开多个零散工具。

Windows 可以直接运行项目里的 Start Orrery.vbs 或 start-orrery.bat。

任务关系图终于能正常阅读

任务图现在会自动排版，并明确区分：

• 哪些任务是前后接续的；
• 哪些任务互相依赖；
• 哪些任务可能冲突；
• 哪些任务只是同一系列，不代表存在因果关系。

你可以缩放、筛选、收起历史任务并查看关系详情。关系图仍然是只读的，不会因为你点击图表就执行合并、删除或修改任务。

能看到当前是谁在推进什么

个人工作台会汇总本机可见的任务和 worktree，区分正在进行、等待确认、历史状态和清理建议。多人、多 Agent 协作时，也能看到任务属于谁、影响哪些模块以及是否存在阻断。

Personal Mode 默认只在本机工作，不访问外部网络。Team Mode 必须由项目明确开启，并且执行请求仍需要成员在自己的机器上确认。

文档问答更清楚哪些内容才算事实

Orrery 会把当前事实、已经接受的决定、准备实施的计划和验证结果分开处理，减少“计划写了就被当成已经完成”的情况。

右下角的“问文档”仍然是辅助阅读入口，它不会替你批准决定，也不会把 AI 回答写成项目事实。

安装和升级更安全

v0.3.0 提供一个自包含 ZIP，解压后即可离线安装，不依赖 PyPI，也不要求电脑里预先安装 Orrery。

• 新安装默认只创建缺失文件；
• 已有的 AGENTS.md、ADR、State、Plan 等作者文档不会被批量覆盖；
• 使用 --upgrade-tools 更新 Orrery 托管文件时，会先保存带时间戳的备份；
• 从 v0.2.0 升级不会自动替项目选择或批准新的权威模型。

新项目安装

1. 下载 project-orrery-v0.3.0.zip 和 project-orrery-v0.3.0.sha256。

2. 校验 ZIP。它的 SHA-256 应为：

   12a7061227cd2f9137dc2923716523059fbc8b528df8b1c7a8cdd8283d7d2385

3. 解压后先预演安装：

   python project-orrery/scripts/install_project_orrery.py --target <项目目录> --title "项目名称" --dry-run

4. 确认输出没有问题，再去掉 --dry-run 正式安装。

5. 进入项目目录，运行 Start Orrery.vbs 或 start-orrery.bat。

从旧版本升级

先预演托管工具升级：

python project-orrery/scripts/install_project_orrery.py --target <项目目录> --upgrade-tools --dry-run

确认需要替换的文件和备份位置后，再去掉 --dry-run。被替换的旧文件会保存在：

.project-orrery-backup/<时间戳>/

升级完成后建议运行：

python project-orrery/scripts/validate_installation.py --target <项目目录>

这版暂时没有什么

• 没有自动删除 worktree；
• 没有 OS 定时清理任务；
• 没有 orrery 命令别名，仍使用 project-orrery；
• 没有自动开启 Team Mode；
• 没有云端中继或远程执行；
• Core、CLI 和其他 Adapter 暂未通过 PyPI 独立发布；
• 当前界面仍以中文为主。

如果你只想在本机整理文档、查看任务和理解项目状态，这些限制不会影响主要功能。

v0.2.0

What's Changed

• docs: add professional bilingual project documentation by @yw9299-stack in #1
• Add Skill update and compatibility protocol by @yw9299-stack in #2

New Contributors

• @yw9299-stack made their first contribution in #1

Full Changelog: https://github.com/yw9299-stack/project-orrery/commits/v0.2.0