@aithe/aithe-ui 26.3.1 → 26.3.2

package/dist/core/datahub/__tests__/force-options.test.js

@@ -0,0 +1,161 @@
+/**
+ * @file DataHubCore forceDedup / forceCache 选项测试
+ * @description 验证当 URL 不以 query/list/get 结尾时，
+ *              forceDedup 和 forceCache 选项能强制启用去重和缓存，
+ *              且不会被幂等守卫拦截。
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { DataHubCore } from '../../datahub/core/datahub-core';
+/** 构造一个可控的假适配器 / Build a controllable fake adapter */
+function createFakeAdapter() {
+    const adapter = {
+        name: 'fake',
+        callCount: 0,
+        reset() {
+            this.callCount = 0;
+        },
+        async request(req) {
+            this.callCount++;
+            return { ok: true, status: 200, data: { url: req.url, n: this.callCount } };
+        },
+    };
+    return adapter;
+}
+/** 构造一个使用 raw APIStyle 的 DataHubCore（不做业务协议解析）/ Build a DataHubCore with raw APIStyle */
+function createCore(adapter) {
+    const core = new DataHubCore({ defaultCacheTTL: 1000, defaultAdapter: adapter.name });
+    core.registerAdapter(adapter);
+    core.setAPIStyle('raw');
+    return core;
+}
+beforeEach(() => {
+    // 每个用例前清空全局缓存和去重记录，避免用例间相互干扰
+    // Clear global cache and dedup records before each case to avoid cross-test interference
+});
+describe('DataHubCore - forceDedup', () => {
+    it('非 query URL 默认走幂等守卫，并发第二个请求被拒绝', async () => {
+        const fake = createFakeAdapter();
+        const core = createCore(fake);
+        // /system/roles/viewer 结尾不是 query/list/get，默认判为 submit
+        const p1 = core.request('/system/roles/viewer', undefined, { method: 'GET' });
+        const p2 = core.request('/system/roles/viewer', undefined, { method: 'GET' });
+        // p2 应被幂等守卫拒绝
+        await expect(p2).rejects.toThrow(/duplicate submit/);
+        await p1;
+        expect(fake.callCount).toBe(1);
+    });
+    it('forceDedup: true 时，非 query URL 并发请求被去重，只发一次', async () => {
+        const fake = createFakeAdapter();
+        const core = createCore(fake);
+        core.clearDedup();
+        core.clearIdempotent();
+        const p1 = core.request('/system/roles/viewer', undefined, {
+            method: 'GET',
+            forceDedup: true,
+        });
+        const p2 = core.request('/system/roles/viewer', undefined, {
+            method: 'GET',
+            forceDedup: true,
+        });
+        const [r1, r2] = await Promise.all([p1, p2]);
+        // 两个调用共享同一结果，只发一次实际请求
+        expect(fake.callCount).toBe(1);
+        expect(r1).toEqual(r2);
+    });
+    it('forceDedup 不影响不同 URL 的请求', async () => {
+        const fake = createFakeAdapter();
+        const core = createCore(fake);
+        core.clearDedup();
+        core.clearIdempotent();
+        await Promise.all([
+            core.request('/system/roles/a', undefined, { method: 'GET', forceDedup: true }),
+            core.request('/system/roles/b', undefined, { method: 'GET', forceDedup: true }),
+        ]);
+        expect(fake.callCount).toBe(2);
+    });
+});
+describe('DataHubCore - forceCache', () => {
+    it('非 query URL 默认不缓存，两次请求发两次', async () => {
+        const fake = createFakeAdapter();
+        const core = createCore(fake);
+        core.clearCache();
+        core.clearIdempotent();
+        await core.request('/system/roles/viewer', undefined, { method: 'GET', skipIdempotent: true });
+        await core.request('/system/roles/viewer', undefined, { method: 'GET', skipIdempotent: true });
+        expect(fake.callCount).toBe(2);
+    });
+    it('forceCache: true 时，非 query URL 第二次请求命中缓存', async () => {
+        const fake = createFakeAdapter();
+        const core = createCore(fake);
+        core.clearCache();
+        core.clearIdempotent();
+        const r1 = await core.request('/system/roles/viewer', undefined, {
+            method: 'GET',
+            forceCache: true,
+            skipIdempotent: true,
+        });
+        const r2 = await core.request('/system/roles/viewer', undefined, {
+            method: 'GET',
+            forceCache: true,
+            skipIdempotent: true,
+        });
+        // 第二次命中缓存，只发一次实际请求
+        expect(fake.callCount).toBe(1);
+        expect(r1).toEqual(r2);
+    });
+    it('forceCache 配合 skipCache 时不命中缓存', async () => {
+        const fake = createFakeAdapter();
+        const core = createCore(fake);
+        core.clearCache();
+        core.clearIdempotent();
+        await core.request('/system/roles/viewer', undefined, {
+            method: 'GET',
+            forceCache: true,
+            skipIdempotent: true,
+        });
+        await core.request('/system/roles/viewer', undefined, {
+            method: 'GET',
+            forceCache: true,
+            skipCache: true,
+            skipIdempotent: true,
+        });
+        expect(fake.callCount).toBe(2);
+    });
+});
+describe('DataHubCore - forceDedup + forceCache 跳过幂等守卫', () => {
+    it('forceDedup 为 true 时，即使 URL 被判为 submit 也不会触发幂等守卫', async () => {
+        const fake = createFakeAdapter();
+        const core = createCore(fake);
+        core.clearDedup();
+        core.clearIdempotent();
+        // 串行两次请求（不并发），验证幂等守卫不会拦截第二次
+        await core.request('/system/roles/viewer', undefined, {
+            method: 'GET',
+            forceDedup: true,
+        });
+        // 第二次请求不应被幂等守卫拒绝（dedup 记录已清理，会重新发请求）
+        const r2 = await core.request('/system/roles/viewer', undefined, {
+            method: 'GET',
+            forceDedup: true,
+        });
+        expect(r2.ok).toBe(true);
+        expect(fake.callCount).toBe(2);
+    });
+    it('forceCache 为 true 时，即使 URL 被判为 submit 也不会触发幂等守卫', async () => {
+        const fake = createFakeAdapter();
+        const core = createCore(fake);
+        core.clearCache();
+        core.clearIdempotent();
+        await core.request('/system/roles/viewer', undefined, {
+            method: 'GET',
+            forceCache: true,
+        });
+        // 第二次命中缓存，且不被幂等守卫拦截
+        const r2 = await core.request('/system/roles/viewer', undefined, {
+            method: 'GET',
+            forceCache: true,
+        });
+        expect(r2.ok).toBe(true);
+        expect(fake.callCount).toBe(1);
+    });
+});

