@dyyz1993/create-agent 2.0.0 → 2.1.0

package/templates/shared/logger.ts

@@ -0,0 +1,129 @@
+import { appendFile, mkdir as mkdirAsync, readdir as readdirAsync, unlink as unlinkAsync, stat as statAsync } from "fs/promises";
+import { existsSync, mkdirSync } from "fs";
+import { join } from "path";
+
+export type LogLevel = "debug" | "info" | "warn" | "error";
+
+interface LogEntry {
+  timestamp: string;
+  level: LogLevel;
+  module: string;
+  message: string;
+  data?: Record<string, unknown>;
+}
+
+let _logDir: string | null = null;
+let _maxAgeDays = 30;
+
+export function configureLogDir(dir: string, options?: { maxAgeDays?: number }): void {
+  _logDir = dir;
+  if (options?.maxAgeDays !== undefined) {
+    _maxAgeDays = options.maxAgeDays;
+  }
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  cleanOldLogs(dir, _maxAgeDays);
+}
+
+function getLogDir(): string {
+  if (!_logDir) {
+    _logDir = "logs";
+    if (!existsSync(_logDir)) {
+      mkdirSync(_logDir, { recursive: true });
+    }
+  }
+  return _logDir;
+}
+
+async function cleanOldLogs(dir: string, maxAgeDays: number): Promise<void> {
+  try {
+    if (!existsSync(dir)) return;
+    const files = await readdirAsync(dir);
+    const cutoff = Date.now() - maxAgeDays * 86400000;
+    for (const f of files) {
+      if (!f.endsWith(".log")) continue;
+      const filePath = join(dir, f);
+      const s = await statAsync(filePath);
+      if (s.mtimeMs < cutoff) {
+        await unlinkAsync(filePath);
+      }
+    }
+  } catch { /* ignore */ }
+}
+
+function formatLine(entry: LogEntry): string {
+  const base = `[${entry.timestamp}] [${entry.level.toUpperCase()}] [${entry.module}] ${entry.message}`;
+  return entry.data ? `${base} ${JSON.stringify(entry.data)}` : base;
+}
+
+let writeQueue: Promise<void> = Promise.resolve();
+
+function writeToFile(line: string): void {
+  writeQueue = writeQueue.then(async () => {
+    try {
+      const date = new Date().toISOString().slice(0, 10);
+      const dir = getLogDir();
+      if (!existsSync(dir)) {
+        await mkdirAsync(dir, { recursive: true });
+      }
+      await appendFile(join(dir, `${date}.log`), `${line}\n`);
+    } catch { /* ignore */ }
+  });
+}
+
+export class Logger {
+  private readonly module: string;
+
+  constructor(module: string) {
+    this.module = module;
+  }
+
+  debug(message: string, data?: Record<string, unknown>): void {
+    this.write("debug", message, data);
+  }
+
+  info(message: string, data?: Record<string, unknown>): void {
+    this.write("info", message, data);
+  }
+
+  warn(message: string, data?: Record<string, unknown>): void {
+    this.write("warn", message, data);
+  }
+
+  error(message: string, data?: Record<string, unknown>): void {
+    this.write("error", message, data);
+  }
+
+  private write(level: LogLevel, message: string, data?: Record<string, unknown>): void {
+    const entry: LogEntry = {
+      timestamp: new Date().toISOString(),
+      level,
+      module: this.module,
+      message,
+      ...(data ? { data } : {}),
+    };
+
+    const line = formatLine(entry);
+
+    if (level === "error") {
+      console.error(line);
+    } else if (level === "warn") {
+      console.warn(line);
+    } else {
+      console.log(line);
+    }
+
+    if (process.env.NODE_ENV !== "production" || level !== "debug") {
+      writeToFile(line);
+    }
+  }
+}
+
+export function createLogger(module: string): Logger {
+  return new Logger(module);
+}
+
+export function flushLogs(): Promise<void> {
+  return writeQueue;
+}

package/templates/shared/vite-base.config.ts

