SDF COM 桥接器

将 SDF COM 聊天室与飞书（Feishu）打通的双向桥接工具，支持实时消息同步与中英互译。

架构

• 通过 SSH Socket 连接 SDF
• COM 运行于远程主机
• 终端解析器（Terminal Parser）提取聊天消息
• 翻译器（Translator）处理英文 ↔ 中文双向翻译
• 飞书（Feishu）集成模块发送格式化消息

组件

1. SSH 连接（scripts/ssh_connection.py）

复用 ControlMaster socket 建立连接。

from ssh_connection import SSHConnection

conn = SSHConnection(user="yupeng", host="sdf.org")
conn.connect("com -c")  # 启动 COM
conn.send("g anonradion")  # 进入房间

2. COM 交互（scripts/com_interaction.py）

COM 命令封装器。

3. 终端解析器（scripts/terminal_parser.py）

从终端输出中提取聊天消息。

from terminal_parser import SimpleTextParser

parser = SimpleTextParser()
messages = parser.feed(raw_text)

4. 翻译器（scripts/translator.py）

执行英文到中文的翻译。

from translator import LLMTranslator

translator = LLMTranslator()
zh = translator.quick_translate_en_to_zh("hello")

5. 飞书（Feishu）桥接模块（scripts/feishu_bridge.py）

解析飞书（Feishu）中的指令命令。

6. 主桥接器（scripts/main.py）

完整运行示例。

from main import SDFComBridge

bridge = SDFComBridge(
    user="yupeng",
    host="sdf.org",
    target_room="anonradio"
)

bridge.start()
bridge.handle_feishu_message("com: hello")
bridge.stop()

使用方法

安装依赖：

pip install -r requirements.txt

直接运行：

python scripts/main.py

测试连接：

python -c "from scripts.ssh_connection import SSHConnection; c = SSHConnection(); print(c._check_socket())"

配置

编辑 main.py 文件：

bridge = SDFComBridge(
    user="yupeng",
    host="sdf.org",
    target_room="anonradio"
)

默认房间

自动加入 anonradio 聊天室。

消息流向

COM → 飞书（Feishu）：

• 英文消息自动翻译为中文后发送至飞书

飞书（Feishu） → COM：

• 以 "com:" 开头的消息将被转发至 COM

注意事项

• 需已存在 SSH ControlMaster socket
• socket 路径：~/.ssh/sockets/yupeng@sdf.org
• 远程主机上必须可执行 com 命令
• pyte 依赖正确的终端尺寸（默认为 80×24）