-–
name: miao-import
description: MIAO小说创作流程（素材导入版），适合已有素材库的项目。分析素材库→分类整理→归档到0-素材/→输出分析报告与评分→用户确认后进入标准流程。触发词：“MIAO素材导入”、“素材库导入”、“有素材库写小说”。
-–
# MIAO·素材导入流程
## 触发词
- **MIAO素材导入** / **MIAO导入流程**
- **素材库导入** / **有素材库写小说**
## 核心理念
> 素材导入 = **理解素材、整理素材、归档素材、评估素材**，不直接生成创作文件。
> 创作文件（设定、大纲、正文）由标准流程的 1-边界 → 2-设定 → 3-大纲 → 4-正文 → 5-审查 生成。
> 素材导入版的产出物是 `0-素材/` 目录，作为标准流程各步骤的参考输入。
## 流程总览
```
用户给素材库
↓
第零步：项目初始化（创建目录结构 + SOLOENT.md）
↓
第一步：分析素材（理解故事 + 扫描文件 + 分类）
↓
第二步：整理素材（按标准格式整理 → 归档到 0-素材/）
↓
第三步：评估素材（评分 + 分析报告 + 创作方向建议）
↓
用户确认 → 进入标准流程
↓
1-边界 → 2-设定（读取0-素材/参考）→ 3-大纲（读取0-素材/参考）→ 4-正文 → 5-审查
```
—
## 第零步：项目初始化
### 动作
1. 创建项目目录结构（与标准版一致）：
```
项目根目录/
├── SOLOENT.md
├── 0-素材/ ← 素材导入版专属目录
├── 1-边界/
├── 2-设定/
├── 3-大纲/
├── 4-正文/
├── 5-审查/
└── .novelkit/
├── constitution/MASTER.md
└── memory/
```
2. 从模板复制 `SOLOENT.md`、`MASTER.md`、memory 模板文件
3. 在 SOLOENT.md §2.3 注册素材库根路径
### 前置条件自检
> 
开始前检查以下项目，任一不满足则先修复：
- [ ] 素材库路径存在且可访问
- [ ] 素材库目录下有文件（非空目录）
- [ ] SOLOENT.md 已创建且包含 §2.4 段落
- [ ] 目录结构完整（0-素材/ ~ 5-审查/）
- [ ] MASTER.md 存在于 .novelkit/constitution/
- [ ] memory 模板文件存在
—
## 第一步：分析素材
> 
第一步（1/3）：分析素材库
### 1.1 扫描素材库文件
读取素材库目录下全部文件，输出文件清单：
| 参考文件 | 内容类型 | 文件大小 | 状态 |
|:—|:—|:—|:—|
| [文件名] | [AI判断类型] | [X万字] | [正常/
大文件/
读取失败] |
**大文件标注**：单文件超过2万字的参考文件，在状态列标注「大文件」，并注明该文件覆盖的章节范围或内容范围。
**读取失败处理**：若某文件读取失败（权限/编码/格式错误），在状态列标注「读取失败：[原因]」，跳过该文件继续扫描其余文件。若关键文件读取失败，暂停并提示用户检查文件。
### 1.2 理解故事
读取素材库的核心文件（世界观、大纲、角色相关文件），回答以下问题：
**1. 这个故事讲什么？**
- 题材与类型
- 核心设定（一句话）
- 主角是谁（身份、核心特征）
- 核心冲突是什么
- 一句话概括
**2. 素材覆盖了多大范围？**
- 有章节细纲的章节范围（如第1-300章）
- 各区间的详细程度梯度（逐章 > 按单元 > 按区间 > 只有概念）
- 总覆盖字数估算
**3. 素材的结尾形态是什么？**
| 结尾形态 | 判断标准 | 后续影响 |
|:—|:—|:—|
| **完整闭环** | 包含决战/大结局/主角离开当前世界/时间跳跃等"完结信号" | 后续无法自然延续 |
| **开放式** | 有未收束的伏笔、未解决的核心矛盾、明确的续作线索 | 可基于伏笔延伸 |
| **半成品** | 故事进行到一半，没有明确的结尾或续作线索 | 需要重新规划后续 |
### 1.3 素材分类
将素材文件按内容类型分为三类：
| 分类 | 定义 | 处理策略 |
|:—|:—|:—|
| **核心层** | 有详细章节规划或核心设定的素材 | 整理归档到 0-素材/ |
| **支撑层** | 有世界观/角色/金手指等设定，但无章节规划 | 整理归档到 0-素材/ |
| **缺失层** | 完全没有素材的部分 | 在分析报告中标注，建议后续处理方式 |
—
## 第二步：整理素材
> 第二步（2/3）：整理素材 → 归档到 0-素材/
### 2.1 整理规则
**核心原则**：
- 整理 = 从用户素材中****提取、归类、格式化****，不是重新创作
- **整理 ≠ 简化**：整理后的文件必须保留原始素材的详细程度。禁止将详细设定压缩为摘要，禁止将完整列表缩减为代表项，禁止省略原始素材中的具体数值、参数、条件、步骤等细节
- 每个整理文件必须标注****信息来源****（来自哪个素材文件）
- 素材中有矛盾的地方，标注矛盾并给出AI判断，不自行掩盖
- 大文件按需整理：不全量复制，提取关键信息，标注"完整内容见原文件 [文件名] 第X-Y行"
- ** 大文件规则仅适用于单文件超过2万字的素材**。未超过2万字的小文件，必须全量整理，不得以"精简"为由省略内容
### 2.2 归档文件清单
按标准流程各步骤的消费需求组织，共10个文件：
| # | 0-素材/ 文件 | 内容 | 下游消费者 | 来源素材 |
|:—|:—|:—|:—|:—|
| 1 | **素材分析报告.md** | AI生成（故事概述+覆盖范围+结尾形态+评分+创作方向） | 用户审阅 | AI生成 |
| 2 | **世界观.md** | 背景设定、表里世界、地理、社会结构 | 2-设定步骤2 | 世界观相关文件 |
| 3 | **力量体系.md** | 序列/等级/晋升条件/能力分类 | 2-设定步骤2 | 力量体系相关文件 |
| 4 | **金手指.md** | 核心机制、任务系统、代价、进化路线 | 2-设定步骤3 | 金手指相关文件 |
| 5 | **核心角色.md** | 主角+核心反派+关键配角（3-5个），含关系网 | 2-设定步骤4 | 角色相关文件 |
| 6 | **配角与关系.md** | 其他配角清单+功能定位+出场/退场规划 | 2-设定步骤4 | 配角相关文件 |
| 7 | **主线与剧情推演.md** | 按卷/章节区间的剧情线、关键事件 | 2-设定步骤2 + 3-大纲步骤1 | 大纲/细纲文件 |
| 8 | **文风参考.md** | 基调、语言修辞、对话风格、节奏偏好 | 1-边界 | 文风相关文件 |
| 9 | **伏笔与情感线.md** | 伏笔埋设/收束计划、情感节点时间线 | 3-大纲步骤3 | 伏笔/情感线文件 |
| 10 | **名场面与节奏参考.md** | 爆点/笑点/泪点/悬念设计、样板书拆解（如有） | 3-大纲步骤3 | 名场面/样板书文件 |
### 2.3 整理执行
按以下顺序逐个文件整理，**每完成一个文件立即写入项目根目录下的 `0-素材/` 文件夹**：
> **路径约束**：所有整理文件必须写入 `[项目根目录]/0-素材/`。不得写入素材库目录、不得写入其他临时路径。项目根目录 = SOLOENT.md 所在目录。
1. 先读取所有相关素材文件
2. 提取关键信息，按标准格式整理
3. 在文件末尾标注信息来源表格
4. 写入 `0-素材/` 对应文件
**每个整理文件的格式要求**：
```markdown
# [文件名]
> 来源：[列出所有来源素材文件]
> 整理时间：[自动填写]
## [内容板块1]
[整理后的内容]
## [内容板块2]
[整理后的内容]
—
## 信息来源
| 板块 | 来源文件 | 备注 |
|:—|:—|:—|
| [板块名] | [素材文件名] | [如：提取了世界观部分] |
```
### 2.4 空素材处理
若素材库中某分类完全无对应素材（如没有文风参考文件），在 0-素材/ 中仍创建该文件，内容为：
```markdown
# [文件名]
> 素材库中未找到对应内容，此文件为空。
## 待补充
- [ ] 标准流程执行时由AI/用户补充
```
—
## 第三步：评估素材
> 第三步（3/3）：评估素材 → 输出分析报告
### 3.1 素材评分
对整理后的素材进行三维评分：
> **评分纪律**：评分必须基于第二步整理后的实际文件内容，不得凭印象给分。评分结果只输出一次，写入素材分析报告后不得修改。如果在暂停展示时给出了评分，必须与最终报告中的评分完全一致。
| 维度 | 评什么 | 分值 | 评分标准 |
|:—|:—|:—:|:—|
| **完整度** | 世界观、金手指、力量体系、核心角色、主线推演是否齐全 | 40分 | 每缺一项扣8分。注意：若素材覆盖范围外（如规划了300万字但素材只覆盖100万字）存在大量空白章节，必须扣分 |
| **详细度** | 有素材的部分够不够细 | 30分 | 逐章细纲=30 / 按单元=20 / 按区间=15 / 只有概念=10 |
| **一致性** | 素材内部有没有矛盾 | 30分 | 无矛盾=30 / 轻微矛盾（可协调）=20 / 严重矛盾=10 |
**总分与等级**：
| 等级 | 分数 | 含义 | 后续路径 |
|:—|:—:|:—|:—|
| 
**A级** | ≥80 | 素材充足，可直接进入标准流程 | 进入标准流程 |
| 
**B级** | 50-79 | 素材有缺口，需补充后进入 | 提示缺失项 → 用户选择补充方式 |
| 
**C级** | <50 | 素材严重不足，建议先补素材或用标准版 | 提示具体缺什么 → 用户决定 |
### 3.2 素材结构定性评估
> 仅在素材覆盖率<80%时执行。
| 检查项 | 判断方法 | 风险 |
|:—|:—|:—|
| **结尾闭环** | 素材覆盖的最后一章是否包含：决战/大结局/主角离开当前世界/时间跳跃等"完结信号" | 有闭环=后续无法自然延续 |
| **类型断裂** | 素材覆盖范围外是否暗示了类型变化（如都市→星际、修仙→科幻） | 有变化=读者群体断裂 |
| **伏笔延续性** | 素材覆盖范围内的伏笔是否全部收束？角色线是否全部完结？ | 全部收束=后续缺少悬念驱动力 |
若任一项触发，必须在分析报告中追加****定性风险警告****。
### 3.3 输出分析报告
将以下内容写入 `0-素材/素材分析报告.md`：
```markdown
# 素材库分析报告
## 一、故事概述
- **题材与类型**：[从素材提取]
- **核心设定**：[一句话]
- **主角**：[身份、核心特征]
- **核心冲突**：[一句话]
- **一句话概括**：[一句话]
## 二、素材覆盖范围
- **有细纲覆盖**：第X-Y章（约Z万字）
- **详细程度梯度**：
-
第A-B章：逐章细纲（最详细）
-
第C-D章：按单元细纲
-
第E-F章：按区间细纲（较粗）
-
第G章+：无素材
- **总覆盖率**：X%
## 三、素材结尾形态
- **形态**：[完整闭环 / 开放式 / 半成品]
- **判断依据**：[具体事件说明]
## 四、素材评分
| 维度 | 分数 | 说明 |
|:—|:—:|:—|
| 完整度 | X/40 | [缺什么/全齐] |
| 详细度 | X/30 | [最细到什么程度] |
| 一致性 | X/30 | [有无矛盾] |
| **总分** | **X/100** | **等级：A / B / C** |
## 五、定性风险警告（如有）
- [x] 结尾闭环：…
- [ ] 类型断裂：…
- [ ] 伏笔延续性：…
## 六、缺失项清单
| 缺失内容 | 严重程度 | 建议补充方式 |
|:—|:—|:—|
| [缺什么] | [高/中/低] | [AI补充 / 拆书补充 / 用户补充 / 可忽略] |
## 七、创作方向建议
基于素材分析，给出2-3个创作方向建议：
1. [建议A：如缩减至素材可支撑的完整故事规模]
2. [建议B：如维持原规划，AI基于素材逻辑延伸后续]
3. [建议C：如维持原规划，后续部分重新设计]
## 八、后续路径
- 素材等级：[A / B / C]
- 建议路径：[进入标准流程 / 补充素材后进入 / 切换标准版]
- 0-素材/ 文件清单：[列出10个文件及状态]
```
### 3.4 更新 SOLOENT.md
> ** 强制步骤**：分析报告写入 0-素材/ 后，**必须立即更新 SOLOENT.md**，在暂停等待用户确认之前完成。不得跳过，不得推迟到用户确认之后。
1. **确认 SOLOENT.md 已存在**。若不存在，从 SOLOENT_TEMPLATE.md 复制创建
2. **更新 §1 项目基因**：写入从素材提取的书名、简介、类型/题材、核心主题、目标读者
3. **更新 §2.3 素材库索引**：将 0-素材/ 下所有文件的路径写入整理文件清单表格，状态改为 
已完成
4. **更新 §2.4 创作参数锁定**：从素材提取字数/卷数/章数等参数写入（若素材有多个版本取最合理的值，矛盾处标注）
5. **更新 §2.5 素材完整度**：写入评分结果、定性风险状态、缺失项处理方式
### 3.5 用户确认
> **
强制暂停**：SOLOENT.md 更新完成后，展示分析报告摘要 + SOLOENT.md 关键更新内容，**必须使用 AskUserQuestion 工具**等待用户选择，**不得自行继续执行任何后续步骤**。
用户可选择：
- **确认并进入标准流程**：加载 1-边界/SKILL.md，开始标准流程（2-设定/3-大纲 等步骤读取 0-素材/ 作为参考）
- **补充素材后继续**：用户提供补充素材，回到第一步重新分析
- **切换标准版**：放弃素材导入，从零开始创作
- **调整规划**：如缩减篇幅、调整分卷等
—
## 标准流程衔接
> 素材导入完成后，进入标准流程。标准流程各步骤读取 0-素材/ 作为参考输入。
### 各步骤读取指引
| 标准流程步骤 | 读取 0-素材/ 文件 | 读取方式 |
|:—|:—|:—|
| 1-边界 | 文风参考.md | 全量读取 |
| 2-设定 步骤1（创意脑暴） | 主线与剧情推演.md | 按需读取 |
| 2-设定 步骤2（世界观+主线） | 世界观.md + 力量体系.md + 主线与剧情推演.md | 全量读取 |
| 2-设定 步骤3（金手指） | 金手指.md | 全量读取 |
| 2-设定 步骤4（角色） | 核心角色.md + 配角与关系.md | 全量读取 |
| 3-大纲 步骤1（总纲） | 主线与剧情推演.md + 名场面与节奏参考.md | 全量读取 |
| 3-大纲 步骤3（章纲） | 伏笔与情感线.md + 主线与剧情推演.md（按需） | 按需读取 |
| 4-正文 | 文风参考.md + 核心角色.md（按需） | 按需读取 |
### 2-设定/3-大纲 的素材导入版说明
> 当 SOLOENT.md §2.3 注册了 0-素材/ 路径时，标准流程的 2-设定 和 3-大纲 步骤应：
> 1. ****优先读取 0-素材/ 中的对应文件****作为参考输入
> 2. **不是直接复制** 0-素材/ 的内容到创作文件，而是基于整理后的素材进行交互式共创
> 3. 用户可在交互过程中修改、补充、删除素材中的内容
> 4. 最终创作文件（2.2/2.3/2.4/2.5/2.6/3.1等）的质量由标准流程的质量检查机制保障
—
## 异常处理
| 异常场景 | 处理方式 |
|:—|:—|
| **素材库路径不存在或为空** | 提示用户确认素材库路径。若用户确认路径正确但为空，建议切换标准版 |
| **参考文件读取失败** | 在扫描结果中标注「读取失败：[原因]」，跳过该文件继续。若关键文件读取失败，暂停提示用户 |
| **参考文件间存在严重矛盾** | 在整理文件中标注矛盾，给出AI判断。用户未回应时默认采用AI建议并标注 |
| **SOLOENT.md 不存在** | 自动执行第零步项目初始化 |
| **0-素材/ 目录已存在** | 提示用户：已有素材整理结果，是否覆盖？用户确认后继续 |
| **素材库只有一个文件** | 正常执行，但评分时详细度维度适当放宽 |
—
## 流程进度提示
> 每个步骤开始时，AI 应输出当前进度位置。
格式：` [步骤名称]（X/3）> [子步骤名称]`
示例：
- ` 第一步（1/3）：分析素材 > 1.1 扫描素材库文件`
- ` 第二步（2/3）：整理素材 > 整理世界观.md`
- ` 第三步（3/3）：评估素材 > 3.3 输出分析报告`
—
## 可选技能
| 技能 | 触发词 | 用途 |
|:—|:—|:—|
| 写作进阶技巧 | “MIAO写作技巧” | 场景变体、伏笔管理、弃书风险自检 |
| 起点AI责编 | “帮我审稿”、“起点审稿” | 起点平台审稿诊断 |
| 番茄AI责编 | “番茄审稿” | 番茄平台审稿诊断 |