zero-workspace 0.0.2

package/dist/services/InstallationService.js

@@ -0,0 +1,204 @@
+// src/services/InstallationService.ts
+import * as path from "node:path";
+import * as os from "node:os";
+import * as fs from "node:fs/promises";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { DEFAULT_INSTALLATION_META } from "../types/settings.js";
+/**
+ * 安装服务
+ * 管理安装元信息文件 ~/.zero-workspace/installation-meta.json
+ * 用于跟踪各平台组件的安装状态和版本
+ */
+export class InstallationService {
+    metaPath;
+    packageVersion;
+    constructor() {
+        const isDev = process.env.NODE_ENV === "development" || process.env.ZERO_DEV === "true";
+        const baseDir = isDev ? ".zero-workspace-dev" : ".zero-workspace";
+        this.metaPath = path.join(os.homedir(), baseDir, "installation-meta.json");
+        this.packageVersion = this.loadPackageVersion();
+    }
+    /**
+     * 获取包版本号
+     */
+    loadPackageVersion() {
+        try {
+            // 优先使用 npm 环境变量
+            if (process.env.npm_package_version) {
+                return process.env.npm_package_version;
+            }
+            // 从 package.json 读取（支持直接 node 运行）
+            // import.meta.url 指向 dist/services/InstallationService.js
+            // package.json 在 ../../package.json
+            const __dirname = path.dirname(fileURLToPath(import.meta.url));
+            const pkgPath = path.join(__dirname, "..", "..", "package.json");
+            const pkgContent = readFileSync(pkgPath, "utf-8");
+            const pkg = JSON.parse(pkgContent);
+            return pkg.version || "0.0.0";
+        }
+        catch {
+            return "0.0.0";
+        }
+    }
+    /**
+     * 获取元信息文件路径
+     */
+    getPath() {
+        return this.metaPath;
+    }
+    /**
+     * 获取当前包版本
+     */
+    getPackageVersion() {
+        return this.packageVersion;
+    }
+    /**
+     * 读取安装元信息
+     * 如果文件不存在，返回默认结构
+     */
+    async read() {
+        try {
+            const content = await fs.readFile(this.metaPath, "utf-8");
+            const meta = JSON.parse(content);
+            // 版本迁移（如果需要）
+            if (meta.schemaVersion !== "1.0") {
+                // 未来可在此处理版本迁移
+                meta.schemaVersion = "1.0";
+            }
+            return meta;
+        }
+        catch (err) {
+            // 文件不存在时返回默认结构
+            if (err.code === "ENOENT") {
+                return this.createDefaultMeta();
+            }
+            throw err;
+        }
+    }
+    /**
+     * 写入安装元信息
+     */
+    async write(meta) {
+        // 确保目录存在
+        const metaDir = path.dirname(this.metaPath);
+        await fs.mkdir(metaDir, { recursive: true });
+        // 更新时间戳
+        meta.global.lastUpdatedAt = new Date().toISOString();
+        // 写入文件
+        await fs.writeFile(this.metaPath, JSON.stringify(meta, null, 2), "utf-8");
+    }
+    /**
+     * 更新指定平台的安装信息
+     */
+    async updatePlatform(platform, info) {
+        const meta = await this.read();
+        const now = new Date().toISOString();
+        const existing = meta.global.platforms[platform];
+        meta.global.platforms[platform] = {
+            enabled: info.enabled ?? existing?.enabled ?? true,
+            installedAt: existing?.installedAt ?? now,
+            components: {
+                hooks: this.mergeComponent(existing?.components?.hooks, info.components?.hooks),
+                mcp: this.mergeComponent(existing?.components?.mcp, info.components?.mcp),
+                ...(platform === "claudeCode" && {
+                    agents: this.mergeComponent(existing?.components?.agents, info.components?.agents),
+                    skills: this.mergeComponent(existing?.components?.skills, info.components?.skills),
+                }),
+                ...(platform === "codex" && {
+                    agentsMd: this.mergeComponent(existing?.components?.agentsMd, info.components?.agentsMd),
+                }),
+                ...(platform === "cursor" && {
+                    modes: this.mergeComponent(existing?.components?.modes, info.components?.modes),
+                }),
+            },
+        };
+        await this.write(meta);
+        return meta;
+    }
+    /**
+     * 合并组件信息
+     */
+    mergeComponent(existing, update) {
+        if (!update) {
+            return existing ?? { installed: false };
+        }
+        return {
+            installed: update.installed,
+            version: update.installed ? (update.version ?? this.packageVersion) : undefined,
+        };
+    }
+    /**
+     * 更新单个组件
+     */
+    async updateComponent(platform, component, installed, version) {
+        const meta = await this.read();
+        const now = new Date().toISOString();
+        // 确保平台存在
+        if (!meta.global.platforms[platform]) {
+            meta.global.platforms[platform] = {
+                enabled: true,
+                installedAt: now,
+                components: {
+                    hooks: { installed: false },
+                    mcp: { installed: false },
+                },
+            };
+        }
+        const platformInfo = meta.global.platforms[platform];
+        platformInfo.components[component] = {
+            installed,
+            version: installed ? (version ?? this.packageVersion) : undefined,
+        };
+        // 检查是否所有组件都未安装
+        const allDisabled = Object.values(platformInfo.components).every((c) => !c.installed);
+        platformInfo.enabled = !allDisabled;
+        await this.write(meta);
+        return meta;
+    }
+    /**
+     * 获取指定平台的安装信息
+     */
+    async getPlatform(platform) {
+        const meta = await this.read();
+        return meta.global.platforms[platform];
+    }
+    /**
+     * 检查平台组件版本
+     * 返回需要更新的组件列表
+     */
+    async checkComponentUpdates(platform) {
+        const platformInfo = await this.getPlatform(platform);
+        if (!platformInfo) {
+            return [];
+        }
+        const outdated = [];
+        for (const [name, info] of Object.entries(platformInfo.components)) {
+            const componentInfo = info;
+            if (componentInfo.installed && componentInfo.version && componentInfo.version !== this.packageVersion) {
+                outdated.push({
+                    component: name,
+                    installedVersion: componentInfo.version,
+                    currentVersion: this.packageVersion,
+                });
+            }
+        }
+        return outdated;
+    }
+    /**
+     * 创建默认的元信息结构
+     */
+    createDefaultMeta() {
+        const now = new Date().toISOString();
+        return {
+            ...DEFAULT_INSTALLATION_META,
+            global: {
+                installedAt: now,
+                lastUpdatedAt: now,
+                packageVersion: this.packageVersion,
+                platforms: {},
+            },
+        };
+    }
+}
+//# sourceMappingURL=InstallationService.js.map

