# 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。 |