package/dist/core/datahub/core/api-styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-styles.d.ts","sourceRoot":"","sources":["../../../../src/core/datahub/core/api-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,qBAAqB,CAAC;AAgI7B;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}
+{"version":3,"file":"api-styles.d.ts","sourceRoot":"","sources":["../../../../src/core/datahub/core/api-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,qBAAqB,CAAC;AAqI7B;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}

package/dist/core/datahub/core/api-styles.js

@@ -14,6 +14,11 @@
 const defaultStyle = {
     name: 'default',
     onRequest(req) {
+        // GET 请求不发送 body，无需包装 data，避免触发 "GET request with body is unusual" 警告
+        // GET requests do not send a body, so skip wrapping data to avoid the "GET request with body is unusual" warning
+        if (req.options.method === 'GET') {
+            return;
+        }
         req.data = { data: req.data };
     },
     onResponse(res) {

package/dist/core/datahub/core/datahub-core.d.ts

@@ -107,6 +107,56 @@ export declare class DataHubCore {
      * if (biz.code === 'Ok') { /* handle success *\/ }
      */
     request<T = unknown>(url: string, data?: unknown, options?: DataHubRequestOptions): Promise<DataHubAdapterResponse<T>>;
+    /**
+     * 应用全局响应拦截器（命中缓存与实际请求路径共用）。
+     * Apply global response interceptor (shared by cache-hit and real-request paths).
+     */
+    private applyResponseInterceptor;
+    /**
+     * 实际执行请求：适配器调用 + 响应拦截 + HTTP 错误处理 + 统一响应处理 + 缓存写入。
+     * Execute the request: adapter call + response interceptor + HTTP error handling +
+     * unified response handling + cache write.
+     */
+    private executeRequest;
+    /**
+     * 构造 HTTP 传输层错误：优先用 APIStyle 解析响应体，回退到 transport error。
+     * Build HTTP transport error: try APIStyle first, fall back to transport error.
+     */
+    private buildHttpError;
+    /**
+     * 是否可缓存：strategy 默认判定，或 forceCache 强制启用。
+     * Whether cacheable: by strategy, or force-enabled by forceCache.
+     */
+    private isCacheable;
+    /**
+     * 是否可去重：strategy 默认判定，或 forceDedup 强制启用。
+     * Whether dedupable: by strategy, or force-enabled by forceDedup.
+     */
+    private isDedupable;
+    /**
+     * 是否需要幂等防护：strategy 判定为提交类、未跳过、且未被 force 选项豁免。
+     * Whether idempotent guard applies: strategy says submit, not skipped, and not
+     * exempted by forceDedup/forceCache (which mark the request as a query).
+     */
+    private shouldGuardIdempotent;
+    /**
+     * 统一响应处理：APIStyle 转换 + isSuccess 业务校验 + 返回业务数据
+     * Unified response handling: APIStyle transform + isSuccess check + return business data
+     *
+     * 抽取该方法的目的：让「实际请求路径」与「缓存命中路径」走完全一致的响应处理逻辑，
+     * 避免缓存命中时跳过 isSuccess 校验或丢失 code/message 等字段。
+     *
+     * This method is extracted so that both the real-request path and the cache-hit path
+     * share identical response handling, avoiding skipped isSuccess checks or lost
+     * code/message fields when cache hits.
+     *
+     * @param res - 适配器返回的原始响应 / Raw response from adapter
+     * @param requestStyle - 解析后的 APIStyle / Resolved APIStyle
+     * @param traceId - 链路追踪 ID / Trace ID
+     * @param fullUrl - 完整请求 URL / Full request URL
+     * @returns 业务数据已替换的响应 / Response with business data replaced
+     */
+    private handleResponse;
     /** 清空所有缓存 / Clear all cache */
     clearCache(): void;
     /** 清空所有去重记录 / Clear all dedup records */

package/dist/core/datahub/core/datahub-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datahub-core.d.ts","sourceRoot":"","sources":["../../../../src/core/datahub/core/datahub-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAOxE,OAAO,EAA4B,eAAe,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAenG;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,uDAAuD;IACvD,OAAO,CAAC,MAAM,CAAiB;IAC/B,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAA8B;IAE9C;;OAEG;gBACS,MAAM,GAAE,aAAkB;IAatC;;;;OAIG;IACI,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIrD;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAM3D;;;;;;;;;;;;;;;OAeG;IACI,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI;IAezD;;;OAGG;IACI,WAAW,IAAI,eAAe,GAAG,SAAS;IAIjD;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;;;;;;;;;;;;;;;;;OAkBG;IACU,OAAO,CAAC,CAAC,GAAG,OAAO,EAC9B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAgJrC,+BAA+B;IACxB,UAAU,IAAI,IAAI;IAIzB,yCAAyC;IAClC,UAAU,IAAI,IAAI;IAIzB,2CAA2C;IACpC,eAAe,IAAI,IAAI;IAM9B;;OAEG;IACI,qBAAqB,CAC1B,OAAO,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,qBAAqB,GAAG,IAAI,GACpE,IAAI;IAIP;;OAEG;IACI,sBAAsB,CAC3B,OAAO,EAAE,CACP,GAAG,EAAE,sBAAsB,EAC3B,GAAG,EAAE,qBAAqB,KACvB,sBAAsB,GAAG,IAAI,GACjC,IAAI;IAIP;;OAEG;IACI,eAAe,CACpB,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,qBAAqB,KAAK,IAAI,GACtE,IAAI;IAIP;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAIzD;;OAEG;IACI,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;IAM3C,2DAA2D;IACpD,eAAe,yBAAmB;IAEzC,wEAAwE;IACjE,SAAS,mBAAa;IAI7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;;OAGG;IACH,OAAO,CAAC,cAAc;CA0BvB"}
+{"version":3,"file":"datahub-core.d.ts","sourceRoot":"","sources":["../../../../src/core/datahub/core/datahub-core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EAEhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,IAAI,iBAAiB,EAAyC,MAAM,qBAAqB,CAAC;AAO/G,OAAO,EAA4B,eAAe,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAenG;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,uDAAuD;IACvD,OAAO,CAAC,MAAM,CAAiB;IAC/B,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAA8B;IAE9C;;OAEG;gBACS,MAAM,GAAE,aAAkB;IAatC;;;;OAIG;IACI,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIrD;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAM3D;;;;;;;;;;;;;;;OAeG;IACI,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI;IAezD;;;OAGG;IACI,WAAW,IAAI,eAAe,GAAG,SAAS;IAIjD;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;;;;;;;;;;;;;;;;;OAkBG;IACU,OAAO,CAAC,CAAC,GAAG,OAAO,EAC9B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;IA8ErC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAMhC;;;;OAIG;YACW,cAAc;IAuD5B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAInB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAInB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,cAAc;IA+BtB,+BAA+B;IACxB,UAAU,IAAI,IAAI;IAIzB,yCAAyC;IAClC,UAAU,IAAI,IAAI;IAIzB,2CAA2C;IACpC,eAAe,IAAI,IAAI;IAM9B;;OAEG;IACI,qBAAqB,CAC1B,OAAO,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,qBAAqB,GAAG,IAAI,GACpE,IAAI;IAIP;;OAEG;IACI,sBAAsB,CAC3B,OAAO,EAAE,CACP,GAAG,EAAE,sBAAsB,EAC3B,GAAG,EAAE,qBAAqB,KACvB,sBAAsB,GAAG,IAAI,GACjC,IAAI;IAIP;;OAEG;IACI,eAAe,CACpB,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,qBAAqB,KAAK,IAAI,GACtE,IAAI;IAIP;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI;IAIzD;;OAEG;IACI,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;IAM3C,2DAA2D;IACpD,eAAe,yBAAmB;IAEzC,wEAAwE;IACjE,SAAS,mBAAa;IAI7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;;OAGG;IACH,OAAO,CAAC,cAAc;CA0BvB"}

package/dist/core/datahub/core/datahub-core.js

@@ -195,101 +195,180 @@ export class DataHubCore {
         }
         // 6. 缓存检查：查询类请求且未跳过缓存时，尝试命中缓存
         // Cache check: for query requests without skipCache, try to hit cache
-        if (strategy.cacheable && !merged.skipCache) {
+        // forceCache 选项可无视 URL 命名约定强制启用缓存
+        // forceCache option bypasses URL naming convention to force-enable caching
+        const cacheable = this.isCacheable(strategy, merged);
+        if (cacheable && !merged.skipCache) {
             const cached = cacheGet(fullUrl, data);
-            if (cached)
-                return cached;
+            if (cached) {
+                // 缓存命中：先走全局响应拦截器，再走统一响应处理（与实际请求路径保持一致）
+                // Cache hit: apply global response interceptor first, then unified response handling
+                // (consistent with the real-request path)
+                this.applyResponseInterceptor(cached, req);
+                return this.handleResponse(cached, requestStyle, traceId, fullUrl);
+            }
         }
         // 实际执行请求的内部函数 / Internal function that actually executes the request
-        const execute = async () => {
-            // 标记 loading 开始 / Mark loading start
-            loadingStart(fullUrl);
-            try {
-                // 7. 解析并调用适配器 / Resolve and call adapter
-                const adapter = this.resolveAdapter(merged);
-                const res = await adapter.request(req);
-                // 8. 响应拦截器 / Response interceptor
-                if (this.config.onResponse) {
-                    const intercepted = this.config.onResponse(res, req);
-                    if (intercepted)
-                        Object.assign(res, intercepted);
-                }
-                // 9. HTTP 传输层错误处理：HTTP 非 2xx 时，优先用 APIStyle 解析响应体
-                // HTTP transport error: when !res.ok, try APIStyle first, fall back to transport error
-                if (!res.ok) {
-                    if (requestStyle) {
-                        const result = requestStyle.onResponse(res);
-                        throw new DataHubErrorClass({
-                            code: result.code ?? `HTTP_${res.status}`,
-                            message: result.message || `HTTP request failed with status ${res.status}`,
-                            trace: traceId,
-                            status: res.status,
-                            url: fullUrl,
-                            data: res.data,
-                        });
-                    }
-                    throw this.createTransportError(res, traceId, fullUrl);
-                }
-                // 10. 使用 APIStyle 解析业务结果（code/message/data）
-                // Use APIStyle to parse business result (code/message/data)
-                if (requestStyle) {
-                    const result = requestStyle.onResponse(res);
-                    // 11. 业务错误处理：根据风格自定义的成功判断
-                    // Business error handling: success check defined by the style
-                    if (!requestStyle.isSuccess(result)) {
-                        throw new DataHubErrorClass({
-                            code: result.code,
-                            message: result.message || `error: ${result.code}`,
-                            trace: traceId,
-                            status: res.status,
-                            url: fullUrl,
-                        });
-                    }
-                    // 缓存写入：查询类请求成功后写入缓存
-                    // Cache write: write to cache after successful query request
-                    if (strategy.cacheable && !merged.skipCache) {
-                        const ttl = merged.cacheTTL ?? DEFAULT_CONFIG.defaultCacheTTL;
-                        cacheSet(fullUrl, data, res, ttl);
-                    }
-                    // 返回时 data 替换为业务数据 / Replace data with business data in response
-                    return { ...res, data: result.data };
-                }
-                // 缓存写入：查询类请求成功后写入缓存
-                // Cache write: write to cache after successful query request
-                if (strategy.cacheable && !merged.skipCache) {
-                    const ttl = merged.cacheTTL ?? DEFAULT_CONFIG.defaultCacheTTL;
-                    cacheSet(fullUrl, data, res, ttl);
-                }
-                // APIStyle 为空，直接返回原始响应 / No APIStyle, return raw response directly
-                return res;
-            }
-            catch (err) {
-                // 13. 统一错误处理：将各类异常转换为 DataHubError
-                // Unified error handling: convert all exceptions to DataHubError
-                const error = this.normalizeError(err, fullUrl, traceId);
-                if (this.config.onError) {
-                    this.config.onError(error, req);
-                }
-                throw error;
-            }
-            finally {
-                // 无论成功失败，标记 loading 结束 / Mark loading end regardless of success or failure
-                loadingEnd(fullUrl);
-            }
-        };
+        const execute = () => this.executeRequest(req, merged, requestStyle, traceId, fullUrl, data, cacheable);
         // 12. 去重处理：查询类请求自动合并相同并发请求
         // Dedup: automatically merge identical concurrent query requests
-        if (strategy.dedupable && !merged.skipDedup) {
+        // forceDedup 选项可无视 URL 命名约定强制启用去重
+        // forceDedup option bypasses URL naming convention to force-enable dedup
+        const dedupable = this.isDedupable(strategy, merged);
+        if (dedupable && !merged.skipDedup) {
             return dedupTrack(fullUrl, data, execute);
         }
         // 13. 幂等防护：提交类请求阻止重复提交
         // Idempotent guard: block duplicate submissions for submit requests
-        if (strategy.idempotent && !merged.skipIdempotent) {
+        // 当 forceDedup 或 forceCache 为 true 时跳过幂等防护，避免并发查询请求被误判为重复提交
+        // Skip idempotent guard when forceDedup or forceCache is true, preventing concurrent
+        // query requests from being misjudged as duplicate submissions
+        if (this.shouldGuardIdempotent(strategy, merged)) {
             return idempotentGuard(fullUrl, data, execute);
         }
         // 14. 无需中间件，直接执行 / No middleware needed, execute directly
         return execute();
     }
+    /**
+     * 应用全局响应拦截器（命中缓存与实际请求路径共用）。
+     * Apply global response interceptor (shared by cache-hit and real-request paths).
+     */
+    applyResponseInterceptor(res, req) {
+        if (!this.config.onResponse)
+            return;
+        const intercepted = this.config.onResponse(res, req);
+        if (intercepted)
+            Object.assign(res, intercepted);
+    }
+    /**
+     * 实际执行请求：适配器调用 + 响应拦截 + HTTP 错误处理 + 统一响应处理 + 缓存写入。
+     * Execute the request: adapter call + response interceptor + HTTP error handling +
+     * unified response handling + cache write.
+     */
+    async executeRequest(req, merged, requestStyle, traceId, fullUrl, data, cacheable) {
+        // 标记 loading 开始 / Mark loading start
+        loadingStart(fullUrl);
+        try {
+            // 7. 解析并调用适配器 / Resolve and call adapter
+            const adapter = this.resolveAdapter(merged);
+            const res = await adapter.request(req);
+            // 8. 响应拦截器 / Response interceptor
+            this.applyResponseInterceptor(res, req);
+            // 9. HTTP 传输层错误处理：HTTP 非 2xx 时，优先用 APIStyle 解析响应体
+            // HTTP transport error: when !res.ok, try APIStyle first, fall back to transport error
+            if (!res.ok) {
+                throw this.buildHttpError(res, requestStyle, traceId, fullUrl);
+            }
+            // 10. 统一响应处理：APIStyle 转换 + isSuccess 业务校验 + 返回业务数据
+            // Unified response handling: APIStyle transform + isSuccess check + return business data
+            // 注意：handleResponse 内部会抛出 DataHubError，与原逻辑保持一致
+            // Note: handleResponse throws DataHubError on business failure, consistent with original logic
+            const handled = this.handleResponse(res, requestStyle, traceId, fullUrl);
+            // 11. 缓存写入：查询类请求成功后写入缓存（写入原始 res，保持现有行为）
+            // Cache write: write to cache after successful query request (write raw res, keep existing behavior)
+            if (cacheable && !merged.skipCache) {
+                const ttl = merged.cacheTTL ?? DEFAULT_CONFIG.defaultCacheTTL;
+                cacheSet(fullUrl, data, res, ttl);
+            }
+            // 返回经 handleResponse 处理后的响应（data 已替换为业务数据）
+            // Return the response processed by handleResponse (data replaced with business data)
+            return handled;
+        }
+        catch (err) {
+            // 统一错误处理：将各类异常转换为 DataHubError
+            // Unified error handling: convert all exceptions to DataHubError
+            const error = this.normalizeError(err, fullUrl, traceId);
+            if (this.config.onError) {
+                this.config.onError(error, req);
+            }
+            throw error;
+        }
+        finally {
+            // 无论成功失败，标记 loading 结束 / Mark loading end regardless of success or failure
+            loadingEnd(fullUrl);
+        }
+    }
+    /**
+     * 构造 HTTP 传输层错误：优先用 APIStyle 解析响应体，回退到 transport error。
+     * Build HTTP transport error: try APIStyle first, fall back to transport error.
+     */
+    buildHttpError(res, requestStyle, traceId, fullUrl) {
+        if (requestStyle) {
+            const result = requestStyle.onResponse(res);
+            return new DataHubErrorClass({
+                code: result.code ?? `HTTP_${res.status}`,
+                message: result.message || `HTTP request failed with status ${res.status}`,
+                trace: traceId,
+                status: res.status,
+                url: fullUrl,
+                data: res.data,
+            });
+        }
+        return this.createTransportError(res, traceId, fullUrl);
+    }
+    /**
+     * 是否可缓存：strategy 默认判定，或 forceCache 强制启用。
+     * Whether cacheable: by strategy, or force-enabled by forceCache.
+     */
+    isCacheable(strategy, options) {
+        return strategy.cacheable || options.forceCache === true;
+    }
+    /**
+     * 是否可去重：strategy 默认判定，或 forceDedup 强制启用。
+     * Whether dedupable: by strategy, or force-enabled by forceDedup.
+     */
+    isDedupable(strategy, options) {
+        return strategy.dedupable || options.forceDedup === true;
+    }
+    /**
+     * 是否需要幂等防护：strategy 判定为提交类、未跳过、且未被 force 选项豁免。
+     * Whether idempotent guard applies: strategy says submit, not skipped, and not
+     * exempted by forceDedup/forceCache (which mark the request as a query).
+     */
+    shouldGuardIdempotent(strategy, options) {
+        if (!strategy.idempotent || options.skipIdempotent)
+            return false;
+        const forceQuery = options.forceDedup === true || options.forceCache === true;
+        return !forceQuery;
+    }
+    /**
+     * 统一响应处理：APIStyle 转换 + isSuccess 业务校验 + 返回业务数据
+     * Unified response handling: APIStyle transform + isSuccess check + return business data
+     *
+     * 抽取该方法的目的：让「实际请求路径」与「缓存命中路径」走完全一致的响应处理逻辑，
+     * 避免缓存命中时跳过 isSuccess 校验或丢失 code/message 等字段。
+     *
+     * This method is extracted so that both the real-request path and the cache-hit path
+     * share identical response handling, avoiding skipped isSuccess checks or lost
+     * code/message fields when cache hits.
+     *
+     * @param res - 适配器返回的原始响应 / Raw response from adapter
+     * @param requestStyle - 解析后的 APIStyle / Resolved APIStyle
+     * @param traceId - 链路追踪 ID / Trace ID
+     * @param fullUrl - 完整请求 URL / Full request URL
+     * @returns 业务数据已替换的响应 / Response with business data replaced
+     */
+    handleResponse(res, requestStyle, traceId, fullUrl) {
+        // 无 APIStyle：直接返回原始响应，不做业务转换 / No APIStyle: return raw response
+        if (!requestStyle)
+            return res;
+        // 使用 APIStyle 解析业务结果（code/message/data）
+        // Use APIStyle to parse business result (code/message/data)
+        const result = requestStyle.onResponse(res);
+        // 业务错误处理：根据风格自定义的成功判断
+        // Business error handling: success check defined by the style
+        if (!requestStyle.isSuccess(result)) {
+            throw new DataHubErrorClass({
+                code: result.code,
+                message: result.message || `error: ${result.code}`,
+                trace: traceId,
+                status: res.status,
+                url: fullUrl,
+            });
+        }
+        // 返回时 data 替换为业务数据 / Replace data with business data in response
+        return { ...res, data: result.data };
+    }
     // ─── 状态清理方法 / State Cleanup Methods ─────────────────────
     /** 清空所有缓存 / Clear all cache */
     clearCache() {

package/dist/core/datahub/types.d.ts

@@ -74,6 +74,24 @@ export interface DataHubRequestOptions {
     skipDedup?: boolean;
     /** 是否跳过幂等防护，允许同一提交重复执行 / Whether to skip idempotent guard, allowing duplicate submissions */
     skipIdempotent?: boolean;
+    /**
+     * 是否强制启用去重：为 true 时无视 URL 命名约定，对本请求启用并发去重。
+     * 适用于 URL 不以 query/list/get 结尾、但语义为查询且可能被并发调用的 GET 请求。
+     * Force enable dedup: when true, bypasses URL naming convention and enables
+     * concurrent dedup for this request. Applicable to GET requests whose URL does
+     * not end with query/list/get but are semantically queries and may be called concurrently.
+     */
+    forceDedup?: boolean;
+    /**
+     * 是否强制启用缓存：为 true 时无视 URL 命名约定，对本请求启用结果缓存。
+     * 配合 cacheTTL 控制有效期。适用于 URL 不以 query/list/get 结尾、
+     * 但语义为查询且结果可短期复用的 GET 请求。
+     * Force enable cache: when true, bypasses URL naming convention and enables
+     * result caching for this request. Use with cacheTTL to control TTL.
+     * Applicable to GET requests whose URL does not end with query/list/get
+     * but are semantically queries with short-term reusable results.
+     */
+    forceCache?: boolean;
     /** 是否使用 Mock 适配器 / Whether to use the Mock adapter */
     mock?: boolean;
     /** Mock 返回的业务数据 / Mock business data to return */

package/dist/core/datahub/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/datahub/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/datahub/types.ts"],"names":[],"mappings":"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"}

package/dist/core/markdown/plugins.d.ts

@@ -6,7 +6,7 @@
  *
  * 分类：
  * - Leaf blocks（叶子块）：heading, setextHeading, thematicBreak, codeFence, table
- * - Container blocks（容器块）：blockquote, list, taskList
+ * - Container blocks（容器块）：blockquote, list（含嵌套子列表）, taskList
  * - Inlines（行内）：bold, italic, code, del, link, image
  * - Extensions（扩展）：emoji, icon
  */
@@ -52,6 +52,7 @@ export declare const blockquotePlugin: AstPlugin;
  * 无序 / 有序列表
  *
  * 匹配 `- ` `* ` `+ ` 开头的无序列表，以及 `1. ` 等有序列表。
+ * 支持列表项的缩进续行和嵌套子列表。
  */
 export declare const listPlugin: AstPlugin;
 /**

package/dist/core/markdown/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAW,SAAS,EAAE,MAAM,SAAS,CAAC;AA8DlD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAc3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAejC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAQjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAkC7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAqDzB,CAAC;AAYF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,SA8B9B,CAAC;AAiBF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SA4CxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,SAiC5B,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SA+BxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,SAU1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAUxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,SAUvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,CAqB5C;AAED,0BAA0B;AAC1B,eAAO,MAAM,UAAU,EAAE,SAA8B,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAUzB,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAUxB,CAAC;AAwEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAYzB,CAAC"}
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAW,SAAS,EAAE,MAAM,SAAS,CAAC;AA8DlD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAc3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAejC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAQjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAkC7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAqDzB,CAAC;AAYF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,SA8B9B,CAAC;AAgIF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,SA0DxB,CAAC;AAoCF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,SAiC5B,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SA+BxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,SAU1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAUxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,SAUvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,CAqB5C;AAED,0BAA0B;AAC1B,eAAO,MAAM,UAAU,EAAE,SAA8B,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAUzB,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,SAUxB,CAAC;AAwEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAYzB,CAAC"}