小百灵云片 · 桌面客户端  安装包 v0.4.0 / 窗口版 v0.5.0（本机测试版）
================================================================

【本版形态：Windows 窗口 + 内置 Web】
双击启动后是一个**独立窗口**（无地址栏、有独立任务栏图标），窗口里加载的是
云端 /desk 页面 —— 页面本体 100% 放在云端，升级只改云端，不用重装客户端。
窗口用系统自带的 Edge / Chrome 的 app 模式打开（不是 WebView2 内嵌控件）；
未安装这两款浏览器时降级为系统默认浏览器标签页。

【登录：与 Web 端完全对齐】
★ 先用「用户 Web 工作台」的同一账号在窗口里登录，本机工位才会启动：
     本机演示：kaimi_demo / demo-1113
     隔离验证：other_demo / other-1113
   系统管理端账号（kaimi_ops）不能登录桌面工位。
   没有第二套客户端口令，config.json 里也不再需要存密码。
★ 未登录 / 退出登录 / 暂停接单 / 关闭窗口 → 工位立即停止，本机不接收任何任务。
   登录会话由云端 web_sessions 校验，租户由服务端固定，客户端改不动别人的租户。

【这个客户端做什么】
接收云端出片任务、按排期定时成片、把成片与封面成对回传、回报状态。
发布动作由云端在客户审核后统一执行，本客户端不持有任何平台登录态 / Cookie / 代理。
注：KaimiWorker.exe、KaimiWorker 安装目录、D:\Kaimi-SaaS 等是内部标识符，
    不是产品名；产品对外统一叫「小百灵云片」。

【安装（推荐）】
1. 先启动云端服务：在 D:\Kaimi-SaaS 执行 python run_cloud.py
2. 双击 install.bat（默认装到 %LOCALAPPDATA%\KaimiWorker，并在桌面创建
   「小百灵云片 桌面端」快捷方式）。重复安装会保留你改过的 config.json。
3. 双击桌面快捷方式 → 弹出登录窗口。首次运行 Windows SmartScreen 对未签名
   本地构建可能提示，点「更多信息 → 仍要运行」。窗口关掉 = 客户端退出。

【绿色运行（不想安装）】
直接双击 start-worker.bat，效果相同，不写注册表、不建快捷方式。

【旧的无界面模式（headless，仅自动化 / 探针用）】
命令行直接执行 KaimiWorker.exe（不带 --desk），仍走原来的黑色控制台工位，
用独立客户端账号 kaimi_worker / worker-1113 登录：
     set KM_SAAS_CLIENT_USER=kaimi_worker
     set KM_SAAS_CLIENT_PWD=worker-1113
   set-credentials.bat 改的就是这个模式的账号。生产环境务必改掉演示口令，
   不要把正式口令明文留在包里。窗口版不需要这些。

【配置 config.json】
  base_url   云端地址，本机默认 http://127.0.0.1:5310；换机器改成实际 IP/域名
  desk_port  窗口版本地控制桥端口，默认 5311，只监听 127.0.0.1；被占用会自动顺延
  core_root  出片内核仓路径，默认 D:\Kaimi-Video-Automation（需含 core/ 与 modules/）
  device_name 管理端「设备」列表里显示的名字
  version    与云端版本协议一致，不要手改

【内核依赖（重要）】
本包不含 GB 级渲染内核。即使演练模式，租户子进程也会导入内核仓的
core/config.py 与 core/store.py 做 KM_* 隔离自检，所以 core_root 必须指向
真实存在的内核目录。真实出片还需要 ffmpeg / edge-tts / 字体，由内核环境提供。

【演练开关】
  KM_SAAS_DRY_RUN=1  默认。本地 ffmpeg 生成 2 秒演示片，不调 LLM/TTS/第三方 API。
  KM_SAAS_DRY_RUN=0  真实出片，需你确认后开启（会触发 TTS/LLM 计费）。
  KM_SAAS_DEMO_VIDEO=0  连演示片都不生成，只回传占位字节（无 ffmpeg 的机器用）。

【升级】
业务代码放在 app/ 目录，启动时自动向云端比对版本清单，逐文件校验 sha256 后
原子替换，重启生效 —— 不用重新下载安装包，也不用重新打包 exe。
窗口里的页面直接由云端下发，改界面连客户端都不用重启。

【日志与卸载】
窗口版运行日志：<安装目录>\desk.log（窗口「本机运行日志」里也能看到）
任务日志：<安装目录>\app\_runtime\workers\<租户>\logs\<任务>.log
卸载：uninstall.bat（需输入 YES 确认，会移除安装目录与桌面快捷方式）

【本版边界】
全链路 dry-run：没有真出片、没有真发布、没有调用任何付费 API。
exe 为本地未签名构建，仅用于本机/内网测试；对外分发需购买代码签名证书。
窗口是系统 Edge/Chrome 的 app 独立窗口，不是 WebView2 内嵌控件。
