docs: finalize AI Design feedback integration

This commit is contained in:
2026-09-04 10:20:44 +08:00
parent 3bda17aa3c
commit aa3f52a8f8
4 changed files with 115 additions and 1 deletions

View File

@@ -26,7 +26,7 @@ Makelore 是 Electron 桌面客户端。Renderer 负责项目操作与状态展
| Official Hosted Plugins | Acquired code-owned bundled Game Resource package → effective parent snapshot → code-owned Main adapter → fixed Works Square hosted route | 无设备下载、更新、Beta 或签名步骤Renderer/Package/Pi 不持有 Provider key、model 或 URL。每次计费操作要求显式确认child 不继承 hosted tool。历史 Hosted Web Search 不再进入当前客户端。 |
| Device Packages | Conversation install tools → Main-owned inspect/preview/confirm/commit → immutable local generation → parent Skill/Pi-extension resources | 支持 npm、Git、绝对本地 Plugin 目录与 loose `SKILL.md`没有可见安装入口、Account Library、Release、Admission 或 Marketplace Package Store。可执行 extension 拥有桌面用户权限且生命周期脚本禁用。每个 generation 包含所有显式安装且当前启用的 Skill/extension新/idle parent 自动刷新active parent 在 turn settled 后刷新child 始终为空。 |
| AI Design Workspace & Living Form | 一个 Workspace 的当前 Direction、Current Specification、持久 Agent Session、conversation timeline、Tasks 与 Assets | 自然对话是主创作面Living Form 仅以“AI 已理解”的紧凑辅助摘要与可选手动调整投影服务端 Current SpecificationRenderer 只持有草稿和已接受投影 |
| AI Design Input & Reconciliation | Chat、字段/集合编辑、decision、proposal、lock、Asset binding 与 restore | 全部进入同一 `design.input.apply` reducer稳定 command/operation ID 支持 unknown-result 重放revision conflict 刷新权威状态 |
| AI Design Input & Reconciliation | Chat、字段/集合编辑、decision、proposal、lock、Asset binding 与 restore | 全部进入同一 `design.input.apply` reducer稳定 command/operation ID 支持 unknown-result 重放revision conflict 刷新权威状态;待提交 chat 从同一 pending operation 临时投影raw assistant delta 保持内部且不生成对话区进度栏 |
| AI Design Gateway Routing | Main-owned Works Square V2 adapter 与 Direction event stream | Main 持有 Works Token、stream ticket、WebSocket、重试分类和错误脱敏事件顺序与 Task progress 不构成 Specification 真值 |
| AI Design Quote & Task Controls | 精确 Specification revision 编译出的不可变 Quote 与 Workspace Tasks | 客户端只展示 public output summary、warnings、expiry 与 Token Points并以 Quote ID 确认Provider Prompt/model/route/storage/billing atoms 不下发 |
| AI Design Assets | Workspace 已完成作品或本地上传的真实 Asset | Asset 通过 typed binding 写入 Specification生成结果经 Main-owned asset download 保存 |
@@ -88,6 +88,8 @@ Makelore 是 Electron 桌面客户端。Renderer 负责项目操作与状态展
- Main 通过 `design.input.apply``design.quote.request``design.generation.confirm` 访问 V2。unknown transport result 必须复用原 command/operation identity结构化业务错误不得重放未知上游文本不得穿透安全投影。
- Main-owned Canvas Workspace JSON 请求和 shared Works token refresh 的完整生命周期最多 30 秒,超时 abort transport 并以固定 `504 DESIGN_WORKSPACE_REQUEST_TIMEOUT` 结束 Renderer 等待。Electron `net.fetch` 失败后的 Node fetch 透明回退只允许 `GET``HEAD``OPTIONS`PATCH/POST 等 mutation 只允许由持有显式幂等身份的上层协议决定重试,不能由底层 transport 隐式重放。该边界不改变上面的 WebSocket→REST 幂等 fallback。
- Renderer 的异步与流式结果必须核对 Workspace、Direction、revision 和 operation identityDirection snapshot 是 Specification 真值Task/Asset 事件只更新 Workspace resource projection。
- 待提交 chat 可以从现有 pending operation 立即投影为明确标注“发送中/正在确认”的用户气泡,但只有服务端 canonical turn 能进入对话历史;确定失败必须恢复原草稿,不能另建一套消息状态或新业务意图。
- `design.assistant.delta` 是未完成的内部传输状态不是助手回复。Renderer 不得显示原始片段,也不得在对话区为它创建独立整理进度栏;右侧 Current Specification 投影继续呈现 AI 当前理解。重叠连接与重放 chunk 必须按连接 generation 和 `chunkIndex` 收敛。
- 确认生成只提交不可变 Quote ID。Task 事务已提交但事件迟到时可刷新 Workspace projectionTask progress 不得改写 Living Form 或授权新的生成操作。
- Updater feed 选择、原始错误日志、下载和安装生命周期只属于 Electron Main。Renderer 不得把缺失稳定 manifest 投影为“已是最新版”也不得显示原始堆栈、URL、路径或错误码并发检查共享同一错误事件时只发送一次错误状态后续独立重试仍可重新报告。
- 图片与视频复用同一个单图来源选择器。图片 Brief 可从当前 Workspace 的已完成作品或本地上传中选择一张参考图继续生成;视频 Brief 使用同一入口绑定首帧。两条路径都必须通过现有 Workspace Asset 上传/选择契约提交一个真实 `attachmentAssetIds`,不得用本地路径或自然语言描述代替资产身份。

