@agile-team/wl-skills-kit 2.3.0 → 2.3.2

package/files/.github/standards/06-security.md

@@ -1,44 +1,44 @@
-# 06 — 安全规范
-
-> **强制度**：🔴 必遵。
-
----
-
-## v-html 使用约束
-
-- ❌ 默认禁止 `v-html`
-- ✅ 仅当内容来源受控（如后端返回已消毒的富文本），且必须在使用处加注释说明来源：
-
-```vue
-<!-- v-html 安全声明：内容来自 /api/notice/detail，后端已做 XSS 过滤 -->
-<div v-html="notice.content" />
-```
-
-## Token 存储
-
-- ✅ 仅存 `sessionStorage` / `localStorage`
-- ❌ 禁止放在 URL 参数（被日志记录）
-- ❌ 禁止放在 `<meta>` 标签（HTML 静态可见）
-
-## 接口请求
-
-- ✅ 统一通过 `getAction / postAction / putAction / deleteAction` 走拦截器
-- ✅ 拦截器自动注入 token、统一处理 401 跳转
-- ❌ 禁止 `import axios from 'axios'` 直接使用
-
-## 用户输入
-
-- ✅ 通过接口参数对象传递
-- ❌ 禁止拼接到 URL 字符串
-- ❌ 禁止直接传给 SQL 语句生成函数（防 SQL 注入）
-
-## 对象遍历
-
-- ❌ 禁止 `for...in`（可能枚举原型链属性，存在安全隐患）
-- ✅ 使用 `Object.keys(obj).forEach()` / `Object.entries(obj)`
-
-## 危险 API
-
-- ❌ **禁止 `eval()`** —— 任何场景均不允许
-- ❌ 禁止 `new Function(string)` 动态执行字符串代码
-- ❌ 禁止 `setTimeout(string)` 字符串形式调用
+# 06 — 安全规范
+
+> **强制度**：🔴 必遵。
+
+---
+
+## v-html 使用约束
+
+- ❌ 默认禁止 `v-html`
+- ✅ 仅当内容来源受控（如后端返回已消毒的富文本），且必须在使用处加注释说明来源：
+
+```vue
+<!-- v-html 安全声明：内容来自 /api/notice/detail，后端已做 XSS 过滤 -->
+<div v-html="notice.content" />
+```
+
+## Token 存储
+
+- ✅ 仅存 `sessionStorage` / `localStorage`
+- ❌ 禁止放在 URL 参数（被日志记录）
+- ❌ 禁止放在 `<meta>` 标签（HTML 静态可见）
+
+## 接口请求
+
+- ✅ 统一通过 `getAction / postAction / putAction / deleteAction` 走拦截器
+- ✅ 拦截器自动注入 token、统一处理 401 跳转
+- ❌ 禁止 `import axios from 'axios'` 直接使用
+
+## 用户输入
+
+- ✅ 通过接口参数对象传递
+- ❌ 禁止拼接到 URL 字符串
+- ❌ 禁止直接传给 SQL 语句生成函数（防 SQL 注入）
+
+## 对象遍历
+
+- ❌ 禁止 `for...in`（可能枚举原型链属性，存在安全隐患）
+- ✅ 使用 `Object.keys(obj).forEach()` / `Object.entries(obj)`
+
+## 危险 API
+
+- ❌ **禁止 `eval()`** —— 任何场景均不允许
+- ❌ 禁止 `new Function(string)` 动态执行字符串代码
+- ❌ 禁止 `setTimeout(string)` 字符串形式调用

package/files/.github/standards/07-config.md

