zero-workspace 0.0.2

package/dist/http/server.d.ts

@@ -0,0 +1,10 @@
+import { FastifyInstance } from "fastify";
+/**
+ * 创建并配置 Fastify 服务器
+ */
+export declare function createServer(): Promise<FastifyInstance>;
+/**
+ * 启动服务器
+ */
+export declare function startServer(port?: number): Promise<FastifyInstance>;
+//# sourceMappingURL=server.d.ts.map

package/dist/http/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/http/server.ts"],"names":[],"mappings":"AAMA,OAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA6BnD;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAqQ7D;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,GAAE,MAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAgBhF"}

package/dist/http/server.js

@@ -0,0 +1,284 @@
+// src/http/server.ts
+// Fastify HTTP 服务器配置
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import * as fs from "node:fs";
+import Fastify from "fastify";
+import cors from "@fastify/cors";
+import fastifyStatic from "@fastify/static";
+import multipart from "@fastify/multipart";
+import { errorHandler } from "./middleware/errorHandler.js";
+import { ensureBaseSetup } from "./services.js";
+import { eventService, EventService } from "../services/EventService.js";
+// ESM 下获取 __dirname
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// 服务启动时间（模块加载时记录）
+const SERVER_START_TIME = new Date().toISOString();
+// 判断是否为开发模式
+const IS_DEV = process.env.NODE_ENV === "development" || process.env.ZERO_DEV === "true";
+// 导入路由
+import { workspaceRoutes } from "./routes/workspace.js";
+import { nodeRoutes } from "./routes/node.js";
+import { stateRoutes } from "./routes/state.js";
+import { contextRoutes } from "./routes/context.js";
+import { logRoutes } from "./routes/log.js";
+import { configRoutes } from "./routes/config.js";
+import { memoRoutes } from "./routes/memo.js";
+import { adminRoutes } from "./routes/admin.js";
+import { backupRoutes } from "./routes/backup.js";
+/**
+ * 创建并配置 Fastify 服务器
+ */
+export async function createServer() {
+    const server = Fastify({
+        logger: IS_DEV
+            ? {
+                level: "info",
+                transport: {
+                    target: "pino-pretty",
+                    options: {
+                        translateTime: "HH:MM:ss Z",
+                        ignore: "pid,hostname",
+                    },
+                },
+            }
+            : {
+                level: "warn", // 生产环境只记录警告和错误
+            },
+    });
+    // 注册 CORS
+    await server.register(cors, {
+        origin: true, // 开发环境允许所有来源
+        methods: ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"],
+        allowedHeaders: ["Content-Type", "Authorization"],
+    });
+    // 注册 multipart 插件（用于文件上传）
+    await server.register(multipart, {
+        limits: {
+            fileSize: 10 * 1024 * 1024, // 10MB 限制（全局备份文件通常很小）
+        },
+    });
+    // 设置错误处理器
+    server.setErrorHandler(errorHandler);
+    // 健康检查
+    server.get("/health", async () => ({
+        status: "ok",
+        timestamp: new Date().toISOString(),
+    }));
+    // SSE 事件流端点
+    server.get("/api/events", async (request, reply) => {
+        // 设置 SSE 响应头
+        reply.raw.writeHead(200, {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            "Connection": "keep-alive",
+            "Access-Control-Allow-Origin": "*",
+        });
+        // 注册客户端
+        const clientId = eventService.addClient(reply);
+        server.log.info(`SSE 客户端连接: ${clientId}, 当前连接数: ${eventService.getClientCount()}`);
+        // 发送初始连接确认
+        reply.raw.write(`data: ${JSON.stringify({ type: "connected", clientId })}\n\n`);
+        // 保持连接（心跳）
+        const heartbeat = setInterval(() => {
+            try {
+                reply.raw.write(`: heartbeat\n\n`);
+            }
+            catch {
+                clearInterval(heartbeat);
+            }
+        }, 30000);
+        // 清理
+        reply.raw.on("close", () => {
+            clearInterval(heartbeat);
+            eventService.removeClient(clientId);
+            server.log.info(`SSE 客户端断开: ${clientId}, 剩余连接数: ${eventService.getClientCount()}`);
+        });
+        // 不要调用 reply.send()，保持连接打开
+        return reply;
+    });
+    // 内部事件接收端点（跨进程事件转发用）
+    server.post("/api/internal/events", async (request, reply) => {
+        // 验证内部令牌
+        const token = request.headers["x-internal-token"];
+        const expectedToken = EventService.getInternalToken();
+        if (token !== expectedToken) {
+            return reply.status(401).send({ error: "Unauthorized" });
+        }
+        // 验证来源必须是本地
+        const remoteAddr = request.ip;
+        if (remoteAddr !== "127.0.0.1" && remoteAddr !== "::1" && remoteAddr !== "::ffff:127.0.0.1") {
+            return reply.status(403).send({ error: "Forbidden: local only" });
+        }
+        // 广播事件（仅本地广播，不再转发，避免循环）
+        const event = request.body;
+        if (event && event.type && event.workspaceId) {
+            const data = JSON.stringify(event);
+            const message = `data: ${data}\n\n`;
+            // 直接写入所有客户端，不调用 broadcast() 避免再次转发
+            const clients = eventService.clients;
+            for (const [, clientReply] of clients) {
+                try {
+                    clientReply.raw.write(message);
+                }
+                catch {
+                    // 忽略写入失败
+                }
+            }
+            server.log.info(`[内部事件] 收到并广播: ${event.type} (${event.workspaceId})`);
+            return { success: true };
+        }
+        return reply.status(400).send({ error: "Invalid event format" });
+    });
+    // 版本检查接口（公开）
+    server.get("/api/version", async () => {
+        // 读取当前版本
+        let currentVersion = "unknown";
+        const packageJsonPath = path.resolve(__dirname, "../../package.json");
+        try {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+            currentVersion = packageJson.version;
+        }
+        catch {
+            // 忽略错误
+        }
+        // 从 npm registry 获取最新版本（带缓存）
+        let latestVersion = null;
+        let updateAvailable = false;
+        // 语义化版本比较：v1 > v2 返回 true
+        const semverGreaterThan = (v1, v2) => {
+            const parse = (v) => v.split(".").map(Number);
+            const [a1, a2, a3] = parse(v1);
+            const [b1, b2, b3] = parse(v2);
+            if (a1 !== b1)
+                return a1 > b1;
+            if (a2 !== b2)
+                return a2 > b2;
+            return a3 > b3;
+        };
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 3000);
+            const response = await fetch("https://registry.npmjs.org/zero-workspace/latest", { signal: controller.signal });
+            clearTimeout(timeout);
+            if (response.ok) {
+                const data = await response.json();
+                latestVersion = data.version || null;
+                if (latestVersion && currentVersion !== "unknown") {
+                    // 只有当 npm 版本大于当前版本时才提示更新
+                    updateAvailable = semverGreaterThan(latestVersion, currentVersion);
+                }
+            }
+        }
+        catch {
+            // 网络错误时静默处理
+        }
+        return {
+            currentVersion,
+            latestVersion,
+            updateAvailable,
+        };
+    });
+    // 服务信息接口（基本信息所有环境可用，调试信息仅开发模式）
+    server.get("/api/dev-info", async () => {
+        // 读取 package.json 版本
+        let packageVersion = null;
+        const packageJsonPath = path.resolve(__dirname, "../../package.json");
+        try {
+            const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+            packageVersion = packageJson.version;
+        }
+        catch {
+            // 忽略错误
+        }
+        // 基本信息（所有环境可用）
+        const baseInfo = {
+            available: true,
+            isDev: IS_DEV,
+            packageVersion,
+            nodeVersion: process.version,
+            platform: process.platform,
+        };
+        // 生产环境只返回基本信息
+        if (!IS_DEV) {
+            return baseInfo;
+        }
+        // 开发环境额外返回调试信息
+        // 获取代码编译时间（dist/index.js 的修改时间）
+        let codeBuildTime = null;
+        const distIndexPath = path.resolve(__dirname, "../index.js");
+        try {
+            const stat = fs.statSync(distIndexPath);
+            codeBuildTime = stat.mtime.toISOString();
+        }
+        catch {
+            // 忽略错误
+        }
+        return {
+            ...baseInfo,
+            serverStartTime: SERVER_START_TIME,
+            codeBuildTime,
+            dataDir: ".zero-workspace-dev",
+        };
+    });
+    // 注册 API 路由
+    await server.register(workspaceRoutes, { prefix: "/api" });
+    await server.register(nodeRoutes, { prefix: "/api" });
+    await server.register(stateRoutes, { prefix: "/api" });
+    await server.register(contextRoutes, { prefix: "/api" });
+    await server.register(logRoutes, { prefix: "/api" });
+    await server.register(configRoutes, { prefix: "/api" });
+    await server.register(memoRoutes, { prefix: "/api" });
+    await server.register(adminRoutes, { prefix: "/api" });
+    await server.register(backupRoutes, { prefix: "/api" });
+    // 托管前端静态文件（生产模式）
+    // web/dist 目录相对于 dist/http/server.js，路径为 ../../web/dist
+    const webDistPath = path.resolve(__dirname, "../../web/dist");
+    if (fs.existsSync(webDistPath)) {
+        await server.register(fastifyStatic, {
+            root: webDistPath,
+            prefix: "/",
+        });
+        // SPA 路由回退：非 API 路径且非静态文件时返回 index.html
+        server.setNotFoundHandler(async (request, reply) => {
+            // API 路由返回 404 JSON
+            if (request.url.startsWith("/api/")) {
+                return reply.status(404).send({ error: "Not found" });
+            }
+            // 其他路由返回 index.html（SPA 前端路由）
+            return reply.sendFile("index.html");
+        });
+        server.log.info(`Web UI 静态文件已加载: ${webDistPath}`);
+    }
+    else {
+        server.log.warn(`Web UI 静态文件目录不存在: ${webDistPath}`);
+        server.log.warn("请运行 'cd web && npm run build' 构建前端");
+    }
+    // 启动前确保基础目录存在
+    server.addHook("onReady", async () => {
+        await ensureBaseSetup();
+    });
+    return server;
+}
+/**
+ * 启动服务器
+ */
+export async function startServer(port = 19540) {
+    const server = await createServer();
+    const modeLabel = IS_DEV ? "[DEV]" : "[PROD]";
+    const dataDir = IS_DEV ? ".zero-workspace-dev" : ".zero-workspace";
+    // 默认只监听本地地址（安全），可通过 ZERO_HOST 环境变量覆盖
+    const host = process.env.ZERO_HOST || "127.0.0.1";
+    try {
+        await server.listen({ port, host });
+        console.log(`${modeLabel} ZeroWorkspace HTTP Server 已启动: http://${host}:${port}`);
+        console.log(`${modeLabel} 数据目录: ~/${dataDir}/`);
+        return server;
+    }
+    catch (err) {
+        server.log.error(err);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/http/server.js.map

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

package/dist/http/services.d.ts

@@ -0,0 +1,93 @@
+import { FileSystemAdapter } from "../storage/FileSystemAdapter.js";
+import { JsonStorage } from "../storage/JsonStorage.js";
+import { MarkdownStorage } from "../storage/MarkdownStorage.js";
+import { SessionBindingStorage } from "../storage/SessionBindingStorage.js";
+import { WorkspaceService } from "../services/WorkspaceService.js";
+import { NodeService } from "../services/NodeService.js";
+import { StateService } from "../services/StateService.js";
+import { ContextService } from "../services/ContextService.js";
+import { ReferenceService } from "../services/ReferenceService.js";
+import { LogService } from "../services/LogService.js";
+import { SessionService } from "../services/SessionService.js";
+import { DispatchService } from "../services/DispatchService.js";
+import { ConfigService } from "../services/ConfigService.js";
+import { MemoService } from "../services/MemoService.js";
+import { TutorialService } from "../services/TutorialService.js";
+import { InstallationService } from "../services/InstallationService.js";
+import { DetectionService } from "../services/DetectionService.js";
+import { BackupService } from "../services/BackupService.js";
+import { HealthService } from "../services/HealthService.js";
+import { SearchService } from "../services/SearchService.js";
+import { RepairService } from "../services/RepairService.js";
+import { HelpService } from "../tools/help.js";
+export interface Services {
+    fs: FileSystemAdapter;
+    json: JsonStorage;
+    md: MarkdownStorage;
+    sessionStorage: SessionBindingStorage;
+    workspace: WorkspaceService;
+    node: NodeService;
+    state: StateService;
+    context: ContextService;
+    reference: ReferenceService;
+    log: LogService;
+    session: SessionService;
+    dispatch: DispatchService;
+    config: ConfigService;
+    memo: MemoService;
+    tutorial: TutorialService;
+    installation: InstallationService;
+    detection: DetectionService;
+    backup: BackupService;
+    health: HealthService;
+    search: SearchService;
+    repair: RepairService;
+    help: HelpService;
+}
+/**
+ * 创建服务实例（单例模式）
+ */
+export declare function createServices(): Services;
+/**
+ * 获取服务实例
+ */
+export declare function getServices(): Services;
+/**
+ * 确保基础目录和索引文件存在
+ */
+export declare function ensureBaseSetup(): Promise<void>;
+export interface DirNameResolution {
+    projectRoot: string;
+    wsDirName: string;
+}
+export interface FullDirNameResolution extends DirNameResolution {
+    nodeDirName: string;
+}
+/**
+ * 解析工作区 dirName
+ * 将 workspaceId 转换为实际的目录名
+ *
+ * @example
+ * const { projectRoot, wsDirName } = await resolveWsDirName("ws-abc123");
+ * // wsDirName 用于后续文件系统操作
+ */
+export declare function resolveWsDirName(workspaceId: string): Promise<DirNameResolution>;
+/**
+ * 解析节点 dirName
+ * 需要先有 projectRoot 和 wsDirName（可通过 resolveWsDirName 获取）
+ *
+ * @example
+ * const nodeDirName = await resolveNodeDirName(projectRoot, wsDirName, "node-xyz");
+ * // nodeDirName 用于访问节点目录（如 Info.md, Log.md）
+ */
+export declare function resolveNodeDirName(projectRoot: string, wsDirName: string, nodeId: string): Promise<string>;
+/**
+ * 解析工作区和节点的 dirName（组合方法）
+ * 一次性获取所有需要的目录名，适用于节点级别操作
+ *
+ * @example
+ * const { projectRoot, wsDirName, nodeDirName } = await resolveDirNames("ws-abc", "node-xyz");
+ * await md.readNodeInfo(projectRoot, wsDirName, nodeDirName);
+ */
+export declare function resolveDirNames(workspaceId: string, nodeId: string): Promise<FullDirNameResolution>;
+//# sourceMappingURL=services.d.ts.map

package/dist/http/services.d.ts.map

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