@follenfang/fupload 0.0.20 → 0.0.22

package/fupload/SKILL.md

@@ -2,7 +2,7 @@
 name: fupload
 description: Explicit author-publishing workflow for World of Warcraft plugins, configuration shares, and WA/strings on NewBeeBox, NetEase DD, CurseForge, Heybox Workshop, and ModUs.Creator, including local Creator login reuse and plugin ZIP publishing. Use only when the user explicitly invokes `$fupload`, explicitly asks to use the Fupload Skill, or loads this Skill by path. Do not trigger from ordinary mentions of publishing, NewBeeBox, DD, CurseForge, Heybox, ModUs, plugins, configurations, or WA.
 metadata:
-  version: "0.0.20"
+  version: "0.0.22"
 ---
 
 # Fupload
@@ -22,7 +22,7 @@ Map natural language consistently:
 
 - `create`: create the main record. If first content is a separate platform action, plan it as a following atomic step.
 - `update`: publish a plugin version, change selected configuration-backup content, or publish a WA/string version.
-- `edit`: change fields allowed by the target platform's action allowlist. For DD plugins, this includes `description` and existing-record commercial, association, room/channel, and creation-statement settings; other first-publication metadata, categories, media, and version fields are create/update-only. Description edits read both detail and author-list projections; either may confirm the value, but if neither matches, report verification-required.
+- `edit`: change fields allowed by the target platform's action allowlist. For DD plugins, this includes `description`, `html_desc`, and existing-record commercial, association, room/channel, and creation-statement settings; other first-publication metadata, categories, media, and version fields are create/update-only. Description edits read both detail and author-list projections; either may confirm the value, but if neither matches, report verification-required.
 - `delete`: delete one main record only. It never deletes an individual version, media object, or associated record.
 
 Never offer bulk delete, drafts, guides, messages, or GUI control automation. Heybox supports individual version deletion with asynchronous readback; whole-module deletion is not supported. The DD task-session command may close verified official GUI processes only after the consent flow below.

package/fupload/references/dd.md

@@ -73,7 +73,7 @@ A published version's `update_desc` cannot be corrected through the CLI: `plugin
 
 Every path in `detail_img_files` must exist as a regular local file. Validation reports the exact indexed path, such as `$.detail_img_files[0]`, before any upload or mutation.
 
-`game_type` and the outer free/paid state are create-only. `plugin update` requires `sn`, `game_versions`, `version`, and `update_desc`; optional `file`, `detail_url`, and `release_type` publish a new version. `plugin edit` requires `sn` and accepts `description` plus the official existing-record commercial and association controls (`scope`, payment/lifetime/VIP fields, room/channel linkage, `creation_statement`, and associated content). Other first-publication metadata (`addon_type`, `name`, logo, detail images, categories, and `html_desc`) and version fields are not edit fields. The CLI verifies a description edit through both detail and author-list readback; if DD accepts the request but leaves the remote value unchanged, it reports a verification-required error rather than false success.
+`game_type` and the outer free/paid state are create-only. `plugin update` requires `sn`, `game_versions`, `version`, and `update_desc`; optional `file`, `detail_url`, and `release_type` publish a new version. `plugin edit` requires `sn` and accepts `description`, `html_desc`, plus the official existing-record commercial and association controls (`scope`, payment/lifetime/VIP fields, room/channel linkage, `creation_statement`, and associated content). Other first-publication metadata (`addon_type`, `name`, logo, detail images, and categories) and version fields are not edit fields. The CLI verifies description edits through both detail and author-list readback; if DD accepts the request but leaves the remote value unchanged, it reports a verification-required error rather than false success.
 
 When `assign_user_sn` is present, the official UI exposes only the public scope option. Python validates the final rebuilt form and rejects a private scope before upload or mutation.
 

package/fupload/scripts/fupload_cli/__init__.py

@@ -1,3 +1,3 @@
 """Fupload Python CLI."""
 
-__version__ = "0.0.20"
+__version__ = "0.0.22"

package/fupload/scripts/fupload_cli/dd.py

