Releases: BukeLy/Stateless-FileSystem-Agent
Releases · BukeLy/Stateless-FileSystem-Agent
v0.3.0
What's New
Added
- SQS FIFO 队列: 升级为 FIFO 队列,保证同一会话内消息顺序处理
- Telegram Webhook 安全验证: 支持
X-Telegram-Bot-Api-Secret-TokenHMAC 验证 - 本地命令 Handler 系统: 支持
static(静态回复) 和handler(处理函数) 两种类型 - 新命令:
/newchat- 在群组 Forum 中创建新 Topic 开始独立对话/debug- 下载当前会话的 session 文件/start- 私聊欢迎消息
- 持续打字指示: Consumer 每 4 秒发送打字状态,改善长请求时的用户体验
- Markdown 转换管道: 将 Agent 输出转换为 Telegram MarkdownV2 格式
- Forum 群组支持: Bot 入群自动检查 Topics 功能和权限
- 用户白名单: 支持限制私聊和群组邀请权限
Changed
- Node.js 升级: Docker 镜像升级到 Node.js 20+ (MCP undici 依赖要求)
- HOME 目录: 从
/root改为/tmp(MCP auth 文件写入兼容) - Producer 权限扩展: 新增 DynamoDB 读取和 S3 读取权限
Breaking Changes
Full Changelog: v0.2.0...v0.3.0
架构变更 - SQS异步处理
主要变更
架构重构
- 重构 SDK Client 为 SQS 异步架构 - 解决 Telegram webhook 超时问题
- Producer Lambda 立即返回 200,响应时间从 30-70s 降至 < 1s
- Consumer Lambda 异步处理消息,无超时限制
- 支持灵活的重试策略和死信队列(DLQ)
功能改进
- 增强异常处理和错误恢复机制
- 添加 SQS 权限策略和 HTTP 状态码检查
- 优化消息处理流程
文档更新
- 添加 SQS 异步架构设计文档
- 更新 README,添加英文文档和项目说明
- 添加架构调整的 CHANGELOG
Bug 修复
- 修复 code review 的 3 个高优先级问题
- 修复命令拦截逻辑,允许所有消息传给 Agent 处理
- 使用 ResultMessage.result 获取最终响应
- 修复 Dockerfile hadolint 警告
- 优化 MarkdownV2 系统提示词确保正确转义
预期收益
- ✅ Telegram Webhook 响应时间: 30-70s → < 1s
- ✅ 消除超时重试问题
- ✅ 提升用户体验
- ✅ 更好的可观测性(队列深度监控)
- ✅ 灵活的重试和错误处理
成本影响
- 总增量: < $1/月