wpsnote/wpsnote-skills/novel-writer-cli

wpsnote-cli status --json

wpsnote-cli <子命令> [参数]

wpsnote-cli <子命令> --json-args '{"key": "value", "content": "<p>XML内容</p>"}'

#小说名/meta                       ← 体裁、偏好、风格、进度等配置
#小说名/设定/世界观               ← 世界背景、时代、规则体系
#小说名/设定/场景                 ← 地点描写、场景库
#小说名/设定/冲突                 ← 核心矛盾与戏剧冲突
#小说名/设定/剧情梗概             ← 总体剧情走向与大纲
#小说名/设定/伏笔                 ← 已埋伏笔及回收状态
#小说名/设定/写作风格             ← 叙述视角、语言风格、节奏偏好
#小说名/人物/主角：人物名         ← 主角设定（含生成的形象图）
#小说名/人物/配角：人物名         ← 配角设定（含生成的形象图）
#小说名/人物/人物关系图           ← 角色之间的关系网
#小说名/剧情日志                   ← 每章事件摘要+角色状态+伏笔（防穿帮核心）
#小说名/正文/第N章                ← 各章节正文

你希望这部小说是什么体裁？
A. 奇幻/玄幻（有魔法或特殊力量体系）
B. 都市/现代（贴近现实生活）
C. 科幻（未来、技术、星际）
D. 悬疑/推理（谜题、反转、破案）
→ 也可以直接告诉我你想要的风格

<h1>笔记标题</h1>
<p><tag>#小说名/设定/世界观</tag></p>
<p>正文内容...</p>

wpsnote-cli find --keyword "小说名" --json

你的故事大概是什么方向？
A. 一个人在陌生/异世界的冒险与成长
B. 现代都市里的情感、阴谋或悬疑
C. 末世、星际或未来科技背景的生存/探索
D. 权谋、江湖、历史或古代架空
→ 也可以直接用一句话描述你的故事核心

主角的起点是？
A. 普通人，被命运推着卷入事件，逐渐觉醒
B. 有天赋但有明显缺陷，需要经历磨砺
C. 已经足够强，故事聚焦更大的阴谋、牺牲或使命
D. 让 AI 根据故事背景自动决定

偏好哪种风格？
A. 快节奏爽文，冲突密集，读着带劲
B. 慢热叙事，注重人物情感和内心刻画
C. 悬疑紧张，每章留钩子，让人想翻下一章
D. 随 AI 根据体裁自动匹配

# 创建笔记
wpsnote-cli create --title "《小说名》创作设定" --json
# → 获取 note_id（记为 META_ID）
 
# 写入内容（含笔记索引区块）
wpsnote-cli batch-edit --json-args '{
  "note_id": "<META_ID>",
  "operations": [{
    "op": "replace",
    "block_id": "<初始空block_id>",
    "content": "<h1>《小说名》创作设定</h1><p><tag>#小说名/meta</tag></p><h2>基本信息</h2><p>体裁：[奇幻/科幻/现代/悬疑...]</p><p>叙述视角：第三人称有限视角</p><p>语言风格：[沉稳/轻快/诗意/犀利...]</p><p>章节目标字数：[X–Y 字]</p><p>特殊禁忌：[用户不希望出现的内容，若无则写\"无\"]</p><h2>创作记录</h2><p>当前进度：第 0 章（待开始）</p><p>创作开始时间：[YYYY-MM-DD]</p><h2>笔记索引</h2><p>【meta】note_id = <META_ID></p><p>【世界观】note_id = （创建后填入）</p><p>【冲突设定】note_id = （创建后填入）</p><p>【剧情梗概】note_id = （创建后填入）</p><p>【伏笔日志】note_id = （创建后填入）</p><p>【剧情日志】note_id = （创建后填入）</p><h3>人物</h3><p>【人物：角色名】note_id = （创建后填入）</p><h3>场景</h3><p>【场景：场景名】note_id = （创建后填入）</p><h3>正文章节</h3><p>（正文创建后逐章填入）</p>"
  }]
}'

