Initial commit with CC BY-NC-ND 4.0 license

SL/bus/file/FilePipe.js

@@ -0,0 +1,61 @@
+class FilePipe {
+    constructor() {
+        this.name = "FilePipe";
+        // 模拟的根存储路径，实际环境可能对应 IndexedDB 的 Store Name 或 Node 的 baseDir
+        this.basePath = "/virtual_fs/";
+    }
+
+    /**
+     * 安全路径解析与校验
+     * @param {string} plugin 插件名称（命名空间）
+     * @param {string} relativePath 相对路径
+     * @returns {string|null} 合法的绝对路径，如果违规则返回 null
+     */
+    _resolvePath(plugin, relativePath) {
+        if (!plugin || typeof plugin !== 'string') {
+            console.error(`[FilePipe] Security Error: Invalid plugin identity.`);
+            return null;
+        }
+
+        // 简单防越权：禁止包含 ".."
+        if (relativePath.includes('..')) {
+            console.error(`[FilePipe] Security Error: Directory traversal attempt blocked for plugin '${plugin}'. Path: ${relativePath}`);
+            return null;
+        }
+
+        // 强制限定在插件目录下
+        // 格式: /virtual_fs/PluginName/filename
+        return `${this.basePath}${plugin}/${relativePath}`;
+    }
+
+    /**
+     * 读取文件
+     * @param {string} plugin 调用方插件名
+     * @param {string} path 文件相对路径
+     */
+    async read(plugin, path) {
+        const safePath = this._resolvePath(plugin, path);
+        if (!safePath) return null;
+
+        console.log(`[FilePipe] Reading from: ${safePath}`);
+        // TODO: Implement actual file reading logic
+        return null;
+    }
+
+    /**
+     * 写入文件
+     * @param {string} plugin 调用方插件名
+     * @param {string} path 文件相对路径
+     * @param {any} data 数据
+     */
+    async write(plugin, path, data) {
+        const safePath = this._resolvePath(plugin, path);
+        if (!safePath) return false;
+
+        console.log(`[FilePipe] Writing to: ${safePath}`);
+        // TODO: Implement actual file writing logic
+        return true;
+    }
+}
+
+export default FilePipe;