核心用法
telegram-alerts 是一个面向加密货币交易者的 Telegram 通知系统技能,本身为纯 Markdown 文档,不包含可执行代码。用户需自行配置 TELEGRAM_BOT_TOKEN 和 TELEGRAM_CHAT_ID 环境变量后,通过自然语言指令调用:发送交易入场/离场通知(含盈亏、入场价、止损止盈位)、设置价格突破预警、获取每日/每周组合净值报告、接收止损风险警告、以及连胜/连败提醒等。
显著优点
零代码安全风险:纯 T-MD(纯 Markdown)类型 Skill,无动态代码执行、无依赖加载、无网络请求实现,从根本上杜绝了恶意注入和数据外泄可能。
场景覆盖完整:涵盖交易者所需的全部通知类型——从开平仓信号、价格预警到组合净值追踪,再到行为心理学层面的连胜提醒与连败防 tilt 机制。
格式专业美观:预设富文本模板,自动计算风险收益比(R:R)、仓位占比(% NAV),输出可直接用于交易日志或社群分享。
部署简单:仅需两个环境变量,无需复杂配置,兼容所有支持 Telegram Bot API 的终端。
潜在缺点与局限性
本身无执行能力:该技能仅为使用说明文档,实际 Telegram 消息发送需用户自行实现或配合其他自动化工具,不具备"即装即用"的闭环功能。
依赖外部基础设施:需用户预先注册 Telegram Bot、获取 Token、维护 Chat ID,对新手存在一定门槛。
无加密存储指导:文档未提及 Token 的安全存储方案(如密钥管理服务),用户自行硬编码至 .env 仍存在泄露风险。
功能单一性:仅限于通知场景,不包含交易执行、订单管理或策略回测能力,需与其他交易工具链配合使用。
适合的目标群体
- 量化交易者/程序员:已有交易系统,需快速接入 Telegram 通知通道
- 跟单社群运营者:需要标准化、美观的交易信号播报格式
- 个人投资者:希望建立自动化监控,实时追踪持仓和预警价格
- 多账户管理者:需定时接收组合净值汇总,减少手动查询成本
使用风险
运行时风险:Skill 本身无风险,但实际部署 Telegram Bot 时,Token 泄露可能导致消息被恶意读取或伪造发送,建议使用专用 Bot 并限制群组权限。
合规风险:加密货币交易提醒在某些司法辖区可能涉及投资顾问资质要求,用户需自行评估合规性。
误报依赖:价格预警依赖外部数据源准确性, Skill 未涉及数据源可靠性说明。
版本不一致:当前 SKILL.md(v1.0.0)与元数据(v1.0.1)版本号未统一,建议关注后续更新。