@w-xuefeng/cfib 0.0.1 → 0.0.2

package/README.md

@@ -93,10 +93,13 @@ cfib random output.jpg --type img --origin "https://example.com"
 
 ## 🤖 关于 AI Agent Skills
 
-在项目的 `skills/` 文件夹下包含了可以直接被 AI Agent（例如 Claude, AutoGPT 工具链）解析吸收的能力配置清单（`SKILL.md`）。
+在项目的 `skills/` 文件夹下包含了可以直接被 AI Agent（例如 Cline, OpenClaw 等工具链）解析吸收的能力配置清单（`SKILL.md`）。
 
-这些说明文档内置了完整的调用说明，AI 助手在读取这些配置后便能安全、无障碍地为你执行上述所列的图床业务。
+该说明文档（`skills/cfib-cli/SKILL.md`）内置了完整的指令和规则说明。AI 助手在读取这些配置后便能安全、无障碍地为你执行上述所列的所有图床业务（文件上传、移除和随机获取）。
 
-- `skills/upload/SKILL.md`
-- `skills/remove/SKILL.md`
-- `skills/random/SKILL.md`
+除此之外对于 AI 智能体系的自身优化，还加入了：
+- **动态帮助查询**：要求 Agent 主动执行 `cfib --help` 获取最即时的各类参数说明与最新用法规范。
+- **凭据集成提取**：内置提取启发，引导 AI 在缺失必须参数时，可以主动调用同生态的 `local-diamond` 配置中心（例如 `bunx lod get cfib/origin`）一键提取对应环境变量组，从而达成更高程度的自治运行。
+
+只需让你的 Agent 引入或者加载以下核心 Skill 解析说明，即可解锁 CFIB 图床管理的全部功能：
+- `skills/cfib-cli/SKILL.md`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@w-xuefeng/cfib",
   "description": "cloudflare-image-bed CLI tools and Agent Skills",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "module": "src/index.ts",
   "type": "module",
   "bin": {
@@ -20,4 +20,4 @@
   "dependencies": {
     "@w-xuefeng/bkit": "^0.0.5"
   }
-}
+}

