Plugins
- 添加 yt-dlp 插件

## [0.1.0] --2025-08-25
## Added
- Plugin @property command 改成 string[]，满足一些多命令的插件，需要调整以前的插件结构

Plugins
- 添加 netease 插件
- eat 添加 brightne 参数用来调节头像亮度
- 修复 send_cron 重启启动无法继续以前的任务

Plugins
- 修复 eat tlg 表情包坐标问题
- 添加 bulk_delete、eat2

## [0.1.1] --2025-08-26
## Added
- help 可查看当前版本
- 添加 id 插件
- .npm search 可查看远程插件列表

Plugins
- 添加 search、aban 插件

Telebox
- 清除 AliasDB.ts

新增插件：
安装方式 npm i <插件名>
* clean_member
* da
* dc
* gt
* ip
* music 需要自行配置warp+YouTube cookie
* shift
* speednext
* dig
* gpt
* keyword
* komari

Telebox 更新：

* 优化帮助文案

更新指令：

* .update

📢 TeleBox 更新公告

插件更新
· 新增 pin_cron — 定时置顶/取消置顶消息（含任务管理）
· 新增 forward_cron — 定时转发消息
· 新增 lottery — 抽奖插件

主程序更新
· 新增通用实体处理 & access hash 工具
· 美化 help.ts、id.ts 文案
· 更新 plugins.json 配置

更新方式
· 更新主程序：update -f
· 安装新插件：npm i <插件名>

📢 TeleBox 更新公告 | 2025/08/31

🔌 插件更新

PR #18 已合并：eat 插件更新 by @ClearLuv

• 增加 eatkz、maskkz
• 更新 eat 配置

新增功能：
• forward_cron 插件支持全局任务管理
• 新增 dme 插件
• 优化日志输出

🔨 TeleBox 主仓库更新

增强 npm search 显示效果，支持插件仓库链接

帮助文档新增 npm search 使用提示

新增 ping 插件 🏓

.ping — Telegram 延迟测试

.ping all — 测试所有数据中心

.ping [IP/域名/dcX] — 指定目标延迟测试

支持 ICMP 与 TCP 测试

更新方式
· 更新主程序：update -f
· 安装新插件：npm i <插件名>
· eat set 更新表情包配置

## [0.1.3] --2025-09-01
- pluginManager 修复对含有子命令的插件添加太多监听函数

⚠️⚠️⚠️ 需要重启下 telebox

📢 TeleBox 更新公告 | 2025/09/01

🔌 插件更新

PR #19 已合并：新增 PM2 插件 by @EAlyce

• 新增 PM2 插件，支持快速重启和停止所有应用
• 更新 plugins.json 配置
• 优化 README 插件说明文档

更新方式
· 更新主程序：update -f
· 安装新插件：npm i pm2

📢 TeleBox 更新公告 | 2025/09/02

🔌 主程序更新
PR #15 已合并：新增一键安装全部远程插件并显示进度条 by @EAlyce

新增命令：npm i all
· 一键安装全部远程插件
· 支持显示安装进度条

🔌 插件更新
PR #22 已合并：新增 autochangename 插件 & 增强 dme 插件 by @EAlyce

新增 autochangename 插件：支持定时修改个人资料名称增加时间显示
dme 插件新增 -f 参数：支持无限制消息搜索
更新 plugins.json
优化 README.md

🔨 文档更新
2 new commits to TeleBox:main by @xream

补充 .nvmrc 配置说明

补充 pm2-logrotate 使用说明

更新方式
· 更新主程序：update -f
· 安装新插件：npm i autochangename
· 一键安装全部插件：npm i all

📢 TeleBox 更新公告 | 2025/09/02

🔨 主程序更新
6 new commits to TeleBox\:main by @EAlyce

* 增加插件参数系统，支持类型安全定义与自动验证
* 新增 parsePluginArgs, validatePluginArgs, generateParameterHelp 工具
* 扩展 Plugin 接口支持可选参数字段，保持向下兼容
* 创建 TELEBOX\_AI\_DEVELOPMENT\_PROMPT.md
* 统一插件帮助文档格式并建立开发规范
* 优化 ping 插件：集成 Telegram 网络栈并改进用户体验

