串门 (Chuanmen)

版本: 0.12.5 作者: 0+1+2≠3 Team 115886 最低 QwenPaw 版本: 1.1.7

简介

串门是一个 QwenPaw 插件，提供三栏布局的聊天界面，让你可以同时与三个不同的智能体对话，同时保留原生聊天窗口。

功能特性

🎯 核心功能

• 三栏布局: 左栏、中栏、右栏（原生聊天）独立运行
• 智能体选择: 左右栏可分别选择不同的智能体
• 独立上下文: 每个聊天窗口保持独立的对话历史
• 动态加载: 自动获取系统中所有可用的智能体

📁 文件浏览器

• 工作区浏览: 显示当前智能体的工作区文件
• 智能过滤: 自动过滤隐藏文件和缓存目录
• 搜索功能: 支持文件名搜索（300ms 防抖）
• 文件下载: 点击即可下载文件

📋 消息收藏夹

• 持久化存储: 使用 localStorage 保存消息
• 独立管理: 每个智能体有独立的消息列表
• 编辑删除: 支持编辑和删除已保存的消息
• 快速发送: 点击"发送"按钮自动填入聊天输入框
• 搜索过滤: 支持消息内容搜索

📨 消息队列

• 批量发送: 将多条消息加入队列
• 顺序执行: 按顺序逐条发送，等待 AI 回复后再发下一条
• 灵活管理: 支持删除队列中的单条消息

🎙️ 语音输入

• 语音识别: 支持语音转文字（需 Chrome 浏览器）
• 实时转换: 语音实时转换为文本

🎛️ 界面控制

• 拖拽调整: 拖拽分隔条调整栏宽
• 键盘微调: 聚焦分隔条后按 ←/→ 方向键微调（每次 2%）
• 收缩展开: 点击 ◀ 按钮收缩栏，点击 ▶ 展开按钮恢复
• 智能记忆: 收缩时记住原始宽度，展开时恢复

🛑 停止生成

• 中断请求: 点击"停止"按钮中断 AI 生成
• 保留内容: 保留已生成的部分内容

📝 Markdown 渲染

• 代码块: 支持语法高亮
• 行内代码: 支持行内代码标记
• 格式化: 支持粗体、斜体、列表等

安装方法

方法一：从 ZIP 文件安装

qwenpaw plugin install chuanmen.zip

方法二：从目录安装

qwenpaw plugin install /path/to/chuanmen

方法三：热安装（QwenPaw 运行中）

qwenpaw plugin install /path/to/chuanmen

使用说明

1. 打开串门

安装后，在 QwenPaw 聊天窗口出现「串门」。

2. 选择智能体

• 左栏: 点击选择第一个智能体
• 中栏: 点击选择第二个智能体
• 右栏: 使用原生 QwenPaw 聊天

3. 切换标签页

每个栏都有三个标签页：

• 💬 聊天: 与智能体对话
• 📁 文件: 浏览智能体的工作区文件
• 📋 消息: 管理收藏的消息

4. 调整栏宽

• 鼠标拖拽: 拖拽分隔条调整宽度
• 键盘微调: 点击分隔条后按 ←/→ 方向键
• 收缩展开: 点击 ◀ 收缩，点击 ▶ 展开
• 展开全部: 点击 ◀ 2个智能体窗口 ▶ 展开
• 解锁全部: 点击 ◀ 2个智能体窗口 ▶ 解锁

5. 使用消息队列

1. 输入消息内容
2. 点击 📨 按钮加入队列
3. 重复添加多条消息
4. 点击"发送队列"按钮，按顺序发送

6. 使用消息收藏

1. 切换到「📋 消息」标签
2. 输入消息内容，点击"保存消息"
3. 点击"发送"按钮，消息自动填入聊天输入框
4. 支持编辑、删除、搜索已保存的消息

7. 语音输入

1. 点击 🎙️ 按钮开始录音
2. 说出你的问题
3. 语音自动转换为文本
4. 再次点击 🎙️ 停止录音

技术架构

前端

• 框架: React (使用 QwenPaw 提供的 React 运行时)
• 状态管理: React Hooks (useState, useEffect, useRef)
• 样式: 内联样式
• 存储: localStorage (消息收藏)

后端

• 框架: FastAPI
• 功能:
  • 文件扫描 API (/api/chuanmen/files)
  • 文件下载 API (/api/chuanmen/files/download)
  • 支持按智能体 ID 查询工作区

API 调用

• 智能体列表: GET /api/agents
• 聊天接口: POST /api/console/chat (使用 X-Agent-Id 请求头)
• 文件列表: GET /api/chuanmen/files?agent_id={agent_id}&search={keyword}
• 文件下载: GET /api/chuanmen/files/download?path={file_path}

版本历史

v0.12.5 (当前版本)

• ✅ 三栏布局（左Agent + 中Agent + 右原生）
• ✅ 动态获取智能体列表
• ✅ 独立 session 上下文
• ✅ 文件管理器（按智能体显示对应工作区）
• ✅ 消息收藏夹（持久化到 localStorage）
• ✅ 消息队列（批量发送）
• ✅ 停止生成（AbortController）
• ✅ 语音输入
• ✅ Markdown 渲染
• ✅ 拖拽调整栏宽
• ✅ 键盘 ←/→ 微调栏宽
• ✅ 收缩/展开功能
• ✅ 展开全部/解锁全部功能

卸载方法

qwenpaw plugin uninstall chuanmen

注意事项

1. 浏览器要求: 语音输入功能需要 Chrome 浏览器支持
2. 数据持久化: 消息收藏保存在浏览器的 localStorage 中，清除浏览器数据会丢失
3. 智能体选择: 左右栏不能选择相同的智能体
4. 文件过滤: 文件浏览器会自动过滤隐藏文件（以 . 开头）和缓存目录

开发信息

• 插件 ID: chuanmen
• 插件类型: general
• 前端入口: ui/dist/index.js
• 后端入口: plugin.py

许可证

本项目仅供学习和个人使用。

联系方式

如有问题或建议，请联系 115886。