v0.1.0-alpha.20

v0.1.0-alpha.20

Alpha.20 聚焦“第一次真的装得起来”和“公众号排版的手机阅读感”：Windows x64 首次提供带内置 Python 的可校验便携包，普通用户不再需要 Git、系统 Python、Node.js、pnpm 或 Wenyan；工作台新增拟真手机阅读预览，并统一内容校对与沉浸式预览交互。

主要变化

• 新增 Windows x64 便携发行包，内置官方 Python 3.11.9、后端依赖和生产工作台；
• 新增固定版本 Release 安装器，自动下载 ZIP 与 .sha256，校验通过后才执行持久安装；
• 新增 GitHub Actions Release 工作流：构建、陌生目录安装、健康检查、样例任务、卸载全部通过后才上传资产；
• 正式包不再携带匿名盲评实验语料、内部文章、本地数据库、凭据、缓存或开发构建目录；
• 服务端运行资产改为显式跟随当前安装版本根目录，修复嵌入式 Python 安装后的品牌与实验样本路径问题；
• 新增内容校对 / 手机预览切换，使用 MIT 许可的 @sneas/telephone 外壳并由项目模拟公众号阅读顶部、正文和底部操作栏；
• 手机预览保持 390px 文章宽度，只用于版式判断，不改变最终交付 HTML，也不冒充真实微信客户端；
• 完善第三方许可证与运行依赖清单，Release 包内可查看确切的 Python 包版本。

Windows 安装

把本 Release 页面交给具备终端能力的 Agent，并要求它先阅读固定版本的 INSTALL_FOR_AGENT.md：

https://github.com/zhouke0929/wechat-visual-director/releases/tag/v0.1.0-alpha.20

或在 PowerShell 执行：

$installer = Join-Path $env:TEMP "wechat-visual-director-install-alpha20.ps1"
Invoke-WebRequest "https://github.com/zhouke0929/wechat-visual-director/releases/download/v0.1.0-alpha.20/install-release.ps1" -OutFile $installer
$result = powershell -NoProfile -ExecutionPolicy Bypass -File $installer | ConvertFrom-Json
powershell -NoProfile -ExecutionPolicy Bypass -File $result.launcher doctor --json

安装成功应同时满足：

core_ready=true
workbench_ready=true
persistent=true
version=0.1.0-alpha.20
running_version=0.1.0-alpha.20
version_match=true
runtime_match=true
runtime_mode=bundled_python
bundled_runtime=true
host_skill_registered=true

兼容性与安全

• Windows 10/11 x64 为正式便携包平台；macOS 继续作为源码安装 Technical Preview；
• 升级仍保留 data/、config/、图片资产和本机公众号凭据；
• 安装包不自动群发文章，公众号草稿创建仍需本地配置和工作台人工确认；
• SHA-256 只证明下载内容与本 Release 资产一致；用户和 Agent 仍应使用固定标签，不执行来源不明的安装脚本；
• API Key、AppSecret、Cookie、任务数据库和本地测试稿不进入发行资产。

验证

• API 全量测试通过；
• Web 类型检查与生产构建通过；
• Windows 包在全新临时目录中使用内置 Python 完成安装、启动、doctor、样例任务创建和完整卸载；
• Release ZIP、SHA-256、安装脚本与 GitHub Actions 构建链路通过；
• Git diff、敏感信息与发行范围检查通过。