knight-agent 1.1.0

package/module/ToolModule/ToolModule.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolModule = void 0;
+const base_1 = require("../../base");
+const ToolRAG_1 = require("./ToolRAG");
+/** 工具管理模块 — 注册表 + 缓存 + 重试 + 执行调度 */
+class ToolModule extends base_1.AbstractModule {
+    constructor() {
+        super();
+        /** 工具语义检索器(可选) */
+        this._rag = new ToolRAG_1.ToolRAG();
+        this._tools = new Map();
+        this._cache = new Map();
+    }
+    /** 已注册工具数量 */
+    get count() { return this._tools.size; }
+    // ======================== 注册 ========================
+    /** 注册单个工具 */
+    register(tool) {
+        this._tools.set(tool.name, tool);
+        this._rag.index(tool.name, `${tool.name}: ${tool.description}`);
+        return this;
+    }
+    /** 批量注册 */
+    registerAll(tools) {
+        for (const tool of tools) {
+            this.register(tool);
+        }
+        return this;
+    }
+    /** 移除工具 */
+    unregister(name) {
+        this.invalidateCache(name);
+        this._rag.remove(name);
+        return this._tools.delete(name);
+    }
+    /** 获取工具定义 */
+    get(name) {
+        return this._tools.get(name);
+    }
+    /** 获取全部工具 */
+    list() {
+        return Array.from(this._tools.values());
+    }
+    /** 按分类获取 */
+    listByCategory(category) {
+        return this.list().filter(t => t.category === category);
+    }
+    /** 设置语义检索的嵌入提供者(不设则使用内置关键词匹配) */
+    setEmbeddingProvider(provider) {
+        this._rag.setProvider(provider);
+    }
+    /**
+     * 根据用户输入从候选工具中检索最相关的 Top-K 个
+     *   先经过 RAG 语义排序，再取前 topK 个
+     * @param query      用户输入
+     * @param candidates 候选工具名列表(如 Skill 过滤后的结果)
+     * @param topK       返回数量
+     */
+    async selectTools(query, candidates, topK = 10) {
+        const pool = (candidates ?? this.list().map(t => t.name));
+        if (pool.length <= topK) {
+            return pool;
+        }
+        const items = pool
+            .map(n => this._tools.get(n))
+            .filter(Boolean)
+            .map(t => ({ name: t.name, description: t.description }));
+        return this._rag.search(query, items, topK);
+    }
+    /**
+     * 导出为 OpenAI API 工具列表(可按名称过滤)
+     * @param names     工具名白名单
+     * @param compact   精简模式：去掉 schema 中的 description/default，减少 token 开销
+     */
+    ToAPITools(names, compact = false) {
+        const tools = names
+            ? names.map(n => this._tools.get(n)).filter(Boolean)
+            : this.list();
+        return tools.map(t => ({
+            id: t.name,
+            type: "function",
+            function: {
+                name: t.name,
+                description: t.description,
+                parameters: compact ? this.stripSchema(t.schema) : t.schema,
+            },
+        }));
+    }
+    /** 递归裁剪 JSONSchema：去掉 description/default，只保留 type/enum/required/properties/items */
+    stripSchema(s) {
+        if (!s || typeof s !== "object") {
+            return s;
+        }
+        const out = {};
+        if (s.type) {
+            out.type = s.type;
+        }
+        if (s.enum) {
+            out.enum = s.enum;
+        }
+        if (s.required) {
+            out.required = s.required;
+        }
+        if (s.properties) {
+            out.properties = {};
+            for (const [k, v] of Object.entries(s.properties)) {
+                out.properties[k] = this.stripSchema(v);
+            }
+        }
+        if (s.items) {
+            out.items = this.stripSchema(s.items);
+        }
+        return out;
+    }
+    // ======================== 缓存 ========================
+    cacheKey(name, args) {
+        return `${name}:${JSON.stringify(args)}`;
+    }
+    checkCache(name, args) {
+        const key = this.cacheKey(name, args);
+        const entry = this._cache.get(key);
+        if (entry && (Date.now() - entry.timestamp) < entry.ttlMs) {
+            return entry.result;
+        }
+        this._cache.delete(key);
+        return null;
+    }
+    setCache(name, args, result, ttlMs = 60000) {
+        const key = this.cacheKey(name, args);
+        this._cache.set(key, { result, timestamp: Date.now(), ttlMs });
+    }
+    /** 清除缓存(可按工具名精确清除) */
+    invalidateCache(name) {
+        if (name) {
+            for (const [key] of this._cache) {
+                if (key.startsWith(`${name}:`)) {
+                    this._cache.delete(key);
+                }
+            }
+        }
+        else {
+            this._cache.clear();
+        }
+    }
+    // ======================== 执行 ========================
+    /** 执行单个工具调用 */
+    async Execute(toolCall, ctx) {
+        const name = toolCall.function.name;
+        const tool = this._tools.get(name);
+        if (!tool) {
+            return `工具 "${name}" 未注册`;
+        }
+        let args;
+        try {
+            args = JSON.parse(toolCall.function.arguments);
+        }
+        catch {
+            return `工具 "${name}" 参数解析失败`;
+        }
+        if (tool.cacheable) {
+            const cached = this.checkCache(name, args);
+            if (cached) {
+                return cached;
+            }
+        }
+        const maxRetries = (tool.retryable && tool.maxRetries) ? tool.maxRetries : 1;
+        let lastError = "";
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                const result = await tool.handler(args);
+                if (tool.cacheable) {
+                    this.setCache(name, args, result);
+                }
+                return result;
+            }
+            catch (e) {
+                lastError = String(e);
+                if (attempt < maxRetries - 1) {
+                    await new Promise(r => setTimeout(r, 200 * (attempt + 1)));
+                }
+            }
+        }
+        return `工具 "${name}" 执行失败(重试${maxRetries}次): ${lastError}`;
+    }
+    /** 批量执行(自动分组并行/串行) */
+    async ExecuteBatch(toolCalls, ctx) {
+        const results = new Map();
+        const parallel = [];
+        const sequential = [];
+        for (const tc of toolCalls) {
+            const tool = this._tools.get(tc.function.name);
+            if (tool?.parallelizable) {
+                parallel.push(tc);
+            }
+            else {
+                sequential.push(tc);
+            }
+        }
+        if (parallel.length > 0) {
+            const parallelResults = await Promise.all(parallel.map(tc => this.Execute(tc, ctx).then(r => ({ id: tc.id, result: r }))));
+            for (const { id, result } of parallelResults) {
+                results.set(id, result);
+            }
+        }
+        for (const tc of sequential) {
+            const result = await this.Execute(tc, ctx);
+            results.set(tc.id, result);
+        }
+        return results;
+    }
+    /** 清空全部工具和缓存 */
+    clear() {
+        this._tools.clear();
+        this._cache.clear();
+        // RAG 索引随工具清空，但保留 provider 设置
+    }
+}
+exports.ToolModule = ToolModule;
+//# sourceMappingURL=ToolModule.js.map

