@zhin.js/plugin-code-runner 0.0.1

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

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

package/lib/index.js

@@ -0,0 +1,109 @@
+/**
+ * @zhin.js/plugin-code-runner
+ *
+ * 沙箱代码执行插件 —— 通过 glot.io API 安全运行代码片段
+ *
+ * 功能：
+ *   - AI 工具 run_code：AI 可调用执行代码
+ *   - 命令「运行 <language> <code>」：用户直接运行代码
+ *
+ * 安全：
+ *   - 代码长度上限 10000 字符
+ *   - 语言白名单校验
+ *   - 不执行本地代码，全部通过 glot.io 远程沙箱
+ */
+import { usePlugin, MessageCommand, ZhinTool } from 'zhin.js';
+const { addCommand, addTool, logger } = usePlugin();
+// ─── 常量 ────────────────────────────────────────────────────────────────────
+const MAX_CODE_LENGTH = 10000;
+const SUPPORTED_LANGUAGES = {
+    python: 'main.py',
+    javascript: 'main.js',
+    typescript: 'main.ts',
+    go: 'main.go',
+    rust: 'main.rs',
+    java: 'Main.java',
+    c: 'main.c',
+    cpp: 'main.cpp',
+    ruby: 'main.rb',
+    php: 'main.php',
+};
+const GLOT_API_BASE = 'https://glot.io/api/run';
+async function runCode(language, code) {
+    const lang = language.toLowerCase().trim();
+    if (!SUPPORTED_LANGUAGES[lang]) {
+        return {
+            stdout: '',
+            stderr: '',
+            error: `不支持的语言: ${lang}。支持: ${Object.keys(SUPPORTED_LANGUAGES).join(', ')}`,
+        };
+    }
+    if (code.length > MAX_CODE_LENGTH) {
+        return {
+            stdout: '',
+            stderr: '',
+            error: `代码长度超过上限 ${MAX_CODE_LENGTH} 字符（当前 ${code.length}）`,
+        };
+    }
+    const fileName = SUPPORTED_LANGUAGES[lang];
+    const url = `${GLOT_API_BASE}/${lang}/latest`;
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                files: [{ name: fileName, content: code }],
+            }),
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!response.ok) {
+            return {
+                stdout: '',
+                stderr: '',
+                error: `API 请求失败: ${response.status} ${response.statusText}`,
+            };
+        }
+        const data = (await response.json());
+        return {
+            stdout: data.stdout || '',
+            stderr: data.stderr || '',
+            error: data.error || '',
+        };
+    }
+    catch (e) {
+        const msg = e?.name === 'TimeoutError' ? '请求超时（30s）' : e?.message || '未知错误';
+        return { stdout: '', stderr: '', error: msg };
+    }
+}
+function formatResult(result) {
+    const parts = [];
+    if (result.stdout)
+        parts.push(`[stdout]\n${result.stdout}`);
+    if (result.stderr)
+        parts.push(`[stderr]\n${result.stderr}`);
+    if (result.error)
+        parts.push(`[error]\n${result.error}`);
+    return parts.length ? parts.join('\n') : '（无输出）';
+}
+// ─── AI Tool: run_code ───────────────────────────────────────────────────────
+addTool(new ZhinTool('run_code')
+    .desc('在沙箱中运行代码片段，返回 stdout/stderr/error')
+    .keyword('运行代码', '执行代码', 'run code', 'execute', '代码')
+    .tag('code', 'run', 'execute', 'sandbox')
+    .param('language', { type: 'string', description: '编程语言（python/javascript/typescript/go/rust/java/c/cpp/ruby/php）' }, true)
+    .param('code', { type: 'string', description: '要执行的代码' }, true)
+    .execute(async (args) => {
+    const result = await runCode(args.language, args.code);
+    return formatResult(result);
+})
+    .toTool());
+// ─── 命令: 运行 ─────────────────────────────────────────────────────────────
+addCommand(new MessageCommand('运行 <language:text> <code:text>')
+    .desc('在沙箱中运行代码片段')
+    .action(async (_message, result) => {
+    const { language, code } = result.params;
+    logger.info(`运行代码: language=${language}, length=${code.length}`);
+    const res = await runCode(language, code);
+    return formatResult(res);
+}));
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@zhin.js/plugin-code-runner",
+  "version": "0.0.1",
+  "description": "Sandboxed code execution plugin for Zhin.js — run code snippets via AI or command",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "development": "./src/index.ts",
+      "import": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": ["src", "lib", "README.md"],
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rimraf lib"
+  },
+  "keywords": ["zhin", "zhin.js", "bot", "plugin", "code-runner", "sandbox", "execute"],
+  "author": { "name": "lc-cn", "email": "admin@liucl.cn", "url": "https://github.com/lc-cn" },
+  "license": "MIT",
+  "dependencies": {},
+  "devDependencies": { "typescript": "^5.9.3", "zhin.js": "workspace:*" },
+  "peerDependencies": { "zhin.js": ">=1.0.60" },
+  "repository": { "type": "git", "url": "git+https://github.com/zhinjs/zhin.git", "directory": "plugins/utils/code-runner" },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}

