> For the complete documentation index, see [llms.txt](https://en-ascent.webvista.studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://en-ascent.webvista.studio/ascent-mu-ban-shi-yong-shuo-ming/qi-ta/ban-ben-shuo-ming/v3.1.0-ji-jiang-fa-bu.md).

# v3.1.0（即将发布）

本次更新重点提升 **AI 友好的店铺内容识别能力**、视觉自定义能力和购物体验细节。Ascent 现在可以向搜索引擎、AI 搜索工具和 AI 问答工具提供更清晰的页面信号，同时为横幅、卡片、倒计时、商品板块和信任信息提供更多样式控制。

#### 新增

* 增强商品、分类、博客、文章、页面、品牌信息、社交主页和分享预览的 **AI 友好识别信号**
* 板块标题新增更多设计选项，包括装饰图标和斜体文字渐变效果
* 更多板块新增容器阴影和渐变边框设置，包括 Countdown、Text with icons、Quote 和 Search banner
* Collection、Featured collection、Related products、Recently viewed products 等商品卡片场景新增边框设置
* Main cart 横幅新增背景图、横幅高度、图片透明度和图片动效设置
* Image gallery 图片块新增边框、卡片阴影、圆形箭头按钮和更灵活的标题按钮位置
* Text with icons 新增全宽布局、容器阴影、板块边框、图标边框和手机端轮播优化
* 新增开发者文档，说明如何让自定义 Add to cart 按钮打开原生购物车抽屉、如何用 JavaScript 刷新购物车界面，以及如何精简 `metafields.shopify` 翻译

#### 优化

* 重设计 Countdown 板块默认内容和样式，支持图标选择、caption、heading、description、紧凑倒计时卡片、手机端间距优化，以及可选阴影和边框
* 优化 Mega Menu Featured image，改进文字渐变遮罩、描述文字、标题装饰线和紧凑圆形按钮
* 优化商品页 Payment and security 布局，包括信任徽章尺寸、支付图标排列、标题图标和文字间距
* 优化博客卡片，包含更清晰的摘要、紧凑箭头按钮、横置卡片标题字号，以及图片徽章数量限制
* 优化 Rich text 及相关内容块，改进内容宽度、图片块尺寸、浅色文字设置和 Highlight stats 容器样式
* 优化多个板块的标题设置一致性，包括渐变标题效果，以及仅在显示板块标题时展示相关装饰设置
* 优化购物车抽屉、搜索抽屉、推荐卡片、迷你结账、到店取货信息、筛选项、已选筛选、徽章、博客标签、社交图标、工具栏和页眉子菜单样式

#### 修复及其他改进

* 减少重复或不清晰的结构化信号，帮助 AI 工具和搜索引擎更准确理解店铺内容
* 修复部分卡片和玻璃效果容器中由动画包裹层导致的布局问题
* 优化卡片、媒体、横幅、商品模块和抽屉中的模糊、阴影、边框和圆角表现
* 优化手机端倒计时尺寸和间距，避免在订阅弹窗和板块布局中溢出
* 优化轮播和触摸板滑动体验，让切换更加顺滑
* 全面提升主题的 UI 一致性、视觉细节和店铺前台稳定性


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://en-ascent.webvista.studio/ascent-mu-ban-shi-yong-shuo-ming/qi-ta/ban-ben-shuo-ming/v3.1.0-ji-jiang-fa-bu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.