feishu-search

Feishu Search Skill 是一款专为飞书（Lark）平台设计的命令行搜索工具，旨在为开发者和企业用户提供统一的资源检索入口。该技能通过调用飞书官方开放 API，实现了对聊天记录、云文档、表格等资源的高效检索功能，代码安全规范，适合集成至自动化工作流。

核心用法方面，该技能以 Node.js CLI 形式提供，用户可通过简单的命令行参数执行搜索操作。主要支持两大功能模块：一是消息搜索（search_messages），可跨私聊和群聊检索历史聊天记录；二是文档搜索（search_docs），支持定位文档、表格及多维表格。使用时需预先安装 feishu-common 依赖模块，并配置 FEISHU_APP_ID、FEISHU_APP_SECRET 等环境变量完成身份认证，通过标准输入输出与系统交互。

显著优点体现在多个维度。代码层面遵循安全规范，无 eval、exec 等危险函数，依赖版本通过 package-lock.json 严格锁定，杜绝了供应链攻击风险。网络行为完全透明，所有请求均指向官方 Feishu API（open.feishu.cn），不存在数据泄露至第三方服务器的风险，且搜索结果仅本地输出，无静默收集行为。权限设计合理，采用显式环境变量配置模式，敏感操作需用户主动授权，符合最小权限原则，同时具备良好的错误处理机制，不暴露敏感堆栈信息。

潜在缺点与局限性亦需关注。首要问题是来源可信度为 T3 级（个人开发者账号），虽代码质量达到 A 级标准，但缺乏官方组织背书，长期维护能力存在不确定性。功能上存在外部强依赖，必须配合 feishu-common 模块才能运行，增加了依赖链的复杂度与潜在攻击面。当前版本仅实现搜索功能，日历搜索尚处于计划阶段，功能覆盖面有待扩展。此外，CLI 交互模式对非技术用户存在一定使用门槛，且需用户自行管理 API 凭证的安全存储。

该技能特别适合以下群体：企业 IT 管理员、需要集成飞书搜索能力的开发者、以及构建办公自动化流程的技术团队。对于已在内部部署飞书应用的企业，可作为资源检索的底层工具集成至 CI/CD 流程、内部管理系统或运维脚本中，实现文档和消息的自动化查找。

使用风险主要集中于三方面：一是依赖链风险，feishu-common 模块的安全性直接影响本技能，需确保该模块同样经过安全审查；二是凭证管理风险，FEISHU_APP_SECRET 等敏感信息若硬编码或配置不当可能导致企业数据泄露，必须妥善存储于环境变量或专业密钥管理系统；三是 T3 来源的潜在维护风险，个人开发者项目的持续更新、漏洞修复响应能力存在不确定性。建议在高安全性场景下，定期审查代码变更，并优先考虑迁移至组织级可信来源或官方 SDK。