本地安装与启动

首次安装怎样执行？

deploy/macos.py 提供 doctor、bootstrap、rebuild、start、stop、status 等入口；首次安装建立本项目独立环境，stop 保留卷和本机资料。

在新的开发副本根目录执行，首次安装会创建本项目数据卷、迁移角色、本机账号和本地初始数据。

复制python3 deploy/macos.py doctor
python3 deploy/macos.py bootstrap
python3 deploy/macos.py status

不要复制旧机器的固定商城ID或测试账号。status 输出当前环境入口；消费者与管理账号各有身份范围。本机秘密只在自己的受控配置中获取，不写入共享文档。

移动端 工具暂未准备好怎么办？

复制python3 deploy/macos.py bootstrap --skip-mobile

该参数只代表后端、Admin、PC准备范围。HBuilderX准备后按正常停止、检查和启动流程继续，再实际打开移动页面触发开发编译。开发环境支付或短信模拟不证明真实外部通道。

重启和代码变更怎么处理？

复制python3 deploy/macos.py stop
python3 deploy/macos.py start
python3 deploy/macos.py status

代码改变后先停止本入口拥有的进程，再按脚本的 rebuild 流程构建。新增迁移前核对历史保留与目标数据库，不能通过清库掩盖失败。安装失败保留日志并只补失败步骤，不反复执行交易、退款或演示初始化。

启动后要确认什么？

分别记录后端可读、Admin登录与页面、PC当前商城、390px 移动端以及对象读取。端口监听与健康UP只能证明相应技术环节，不能代替业务验收。