添加国际化助手和插件范围数据存储的支持，更新相关文档和 JSON Schema 定义

Author: hotlong

content/docs/references/system/I18nContext.mdx

@@ -0,0 +1,11 @@
+---
+title: I18nContext
+description: Internationalization Helper
+---
+
+Internationalization Helper
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |

content/docs/references/system/PluginContext.mdx

@@ -10,6 +10,8 @@ description: PluginContext Schema Reference
 | **ql** | `object` | ✅ | ObjectQL Data Access Client |
 | **os** | `object` | ✅ | Access to System Core |
 | **logger** | `object` | ✅ | Structured Logger |
+| **storage** | `object` | ✅ | Plugin Scoped Data Storage (KV) |
+| **i18n** | `object` | ✅ | Internationalization Helper |
 | **metadata** | `any` | optional | Metadata registry |
 | **events** | `any` | optional | Event bus |
 | **app** | `object` | ✅ | App Runtime Capabilities |

content/docs/references/system/ScopedStorage.mdx

@@ -0,0 +1,11 @@
+---
+title: ScopedStorage
+description: Plugin Scoped Data Storage (KV)
+---
+
+Plugin Scoped Data Storage (KV)
+
+## Properties
+
+| Property | Type | Required | Description |
+| :--- | :--- | :--- | :--- |

packages/spec/json-schema/I18nContext.json

@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/I18nContext",
+  "definitions": {
+    "I18nContext": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false,
+      "description": "Internationalization Helper"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

packages/spec/json-schema/Manifest.json

@@ -206,6 +206,55 @@
                 "additionalProperties": false
               },
               "description": "Theme contributions"
+            },
+            "translations": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "locale": {
+                    "type": "string"
+                  },
+                  "path": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "locale",
+                  "path"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Translation resources"
+            },
+            "actions": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "description": "Unique action name"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "input": {
+                    "description": "Input validation schema"
+                  },
+                  "output": {
+                    "description": "Output schema"
+                  }
+                },
+                "required": [
+                  "name"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Exposed server actions"
             }
           },
           "additionalProperties": false,

packages/spec/json-schema/PluginContext.json

@@ -35,6 +35,18 @@
           "additionalProperties": false,
           "description": "Structured Logger"
         },
+        "storage": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": false,
+          "description": "Plugin Scoped Data Storage (KV)"
+        },
+        "i18n": {
+          "type": "object",
+          "properties": {},
+          "additionalProperties": false,
+          "description": "Internationalization Helper"
+        },
         "metadata": {
           "description": "Metadata registry"
         },
@@ -68,6 +80,8 @@
         "ql",
         "os",
         "logger",
+        "storage",
+        "i18n",
         "app"
       ],
       "additionalProperties": false

packages/spec/json-schema/ScopedStorage.json

@@ -0,0 +1,12 @@
+{
+  "$ref": "#/definitions/ScopedStorage",
+  "definitions": {
+    "ScopedStorage": {
+      "type": "object",
+      "properties": {},
+      "additionalProperties": false,
+      "description": "Plugin Scoped Data Storage (KV)"
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

packages/spec/src/system/manifest.zod.ts

@@ -116,6 +116,27 @@ export const ManifestSchema = z.object({
       label: z.string(),
       path: z.string(),
     })).optional().describe('Theme contributions'),
+
+    /**
+     * Register Translations.
+     * Path to translation files (e.g. "locales/en.json").
+     */
+    translations: z.array(z.object({
+      locale: z.string(),
+      path: z.string(),
+    })).optional().describe('Translation resources'),
+
+    /**
+     * Register Server Actions.
+     * Invocable functions exposed to Flows or API.
+     */
+    actions: z.array(z.object({
+       name: z.string().describe('Unique action name'),
+       label: z.string().optional(),
+       description: z.string().optional(),
+       input: z.any().optional().describe('Input validation schema'),
+       output: z.any().optional().describe('Output schema'),
+    })).optional().describe('Exposed server actions'),
   }).optional().describe('Platform contributions'),
 
   /** 

packages/spec/src/system/plugin.zod.ts

@@ -30,6 +30,17 @@ export const SystemAPISchema = z.object({
   getConfig: z.function().args(z.string()).returns(z.promise(z.any())),
 }).describe('Access to System Core');
 
+export const ScopedStorageSchema = z.object({
+  get: z.function().args(z.string()).returns(z.promise(z.any())).describe('Get value by key'),
+  set: z.function().args(z.string(), z.any()).returns(z.promise(z.void())).describe('Set value for key'),
+  delete: z.function().args(z.string()).returns(z.promise(z.void())).describe('Delete key'),
+}).describe('Plugin Scoped Data Storage (KV)');
+
+export const I18nContextSchema = z.object({
+  t: z.function().args(z.string(), z.record(z.any()).optional()).returns(z.string()).describe('Translate a key'),
+  getLocale: z.function().returns(z.string()).describe('Get current context locale'),
+}).describe('Internationalization Helper');
+
 /**
  * Plugin Context Schema
  * 
@@ -76,6 +87,23 @@ export const PluginContextSchema = z.object({
    */
   logger: LoggerSchema,
 
+  /**
+   * Scoped Storage.
+   * Key-Value store isolated for this plugin.
+   * 
+   * @example
+   * await context.storage.set('last_sync', Date.now());
+   */
+  storage: ScopedStorageSchema,
+
+  /**
+   * I18n Helper.
+   * 
+   * @example
+   * const msg = context.i18n.t('error.invalid_input');
+   */
+  i18n: I18nContextSchema,
+
   /**
    * Metadata registry.
    * Provides access to system metadata like object schemas, field definitions, etc.