🔨 插件文档更新
2 new commits to TeleBox\_Plugins\:main by @EAlyce

* 更新 README.md

🔨 插件配置更新
2 new commits to TeleBox\_Plugins\:main by @EAlyce

* 更新 plugins.json

更新方式
· 更新主程序：update -f
· 一键安装全部插件：npm i all

📢 TeleBox 更新公告 | 2025/09/03

🔨 主程序更新

- 美化 npm 样式

🔨 插件更新
- npm search ：新增插件状态显示，新增插件简介
- eat 插件：显示表情包名字并优化用户体验
- dme 插件： 新增图片防撤回
🔨 插件文档更新

- clean_member 插件：精简帮助文案

🔨 插件配置更新

- 为所有插件新增 desc 字段

更新方式
· 更新主程序：update -f
· 一键安装全部插件：npm i all

TeleBox Dev更新 | 2025/09/06

📌 本体更新
- 优化文档
- 补全依赖
- getCommandFromMessage 调整，支持 Api.Message | string
- 调整命令前缀
- 增加消息序列化还原方法

🔌 插件更新

通用改进
- 放弃旧的 node-schedule，全面切换至 cron
- 适配全新插件系统（部分插件尚未完全适配）
- 固定定时任务 → 使用 cronTasks
- 动态定时任务 → 使用 cronManager
- description 必须包含明确的使用说明
- 插件前缀应动态获取，而不是写死
- sudo 模式下涉及触发者原始消息需使用 trigger
- 时间统一为 zh-CN 格式，时区设为 Asia/Shanghai
- 用户/频道/对话展示可参考 acron.formatEntity 与 sudo.buildDisplay
- 配置存储可选择 sqlite 或 lowdb

插件详情

• acron, send_cron, forward_cron, pin_cron
- 定时发送 / 转发 / 复制 / 置顶 / 取消置顶 / 删除消息 / 执行命令
- 替代旧的 send_cron、forward_cron、pin_cron

• eat
- 支持 sudo 模式下 trigger 为原始消息
- 表情包“我”优先取 trigger

• gpt
- 数据文件规范化

• dbdj
- 新增 点兵点将 功能：从最近消息中随机抽取指定人数

• npm, tpm
- npm 更名为 tpm
- 优化输出显示与长消息处理
- 支持插件安装记录
- 新增一键更新功能

• re
- 示范最后删除原始消息
- 支持话题

• help
- 支持定时任务
- 描述支持动态生成
- 默认关闭链接预览

• debug, entity, msg, id
- 新增 entity, msg 调试功能
- 吸收 id，合并为 debug 插件

• sure
- 2 秒后自动删除原消息
- 修复类型判断
- 支持赋予他人 bot 身份发消息（支持重定向）
- 支持内置命令（操作 aban 等）
- _command: 开头的消息自动识别为命令

• sudo
- 支持 trigger 原始消息
- 修复类型判断
- 使用缓存，支持频道马甲与固定 id 链接
- 简化判断逻辑
- add/del 支持回复消息或传入 uid/@username
- 新增对话白名单

• sendLog
- 支持发送日志文件到收藏夹或自定义目标

• bf
- 修复时区问题

• ping
- 修复 dc1~dc5 icmp avg 取值问题

⚙️ 更新方式
- 更新主程序：update -f
- 安装新插件：tpm i <插件名>
- 一键安装全部插件：tpm i all

📢 声明
本次为TeleBox Dev更新
等待测试结束后
本体与插件会一并推送到 main 分支
⚠️ 部分插件的数据库需要手动迁移
建议先备份 导出

若出现 bug，会在后续快速修复，敬请耐心等待

📢 TeleBox 更新 | 2025/09/06

🗓 [0.2.0] --2025-09-06

🔧 本体

- safeForwardMessage 支持发送至话题

- 支持从环境变量设置命令前缀

- 优化文档

- 补全依赖

- getCommandFromMessage 调整, 支持 Api.Message | string

- 调整前缀

- 增加消息序列化还原方法

🧩 插件

- 放弃了旧的 node-schedule 使用新的 cron

- 适配了新的插件系统

- 部分插件未完美适配

- 固定的定时任务, 应使用 cronTasks

- 动态的处理定时任务, 应使用 cronManager

- description 应包含明确的使用说明, 现已支持动态生成