package/module/ToolModule/ToolModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolModule.js","sourceRoot":"","sources":["../../../src/module/ToolModule/ToolModule.ts"],"names":[],"mappings":"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"}

package/module/ToolModule/ToolRAG.d.ts

@@ -0,0 +1,38 @@
+/** 嵌入向量提供者接口 — 业务层可替换为真实 embedding 模型 */
+export interface IEmbeddingProvider {
+    /** 将文本转为向量 */
+    embed(text: string): Promise<Array<number>>;
+    /** 向量维度 */
+    readonly dims: number;
+}
+/**
+ * 工具语义检索器
+ *   默认使用关键词匹配(零依赖)，业务层可通过 setProvider() 替换为真实 embedding
+ */
+export declare class ToolRAG {
+    private _provider;
+    private readonly _index;
+    /** 是否已加载真实 embedding 提供者 */
+    get hasProvider(): boolean;
+    /** 设置嵌入提供者(可选，不设则使用内置关键词匹配) */
+    setProvider(provider: IEmbeddingProvider): void;
+    /** 索引一个工具(注册时调用) */
+    index(name: string, description: string): Promise<void>;
+    /** 移除工具索引 */
+    remove(name: string): void;
+    /**
+     * 检索最相关的 Top-K 个工具名
+     * @param query      用户输入
+     * @param candidates 候选工具定义(name + description)
+     * @param topK       返回数量
+     */
+    search(query: string, candidates: Array<{
+        name: string;
+        description: string;
+    }>, topK?: number): Promise<Array<string>>;
+    /** 基于嵌入向量的语义检索 */
+    private _semanticSearch;
+    /** 内置关键词匹配(零依赖) */
+    private _keywordSearch;
+}
+//# sourceMappingURL=ToolRAG.d.ts.map

