\r \r

jisu-find-skill（技能查找）\r

\r ClawHub 上发现与安装技能；包名是 jisu-find-skill，请用 Python 跑 find_skills.py（不在 PATH 里当命令用）。\r \r

入口说明\r

\r

python3 skills/jisu-find-skill/find_skills.py installed\r
```\r
\r
目录可能是 `skills/` 或 `skill/`，按本仓库实际路径改。Windows 可用 `py` / `python`。\r
\r
## 做什么\r
\r
- **`search`**：调 `clawhub search`（含变体与解析）。**默认可读**（摘要 + 每条 `detail_line` / `description_line`，不整段贴 CLI 原始输出）；要结构化结果加 **`--json`**。默认对解析到的条目拉 ClawHub API，再按 **下载量 → 星标 → `match_score` → 名称** 排序后按 **`--limit`** 截断。**`--no-details`** 不拉 API，只按 `match_score` 截断。\r
- **`list`**：**`clawhub search jisuapi`**，默认可读；**`--json`** 输出完整 JSON。需本机有 `clawhub`。\r
- **其它**：`inspect` / `install` / `stats` / `verify` / `installed` 同样默认可读，**`--json`** 可切回机器格式。\r
\r
**不依赖**仓库内任何 Markdown 清单文件；极速相关能力请通过 ClawHub 与 `list`/`search` 自行发现。\r
\r
## 依赖与环境\r
\r
| 项 | 必需 | 说明 |\r
|----|------|------|\r
| `python3` | 是 | 运行脚本 |\r
| `clawhub` | 对 search/list 需要 | 否则 `search` 无结果、`list` 报错 |\r
\r
| 环境变量（可选） | 作用 |\r
|------------------|------|\r
| `OPENCLAW_SKILLS_DIR` | 已安装技能根目录，默认 `~/.openclaw/workspace/skills` |\r
\r
## 子命令\r
\r
| 子命令 | 说明 |\r
|--------|------|\r
| `search` | 默认可读；`--json` 结构化；默认拉 API 后按下载量排序再 `--limit`；`--no-details` 仅按匹配分；`--no-clawhub` 不调 CLI |\r
| `list` | `clawhub search jisuapi`；`--json` 输出 JSON |\r
| `inspect` | `clawhub inspect` |\r
| `stats` | ClawHub HTTP API |\r
| `install` | 默认 dry run，`--execute` 真装 |\r
| `verify` | 检查本机 `SKILL.md` |\r
| `installed` | 目录扫描 + 可选 `clawhub list` |\r
\r
## `search` 说明\r
\r
- **输入**：普通字符串、`{"q":"…"}`、`@文件`、stdin `-`。中文会拆 2/3 字做 slug 匹配分；发给 `clawhub` 仍是**原查询**。\r
- **默认拉 API**（`--no-details` 跳过）：`sort_by` 为 `downloads_stars_match_score`，否则 `match_score`。每条含 `detail`、`stars`、`downloads`、`description`（接口 `summary`）、`author` 及展示用 `detail_line` / `description_line`（缺省为 `—`）。**`merge_note`**、**`clawhub_queries_tried`** 便于排查；HTTP 次数约等于本次 CLI 解析条数。\r
- **展示序号**：**`name`** 为 `1、org/skill` 形式，**`sort_rank`** 从 1 起；**`clawhub_path`** / **`install_hint`** 无序号（供安装）。`list` 的 `results` 相同规则。\r
\r
展示示例（`detail_line` → `description_line`）：\r
\r
```text\r
1、jisu\r
星标: 12 | 下载: 340 | 作者: 极速数据 (@jisuapi)\r
描述: 提供所有的极速数据技能包，供选择使用。\r
```\r
\r
## 示例\r
\r
```bash\r
python3 skills/jisu-find-skill/find_skills.py search 天气 --limit 15          # 默认可读\r
python3 skills/jisu-find-skill/find_skills.py search 天气 --limit 5 --json   # 结构化\r
python3 skills/jisu-find-skill/find_skills.py search weather --no-details\r
python3 skills/jisu-find-skill/find_skills.py list\r
python3 skills/jisu-find-skill/find_skills.py list --json\r
python3 skills/jisu-find-skill/find_skills.py stats jisuapi/jisu-weather\r
```\r
\r
## 关于极速数据\r
\r
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r
\r
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息  \r
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测  \r
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询  \r
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别  \r
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令  \r
- **位置服务**：基站查询，经纬度地址转换，坐标系转换  \r
\r
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r