wpsnote-cli create --title "《小说名》世界观设定" --json
# → note_id
 
wpsnote-cli outline --note_id <note_id> --json
# → 获取初始 block_id
 
wpsnote-cli batch-edit --json-args '{
  "note_id": "<note_id>",
  "operations": [{
    "op": "replace",
    "block_id": "<block_id>",
    "content": "<h1>《小说名》世界观设定</h1><p><tag>#小说名/设定/世界观</tag></p><h2>世界背景</h2><p>[时代/地理/社会结构]</p><h2>核心规则</h2><p>[魔法体系/科技水平/社会规范]</p><h2>特殊设定</h2><p>[独有元素]</p><h2>禁忌与约束</h2><p>[这个世界做不到的事]</p>"
  }]
}'

wpsnote-cli create --title "人物设定 — 角色名" --json
# → note_id
 
wpsnote-cli outline --note_id <note_id> --json
# → 获取初始 block_id
 
wpsnote-cli batch-edit --json-args '{
  "note_id": "<note_id>",
  "operations": [{
    "op": "replace",
    "block_id": "<block_id>",
    "content": "<h1>人物设定 — 角色名</h1><p><tag>#小说名/人物/主角：角色名</tag></p><h2>外貌</h2><p>[详细外貌描述，用于生图：发色与发型、体型与身材比例、面部特征、着装偏好与典型服饰、标志性配件]</p><h2>性格</h2><p>[3-5个核心词]</p><h2>口头禅/说话风格</h2><p>[...]</p><h2>背景故事</h2><p>[...]</p><h2>人物动机</h2><p>想要：[...] 害怕：[...]</p><h2>当前状态</h2><p>当前状态：初始状态</p>"
  }]
}'

# 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": "<last_block_id>",
  "position": "after",
  "src": "<image_url>",
  "alt": "角色名 初始形象图"
}'

wpsnote-cli outline --note_id <人物笔记> --json  # → last_block_id
 
wpsnote-cli edit --json-args '{
  "note_id": "<人物笔记>",
  "op": "insert",
  "anchor_id": "<last_block_id>",
  "position": "after",
  "content": "<h2>形象变迁历史</h2><h3>第X章之后</h3><p>变迁类型：[受伤/换装/成长/魔化/其他...]</p><p>触发事件：[导致外貌变化的具体事件]</p><p>变迁描述：[详细说明外貌变成了什么样，哪些改变，哪些保留]</p><p>【变迁后形象图描述】[此图展示变迁后的外貌，角度/重点描述]</p>"
}'
# 然后生图并插入（流程同 Step A-C；失败时写"（变迁形象图待补）"占位）

wpsnote-cli create --title "场景设定 — 场景名" --json
wpsnote-cli outline --note_id <note_id> --json
 
wpsnote-cli batch-edit --json-args '{
  "note_id": "<note_id>",
  "operations": [{
    "op": "replace",
    "block_id": "<block_id>",
    "content": "<h1>场景设定 — 场景名</h1><p><tag>#小说名/设定/场景/场景名</tag></p><h2>场景概述</h2><p>场景类型：[室内/室外/地下/空中...]</p><p>所属区域/位置：[...]</p><p>首次出现：第X章</p><h2>环境细节</h2><p>地面：[材质、颜色、状态]</p><p>建筑/结构：[样式、材料、破损程度、高度层次]</p><p>光线：[光源类型、颜色、照射角度、氛围感]</p><p>气味：[...]</p><p>声音：[...]</p><p>温度/气候：[...]</p><p>常驻元素：[固定摆设、标志性物件]</p><h2>配图</h2><p>（见下方生图流程）</p>"
  }]
}'

