# 新同事上手 — 正文已并入站上的「上手」页

> **正文在这里（免登录可读，发给同事就发这个）**：
> **https://product-demo.tvustream.com/tvu-design-system/playground-dist/#/guide/onboarding**
>
> 仓库内的源文件 = [`playground/docs/pages/OnboardingPage.vue`](../playground/docs/pages/OnboardingPage.vue)（2026-08-13 起是**站内真页面**，进了左侧「上手」组；老地址 `playground-dist/onboarding.html` 仍在、已缩成重定向壳，别再把它当正文真源）（随 `pnpm build:playground` 发布）。

---

## 为什么本文只剩指针

本文和站上那一页曾经是同一份内容的两个副本（Markdown 版 + HTML 版）。
**代价当场就付了**：组件数写错的那句话要改两遍，实际漏了几处，一个错数字同时活在 4 份文档里。

2026-08-11 owner 拍板把「装」和「用」合成站上一页并发布后，副本就没有存在理由了 ——
读者要的那一份在公网上、不需要授权；而仓库里再留一份全文，只会重新长出「一处改两遍」。

⚠️ **要改上手流程，改站上那一页的源文件，别改回本文。**

---

## 那一页里有什么

| 段 | 内容 |
|---|---|
| 这套系统怎么用 | 一句话（先问系统有什么，再动手）+ 三条工作方法 |
| 你手上有什么（3 行自测） | 分诊到你真能走的路；**没有 Gitea 权限的同事只有路线 0 和 B 是活的** |
| 该装什么 | **安装路径 A**（本地源码，会改设计系统的人）· **安装路径 B**（npm 依赖，只用不改的人） |
| 引用起来 | peer `vue ^3.5.0` 门槛 · `style.css` 必引 · 全局注册 vs 按需 · Button props · `data-theme` 主题 · 图标 · React / 原生走 `./web-components` · 报错对照表 |
| 装好之后 | 一次任务从头到尾的顺序 + 唤醒词 + 做界面记住三条 |
| 四条路各自 | 路线 0 文档站 · A Figma · B Claude Design · C 写代码，各带 30 秒自检和真实卡点 |

页面顶部可以**按身份筛选**（我只想看看 / 出 Figma 稿 / 出稿不用 Figma / 写代码），选完只显示跟你有关的段；宽屏左侧有目录。

---

## 相关

| 想要 | 去哪 |
|---|---|
| 「装好之后做什么」的仓库侧指针 | [`DESIGNING_WITH_TVU.md`](./DESIGNING_WITH_TVU.md) |
| 只装 Claude Code plugin | 站上「上手」页 [两行命令装插件](https://product-demo.tvustream.com/tvu-design-system/playground-dist/#/guide/onboarding#install-plugin) |
| npm 装包步骤 / 401 排查（开发向完整版） | [`GETTING_STARTED.md`](./GETTING_STARTED.md) |
| 唤醒词全表 | [`WAKE-WORDS.md`](./WAKE-WORDS.md) |
| 品牌色和 logo 规范 | [`BRANDING.md`](../BRANDING.md) |
| 想改进设计系统本身 | [`CONTRIBUTING.md`](../CONTRIBUTING.md) — 走 PR，owner review |