量迹CLI

它解决什么问题

让 AI Agent 直接调用量迹后端 API 时，常见的问题不是「有没有接口」，而是接口分散、认证体系混杂、端点行为不一致。量迹同时存在两套认证：X-API-Key 面向 MCP/Agent 永久有效，Bearer Token 面向网页端登录且只有 30 天有效期。如果混用这两套认证，或者不理解 API Key 的返回规则，Agent 很容易在第一次调用后就丢掉完整的 Key。

另一个问题是 Skill 上传链路不是普通 REST 调用：文件要先通过后端签发的 OSS 签名直传阿里云 OSS，再用 API Key 创建 Skill 记录，两个体系相互独立，缺一步就会失败。

技能如何工作

量迹CLI 把量迹后端 API 整理成可被 Agent 直接使用的调用方案，覆盖四个核心面：

• 用户认证：支持发送验证码、手机号登录，以及验证码登录并获取 API Key。MCP 场景必须使用 X-API-Key 认证。
• 商品与订单：包含商品列表、商品详情、创建订单、订单列表、订单详情、取消订单和小程序支付。
• 论坛社区：帖子列表支持 discussion、help、share、notice 四种分类，提供发帖、回复、修改、删除和详情查询。
• Skill 市场：支持搜索（可按 popular、newest、top-rated 排序）、详情、下载、点赞、收藏、评论、分类获取、推荐，以及「我发布的」和「我收藏的」查询。

MCP Server 暴露了一组工具，例如 quant_speed_get_profile、quant_speed_create_order、quant_speed_create_topic、quant_speed_search_skills、quant_speed_install_skill、quant_speed_publish_skill 等，让 AI 可以直接完成从查商品到发帖、装 Skill、发布 Skill 的完整流程。

Skill 上传需要两步：先获取 OSS 上传签名，再直传文件到 OSS，最后用 API Key 创建 Skill 记录。

配置通过环境变量管理，包括 QS_DJANGO_API_URL、QS_API_KEY、QS_TOKEN 和 QS_SKILL_DIR。

适用边界与注意点

API Key 只在首次生成或 force_regenerate=true 时返回完整内容。 如果 Key 已存在且未强制重新生成，接口只会返回提示，需要在网页端「个人设置」中查看和复制。

帖子修改和删除有明确权限：作者只能操作自己的帖子，管理员（is_staff=True）可以操作任意帖子；修改后帖子状态会变为 pending，需要重新审核通过后才恢复 published。

Skill 上传依赖 OSS 签名直传机制，与 MCP API Key 认证是两套独立体系，不能混用。

错误处理遵循标准 HTTP 状态码，例如 401 表示未登录或认证失败，403 表示权限不足，404 表示资源不存在。

这个技能适合需要把 Agent 接入量迹后端做认证、交易、社区和 Skill 管理的工程场景，不适合用来替代前端交互或绕过审核流程。