Update README files to reflect project name change to "CodeExpander Plugins" and improve command descriptions. Add Chinese localization for README.

Author: xudaolong

README.md

@@ -1,100 +1,94 @@
-# Online Dev Tools (pnpm monorepo)
+# CodeExpander Plugins
+
+[English](./README.md) | [简体中文](./README.zh-CN.md)
 
 Monorepo of **CodeExpander plugins**, managed with pnpm workspaces.
 
 ## Structure
 
 - **packages/ui** — Shared Tailwind + shadcn-style UI components used by plugins.
 - **packages/i18n** — Minimal i18n helpers (`getLocale`, `t`) for plugin locales.
-- **packages/plugin-text** … **packages/plugin-ai** — CodeExpander plugin packages (one per category). Each builds to a `dist/` folder with `plugin.json` + `index.html` + assets.
+- **packages/plugin-text** … **packages/plugin-ai** — CodeExpander plugin packages (one per category). Each builds to a `dist/` folder with `plugin.json`, `index.html`, and assets.
 
 ## Commands
 
-- `pnpm install` — Install all workspace dependencies.
-- `pnpm run dev` — Start the plugin-text dev server. **`make dev`** — CLI 选择要开发的插件后启动对应 dev server；或 `make dev PLUGIN=plugin-html` 直接指定。
-- `pnpm run build` — Build all plugin packages.
-- Build a single plugin: `pnpm --filter @codeexpander/plugin-text run build`.
-- Build all plugins only: `pnpm run build:plugins`（或 `pnpm --filter './packages/plugin-*' run build`）。
-- **一键发布所有插件到 npm**：`pnpm run publish:plugins`（先构建再按序发布 11 个包，包名为 `@codeexpander/plugin-xxx`）。
-
----
+| Command | Description |
+|--------|-------------|
+| `pnpm install` | Install all workspace dependencies. |
+| `pnpm run dev` | Start the default plugin dev server. Use **`make dev`** to pick a plugin interactively, or `make dev PLUGIN=plugin-html` to specify one. |
+| `pnpm run build` | Build all packages. |
+| `pnpm --filter @codeexpander/plugin-text run build` | Build a single plugin. |
+| `pnpm run build:plugins` | Build all plugin packages only (`pnpm --filter './packages/plugin-*' run build`). |
+| `pnpm run publish:plugins` | Build and publish all plugins to npm in sequence (package names: `@codeexpander/plugin-*`). |
 
-## 一键发布插件 / One-click plugin publish
+## One-Click Plugin Publish
 
-插件包名已统一为 **`@codeexpander/plugin-*`**（如 `@codeexpander/plugin-text`），发布到 npm 后可通过 CodeExpander 的 npm 安装方式使用。
+Plugin packages use the **`@codeexpander/plugin-*`** scope (e.g. `@codeexpander/plugin-text`). After publishing to npm, they can be installed via CodeExpander’s npm install flow.
 
-**发布前准备**
+**Before publishing**
 
-1. 登录 npm：`npm login`（需有 `@codeexpander` 组织权限或使用个人 scope）。
-2. 可选：统一改版本号（如 `0.1.0` → `0.2.0`）：
+1. Log in to npm: `npm login` (requires `@codeexpander` org access or your own scope).
+2. Optional — bump versions (e.g. `0.1.0` → `0.2.0`):
    ```bash
    pnpm --filter './packages/plugin-*' exec -- npm version patch --no-git-tag-version
    ```
 
-**执行发布**
+**Publish**
 
 ```bash
 pnpm run publish:plugins
 ```
 
-该命令会依次：构建所有插件（`build:plugins`）→ 对每个插件执行 `pnpm publish -r`（`--no-git-checks` 跳过 git 检查）。发布内容为各包的 `dist/` 目录（含 `plugin.json`、`index.html`、assets）。
+This will: build all plugins (`build:plugins`), then run `pnpm publish` for each plugin (with `--no-git-checks`). Published content is each package’s `dist/` (including `plugin.json`, `index.html`, and assets).
 
-若只发布单个插件，可先构建再进入该包目录执行 `pnpm publish`：
+To publish a single plugin:
 
 ```bash
 pnpm --filter @codeexpander/plugin-text run build
 cd packages/plugin-text && pnpm publish --no-git-checks
 ```
 
