@xiongtao.xt/tau-plugins 0.23.1 → 0.25.0

package/client/chunk-GQO6J7O3.js

@@ -0,0 +1,281 @@
+// packages/plugins/src/ids.ts
+function assertLocalId(value) {
+  if (typeof value !== "string" || !/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/.test(value)) {
+    throw new Error("\u63D2\u4EF6\u6807\u8BC6\u5FC5\u987B\u4E3A 1 \u81F3 128 \u4F4D\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u70B9\u3001\u6A2A\u7EBF\u6216\u4E0B\u5212\u7EBF");
+  }
+}
+
+// packages/plugins/src/version.ts
+function parseVersion(value) {
+  const match = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.exec(
+    value
+  );
+  if (!match) throw new Error(`\u7248\u672C\u53F7\u65E0\u6548\uFF1A${value}`);
+  const pre = match[4]?.split(".") ?? [];
+  if (pre.some((part) => /^\d+$/.test(part) && part.length > 1 && part.startsWith("0")))
+    throw new Error(`\u7248\u672C\u53F7\u65E0\u6548\uFF1A${value}`);
+  return { core: match.slice(1, 4), pre };
+}
+function comparePluginVersions(left, right) {
+  const a = parseVersion(left);
+  const b = parseVersion(right);
+  const numeric = (x, y) => BigInt(x) === BigInt(y) ? 0 : BigInt(x) > BigInt(y) ? 1 : -1;
+  for (let index = 0; index < 3; index++) {
+    const result = numeric(a.core[index], b.core[index]);
+    if (result) return result;
+  }
+  if (!a.pre.length || !b.pre.length)
+    return a.pre.length === b.pre.length ? 0 : a.pre.length ? -1 : 1;
+  for (let index = 0; index < Math.max(a.pre.length, b.pre.length); index++) {
+    const x = a.pre[index], y = b.pre[index];
+    if (x === void 0 || y === void 0) return x === void 0 ? -1 : 1;
+    if (x === y) continue;
+    const nx = /^\d+$/.test(x), ny = /^\d+$/.test(y);
+    return nx && ny ? numeric(x, y) : nx !== ny ? nx ? -1 : 1 : x > y ? 1 : -1;
+  }
+  return 0;
+}
+
+// packages/plugins/src/categories.ts
+var PLUGIN_CATEGORIES = [
+  { id: "sync", label: "\u540C\u6B65" },
+  { id: "upload", label: "\u8D44\u6E90\u4E0A\u4F20" },
+  { id: "editor", label: "\u7F16\u8F91\u5668" },
+  { id: "whiteboard", label: "\u767D\u677F" },
+  { id: "blog-template", label: "\u535A\u5BA2\u6A21\u677F" },
+  { id: "blog-publish", label: "\u535A\u5BA2\u53D1\u5E03" },
+  { id: "ai", label: "AI" },
+  { id: "voice", label: "\u8BED\u97F3" },
+  { id: "video", label: "\u5728\u7EBF\u89C6\u9891" },
+  { id: "page", label: "\u9875\u9762" }
+];
+var PLUGIN_KEYWORD_LIMIT = 5;
+var PLUGIN_KEYWORD_MAX_LENGTH = 20;
+var categoryIds = new Set(PLUGIN_CATEGORIES.map((item) => item.id));
+var isPluginCategory = (value) => typeof value === "string" && categoryIds.has(value);
+function readCatalogFields(item, strict) {
+  const fail = (message) => {
+    if (strict) throw new Error(message);
+  };
+  const list = (value, name) => {
+    if (value === void 0) return [];
+    if (Array.isArray(value)) return value;
+    fail(`${name} \u5FC5\u987B\u662F\u6570\u7EC4`);
+    return [];
+  };
+  const categories = [];
+  for (const value of list(item.categories, "categories")) {
+    if (!isPluginCategory(value)) fail(`\u672A\u77E5\u63D2\u4EF6\u5206\u7C7B\uFF1A${String(value)}`);
+    else if (!categories.includes(value)) categories.push(value);
+  }
+  const keywords = [];
+  for (const value of list(item.keywords, "keywords")) {
+    const keyword = typeof value === "string" ? value.trim() : "";
+    if (!keyword || keyword.length > PLUGIN_KEYWORD_MAX_LENGTH)
+      fail(`\u5173\u952E\u8BCD\u5FC5\u987B\u4E3A 1 \u81F3 ${PLUGIN_KEYWORD_MAX_LENGTH} \u5B57`);
+    else if (!keywords.includes(keyword)) keywords.push(keyword);
+  }
+  if (keywords.length > PLUGIN_KEYWORD_LIMIT) {
+    fail(`\u5173\u952E\u8BCD\u6700\u591A ${PLUGIN_KEYWORD_LIMIT} \u4E2A`);
+    keywords.length = PLUGIN_KEYWORD_LIMIT;
+  }
+  return {
+    ...categories.length ? { categories: Object.freeze(categories) } : {},
+    ...keywords.length ? { keywords: Object.freeze(keywords) } : {}
+  };
+}
+
+// packages/plugins/src/permissions.ts
+var PLUGIN_PERMISSIONS = [
+  "cards:read",
+  "cards:write",
+  "cards:delete",
+  "articles:read",
+  "articles:write",
+  "articles:delete",
+  "documents:read",
+  "documents:write",
+  "todos:read",
+  "todos:write",
+  "todos:delete",
+  "calendar:read",
+  "calendar:write",
+  "calendar:delete"
+];
+var permissionIds = new Set(PLUGIN_PERMISSIONS);
+var isPluginPermission = (value) => typeof value === "string" && permissionIds.has(value);
+function readPermissionsField(item, strict) {
+  const fail = (message) => {
+    if (strict) throw new Error(message);
+  };
+  if (item.permissions === void 0) return {};
+  if (!Array.isArray(item.permissions)) {
+    fail("permissions \u5FC5\u987B\u662F\u6570\u7EC4");
+    return {};
+  }
+  const permissions = [];
+  for (const value of item.permissions) {
+    if (!isPluginPermission(value)) fail(`\u672A\u77E5\u63D2\u4EF6\u6743\u9650\uFF1A${String(value)}`);
+    else if (!permissions.includes(value)) permissions.push(value);
+  }
+  return permissions.length ? { permissions: Object.freeze(permissions) } : {};
+}
+
+// packages/plugins/src/backend-manifest.ts
+var PLUGIN_SYSTEM_ACCESS = ["filesystem", "network", "process"];
+function validateBackendManifest(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    throw new Error("\u540E\u53F0\u58F0\u660E\u5FC5\u987B\u662F\u5BF9\u8C61");
+  const item = value;
+  const keys = [
+    "entry",
+    "runtime",
+    "apiVersion",
+    "scope",
+    "activation",
+    "lifetime",
+    "reason",
+    "systemAccess",
+    "tools"
+  ];
+  if (Object.keys(item).some((key) => !keys.includes(key))) throw new Error("\u540E\u53F0\u58F0\u660E\u5305\u542B\u672A\u77E5\u5B57\u6BB5");
+  if (typeof item.entry !== "string" || !/^[\w./-]+\.js$/.test(item.entry) || item.entry.split("/").some((part) => !part || part === "." || part === ".."))
+    throw new Error("\u540E\u53F0\u5165\u53E3\u5FC5\u987B\u662F\u5305\u5185 JS \u6587\u4EF6");
+  if (item.runtime !== "node" || item.apiVersion !== 1)
+    throw new Error("\u540E\u53F0\u8FD0\u884C\u65F6\u6216\u534F\u8BAE\u7248\u672C\u4E0D\u517C\u5BB9");
+  if (item.scope !== "application" && item.scope !== "workspace") throw new Error("\u540E\u53F0\u4F5C\u7528\u57DF\u65E0\u6548");
+  if (item.activation !== "on-demand" && item.activation !== "app-ready" && item.activation !== "workspace-ready")
+    throw new Error("\u540E\u53F0\u6FC0\u6D3B\u65F6\u673A\u65E0\u6548");
+  if (item.activation !== "on-demand" && item.activation !== (item.scope === "application" ? "app-ready" : "workspace-ready"))
+    throw new Error("\u540E\u53F0\u6FC0\u6D3B\u65F6\u673A\u4E0E\u4F5C\u7528\u57DF\u4E0D\u5339\u914D");
+  if (item.lifetime !== "idle" && item.lifetime !== "persistent")
+    throw new Error("\u540E\u53F0\u751F\u547D\u5468\u671F\u65E0\u6548");
+  if (typeof item.reason !== "string" || !item.reason.trim() || item.reason.length > 500)
+    throw new Error("\u540E\u53F0\u7528\u9014\u5FC5\u987B\u4E3A 1 \u81F3 500 \u5B57");
+  if (!Array.isArray(item.systemAccess) || new Set(item.systemAccess).size !== item.systemAccess.length || item.systemAccess.some((value2) => !PLUGIN_SYSTEM_ACCESS.includes(value2)))
+    throw new Error("\u540E\u53F0\u7CFB\u7EDF\u7528\u9014\u5206\u7C7B\u65E0\u6548");
+  let tools;
+  if (item.tools !== void 0) {
+    if (!Array.isArray(item.tools) || item.tools.length > 32 || !item.systemAccess.includes("process"))
+      throw new Error("\u5916\u90E8\u5DE5\u5177\u987B\u58F0\u660E process \u7528\u9014\uFF0C\u6700\u591A 32 \u9879");
+    const ids = /* @__PURE__ */ new Set();
+    tools = Object.freeze(
+      item.tools.map((tool) => {
+        if (!tool || typeof tool !== "object" || Array.isArray(tool))
+          throw new Error("\u5916\u90E8\u5DE5\u5177\u58F0\u660E\u65E0\u6548");
+        const value2 = tool;
+        if (Object.keys(value2).some((key) => !["id", "command", "args"].includes(key)) || typeof value2.id !== "string" || !/^[a-z][\w.-]{0,63}$/.test(value2.id) || ids.has(value2.id) || typeof value2.command !== "string" || !value2.command.trim() || value2.command.length > 1024 || /[\0\r\n]/.test(value2.command))
+          throw new Error("\u5916\u90E8\u5DE5\u5177\u8EAB\u4EFD\u6216\u547D\u4EE4\u65E0\u6548");
+        ids.add(value2.id);
+        if (value2.args !== void 0 && (!Array.isArray(value2.args) || value2.args.length > 64 || value2.args.some(
+          (arg) => typeof arg !== "string" || arg.length > 4096 || arg.includes("\0")
+        )))
+          throw new Error("\u5916\u90E8\u5DE5\u5177\u53C2\u6570\u65E0\u6548");
+        return Object.freeze({
+          id: value2.id,
+          command: value2.command,
+          ...value2.args ? { args: Object.freeze([...value2.args]) } : {}
+        });
+      })
+    );
+  }
+  return Object.freeze({
+    ...tools ? { tools } : {},
+    entry: item.entry,
+    runtime: "node",
+    apiVersion: 1,
+    scope: item.scope,
+    activation: item.activation,
+    lifetime: item.lifetime,
+    reason: item.reason.trim(),
+    systemAccess: Object.freeze([...item.systemAccess])
+  });
+}
+
+// packages/plugins/src/package.ts
+var PLUGIN_SHARED_MODULES = [
+  "@tau/plugins",
+  "@tau/plugins/whiteboard",
+  "@tau/plugins/sync",
+  "@tau/ui",
+  "react",
+  "react-dom",
+  "react-dom/client",
+  "react/jsx-runtime",
+  "react/jsx-dev-runtime"
+];
+function validatePluginManifest(value, options = {}) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    throw new Error("\u63D2\u4EF6\u6E05\u5355\u5FC5\u987B\u662F\u5BF9\u8C61");
+  const item = value;
+  if (item.formatVersion !== 1 && item.formatVersion !== 2 || item.apiVersion !== 1 || item.platform !== "desktop" || item.format !== "cjs")
+    throw new Error("\u63D2\u4EF6\u5305\u683C\u5F0F\u3001API \u7248\u672C\u6216\u5E73\u53F0\u4E0D\u517C\u5BB9");
+  if (typeof item.id !== "string") throw new Error("\u63D2\u4EF6 ID \u65E0\u6548");
+  assertLocalId(item.id);
+  if (typeof item.name !== "string" || !item.name.trim() || typeof item.version !== "string" || !/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(item.version))
+    throw new Error("\u63D2\u4EF6\u540D\u79F0\u6216\u7248\u672C\u65E0\u6548");
+  const file = (input, extension) => {
+    if (typeof input !== "string" || !/^[\w./-]+$/.test(input) || input.split("/").some((part) => !part || part === "." || part === "..") || !input.endsWith(extension))
+      throw new Error("\u63D2\u4EF6\u5165\u53E3\u6216\u6837\u5F0F\u8DEF\u5F84\u65E0\u6548");
+    return input;
+  };
+  const main = file(item.main, ".js");
+  const backend = item.backend === void 0 ? void 0 : validateBackendManifest(item.backend);
+  if (item.formatVersion === 2 !== Boolean(backend))
+    throw new Error("\u540E\u53F0\u58F0\u660E\u5FC5\u987B\u4F7F\u7528\u5305\u683C\u5F0F 2\uFF0C\u666E\u901A\u63D2\u4EF6\u4F7F\u7528\u683C\u5F0F 1");
+  if (backend?.entry === main) throw new Error("\u540E\u53F0\u5165\u53E3\u4E0D\u80FD\u4E0E\u6E32\u67D3\u5165\u53E3\u76F8\u540C");
+  if (backend && typeof item.minAppVersion !== "string")
+    throw new Error("\u540E\u53F0\u63D2\u4EF6\u5FC5\u987B\u58F0\u660E\u6700\u4F4E\u5BA2\u6237\u7AEF\u7248\u672C");
+  if (item.minAppVersion !== void 0) {
+    if (typeof item.minAppVersion !== "string") throw new Error("\u6700\u4F4E\u5BA2\u6237\u7AEF\u7248\u672C\u65E0\u6548");
+    comparePluginVersions(item.minAppVersion, item.minAppVersion);
+  }
+  const styles = item.styles === void 0 ? void 0 : file(item.styles, ".css");
+  if (item.editor !== void 0 && item.editor !== true) throw new Error("editor \u53EA\u80FD\u58F0\u660E\u4E3A true");
+  if (item.whiteboard !== void 0 && item.whiteboard !== true)
+    throw new Error("whiteboard \u53EA\u80FD\u58F0\u660E\u4E3A true");
+  const catalog = readCatalogFields(item, options.strict === true);
+  const permissions = readPermissionsField(item, options.strict === true);
+  const integrity = {};
+  for (const name of [main, ...styles ? [styles] : [], ...backend ? [backend.entry] : []]) {
+    const hash = item.integrity && typeof item.integrity === "object" ? item.integrity[name] : void 0;
+    if (typeof hash !== "string" || !/^[a-f0-9]{64}$/.test(hash))
+      throw new Error("\u63D2\u4EF6\u4EA7\u7269\u7F3A\u5C11\u6709\u6548\u7684\u5B8C\u6574\u6027\u6458\u8981");
+    integrity[name] = hash;
+  }
+  return Object.freeze({
+    formatVersion: item.formatVersion,
+    id: item.id,
+    name: item.name,
+    version: item.version,
+    ...typeof item.minAppVersion === "string" ? { minAppVersion: item.minAppVersion } : {},
+    apiVersion: 1,
+    platform: "desktop",
+    format: "cjs",
+    main,
+    ...backend ? { backend } : {},
+    ...item.editor === true ? { editor: true } : {},
+    ...item.whiteboard === true ? { whiteboard: true } : {},
+    ...catalog,
+    ...permissions,
+    integrity: Object.freeze(integrity),
+    ...styles === void 0 ? {} : { styles }
+  });
+}
+var isContentPlugin = (manifest) => manifest.editor === true || manifest.whiteboard === true;
+
+export {
+  assertLocalId,
+  comparePluginVersions,
+  PLUGIN_CATEGORIES,
+  PLUGIN_KEYWORD_LIMIT,
+  PLUGIN_KEYWORD_MAX_LENGTH,
+  isPluginCategory,
+  PLUGIN_PERMISSIONS,
+  isPluginPermission,
+  PLUGIN_SYSTEM_ACCESS,
+  validateBackendManifest,
+  PLUGIN_SHARED_MODULES,
+  validatePluginManifest,
+  isContentPlugin
+};

