重构启动脚本并添加欢迎页面模板

hotlong · hotlong · commit cf2e9d95efcd · 2026-01-16T23:56:00.000+08:00
diff --git a/examples/showcase/project-tracker/package.json b/examples/showcase/project-tracker/package.json
@@ -24,7 +24,8 @@
     "dist"
   ],
   "scripts": {
-    "start": "objectql serve --dir src",
+    "dev": "objectql dev --dir src",
+    "start": "objectql start --dir src",
     "seed": "ts-node src/seed.ts",
     "codegen": "objectql types -s src -o src/types",
     "build": "npm run codegen && tsc && rsync -a --include '*/' --include '*.yml' --exclude '*' src/ dist/",
diff --git a/packages/runtime/server/src/adapters/node.ts b/packages/runtime/server/src/adapters/node.ts
@@ -6,6 +6,7 @@ import { generateOpenAPI } from '../openapi';
 import { createFileUploadHandler, createBatchFileUploadHandler, createFileDownloadHandler } from '../file-handler';
 import { LocalFileStorage } from '../storage';
 import { escapeRegexPath } from '../utils';
+import { getWelcomePageHtml } from '../templates';
 
 /**
  * Options for createNodeHandler
@@ -241,6 +242,13 @@ export function createNodeHandler(app: IObjectQL, options?: NodeHandlerOptions)
 
         // Special case for root: since we accept POST / (RPC), correct response for GET / is 405
         if (pathName === '/') {
+            if (method === 'GET') {
+                res.setHeader('Content-Type', 'text/html; charset=utf-8');
+                res.statusCode = 200;
+                res.end(getWelcomePageHtml(routes));
+                return;
+            }
+
             res.setHeader('Allow', 'POST');
             res.statusCode = 405;
             res.end(JSON.stringify({ error: { code: ErrorCode.INVALID_REQUEST, message: 'Method Not Allowed. Use POST for JSON-RPC.' } }));
diff --git a/packages/runtime/server/src/templates.ts b/packages/runtime/server/src/templates.ts
@@ -0,0 +1,49 @@
+export function getWelcomePageHtml(routes: { rpc: string; data: string; }) {
+    return `<!DOCTYPE html>
+<html>
+<head>
+    <title>ObjectQL Server</title>
+    <style>
+        body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; max-width: 800px; margin: 40px auto; padding: 20px; line-height: 1.6; color: #333; }
+        h1 { margin-bottom: 10px; }
+        code { background: #f4f4f4; padding: 2px 5px; border-radius: 3px; font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace; }
+        .card { border: 1px solid #e1e4e8; border-radius: 6px; padding: 24px; margin-top: 24px; box-shadow: 0 1px 3px rgba(0,0,0,0.04); }
+        .status { color: #28a745; font-weight: 600; display: inline-flex; align-items: center; }
+        .status::before { content: ""; display: inline-block; width: 10px; height: 10px; background: #28a745; border-radius: 50%; margin-right: 8px; }
+        a { color: #0366d6; text-decoration: none; }
+        a:hover { text-decoration: underline; }
+        ul { list-style-type: none; padding: 0; }
+        li { padding: 8px 0; border-bottom: 1px solid #f1f1f1; }
+        li:last-child { border-bottom: none; }
+    </style>
+</head>
+<body>
+    <div style="margin-bottom: 20px;">
+        <span class="status">Running</span>
+    </div>
+    <h1>ObjectQL Server</h1>
+    <p>The server is operational and ready to accept requests.</p>
+    
+    <div class="card">
+        <h3 style="margin-top: 0">API Endpoints</h3>
+        <ul>
+            <li><strong>JSON-RPC:</strong> <code>POST ${routes.rpc}</code></li>
+            <li><strong>REST API:</strong> <code>GET ${routes.data}/:object</code></li>
+            <li><strong>OpenAPI Spec:</strong> <a href="/openapi.json">/openapi.json</a></li>
+        </ul>
+    </div>
+
+    <div class="card">
+        <h3 style="margin-top: 0">Useful Links</h3>
+        <ul>
+            <li><a href="https://objectql.org/docs" target="_blank">Documentation</a></li>
+            <li><a href="https://github.com/objectql/objectql" target="_blank">GitHub Repository</a></li>
+        </ul>
+    </div>
+    
+    <p style="margin-top: 40px; color: #666; font-size: 0.85em; text-align: center;">
+        Powered by <strong>ObjectQL</strong>
+    </p>
+</body>
+</html>`;
+}