package/dist/services/InstallationService.js.map

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

package/dist/services/LogService.d.ts

@@ -0,0 +1,35 @@
+import type { FileSystemAdapter } from "../storage/FileSystemAdapter.js";
+import type { MarkdownStorage } from "../storage/MarkdownStorage.js";
+import type { JsonStorage } from "../storage/JsonStorage.js";
+import type { LogAppendParams, LogAppendResult, ProblemUpdateParams, ProblemUpdateResult, ProblemClearParams, ProblemClearResult } from "../types/context.js";
+/**
+ * 日志服务
+ * 处理日志追加和问题管理
+ */
+export declare class LogService {
+    private json;
+    private md;
+    private fs;
+    constructor(json: JsonStorage, md: MarkdownStorage, fs: FileSystemAdapter);
+    /**
+     * 根据 workspaceId 获取工作区信息
+     */
+    private resolveWorkspaceInfo;
+    /**
+     * 追加日志
+     */
+    append(params: LogAppendParams): Promise<LogAppendResult>;
+    /**
+     * 根据节点状态生成日志追加后的提示
+     */
+    private generateLogHint;
+    /**
+     * 更新问题
+     */
+    updateProblem(params: ProblemUpdateParams): Promise<ProblemUpdateResult>;
+    /**
+     * 清空问题
+     */
+    clearProblem(params: ProblemClearParams): Promise<ProblemClearResult>;
+}
+//# sourceMappingURL=LogService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LogService.d.ts","sourceRoot":"","sources":["../../src/services/LogService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAK7B;;;GAGG;AACH,qBAAa,UAAU;IAEnB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,EAAE;gBAFF,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,eAAe,EACnB,EAAE,EAAE,iBAAiB;IAG/B;;OAEG;YACW,oBAAoB;IAelC;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAsD/D;;OAEG;IACH,OAAO,CAAC,eAAe;IAkCvB;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4C9E;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAuC5E"}