- 应动态获取前缀, 而不是写死固定的字符串

- 如果涉及到 sudo 模式下, 获取或操作触发触发者的原始消息, 应使用 trigger

- 例如 re 中, 尝试删除原始消息

- 例如 eat 中, 表情包中的 我 应优先取 trigger, 这才是 sudo 模式下的触发者

- 展示时间, 可先统一格式 zh-CN, 时区 Asia/Shanghai

- 展示用户/频道/对话, 可参考 acron 的 formatEntity 和 sudo 的 buildDisplay

- 读写配置, 可使用 sqlite 或 lowdb

📦 acron, send_cron, forward_cron, pin_cron

- 定时发送/转发/复制/置顶/取消置顶/删除消息/执行命令, 取代了 send_cron, forward_cron, pin_cron

- 调整格式, 去除不必要的换行

- 支持直接跳转到目标对话/消息 支持话题

📦 eat

- 支持 sudo 模式下, trigger 为触发者的原始消息, 表情包的 我 为触发者

📦 gpt

- 数据文件规范化

📦 dbdj

- 新增点兵点将, 从最近的消息中随机抽取指定人数的用户

📦 npm, tpm

- npm -> tpm

- 优化显示和长消息

- 支持插件安装记录

- 支持一键更新

📦 re

- 示范在最后删除发送的原始消息

- 支持话题

📦 help

- 支持定时任务

- 描述支持动态生成

- 关闭链接预览

📦 debug, entity, msg, id

- 新增 entity, msg 方便调试

- 吸收了 id, 合并为 debug 插件: 获取 entity/msg 信息, 获取详细的用户、群组或频道信息

📦 sure

- 默认不 mention

- 2s 后自动删除原消息

- 修复类型判断

- 赋予其他用户使用 bot 身份发送消息(支持重定向)的权限

- 支持内置命令(操作 aban, 可实现额外管理员功能)

- 消息若以 _command: 开头, 认为此消息是命令, 即 _command:/sb 可匹配 /sb 和 /sb uid. 若设置了重定向为 /spam, 则会自动变成 /spam 和 /spam uid

📦 sudo

- 默认不 mention

- 传入 trigger 发送者的原始消息

- 修复类型判断

- 使用缓存, 支持频道马甲, 简化判断和展示逻辑, 支持使用固定 id 链接

- 调整对话/频道/用户判断逻辑

- add/del 支持回复目标用户的消息或带上 uid/@username

- 支持对话白名单

📦 sendLog

- 支持发送日志文件到收藏夹或自定义目标

📦 bf

- 简单修复下 bf 时区问题

📦 ping

- 修复 ping dc1~dc5 icmp avg 取值问题

📦 shift

- 支持发送到话题, 不用再设置多余的 all

📦 pmcaptcha

- 暂时下架 待更新

⚙️ 更新方式
- 更新主程序：update -f
- 安装新插件：tpm i <插件名>
- 一键安装全部插件：tpm i all

📢 声明
⚠️ 部分插件的数据库需要手动迁移
建议先备份 导出

若出现 bug，会在后续快速修复，敬请耐心等待

📢 重要提醒 | 2025/09/07

由于 0.2.0 采用全新架构，更新后需要 重新登录或重装。

🔧 操作步骤

1. 停止 TeleBox

cd ~/telebox

pm2 stop telebox

npm start

2. 登录完成后，按下 CTRL + C 退出

3. 重启 TeleBox

pm2 restart telebox

⚠️ 如果更新后遇到异常，请先确认是否已完成 重新登录 / 重装 步骤。

📅 TeleBox 日报 - 2025-09-07

📊 今日提交统计
• 总提交数: 34
• TeleBox: 5 次提交
• TeleBox_Plugins: 29 次提交

🔧 TeleBox
• `d8368f7` tpm 文案 _13:18_
• `31c36b6` debug 新增 echo, 回复一条消息 尝试以原样回复 _12:34_
• `d6710f0` 修复 sudo, sure 复制 _12:05_
• `f6c8e54` 新增 dayjs _12:05_
• `b009ee9` tpm 区分精简版和详细版已安装记录 _08:22_