@@ -0,0 +1,92 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import { resolve } from "path";
+import { readFileSync, existsSync } from "fs";
+export function createViteConfig(dirname: string) {
+	const PORT_FILE = resolve(dirname, ".server-port");
+
+	function getBackendPort(): number {
+		if (existsSync(PORT_FILE)) {
+			try {
+				return parseInt(readFileSync(PORT_FILE, "utf-8").trim());
+			} catch {
+				/* fall through */
+			}
+		}
+		return parseInt(process.env.PORT || "3100");
+	}
+
+	const backendPort = getBackendPort();
+
+	return defineConfig({
+		plugins: [react()],
+		root: "src/mainview",
+		build: {
+			outDir: "../../dist",
+			emptyOutDir: true,
+			target: "es2020",
+			cssMinify: true,
+			minify: "esbuild",
+			reportCompressedSize: true,
+			chunkSizeWarningLimit: 1000,
+			rollupOptions: {
+				output: {
+					manualChunks: {
+						"vendor-react": ["react", "react-dom"],
+						"vendor-state": ["zustand"],
+						"vendor-i18n": ["i18next", "react-i18next"],
+					},
+					compact: true,
+				},
+			},
+		},
+		css: {
+			devSourcemap: false,
+		},
+		server: {
+			port: parseInt(process.env.VITE_PORT || "5173"),
+			strictPort: false,
+			watch: {
+				ignored: [".workspace/**"],
+			},
+			proxy: {
+				"/health": {
+					target: `http://localhost:${backendPort}`,
+					changeOrigin: true,
+				},
+				"/info": {
+					target: `http://localhost:${backendPort}`,
+					changeOrigin: true,
+				},
+				"/file": {
+					target: `http://localhost:${backendPort}`,
+					changeOrigin: true,
+				},
+				"/upload": {
+					target: `http://localhost:${backendPort}`,
+					changeOrigin: true,
+				},
+				"/api": {
+					target: `http://localhost:${backendPort}`,
+					changeOrigin: true,
+					ws: true,
+				},
+				"/ws": { target: `ws://localhost:${backendPort}`, ws: true },
+			},
+		},
+		resolve: {
+			alias: {
+				"@dyyz1993/rpc-core": resolve(
+					dirname,
+					"..",
+					"..",
+					"packages",
+					"rpc-core",
+					"src",
+					"index.ts"
+				),
+				"@shared": resolve(dirname, "..", "shared"),
+			},
+		},
+	});
+}

package/templates/shared/vitest-base.config.ts

@@ -0,0 +1,42 @@
+import { defineConfig } from "vitest/config";
+import react from "@vitejs/plugin-react";
+import { resolve } from "path";
+
+export function createVitestConfig(dirname: string) {
+	return defineConfig({
+		plugins: [react()],
+		test: {
+			globals: true,
+			environment: "happy-dom",
+			setupFiles: ["./src/mainview/__tests__/setup.ts"],
+			include: [
+				"src/mainview/**/*.{test,spec}.{ts,tsx}",
+				"src/shared/**/*.{test,spec}.{ts,tsx}",
+				"src/__tests__/**/*.{test,spec}.{ts,tsx}",
+				"src/gateway/**/*.{test,spec}.{ts,tsx}",
+				"../shared/**/*.{test,spec}.{ts,tsx}",
+			],
+			css: false,
+			coverage: {
+				provider: "v8",
+				reporter: ["text", "lcov"],
+				include: ["src/mainview/**/*.{ts,tsx}"],
+				exclude: ["src/mainview/**/types/**", "src/mainview/**/*.d.ts", "src/mainview/main.tsx"],
+			},
+		},
+		resolve: {
+			alias: {
+				"@dyyz1993/rpc-core": resolve(
+					dirname,
+					"..",
+					"..",
+					"packages",
+					"rpc-core",
+					"src",
+					"index.ts"
+				),
+				"@shared": resolve(dirname, "..", "shared"),
+			},
+		},
+	});
+}

package/templates/agent/eslint-plugin-rpc/index.js

