# Parallel Tasks v0.3.3 — 安装与已知限制

这是 Yancy Labs 提供的 **ad-hoc、未公证候选版**，不是 Apple Developer ID 发行包，也不是 Mac App Store 版本。它仅用于公开评估；下载前请阅读本文件和同目录的 `EVALUATION_TERMS.md`。

## 支持范围

- macOS 14 或更高版本
- Apple Silicon（arm64）
- 当前版本：`0.3.3`（Community Development Candidate）
- 源码 commit：`650b54b`（fix/stability-cross-validation-findings 分支；基于 64ff065 + 两轮多代理交叉验证审查的 9 项修复）

## 这个包里有什么

- `ParallelTasks.app`：macOS 待办台，汇总 Codex / Claude Code 等 Agent 需要本人介入的事项
- `Contents/Helpers/taskmanager-mcp`：本地 stdio MCP server，供 Codex / Claude Code 直接写入任务库

## 下载前核对

在解压前，先核对网站列出的 SHA-256（同目录 `ParallelTasks-0.3.3-SHA256SUMS.txt`）。哈希不一致时不要打开 App。

## 安装

1. 解压下载包，将 `ParallelTasks.app` 拖到“应用程序”。
2. 第一次双击时，macOS 可能显示“未打开 ParallelTasks.app，Apple 无法验证……”并只提供“完成”和“移到废纸篓”。这是未公证实验包的预期 Gatekeeper 提示；选择“完成”，不要移到废纸篓。
3. 随即打开“系统设置 → 隐私与安全性”，向下滚动到“安全性”，找到刚被阻止的 `ParallelTasks.app`，点击“仍要打开”并确认。这个操作只放行当前 App，不会关闭系统的全局安全保护。
4. 如果“仍要打开”没有出现：确认 App 已放入“应用程序”且不是直接从 ZIP 内运行；然后在 Finder 中按住 Control 点击 `ParallelTasks.app`，选择“打开”。不要关闭 Gatekeeper，也不要运行 `xattr` 或 `spctl --master-disable` 等全局绕过操作。

## 接入 Codex / Claude Code（可选）

- 仓库 `integrations/` 目录提供 Claude Code 与 Codex 插件的启动脚本模板；MCP 二进制已内置在 App 的 `Contents/Helpers/taskmanager-mcp`。
- 未接入 MCP 时，仍可通过菜单“恢复入口”用文件、剪贴板或收件箱目录导入回执 JSON。

## 隐私和数据边界

- 任务、回执、步骤状态和备注保存在本机 `~/Library/Application Support/ParallelTaskManager/`；App 不上传任何任务内容（PRIVACY.md 随仓库发布）。
- 导入前会扫描常见密码、Token、私钥模式，命中即拒收。
- “复制并返回 Codex”只复制恢复消息并请求切换任务，不会替你粘贴或发送。

## 已知限制

- 本包没有 Developer ID 签名和 Apple 公证，macOS 会显示“无法验证开发者”或类似警告。
- 没有自动更新；更新必须重新核对版本和 SHA-256。
- VoiceOver 实际听测尚未完成，不能宣称完整无障碍兼容。
- 本版本包含 2026-08-23 稳定性审查的修复（回执更新删除旧事项、收件箱归档失败误报等）；完整报告见仓库 `docs/review/2026-08-23-stability-review/`。

## 卸载

1. 退出 App（菜单栏 Parallel Tasks → 退出）。
2. 把 `ParallelTasks.app` 移到废纸篓。
3. 如需删除数据：移除 `~/Library/Application Support/ParallelTaskManager/` 目录（其中包含全部任务数据，删除前确认不再需要）。
