基于 DeepSeek Harness（dsh）的 ApeMind 品牌桌面客户端。
本仓不是 dsh 的 fork。 它持有的是「版本锁 + 品牌 overlay + 发版流水线」，
上游代码按 upstream.lock 取固定 commit，overlay 保存品牌、登录插件和必要接线。升级时仍可能需要调整补丁，并重新验证构建与功能。
upstream.lock ──► checkout 上游锁定 commit ──► 应用 overlay/ ──► 按上游脚本构建/打包
(版本唯一事实来源) (不可变的完整 SHA) (只碰品牌接线) (原生 electron-builder)
三个设计决定，都是刻意的：
- 锁 commit，不锁分支/tag。 分支会移动、tag 可被重打；只有 40 位 commit 不可变。
升级上游 = 改
upstream.lock一个版本号 + 跑回归。 - overlay 是纯补丁、无上游文件副本，且受闸门约束。 overlay 只放
overlay/patches/*.patch（品牌 + 未签名开关），按固定顺序git apply；补丁上下文不匹配就结构性失败， 不存在"副本静默落后上游"的隐患（见overlay/OVERLAY.md）。scripts/verify-overlay.sh会校验：overlay 里无上游副本、每个补丁只碰授权路径。 这条闸门是防止 overlay 悄悄退化成 fork 的关键。scripts/sync-upstream.sh会在构建前校验：除白名单文件外任何差异都直接失败 —— 这条闸门是防止 overlay 悄悄退化成 fork 的关键。 - 依赖不自建版本表。 全部继承上游 lockfile；
upstream.lock记录其 sha256， 用于确认我们拿到的确实是被验证过的那份依赖图。
登录与 Agent 集成合同见 CLI-first 集成设计，文档入口见 docs。
| 项 | 状态 |
|---|---|
仓骨架 / upstream.lock / overlay 机制 |
✅ 已建并实测（sync-upstream.sh 跑通） |
| dev 模式本机运行 | ✅ 已实测（macOS arm64，无需任何 Apple 凭据） |
未签名 .app 本机可用 |
✅ 已产出（见下） |
| 品牌（五处用户可见位） | ✅ 已完成：窗口标题 / 侧栏字标 / 侧栏 mark / 中间 hero / app 图标 |
| 可分发正式安装包 | ⛔ 阻塞于 Apple Developer 凭据 |
桌面版运行时加载 $DSH_HOME/profiles/desktop 中安装的插件。启动新安装包时，
应用校验内置核心包与已安装包的内容清单；即使上游版本号相同，只要包内容变化，
也会通过上游已有的安装事务更新运行目录，保留用户插件，并在激活失败时回滚。
相同包内容再次启动时不重复安装，无需手工清理 profile。
构建目录里的新文件尚未进入正在运行的旧应用。修改后需要重新打包，并启动该产物； 具体命令与 CLI 版本锁见 本机运行指南。
./scripts/sync-upstream.sh # 按 upstream.lock 取上游 + 应用 overlay
cd work/dsh-desktop
corepack prepare pnpm@11.7.0 --activate # 必须匹配上游 packageManager
pnpm install --frozen-lockfile
pnpm run build
APEMIND_CLI_BIN="$(node --input-type=module -e "import { prepareApeMindCli } from './apps/desktop/scripts/apemind-cli-runtime.mjs'; console.log(await prepareApeMindCli())")" \
APEMIND_CONFIG_DIR="$PWD/apps/desktop/.desktop-build/development/apemind" \
pnpm run dev:desktop预期：窗口标题为品牌名；渲染走自定义协议 dsh-app://app/index.html（不是 localhost）。
Harness state 落在 apps/desktop/.desktop-build/development/home，不污染真实 $DSH_HOME。
上游 macOS 打包链无条件要求 Apple 凭据，缺凭据会在两处抛错，且第二处在很后面才触发：
apps/desktop/electron-builder.config.mjs构造 config 时解析凭据 ——--dir绕不过；apps/desktop/scripts/prepare-seed.ts再次解析 —— 此时prepare:runtime、prepare:packages已白跑。
因此本仓提供 DSH_DESKTOP_UNSIGNED 开关（见 overlay/），短路上述门槛，
用于本机验证。TeamIdentifier=not set），
只能本机使用，不可分发 —— 可分发正式包必须等 Apple 凭据。
| 依赖 | 形态 |
|---|---|
| dsh / Electron / Node / pnpm / 预置插件 | 锁精确版本的产物（npm 包 / 官方归档），版本表继承上游 lockfile |
| ApeMind CLI | overlay/apps/desktop/resources/apemind-cli.lock.json 固定发布版本、源码提交和各平台 SHA-256，打包时自动下载并校验 |
| 本仓自有代码 | 只有品牌 + 登录 + 接线，且刻意保持薄 |
构建需要外网（prepare:runtime 下载 Node、prepare:seed 拉 npm），不是离线构建。
本仓自有代码见 LICENSE。
上游 dsh 为 MIT；再分发产物须遵守上游 THIRD_PARTY_NOTICES.md 与
BRAND_GUIDELINES.md（上游明确要求项目名避免直接使用 "DeepSeek Harness" 商标，
本仓据此使用 "ApeMind Desktop" 并声明 "built on DeepSeek Harness"）。