# 2026-08-04 工作记录

## 撰写《AI 辅助编程规范与实战示例》文档
- 应业主想了解"如何用 AI 编程"的需求，以 `src/views/base/cargo-type.vue`（货物类型模块）为实例，撰写对外说明文档。
- 产出文件：`/Users/gxwebsoft/VUE/tms-erp-web-ws/AI辅助编程规范与实战示例.md`
- 文档结构：协作流程总览 → AGENTS.md 规范条款 → cargo-type 模块实例拆解（三级文件分离、校验三处一致、审计字段用姓名、导入失败明细加工、样式规范）→ 人机协作人工兜底项 → 5 条经验 → 给业主的价值建议。
- 文档引用了真实代码片段：cargo-type.vue / option / api / utils/import-excel.js，强调需求卡 + AGENTS.md + 复用 utils 三件套作为"单一事实来源"。

## 生成 Word(.docx) 版本
- 用 docx-js（managed node workspace）将《AI 辅助编程规范与实战示例.md》转成 Word 文档：`/Users/gxwebsoft/VUE/tms-erp-web-ws/AI辅助编程规范与实战示例.docx`。
- 踩坑：docx-js 会在段落间注入非法空节点 `<0/>`（`<N/>`），导致 XML 不合法；后处理用正则剔除 `<\d+/>` 后重新校验通过。
- 生成脚本：`/Users/gxwebsoft/.workbuddy/binaries/node/workspace/gen_doc.js`（含标题/表格/代码块/项目符号样式）。

## 分页组件：上一页/下一页改为原生箭头图标
- 需求：全站不隐藏上一页/下一页，改显示原生箭头图标；首页/尾页保持不注入。
- 改动文件：`src/styles/element-ui.scss`（3 处历史遗留规则）、`src/utils/pagination.js`（注释同步）。
- 删除的遗留规则：①隐藏原生 `.el-icon` 箭头；②用 `::before` 注入「上一页/下一页」文字；③整体 `display:none` 隐藏 `.btn-prev/.btn-next`。首页/尾页仍由 pagination.js 增强器不注入，且各页面 layout 无 first/last。
- 效果：上一页/下一页显示 Element Plus 原生箭头（‹ ›），带边框与页码按钮视觉统一，hover 变主色，禁用态灰显。