----
-
-## 如何验证开发插件 / How to verify plugin development
+## Verifying Plugin Development
 
-### 方式一：本地开发（不依赖 CodeExpander）
+### Option 1: Local dev (no CodeExpander)
 
-在浏览器里直接跑插件的 UI，改代码会热更新，适合改界面、加功能。复制/Toast 在无 host 时会走 fallback（如 `navigator.clipboard`）。
+Run the plugin UI in the browser with hot reload. Copy/Toast use fallbacks (e.g. `navigator.clipboard`) when not running inside CodeExpander.
 
 ```bash
-# 进入某个插件目录并启动 Vite 开发服务器
 cd packages/plugin-text && pnpm run dev
-# 或从仓库根目录指定插件
+# or from repo root:
 pnpm --filter @codeexpander/plugin-text run dev
 ```
 
-浏览器打开终端里提示的地址（如 `http://localhost:5173`），即可看到该插件的**多 Tab 工具界面**（无「Back to Tools」等外壳，仅插件内容）。
+Open the URL shown in the terminal (e.g. `http://localhost:5173`) to see the plugin’s multi-tab tools UI (no “Back to Tools” shell, just the plugin).
 
-### 方式二：构建后在 CodeExpander 里验证（推荐）
+### Option 2: Build and test in CodeExpander (recommended)
 
-在真实宿主里确认插件是否按规范工作（含 `writeClipboard`、`showToast`、多语言等）。
+Verify behavior in the real host (e.g. `writeClipboard`, `showToast`, i18n).
 
-1. **构建插件**
+1. **Build**
    ```bash
-   # 构建单个插件
    pnpm --filter @codeexpander/plugin-text run build
-
-   # 或构建所有插件
+   # or all plugins:
    pnpm run build:plugins
    ```
 
-2. **导入 CodeExpander**
-   - 打开 CodeExpander → **设置** 或 **插件中心**
-   - 选择 **从目录导入**（Import from directory）
-   - 选中该插件的 **dist** 目录，例如：
+2. **Import in CodeExpander**
+   - Open CodeExpander → **Settings** or **Plugin Hub**
+   - Choose **Import from directory**
+   - Select the plugin’s **dist** folder, e.g.:
      - `packages/plugin-text/dist`
      - `packages/plugin-html/dist`
-     - 等等
-
-3. **验证**
-   - 在 CodeExpander 里搜索或打开对应插件（如 "Text Tools"）
-   - 应只看到插件内容：Tab 切换各工具（如 Word Counter、Text Diff…），无「Back to Tools」
-   - 测试复制、Toast、中英文切换（若传了 `initialPayload.locale`）
 
----
+3. **Verify**
+   - Search or open the plugin (e.g. “Text Tools”) in CodeExpander.
+   - You should see only the plugin content: tabs for each tool (Word Counter, Text Diff, etc.), no “Back to Tools”.
+   - Test copy, Toast, and locale (if `initialPayload.locale` is passed).
 
-## Using plugins in CodeExpander
+## Using Plugins in CodeExpander
 
 1. Build the plugin: `pnpm --filter @codeexpander/plugin-text run build`.
 2. In CodeExpander: **Settings** or **Plugin Hub** → **Import from directory**.
-3. Select the plugin’s `dist` folder (e.g. `packages/plugin-text/dist`). The folder must contain `plugin.json` and the entry file (`index.html`).
+3. Select the plugin’s `dist` folder (e.g. `packages/plugin-text/dist`). It must contain `plugin.json` and the entry file (`index.html`).
 
-Each plugin supports multiple languages (en, zh) via `initialPayload.locale` or browser locale.
+Plugins support multiple languages (en, zh) via `initialPayload.locale` or browser locale.

README.zh-CN.md

