Skip to content

Latest commit

 

History

History
102 lines (91 loc) · 12.6 KB

README.md

File metadata and controls

102 lines (91 loc) · 12.6 KB

本目录属于河图洛书 Hetu Luoshu,全局信息见根 README。

河图洛书 Hetu Luoshu 文档

文档版本:V1.0;日期:2026-11-16。本系列定义产品需求、领域、数据、接口、交互、工程与验收规范;外部依据统一维护于 research。

阅读路线

读者或任务 顺序
作者、编剧、产品 01 → 37 → 36 → 26 → 10 → 15 → 17 → 25
MCP/CLI/Skills 功能 Review 与 AI 导航 40 机器能力地图 → 机器可读索引
本轮重构跟进 38 → 20 → 19;工作包/实现基线/验收要求分别维护
下一版本创作与审阅体验 41 产品方案 → 研究依据 → 38 工作包;方案、实施与实测分别记录
资料、图片与短剧制作 37 → 35 → 09 → 29 → 30 → research/11 → research/13
核心领域、本体与插件边界 28 → 05 → 29 → 30 → 开放宿主SDK;维护规则见24
内核与数据开发 03 → 28 → 05 → 29 → 30 → 07 → 08 → 09
Electron与插件开发 39 → plugin/19 → plugin/07 → plugin/10 → 10 → 13 → 19 → 21
插件开发、发布与上架 开发调试 → 发布上架 → 目录治理
Cordis采用、框架自主性与DSH兼容 采用与兼容边界 → 架构决策;小说规划专业合同归独立插件文档
桌面平台适配 39 → 11/12 → 38 → 20
软件引导与持续 Agent 协作 01 → 27 → 23第40~44节 → 10 → 26 → 19第3.3节
Skills、MCP 与局部交互开发 27 → 14 → 30第23节 → 29第22节 → 18 → 04
交付与协作 16 → 17 → 19 → 20 → 21

图示与场景入口

需要评审的内容 入口
作者从创作库到阅读观看、协作和交付的完整路线 业务全程总览、用例关系
系统、模块、运行进程与信任边界 总体架构、系统图、运行部署图
三类独立对象、卷章、分集与实体关系 作品管理流程、内容归属 ERD
参考稿、采纳、中文编辑与独立定稿 审核状态、保存时序、采纳时序
MCP、Apps、浏览器与退出协作 接入与局部交互时序、接入设计、退出流程
稳定接入、持续参考稿、按需资料与反馈接续 ASCII 与架构图、接续合同、真实 Codex 验收
用户目标、异常分支和验收追踪 用户故事与用例、业务验收场景
每个用例对应的领域对象、应用合同与验收 逐用例追踪、架构视图
中文全文查找、历史引文与安全替换 检索流程、检索用例
稿件格式转换、固定版本与可恢复交付 导入时序、交付时序、交付合同
本机 MCP、服务端部署边界与设计还原 职责矩阵、部署边界图、实施顺序、设计规范、Figma 研究
采纳和独立定稿的确切接口与历史记录 应用 API、生命周期数据
资料分层、场景与生成候选交接 资料与资产 ASCII 图、制作时序与依赖图、图片模型研究
三类工作面、预演、音画、位置意见与完整交付 四份ASCII布局、架构及制作图、重构工作包
原创、改编和导入的完整场景 场景矩阵及流程、场景用例
改编价值、作者主张与中英市场区分 市场及创作者价值研究、官网内容规范

文档目录与事实归属

