← 返回 Skills 市场
josephyb97

feishuFindDoc

作者 Josephyb97 · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
535
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install feishu-doc-finder
功能描述
Find and download files from Feishu chat history by filename.
使用说明 (SKILL.md)

Feishu File Finder

A utility skill to search for a file in a Feishu chat (by filename) and download it. Useful when OpenClaw's auto-download misses a file or for retrieving past files.

Prerequisites

  • FEISHU_APP_ID and FEISHU_APP_SECRET must be set in environment.

Usage

cd skills/feishu-file-finder
npm install

# Basic usage
node index.js --chat \x3Cchat_id> --file \x3Cfilename>

# Options
# -o, --output \x3Cdir>   Save path (default: current dir)
# -h, --hours \x3Cnum>    Search history lookback (default: 24h)

Example

export FEISHU_APP_ID=...
export FEISHU_APP_SECRET=...

node index.js --chat oc_87435... --file travel-planner.zip
安全使用建议
This skill's behavior (using the Feishu SDK to search chat history and download files) is coherent with its description, but there is an important metadata mismatch: the registry entry does not declare the FEISHU_APP_ID and FEISHU_APP_SECRET env vars that both SKILL.md and the code require. Before installing or running this skill: 1) Only provide FEISHU_APP_ID/FEISHU_APP_SECRET for an app you created or trust; prefer an app with minimal permissions (read-only access to the specific chat scope). 2) Review package.json and the exact versions of dependencies (npm install will pull @larksuiteoapi/node-sdk and commander). 3) Run the skill in a sandboxed environment or container to limit filesystem/network exposure; it will write downloaded files to disk. 4) Ask the publisher to update registry metadata to declare the required environment variables and to provide a homepage/source repo for auditing. 5) If you need higher assurance, audit the SKILL.md and index.js yourself or have a trusted reviewer confirm there are no unexpected network endpoints or credential exfiltration paths (none were detected in the provided code).
功能分析
Type: OpenClaw Skill Name: feishu-doc-finder Version: 1.0.0 The skill's primary function is to find and download files from Feishu, which aligns with its description. It accesses `FEISHU_APP_ID` and `FEISHU_APP_SECRET` from environment variables, which is necessary for its operation, and there is no evidence of exfiltration. However, the `index.js` script constructs the output file path using `path.join(options.output, fileName)`. If the `fileName` retrieved from the Feishu API contains path traversal sequences (e.g., `../../evil.sh`), a malicious file could be written outside the intended output directory. This represents a potential path traversal vulnerability, classifying the skill as suspicious due to this risky capability, even though there's no clear evidence of intentional malicious behavior by the developer.
能力评估
Purpose & Capability
The skill's stated purpose (find & download files from Feishu chat) matches the implementation (uses @larksuiteoapi/node-sdk to list messages and download resources). However, the registry metadata declares no required environment variables or primary credential, while SKILL.md and index.js both require FEISHU_APP_ID and FEISHU_APP_SECRET. This mismatch is unexpected and reduces transparency about what secrets the skill needs.
Instruction Scope
SKILL.md directs running npm install and node index.js with chat and filename arguments and explicitly requires FEISHU_APP_ID/FEISHU_APP_SECRET. The runtime instructions and code operate within the stated scope (search chat history, locate file messages, download file to disk). The instructions do not request unrelated files, system config, or external endpoints beyond Feishu's API (via the official SDK).
Install Mechanism
There is no custom install spec; the skill is instruction+code that expects a normal npm install of declared dependencies (commander and @larksuiteoapi/node-sdk). No arbitrary URL downloads or extract steps are used. Risk is typical for npm packages (supply-chain risk) but not unusual or disproportionate for this functionality.
Credentials
The credentials the code requires (FEISHU_APP_ID and FEISHU_APP_SECRET) are reasonable for accessing Feishu chat and downloading files — so their existence is proportionate. The issue is that the registry metadata did not advertise these required environment variables or a primary credential, meaning a user installing the skill might not realize they must provide secrets. That mismatch is a transparency and safety concern.
Persistence & Privilege
The skill does not request always: true, does not declare any system-wide config paths, and does not modify other skills. It writes downloaded files to a user-specified output directory (default current directory), which is expected behavior for a downloader.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install feishu-doc-finder
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /feishu-doc-finder 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of Feishu File Finder (version 1.0.0). - Enables searching and downloading files from Feishu chat history by filename. - Supports specifying chat ID, filename, output directory, and search time window. - Requires setting FEISHU_APP_ID and FEISHU_APP_SECRET environment variables.
元数据
Slug feishu-doc-finder
版本 1.0.0
许可证
累计安装 0
当前安装数 0
历史版本数 1
常见问题

feishuFindDoc 是什么?

Find and download files from Feishu chat history by filename. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 535 次。

如何安装 feishuFindDoc?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install feishu-doc-finder」即可一键安装,无需额外配置。

feishuFindDoc 是免费的吗?

是的,feishuFindDoc 完全免费(开源免费),可自由下载、安装和使用。

feishuFindDoc 支持哪些平台?

feishuFindDoc 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 feishuFindDoc?

由 Josephyb97(@josephyb97)开发并维护,当前版本 v1.0.0。

💬 留言讨论