# topicsBot

**Repository Path**: lcm_ccy/topics-bot

## Basic Information

- **Project Name**: topicsBot
- **Description**: 一个基于NTFY的topic写的几个python好玩的脚本
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-21
- **Last Updated**: 2026-02-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Bot

** Bot ** 是一个基于 `ntfy.sh` 协议的轻量级、模块化 Linux 远程管理与多模态交互框架。它专为极客和开发者设计，通过动态加载机制，将复杂的服务器运维与 AI 对话、音频处理、视觉监控等功能集成在手机端的即时通讯界面中。



## ✨ 核心特性

* **🧩 模块化动态加载**：采用“按需加载”机制，组件在收到指令时才实例化，并在闲置（360秒）后自动卸载，极大地节省了系统内存。
* **⛓️ 智能指令流水线**：支持类似 Bash 的管道符 `|` 和逻辑与 `&&`，允许指令级联。例如：`/pulse | /say` (获取负载并语音播报)。
* **🤖 AI 深度交互**：内置 DeepSeek 大模型，支持上下文记忆，可作为指令链的逻辑中枢或分析器。
* **📟 交互式 PTY 终端**：通过 `/cmdstart` 开启伪终端模式，支持实时输出流，实现接近原生 SSH 的交互体验。
* **📊 实时保镖监控**：后台线程实时监控 CPU 温度与磁盘空间，并利用 `ntfy` 的优先级功能实现高分贝紧急告警。
* **🎨 创意多模态**：
    * **音频**：远程环境监听 (`arecord`) 与 微软晓晓 TTS 喊话。
    * **视觉**：X11 窗口枚举与高精度截图。
    * **极客**：二进制流转 MIDI 音乐、LSB 图片隐写术。

---

## 🛠️ 系统要求

### 基础环境
* **Python**: 3.10+
* **通讯**: 一个自建或公共的 [ntfy.sh](https://ntfy.sh) 主题。
* **AI**: 一个deepseek api

### 核心依赖
```bash
pip install requests openai mido python-rtmidi numpy pillow edge-tts
```

### 系统级工具 (Linux)

* **截图**: `maim`, `wmctrl` , ` xdotool `
* **播放/录音**: `mpv`, `alsa-utils`
* **监控**: `top`, `free`, `df`

---

## 🚀 快速部署

1. **设置环境变量**:
```bash
export NTFY_URL="[https://ntfy.sh/your_secret_topic](https://ntfy.sh/your_secret_topic)"
export DEEPSEEK_API_KEY="your_api_key"
# 如果 ntfy 开启了 ACL 认证
export NTFY_USER="your_user"
export NTFY_PASS="your_pass"

```


2. **启动主程序**:
```bash
python main.py

```



---

## 📖 指令手册

### 1. 系统管理与监控

| 指令 | 效果 |
| --- | --- |
| `/status` | 弹出系统健康报告（含 CPU 温度、内存、带宽）及快捷按钮 |
| `/cmd <cmd>` | 执行单条 Shell 命令并捕获输出 |
| `/cmdstart` | 启动交互式 Shell 模式（/stop结束） |
| `/screenshot` | 获取活动窗口列表，点击按钮即可远程截图 |

### 2. AI 与 语音

| 指令 | 效果 |
| --- | --- |
| `/aistart` | 进入 AI 对话模式（非斜杠消息均由 AI 处理/stop结束） |
| `/say <text>` | 在服务器端通过扬声器播放语音 |
| `/listen [sec]` | 录制指定时长的环境音并回传 |

### 3. 极客组合技 (Pipelines)

* **语音报温度**: `/status | /say`
* **分析系统状态**: `/status | /aistart 请分析当前系统是否存在性能瓶颈`
* **秘密传输**: `/cmd cat /etc/passwd | /steg` (执行命令并将结果隐写进图片)

支持管道符和&&

---

##  模块结构


.
├── main.py                # 调度核心：Bot 管理器、指令流水线解析
├── communicator.py        # 通讯适配器：封装 ntfy 推送与监听逻辑
├── aibot.py               # AI 模块：对接 DeepSeek API
├── bot.py                 # 终端模块：PTY 交互式 Shell 实现
├── sys_bot.py             # 监控模块：硬件采集与主动告警告警
├── audiobot.py            # 音频模块：TTS 与录音处理
├── screenshotbot.py       # 视觉模块：窗口管理与 Maim 截图
├── steganobot.py          # 安全模块：LSB 隐写算法实现
└── pulsebot.py            # 声音模块：CPU 负载频率映射

## 整体部署


```bash
# 1. 将当前目录下的所有代码拷贝到 /opt/jiaolong
sudo cp -r . /opt/jiaolong
sudo cd /opt/jiaolong

# 2. 创建环境配置文件（保护你的 API Key 不直接暴露在服务脚本里）
# 请根据你的实际情况修改下面的值
sudo tee /opt/jiaolong/.env <<EOF
NTFY_URL=https://ntfy.sh/你的主题
DEEPSEEK_API_KEY=你的API密钥
NTFY_USER=你的用户名
NTFY_PASS=你的密码
DISPLAY=:1
XAUTHORITY=/root/.Xauthority
EOF
```

创建systemctl
```bash
sudo tee /etc/systemd/system/jiaolong.service <<EOF
[Unit]
Description=Jiaolong Smart Bot Service
# 确保在网络完全在线后启动
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=root
Group=root
WorkingDirectory=/opt/jiaolong
# 加载刚才创建的环境变量文件
EnvironmentFile=/opt/jiaolong/.env
ExecStart=/usr/bin/python3 main.py
# 崩溃后自动重启，间隔 5 秒
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF
```

自启动
```bash
# 重新加载配置
sudo systemctl daemon-reload

# 设置开机自启
sudo systemctl enable jiaolong

# 立即启动
sudo systemctl start jiaolong

# 查看运行状态
sudo systemctl status jiaolong
```