@@ -1,50 +0,0 @@
-/**
- * eslint-plugin-rpc — RPC 模块化规范 ESLint 插件（单注册架构）
- *
- * 规则列表：
- *   - rpc/no-bare-method          : 方法名必须使用 module.action 格式
- *   - rpc/no-direct-register      : server.register() 只允许在 handlers/ 目录内使用
- *   - rpc/schema-merge-only       : rpc-schema.ts 禁止直接定义方法
- *   - rpc/module-file-naming      : 模块文件命名、导出、方法前缀强制规范
- *   - rpc/require-typed-register  : 入口文件必须导入 registerAllHandlers
- *   - rpc/require-api-client      : 前端必须通过 apiClient 调用 RPC
- */
-"use strict";
-
-const noBareMethod = require("./rules/no-bare-method");
-const noDirectRegister = require("./rules/no-direct-register");
-const schemaMergeOnly = require("./rules/schema-merge-only");
-const moduleFileNaming = require("./rules/module-file-naming");
-const requireTypedRegister = require("./rules/require-typed-register");
-const requireApiClient = require("./rules/require-api-client");
-const noHardcodedStrings = require("./rules/no-hardcoded-strings");
-
-module.exports = {
-  meta: {
-    name: "eslint-plugin-rpc",
-    version: "1.0.0",
-  },
-  rules: {
-    "no-bare-method": noBareMethod,
-    "no-direct-register": noDirectRegister,
-    "schema-merge-only": schemaMergeOnly,
-    "module-file-naming": moduleFileNaming,
-    "require-typed-register": requireTypedRegister,
-    "require-api-client": requireApiClient,
-    "no-hardcoded-strings": noHardcodedStrings,
-  },
-  configs: {
-    recommended: {
-      plugins: ["rpc"],
-      rules: {
-        "rpc/no-bare-method": "error",
-        "rpc/no-direct-register": "error",
-        "rpc/schema-merge-only": "error",
-        "rpc/module-file-naming": "error",
-        "rpc/require-typed-register": "error",
-        "rpc/require-api-client": "error",
-        "rpc/no-hardcoded-strings": "warn",
-      },
-    },
-  },
-};

package/templates/agent/eslint-plugin-rpc/package.json

@@ -1,6 +0,0 @@
-{
-  "name": "@dyyz1993/eslint-plugin-rpc",
-  "version": "1.0.0",
-  "private": true,
-  "main": "index.js"
-}

package/templates/agent/eslint-plugin-rpc/rules/module-file-naming.js

@@ -1,99 +0,0 @@
-/**
- * @fileoverview 强制 RPC 模块文件的命名和导出规范
- */
-"use strict";
-
-function getModuleName(filename) {
-  const match = filename.match(/\/modules\/([^/]+)\.[jt]sx?$/);
-  return match ? match[1] : null;
-}
-
-module.exports = {
-  meta: {
-    type: "problem",
-    docs: {
-      description: "RPC 模块文件必须遵循命名和导出规范",
-      category: "RPC Conventions",
-      recommended: "error",
-    },
-    messages: {
-      missingMethodsExport:
-        '模块文件 "{{file}}" 必须导出 "{{ModuleName}}Methods" 接口。',
-      methodPrefixMismatch:
-        '方法 "{{method}}" 的前缀不匹配模块 "{{module}}"。必须以 "{{module}}." 开头。',
-      eventPrefixMismatch:
-        '事件 "{{event}}" 的前缀不匹配模块 "{{module}}"。必须以 "{{module}}." 开头。',
-    },
-    schema: [],
-  },
-
-  create(context) {
-    const filename = context.getFilename();
-    const moduleName = getModuleName(filename);
-    if (!moduleName) return {};
-
-    const moduleNamePascal = moduleName
-      .split(/[-_]/)
-      .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
-      .join("");
-
-    let hasMethodsExport = false;
-
-    return {
-      TSInterfaceDeclaration(node) {
-        const name = node.id.name;
-
-        if (name === `${moduleNamePascal}Methods`) {
-          hasMethodsExport = true;
-
-          if (node.body && node.body.body) {
-            for (const member of node.body.body) {
-              if (member.type === "TSPropertySignature" && member.key) {
-                const key =
-                  member.key.type === "Literal" ? String(member.key.value) : null;
-                if (key && !key.startsWith(`${moduleName}.`)) {
-                  context.report({
-                    node: member,
-                    messageId: "methodPrefixMismatch",
-                    data: { method: key, module: moduleName },
-                  });
-                }
-              }
-            }
-          }
-        }
-
-        if (name === `${moduleNamePascal}Events`) {
-          if (node.body && node.body.body) {
-            for (const member of node.body.body) {
-              if (member.type === "TSPropertySignature" && member.key) {
-                const key =
-                  member.key.type === "Literal" ? String(member.key.value) : null;
-                if (key && !key.startsWith(`${moduleName}.`)) {
-                  context.report({
-                    node: member,
-                    messageId: "eventPrefixMismatch",
-                    data: { event: key, module: moduleName },
-                  });
-                }
-              }
-            }
-          }
-        }
-      },
-
-      "Program:exit"() {
-        if (!hasMethodsExport) {
-          context.report({
-            loc: { line: 1, column: 0 },
-            messageId: "missingMethodsExport",
-            data: {
-              file: filename.split("/").pop(),
-              ModuleName: moduleNamePascal,
-            },
-          });
-        }
-      },
-    };
-  },
-};

