docs: update for AstrBotDevs/AstrBot#4787

Author: astrbot-docs-agent[bot]

.vitepress/config.mjs

@@ -196,6 +196,7 @@ export default defineConfig({
                   { text: "插件指南（旧）", link: "/plugin" },
                 ],
               },
+              { text: "CLI 测试器", link: "/cli-tester" },
               {
                 text: "接入平台适配器",
                 link: "/plugin-platform-adapter",
@@ -413,6 +414,7 @@ export default defineConfig({
                   { text: "Publish Plugin", link: "/plugin-publish" },
                 ],
               },
+              { text: "CLI Tester", link: "/cli-tester" },
               {
                 text: "Platform Adapter Integration",
                 link: "/plugin-platform-adapter",

en/dev/cli-tester.md

@@ -0,0 +1,76 @@
+# CLI Tester
+
+The CLI Tester is a tool designed specifically for plugin developers to build a fast feedback loop, supporting the "Vibe Coding" development mode.
+
+Traditional plugin development requires: writing code → restarting the bot → logging into an IM platform → sending test messages → checking results → modifying code... This process has a long feedback cycle and can be distracting.
+
+CLI Tester allows you to: **write code → test via command line → see results immediately → modify code...**
+
+## Core Values
+
+- ⚡ **Instant Feedback**: Test directly from the command line without logging into IM platforms.
+- 🔄 **Fast Iteration**: Shorten the feedback loop and improve development efficiency.
+- 🎯 **Focused Development**: Focus on plugin logic rather than platform interaction.
+- 🧪 **Independent Testing**: Isolated sessions for each request, supporting concurrent testing.
+
+## Enabling CLI Tester
+
+Enable the CLI platform in the management panel, or add the configuration in `data/config/platforms.json`:
+
+```json
+{
+  "type": "cli",
+  "enable": true,
+  "mode": "socket",
+  "socket_path": "/tmp/astrbot.sock"
+}
+```
+
+> **Note**: CLI Tester is disabled by default. It is recommended to enable it only in development environments.
+
+## Usage
+
+### 1. Basic Testing
+
+You can use the built-in `astrbot-cli` tool to send messages.
+
+```bash
+# Test inside the container
+docker exec astrbot python3 /AstrBot/astrbot-cli "Hello"
+
+# Test plugin commands
+docker exec astrbot python3 /AstrBot/astrbot-cli "/help"
+
+# JSON format output (includes rich media like images)
+docker exec astrbot python3 /AstrBot/astrbot-cli -j "/time"
+```
+
+### 2. Create a Global Command (Optional)
+
+For convenience, you can create a wrapper script on the host machine:
+
+```bash
+# Create wrapper script on host
+cat > /usr/local/bin/astrbot-cli << 'EOF'
+#!/bin/bash
+docker exec astrbot python3 /AstrBot/astrbot-cli "$@"
+EOF
+
+chmod +x /usr/local/bin/astrbot-cli
+
+# Use directly
+astrbot-cli "Test message"
+```
+
+## Core Features
+
+1. **Unix Socket Mode**: Provides synchronous request-response via `/tmp/astrbot.sock`.
+2. **Session Isolation**: Supports concurrent testing; each request can have an independent session (requires `use_isolated_sessions` enabled in config).
+3. **Rich Media Support**: Automatically handles rich media content like images (Base64 encoded).
+4. **Whitelist Exemption**: The CLI platform automatically bypasses whitelist checks for easier local debugging.
+
+## Technical Characteristics
+
+- 📦 **Zero External Dependencies**: Uses only the Python standard library.
+- 💾 **Lightweight**: Total size is about 35KB.
+- 🏗️ **Unix Philosophy**: Atomic modules, explicit I/O, and pipeline orchestration.

zh/dev/cli-tester.md

@@ -0,0 +1,76 @@
+# CLI 测试器 (CLI Tester)
+
+CLI 测试器是一个专为插件开发者设计的工具，旨在构建快速反馈循环，支持 Vibe Coding 开发模式。
+
+传统插件开发流程需要：编写代码 → 重启机器人 → 登录 IM 平台 → 发送测试消息 → 查看结果 → 修改代码... 这个流程反馈周期长，且容易分散注意力。
+
+CLI 测试器允许你：**编写代码 → 命令行测试 → 立即查看结果 → 修改代码...**
+
+## 核心价值
+
+- ⚡ **即时反馈**：无需登录 IM 平台，命令行直接测试。
+- 🔄 **快速迭代**：缩短反馈循环，提升开发效率。
+- 🎯 **专注开发**：专注于插件逻辑，而非平台交互。
+- 🧪 **独立测试**：每个请求独立会话，支持并发测试。
+
+## 启用 CLI 测试器
+
+在管理面板中启用 CLI 平台，或在 `data/config/platforms.json` 中添加配置：
+
+```json
+{
+  "type": "cli",
+  "enable": true,
+  "mode": "socket",
+  "socket_path": "/tmp/astrbot.sock"
+}
+```
+
+> **注意**：CLI 测试器默认是关闭的，建议仅在开发环境启用。
+
+## 使用方法
+
+### 1. 基础测试
+
+你可以使用内置的 `astrbot-cli` 工具发送消息。
+
+```bash
+# 在容器内测试
+docker exec astrbot python3 /AstrBot/astrbot-cli "你好"
+
+# 测试插件命令
+docker exec astrbot python3 /AstrBot/astrbot-cli "/help"
+
+# JSON 格式输出（包含图片等富媒体）
+docker exec astrbot python3 /AstrBot/astrbot-cli -j "/time"
+```
+
+### 2. 创建全局命令（可选）
+
+为了方便使用，你可以在宿主机创建一个包装脚本：
+
+```bash
+# 在宿主机创建包装脚本
+cat > /usr/local/bin/astrbot-cli << 'EOF'
+#!/bin/bash
+docker exec astrbot python3 /AstrBot/astrbot-cli "$@"
+EOF
+
+chmod +x /usr/local/bin/astrbot-cli
+
+# 直接使用
+astrbot-cli "测试消息"
+```
+
+## 核心功能
+
+1. **Unix Socket 模式**：通过 `/tmp/astrbot.sock` 提供同步请求-响应。
+2. **会话隔离**：支持并发测试，每个请求可以拥有独立会话（需在配置中开启 `use_isolated_sessions`）。
+3. **富媒体支持**：自动处理图片等富媒体内容（Base64 编码）。
+4. **白名单豁免**：CLI 平台自动豁免白名单检查，方便本地调试。
+
+## 技术特点
+
+- 📦 **零外部依赖**：仅使用 Python 标准库。
+- 💾 **轻量级**：总计约 35KB。
+- 🏗️ **遵循 Unix 哲学**：原子化模块、显式 I/O、管道编排。