---
description: 
alwaysApply: true
---

1. 写代码的时候要补充详细的中文注释（每个方法是干嘛的，为什么要这样写），如果是工作区，则所有项目都适用该规则
2. 注意不要生成太多的空行，上一部分代码和下一部分代码中间的空行不要大于2行
3. 有封装好的方法、组件需要复用，不要重复造轮子
4. 小程序端的抽屉全部需要用page-container来防止用户意外退出页面（记得使用v-if而不是v-show）
5. 数据库的（created_at、updated_at、deleted_at）统一使用时间戳，不要使用字符串，并且我在查询器中一级格式化成字符串了，无需再次格式化
6. 微信小程序 `.vue` 模板（会编译成 WXML）禁止使用 `??`、`?.` 等现代运算符，否则会报 `unexpected token '?'`；模板里用 `||` / 显式判断，脚本里可用 `??`/`?.`
7. 微信小程序模板里 `:class` / `:style` 禁止写 `fn(arg)` 方法调用（如 `:class="sexClass(p)"` 会编译失败）；用对象/数组字面量（如 `:class="{ male: p.sex == 1 }"`），或把结果先算进 data/computed 再绑定
8. 接口取值：写代码时先确认接口是 xk-api 还是 Yii，再固定用 `code/result/message` 或 `errcode/data/msg`（可用 `unwrapXkApi` / `unwrapYiiApi`）；禁止运行时猜测、禁止 `result || data`（详见 Api-Response.mdc）
9. 卡片强调样式：禁止用左侧竖色条（`border-left` 色条/左侧色块）做卡片强调或分类标识，统一用「1px 同色系边框 + 同色低透明度外发光（box-shadow 微光）」；历史页面暂不强制回改，新增/改动的卡片必须遵守
10. API 模块拆分：迁移到 xk-api 的接口和所有新增接口必须放 `request/api/<module>.js` 独立模块文件，禁止再往 `request/api/api.js` 大文件里新增（详见 Api-Module-Split.mdc）