# 角度 1（正面全景）— 先写描述文字
wpsnote-cli outline --note_id <场景笔记> --json  # → last_block_id
wpsnote-cli edit --json-args '{
  "note_id": "<场景笔记>",
  "op": "insert",
  "anchor_id": "<last_block_id>",
  "position": "after",
  "content": "<p>【正面全景】[角度描述：从哪里看、光线方向、画面重点]</p>"
}'
 
# 生成图片（失败时写占位符后继续）
wpsnote-cli gen-image \
  --prompt "[场景名]，[所有环境细节]，正面全景，[光线色调]，[体裁]插画风格，写实背景艺术" \
  --width 2048 --height 1536 --json
# → 成功：获取 image_url，然后插图
# → 失败：wpsnote-cli edit --json-args '{"note_id":"<场景笔记>","op":"insert","anchor_id":"<last_block_id>","position":"after","content":"<p>（正面全景图待补）</p>"}' 然后继续
 
wpsnote-cli outline --note_id <场景笔记> --json  # → 最新 last_block_id（生图成功时）
wpsnote-cli insert-image --json-args '{"note_id":"<场景笔记>","anchor_id":"<last_block_id>","position":"after","src":"<image_url>","alt":"场景名 正面全景"}'
 
# 角度 2（内部视角）— 先写描述文字，再生图插入（同上流程）
# 角度 3（特写细节，可选）— 同上

wpsnote-cli outline --note_id <场景笔记> --json  # → last_block_id
 
wpsnote-cli edit --json-args '{
  "note_id": "<场景笔记>",
  "op": "insert",
  "anchor_id": "<last_block_id>",
  "position": "after",
  "content": "<h2>场景变更历史</h2><h3>第X章之后</h3><p>变更类型：[破坏/改造/废弃/占领...]</p><p>变更描述：[详细说明场景变成什么样，哪些细节改变，哪些保留]</p><p>触发事件：[导致变更的具体事件]</p>"
}'
# 变更后如需配图，同样先写角度描述文字再插入图片；失败时写"（变更状态图待补）"占位

wpsnote-cli create --title "《小说名》剧情梗概" --json
wpsnote-cli outline --note_id <note_id> --json
 
wpsnote-cli batch-edit --json-args '{
  "note_id": "<note_id>",
  "operations": [{
    "op": "replace",
    "block_id": "<block_id>",
    "content": "<h1>《小说名》剧情梗概</h1><p><tag>#小说名/设定/剧情梗概</tag></p><h2>故事起点</h2><p>[...]</p><h2>主线走向</h2><p>[3-5个关键转折点]</p><h2>预计结局</h2><p>[可以模糊]</p><h2>核心主题</h2><p>[...]</p>"
  }]
}'

wpsnote-cli create --title "《小说名》伏笔日志" --json
wpsnote-cli outline --note_id <note_id> --json
 
wpsnote-cli batch-edit --json-args '{
  "note_id": "<note_id>",
  "operations": [{
    "op": "replace",
    "block_id": "<block_id>",
    "content": "<h1>《小说名》伏笔日志</h1><p><tag>#小说名/设定/伏笔</tag></p><p>（尚未埋入伏笔）</p>"
  }]
}'

<p>[F-1] 伏笔内容描述 → 埋入：第1章 / 状态：未回收</p>
<p>[F-2] 伏笔内容描述 → 埋入：第2章 / 已回收：第5章</p>

wpsnote-cli create --title "《小说名》剧情日志" --json
wpsnote-cli outline --note_id <note_id> --json
 
wpsnote-cli batch-edit --json-args '{
  "note_id": "<note_id>",
  "operations": [{
    "op": "replace",
    "block_id": "<block_id>",
    "content": "<h1>《小说名》剧情日志</h1><p><tag>#小说名/剧情日志</tag></p><p>（尚未开始写作）</p>"
  }]
}'

# 首次启动时通过标签搜索找到 meta 笔记（此后通过已知 note_id 直接访问）
wpsnote-cli find --json-args '{"tags":["#小说名/meta"],"limit":1}' --json
# → META_ID