package/package.js

@@ -0,0 +1,30 @@
+import {
+  PLUGIN_CATEGORIES,
+  PLUGIN_KEYWORD_LIMIT,
+  PLUGIN_KEYWORD_MAX_LENGTH,
+  PLUGIN_PERMISSIONS,
+  PLUGIN_SHARED_MODULES,
+  PLUGIN_SYSTEM_ACCESS,
+  assertLocalId,
+  comparePluginVersions,
+  isContentPlugin,
+  isPluginCategory,
+  isPluginPermission,
+  validateBackendManifest,
+  validatePluginManifest
+} from "./client/chunk-GQO6J7O3.js";
+export {
+  PLUGIN_CATEGORIES,
+  PLUGIN_KEYWORD_LIMIT,
+  PLUGIN_KEYWORD_MAX_LENGTH,
+  PLUGIN_PERMISSIONS,
+  PLUGIN_SHARED_MODULES,
+  PLUGIN_SYSTEM_ACCESS,
+  assertLocalId,
+  comparePluginVersions,
+  isContentPlugin,
+  isPluginCategory,
+  isPluginPermission,
+  validateBackendManifest,
+  validatePluginManifest
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiongtao.xt/tau-plugins",
-  "version": "0.23.1",
+  "version": "0.25.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -18,6 +18,14 @@
       "default": "./runtime.js"
     },
     "./tailwind.css": "./tailwind.css",