package/skills/cfib-cli/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: cfib-cli
+description: Use the cfib CLI to interact with a Cloudflare Image Bed. Use when the user wants to upload a local file, remove a remote file or folder, or fetch a random image/path from the image bed via cfib.
+metadata: {"openclaw":{"requires":{"bins":["cfib"]}}}
+---
+
+# CFIB CLI
+
+This skill allows you to interact with a Cloudflare Image Bed instance via the `cfib` CLI.
+
+## Working rules
+
+- Prefer the native `cfib` binary when it exists on PATH. Otherwise, use `bunx @w-xuefeng/cfib` or `npx @w-xuefeng/cfib`.
+- Use the `exec` tool to execute the cfib script.
+- Treat `--origin`, tokens, auth codes, and similar credentials as secrets; do not echo them back unnecessarily.
+- **Credential retrieval**: If you lack required parameters (like `--origin`, `--upload-auth-code`, or tokens), try fetching them using `local-diamond` (`lod`). Extract them by executing `bunx lod get cfib/origin`, `bunx lod get cfib/upload-auth-code`, `bunx lod get cfib/upload-token`, or `bunx lod get cfib/delete-token`.
+- For destructive actions like `cfib remove`, confirm with the user unless they already clearly asked for deletion.
+- When downloading with `random --type img`, save into a user-specified path when possible and report where the file was written.
+- Return the important parts of the command result in plain language, and include paths/URLs when the command succeeds.
+- To discover more options or verify usage at runtime, execute `cfib --help`.
+
+## Commands
+
+### 1. Upload a local file (`cfib upload`)
+
+Upload a local generic file or image to a Cloudflare Image Bed instance.
+
+```bash
+cfib upload <local_filepath> [options]
+```
+
+**Required Arguments:**
+- `<local_filepath>`: The absolute or relative path to the local file you wish to upload.
+
+**Global Required Options:**
+- `--origin <url>`: The origin URL of the image bed server.
+- `--upload-auth-code <code>`: The auth code cookie value to bypass authentication.
+
+**Global Optional Environment & Tracing Options:**
+- `--upload-token <token>`: The authorization token for uploading.
+- `--trace <id>`, `--lang <language>`, `--log <true|false>`
+
+**Upload Specific Options (Optional):**
+- `--server-compress <true|false>`: Whether the server should compress the image.
+- `--upload-channel <channel>`: The channel to use (telegram, cfr2, s3, discord, huggingface).
+- `--upload-folder <folder>`: A specific folder on the server to upload the file to.
+- `--auth-code <code>`: Specific authCode for upload.
+
+**Success Criteria:** Outputs a JSON response. A successful upload contains `success: true` and the `data.src` / `data.url`.
+
+---
+
+### 2. Remove an image or folder (`cfib remove`)
+
+Delete an existing file or directory from the Cloudflare Image Bed server.
+
+```bash
+cfib remove <remote_path> [options]
+```
+
+**Required Arguments:**
+- `<remote_path>`: The path on the server referencing the file or folder.
+
+**Global Required Options:**
+- `--origin <url>`: The origin URL of the image bed server.
+- `--upload-auth-code <code>`: The auth code cookie value.
+
+**Optional Options:**
+- `--delete-token <token>`: The authorization token required for deletion.
+- `--folder`: Pass this flag if `<remote_path>` is a folder and you want to delete the whole folder.
+- `--trace <id>`, `--lang <language>`, `--log <true|false>`
+
+**Success Criteria:** Outputs a JSON response with `success: true`.
+
+---
+
+### 3. Fetch a random image (`cfib random`)
+
+Fetch a random file or image from the Cloudflare Image Bed server. It can either return the JSON metadata or download the actual file.
+
+```bash
+cfib random [options] [local_save_path]
+```
+
+**Options (All Optional):**
+- `[local_save_path]`: If you specify `--type img`, provide a local filepath to save the binary data (defaults to `random-image.jpg`).
+- `--type <path|img>`: (default: path) If `img`, returns and saves the file directly. If `path`, returns JSON info.
+- `--content <image|video>`, `--form <json|text>`, `--dir <path>`, `--orientation <landscape|portrait|square|auto>`
+
+**Global Required Options:**
+- `--origin <url>`: The origin URL of the image bed server.
+
+**Global Optional Options:**
+- `--trace <id>`, `--lang <language>`, `--log <true|false>`
+
+**Success Criteria:** Outputs JSON metadata of the file. If `--type img` is used, the image is saved to the given path.

package/skills/random/SKILL.md

@@ -1,48 +0,0 @@
----
-description: Get a random image from the Cloudflare Image Bed
----
-
-# Random Image Skill
-
-This tool fetches a random file or image from the Cloudflare Image Bed server. It can either return the JSON metadata or download the actual file.
-
-## Usage
-
-Use the `run_command` tool to execute the cfib script. If the package is installed globally, you can use `cfib`. Otherwise, use `bunx cfib` or `npx cfib`:
-
-```bash
-cfib random [options] [local_save_path]
-# OR
-bunx @w-xuefeng/cfib random [options] [local_save_path]
-```
-
-### Options (All Optional):
-- `[local_save_path]`: If you specify `--type img`, you must provide a local filepath to save the binary image data (defaults to `random-image.jpg`).
-- `--type <path|img>`: (default: path) If set to `img`, returns and saves the file directly. If set to `path`, returns JSON info.
-- `--content <image|video>`: (default: image) The type of content to filter.
-- `--form <json|text>`: (default: json) The response data format.
-- `--dir <path>`: Filter random files only within a specific server directory.
-- `--orientation <landscape|portrait|square|auto>`: Filter by image orientation.
-
-### Global Required Options:
-- `--origin <url>`: The origin URL of the image bed server.
-
-### Global Optional Options:
-- `--trace <id>`: Set an explicit Trace-Id.
-- `--lang <language>`: Set an explicit Accept-Language.
-- `--log <true|false>`: Enable or disable logging.
-
-## Examples
-
-Get JSON metadata of a random image:
-```bash
-cfib random --origin "https://my-image-bed.com"
-```
-
-Download a random image directly to `test.jpg`:
-```bash
-cfib random test.jpg --type img --origin "https://my-image-bed.com"
-```
-
-## Success Criteria
-Normally outputs JSON metadata of the file. If `--type img` is used, the image is saved to the provided local path and outputs `Image saved to <path>`.

