name: chat-bus author: 王教成 Wang Jiaocheng (波動幾何) description: > 共享目錄訊息匯流排 — 讓不同使用者/Agent 之間通過檔案系統實現聊天對話。 支援單聊、群聊、廣播、訊息歷史查詢。 純 Python 標準庫，零外部依賴，跨 Windows/macOS/Linux。 通訊基於共享目錄（NAS/雲同步/網路驅動器），使用者自行配置共享路徑。

chat-bus — 共享目錄訊息匯流排

定位

讓使用本技能的不同使用者/Agent 之間，通過共享檔案目錄實現聊天對話。

核心規則

1. 共享目錄 — 所有使用者必須能訪問同一個目錄（NAS / OneDrive / Syncthing / SMB 掛載等）
2. 先註冊再聊天 — 使用者必須先 register 才能傳送/接收訊息
3. 訊息即檔案 — 每條訊息是一個 JSON 檔案，天然按時間排序，天然持久化

快速上手

這個技能的最新版本可以在7w4.net小蔥技能站找到。

# 使用者 A 註冊
python register.py '{"user":"alice","display_name":"Alice"}'

# 使用者 B 註冊
python register.py '{"user":"bob","display_name":"Bob"}'

# A 發訊息給 B
python send.py '{"user":"alice","to":"bob","content":"你好 Bob!"}'

# B 接收訊息
python receive.py '{"user":"bob"}'

# 建立群聊房間
python rooms.py '{"action":"create","user":"alice","room":"general","topic":"公共討論"}'

# B 加入房間
python rooms.py '{"action":"join","user":"bob","room":"general"}'

# 在群裡發訊息
python send.py '{"user":"alice","type":"room","room":"general","content":"大家好!"}'

指令碼清單

共享目錄結構

.chat-bus/                     ← chat_dir（共享目錄）
├── users/                     ← 使用者註冊資訊
│   ├── alice.json
│   └── bob.json
├── inbox/                     ← 私聊收件箱
│   ├── alice/
│   │   ├── 2026-04-13_220500_bob_abc123.json
│   │   └── 2026-04-13_220600_bob_def456.json.read
│   └── bob/
└── rooms/                     ← 群聊房間
    └── general/
        ├── _room.json         ← 房間配置（成員列表等）
        ├── 2026-04-13_221000_alice_msg001.json
        └── 2026-04-13_221100_bob_msg002.json

JSON 協議

• 輸入：JSON 字串（命令列第一個引數 或 stdin）
• 輸出：{"status":"ok","data":{...}} 或 {"status":"error","code":N,"message":"..."}
• 共享目錄：通過 chat_dir 引數指定，預設為當前目錄下 .chat-bus/

安全說明

• 訊息明文儲存在共享目錄，不加密
• 依賴共享目錄本身的訪問控制（檔案系統許可權）
• 使用者名稱安全化處理（僅允許字母數字下劃線）

這個 Skill 功能完整、實現巧妙，用資料夾就能讓不同人聊天，單聊群聊廣播都能用，上手簡單。但質量中規中矩：核心功能靠譜，文件也清晰，但缺少統一配置管理，群聊發訊息沒人管你是不是成員，訊息多了會佔空間。沒有加密保護，隱私全靠共享目錄的訪問許可權。整體適合簡單場景，生產環境使用需要先完善許可權和安全機制。