@aalis/plugin-office 0.1.0

package/README.md

@@ -0,0 +1,21 @@
+# @aalis/plugin-office
+
+运行时插件
+
+## 角色
+
+运行时插件
+
+## 安装
+
+```bash
+pnpm add @aalis/plugin-office
+```
+
+## 文档
+
+详见 [docs/plugins/plugin-office.md](../../docs/plugins/plugin-office.md)。
+
+## 许可
+
+见仓库根目录 LICENSE。

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import type { ConfigSchema, Context } from '@aalis/core';
+import '@aalis/plugin-tools-api';
+export declare const name = "@aalis/plugin-office";
+export declare const displayName = "Office \u6587\u6863\u5DE5\u5177";
+export declare const subsystem = "tools";
+export declare const inject: {
+    required: string[];
+    optional: string[];
+};
+export declare const configSchema: ConfigSchema;
+export declare const defaultConfig: {
+    outputDir: string;
+    docx: {
+        enabled: boolean;
+    };
+    xlsx: {
+        enabled: boolean;
+    };
+    pptx: {
+        enabled: boolean;
+    };
+    pdf: {
+        enabled: boolean;
+    };
+};
+export declare function apply(ctx: Context, config: Record<string, unknown>): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AASzD,OAAO,yBAAyB,CAAC;AAIjC,eAAO,MAAM,IAAI,yBAAyB,CAAC;AAC3C,eAAO,MAAM,WAAW,oCAAgB,CAAC;AACzC,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,eAAO,MAAM,MAAM;;;CAGlB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,YA8B1B,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;CAMzB,CAAC;AAcF,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA4CzE"}

package/dist/index.js

