KuteSmart 海外运营款式目录：按系列查询产品

解决的问题

在海外运营平台的产品运营场景里，「按系列查看对应款式产品」是款式目录维护、运营活动筛选、上新校验等任务的基础动作。如果把这类接口调用直接混进业务代码或上层 Agent 的流程里，容易出现参数位置不统一、环境地址被误改、登录态拼接重复、错误信息被吞掉等问题：一次看似简单的系列查询，可能因为 seriesId 传错位置、正式环境地址被用户输入覆盖，或者 accessToken 被重复加上 Bearer，导致查询失败、返回空列表，甚至拿到错误的分页数据，后续的运营决策也就失去了依据。

这个技能如何工作

这个技能只承担一个最小颗粒度的接口动作：styles_by_series。它封装了 KuteSmart 海外运营平台的款式目录查询能力，固定调用正式环境地址 GET https://www.kutetailor.com/api/style/style-info/getStylesBySeriesId，按系列 ID 查询对应的款式产品，并以 IPage 结构返回分页结果。

调用时，所有参数都收敛到嵌套的 params 对象里：seriesId 以及分页、筛选条件作为查询参数放入 params.query；登录态 token 放入 params.accessToken，由技能统一生成 Authorization: Bearer 头，如果传入的值已经包含 Bearer，就不会再重复拼接；需要额外指定的请求头放进 params.headers。技能会严格遵守接口契约：GET 请求的查询参数直接拼到 URL query，POST/PUT 默认提交 JSON body，接口地址以 frontmatter 里的 base_url 为准，不会被用户输入覆盖。

拿到结果后，技能会原样返回 IPage 数据，把分页信息、款式列表等字段交给上层 Agent 继续使用。如果接口返回认证失败、权限不足、参数错误或业务异常，技能会把原始错误码和错误信息透传给上层，方便定位是登录态、租户权限还是查询条件的问题。

适用边界与注意点

它是一个原子技能，只负责完成「根据系列查询产品」这一步接口调用，不负责库存、价格、订单、优惠或物流等后续数据补全。需要构建完整的款式目录业务链路时，要由上层 Agent 通过聚合技能或计划文档把多个原子技能编排起来。

使用时需要注意：接口返回是唯一的事实来源，不要根据这个技能的返回去推断或补造库存、价格、订单号等字段；它属于查询/计算类接口，但仍要遵守当前的登录态、租户和用户权限约束；另外，它依赖 styles_by_series 这个单一动作，如果业务需要按款式、分类等其他维度查询，需要使用其他对应的原子技能。