HX LAN Chat for VS Code

在 VS Code 右侧辅助侧边栏中进行双人局域网私聊，并与 hx-cli 终端客户端互通。

功能

• 使用六位配置码创建或加入聊天，无需公网服务器。
• VS Code 插件和 hx-cli 可以互相创建、加入并双向发送消息。
• 局域网广播不可用时，可以通过房主 IP 和端口直连。
• 房主可以使用本机配置将聊天记录归档到 MySQL，加入方无需数据库配置。

安装

在 VS Code 扩展视图中搜索 HX LAN Chat，或者搜索完整插件 ID：

@id:hx-lan.hx-lan-chat-vscode

使用

1. 点击右侧侧边栏的 HX 图标。
2. 输入昵称后选择“创建聊天”，把六位配置码发给对方。
3. 对方可以在插件中输入配置码，或在终端执行 hx-cli 六位码。

房主使用与 hx-cli 相同的本机配置和 macOS 钥匙串，聊天记录自动写入 MySQL hx 数据库。插件包不包含数据库密码，密码仍从房主的 macOS 钥匙串读取。

如果局域网广播发现被防火墙阻止，可在“直连设置”中填写房主 IP 和端口。

网络与隐私

聊天连接只在局域网内建立，不经过 HX 云端服务。配置码用于发现并验证本次聊天，仍应只发送给准备加入的伙伴。

兼容性

• VS Code 1.106 或更高版本
• macOS Intel / Apple Silicon
• HX CLI 1.2.1

终端版本保持原用法：

npm install --global hx-lan-chat-cli@1.2.1
hx-cli

本地打包

在项目根目录运行：

./scripts/package-vscode.zsh --install

这会执行类型检查、单元测试、与真实 hx-cli 的双向互通测试，生成 VSIX，并可选安装 到本机 Visual Studio Code。插件已经把网络、MySQL 和所需依赖打进 VSIX，不要求先全局 安装 hx-cli。