@@ -0,0 +1,110 @@
+import { createProcessGateway } from '@aalis/plugin-process-api';
+import { createStorageGateway } from '@aalis/plugin-storage-api';
+import { toolsWithGroups, useToolService } from '@aalis/plugin-tools-api';
+import { DocSessionManager } from './session.js';
+import { registerDocxTools } from './tools/docx.js';
+import { registerPdfTools } from './tools/pdf.js';
+import { registerPptTools } from './tools/pptx.js';
+import { registerExcelTools } from './tools/xlsx.js';
+import '@aalis/plugin-tools-api';
+// ===== 插件元数据 =====
+export const name = '@aalis/plugin-office';
+export const displayName = 'Office 文档工具';
+export const subsystem = 'tools';
+export const inject = {
+    required: ['storage', 'tools'],
+    optional: ['process'],
+};
+export const configSchema = {
+    outputDir: {
+        type: 'string',
+        label: '输出目录',
+        description: '文档保存目录（storage URI，如 workspace:/ 或 data:/docs），也兼容裸名「workspace」/「data」。',
+    },
+    docx: {
+        label: 'Word 文档',
+        fields: {
+            enabled: { type: 'boolean', label: '启用 Word 工具', default: true },
+        },
+    },
+    xlsx: {
+        label: 'Excel 工作簿',
+        fields: {
+            enabled: { type: 'boolean', label: '启用 Excel 工具', default: true },
+        },
+    },
+    pptx: {
+        label: 'PPT 演示文稿',
+        fields: {
+            enabled: { type: 'boolean', label: '启用 PPT 工具', default: true },
+        },
+    },
+    pdf: {
+        label: 'PDF 文档',
+        fields: {
+            enabled: { type: 'boolean', label: '启用 PDF 工具', default: true },
+        },
+    },
+};
+export const defaultConfig = {
+    outputDir: 'workspace:/',
+    docx: { enabled: true },
+    xlsx: { enabled: true },
+    pptx: { enabled: true },
+    pdf: { enabled: true },
+};
+// ===== 插件入口 =====
+export function apply(ctx, config) {
+    const cfg = resolveConfig(config);
+    const storage = createStorageGateway(ctx);
+    // 兼容 裸名/相对路径 → storage URI
+    function toUri(input) {
+        if (input.includes(':/'))
+            return input;
+        const s = input.trim().replace(/^\.?\/+/, '');
+        const idx = s.indexOf('/');
+        return idx > 0 ? `${s.slice(0, idx)}:/${s.slice(idx + 1)}` : `${s}:/`;
+    }
+    const outputUri = toUri(cfg.outputDir);
+    const sessions = new DocSessionManager();
+    const baseTools = useToolService(ctx);
+    baseTools.registerGroup({
+        name: 'office',
+        label: 'Office 文档工具',
+        description: '创建和编辑 Word、Excel、PPT、PDF 文档',
+    });
+    const tools = toolsWithGroups(baseTools, ['office']);
+    if (cfg.docx.enabled) {
+        registerDocxTools(tools, sessions, storage, outputUri);
+        ctx.logger.info('Word (docx) 工具已启用');
+    }
+    if (cfg.xlsx.enabled) {
+        registerExcelTools(tools, sessions, storage, outputUri);
+        ctx.logger.info('Excel (xlsx) 工具已启用');
+    }
+    if (cfg.pptx.enabled) {
+        registerPptTools(tools, sessions, storage, outputUri);
+        ctx.logger.info('PPT (pptx) 工具已启用');
+    }
+    if (cfg.pdf.enabled) {
+        const proc = ctx.hasService('process') ? createProcessGateway(ctx) : undefined;
+        registerPdfTools(tools, sessions, storage, outputUri, proc);
+        ctx.logger.info('PDF 工具已启用');
+    }
+    ctx.logger.info(`Office 文档工具插件已启动 (输出 URI: ${outputUri})`);
+}
+// ===== 辅助函数 =====
+function resolveConfig(config) {
+    const docx = config.docx;
+    const xlsx = config.xlsx;
+    const pptx = config.pptx;
+    const pdf = config.pdf;
+    return {
+        outputDir: String(config.outputDir || 'workspace:/'),
+        docx: { enabled: docx?.enabled !== false },
+        xlsx: { enabled: xlsx?.enabled !== false },
+        pptx: { enabled: pptx?.enabled !== false },
+        pdf: { enabled: pdf?.enabled !== false },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,24 @@
+export type DocType = 'docx' | 'xlsx' | 'pptx' | 'pdf';
+export interface DocSession {
+    id: string;
+    type: DocType;
+    filename: string;
+    /** 底层文档对象（docx.Document / ExcelJS.Workbook / pptxgen） */
+    doc: unknown;
+    createdAt: number;
+}
+/**
+ * 管理内存中的文档会话。
+ * create 返回 docId，后续操作引用该 ID，save 后释放。
+ */
+export declare class DocSessionManager {
+    private sessions;
+    create(type: DocType, filename: string, doc: unknown): string;
+    get(id: string): DocSession | undefined;
+    getByType<T>(id: string, type: DocType): T | undefined;
+    remove(id: string): boolean;
+    list(): DocSession[];
+    /** 获取会话或抛出错误（简化工具代码） */
+    require(id: string, expectedType?: DocType): DocSession;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAiC;IAEjD,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM;IAM7D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIvC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS;IAMtD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,IAAI,IAAI,UAAU,EAAE;IAIpB,wBAAwB;IACxB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,UAAU;CAQxD"}

package/dist/session.js

@@ -0,0 +1,38 @@
+/**
+ * 管理内存中的文档会话。
+ * create 返回 docId，后续操作引用该 ID，save 后释放。
+ */
+export class DocSessionManager {
+    sessions = new Map();
+    create(type, filename, doc) {
+        const id = `doc-${crypto.randomUUID().slice(0, 8)}`;
+        this.sessions.set(id, { id, type, filename, doc, createdAt: Date.now() });
+        return id;
+    }
+    get(id) {
+        return this.sessions.get(id);
+    }
+    getByType(id, type) {
+        const session = this.sessions.get(id);
+        if (!session || session.type !== type)
+            return undefined;
+        return session.doc;
+    }
+    remove(id) {
+        return this.sessions.delete(id);
+    }
+    list() {
+        return [...this.sessions.values()];
+    }
+    /** 获取会话或抛出错误（简化工具代码） */
+    require(id, expectedType) {
+        const session = this.sessions.get(id);
+        if (!session)
+            throw new Error(`文档不存在: ${id}`);
+        if (expectedType && session.type !== expectedType) {
+            throw new Error(`文档类型不匹配: 期望 ${expectedType}，实际 ${session.type}`);
+        }
+        return session;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACpB,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEjD,MAAM,CAAC,IAAa,EAAE,QAAgB,EAAE,GAAY;QAClD,MAAM,EAAE,GAAG,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC1E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,SAAS,CAAI,EAAU,EAAE,IAAa;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACxD,OAAO,OAAO,CAAC,GAAQ,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,wBAAwB;IACxB,OAAO,CAAC,EAAU,EAAE,YAAsB;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,YAAY,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,eAAe,YAAY,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/tools/docx.d.ts

@@ -0,0 +1,5 @@
+import type { StorageService } from '@aalis/plugin-storage-api';
+import type { ScopedToolService } from '@aalis/plugin-tools-api';
+import type { DocSessionManager } from '../session.js';
+export declare function registerDocxTools(tools: ScopedToolService, sessions: DocSessionManager, storage: StorageService, outputUri: string): void;
+//# sourceMappingURL=docx.d.ts.map

package/dist/tools/docx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx.d.ts","sourceRoot":"","sources":["../../src/tools/docx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAsBjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAuGvD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,QAsmBlB"}