XML内容
"}' ``` 所有写操作加 `--json` 获取结构化返回值，方便提取 note_id / block_id。 --- ## 命令速查表 | 操作 | CLI 命令 | |------|---------| | 搜索笔记 | `wpsnote-cli find --json-args '{"keyword":"...","tags":["#标签"]}'` | | 读取全文 | `wpsnote-cli read --note_id...
"}'` | | 批量编辑 | `wpsnote-cli batch-edit --json-args '{"note_id":"...","operations":[...]}'` | | 插入图片 | `wpsnote-cli insert-image --json-args '{"note_id":"...","anchor_id":"...","position":"after","src":"正文内容...
``` --- ## 两种启动模式 ### 模式 A：冷启动（全新小说） 当以下命令未找到相关笔记时，进入冷启动： ```bash wpsnote-cli find --keyword "小说名" --json ``` 流程： 1. 向用户提 3 个带备选项的问题（故事方向、主角起点、写作节奏） 2. 根据回答 AI 自动推导所有设定 3. 依次创建设定笔记 → 生成人物图 → 写第一章 → 存档展示 ### 模式 B：续写模式（已有笔记） 当找到对应小说标签的笔记时，直接加载上下文续写。 流程： 1. 加载 meta 笔记（获取风格约束） 2. 读取最新章节结尾（300–500 字） 3. 读取剧情日志（未回收伏笔、角色状态） 4. 如有用户特殊需求，检索相关设定笔记 5. 写作 → 存档 → 自动更新日志 --- ## 冷启动详细流程 ### Step 1：收集基础信息 AI 向用户提问，每个问题都必须附上备选项，用户可直接选或自由描述。全部问题收齐后，AI 自动推导所有设定，无需用户逐一确认。 问题 1：故事是关于什么的？ ``` 你的故事大概是什么方向？ A. 一个人在陌生/异世界的冒险与成长 B. 现代都市里的情感、阴谋或悬疑 C. 末世、星际或未来科技背景的生存/探索 D. 权谋、江湖、历史或古代架空 → 也可以直接用一句话描述你的故事核心 ``` 问题 2：主角是什么样的人？ ``` 主角的起点是？ A. 普通人，被命运推着卷入事件，逐渐觉醒 B. 有天赋但有明显缺陷，需要经历磨砺 C. 已经足够强，故事聚焦更大的阴谋、牺牲或使命 D. 让 AI 根据故事背景自动决定 ``` 问题 3：你喜欢什么样的写作节奏？ ``` 偏好哪种风格？ A. 快节奏爽文，冲突密集，读着带劲 B. 慢热叙事，注重人物情感和内心刻画 C. 悬疑紧张，每章留钩子，让人想翻下一章 D. 随 AI 根据体裁自动匹配 ``` 用户回答后，AI 根据所有回答自动推导以下设定，不再追问： | 设定项 | 推导依据 | |--------|---------| | 体裁 | 根据问题 1 回答自动判断 | | 世界观 | 基于体裁和描述构建 | | 主要冲突 | 从故事核心提炼 | | 主角设定 | 结合问题 2 和体裁生成 | | 叙述视角 | 默认第三人称有限视角（存入 meta） | | 章节字数 | 根据体裁推导默认值（见下方字数规则），存入 meta | | 语言风格 | 根据问题 3 和体裁判断，存入 meta | 章节字数推导规则： | 体裁/偏好 | 默认目标字数 | |----------|------------| | 轻小说/网络爽文 | 2000–3000 字 | | 奇幻/科幻/武侠 | 1500–2500 字 | | 都市/言情/悬疑 | 1000–2000 字 | | 纯文学/慢热风格 | 800–1500 字 | | 用户明确指定 | 以用户指定为准 | 字数存入 meta 笔记后，每次写作前必须读取并作为硬约束执行。 --- ### Step 2：创建设定笔记 #### 2-1：Meta 笔记 Meta 笔记是整部小说的**唯一索引中心**，存储所有子笔记的 note_id。后续所有流程应优先从 meta 索引读取 note_id，不再每次搜索。 ```bash # 创建笔记 wpsnote-cli create --title "《小说名》创作设定" --json # → 获取 note_id（记为 META_ID） # 写入内容（含笔记索引区块） wpsnote-cli batch-edit --json-args '{ "note_id": "体裁：[奇幻/科幻/现代/悬疑...]
叙述视角：第三人称有限视角
语言风格：[沉稳/轻快/诗意/犀利...]
章节目标字数：[X–Y 字]
特殊禁忌：[用户不希望出现的内容，若无则写\"无\"]
当前进度：第 0 章（待开始）
创作开始时间：[YYYY-MM-DD]
【meta】note_id =
【世界观】note_id = （创建后填入）
【冲突设定】note_id = （创建后填入）
【剧情梗概】note_id = （创建后填入）
【伏笔日志】note_id = （创建后填入）
【剧情日志】note_id = （创建后填入）
【人物：角色名】note_id = （创建后填入）
【场景：场景名】note_id = （创建后填入）
（正文创建后逐章填入）
" }] }' ``` > 注意：创建笔记后先调用 `wpsnote-cli outline --note_id[时代/地理/社会结构]
[魔法体系/科技水平/社会规范]
[独有元素]
[这个世界做不到的事]
" }] }' ``` #### 2-3：人物笔记（每个主要角色一篇） ```bash wpsnote-cli create --title "人物设定 — 角色名" --json # → note_id wpsnote-cli outline --note_id[详细外貌描述，用于生图：发色与发型、体型与身材比例、面部特征、着装偏好与典型服饰、标志性配件]
[3-5个核心词]
[...]
[...]
想要：[...] 害怕：[...]
当前状态：初始状态
" }] }' ``` 创建完人物笔记后，立即生成人物形象图： > ⚠️ **生成任何角色图片前，必须先完整阅读该角色笔记**，提取并记录以下人设细节，生图 prompt 必须包含所有这些细节以保证跨章一致性： > - 发色与发型（如：银白色长直发、黑色短发、棕色卷发） > - 体型与身材比例（如：修长高挑、娇小纤细、壮实宽肩） > - 面部特征（如：眼睛颜色形状、肤色、标志性特征） > - 着装偏好与典型服饰（如：总穿深色风衣、偏爱白色宽袖长袍） > - 标志性配件（如：左耳银环、颈间红绳） > > 这些细节**非常非常重要**，后续所有涉及该角色的图片都必须严格遵循，不得出现与人设不符的外貌。 > > **若角色有形象变迁历史，使用最新变迁后的描述生图，而非初始描述。** ```bash # Step 0：阅读人物笔记，提取人设细节（必做，不可跳过） wpsnote-cli read --note_id <人物笔记note_id> --json # → 从输出中提取：发色、发型、体型、面部特征、着装偏好、标志性配件 # → 若有形象变迁历史，读取最新变迁描述作为生图依据 # → 将这些细节全部写入 prompt # Step A：文生图（默认 4:3，最大 2048x1536；每 10 分钟最多 10 张） wpsnote-cli gen-image \ --prompt "[角色名]，[发色发型]，[体型描述]，[面部特征]，[典型着装]，[标志性配件]，[体裁]插画风格，精细人物肖像，[主要色调]" \ --width 2048 \ --height 1536 \ --json # → 成功：返回 image_url # → 失败：跳过插图，在笔记对应位置写"（形象图待补）"，继续后续流程 # Step B：获取人物笔记末尾 block_id wpsnote-cli outline --note_id <人物笔记note_id> --json # → 找到最后一个 block_id（last_block） # Step C：插入图片（生图成功时执行） wpsnote-cli insert-image --json-args '{ "note_id": "<人物笔记note_id>", "anchor_id": "变迁类型：[受伤/换装/成长/魔化/其他...]
触发事件：[导致外貌变化的具体事件]
变迁描述：[详细说明外貌变成了什么样，哪些改变，哪些保留]
【变迁后形象图描述】[此图展示变迁后的外貌，角度/重点描述]
" }' # 然后生图并插入（流程同 Step A-C；失败时写"（变迁形象图待补）"占位） ``` > 后续所有涉及该角色的生图 prompt，都必须使用**最新变迁描述**而非初始外貌。 #### 2-3b：场景设定笔记（剧情中出现的每个场景必须单独建档） > ⚠️ **每个新场景必须独立创建设定笔记**，不可合并。 ```bash wpsnote-cli create --title "场景设定 — 场景名" --json wpsnote-cli outline --note_id场景类型：[室内/室外/地下/空中...]
所属区域/位置：[...]
首次出现：第X章
地面：[材质、颜色、状态]
建筑/结构：[样式、材料、破损程度、高度层次]
光线：[光源类型、颜色、照射角度、氛围感]
气味：[...]
声音：[...]
温度/气候：[...]
常驻元素：[固定摆设、标志性物件]
（见下方生图流程）
" }] }' ``` **场景配图规范：** - 每个场景必须生成 **2–3 张不同角度的图**（正面全景、内部视角、特写细节） - **每张图上方必须先写入一段文字**，描述该图的拍摄角度和画面重点，再插入图片 - **默认图片尺寸：4:3，最大 2048×1536** - **生图失败处理：失败时写 `（图待补）` 占位，继续后续流程，不阻塞创作** ```bash # 角度 1（正面全景）— 先写描述文字 wpsnote-cli outline --note_id <场景笔记> --json # → last_block_id wpsnote-cli edit --json-args '{ "note_id": "<场景笔记>", "op": "insert", "anchor_id": "【正面全景】[角度描述：从哪里看、光线方向、画面重点]
" }' # 生成图片（失败时写占位符后继续） wpsnote-cli gen-image \ --prompt "[场景名]，[所有环境细节]，正面全景，[光线色调]，[体裁]插画风格，写实背景艺术" \ --width 2048 --height 1536 --json # → 成功：获取 image_url，然后插图 # → 失败：wpsnote-cli edit --json-args '{"note_id":"<场景笔记>","op":"insert","anchor_id":"（正面全景图待补）
"}' 然后继续 wpsnote-cli outline --note_id <场景笔记> --json # → 最新 last_block_id（生图成功时） wpsnote-cli insert-image --json-args '{"note_id":"<场景笔记>","anchor_id":"变更类型：[破坏/改造/废弃/占领...]
变更描述：[详细说明场景变成什么样，哪些细节改变，哪些保留]
触发事件：[导致变更的具体事件]
" }' # 变更后如需配图，同样先写角度描述文字再插入图片；失败时写"（变更状态图待补）"占位 ``` #### 2-4：剧情梗概笔记 ```bash wpsnote-cli create --title "《小说名》剧情梗概" --json wpsnote-cli outline --note_id[...]
[3-5个关键转折点]
[可以模糊]
[...]
" }] }' ``` #### 2-5：伏笔日志笔记（初始为空） ```bash wpsnote-cli create --title "《小说名》伏笔日志" --json wpsnote-cli outline --note_id（尚未埋入伏笔）
" }] }' ``` 后续每章追加格式（全局唯一编号 F-1、F-2…）： ```xml[F-1] 伏笔内容描述 → 埋入：第1章 / 状态：未回收
[F-2] 伏笔内容描述 → 埋入：第2章 / 已回收：第5章
``` #### 2-6：剧情日志笔记（初始为空） ```bash wpsnote-cli create --title "《小说名》剧情日志" --json wpsnote-cli outline --note_id（尚未开始写作）
" }] }' ``` --- ## 写作前上下文检查（每次必做） ### 检查 0：读 Meta，获取写作约束和笔记索引 ```bash # 首次启动时通过标签搜索找到 meta 笔记（此后通过已知 note_id 直接访问） wpsnote-cli find --json-args '{"tags":["#小说名/meta"],"limit":1}' --json # → META_ID # 读取整个 meta 笔记（含基本信息 + 笔记索引） wpsnote-cli read --note_id正文第一段...
正文第二段...
..." }] }' # 写入成功后，立即将新章节 note_id 回写到 meta 索引 wpsnote-cli search --note_id【第X章】note_id =
主要事件：[本章核心剧情一两句]
在场角色：[角色名, 角色名, ...]
角色状态变化：[无 / 角色名：变化描述]
结尾句：[本章最后一句原文]
【新埋】[F-X] [伏笔描述] → 状态：未回收
（本章无新伏笔则写：本章无新伏笔）
累计未回收伏笔：[F-1、F-3...] 共 N 条
" }' ``` > 伏笔编号规则：全局唯一，按埋入顺序编号，格式 `F-1`、`F-2`……跨章一致。 ### 归档 3：更新角色当前状态 ```bash # 定位"当前状态"字段 wpsnote-cli search --note_id <角色笔记> --query "当前状态" --json # → block_id # 替换状态描述 wpsnote-cli edit --json-args '{ "note_id": "<角色笔记>", "op": "replace", "block_id": "<状态block_id>", "content": "当前状态：[新状态描述]
" }' ``` ### 归档 4：同步伏笔日志（必做，每章都要执行） 情况 A：本章埋入新伏笔 ```bash wpsnote-cli outline --note_id <伏笔日志> --json # → last_block_id wpsnote-cli edit --json-args '{ "note_id": "<伏笔日志>", "op": "insert", "anchor_id": "[F-X] [伏笔描述] → 埋入：第X章 / 状态：未回收
" }' ``` 情况 B：本章回收了已有伏笔 ```bash wpsnote-cli search --note_id <伏笔日志> --query "F-X" --json # → block_id wpsnote-cli edit --json-args '{ "note_id": "<伏笔日志>", "op": "replace", "block_id": "<伏笔block_id>", "content": "[F-X] [伏笔描述] → 埋入：第X章 / 已回收：第Y章
" }' ``` 情况 C：本章无伏笔变动（也必须执行） ```bash # 核对未回收数量与剧情日志最新条目一致 wpsnote-cli search --note_id <伏笔日志> --query "未回收" --json # → 若数量与剧情日志对得上，归档完成；若对不上，逐条比对补齐 ``` ### 归档 5：更新 Meta 进度 ```bash wpsnote-cli search --note_id当前进度：第 X 章
" }' ``` --- ## 防穿帮速查表 | 穿帮类型 | 触发场景 | 防护措施 | |---------|---------|---------| | 角色状态矛盾 | 第三章受伤，第四章却行动如常 | 写前读角色"当前状态"字段 | | 能力越界 | 角色突然会了设定里没有的技能 | 写前读世界观/角色设定笔记 | | 人际关系错误 | 已决裂的人突然像老朋友 | 读人物关系图笔记 | | 地理矛盾 | 三天路程突然一天到 | 场景笔记标注地理距离 | | 场景细节矛盾 | 同一地点描述前后不一致 | 写前读场景设定笔记，照实执行细节 | | 场景状态错误 | 已破坏的房间又恢复原样 | 查看场景变更历史，使用最新状态 | | 角色外貌不一致 | 同一角色发色或着装前后矛盾 | 生图/写作前必须先读人物笔记人设细节 | | 伏笔遗忘 | 第二章埋的东西从未回收 | 每次写前扫描剧情日志 | | 时间线混乱 | 事件先后顺序不清楚 | 剧情日志按章节顺序记录 | --- ## 特殊情况处理 ### 用户想改变已有设定 ```bash # 找出所有相关笔记 wpsnote-cli find --json-args '{"keyword":"角色名/设定名","tags":["#小说名"]}' --json # 评估影响范围，告知用户（一句话说明） # 确认后批量更新相关笔记 # 在剧情日志中标注"设定变更点：第X章起，XX设定改为YY" ``` ### 用户想插入新角色 1. 询问："这个角色有什么特点？"（如用户没想法，AI 直接生成） 2. 创建人物笔记 → 生成形象图（见 2-3） 3. 在人物关系图笔记中追加与已有角色的关系 4. 检查前文是否适合补充伏笔铺垫 ### 用户想跳章节写 ```bash # 在剧情日志中为跳过的章节预留标记 wpsnote-cli edit --json-args '{ "note_id": "<剧情日志>", "op": "insert", "anchor_id": "[待写] 第X章 占位
" }' # 在 Meta 笔记"当前进度"后追加跳写记录 # 正常写指定章节并存档 ``` --- ## 续写序列快速参考 ```bash # Step 1：加载 meta 笔记（索引 + 风格约束） # 首次使用标签搜索定位 meta，后续直接用已知 META_ID wpsnote-cli find --json-args '{"tags":["#小说名/meta"],"limit":1}' --json wpsnote-cli read --note_id