+    "./package": {
+      "types": "./types/packages/plugins/src/package.d.ts",
+      "default": "./package.js"
+    },
+    "./backend": {
+      "types": "./types/packages/plugins/src/backend.d.ts",
+      "default": "./runtime.js"
+    },
     "./sync": {
       "types": "./types/packages/plugins/src/sync.d.ts",
       "default": "./runtime.js"

package/publish-artifacts.js

@@ -1,152 +1,7 @@
-// packages/plugins/src/ids.ts
-function assertLocalId(value) {
-  if (typeof value !== "string" || !/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}$/.test(value)) {
-    throw new Error("\u63D2\u4EF6\u6807\u8BC6\u5FC5\u987B\u4E3A 1 \u81F3 128 \u4F4D\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u70B9\u3001\u6A2A\u7EBF\u6216\u4E0B\u5212\u7EBF");
-  }
-}
-
-// packages/plugins/src/version.ts
-function parseVersion(value) {
-  const match = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.exec(
-    value
-  );
-  if (!match) throw new Error(`\u7248\u672C\u53F7\u65E0\u6548\uFF1A${value}`);
-  const pre = match[4]?.split(".") ?? [];
-  if (pre.some((part) => /^\d+$/.test(part) && part.length > 1 && part.startsWith("0")))
-    throw new Error(`\u7248\u672C\u53F7\u65E0\u6548\uFF1A${value}`);
-  return { core: match.slice(1, 4), pre };
-}
-function comparePluginVersions(left, right) {
-  const a = parseVersion(left);
-  const b = parseVersion(right);
-  const numeric = (x, y) => BigInt(x) === BigInt(y) ? 0 : BigInt(x) > BigInt(y) ? 1 : -1;
-  for (let index = 0; index < 3; index++) {
-    const result = numeric(a.core[index], b.core[index]);
-    if (result) return result;
-  }
-  if (!a.pre.length || !b.pre.length)
-    return a.pre.length === b.pre.length ? 0 : a.pre.length ? -1 : 1;
-  for (let index = 0; index < Math.max(a.pre.length, b.pre.length); index++) {
-    const x = a.pre[index], y = b.pre[index];
-    if (x === void 0 || y === void 0) return x === void 0 ? -1 : 1;
-    if (x === y) continue;
-    const nx = /^\d+$/.test(x), ny = /^\d+$/.test(y);
-    return nx && ny ? numeric(x, y) : nx !== ny ? nx ? -1 : 1 : x > y ? 1 : -1;
-  }
-  return 0;
-}
-
-// packages/plugins/src/categories.ts
-var PLUGIN_CATEGORIES = [
-  { id: "sync", label: "\u540C\u6B65" },
-  { id: "upload", label: "\u8D44\u6E90\u4E0A\u4F20" },
-  { id: "editor", label: "\u7F16\u8F91\u5668" },
-  { id: "whiteboard", label: "\u767D\u677F" },
-  { id: "blog-template", label: "\u535A\u5BA2\u6A21\u677F" },
-  { id: "blog-publish", label: "\u535A\u5BA2\u53D1\u5E03" },
-  { id: "ai", label: "AI" },
-  { id: "voice", label: "\u8BED\u97F3" },
-  { id: "video", label: "\u5728\u7EBF\u89C6\u9891" },
-  { id: "page", label: "\u9875\u9762" }
-];
-var PLUGIN_KEYWORD_LIMIT = 5;
-var PLUGIN_KEYWORD_MAX_LENGTH = 20;
-var categoryIds = new Set(PLUGIN_CATEGORIES.map((item) => item.id));
-var isPluginCategory = (value) => typeof value === "string" && categoryIds.has(value);
-function readCatalogFields(item, strict) {
-  const fail = (message) => {
-    if (strict) throw new Error(message);
-  };
-  const list = (value, name) => {
-    if (value === void 0) return [];
-    if (Array.isArray(value)) return value;
-    fail(`${name} \u5FC5\u987B\u662F\u6570\u7EC4`);
-    return [];
-  };
-  const categories = [];
-  for (const value of list(item.categories, "categories")) {
-    if (!isPluginCategory(value)) fail(`\u672A\u77E5\u63D2\u4EF6\u5206\u7C7B\uFF1A${String(value)}`);
-    else if (!categories.includes(value)) categories.push(value);
-  }
-  const keywords = [];
-  for (const value of list(item.keywords, "keywords")) {
-    const keyword = typeof value === "string" ? value.trim() : "";
-    if (!keyword || keyword.length > PLUGIN_KEYWORD_MAX_LENGTH)
-      fail(`\u5173\u952E\u8BCD\u5FC5\u987B\u4E3A 1 \u81F3 ${PLUGIN_KEYWORD_MAX_LENGTH} \u5B57`);
-    else if (!keywords.includes(keyword)) keywords.push(keyword);
-  }
-  if (keywords.length > PLUGIN_KEYWORD_LIMIT) {
-    fail(`\u5173\u952E\u8BCD\u6700\u591A ${PLUGIN_KEYWORD_LIMIT} \u4E2A`);
-    keywords.length = PLUGIN_KEYWORD_LIMIT;
-  }
-  return {
-    ...categories.length ? { categories: Object.freeze(categories) } : {},
-    ...keywords.length ? { keywords: Object.freeze(keywords) } : {}
-  };
-}
-
-// packages/plugins/src/package.ts
-var PLUGIN_SHARED_MODULES = [
-  "@tau/plugins",
-  "@tau/plugins/whiteboard",
-  "@tau/plugins/sync",
-  "@tau/ui",
-  "react",
-  "react-dom",
-  "react-dom/client",
-  "react/jsx-runtime",
-  "react/jsx-dev-runtime"
-];
-function validatePluginManifest(value, options = {}) {
-  if (!value || typeof value !== "object" || Array.isArray(value))
-    throw new Error("\u63D2\u4EF6\u6E05\u5355\u5FC5\u987B\u662F\u5BF9\u8C61");
-  const item = value;
-  if (item.formatVersion !== 1 || item.apiVersion !== 1 || item.platform !== "desktop" || item.format !== "cjs")
-    throw new Error("\u63D2\u4EF6\u5305\u683C\u5F0F\u3001API \u7248\u672C\u6216\u5E73\u53F0\u4E0D\u517C\u5BB9");
-  if (typeof item.id !== "string") throw new Error("\u63D2\u4EF6 ID \u65E0\u6548");
-  assertLocalId(item.id);
-  if (typeof item.name !== "string" || !item.name.trim() || typeof item.version !== "string" || !/^\d+\.\d+\.\d+(?:-[\w.-]+)?$/.test(item.version))
-    throw new Error("\u63D2\u4EF6\u540D\u79F0\u6216\u7248\u672C\u65E0\u6548");
-  const file = (input, extension) => {
-    if (typeof input !== "string" || !/^[\w./-]+$/.test(input) || input.split("/").some((part) => !part || part === "." || part === "..") || !input.endsWith(extension))
-      throw new Error("\u63D2\u4EF6\u5165\u53E3\u6216\u6837\u5F0F\u8DEF\u5F84\u65E0\u6548");
-    return input;
-  };
-  const main = file(item.main, ".js");
-  if (item.sync !== void 0) throw new Error("Node\u540C\u6B65\u5165\u53E3\u5DF2\u505C\u7528\uFF0C\u8BF7\u66F4\u65B0\u63D2\u4EF6");
-  if (item.minAppVersion !== void 0) {
-    if (typeof item.minAppVersion !== "string") throw new Error("\u6700\u4F4E\u5BA2\u6237\u7AEF\u7248\u672C\u65E0\u6548");
-    comparePluginVersions(item.minAppVersion, item.minAppVersion);
-  }
-  const styles = item.styles === void 0 ? void 0 : file(item.styles, ".css");
-  if (item.editor !== void 0 && item.editor !== true) throw new Error("editor \u53EA\u80FD\u58F0\u660E\u4E3A true");
-  if (item.whiteboard !== void 0 && item.whiteboard !== true)
-    throw new Error("whiteboard \u53EA\u80FD\u58F0\u660E\u4E3A true");
-  const catalog = readCatalogFields(item, options.strict === true);
-  const integrity = {};
-  for (const name of [main, ...styles ? [styles] : []]) {
-    const hash = item.integrity && typeof item.integrity === "object" ? item.integrity[name] : void 0;
-    if (typeof hash !== "string" || !/^[a-f0-9]{64}$/.test(hash))
-      throw new Error("\u63D2\u4EF6\u4EA7\u7269\u7F3A\u5C11\u6709\u6548\u7684\u5B8C\u6574\u6027\u6458\u8981");
-    integrity[name] = hash;
-  }
-  return Object.freeze({
-    formatVersion: 1,
-    id: item.id,
-    name: item.name,
-    version: item.version,
-    ...typeof item.minAppVersion === "string" ? { minAppVersion: item.minAppVersion } : {},
-    apiVersion: 1,
-    platform: "desktop",
-    format: "cjs",
-    main,
-    ...item.editor === true ? { editor: true } : {},
-    ...item.whiteboard === true ? { whiteboard: true } : {},
-    ...catalog,
-    integrity: Object.freeze(integrity),
-    ...styles === void 0 ? {} : { styles }
-  });
-}
+import {
+  PLUGIN_SHARED_MODULES,
+  validatePluginManifest
+} from "./client/chunk-GQO6J7O3.js";
 
 // packages/plugins/src/rendering.ts
 var PLUGIN_RENDER_VERSION = 1;

