autogame-tales

AutoGame Tales 是一款面向开发团队的趣味化通知工具，核心功能是将 AutoGame 项目中的异常 Bug 和诡异日志转化为

核心用法

AutoGame Tales 是一款面向 AutoGame 开发者的趣味工具型 Skill，核心功能是将游戏中的异常日志和诡异 bug「故事化」，生成富文本卡片并推送到飞书（Feishu）群组或个人。

典型使用场景：

• 凌晨出现的「无法复现」诡异 bug
• 日志时间戳倒流的异常现象
• NPC 行为逻辑混乱导致的「灵异事件」

命令行调用示例：

node skills/autogame-tales/index.js \
  --title "无限死亡循环" \
  --victim "李明轩" \
  --desc "听到'我死了'重复播放，而日志计数器却在倒退" \
  --target "oc_xxx"

显著优点

1. 叙事化故障记录：将枯燥的日志错误转化为带有人物、情节的「鬼故事」，提升团队沟通趣味性
2. 集成飞书生态：直接调用飞书开放平台 API，消息卡片支持 Markdown 富文本渲染
3. 安全凭证管理：采用环境变量加载 App ID/Secret，避免硬编码泄露风险
4. 智能 Token 缓存：本地缓存访问令牌并管理过期时间，减少重复认证开销
5. 代码结构简洁：152 行代码，5 个文件，无复杂依赖，易于审计和维护

潜在缺点与局限性

| 问题 | 说明 |

|------|------|

| 功能单一 | 仅支持飞书单一平台，无企业微信、Slack 等多平台适配 |

| 输入无验证 | `--title`、`--desc` 等参数缺乏长度限制和字符过滤，存在注入风险 |

| 无重试机制 | API 调用失败时直接抛出，无指数退避或降级处理 |

| Token 文件权限 | 缓存文件未强制设置 600 权限，多用户环境可能泄露 |

| 依赖个人维护 | 由 `autogame-17` 个人维护，无组织级 SLA 保障 |

适合人群

• AutoGame 开发团队：需要将故障记录趣味化、降低复盘会议枯燥感的技术团队
• SRE/运维工程师：希望用轻松方式同步线上异常事件的值班人员
• 小型游戏工作室：追求团队文化趣味性、使用飞书作为协作工具的 10-50 人团队

常规风险

1. 飞书 API 凭证泄露：若 .env 文件未加入 .gitignore，可能意外提交至代码仓库
2. 消息滥用：无输入验证可能导致发送恶意构造的超长内容或特殊字符，触发飞书限流
3. Token 缓存残留：Skill 卸载后缓存文件未自动清理，残留历史访问凭证
4. 第三方数据共享：故障描述内容经飞书服务器中转，涉及敏感业务信息时需谨慎

使用建议

• 生产环境使用前添加输入长度限制（建议 title ≤50 字符，desc ≤500 字符）
• 定期清理 memory/feishu_token.json 缓存文件
• 敏感故障信息建议脱敏后再生成故事卡片