Update docs (#156)

* docs: 更新 rsmax 安装说明

* docs: 移除 v1 文档

---------

Co-authored-by: watsonhaw5566 <348748267@qq.com>

Author: watsonhaw5566

README.md

@@ -29,7 +29,7 @@ export default function Counter() {
 ## 快速开始
 
 ```bash
-pnpm add rsmax
+pnpm add -D rsmax
 rsmax dev src -o dist
 ```
 
@@ -42,8 +42,6 @@ pnpm docs:dev      # 本地预览
 pnpm docs:build    # 构建文档
 ```
 
-文档内含 v2（当前版本）与 v1（旧版）两套内容，可在导航栏右上角切换。
-
 ## License
 
 MIT

docs/.vitepress/config.js

@@ -1,7 +1,7 @@
 import { defineConfig } from 'vitepress';
 
 // ============================================================
-// v2（当前版本）侧边栏
+// 侧边栏
 // ============================================================
 const guideSidebar = [
   {
@@ -39,111 +39,6 @@ const guideSidebar = [
   },
 ];
 
-// ============================================================
-// v1（旧版）侧边栏
-// ============================================================
-const v1GuideSidebar = [
-  {
-    text: '开始',
-    collapsed: false,
-    items: [
-      { text: '快速上手', link: '/v1/guide/quick-start' },
-      { text: '常见问题', link: '/v1/faq' },
-    ],
-  },
-  {
-    text: '基础指南',
-    collapsed: false,
-    items: [
-      { text: 'CLI 命令行', link: '/v1/guide/basic/cli' },
-      { text: 'React', link: '/v1/guide/basic/react' },
-      { text: 'public 目录', link: '/v1/guide/basic/public' },
-      { text: '调试工具', link: '/v1/guide/basic/devtools' },
-      { text: '错误处理', link: '/v1/guide/basic/error-handling' },
-      { text: '小程序自定义组件', link: '/v1/guide/basic/custom-component' },
-      { text: '使用小程序插件', link: '/v1/guide/basic/plugin' },
-    ],
-  },
-  {
-    text: '进阶指南',
-    collapsed: false,
-    items: [
-      { text: '混合开发', link: '/v1/guide/advanced/hybrid' },
-      { text: '性能优化', link: '/v1/guide/advanced/performance' },
-      { text: '使用插件', link: '/v1/guide/advanced/plugin' },
-      { text: '状态共享', link: '/v1/guide/advanced/sharing-state' },
-      { text: 'TypeScript 支持', link: '/v1/guide/advanced/typescript' },
-    ],
-  },
-  {
-    text: '框架',
-    collapsed: false,
-    items: [
-      { text: 'App', link: '/v1/guide/framework/app' },
-      { text: '页面', link: '/v1/guide/framework/page' },
-      { text: '组件', link: '/v1/guide/framework/component' },
-      { text: '事件', link: '/v1/guide/framework/event' },
-      { text: 'API', link: '/v1/guide/framework/api' },
-      { text: '样式', link: '/v1/guide/framework/style' },
-    ],
-  },
-  {
-    text: '跨平台开发',
-    collapsed: false,
-    items: [
-      { text: 'Rsmax One', link: '/v1/guide/one/' },
-      { text: 'Web 同构', link: '/v1/guide/one/web' },
-    ],
-  },
-  {
-    text: '配置',
-    collapsed: false,
-    items: [
-      { text: 'Rsmax 配置', link: '/v1/guide/config/rsmax' },
-      { text: '环境变量', link: '/v1/guide/config/environment-variables' },
-      { text: 'PostCSS 配置', link: '/v1/guide/config/postcss' },
-    ],
-  },
-  {
-    text: '其他',
-    collapsed: false,
-    items: [
-      { text: '小程序插件开发', link: '/v1/guide/writing-mini-plugins' },
-      { text: '实现原理', link: '/v1/guide/implementation-notes' },
-    ],
-  },
-];
-
-const v1ApiSidebar = [
-  {
-    text: 'API',
-    collapsed: false,
-    items: [
-      { text: 'rsmax', link: '/v1/api/rsmax' },
-      { text: 'rsmax / build', link: '/v1/api/rsmax-build' },
-      { text: 'rsmax / macro', link: '/v1/api/rsmax-macro' },
-    ],
-  },
-  {
-    text: 'rsmax / one',
-    collapsed: false,
-    items: [
-      { text: 'API', link: '/v1/api/rsmax-one/api' },
-      { text: '组件', link: '/v1/api/rsmax-one/components' },
-      { text: '事件', link: '/v1/api/rsmax-one/event' },
-      { text: '生命周期', link: '/v1/api/rsmax-one/lifecycle' },
-    ],
-  },
-  {
-    text: 'rsmax / [平台]',
-    collapsed: false,
-    items: [
-      { text: 'API', link: '/v1/api/rsmax-platform/api' },
-      { text: '组件', link: '/v1/api/rsmax-platform/component' },
-    ],
-  },
-];
-
 export default defineConfig({
   lang: 'zh-CN',
   title: 'Rsmax',
@@ -156,19 +51,9 @@ export default defineConfig({
 
     nav: [
       { text: '指南', link: '/guide/introduction', activeMatch: '/guide/' },
-      {
-        text: 'v2.x',
-        items: [
-          { text: 'v2.x', link: '/' },
-          { text: 'v1.x', link: '/v1/' },
-        ],
-      },
     ],
 
-    // 更具体的前缀需放在前面
     sidebar: {
-      '/v1/api/': v1ApiSidebar,
-      '/v1/': v1GuideSidebar,
       '/guide/': guideSidebar,
     },
 

docs/guide/getting-started.md

@@ -8,12 +8,16 @@
 
 ## 安装
 
-在你的小程序项目中安装 `rsmax`：
+在你的小程序项目中安装 `rsmax`（**请安装到 `devDependencies`**）：
 
 ```bash
-pnpm add rsmax
+pnpm add -D rsmax
 ```
 
+::: warning 为什么必须是 devDependencies
+rsmax 是编译期工具链，小程序运行时并不依赖它。微信开发者工具的「构建 npm」只会扫描 `dependencies`，若把 rsmax 装入其中，工具会连带解析它的 Node 侧依赖（如 `@parcel/watcher`、`@babel/*`），这些包含工具无法解析的语法，构建会报 `parse js file ... failed: Unexpected token` 之类的错误。
+:::
+
 ## 项目结构
 
 ```
@@ -106,4 +110,11 @@ npx rsmax build src -o dist
 
 ## 使用 npm 包
 
-首次使用第三方 npm 包后，需在微信开发者工具中执行 **工具 → 构建 npm**。构建产物 `miniprogram_npm` 目录会被 rsmax 自动保留，无需重复构建。详见 [CLI 命令](./cli)。
+依赖按用途安装到不同位置：
+
+| 依赖类型 | 安装位置 | 示例 |
+|---------|---------|------|
+| 编译期工具链 | `devDependencies`（`pnpm add -D`） | `rsmax` |
+| 小程序运行时使用的包 | `dependencies`（`pnpm add`） | `@vant/weapp`、`tdesign-miniprogram`、`dayjs` |
+
+「构建 npm」只处理 `dependencies` 中的包：首次安装运行时 npm 包后，需在微信开发者工具中执行 **工具 → 构建 npm**。构建产物 `miniprogram_npm` 目录会被 rsmax 自动保留，无需重复构建。详见 [CLI 命令](./cli)。

docs/guide/ui-libraries.md

@@ -10,7 +10,7 @@
 | TDesign MiniProgram | `tdesign-miniprogram` | `t-` | `t-button` → `tdesign-miniprogram/button/button` |
 | Ant Design Mini | `antd-mini` | `ant-` | `ant-button` → `antd-mini/Button/index` |
 
-安装后直接使用：
+安装后直接使用（UI 组件库属于小程序运行时依赖，请安装到 `dependencies`，**不要加 `-D`**，否则「构建 npm」扫描不到）：
 
 ```bash
 pnpm add @vant/weapp