NianToB/docs/START_HERE.md

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。

常用命令

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。