@ninkch/dsh-infinite-canvas 0.20.5 → 0.21.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/docs/UI-RULES.md CHANGED
@@ -22,8 +22,9 @@
22
22
 
23
23
  10. 图标列**不得有任何外框**:无 `border`、无 `background`、无 `box-shadow`、无 `border-radius`(不要卡片、不要描边、不要底色)。
24
24
  11. 图标列**垂直居中悬浮在左栏中间**,**不撑满上下边**。正确实现是**两层结构**:外层 `.dshic-rail` 只负责占位(宽 46px、透明、`position:relative`),内层 `.dshic-rail-inner` 用 `position:absolute; top:50%; transform:translateY(-50%)` 居中。**不要用 `align-self:center` + `margin:auto 0`**——它会被父级 `align-items:stretch` 拉成整列高,看起来像"满高白色卡片",这是历史上反复复发的问题(第三次返工才根治)。
25
- 12. 图标顺序:文本 / 剧本 / 分镜表 / 图片 / 视频 / 成片 / 资产 / 设定集 / **导演台** / 运行工作流;hover 才有轻量反馈。
26
- - 导演台(摄像机图标,`data-action: 'open-director'`)排在「设定集」与「运行工作流」之间:前六个是**节点类型**,资产/设定集/导演台是**工具入口**,运行工作流是**动作**——三组分隔符 `dshic-rail-sep` 把它们分开。
25
+ 12. 图标顺序:文本 / 剧本 / 分镜表 / 图片 / 视频 / 音频 / 成片 / 资产 / 设定集 / 角色库 / 工作流 / 记忆 / **3D-BOX** / 运行工作流;hover 才有轻量反馈。
26
+ - 前七个是**节点类型**,资产/设定集/角色库/工作流/记忆是**工具入口**,3D-BOX 是**产品入口**,运行工作流是**动作**——三组分隔符 `dshic-rail-sep` 把它们分开。
27
+ - **3D-BOX 只保留一个入口**(`data-action: 'open-3dbox-home'`,摄像机图标):先进入 3D-BOX 库(新建/我的 3D-BOX),再由卡片进入舞台;不要再加第二个「导演台」入口。
27
28
  - `scripts/test-panel-layout.mjs` 对整列 `data-action` 序列做严格断言(顺序错一个就红),改顺序必须同时改该测试与本条。
28
29
 
29
30
  ## 四、项目下拉(左上角)
@@ -15,8 +15,9 @@
15
15
  ## 1. 当前实现(进程内执行器)
16
16
 
17
17
  **入口**(三处,同一引擎):
18
- - 设置卡「自动创作(实验)」:开关 + 一句话创意 + 启动/中止 + 预算单/批准/生成;
19
- - 对话工具:`canvas_auto_status` / `canvas_auto_start` / `canvas_auto_budget` / `canvas_auto_generate` / `canvas_auto_abort`;
18
+ - 设置卡「自动创作(实验)」:**只有开关**(0.21 起动作区迁出);
19
+ - 创作台(左栏图标,`ProductionConsole`):brief/启动、实时阶段与预算单、分场勾选生成、批准/生成/中止;批量执行同面板页签;
20
+ - 对话工具:`canvas_auto_status` / `canvas_auto_start` / `canvas_auto_budget` / `canvas_auto_generate` / `canvas_auto_abort`,单价设置 `canvas_production_set_price`;
20
21
  - 人格分支:`canvas_auto_status.enabled=true` 时禁止提问,必须同一轮 `canvas_auto_start`。
21
22
 
22
23
  **免费段**(`autoRoom`,五轮角色提示词 + 落盘 + 生成编排):
@@ -46,7 +47,7 @@
46
47
  | 编剧室/付费段 | `index.js`(`autoRoom`/`autoPaid`/`AUTO_RUNS`) | 轮次编排、讨论落盘、生成编排 |
47
48
  | RPC | `autoModeGet/Set`、`autoStart/Status/Abort`、`autoQuote/Approve/Generate` | 设置卡与工具共用 |
48
49
  | 工具 | `canvas_auto_*` 五个 | 对话智能体的入口 |
49
- | 客户端 | `AutoModeCard`(设置卡)+ `ProjectsTab` 阶段行 | 开关/创意/预算/批准/进度 |
50
+ | 客户端 | `AutoModeCard`(设置卡,只有开关)+ `ProductionConsole`/`AutoStudioPanel`(左栏创作台)+ `ProjectsTab` 阶段行 | 开关;brief/预算/批准/生成/中止(创作台) |
50
51
 
51
52
  ## 3. 测试