@@ -0,0 +1,94 @@
+# CodeExpander Plugins
+
+[English](./README.md) | [简体中文](./README.zh-CN.md)
+
+本仓库是 **CodeExpander 插件** 的 pnpm 单体仓库。
+
+## 结构
+
+- **packages/ui** — 插件共用的 Tailwind + shadcn 风格 UI 组件。
+- **packages/i18n** — 插件多语言用的轻量 i18n 工具（`getLocale`、`t`）。
+- **packages/plugin-text** … **packages/plugin-ai** — 各品类 CodeExpander 插件包，构建输出到 `dist/`（含 `plugin.json`、`index.html` 及静态资源）。
+
+## 常用命令
+
+| 命令 | 说明 |
+|--------|-------------|
+| `pnpm install` | 安装工作区依赖。 |
+| `pnpm run dev` | 启动默认插件开发服务。**`make dev`** 可交互选择要开发的插件；`make dev PLUGIN=plugin-html` 直接指定插件。 |
+| `pnpm run build` | 构建所有包。 |
+| `pnpm --filter @codeexpander/plugin-text run build` | 仅构建单个插件。 |
+| `pnpm run build:plugins` | 仅构建所有插件（等价于 `pnpm --filter './packages/plugin-*' run build`）。 |
+| `pnpm run publish:plugins` | 先构建再按序发布所有插件到 npm（包名为 `@codeexpander/plugin-*`）。 |
+
+## 一键发布插件
+
+插件包名统一为 **`@codeexpander/plugin-*`**（如 `@codeexpander/plugin-text`），发布到 npm 后可在 CodeExpander 中通过 npm 安装使用。
+
+**发布前准备**
+
+1. 登录 npm：`npm login`（需具备 `@codeexpander` 组织权限或使用个人 scope）。
+2. 可选：统一提升版本号（如 `0.1.0` → `0.2.0`）：
+   ```bash
+   pnpm --filter './packages/plugin-*' exec -- npm version patch --no-git-tag-version
+   ```
+
+**执行发布**
+
+```bash
+pnpm run publish:plugins
+```
+
+该命令会依次：构建所有插件（`build:plugins`）→ 对每个插件执行 `pnpm publish`（`--no-git-checks` 跳过 git 检查）。发布内容为各包的 `dist/` 目录（含 `plugin.json`、`index.html` 及资源）。
+
+若只发布单个插件，可先构建再进入该包目录执行 `pnpm publish`：
+
+```bash
+pnpm --filter @codeexpander/plugin-text run build
+cd packages/plugin-text && pnpm publish --no-git-checks
+```
+
+## 如何验证插件开发
+
+### 方式一：本地开发（不依赖 CodeExpander）
+
+在浏览器中直接运行插件 UI，支持热更新；无宿主时复制/Toast 会走 fallback（如 `navigator.clipboard`）。
+
+```bash
+cd packages/plugin-text && pnpm run dev
+# 或从仓库根目录指定插件
+pnpm --filter @codeexpander/plugin-text run dev
+```
+
+在终端提示的地址（如 `http://localhost:5173`）打开，即可看到该插件的多 Tab 工具界面（无「返回工具」等外壳，仅插件内容）。
+
+### 方式二：构建后在 CodeExpander 中验证（推荐）
+
+在真实宿主中确认插件行为（含 `writeClipboard`、`showToast`、多语言等）。
+
+1. **构建插件**
+   ```bash
+   pnpm --filter @codeexpander/plugin-text run build
+   # 或构建所有插件
+   pnpm run build:plugins
+   ```
+
+2. **在 CodeExpander 中导入**
+   - 打开 CodeExpander → **设置** 或 **插件中心**
+   - 选择 **从目录导入**
+   - 选中该插件的 **dist** 目录，例如：
+     - `packages/plugin-text/dist`
+     - `packages/plugin-html/dist`
+
+3. **验证**
+   - 在 CodeExpander 中搜索或打开对应插件（如「文本工具」）
+   - 应只看到插件内容：Tab 切换各工具（如字数统计、文本对比等），无「返回工具」
+   - 测试复制、Toast、中英文切换（若传入 `initialPayload.locale`）
+
+## 在 CodeExpander 中使用插件
+
+1. 构建插件：`pnpm --filter @codeexpander/plugin-text run build`。
+2. 在 CodeExpander：**设置** 或 **插件中心** → **从目录导入**。
+3. 选择插件的 `dist` 目录（如 `packages/plugin-text/dist`），其中需包含 `plugin.json` 和入口文件 `index.html`。
+
+插件通过 `initialPayload.locale` 或浏览器语言支持多语言（en、zh）。