View File

@@ -4,6 +4,25 @@ This file is the integrated default-branch snapshot. Feature tasks record progre
## Integrated Through
- AI Design conversation-feedback sources
`403236115bf81e7617856cd8219b1be23f6abbb8` from task
`20260904-design-summary-separation-9c4e7a21` and
`3bda17aa3c1d034ddb3feaa08e516398e91cba0a` from task
`20260904-remove-design-progress-4e8a1c73` are integrated onto local `main` and
canonically reconciled by task `20260904-finalize-design-feedback-7c4e2a91`. A
submitted chat appears immediately as a provisional user bubble from its existing
pending operation, shows `发送中` or `正在确认`, restores the retained draft after
definitive failure, and is replaced by the canonical Workspace turn without a
second message store. Raw `design.assistant.delta` text remains internal transport
state: it is neither a finished reply nor a visible progress banner. The right-side
“AI 听懂的想法” remains the single organized-understanding projection, while
connection generation fencing and `chunkIndex` deduplication still converge repeated
streams. Current Specification, immutable Quote confirmation, server/Main contracts,
plugins, packaging, deployment, publication, and paid Provider behavior are
unchanged. Source verification passed focused/adjacent tests, typecheck, scoped
lint, production build, and both existing AI Design Electron checks individually;
the banner-removal follow-up passed its focused 10-test file, typecheck, and scoped
lint.
- Conversation-first AI Design client source
`fe50e4ba198649a07c5c9443f15edf7dfa2a47e6` from task
`20260903-design-guided-conversation-client-8b4e1c72` is integrated onto local
@@ -551,6 +570,8 @@ This file is the integrated default-branch snapshot. Feature tasks record progre
AI Design Canvas 现在默认以对话和一张持续可见的“我的创作”卡服务 8-16 岁创作者;专业字段矩阵收进按需打开的“精细调整”,移动端保持对话优先并只挂载一个卡片/底部面板。Creation Card、精细调整、Quote、Task 与结果提示都只投影权威状态,已知问题按 code 转成通俗中文,未知服务端或 Provider 文本不会直接显示。一个 Workspace 仍只公开一个 current Direction、一个 persistent Agent Session 和一个 Current Specificationconversation timeline 只记录交互历史。Chat、direct edits、decision responses、proposal acceptance、locks、Asset binding 与 restore 都通过 `design.input.apply` 进入同一服务端 reducerRenderer drafts 在 accepted 前保持本地。Main 持有 Works Token、stream ticket、WebSocket、request deadline、stable command/operation IDs 与错误脱敏unknown result 只能复用原 identity结构化业务错误不得重放。Generation 由服务端对 exact Specification revision 编译 immutable Quote客户端只展示 public output plan、warnings、expiry 与 Token Points并以 Quote ID 调用 `design.generation.confirm`Provider Prompt、model、route、storage 和 billing atoms 不进入 Renderer。Task/Asset events 独立收敛 Workspace resources不改写 Living Form。Development 与 packaged builds 均使用 Works Square V2V1 DTO、local semantic adapter、mutable Quote PATCH 与 editable provider Prompt 已移除。
新提交的 Design chat 会立即从现有 pending operation 投影为带“发送中”或“正在确认”的临时用户气泡,服务端确认的 canonical turn 到达后再替换它;确定失败时原草稿重新出现在输入框。`design.assistant.delta` 只作为内部传输与收敛状态,不显示原始片段,也不在对话区生成独立整理进度栏;右侧 Current Specification 摘要继续承担“AI 当前听懂的内容”。重复连接和事件按 connection generation 与 `chunkIndex` 收敛。
Canvas 侧栏提供“获取灵感”进入 Prompt Museum。列表、筛选、分页、详情、作者/来源/许可证和图片地址全部由服务端经 Main-owned Host API 提供,客户端不打包静态数据集;服务端相对媒体只允许固定 `/api/image-prompt-museum/{entry}/media/{thumbnail|number}` 形状,并由 Main 注入 Works Bearer、执行一次 401 刷新、可信 raster MIME 与 10 MiB 上限后转为 Renderer data URLcredential-free HTTPS CDN 图片保持直连。图片失败只显示卡片内占位,不阻断卡片或详情;缺少来源 URL 时显示纯文本。“使用此 Prompt”只把原文带回当前 Canvas 输入框,不自动发送。该模块不是投稿、点赞、评论或排行榜社区。客户端契约已就绪,但不据此宣称 Works Square 内容后台和生产数据已经部署。`pnpm run dev` 现在默认使用云端 Canvas 适配器,本地适配器只能通过显式开发命令启用;产品 UI 只保留中文。
密码登录提供可选“记住密码”。该记录与七天登录会话分离,只在正式安装包且系统安全存储可用时由 Electron Main 加密落盘Renderer 仅在登录页内存中接收回填,不写 Zustand/localStorageWorks Square 也不持久化桌面密码。退出登录和短信登录不删除记录,成功的未勾选密码登录会清除旧记录。未打包开发版禁用该选项,避免未签名 Electron 调试进程触发 macOS 钥匙串。