package/src/index.ts

@@ -0,0 +1,133 @@
+/**
+ * @zhin.js/plugin-code-runner
+ *
+ * 沙箱代码执行插件 —— 通过 glot.io API 安全运行代码片段
+ *
+ * 功能：
+ *   - AI 工具 run_code：AI 可调用执行代码
+ *   - 命令「运行 <language> <code>」：用户直接运行代码
+ *
+ * 安全：
+ *   - 代码长度上限 10000 字符
+ *   - 语言白名单校验
+ *   - 不执行本地代码，全部通过 glot.io 远程沙箱
+ */
+import { usePlugin, MessageCommand, ZhinTool } from 'zhin.js'
+
+const { addCommand, addTool, logger } = usePlugin()
+
+// ─── 常量 ────────────────────────────────────────────────────────────────────
+
+const MAX_CODE_LENGTH = 10000
+
+const SUPPORTED_LANGUAGES: Record<string, string> = {
+  python: 'main.py',
+  javascript: 'main.js',
+  typescript: 'main.ts',
+  go: 'main.go',
+  rust: 'main.rs',
+  java: 'Main.java',
+  c: 'main.c',
+  cpp: 'main.cpp',
+  ruby: 'main.rb',
+  php: 'main.php',
+}
+
+const GLOT_API_BASE = 'https://glot.io/api/run'
+
+// ─── 核心执行函数 ────────────────────────────────────────────────────────────
+
+interface RunResult {
+  stdout: string
+  stderr: string
+  error: string
+}
+
+async function runCode(language: string, code: string): Promise<RunResult> {
+  const lang = language.toLowerCase().trim()
+
+  if (!SUPPORTED_LANGUAGES[lang]) {
+    return {
+      stdout: '',
+      stderr: '',
+      error: `不支持的语言: ${lang}。支持: ${Object.keys(SUPPORTED_LANGUAGES).join(', ')}`,
+    }
+  }
+
+  if (code.length > MAX_CODE_LENGTH) {
+    return {
+      stdout: '',
+      stderr: '',
+      error: `代码长度超过上限 ${MAX_CODE_LENGTH} 字符（当前 ${code.length}）`,
+    }
+  }
+
+  const fileName = SUPPORTED_LANGUAGES[lang]
+  const url = `${GLOT_API_BASE}/${lang}/latest`
+
+  try {
+    const response = await fetch(url, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        files: [{ name: fileName, content: code }],
+      }),
+      signal: AbortSignal.timeout(30_000),
+    })
+
+    if (!response.ok) {
+      return {
+        stdout: '',
+        stderr: '',
+        error: `API 请求失败: ${response.status} ${response.statusText}`,
+      }
+    }
+
+    const data = (await response.json()) as RunResult
+    return {
+      stdout: data.stdout || '',
+      stderr: data.stderr || '',
+      error: data.error || '',
+    }
+  } catch (e: any) {
+    const msg = e?.name === 'TimeoutError' ? '请求超时（30s）' : e?.message || '未知错误'
+    return { stdout: '', stderr: '', error: msg }
+  }
+}
+
+function formatResult(result: RunResult): string {
+  const parts: string[] = []
+  if (result.stdout) parts.push(`[stdout]\n${result.stdout}`)
+  if (result.stderr) parts.push(`[stderr]\n${result.stderr}`)
+  if (result.error) parts.push(`[error]\n${result.error}`)
+  return parts.length ? parts.join('\n') : '（无输出）'
+}
+
+// ─── AI Tool: run_code ───────────────────────────────────────────────────────
+
+addTool(
+  new ZhinTool('run_code')
+    .desc('在沙箱中运行代码片段，返回 stdout/stderr/error')
+    .keyword('运行代码', '执行代码', 'run code', 'execute', '代码')
+    .tag('code', 'run', 'execute', 'sandbox')
+    .param('language', { type: 'string', description: '编程语言（python/javascript/typescript/go/rust/java/c/cpp/ruby/php）' }, true)
+    .param('code', { type: 'string', description: '要执行的代码' }, true)
+    .execute(async (args) => {
+      const result = await runCode(args.language, args.code)
+      return formatResult(result)
+    })
+    .toTool(),
+)
+
+// ─── 命令: 运行 ─────────────────────────────────────────────────────────────
+
+addCommand(
+  new MessageCommand('运行 <language:text> <code:text>')
+    .desc('在沙箱中运行代码片段')
+    .action(async (_message, result) => {
+      const { language, code } = result.params as { language: string; code: string }
+      logger.info(`运行代码: language=${language}, length=${code.length}`)
+      const res = await runCode(language, code)
+      return formatResult(res)
+    }),
+)