cortico-world-wardrobe-studio 0.2.3 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.4.0
+
+- Add an opt-in native wardrobe compatibility adapter for the checksum-verified desktop-pet 0.2.0 page: outfits followed by outfit-specific controls.
+- Keep standard native appearance persistence, Coo/unconfigured figures, preview and import/removal flows.
+- Back up before patching; restore on normal stop, recover interrupted installation and refuse overwriting external changes.
+- Use an origin/token-checked, read-only loopback feed without weakening CSP or modifying figure resources.
+- Document supported versions, explicit configuration, uninstall/recovery and the distinction from an official host API.
+- Refresh bilingual project documentation and make the GitHub README English by default.
+
+## 0.3.0
+
+- Default to Chinese with a shared, persistent Chinese/English panel selector; preserve pending choices and JSON drafts when switching.
+- Add a detailed bilingual manual with reference/motion prompts, raw video gates, temporal matting steps, figure runtime requirements and import troubleshooting.
+- Add full field tables, complete fictional profiles and a downloadable JSON Schema.
+- Add read-only configuration checks, local installed-ID inspection and example/manual downloads in the panel.
+- Enforce the profile limit in UTF-8 bytes, including pasted input.
+
 ## 0.2.3
 
 - Follow the host theme with a dotted preview stage, compact outfit cards and horizontal option rows.

package/README.en.md

@@ -0,0 +1,5 @@
+# Wardrobe Studio
+
+English is now the default [README](README.md).
+
+[简体中文](README_zh.md)

package/README.md

@@ -1,44 +1,142 @@
-# Wardrobe Studio · a Cortico World extension
+<div align="center">
 
-Choose an outfit in a separate wardrobe panel, then configure only the options that belong to it. A local profile maps complete combinations to existing figure schemes. The original Coopanion wardrobe page and figure files remain unchanged.
+<img src="assets/icon.svg" width="72" height="72" alt="Wardrobe Studio">
 
-[中文说明](README_zh.md)
+# Wardrobe Studio
 
-![Wholly fictional wardrobe example](assets/wardrobe.png)
+**Choose an outfit. Configure what belongs to it.**
 
-The fictional Moss Fox demonstrates three different groups: trail outfits expose cape and footwear, rain outfits expose hood and raincoat colour, and stargazer outfits expose a visor. Combinations without animation resources cannot be applied. The panel follows the host theme, with a dotted preview stage and compact outfit cards. Installed-character previews use local figure thumbnails; the demonstration contains only fictional artwork.
+Outfit-specific controls and a continuous-animation authoring guide for Coopanion.
 
