DJB 联脑 · djb-node macOS 安装说明（源码包，测试构建）
=========================================================

包内容
------
本包是 djb-node 0.2.0 的**源码包**（git archive，与 CPU 架构无关：
Intel 与 Apple Silicon 通用），不是签名二进制，也不是 .dmg。
包含：djb_node/ Python 包（含 desktop/tray/gui 新代码）、openapi.yaml 契约快照、
deploy/machine-room/ 部署制品说明、tests/ 与 tools/。

运行要求
--------
  * macOS 12+（建议），Python 3.10 及以上（python3 --version 确认）
  * 运行时零第三方依赖（仅标准库）；如需真 tokenizer 可装可选 extra [tokens]
  * 桌面端需要 Tk（python.org 官方 Python 自带；Homebrew Python 需另装 python-tk）

安装（二选一）
--------------
A. pipx（推荐，隔离环境 + 全局 `djb` 命令）
     pipx install .
     djb --version

B. venv（不装 pipx 时）
     python3 -m venv .venv
     .venv/bin/pip install .
     .venv/bin/djb --version

首次初始化与绑定（顺序不要颠倒）
--------------------------------
     djb init --preset 均衡   # 初始化本地目录、预设与环境自检
     djb auth --pair          # 生成本机密钥
     # 到网页端 → 账户/节点 → 生成绑定码（一次性，10 分钟内有效）
     djb auth --bind <绑定码> # 粘贴网页端生成的码
     djb env                  # 可选：环境检测/下一步
     djb start                # 起 daemon（只绑 127.0.0.1:1717）
     djb status               # 查看 daemon / 配置 / 额度状态

凭据只落在本机状态目录（0600），本包不含任何 token、密钥或生产域名。

签名与 Gatekeeper（重要）
-------------------------
  * 本包**未签名、未公证**（unsigned-test，测试分发用，不构成生产发布）。
  * 从网络下载后 macOS 可能加 quarantine 属性，首次运行会被 Gatekeeper 拦截；
    可在「系统设置 → 隐私与安全性」里对该二进制选择「仍要打开」，
    或对源码包内的脚本按需处理后运行。**不要**把此流程写进生产分发文档。
  * 正式的签名/公证 .dmg 待发布（需要 Apple Developer ID 证书 + notarytool），
    在 dmg 就绪前，本源码包是 macOS 唯一的官方测试产物。

许可
----
Apache-2.0（见包内 LICENSE）。
