diff --git a/app/layout.config.tsx b/app/layout.config.tsx
index b0351be2..b660ce1c 100644
--- a/app/layout.config.tsx
+++ b/app/layout.config.tsx
@@ -18,6 +18,10 @@ export function baseOptions(locale: string): BaseLayoutProps {
     },
     // see https://fumadocs.dev/docs/ui/navigation/links
     links: [
+      {
+        text: customTranslations[locale]['guides.title'],
+        url: '/guides/sheets',
+      },
       {
         text: customTranslations[locale]['reference.title'],
         url: '/reference/classes/univer',
diff --git a/content/guides/changelog.ja-JP.mdx b/content/guides/changelog.ja-JP.mdx
new file mode 100644
index 00000000..9e9f353d
--- /dev/null
+++ b/content/guides/changelog.ja-JP.mdx
@@ -0,0 +1,52 @@
+---
+title: 変更ログ
+---
+
+Univer は [セマンティック バージョニング](https://semver.org/lang/ja/)（`MAJOR.MINOR.PATCH`）に従います。
+
+- **MAJOR**：互換性のない API 変更
+- **MINOR**：新機能、後方互換性あり
+- **PATCH**：バグ修正、後方互換性あり
+
+## リリース チャンネル
+
+| チャンネル | 安定性 | 用途 |
+|-----------|--------|------|
+| 安定版 (`latest`) | 本番環境対応 | 本番デプロイ |
+| ベータ版 (`beta`) | 機能完了、テスト中 | 本番前の検証 |
+| アルファ版 (`alpha`) | 開発中 | 早期アクセス、フィードバック |
+| ナイトリー版 (`nightly`) | 最新コミット | 最先端のテスト |
+
+npm タグを使用して特定のチャンネルをインストールできます：
+
+```bash
+npm install @univerjs/core@latest
+npm install @univerjs/core@beta
+npm install @univerjs/core@alpha
+npm install @univerjs/core@nightly
+```
+
+> **重要**：アルファ版、ベータ版、ナイトリー版にはバグや不完全な機能が含まれる可能性があります。本番環境での使用は避けてください。
+
+## バージョン履歴
+
+すべてのバージョンのリリースノートは [GitHub Releases](https://github.com/dream-num/univer/releases) で公開されています。
+
+### アップグレード方法
+
+1. 破壊的変更について [リリースノート](https://github.com/dream-num/univer/releases) を確認する
+2. すべての `@univerjs/*` パッケージを同じターゲット バージョンに更新する
+3. テスト スイートを実行する
+4. 問題が発生した場合は、[トラブルシューティング](/guides/troubleshooting) ガイドを参照する
+
+### 非推奨ポリシー
+
+- 非推奨としてマークされた機能は、少なくとも 1 つのマイナー バージョンは引き続き動作します
+- 非推奨の API は、開発ビルドで警告をログ出力します
+- 移行パスはリリースノートに記載されます
+
+## 最新情報を入手する
+
+- [GitHub リポジトリ](https://github.com/dream-num/univer) をウォッチしてリリース通知を受け取る
+- [ブログ](/blog) をフォローして詳細な機能発表を確認する
+- [Discord](https://discord.gg/XPGnMBmpd6) に参加してディスカッションに参加する
diff --git a/content/guides/changelog.mdx b/content/guides/changelog.mdx
new file mode 100644
index 00000000..fcca0539
--- /dev/null
+++ b/content/guides/changelog.mdx
@@ -0,0 +1,52 @@
+---
+title: Changelog
+---
+
+Univer follows [Semantic Versioning](https://semver.org/) (`MAJOR.MINOR.PATCH`).
+
+- **MAJOR**: Incompatible API changes
+- **MINOR**: New features, backwards compatible
+- **PATCH**: Bug fixes, backwards compatible
+
+## Release Channels
+
+| Channel | Stability | Use Case |
+|---------|-----------|----------|
+| Stable (`latest`) | Production-ready | Production deployments |
+| Beta (`beta`) | Feature-complete, testing | Pre-production validation |
+| Alpha (`alpha`) | In development | Early access, feedback |
+| Nightly (`nightly`) | Latest commits | Bleeding edge testing |
+
+You can install a specific channel via npm tags:
+
+```bash
+npm install @univerjs/core@latest
+npm install @univerjs/core@beta
+npm install @univerjs/core@alpha
+npm install @univerjs/core@nightly
+```
+
+> **Important**: Alpha, beta, and nightly versions may contain bugs or incomplete features. Avoid using them in production.
+
+## Version History
+
+Release notes for all versions are published on [GitHub Releases](https://github.com/dream-num/univer/releases).
+
+### How to Upgrade
+
+1. Review the [release notes](https://github.com/dream-num/univer/releases) for breaking changes
+2. Update all `@univerjs/*` packages to the same target version
+3. Run your test suite
+4. Check the [Troubleshooting](/guides/troubleshooting) guide if issues arise
+
+### Deprecation Policy
+
+- Features marked as deprecated will continue to work for at least one minor version
+- Deprecated APIs will log warnings in development builds
+- Migration paths are documented in the release notes
+
+## Staying Informed
+
+- Watch the [GitHub repository](https://github.com/dream-num/univer) for release notifications
+- Follow our [blog](/blog) for in-depth feature announcements
+- Join our [Discord](https://discord.gg/XPGnMBmpd6) for discussions
diff --git a/content/guides/changelog.zh-CN.mdx b/content/guides/changelog.zh-CN.mdx
new file mode 100644
index 00000000..33031e85
--- /dev/null
+++ b/content/guides/changelog.zh-CN.mdx
@@ -0,0 +1,52 @@
+---
+title: 更新日志
+---
+
+Univer 遵循 [语义化版本控制](https://semver.org/lang/zh-CN/)（`MAJOR.MINOR.PATCH`）。
+
+- **MAJOR（主版本）**：不兼容的 API 变更
+- **MINOR（次版本）**：新增功能，向后兼容
+- **PATCH（修订版本）**：问题修复，向后兼容
+
+## 发布渠道
+
+| 渠道 | 稳定性 | 适用场景 |
+|------|--------|----------|
+| 稳定版 (`latest`) | 生产环境可用 | 生产部署 |
+| 测试版 (`beta`) | 功能完整，测试中 | 生产前验证 |
+| 预览版 (`alpha`) | 开发中 | 早期体验、反馈 |
+| 每夜版 (`nightly`) | 最新提交 | 前沿功能测试 |
+
+你可以通过 npm 标签安装特定渠道：
+
+```bash
+npm install @univerjs/core@latest
+npm install @univerjs/core@beta
+npm install @univerjs/core@alpha
+npm install @univerjs/core@nightly
+```
+
+> **重要**：Alpha、Beta 和每夜版可能包含缺陷或未完成的功能，请避免在生产环境中使用。
+
+## 版本历史
+
+所有版本的发布说明均发布在 [GitHub Releases](https://github.com/dream-num/univer/releases)。
+
+### 如何升级
+
+1. 查看 [发布说明](https://github.com/dream-num/univer/releases) 了解破坏性变更
+2. 将所有 `@univerjs/*` 包更新到相同的目标版本
+3. 运行你的测试套件
+4. 如遇到问题，请查看 [故障排查](/guides/troubleshooting) 指南
+
+### 弃用策略
+
+- 标记为弃用的功能至少会再维护一个次版本
+- 弃用的 API 会在开发构建中输出警告
+- 迁移路径会在发布说明中记录
+
+## 保持关注
+
+- Watch [GitHub 仓库](https://github.com/dream-num/univer) 获取发布通知
+- 关注我们的 [博客](/blog) 了解深度功能公告
+- 加入 [Discord](https://discord.gg/XPGnMBmpd6) 参与讨论
diff --git a/content/guides/changelog.zh-TW.mdx b/content/guides/changelog.zh-TW.mdx
new file mode 100644
index 00000000..24e5fb63
--- /dev/null
+++ b/content/guides/changelog.zh-TW.mdx
@@ -0,0 +1,52 @@
+---
+title: 更新日誌
+---
+
+Univer 遵循 [語義化版本控制](https://semver.org/lang/zh-TW/)（`MAJOR.MINOR.PATCH`）。
+
+- **MAJOR（主版本）**：不相容的 API 變更
+- **MINOR（次版本）**：新增功能，向後相容
+- **PATCH（修訂版本）**：問題修復，向後相容
+
+## 發布渠道
+
+| 渠道 | 穩定性 | 適用場景 |
+|------|--------|----------|
+| 穩定版 (`latest`) | 生產環境可用 | 生產部署 |
+| 測試版 (`beta`) | 功能完整，測試中 | 生產前驗證 |
+| 預覽版 (`alpha`) | 開發中 | 早期體驗、回饋 |
+| 每夜版 (`nightly`) | 最新提交 | 前沿功能測試 |
+
+你可以透過 npm 標籤安裝特定渠道：
+
+```bash
+npm install @univerjs/core@latest
+npm install @univerjs/core@beta
+npm install @univerjs/core@alpha
+npm install @univerjs/core@nightly
+```
+
+> **重要**：Alpha、Beta 和每夜版可能包含缺陷或未完成的功能，請避免在生產環境中使用。
+
+## 版本歷史
+
+所有版本的發布說明均發布在 [GitHub Releases](https://github.com/dream-num/univer/releases)。
+
+### 如何升級
+
+1. 查看 [發布說明](https://github.com/dream-num/univer/releases) 了解破壞性變更
+2. 將所有 `@univerjs/*` 套件更新到相同的目標版本
+3. 執行你的測試套件
+4. 如遇到問題，請查看 [故障排查](/guides/troubleshooting) 指南
+
+### 棄用策略
+
+- 標記為棄用的功能至少會再維護一個次版本
+- 棄用的 API 會在開發建置中輸出警告
+- 遷移路徑會在發布說明中記錄
+
+## 保持關注
+
+- Watch [GitHub 倉庫](https://github.com/dream-num/univer) 取得發布通知
+- 關注我們的 [部落格](/blog) 了解深度功能公告
+- 加入 [Discord](https://discord.gg/XPGnMBmpd6) 參與討論
diff --git a/content/guides/contributing.ja-JP.mdx b/content/guides/contributing.ja-JP.mdx
new file mode 100644
index 00000000..e45477a3
--- /dev/null
+++ b/content/guides/contributing.ja-JP.mdx
@@ -0,0 +1,144 @@
+---
+title: コントリビューションガイド
+---
+
+Univer へのコントリビューションに興味をお持ちいただき、ありがとうございます！このガイドは、あなたの始め方をお手伝いします。
+
+## 行動規範
+
+すべてのコントリビューターにとって、フレンドリーで安全、かつ歓迎される環境を提供することをお約束します。すべてのやり取りで、敬意を持ち建設的であってください。
+
+## コントリビューションの方法
+
+### バグの報告
+
+バグ報告を作成する前に、以下を行ってください：
+
+1. [既存の issue](https://github.com/dream-num/univer/issues) を検索して重複を避ける
+2. 最新の安定版を使用してバグがまだ存在することを確認する
+3. 関連情報を収集する：ブラウザーのバージョン、Node.js のバージョン、エラーメッセージ
+
+報告時には以下を含めてください：
+
+- 明確で説明的なタイトル
+- 問題を再現する手順
+- 期待される動作と実際の動作
+- 最小限の再現例（CodeSandbox、StackBlitz、または GitHub リポジトリ）
+- 該当する場合は、スクリーンショットや画面録画
+
+### 機能の提案
+
+機能リクエストは歓迎されます！まずディスカッションを開いて、コミュニティやメンテナーからのフィードバックを集めることをお勧めします。
+
+### コードのコントリビューション
+
+#### 開発環境のセットアップ
+
+1. リポジトリをフォークしてクローンします：
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/univer.git
+   cd univer
+   ```
+
+2. 依存関係をインストールします：
+   ```bash
+   pnpm install
+   ```
+
+3. プロジェクトをビルドします：
+   ```bash
+   pnpm build
+   ```
+
+4. テストを実行します：
+   ```bash
+   pnpm test
+   ```
+
+#### プロジェクト構造
+
+```
+packages/
+  core/           # コア インフラストラクチャ（DI、コマンド システム、ライフサイクル）
+  design/         # デザイン システムと基本スタイル
+  engine-render/  # Canvas レンダリング エンジン
+  engine-formula/ # 数式計算エンジン
+  sheets/         # スプレッドシート データ モデルとコア ロジック
+  sheets-ui/      # スプレッドシート UI コンポーネント
+  docs/           # ドキュメント データ モデル
+  docs-ui/        # ドキュメント UI コンポーネント
+  slides/         # プレゼンテーション データ モデル
+  ui/             # 共有 UI フレームワーク
+examples/         # 統合例（React、Vue、Angular など）
+```
+
+#### プラグインの作成
+
+Univer はプラグイン アーキテクチャで構築されています。新しい機能を追加するには：
+
+1. `packages/` の下に新しいパッケージを作成するか、スタンドアロンのリポジトリを作成します
+2. `Plugin` を拡張するプラグイン クラスを実装します
+3. `onStarting` でコマンド、サービス、コントローラーを登録します
+4. 公開 API を公開する場合は、ファサード拡張を追加します
+5. テストとドキュメントを作成します
+
+ステップバイステップのガイドについては、[カスタム プラグイン チュートリアル](/guides/recipes/tutorials/custom-plugin) を参照してください。
+
+#### コミット規約
+
+[Conventional Commits](https://www.conventionalcommits.org/ja/v1.0.0/) を使用しています：
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+一般的なタイプ：
+
+- `feat`：新機能
+- `fix`：バグ修正
+- `docs`：ドキュメントの変更
+- `style`：コード スタイルの変更（フォーマット、セミコロンなど）
+- `refactor`：コードのリファクタリング
+- `perf`：パフォーマンスの改善
+- `test`：テストの追加または修正
+- `chore`：ビルド プロセスまたは補助ツールの変更
+
+例：
+```
+feat(sheets): カスタム数値形式のサポートを追加
+
+Closes #1234
+```
+
+#### Pull Request のプロセス
+
+1. `dev` ブランチから機能ブランチを作成します
+2. 明確で焦点を絞ったコミットを行います
+3. 必要に応じてテストを追加または更新します
+4. `pnpm lint` と `pnpm test` がパスすることを確認します
+5. 変更が公開 API に影響する場合は、ドキュメントを更新します
+6. `dev` ブランチに対して Pull Request を開きます
+7. PR テンプレートに明確な説明を記入します
+
+### ドキュメントへのコントリビューション
+
+ドキュメントの改善も非常に評価されています。ドキュメントを編集するには：
+
+1. ドキュメントは [documentation リポジトリ](https://github.com/dream-num/documentation) にあります
+2. 各ページは対応する `.mdx` ファイルを持っています
+3. 既存のスタイルとフォーマットに従ってください
+4. 該当する場合は、すべての言語バリアントを更新してください（en-US、zh-CN、zh-TW、ja-JP）
+
+## コミュニティ
+
+- [Discord](https://discord.gg/XPGnMBmpd6)：リアルタイムのディスカッションとサポート
+- [GitHub Discussions](https://github.com/dream-num/univer/discussions)：長い形式のディスカッションと Q&A
+- [Twitter / X](https://twitter.com/univerhq)：アナウンスと更新
+
+## ライセンス
+
+Univer にコントリビュートすることで、あなたのコントリビューションが [Apache License 2.0](https://github.com/dream-num/univer/blob/dev/LICENSE.txt) の下でライセンスされることに同意したものとみなされます。
diff --git a/content/guides/contributing.mdx b/content/guides/contributing.mdx
new file mode 100644
index 00000000..5e9045a4
--- /dev/null
+++ b/content/guides/contributing.mdx
@@ -0,0 +1,144 @@
+---
+title: Contributing
+---
+
+Thank you for your interest in contributing to Univer! This guide will help you get started.
+
+## Code of Conduct
+
+We are committed to providing a friendly, safe, and welcoming environment for all contributors. Please be respectful and constructive in all interactions.
+
+## How to Contribute
+
+### Reporting Bugs
+
+Before creating a bug report, please:
+
+1. Search [existing issues](https://github.com/dream-num/univer/issues) to avoid duplicates
+2. Use the latest stable version to verify the bug still exists
+3. Collect relevant information: browser version, Node.js version, error messages
+
+When reporting, include:
+
+- A clear, descriptive title
+- Steps to reproduce the issue
+- Expected vs actual behavior
+- A minimal reproduction (CodeSandbox, StackBlitz, or GitHub repo)
+- Screenshots or screen recordings if applicable
+
+### Suggesting Features
+
+Feature requests are welcome! Please open a discussion first to gather feedback from the community and maintainers.
+
+### Contributing Code
+
+#### Development Setup
+
+1. Fork and clone the repository:
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/univer.git
+   cd univer
+   ```
+
+2. Install dependencies:
+   ```bash
+   pnpm install
+   ```
+
+3. Build the project:
+   ```bash
+   pnpm build
+   ```
+
+4. Run tests:
+   ```bash
+   pnpm test
+   ```
+
+#### Project Structure
+
+```
+packages/
+  core/           # Core infrastructure (DI, command system, lifecycle)
+  design/         # Design system and base styles
+  engine-render/  # Canvas rendering engine
+  engine-formula/ # Formula calculation engine
+  sheets/         # Spreadsheet data model and core logic
+  sheets-ui/      # Spreadsheet UI components
+  docs/           # Document data model
+  docs-ui/        # Document UI components
+  slides/         # Presentation data model
+  ui/             # Shared UI framework
+examples/         # Integration examples (React, Vue, Angular, etc.)
+```
+
+#### Writing a Plugin
+
+Univer is built on a plugin architecture. To add new functionality:
+
+1. Create a new package under `packages/` or a standalone repository
+2. Implement the plugin class extending `Plugin`
+3. Register commands, services, and controllers in `onStarting`
+4. Add facade extensions if exposing public APIs
+5. Write tests and documentation
+
+See the [Custom Plugin Tutorial](/guides/recipes/tutorials/custom-plugin) for a step-by-step guide.
+
+#### Commit Convention
+
+We use [Conventional Commits](https://www.conventionalcommits.org/):
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+Common types:
+
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation changes
+- `style`: Code style changes (formatting, semicolons, etc.)
+- `refactor`: Code refactoring
+- `perf`: Performance improvements
+- `test`: Test additions or fixes
+- `chore`: Build process or auxiliary tool changes
+
+Example:
+```
+feat(sheets): add support for custom number formats
+
+Closes #1234
+```
+
+#### Pull Request Process
+
+1. Create a feature branch from `dev`
+2. Make your changes with clear, focused commits
+3. Add or update tests as needed
+4. Ensure `pnpm lint` and `pnpm test` pass
+5. Update documentation if your changes affect public APIs
+6. Open a Pull Request against the `dev` branch
+7. Fill out the PR template with a clear description
+
+### Contributing Documentation
+
+Documentation improvements are highly valued. To edit docs:
+
+1. Documentation lives in the [documentation repository](https://github.com/dream-num/documentation)
+2. Each page has a corresponding `.mdx` file
+3. Follow the existing style and formatting
+4. Update all language variants if applicable (en-US, zh-CN, zh-TW, ja-JP)
+
+## Community
+
+- [Discord](https://discord.gg/XPGnMBmpd6): Real-time discussions and support
+- [GitHub Discussions](https://github.com/dream-num/univer/discussions): Long-form discussions and Q&A
+- [Twitter / X](https://twitter.com/univerhq): Announcements and updates
+
+## License
+
+By contributing to Univer, you agree that your contributions will be licensed under the [Apache License 2.0](https://github.com/dream-num/univer/blob/dev/LICENSE.txt).
diff --git a/content/guides/contributing.zh-CN.mdx b/content/guides/contributing.zh-CN.mdx
new file mode 100644
index 00000000..816b2d3b
--- /dev/null
+++ b/content/guides/contributing.zh-CN.mdx
@@ -0,0 +1,144 @@
+---
+title: 贡献指南
+---
+
+感谢你对贡献 Univer 的兴趣！本文档将帮助你快速上手。
+
+## 行为准则
+
+我们致力于为所有贡献者提供一个友好、安全和受欢迎的环境。请在所有互动中保持尊重和建设性。
+
+## 如何贡献
+
+### 报告缺陷
+
+在创建缺陷报告之前，请：
+
+1. 搜索 [现有 issue](https://github.com/dream-num/univer/issues) 以避免重复
+2. 使用最新稳定版验证该缺陷是否仍然存在
+3. 收集相关信息：浏览器版本、Node.js 版本、错误信息
+
+报告时请包含：
+
+- 清晰、描述性的标题
+- 复现步骤
+- 预期行为与实际行为
+- 最小可复现示例（CodeSandbox、StackBlitz 或 GitHub 仓库）
+- 如有必要，附上截图或录屏
+
+### 提议新功能
+
+欢迎提交功能请求！建议先开启一个 discussion，收集社区和维护者的反馈。
+
+### 提交代码
+
+#### 开发环境搭建
+
+1. Fork 并克隆仓库：
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/univer.git
+   cd univer
+   ```
+
+2. 安装依赖：
+   ```bash
+   pnpm install
+   ```
+
+3. 构建项目：
+   ```bash
+   pnpm build
+   ```
+
+4. 运行测试：
+   ```bash
+   pnpm test
+   ```
+
+#### 项目结构
+
+```
+packages/
+  core/           # 核心基础设施（依赖注入、命令系统、生命周期）
+  design/         # 设计系统和基础样式
+  engine-render/  # Canvas 渲染引擎
+  engine-formula/ # 公式计算引擎
+  sheets/         # 电子表格数据模型和核心逻辑
+  sheets-ui/      # 电子表格 UI 组件
+  docs/           # 文档数据模型
+  docs-ui/        # 文档 UI 组件
+  slides/         # 演示文稿数据模型
+  ui/             # 共享 UI 框架
+examples/         # 集成示例（React、Vue、Angular 等）
+```
+
+#### 编写插件
+
+Univer 基于插件架构构建。要添加新功能：
+
+1. 在 `packages/` 下创建新包，或建立独立仓库
+2. 实现继承自 `Plugin` 的插件类
+3. 在 `onStarting` 中注册命令、服务和控制器
+4. 如需暴露公共 API，添加 Facade 扩展
+5. 编写测试和文档
+
+请参阅 [自定义插件教程](/guides/recipes/tutorials/custom-plugin) 获取分步指南。
+
+#### 提交规范
+
+我们使用 [Conventional Commits](https://www.conventionalcommits.org/zh-hans/v1.0.0/)：
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+常用类型：
+
+- `feat`：新功能
+- `fix`：缺陷修复
+- `docs`：文档变更
+- `style`：代码格式调整
+- `refactor`：代码重构
+- `perf`：性能优化
+- `test`：测试相关
+- `chore`：构建流程或辅助工具变更
+
+示例：
+```
+feat(sheets): 增加自定义数字格式支持
+
+Closes #1234
+```
+
+#### Pull Request 流程
+
+1. 从 `dev` 分支创建功能分支
+2. 进行清晰、专注的提交
+3. 根据需要添加或更新测试
+4. 确保 `pnpm lint` 和 `pnpm test` 通过
+5. 如果变更影响公共 API，更新文档
+6. 向 `dev` 分支发起 Pull Request
+7. 填写 PR 模板，提供清晰的描述
+
+### 贡献文档
+
+文档改进同样受到高度重视。编辑文档的步骤：
+
+1. 文档位于 [documentation 仓库](https://github.com/dream-num/documentation)
+2. 每页对应一个 `.mdx` 文件
+3. 遵循现有的风格和格式
+4. 如适用，请同时更新所有语言版本（en-US、zh-CN、zh-TW、ja-JP）
+
+## 社区
+
+- [Discord](https://discord.gg/XPGnMBmpd6)：实时讨论和支持
+- [GitHub Discussions](https://github.com/dream-num/univer/discussions)：长篇讨论和问答
+- [Twitter / X](https://twitter.com/univerhq)：公告和动态更新
+
+## 许可证
+
+向 Univer 贡献代码即表示你同意将你的贡献以 [Apache License 2.0](https://github.com/dream-num/univer/blob/dev/LICENSE.txt) 许可发布。
diff --git a/content/guides/contributing.zh-TW.mdx b/content/guides/contributing.zh-TW.mdx
new file mode 100644
index 00000000..a3acf8eb
--- /dev/null
+++ b/content/guides/contributing.zh-TW.mdx
@@ -0,0 +1,144 @@
+---
+title: 貢獻指南
+---
+
+感謝你對貢獻 Univer 的興趣！本文檔將幫助你快速上手。
+
+## 行為準則
+
+我們致力於為所有貢獻者提供一個友好、安全和受歡迎的環境。請在所有互動中保持尊重和建設性。
+
+## 如何貢獻
+
+### 報告缺陷
+
+在建立缺陷報告之前，請：
+
+1. 搜尋 [現有 issue](https://github.com/dream-num/univer/issues) 以避免重複
+2. 使用最新穩定版驗證該缺陷是否仍然存在
+3. 收集相關資訊：瀏覽器版本、Node.js 版本、錯誤資訊
+
+報告時請包含：
+
+- 清晰、描述性的標題
+- 復現步驟
+- 預期行為與實際行為
+- 最小可復現示例（CodeSandbox、StackBlitz 或 GitHub 倉庫）
+- 如有必要，附上截圖或錄影
+
+### 提議新功能
+
+歡迎提交功能請求！建議先開啟一個 discussion，收集社群和維護者的回饋。
+
+### 提交程式碼
+
+#### 開發環境搭建
+
+1. Fork 並克隆倉庫：
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/univer.git
+   cd univer
+   ```
+
+2. 安裝依賴：
+   ```bash
+   pnpm install
+   ```
+
+3. 構建專案：
+   ```bash
+   pnpm build
+   ```
+
+4. 執行測試：
+   ```bash
+   pnpm test
+   ```
+
+#### 專案結構
+
+```
+packages/
+  core/           # 核心基礎設施（依賴注入、命令系統、生命週期）
+  design/         # 設計系統和基礎樣式
+  engine-render/  # Canvas 渲染引擎
+  engine-formula/ # 公式計算引擎
+  sheets/         # 電子表格資料模型和核心邏輯
+  sheets-ui/      # 電子表格 UI 元件
+  docs/           # 文件資料模型
+  docs-ui/        # 文件 UI 元件
+  slides/         # 簡報資料模型
+  ui/             # 共享 UI 框架
+examples/         # 整合示例（React、Vue、Angular 等）
+```
+
+#### 編寫外掛程式
+
+Univer 基於外掛程式架構構建。要添加新功能：
+
+1. 在 `packages/` 下建立新套件，或建立獨立倉庫
+2. 實作繼承自 `Plugin` 的外掛程式類別
+3. 在 `onStarting` 中註冊命令、服務和控制器
+4. 如需暴露公共 API，添加 Facade 擴充
+5. 編寫測試和文件
+
+請參閱 [自訂外掛程式教學](/guides/recipes/tutorials/custom-plugin) 取得分步指南。
+
+#### 提交規範
+
+我們使用 [Conventional Commits](https://www.conventionalcommits.org/zh-hans/v1.0.0/)：
+
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+常用類型：
+
+- `feat`：新功能
+- `fix`：缺陷修復
+- `docs`：文件變更
+- `style`：程式碼格式調整
+- `refactor`：程式碼重構
+- `perf`：效能最佳化
+- `test`：測試相關
+- `chore`：建置流程或輔助工具變更
+
+示例：
+```
+feat(sheets): 增加自訂數字格式支援
+
+Closes #1234
+```
+
+#### Pull Request 流程
+
+1. 從 `dev` 分支建立功能分支
+2. 進行清晰、專注的提交
+3. 根據需要添加或更新測試
+4. 確保 `pnpm lint` 和 `pnpm test` 通過
+5. 如果變更影響公共 API，更新文件
+6. 向 `dev` 分支發起 Pull Request
+7. 填寫 PR 模板，提供清晰的描述
+
+### 貢獻文件
+
+文件改進同樣受到高度重視。編輯文件的步驟：
+
+1. 文件位於 [documentation 倉庫](https://github.com/dream-num/documentation)
+2. 每頁對應一個 `.mdx` 檔案
+3. 遵循現有的風格和格式
+4. 如適用，請同時更新所有語言版本（en-US、zh-CN、zh-TW、ja-JP）
+
+## 社群
+
+- [Discord](https://discord.gg/XPGnMBmpd6)：即時討論和支援
+- [GitHub Discussions](https://github.com/dream-num/univer/discussions)：長篇討論和問答
+- [Twitter / X](https://twitter.com/univerhq)：公告和動態更新
+
+## 授權條款
+
+向 Univer 貢獻程式碼即表示你同意將你的貢獻以 [Apache License 2.0](https://github.com/dream-num/univer/blob/dev/LICENSE.txt) 授權發布。
diff --git a/content/guides/meta.json b/content/guides/meta.json
index e084e330..950216c2 100644
--- a/content/guides/meta.json
+++ b/content/guides/meta.json
@@ -4,6 +4,10 @@
     "docs",
     "slides",
     "pro",
-    "recipes"
+    "recipes",
+    "---More---",
+    "troubleshooting",
+    "changelog",
+    "contributing"
   ]
 }
diff --git a/content/guides/sheets/getting-started/installation/index.mdx b/content/guides/sheets/getting-started/installation/index.mdx
index ee6fb2ee..57711b1f 100644
--- a/content/guides/sheets/getting-started/installation/index.mdx
+++ b/content/guides/sheets/getting-started/installation/index.mdx
@@ -2,7 +2,7 @@
 title: Installation & Basic Usage
 ---
 
-Univer adopts a plugin-based design philosophy, aim`ing to provide developers with a flexible and extensible framework for electronic document applications. Through this plugin-based design, Univer can easily integrate various functional modules to meet the needs of different users. However, the plugin-based design increases the complexity of the application, especially for developers who are new to Univer.
+Univer adopts a plugin-based design philosophy, aiming to provide developers with a flexible and extensible framework for electronic document applications. Through this plugin-based design, Univer can easily integrate various functional modules to meet the needs of different users. However, the plugin-based design increases the complexity of the application, especially for developers who are new to Univer.
 
 For this reason, Univer provides two ways to help you quickly integrate and use Univer: **plugin mode** and **preset mode**. The so-called **preset** is actually a combination of pre-configured plugins, so the capabilities provided by both modes are the same without complex extensions.
 
diff --git a/content/guides/troubleshooting.ja-JP.mdx b/content/guides/troubleshooting.ja-JP.mdx
new file mode 100644
index 00000000..bd180d64
--- /dev/null
+++ b/content/guides/troubleshooting.ja-JP.mdx
@@ -0,0 +1,175 @@
+---
+title: トラブルシューティング
+---
+
+このガイドでは、Univer のインストール、設定、実行時に発生する可能性のある一般的な問題と推奨される解決策について説明します。
+
+## インストールの問題
+
+### 依存関係のバージョンの不一致
+
+**症状**：インストール後にビルドエラーや実行時例外が発生する。
+
+**原因**：Univer のすべてのパッケージは、完全に同じバージョンを使用する必要があります。バージョンの混在はサポートされていません。
+
+**解決策**：
+
+```bash
+# 現在インストールされているバージョンを確認
+npm list @univerjs/core
+
+# すべてのパッケージを同じバージョンに更新
+npm install @univerjs/core@latest @univerjs/sheets@latest @univerjs/sheets-ui@latest
+```
+
+> すべての `@univerjs/*` および `@univerjs-pro/*` パッケージが同じバージョン番号を使用していることを常に確認してください。
+
+### Peer Dependency の警告
+
+**症状**：インストール時に `react`、`react-dom`、または `rxjs` に関する警告が表示される。
+
+**解決策**：
+
+```bash
+# npm 7+ は peerDependencies を自動的に処理します
+# 古いバージョンや yarn の場合は手動でインストールしてください
+npm install react react-dom rxjs
+```
+
+### Webpack 4 の互換性
+
+**症状**：Webpack 4 を使用しているときに `Module not found` エラーが発生する。
+
+**原因**：Webpack 4 は `package.json` の `exports` フィールドをサポートしていません。
+
+**解決策**：Webpack 5 にアップグレードするか、ビルド設定でインポートパスを実際のファイルパスに手動でマッピングしてください。
+
+## 実行時の問題
+
+### 空白画面 / Univer がレンダリングされない
+
+**症状**：初期化後にコンテナ要素が空になっている。
+
+**チェックリスト**：
+
+1. **コンテナ要素が存在する**：`createUniver` を呼び出す前に、指定された `container` id を持つ DOM 要素が存在することを確認してください。
+   ```html
+   <!-- HTML に #app が存在することを確認 -->
+   <div id="app"></div>
+   ```
+
+2. **CSS ファイルがインポートされている**：Univer は正しくレンダリングするために CSS を必要とします。
+   ```typescript
+   import '@univerjs/design/lib/index.css'
+   import '@univerjs/ui/lib/index.css'
+   ```
+
+3. **プラグインが正しい順序で登録されている**：UI プラグインはコアプラグインの後に登録する必要があります。
+   ```typescript
+   univer.registerPlugin(UniverRenderEnginePlugin)
+   univer.registerPlugin(UniverFormulaEnginePlugin)
+   univer.registerPlugin(UniverUIPlugin, { container: 'app' })
+   ```
+
+### 数式が計算されない
+
+**症状**：セルに計算結果ではなく数式テキスト（`=SUM(A1:A10)`）が表示される。
+
+**解決策**：
+
+1. `@univerjs/engine-formula` および `@univerjs/sheets-formula` プラグインが登録されていることを確認してください。
+2. `initialFormulaComputing` 設定を確認してください：
+   ```typescript
+   import { CalculationMode } from '@univerjs/engine-formula'
+   // 初期化時に強制計算
+   formulaEngine.setInitialFormulaComputing(CalculationMode.FORCED)
+   ```
+3. 数式の構文が Univer でサポートされていることを確認してください。
+
+### 元に戻す/やり直しが機能しない
+
+**症状**：Ctrl+Z / Ctrl+Y が反応しない。
+
+**原因**：元に戻す/やり直しプラグインが登録されていない可能性があります。
+
+**解決策**：`@univerjs/sheets-ui`（元に戻す/やり直し機能を含む）が登録されていることを確認してください。カスタムコマンドの場合、それらが `COMMAND` タイプとして適切に宣言され、正しい元に戻す/やり直しパラメータを持っていることを確認してください。
+
+## パフォーマンスの問題
+
+### 大規模データセットでのレンダリングが遅い
+
+**症状**：10万個以上のセルを含むワークシートのスクロールや編集時に遅延が発生する。
+
+**推奨事項**：
+
+1. **遅延読み込みを使用する**：最初のレンダリング後に必須でないプラグインを読み込みます。
+   ```typescript
+   univer.createUnit(UniverInstanceType.UNIVER_SHEET, {})
+   // 初期レンダリング後に重いプラグインを読み込む
+   import('@univerjs/watermark').then(({ UniverWatermarkPlugin }) => {
+     univer.registerPlugin(UniverWatermarkPlugin)
+   })
+   ```
+
+2. **過度なセルスタイルを避ける**：一意のスタイルはそれぞれメモリ使用量を増加させます。可能な限りスタイルを再利用してください。
+
+3. **データ処理にはサーバーサイドレンダリングを使用する**：重い計算の場合、Node.js での Univer 使用（ヘッドレスモード）を検討してください。
+
+### メモリ使用量が高い
+
+**症状**：ブラウザタブがクラッシュしたり、応答しなくなったりする。
+
+**推奨事項**：
+
+1. 未使用のワークブックインスタンスを破棄する：
+   ```typescript
+   const workbook = univerAPI.getActiveWorkbook()
+   workbook.dispose()
+   ```
+
+2. メモリ内に大きなスナップショットを不必要に保持しないようにしてください。
+
+## モバイルの問題
+
+### タッチイベントが応答しない
+
+**症状**：モバイルデバイスでセルを操作できない。
+
+**原因**：デスクトップとモバイルの UI プラグインは同時に使用できません。
+
+**解決策**：モバイル版の UI プラグインを使用してください：
+
+```typescript
+// デスクトップ UI プラグインをモバイル版に置き換える
+import { UniverSheetsMobileUIPlugin } from '@univerjs/sheets-ui'
+
+univer.registerPlugin(UniverSheetsMobileUIPlugin)
+```
+
+> モバイル対応は現在実験的です。本番環境にデプロイする前に、十分なテストをお勧めします。
+
+## Headless / Node.js の問題
+
+### `document is not defined` エラー
+
+**症状**：Node.js で実行時にエラーが発生する。
+
+**原因**：UI 関連のプラグインがブラウザー以外の環境で DOM API にアクセスしています。
+
+**解決策**：Node.js では、コアプラグインとデータプラグインのみを登録し、`-ui` サフィックスのプラグインは登録しないでください。
+
+```typescript
+// Node.js で安全なプラグインセット
+univer.registerPlugin(UniverRenderEnginePlugin)
+univer.registerPlugin(UniverFormulaEnginePlugin)
+univer.registerPlugin(UniverSheetsPlugin)
+// UniverSheetsUIPlugin や UniverUIPlugin は登録しない
+```
+
+## ヘルプの取得
+
+このドキュメントで問題が解決しない場合：
+
+1. [GitHub Issues](https://github.com/dream-num/univer/issues) で類似の問題を検索する
+2. リアルタイムサポートのために [Discord コミュニティ](https://discord.gg/XPGnMBmpd6) に参加する
+3. 最小限の再現例を作成し、新しい issue を提出する
diff --git a/content/guides/troubleshooting.mdx b/content/guides/troubleshooting.mdx
new file mode 100644
index 00000000..73e9a9b7
--- /dev/null
+++ b/content/guides/troubleshooting.mdx
@@ -0,0 +1,175 @@
+---
+title: Troubleshooting
+---
+
+This guide covers common issues you may encounter when installing, configuring, or running Univer, along with recommended solutions.
+
+## Installation Issues
+
+### Dependency Version Mismatch
+
+**Symptom**: Build errors or runtime exceptions after installation.
+
+**Cause**: Univer packages must use the exact same version. Mixing versions is not supported.
+
+**Solution**:
+
+```bash
+# Check current installed versions
+npm list @univerjs/core
+
+# Update all packages to the same version
+npm install @univerjs/core@latest @univerjs/sheets@latest @univerjs/sheets-ui@latest
+```
+
+> Always ensure all `@univerjs/*` and `@univerjs-pro/*` packages share the same version number.
+
+### Peer Dependency Warnings
+
+**Symptom**: Warnings about `react`, `react-dom`, or `rxjs` during installation.
+
+**Solution**:
+
+```bash
+# npm 7+ handles peerDependencies automatically
+# For older versions or yarn, install them manually
+npm install react react-dom rxjs
+```
+
+### Webpack 4 Compatibility
+
+**Symptom**: `Module not found` errors when using Webpack 4.
+
+**Cause**: Webpack 4 does not support the `exports` field in `package.json`.
+
+**Solution**: Update to Webpack 5, or manually map the import paths to the actual file paths in your build configuration.
+
+## Runtime Issues
+
+### Blank Screen / Univer Not Rendering
+
+**Symptom**: The container element is empty after initialization.
+
+**Checklist**:
+
+1. **Container element exists**: Ensure the DOM element with the specified `container` id exists before calling `createUniver`.
+   ```html
+   <!-- Ensure #app exists in your HTML -->
+   <div id="app"></div>
+   ```
+
+2. **CSS files are imported**: Univer requires CSS to render correctly.
+   ```typescript
+   import '@univerjs/design/lib/index.css'
+   import '@univerjs/ui/lib/index.css'
+   ```
+
+3. **Plugins registered in correct order**: UI plugins should be registered after core plugins.
+   ```typescript
+   univer.registerPlugin(UniverRenderEnginePlugin)
+   univer.registerPlugin(UniverFormulaEnginePlugin)
+   univer.registerPlugin(UniverUIPlugin, { container: 'app' })
+   ```
+
+### Formula Not Calculating
+
+**Symptom**: Cells show formula text (`=SUM(A1:A10)`) instead of calculated values.
+
+**Solution**:
+
+1. Ensure `@univerjs/engine-formula` and `@univerjs/sheets-formula` plugins are registered.
+2. Check the `initialFormulaComputing` configuration:
+   ```typescript
+   import { CalculationMode } from '@univerjs/engine-formula'
+   // Force calculation during initialization
+   formulaEngine.setInitialFormulaComputing(CalculationMode.FORCED)
+   ```
+3. Verify the formula syntax is supported by Univer.
+
+### Undo/Redo Not Working
+
+**Symptom**: Ctrl+Z / Ctrl+Y has no effect.
+
+**Cause**: The undo/redo plugin may not be registered.
+
+**Solution**: Ensure `@univerjs/sheets-ui` (which includes undo/redo) is registered. For custom commands, verify they are properly declared as `COMMAND` type with correct undo/redo parameters.
+
+## Performance Issues
+
+### Slow Rendering with Large Datasets
+
+**Symptom**: Lag when scrolling or editing with 100k+ cells.
+
+**Recommendations**:
+
+1. **Use lazy loading**: Defer non-essential plugins until after first render.
+   ```typescript
+   univer.createUnit(UniverInstanceType.UNIVER_SHEET, {})
+   // Load heavy plugins after initial render
+   import('@univerjs/watermark').then(({ UniverWatermarkPlugin }) => {
+     univer.registerPlugin(UniverWatermarkPlugin)
+   })
+   ```
+
+2. **Avoid excessive cell styles**: Each unique style increases memory usage. Reuse styles when possible.
+
+3. **Use server-side rendering for data processing**: For heavy computations, consider using Univer in Node.js (headless mode).
+
+### High Memory Usage
+
+**Symptom**: Browser tab crashes or becomes unresponsive.
+
+**Recommendations**:
+
+1. Dispose unused workbook instances:
+   ```typescript
+   const workbook = univerAPI.getActiveWorkbook()
+   workbook.dispose()
+   ```
+
+2. Avoid keeping large snapshots in memory unnecessarily.
+
+## Mobile Issues
+
+### Touch Events Not Responding
+
+**Symptom**: Cannot interact with cells on mobile devices.
+
+**Cause**: Desktop and mobile UI plugins cannot be used together.
+
+**Solution**: Use the mobile variant of UI plugins:
+
+```typescript
+// Replace desktop UI plugin with mobile variant
+import { UniverSheetsMobileUIPlugin } from '@univerjs/sheets-ui'
+
+univer.registerPlugin(UniverSheetsMobileUIPlugin)
+```
+
+> Mobile support is currently experimental. Thorough testing is recommended before production deployment.
+
+## Headless / Node.js Issues
+
+### `document is not defined` Error
+
+**Symptom**: Error when running in Node.js.
+
+**Cause**: UI-related plugins are accessing DOM APIs in a non-browser environment.
+
+**Solution**: Only register core and data plugins in Node.js. Do not register any `-ui` plugins.
+
+```typescript
+// Node.js safe plugin set
+univer.registerPlugin(UniverRenderEnginePlugin)
+univer.registerPlugin(UniverFormulaEnginePlugin)
+univer.registerPlugin(UniverSheetsPlugin)
+// Do NOT register UniverSheetsUIPlugin or UniverUIPlugin
+```
+
+## Getting Help
+
+If your issue is not covered here:
+
+1. Search [GitHub Issues](https://github.com/dream-num/univer/issues) for similar problems
+2. Join our [Discord community](https://discord.gg/XPGnMBmpd6) for real-time support
+3. Create a minimal reproduction and file a new issue
diff --git a/content/guides/troubleshooting.zh-CN.mdx b/content/guides/troubleshooting.zh-CN.mdx
new file mode 100644
index 00000000..103f9ecf
--- /dev/null
+++ b/content/guides/troubleshooting.zh-CN.mdx
@@ -0,0 +1,175 @@
+---
+title: 故障排查
+---
+
+本文档涵盖了在安装、配置或运行 Univer 时可能遇到的常见问题及推荐解决方案。
+
+## 安装问题
+
+### 依赖版本不匹配
+
+**现象**：安装后出现构建错误或运行时异常。
+
+**原因**：Univer 的所有包必须使用完全相同的版本，不支持混用版本。
+
+**解决方案**：
+
+```bash
+# 检查当前安装的版本
+npm list @univerjs/core
+
+# 将所有包更新到相同版本
+npm install @univerjs/core@latest @univerjs/sheets@latest @univerjs/sheets-ui@latest
+```
+
+> 请始终确保所有 `@univerjs/*` 和 `@univerjs-pro/*` 包使用相同的版本号。
+
+### Peer Dependency 警告
+
+**现象**：安装时出现 `react`、`react-dom` 或 `rxjs` 的警告。
+
+**解决方案**：
+
+```bash
+# npm 7+ 会自动处理 peerDependencies
+# 对于旧版本或 yarn，请手动安装
+npm install react react-dom rxjs
+```
+
+### Webpack 4 兼容性
+
+**现象**：使用 Webpack 4 时出现 `Module not found` 错误。
+
+**原因**：Webpack 4 不支持 `package.json` 中的 `exports` 字段。
+
+**解决方案**：升级到 Webpack 5，或在构建配置中手动将导入路径映射到实际文件路径。
+
+## 运行时问题
+
+### 白屏 / Univer 无法渲染
+
+**现象**：初始化后容器元素为空。
+
+**检查清单**：
+
+1. **容器元素存在**：确保调用 `createUniver` 前，指定 `container` id 的 DOM 元素已存在。
+   ```html
+   <!-- 确保 HTML 中存在 #app -->
+   <div id="app"></div>
+   ```
+
+2. **已导入 CSS 文件**：Univer 需要 CSS 才能正确渲染。
+   ```typescript
+   import '@univerjs/design/lib/index.css'
+   import '@univerjs/ui/lib/index.css'
+   ```
+
+3. **插件注册顺序正确**：UI 插件应在核心插件之后注册。
+   ```typescript
+   univer.registerPlugin(UniverRenderEnginePlugin)
+   univer.registerPlugin(UniverFormulaEnginePlugin)
+   univer.registerPlugin(UniverUIPlugin, { container: 'app' })
+   ```
+
+### 公式不计算
+
+**现象**：单元格显示公式文本（`=SUM(A1:A10)`）而非计算结果。
+
+**解决方案**：
+
+1. 确保已注册 `@univerjs/engine-formula` 和 `@univerjs/sheets-formula` 插件。
+2. 检查 `initialFormulaComputing` 配置：
+   ```typescript
+   import { CalculationMode } from '@univerjs/engine-formula'
+   // 初始化时强制计算
+   formulaEngine.setInitialFormulaComputing(CalculationMode.FORCED)
+   ```
+3. 确认公式语法受 Univer 支持。
+
+### 撤销/重做无效
+
+**现象**：Ctrl+Z / Ctrl+Y 没有反应。
+
+**原因**：可能未注册撤销/重做插件。
+
+**解决方案**：确保已注册 `@univerjs/sheets-ui`（包含撤销/重做功能）。对于自定义命令，请确认它们已正确声明为 `COMMAND` 类型，并带有正确的撤销/重做参数。
+
+## 性能问题
+
+### 大数据集渲染缓慢
+
+**现象**：滚动或编辑包含 10万+ 单元格时出现卡顿。
+
+**建议**：
+
+1. **使用懒加载**：首次渲染后再加载非必要插件。
+   ```typescript
+   univer.createUnit(UniverInstanceType.UNIVER_SHEET, {})
+   // 初始渲染后加载重量级插件
+   import('@univerjs/watermark').then(({ UniverWatermarkPlugin }) => {
+     univer.registerPlugin(UniverWatermarkPlugin)
+   })
+   ```
+
+2. **避免过多单元格样式**：每种独特样式都会增加内存占用，请尽量复用样式。
+
+3. **使用服务端渲染处理数据**：对于繁重计算，考虑在 Node.js 中使用 Univer（headless 模式）。
+
+### 内存占用过高
+
+**现象**：浏览器标签页崩溃或无响应。
+
+**建议**：
+
+1. 释放不用的工作簿实例：
+   ```typescript
+   const workbook = univerAPI.getActiveWorkbook()
+   workbook.dispose()
+   ```
+
+2. 避免不必要地在内存中保留大量快照数据。
+
+## 移动端问题
+
+### 触摸事件无响应
+
+**现象**：在移动设备上无法与单元格交互。
+
+**原因**：桌面端和移动端 UI 插件不能同时使用。
+
+**解决方案**：使用移动端变体 UI 插件：
+
+```typescript
+// 将桌面端 UI 插件替换为移动端变体
+import { UniverSheetsMobileUIPlugin } from '@univerjs/sheets-ui'
+
+univer.registerPlugin(UniverSheetsMobileUIPlugin)
+```
+
+> 移动端支持目前处于实验阶段，生产环境部署前建议进行充分测试。
+
+## Headless / Node.js 问题
+
+### `document is not defined` 错误
+
+**现象**：在 Node.js 中运行时出现错误。
+
+**原因**：UI 相关插件在非浏览器环境中访问了 DOM API。
+
+**解决方案**：在 Node.js 中只注册核心和数据插件，不要注册任何 `-ui` 后缀的插件。
+
+```typescript
+// Node.js 安全的插件组合
+univer.registerPlugin(UniverRenderEnginePlugin)
+univer.registerPlugin(UniverFormulaEnginePlugin)
+univer.registerPlugin(UniverSheetsPlugin)
+// 不要注册 UniverSheetsUIPlugin 或 UniverUIPlugin
+```
+
+## 获取帮助
+
+如果本文档未涵盖你的问题：
+
+1. 在 [GitHub Issues](https://github.com/dream-num/univer/issues) 中搜索类似问题
+2. 加入我们的 [Discord 社区](https://discord.gg/XPGnMBmpd6) 获取实时支持
+3. 创建一个最小可复现示例并提交新 issue
diff --git a/content/guides/troubleshooting.zh-TW.mdx b/content/guides/troubleshooting.zh-TW.mdx
new file mode 100644
index 00000000..ab297034
--- /dev/null
+++ b/content/guides/troubleshooting.zh-TW.mdx
@@ -0,0 +1,175 @@
+---
+title: 故障排查
+---
+
+本文檔涵蓋了在安裝、配置或運行 Univer 時可能遇到的常見問題及推薦解決方案。
+
+## 安裝問題
+
+### 依賴版本不匹配
+
+**現象**：安裝後出現構建錯誤或運行時異常。
+
+**原因**：Univer 的所有套件必須使用完全相同的版本，不支援混用版本。
+
+**解決方案**：
+
+```bash
+# 檢查目前安裝的版本
+npm list @univerjs/core
+
+# 將所有套件更新到相同版本
+npm install @univerjs/core@latest @univerjs/sheets@latest @univerjs/sheets-ui@latest
+```
+
+> 請始終確保所有 `@univerjs/*` 和 `@univerjs-pro/*` 套件使用相同的版本號。
+
+### Peer Dependency 警告
+
+**現象**：安裝時出現 `react`、`react-dom` 或 `rxjs` 的警告。
+
+**解決方案**：
+
+```bash
+# npm 7+ 會自動處理 peerDependencies
+# 對於舊版本或 yarn，請手動安裝
+npm install react react-dom rxjs
+```
+
+### Webpack 4 相容性
+
+**現象**：使用 Webpack 4 時出現 `Module not found` 錯誤。
+
+**原因**：Webpack 4 不支援 `package.json` 中的 `exports` 欄位。
+
+**解決方案**：升級到 Webpack 5，或在構建配置中手動將匯入路徑對應到實際檔案路徑。
+
+## 運行時問題
+
+### 白屏 / Univer 無法渲染
+
+**現象**：初始化後容器元素為空。
+
+**檢查清單**：
+
+1. **容器元素存在**：確保呼叫 `createUniver` 前，指定 `container` id 的 DOM 元素已存在。
+   ```html
+   <!-- 確保 HTML 中存在 #app -->
+   <div id="app"></div>
+   ```
+
+2. **已匯入 CSS 檔案**：Univer 需要 CSS 才能正確渲染。
+   ```typescript
+   import '@univerjs/design/lib/index.css'
+   import '@univerjs/ui/lib/index.css'
+   ```
+
+3. **套件註冊順序正確**：UI 套件應在核心套件之後註冊。
+   ```typescript
+   univer.registerPlugin(UniverRenderEnginePlugin)
+   univer.registerPlugin(UniverFormulaEnginePlugin)
+   univer.registerPlugin(UniverUIPlugin, { container: 'app' })
+   ```
+
+### 公式不計算
+
+**現象**：儲存格顯示公式文字（`=SUM(A1:A10)`）而非計算結果。
+
+**解決方案**：
+
+1. 確保已註冊 `@univerjs/engine-formula` 和 `@univerjs/sheets-formula` 套件。
+2. 檢查 `initialFormulaComputing` 配置：
+   ```typescript
+   import { CalculationMode } from '@univerjs/engine-formula'
+   // 初始化時強制計算
+   formulaEngine.setInitialFormulaComputing(CalculationMode.FORCED)
+   ```
+3. 確認公式語法受 Univer 支援。
+
+### 復原/重做無效
+
+**現象**：Ctrl+Z / Ctrl+Y 沒有反應。
+
+**原因**：可能未註冊復原/重做套件。
+
+**解決方案**：確保已註冊 `@univerjs/sheets-ui`（包含復原/重做功能）。對於自訂命令，請確認它們已正確宣告為 `COMMAND` 類型，並帶有正確的復原/重做參數。
+
+## 效能問題
+
+### 大資料集渲染緩慢
+
+**現象**：捲動或編輯包含 10萬+ 儲存格時出現卡頓。
+
+**建議**：
+
+1. **使用延遲載入**：首次渲染後再載入非必要套件。
+   ```typescript
+   univer.createUnit(UniverInstanceType.UNIVER_SHEET, {})
+   // 初始渲染後載入重量級套件
+   import('@univerjs/watermark').then(({ UniverWatermarkPlugin }) => {
+     univer.registerPlugin(UniverWatermarkPlugin)
+   })
+   ```
+
+2. **避免過多儲存格樣式**：每種獨特樣式都會增加記憶體佔用，請盡量複用樣式。
+
+3. **使用伺服器端渲染處理資料**：對於繁重計算，考慮在 Node.js 中使用 Univer（headless 模式）。
+
+### 記憶體佔用過高
+
+**現象**：瀏覽器分頁崩潰或無回應。
+
+**建議**：
+
+1. 釋放不用的活頁簿實例：
+   ```typescript
+   const workbook = univerAPI.getActiveWorkbook()
+   workbook.dispose()
+   ```
+
+2. 避免不必要地在記憶體中保留大量快照資料。
+
+## 行動端問題
+
+### 觸控事件無回應
+
+**現象**：在行動裝置上無法與儲存格互動。
+
+**原因**：桌面端和行動端 UI 套件不能同時使用。
+
+**解決方案**：使用行動端變體 UI 套件：
+
+```typescript
+// 將桌面端 UI 套件替換為行動端變體
+import { UniverSheetsMobileUIPlugin } from '@univerjs/sheets-ui'
+
+univer.registerPlugin(UniverSheetsMobileUIPlugin)
+```
+
+> 行動端支援目前處於實驗階段，生產環境部署前建議進行充分測試。
+
+## Headless / Node.js 問題
+
+### `document is not defined` 錯誤
+
+**現象**：在 Node.js 中運行時出現錯誤。
+
+**原因**：UI 相關套件在非瀏覽器環境中存取了 DOM API。
+
+**解決方案**：在 Node.js 中只註冊核心和資料套件，不要註冊任何 `-ui` 後綴的套件。
+
+```typescript
+// Node.js 安全的套件組合
+univer.registerPlugin(UniverRenderEnginePlugin)
+univer.registerPlugin(UniverFormulaEnginePlugin)
+univer.registerPlugin(UniverSheetsPlugin)
+// 不要註冊 UniverSheetsUIPlugin 或 UniverUIPlugin
+```
+
+## 取得協助
+
+如果本文檔未涵蓋你的問題：
+
+1. 在 [GitHub Issues](https://github.com/dream-num/univer/issues) 中搜尋類似問題
+2. 加入我們的 [Discord 社群](https://discord.gg/XPGnMBmpd6) 取得即時支援
+3. 建立一個最小可復現示例並提交新 issue
diff --git a/lib/i18n.ts b/lib/i18n.ts
index e5b23964..2b50fe0e 100644
--- a/lib/i18n.ts
+++ b/lib/i18n.ts
@@ -179,6 +179,7 @@ const customZhCN = {
   'home.features.performance.title': '无与伦比的性能',
   'home.features.customizability.title': '一切皆可定制',
   'documentation.title': '文档',
+  'guides.title': '指南',
   'reference.title': 'API 参考',
   'ecosystem.title': '生态',
   'icons.title': '图标',
@@ -318,6 +319,7 @@ const customZhTw = {
   'home.features.performance.title': '無與倫比的性能',
   'home.features.customizability.title': '一切皆可定制',
   'documentation.title': '文檔',
+  'guides.title': '指南',
   'reference.title': 'API 參考',
   'ecosystem.title': '生態',
   'icons.title': '圖標',
@@ -457,6 +459,7 @@ const customEnUS: typeof customZhCN = {
   'home.features.performance.title': 'Unrivaled Performance',
   'home.features.customizability.title': 'Customize Everything',
   'documentation.title': 'Documentation',
+  'guides.title': 'Guides',
   'reference.title': 'API Reference',
   'ecosystem.title': 'Ecosystem',
   'icons.title': 'Icons',
@@ -596,6 +599,7 @@ const customJaJP: typeof customZhCN = {
   'home.features.performance.title': '比類のないパフォーマンス',
   'home.features.customizability.title': 'すべてをカスタマイズ',
   'documentation.title': 'ドキュメント',
+  'guides.title': 'ガイド',
   'reference.title': 'API リファレンス',
   'ecosystem.title': 'エコシステム',
   'icons.title': 'アイコン',