package/types/packages/plugins/src/app.d.ts

@@ -0,0 +1,55 @@
+import type { PluginContentRef } from "./data";
+/**
+ * 关联与打开已有内容：插件页面（如自建画布）引用用户的卡片、日记、待办等，并在点击时打开。
+ * 引用可以序列化后存入插件自己的数据；id 与 context.data 中同类实体的 id 一致。
+ */
+export type PluginEntityKind = "card" | "article" | "document" | "diary" | "whiteboard" | "todo" | "event";
+export declare const PLUGIN_ENTITY_KINDS: readonly PluginEntityKind[];
+export interface PluginEntityRef {
+    kind: PluginEntityKind;
+    id: string;
+}
+/** 用户选中的一项：标题是选择时的快照，之后的改名需要读取权限才能取到 */
+export interface PluginPickedEntity {
+    ref: PluginEntityRef;
+    title: string;
+}
+export interface PluginPickOptions {
+    /** 可选类型，顺序即弹窗中的分组顺序 */
+    kinds: readonly PluginEntityKind[];
+    /** 默认 false：点选一项即确认 */
+    multiple?: boolean;
+    /** 弹窗标题，默认「选择要关联的内容」 */
+    title?: string;
+}
+export type PluginExportFormat = "markdown" | "image" | "pdf" | "epub";
+export declare const PLUGIN_EXPORT_FORMATS: readonly PluginExportFormat[];
+/** 宿主动作：界面与确认都由 Tau 提供，插件拿不到正文；目前支持卡片、文章与项目文档的正文 */
+export interface PluginAppActions {
+    /** Markdown 直接保存文件；图片、PDF、EPUB 打开导出窗口 */
+    "content.export": {
+        ref: PluginContentRef;
+        format: PluginExportFormat;
+    };
+    /** 全屏演示 */
+    "content.present": {
+        ref: PluginContentRef;
+    };
+    /** 打开「内容协作」窗口，由用户确认发起共享或管理成员 */
+    "content.share": {
+        ref: PluginContentRef;
+    };
+}
+export type PluginAppAction = keyof PluginAppActions;
+export declare const PLUGIN_APP_ACTIONS: readonly PluginAppAction[];
+export interface PluginApp {
+    /**
+     * 打开 Tau 的搜索选择弹窗，返回用户选中的内容；用户取消时返回空数组。
+     * 用户亲手挑选即视为同意插件引用这些内容，不需要读取权限。只能在用户操作（点击、按键）后调用。
+     */
+    pick(options: PluginPickOptions): Promise<PluginPickedEntity[]>;
+    /** 打开对应的页面：卡片详情、日记当天、待办详情、日程详情等。只能在用户操作后调用；内容已删除时抛错。 */
+    open(ref: PluginEntityRef): Promise<void>;
+    /** 执行宿主动作，对应界面打开后返回。只能在用户操作后调用；不需要数据权限；内容已删除时抛错。 */
+    run<A extends PluginAppAction>(action: A, options: PluginAppActions[A]): Promise<void>;
+}

