OneBot TUI Control

一个为 onebot-tui 量身打造的 VS Code 控制面板，让您可以在编辑器内方便地管理聊天会话。

✨ 功能特性

• 实时联系人列表：在侧边栏清晰地展示您的好友和群组，并实时显示数量。
• 一键切换聊天：单击列表中的任意联系人，即可快速切换 onebot-tui 的当前聊天窗口。
• 快速搜索：通过顶部的搜索按钮，可以即时过滤您的联系人列表。
• 状态显示：当前活跃的聊天会以 ✅ 图标高亮显示，一目了然。
• 右键快捷操作：右键单击联系人，即可快速复制其 ID。
• 动态 API 配置：无需修改代码，在 VS Code 设置中即可轻松更改后端 API 地址。
• 智能刷新：当您修改 API 地址后，插件会自动刷新列表，无需手动操作。

🚀 快速开始

1. 安装 OneBot TUI 后端

首先，您需要安装 onebot-tui 后端程序。这是一个基于终端的 QQ 聊天客户端。

macOS & Linux

curl -sSL https://raw.githubusercontent.com/ziyi233/onebot-tui/main/install.sh | sh

Windows (PowerShell)

irm https://raw.githubusercontent.com/ziyi233/onebot-tui/main/install.ps1 | iex

2. 启动 OneBot TUI 后台服务

在终端中运行以下命令启动后台服务：

./onebot-tui-daemon

首次运行时，它会引导您创建一个 config.yml 配置文件。

3. 安装 VS Code 插件

1. 在 VS Code 扩展市场搜索 OneBot TUI Control 并安装。
2. 打开 VS Code 设置 (Ctrl + ,)。
3. 搜索 onebot-tui-control.apiUrl。
4. 填入 onebot-tui 的 API 地址（默认为 http://127.0.0.1:9090）。

4. 开始使用

• 点击 VS Code 活动栏的 OneBot TUI 图标，即可在侧边栏查看和管理您的聊天。
• 点击任意联系人即可切换到该聊天。
• 使用顶部搜索框快速查找联系人。
• 右键点击联系人可复制其 ID。

🔧 高级用法

您也可以直接使用 onebot-tui-controller 命令行工具管理聊天：

• 列出所有聊天：

  ./onebot-tui-controller list
  

• 切换到指定聊天：

  ./onebot-tui-controller use <CHAT_ID>
  

• 发送消息：

  ./onebot-tui-controller send "您要发送的消息"
  

⚙️ 插件设置

本插件提供以下配置项：

• onebot-tui-control.apiUrl: 您的 onebot-tui Go 后端程序的 API 地址。

📦 如何打包和发布 (面向开发者)

1. 安装依赖: npm install
2. 修改发布者名称: 在 package.json 文件中，将 publisher 字段的值修改为您在 VS Code Marketplace 上的发布者 ID。
3. 打包: npm run package (这会在项目根目录下生成一个 .vsix 文件)。
4. 发布: npm run publish (这会将插件发布到 VS Code Marketplace)。

📝 许可证

本项目基于 MIT 许可证。