🔧 TeleBox_Plugins
• `66f7ca4` 修复bug _21:28_
• `767ff41` GIF转贴纸插件 _21:27_
• `5336d69` 新增视频转音频插件 _21:24_
• `2b104a0` 优先识别法币 _19:21_
• `11aba0d` 优化rate插件 智能查询汇率 _19:11_
• `1af6f7a` - eat _18:55_
• `a3fbaef` - 完善 eat 的表情包头像配置 _18:53_
• `c7d2fc2` bulk_delete 支持数据库持久化存储 _17:15_
• `d3169f0` - update eat _16:55_
• `35cdc3e` 从内部引入 axios _16:47_
• _... 还有 19 条提交_

👥 今日贡献者
• xream: 13 次提交
• EAlyce: 18 次提交
• TeleBoxDev: 2 次提交
• ClearLuv: 1 次提交

⏰ 报告生成时间: 2025/9/8 10:59:31

📅 TeleBox 日报 - 2025-09-06

📊 今日提交统计
• 总提交数: 31
• TeleBox: 19 次提交
• TeleBox_Plugins: 12 次提交

📦 docs 插件/功能
- : 重写TELEBOX_AI_DEVELOPMENT_PROMPT.md基于实际代码
- : 优化文档

📦 feat 插件/功能
- : help 去除默认的中文别名, 可自行 alias 重定向
- : 重定向中的命令允许不符合 /^[a-z0-9_]+$/i
- : debug msg, entity 消息过长则以文件形式发送
- : exit 之后重启将更新消息, 展示重启成功与耗时
- : 新增命令 exit - 结束进程 若配置了进程管理工具, 将自动重启
- : 命令必须符合 /^[a-z0-9_]+$/i
- : bf 支持 to 单次备份到指定目标, 发送后显示对话名称
- : 重构简化版 bf; 更新 package-lock.json
- : gitignore my_session
- : safeForwardMessage 支持发送至话题
- : 支持从环境变量设置命令前缀
- : sudo, sure 默认不 mention

📦 Merge 插件/功能
- branch 'dev'

📦 其他 插件/功能
- - 命令必须符合 /^[a-z0-9_]+$/i

📦 revert 插件/功能
- : 命令必须符合 /^[a-z0-9_]+$/i

📦 chore 插件/功能
- : sure 命令文案

📦 release 插件/功能
- : 0.2.0

📦 fix 插件/功能
- : 修复 acron 备注解析
- : 修复 acron 消息链接

📦 feat 插件/功能
- : 新增汇率查询计算插件
- : bulk_delete 支持 .bd on 之后, .bd 数字删除自己和他人的消息
- : acron 支持直接跳转到目标对话/消息 支持话题
- : shift 支持发送到话题, 不用再设置多余的 all
- : acron 调整格式, 去除不必要的换行
- : 新增 点兵点将 - 从最近的消息中随机抽取指定人数的用户
- : gpt 数据文件规范化

📦 chore 插件/功能
- : acron 命令文案
- : acron 可作为 lowdb, cronManager 和 formatEntity(涉及用户/频道/对话展示) 使用示范

📦 revert 插件/功能
- : 暂时下架 pmcaptcha(待更新)

👥 今日贡献者
• EAlyce: 2 次提交
• xream: 28 次提交
• TeleBoxDev: 1 次提交

⏰ 报告生成时间: 2025/9/8 11:15:25

📅 TeleBox 日报 - 2025-09-05

📊 今日提交统计
• 总提交数: 25
• TeleBox: 12 次提交
• TeleBox_Plugins: 13 次提交

📦 feat 插件/功能
- 完善别名和帮助
- entity, id -> debug(获取 entity/msg 信息, 获取详细的用户、群组或频道信息); re 支持话题
- 增加消息序列化还原方法
- 调整前缀, 调整分割长消息阈值
- tpm 优化显示和长消息, 支持插件安装记录, 支持一键更新
- 适配 allas, entity, exec, id, ping, sendLog, update
- 暂时回退 sudo patch(现在 edit 一次就会发送一次, 等新的方案); sudo 传入 trigger 发送者的原始消息; 适配 re, 示范在最后删除发送的原始消息
- bf 使用 LowDB + CronManager; 适配 sysinfo; npm -> tpm
- 适配 sure
- help 关闭链接预览
- help 支持定时任务, 描述支持动态生成; 尝试适配 sudo

