飞书卡片消息推送工具，支持 Markdown 富文本、代码块、表格、彩色标题栏与交互按钮，需依赖 feishu-common 认证模块。
说明：
## 核心用法
Feishu Card Skill 是一款面向飞书（Lark）生态的自动化消息推送工具，通过调用飞书开放平台的「交互式卡片」接口，实现富媒体内容的程序化发送。其核心功能包括：
1. **三种发送模式**：
– **简单文本模式**：直接通过 `–text` 参数发送纯文本，适用于无特殊字符的场景；
– **文件引用模式**（推荐）：先将 Markdown 内容写入临时文件，通过 `–text-file` 读取，规避 Shell 转义问题，特别适合代码块、日志、表格等复杂格式；
– **安全封装模式**：`send_safe.js` 自动处理临时文件创建与清理，简化调用流程。
2. **Persona 角色化 messaging**：内置 d-guide（警告红）、green-tea（软萌粉）、mad-dog（灰调错误风）等预设风格，自动匹配配色、前缀文案与语气后缀，适用于告警、运营、技术监控等不同场景。
3. **富媒体支持**：彩色标题栏（6 色可选）、Markdown 语法（代码高亮、表格）、本地图片上传嵌入、底部交互按钮（跳转链接）。
### 显著优点
– **格式完整性保障**：强制文件中转机制彻底解决 Shell 对反引号、星号等特殊字符的吞噬问题，确保代码块、日志原样呈现；
– **低代码集成**：命令行即调即用，无需编写 HTTP 请求或处理 OAuth 令牌（由 feishu-common 托管）；
– **视觉分层清晰**：卡片化布局优于普通文本消息，信息结构更易读；
– **Persona 扩展性**：角色模板可快速复制修改，适配团队内部运营规范。
### 潜在缺点与局限性
– **依赖前置条件**：必须预先安装并配置 `feishu-common`，且该模块需有效 tenant_access_token，单点故障风险存在；
– **平台锁定**：仅兼容飞书/ Lark 生态，无法迁移至企业微信、Slack、钉钉等其他 IM；
– **本地文件约束**：`–image-path` 要求图片必须存在于本地文件系统，不支持 URL 直链或 Base64 嵌入；
– **交互能力有限**：按钮仅支持单一跳转 URL，不支持回调事件、表单填写等高级交互；
– **无历史记录**：工具本身不存储发送日志，失败重试或审计追溯需依赖外部系统。
### 适合人群
– 运维/ SRE 工程师：用于告警通知、CI/CD 流水线状态推送；
– 后端开发者：代码审查结果、自动化测试报告的可视化分发；
– 运营人员：定时数据日报、活动提醒的模板化发送。
### 常规风险
– **Token 泄露**：feishu-common 存储的 tenant_access_token 若权限过高，一旦泄露可导致企业数据被批量读取；
– **Shell 注入**：`–text` 参数若直接拼接用户输入，存在命令注入风险（尽管官方推荐文件模式已规避大部分场景）；
– **频率限制**：飞书开放平台对单应用存在 QPS 与单日消息上限，高频推送需做削峰与兜底队列。
会员专属