package/types/packages/plugins/src/backend-manifest.d.ts

@@ -0,0 +1,19 @@
+export declare const PLUGIN_SYSTEM_ACCESS: readonly ["filesystem", "network", "process"];
+export type PluginSystemAccess = (typeof PLUGIN_SYSTEM_ACCESS)[number];
+export interface PluginBackendManifest {
+    tools?: readonly {
+        id: string;
+        command: string;
+        args?: readonly string[];
+    }[];
+    entry: string;
+    runtime: "node";
+    apiVersion: 1;
+    scope: "application" | "workspace";
+    activation: "on-demand" | "app-ready" | "workspace-ready";
+    lifetime: "idle" | "persistent";
+    reason: string;
+    /** 系统用途披露，不表示操作系统级权限限制。 */
+    systemAccess: readonly PluginSystemAccess[];
+}
+export declare function validateBackendManifest(value: unknown): PluginBackendManifest;

package/types/packages/plugins/src/backend.d.ts

@@ -0,0 +1,65 @@
+import type { JsonValue } from "./json";
+export type { JsonValue } from "./json";
+export type { PluginBackendManifest } from "./backend-manifest";
+export type BackendState = "stopped" | "starting" | "running" | "draining" | "failed" | "blocked";
+export interface BackendStatus {
+    state: BackendState;
+    generation?: string;
+    pid?: number;
+    error?: string;
+    diagnostics?: {
+        startedAt: number;
+        startupMs?: number;
+        failures: number;
+        timeouts: number;
+    };
+    resources?: {
+        cpuPercent: number;
+        memoryKiB: number;
+    };
+}
+export interface BackendDisposable {
+    dispose(): void | Promise<void>;
+}
+export interface BackendSchema<T extends JsonValue = JsonValue> {
+    parse(value: unknown): T;
+}
+export interface PluginBackendClient {
+    call(method: string, input: JsonValue, options?: {
+        signal?: AbortSignal;
+    }): Promise<JsonValue>;
+    subscribe(event: string, listener: (value: JsonValue) => void): BackendDisposable;
+    getState(): Promise<BackendStatus>;
+}
+export interface BackendContext {
+    readonly process: {
+        run(toolId: string, args?: readonly string[], options?: {
+            signal?: AbortSignal;
+        }): Promise<BackendProcessResult>;
+    };
+    readonly pluginId: string;
+    readonly workspaceId: string | null;
+    readonly signal: AbortSignal;
+    register(resource: BackendDisposable): BackendDisposable;
+    readonly rpc: {
+        register<I extends JsonValue, O extends JsonValue>(method: string, schemas: {
+            input: BackendSchema<I>;
+            output: BackendSchema<O>;
+        }, handler: (input: I, request: {
+            signal: AbortSignal;
+        }) => O | Promise<O>): BackendDisposable;
+        emit(event: string, value: JsonValue): void;
+    };
+}
+export interface BackendProcessResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export interface BackendDefinition {
+    create(): {
+        activate(context: BackendContext): void | Promise<void>;
+        deactivate?(): void | Promise<void>;
+    };
+}
+export declare function defineBackend(definition: BackendDefinition): BackendDefinition;