📦 fix 插件/功能
- 修复 help

📦 feat 插件/功能
- 适配 keyword, ip, gt, eat(支持 sudo 模式下, trigger 为原始消息, 表情包的 '我' 为触发者)
- 适配 yt-dlp, search, q, pmcaptcha, pm2, netease, music, lottery, komari
- 适配 bulk_delete, da, dc, dig, dme, yvlu(API 404 了)
- 适配 speednext
- 适配 AutoChangeName
- acron 支持定时执行命令
- acron 支持 pin/unpin
- acron 支持 forward/copy
- acron 支持 send(为保证消息的格式, 需要回复一条消息 - 储存此消息到数据库 不支持带多媒体或 replyMarkup 的消息, 可考虑使用本插件的定时复制/转发功能)
- 大一统插件 acron(定时发送/转发/复制/置顶/取消置顶/删除消息), 先实现了删除
- 适配 send_cron(改为 lowdb)
- 适配 aban
- 适配 shift

👥 今日贡献者
• xream: 25 次提交

⏰ 报告生成时间: 2025/9/8 11:20:48

📢 TeleBox 更新 | 2025/09/08

🗓 [0.2.1] --2025-09-08

- 放宽命令校验：重定向命令允许不符合 /^[a-z0-9_]+$/i

- 文档：重写 TELEBOX_AI_DEVELOPMENT_PROMPT.md ，并整体优化

- 通知/公告：通知消息改为纯文本格式；修复公告文案过长

- 提交总结：新增每日提交总结与脚本 使用 Gemini AI 生成；修正需扫描的目标仓库

🧩 插件

📦 acron

- 新增 `ls`、`la`

- 支持直接跳转到目标对话/消息，并支持话题

- 修复复制、备注解析与消息链接

- 优化取值与复制逻辑、格式调整去除多余换行

- 提供 `lowdb`/`cronManager`/`formatEntity` 使用示例

- 文案更新

📦 bf

- 支持 `to` 参数：单次备份到指定目标并显示对话名称

- 文案更新

📦 bulk_delete

- 支持数据库持久化存储

- `.bd on` 后可用 `.bd 数字` 删除自己和他人消息

📦 convert

- 新增视频转音频插件

📦 debug

- 新增 `echo`：原样回复一条消息

- `msg/entity` 过长时以文件形式发送

📦 eat

- 完善表情包头像配置

- 文案更新

📦 gemini

- 新增 Gemini 插件

- 支持提交/日报总结能力

📦 gif

- 新增 GIF 转贴纸插件

📦 gpt

- 数据文件规范化

📦 help

- 去除默认中文别名，支持通过 alias 自定义重定向

📦 his

- 新增：查看被回复者最近 30 条消息

📦 kitt

- 新增高级触发器（JavaScript 匹配 → 执行），逻辑自由

- 上下文增加 API

- 文案修复与更新

📦 music

- 重写 `music.ts` 以适配新架构并增强音频处理

📦 news

- 新增新闻插件

- 更新 `news.ts`

📦 QR

- 新增二维码插件

📦 rate

- 新增汇率查询计算能力

- 优化智能查询流程，优先识别法币

- 删除多余别名

📦 search

- 修复 bug

📦 shift

- 支持发送到话题

📦 speednext

- 别名由 `s` 调整为 `st`

📦 sudo

- 修复复制逻辑

📦 sure

- 修复复制逻辑

📦 tpm

- 区分“精简版/详细版”已安装记录

- 文案更新

📦 exit

- 新增 `exit` 指令：结束进程；如配置进程管理工具将自动重启，并在重启时展示耗时与成功提示

📦 pmcaptcha

- 暂时下架（待更新）

📦 pm2

- 插件删除（由 `exit` 指令可实现重启）

📦 点兵点将

- 从最近的消息中随机抽取指定人数的用户

⚙️ 更新方式
- 更新主程序：update -f
- 安装新插件：tpm i <插件名>
- 一键更新已安装的远程插件：tpm update
- 一键安装全部插件：tpm i all

📢 声明
⚠️ 部分插件的数据库需要手动迁移
建议先备份 导出

若出现 bug，会在后续快速修复，敬请耐心等待