Menu
AnQiCMS 开发核心技能：模板语法规则、引擎说明（pongo2）、标签闭合规则、API 规范、数据模型
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | anqicms-dev |
| description | AnQiCMS 开发核心技能：模板语法规则、引擎说明（pongo2）、标签闭合规则、API 规范、数据模型 |
| category | Development |
| version | 1.1 |
| tags | ["anqicms","development","template","api","pongo2"] |
AnQiCMS 使用基于 github.com/flosch/pongo2 的 Django-like 模板引擎，语法与 Django/Jinja2 类似但有自定义扩充。
| 规则 | 说明 | 正确示例 | 错误示例 |
|---|---|---|---|
| 变量大小写 | 严格区分大小写，字段首字母大写 | {{ item.Title }} | {{ item.title }} |
| 时间格式 | 使用 Golang 参考时间（不是 PHP/Python 格式） | {{ stampToDate(item.CreatedTime, "2006-01-02") }} | {{ item.CreatedTime|date("Y-m-d") }} |
| 标签闭合 | 只有 BLOCK_TAGS 需闭合，SINGLE_TAGS 无需闭合 | {% archiveList %}...{% endarchiveList %} | 对 {% tdk %} 加 {% endtdk %} |
| 条件判断 | 用 elif 不是 elseif | {% elif cond %} | {% elseif cond %} |
| 空值判断 | 可用 {% if array %} 或 {% for %}...{% empty %}...{% endfor %} | ||
| 变量声明 | 获取数据时需声明变量名才能后续引用 | {% contact siteInfo %} | 不声明直接 {% if contact %} |
archiveList · categoryList · navList · pagination · tagList · bannerList · commentList · reviewList · if · for · block · with · autoescape · filter · ifchanged · ifequal · ifnotequal · macro · spaceless · pageList · prevArchive · nextArchive · breadcrumb · linkList · guestbook · archiveParams · tagDataList · archiveFilters · languages · jsonLd · comment · archiveSku
archiveDetail · categoryDetail · tagDetail · pageDetail · moduleDetail · userDetail · userGroupDetail · tdk · system · contact · diy · pluginJsCode · tr · lorem · now · set · include · extends · import · ssi · templatetag · widthratio · attachment · cycle · firstof · jump
完整说明请加载 template-dev 技能。
/api（如 https://domain.com/api/archive/list）Token: <token>，管理端用 Header Admin: <token>page、limit（默认10）、order（如 id desc）interface ApiResponse<T> {
code: number; // 0=成功，非0=错误
msg: string; // 错误消息
data: T; // 数据
total?: number; // 分页总数
}
关键规则：检查 code === 0，HTTP 200 不代表成功。code === 1001 表示 token 过期需重新登录。
| 模型 | 关键字段 |
|---|---|
| Archive（文章/产品） | id, title, cover, description, created_time(timestamp), views, category_id, tags, price, stock, url_token, seo_title |
| Category（分类） | id, title, parent_id, cover, url_token, type（1=分类，3=单页） |
| Order（订单） | id, order_no, amount, status（0=未支付,1=已支付,2=发货中,3=已完成,-1=已取消,9=已过期,4=已退款） |
| User（用户） | id, user_name, avatar_url, balance, phone, email |
template/your_template_name/
├── base.html # 基础布局（header/footer）
├── index/
│ └── index.html # 首页
├── article/ # 文章模型
│ ├── index.html # 文章首页（模型页）
│ ├── list.html # 文章列表
│ └── detail.html # 文章详情
├── product/ # 产品模型（有产品模型时）
│ ├── index.html
│ ├── list.html
│ └── detail.html
├── page/
│ ├── detail.html # 单页面
│ └── about.html # 自定义别名
├── search/
│ └── index.html # 搜索结果
├── tag/
│ ├── index.html # 标签云
│ └── list.html # 标签文档列表
├── comment/
│ └── list.html # 评论
├── guestbook/
│ └── index.html # 留言板
├── partial/ # 可复用片段
│ ├── header.html
│ ├── footer.html
│ └── sidebar.html
└── errors/
├── 404.html
├── 500.html
└── close.html # 站点关闭
{模型表名}/{文档ID}.html（如 article/10.html）{模型表名}/list-{分类ID或别名}.html（如 article/list-5.html）page/{别名}.html（如 page/about.html）CSS/JS/图片放在 /public/static/{your_template_name}/ 目录下，模板中通过 system 标签引用路径：
<link href="{% system with name='TemplateUrl' %}css/style.css" rel="stylesheet">
<script src="{% system with name='TemplateUrl' %}js/main.js"></script>
template_reload 生效skill_get 加载 template-dev 获取模板标签完整参考skill_get 加载 api-dev 获取完整的 API 端点列表AnQiCMS API 开发技能：全部 REST API 端点、请求/响应格式、认证流程、关键工作流。适用于前端对接和二次开发
批量操作技能：批量创建、修改、删除文档的流程指导，包括数据准备、分批执行和错误处理。
内容规划技能：制定内容发布计划、栏目内容策略、确定选题方向和发布频率。适用于内容运营和编辑。
SEO 分析技能：分析页面标题、关键词密度、内链外链结构、内容质量，并给出优化建议。适用于推广专员和网站管理员。
站点健康检查：检查站点配置、缓存状态、SEO设置、安全设置，发现潜在问题和优化空间。
AnQiCMS 模板开发技能：基于 pongo2（Django 语法）的自定义模板引擎，标签闭合规则完整速查