View File

@@ -0,0 +1,89 @@
# Task: Finalize AI Design conversation feedback integration
## Identity
- Task ID: 20260904-finalize-design-feedback-7c4e2a91
- Mode: Integration
- Branch: main
- Worktree: D:\Datas\OthersProjects\makelore
- Base commit: 3bda17aa3c1d034ddb3feaa08e516398e91cba0a
- Owner: codex-root
- Status: Ready for Integration
## Scope
- Reconcile the already integrated AI Design conversation-feedback sources
`403236115bf81e7617856cd8219b1be23f6abbb8` and
`3bda17aa3c1d034ddb3feaa08e516398e91cba0a` into canonical current state,
architecture, and business rules.
- Record the final behavior: submitted user messages appear immediately with honest
pending status, raw assistant deltas remain internal, and the main conversation has
no assistant-progress banner because the right-side Current Specification projection
owns the organized understanding.
- Preserve the three adopted foreign untracked task records byte-for-byte. Do not add,
edit, move, stash, reset, clean, or commit them.
- Do not change product code, Works Square server, Electron Main/API contracts,
generation, billing, plugins, navigation, packaging, publication, remote history, or
paid Provider behavior.
## Intent And Constraints
- The user explicitly authorized recovery of the prior integration lock and made the
final presentation decision that the central progress banner is redundant and must
be removed rather than restyled.
- Client `main` already contains both source records and product changes at exact base
`3bda17aa3c1d034ddb3feaa08e516398e91cba0a`; this task performs canonical integration
only, so the document drift boundary does not need to cross another task's record.
- ADR-007 remains accepted. Current Specification is still server authority, its
right-side projection remains auxiliary UI, provisional user messages remain pending
projections, and only canonical turns enter conversation history.
- The newer source narrows the older optional progress presentation: raw assistant
deltas stay internal and invisible. The user's explicit instruction resolves that
semantic conflict.
- Concurrent Task Gate and Integration Planning Gate passed. Relevant source tasks are
Ready for Integration; other active work remains isolated and does not alter this
exact final behavior.
## Outcome
- Canonically recorded both integrated conversation-feedback sources on client `main`
at product frontier `3bda17aa3c1d034ddb3feaa08e516398e91cba0a`.
- The main conversation no longer renders raw assistant delta text or an independent
“AI 正在整理你的想法” progress banner. The right-side Current Specification summary
is the single organized-understanding surface.
- Immediate provisional user bubbles, `发送中` / `正在确认`, canonical turn replacement,
draft recovery, connection-generation fencing, and `chunkIndex` deduplication remain
intact.
- Updated canonical current state, system architecture, and business rules without
changing ADR-007, product code, server/Main contracts, immutable Quotes, navigation,
plugins, packaging, billing, or remote history.
- The earlier root lock and one transient wrong-base integration lock were recovered
under the user's explicit authorization. Each uncommitted document edit was restored
before release; the three adopted foreign files remained unchanged throughout.
## Verification
- Product source commit `3bda17a` has exact parent
`403236115bf81e7617856cd8219b1be23f6abbb8`; its changed paths are limited to the
source task record, `DesignConversationPane`, and its focused test.
- Root focused Renderer test passed: `pnpm exec vitest run
tests/unit/image-canvas-page.test.tsx` → `1 file / 10 tests`.
- Root TypeScript `pnpm exec tsc --noEmit` passed.
- Root scoped ESLint for the changed component and test passed.
- Root product paths matched source `3bda17a` exactly and `git diff --check` passed
before canonical documentation.
- The earlier conversation-feedback source retains its adjacent 51-test,
production-build, and individual Electron evidence; this final integration did not
repeat those broader checks for a presentation-only removal.
## Follow-ups
- Build and publish a new Makelore client version before expecting installed users to
receive this UI change. Packaging, deployment, publication, and remote push are not
part of this integration.
## Promotion Candidates
- Applied the two source promotion candidates to `current-state.md`,
`system-overview.md`, and `business-rules.md` using the user's final presentation
decision. No unresolved promotion candidate remains.