package/dist/services/LogService.js

@@ -0,0 +1,189 @@
+// src/services/LogService.ts
+import { ZeroError } from "../types/errors.js";
+import { formatShort, now } from "../utils/time.js";
+import { eventService } from "./EventService.js";
+/**
+ * 日志服务
+ * 处理日志追加和问题管理
+ */
+export class LogService {
+    json;
+    md;
+    fs;
+    constructor(json, md, fs) {
+        this.json = json;
+        this.md = md;
+        this.fs = fs;
+    }
+    /**
+     * 根据 workspaceId 获取工作区信息
+     */
+    async resolveWorkspaceInfo(workspaceId) {
+        const index = await this.json.readIndex();
+        const entry = index.workspaces.find(ws => ws.id === workspaceId);
+        if (!entry) {
+            throw new ZeroError("WORKSPACE_NOT_FOUND", `工作区 "${workspaceId}" 不存在`);
+        }
+        if (entry.status === "error" && entry.errorInfo) {
+            throw new ZeroError("WORKSPACE_ERROR", `工作区 "${workspaceId}" 处于错误状态: ${entry.errorInfo.message}`);
+        }
+        return {
+            projectRoot: entry.projectRoot,
+            wsDirName: entry.dirName || entry.id, // 向后兼容
+        };
+    }
+    /**
+     * 追加日志
+     */
+    async append(params) {
+        const { workspaceId, nodeId, operator, event } = params;
+        // 参数验证（防止 AI 使用错误参数名）
+        if (!operator) {
+            throw new ZeroError("INVALID_PARAMS", "缺少必填参数 operator（操作者），请检查是否使用了正确的参数名");
+        }
+        if (!event) {
+            throw new ZeroError("INVALID_PARAMS", "缺少必填参数 event（事件描述），请检查是否使用了正确的参数名（不是 content）");
+        }
+        // 1. 获取工作区信息
+        const { projectRoot, wsDirName } = await this.resolveWorkspaceInfo(workspaceId);
+        // 2. 获取节点信息（用于生成 hint）
+        const graph = await this.json.readGraph(projectRoot, wsDirName);
+        let hint;
+        let nodeDirName;
+        if (nodeId) {
+            const nodeMeta = graph.nodes[nodeId];
+            if (!nodeMeta) {
+                throw new ZeroError("NODE_NOT_FOUND", `节点 "${nodeId}" 不存在`);
+            }
+            nodeDirName = nodeMeta.dirName || nodeId; // 向后兼容
+            // 根据节点类型和状态生成 hint
+            hint = this.generateLogHint(nodeMeta.type, nodeMeta.status, nodeMeta.children.length, event);
+        }
+        // 3. 生成时间戳（完整格式：YYYY-MM-DD HH:mm:ss）
+        const timestamp = formatShort(now());
+        // 4. 构造日志条目并追加
+        try {
+            await this.md.appendTypedLogEntry(projectRoot, wsDirName, {
+                timestamp,
+                operator,
+                event,
+            }, nodeDirName);
+        }
+        catch (error) {
+            throw new ZeroError("LOG_APPEND_FAILED", `日志追加失败: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        // 5. 推送 SSE 事件通知前端
+        eventService.emitLogUpdate(workspaceId, nodeId || "workspace");
+        // 6. 返回结果
+        return {
+            success: true,
+            timestamp,
+            hint,
+        };
+    }
+    /**
+     * 根据节点状态生成日志追加后的提示
+     */
+    generateLogHint(nodeType, status, childCount, event) {
+        // 防御性检查：如果 event 为空则跳过关键词检测
+        if (!event) {
+            return "";
+        }
+        // 检测是否是"方案确定"类的日志
+        const planningKeywords = ["确定", "决定", "方案", "设计", "计划", "开始实现", "准备"];
+        const isPlanningEvent = planningKeywords.some(kw => event.includes(kw));
+        if (nodeType === "planning") {
+            if (status === "planning" && childCount === 0 && isPlanningEvent) {
+                return "💡 看起来方案已确定。规划节点的下一步是使用 node_create 创建子节点来分解任务。";
+            }
+            if (status === "monitoring") {
+                return "💡 规划节点正在监控子节点执行。等待所有子节点完成后可以 complete 汇总结论。";
+            }
+        }
+        else if (nodeType === "execution") {
+            if (status === "implementing") {
+                if (isPlanningEvent) {
+                    return "💡 执行节点应聚焦于具体执行而非规划。如果任务需要分解，请 fail 回退到父规划节点。";
+                }
+                return "💡 继续执行任务，完成后调用 node_transition(action=\"complete\", conclusion=\"...\")。";
+            }
+        }
+        return "";
+    }
+    /**
+     * 更新问题
+     */
+    async updateProblem(params) {
+        const { workspaceId, nodeId, problem, nextStep } = params;
+        // 1. 获取工作区信息
+        const { projectRoot, wsDirName } = await this.resolveWorkspaceInfo(workspaceId);
+        // 2. 如果有 nodeId，验证节点存在并获取目录名
+        let nodeDirName;
+        if (nodeId) {
+            const graph = await this.json.readGraph(projectRoot, wsDirName);
+            const nodeMeta = graph.nodes[nodeId];
+            if (!nodeMeta) {
+                throw new ZeroError("NODE_NOT_FOUND", `节点 "${nodeId}" 不存在`);
+            }
+            nodeDirName = nodeMeta.dirName || nodeId; // 向后兼容
+        }
+        // 3. 构造 Problem.md 内容
+        const problemData = {
+            currentProblem: problem,
+            nextStep: nextStep || "（暂无）",
+        };
+        // 4. 写入对应的 Problem.md
+        await this.md.writeProblem(projectRoot, wsDirName, problemData, nodeDirName);
+        // 5. 追加日志
+        const timestamp = formatShort(now());
+        await this.md.appendTypedLogEntry(projectRoot, wsDirName, {
+            timestamp,
+            operator: "AI",
+            event: `更新问题: ${problem.substring(0, 50)}${problem.length > 50 ? "..." : ""}`,
+        }, nodeDirName);
+        // 6. 推送 SSE 事件通知前端
+        eventService.emitNodeUpdate(workspaceId, nodeId);
+        // 7. 返回结果
+        return {
+            success: true,
+            hint: "💡 问题已记录。如果问题复杂且当前是执行节点，考虑 fail 后回到父规划节点重新分解；如果问题已解决，使用 problem_clear 清空。",
+        };
+    }
+    /**
+     * 清空问题
+     */
+    async clearProblem(params) {
+        const { workspaceId, nodeId } = params;
+        // 1. 获取工作区信息
+        const { projectRoot, wsDirName } = await this.resolveWorkspaceInfo(workspaceId);
+        // 2. 如果有 nodeId，验证节点存在并获取目录名
+        let nodeDirName;
+        if (nodeId) {
+            const graph = await this.json.readGraph(projectRoot, wsDirName);
+            const nodeMeta = graph.nodes[nodeId];
+            if (!nodeMeta) {
+                throw new ZeroError("NODE_NOT_FOUND", `节点 "${nodeId}" 不存在`);
+            }
+            nodeDirName = nodeMeta.dirName || nodeId; // 向后兼容
+        }
+        // 3. 写入空模板到 Problem.md
+        await this.md.writeProblem(projectRoot, wsDirName, {
+            currentProblem: "（暂无）",
+            nextStep: "（暂无）",
+        }, nodeDirName);
+        // 4. 追加日志
+        const timestamp = formatShort(now());
+        await this.md.appendTypedLogEntry(projectRoot, wsDirName, {
+            timestamp,
+            operator: "AI",
+            event: "清空问题",
+        }, nodeDirName);
+        // 5. 推送 SSE 事件通知前端
+        eventService.emitNodeUpdate(workspaceId, nodeId);
+        // 6. 返回结果
+        return {
+            success: true,
+        };
+    }
+}
+//# sourceMappingURL=LogService.js.map

package/dist/services/LogService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogService.js","sourceRoot":"","sources":["../../src/services/LogService.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAa7B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;GAGG;AACH,MAAM,OAAO,UAAU;IAEX;IACA;IACA;IAHV,YACU,IAAiB,EACjB,EAAmB,EACnB,EAAqB;QAFrB,SAAI,GAAJ,IAAI,CAAa;QACjB,OAAE,GAAF,EAAE,CAAiB;QACnB,OAAE,GAAF,EAAE,CAAmB;IAC5B,CAAC;IAEJ;;OAEG;IACK,KAAK,CAAC,oBAAoB,CAAC,WAAmB;QACpD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;QACjE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,SAAS,CAAC,qBAAqB,EAAE,QAAQ,WAAW,OAAO,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAChD,MAAM,IAAI,SAAS,CAAC,iBAAiB,EAAE,QAAQ,WAAW,aAAa,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QACpG,CAAC;QACD,OAAO;YACL,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,SAAS,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,EAAG,OAAO;SAC/C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAAuB;QAClC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QAExD,sBAAsB;QACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,SAAS,CAAC,gBAAgB,EAAE,qCAAqC,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,SAAS,CAAC,gBAAgB,EAAE,+CAA+C,CAAC,CAAC;QACzF,CAAC;QAED,aAAa;QACb,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAEhF,uBAAuB;QACvB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAChE,IAAI,IAAwB,CAAC;QAC7B,IAAI,WAA+B,CAAC;QAEpC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,SAAS,CAAC,gBAAgB,EAAE,OAAO,MAAM,OAAO,CAAC,CAAC;YAC9D,CAAC;YACD,WAAW,GAAG,QAAQ,CAAC,OAAO,IAAI,MAAM,CAAC,CAAE,OAAO;YAClD,mBAAmB;YACnB,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/F,CAAC;QAED,qCAAqC;QACrC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;QAErC,eAAe;QACf,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,WAAW,EAAE,SAAS,EAAE;gBACxD,SAAS;gBACT,QAAQ;gBACR,KAAK;aACN,EAAE,WAAW,CAAC,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,SAAS,CAAC,mBAAmB,EAAE,WAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChH,CAAC;QAED,mBAAmB;QACnB,YAAY,CAAC,aAAa,CAAC,WAAW,EAAE,MAAM,IAAI,WAAW,CAAC,CAAC;QAE/D,UAAU;QACV,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS;YACT,IAAI;SACL,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,eAAe,CACrB,QAA4B,EAC5B,MAAc,EACd,UAAkB,EAClB,KAAyB;QAEzB,4BAA4B;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,kBAAkB;QAClB,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QACtE,MAAM,eAAe,GAAG,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAExE,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5B,IAAI,MAAM,KAAK,UAAU,IAAI,UAAU,KAAK,CAAC,IAAI,eAAe,EAAE,CAAC;gBACjE,OAAO,iDAAiD,CAAC;YAC3D,CAAC;YACD,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;gBAC5B,OAAO,8CAA8C,CAAC;YACxD,CAAC;QACH,CAAC;aAAM,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;YACpC,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;gBAC9B,IAAI,eAAe,EAAE,CAAC;oBACpB,OAAO,+CAA+C,CAAC;gBACzD,CAAC;gBACD,OAAO,2EAA2E,CAAC;YACrF,CAAC;QACH,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,MAA2B;QAC7C,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAE1D,aAAa;QACb,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAEhF,6BAA6B;QAC7B,IAAI,WAA+B,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,SAAS,CAAC,gBAAgB,EAAE,OAAO,MAAM,OAAO,CAAC,CAAC;YAC9D,CAAC;YACD,WAAW,GAAG,QAAQ,CAAC,OAAO,IAAI,MAAM,CAAC,CAAE,OAAO;QACpD,CAAC;QAED,sBAAsB;QACtB,MAAM,WAAW,GAAG;YAClB,cAAc,EAAE,OAAO;YACvB,QAAQ,EAAE,QAAQ,IAAI,MAAM;SAC7B,CAAC;QAEF,sBAAsB;QACtB,MAAM,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QAE7E,UAAU;QACV,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;QACrC,MAAM,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,WAAW,EAAE,SAAS,EAAE;YACxD,SAAS;YACT,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,SAAS,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;SAC9E,EAAE,WAAW,CAAC,CAAC;QAEhB,mBAAmB;QACnB,YAAY,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAEjD,UAAU;QACV,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,2EAA2E;SAClF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,MAA0B;QAC3C,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAEvC,aAAa;QACb,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAEhF,6BAA6B;QAC7B,IAAI,WAA+B,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,SAAS,CAAC,gBAAgB,EAAE,OAAO,MAAM,OAAO,CAAC,CAAC;YAC9D,CAAC;YACD,WAAW,GAAG,QAAQ,CAAC,OAAO,IAAI,MAAM,CAAC,CAAE,OAAO;QACpD,CAAC;QAED,uBAAuB;QACvB,MAAM,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,EAAE;YACjD,cAAc,EAAE,MAAM;YACtB,QAAQ,EAAE,MAAM;SACjB,EAAE,WAAW,CAAC,CAAC;QAEhB,UAAU;QACV,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;QACrC,MAAM,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,WAAW,EAAE,SAAS,EAAE;YACxD,SAAS;YACT,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,MAAM;SACd,EAAE,WAAW,CAAC,CAAC;QAEhB,mBAAmB;QACnB,YAAY,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAEjD,UAAU;QACV,OAAO;YACL,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/services/MemoService.d.ts

@@ -0,0 +1,39 @@
+import type { FileSystemAdapter } from "../storage/FileSystemAdapter.js";
+import type { JsonStorage } from "../storage/JsonStorage.js";
+import type { MarkdownStorage } from "../storage/MarkdownStorage.js";
+import type { MemoCreateParams, MemoCreateResult, MemoListParams, MemoListResult, MemoGetParams, MemoGetResult, MemoUpdateParams, MemoUpdateResult, MemoDeleteParams, MemoDeleteResult } from "../types/memo.js";
+/**
+ * Memo 服务
+ * 处理备忘相关的业务逻辑
+ */
+export declare class MemoService {
+    private json;
+    private md;
+    private fs;
+    constructor(json: JsonStorage, md: MarkdownStorage, fs: FileSystemAdapter);
+    /**
+     * 根据 workspaceId 获取工作区信息
+     */
+    private resolveWorkspaceInfo;
+    /**
+     * 创建备忘
+     */
+    create(params: MemoCreateParams): Promise<MemoCreateResult>;
+    /**
+     * 列出备忘（支持 tag 过滤）
+     */
+    list(params: MemoListParams): Promise<MemoListResult>;
+    /**
+     * 获取备忘内容（支持按行分页）
+     */
+    get(params: MemoGetParams): Promise<MemoGetResult>;
+    /**
+     * 更新备忘
+     */
+    update(params: MemoUpdateParams): Promise<MemoUpdateResult>;
+    /**
+     * 删除备忘
+     */
+    delete(params: MemoDeleteParams): Promise<MemoDeleteResult>;
+}
+//# sourceMappingURL=MemoService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MemoService.d.ts","sourceRoot":"","sources":["../../src/services/MemoService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAGjB,MAAM,kBAAkB,CAAC;AAQ1B;;;GAGG;AACH,qBAAa,WAAW;IAEpB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,EAAE;gBAFF,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,eAAe,EACnB,EAAE,EAAE,iBAAiB;IAG/B;;OAEG;YACW,oBAAoB;IAkBlC;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6EjE;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAuC3D;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAmDxD;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsFjE;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAkClE"}