package/types/packages/plugins/src/components.d.ts

@@ -0,0 +1,30 @@
+import type { ReactElement } from "react";
+import type { PluginContentRef } from "./data";
+/**
+ * 与卡片详情相同的正文编辑器：协作、内置与已安装的编辑器扩展、文档待办都由宿主提供。
+ * 可编辑需要所属实体的写入权限，只读需要读取权限；未授权时显示「允许访问」，由用户点击后询问。
+ * 只能在插件页面内使用。
+ */
+export interface ContentEditorProps {
+    contentRef: PluginContentRef;
+    /** 默认 false */
+    readonly?: boolean;
+    /** 正文为空时的提示文字 */
+    placeholder?: string;
+    /** 打开后滚动并闪烁到的位置：从 Tau 打开插件内容时页面参数 params.at 原样传入 */
+    at?: string;
+}
+/** 正文开头几块的只读渲染，用于列表与卡面；需要所属实体的读取权限。 */
+export interface ContentPreviewProps {
+    contentRef: PluginContentRef;
+    /** 显示的块数，默认 3 */
+    maxBlocks?: number;
+}
+/** 宿主注入的实现；SDK 根入口只引用 React 类型，不加载 React 运行时。 */
+export interface ContentComponentsRuntime {
+    ContentEditor(props: ContentEditorProps): ReactElement | null;
+    ContentPreview(props: ContentPreviewProps): ReactElement | null;
+}
+export declare function configureContentComponents(value: ContentComponentsRuntime): void;
+export declare const ContentEditor: (props: ContentEditorProps) => ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | null;
+export declare const ContentPreview: (props: ContentPreviewProps) => ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | null;