编号 文档 拥有的事实
01 产品需求 PRD 用户、边界、功能 ID、版本范围
02 架构选型与设计原则 技术选择、理由、代价与原则
03 总体技术架构 模块、依赖、运行单元
04 Monorepo 与开发规范 源码布局、依赖和共享来源
05 领域模型与数据合同 身份、版本、状态、引用
06 设定集与规则规范 设定集字段、锁定、规则语义
07 工作区与持久化设计 内容目录、事务、恢复
08 剧情抽取与一致性引擎 规则算法、覆盖、诊断
09 小说与短剧流水线 节点、骨架、改编与回溯
10 桌面与插件工作面交互设计 任务层级、贡献工作面、状态与可访问性
11 macOS桌面实施 Electron平台适配、应用身份和系统验收
12 Windows Electron实施方案 共同工作台、Windows系统适配与实机验收
13 进程通信、内核ABI与CLI合同 桌面RPC、保留ABI、独立CLI、错误与命令面
14 MCP 与 Agent 接入 工具、权限、MCP Apps 与宿主兼容
15 人工审核与审计 参考稿、局部采纳、来源、独立定稿、审计与返工
16 Git 版本与协作 快照、分支、远端与冲突
17 IP Bundle 与素材交付 导出、溯源、包清单
18 安全与隐私 信任边界、路径、凭据和外发
19 测试策略与验收矩阵 正负用例、跨端门禁、性能目标
20 实施路线与里程碑 阶段、依赖、交付证据
21 构建分发与运维 工具链、制品、签名与更新
22 插件生态开源许可与商业化 插件隔离、商业范围、许可
23 业务流程与 MCP 时序 系统与组件架构、书库卷章、改编诊断、接入、候选、Apps、浏览器、定稿和恢复图
24 文档治理架构决策与风险 ADR、准入条件与变更规则
25 小说与剧本标准格式 源格式、互操作与交稿模板
26 用户故事与用例 角色、用例关系、用户故事、主异常流程与验收追踪
27 Agent 与 Codex 插件集成 稳定接入、持续任务、场景 Skills、参考稿、按需上下文与反馈接续
28 领域设计与边界上下文 本体语义、聚合、关系、核心准入、上下文与不变量;维护规则归24
29 数据字典与 Schema 字段、关系、约束与数据生命周期
30 应用 API 详细设计 操作、权限、输入输出与恢复
31 国际化与中文体验 中文优先、英文、术语、编码与模板
32 品牌视觉与原型规范 吉祥物、图标、宣传素材与交互原型
33 宣传网站与部署 网站页面、内容归属、发布与验收
34 小说封面与 Agent 协作 Prompt、封面 Skill、固定目录、候选识别及作者选用
35 资料、素材与短剧制作资产 中文分类、资料分层、场景版本、外部图片交接、选用和依赖
36 创作场景与引导流程 原创与改编、来源与授权、引导、新建、导入及工作台适配
37 创作库与小说剧本视频设计 三类独立入口、四份布局、固定关联、预演、媒体审阅和成片工程交付
38 创作工作台重构执行计划 本轮工作包、依赖与状态;网站/文档/博客、功能、Skills、CLI/MCP、Codex业务与桌面验收

| 39 | Electron与插件优先重构架构 | 已采纳技术决定、TS插件与Rust分工、RPC、迁移和退役门禁 | | 40 | 机器能力地图与Review清单 | 从源码生成的完整功能、CLI/MCP/Skills 映射、作者决定、恢复与验证状态 | | 41 | 创作与审阅体验迭代方案 | 下一版本产品建议、全局页面覆盖、主题字体排版、双入口、迁移与拟议验收;不表示已经实施 | | 插件系列 | 产品调研与创作插件体系 | 第一性原理、生态、分类、需求、数据/API/SDK、渲染、源码审计与验收 |

使用约定

  • 产品名为“河图洛书 Hetu Luoshu”,软件仓库名为 hetu。
  • “源码Monorepo”“创作库”和“作品工作区”分别指软件工程、三类对象登记与文件事务范围;同根多个对象仍核验具体身份和权限,来源关联不自动扩权。
  • V1.0 是本文档产品范围,软件发行版本、Schema 版本、ABI 版本分别管理。
  • contracts/ 拥有机器 Schema;文档拥有字段语义、约束与设计理由,修改时同步评审。
  • 已采纳Electron+TS插件宿主+Rust Core;原生源码已退役,历史验收保留原版本证据,Electron按作者确认的Mac交互与当前风格独立验收。文件名中“原生”保留链接身份,以正文目标为准。
  • 规范定义与运行证据分开;验收和兼容声明必须绑定具体版本、平台和制品。