@@ -1,52 +1,52 @@
-# 07 — 配置管理规范
-
-> **强制度**：🔴 必遵。
-
----
-
-## 环境变量
-
-- 统一存放 `envs/.env.{mode}` 文件
-- 命名以 `VITE_` 开头（Vite 暴露给客户端的前缀）
-- 通过 `import.meta.env.VITE_XXX` 读取
-- ❌ 不硬编码环境相关值
-
-```typescript
-// ✅ 正确
-const apiBase = import.meta.env.VITE_API_URL;
-
-// ❌ 错误
-const apiBase = "http://10.0.0.5:8080/api";
-```
-
-## API 地址
-
-- ✅ 通过 `import.meta.env.VITE_API_URL` 等环境变量获取
-- ❌ 不在代码中硬编码 `http://` / `https://` 地址
-
-## 接口路径
-
-- ✅ 集中在 `data.ts` 的 `API_CONFIG` 对象中声明（`as const`）
-- ❌ 不散落在模板字符串、方法内部
-
-```typescript
-export const API_CONFIG = {
-  list: "/mmwr/customer/list",
-  save: "/mmwr/customer/save",
-  remove: "/mmwr/customer/remove",
-} as const;
-```
-
-## 敏感信息
-
-- ❌ 不提交到仓库（已纳入 `.gitignore`）
-- ✅ 团队共享走内部文档或专用密钥服务
-
-## AI 检查清单
-
-生成代码前，AI 必须确认：
-
-- [ ] 没有硬编码的 IP / 域名 / 端口
-- [ ] 所有 API 路径在 `API_CONFIG` 中声明
-- [ ] 环境变量都加了 `VITE_` 前缀
-- [ ] 没有把 token / secret / 密码以明文形式写入代码
+# 07 — 配置管理规范
+
+> **强制度**：🔴 必遵。
+
+---
+
+## 环境变量
+
+- 统一存放 `envs/.env.{mode}` 文件
+- 命名以 `VITE_` 开头（Vite 暴露给客户端的前缀）
+- 通过 `import.meta.env.VITE_XXX` 读取
+- ❌ 不硬编码环境相关值
+
+```typescript
+// ✅ 正确
+const apiBase = import.meta.env.VITE_API_URL;
+
+// ❌ 错误
+const apiBase = "http://10.0.0.5:8080/api";
+```
+
+## API 地址
+
+- ✅ 通过 `import.meta.env.VITE_API_URL` 等环境变量获取
+- ❌ 不在代码中硬编码 `http://` / `https://` 地址
+
+## 接口路径
+
+- ✅ 集中在 `data.ts` 的 `API_CONFIG` 对象中声明（`as const`）
+- ❌ 不散落在模板字符串、方法内部
+
+```typescript
+export const API_CONFIG = {
+  list: "/mmwr/customer/list",
+  save: "/mmwr/customer/save",
+  remove: "/mmwr/customer/remove",
+} as const;
+```
+
+## 敏感信息
+
+- ❌ 不提交到仓库（已纳入 `.gitignore`）
+- ✅ 团队共享走内部文档或专用密钥服务
+
+## AI 检查清单
+
+生成代码前，AI 必须确认：
+
+- [ ] 没有硬编码的 IP / 域名 / 端口
+- [ ] 所有 API 路径在 `API_CONFIG` 中声明
+- [ ] 环境变量都加了 `VITE_` 前缀
+- [ ] 没有把 token / secret / 密码以明文形式写入代码

package/files/.github/standards/08-git.md

@@ -1,60 +1,60 @@
-# 08 — Git 分支 & 提交规范
-
-> **强制度**：🔴 必遵。
-> 本项目强制使用 `@robot-admin/git-standards`（commitlint + cz-customizable + husky）。
-
----
-
-## 分支命名
-
-```
-feat/xxx       新功能
-fix/xxx        Bug 修复
-refactor/xxx   重构
-docs/xxx       文档更新
-chore/xxx      构建/工具变更
-perf/xxx       性能优化
-test/xxx       测试相关
-```
-
-## 提交方式（强制）
-
-```bash
-git add .
-git cz   # 交互式选择 type + scope + 描述
-```
-
-❌ **禁止**：`git commit -m "xxx"` 直接提交（绕过规范校验）
-
-## 提交类型（type）枚举
-
-`feat` / `fix` / `perf` / `docs` / `style` / `refactor` / `test` / `chore` / `revert` / `build` / `deps` / `wip`
-
-## scope 强制要求
-
-提交时必须填写影响范围，格式：`type(scope): 中文描述`
-
-```
-feat(mmwr-customer): 新增客户档案页面
-fix(domestic-trade): 修复订单状态切换闪烁
-refactor(c_formModal): 重构表单回填逻辑
-```
-
-## husky 钩子未生效时
-
-1. 检查 `@robot-admin/git-standards` 是否已执行 `init`
-2. 检查 `.husky/` 目录及 `pre-commit`、`commit-msg` 钩子文件
-3. 联系 CHENY（工号 409322）
-
-## AI 生成 commit message 参考
-
-AI 在协助提交时，按以下格式输出建议：
-
-```
-feat(模块名): 中文描述
-
-- 变更点 1
-- 变更点 2
-```
-
-不主动执行 `git commit`，由开发者通过 `git cz` 交互式确认。
+# 08 — Git 分支 & 提交规范
+
+> **强制度**：🔴 必遵。
+> 本项目强制使用 `@robot-admin/git-standards`（commitlint + cz-customizable + husky）。
+
+---
+
+## 分支命名
+
+```
+feat/xxx       新功能
+fix/xxx        Bug 修复
+refactor/xxx   重构
+docs/xxx       文档更新
+chore/xxx      构建/工具变更
+perf/xxx       性能优化
+test/xxx       测试相关
+```
+
+## 提交方式（强制）
+
+```bash
+git add .
+git cz   # 交互式选择 type + scope + 描述
+```
+
+❌ **禁止**：`git commit -m "xxx"` 直接提交（绕过规范校验）
+
+## 提交类型（type）枚举
+
+`feat` / `fix` / `perf` / `docs` / `style` / `refactor` / `test` / `chore` / `revert` / `build` / `deps` / `wip`
+
+## scope 强制要求
+
+提交时必须填写影响范围，格式：`type(scope): 中文描述`
+
+```
+feat(mmwr-customer): 新增客户档案页面
+fix(domestic-trade): 修复订单状态切换闪烁
+refactor(c_formModal): 重构表单回填逻辑
+```
+
+## husky 钩子未生效时
+
+1. 检查 `@robot-admin/git-standards` 是否已执行 `init`
+2. 检查 `.husky/` 目录及 `pre-commit`、`commit-msg` 钩子文件
+3. 联系 CHENY（工号 409322）
+
+## AI 生成 commit message 参考
+
+AI 在协助提交时，按以下格式输出建议：
+
+```
+feat(模块名): 中文描述
+
+- 变更点 1
+- 变更点 2
+```
+
+不主动执行 `git commit`，由开发者通过 `git cz` 交互式确认。