package/module/ToolModule/ToolRAG.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRAG.d.ts","sourceRoot":"","sources":["../../../src/module/ToolModule/ToolRAG.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IAE/B,cAAc;IACd,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5C,WAAW;IACX,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AASD;;;GAGG;AACH,qBAAa,OAAO;IAEhB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAE7D,4BAA4B;IAC5B,IAAW,WAAW,IAAI,OAAO,CAAoC;IAErE,+BAA+B;IACxB,WAAW,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI;IAOtD,oBAAoB;IACP,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpE,aAAa;IACN,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKjC;;;;;OAKG;IACU,MAAM,CACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,EACxD,IAAI,GAAE,MAAW,GAClB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAWzB,kBAAkB;YACJ,eAAe;IAiB7B,mBAAmB;IACnB,OAAO,CAAC,cAAc;CA8BzB"}

package/module/ToolModule/ToolRAG.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRAG = void 0;
+/**
+ * 工具语义检索器
+ *   默认使用关键词匹配(零依赖)，业务层可通过 setProvider() 替换为真实 embedding
+ */
+class ToolRAG {
+    constructor() {
+        this._provider = null;
+        this._index = new Map();
+    }
+    /** 是否已加载真实 embedding 提供者 */
+    get hasProvider() { return this._provider !== null; }
+    /** 设置嵌入提供者(可选，不设则使用内置关键词匹配) */
+    setProvider(provider) {
+        this._provider = provider;
+        // 已有索引需要重建
+        this._index.clear();
+    }
+    /** 索引一个工具(注册时调用) */
+    async index(name, description) {
+        if (this._provider) {
+            const vector = await this._provider.embed(`${name}: ${description}`);
+            this._index.set(name, { name, vector });
+        }
+        // 关键词模式不需要索引，检索时实时计算
+        return Promise.resolve();
+    }
+    /** 移除工具索引 */
+    remove(name) {
+        this._index.delete(name);
+    }
+    /**
+     * 检索最相关的 Top-K 个工具名
+     * @param query      用户输入
+     * @param candidates 候选工具定义(name + description)
+     * @param topK       返回数量
+     */
+    async search(query, candidates, topK = 10) {
+        if (candidates.length <= topK) {
+            return candidates.map(c => c.name);
+        }
+        if (this._provider) {
+            return this._semanticSearch(query, candidates, topK);
+        }
+        return this._keywordSearch(query, candidates, topK);
+    }
+    /** 基于嵌入向量的语义检索 */
+    async _semanticSearch(query, candidates, topK) {
+        const queryVec = await this._provider.embed(query);
+        const scored = candidates.map(c => {
+            const entry = this._index.get(c.name);
+            const score = entry ? _cosineSimilarity(queryVec, entry.vector) : 0;
+            return { name: c.name, score };
+        });
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, topK).map(s => s.name);
+    }
+    /** 内置关键词匹配(零依赖) */
+    _keywordSearch(query, candidates, topK) {
+        const keywords = _tokenize(query);
+        if (keywords.length === 0) {
+            return candidates.slice(0, topK).map(c => c.name);
+        }
+        const scored = candidates.map(c => {
+            const nameTokens = _tokenize(c.name);
+            const descTokens = _tokenize(c.description);
+            let score = 0;
+            for (const kw of keywords) {
+                for (const nt of nameTokens) {
+                    if (nt.includes(kw) || kw.includes(nt)) {
+                        score += 3;
+                    }
+                }
+                for (const dt of descTokens) {
+                    if (dt.includes(kw) || kw.includes(dt)) {
+                        score += 1;
+                    }
+                }
+            }
+            return { name: c.name, score };
+        });
+        scored.sort((a, b) => b.score - a.score);
+        return scored.filter(s => s.score > 0).slice(0, topK).map(s => s.name);
+    }
+}
+exports.ToolRAG = ToolRAG;
+/** 简易分词(中文按单字、英文按词) */
+function _tokenize(text) {
+    const tokens = [];
+    // 提取中文字符
+    const cjk = text.match(/[一-鿿㐀-䶿]+/g);
+    if (cjk) {
+        for (const seg of cjk) {
+            // 中文按 1-2 字滑动窗口
+            for (let i = 0; i < seg.length; i++) {
+                tokens.push(seg.substring(i, i + 2));
+            }
+        }
+    }
+    // 提取英文/数字词
+    const en = text.match(/[a-zA-Z0-9_]+/g);
+    if (en) {
+        for (const w of en) {
+            if (w.length > 1) {
+                tokens.push(w.toLowerCase());
+            }
+        }
+    }
+    return tokens;
+}
+/** 余弦相似度 */
+function _cosineSimilarity(a, b) {
+    let dot = 0, normA = 0, normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+//# sourceMappingURL=ToolRAG.js.map

package/module/ToolModule/ToolRAG.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolRAG.js","sourceRoot":"","sources":["../../../src/module/ToolModule/ToolRAG.ts"],"names":[],"mappings":"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"}

package/module/ToolModule/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./ToolModule";
+export * from "./ToolRAG";
+//# sourceMappingURL=index.d.ts.map

package/module/ToolModule/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/module/ToolModule/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/module/ToolModule/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ToolModule"), exports);
+__exportStar(require("./ToolRAG"), exports);
+//# sourceMappingURL=index.js.map

package/module/ToolModule/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/module/ToolModule/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,4CAA0B"}

package/module/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./AgentModule";
+export * from "./ToolModule";
+export * from "./ReasonModule";
+export * from "./DialogModule";
+export * from "./SkillModule";
+//# sourceMappingURL=index.d.ts.map

package/module/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/module/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/module/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./AgentModule"), exports);
+__exportStar(require("./ToolModule"), exports);
+__exportStar(require("./ReasonModule"), exports);
+__exportStar(require("./DialogModule"), exports);
+__exportStar(require("./SkillModule"), exports);
+//# sourceMappingURL=index.js.map

package/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/module/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,+CAA6B;AAC7B,iDAA+B;AAC/B,iDAA+B;AAC/B,gDAA8B"}

package/package.json

@@ -0,0 +1,19 @@
+{
+    "name": "knight-agent",
+    "version": "1.1.0",
+    "description": "Knight-agent智能体架构",
+    "main": "index.js",
+    "scripts": {
+        "test": "echo \"Error: no test specified\" && exit 1",
+        "authToken": "npm config set //registry.npmjs.org/:_authToken=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",
+        "login": "npm login",
+        "publish": "npm publish"
+    },
+    "keywords": [
+        "knight",
+        "agent",
+        "knight-agent"
+    ],
+    "author": "ZiXuWang",
+    "license": "MIT"
+}

package/utility/InterfaceUtility.d.ts

@@ -0,0 +1,14 @@
+/** 接口模块 */
+export declare namespace InterfaceUtility {
+    /** 类型泛型接口(构造器签名接口) */
+    type IType<T> = new (...args: any[]) => T;
+    /** 行为类型泛型接口(类似于C#中的Action使用方法) */
+    interface IAction<T = any, K = any, M = any, N = any, Q = any, U = any, V = any, W = any> {
+        (t?: T, k?: K, m?: M, n?: N, q?: Q, u?: U, v?: V, w?: W): any;
+    }
+    /** 事件类型泛型接口(类似于C#中的Event使用方法) */
+    interface IEvent<T = any, K = any, M = any, N = any, Q = any, U = any, V = any, W = any> {
+        (t?: T, k?: K, m?: M, n?: N, q?: Q, u?: U, v?: V, w?: W): any;
+    }
+}
+//# sourceMappingURL=InterfaceUtility.d.ts.map

package/utility/InterfaceUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InterfaceUtility.d.ts","sourceRoot":"","sources":["../../src/utility/InterfaceUtility.ts"],"names":[],"mappings":"AACA,WAAW;AACX,yBAAiB,gBAAgB,CACjC;IACI,sBAAsB;IACtB,KAAY,KAAK,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IACjD,kCAAkC;IAClC,UAAiB,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG;QAE3F,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;KACjE;IACD,iCAAiC;IACjC,UAAiB,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG;QAE1F,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;KACjE;CACJ"}

package/utility/InterfaceUtility.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=InterfaceUtility.js.map

package/utility/InterfaceUtility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InterfaceUtility.js","sourceRoot":"","sources":["../../src/utility/InterfaceUtility.ts"],"names":[],"mappings":""}

package/utility/LogUtility.d.ts

@@ -0,0 +1,41 @@
+/*********************************************************************************
+  * FileName     : LogUtility
+  * FileBasename : LogUtility.ts
+  * Description  : 日志工具
+  * Version      : V1.0.0
+  * Date         : Wed Mar 02 2022 17:03:42 GMT+0800 (中国标准时间)
+  * Path         : db://assets/Script/Utility/LogUtility.ts
+  * Author       : Seven_9t
+  * Others       : 修改默认TS脚本模板路径 C:\CocosDashboard_1.0.12\resources\.editors\Creator\<Version>\resources\resources\3d\engine\editor\assets\default_file_content\ts
+  * ManualUrl    : <指南手册>    https://docs.cocos.com/creator/3.4/manual/zh/
+  *              : <脚本手册>    https://docs.cocos.com/creator/3.4/manual/zh/scripting/
+  *              : <CC类手册>    https://docs.cocos.com/creator/3.4/manual/zh/scripting/decorator.html
+  *              : <生命周期手册>https://docs.cocos.com/creator/3.4/manual/zh/scripting/life-cycle-callbacks.html
+
+**********************************************************************************/
+/** 日志工具 */
+export declare namespace LogUtility {
+    /** 是否开启日志 */
+    let Switch: boolean;
+    /** 是否显示堆栈信息 */
+    const Stack: boolean;
+    /** 系统名称 */
+    const Name: string;
+    /** 日志标签 */
+    const Flag: string;
+    /** 设置日志开关 */
+    function SetSwitch(_value: boolean): void;
+    /** 提示日志 */
+    function LogTip(..._message: any[]): void;
+    /** 信息日志*/
+    function LogInfo(..._message: any[]): void;
+    /** 警告日志 */
+    function LogWarning(..._message: any[]): void;
+    /** 错误日志 */
+    function LogError(..._message: any[]): void;
+    /** 系统日志 */
+    function LogSystem(..._message: any[]): void;
+    /** 输出日志 */
+    function Print(type: any, _head: string, _color: string, ..._message: any[]): void;
+}
+//# sourceMappingURL=LogUtility.d.ts.map

package/utility/LogUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogUtility.d.ts","sourceRoot":"","sources":["../../src/utility/LogUtility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;mFAcmF;AAEnF,WAAW;AACX,yBAAiB,UAAU,CAC3B;IACI,aAAa;IACN,IAAI,MAAM,EAAE,OAAc,CAAC;IAClC,eAAe;IACR,MAAM,KAAK,EAAE,OAAe,CAAC;IACpC,WAAW;IACJ,MAAM,IAAI,EAAE,MAAkB,CAAC;IACtC,WAAW;IACJ,MAAM,IAAI,EAAE,MAAgB,CAAC;IAEpC,aAAa;IACb,SAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,QAGxC;IACD,WAAW;IACX,SAAgB,MAAM,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,QAGxC;IACD,UAAU;IACV,SAAgB,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,QAGzC;IACD,WAAW;IACX,SAAgB,UAAU,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,QAG5C;IACD,WAAW;IACX,SAAgB,QAAQ,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,QAG1C;IACD,WAAW;IACX,SAAgB,SAAS,CAAC,GAAG,QAAQ,EAAE,GAAG,EAAE,QAG3C;IACD,WAAW;IACX,SAAgB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,QAKjF;CACJ"}

package/utility/LogUtility.js

@@ -0,0 +1,70 @@
+"use strict";
+/*********************************************************************************
+  * FileName     : LogUtility
+  * FileBasename : LogUtility.ts
+  * Description  : 日志工具
+  * Version      : V1.0.0
+  * Date         : Wed Mar 02 2022 17:03:42 GMT+0800 (中国标准时间)
+  * Path         : db://assets/Script/Utility/LogUtility.ts
+  * Author       : Seven_9t
+  * Others       : 修改默认TS脚本模板路径 C:\CocosDashboard_1.0.12\resources\.editors\Creator\<Version>\resources\resources\3d\engine\editor\assets\default_file_content\ts
+  * ManualUrl    : <指南手册>    https://docs.cocos.com/creator/3.4/manual/zh/
+  *              : <脚本手册>    https://docs.cocos.com/creator/3.4/manual/zh/scripting/
+  *              : <CC类手册>    https://docs.cocos.com/creator/3.4/manual/zh/scripting/decorator.html
+  *              : <生命周期手册>https://docs.cocos.com/creator/3.4/manual/zh/scripting/life-cycle-callbacks.html
+
+**********************************************************************************/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LogUtility = void 0;
+/** 日志工具 */
+var LogUtility;
+(function (LogUtility) {
+    /** 是否开启日志 */
+    LogUtility.Switch = true;
+    /** 是否显示堆栈信息 */
+    LogUtility.Stack = false;
+    /** 系统名称 */
+    LogUtility.Name = "⚡KNIGHT";
+    /** 日志标签 */
+    LogUtility.Flag = '⛓️‍💥';
+    /** 设置日志开关 */
+    function SetSwitch(_value) {
+        // LogUtility.Switch = _value;
+    }
+    LogUtility.SetSwitch = SetSwitch;
+    /** 提示日志 */
+    function LogTip(..._message) {
+        LogUtility.Print(console.log, "📣提示", '#19be6b', ..._message);
+    }
+    LogUtility.LogTip = LogTip;
+    /** 信息日志*/
+    function LogInfo(..._message) {
+        LogUtility.Print(console.info, "💬信息", '#2d8cf0', ..._message);
+    }
+    LogUtility.LogInfo = LogInfo;
+    /** 警告日志 */
+    function LogWarning(..._message) {
+        LogUtility.Print(console.warn, "⚠️警告", '#ff9900', ..._message);
+    }
+    LogUtility.LogWarning = LogWarning;
+    /** 错误日志 */
+    function LogError(..._message) {
+        LogUtility.Print(console.error, "☣️错误", '#ed4014', ..._message);
+    }
+    LogUtility.LogError = LogError;
+    /** 系统日志 */
+    function LogSystem(..._message) {
+        LogUtility.Print(console.warn, "⚙️系统", '#7825FF', ..._message);
+    }
+    LogUtility.LogSystem = LogSystem;
+    /** 输出日志 */
+    function Print(type, _head, _color, ..._message) {
+        if (!LogUtility.Switch) {
+            return;
+        }
+        const _format = [`[${LogUtility.Name}][${_head}]`, ..._message];
+        type(..._format);
+    }
+    LogUtility.Print = Print;
+})(LogUtility || (exports.LogUtility = LogUtility = {}));
+//# sourceMappingURL=LogUtility.js.map

package/utility/LogUtility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogUtility.js","sourceRoot":"","sources":["../../src/utility/LogUtility.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;mFAcmF;;;AAEnF,WAAW;AACX,IAAiB,UAAU,CAgD1B;AAhDD,WAAiB,UAAU;IAEvB,aAAa;IACF,iBAAM,GAAY,IAAI,CAAC;IAClC,eAAe;IACF,gBAAK,GAAY,KAAK,CAAC;IACpC,WAAW;IACE,eAAI,GAAW,SAAS,CAAC;IACtC,WAAW;IACE,eAAI,GAAW,OAAO,CAAC;IAEpC,aAAa;IACb,SAAgB,SAAS,CAAC,MAAe;QAErC,8BAA8B;IAClC,CAAC;IAHe,oBAAS,YAGxB,CAAA;IACD,WAAW;IACX,SAAgB,MAAM,CAAC,GAAG,QAAe;QAErC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;IAClE,CAAC;IAHe,iBAAM,SAGrB,CAAA;IACD,UAAU;IACV,SAAgB,OAAO,CAAC,GAAG,QAAe;QAEtC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;IACnE,CAAC;IAHe,kBAAO,UAGtB,CAAA;IACD,WAAW;IACX,SAAgB,UAAU,CAAC,GAAG,QAAe;QAEzC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;IACnE,CAAC;IAHe,qBAAU,aAGzB,CAAA;IACD,WAAW;IACX,SAAgB,QAAQ,CAAC,GAAG,QAAe;QAEvC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;IACpE,CAAC;IAHe,mBAAQ,WAGvB,CAAA;IACD,WAAW;IACX,SAAgB,SAAS,CAAC,GAAG,QAAe;QAExC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC;IACnE,CAAC;IAHe,oBAAS,YAGxB,CAAA;IACD,WAAW;IACX,SAAgB,KAAK,CAAC,IAAS,EAAE,KAAa,EAAE,MAAc,EAAE,GAAG,QAAe;QAE9E,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAAC,OAAO;QAAC,CAAC;QACnC,MAAM,OAAO,GAAa,CAAC,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC1E,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IACrB,CAAC;IALe,gBAAK,QAKpB,CAAA;AACL,CAAC,EAhDgB,UAAU,0BAAV,UAAU,QAgD1B"}