package/templates/agent/eslint-plugin-rpc/rules/no-bare-method.js

@@ -1,78 +0,0 @@
-/**
- * @fileoverview 禁止使用裸方法名（无模块前缀）
- */
-"use strict";
-
-const METHOD_CALL_PATTERNS = [
-  { calleePattern: /^register$/, argIndex: 0 },
-  { calleePattern: /\.call$/, argIndex: 0 },
-  { calleePattern: /\.subscribe$/, argIndex: 0 },
-  { calleePattern: /\.emitEvent$/, argIndex: 0 },
-];
-
-function isModuleMethodName(name) {
-  const parts = name.split(".");
-  return parts.length === 2 && parts[0].length > 0 && parts[1].length > 0;
-}
-
-module.exports = {
-  meta: {
-    type: "problem",
-    docs: {
-      description: "RPC 方法名必须使用 module.action 格式（禁止裸方法名）",
-      category: "RPC Conventions",
-      recommended: "error",
-    },
-    messages: {
-      bareMethod:
-        'RPC 方法名 "{{name}}" 缺少模块前缀。必须使用 "module.action" 格式，如 "{{suggestion}}"。',
-      invalidFormat:
-        'RPC 方法名 "{{name}}" 格式错误。必须使用 "module.action" 格式（单一 "." 分隔）。',
-    },
-    schema: [],
-  },
-
-  create(context) {
-    const filename = context.getFilename();
-
-    if (!/\.[jt]sx?$/.test(filename)) return {};
-
-    return {
-      CallExpression(node) {
-        const { callee, arguments: args } = node;
-
-        let calleeText = "";
-        if (callee.type === "Identifier") {
-          calleeText = callee.name;
-        } else if (callee.type === "MemberExpression" && callee.property.type === "Identifier") {
-          calleeText = `.${callee.property.name}`;
-        }
-
-        for (const pattern of METHOD_CALL_PATTERNS) {
-          if (!pattern.calleePattern.test(calleeText)) continue;
-          if (args.length <= pattern.argIndex) continue;
-
-          const arg = args[pattern.argIndex];
-          if (arg.type !== "Literal" || typeof arg.value !== "string") continue;
-
-          const methodName = arg.value;
-
-          if (!methodName.includes(".")) {
-            const suggestion = `module.${methodName}`;
-            context.report({
-              node: arg,
-              messageId: "bareMethod",
-              data: { name: methodName, suggestion },
-            });
-          } else if (!isModuleMethodName(methodName)) {
-            context.report({
-              node: arg,
-              messageId: "invalidFormat",
-              data: { name: methodName },
-            });
-          }
-        }
-      },
-    };
-  },
-};

package/templates/agent/eslint-plugin-rpc/rules/no-direct-register.js

@@ -1,65 +0,0 @@
-/**
- * @fileoverview server.register() 只允许在 shared/handlers/ 目录内使用
- */
-"use strict";
-
-module.exports = {
-  meta: {
-    type: "problem",
-    docs: {
-      description:
-        "server.register() 只允许在 shared/handlers/ 目录内使用，入口文件和其他文件禁止直接调用",
-      category: "RPC Conventions",
-      recommended: "error",
-    },
-    messages: {
-      noDirectRegisterInEntry:
-        "入口文件禁止直接调用 server.register()。请导入并使用 registerAllHandlers() 统一注册 handler。",
-      noDirectRegisterGeneral:
-        "禁止直接调用 server.register()。Handler 注册只能在 shared/handlers/ 目录内的文件中进行。",
-    },
-    schema: [],
-  },
-
-  create(context) {
-    const filename = context.getFilename();
-
-    if (!/src\/.*\.[jt]sx?$/.test(filename)) return {};
-
-    if (filename.includes("shared/handlers/")) return {};
-
-    const isEntryPoint =
-      filename.endsWith("bun/index.ts") || filename.endsWith("server.ts");
-
-    return {
-      CallExpression(node) {
-        const { callee } = node;
-
-        if (
-          callee.type === "MemberExpression" &&
-          callee.property.type === "Identifier" &&
-          callee.property.name === "register" &&
-          callee.object.type === "Identifier"
-        ) {
-          const objectName = callee.object.name;
-
-          const serverVarNames = [
-            "server",
-            "rpcServer",
-            "rpc",
-            "rpc_server",
-          ];
-
-          if (serverVarNames.includes(objectName)) {
-            context.report({
-              node,
-              messageId: isEntryPoint
-                ? "noDirectRegisterInEntry"
-                : "noDirectRegisterGeneral",
-            });
-          }
-        }
-      },
-    };
-  },
-};

