# OctoWorkFlow Desktop 0.2.1 安装与卸载

这是只读任务看板客户端，不包含 Python、工作流执行器或 Web 服务。请先配置并运行本机只读看板，默认地址 http://127.0.0.1:8765。已经安装工作流的 macOS 用户可运行：

```sh
python3 ~/.octoworkflow/dashboard.py board serve --port 8765
```

Windows 的只读服务启动与隔离验证命令见源码 windows/README.md。客户端安装成功不代表工作流服务器已安装；POSIX工作流安装器不支持原生Windows。不要给客户端连接 --control 认证端口。

## macOS

支持 macOS 12+，包含 arm64/x86_64。打开 DMG，把 OctoWorkFlow.app 拖到 Applications，打开后从菜单栏进入；不显示 Dock 图标。升级前从菜单退出旧版，再替换 App。登录启动默认关闭，macOS13+可在设置中主动启用。卸载前关闭登录启动、退出后移除 App；不会删除任务。偏好保存在 local.octoworkflow.menubar 域。

App 和 DMG 已用 Developer ID 签名并完成 Apple 公证。开发机 Gatekeeper 已禁用，默认安全设置下的干净机器首次安装尚未验证，不能以本机启动替代该验证。

## Windows x64

setup.exe 默认安装到当前用户 %LOCALAPPDATA%\Programs\OctoWorkFlow，无需管理员权限。Portable ZIP 必须完整解压，保留全部 DLL 和运行时文件，再打开 OctoWorkFlow.exe；不需要另装.NET。升级前从托盘菜单退出旧版。

Windows 包未进行 Authenticode 签名，不承诺 SmartScreen 信誉；不要关闭安全保护来绕过警告。实测为 Windows11 Insider，稳定OS/DPI/双屏/辅助技术等矩阵尚未完成，具体限制见 RELEASE-NOTES.md。

安装版在“已安装的应用”中卸载。卸载器仅清理精确指向当前安装路径的自建启动项；用户偏好保留在 %LOCALAPPDATA%\OctoWorkFlow\settings.json。Portable删除前先在设置关闭曾主动启用的登录启动，然后退出。

## 两平台使用

关注／进行中／全部分类，多词搜索，点击任务查看摘要。底部“查看完整控制台”打开默认浏览器。首次无数据显示未知，离线保留快照并标记过期。退出客户端不会停止工作流任务和看板服务。

校验安装文件实际SHA256与随附SHA256SUMS.txt一致。校验和证明完整性，不替代发布者身份和系统安全验证。