Writing 时序图

状态：legacy current reference。本文的 v1 时序记录已由 ./v2/product-requirements.md 中的 current 流程与时序替换；新增时序只写入 v2 文档。

更新时间：2026-06-30 状态：legacy current reference；current 时序以 ./v2/product-requirements.md 和 ./v2/content-factory-plugin-reframe.md 为准

1. 插件中心安装态展示

sequenceDiagram
  autonumber
  participant User as 用户
  participant Page as 插件中心
  participant Cloud as Cloud Marketplace
  participant Installed as Installed Registry
  participant Contract as Plugin Contract

  User->>Page: 打开插件中心
  Page->>Cloud: 拉取 marketplace
  Cloud-->>Page: 可能返回 401/403
  Page->>Installed: 读取本地已安装插件包
  Installed-->>Page: content-factory-app
  Page->>Contract: projectPluginRegistryFromInstalledPackages
  Contract-->>Page: typed Skills / MCP / activation projection / readiness
  Page-->>User: 展示内容工厂和能力详情

2. @写文章 激活

sequenceDiagram
  autonumber
  participant User as 用户
  participant Composer as Claw 输入框
  participant Registry as Plugin Registry
  participant Intent as Intent Resolver
  participant Runtime as App Server Runtime

  User->>Composer: 输入 @写文章 写一篇文章
  Composer->>Registry: buildPluginActivationMentionCatalog
  Registry-->>Composer: 内容工厂 typed activation entry
  Composer->>Intent: resolveWorkspacePluginIntent
  Intent-->>Composer: content_article_generate + plugin contract
  Composer->>Runtime: agentSession/turn/start + plugin_activation metadata
  Runtime-->>Composer: turn started

3. 写作 workflow 执行

sequenceDiagram
  autonumber
  participant Runtime as App Server Runtime
  participant Projection as Workflow Projection
  participant Research as content-researcher
  participant Strategy as content-strategist
  participant Writer as article-writer
  participant Editor as copy-editor
  participant Image as image-planner
  participant Store as Artifact / Read Model

  Runtime->>Projection: content.article.generate
  Projection->>Research: 搜索主题和事实
  Research-->>Projection: research notes
  Projection->>Strategy: 生成角度和大纲
  Strategy-->>Projection: brief + outline
  Projection->>Writer: 写正文
  Writer-->>Projection: markdown draft
  Projection->>Editor: 审稿校对
  Editor-->>Projection: revised draft + issues
  Projection->>Image: 规划配图
  Image-->>Projection: image slots + prompts
  Projection->>Store: workspace patch + runtime evidence
  Store-->>Runtime: articleDraft artifact refs

4. ArtifactFrame 到右侧 Article Editor

sequenceDiagram
  autonumber
  participant Runtime as App Server Runtime
  participant Chat as Message List
  participant Frame as ArtifactFrame
  participant Surface as Right Surface
  participant Editor as Article Editor

  Runtime-->>Chat: 先下发任务卡 / 对话流过程态
  Chat-->>User: 在对话流展示检索、skills 编排和写作过程
  Runtime-->>Chat: articleArtifacts / workspace patch
  Chat->>Frame: 创建独立产物框
  Runtime-->>Frame: 流式写入最终文章内容
  Frame-->>Chat: objectRef / artifactRef
  User->>Frame: 点击打开
  Frame->>Surface: openArticleArtifact(articleDraft)
  Surface->>Editor: render articleDraft
  Editor-->>User: 展示可编辑正文、结构、引用、配图和动作

5. 历史恢复

sequenceDiagram
  autonumber
  participant User as 用户
  participant Sidebar as 历史列表
  participant Runtime as agentSession/read
  participant Workspace as Plugin Workspace
  participant Surface as Right Surface

  User->>Sidebar: 打开历史写作会话
  Sidebar->>Runtime: read session
  Runtime-->>Sidebar: messages + artifacts + plugin workspace
  Sidebar->>Workspace: hydrate content-factory Article Workspace facts
  Workspace-->>Sidebar: selected articleDraft
  Sidebar->>Surface: open articleArtifact(articleDraft)
  Surface-->>User: 恢复右侧文章草稿

6. 继续改写

sequenceDiagram
  autonumber
  participant User as 用户
  participant Editor as Article Editor
  participant Action as Surface Action Router
  participant Runtime as App Server Runtime
  participant Worker as Content Factory Worker

  User->>Editor: 点击继续改写
  Editor->>Action: revise(articleDraftRef, instruction)
  Action->>Runtime: agentSession/action/respond
  Runtime->>Worker: content.article.revise
  Worker-->>Runtime: updated articleDraft artifact
  Runtime-->>Editor: 新版本 / workspace patch