package/templates/agent/eslint-plugin-rpc/rules/no-hardcoded-strings.js

@@ -1,69 +0,0 @@
-"use strict";
-
-module.exports = {
-  meta: {
-    type: "suggestion",
-    docs: {
-      description: "disallow hardcoded strings in JSX (use i18n t() instead)",
-      category: "Best Practices",
-      recommended: false,
-    },
-    fixable: null,
-    schema: [
-      {
-        type: "object",
-        properties: {
-          ignoreAttributes: {
-            type: "array",
-            items: { type: "string" },
-          },
-          ignoreComponents: {
-            type: "array",
-            items: { type: "string" },
-          },
-        },
-        additionalProperties: false,
-      },
-    ],
-    messages: {
-      hardcodedString:
-        'Hardcoded string "{{text}}" should use i18n translation (t()).',
-    },
-  },
-
-  create(context) {
-    const options = context.options[0] || {};
-    const ignoreAttributes = new Set(options.ignoreAttributes || ["className", "style", "id", "key", "ref", "type", "name", "data-testid", "viewBox", "d", "points", "x1", "x2", "y1", "y2", "strokeWidth", "strokeLinecap", "strokeLinejoin", "fill", "stroke", "xmlns"]);
-    new Set(options.ignoreComponents || []);
-
-    return {
-      JSXText(node) {
-        const text = node.value.trim();
-        if (text.length > 1 && /[a-zA-Z]{2,}/.test(text)) {
-          context.report({
-            node,
-            messageId: "hardcodedString",
-            data: { text },
-          });
-        }
-      },
-      JSXAttribute(node) {
-        if (ignoreAttributes.has(node.name.name)) return;
-        if (
-          node.value &&
-          node.value.type === "Literal" &&
-          typeof node.value.value === "string"
-        ) {
-          const text = node.value.value.trim();
-          if (text.length > 3 && /[a-zA-Z]{3,}/.test(text) && !text.startsWith("var(") && !text.startsWith("bg-") && !text.startsWith("text-") && !text.startsWith("border-")) {
-            context.report({
-              node,
-              messageId: "hardcodedString",
-              data: { text },
-            });
-          }
-        }
-      },
-    };
-  },
-};

package/templates/agent/eslint-plugin-rpc/rules/require-api-client.js

@@ -1,58 +0,0 @@
-/**
- * @fileoverview 强制前端使用 apiClient 进行 RPC 调用
- */
-"use strict";
-
-module.exports = {
-  meta: {
-    type: "problem",
-    docs: {
-      description: "前端 RPC 调用必须通过 apiClient",
-      category: "RPC Conventions",
-      recommended: "error",
-    },
-    messages: {
-      useApiClient:
-        "前端 RPC 调用必须通过 apiClient.call() / apiClient.subscribe()。禁止直接操作 WebSocket 或其他传输层。",
-    },
-    schema: [],
-  },
-
-  create(context) {
-    const filename = context.getFilename();
-
-    if (!/mainview\/.*\.[jt]sx?$/.test(filename)) return {};
-
-    return {
-      NewExpression(node) {
-        if (
-          node.callee.type === "Identifier" &&
-          node.callee.name === "WebSocket"
-        ) {
-          context.report({
-            node,
-            messageId: "useApiClient",
-          });
-        }
-      },
-
-      CallExpression(node) {
-        if (
-          node.callee.type === "MemberExpression" &&
-          node.callee.property.type === "Identifier" &&
-          node.callee.property.name === "send"
-        ) {
-          if (node.callee.object.type === "Identifier") {
-            const objName = node.callee.object.name.toLowerCase();
-            if (objName.includes("websocket") || objName.includes("ws")) {
-              context.report({
-                node,
-                messageId: "useApiClient",
-              });
-            }
-          }
-        }
-      },
-    };
-  },
-};