项目文档¶

从与你的任务对应的文档开始。计划与已归档的原型不会覆盖已发布的行为。

用户指南¶

• ../README.md：在 macOS、Windows 和 Linux 上安装和使用 Hex。
• windows.md：Windows x64 和 ARM64 测试版要求、安装和源码构建。
• linux.md：Linux X11 和原生 Wayland 测试版要求与安装。
• nix.md：Nix 打包、开发和每用户自动启动。
• ../ios/README.md：构建并测试 iOS 原型。
• ../sdk/typescript/README.md：将公共 TypeScript 转录 SDK 与显式提供的原生辅助程序配合使用。

工程参考¶

• ../AGENTS.md：架构、不变量、开发命令和诊断。这是实现方面的权威依据。
• ../ROADMAP.md：按优先级排序的产品与工程工作。
• design-system.md：Rune + rune-kit + OpenCode 主题组件、Hex 部件、文案规则和 --snap 场景验证。
• features/README.md：现有的用户可见功能、入口点、可用的验证方式与缺口；详细的听写与恢复映射。
• perf.md：strobe 基准测试、驱动窗口遍历其辅助功能树的用例，以及经过基准测试的 Hex 副本如何保持隔离。
• downloads.md：公共下载路径、R2 自定义域名、GitHub 发布镜像和网络恢复。
• opencode-compatibility.md：经审计的 OpenCode V2 源码与 CLI 基线、集成契约和验证限制。
• plans/personal-commands.md：已发布的个人命令契约及剩余的生命周期工作。
• plans/quickjs.md：配置在嵌入式 QuickJS 而非 Bun 中运行的原因与方式，以及体积和延迟测量。
• specs/local-transcription-service.md：已实现的 macOS 本地服务协议和生命周期保证。

架构决策与进行中的计划¶

• plans/rune-ui.md：已实现；Rune 桌面 UI 移植、界面、goldens 以及剩余的实窗核对清单。
• plans/single-process.md：已实现；macOS、Windows 和 Linux 上每个用户一个 Hex 进程，托管 Rune 窗口和覆盖层。
• plans/rune-dependency.md：关于将 Rune 作为公共 MIT Git 依赖项以及 Nix output-hash 更新的决策记录。
• plans/shared-desktop-ui.md：已实现；macOS、Windows 和 Linux 如何共享一个窗口和一个设置文件。
• plans/swift-app-handoff.md：从 Swift 进行手动下载交接，不涉及数据导入或自动替换。
• plans/typescript-sdk.md：已发布的 SDK 状态、剩余的签名辅助程序打包，以及首个消费者的验证。
• plans/linux.md：Linux X11/Wayland 验证以及后续的能力切片。
• plans/meeting-live-transcription.md：对 Apple SpeechTranscriber 与 Moonshine 在实时会议草稿方面的评估。
• plans/granola-import.md：关于将历史 Granola 会议导入 hex mcp 的研究。

当计划与 AGENTS.md 在已发布行为上不一致时，更新该计划。

研究与归档¶

• research/transcription-benchmark.md：历史基准测试方法和测量结果。
• ../prototypes/app-shell/README.md：已归档的 app-shell 对比原型。

发布¶

releases/ 包含各版本的发布说明和草稿。../release-notes/ 包含 2.0.0 至 2.0.9 版本的遗留输入。已发布的说明和 SDK 更新日志描述的是其对应版本，而非当前行为；请将其作为历史记录保留。草稿说明不能证明其对应的版本已经发布。