npm - @izhimu/qq - Versions diffs - 0.2.0 → 0.2.1 - Mend

@izhimu/qq 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/LICENSE +21 -21
package/README.md +388 -388
package/dist/src/utils/markdown.d.ts +2 -5
package/dist/src/utils/markdown.js +74 -69
package/package.json +1 -1

package/LICENSE CHANGED Viewed

@@ -1,21 +1,21 @@
-MIT License
-Copyright (c) 2026 izhimu
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+Copyright (c) 2026 izhimu
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md CHANGED Viewed

@@ -1,388 +1,388 @@
-# @izhimu/qq
-<p align="center">
-  <a href="https://opensource.org/licenses/MIT">
-    <img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT">
-  </a>
-  <a href="https://docs.openclaw.ai/">
-    <img src="https://img.shields.io/badge/OpenClaw-Plugin-blueviolet.svg" alt="OpenClaw">
-  </a>
-  <a href="https://github.com/botuniverse/onebot-11">
-    <img src="https://img.shields.io/badge/Protocol-OneBot_11-yellow.svg" alt="Protocol">
-  </a>
-  <a href="https://www.typescriptlang.org/">
-    <img src="https://img.shields.io/badge/Language-TypeScript-blue.svg" alt="TypeScript">
-  </a>
-</p>
-<p align="center">
-  <strong>QQ Channel Plugin for OpenClaw</strong>
-</p>
-<p align="center">
-  通过 NapCat WebSocket API 连接 QQ 机器人，支持私聊、群聊、图片、回复等多种消息类型
-</p>
----
-## 目录
-- [功能特性](#功能特性)
-- [安装](#安装)
-- [快速开始](#快速开始)
-- [配置](#配置)
-- [使用方法](#使用方法)
-- [架构设计](#架构设计)
-- [API 文档](#api-文档)
-- [开发指南](#开发指南)
-- [故障排查](#故障排查)
----
-## 功能特性
-- **多渠道支持** - 同时支持 QQ 私聊和群聊
-- **消息类型** - 文本、@提及、图片、表情、语音、文件、回复
-- **实时通信** - WebSocket 全双工连接，支持自动重连
-- **心跳监测** - 内置健康检查和连接状态监控
-- **交互式配置** - 提供向导式配置界面
-- **TypeScript** - 完整的类型定义和类型安全
----
-## 安装
-### 前提条件
-1. 安装 [OpenClaw](https://docs.openclaw.ai/) >= 2026.2.1
-2. 安装并配置 [NapCat](https://github.com/NapNeko/NapCatQQ) WebSocket 服务
-### 通过 OpenClaw CLI 安装
-```bash
-# 安装插件
-openclaw plugins install @izhimu/qq
-```
-### 本地开发安装
-```bash
-# 克隆仓库
-git clone <repository-url>
-cd openclaw-channel-qq
-# 安装依赖
-npm install
-# 构建项目
-npm run build
-# 安装到 OpenClaw
-openclaw plugins install /path/to/openclaw-channel-qq
-```
----
-## 快速开始
-### 1. 配置 NapCat
-在 NapCat 的 `config.yml` 中启用 WebSocket：
-```yaml
-ws:
-  servers:
-    - url: ws://0.0.0.0:3001
-      token: ""  # 如需认证请设置
-      enableHeart: true
-```
-### 2. 配置 OpenClaw
-运行交互式配置向导：
-```bash
-openclaw onboard
-```
-或手动编辑配置：
-```json
-{
-  "channels": {
-    "qq": {
-      "wsUrl": "ws://127.0.0.1:3001",
-      "accessToken": "",
-      "enabled": true
-    }
-  }
-}
-```
-### 3. 启动 Gateway
-```bash
-openclaw gateway restart
-```
----
-## 配置
-### 配置选项
-| 属性 | 类型 | 必填 | 默认值 | 描述 |
-|------|------|------|--------|------|
-| `wsUrl` | `string` | 是 | - | NapCat WebSocket 地址 |
-| `accessToken` | `string` | 否 | `""` | 访问令牌（如配置了认证） |
-| `enabled` | `boolean` | 否 | `true` | 是否启用该账号 |
-### 配置示例
-```json
-{
-  "channels": {
-    "qq": {
-      "wsUrl": "ws://127.0.0.1:3001",
-      "accessToken": "your-token",
-      "enabled": true
-    }
-  }
-}
-```
----
-## 使用方法
-### 发送消息
-```bash
-# 发送私聊消息
-openclaw message send "你好！" --to qq:private:123456789
-# 发送群消息
-openclaw message send "大家好！" --to qq:group:123456
-# 带回复的消息
-openclaw message send "回复你的消息" --to qq:private:123456789 --reply-to <message-id>
-```
-### 检查状态
-```bash
-# 查看频道状态
-openclaw channels
-# 查看日志
-openclaw logs --channel qq
-```
-### 消息目标格式
-| 类型 | 格式 | 示例 |
-|------|------|------|
-| 私聊 | `private:<QQ号>` | `qq:private:123456789` |
-| 群聊 | `group:<群号>` | `qq:group:123456` |
----
-## 架构设计
-### 项目结构
-```
-openclaw-channel-qq/
-├── src/
-│   ├── channel.ts              # 插件主入口
-│   ├── core/
-│   │   ├── connection.ts       # WebSocket 连接管理
-│   │   ├── dispatch.ts         # 事件分发器
-│   │   ├── request.ts          # API 请求处理
-│   │   ├── runtime.ts          # 运行时状态管理
-│   │   └── config.ts           # 配置解析
-│   ├── adapters/
-│   │   └── message.ts          # 消息格式转换
-│   ├── types/
-│   │   └── index.ts            # TypeScript 类型定义
-│   ├── utils/
-│   │   ├── index.ts            # 工具函数
-│   │   ├── log.ts              # 日志工具
-│   │   ├── markdown.ts         # Markdown 处理
-│   │   └── cqcode.ts           # CQ 码解析
-│   └── onboarding.ts           # 交互式配置向导
-├── docs/
-│   ├── napcat-websocket-api.md # NapCat API 文档
-│   └── plugin-development-guide.md # 插件开发指南
-├── openclaw.plugin.json        # 插件清单
-├── package.json
-└── tsconfig.json
-```
-### 核心组件
-#### 1. ConnectionManager
-负责 WebSocket 连接的生命周期管理：
-- 连接建立和断开
-- 自动重连机制（指数退避）
-- 心跳监测
-- 请求/响应关联
-#### 2. MessageAdapter
-处理 NapCat 与 OpenClaw 消息格式的双向转换：
-- 入站消息解析（NapCat → OpenClaw）
-- 出站消息构建（OpenClaw → NapCat）
-- 支持多种消息段类型
-#### 3. EventDispatcher
-处理 NapCat 上报的各类事件：
-- 消息事件（私聊、群聊）
-- 通知事件（戳一戳、撤回等）
-- 元事件（心跳、生命周期）
----
-## API 文档
-### 支持的消息类型
-| 类型 | 入站 | 出站 | 说明 |
-|------|------|------|------|
-| `text` | ✓ | ✓ | 文本消息 |
-| `at` | ✓ | ✓ | @提及 |
-| `image` | ✓ | ✓ | 图片 |
-| `face` | ✓ | - | QQ 表情 |
-| `reply` | ✓ | ✓ | 消息回复 |
-| `record` | ✓ | - | 语音消息 |
-| `file` | ✓ | - | 文件 |
-| `json` | ✓ | - | JSON 富文本 |
-### OneBot 11 接口
-```typescript
-// 发送消息
-{
-  action: 'send_msg',
-  params: {
-    message_type: 'private' | 'group',
-    user_id?: string,      // 私聊时必填
-    group_id?: string,     // 群聊时必填
-    message: NapCatMessage[] | string
-  }
-}
-// 获取消息
-{
-  action: 'get_msg',
-  params: {
-    message_id: number
-  }
-}
-// 获取运行状态
-{
-  action: 'get_status',
-  params: {}
-}
-```
-完整 API 文档请参考 [NapCat WebSocket API 文档](./docs/napcat-websocket-api.md)。
----
-## 开发指南
-### 开发环境设置
-```bash
-# 安装依赖
-npm install
-# 开发模式（热重载）
-npm run dev
-# 构建
-npm run build
-```
-### 目录结构说明
-| 目录 | 说明 |
-|------|------|
-| `src/core/` | 核心功能模块 |
-| `src/adapters/` | 适配器（消息转换等） |
-| `src/types/` | TypeScript 类型定义 |
-| `src/utils/` | 工具函数 |
-| `docs/` | 文档 |
-| `openspec/` | OpenSpec 规范 |
-### 插件开发参考
-详细开发指南请参考 [插件开发指南](./docs/plugin-development-guide.md)。
----
-## 故障排查
-### 连接问题
-1. **检查 NapCat 是否运行**
-   ```bash
-   # 检查服务状态
-   curl http://localhost:3001/get_status
-   ```
-2. **验证 WebSocket 配置**
-   - 确认 `wsUrl` 与 NapCat 配置一致
-   - 检查访问令牌是否正确
-3. **防火墙设置**
-   - 确保 WebSocket 端口未被防火墙拦截
-### 消息发送失败
-1. **检查账号状态**
-   ```bash
-   openclaw channels
-   ```
-2. **查看日志**
-   ```bash
-   openclaw logs --channel qq --verbose
-   ```
-3. **验证消息格式**
-   - 确保目标格式正确：`private:<QQ>` 或 `group:<群号>`
-### 常见问题
-| 问题 | 可能原因 | 解决方案 |
-|------|----------|----------|
-| 连接失败 | NapCat 未启动 | 启动 NapCat 服务 |
-| 认证失败 | accessToken 错误 | 检查配置中的令牌 |
-| 消息未收到 | 账号被禁用 | 检查 `enabled: true` |
-| 图片发送失败 | URL 不可访问 | 确保图片 URL 可公网访问 |
----
-## 相关链接
-- [OpenClaw 官方文档](https://docs.openclaw.ai/)
-- [OpenClaw 插件开发指南](https://docs.openclaw.ai/plugin)
-- [NapCat GitHub](https://github.com/NapNeko/NapCatQQ)
-- [OneBot 11 协议标准](https://github.com/botuniverse/onebot-11)
----
-## 开源协议
-[MIT](LICENSE) © izhimu
----
-<p align="center">
-  如有问题或建议，欢迎提交 Issue 或 PR
-</p>
+# @izhimu/qq
+<p align="center">
+  <a href="https://opensource.org/licenses/MIT">
+    <img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT">
+  </a>
+  <a href="https://docs.openclaw.ai/">
+    <img src="https://img.shields.io/badge/OpenClaw-Plugin-blueviolet.svg" alt="OpenClaw">
+  </a>
+  <a href="https://github.com/botuniverse/onebot-11">
+    <img src="https://img.shields.io/badge/Protocol-OneBot_11-yellow.svg" alt="Protocol">
+  </a>
+  <a href="https://www.typescriptlang.org/">
+    <img src="https://img.shields.io/badge/Language-TypeScript-blue.svg" alt="TypeScript">
+  </a>
+</p>
+<p align="center">
+  <strong>QQ Channel Plugin for OpenClaw</strong>
+</p>
+<p align="center">
+  通过 NapCat WebSocket API 连接 QQ 机器人，支持私聊、群聊、图片、回复等多种消息类型
+</p>
+---
+## 目录
+- [功能特性](#功能特性)
+- [安装](#安装)
+- [快速开始](#快速开始)
+- [配置](#配置)
+- [使用方法](#使用方法)
+- [架构设计](#架构设计)
+- [API 文档](#api-文档)
+- [开发指南](#开发指南)
+- [故障排查](#故障排查)
+---
+## 功能特性
+- **多渠道支持** - 同时支持 QQ 私聊和群聊
+- **消息类型** - 文本、@提及、图片、表情、语音、文件、回复
+- **实时通信** - WebSocket 全双工连接，支持自动重连
+- **心跳监测** - 内置健康检查和连接状态监控
+- **交互式配置** - 提供向导式配置界面
+- **TypeScript** - 完整的类型定义和类型安全
+---
+## 安装
+### 前提条件
+1. 安装 [OpenClaw](https://docs.openclaw.ai/) >= 2026.2.1
+2. 安装并配置 [NapCat](https://github.com/NapNeko/NapCatQQ) WebSocket 服务
+### 通过 OpenClaw CLI 安装
+```bash
+# 安装插件
+openclaw plugins install @izhimu/qq
+```
+### 本地开发安装
+```bash
+# 克隆仓库
+git clone <repository-url>
+cd openclaw-channel-qq
+# 安装依赖
+npm install
+# 构建项目
+npm run build
+# 安装到 OpenClaw
+openclaw plugins install /path/to/openclaw-channel-qq
+```
+---
+## 快速开始
+### 1. 配置 NapCat
+在 NapCat 的 `config.yml` 中启用 WebSocket：
+```yaml
+ws:
+  servers:
+    - url: ws://0.0.0.0:3001
+      token: ""  # 如需认证请设置
+      enableHeart: true
+```
+### 2. 配置 OpenClaw
+运行交互式配置向导：
+```bash
+openclaw onboard
+```
+或手动编辑配置：
+```json
+{
+  "channels": {
+    "qq": {
+      "wsUrl": "ws://127.0.0.1:3001",
+      "accessToken": "",
+      "enabled": true
+    }
+  }
+}
+```
+### 3. 启动 Gateway
+```bash
+openclaw gateway restart
+```
+---
+## 配置
+### 配置选项
+| 属性 | 类型 | 必填 | 默认值 | 描述 |
+|------|------|------|--------|------|
+| `wsUrl` | `string` | 是 | - | NapCat WebSocket 地址 |
+| `accessToken` | `string` | 否 | `""` | 访问令牌（如配置了认证） |
+| `enabled` | `boolean` | 否 | `true` | 是否启用该账号 |
+### 配置示例
+```json
+{
+  "channels": {
+    "qq": {
+      "wsUrl": "ws://127.0.0.1:3001",
+      "accessToken": "your-token",
+      "enabled": true
+    }
+  }
+}
+```
+---
+## 使用方法
+### 发送消息
+```bash
+# 发送私聊消息
+openclaw message send "你好！" --to qq:private:123456789
+# 发送群消息
+openclaw message send "大家好！" --to qq:group:123456
+# 带回复的消息
+openclaw message send "回复你的消息" --to qq:private:123456789 --reply-to <message-id>
+```
+### 检查状态
+```bash
+# 查看频道状态
+openclaw channels
+# 查看日志
+openclaw logs --channel qq
+```
+### 消息目标格式
+| 类型 | 格式 | 示例 |
+|------|------|------|
+| 私聊 | `private:<QQ号>` | `qq:private:123456789` |
+| 群聊 | `group:<群号>` | `qq:group:123456` |
+---
+## 架构设计
+### 项目结构
+```
+openclaw-channel-qq/
+├── src/
+│   ├── channel.ts              # 插件主入口
+│   ├── core/
+│   │   ├── connection.ts       # WebSocket 连接管理
+│   │   ├── dispatch.ts         # 事件分发器
+│   │   ├── request.ts          # API 请求处理
+│   │   ├── runtime.ts          # 运行时状态管理
+│   │   └── config.ts           # 配置解析
+│   ├── adapters/
+│   │   └── message.ts          # 消息格式转换
+│   ├── types/
+│   │   └── index.ts            # TypeScript 类型定义
+│   ├── utils/
+│   │   ├── index.ts            # 工具函数
+│   │   ├── log.ts              # 日志工具
+│   │   ├── markdown.ts         # Markdown 处理
+│   │   └── cqcode.ts           # CQ 码解析
+│   └── onboarding.ts           # 交互式配置向导
+├── docs/
+│   ├── napcat-websocket-api.md # NapCat API 文档
+│   └── plugin-development-guide.md # 插件开发指南
+├── openclaw.plugin.json        # 插件清单
+├── package.json
+└── tsconfig.json
+```
+### 核心组件
+#### 1. ConnectionManager
+负责 WebSocket 连接的生命周期管理：
+- 连接建立和断开
+- 自动重连机制（指数退避）
+- 心跳监测
+- 请求/响应关联
+#### 2. MessageAdapter
+处理 NapCat 与 OpenClaw 消息格式的双向转换：
+- 入站消息解析（NapCat → OpenClaw）
+- 出站消息构建（OpenClaw → NapCat）
+- 支持多种消息段类型
+#### 3. EventDispatcher
+处理 NapCat 上报的各类事件：
+- 消息事件（私聊、群聊）
+- 通知事件（戳一戳、撤回等）
+- 元事件（心跳、生命周期）
+---
+## API 文档
+### 支持的消息类型
+| 类型 | 入站 | 出站 | 说明 |
+|------|------|------|------|
+| `text` | ✓ | ✓ | 文本消息 |
+| `at` | ✓ | ✓ | @提及 |
+| `image` | ✓ | ✓ | 图片 |
+| `face` | ✓ | - | QQ 表情 |
+| `reply` | ✓ | ✓ | 消息回复 |
+| `record` | ✓ | - | 语音消息 |
+| `file` | ✓ | - | 文件 |
+| `json` | ✓ | - | JSON 富文本 |
+### OneBot 11 接口
+```typescript
+// 发送消息
+{
+  action: 'send_msg',
+  params: {
+    message_type: 'private' | 'group',
+    user_id?: string,      // 私聊时必填
+    group_id?: string,     // 群聊时必填
+    message: NapCatMessage[] | string
+  }
+}
+// 获取消息
+{
+  action: 'get_msg',
+  params: {
+    message_id: number
+  }
+}
+// 获取运行状态
+{
+  action: 'get_status',
+  params: {}
+}
+```
+完整 API 文档请参考 [NapCat WebSocket API 文档](./docs/napcat-websocket-api.md)。
+---
+## 开发指南
+### 开发环境设置
+```bash
+# 安装依赖
+npm install
+# 开发模式（热重载）
+npm run dev
+# 构建
+npm run build
+```
+### 目录结构说明
+| 目录 | 说明 |
+|------|------|
+| `src/core/` | 核心功能模块 |
+| `src/adapters/` | 适配器（消息转换等） |
+| `src/types/` | TypeScript 类型定义 |
+| `src/utils/` | 工具函数 |
+| `docs/` | 文档 |
+| `openspec/` | OpenSpec 规范 |
+### 插件开发参考
+详细开发指南请参考 [插件开发指南](./docs/plugin-development-guide.md)。
+---
+## 故障排查
+### 连接问题
+1. **检查 NapCat 是否运行**
+   ```bash
+   # 检查服务状态
+   curl http://localhost:3001/get_status
+   ```
+2. **验证 WebSocket 配置**
+   - 确认 `wsUrl` 与 NapCat 配置一致
+   - 检查访问令牌是否正确
+3. **防火墙设置**
+   - 确保 WebSocket 端口未被防火墙拦截
+### 消息发送失败
+1. **检查账号状态**
+   ```bash
+   openclaw channels
+   ```
+2. **查看日志**
+   ```bash
+   openclaw logs --channel qq --verbose
+   ```
+3. **验证消息格式**
+   - 确保目标格式正确：`private:<QQ>` 或 `group:<群号>`
+### 常见问题
+| 问题 | 可能原因 | 解决方案 |
+|------|----------|----------|
+| 连接失败 | NapCat 未启动 | 启动 NapCat 服务 |
+| 认证失败 | accessToken 错误 | 检查配置中的令牌 |
+| 消息未收到 | 账号被禁用 | 检查 `enabled: true` |
+| 图片发送失败 | URL 不可访问 | 确保图片 URL 可公网访问 |
+---
+## 相关链接
+- [OpenClaw 官方文档](https://docs.openclaw.ai/)
+- [OpenClaw 插件开发指南](https://docs.openclaw.ai/plugin)
+- [NapCat GitHub](https://github.com/NapNeko/NapCatQQ)
+- [OneBot 11 协议标准](https://github.com/botuniverse/onebot-11)
+---
+## 开源协议
+[MIT](LICENSE) © izhimu
+---
+<p align="center">
+  如有问题或建议，欢迎提交 Issue 或 PR
+</p>

package/dist/src/utils/markdown.d.ts CHANGED Viewed

@@ -3,22 +3,19 @@ export declare class MarkdownToText {
     private maskPrefix;
     private maskCounter;
     /**
-     * 主入口：将 Markdown 转换为纯文本
-     * @param markdown 原始 Markdown 字符串
+     * 主入口：将 Markdown 转换为纯文本（移动端优化版）
      */
     convert(markdown: string): string;
     /**
      * 保护代码块
-     * 支持 ```language 和 ~~~ 两种写法
      */
     private maskCodeBlocks;
     /**
      * 保护行内代码
-     * `code` -> 使用单引号包裹，区别于普通文本
      */
     private maskInlineCode;
     /**
-     * 还原被掩码的内容
+     * 还原掩码内容
      */
     private unmaskContent;
     /**

package/dist/src/utils/markdown.js CHANGED Viewed

@@ -1,116 +1,121 @@
 export class MarkdownToText {
-    // 用于暂存被保护的代码块，防止被正则误伤
     codeBlockStore = new Map();
-    maskPrefix = '%%MD_MASK_';
+    maskPrefix = '%%MD-MASK-';
     maskCounter = 0;
     /**
-     * 主入口：将 Markdown 转换为纯文本
-     * @param markdown 原始 Markdown 字符串
+     * 主入口：将 Markdown 转换为纯文本（移动端优化版）
      */
     convert(markdown) {
         if (!markdown)
             return '';
-        // 1. 初始化
+        // 初始化
         this.codeBlockStore.clear();
         this.maskCounter = 0;
         let text = markdown;
-        // --- 阶段 1: 保护性预处理 (Protect) ---
-        // 必须最先执行，防止代码里的注释 # 被当成标题，或 ** 被当成粗体
+        // ============================================================
+        // 阶段 1: 保护性预处理 (Protect)
+        // ============================================================
         text = this.maskCodeBlocks(text);
         text = this.maskInlineCode(text);
-        // --- 阶段 2: 结构化转换 (Structure) ---
-        // 2.1 清理 HTML 标签 (保留 <br> 的换行效果)
+        // ============================================================
+        // 阶段 2: 优先处理特殊标签 (Priority Tags)
+        // ============================================================
+        // 2.1 图片 -> [图片] url（保留 URL，放在同一行）
+        text = text.replace(/!\[([^\]]*)]\(([^)]+)\)/g, (_match, alt, url) => {
+            const displayText = alt ? `[图片: ${alt}]` : '[图片]';
+            return `${displayText} ${url}`;
+        });
+        // 2.2 自动链接 <http://...> -> http://...
+        text = text.replace(/<((?:https?|ftp|email|mailto):[^>]+)>/g, '$1');
+        // 2.3 普通链接 [Text](url) -> Text: url（冒号分隔，更清晰）
+        text = text.replace(/\[([^\]]+)]\(([^)]+)\)/g, (_match, linkText, url) => {
+            // 如果链接文本就是 URL，只显示一次
+            if (linkText === url || linkText.trim() === url.trim()) {
+                return url;
+            }
+            return `${linkText}: ${url}`;
+        });
+        // ============================================================
+        // 阶段 3: 结构化转换 & 清理 (Structure & Clean)
+        // ============================================================
+        // 3.1 预处理换行和分割线标签
         text = text.replace(/<br\s*\/?>/gi, '\n');
-        text = text.replace(/<hr\s*\/?>/gi, '\n────────────────────\n');
-        text = text.replace(/<[^>]+>/g, ''); // 移除剩余所有标签
-        // 2.2 标题 (Headers) -> 转换为视觉醒目的文本
-        // H1/H2 使用双线/单线分隔，H3+ 使用括号包裹
-        text = text.replace(/^#\s+(.*)$/gm, '\n$1\n════════════════════\n');
-        text = text.replace(/^##\s+(.*)$/gm, '\n$1\n────────────────────\n');
-        text = text.replace(/^(#{3,6})\s+(.*)$/gm, '\n【 $2 】\n');
-        // 2.3 水平分割线 (---, ***, ___)
-        text = text.replace(/^(-\s*?|\*\s*?|_\s*?){3,}\s*$/gm, '────────────────────');
-        // 2.4 引用 (Blockquotes) -> 使用竖线前缀
-        // 处理多级引用 >> Text
-        text = text.replace(/^(>+)\s?(.*)$/gm, (_match, _arrows, content) => {
-            return `▎ ${content}`;
+        text = text.replace(/<hr\s*\/?>/gi, '\n---\n');
+        // 3.2 安全清理 HTML 标签
+        text = text.replace(/<(script|style)[^>]*>[\s\S]*?<\/\1>/gi, '');
+        text = text.replace(/<!--[\s\S]*?-->/g, '');
+        text = text.replace(/<\/?([a-z][a-z0-9]*)\b[^>]*>/gi, '');
+        // 3.3 标题 -> 简洁样式
+        text = text.replace(/^#\s+(.*)$/gm, '\n【$1】\n');
+        text = text.replace(/^##\s+(.*)$/gm, '\n■ $1\n');
+        text = text.replace(/^(#{3,6})\s+(.*)$/gm, '\n▸ $2\n');
+        // 3.4 Markdown 分割线
+        text = text.replace(/^(-\s*?|\*\s*?|_\s*?){3,}\s*$/gm, '---');
+        // 3.5 引用
+        text = text.replace(/^(>+)\s?(.*)$/gm, (_match, arrows, content) => {
+            const level = arrows.length;
+            return level > 1 ? `  ${content}` : `${content}`;
         });
-        // 2.5 任务列表 (Task Lists)
-        text = text.replace(/^(\s*)-\s\[x]\s/gim, '$1✅ '); // 完成
-        text = text.replace(/^(\s*)-\s\[\s]\s/gim, '$1⬜ '); // 未完成
-        // 2.6 无序与有序列表 (Lists)
-        // 保留 $1 (缩进空格)，将 -/*/+ 替换为 •
-        text = text.replace(/^(\s*)[-*+]\s+(.*)$/gm, '$1• $2');
-        // 有序列表 1. 2. 通常不需要改动，保留原样即可
-        // 2.7 表格 (Tables)
-        // 移除对齐行 |---|---|
+        // 3.6 任务列表 & 无序列表
+        text = text.replace(/^(\s*)-\s\[x]\s/gim, '$1✓ ');
+        text = text.replace(/^(\s*)-\s\[\s]\s/gim, '$1□ ');
+        text = text.replace(/^(\s*)[-*+]\s+(.*)$/gm, '$1· $2');
+        // 3.7 表格
         text = text.replace(/^\s*\|?[\s\-:|]+\|?\s*$/gm, '');
-        // 将 | Cell | Cell | 转换为空格分隔，尽量保持一行
         text = text.replace(/^\|(.*)\|$/gm, (_match, content) => {
-            // 移除首尾管道符，中间管道符变为空格
-            return content.split('|').map((s) => s.trim()).join('  ');
+            return content.split('|').map((s) => s.trim()).join(' | ');
         });
-        // --- 阶段 3: 行内格式清理 (Inline Formatting) ---
-        // 3.1 粗体 (Bold) -> 使用中文引号或双星号强调
-        // 使用 [\s\S] 确保匹配跨行粗体
-        text = text.replace(/(\*\*|__)([\s\S]*?)\1/g, '“$2”');
-        // 3.2 斜体 (Italic) -> 直接移除符号，纯文本很难表现斜体
-        // 注意：必须在处理完粗体后处理斜体
+        // ============================================================
+        // 阶段 4: 行内格式 (Inline Formatting)
+        // ============================================================
+        // 4.1 粗体 -> 保留文字
+        text = text.replace(/(\*\*|__)([\s\S]*?)\1/g, '$2');
+        // 4.2 斜体 -> 保留文字
         text = text.replace(/([*_])([\s\S]*?)\1/g, '$2');
-        // 3.3 删除线 (Strikethrough) -> 移除内容或仅移除符号？通常仅移除符号
+        // 4.3 删除线 -> 保留文字
         text = text.replace(/~~([\s\S]*?)~~/g, '$1');
-        // 3.4 图片 (Images) -> 转换为占位符
-        text = text.replace(/!\[([^\]]*)]\(([^)]+)\)/g, (_match, alt) => {
-            return `[图片: ${alt || 'Image'}]`;
-        });
-        // 3.5 链接 (Links) -> Text (URL)
-        // 排除锚点链接或空链接
-        text = text.replace(/\[([^\]]+)]\(([^)]+)\)/g, '$1 ($2)');
-        // 处理自动链接 <http://example.com>
-        text = text.replace(/<((?:https?|ftp|email):[^>]+)>/g, '$1');
-        // --- 阶段 4: 还原与收尾 (Restore & Finalize) ---
-        // 4.1 还原代码块
+        // ============================================================
+        // 阶段 5: 还原与收尾 (Restore & Finalize)
+        // ============================================================
+        // 5.1 还原代码块
         text = this.unmaskContent(text);
-        // 4.2 解码 HTML 实体 (&amp; -> &)
+        // 5.2 解码 HTML 实体
         text = this.decodeHtmlEntities(text);
-        // 4.3 最终排版优化
-        // 移除段首段尾多余空白，将连续3个以上换行压缩为2个（段落间距）
-        text = text.replace(/\n{3,}/g, '\n\n').trim();
+        // 5.3 最终排版优化
+        text = text.replace(/\n{3,}/g, '\n\n');
+        text = text.replace(/[ \t]+/g, ' ');
+        text = text.replace(/^\s+|\s+$/gm, '');
+        text = text.trim();
         return text;
     }
     /**
      * 保护代码块
-     * 支持 ```language 和 ~~~ 两种写法
      */
     maskCodeBlocks(text) {
-        // 匹配 3个或更多反引号/波浪线
-        const codeBlockRegex = /(`{3,}|~{3,})(\w*)\n([\s\S]*?)\1/g;
+        const codeBlockRegex = /(`{3,}|~{3,})(\w*)\n?([\s\S]*?)\n?\1/g;
         return text.replace(codeBlockRegex, (_match, _fence, lang, code) => {
-            const key = `${this.maskPrefix}BLOCK_${this.maskCounter++}`;
-            const langTag = lang ? ` [${lang}]` : '';
-            // 构造美观的代码块样式
-            const formatted = `\n────────────────────${langTag}\n${code.replace(/^\n+|\n+$/g, '')}\n────────────────────\n`;
+            const key = `${this.maskPrefix}BLOCK-${this.maskCounter++}`;
+            const langTag = lang ? `[${lang}]\n` : '';
+            const formatted = `\n${langTag}${code.trim()}\n`;
             this.codeBlockStore.set(key, formatted);
             return key;
         });
     }
     /**
      * 保护行内代码
-     * `code` -> 使用单引号包裹，区别于普通文本
      */
     maskInlineCode(text) {
         return text.replace(/`([^`]+)`/g, (_match, code) => {
-            const key = `${this.maskPrefix}INLINE_${this.maskCounter++}`;
-            this.codeBlockStore.set(key, ` ‘${code}’ `); // 加空格防止粘连
+            const key = `${this.maskPrefix}INLINE-${this.maskCounter++}`;
+            this.codeBlockStore.set(key, `'${code}'`);
             return key;
         });
     }
     /**
-     * 还原被掩码的内容
+     * 还原掩码内容
      */
     unmaskContent(text) {
-        // 使用正则全局匹配所有 mask key
-        const maskRegex = new RegExp(`${this.maskPrefix}\\w+_\\d+`, 'g');
+        const maskRegex = new RegExp(`${this.maskPrefix}[\\w-]+`, 'g');
         return text.replace(maskRegex, (key) => {
             return this.codeBlockStore.get(key) || '';
         });

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@izhimu/qq",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "A QQ channel plugin for OpenClaw using NapCat WebSocket",
   "type": "module",
   "main": "dist/index.js",