Appearance

常见问题 ​

Skill 安装 ​

如何安装 SolveX Skill？ ​

将 Agent 安装提示复制并发送给你的 AI Agent（如 Claude Code、Cursor 等），Agent 会自动执行安装命令并完成配置。

也可以手动运行安装命令：

bash
npx skills add solvex-top/solvex-skills@traffic-standards-kb -g -y

安装命令报错 "npx not found" 怎么办？ ​

该错误表示系统中未安装 Node.js 或 npm。请先安装 Node.js（推荐 18.x 或更高版本）：

  • macOS：brew install node
  • Ubuntu/Debian：sudo apt install nodejs npm
  • Windows：从 nodejs.org 下载安装包

安装完成后重新打开终端，再次运行安装命令。

如何更新已安装的 Skill？ ​

重新运行安装命令即可覆盖更新到最新版本：

bash
npx skills add solvex-top/solvex-skills@traffic-standards-kb -g -y

如何卸载 Skill？ ​

bash
npx skills remove solvex-top/solvex-skills@traffic-standards-kb -g

API Key 配置 ​

API Key 从哪里获取？ ​

  1. 访问 SolveX 开放平台 注册账号
  2. 登录后进入「API Key」页面
  3. 创建新的 API Key 并复制

详见 API Key 管理。

API Key 配置在哪里？ ​

API Key 需要配置在 Claude Code 的 ~/.claude/settings.json 文件的 env 字段中：

json
{
  "env": {
    "STANDARDS_API_KEY": "你的API Key"
  }
}

也可以导出为 shell 环境变量：

bash
export STANDARDS_API_KEY="你的API Key"

如何验证 API Key 是否有效？ ​

在终端中运行以下命令测试：

bash
curl -X POST https://solvexpert.net/api/v1/standards/query \
  -H "Authorization: Bearer 你的API Key" \
  -H "Content-Type: application/json" \
  -d '{"query": "信号灯设置规范", "limit": 1}'

返回正常结果即表示 API Key 有效。也可以直接让 Agent 用 Skill 查询一个简单问题来验证。

环境变量 ​

STANDARDS_API_KEY 未配置会怎样？ ​

Agent 在调用 Skill 时会收到 API 认证失败的错误提示。Skill 本身可以安装成功，但无法查询交通标准数据。需要先配置 STANDARDS_API_KEY 才能正常使用。

如何确认环境变量已生效？ ​

在终端中运行：

bash
echo $STANDARDS_API_KEY

如果输出你的 API Key 则已生效。Claude Code 用户可以让 Agent 检查 ~/.claude/settings.json 中的 env 字段。

使用问题 ​

如何判断 Skill 是否安装成功？ ​

让 Agent 用 Skill 查询一个交通标准问题（如「查询信号灯设置规范」），如果返回带标准编号和引用内容的格式化结果，则安装成功。

也可以检查 ~/.claude/skills/ 目录下是否存在对应的 Skill 文件。

Skill 调用返回空结果怎么办？ ​

  • 检查查询关键词是否与交通标准领域相关（信号控制、智能停车、V2X、ETC 等）
  • 尝试更具体的关键词，如「GB 14886 信号灯」
  • 确认 API Key 配额是否充足，详见 套餐方案
  • 如果问题持续，可能是后端服务暂时不可用，请稍后重试

一个 Agent 可以安装多个 Skill 吗？ ​

可以。每个 Skill 使用不同的安装命令独立安装，互不冲突。SolveX 后续将推出更多 Skill，可按需安装。

© 2024-2026 SolveX AI