Harborbeacon Desktop

HarborBeacon桌面

HarborBeacon Desktop是Windows和macOS上用于远程助手工作流的独立桌面主机项目。

推荐的独立存储库名称： harborbeacon-desktop

此工作区目前提供：

• 用于桌面主机架构的Rust工作区框架
• 一 doctor 用于Feishu凭据和连接诊断的CLI
• 未来Feishu、运行时和VS代码桥工作的基础机箱

布局

• apps/desktop：桌面代理--飞舒WS→ 派遣→ vscode桥→ reply
• apps/doctor：飞舒诊断CLI
• apps/mcp-server：用于VS代码/副本的stdio MCP服务器
• crates/core-contracts：共享类型（通道、InboundMessage、OutboundMessage等）
• crates/feishu-provider：飞书API，WebSocket长连接，回复客户端
• crates/router-runtime：运行时配置
• crates/vscode-bridge：沙盒工作区操作（read_file、list_directory、search_text）

快速开始

医生CLI

cargo run -p harborbeacon-desktop-doctor -- --app-id  --app-secret 

使用 --json 用于机器可读输出。

桌面代理

cargo run -p harborbeacon-desktop -- \
  --app-id  --app-secret  \
  --workspace .

代理通过WebSocket连接到Feishu，接收消息，分派 /read, /ls, /search 对工作区执行命令并回复 自动回到飞叔。

VS代码/复制品MCP集成

1. 构建MCP服务器：

   cargo build --release -p harborbeacon-desktop-mcp-server

1. 复制 .vscode/mcp.json 进入目标工作区 .vscode/ 文件夹

（或合并 "mcp" 在现有的VS代码设置中添加部分）。

1. 更新 "command" 指向已构建二进制文件的路径，以及

"--workspace" 到您要公开的项目根目录。

1. 重新启动VS代码。MCP工具(read_file, list_directory,

search_text)将出现在Copilot的工具列表中。

测试

cargo test --workspace