slug: free-ride name: "free-ride" version: 1.0.13 displayName: "免费版" summary: '"为SkillHub管理OpenRouter免费AI模型,零成本调用。Manages free AI models from OpenRouter for SkillHub。核心能力: - 集"' summary_zh: '"为SkillHub管理OpenRouter免费AI模型,零成本调用。Manages free AI models from OpenRouter for SkillHub。核心能力: - 集"' license: "MIT" description: [''集成工具领域的专业化AI辅助工具'']。"为SkillHub管理OpenRouter免费AI模型,零成本调用。Manages free。Use when 需要AI模型调用、智能对话、Agent编排、LLM应用时使用。不适用于需要100%确定性的关键决策。适用于独立开发者、企业团队和自动化工作流场景。 AI models from OpenRouter for SkillHub。核心能力: - 集"。"免费版"工具。支持自动化配置和灵活的参数设置,适适用于不同工作场景,改善操作效率。' 适用场景:
- 第三方API集成、平台对接、数据同步
- 独立开发者与一人公司效率提升
- 自动化工作流与智能决策辅助。Use when 需要AI模型调用、智能对话、Agent编排、LLM应用时使用。不适用于需要100%确定性的关键决策。 tags:
- Integrations
- 工具
- 效率
- free
- step
- ride
- api tools:
- read
- exec
- write homepage: '""' category: '"Automation"' homepage: "" pricing_tier: "free"
功能说明: 本技能涵盖 化工作流场景 等核心能力。
Free Ride
付费版扩展能力
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| Free RideSkillHub管理 | 不支持 | 支持 |
| 复杂工作流可视化编排 | 不支持 | 支持 |
| 条件分支与异常重试 | 不支持 | 支持 |
| 定时触发与事件驱动 | 不支持 | 支持 |
| 执行日志与审计追踪 | 不支持 | 支持 |
典型场景
| 场景 | 输入 | 输出 |
|---|---|---|
| 模型调用 | 输入文本与模型参数 | 模型输出与用量统计 |
| 管理操作 | 操作目标与参数 | 操作结果与状态变更 |
| 为SkillHub管 | 目标数据与配置参数 | 处理结果与执行状态 |
不适用于:需要人工判断的复杂决策场景
输入定义
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 否 | free-ride处理的内容输入 |
| mode | string | 否 | 处理模式, 可选: json/text/markdown, |
| max_retries | integer | 否 | 单步最大重试次数, 默认: 2 |
| skip_steps | array | 否 | 跳过的步骤编号(用于断点续传), 默认: [] |
输出规范
{
"success": true,
"data": {
"final_result": {
"ride_result": "ride_result_value",
"ride_metadata": "ride_metadata_value",
"ride_status": "ride_status_value"
},
"execution_log": [
{
"step": 1,
"name": "按流程执行",
"status": "completed",
"duration_ms": 1200,
"output_summary": "按流程执行"
},
{
"step": 2,
"name": "按流程执行",
"status": "completed",
"duration_ms": 3500,
"output_summary": "按流程执行"
},
{
"step": 3,
"name": "按流程执行",
"status": "completed",
"duration_ms": 2100,
"output_summary": "按流程执行"
},
{
"step": 4,
"name": "按流程执行",
"status": "completed",
"duration_ms": 800,
"output_summary": "按流程执行"
}
],
"total_duration_ms": 7600,
"gates_passed": 3,
"gates_total": 3
},
"error": null
}
中间产物模板参考: assets/free-ride_template
安装与配置
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
依赖说明(补充)
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
API Key 配置
可用性分类
- 分类: MD+execute()
- 说明: 基于Markdown的AI Skill,
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
功能边界
- 需要API Key,无Key环境无法使用
创新优势
效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 模型调用 | 30分钟 | 5分钟 | 25分钟 | 5% |
| 数据同步 | 2小时 | 30分钟 | 1.5小时 | 3% |
| 工作流管理 | 1小时 | 15分钟 | 45分钟 | 2% |
| 异常处理 | 2小时 | 30分钟 | 1.5小时 | 4% |
| 报告生成 | 1小时 | 10分钟 | 50分钟 | 1% |
差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 易用性 | 高 | 低 | 中 | 高 |
| 成本 | 低 | 高 | 中 | 高 |
| 效率 | 高 | 低 | 中 | 高 |
| 准确率 | 高 | 低 | 中 | 高 |
| 可定制性 | 中 | 低 | 高 | 高 |
核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 手动操作繁琐 | 需要大量人工操作,效率低下 | 整体工作效率 | 自动化处理,减少人工操作 | 时间节约25% |
| 数据同步困难 | 数据在不同系统间同步困难,影响决策 | 数据准确性 | 自动化数据同步,提高数据准确性 | 准确率提升3% |
| 工作流管理复杂 | 工作流管理复杂,难以维护 | 工作流效率 | 简化工作流管理,提高工作效率 | 时间节约45% |
常见问题FAQ
Q1: 免费版支持哪些AI模型?
A: 免费版支持OpenRouter提供的多种免费AI模型,包括文本分析、图像识别、语音识别等。
Q2: 如何在免费版中调用AI模型?
A: 在AI Agent对话中调用本技能,提供必要的输入参数,即可调用AI模型。
Q3: 免费版的调用频率有限制吗?
A: 免费版对调用频率没有限制,但可能会受到系统资源的影响。
Q4: 免费版支持断点续传吗?
A: 免费版支持断点续传功能,当操作中断时,可以继续执行,无需从头开始。
Q5: 免费版的数据安全性如何保障?
A: 免费版采用加密传输和存储,确保用户数据的安全性和隐私性。
诊断与修复
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| 调用失败 | 网络连接问题 | 检查网络连接,重试调用 | 确保网络连接正常 |
| 输出结果错误 | 输入数据格式错误 | 检查输入数据格式,提供正确格式 | 提供正确格式的输入数据 |
| 处理超时 | 系统资源不足 | 检查系统资源,优化处理流程 | 优化处理流程,增加系统资源 |
| 断点续传失败 | 缓存数据损坏 | 检查缓存数据,重新开始 | 清除旧缓存,重新开始 |
| 异常处理失败 | 异常处理逻辑错误 | 检查异常处理逻辑,修复错误 | 修复异常处理逻辑 |
安全规则
- 确保输入数据的安全性,避免敏感信息泄露。
- 定期更新AI模型,以保持模型的准确性和安全性。
- 限制对AI模型的访问权限,防止未授权访问。
- 对用户数据进行加密存储和传输,保护用户隐私。
- 监控系统日志,及时发现并处理异常情况。
安全风险防范
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
异常处理框架
针对"免费版"使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
"免费版"通用排查步骤
- 检查输入参数: 确认所有必填参数已提供且格式正确
- 查看日志输出: 定位具体错误行和异常类型
- 验证环境配置: 确认依赖库版本和运行环境满足要求
- 逐步调试: 缩小问题范围,隔离故障模块
上线流程
- 配置API密钥: 在环境变量中设置对应的API Key
- 初始化连接: 使用提供的凭证建立API连接
- 调用接口: 传入必要参数执行API调用
- 准备文件: 确认文件路径正确且格式受支持
- 执行处理: 调用对应的处理函数
- 查看结果: 检查输出文件或返回数据
- 检查环境: 确认运行时和依赖已安装
- 执行命令: 使用正确的参数格式执行
- 查看输出: 检查命令输出和退出码
前置条件
- 已安装所需运行环境(参考依赖说明)
- 已获取必要的API密钥或访问凭证(如适用)
- 输入数据已准备就绪