---
name: e10-utils-knowledge
description: Use when E10 frontend work mentions @weapp/utils, regOvProps, corsImport, WeappSDK, history or eventEmitter, 或涉及工具函数、SDK、跨应用加载、路由、运行环境、日期、国际化、安全、监控和组件复写。
---

# E10 Utils 知识库

选择或实现 E10 Utils 能力前，先使用本 Skill 自带检索，只加载最少必要上下文。

## 工作流程

1. 检索用户需求关键词：

```bash
node skills/e10-local-knowledge/modules/e10-utils-knowledge/scripts/search.mjs search "关键词" --limit 3
```

2. 精确命中导出符号或能力 ID 时，只加载摘要：

```bash
node skills/e10-local-knowledge/modules/e10-utils-knowledge/scripts/search.mjs load middleware --section summary
```

3. 用户需要代码或摘要不足以说明用法时，加载示例：

```bash
node skills/e10-local-knowledge/modules/e10-utils-knowledge/scripts/search.mjs load middleware --section example
```

4. 只有 `summary` 和 `example` 仍不足时，才加载 `all`。

每次加载最多返回 12288 bytes。

## 加载规则

- 检索候选最多保留三个。
- 精确导出符号优先于宽泛关键词匹配。
- 只有场景搜索存在歧义时才使用 `--category` 缩小范围。
- 禁止加载全部知识卡或全部 Utils 原始文档。
- 将知识卡作为选型证据，记录加载的能力 ID 和章节。
- 知识卡与项目规则冲突时，以项目前端 baseline 为准。

## E-Code 强制约束

- 业务接口请求使用 `devRequest`，不得使用 Utils `request`。
- 请求拦截器使用 `regApiInterceptor`。
- 不得绕过准入名单，也不得从前端直接调用 OpenAPI 或 `/openserver/`。
- 组件复写必须限定路由、业务 props 或稳定的 `weId` 后缀。
- 保持 PC/移动端、登录状态、租户范围和原组件行为边界。

## 资源说明

- `references/index.md`：分类和导出符号总览，仅在检索词不明确时读取。
- `references/categories/*.md`：分类路由，每个任务最多读取一个。
- `references/cards/*.md`：由脚本按需加载的精简能力卡。
- `scripts/search.mjs`：确定性的 `search` 和 `load` 接口。

输出检索词、候选、选中能力、加载章节，以及项目规则覆盖知识卡的情况。
