# Sutie v0.5.0 build 31 — 安装与已知限制

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

## 支持范围

- macOS 14 或更高版本
- Apple Silicon（arm64）
- Chrome 109 或更高版本（随包提供 Chrome 扩展）
- Obsidian 1.12 或更高版本（随包提供桌面插件）
- 当前版本：`0.5.0 (31)`
- 源码 commit：`faf0de1`（v0.4a-beta 分支；build 30 冻结基线 `249aff2` + 三视角交叉审查修复）

## 下载前核对

在解压前，先核对网站列出的 SHA-256。哈希不一致时不要打开 App，并通过 Yancy Labs 支持入口报告。

## 安装

1. 解压下载包，将 `Sutie.app` 拖到“应用程序”。macOS 扩展与 Obsidian 插件是同目录下的独立 ZIP（`Sutie-Chrome-v0.1.3.zip`、`sutie-obsidian-0.4.1.zip`），分别单独下载解压。
2. 第一次双击时，macOS 可能显示“未打开 Sutie.app，Apple 无法验证……”并只提供“完成”和“移到废纸篓”。这是未公证实验包的预期 Gatekeeper 提示；选择“完成”，不要移到废纸篓。
3. 随即打开“系统设置 → 隐私与安全性”，向下滚动到“安全性”。找到刚被阻止的 `Sutie.app`，点击“仍要打开”，按系统要求确认身份，再在第二个确认框中选择“打开”。这个操作只放行当前 App，不会关闭系统的全局安全保护。
4. 如果“仍要打开”没有出现：确认 App 已放入“应用程序”且不是直接从 ZIP 内运行；然后在 Finder 中按住 Control 点击 `Sutie.app`，选择“打开”。若仍被阻止，请先确认本机是 Apple Silicon、系统为 macOS 14 或更高版本，并重新核对下载哈希。
5. 不要关闭 Gatekeeper，也不要运行 `xattr` 或 `spctl --master-disable` 等全局或命令行绕过操作。无法完成上述单 App 放行时，应停止使用并通过支持入口反馈。
6. 只有在你信任下载来源并接受本实验版风险时，才在系统设置中授予 Input Monitoring 和 Accessibility。Sutie 不申请 Screen Recording。
7. 在 Sutie 菜单中安装或修复 Chrome Native Host；Chrome 扩展目录是 `ChromeExtension`，使用 Chrome 的“加载已解压的扩展程序”。
8. Obsidian 插件目录 `ObsidianPlugin/sutie` 应复制到目标库的 `.obsidian/plugins/sutie/`，然后在 Obsidian 社区插件设置中启用。

## 隐私和数据边界

Sutie 的本机功能以本地账本和会话内存为主，不把剪贴板正文上传到 Yancy Labs。Input Monitoring 用于观察复制/粘贴快捷键，Accessibility 用于识别前台 App 和执行专用回粘；请不要在实验版中处理密码、支付信息、医疗信息或其他敏感内容。

## 已知限制

- 本包没有 Developer ID 签名和 Apple 公证，macOS 可能显示“无法验证开发者”或类似警告。
- VoiceOver 实际听测尚未完成，不能宣称完整无障碍兼容。
- 没有自动更新；更新必须重新核对版本和 SHA-256。
- 当前主要验证对象是 macOS 14+ Apple Silicon、Chrome、Obsidian；第三方 App 的来源归因可能是最佳努力结果。

## 卸载

退出 Sutie 后删除 `Sutie.app`；在 Chrome 移除扩展并按 App 内提示清理 Native Host；在 Obsidian 禁用并删除 `sutie` 插件目录。若不再保留本地记录，再按 App 内说明删除 Sutie 数据目录。

问题反馈：<https://yancylabs.com/support/>