NovelForge Studio

产品体验  创作工作台  低运行开销

NovelForge Studio 是 NovelForge Core 之上的产品体验层。Phase 1、Phase 2A、Phase 2B 已经建立产品模型、安全投影和 portable Host Bridge。Phase 2C 现在已经包含一个真实可构建的只读 SolidJS application shell：TypeScript + Vite + @solidjs/router，消费 Story Loom v2 和通过 config 按需生成的 zero-runtime-JavaScript WeiUI CSS foundation。

Local Web 是一等产品面；当目标是最低增量 CPU/RAM 时，它也是首选宿主。Tauri 继续作为未来 optional/installable host，而不是产品语义中心。

权威边界 ✦ Studio 只消费 NovelForge Core 状态。UI state 不是 Canon、Memory、semantic truth、write authority，也不是第二套 workflow engine。

English

产品架构

• English
• 简体中文
• portable_product_contract.json —— one-product/many-hosts delivery contract。
• host_bridge_contract.json —— public read-only Host Bridge allowlist。
• ../assets/brand/weiui.integration.json —— exact WeiUI source pin 与 generated-bundle contract。
• ../assets/brand/story-loom.weiui.css —— live Story Loom wui-theme layer。

规则保持简单：Core 拥有 truth；Studio 拥有 presentation 与 transport。 Core 尚未提供的公共 primitive 会明确保持 unavailable，而不是在 UI 中重造一套。

Phase 1 · Run / Context Inspector prototype

• prototypes/run-context-inspector.html —— 零依赖只读 Inspector prototype。
• fixtures/run-receipt.synthetic.json —— 仅用于 visual / interaction QA 的 synthetic receipt。

第一版原型建立了一个关键 observability 区分：语义选择认为能支撑问题的 evidence，不等于最终真正进入模型上下文的 evidence。

Phase 2A · 一个产品，多种宿主

NovelForge 产品语义面向四种一等交付方式：

• CLI —— 可脚本化的原生 inspection / automation。
• Local Web / local app —— low-overhead creator workstation。
• Cloud-hosted UI —— 相同产品模型置于远程 transport 后。
• Agent Skill / package —— 面向其他 Agent Framework 的 portable adapter。

不同宿主可以拥有不同 capability，但这些差异不能改变 Canon、Settlement、Context、semantic-result、readiness、publication 或 receipt semantics。Capability 不等于 authority。

Phase 2A Project Hub safe projection 位于 project_hub_projection.py，会清除 absolute host paths 并携带明确的 non-authority markers。

Phase 2B · Portable read-only Host Bridge

host_bridge.py 接收 novelforge_studio_host_bridge_request_v1，返回 fingerprint-bound novelforge_studio_host_bridge_result_v1。

当前真实支持的操作刻意保持很小：

• bridge.describe
• framework.doctor
• project.inspect
• capabilities.inspect
• context.inspect
• semantic.catalog

Runtime session/event/handoff reads、Run Receipt retrieval、resume、generic command invocation 与 project mutation 继续依赖 Core Issue #23。Studio 不会读取 private SQLite state 去伪造这些能力。

../agent-skills/novelforge/SKILL.md 使用相同 operation vocabulary，同时不 import 私有 Core runtime module。

Story Loom v2 · WeiUI config-generated foundation

Story Loom 继续拥有 NovelForge visual/product-semantic authority；WeiUI 拥有 generic CSS/token primitives。

Reviewed upstream exact pin 记录在 ../assets/brand/weiui.integration.json。Phase 2C 只消费 @weiui/tokens 与 @weiui/css；@weiui/react 和 @weiui/headless 继续禁止成为 Studio runtime dependency。

WeiUI 现在拥有正式的 build-time config layer。Studio 在 app/weiui.config.json 中声明实际需要的 generic UI surface：

weiui.config.json
→ exact-pinned @weiui/css config/bundle manifest
→ dependency-closed minimal CSS
→ checked-in vendor CSS + token CSS
→ Story Loom wui-theme
→ SolidJS product surface

Generated files 会直接 checked in，因此普通 Studio runtime 不需要 Node、WeiUI checkout 或 bundler。sync_weiui.py 在 CI 中基于 exact upstream pin 做 byte-for-byte regeneration verification。

Baseline design/runtime constraints 继续由 machine gate 强制：

• en-US + zh-CN；
• mobile-first、phone focus-first composition；
• minimum 44px touch target；
• logical CSS properties 与 text-expansion-safe layout；
• reduced-motion support；
• no idle decorative animation；
• no default polling；
• zero WeiUI browser JavaScript。

Phase 2C · 真实 SolidJS product shell

Application source 位于 app/。

Core public boundary
→ studio/host_bridge.py
→ studio/local_server.py
→ typed /api/bridge/invoke transport
→ SolidJS + TypeScript + Vite + @solidjs/router
→ config-generated WeiUI CSS + Story Loom theme

当前只读 shell 已经包含：

• Desk —— bridge status、supported/deferred operation counts、current project summary。
• Project Hub —— 真实 project.inspect safe projection。
• Scene Workspace —— 在 Core 暴露可信 current-scene/content projection 前明确 unavailable；不使用 fixture 或 filesystem inference 冒充当前场景。
• Context Inspector —— 真实 context.inspect，manifest/overlay 只接受 project-relative paths。
• Host Capabilities —— 真实 capabilities.inspect；进入 route 时取一次，此后只有显式 Refresh 才再次请求。
• Semantic Catalog —— 真实 semantic.catalog；同样没有 polling。
• Framework Diagnostics —— 用户显式触发 framework.doctor。
• Command palette —— operation vocabulary 来自 live bridge.describe；deferred Core operations 会显示依赖原因，而不会表现成可执行命令。

App 默认没有 interval polling、WebSocket heartbeat、Redux-like second state store，也不把 project truth 持久化到 browser storage。Project root 只是当前页面 session 的 presentation state。

Local server

local_server.py 是 stdlib-only transport。它：

• 只 bind 127.0.0.1；
• 启动时生成 ephemeral token 并注入 served app；
• 检查 Host / Origin / Sec-Fetch-Site；
• API 只暴露 POST /api/bridge/invoke；
• 拒绝 CORS preflight；
• request body 上限 128 KiB；
• 没有 write / Canon / Settlement authority；
• 没有 polling 或 background refresh。

构建后运行：

cd studio/app
pnpm install --frozen-lockfile
pnpm build
cd ../..
python studio/local_server.py

Server 会打印 loopback URL，不会自动拉起浏览器。

性能纪律

Phase 2C 把性能当成 acceptance condition，而不是后期优化项。CI 会检查 raw JS/CSS budget；产品 routes 使用 lazy loading；初始 shell 不引入 heavy editor/runtime libraries。

首轮 production build 的 main Solid/router JS chunk 只有几十 KB raw，各 route chunk 为低个位数 KB。真正的 target-host idle CPU/RAM 仍必须实测后，才能称 desktop wrapper production-ready；bundle size 不能冒充 runtime measurement。

当前与 Studio 直接相关的 Core 能力

novelforge_production_readiness_v1 让 Review 拥有真实 same-fingerprint conjunction gate，而不是虚构的 quality percentage。

novelforge_publication_ir_v1 + publication/compiler.py 提供 Accepted text → clean text、Web HTML、print-oriented HTML/CSS、EPUB 3.3 的 deterministic compilation。更丰富的 Publication Studio 仍然只能建立在 Core 实际存在的 contract 上。