@@ -1465,10 +1465,11 @@ PLUGIN_CREATE_DEFAULTS = {
 
 # DD's modify form is not a second create form. The official edit page
 # rebuilds the payload from existing commercial/association controls. The
-# brief description is the supported metadata exception and is verified by
-# detail and author-list readback after every edit.
+# brief and rich-text detail descriptions are the supported metadata
+# exceptions and are verified by detail and author-list readback after every
+# edit. Other first-publication metadata remains create-only.
 PLUGIN_EDIT_FIELDS = (
-    "description",
+    "description", "html_desc",
     "scope", "share_code_life_type", "need_buy", "price_fen", "buy_life_type",
     "jump_room", "room_id", "channel_id", "channel_type", "sync_room",
     "creation_statement", "with_associate", "associated_acts", "need_anchor_vip",
@@ -1485,13 +1486,15 @@ def plugin_form(
         if isinstance(author_value, Mapping) and isinstance(author_value.get("latest_version"), dict)
         else {}
     )
-    # Official detail dialog projection followed by the editor's pick list.
+    # The author list is the live publication projection. DD detail_v2 can
+    # retain an older latest_version, so an available author-list value wins
+    # over detail for the version/package fields used to rebuild modify form.
     source = {name: copy.deepcopy(value[name]) for name in PLUGIN_FIELDS if name in value}
     for name in ("detail_url", "release_type", "version"):
         latest_name = {"detail_url": "file_path"}.get(name, name)
-        projected = latest.get(latest_name)
+        projected = author_latest.get(latest_name)
         if projected is None:
-            projected = author_latest.get(latest_name)
+            projected = latest.get(latest_name)
         if projected is None:
             source.pop(name, None)
         else:
@@ -1516,22 +1519,29 @@ def plugin_form(
     return form
 
 
-def plugin_version_projection(value: Mapping[str, Any]) -> Dict[str, Any]:
+def plugin_version_projection(
+    value: Mapping[str, Any], author_value: Optional[Mapping[str, Any]] = None,
+) -> Dict[str, Any]:
     """Project version fields for readback without feeding them into modify."""
     latest = value.get("latest_version") if isinstance(value.get("latest_version"), dict) else {}
+    author_latest = (
+        author_value.get("latest_version")
+        if isinstance(author_value, Mapping) and isinstance(author_value.get("latest_version"), dict)
+        else {}
+    )
     projection: Dict[str, Any] = {}
     sources = {
-        "game_versions": (latest, "game_versions", value, "game_versions"),
-        "detail_url": (latest, "file_path", value, "detail_url"),
-        "release_type": (latest, "release_type", value, "release_type"),
-        "version": (latest, "version", value, "version"),
-        "update_desc": (latest, "update_desc", value, "update_desc"),
+        "game_versions": ((author_latest, "game_versions"), (latest, "game_versions"), (value, "game_versions")),
+        "detail_url": ((author_latest, "file_path"), (latest, "file_path"), (value, "detail_url")),
+        "release_type": ((author_latest, "release_type"), (latest, "release_type"), (value, "release_type")),
+        "version": ((author_latest, "version"), (latest, "version"), (value, "version")),
+        "update_desc": ((author_latest, "update_desc"), (latest, "update_desc"), (value, "update_desc")),
     }
-    for name, (preferred, preferred_name, fallback, fallback_name) in sources.items():
-        if preferred.get(preferred_name) is not None:
-            projection[name] = copy.deepcopy(preferred[preferred_name])
-        elif fallback.get(fallback_name) is not None:
-            projection[name] = copy.deepcopy(fallback[fallback_name])
+    for name, candidates in sources.items():
+        for source, source_name in candidates:
+            if source.get(source_name) is not None:
+                projection[name] = copy.deepcopy(source[source_name])
+                break
     return projection
 
 
@@ -2087,11 +2097,33 @@ class DD:
             apply_present(form, doc, PLUGIN_FIELDS)
         else:
             current = self._fresh_detail(session, "plugin", doc["sn"])
+            if current.get("assign_user_sn") and doc.get("scope") == "private":
+                raise ValidationError("assigned plugins can only use public scope", path="$.scope")
             game_type = current.get("game_type") or (current.get("game_types") or [None])[0]
             listing = author_item(
                 session, "plugin", str(doc["sn"]), str(current.get("name") or ""), game_type,
             )
-            form = plugin_form(current, listing)
+            if action == "edit":
+                if not listing:
+                    raise FuploadError(
+                        "DD author-list projection is required to preserve the published plugin version",
+                        kind="verification_required", stage="dependency_get", endpoint="/addon/list",
+                        verification_required=True,
+                    )
+                published_version = plugin_version_projection({}, listing)
+                missing_published = [
+                    name for name in ("detail_url", "release_type", "version")
+                    if name not in published_version
+                ]
+                if missing_published:
+                    raise FuploadError(
+                        "DD author-list projection is missing published plugin field(s): %s"
+                        % ", ".join(missing_published),
+                        kind="verification_required", stage="dependency_get", endpoint="/addon/list",
+                        verification_required=True,
+                        details={"fields": missing_published},
+                    )
+            form = plugin_form(current, listing) if action == "edit" else plugin_form(current)
             allowed = PLUGIN_EDIT_FIELDS if action == "edit" else ("game_versions", "detail_url", "release_type", "version", "update_desc")
             current_version = str(form.get("version") or "").strip()
             apply_present(form, doc, allowed)
@@ -2151,6 +2183,7 @@ class DD:
             "creation_statement", "need_buy",
             "price_fen", "buy_life_type", "jump_room", "room_id", "channel_id", "channel_type",
             "sync_room", "with_associate", "associated_acts", "need_anchor_vip", "vip_levels",
+            "game_versions", "detail_url", "release_type", "version",
         )
         if action != "update":
             raw_readback: Any = {}

package/fupload/scripts/fupload_cli/schema.py

@@ -581,6 +581,10 @@ DD_PLUGIN_EDIT_META = {
     for name in DD_COMMERCIAL
 }
 DD_PLUGIN_EDIT_META["description"] = DD_PLUGIN_META["description"]
+# DD's modify form accepts the existing plugin's rich-text detail body as
+# metadata. Keep the other first-publication metadata (name, logo, images,
+# categories, etc.) create-only, but allow an explicit html_desc edit.
+DD_PLUGIN_EDIT_META["html_desc"] = DD_PLUGIN_META["html_desc"]
 DD_PLUGIN_VERSION = {
     "game_versions": f("array", nonempty=True), "detail_url": f("string"),
     "file": f("string", local_file=True), "release_type": f("integer", choices=(1, 2, 3)),

package/npm/skill-manifest.json

@@ -1,9 +1,9 @@
 {
   "schema": "fupload.npm-skill-manifest.v1",
   "package_name": "@follenfang/fupload",
-  "package_version": "0.0.20",
-  "skill_version": "0.0.20",
-  "tree_sha256": "bea57f52a133edcd0062736fb1f7c0c560293cb51454275bb1d7bf2234c2d67c",
+  "package_version": "0.0.22",
+  "skill_version": "0.0.22",
+  "tree_sha256": "fffd84093cea75f44ca8ad836f4cfb643e692cf121162201892ad130f23fbc5a",
   "files": [
     {
       "path": "agents/openai.yaml",
@@ -88,7 +88,7 @@
     {
       "path": "references/dd.md",
       "bytes": 20837,
-      "sha256": "583a3531cfabf6749c31088a88b3bbad2c516e1eae0b100433305f26894c153d"
+      "sha256": "4a174fa9470a23aee5c607b85123575c157559570a2d3fd4caa9a0874f9ae934"
     },
     {
       "path": "references/modus.md",
@@ -113,7 +113,7 @@
     {
       "path": "scripts/fupload_cli/__init__.py",
       "bytes": 50,
-      "sha256": "72c39ea05a04d5f631b53d5363ab86a8c974169c19c56245d7ab2c3c16498ba4"
+      "sha256": "0cec28503481955d702020619b9cd9b3ec7032c4d20be0bbad2aa9f4f5dac6f8"
     },
     {
       "path": "scripts/fupload_cli/blackbox_web.py",
@@ -147,8 +147,8 @@
     },
     {
       "path": "scripts/fupload_cli/dd.py",
-      "bytes": 115390,
-      "sha256": "e160eeebb2914016d99f6dad1ad38b61fa201c884bb2314090839408fa70cd58"
+      "bytes": 117372,
+      "sha256": "19a303e84ce08dd3af9a905d04d24f7224c3302f83f0d62f899618cf45fe0433"
     },
     {
       "path": "scripts/fupload_cli/errors.py",
@@ -182,8 +182,8 @@
     },
     {
       "path": "scripts/fupload_cli/schema.py",
-      "bytes": 54628,
-      "sha256": "6eead57520d6f1d0db62d6da764c4e419cca24a267483dd3708f212a492e396a"
+      "bytes": 54911,
+      "sha256": "bede6cc93de8a9d766e463cab0acb8725745da781aebabba73744394b594b93c"
     },
     {
       "path": "scripts/fupload_cli/state_machine.py",
@@ -207,8 +207,8 @@
     },
     {
       "path": "SKILL.md",
-      "bytes": 28568,
-      "sha256": "98335037547a916e251f65c39a686eb3c9a58468f113531c1e28a9ec225198e9"
+      "bytes": 28582,
+      "sha256": "925b6b480edae4272a6922200a7f046e95df96908edecd4660e1fc49bdb6688d"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@follenfang/fupload",
-  "version": "0.0.20",
+  "version": "0.0.22",
   "description": "Install and run the Fuploader Agent Skill and Python CLI.",
   "type": "module",
   "bin": {