dsh-director 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md ADDED
@@ -0,0 +1,501 @@
1
+ # CHANGELOG
2
+
3
+ ## 1.0.0(2026-11-19,包名迁移为 dsh-director,DSH导演 1.0)
4
+
5
+ * **npm 包名改为 `dsh-director`**:与显示名 **DSH导演 / DSH Director** 同义,npm 与 DSH 市场
6
+ 搜索 `dsh director` 直接命中;旧包 `@zipx/dsh-plugin` 停在 0.3.0,不再更新。
7
+ * 插件 bundle id、`cordis.patch.yml` 层名、右侧栏 slot key(`dsh-director/workbench` 等)
8
+ 同步改名;市场索引 `name` 与安装源保持一致。
9
+ * 版本从 0.6.x 直接到 **1.0.0**:新包名是一次身份迁移,功能面与 0.6.0 相同(43 个工具)。
10
+ * 别名包 `dsh-zipx` 升到 1.0.0,依赖 `dsh-director@1.0.0`。
11
+ * `npm run check` / `npm run market:check` 全绿。
12
+
13
+ ## 0.6.0(2026-11-19,统一命名 DSH导演 / DSH Director,发布 DSH 插件市场索引)
14
+
15
+ * 显示名统一为 **DSH导演**(zh)/ **DSH Director**(en):插件管理器、Discover 卡片、
16
+ 侧栏入口、README、详情页、别名包全部读同一份 `locale/*.json` 的 `meta.title`。
17
+ * 介绍改为**交付结果导向**:精品影视、多集短剧、创意视频、带货商品视频;关键词加入
18
+ `dsh导演`、`dsh-director`、`精品影视`、`多集短剧`、`创意视频`、`带货视频`、
19
+ `短剧`、`小说转视频`、`剧本转视频`、`分镜`、`成片` 等,DSH 市场搜索按
20
+ name/title/keywords/description 打分,四类交付词都能命中。
21
+ * `market/index.json` 改为由 package.json + locale meta 生成;新增四个筛选项
22
+ (精品影视 / 多集短剧 / 创意视频 / 带货视频),安装源固定到精确 commit。
23
+ * 新增 `docs/DETAIL.en.md`;`meta.detail` 让插件详情页直接展示交付类型,而不是只靠 README。
24
+ * 工具数不变(43);locale 408 键 zh=en;`npm run check` 与 `npm run market:check` 全绿。
25
+
26
+ ## 0.5.4(2026-11-17,旧门禁未确认可见 + P1 故事账本)
27
+
28
+ * DSH 状态卡新增 `gate_unverified`:旧资产的门禁没有 `content_fingerprint` 时显示
29
+ 「旧门禁没有内容指纹(未确认)」,不再让用户把历史判决当成这一版的结论;仍可用
30
+ `zipx_run_gate` 重判。不是 fail,也不冒充 current。
31
+ * 对应后端 P1:场景账本(`agentic/story_ledger.py`)注入整步/单章写作提示词;
32
+ plot_analysis / script 单章覆盖前落文件快照;`STORY_REPETITION_REVIEW` 可关语义判官。
33
+ * 工具数不变(43);locale 408 键 zh=en;check-host / check-panel 全绿。
34
+
35
+ ## 0.5.3(2026-11-17,商业面板对商业模板项目始终可见)
36
+
37
+ * 0.5.1 的商业/植入面板只在简报或产品图非空时出现:用 Studio 建的 brand_film
38
+ 项目如果没填品牌,DSH 里就没有入口补。现在详情读
39
+ `/zipx-meta/project/{id}/resolved`,模板带 `commercial` 时面板始终显示(空简报也能填)。
40
+
41
+ ## 0.5.2(2026-11-17,安全收口:DELETE 只对团队代理放行)
42
+
43
+ * 0.5.1 给代理加了 DELETE,但方法白名单是全局的:`/zipx-api` 也会跟着放行 DELETE。
44
+ 现在新增 `allowDelete` 选项(默认 false),只有 `/zipx-team` 打开;其余代理仍保持
45
+ GET/POST/PUT/PATCH。check-host 钉住:`/zipx-api` 的 DELETE 返回 405,`/zipx-team` 的
46
+ DELETE 透传。
47
+
48
+ ## 0.5.1(2026-11-17,收口四条边界:产品图 / 团队 / 知识媒体 / 流式上传)
49
+
50
+ 对应上一轮报告里的四条「仍在 Studio / 只放行 25MB」的边界。工具数不变(仍是 43),新增
51
+ 三条同源代理与两个详情面板;所有写操作在 Host 侧注入令牌,浏览器不持有凭证。
52
+
53
+ ### 产品图 + 商业/植入面板
54
+
55
+ * 详情新增「商业 / 植入简报」:品牌/产品/核心信息/卖点/CTA/必须避免可改(PATCH
56
+ `/campaign-brief`),产品图可传(multipart + 角度:参考/正面/细节/生活场景,≤15MB)。
57
+ * 新代理 `/zipx-verticals` → `/api/v3/verticals`(可写,20MB 上限)。
58
+ * 缩略图走 `/zipx-api/files/download?file_path=…`(后端公开媒体端点),不把字节搬进 DSH。
59
+
60
+ ### 团队协作(邀请 / 角色 / 移除)
61
+
62
+ * 详情「剧组」卡从只读改成可管理:成员列表、邀请(editor/viewer/admin)、改角色、
63
+ 移除成员、撤销待接受邀请。
64
+ * 新代理 `/zipx-team` → `/api/v2/team`;`DELETE` 只在这条代理上放行(移除成员/撤销邀请)。
65
+ * 套餐不含团队时后端 403,面板显示「当前套餐不含团队协作」,不当成"没有成员";
66
+ 席位购买与套餐开通仍在 Studio。
67
+
68
+ ### 知识库图片 / 音频 / 视频
69
+
70
+ * `/zipx-kb` 改为**流式代理**(560MB 硬上限,声明长度先挡、chunked 边读边数),
71
+ 视频不再把整包读进 Node 内存,也不再被旧 25MB 上限挡住。
72
+ * 知识 tab 按扩展名分流:文档 → `/knowledge/documents`;图片 → `/assets/upload`
73
+ (角色/道具/场景);音频 → `voice_sample`;视频 → `/knowledge/media/upload`(异步分析)。
74
+ * 媒体素材列表(最近 8 条)来自 `/assets`;后端的大小/类型/内容嗅探仍是唯一把关点。
75
+
76
+ ### 分集「开始」保持对话指令
77
+
78
+ * 这不是缺口:付费生成必须经批准卡。按钮只把一句带 episode_id 的话投进对话,
79
+ 由模型先预检再调 `zipx_start_episode`。
80
+
81
+ ### 门禁
82
+
83
+ * check-host:新增团队 GET/POST/PATCH/DELETE 透传(含 Host 令牌)、产品图 multipart
84
+ 边界与字节、26MB 视频流式上传三条回归。
85
+ * check-panel:新增知识媒体上传、团队/产品面板接线断言;locale 407 键 zh=en。
86
+ * 真机:OpenAPI 确认 7 条端点存在(含 team 的 DELETE 与 product-images 的 multipart)。
87
+
88
+ ## 0.5.0(2026-11-17,把"尚未做"补齐:导出包 / 知识上传与引用 / 复盘发布 / 多版本)
89
+
90
+ 对应审计报告 §4 的 4.2–4.6。后端新增 2 条端点 + 1 个模块,工具数不变(导出与复盘复用
91
+ HTTP,不新增模型可见工具)。
92
+
93
+ ### 导出包(4.3)
94
+
95
+ * 后端 `GET /api/v3/director/project/{id}/export?scope=all|final`:把项目里的真实媒体文件
96
+ 打成 zip,含 `manifest.json`(步骤/相对路径/字节数/被跳过的文件及原因)与
97
+ `发布清单.md`(文案 + 计划 + 文件表)。路径收集复用 `external._walk_media_paths`,
98
+ 归属校验复用 `resolve_media_file`;超限(>500 文件 / >2GiB)直接 413 并给数字。
99
+ * 字幕(.srt/.ass/.vtt)现在算**媒体路径**:以前只带走视频,字幕在面板与导出里都不可见。
100
+ * 资产库 tab 与复盘 tab 都有「导出成片包 / 导出全部」。
101
+
102
+ ### 知识库上传与项目级引用(4.2)
103
+
104
+ * `/zipx-kb` 代理放行 25MB multipart;知识 tab 新增「上传文档」(PDF/Word/Markdown/txt)。
105
+ * 新模块 `agentic/creator_kb_selection.py`:项目级白名单存 `V3ProjectPrefs.payload`,
106
+ 在**召回之后**过滤(空 = 不限制)。创建向导与项目设置都能勾选。
107
+ * `PATCH /project/{id}` 增加 `creator_kb_doc_ids`、`publish_plan`;项目详情返回两者。
108
+
109
+ ### 复盘 / 发布 / A/B(4.4–4.6)
110
+
111
+ * 新右栏 tab「复盘与发布」:发布物料(标题/一句话/标签,可复制)、发布计划
112
+ (时间/平台/备注,落库 + 导出 .ics 到自己的日历)、复盘(余额/本步预估/进度/修改次数/
113
+ 可导出文件数/被跳过的文件)、多版本 A/B(当前步骤的 variations,选定写回该步产物)。
114
+ * **诚实边界**:ZipX 不代发、不做平台账号绑定;这里给的是"可以自己发"的物料与导出包。
115
+
116
+ ### 其它
117
+
118
+ * 面板按钮投递失败会显示提示(不再静默)。
119
+ * 工具数 43(含并行加入的 `zipx_run_gate` / `zipx_update_story_outline`),卡片 43。
120
+
121
+ ## 0.4.2(2026-11-17,面板按钮真的能说话)
122
+
123
+ * 修一个静默失效:`inputActions` 只发给会话作用域 slot(header / composer dock / hero),
124
+ `main` 面板与右栏 tab 拿不到;而打开 main 面板时对话会被替换卸载。于是项目详情/工作台/
125
+ 资产库里的「预检并重试」「开始这一集」「推进」等按钮此前点了没反应。
126
+ * 现在:会话作用域组件把 `inputActions` 记进 RUNTIME;面板取不到时先切回对话,
127
+ 等输入框挂载后再投递(最多约 1.4 秒)。**面板仍然不直连付费后端**,只是把话送到对话。
128
+ * 回归:`npm run check`(host wiring / panel / 41 tools / 41 cards / 327 键)。
129
+
130
+ ## 0.4.1(2026-11-17,剧组只读卡)
131
+
132
+ * 项目详情新增「剧组」卡:读 `/zipx-collab/projects/{id}/members`(只读代理),
133
+ 人数 > 1 才显示;邀请与权限仍在 Studio。
134
+ * 0.4.0 的 41 个工具 / 6 个右栏 tab / 325+ locale 键不变。
135
+
136
+ ## 0.4.0(2026-11-17,P0-1~P1:从入口到成片)
137
+
138
+ 对应方案:`docs/ZipX_DSH_系统级融合方案_从入口到成片_20261117.md` §10。41 个工具(+3)。
139
+
140
+ ### P0-1 三模式创建(接 `/setup`)
141
+
142
+ * 面板创建面板换成**向导**:创意 / 小说 / 剧本 三模式,一段母本(textarea)+ 默认规格,
143
+ 一步创建。「填个示例」只填输入框,不替用户创作。
144
+ * 创建统一走 `POST /api/v3/director/setup`(唯一能带 `workflow_type` 的入口);
145
+ `zipx_create_project` 同步改走 /setup,新增 `mode`(idea/novel/script)与 `creator_mode`。
146
+ 修掉两个硬伤:面板不传 `initial_content`、工具走 `/projects` 拿不到 workflow_type。
147
+ * 模板/导演原型来自后端(`/zipx-meta/templates`、`/archetypes`);选中模板自动带出原型与画幅;
148
+ 商业模板多问三项(品牌/产品/核心信息)→ `campaign_brief`。
149
+
150
+ ### P0-2 项目整理
151
+
152
+ * 后端新增 `PATCH /api/v3/director/project/{id}`(改名 / 归档 / 恢复):
153
+ 归档沿用 `status='archived'`(原状态存 `assets._pre_archive_status`,恢复写回),
154
+ 不建列、不删除,且不再计入免费版项目配额(`check_project_limit` 只数进行中)。
155
+ * `GET /projects` 新增 `q`(标题+母本子串)与 `include_archived`;默认排除归档。
156
+ * 面板:搜索框、归档视图切换、项目详情里的改名/归档/恢复;新工具 `zipx_update_project`。
157
+
158
+ ### P0-3 分集
159
+
160
+ * 项目详情新增分集区(集号/步骤/场/镜/时长/状态);「进入这一集」把子项目绑到本会话,
161
+ 「开始这一集」只发对话指令(付费动作仍走批准卡)。
162
+
163
+ ### P0-4 资产库 / 版本 / 导出
164
+
165
+ * 右栏新增**资产库** tab:全项目图片/视频/音频、按类型筛选、逐项下载、复制 JSON 清单
166
+ (`download` + `/zipx-media`,拿到的是原始文件)。
167
+ * 版本链只读展示(`/zipx-os/repair/{id}`):面板不写第二套,采纳/退回仍走 `zipx_repair_action`。
168
+ * 交付 tab 加「下载成片」。
169
+
170
+ ### P0-5~P0-8 账号 / 计费 / 失败 / 导入
171
+
172
+ * 设置页:用量明细(`/zipx-account/history` → `/api/v1/credits/history`)、配对码连接
173
+ (`/zipx-pair/connect`,设备 id 本机持久化)、创作者知识库入口。
174
+ * 项目详情:失败块(lifecycle=failed)→「预检并重试」/「只看诊断」,两条都只发对话。
175
+ * 导入 = 创建向导的「小说 / 剧本」模式(`novel2video` / `script2video`,脚本直进剧本与分镜)。
176
+
177
+ ### P1 知识库 / 模板 / 协作 / 反向进入
178
+
179
+ * `/zipx-kb` → `/api/v3/creator/*`:知识库 tab(文档列表、启停、加链接、加创意文本、
180
+ 风格画像标签)。上传类仍在 Studio(代理 2MB 上限,不假装能传)。
181
+ * `/zipx-meta` → `/api/v3/verticals`(只读):模板目录。
182
+ * `/zipx-collab` → `/api/v4/collab`(只读)+ 工具 `zipx_collab`(members/anchors/deliveries/audit/snapshots)。
183
+ * `/zipx-os` 收紧为**只读**(与它自己的契约一致)。
184
+ * 消费 Studio 的 `?zipx_project=` 反向进入;新增深链 `?zipx_new=idea|novel|script`。
185
+ * 命令:`/zipx-new`、`/zipx-assets`、`/zipx-know`、`/zipx-deliver`(全部复用已有界面)。
186
+
187
+ ### 纪律
188
+
189
+ * 一条规则一个实现点:创建映射(模式→workflow_type)、归档(PATCH)、版本链(repair)、
190
+ 模板清单(后端)都没有第二套。
191
+ * 面板按钮不直连付费后端:推进/重做/开集/重试一律转成用户消息,由批准卡决定。
192
+ * 死代码清理:旧的 `CreateSheet`(标题/题材/形态手填)整段删除,由向导取代。
193
+
194
+ ## 2026-11-17 P1:语义重复 / 大纲 / 显式重判 / 省略号(0.4.x 修复项)
195
+
196
+ * **语义重复判官** agentic/repetition_review.py:只看每章摘要+首尾 80 字,一次调用输出重复对;
197
+ 失败/超时 checked=False(不阻断、不冒充通过),高严重度进 story_quality.issues。
198
+ * **大纲层重复** story_plan.validate_outline + outline_quality.duplicate_chapters。
199
+ * **全局大纲修改**:POST /project/{id}/story/outline + zipx_update_story_outline,只改
200
+ title/logline/characters、重算 outline_quality、门禁标旧,不重写正文。
201
+ * **显式重判门禁**:POST /steps/{step}/regate + zipx_run_gate(只判不生成;provider 成本,
202
+ 不扣用户积分)。
203
+ * **省略号截断**:validate_chapter 增 ellipsis_truncation,定向重写要求补全台词/动作。
204
+ * 接线门禁新增 validate_outline / repetition_review / content_fingerprint 三项(86 项);
205
+ 回归 tests/test_story_chapter_contract_nov2026.py 14 passed;插件 43 工具全绿。
206
+
207
+ ## 2026-11-17 故事章级质量闭环(0.3.0 修复项)
208
+
209
+ * **单章重写不再绕过章节契约**:ensure_heading + validate_chapter(所有其它章参与,新增段落级
210
+ repetition_scene)+ 命中一次定向重写 + review_issues(不再写 [])。上下文改用唯一实现
211
+ story_context.previous_summary,并注入 Story Bible。
212
+ * **门禁有版本**:gate_snapshot 写 content_fingerprint;产物在判决后被改过 ⇒
213
+ step_gate_failure 报「旧判决,需要重新质检」;WorkState 新增 gate_stale(不许推进,
214
+ summary 说清原因)。
215
+ * **改完真的重判**:新增 WorkflowV2Manager.finalize_after_item_edits;多章批量在收尾调用一次,
216
+ 清掉旧快照 → story_quality + 判官门禁 → 写回;对话里回「门禁已重判:pass/fail(x/y)」。
217
+ * **story_quality.audit 查跨章重复**(整篇 + 段落),高严重度直接进 step_gate_failure;
218
+ 故事质量契约新增第 4 条「禁止重复场景」。
219
+ * 回归:backend/tests/test_story_chapter_contract_nov2026.py(9 项)。
220
+
221
+ ## 0.3.1(2026-11-17,项目详情 + 解绑)
222
+
223
+ * **点开历史项目进入项目视图**:点项目不再「绑一下就关窗」。ProjectLibrary 新增
224
+ ProjectDetail:当前步骤/门禁、步骤清单、该步产物(图片/视频/音频)、最近创作事件,
225
+ 并自动打开右侧「工作台」。绑定仍然发生(之后对话默认指向它),但界面留在项目上。
226
+ * **解绑(新能力)**:后端 `POST /api/v3/director/session/unbind`(幂等,只清
227
+ `external_sessions.project_id`,不动项目/设备/会话);插件新增
228
+ `zipx_unbind_project` 工具,项目详情与项目库头部都有「解除绑定」。
229
+ * 项目库头部在已绑定时显示当前绑定并提供解绑入口。
230
+
231
+ ## 0.3.0(2026-11-16,P0–P3:对话优先 + 原生卡片 + 批准 + 后台任务 + 右侧栏)
232
+
233
+ 以 `docs/ZipX_DSH_融合体验重构与增长可行性方案_20261116.md` 为唯一方案,替换 0.2.x 的
234
+ 「main 全屏面板 + 假聊天 + 内嵌 Studio 主路径」。旧模块能用的搬进新壳,不能用的直接删除,
235
+ 不留第二套实现。
236
+
237
+ ### P0 可发现 / 可连接 / 不绑错
238
+
239
+ * `package.json`:`dsh.client.inject` 17 个客户端包;宿主 credentials/jobs/webserver/session/
240
+ user-approval 为可选 peer;license 改 MIT;版本 0.3.0;keywords 加 `dsh-zipx`/`ai-film`。
241
+ * **token 迁进 DSH Credentials**(`zipx/account`):优先 credentials,旧
242
+ `~/.zipx/account-token.json` 首次启动一次性迁移为 `.migrated`;无 credentials 服务时显式降级文件。
243
+ * **删除全局 `fallbackBinding`**:新会话不再继承上一个项目;缓存缺失时
244
+ `GET /session/{dsh_session_id}` 恢复,恢复不到就报「未绑定」。
245
+ * `zipx_create_project` / `zipx_bind_project` 只绑当前会话,并写 `external_sessions`;
246
+ 没有会话 id 时拒绝写全局绑定。
247
+ * 新设置页:连接 / 账号 / 积分 / 预算 / 诊断;新增 `/zipx-auth/status`、`/zipx-budget`、`/zipx-doctor`。
248
+ * 新增 `/zipx-media` Range 代理(只放行 ZipX 文件路径,支持 206/HEAD),手机可拖进度条。
249
+
250
+ ### P1 对话优先 + 卡片 + 批准 + 后台任务
251
+
252
+ * `conversation.session.header.actions` 项目 Chip;`conversation.composer.dock` 状态条;
253
+ `conversation.hero.options` 首屏入口。
254
+ * `tool.call.toolview` 注册 **35 个 keyed 卡片**,其中 18 个专属:
255
+ 状态 / 预检 / 执行 / 进度 / 产物 / 成本 / 交付 / 四锁 / 项目库 / 绑定 / 连接 / 开始 / 切换。
256
+ * 每个工具都有 `output.presentationMeta`(纯函数、可回放、JSON-safe);默认投影覆盖长尾工具。
257
+ * **原生批准**:`tools/pre-execute` 对 7 个付费工具 + 会触发付费的 `zipx_chat` 返回 `ask`;
258
+ 无批准通道时拒绝(`ZIPX_ALLOW_UNCONFIRMED=1` 仅显式放行)。`confirm: true` 不再被信任。
259
+ * **预算拦截**:每步/每日上限,超出时在批准前 deny;批准后在 `tools/result` 记账。
260
+ * **后台任务**:`zipx_watch_step` 用 `ctx.jobs.start` 立即返回 job id;完成由 ui-jobs 通知;
261
+ 无 jobs 服务时退回阻塞等待。取消走 `zipx_abort`(请求后端中止并释放执行锁;已发出的付费调用可能仍完成)。
262
+ * `zipx_confirm_step` 不再阻塞 90 秒:只回「已受理」,真实进度交给 `zipx_watch_step`。
263
+
264
+ ### P2 右侧栏工作台 + 产物 + 交付
265
+
266
+ * 四个 Tab 类型:`zipx-workbench` / `zipx-artifact` / `zipx-delivery` / `zipx-studio`,
267
+ 通过 `ctx.sidebarRightTabs.register` + `sidebar.right.pane.tab`(按类型 id keyed)接线。
268
+ * 工作台:步骤列表、当前步骤产物、推进/重做/交付/legacy 按钮;按钮只发用户消息。
269
+ * 产物 Tab:图片/视频/音频/文本,视频走 `/zipx-media`;交付 Tab:检查单 + 成片播放。
270
+ * **main 面板降级为项目库**:列表/搜索/新建/绑定;不再有假聊天与三栏 Studio。
271
+ * `?zipx_shell=legacy` 保留回退:项目库 + 内嵌 Studio;右侧栏也有 legacy Tab。
272
+
273
+ ### P3 命令 / 引用 / 移动端 / 发布素材
274
+
275
+ * `/zipx`、`/zipx-status`、`/zipx-doctor`(`ctx.commandUi`)。
276
+ * `@项目` 引用(`ctx.inputTriggers`):插入 `<zipx_project id="…"/>` 并绑定本会话。
277
+ * 卡片/列表/状态条响应式(auto-fill grid、flex-wrap),右侧栏走 DSH 全屏规则。
278
+ * README 第一屏改成「结果 + 5 分钟 + 成本 + 原生能力」;market index 0.3.0 结果导向。
279
+ * 新增 `scripts/check-host.mjs`(绑定/批准/后台任务/卡片/media)、重写 `scripts/check-panel.mjs`。
280
+
281
+ ### 2026-11-17 边界补强(仍属 0.3.0)
282
+
283
+ * **真取消**:新增 `zipx_abort` 工具 + 后端 `POST /api/v3/director/project/{id}/abort`,复用唯一实现
284
+ `WorkflowV2Manager.abort_step`(置 abort 标志、强制释放执行锁、项目置 failed、写活动日志)。
285
+ `zipx_watch_step` 的后台任务 `cancel()` 现在**同时请求后端中止**,不再只停轮询;文案如实写
286
+ 「已发出的付费调用可能仍完成,后续步骤不会继续」。
287
+ * **成本口径可见**:成本卡显示 `estimate_kind`;`precheck_threshold` 明确写「开拍前余额预检门槛,
288
+ 不是最终报价」。
289
+ * **产物签名可刷新**:产物卡新增刷新按钮,重新调 `/artifacts?media=1` 换新签名 URL(过期不再只能重开面板)。
290
+ * **LAN/手机**:Host 代理从「仅回环」放宽到「回环或同一个 DSH 页面」,手机经 LAN 打开 DSH 也能用
291
+ `/zipx-api`、账户、诊断与媒体代理。
292
+ * **批准策略 never 不再把付费动作判死(2026-11-17 真机)**:DSH 的 full access 预设 =
293
+ `approval policy never`,原生批准卡会**确定性地拒绝**,E2E 会话因此卡在 `zipx_start`,
294
+ 模型只看到 `the user rejected tool`。现在 `tools/pre-execute` 先读会话策略:`never`
295
+ 或没有批准服务时,降级到 `ctx.userQuestions` 的**一次性确认卡**(`intent.kind='approval'`,
296
+ 「允许本次 / 拒绝」)——仍然是人点,不是模型自证;只有两者都不可用才 deny。
297
+ `zipx_connect` 增加「付费确认」一栏(DSH 批准卡 / 一次性确认卡 / 不可用),系统提示与
298
+ skill 明确「含付费动作的 run_code 单独一次并传 `timeoutMs: 600000`,默认 120 秒包含等待
299
+ 人确认的时间」。回归:`scripts/check-host.mjs` 新增 never / 拒绝 / 无批准服务三条。
300
+ * **建项目不再丢创意母本 / 规格(2026-11-17 真机)**:`zipx_create_project` 新增必填
301
+ `initial_content`(写入 `project.input_prompt`,故事步骤只读它),并映射
302
+ `episodes` → `story_requirements.chapter_count`、`duration_s` → `target_runtime_s`。
303
+ 此前工具只发 title/genre,而 `form/episodes/duration_s` 不是 `DirectorSetupRequest`
304
+ 的字段、被 Pydantic 静默丢弃;故事步骤于是拿 `project.input_prompt` 的占位串生成——
305
+ 真机把「科幻政治惊悚」写成乡村染坊悬疑(6826 字、0 章)。回归:`check-host` 新增
306
+ 母本/章节/时长/旧字段四条。
307
+ * **2026-11-17 修复轮(F1/F2/F3/F4/F9)**:
308
+ * `zipx_start` 批准卡的 step 缺省按 `story` 预估(不再「费用未知」)。
309
+ * 新增 `zipx_update_project_input`(未开工项目改正 `project.input_prompt`,避免新建同名项目);
310
+ 工具面 35 → 36,`check-tools/check-skill/check-host` 同步。
311
+ * `zipx_start` render 显示预估 credits / 余额;后端 start 回执带
312
+ `estimate_calls/balance/estimate_kind`。
313
+ * `zipx_create_project` 的导演原型/画幅/平台/语言参数(源码已有,本轮构建带入)。
314
+ * skill/系统提示:科学/惊悚优先 nolan/fincher;未开工改母本用新工具。
315
+ * **生成结果回不到对话(2026-11-17 19:30–,session-0f608876)**:
316
+ * 后台完成通知只有 WorkState(\`story · running · 1/1\`),没有正文/媒体/产物指针;
317
+ \`zipx_read_asset\` 只给截断 JSON,\`zipx_artifacts\` 的 render 不列 URL;
318
+ \`/zipx-media\` 还拒掉契约 v5 的签名媒体路径(\`media_target_rejected\`),
319
+ 且不补 Host 令牌(签名端点仍要登录态)⇒ 会话里看不到任何产物。
320
+ * 新增 **\`zipx_step_result\`**(工具面 36 → 37)+ **ResultCard**:正文节选、
321
+ 章/场/镜/条计数、门禁、图片/视频网格(/zipx-media),并给「在 Studio 打开」。
322
+ * 后端新增 \`GET /project/{id}/result\`(\`agentic/step_result.py\`):一步的预览读模型,
323
+ 覆盖所有工作流步骤(结构化步骤回退到字段摘要);没有产物如实 \`has_content=false\`。
324
+ * \`zipx_watch_step\` 到终态时取紧凑回执(<2KB)塞进完成通知,\`detail\` 先报「生成了什么」。
325
+ * \`/zipx-media\` 放行 \`/api/v3/director/project/\`,**只对配置后端**补 Bearer;
326
+ \`zipx_read_asset\` render 改成先读正文(story_text/script_text/hook/chapters)。
327
+ * 系统提示 + skill 硬规则:**生成结束必须调 \`zipx_step_result\`,只说「已完成」不算交付**。
328
+ * 回归:\`tests/test_step_result_nov2026.py\` 7 passed;\`check-host\` 新增 v5 媒体放行/令牌/
329
+ step_result 三条;\`check-panel\` 新增 ResultCard 两条。
330
+
331
+ ### 删除 / 替换
332
+
333
+ * 删除 `src/client.js` 单文件大 bundle(194KB)与其中的假聊天、内嵌 Studio 主路径、
334
+ 旧三栏 `ZipxPanel`;客户端拆成 `src/client/*.js` 由 `scripts/build.mjs` 顺序拼接。
335
+ * 删除 `fallbackBinding`、对 `confirm` 的信任、阻塞式 watch 主路径。
336
+ * 旧 `ZipX × DSH:插件生态接入 + 对话系统替代` 的 DSH 面板实现不再作为入口;本版以
337
+ 《融合体验重构与增长可行性方案》为唯一方案。
338
+
339
+
340
+ 业主裁定「按 B1 执行」——预览要与 zipx studio 前端界面**每个工作流的设计显示一致**。
341
+ 0.2.6 只做到"数据源与字段对齐"(同一份产物、同样的场景字段拆法),富交互(分镜编辑器、
342
+ 候选帧、EDL 时间轴)仍只在 Studio 里有。这一版改成**不复制设计**:
343
+
344
+ * **iframe 直接跑 Studio**:产物区新增两档「Studio 视图 / 对话卡片」,**默认 Studio 视图**。
345
+ iframe 打开的是 `{studioUrl}/studio/{projectId}/embed/{step}` —— Studio 里那一步的原界面,
346
+ 不是重画的一版。切到「对话卡片」是原来的精简视图(窄、纯文本、不依赖 Studio 起没起)。
347
+ 偏好记在 `zipx.wbView`。
348
+ * **凭证不进浏览器(除了一次性码)**:面板 → Host `/zipx-embed/url`(Host 侧带令牌)→
349
+ ZipX `POST /api/v3/director/project/{id}/embed-code` 发**一次性、120 秒**的兑换码 →
350
+ Host 把码拼进 iframe 地址 `?vc=…` → iframe 兑换出一条 **15 分钟**令牌存
351
+ `sessionStorage`。诚实边界:换到的仍是**完整用户令牌**,只是寿命 15 分钟;它不写
352
+ `localStorage`(那会覆盖用户自己在 Studio 标签页的登录态),也不进 URL。
353
+ * **码是一次性 ⇒「重新载入」必须重新签发**:iframe 里的重载通过 `postMessage` 回到面板,
354
+ 面板重新申请一次再换 `src`;地址栏里的 `?vc=` 兑换后立刻 `replaceState` 抹掉。
355
+ * **凭证过期如实可见**:15 分钟后 iframe 顶部出现一条「预览凭证已过期,点重新载入」,
356
+ 不假装还能用。
357
+ * **回归**:`check-panel.mjs` 新增 5 项(文案中英齐全 / 走 `/zipx-embed/url` /
358
+ `StudioEmbed` 存在 / 默认 Studio 视图 / 切换会写回偏好);locale 274 键中英一致。
359
+
360
+ ## 0.2.6(2026-11-16,对话入口交给「属于这个项目的 DSH 会话」+回执诚实+预览人话化)
361
+
362
+ 业主三条反馈:「点『DSH 导演』跳到了我正在进行的别的会话,不是在这个项目里创作」、
363
+ 「图三输入内容后系统没法理解和推进」、「预览文本还是 JSON 格式,要和 Studio 每步的设计一致」。
364
+
365
+ * **对话入口:新开一个本项目的 DSH 会话,不再往当前输入框塞字**。旧实现是
366
+ 「把[ZipX 项目]+ 你说的话压进当前挂载的 composer,然后 `layout.selectPanel(null)`」——
367
+ 于是话落进了用户上一次开着的会话(真机:落进一个完全无关的任务会话),而递过去的还只是
368
+ 一句导航标签。现在走 `uiWorkspace.startSession({ prompt })` 新建会话;桥只把话交给
369
+ **推送之后才挂载**的输入框(旧会话的输入框不接),并在用户本来就点了发送时替他按回车;
370
+ 拿不到 `uiWorkspace` 的老版 DSH 退回"塞进当前输入框",**不再主动把视图切走**。
371
+ * **绑定即角色**:交接文本先要求模型调 `zipx_bind_project`;该工具的回执现在是**导演角色卡**
372
+ (先读状态、写前预检、付费先问、一次一个写动作、只说「已派发」、读不到就说读不到)。
373
+ DSH 的 preset 不随第三方插件分发,工具结果是目前唯一能可靠交出身份的时机。
374
+ * **预览:场景串拆成人话字段**。后端把场景写成 `【Scene 6】景: 修表铺柜台时: 同日晌午人: 女人、老师傅`,
375
+ Studio 会拆成地点/时间/人物;面板此前原样打印,看起来就像 JSON。现在同一套字段拆出来
376
+ (`景/时/人`),正文单独一行;剧集规划额外给「这部剧已经拆成 N 集」的子项目卡片(集号/状态/场数/打开),
377
+ 与 Studio 的 EpisodesView 同一份数据源。
378
+ * **不再拿 JSON 当正文**:「最长字符串」兜底会跳过 `{`/`[`/`"` 开头的片段;没有结构化预览时
379
+ 如实说「这一步暂时只有统计,全文点『在网页 Studio 看』」;原始 JSON 入口改名为「调试:原始 JSON」。
380
+ * **后端回执诚实(P0 真机工单)**:项目 3ebb080f「AI 东方」14:13 那一轮被判
381
+ `blocked / dispatch_not_fired:START_WORKFLOW`,而同一时刻 `creative_events` 是
382
+ `turn.responded(start_workflow) → expert.activated 06:18 → gate.evaluated 06:37 → artifact.saved(story) 06:47`
383
+ —— 创作真的跑完了,回执却说没派发。根因:`_execute_start_workflow` 已经 `create_task` 起跑,
384
+ 动作字典却没有 `pipeline_fired`。现在唯一派发判据 `DirectorAgent._spawn_background()`,
385
+ START_WORKFLOW / START_EPISODE(两条入口)/ RESUME 的拒绝分支全部显式写这个字段;
386
+ `PAUSE` 从"异步"改判"同步完成"(置位失败用 `ok=False` 判 `blocked:sync_failed`);
387
+ `ADVANCE_WORKFLOW` 补进异步名单(原来登记的是没有任何发送方的 `ADVANCE_STEP`,导致
388
+ 未起跑的推进落成 done)。
389
+ * **回归**:`backend/tests/test_async_action_dispatch_flag_nov2026.py`(9 项,含源码守卫:
390
+ ASYNC_ACTIONS 里任何类型出现时必须带 `pipeline_fired`,第四次复发当场红);
391
+ `test_advance_refusal_honesty_oct2026.py` 一并 18 项通过;插件 `npm run check` 全绿(locale 265 键中英一致)。
392
+
393
+ ## 未发布(2026-11-13 深夜,工作台 v4:按步骤渲染 / 父项目→子剧集 / 导演方案可见 / 上下分栏)
394
+
395
+ 业主两条反馈:「工作台和预览区的横线做成可以上下拖拽放大的」+「从剧集规划看,内容显示不正确,
396
+ 剧集设计的内容没能正确显示。请检查全部工作流链路的接线情况……是全部工作流」。
397
+
398
+ * **上下分栏**:工作台内部(步骤列表 / 产物预览)之间新增可拖拽横线(14%–80%,双击复位,
399
+ 比例进 localStorage)。原来步骤区写死 `max-height:44%`,产物区再大也挤不动。
400
+ * **每一步按它自己的结构渲染**(这是"内容显示不正确"的根因):以前统一取"最长的那段字符串"当正文,
401
+ 剧集规划的 `episodes[].scenes` 是整段剧本,于是屏幕上出现的是某一集的第 9 场,用户看不到
402
+ "几集 / 每集几场 / 每集讲什么"。现在:剧集规划=每集卡片(集/场/时长/角色 + 前 3 场首行);
403
+ 剧集设计=集号/场数/镜头数 + 设计摘要 + 场景列表;导演方案=场数/硬规则/覆盖义务 + 导演简报
404
+ (Markdown);分镜设计=场数/镜头数 + 前几镜;剧集规划/剧本=场景列表;声音/剪辑/合成/后期各有摘要。
405
+ 结构化步骤不再跑"最长字符串"扫描(95 万字符的 episode_design、1.4MB 的 keyframes 不再整树遍历)。
406
+ * **父项目的剧集阶段步骤**:以前点「剧集设计」只显示"还没有产物"——那一步是按集生成的,父项目本来就没有。
407
+ 现在给出「这一步按集生成」+ 子剧集按钮(第 N 集 · 场数),点进去就是那一集的产物。
408
+ * **剧集子项目只显示 episode 阶段步骤**:`/workflow-steps?workflow_type=episode` 回的是 14 步全链
409
+ (API 把未知类型回落到 idea2video),面板按 `is_episode_step` 收敛成 9 步并重新编号 1–9。
410
+ * **后端:产物白名单从注册表派生**(真正的接线缺口)。`/project/{id}/artifacts` 以前手写白名单,
411
+ 漏了 2026-11-11 新增的 `directing`(导演方案)——库里真有 2 条 directing 资产,网站与面板都显示
412
+ "没有产物"。现在唯一派生点 `artifact_types_for_read()`(注册表步骤 id ∪ 历史别名 ∪ review_stills),
413
+ 新增测试 `tests/test_artifact_visibility_wiring_nov2026.py` 扫全仓 `_save_asset(…, "<type>")`,
414
+ 任何写得出却读不到的类型当场红。`verify.ps1` 14 → 15 步。
415
+ * 顺手:生命周期词条改走字典(`awaiting_confirm` 不再原样吐英文);场景行不再重复 `[1]` 编号;
416
+ 导演方案的 totals 用「场 / 条规则 / 条硬规则 / 条覆盖义务」而不是英文键名。
417
+
418
+ **真机验收(隔离 t1 :3990)**:剧集规划卡片 ✓、剧集设计→按集提示 ✓、子剧集步骤收敛 ✓、
419
+ 子剧集剧集设计有产物 ✓、导演方案读到 25.5KB 产物并显示"共 9 场 · 硬规则 7 条 · 覆盖义务 0 条" ✓、
420
+ 上下分栏拖动 496→586 ✓;v3 那套 18 项回归仍全绿;后端 pytest 3/3 通过。
421
+
422
+ ## 未发布(2026-11-13 晚,面板 v3:可拖拽工作台 / 新建 / 账户 / DSH 对话;发布时 bump 到 0.2.6)
423
+
424
+ 业主三条反馈,逐条落到代码:
425
+
426
+ * **工作台能点开任何一步的产物**。此前只在选中项目时预拉 `steps=keyframes,compose`,其余步骤的产物永远看不到;现在点哪一步就取哪一步(`GET /project/{id}/artifacts?media=1&steps=<step>`,命中缓存 60 秒)。视频可播、图片可点开大图(灯箱)、长文本给预览、原始 JSON 折叠,并**分开**说「正在读 / 读不到(HTTP x)/ 这一步还没有产物」——「没生成」不等于「生成失败」。
427
+ * **对话与工作台之间是可拖拽的分栏**(320–720px,双击复位,宽度记在 localStorage)。产物区默认 420px、图片网格 112px 起,分镜/关键帧不再挤成 88px 缩略图。拖拽用 pointer capture + React 事件,不碰 `window.addEventListener`(动态包的浏览器全局是被收窄的)。
428
+ * **面板里能新建项目**:标题 / 题材 / 一句话创意 / 起点 / 画幅 / 平台 / 模式 → `POST /setup`,`auto_start:false`——**建项目不花钱**,要不要开工由接下来的对话决定。
429
+ * **账户、登录、创作者中心进入插件**:新增 Host 侧 `/zipx-account` 代理(`/api/v1/{auth,user,credits}` 里**明确列出**的六个动作)。注册/登录/退出/改名/改密码/看积分都在面板里;`access_token` 只落 Host 进程与 `~/.zipx/account-token.json`(0600),浏览器只拿到 `{ok,user}`。**退出登录同时清掉配对令牌**,否则「退出」之后旧令牌仍然可用。新增 `scripts/check-account-route.mjs`(假后端,不创建账号):令牌不外泄 / 登录态 / 额度 / 退出即失效 / 白名单外 404;`verify.ps1` 13 → 14 步。
430
+ * **对话系统默认改用 DSH 的**(回答业主第 3 条)。此前面板里跑的确实是 **ZipX 自己的 DirectorAgent**(`/api/v3/director/chat`:意图分类、守卫、计划模式)——只是被画进了 DSH,这是事实陈述不是设计意图。现在默认「DSH 导演」:面板**不复制对话**,把「[ZipX 项目:标题|id]+ 你说的话」写进 DSH 的输入框并切到对话视图(`conversation.input.right` 桥:先在光标处 `insertText`,这样 DSH 里已有的草稿不会被顶掉;拿不到光标才退回 `setDraft`),由带 34 个 zipx 工具的 DSH Agent 规划与派发;抓不到输入框时如实降级为剪贴板,不谎称「已发送」。「Studio 引擎」保留原来的 DirectorAgent 对话,标签上直接写明它是 Studio 引擎,用于对照与旧会话。
431
+ * **动态包的定时器**:`setTimeout`/`setInterval`/`fetch` 在动态包里会抛(DSH 的 guard 明确拒绝)。面板的"思考中计时 / 提示自动收起 / 交接兜底"改用 `inject:['timer']` 的 `ctx.timer`;深链自动切面板也改用 `ctx.timer.timeout` 重试(此前靠 `window.setTimeout`,在真机里一次都没跑起来)。
432
+ * **诚实边界**:DSH 没有「在非对话面板里嵌对话」的公开 API,能拿到的是 composer 的 `setDraft/submit`。所以面板不冒充对话渲染器——它把话交出去,由 DSH 自己显示那一轮;面板里的 DSH 卡片写清了这一点。
433
+
434
+ ## 未发布(2026-11-13,面板重做;发布时 bump 到 0.2.6)
435
+
436
+ 面板从「只读工作台」变成「能对话的工作台」。业主原话:「没有对话创作系统的对话框,对话创作是 zipx 创作的核心入口」+「前端编排混乱,缺乏美感」。
437
+
438
+ * **对话是主舞台**:面板直接调 `POST /zipx-api/chat`——与 Studio **同一个导演 Agent、同一张 `dialogue_turns` 表**,不是第二套对话引擎。说话就能推进/修改/重做;付费动作仍由导演先问;回执把 `actions` 作为 chip 显示,派发后只说「已派发」,不假装完成。
439
+ * **重新编排**:顶部 48px 状态栏(品牌 / 连接态 / 刷新),左侧 264px 项目库(搜索 + 门禁徽章 + 产出),中间对话(气泡、时间、理解成什么、思考中计时、停止等待),右侧可折叠工作台(步骤 / 产物 = 成片播放器 + 关键帧)。原来的「三列挤一屏、11px 字、8 个竖排按钮、把句子复制到会话里让模型执行」全部删掉——动作现在**直接填进输入框**。
440
+ * **对话记录**:新增 `/zipx-os` 只读代理(→ `/api/v3/creative-os`);后端 `runtime.snapshot` 补 `reply` / `intent_type`,`raw_message` 160 → 800 字符。Host 未重启(代理还 404)时退回本机缓存并如实说明,不把「读不到」说成「没有」。
441
+ * **Markdown**:导演的回话是 Markdown(`**粗体**`、编号清单),此前原样吐星号。现在只认三种结构:粗体、有序/无序清单、空行分段。
442
+ * **意图/生命周期说人话**:`revision_run` → 「整段返工」、`advance_step` → 「推进下一步」;`passed` → 「已通过」。`none` 不再显示成一条 chip。
443
+ * **门禁**:新增 `scripts/check-panel.mjs`(最小 React 渲染,断言空舞台/深链/输入框/发送禁用,抓「白屏」这类语法检查抓不到的事故)与 `scripts/sync-locale.mjs`(`locale/*.json` 由面板字典生成,`--check` 不一致就红);`verify.ps1` 11 → 13 步。
444
+ * **实测**:隔离 profile 冷启动 + 无头 Chrome,19 个项目、`pageerror` 0、`failedResponses` 0;截图 `screenshots/02-workbench.png`。
445
+
446
+ ## 0.2.5 — 2026-11-13
447
+
448
+ 真机验收(DSH Web 重启后)暴露的三条「说了假话」,都与**花钱**或**状态**有关:
449
+
450
+ * **预检把「会花钱」报成免费**:`zipx_preview_action` 对 `advance_step` 回 `paid:false`,而它实际会起跑下一步生成——实测 `campaign_brief` → `creative_script` 扣 **10 credits**。现在回 `action_paid / triggers_generation / generates_step / note`,render 直接说「推进本身不计费,但它会起跑下一步「创意脚本」的生成」。
451
+ * **状态卡把「下一步」说成当前步**:站在「创意简报」上写「你要推进到下一步「创意简报」」——指回自己。现在对着 `next_step_id` 说话;链尾(如父项目的 `compose`)改说「收尾交付(已是最后一步)」,不再让人以为后面还有阶段。
452
+ * **`fetch failed` 读成「后端坏了」**:长驻 Host 进程的 keep-alive 池在后端容器重启后会留一批死 socket。GET 现在对连接级失败重试 3 次(写请求一律不重试,付费动作不能被 socket 抖动执行两遍)。
453
+ * **新增 `zipx_dispatch`(工具面 33 → 34)**:契约能力清单里的 8 个付费动作,此前有 4 个(`modify` / `style_adjust` / `batch_modify` / `restart`)只能靠 `zipx_chat` 用人话触发——要过意图分类,分类错了就变成「改成了别的东西」。现在有结构化写入口,走同一个唯一派发口 `/dispatch`,动作与参数原样交出。写路径 E2E 从 14 项加到 **18 项**:`modify` / `style_adjust` / `batch_modify` / `restart` 四个动作逐个断言「不带 confirm 必须 409 `confirm_required`」(全部零成本)。真机校验:不带 `confirm` 的 paid 动作 → 409 `confirm_required`(「这个动作可能触发付费生成调用。先确认(confirm=true),或先 preview 看成本。」)。
454
+ * **代理侧也修了一次「fetch failed」**:`/zipx-api` 的 GET 现在重试一次;写请求不重试,但 502 里写明「这是连接级失败、请求可能没送达、付费动作请带 idempotency_key」,并带上 `retryable` 与 `upstream`。
455
+ * **`zipx-creator` 技能真的挂上了**:`skills/zipx-creator/SKILL.md` 从 0.1.0 就随包发出去,但没有任何代码把它注册进 DSH——技能清单里看不到,等于「文档带了、入口没有」。现在经 `ctx.skills.registerProvider` 注册(模型与用户都可调起,rank=600 与自带包同级)。新增 `scripts/check-skill.mjs`:用假 ctx 跑 `apply()`,断言 provider 被注册、`list()` 给出 `zipx-creator`、`get()` 真能读出正文。
456
+ * **验收脚本自己先能红**:`verify.ps1` 此前用 `node xxx.mjs | Out-Null`,脚本 `exit 1` 也照样打 PASS(输出还被吞掉)。现在每个 node/pnpm 调用都检查退出码并抛出(红测:`node -e process.exit(7)` → 当场 FAIL)。步骤 8 → 9。
457
+ * **后端的 409 现在直接说人话**:此前 `ZipX /api/v3/director/dispatch -> HTTP 409: {"detail":{"code":...}}` 整段塞给模型,而 `detail.message` 里本来就是「先确认(confirm=true)」这种人话。现在优先取 `detail.message`(或 `detail` 字符串),`status`/`code` 挂在 Error 上;非 JSON 错误体保留原文。
458
+ * **验收先等后端真的起来**:`verify.ps1` 新增第 1 步「/health 连续两次 200(最多 90 秒)」。真机教训:容器刚重启时 uvicorn 已绑端口但深链路在初始化,第 7 步照过、后面的 audit/E2E 偶发 `fetch failed`,把「后端在开机」误报成「插件坏了」。超时算失败,不静默继续。(顺带:这个文件必须保持纯 ASCII——PS 5.1 把无 BOM 的 UTF-8 当 ANSI 读,中文注释会让它解析失败。)
459
+ * **新增 `scripts/check-net.mjs`(第 10 步验收)**:用本地假服务把三条网络行为钉死——409 人话原样透出且不重试、GET 连接被掐断会重试一次、**写请求连接失败不重试**(付费动作不能重放)。以前这三条只能靠真机偶发观察。
460
+ * `/zipx-api` 补回环校验:它替浏览器注入配对令牌,所以只接受本机连接(回环外一律 403 `not_loopback`)。实测 3080 只监听 127.0.0.1,这条挡的是「把 DSH 暴露到局域网」那一步。
461
+ * `zipx_connect` 回 `dsh_tools`(本进程真实注册数),「33 个工具」不再靠数提示词;系统提示段里的工具数也改成运行时取值,不再写死(此前写死 23,工具面早已 33)。
462
+
463
+ ## 0.2.4 — 2026-11-13
464
+
465
+ * 新增 `zipx_events`:按游标增量读创作事件(契约 v5 #14)。此前那个端点**没有任何消费者**——等于白实现。真机回执:`count/has_more/next_cursor` + `events[].event_type/summary/step` 与 render 一致。
466
+ * 工具面 32 → 33。
467
+
468
+ ## 0.2.3 — 2026-11-13
469
+
470
+ * 面板不再把「读不到」说成「没有」:500 / 非 JSON 响应此前都掉进「项目库是空的」,现在分别显示「读取失败(HTTP 500)」与「返回的不是 JSON」,并提示先重试。
471
+ * 新增 `scripts/ui-resilience.mjs`:真浏览器 + 路由拦截,把后端打到 0 项目 / 500 / 非 JSON / 超长标题 / 渠道关闭,断言「无 pageerror、文案不说谎」。
472
+
473
+ ## 0.2.2 — 2026-11-13
474
+
475
+ * `zipx_delivery` 的检查项**原因字段读错了**(读 `detail`,实际是 `note`)⇒ 把「为什么不通过」整段丢了。修好后「台词无人声 / 字幕偏差 127s / 色偏」这类结论才真的到模型眼前。
476
+ * `zipx_sign_lock` 回执没有 `lock` 字段 ⇒ 改为从入参取,不再输出「已签收 」空尾巴。
477
+ * `zipx_list_episodes` 有人话列表,不再把裸 JSON 丢给模型;读不到子项目时如实说明。
478
+
479
+ ## 0.2.1 — 2026-11-13
480
+
481
+ * `zipx_confirm_step` 只对**当前步骤**有效:传别的步骤会 409 `step_mismatch`(此前会返回 200「已确认」而指针不动 = 假完成)。
482
+ * 面板产物请求只拉真正渲染的两步(`keyframes,compose`):**2.88MB → 1.30MB**。
483
+ * 连接卡提示改指向真实入口(Studio「用 DSH 创作」);入口卡/任务屏的复制按钮改为复制**整条深链**(码与设备成对,单独抄码连不上)。
484
+ * 新增 `scripts/check-market-ready.mjs`(市场就绪 21 条断言)与 `scripts/e2e-write.mjs`(零成本写路径 E2E,自动清理)。
485
+ ## 0.2.0 — 2026-11-13
486
+
487
+ * **工具面 23 → 32**:新增 `zipx_connect` / `zipx_list_projects` / `zipx_create_project` /
488
+ `zipx_bind_project` / `zipx_project_overview` / `zipx_artifacts` / `zipx_delivery` /
489
+ `zipx_cost` / `zipx_repair_action`,对应契约 v5 的 14 个端点。
490
+ * **会话-项目绑定**:`zipx_bind_project` 之后,读类工具可省略 `project_id`(缺省取本会话绑定,
491
+ 同时写 ZipX `external_sessions` 做持久化)。
492
+ * **配对 handoff**:新增 `POST /zipx-pair/connect` 与面板自动消费 `?zipx_code=`;
493
+ 令牌改成一请求一读,配对后**无需重启 DSH**。
494
+ * **面板**:项目库带门禁摘要(`gates=1`),连接卡显示账号/设备/过期。
495
+
496
+ ## 0.1.0 — 2026-11-13
497
+
498
+ * 首个可安装版本:标准 DSH 组合包(`dsh.bundle` + `engines.dsh`),零依赖构建,23 个工具。
499
+
500
+
501
+
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 ZipX
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.