本目录属于河图洛书 Hetu Luoshu,全局信息见根 README。
文档版本: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交互与当前风格独立验收。文件名中“原生”保留链接身份,以正文目标为准。
- 规范定义与运行证据分开;验收和兼容声明必须绑定具体版本、平台和制品。