fiction-import:导入已有小说
将已写好但未按本工具集结构组织的项目反向解析为标准格式。
适用场景
- 之前在其他工具或纯文本中写了半本,想迁移过来
- 写作途中才决定用本工具集管理
- 有一本完稿想进来做拆解参考
执行流程
Step 1:确认导入源
询问用户:
- 源文件/目录路径
- 书名和作者
- 大致的题材和篇幅
Step 2:建立目标目录
# SCRIPTS_DIR 由安装宿主指向本仓库或已安装的 scripts/ 目录。
export PROJECT_ROOT="${CODEX_PROJECT_DIR:-${CLAUDE_PROJECT_DIR:-$PWD}}"
python -X utf8 "${SCRIPTS_DIR}/fiction.py" --project-root "${PROJECT_ROOT}" init \
--title "{书名}" --author "{作者}" --genre "{题材}"
--project-root 是全局参数,必须放在 init 子命令之前。初始化脚本只创建项目骨架;章节拆分、设定提取和 writing_started 标记仍由本 skill 的执行流程在用户确认后完成。
Step 3:解析源文件
- 如果是单一文件 → 按章节标记拆分(按"第 X 章"或数字编号)
- 如果是目录 → 按文件名排序逐章导入
- 源文件格式支持:.txt / .md 纯文本
Step 4:按篇幅路由拆解
自动调用 fiction-analyze 的拆解管线,按字数分流。
Step 5:生成设定和总纲
基于文本分析,生成初始设定集和总纲草案:
- 主角卡(提取文本中的身份/能力/关系)
- 世界观框架
- 核心冲突推测
- 简化到骨架级别,不做过度推断
Step 6:标记状态
- state.json 中标记 writing_started: true(如果已有一章以上正文)
- 正文文件逐章写入正文/
- 输出导入完成报告
限制
- 纯文本格式,解析依赖章节分隔符识别
- 格式不规范(无章节标记、段落无分隔)时精度下降
- 导入后建议运行 fiction-doctor 确认完整性
- 导入的设定和总纲是"推断"而非"确认",需要用户审查修改
- 导入完成后建议运行 fiction-conceive 打磨设定
参考
拆解管线复用 fiction-analyze 的逻辑。 导入后下一步推荐:fiction-doctor(确认完整性)→ fiction-conceive(打磨设定)→ fiction-plan(正式进入规划) 如果导入对象是别人的作品用于拆解学习,建议直接使用 fiction-analyze, 不需要先导入到项目目录。
使用示例
> /fiction-import D:/旧稿/我的小说.txt
📖 导入中...
检测到:长篇(约 25 万字 / 80 章)
题材:都市重生(推测,请用户确认)
✅ 导入完成!
· 正文/ 已写入 1-80 章
· 设定集/ 已生成骨架(请 review)
· 大纲/ 总纲草案.md 已生成
· 拆文库/ 已生成拆解报告
建议下一步:
1. fiction-doctor 检查完整性
2. fiction-conceive 打磨设定
3. fiction-plan 1 开始正式规划
致谢
本 skill 的开发参考了以下开源项目的思路与实现:
感谢原作者的开源贡献。
