feat(dam): 更新 MUSE 模型网关与公开演示隔离

README.md

@@ -5,8 +5,9 @@
 ## 从这里开始
 
 - [场景分类](docs/domains.md)：CRM、ERP、MES、DAM 等 16 个业务领域。
-- [案例目录](catalog/cases.json)：机器可读索引，目前包含一个案例。
+- [案例目录](catalog/cases.json)：机器可读索引，目前包含两个案例。
 - [本色 Persona Studio · 企业数字人工作台](examples/dam/character-material-library/README.md)：首个 DAM 案例，含六页工作台、业务规格、合成数据与制作审核闭环。
+- [MUSE 缪思 · 品牌数字人技术验证工作台](examples/dam/brand-digital-human-studio/README.md)：四页工作台、图片上传、候选确认、可播放示意样片及可配置的阿里云万相、声音复刻/TTS/对口型与Higgsfield本机适配代码。
 - [案例规范](docs/case-standard.md)：目录、元信息、交付状态与验收要求。
 - [新增案例](CONTRIBUTING.md)：从模板开始，提交前执行检查。
 
@@ -16,7 +17,7 @@ npm run check
 npm run demo
 ```
 
-打开 <http://127.0.0.1:4173>。目录入口可按领域筛选；首个案例可管理人物与素材、解析需求、模拟视频任务、人工审核和归档溯源。`npm run demo` 先构建工作台再提供统一目录服务，全部使用合成数据，不连接外部 SaaS 或生成模型。
+打开 <http://127.0.0.1:4173>。目录入口可按领域筛选；首个案例可管理人物与素材、解析需求、模拟视频任务、人工审核和归档溯源。`npm run demo` 先构建工作台再提供统一目录服务，目录入口全部使用合成数据，不连接外部 SaaS 或生成模型。MUSE 的真实接口验证需按其案例说明单独启动工作台及本机代理，默认关闭付费调用。
 
 需要 Node.js 22.12 或更新版本。Windows 若使用 `\\wsl.localhost\...` 工作目录，请在 WSL 中执行 npm 命令；Windows npm 的默认脚本 shell 不支持 UNC 工作目录。
 

catalog/cases.json

@@ -14,6 +14,22 @@
       ],
       "status": "prototype",
       "path": "examples/dam/character-material-library"
+    },
+    {
+      "id": "brand-digital-human-studio",
+      "title": "MUSE 缪思 · 品牌数字人技术验证工作台",
+      "summary": "用虚构素材演示资产、视频、任务与审核复用，提供阿里云万相、声线复刻/TTS/对口型及Higgsfield等本机适配代码，真实效果待验证。",
+      "domain": "dam",
+      "tags": [
+        "marketing",
+        "digital-human",
+        "video-generation",
+        "higgsfield",
+        "aliyun",
+        "voice-cloning"
+      ],
+      "status": "prototype",
+      "path": "examples/dam/brand-digital-human-studio"
     }
   ]
 }

examples/dam/brand-digital-human-studio/README.md

@@ -0,0 +1,101 @@
+# MUSE 缪思 品牌数字人技术验证工作台
+
+面向品牌内容创作者，演示账号登录、图片/录音资产、候选确认、脚本、任务与成品复用。当前为 **prototype**：免费模拟可运行；有阿里云万相、声音复刻/TTS/图片对口型、Higgsfield、Seedance独立视频、Qwen及小云雀适配代码。公开仓库仅收录软件和模拟响应验证，不收录真实客户素材、成片或任务回执；客户质量尚未验收，不能称为 integrated。默认人物、商品和媒体全部虚构；6秒内置样片没有AI表演或克隆声音。演示登录的桌面/手机检查及仓库5项浏览器回归通过，证据范围见验证记录。
+
+## 从干净检出启动
+
+Node.js 22.12+，仓库根目录执行：
+
+```sh
+npm ci
+npm run check
+npm run demo
+```
+
+打开 http://127.0.0.1:4173 ，选择MUSE。目录入口只运行免费模拟，不请求任何本机API。图片与样片来自自身构建目录，浏览器存储键为 `bytefolk-brand-digital-human-studio-v1`，与Persona隔离。
+
+## 演示账号登录
+
+进入MUSE后，用下列虚构公共账号登录；账号只展示身份与登录流程，不连接企业账号系统。
+
+| 身份                | 账号                | 密码        |
+| ------------------- | ------------------- | ----------- |
+| 林知夏 · 品牌管理员 | `admin@muse.demo`   | `Muse2026!` |
+| 苏遥 · 创作成员     | `creator@muse.demo` | `Muse2026!` |
+
+默认当前标签页登录态保存在sessionStorage，最长8小时，刷新保持；勾选「在此浏览器记住我 7 天」改用localStorage保存，最长7天，到期重新登录。登录记录命名空间为 `bytefolk-muse-demo-auth-v1`，不保存输入密码。
+
+两种身份共用同一浏览器工作空间，没有正式后端鉴权、企业权限或RBAC，也没有以此保护API。退出仅清演示登录态，不清资产/草稿/成品、不清供应商配置或Key、不中止云任务。工作台登录与供应商授权相互独立，不取得生成额度。退出后可换另一个演示身份登录。
+
+2026-10-14以Playwright检查正确/错误凭据、示例不自动登录、密码显示、Enter、身份/深链、刷新草稿、8小时/7天无密码记录、退出工作空间保留、模拟到期及存储写入拒绝。桌面1440×1000和手机390×844通过，无控制台/页面错误；本机登录前0 API、全程无非GET API请求。退出不调用供应商配置清除/云任务取消接口；未以客户真实Key验收配置恢复，也未进行真实生成。[实际证据及限制](evidence/verification.md)
+
+## 免费演示
+
+1. 资产库搜索、筛选、收藏或上传PNG/JPEG/WebP，最大2MB。
+2. 输入虚构人名、商品编号和场景，查看候选理由，手动确认应用。
+3. 编辑规则分镜、提交模拟任务，约22秒后进入成品。
+4. 播放6秒示意样片，审核、下载、导出JSON和复用配置。
+
+重置工作台记录与退出登录是不同操作：重置仅清工作台浏览器记录，不取消云任务或删除云人物/声线；退出只清演示登录。已有演示登录，正式企业登录、后端鉴权、权限隔离、共享、队列与长期云存储未建设。原Persona案例保留，见[两套工作台对比](comparison.md)。
+
+### Seedance 视频：独立页面配置与手动生成
+
+在「视频创作」选择「Seedance 视频」，点「配置 Seedance」，填写「接口地址（Base URL）」与所接入服务的 API Key，点击「保存配置」，再选择文生视频或单图参考模式。页面显示 Seedance，不把聚合接入平台名称作为创作渠道标题；技术资料保留真实接口来源，便于维护和核对账号。
+
+第一期只开放 `doubao-seedance-2-0-fast-260128`，固定 5 秒、720P。这是当前公开示例能确认的配置范围，不是断言模型本身只支持这些规格。合成后的提示词收窄至1500字符，这是Demo校验范围，不是宣称平台官方上限。文生模式只发文字；单图模式默认用人物资产的单张图片，也可指定云端可读取的 HTTPS 图片链接。人物图片可编码为 Data URL，Base64 在实际账号和渠道下是否被接受仍需联调。独立帽子、场景图片与人物声线仅保留创作档案，本入口不同时上传三张图、不发送克隆声线或音频。
+
+仅用户点击「提交 Seedance 真实生成」才创建收费任务；保存、刷新、清除配置不调用云模型、不核验余额。按生成时长计费，当前不编造统一单价或免费额度，账号权限和价格需在服务控制台核对。不自动换模型或重发收费提交。下载失败只重新取回原任务成片，不再生成。
+
+独立 Key 不与万相/声音配置混用：密码输入，保存后不回显，不写 localStorage，不进入创作 JSON 导出；后端按浏览器匿名会话保存在忽略的 `workbench/.local/higgsfield-demo/seedance/settings.json`（本机明文文件，不是生产加密凭据库）。配置包含 `baseUrl` 与Key。可选环境变量 `SEEDANCE_BASE_URL`、`SEEDANCE_API_KEY`、`SEEDANCE_ENABLE_REAL=false`，需显式开启真实环境配置；页面保存可独立启用当前会话，清除只影响此渠道，不撤销平台 Key，也不清阿里云声线配置。目录演示入口仍不调用 API。
+
+本机接口：`GET/POST /api/seedance/config`、`POST /api/seedance/config/clear`、`POST /api/seedance/videos`、`GET /api/seedance/requests/:id`、同任务 `/media` 与 `/download`。服务端默认Base URL为 `https://ai.amaxsmp.com/v1`，按保存的Base URL拼接 `/video/generations` 提交、`/video/generations/{task_id}` 查询、`/videos/{task_id}/content` 下载。Bearer仅送给所配置服务的接口，不转发给外部视频结果地址。
+
+Base URL默认 `https://ai.amaxsmp.com/v1`，可在同一配置面板填写使用相同视频接口协议的服务地址；不能仅改网址就调用另一种协议。填根网址时自动补 `/v1`，已含 `/v1` 或反向代理前缀 `.../v1` 时不重复。地址须为HTTPS，不含用户名密码、查询参数或片段；HTTP仅允许localhost、127.0.0.1、[::1]本机开发。不要填写完整生成端点，`.../video/generations` 会被拒绝。保存网址和Key仍只写本机，不验证云端或生成。
+
+新任务快照保存提交时的Base URL；更改网址或Key后，查询未归档的旧任务需恢复原配置，不能把原任务ID发到新服务。已下载的本机视频播放和下载不依赖当前云端配置，清除配置不会删除已归档文件。这里是聚合服务接入，不应称作字节官方直连或自研模型。
+
+兼容任务响应的顶层 ID、`top_task_id` 或包装任务对象，归一平台状态；本机提交中的 `submitting` 或结果不明的 `submission_unknown` 不视作成功，任务详情保留平台任务ID供核对。只有云端成功且 MP4 下载本机后才进入成品库。公开文档提示下载网关的二进制转发尚未完成验证，需验证实际文件，并支持从任务的可访问结果地址取回。结果与任务记录保存在 `workbench/.local/higgsfield-demo/seedance/`，需自行备份。接口存在和模拟响应测试不代表真实账号成功。
+
+尚未接入：取消、任意模型目录、多图/参考视频、音频驱动与品牌声线克隆、固定身份训练或模型权重导出。原生模型是否产声不等于指定品牌声线；继续使用独立阿里云声音入口。人物一致性、全身动作和帽子准确性依然需客户素材实测，新增渠道不改变 B 类交付边界。
+
+官方资料（2026-10-14）：[视频生成](https://ai.amaxsmp.com/docs/zh/02-api/video-generation/)、[任务查询](https://ai.amaxsmp.com/docs/zh/02-api/video-task/)、[视频下载](https://ai.amaxsmp.com/docs/zh/02-api/video-download/)。真实上传、付费生成和客户质量未验收。
+
+2026-10-14 网址配置前的历史软件验证：本地 `npm test` 共48项通过（Seedance新增12项），生产构建通过。Browser插件未提供，使用Playwright与真实本机Express代理、临时状态及模拟上游，在1440×1000和390×844验证：Key保存/刷新/清除不触发上游、不修改阿里云配置，不进浏览器存储或导出；页面显示Seedance、默认Fast/5秒/720P，文图切换、HTTPS/非法链接、首帧与刷新；手动提交、状态查询、本机MP4播放/下载、审核/导出/复用。故障fixture首次返回JSON导致预期502，15秒后重新取回原视频；上游生成POST仍只有1次，下载字节与内置fixture一致。预期502以外无控制台/页面错误，无溢出或错误覆盖层。全部仅为软件及模拟合同验证，真实平台生成/素材上传/付费调用为0，Data URL、账号权限、计费和客户画面质量仍待用户验证。
+
+## 独立运行接口验证
+
+仓库根目录执行 `npm run dev --workspace muse-digital-studio`，工作台 http://127.0.0.1:4318 ，本机代理8788。当前主测试路线为阿里云，默认关闭收费调用；目录4173永远只模拟。
+
+在4318选择「阿里云万相真实 API」或「声音复刻与对口型」，点击「配置阿里云」，输入北京地域百炼通用API Key及可选业务空间ID。Key保存于忽略的本机后端文件，不回显、不进浏览器持久存储或配置导出；没有生产凭据加密。保存、刷新、上传录音不发起生成。每个云生成步骤由用户点击，分别计费，不自动充值或连做。
+
+万相模型可在页面选择，时长、分辨率、声音、镜头与价格估算同步变化，后端严格提交所选模型：
+
+| 模型             | 时长/分辨率              | 声音与镜头               |
+| ---------------- | ------------------------ | ------------------------ |
+| wan2.6-i2v-flash | 2–15秒，720P/1080P       | 有声/无声可选，单/多镜头 |
+| wan2.6-i2v       | 2–15秒，720P/1080P       | 固定原生有声，单/多镜头  |
+| wan2.2-i2v-flash | 固定5秒，480P/720P/1080P | 无声、无多镜头参数       |
+
+默认2.6Flash、5秒无声。三款均只提交一张首帧和文字，独立人物/商品/场景三图不会同时提交。2.6合计提示词限1500字符，2.2限800字符；原生有声不等于品牌克隆声线。结果下载本机后进入任务与成品，支持播放、下载、审核和复用；模型权限、费用和效果仍需账号验证。
+
+声音入口：上传10–20秒、≤10MB的WAV/MP3（≥16kHz，WAV16bit，无音乐和其他人声）→用户点击复刻并在平台OK后绑定人物→输入1–240字新台词，点击TTS、试听下载→点击对口型。使用 `voice-enrollment`、`qwen-audio-3.0-tts-flash`、`wan2.2-s2v`。对口型只提交人物图与新音频，小于20秒、480P/720P；不接独立帽子/场景/分镜/全身动作参数。修改人物、台词或声线后，旧语音不能用于不匹配视频。下载失败可取回原语音，不重复TTS。
+
+Higgsfield可选：将 `workbench/.env.example` 复制为 `.env`，填写 `HF_API_KEY` 和 `HF_ENABLE_REAL=true`，重启独立服务。Soul ID v2→completed→Soul 2参考图→视频图片参考；不是把Soul ID传给任意模型。视频支持Seedance 2.0和Kling O3参考模式，分镜编译为一条短片提示词；不做逐镜生成/长片合成或任意成片声轨替换。
+
+Qwen可选：`DASHSCOPE_API_KEY`、`QWEN_BASE_URL`、`QWEN_MODEL`，按Token计费，未配置时免费规则检索。小云雀可选：工作台目录运行 `npm run xyq:install` 和 `npm run xyq:login`，官方CLI1.0.38；需账号调用权限和积分，`XYQ_ENABLE_REAL=true` 才调用，主路线不依赖小云雀会员。
+
+配置、状态、原录音、新语音及万相/小云雀MP4在 `workbench/.local/higgsfield-demo/`；Higgsfield仍播放平台链接，均需自行备份，不是企业永久归档。账号权限、余额、真人声线、口型、全身表演、帽子细节及一致性均待真实样片验证。云人物/声线ID不是可导出的模型权重。详见[接入说明](integrations.md)、[验收](acceptance.md)和[验证记录](evidence/verification.md)。
+
+## Seedance 网址配置版最终软件结果
+
+2026-10-14 网址配置版最终软件验证：本地全套53/53项通过，其中Seedance17项（初始12项＋网址配置5项）；仓库MUSE接口54/54项通过。仓库npm ci成功、依赖不变，最终完整npm run check通过：格式、两套构建、16领域/2案例、7项根检查、54项MUSE、17项Persona、8项离线POC。MUSE最终6项完整浏览器回归通过，新增目录检查包含自定义Base URL被本地目录保护阻断、零API和零Key存储。
+
+网址配置版隔离真实本机代理以1440×1000、390×844验证：默认/v1，自填 `https://video-fixture.example/v1/` 保存后规范化并重新打开回读；提交、查询、content均走自填Base URL。更改网址与假Key后查询旧任务返回预期409且不发外部请求，恢复原URL与Key后取回原成片；本机播放、原生下载字节等fixture、审核、导出无Key及复用通过。模拟上游生成POST仅1次、本机查询5次、结果地址回退2次。故障fixture的502一次、409一次均为预期，无意外console/pageerror；桌面/手机配置弹窗截图已视觉检查，无横向溢出。根5173/8787及仓库4318/8788重启后fresh匿名会话为configured=false、默认Base URL、credentialVerified=false，不触发云调用。
+
+这些是本机软件、假凭据和模拟上游证据，真实平台素材上传/生成/付费调用均为0；真实Key、账号权限、Base64/Data URL、公共网关和客户效果未验收。状态仍prototype、外部适配unavailable，不标connected。
+
+## 最新代码同步范围
+
+当前代码包含万相官方/兼容网关协议、自定义Base URL和模型别名、原任务结果恢复、真实结果视频帧封面、长报错摘要/详情以及全身表演提示词预设。目录入口只显示模拟模式，不提供Key输入或真实提交；独立4318入口保留页面模型配置和用户手动提交。全身预设是测试脚本，不证明效果达标。
+
+只同步代码和抽象技术说明，保留已有合成图片与固定示意MP4；没有复制客户资料、录音、真实生成视频、签名URL、报价或本机状态。使用者自己的运行数据写入忽略的`workbench/.local/`。