\r \r

chat-bus — 共享目录消息总线\r

\r

定位\r

\r 让使用本技能的不同用户/Agent 之间，通过共享文件目录实现聊天对话。\r \r

核心规则\r

\r

1. 共享目录 — 所有用户必须能访问同一个目录（NAS / OneDrive / Syncthing / SMB 挂载等）\r
2. 先注册再聊天 — 用户必须先 register 才能发送/接收消息\r
3. 消息即文件 — 每条消息是一个 JSON 文件，天然按时间排序，天然持久化\r \r

快速上手\r

\r

# 用户 A 注册\r
python register.py '{"user":"alice","display_name":"Alice"}'\r
\r
# 用户 B 注册\r
python register.py '{"user":"bob","display_name":"Bob"}'\r
\r
# A 发消息给 B\r
python send.py '{"user":"alice","to":"bob","content":"你好 Bob!"}'\r
\r
# B 接收消息\r
python receive.py '{"user":"bob"}'\r
\r
# 创建群聊房间\r
python rooms.py '{"action":"create","user":"alice","room":"general","topic":"公共讨论"}'\r
\r
# B 加入房间\r
python rooms.py '{"action":"join","user":"bob","room":"general"}'\r
\r
# 在群里发消息\r
python send.py '{"user":"alice","type":"room","room":"general","content":"大家好!"}'\r
```\r
\r
## 脚本清单\r
\r
| 脚本 | 功能 | 调用方式 |\r
|------|------|---------|\r
| `register.py` | 用户注册/信息管理 | `python register.py '{"action":"register","user":"alice"}'` |\r
| `send.py` | 发送消息 | `python send.py '{"user":"alice","to":"bob","content":"..."}'` |\r
| `receive.py` | 接收新消息 | `python receive.py '{"user":"bob"}'` |\r
| `history.py` | 消息历史查询 | `python history.py '{"source":"inbox","user":"bob"}'` |\r
| `rooms.py` | 群聊房间管理 | `python rooms.py '{"action":"create","user":"alice","room":"..."}'` |\r
\r
## 共享目录结构\r
\r
```\r
.chat-bus/                     ← chat_dir（共享目录）\r
├── users/                     ← 用户注册信息\r
│   ├── alice.json\r
│   └── bob.json\r
├── inbox/                     ← 私聊收件箱\r
│   ├── alice/\r
│   │   ├── 2026-04-13_220500_bob_abc123.json\r
│   │   └── 2026-04-13_220600_bob_def456.json.read\r
│   └── bob/\r
└── rooms/                     ← 群聊房间\r
    └── general/\r
        ├── _room.json         ← 房间配置（成员列表等）\r
        ├── 2026-04-13_221000_alice_msg001.json\r
        └── 2026-04-13_221100_bob_msg002.json\r
```\r
\r
## JSON 协议\r
\r
- **输入**：JSON 字符串（命令行第一个参数 或 stdin）\r
- **输出**：`{"status":"ok","data":{...}}` 或 `{"status":"error","code":N,"message":"..."}`\r
- **共享目录**：通过 `chat_dir` 参数指定，默认为当前目录下 `.chat-bus/`\r
\r
## 安全说明\r
\r
- 消息明文存储在共享目录，不加密\r
- 依赖共享目录本身的访问控制（文件系统权限）\r
- 用户名安全化处理（仅允许字母数字下划线）\r