feat(website): add japanese and simplified chinese docs with i18n, translation issue flow

1 files changed, 85 insertions, 0 deletions

diff --git a/website/src/content/docs/zh-cn/concepts.mdx b/website/src/content/docs/zh-cn/concepts.mdx
new file mode 100644
index 00000000..ab950416
--- /dev/null
+++ b/website/src/content/docs/zh-cn/concepts.mdx
@@ -0,0 +1,85 @@
+---
+title: 核心概念
+description: 理解 Herdr 的工作区、标签页、窗格、智能体、会话和模式。
+---
+
+Herdr 是一个终端工作区管理器。它让真实的终端进程持续运行,并在其之上添加结构。
+
+## 工作区
+
+工作区是最顶层的项目容器。为每个仓库、任务或调查使用一个工作区。
+
+工作区拥有标签页和窗格。它在侧边栏中的状态由内部的智能体汇总而来,让你一眼看出哪个项目需要关注。
+
+## 标签页
+
+标签页是工作区内的一种布局。用标签页来分隔不同视图,比如 `agents`、`logs`、`server` 或 `review`。
+
+标签页可以通过 CLI 和 socket API 寻址。
+
+## 窗格
+
+窗格是一个真实的终端。Herdr 渲染终端输出,把输入传回进程,并在客户端分离后保留窗格。
+
+窗格可以向右或向下分割。它们可以手动重命名、通过 CLI 读取、接收输入,以及被关闭。
+
+## 鼠标 UI
+
+Herdr 是鼠标原生的。你可以点击窗格、标签页、工作区和智能体,可以拖动分割边框、选择文本、使用右键菜单。下文的所有操作都可以用鼠标完成;按键绑定是可选的一层。
+
+如果你偏好纯键盘操作,或者不想让 Herdr 捕获鼠标输入,可以禁用鼠标捕获:
+
+```toml
+[ui]
+mouse_capture = false
+```
+
+## 智能体
+
+智能体是 Herdr 在窗格内识别出的进程。Herdr 通过前台进程、屏幕清单和可选的集成来检测智能体。
+
+智能体状态如下:
+
+| 状态 | 含义 |
+| --- | --- |
+| `blocked` | 智能体需要输入、审批或决策。 |
+| `working` | 智能体正在运行。 |
+| `done` | 智能体已完成,你还没有查看。 |
+| `idle` | 智能体已完成或在等待,并且已被查看过。 |
+| `unknown` | Herdr 无法有把握地判断状态。 |
+
+## 会话
+
+会话是一个持久的 Herdr 服务器命名空间。默认的 `herdr` 命令连接到默认会话。
+
+命名会话是彼此独立的运行时命名空间:
+
+```bash
+herdr session list
+herdr session attach work
+herdr session attach side-project
+```
+
+优先使用工作区。当你需要完全独立的窗格、socket 和持久化运行时状态时,才使用命名会话。
+
+## 客户端与服务器
+
+默认情况下,Herdr 以一个后台服务器加一个或多个已连接客户端的方式运行。
+
+服务器拥有窗格和进程状态。客户端是连接到该服务器的终端 UI。
+
+用 `ctrl+b q` 分离客户端。服务器和智能体会继续运行。
+
+如果想结束会话并停止其中的窗格,停止服务器:
+
+```bash
+herdr server stop
+```
+
+## 模式
+
+Herdr 有终端模式、前缀模式和导航模式。
+
+终端模式把按键发送给聚焦的窗格。前缀模式在按下前缀键后等待一个 Herdr 动作。导航模式是常驻的工作区导航界面。
+
+按下前缀键 (默认 `ctrl+b`),再按一个动作键,比如 `c` 新建标签页,`w` 打开工作区导航。第一次接触前缀键的概念?参见[键盘](/zh-cn/docs/keyboard/)。