-## Use
+[![npm](https://img.shields.io/npm/v/cortico-world-wardrobe-studio?color=c87c5d&label=npm)](https://www.npmjs.com/package/cortico-world-wardrobe-studio)
+[![Checks](https://github.com/FelixHenrikChristian/cortico-world-wardrobe-studio/actions/workflows/check.yml/badge.svg)](https://github.com/FelixHenrikChristian/cortico-world-wardrobe-studio/actions/workflows/check.yml)
+[![MIT](https://img.shields.io/badge/license-MIT-6b9f87)](LICENSE)
 
-1. Install this folder using the manual World extension installer. Restart the Core process as requested and enable Wardrobe Studio. Verify it with isolated data before adopting it in a running deployment.
-2. Keep the desktop-pet World available. The default service origin is `http://127.0.0.1:7797`; change it in the extension configuration and restart this World if necessary.
-3. Import a local wardrobe JSON, choose an outfit and options, then Apply. See the [profile format](docs/profile-format.md) and the fictional example.
-4. Before uninstalling, use Restore previous appearance, verify success, disable the World and uninstall it. Normal stopping also attempts restoration. External appearance changes are preserved. See [lifecycle and recovery](docs/lifecycle.md).
+**English** · [简体中文](README_zh.md)
 
-Every mapped combination must already have complete figure resources. The extension does not combine images into new clothing or fill missing motion. Coo's separate accessory contract continues to use its native wardrobe.
+[Get started](#get-started) · [Create a character](docs/agent-workflow.md) · [Profile format](docs/profile-format.md) · [Downloads](https://github.com/FelixHenrikChristian/cortico-world-wardrobe-studio/releases)
 
-## Authoring guide
+</div>
 
-The guide panel and agent tool cover complete dressed references, continuous action video, normal/half-speed and loop acceptance, temporal local matting, declared pose/expression support, runtime integration and versioned releases. The [full workflow](docs/agent-workflow.md) uses generic practices and a fictional example.
+---
 
-Tools: `wardrobe_list`, `wardrobe_choose`, `wardrobe_restore`, `wardrobe_authoring_guide`. Guidance returns instructions; it does not install tools, download models, run generation or read conversations.
+## One outfit, its own controls
 
-## Data and compatibility
+A character's outfits do not need to share every option. Wardrobe Studio groups existing complete figure schemes and displays only the controls that belong to the selected outfit.
+
+| You want to… | Wardrobe Studio provides… |
+| :--- | :--- |
+| Organize a wardrobe | Outfit-specific options; unavailable combinations disabled |
+| Choose a combination | Standard appearance persistence and local thumbnails |
+| Use the native wardrobe | Optional, reversible compatibility adapter in 0.4 |
+| Create a character | Reference prompts, continuous video, playback gates and temporal matting guidance |
+| Write an import profile | Field tables, fictional examples, JSON Schema and installed-ID checks |
+
+> [!IMPORTANT]
+> Native integration is an **experimental opt-in compatibility patch**, not an official World slot. It temporarily patches the checksum-verified desktop-pet page and restores it on normal stop. Unsupported versions are refused. [Supported host, setup and recovery →](docs/native-integration.md)
+
+<details>
+<summary><strong>Separate-panel preview · entirely fictional artwork</strong></summary>
+<br>
+<div align="center"><img src="assets/wardrobe.png" width="500" alt="A wholly fictional Moss Fox wardrobe"></div>
+
+Moss Fox has cape/footwear options for trail outfits, hood/colour for rain outfits, and a visor for stargazer outfits. This screenshot illustrates the separate panel, not native compatibility mode.
+
+</details>
+
+## Get started
+
+### 1 · Install and enable
+
+Find **Wardrobe Studio** / `cortico-world-wardrobe-studio` in Coopanion's World extension market. Restart Core when requested and enable it. Alternatively, download a [GitHub release](https://github.com/FelixHenrikChristian/cortico-world-wardrobe-studio/releases), extract it and select the folder containing `package.json` in the manual installer.
+
+### 2 · Prepare figure resources
+
+Keep the desktop-pet World running and install/verify your figure pack first. The default service is `http://127.0.0.1:7797`; change it in the extension configuration if necessary, then restart this World.
+
+**A wardrobe JSON groups existing resources; it contains no images or videos.** Every mapped combination must already be playable.
+
+### 3 · Check and import
+
+Open **Wardrobe Studio → Wardrobe → Import profile**. Inspect installed IDs, download the fictional example or JSON Schema, fill in your figure/schemes, run **Check configuration**, then import. Choose an outfit/options and **Apply**.
+
+The extension UI defaults to Chinese. Its **中文 / English** selector is persistent and independent of the host language; imported names remain your own text.
+
+[Complete profile format and example →](docs/profile-format.md)
+
+### 4 · Optional native integration
+
+Configure the installed desktop-pet `web` directory, enable **Native wardrobe compatibility patch**, and restart this World. Reopen the native wardrobe page. Configured figures show outfit/part rows; Coo and unconfigured figures retain their controls.
 
-The extension stores profiles and appearance recovery records only under its own `wardrobe-studio/` directory. Applying an outfit changes the selected figure/scheme through the desktop pet's appearance API. Other preferences are preserved. Application code, original figure files and other extensions are not edited.
+This mode is off by default. Read the [compatibility and rollback guide](docs/native-integration.md) before enabling it.
 
-Normal stop restores the appearance still owned by this extension. Forced termination, an unavailable desktop service or removal of the old figure can require recovery on the next activation; unconditional restoration cannot be promised in those cases. All selected schemes are existing valid schemes, so the original figure does not depend on this extension after removal.
+### 5 · Disable or uninstall
 
-This initial release is experimental: World API 6, figure manifest/API 2, Node.js ≥22, no runtime npm dependencies. Configuration changes, applying appearances, disable restoration and reactivation were checked in a real Core host. The separate panel does not change native fixed-axis layout. See the [verification scope](docs/verification.md) and [publishing guide](docs/publishing.md).
+For changes made in the separate panel, use **Restore previous appearance** first. Disable the World and verify any native patch was restored before uninstalling. Native-page selections are ordinary host selections and remain valid after removal.
 
-## Develop
+[Lifecycle and recovery →](docs/lifecycle.md)
+
+## Create your own character
+
+The guide panel, agent tool and downloadable manuals share the same source documents.
+
+| Stage | Deliverable and acceptance |
+| :--- | :--- |
+| ① Plan | Identity, wardrobe/action matrix and reversible environment record |
+| ② Reference | Fully dressed reference for each supported combination |
+| ③ Continuous video | Dressed reference plus motion guidance; validate one short action first |
+| ④ Raw-video review | Complete normal-speed, half-speed and loop playback |
+| ⑤ Temporal matting | Correct masks, propagate over time and review on contrasting backgrounds |
+| ⑥ Figure package | Coordinates, movement, transitions and actual expression coverage |
+| ⑦ Wardrobe profile | Map installed complete schemes, validate and import |
+
+[Read the detailed workflow →](docs/agent-workflow.md)
+
+## Documentation
+
+| Document | What it covers |
+| :--- | :--- |
+| [Authoring workflow](docs/agent-workflow.md) | Inputs, outputs, prompts, video/alpha requirements and figure interface |
+| [Profile format](docs/profile-format.md) | Required fields, limits, full example and missing combinations |
+| [Native integration](docs/native-integration.md) | Opt-in setup, exact compatibility, file changes and recovery |
+| [Troubleshooting](docs/troubleshooting.md) | Stale resource URLs, connections and runtime resources |
+| [Verification](docs/verification.md) | Checks performed and compatibility boundaries |
+| [Changelog](CHANGELOG.md) | Version history |
+
+## Data and compatibility
+
+- Profiles, language and recovery records stay in this extension's local namespace. No conversation reading or internet requests.
+- Figure manifests and animation assets are never modified. The optional native adapter temporarily changes only its documented page files.
+- Native integration requires the exact reviewed desktop-pet page. Host updates can disable it; the independent panel remains available.
+- World API 6, figure manifest/API 2, Node.js ≥22; no runtime npm dependencies or model downloads.
+- Guidance provides instructions, not automatic media generation or missing animation resources.
+
+<details>
+<summary><strong>Development and agent tools</strong></summary>
 
 ```sh
-npm test
 npm run check
+npm test
 npm run preview
 ```
 
-The preview uses an isolated temporary deployment and fictional data. The package contains source, guidance and fictional examples, without private character media or generation models.
+The preview uses isolated temporary data and fictional artwork. Tests exercise recovery and origin restrictions against disposable fixtures.
+
+| Tool | Purpose |
+| :--- | :--- |
+| `wardrobe_list` | Inspect local profiles and current appearance |
+| `wardrobe_choose` | Apply an existing valid combination |
+| `wardrobe_restore` | Restore a separately leased appearance |
+| `wardrobe_authoring_guide` | Read workflow, format and troubleshooting guidance |
+
+Public examples are entirely fictional. Keep personal figures, profiles and production records outside this repository.
+
+</details>
+
+---
+
+<div align="center">
+
+[MIT License](LICENSE) · Independent extension · Not an official Coopanion / Pal AI Lab component
 
-MIT License. Independent third-party extension; not an official Coopanion or Pal AI Lab component.
+</div>

package/README_zh.md

@@ -1,35 +1,121 @@
-# 装扮工作室 · World 扩展
+<div align="center">
 
-在独立衣橱面板中，先选择服装，再显示这套服装自己的搭配选项。通过本地配置把选项组合映射到形象包已有的完整装扮，不修改 Coopanion 原生装扮页或角色文件。
+<img src="assets/icon.svg" width="72" height="72" alt="装扮工作室">
 
-![完全虚构的衣橱示例](assets/wardrobe.png)
+# 装扮工作室
 
-例如，虚构角色“苔星狐”的森林探险装有斗篷、足部装备；雨林装有雨帽、雨披颜色；观星装有护目镜。切换服装后，配置项随之改变。没有资源的组合不能应用。界面跟随宿主配色，采用点阵预览区、紧凑服装卡片和横排选项；本机预览读取形象包缩略图，公开示例只使用虚构角色。
+**先选服装，再选搭配。**
 
-## 使用
+为 Coopanion 整理角色衣橱，提供从参考图到连续动画的制作指南。
 
-1. 在 World 扩展的手动安装中选择本包目录；按宿主提示重启进程，再启用“装扮工作室”。首次接入请先用隔离数据验证。
-2. 保持桌宠 World 可用。默认地址为 `http://127.0.0.1:7797`；端口不同可在扩展配置中修改，之后重启此 World。
-3. 打开扩展的“衣橱”面板，导入属于本机角色的 JSON 分组配置，选择服装和搭配，点击“应用装扮”。[配置格式](docs/profile-format.md)包含完整虚构示例。
-4. 卸载前点击“恢复原外观”，确认成功后停用并卸载扩展。正常停用也会尝试恢复；在原生页另做的选择会被保留。[生命周期和异常恢复](docs/lifecycle.md)说明边界。
+[![npm](https://img.shields.io/npm/v/cortico-world-wardrobe-studio?color=c87c5d&label=npm)](https://www.npmjs.com/package/cortico-world-wardrobe-studio)
+[![Checks](https://github.com/FelixHenrikChristian/cortico-world-wardrobe-studio/actions/workflows/check.yml/badge.svg)](https://github.com/FelixHenrikChristian/cortico-world-wardrobe-studio/actions/workflows/check.yml)
+[![MIT](https://img.shields.io/badge/license-MIT-6b9f87)](LICENSE)
 
-本扩展不会把已有图片拼成未制作的服装，也不会自动补齐动作。先为每个有效搭配制作并验收完整资源，再配置其映射。Coo 自带配件使用独立契约，继续由原生页管理。
+**简体中文** · [English](README.md)
 
-## 角色制作指导
+[开始使用](#开始使用) · [制作自己的角色](docs/agent-workflow.zh.md) · [JSON 格式](docs/profile-format.zh.md) · [下载版本](https://github.com/FelixHenrikChristian/cortico-world-wardrobe-studio/releases)
 
-“角色制作指导”面板和 agent 工具提供分阶段工作流：角色与完整穿衣参考定稿、连续动作视频、原速／半速及循环验收、本地连续抠像、姿态与表情支持范围、运行时接入和版本发布。[完整指南](docs/agent-workflow.md)只包含可复用的制作流程，没有个人角色或历史素材。
+</div>
 
-工具：`wardrobe_list`、`wardrobe_choose`、`wardrobe_restore`、`wardrobe_authoring_guide`。指导工具只返回说明，不安装工具、下载模型、执行生成任务或读取聊天记录。
+---
 
-## 数据与兼容
+## 一套服装，一组自己的选项
+
+同一角色的不同服装不必共用所有配置项。装扮工作室把角色包已有的完整外观重新分组，只显示当前服装支持的搭配。
+
+| 你要做的事 | 扩展提供什么 |
+| :--- | :--- |
+| 整理衣橱 | 按服装显示独立选项，禁用没有完整资源的组合 |
+| 切换搭配 | 使用桌宠标准外观接口，读取本机角色缩略图 |
+| 制作角色 | 参考图提示词、连续视频、播放验收、连续抠像、形象包接入指南 |
+| 编写配置 | 完整字段表、虚构示例、JSON Schema、本机 ID 查询和只读校验 |
+| 切换语言 | 默认中文，可选 English，记住选择并保留编辑草稿 |
+
+> [!IMPORTANT]
+> **0.4 新增可选的原生装扮页兼容补丁，默认关闭。** 这不是官方 World 插槽，会临时修改经过校验的原生页面，正常停用时恢复。不兼容版本会拒绝修改。[支持版本、设置和回滚说明 →](docs/native-integration.zh.md)
+
+<details>
+<summary><strong>查看独立衣橱预览 · 完全虚构角色</strong></summary>
+<br>
+<div align="center"><img src="assets/wardrobe.png" width="500" alt="虚构苔星狐的独立衣橱面板"></div>
+
+示例“苔星狐”的探险装有斗篷和足部装备，雨林装有雨帽与雨披颜色，观星装只有护目镜。公开素材仅包含虚构示例。
+
+</details>
+
+## 开始使用
+
+### 1 · 安装并启用
+
+在 Coopanion 的 **World 扩展市场**搜索 `装扮工作室` 或 `cortico-world-wardrobe-studio`，安装后按宿主提示重启 Core，再启用扩展。
+
+也可从 [GitHub Releases](https://github.com/FelixHenrikChristian/cortico-world-wardrobe-studio/releases) 下载归档，解压后在手动安装中选择含 `package.json` 的目录。
+
+### 2 · 准备已有的角色资源
+
+保持桌宠 World 运行，并先安装、验收自己的形象包。默认本机服务地址为 `http://127.0.0.1:7797`；端口不同可在扩展配置中修改，之后重启此 World。
+
+**衣橱 JSON 负责分组，不包含图片或视频。** 每个有效搭配需要先有能实际播放的角色资源。
+
+### 3 · 校验并导入衣橱
+
+打开 **装扮工作室 → 衣橱 → 导入衣橱配置**：
+
+1. 查看本机装扮 ID，下载虚构示例或 JSON Schema。
+2. 按自己的角色填写 `figure`、服装选项和已有 `scheme`。
+3. 点击 **校验配置**，修复结构或 ID 报错后再导入。
+4. 选择服装与搭配，点击 **应用装扮**。
+
+[完整 JSON 字段与可复制示例 →](docs/profile-format.zh.md)
 
-扩展只在自己的 `wardrobe-studio/` 目录保存本机衣橱和外观恢复记录。选择已有搭配通过桌宠标准外观接口生效，其他偏好保持原值。形象包、主程序、其他扩展和素材不被改写。
+### 4 · 可选：在原生装扮页选择
 
-正常停用时会恢复仍由本扩展接管的外观。强制结束进程、桌宠服务提前停止或旧形象被删除时，恢复可能需要下次启用后执行；不能承诺这些情形下无条件自动恢复。扩展通过现有有效装扮切换，卸载不会让原形象依赖缺失的扩展代码。
+导入配置后，在扩展配置填写已安装 desktop-pet 包的 `web` 绝对目录，开启「原生装扮页兼容补丁」，重启此 World 并重新打开原生装扮页。配置过的角色显示「服装 → 当前服装的部件」；其他角色与 Coo 保持原控件。启用前请阅读[兼容与回滚说明](docs/native-integration.zh.md)。
 
-当前为实验性首版：World API 6、形象包 manifest/API 2、Node.js ≥22，零运行时 npm 依赖。已在真实 Core 宿主中验收配置切换、应用外观、停用恢复和重新启用。独立面板不改变原生装扮页的固定配置轴。[验证范围](docs/verification.md)与[发布方式](docs/publishing.md)说明当前边界和市场流程。
+### 5 · 停用或卸载
 
-## 开发预览
+独立面板应用的外观先点 **恢复原外观**并确认成功，再停用 World，确认原生页兼容补丁已恢复后卸载。正常停用也会尝试恢复仍由扩展接管的外观；原生页选择按普通宿主装扮保存，停用后保留。
+
+[生命周期、异常恢复与边界 →](docs/lifecycle.md)
+
+## 制作自己的角色
+
+手册与扩展内“角色制作指导”使用同一份内容，可以下载完整 Markdown 版。
+
+| 阶段 | 交付与检查 |
+| :--- | :--- |
+| ① 规划 | 角色设定、服装／动作清单、环境与回退记录 |
+| ② 参考图 | 每个有效搭配的完整穿衣图、统一轮廓与画风 |
+| ③ 连续视频 | 完整穿衣参考 + 动作驱动，先验证一个短动作 |
+| ④ 原片验收 | 完整原速、半速及循环接缝检查 |
+| ⑤ 连续抠像 | 首帧纠正、时序传播、多背景透明度播放检查 |
+| ⑥ 形象包 | 坐标、移动、动作衔接及真实表情覆盖验收 |
+| ⑦ 衣橱配置 | 映射已安装搭配，校验后导入 |
+
+[阅读详细制作指南 →](docs/agent-workflow.zh.md)
+
+## 文档导航
+
+| 文档 | 内容 |
+| :--- | :--- |
+| [从零制作](docs/agent-workflow.zh.md) | 输入输出、提示词、视频与透明素材要求、形象接口骨架 |
+| [衣橱 JSON](docs/profile-format.zh.md) | 必填字段、ID 规则、完整示例、缺失组合和常见报错 |
+| [故障排查](docs/troubleshooting.zh.md) | 旧资源地址、连接与预览、配置通过但动画缺失 |
+| [原生页兼容](docs/native-integration.zh.md) | 实验集成、精确版本限制、文件变更与卸载恢复 |
+| [验证范围](docs/verification.md) | 实际检查过什么、兼容性边界 |
+| [更新记录](CHANGELOG.md) | 已发布版本变更 |
+
+## 数据与兼容
+
+- **本机存储**：配置、语言偏好和外观恢复记录保存在扩展自己的目录。
+- **资源保护**：角色 manifest 与动画素材始终不改写；原生页兼容选项开启后临时修改其文档列出的页面文件。
+- **恢复边界**：强制结束进程、服务不可用或旧角色被删除时，可能需要下次启用后恢复；卸载前应确认结果。
+- **运行要求**：World API 6、形象包 manifest/API 2、Node.js ≥22，零运行时 npm 依赖。
+- **能力范围**：指导工具提供步骤，不自动安装模型、生成素材或补齐未制作的动作。Coo 自带配件继续使用原生页。
+
+<details>
+<summary><strong>开发与 agent 工具</strong></summary>
 
 ```sh
 npm test
@@ -37,6 +123,23 @@ npm run check
 npm run preview
 ```
 
-预览使用独立临时数据和虚构角色，不连接已有 Coopanion。正式包没有图片、视频模型或私有角色素材，只有虚构示例和工具代码。
+开发预览使用独立临时数据与虚构角色。原生集成原型是另一个隔离服务，启动方式见其文档。
+
+| 工具 | 作用 |
+| :--- | :--- |
+| `wardrobe_list` | 读取本地衣橱和当前外观 |
+| `wardrobe_choose` | 切换已有合法搭配 |
+| `wardrobe_restore` | 恢复扩展接管前外观 |
+| `wardrobe_authoring_guide` | 读取制作流程、格式与排查说明 |
+
+公共源码只使用完全虚构的示例。个人角色、衣橱配置和生产记录应放在仓库之外。
+
+</details>
+
+---
+
+<div align="center">
+
+[MIT License](LICENSE) · 第三方独立扩展 · 非 Coopanion / Pal AI Lab 官方组件
 
-MIT License。第三方独立扩展，不代表 Coopanion 或 Pal AI Lab 官方。
+</div>

package/describe.json

@@ -69,7 +69,7 @@
     },
     {
       "name": "wardrobe_authoring_guide",
-      "description": "Read the staged character and outfit authoring workflow. This returns guidance and acceptance criteria; it does not run generation, download models, read conversations or upload assets.",
+      "description": "Read detailed character/outfit production steps, prompts, media acceptance requirements, wardrobe JSON fields/examples and troubleshooting. This returns guidance only; it does not generate assets, download models, read conversations or upload files.",
       "tags": [
         "read"
       ],
@@ -86,15 +86,17 @@
               "review",
               "matte",
               "runtime",
-              "release"
+              "release",
+              "profile",
+              "troubleshooting"
             ]
           }
         },
         "additionalProperties": false
       },
       "summary": {
-        "zh": "读取从角色定稿到连续动画验收的制作指导。",
-        "en": "Read staged guidance for character references and reviewed continuous animation."
+        "zh": "读取详细制作步骤、衣橱 JSON 格式及故障排查。",
+        "en": "Read production steps, wardrobe JSON format and troubleshooting."
       }
     }
   ],