@coralai/sps-plugin-storage-sync 0.1.0 → 0.2.1

package/dist/index.d.ts

@@ -24,13 +24,14 @@ export declare const name = "storage-sync";
 export declare const category = "\u5B58\u50A8";
 export declare const description = "\u5DE5\u4F5C\u533A \u2192 \u5BF9\u8C61\u5B58\u50A8\u540C\u6B65:\u6309\u4EA7\u54C1\u58F0\u660E\u7684\u8303\u56F4,\u628A\u7528\u6237\u4EA7\u7269\u589E\u91CF\u642C\u5230 S3 \u517C\u5BB9\u6876\u3002";
 interface ApplyCtx {
-    effect(fn: () => void): void;
+    effect(fn: () => (() => void) | void): void;
     logger?: {
         info(msg: string): void;
         warn(msg: string): void;
     };
     reflect: {
         get(name: string): unknown;
+        provide(name: string, value?: unknown): () => void;
     };
 }
 export declare function apply(ctx: ApplyCtx, config: StorageSyncConfig): void;

package/dist/index.js

@@ -1,3 +1,4 @@
+import { MinioBackend } from './MinioBackend.js';
 import { runSyncPass } from './syncRunner.js';
 export { Config } from './schema.js';
 export const name = 'storage-sync';
@@ -58,6 +59,25 @@ export function apply(ctx, config) {
             ctx.logger?.warn?.(`[sps-sync] 一轮失败(忽略): ${err instanceof Error ? err.message : String(err)}`);
         }
     };
+    // 🔴 **把桶的读写能力提供出去** —— 宿主不认识桶,但别的插件可能需要读它
+    //    (实例:`gameforge-art` 读 `library/public/audio/<product>/` 当 BGM 兜底)。
+    //    2026-08-28 事故:宿主删掉 `sps.storage` 时只扫了自己仓内的消费方,
+    //    没查线上装着的插件 ⇒ gameforge-art 永远 PENDING、六个 art.* 能力全缺席。
+    //    ⇒ 契约留在 `@coralai/sps-plugin-api`,**实现跟着持有桶凭据的这个插件走**。
+    const backend = new MinioBackend(config);
+    // 🔴 `ctx.effect(fn)` **立即执行 fn**,并把 fn 的返回值当卸载时的 disposer。
+    //    第一版写成 `const d = provide(...); ctx.effect(() => d())` ——
+    //    那当场就把刚 provide 的服务撤销了,而且**没有任何报错**:
+    //    apply 照常跑完、日志照常打,只有 inject 它的插件永远 PENDING。
+    //    (2026-08-28 实测:线上 `reflect.get('sps.storage')` 拿不到,
+    //     而同一次装配里 `[sps-sync] 常驻` 已经打出来了。)
+    //    ⇒ 本仓先例是 `ctx.effect(() => ctx[AGENTS].register(f))` —— register 返回 unregister。
+    ctx.effect(() => ctx.reflect.provide('sps.storage', {
+        configured: () => Boolean(config.endpoint && config.bucket && config.enabled !== false),
+        get: (key) => backend.get(key),
+        list: (prefix) => backend.list(prefix),
+        put: (key, bytes, contentType) => backend.put(key, bytes, contentType),
+    }));
     log(`[sps-sync] 常驻:间隔=${intervalMs}ms 范围=近 ${sinceDays || '∞'} 天`);
     void tick().finally(schedule);
     // 插件卸载/重挂时停掉循环 —— 否则改一次配置就多一个循环在跑。

package/dist/schema.js

@@ -15,7 +15,7 @@ import Schema from '@deepseek-ai/schemastery';
 export const Config = Schema.object({
     enabled: Schema.boolean()
         .default(false)
-        .description('是否开启同步。**默认关** —— 没配桶时开着只会每轮打日志。'),
+        .description('是否开启同步。默认关 —— 没配桶时开着只会每轮打日志。'),
     endpoint: Schema.string().description('S3 兼容端点,如 http://127.0.0.1:9000'),
     bucket: Schema.string().description('桶名。插件只认这一个名字,不认识桶里的语义分区。'),
     accessKey: Schema.string().role('secret').description('访问密钥 ID'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coralai/sps-plugin-storage-sync",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "工作区 → 对象存储同步:把节点本地盘上的用户产物搬到共享面(S3 兼容桶)。",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,7 +28,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@coralai/sps-plugin-api": "^0.13.0"
+    "@coralai/sps-plugin-api": "^0.14.0"
   },
   "optionalDependencies": {
     "minio": "^8.0.7"