package/skills/remove/SKILL.md

@@ -1,48 +0,0 @@
----
-description: Remove an image or folder from the Cloudflare Image Bed
----
-
-# Remove Image or Folder Skill
-
-This tool allows you to delete an existing file or directory from the Cloudflare Image Bed server.
-
-## Usage
-
-Use the `run_command` tool to execute the cfib script. If the package is installed globally, you can use `cfib`. Otherwise, use `bunx cfib` or `npx cfib`:
-
-```bash
-cfib remove <remote_path> [options]
-# OR
-bunx @w-xuefeng/cfib remove <remote_path> [options]
-```
-
-### Required Arguments:
-- `<remote_path>`: The path on the server referencing the file or folder.
-
-### Global Required Options:
-- `--origin <url>`: The origin URL of the image bed server.
-- `--upload-auth-code <code>`: The auth code cookie value.
-
-### Global Optional Options:
-- `--delete-token <token>`: The authorization token required for deletion.
-- `--trace <id>`: Set an explicit Trace-Id.
-- `--lang <language>`: Set an explicit Accept-Language.
-- `--log <true|false>`: Enable or disable logging.
-
-### Options (All Optional):
-- `--folder`: Pass this flag if the `<remote_path>` is a folder and you want to delete the whole folder instead of a target file.
-
-## Example
-
-Delete a single file:
-```bash
-cfib remove "12345.png" --origin "https://my-image-bed.com" --upload-auth-code "my-auth-code" --delete-token "my-secret-token"
-```
-
-Delete a full folder:
-```bash
-cfib remove "my_folder_name" --folder --origin "https://my-image-bed.com" --upload-auth-code "my-auth-code"
-```
-
-## Success Criteria
-The command outputs a JSON response with `success: true` when the file or folder is successfully deleted.

package/skills/upload/SKILL.md

@@ -1,45 +0,0 @@
----
-description: Upload a local image to the Cloudflare Image Bed
----
-
-# Upload Image Skill
-
-This tool allows you to upload a local generic file or image to a Cloudflare Image Bed instance.
-
-## Usage
-
-Use the `run_command` tool to execute the cfib script. If the package is installed globally, you can use `cfib`. Otherwise, use `bunx cfib` or `npx cfib`:
-
-```bash
-cfib upload <local_filepath> [options]
-# OR
-bunx @w-xuefeng/cfib upload <local_filepath> [options]
-```
-
-### Required Arguments:
-- `<local_filepath>`: The absolute or relative path to the local file you wish to upload.
-
-### Global Required Options:
-- `--origin <url>`: The origin URL of the image bed server.
-- `--upload-auth-code <code>`: The auth code cookie value to bypass authentication.
-
-### Global Optional Environment & Tracing Options:
-- `--upload-token <token>`: The authorization token for uploading.
-- `--trace <id>`: Set an explicit Trace-Id.
-- `--lang <language>`: Set an explicit Accept-Language.
-- `--log <true|false>`: Enable or disable logging.
-
-### Upload Specific Options (All Optional):
-- `--server-compress <true|false>`: Whether the server should compress the image.
-- `--upload-channel <channel>`: The channel to use (telegram, cfr2, s3, discord, huggingface).
-- `--upload-folder <folder>`: A specific folder on the server to upload the file to.
-- `--auth-code <code>`: Specific authCode for upload.
-
-## Example
-
-```bash
-cfib upload /path/to/my/image.png --origin "https://my-image-bed.com" --upload-auth-code "my-auth-code" --upload-token "my-token"
-```
-
-## Success Criteria
-The command outputs a JSON response. A successful upload will contain a `success: true` and the `data.src` / `data.url` pointing to the uploaded file.