docs: complete dev command guide

Author: chenjiahan

AGENTS.md

@@ -31,6 +31,11 @@ pnpm --filter rstack test
 
 - Run `pnpm build` once before `pnpm test` command
 
+## Documentation
+
+- Keep corresponding content in `website/docs/en` and `website/docs/zh` aligned in structure, meaning, links, and examples.
+- Keep corresponding heading anchors identical between `website/docs/en` and `website/docs/zh`. When a translated heading would generate a different anchor, add an explicit anchor matching the English heading, for example `## 配置 \{#configuration}`.
+
 ## Project structure
 
 ```text

website/docs/en/guide/cli/dev.mdx

@@ -1,7 +1,43 @@
 # dev
 
-TODO.
+The `rs dev` command starts the [Rsbuild development server](https://rsbuild.rs/guide/basic/server) for an application. It compiles the source code in development mode, watches for changes, and applies hot module replacement (HMR) or reloads the page as needed.
+
+## Usage
+
+```bash
+rs dev [options]
+```
+
+The command loads the application configuration registered with [`define.app()`](../configuration#define-app). When the Rstack configuration file or one of its imported dependencies changes, Rstack automatically restarts the development server and applies the updated configuration.
+
+## Options
+
+`rs dev` supports the same development server options as Rsbuild. See the [Rsbuild CLI documentation](https://rsbuild.rs/guide/basic/cli#rsbuild) for details.
+
+Examples:
+
+```bash
+# Start the server and open the page in the browser
+rs dev --open
+
+# Use port 8080 and fail if it is already in use
+rs dev --port 8080 --strict-port
+
+# Make the server available on the local network
+rs dev --host
+```
 
 ## Configuration
 
-See [`define.app()`](../configuration#define-app).
+Configure the development server through [`define.app()`](../configuration#define-app) in the [Rstack configuration file](/guide/configuration#configuration-file). It accepts the standard [Rsbuild configuration](https://rsbuild.rs/config/):
+
+```ts title="rstack.config.ts"
+import { define } from 'rstack';
+
+define.app({
+  server: {
+    open: true,
+    port: 8080,
+  },
+});
+```

website/docs/zh/guide/cli/build.mdx

@@ -2,6 +2,6 @@
 
 TODO.
 
-## 配置
+## 配置 \{#configuration}
 
 参见 [`define.app()`](../configuration#define-app)。

website/docs/zh/guide/cli/dev.mdx

@@ -1,7 +1,43 @@
 # dev
 
-TODO.
+`rs dev` 命令用于启动应用的 [Rsbuild 开发服务器](https://rsbuild.rs/guide/basic/server)。它会以开发模式编译源码、监听文件变化，并按需进行模块热更新（HMR）或刷新页面。
 
-## 配置
+## 用法 \{#usage}
 
-参见 [`define.app()`](../configuration#define-app)。
+```bash
+rs dev [options]
+```
+
+该命令会加载通过 [`define.app()`](../configuration#define-app) 注册的应用配置。当 Rstack 配置文件或其导入的任一依赖发生变化时，Rstack 会自动重启开发服务器并应用更新后的配置。
+
+## 选项 \{#options}
+
+`rs dev` 支持与 Rsbuild 相同的开发服务器选项，具体说明请参见 [Rsbuild CLI 文档](https://rsbuild.rs/zh/guide/basic/cli#rsbuild)。
+
+示例：
+
+```bash
+# 启动服务器并在浏览器中打开页面
+rs dev --open
+
+# 使用 8080 端口，并在端口已被占用时退出
+rs dev --port 8080 --strict-port
+
+# 允许通过局域网访问开发服务器
+rs dev --host
+```
+
+## 配置 \{#configuration}
+
+在 [Rstack 配置文件](/guide/configuration#configuration-file)中通过 [`define.app()`](../configuration#define-app) 配置开发服务器。该 API 支持标准的 [Rsbuild 配置](https://rsbuild.rs/zh/config/)：
+
+```ts title="rstack.config.ts"
+import { define } from 'rstack';
+
+define.app({
+  server: {
+    open: true,
+    port: 8080,
+  },
+});
+```

website/docs/zh/guide/cli/doc.mdx

@@ -2,6 +2,6 @@
 
 TODO.
 
-## 配置
+## 配置 \{#configuration}
 
 参见 [`define.doc()`](../configuration#define-doc)。

website/docs/zh/guide/cli/lib.mdx

@@ -2,6 +2,6 @@
 
 TODO.
 
-## 配置
+## 配置 \{#configuration}
 
 参见 [`define.lib()`](../configuration#define-lib)。

website/docs/zh/guide/cli/lint.mdx

@@ -2,6 +2,6 @@
 
 TODO.
 
-## 配置
+## 配置 \{#configuration}
 
 参见 [`define.lint()`](../configuration#define-lint)。

website/docs/zh/guide/cli/preview.mdx

@@ -2,6 +2,6 @@
 
 TODO.
 
-## 配置
+## 配置 \{#configuration}
 
 参见 [`define.app()`](../configuration#define-app)。

website/docs/zh/guide/cli/staged.mdx

@@ -2,6 +2,6 @@
 
 TODO.
 
-## 配置
+## 配置 \{#configuration}
 
 参见 [`define.staged()`](../configuration#define-staged)。

website/docs/zh/guide/cli/test.mdx

@@ -2,6 +2,6 @@
 
 TODO.
 
-## 配置
+## 配置 \{#configuration}
 
 参见 [`define.test()`](../configuration#define-test)。