View File

@@ -99,6 +99,8 @@
- AI Design 必须以自然对话帮助用户描述清楚需求:先提取和复述已明确内容,每次最多推进一个真正影响作品的问题。客户端 Current Specification 投影是辅助摘要和可选手动调整,不得把内部字段、缺项或普通 Decision Prompt 变成用户必须逐项填写的表单。
- 每个 mutation 使用稳定 command 与 semantic operation identity。transport-unknown 只能重放原命令business rejection、timeout 或用户再次点击不能自动生成新的业务意图。
- Direction projection 是 Specification 真值。event cursor、assistant delta、Task progress 与 Asset event 只用于传输/资源收敛,不得推进或覆盖 canonical specification revision。
- 用户提交 chat 后,客户端可以立即把同一个 pending operation 投影为临时用户气泡,并明确显示“发送中”或“正在确认”;只有服务端返回的 canonical turn 才进入 conversation timeline。确定失败时必须让原草稿重新可编辑不得把临时投影持久化为第二条消息。
- `design.assistant.delta` 只用于内部传输和结果收敛原始片段不得作为完成的助手回复展示对话区也不得为其增加独立的整理进度栏。AI 当前整理出的设计理解由右侧 Current Specification 投影承载;连接重叠或事件重放按 connection generation 与 `chunkIndex` 去重收敛。
- Main 只向 Renderer 投影已知错误码的固定中文提示未知上游错误文本必须脱敏为通用提示Works Token、stream ticket、provider internals 留在 Main/服务端。
- AI 绘画 Workspace JSON 请求与 shared Works token refresh 必须覆盖取凭据、发请求和读取响应 body 的完整 30 秒 deadline即使底层 transport 忽略 abort调用方也必须确定性结束为 `504 DESIGN_WORKSPACE_REQUEST_TIMEOUT` 并释放共同等待者。Electron-to-Node 透明 fallback 仅允许 `GET`/`HEAD`/`OPTIONS`mutation 不得因 transport failure 被隐式重放,任何重试必须由上层显式幂等合同授权。
- `design.quote.request` 必须绑定 exact current Specification revision 并返回 immutable Quote任何 production-meaning edit 都需要新 revision 与新 Quote。