48 lines
1.3 KiB
Markdown
48 lines
1.3 KiB
Markdown
# 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。 |
|