52
53
 
@@ -1,5 +1,7 @@
1
1
  # 3D 导演台技术方案(Infinite Canvas)
2
2
 
3
+ > **0.21.0 入口变更**:用户界面统一为 **3D-BOX**,左侧只保留一个 `open-3dbox-home` 入口(先到 3D-BOX 库,再由卡片进舞台);本文中的 `open-director` 为历史入口,内部引擎与 `canvas_director_stage` 兼容不变。
4
+ >
3
5
  > 状态:**决策文档**(只定方案与验收判据,不含实现代码)
4
6
  > 范围:无限画布插件的「3D 导演台」功能——左侧图标列入口、摆位取景、截图当镜头首帧、接视频生成
5
7
  > 代码快照:2026-10-23,`client.js` 15974 行 / `index.js` 3984 行;并行开发会让行号漂移,**以标识符检索为准**(末尾「引用自查」给出当次实测行号)
package/docs/guide.en.md CHANGED
@@ -132,7 +132,7 @@ canvas: project card script node text+storyboard ×N ref image nodes
132
132
 
133
133
  ### 3.1 Auto creation (experimental) — one sentence to storyboards + budget
134
134
 
135
- Settings → 「自动创作(实验)」→ on. Then one sentence in the chat (e.g. 拍个悬疑短剧,快递员每天送的信来自未来) starts the writers room: research → two independent pitches → cross-critique → producer decision → bible → script → per-scene storyboards → **budget sheet**. No questions are asked in this mode; the transcript lands on the canvas (编剧室会议 node). Approve the budget once (settings card, or `canvas_auto_budget` + `canvas_auto_generate` from chat) and videos are generated per storyboard, ending with a final-cut node. All gates still apply (bible-first, storyboard quality…), and the canvas must stay open during generation — the runner opens it for you and reports honestly if it cannot.
135
+ Settings → 「自动创作(实验)」→ on (the switch is all Settings keeps). Start from the **Production console** (left icon rail; auto creation + batch run in one panel) or one sentence in the chat (e.g. 拍个悬疑短剧,快递员每天送的信来自未来) — the writers room runs: research → two independent pitches → cross-critique → producer decision → bible → script → per-scene storyboards → **budget sheet**. No questions are asked in this mode; the transcript lands on the canvas (编剧室会议 node). The console shows the live phase/budget, lets you tick scenes to generate, and handles approve/generate/abort; or use `canvas_auto_budget` + `canvas_auto_generate` from chat. The video unit price is set in chat (`canvas_production_set_price`, e.g. "set video price to 0.5 yuan/second") and shared by the auto budget sheet and batch estimates. All gates still apply (bible-first, storyboard quality…), and the canvas must stay open during generation — the runner opens it for you and reports honestly if it cannot.
136
136
 
137
137
  ### 4. Manual fine-tuning: nodes are the workbench
138
138
 
@@ -136,7 +136,7 @@
136
136
 
137
137
  ### 3.1 自动创作(实验)——一句话到分镜 + 预算单
138
138
 
139
- 设置 → 「自动创作(实验)」→ 开启。然后在对话里说一句话(例如:拍个悬疑短剧,快递员每天送的信来自未来),即启动编剧室:调研 → 编剧A/B 独立提案 → 互评 → 监制决策 → 设定集 → 剧本 → 逐场分镜表 → **预算单**。该模式**不会向用户提问**;讨论记录落在画布「编剧室会议」节点。预算单批准一次(设置卡,或对话里 `canvas_auto_budget` + `canvas_auto_generate`)后逐分镜表生成视频,最后建成片节点。所有闸门照常生效(设定集先行、分镜质量……);生成期间画布需保持打开——runner 会替你自动打开,打不开时如实汇报。
139
+ 设置 → 「自动创作(实验)」→ 开启(设置里**只有这个开关**)。启动入口有两个:左侧图标栏的「创作台」(自动创作 + 批量执行统一面板),或在对话里说一句话(例如:拍个悬疑短剧,快递员每天送的信来自未来)即启动编剧室:调研 → 编剧A/B 独立提案 → 互评 → 监制决策 → 设定集 → 剧本 → 逐场分镜表 → **预算单**。该模式**不会向用户提问**;讨论记录落在画布「编剧室会议」节点。创作台里可以看实时阶段/预算单、按场勾选要生成的部分;预算单批准一次(创作台,或对话里 `canvas_auto_budget` + `canvas_auto_generate`)后逐分镜表生成视频,最后建成片节点。视频每秒单价在**对话**里设置(`canvas_production_set_price`,如"设置视频单价 0.5 元/秒"),自动预算与批量执行估算共用。所有闸门照常生效(设定集先行、分镜质量……);生成期间画布需保持打开——runner 会替你自动打开,打不开时如实汇报。
140
140
 
