release: FreeOS v0.0.4 (host-native org waves + P0–P2)

[XYAIStudio]

Summary

切 FreeOS v0.0.4 面向桌面用户的发版：自 v0.0.3 起纳入 P0–P2 与宿主原生组织 Wave 1（#81）/ Wave 2（#82）。只做版本与 CHANGELOG 卫生，不改功能。

当前核对：

• origin/main tip：42759c7a（Merge feat(org): host-native organization wave 2 #82）
• 最新 GitHub Release / tag：v0.0.3（2026-09-20）
• 下一 semver：0.0.4 / 标签 v0.0.4

用户可见进展（相对 0.0.3）

• 组织首页改为宿主原生工作台：即使桌面集成也不再被 iframe 吞掉；原 App 只作过渡链接。人才市场、名册、治理暂停进入宿主 UI（Wave 1）。
• 组织房间继续加深：公告已读名单、任务附件、架构汇报线/JSON 导入、工作台内联批准治理暂停（Wave 2）。不扩永久 Node，不删 ManagedOrganizationRuntime。
• 工作室 vs 组织房间：两扇门、两套身份；组织管理员不再抬成宿主 ADMIN。
• 本机模型与知识库为默认路径：向导先选 Ollama，知识库先引导本机文件夹 + ONNX；云厂商与 ima 仍可选。
• 资产总线与可商业化导出：loop/apply 可 ingest 进组织租户；export-standalone 默认打完整 openXYOS 源码包。
• 产品契约与迁移图：口号与工作室比喻定稿；Node / iframe 明确为过渡桥。
• 备份纳入宿主组织树；缺托管 Node 时运行时跳过而不是拖垮 uv run。

桌面 CI 仍显式 SHIP_OPENXYOS_RUNTIME=1（延续 0.0.3 iframe 过渡桥）。uv run / Docker / 默认绿色包为零 Node。website/package.json 仍为 0.0.2（0.0.3 也未随产品版本 bump，官网下载入口不写死版本号）。

Target branch

• Base is main（发版；本云代理分支名为 cursor/release-v004-956d，合入后需手动打 tag，见下文）

Type of change

• Release / hotfix

Test plan

• 版本源一致：pyproject.toml / octop.__version__ / 桌面 config.yml + Windows info.json / README 徽标均为 0.0.4
• uv run pytest tests/unit/cli/test_version_cmd.py tests/unit/desktop/test_release_hygiene.py tests/unit/desktop/test_phase5_defaults.py -q → 15 passed
• uv run python -c "import octop; print(octop.__version__)" → 0.0.4
• .github/workflows/octop-desktop.yml 仍为 SHIP_OPENXYOS_RUNTIME: "1"
• GitHub CI green

Checklist

• Updated CHANGELOG.md（Unreleased 中属于本版的条目已移入 [0.0.4]；Phase 2–5 历史条目补记到 [0.0.3]）
• README / docs 版本徽标与「当前桌面口味仍是过渡桥」表述已对齐

合入 main 之后：打 tag 并触发发版工作流

Auto Tag On Release Merge 只在 head 为 release/* 或 hotfix/* 时打 tag。本 PR 分支是 cursor/release-v004-956d，合并后 不会自动打 v0.0.4。请在 main tip（含本 PR 的 merge commit）执行：

# 确认 main 已含本 PR，且 pyproject.toml version == 0.0.4
git fetch origin main
git checkout main && git pull origin main
git log -1 --oneline
python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])"

git tag -a v0.0.4 -m "FreeOS 0.0.4"
git push origin v0.0.4

若 git push origin v0.0.4 因权限失败，用 GitHub Release（同样会推 tag，且 release.yml 监听 v*）：

gh release create v0.0.4 --title "v0.0.4" --notes-file - --target main <<'EOF'
面向桌面用户的版本：自 0.0.3 起纳入 P0–P2 与宿主原生组织 Wave 1 / Wave 2。
桌面 CI 仍显式 SHIP_OPENXYOS_RUNTIME=1（0.0.3 iframe 过渡桥）；uv run / Docker / 默认绿色包为零 Node。
完整说明见 CHANGELOG.md 的 [0.0.4] 节。
EOF

人工 push 的 v* tag 会触发 release.yml、docker-publish.yml、octop-desktop.yml（FreeOS Desktop Package）。若 tag 是 GITHUB_TOKEN 推的、工作流没级联，再 dispatch：

gh workflow run release.yml --ref v0.0.4
gh workflow run docker-publish.yml --ref v0.0.4
gh workflow run octop-desktop.yml --ref v0.0.4 -f platforms=all -f attach_release=true

不要在本 PR 合入 main 之前打生产 tag。