# wooooowbot 预览版 · Mac 0.1.1

本地工作站安装与管理 APP。

## 安装

适用 Apple Silicon Mac（M 系列），最低构建目标 macOS 14；目前实测 macOS 26.5.2。
打开 DMG，把「wooooowbot」拖入 Applications，再打开 APP。首次设置时自行命名工作站。
本包为开发预览，使用本地 ad-hoc 签名，尚未完成 Apple Developer ID 签名/公证；下载到另一台 Mac 可能被系统阻止，暂不作为普通用户正式安装包。不要关闭系统安全保护。

首开选择名字和空的数据位置，点击「建立本机工作站」。已有数据请选择「打开已有工作站」，不会覆盖或重建身份。
后台服务需手动启用，macOS 若要求允许后台项目，在系统设置中完成授权。登录此 Mac 用户后运行，注销后停止；电脑休眠/关机时不能提供服务。关闭管理窗口不会停止已启用后台。

## 当前可测

- 命名、稳定本地工作站身份、私有资料目录自动部署、重新打开续接。
- 独立知识库索引后台，启动/停止/系统授权与真实心跳状态。
- Markdown 原稿保存、全文查回、打开来源；目录可被 Obsidian 读取。
- DeepSeek / 智谱 API Key 存本机 Keychain，主动发送固定短请求检查真实响应与用量。需要自己的模型授权；没有内置任何生产密钥。
- 版本及脱敏诊断导出。

## 尚未接通

平台 Admin 账号认领、订阅开通与完整计费账本、专家业务运行环境、新工作站公网连接与 wooooowbot 绑定、已有 Obsidian 库导入、备份恢复、升级回滚、Windows。
本地 owner ID 不等于平台账号，也不赋予平台超级管理员权限。本版不是完整新用户交付，不宣称已跑通小程序闭环。

## 资料与卸载

默认资料位置：用户目录下的 Wooooowbot；APP 支持另选空目录。已有工作站可以通过「打开已有工作站」选择原数据目录，不会自动重命名或移动已有资料。
知识/技能/记忆/附件按稳定 owner ID 保存，system 内保存索引与运行状态，密钥不在资料目录。
先在 APP 停止后台，再移除 Applications 中的 APP。数据目录和 Keychain 不随卸载自动删除；要移除密钥可先在模型页点击移除。保留原始资料后再做后续升级。

## 开发验证

`swift test`；`bash scripts/build.sh`。
SwiftUI/Swift，无第三方运行时依赖。后台不监听公网端口，不执行任意命令。
本机用户能够管理本机文件；当前目录权限不等于多租户服务端授权，未来 Holder 私库需在业务层继续隔离。