package/files/.github/standards/09-typescript.md

@@ -1,71 +1,71 @@
-# 09 — TypeScript 类型规范
-
-> **强制度**：🟡 建议。
-> 项目使用 `strict: false` 宽松模式起步。
-
----
-
-## 类型定义优先级
-
-- **`interface`**：可扩展的对象类型
-- **`type`**：联合类型 / 工具类型 / 字面量类型
-
-```typescript
-// ✅ interface 用于对象
-interface User {
-  id: string;
-  name: string;
-}
-
-// ✅ type 用于联合 / 工具类型
-type Status = "pending" | "active" | "closed";
-type PartialUser = Partial<User>;
-```
-
-## any 使用约束
-
-❌ 禁止滥用 `any`。`as any` 仅允许出现在以下场景：
-
-1. 对接外部 SDK 返回值的边界处
-2. `AbstractPageQueryHook.create()` 的返回值接收（框架限制）
-3. 确实无法确定类型时，加注释 `// TODO: 待补充类型`
-
-```typescript
-// ✅ 允许（框架限制）
-return Page.create() as any
-
-// ✅ 允许（外部边界，加注释）
-const sdkResult = thirdPartySdk.call() as any // TODO(cheny): SDK 1.5 后补充类型
-
-// ❌ 禁止（懒省事）
-function handleClick(row: any) { ... }
-```
-
-## 类型导入
-
-- 业务类型统一从 `@/types/page` 桶文件引入
-- ❌ 不重复定义同名类型
-- ✅ 复杂类型在 `@/types/` 下分文件管理
-
-## 字段类型
-
-- 业务字段优先用 `string` / `number` / `boolean`
-- ❌ 不默认用 `any`
-- ⚠️ 可选字段用 `?`，可空字段用 `| null`
-
-```typescript
-interface Customer {
-  id: string;
-  name: string;
-  remark?: string; // 可选
-  closedAt: string | null; // 可空（后端明确返回 null）
-}
-```
-
-## 与 @robot-admin/git-standards 兼容
-
-| 项目状态             | 处理                                       |
-| -------------------- | ------------------------------------------ |
-| 已有 `tsconfig.json` | ✅ 直接安装 git-standards，零冲突          |
-| 无 TS 环境           | 先 `tsc --init` 初始化，再装 git-standards |
-| ESLint TS 规则       | `warn` 级别，不阻断提交，仅作质量提示      |
+# 09 — TypeScript 类型规范
+
+> **强制度**：🟡 建议。
+> 项目使用 `strict: false` 宽松模式起步。
+
+---
+
+## 类型定义优先级
+
+- **`interface`**：可扩展的对象类型
+- **`type`**：联合类型 / 工具类型 / 字面量类型
+
+```typescript
+// ✅ interface 用于对象
+interface User {
+  id: string;
+  name: string;
+}
+
+// ✅ type 用于联合 / 工具类型
+type Status = "pending" | "active" | "closed";
+type PartialUser = Partial<User>;
+```
+
+## any 使用约束
+
+❌ 禁止滥用 `any`。`as any` 仅允许出现在以下场景：
+
+1. 对接外部 SDK 返回值的边界处
+2. `AbstractPageQueryHook.create()` 的返回值接收（框架限制）
+3. 确实无法确定类型时，加注释 `// TODO: 待补充类型`
+
+```typescript
+// ✅ 允许（框架限制）
+return Page.create() as any
+
+// ✅ 允许（外部边界，加注释）
+const sdkResult = thirdPartySdk.call() as any // TODO(cheny): SDK 1.5 后补充类型
+
+// ❌ 禁止（懒省事）
+function handleClick(row: any) { ... }
+```
+
+## 类型导入
+
+- 业务类型统一从 `@/types/page` 桶文件引入
+- ❌ 不重复定义同名类型
+- ✅ 复杂类型在 `@/types/` 下分文件管理
+
+## 字段类型
+
+- 业务字段优先用 `string` / `number` / `boolean`
+- ❌ 不默认用 `any`
+- ⚠️ 可选字段用 `?`，可空字段用 `| null`
+
+```typescript
+interface Customer {
+  id: string;
+  name: string;
+  remark?: string; // 可选
+  closedAt: string | null; // 可空（后端明确返回 null）
+}
+```
+
+## 与 @robot-admin/git-standards 兼容
+
+| 项目状态             | 处理                                       |
+| -------------------- | ------------------------------------------ |
+| 已有 `tsconfig.json` | ✅ 直接安装 git-standards，零冲突          |
+| 无 TS 环境           | 先 `tsc --init` 初始化，再装 git-standards |
+| ESLint TS 规则       | `warn` 级别，不阻断提交，仅作质量提示      |

