Skip to content

Latest commit

 

History

History
87 lines (67 loc) · 8.86 KB

README.md

File metadata and controls

87 lines (67 loc) · 8.86 KB

本系列属于河图洛书 Hetu Luoshu,产品全局规范见文档总入口。

河图洛书创作插件体系设计

版本:0.1;日期:2026-11-16;状态:已采纳技术方向的产品与实施设计基线。

本系列研究如何让小说、剧本和视频创作能力按需组合,形成作者与外部 Agent 共同使用的、可持续积累的创作工作环境。河图负责作品、确定性操作、可视化与作者决定;理解、规划和生成由作者选择的外部 Agent 完成。

简介

核心主张:河图需要有足够深的创作结构、操作能力和可视化表达,让作者和 Agent 都能围绕整部作品工作。

插件是创作能力的交付单元,可以贡献数据、动作、视图、方法和连接。套件组织多项能力服务具体创作场景;自由成果承载当前作品中的特殊表达。默认体验保持易读易用,需要深度工具的人可以逐步展开。

本系列包含需求和拟议合同,不是插件系统已经上线的声明。已有能力以实际能力发现、contracts/ 和实现基线为准;现有创作工作台的工作包与进度继续由38维护。

安装启用后的插件通过公开SDK复用核心服务,不另申请插件作品权限。核心分层、兼容及审计见27;领域与本体语义归主28。

角色分流

角色或问题 阅读路线
理解背景、机会与长期方向 01 → 02 → 03
了解插件分类及服务哪些人 04 → 05 → 06
开放SDK与宿主核心能力 27 开放宿主SDK与核心能力审计 → 主28 → 20 → 21
评审架构、数据和机器入口 07 → 08 → 09 → 12
评审Cordis采用、自主维护和DSH兼容 26 → 16 → 20
开发插件和动态界面 22 → 20 → 21 → 10 → 11 → 15
发布版本、申请上架与维护 23 → 24 → 13
评估首个小说规划插件 25 → 22 → 20
评审小说生态全周期与现有插件专业深度 29 小说插件生态调研与复刻路线 → 逐项候选索引
规划生态、商业与落地 13 → 14 → 15 → 16

快速上手

先阅读背景与第一性原理,再根据具体任务进入下表。工程示例在 examples/,仅用于评审和验证设计,不应直接交给现有 CLI/MCP 执行。

编号 文档 唯一负责的内容
01 背景与第一性原理 问题推导、生成式 UI 的成本假设、产品价值和战略边界
02 产品与生态调研 开源与商业产品证据、dsh/Pi/A2UI、适用边界和调研缺口
03 产品需求 PRD 目标、范围、需求编号、非功能要求和指标
04 插件分类与能力地图 分类维度、能力目录、套件组合和依赖规则
05 用户需求故事与用例 用户任务、故事、主流程、异常流程和作者决定
06 信息架构与交互设计 导航、工作面、操作层次、页面状态和跨端回退
07 总体架构与技术选型 系统与运行架构、模块职责、技术比较和约束
08 领域模型与数据设计 数据 Owner、文件权威、ERD、索引数据库及事务
09 应用 API 与机器协作合同 拟议动作、Schema、错误、幂等和 CLI/MCP/Skills 映射
10 插件包 SDK 与生命周期 包结构、注册合同、依赖、安装升级和开发验证
11 动态渲染与自由成果设计 多种表达方式、数据桥接、声明式界面和 A2UI 演进
12 安全权限与兼容策略 授权、隔离、内容外发、兼容和恢复边界
13 生态分发与商业模式 供需机制、分发、质量、治理、开源与商业假设
14 首批插件与实施路线 试点范围、依赖、阶段交付和既有规范接入
15 测试验收与追踪矩阵 需求到用例、接口及验收的覆盖与取证
16 架构决策与风险登记 取舍、备选方案、风险、触发条件与待验证假设
17 原生宿主与插件渲染技术方案 DSH/Lime 源码证据、WKWebView/WebView2、跨端 SDK、加载及读写链路
18 桌面技术选型与迁移评估 已采纳技术分工、保留资产、迁移和退役门禁
19 现有架构审计与插件优先重构 源码事实、复用与缺口、UI重审及独立插件闭环
20 首期可执行合同与开发入口 当前包/数据/权限子集、桌面与机器入口、作者决定、图片成果、创作库及开发装配
21 核心格式与动态能力发现 稳定核心格式、河图插件与Agent接入边界、同一连接发现及热插拔用例
22 插件开发与调试指南 独立工程、脚手架、构建校验、机器调试、故障及最小验收
23 插件发布与上架指南 固定版本、制品、摘要、收录申请、审核与更新退出
24 插件目录与分发治理 DSH管理机制证据、GitHub/官网/本机分工、目录数据与准入
25 小说规划插件立项分析 产品定位、核心接口适配、数据责任、首版范围及验收
26 Cordis采用与DSH兼容边界 已采纳框架决定、公共SDK隔离、来源许可、维护退出、兼容等级与迁移门禁
27 开放宿主SDK与核心能力审计 开放核心服务、四层依赖、小说能力审计与SDK演进;本体语义归主28
28 插件Skills注册与发现 包内方法贡献、宿主目录、稳定资源读取、Codex发现及热插拔边界
29 小说插件生态调研与复刻路线 全索引研究、逐项分流、创作周期能力域、四插件专业深化及新增包路线
30 官网插件宣传图规范 用途辨识、主题插画、真实工作面、响应式制品及来源维护

| 29 | 小说插件生态调研与复刻路线 | DSH小说研究、固定来源、能力归属与首批方案导航 |

边界

  • 本系列扩展创作工具的可组合性,专业插件不自建Agent引擎、聊天宿主或自主生成循环;外部MCP App及独立桌面会话由主27和主39统一设计。
  • 画布、导演台和多轨界面可以提供深度能力,作者按需使用;正常机器业务不依赖 GUI 点击。
  • 插件数量、市场收录数、能安装、能加载、内容质量、实际采用分别衡量。
  • 作品文件继续作为权威,首期JSON标题投影可重建,SQLite设计用于后续规模评估;授权与本机安装记录在私密本机存储中单独持有。
  • 当前源码中的类名、路径和动作属于实现事实;本系列中的新类型、包字段、路径和动作属于拟议合同,须经过实施与验收才能发布。

协作方式

新增需求使用 PFR,故事使用 PUS,用例使用 PUC,验收使用 PAC,API 使用 PAPI,架构决策使用 PADR。编号在对应 Owner 文档定义,通过15追踪,避免与主系列编号混淆。

外部证据索引见02及 research-sources.json。研究结论不能直接替代用户访谈或实际产品测试。采纳到现行产品合同时,按14列出的联动清单同步主规范、机器合同和实施计划,保留原有作品与历史引用。

首期源码实现的合同、权限子集与持久化入口见20。