141
141
  ---
142
142
 
@@ -0,0 +1,63 @@
1
+ # 宿主无关化(Host-agnostic)
2
+
3
+ > 本文说明 0.21.0 的边界:**核心(core)不绑定 DeepSeek Harness**;独立画布服务 / MCP / CLI 由
4
+ > `multi-host-adapters` 分支承载,主 npm 包不重复打包一套 server。
5
+
6
+ ## 1. Core 契约(本仓 `index.js`)
7
+
8
+ `apply(ctx)` 只强制依赖三个成员:
9
+
10
+ | 成员 | 用途 | 缺失时 |
11
+ | --- | --- | --- |
12
+ | `ctx.effect(fn)` | 同步执行注册并收集清理函数 | 必需 |
13
+ | `ctx.tools.register(def)` | 注册 `canvas_*` 工具(当前 34 个) | 有守卫,缺失则跳过工具面 |
14
+ | `ctx.webServer.register(route)` | 注册 9 条 `/infinite-canvas/api/*` 路由 | 必需 |
15
+
16
+ 可选增强服务(缺失只降级,不抛错):
17
+
18
+ - `ctx.get('llm')`:文本模型;缺失时相关 RPC 返回「llm 服务不可用」。
19
+ - `ctx.get('skills')`:技能包;缺失时跳过技能注册。
20
+ - `ctx.get('attachments')` / `ctx.attachments`:视觉拉片的图片附件;缺失时拉片明确报错。
21
+ - `ctx.get('workspaceRegistry')`:工作区项目;缺失时 watcher 跳过。
22
+ - `ctx.get('sessionController')` / `ctx.get('agents')`:自动创作多 Agent 探针;缺失时 `multiAgent:false`。
23
+
24
+ 自检:
25
+
26
+ ```bash
27
+ node scripts/test-host-contract.mjs
28
+ # ✓ 宿主契约通过(最小 ctx 同步注册 34 工具 / 9 路由;增强服务缺失可降级)
29
+ ```
30
+
31
+ ## 2. 独立画布服务 / MCP / CLI
32
+
33
+ 实现位于 **`multi-host-adapters` 分支(0.3.3)**,运行时零 npm 依赖:
34
+
35
+ | 文件 | 作用 |
36
+ | --- | --- |
37
+ | `adapters/shared/host-adapter.cjs` | 伪造最小 ctx,加载 core,收集 tools / routes |
38
+ | `adapters/shared/canvas-web.cjs` | 本地 HTTP 画布服务(React UMD 壳 + `/api/rpc`) |
39
+ | `adapters/shared/canvas-mcp.cjs` | MCP stdio server(initialize / tools/list / tools/call) |
40
+ | `adapters/shared/HOST-CONTRACT.md` | 逐条依赖面与实测契约 |
41
+
42
+ 开发态启动(core 指向本仓):
43
+
44
+ ```bash
45
+ node adapters/shared/canvas-web.cjs --core-dir <path-to-dsh-infinite_canvas> --port 3210 --open
46
+ node adapters/shared/canvas-mcp.cjs --core-dir <path-to-dsh-infinite_canvas> --port 3210
47
+ ```
48
+
49
+ 已验证:该 adapter 对 **0.21.0 dev 核心**可同步收集 **34 个工具 / 9 条路由**;画布 UI 由
50
+ `canvas-web.cjs` 自带,core 不注册 HTML 面板路由。
51
+
52
+ ## 3. 分发边界
53
+
54
+ - **主 npm 包**(`@ninkch/dsh-infinite-canvas`):Harness 插件本体,轻量、无 server/vendor。
55
+ - **adapter 发行物**(VSIX / Qoder / WorkBuddy zip):随 `multi-host-adapters` 分支单独构建,
56
+ 内置 core 副本与 React vendor。
57
+ - 两条线共享同一套数据根与本地成果物;Agent 只负责传话/取件,画布资产仍在用户本地。
58
+
59
+ ## 4. 为什么不把 server 搬进主包
60
+
61
+ 1. 主包已由 Harness 提供面板与 webServer;再带一套 HTTP server 会造成双实例/端口冲突。
62
+ 2. adapter 需要自带 React UMD 与宿主探针,体量属于独立发行物。
63
+ 3. 分支已通过独立回归(`test-adapters-*`);主包只维护 core 契约,避免两套实现漂移。