XUANSHU AI / 玄枢

XUANSHU AI 是面向 Windows 10/11 x64 的本地 AI 与机器人工作空间平台。本仓库只包含平台层：轻量启动器、Desktop Shell、Portal、Intro、Workspace Registry、进程编排、发布构建与合规清单。

Jingwei、Hetu、Gongshu 继续维护在独立仓库中；它们仅在发布 staging 阶段按锁定提交组装到 workspaces/，不会合并为 monorepo。

v0.1 冻结目标

• 公开品牌：XUANSHU AI / 玄枢
• 正式可执行文件：XUANSHU AI.exe
• 正式发布名：XUANSHU-AI-v0.1.0-win64.zip
• 系统：Windows 10/11 x64
• Runtime：CPU baseline；不要求 NVIDIA GPU
• 用户流程：下载、解压、双击启动
• Workspace：Jingwei 和 Gongshu 自动启动；Hetu 显示 Preview
• 故障隔离：单个 Workspace 失败不阻止 Portal 启动

内部 Python 包暂时保留 xuanshu_lab，仅作为兼容实现名，不再作为公开产品名称。

开发启动

1. 创建 Python 3.12 虚拟环境并安装平台与 Development Runtime 依赖：

   py -3.12 -m venv .venv
   .\.venv\Scripts\python.exe -m pip install -r .\packaging\runtime\requirements-development.lock
   .\.venv\Scripts\python.exe -m pip install -e .

2. 生成本机专用、不会提交 Git 的 Workspace 配置：

   .\scripts\configure_development.ps1 `
     -JingweiRoot F:\hotarea-cv-JingWei `
     -GongshuRoot G:\gongshu-public `
     -HetuRoot G:\hetu

3. 构建并运行轻量原生 Launcher：

   .\launcher\build_launcher.ps1
   & '.\XUANSHU AI.exe'

无窗口 smoke test：

.\.venv\Scripts\python.exe -m xuanshu_lab --mode development --headless-smoke

发布边界

正式 Release Mode 只解析 Release Root 下的相对路径，优先使用 runtime/python/python.exe，不读取系统 Python、Git、Node、Conda 或开发机盘符。当前轮次只生成 Development staging，不生成或上传正式 GitHub Release ZIP。

架构、许可状态与剩余发布门槛见 XUANSHU RELEASE ARCHITECTURE REPORT。