@dyyz1993/create-agent 1.9.0 → 2.0.0

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

@@ -0,0 +1,99 @@
+/**
+ * @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

@@ -0,0 +1,78 @@
+/**
+ * @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

@@ -0,0 +1,65 @@
+/**
+ * @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

@@ -0,0 +1,69 @@
+"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

@@ -0,0 +1,58 @@
+/**
+ * @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",
+              });
+            }
+          }
+        }
+      },
+    };
+  },
+};

package/templates/agent/eslint-plugin-rpc/rules/require-typed-register.js

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview 入口文件必须导入 registerAllHandlers
+ */
+"use strict";
+
+module.exports = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "入口文件必须导入并调用 registerAllHandlers",
+      category: "RPC Conventions",
+      recommended: "error",
+    },
+    messages: {
+      missingRegisterAllHandlersImport:
+        '入口文件必须导入 registerAllHandlers。请添加：import { registerAllHandlers } from "./shared/handlers/register-all-handlers";',
+      missingRegisterAllHandlersCall:
+        "已导入 registerAllHandlers 但未调用。请在创建 server 后调用 registerAllHandlers(server)。",
+    },
+    schema: [],
+  },
+
+  create(context) {
+    const filename = context.getFilename();
+
+    const isEntryPoint =
+      filename.endsWith("bun/index.ts") || filename.endsWith("gateway/ws-handler.ts");
+
+    if (!isEntryPoint) return {};
+
+    let hasRegisterAllHandlersImport = false;
+    let hasRegisterAllHandlersCall = false;
+    let importNode = null;
+
+    return {
+      ImportDeclaration(node) {
+        if (
+          node.source.type === "Literal" &&
+          typeof node.source.value === "string" &&
+          node.source.value.includes("register-all-handlers")
+        ) {
+          for (const specifier of node.specifiers) {
+            if (
+              specifier.type === "ImportSpecifier" &&
+              specifier.imported.name === "registerAllHandlers"
+            ) {
+              hasRegisterAllHandlersImport = true;
+              importNode = node;
+            }
+          }
+        }
+      },
+
+      CallExpression(node) {
+        if (
+          node.callee.type === "Identifier" &&
+          node.callee.name === "registerAllHandlers"
+        ) {
+          hasRegisterAllHandlersCall = true;
+        }
+      },
+
+      "Program:exit"() {
+        if (!hasRegisterAllHandlersImport) {
+          context.report({
+            loc: { line: 1, column: 0 },
+            messageId: "missingRegisterAllHandlersImport",
+          });
+        } else if (!hasRegisterAllHandlersCall) {
+          context.report({
+            node: importNode,
+            messageId: "missingRegisterAllHandlersCall",
+          });
+        }
+      },
+    };
+  },
+};

package/templates/agent/eslint-plugin-rpc/rules/schema-merge-only.js

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview rpc-schema.ts 只允许合并，禁止直接定义方法
+ */
+"use strict";
+
+module.exports = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "rpc-schema.ts 禁止直接定义方法，只允许 extends 合并",
+      category: "RPC Conventions",
+      recommended: "error",
+    },
+    messages: {
+      noDirectDefinition:
+        'rpc-schema.ts 中禁止直接定义方法 "{{key}}"。请在 src/shared/modules/ 下对应模块文件中定义，然后在此处 extends 合并。',
+    },
+    schema: [],
+  },
+
+  create(context) {
+    const filename = context.getFilename();
+
+    if (!filename.endsWith("rpc-schema.ts") && !filename.endsWith("rpc-schema.tsx")) return {};
+
+    const schemaInterfaces = new Set(["RPCMethods", "RPCEvents"]);
+
+    return {
+      TSInterfaceDeclaration(node) {
+        if (!schemaInterfaces.has(node.id.name)) return;
+
+        if (node.body && node.body.body) {
+          for (const member of node.body.body) {
+            if (member.type === "TSPropertySignature" && member.key) {
+              const keyName =
+                member.key.type === "Identifier"
+                  ? member.key.name
+                  : member.key.type === "Literal"
+                    ? String(member.key.value)
+                    : null;
+
+              if (keyName) {
+                context.report({
+                  node: member,
+                  messageId: "noDirectDefinition",
+                  data: { key: keyName },
+                });
+              }
+            }
+          }
+        }
+      },
+    };
+  },
+};

package/templates/agent/eslint.config.mjs

@@ -1,6 +1,6 @@
 import js from '@eslint/js';
 import tseslint from 'typescript-eslint';
-import rpcPlugin from '@dyyz1993/eslint-plugin-rpc';
+import rpcPlugin from './eslint-plugin-rpc/index.js';
 
 export default tseslint.config(
   js.configs.recommended,
@@ -10,6 +10,7 @@ export default tseslint.config(
       'node_modules/**',
       'build/**',
       'dist/**',
+      'eslint-plugin-rpc/**',
       'postcss.config.js',
       'tailwind.config.js',
     ],

package/templates/agent/package.json

@@ -33,8 +33,7 @@
 		"zustand": "^5.0.12"
 	},
 	"devDependencies": {
-		"@dyyz1993/eslint-plugin-rpc": "workspace:*",
-		"@eslint/js": "^9.0.0",
+			"@eslint/js": "^9.0.0",
 		"@testing-library/jest-dom": "^6.9.1",
 		"@testing-library/react": "^16.3.2",
 		"@testing-library/user-event": "^14.6.1",

package/templates/agent/src/mainview/components/layout/AppLayout.tsx

@@ -9,6 +9,7 @@ import { MobileTabBar } from "../activity-bar/MobileTabBar";
 import { ExplorerSidebar } from "../explorer/ExplorerSidebar";
 import { ChatPanel } from "../chat/ChatPanel";
 import { ThemeToggle } from "../common/ThemeToggle";
+import { LanguageSwitcher } from "../common/LanguageSwitcher";
 
 const GitPanel = React.lazy(() => import("../git/GitPanel").then((m) => ({ default: m.GitPanel })));
 const SearchPanel = React.lazy(() => import("../search/SearchPanel").then((m) => ({ default: m.SearchPanel })));
@@ -87,7 +88,8 @@ export function AppLayout({
             {mode === "desktop" ? t("app.mode.desktop") : t("app.mode.web")}
           </span>
           <span className="ml-3 text-[var(--color-text-tertiary)]">{t("app.title")}</span>
-          <div className="ml-auto">
+          <div className="ml-auto flex items-center gap-1">
+            <LanguageSwitcher />
             <ThemeToggle />
           </div>
         </div>

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

@@ -0,0 +1,50 @@
+/**
+ * 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/chat/eslint-plugin-rpc/package.json

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