package/files/.github/standards/10-pinia.md

@@ -1,57 +1,57 @@
-# 10 — Pinia 状态管理规范
-
-> **强制度**：🔴 必遵。
-
----
-
-## 何时用 Store
-
-- ✅ 跨页面共享：用户信息、权限、全局配置、主题
-- ✅ 需要持久化到 `localStorage` 的状态
-- ✅ 多个不相邻组件共享的会话级状态
-
-## 何时不用 Store（保留页面级 ref）
-
-- ❌ 当前页的查询参数、列表数据、分页、弹窗状态
-- ❌ data.ts 内部的所有状态（默认页面级，不提升到 Store）
-
-## 强制约束
-
-❌ **禁止**：在 `data.ts` 里 `import` Store
-
-> 理由：data.ts 是**页面数据契约**，应保持职责单一，不依赖全局状态。
-> 跨页面共享数据通过 props / 路由参数 / 组件层包装传入，不直接耦合 Store。
-
-## Store 文件结构
-
-```
-src/stores/
-└── {domain}/
-    └── index.ts        每个领域独立目录，避免单文件膨胀
-```
-
-## Store 命名
-
-- `useXxxStore` 标准命名
-- 若项目已统一 `s_` 前缀（如 `s_userStore`），全项目保持一致
-
-```typescript
-// src/stores/user/index.ts
-export const useUserStore = defineStore("user", () => {
-  const userInfo = ref<User | null>(null);
-  function setUser(u: User) {
-    userInfo.value = u;
-  }
-  return { userInfo, setUser };
-});
-```
-
-## 持久化
-
-如需持久化，推荐 `pinia-plugin-persistedstate`：
-
-```typescript
-defineStore('user', () => { ... }, {
-  persist: { storage: localStorage, paths: ['userInfo'] }
-})
-```
+# 10 — Pinia 状态管理规范
+
+> **强制度**：🔴 必遵。
+
+---
+
+## 何时用 Store
+
+- ✅ 跨页面共享：用户信息、权限、全局配置、主题
+- ✅ 需要持久化到 `localStorage` 的状态
+- ✅ 多个不相邻组件共享的会话级状态
+
+## 何时不用 Store（保留页面级 ref）
+
+- ❌ 当前页的查询参数、列表数据、分页、弹窗状态
+- ❌ data.ts 内部的所有状态（默认页面级，不提升到 Store）
+
+## 强制约束
+
+❌ **禁止**：在 `data.ts` 里 `import` Store
+
+> 理由：data.ts 是**页面数据契约**，应保持职责单一，不依赖全局状态。
+> 跨页面共享数据通过 props / 路由参数 / 组件层包装传入，不直接耦合 Store。
+
+## Store 文件结构
+
+```
+src/stores/
+└── {domain}/
+    └── index.ts        每个领域独立目录，避免单文件膨胀
+```
+
+## Store 命名
+
+- `useXxxStore` 标准命名
+- 若项目已统一 `s_` 前缀（如 `s_userStore`），全项目保持一致
+
+```typescript
+// src/stores/user/index.ts
+export const useUserStore = defineStore("user", () => {
+  const userInfo = ref<User | null>(null);
+  function setUser(u: User) {
+    userInfo.value = u;
+  }
+  return { userInfo, setUser };
+});
+```
+
+## 持久化
+
+如需持久化，推荐 `pinia-plugin-persistedstate`：
+
+```typescript
+defineStore('user', () => { ... }, {
+  persist: { storage: localStorage, paths: ['userInfo'] }
+})
+```