@lingfan-engine/core 0.3.4 → 0.3.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingfan-engine/core",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "type": "module",
   "description": "灵泛叙事引擎核心：框架无关的叙事语义（格式/执行/回溯/作用域/存档编排）",
   "license": "Apache-2.0",

package/src/contracts/story/entities.ts

@@ -134,6 +134,12 @@ export interface ProjectManifest {
   entry: string;
   /** 工程显示名（可选） */
   name?: string;
+  /**
+   * 工程简介（可选）：给玩家看的自由文本（创作者写给自己与读者的一句说明）。
+   * **不参与寻址**：定位靠 `id` 与目录名，标题解析只读 `name` / `id`；
+   * 描述是纯元信息，引擎不据此改变任何行为。
+   */
+  description?: string;
   /** 默认语言（I18N overlay 机制） */
   lang?: string;
   /**

package/src/data/project/assemble.ts

@@ -93,6 +93,14 @@ export function assembleProject(
   if (manifest.lang !== undefined && typeof manifest.lang !== "string") {
     issues.push("project.json: lang 必须为字符串");
   }
+  // 工程简介（给玩家看的自由文本）：只校验形状，内容不限语言与字符集。
+  // 空串合法（作者可能留空），不参与寻址，组装器也不回填进 Story。
+  if (
+    manifest.description !== undefined &&
+    typeof manifest.description !== "string"
+  ) {
+    issues.push("project.json: description 必须为字符串");
+  }
   // 故事版本（作者声明）：正整数；缺席 = 1（读侧 ?? 1 口径，组装器不补默认）
   if (
     manifest.version !== undefined &&