@mingfuyun/star-allinone 0.4.4 → 0.4.5

package/README.md

@@ -9,6 +9,7 @@
 | 弹层 overlays | `import { CustomDrawer, BaseModal, HocModal } from '@mingfuyun/star-allinone'` | 不要从 `@/components/CustomDrawer` 抄一份 |
 | 错误边界 | `import { ErrorBoundary } from '@mingfuyun/star-allinone'` | — |
 | Cron | `import { Cron } from '@mingfuyun/star-allinone'` | — |
+| 埋点运行时 | `import { createTracking, getTrackData, TRACKING_REPORT_URLS } from '@mingfuyun/star-allinone'` | SDK 脚本只从 OSS 加载，见 [埋点接入](#-埋点接入) |
 | 管理列表表格 | `import MFProTable from '@/components/CommonTable/MFProTable'` | **没有** `MFTablePro`。不要从本包 import 表格 |
 | 请求 | `import Service from '@/services'`（内部 `MFRequest`） | 页面不要直接 axios |
 
@@ -123,6 +124,10 @@ git commit -m "chore(skill): 接入公共 skill"
 使用 $shared-publish-test，把当前分支发布到测试环境。
 ```
 
+```text
+使用 $shared-tracking，为本项目接入埋点并全站补齐按钮埋点。
+```
+
 公共流程用 `shared-*`，项目专属规则用 `custom-*`。`custom-*` 不能再实现一遍 Service/页面生成/审查。全量契约重建若需要，写成不可调用的脚本，并在 `AGENTS.md` 写命令。业务定制需要复用公共流程时，读取对应的 `.agents/skills/shared-*/SKILL.md`，不要再抛一个入口。
 
 ### 业务项目：更新公共 skill
@@ -154,6 +159,138 @@ import { CustomDrawer, HocModal } from '@mingfuyun/star-allinone';
 
 完整 props 合同见同步后的 `.agents/skills/shared-project-conventions/references/mfprotable.md`。
 
+## 📊 埋点接入
+
+星系管理端统一埋点。运行时依赖本包的 `createTracking`；SDK 从 OSS 加载，**不要**提交进业务仓库或打进 webpack。
+
+**能力包要求：** **≥ 0.4.0**（含 `createTracking`、`TRACKING_REPORT_URLS`、`CustomDrawer` 的 `cancelTrack` / `okTrack`）。
+
+**Agent Skill：** 业务项目 `skills sync` 后，在对话里触发 `$shared-tracking`。基础设施、全站按钮埋点、验证均由 Agent 完成，**不需要**开发者手工改 `tracking/index.ts`、`app.tsx`、各页 `const.tsx`。
+
+完整 Skill 规范见 [skills/shared/tracking/SKILL.md](skills/shared/tracking/SKILL.md)（同步后为 `.agents/skills/shared-tracking/SKILL.md`）。
+
+### 用户只需做 2 件事
+
+**1. 安装能力包并同步 Skill**
+
+```bash
+pnpm add @mingfuyun/star-allinone@^0.4.5
+pnpm exec star-allinone skills sync
+```
+
+**2. 在 Cursor / Codex 触发 Skill**
+
+```text
+使用 $shared-tracking，为本项目接入埋点并全站补齐按钮埋点。
+```
+
+之后由 Agent 改代码、跑 `pnpm typecheck`、汇报已覆盖文件。
+
+**前置条件（平台侧）：** 埋点平台已登记 `appId`（测试 `test-<project>`，生产 `<project>`，与 `.star-allinone.json` 的 `project` 一致）。
+
+**提交：** 确认 Agent 改动后，用 `$shared-review-and-submit` 审查并提交。
+
+### `$shared-tracking` 会自动完成
+
+| Skill 步骤 | Agent 做什么 |
+| --- | --- |
+| 配置 tracking | 新建 `src/utils/tracking/index.ts`（`createTracking`、`getTrackData` 等） |
+| 加载 SDK | 在 Umi `headScripts` 插入 OSS 内联脚本 |
+| 应用初始化 | 改 `src/app.tsx`：`markTrackingReady`、`syncTrackingRoute` |
+| 接口失败上报 | 改 `src/services/request.tsx`：失败时 `reportApiTracking` |
+| 全站按钮埋点 | 扫描页面，补齐五类按钮以及 **带 `onClick` 的 `a` / `div` / `span` 等** |
+| 验证 | 跑 `pnpm typecheck`；必要时说明浏览器验收项 |
+
+非默认 import 路径时，Agent 可读 `.star-allinone.json` 的 `trackingModule`（如 `@/utils/tracking`）。
+
+### 哪些按钮会自动 / 半自动加上埋点
+
+**A. 完全自动（`MFProTable` 组件内）**
+
+| 按钮 | 说明 |
+| --- | --- |
+| 列表 **查询** | `filter_query` / `查询` |
+| 列表 **重置** | `filter_reset` / `重置` |
+
+页面 `const.tsx` **不要重复**写查询/重置的 `track`。
+
+**B. `gen page` 自动生成**（需已有 `src/utils/tracking/index.ts`）
+
+| 位置 | 生成内容 |
+| --- | --- |
+| `const.tsx` 工具栏 | 「新增」→ `track` |
+| `const.tsx` 操作列 | 「编辑」「删除」→ `track` |
+| `*Drawer.tsx` | `cancelTrack` / `okTrack` |
+| `*ConfirmModal.tsx` | 确认框 `data-track` |
+
+跳过：`gen page ... --no-tracking`。不会自动生成：复制、批量、自定义 footer、独立权限按钮、带 submitter 的 ProForm。
+
+**C. Agent 全站补齐**（`$shared-tracking` / `$shared-design-to-page`）
+
+| # | 按钮类型 | 典型位置 |
+| --- | --- | --- |
+| 1 | 权限相关 | `toolBarRender`、`withAuth(Button)`、`TablePermissionActions` |
+| 2 | 抽屉 / 弹层 | `CustomDrawer`、`BaseModal`（含 `HocModal`） |
+| 3 | 表格操作列 | `actionColumn`、`TableActions` |
+| 4 | 表单提交/重置 | `ProForm` submitter、`Form` 按钮 |
+| 5 | 复制 | 操作列、工具栏、「复制 IP」等 |
+| 6 | 带 `onClick` 的元素 | `a`、`div`、`span`、`Typography.Link`、可点击卡片 |
+
+**不上报：** 列设置、表格「更多」省略号 icon（菜单内各项仍要 track）、无权限未渲染的按钮、**没有** `onClick` 的纯展示节点。
+
+### 按钮写法速查
+
+```tsx
+import { getTrackData } from '@/utils/tracking';
+
+// 工具栏
+track: getTrackData('create', '新增', { key: 'toolbar', name: '工具栏' })
+
+// 操作列
+track: getTrackData('edit', '编辑', { key: 'action', name: '操作' })
+
+// 抽屉默认底部
+<CustomDrawer
+  cancelTrack={getTrackData('cancel', '取消', { key: 'editor', name: '用户管理' })}
+  okTrack={getTrackData('confirm', '确定', { key: 'editor', name: '用户管理' })}
+/>
+
+// 带 onClick 的 a / div / span
+<a
+  data-track={getTrackData('view_detail', '查看详情', { key: 'cell', name: '名称' })}
+  onClick={() => handleView(record)}
+>
+  {record.name}
+</a>
+```
+
+点击由 SDK 监听 `data-track`，**不要在** `onClick` 里再调 `track()`。
+
+### 接入流程
+
+```text
+【用户】pnpm add + skills sync
+        ↓
+【用户】对话：$shared-tracking 接入并全站补齐
+        ↓
+【Skill】tracking 配置 + SDK + app.tsx + request + 全站按钮 track
+        ↓
+【Skill】pnpm typecheck + 汇报改动范围
+        ↓
+【用户】$shared-review-and-submit 确认并提交
+```
+
+新建列表页可用 `$shared-design-to-page`（内部 `gen page` 带默认 track，Skill 再补复制/批量等）。
+
+### 不要做的事
+
+- 不要把 `tracking-sdk.global.min.js` 提交到 Git
+- 不要把 SDK 打进 webpack
+- 不要只接 SDK 不补按钮埋点
+- 不要上报成功请求
+
+更多细节见 [skills/shared/tracking/SKILL.md](skills/shared/tracking/SKILL.md)。
+
 ## 🚀 快速开始
 
 ### 基础使用

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mingfuyun/star-allinone",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "星系运维前端能力包",
   "main": "dist/index.js",
   "bin": {

package/skills/README.md

@@ -127,7 +127,7 @@ git commit -m "chore(skill): 更新公共 skill"
 | `shared-design-to-page` | 页面：标准列表内部 `gen page`，其余按设计稿实现 |
 | `shared-review-and-submit` | 审查并提交 |
 | `shared-publish-test` | 测发 |
-| `shared-tracking` | 埋点：升级能力包、加载 OSS 脚本、初始化、失败上报、按钮 `data-track` |
+| `shared-tracking` | 埋点接入与全站可点击补齐（含 onClick 的 a/div/span） |
 
 ## 公共规则写在哪里
 
@@ -137,7 +137,7 @@ git commit -m "chore(skill): 更新公共 skill"
 | `shared-design-to-page` | SKILL + `page-conventions.md`、`overlays.md`、`list-page-template.md`、`tracking.md` | 页面分层、标准列表 CLI、弹层合同、按钮埋点 |
 | `shared-review-and-submit` | SKILL + `impact-analysis.md`、`verify.md`、`ai-review.md`、`commit.md` | 影响分析 → 验证（含埋点完整性）→ 确认后提交 |
 | `shared-publish-test` | SKILL + `scripts/publish-current-branch.sh` | 云效测发；只读 `publishPipelineId` |
-| `shared-tracking` | SKILL | 埋点接入：能力包版本、配置文件、脚本、初始化、失败上报、权限按钮、操作列、抽屉弹层、表单按钮 |
+| `shared-tracking` | [SKILL.md](./shared/tracking/SKILL.md) | 埋点接入：业务接入、五类按钮、带 onClick 的 a/div/span |
 | （非入口）`shared-project-conventions` | `architecture.md`、`mfprotable.md`、`component-contract.md`、`review-checklist.md`（含埋点审查）、`quality-checklist.md` | 架构、导入合同、质量清单 |
 | （非入口）`shared-i-have-adhd` | `i-have-adhd.md` | 用户输出格式 |
 

package/skills/shared/design-to-page/SKILL.md

@@ -52,7 +52,7 @@ Add `--permission-create`, `--permission-edit`, `--permission-delete` when codes
 3. The CLI fills columns and drawer fields from the OpenAPI schema (required, enum → `ProFormSelect`, dates/numbers). Review labels and permission codes; do not recreate the file tree. See [references/list-page-template.md](references/list-page-template.md).
 4. If `src/components/Page/Container/config.tsx` exists, `gen page` writes a Container `index.tsx`, puts the table in `components/List.tsx`, and registers a Tab with `loader: () => import(...)`. Do not invent a second page shell.
 5. Do not overwrite existing page files. Tell the user the CLI refused, then edit in place.
-6. **Tracking:** When the project has tracking configured, `gen page` auto-wires default button tracking. Agent must scan and wire **all** in-scope buttons per [references/tracking.md](references/tracking.md) and `$shared-tracking` (permission, drawer/modal footers, action column, ProForm, copy)—do not leave manual steps for the user. If tracking is not set up yet, tell the user to run `$shared-tracking` first; do not invent a second tracking helper.
+6. **Tracking:** When the project has tracking configured, `gen page` auto-wires default button tracking. Agent must scan and wire **all** in-scope clickables per [references/tracking.md](references/tracking.md) and `$shared-tracking` (permission, drawer/modal footers, action column, ProForm, copy, **`onClick` on `a` / `div` / `span`**)—do not leave manual steps for the user. If tracking is not set up yet, tell the user to run `$shared-tracking` first; do not invent a second tracking helper.
 
 ## Design path
 
@@ -65,7 +65,7 @@ For non-standard layouts:
 5. API-backed pages include types, `MFRequest` methods, aggregate exports, and page consumption in the same change. Use `.agents/skills/shared-api-to-service/SKILL.md` for missing services. Use `.agents/skills/shared-api-to-service/references/mock.md` for extra mock scenarios. Do not embed production fake data.
 6. Compare desktop and narrow layouts against the design. Fix structure and spacing before decoration.
 7. Run focused verification. Do not claim visual fidelity without inspecting the rendered page.
-8. When tracking is enabled, Agent applies [references/tracking.md](references/tracking.md) for every toolbar, action, copy, drawer, confirm, form submit, and standalone permission button on the page.
+8. When tracking is enabled, Agent applies [references/tracking.md](references/tracking.md) for every toolbar, action, copy, drawer, confirm, form submit, standalone permission button, and **`onClick` on `a` / `div` / `span` / links**.
 
 ## Hard rules
 
@@ -79,7 +79,7 @@ For non-standard layouts:
 - Do not use `Modal.confirm` or feature-level Ant Design `Modal` / `Drawer` shells.
 - Do not add a UI library, state library, or CSS-in-JS system without approval.
 - Do not refactor unrelated code.
-- When `src/utils/tracking/index.ts` exists, Agent wires `getTrackData` on every button covered by [references/tracking.md](references/tracking.md) (including copy). Do not call `track()` in handlers. Do not ask the user to add tracks manually.
+- When `src/utils/tracking/index.ts` exists, Agent wires `getTrackData` on every control covered by [references/tracking.md](references/tracking.md), including copy and **any `onClick` on `a` / `div` / `span` / links**. Do not call `track()` in handlers. Do not ask the user to add tracks manually.
 
 ## Verification
 
@@ -90,7 +90,7 @@ pnpm typecheck
 
 Run `pnpm lint` for broad or shared changes. Run the project's documented build command when routes, entry, or multiple pages change.
 
-When tracking is configured, scan changed page files: toolbar `track`, action `track`, copy `track`, drawer `cancelTrack` / `okTrack` or custom-footer `data-track`, confirm modal buttons, ProForm submitters, and standalone permission buttons. Agent fixes missing wiring before calling the page done; do not defer to the user.
+When tracking is configured, scan changed page files: toolbar `track`, action `track`, copy `track`, drawer `cancelTrack` / `okTrack` or custom-footer `data-track`, confirm modal buttons, ProForm submitters, standalone permission buttons, and **`onClick` on `a` / `div` / `span` / `Typography.Link`**. Agent fixes missing wiring before calling the page done; do not defer to the user.
 
 ## User-facing output
 

package/skills/shared/design-to-page/references/tracking.md

@@ -2,7 +2,7 @@
 
 Apply when the business project already has `src/utils/tracking/index.ts` (or the path documented in project conventions). Full SDK setup and **Agent 全站批量补齐规则** live in `.agents/skills/shared-tracking/SKILL.md`. This file covers **page / 生成场景**。
 
-**Agent 规则：** 生成或修改页面时，由 Agent 写入全部按钮埋点，**不要**留给用户手工补。与「接入埋点」同一套五类扫描标准（含复制按钮）。
+**Agent 规则：** 生成或修改页面时，由 Agent 写入全部可点击埋点，**不要**留给用户手工补。与「接入埋点」同一套扫描标准：五类按钮 + **任何带 `onClick` 的元素**（`a`、`div`、`span`、`Typography.Link` 等）。
 
 Import:
 
@@ -24,6 +24,7 @@ Click reporting uses `data-track` JSON from `getTrackData`. Do not call `track()
 | Drawer / Modal custom footer | each `Button` | `data-track={getTrackData(...)}` |
 | Confirm dialog | `BaseModal` | custom footer + `data-track` when button props unavailable |
 | Inline form submit | `ProForm` / `Form` | `submitButtonProps` / `resetButtonProps` |
+| Clickable `a` / `div` / `span` / `Typography.Link` | any node with `onClick` | `data-track={getTrackData(...)}` on **that** node |
 
 `MFProTable` query and reset are handled inside the table (`filter_query` / `查询`, `filter_reset` / `重置`). Do not duplicate in page code.
 
@@ -49,15 +50,18 @@ Every business `Button` in custom `footer` needs `data-track`. Do not replace th
 - Column settings only.
 - Table overflow 「更多」 ellipsis icon (menu items inside still need `track`).
 - Buttons hidden by permission (no render → no track).
+- Nodes with **no** `onClick` (plain text, static `href` links).
 
 **Copy buttons must be tracked** — see shared-tracking §5.
 
+**Any `onClick` node must be tracked** — see shared-tracking §6 (`a`, `div`, `span`, `Typography.Link`, clickable cards).
+
 ## After `gen page`
 
-When `src/utils/tracking/index.ts` exists, `gen page` wires toolbar, action edit/delete, drawer, and modal by default. Agent still reviews and adds tracking for extra buttons (copy, batch, custom footer, ProForm). Pass `--no-tracking` only when user explicitly asks.
+When `src/utils/tracking/index.ts` exists, `gen page` wires toolbar, action edit/delete, drawer, and modal by default. Agent still reviews and adds tracking for extra buttons (copy, batch, custom footer, ProForm) and **every `onClick` on `a` / `div` / `span` / links**. Pass `--no-tracking` only when user explicitly asks.
 
 For pages **not** from `gen page`, Agent scans and wires the full set per shared-tracking — not a user manual task.
 
 ## Verification
 
-Static scan changed files: every toolbar / action / copy / drawer / modal / form button has `track`, `cancelTrack`, `okTrack`, or `data-track`.
+Static scan changed files: every toolbar / action / copy / drawer / modal / form button, plus every `onClick` on `a` / `div` / `span` / `Typography.Link`, has `track`, `cancelTrack`, `okTrack`, or `data-track`.

package/skills/shared/project-conventions/references/review-checklist.md

@@ -33,10 +33,11 @@ Apply when the project has `src/utils/tracking/index.ts` (or the path in project
 - Toolbar and batch actions in `getToolBarRender` need `track: getTrackData(...)`.
 - Action column entries need `track` beside `permission` when present.
 - Standalone permission buttons need `data-track={getTrackData(...)}`.
+- Clickable `a` / `div` / `span` / `Typography.Link` with `onClick` need `data-track` on **that** node.
 - `CustomDrawer` with the default footer needs `cancelTrack` and `okTrack`; custom footers need `data-track` on each business button.
 - `BaseModal` confirm dialogs need `cancelButtonProps` / `okButtonProps` with `'data-track'`.
 - `ProForm` with a visible default submitter needs submit/reset button props; when `submitter={false}`, tracking belongs on the overlay footer only.
-- Require tracking on copy actions; do not require tracking on column settings, table overflow ellipsis icon, or buttons hidden by permission.
+- Require tracking on copy actions and **any node with `onClick`** (`a`, `div`, `span`, `Typography.Link`, clickable cards). Do not require tracking on column settings, table overflow ellipsis icon, buttons hidden by permission, or nodes without `onClick`.
 - Missing in-scope button tracking on a changed page is **P1**.
 
 ## Shared components and regression

package/skills/shared/review-and-submit/SKILL.md

@@ -30,9 +30,9 @@ Follow [references/impact-analysis.md](references/impact-analysis.md). Output:
 Follow [references/verify.md](references/verify.md). Output:
 
 - P0/P1/P2 blockers
-- Completeness of route, permission, API, types, mock, page states, and button tracking when the project has tracking configured
+- Completeness of route, permission, API, types, mock, page states, and click tracking when the project has tracking configured
 - Async, loading, overlay, and list-reload behavior
-- Missing `track` / `data-track` / `cancelTrack` / `okTrack` on in-scope buttons per `shared-tracking` and `shared-design-to-page/references/tracking.md` (P1 when tracking is enabled)
+- Missing `track` / `data-track` / `cancelTrack` / `okTrack` on in-scope clickables (buttons, copy, **`onClick` on `a` / `div` / `span`**) per `shared-tracking` (P1 when tracking is enabled)
 - Prettier, TypeScript, lint, and build results
 - Uncovered risks
 

package/skills/shared/review-and-submit/references/ai-review.md

@@ -15,7 +15,7 @@ If `.agents/project/review-rules.md` exists, apply extra domain checks only; do
 1. React Hooks: stale closures, incomplete dependencies, request races, updates after unmount, unnecessary rerenders.
 2. API contracts: method/path/params, response unwrapping, pagination, nullability, enum drift, error handling, DTO mismatch.
 3. Permissions: route access, button visibility, mutation authorization, client-only enforcement.
-4. **Tracking** (when `src/utils/tracking/index.ts` or project equivalent exists): scan changed pages for missing `track` / `cancelTrack` / `okTrack` / `data-track` on in-scope buttons—toolbar, action column, permission buttons, drawer and confirm footers (default and custom), inline form submitters, and **copy** actions. Flag missing wiring as **P1**. Do not require tracking on column settings, table overflow ellipsis icon, or permission-hidden buttons. Do not flag handlers that call `track()` when `data-track` is the project standard.
+4. **Tracking** (when `src/utils/tracking/index.ts` or project equivalent exists): scan changed pages for missing `track` / `cancelTrack` / `okTrack` / `data-track` on in-scope buttons—toolbar, action column, permission buttons, drawer and confirm footers (default and custom), inline form submitters, **copy** actions, and **any `onClick` on `a` / `div` / `span` / `Typography.Link`**. Flag missing wiring as **P1**. Do not require tracking on column settings, table overflow ellipsis icon, permission-hidden buttons, or nodes without `onClick`. Do not flag handlers that call `track()` when `data-track` is the project standard.
 5. Forms/tables: validation, reset, duplicate submit, refresh after mutation, column-state, long text, empty/error.
 6. Performance (hard checks):
    - New or changed files must not statically `import 'xlsx'`, `@uiw/react-codemirror`, `@codemirror/*`, `echarts`, `@ant-design/charts`, or `react-json-view` at module top level. Those must be `import()`.

package/skills/shared/review-and-submit/references/verify.md

@@ -19,7 +19,7 @@ Do not auto-fix. If `.agents/project/review-rules.md` exists, apply extra domain
 5. Empty table values, duplicate-submit guards, permission wrappers, and narrow-screen overflow.
 6. Heavy deps (`xlsx`, editors, charts) are `import()`; nothing new lands in `src/app.ts`.
 7. No `MFTablePro` / table-from-package imports; overlays come from `@mingfuyun/star-allinone`.
-8. **Tracking** (when tracking is configured): every in-scope button has `track`, `cancelTrack`, `okTrack`, or `data-track` per `.agents/skills/shared-tracking/SKILL.md` and `.agents/skills/shared-design-to-page/references/tracking.md`. Check toolbar items, action column entries, standalone permission buttons, drawer default or custom footers, confirm modals, inline `ProForm` submitters, and **copy** buttons. Missing wiring is **P1** when the button is user-visible and in scope. Excluded controls (column settings, table overflow ellipsis icon) must not be flagged. Permission-hidden buttons may omit tracking.
+8. **Tracking** (when tracking is configured): every in-scope clickable has `track`, `cancelTrack`, `okTrack`, or `data-track` per `.agents/skills/shared-tracking/SKILL.md` and `.agents/skills/shared-design-to-page/references/tracking.md`. Check toolbar items, action column entries, standalone permission buttons, drawer default or custom footers, confirm modals, inline `ProForm` submitters, **copy** buttons, and **`onClick` on `a` / `div` / `span` / `Typography.Link`**. Missing wiring is **P1** when the control is user-visible and in scope. Excluded controls (column settings, table overflow ellipsis icon, nodes without `onClick`) must not be flagged. Permission-hidden buttons may omit tracking.
 
 ## Commands
 

package/skills/shared/tracking/SKILL.md

@@ -16,11 +16,11 @@ description: User-facing. Connect a galaxy admin app to the shared tracking SDK.
 完成标准：
 
 1. 基础设施（SDK、`tracking/index.ts`、`app.tsx`、请求封装）已就绪。
-2. **全站**下列五类可点击按钮均已带 `track` / `cancelTrack` / `okTrack` / `data-track`（无权限未渲染的除外）。
+2. **全站**带用户点击意图的控件均已带 `track` / `cancelTrack` / `okTrack` / `data-track`（无权限未渲染的除外）。覆盖五类标准按钮，以及 **任何写了 `onClick` / `onClickCapture` 的元素**（`a`、`div`、`span`、`Typography.Link` 等）。
 3. `pnpm typecheck` 通过。
 4. 向用户汇报已覆盖的文件范围，而不是留 TODO 让用户自己改。
 
-### 必须扫描并补齐的五类按钮
+### 必须扫描并补齐的范围
 
 | # | 范围 | 扫描位置 | 写法 |
 | --- | --- | --- | --- |
@@ -29,6 +29,9 @@ description: User-facing. Connect a galaxy admin app to the shared tracking SDK.
 | 3 | **MFProTable 操作列** | `actionColumn`、`listActionColumn`、`TableActions`、`TablePermissionActions` | `ActionItem.track` |
 | 4 | **ProForm / Form** | `submitter` 默认栏、`submitter.render`、antd `Form` 提交/重置 | `submitButtonProps` / `resetButtonProps` 的 `data-track` |
 | 5 | **复制相关按钮** | 文案含「复制」「一键复制」、`key` 含 `copy`；含复制 IP | `getTrackData('copy', '…', …)` |
+| 6 | **任意带 `onClick` 的可点击元素** | `onClick` / `onClickCapture` 写在 `a`、`div`、`span`、`p`、`li`、`Typography.Link`、`Typography.Text`、antd `Link` 等上 | 该节点加 `data-track={getTrackData(...)}`。不要只给外层容器埋点而漏掉真正被点的子节点 |
+
+硬规则：**只要业务代码给节点绑了点击回调，该节点就要上报。** 不限 `Button`。链接、可点击文字、卡片区域、状态标签、图标容器都算。
 
 另需覆盖（同属 Agent 批量任务）：
 
@@ -44,9 +47,11 @@ rg "toolBarRender|actionColumn|listActionColumn|TablePermissionActions" src/page
 rg "withAuth|AccessButton" src/pages -g "*.tsx"
 rg "ProForm|submitter" src/pages -g "*.tsx"
 rg "复制|copy|Copy" src/pages src/components -g "*.tsx"
+rg "onClick(Capture)?=" src/pages src/components -g "*.tsx"
+rg "<a |<div |<span " src/pages -g "*.tsx"
 ```
 
-对每个命中文件：**打开、判断是否在五类范围内、补全、保存**。历史页与 `gen page` 新页同一标准。
+对每个命中文件：**打开、判断是否在范围内、补全、保存**。带 `onClick` 的 `a`/`div`/`span` 与 Button 同一标准。历史页与 `gen page` 新页同一标准。
 
 ### 不要做的「半套接入」
 
@@ -54,8 +59,9 @@ rg "复制|copy|Copy" src/pages src/components -g "*.tsx"
 - ❌ 只改一两个示例页，告诉用户「其余页按同样方式手动加」
 - ❌ 在组件层做 track 自动推断（不改 `withAuth` / `TableActions` 自动生成 track）
 - ❌ 把复制按钮排除在补齐范围外
+- ❌ 只给 `Button` 加埋点，漏掉带 `onClick` 的 `a` / `div` / `span` / `Typography.Link`
 
-仍不上报：**列设置**、表格 **「更多」省略号**（仅展开菜单的 icon；菜单内各项仍要 track）。
+仍不上报：**列设置**、表格 **「更多」省略号**（仅展开菜单的 icon；菜单内各项仍要 track）、纯展示且**没有** `onClick` 的节点。
 
 ---
 
@@ -260,6 +266,45 @@ Umi：
 track: getTrackData('copy', '复制IP', { key: 'toolbar', name: '群看板' })
 ```
 
+#### 6. 带 `onClick` 的 `a` / `div` / `span` 等
+
+业务点击绑在哪个节点，`data-track` 就写在哪个节点上。不要依赖父级冒泡来代替。
+
+```tsx
+<a
+  data-track={getTrackData('view_detail', '查看详情', { key: 'cell', name: '名称' })}
+  onClick={() => handleView(record)}
+>
+  {record.name}
+</a>
+
+<div
+  className={styles.card}
+  data-track={getTrackData('open_card', '打开卡片', { key: 'board', name: '看板' })}
+  onClick={handleOpenCard}
+>
+  {title}
+</div>
+
+<span
+  data-track={getTrackData('toggle_status', '切换状态', { key: 'cell', name: '状态' })}
+  onClick={() => handleToggle(record)}
+>
+  {record.status}
+</span>
+
+<Typography.Link
+  data-track={getTrackData('open_doc', '打开文档', { key: 'link', name: '文档' })}
+  onClick={handleOpenDoc}
+>
+  文档
+</Typography.Link>
+```
+
+`onClick` 写在包裹组件上时，把 `data-track` 也写在同一组件。子节点没有独立点击时不要重复上报。
+
+路由跳转用 `history.push` / `navigate` 且绑了 `onClick` 的，同样要 `data-track`。纯 `href`、没有 `onClick` 的外链可以不上报。
+
 ## 不要做的事
 
 - 不要把 `tracking-sdk.global.min.js` 提交到业务仓库。
@@ -277,6 +322,6 @@ track: getTrackData('copy', '复制IP', { key: 'toolbar', name: '群看板' })
 1. 页面请求了 OSS 上的脚本，并且出现 `window.TrackingSDK`。
 2. 进入业务页、初始状态完成后存在 `window.__tracker`。`/` 上可以还没有。
 3. 一次失败请求发出事件名 `api_request`。
-4. 五类按钮（含复制）带 `data-track` / `cancelTrack` / `okTrack`。
+4. 五类标准按钮（含复制），以及带 `onClick` 的 `a` / `div` / `span` / `Typography.Link` 等，带 `data-track` / `cancelTrack` / `okTrack`。
 
 `appId` 与平台不一致时，只改 `src/utils/tracking/index.ts`。