feat: prepare Zhinian desktop client for pilot release

docs/START_HERE.md

@@ -0,0 +1,47 @@
+# YINIAN Desktop 项目启动说明
+
+## 当前基线
+
+- 上游基础：ClawX `0.3.11`
+- 产品定位：快速使用 AI Agent 桌面客户端
+- 当前分支：`yinian-main`
+- PRD：`docs/PRD.md`
+- M1 交付说明：`docs/M1_HANDOFF.md`
+- 服务端契约草案：`docs/SERVER_CONTRACT_V0.md`
+- Pilot QA 清单：`docs/PILOT_QA.md`
+
+## 第一阶段目标
+
+1. 保留 ClawX 基础功能可运行。
+2. 接入 YINIAN 登录态和工作空间上下文。
+3. 建立 `kernel-core` 端口契约。
+4. 建立 OpenClaw Adapter 的最小实现。
+5. 替换首屏为“今日”工作台。
+6. 跑通一个服务端下发 skill 的闭环。
+
+## 工程边界
+
+- Renderer 不直接访问 NIANXX 服务端。
+- Renderer 不读取 token。
+- 客户端不保存第三方模型 API key。
+- Skill bundle 必须签名后才能加载。
+- OpenClaw 相关调用必须逐步收口到 `packages/kernel-adapter-openclaw`。
+
+## 常用命令
+
+```bash
+pnpm install
+pnpm run typecheck
+pnpm run test
+pnpm run build:vite
+pnpm run test:e2e
+pnpm run dev
+```
+
+## 关键环境变量
+
+| 变量 | 用途 |
+|---|---|
+| `YINIAN_API_BASE_URL` | 配置后启用真实 HTTP control plane；未配置时使用 mock。 |
+| `CLAWX_LEGACY_AUTOSTART=1` | 调试时恢复 ClawX 旧的 Gateway 启动行为。 |
+| `CLAWX_E2E=1` | Playwright E2E 兼容模式，保留旧 setup/main flow。 |