@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

package/plugins/fancy-analyze/analyze-definitions.md

@@ -0,0 +1,519 @@
+# 网文创作分析术语定义（权威）
+
+> 本文件是 `schema.md` 的配套定义文件，和 `schema.md` 一起使用。
+>
+> **执行任何章节分析前，必须先按本文件确认术语含义。**
+> 不要用通用文学理论、学术论文或其它题材的定义替代这里的定义。
+>
+> 定义中的类型和例子是**判定框架，不是题材清单**；都市/玄幻/悬疑/言情/无限流/历史/科幻/体育/职场等题材的等价现象都算，按源文实际内容判断，不要硬套词表。
+>
+> 判定顺序：
+> 1. 先判断“本章有没有这个现象”；
+> 2. 再判断它属于哪个术语；
+> 3. 最后才写分析。
+>
+> 如果拿不准，宁可写“无”，不要硬套术语。硬套会让后续骨架/血肉/节奏阶段学到错误模式。
+
+---
+
+## 一、按章写作技法
+
+### 1. 叙事视角
+
+**是什么**：这一章通过谁的眼睛、谁的信息边界、谁的语气来讲故事。
+
+**判定标准**：
+- 限知视角：读者只知道视角人物知道的事；
+- 全知视角：叙述者知道多个人的心理和未发生的事；
+- 多视角：同一章内切换不同人物的认知；
+- 叙述距离：叙述者是贴近人物内心，还是站在远处旁观；
+- 叙述语气：冷静、戏谑、压迫、抒情、说书人等。
+
+**常见误判**：
+- 把“第一人称/第三人称”当成唯一判定，忽略信息边界；
+- 把作者旁白当成视角人物的认知。
+
+**网文例子**：
+> 方平不知道“武科”是什么，读者也不知道。信息只从方平的疑问和同学的对话里释放——这是限知视角，不是全知旁白。
+
+---
+
+### 2. 章节结构
+
+**是什么**：这一章内部的事件排列方式，以及章节作为一个完整单元如何起、承、转、合。
+
+**判定标准**：
+- 章节是否有明确的“开场状态 → 触发事件 → 升级/阻碍 → 转折 → 收束”；
+- 是否存在多线并行、倒叙、插叙、环形结构；
+- 章节的高潮点/信息点在什么位置；
+- 章节结尾是否把读者推向下一章。
+
+**常见误判**：
+- 把“章节分了几个自然段”当成章节结构；
+- 把整本书的卷结构当成单章结构。
+
+**网文例子**：
+> 开头方平确认重生 → 同学提到武科 → 方平听不懂 → 张浩带来八品之战消息 → 方平发现“剧本不对”。这是“确认异常—扩大信息—认知崩塌”的单章结构。
+
+---
+
+### 3. 节奏韵律
+
+**是什么**：一章内信息、情绪、动作、对话的松紧快慢变化。
+
+**判定标准**：
+- 长句/短句、快场景/慢场景的交替；
+- 信息释放密度：是一直解释，还是边行动边释放；
+- 情绪曲线：压制—释放、轻松—紧张、期待—满足；
+- 是否有“呼吸位”（日常、玩笑、停顿）避免持续高压。
+
+**常见误判**：
+- 把“字数多少”当成节奏；
+- 把“事件多”当成节奏快——事件多但全是说明，读者仍会觉得拖。
+
+**网文例子**：
+> 前半段课堂闲聊轻快，张浩一句“马宗师突破八品”后信息密度骤增，结尾用短句收束。这是“轻—重—紧”的节奏，不是单纯事件多。
+
+---
+
+### 4. 对话技巧
+
+**是什么**：对话承担人物塑造、信息释放、关系变化、冲突推进、潜台词和节奏控制的方式。
+
+**判定标准**：
+- 每句对话是否在推进信息/关系/冲突，而不是复述已知；
+- 是否有潜台词：人物说的和想的/要的不一致；
+- 是否有声音差异：不同角色说话方式、称呼、口头禅、句长不同；
+- 是否有对话中的权力关系：谁打断谁、谁回避谁、谁在试探谁；
+- 对话是否与动作、沉默、环境配合。
+
+**常见误判**：
+- 只要有人说话就标“有”；
+- 把大段解释性旁白当成对话技巧；
+- 忽略“沉默”“答非所问”“称呼变化”也是对话。
+
+**网文例子**：
+> 陈凡说“方平，直呼宗师之名，这是最大的不尊重！”——这句话同时在纠正规则、暴露陈凡对武道礼制的熟悉、建立两人关系里的“懂行/不懂行”落差。
+
+---
+
+### 5. 描写技法
+
+**是什么**：用感官、动作、环境、心理、细节来让读者“看见/感到”人物和世界。
+
+**判定标准**：
+- 是否调动至少一种感官（视/听/触/嗅/味/体感）；
+- 是否用动作/细节代替抽象判断；
+- 环境描写是否参与人物情绪或剧情，而不是纯装饰；
+- 心理描写是否具体到念头、身体反应、选择；
+- 是否有“选择性细节”：只写对本章有用的东西。
+
+**常见误判**：
+- 形容词多就标“有”；
+- 把“作者总结人物性格”当成描写；
+- 环境描写与剧情完全无关也标“有”。
+
+**网文例子**：
+> “方平满脸懵”是心理/表情描写；“手里只剩十五元”是动作性细节，同时推进资源困境。两者都比“方平很穷”有效。
+
+---
+
+### 6. 情节机制
+
+**是什么**：推动故事运转的因果装置或规则，例如重生、系统、金手指、任务、比赛、考试、复仇、身份错位、信息差、倒计时。
+
+**判定标准**：
+- 这个机制是否在制造选择、代价、限制和后果；
+- 它是否让主角必须行动，而不是只提供设定说明；
+- 它是否与本章冲突/目标发生关系；
+- 它是否有边界：不能无限解决问题。
+
+**常见误判**：
+- 把“发生了什么事”当成情节机制；
+- 把“系统面板”本身当成机制，而不看它如何改变选择；
+- 机制只出现一次、没有后果，也标“有”。
+
+**网文例子**：
+> 重生不是“知道未来”这么简单：方平的旧记忆与当前武道世界不匹配，迫使他重新收集信息。这是“信息差 + 认知错位”机制在推动行动。
+
+---
+
+### 7. 开头钩子
+
+**是什么**：章节开头用来抓住读者的异常、问题、威胁、欲望、反差或强情绪。
+
+**判定标准**：
+- 前 1-3 段是否提出一个读者想知道答案的问题；
+- 是否有异常/反差/危险/欲望/秘密；
+- 是否让读者产生“接下来会怎样”的期待；
+- 是否与本章核心事件有关，而不是无关噱头。
+
+**常见误判**：
+- 开头有动作就标“有”，但动作没有悬念；
+- 开头只是环境描写，没有信息差/威胁/欲望；
+- 把“标题”当成开头钩子。
+
+**网文例子**：
+> “2008 年，4 月 5 日。”——日期本身不钩人，但紧接着“方平确认自己重生”制造了“他为什么回到过去、他要怎么活”的问题，这才是钩子。
+
+---
+
+### 8. 结尾收束
+
+**是什么**：章节结尾如何收住本章、制造下一章期待，或完成情绪/信息/关系的落点。
+
+**判定标准**：
+- 类型：悬念式、反转式、决定式、情绪落点、信息揭示、日常呼吸；
+- 是否改变读者对前文的解释；
+- 是否把压力/问题推到下一章；
+- 是否与本章开头形成呼应或反差。
+
+**常见误判**：
+- 只要最后一句短就标“有”；
+- 结尾只是总结本章，没有新信息/新压力；
+- 把“下一章标题”当成结尾收束。
+
+**网文例子**：
+> “这剧本，好像有些不对劲啊！”——用人物判断点明异常，不解释原因，把“哪里不对”留给下一章。
+
+---
+
+### 9. 句式变化
+
+**是什么**：句子长度、结构、语气、重复、排比、短促/舒缓的交替。
+
+**判定标准**：
+- 是否有长句解释与短句冲击的交替；
+- 是否用重复、排比、反问、倒装制造节奏；
+- 句式是否服务情绪/信息密度；
+- 是否避免全章同一句式。
+
+**常见误判**：
+- 把“用了比喻”当成句式变化；
+- 只统计句子长短，不看句式功能；
+- 全章都是短句也标“有”——那可能是单调，不是变化。
+
+**网文例子**：
+> 解释性长句写武科制度，紧接着“什么情况？”“啥情况？”两个短句写方平的震惊。长短交替制造认知落差。
+
+---
+
+### 10. 段落布局
+
+**是什么**：段落的长短、顺序、聚焦对象、留白和视觉节奏。
+
+**判定标准**：
+- 长段/短段是否按信息密度和情绪需要排列；
+- 每段是否只有一个焦点；
+- 是否用独立短段强调关键句；
+- 对话、动作、心理、环境是否分段清晰；
+- 是否有“视觉留白”让读者停顿。
+
+**常见误判**：
+- 把“分段多”当成布局好；
+- 一段里塞多个焦点也标“有”；
+- 只看排版，不看段落之间的逻辑推进。
+
+**网文例子**：
+> 课堂群像用较长段落铺陈，张浩爆料后切成短段和独立句，最后用一句“剧本不对”单独收束。段落长度跟着信息压力变化。
+
+---
+
+### 11. 场景转换
+
+**是什么**：叙事从一个场景切到另一个场景，包括地点、时间、人物焦点、社会情境或视角的变化。
+
+**判定标准**：
+- 地点变化：教室 → 网吧、家中 → 学校；
+- 时间变化：当天 → 次日、回忆 → 现在；
+- 焦点变化：方平 → 张浩/全班；
+- 情境变化：课堂 → 武斗现场、日常 → 考试；
+- 转换方式：硬切、过渡句、动作带转、对话带转、蒙太奇。
+
+**常见误判**：
+- 只要换段就标“有”；
+- 同一场景内换说话人不是场景转换；
+- 纯心理联想没有时空/焦点变化，不一定算场景转换。
+
+**网文例子**：
+> 方平在教室听同学聊武科，随后“去蓝天网吧查资料”——地点和行动目标都变了，这是场景转换。仅从方平的思考切到陈凡的台词，不算。
+
+---
+
+### 12. 情绪渲染
+
+**是什么**：通过感官、动作、心理、环境、对话、节奏把读者带进某种情绪。
+
+**判定标准**：
+- 是否写出情绪的身体反应/行为后果；
+- 是否用环境/细节映射情绪；
+- 是否通过压制—释放、期待—落空制造情绪波动；
+- 是否让读者能感到，而不是只被告知“他很愤怒”。
+
+**常见误判**：
+- 出现“愤怒/悲伤/震惊”等词就标“有”；
+- 情绪没有前因后果，直接抒情；
+- 用旁白总结情绪，没有场景支撑。
+
+**网文例子**：
+> 全班兴奋崇拜，方平却“满脸懵”“整个人都傻了”。用群体情绪反衬主角的孤立和不安，比直接写“方平很困惑”更有渲染力。
+
+---
+
+### 13. 张力构建
+
+**是什么**：读者感到“有事情悬着、必须看下去”的压力，来自未解决的冲突、风险、秘密、倒计时、期待或道德困境。
+
+**判定标准**：
+- 是否有明确的未解问题/风险/代价；
+- 读者是否知道“如果失败会怎样”；
+- 是否有多方目标冲突或信息差；
+- 是否在章节内持续加压，而不是一次性解释完。
+
+**常见误判**：
+- 把“冲突很激烈”当成张力——冲突是双方对立，张力是读者对结果的期待；
+- 只有危险，没有代价/不确定性，也不构成张力；
+- 把所有信息都解释完，张力消失。
+
+**网文例子**：
+> 方平只剩十五元，报名截止只剩两天，陈凡最多借十元——目标、资源、时间三重压力同时存在，读者会想知道他怎么凑钱。
+
+---
+
+### 14. 章节功能设计
+
+**是什么**：这一章在整本书/本卷/本单元里承担什么功能。
+
+**判定标准**：
+- 功能类型：开局、升级、打脸、揭示、转折、压制、呼吸、过渡、收束、埋伏笔、回收伏笔；
+- 本章结束后，主线/支线/人物关系/读者认知发生了什么不可逆变化；
+- 本章是否在为下一章/下一卷蓄力；
+- 如果删掉本章，故事会不会缺一块。
+
+**常见误判**：
+- 把“本章发生了很多事”当成功能；
+- 一章承担所有功能，等于没有重点；
+- 只写“过渡章”而不说明过渡了什么。
+
+**网文例子**：
+> 第 1 章的功能不是“介绍世界观”，而是“用认知错位制造悬念，并让主角确立考武科目标”。这是可被后续章节继承的功能。
+
+---
+
+## 二、跨章节实体设计
+
+### 1. 人物关系设计
+
+**是什么**：两个或多个人物之间稳定的互动模式，以及这种模式如何建立、变化、破裂、修复。
+
+**判定标准**：
+- 关系类型：亲属、同学、同桌、师徒、盟友、上下级、敌对、竞争、暗恋、利用；
+- 关系的不对称性：谁掌握资源/信息/权力，谁依赖谁；
+- 关系的交换：情感、利益、保护、背叛；
+- 关系的变化节点：第一次信任、第一次欺骗、第一次决裂；
+- 关系对行动的约束：因为这段关系，角色不能做什么/必须做什么。
+
+**常见误判**：
+- 两个人同框就标“有关系”——没有稳定互动模式不算；
+- 把“关系称谓”（哥哥/老师/老板）当成关系设计；
+- 只写“他们是朋友”，不写朋友关系带来的义务和代价。
+
+**网文例子**：
+> 方平与陈凡不只是“同桌”：陈凡提供武道规则解释和现实提醒，方平提供跨世界视角；两人资源都很紧，但陈凡愿意借出仅有的十元。关系里有信息交换、情谊和资源落差。
+
+---
+
+### 2. 势力结构
+
+**是什么**：一个组织/集团/门派/家族/国家/班级等实体的层级、成员、资源、目标、规则和外部关系。
+
+**判定标准**：
+- 层级：谁在上、谁在下、谁掌握决策权；
+- 成员：核心成员、边缘成员、卧底、叛徒；
+- 资源：钱、武力、信息、人脉、合法性；
+- 目标：这个势力要什么，怕什么；
+- 规则：入会、晋升、惩罚、交易规则；
+- 外部关系：盟友、敌人、中立、依附。
+
+**常见误判**：
+- 只有名字没有结构，不算势力设计；
+- 把“一个强者”当成势力——没有组织/资源/目标就不算；
+- 势力只在背景里被提到，没有行动和后果，也不算有效设计。
+
+**网文例子**：
+> 企鹅集团不是“一个大公司”四个字：它有跨省法人资格、武道强者、商业资源、与谷歌亚太区的竞争关系。这些结构决定了它如何压迫/拉拢主角。
+
+---
+
+### 3. 世界观设计
+
+**是什么**：这个世界的规则、力量体系、社会制度、资源逻辑、代价和限制。
+
+**判定标准**：
+- 规则：什么能做、什么不能做；
+- 力量体系：等级、晋升、克制、代价；
+- 资源：钱/气血/功法/名额如何获得和消耗；
+- 社会制度：法律、教育、阶层、职业；
+- 代价与限制：使用力量/资源要付出什么；
+- 例外：规则在什么情况下被打破。
+
+**常见误判**：
+- 只有名词（武科、宗师、八品）没有规则，不算世界观设计；
+- 规则只用于解释，不参与选择和冲突；
+- 规则可以随意打破，没有代价，等于没有规则。
+
+**网文例子**：
+> “武科”不是一句“有武道考试”：它有报名费、年龄上限、政审、体检、文化课线、区域录取差异、动态录取标准。这些规则共同制造了主角的资源困境。
+
+---
+
+### 4. 冲突设计
+
+**是什么**：两个或多个目标/利益/价值观之间的持续对立，以及它如何升级、转折、解决和留下后果。
+
+**判定标准**：
+- 双方要什么，为什么不能同时满足；
+- 赌注：失败会失去什么；
+- 升级：从口角 → 资源争夺 → 人身危险 → 关系破裂；
+- 压力来源：时间、资源、对手、规则、道德；
+- 解决方式：胜负、妥协、逃避、第三方介入；
+- 余波：冲突结束后，关系/资源/认知发生了什么变化。
+
+**常见误判**：
+- 一次争吵就标“核心冲突”——没有持续对立和赌注不算；
+- 把“困难”当成冲突——困难没有对手/阻力，不一定构成冲突；
+- 冲突解决后没有任何后果，等于没有真正发生。
+
+**网文例子**：
+> “方平要考武科”与“家里没钱、报名截止、陈凡只能借十元”构成资源冲突；它不是一场吵架，而是持续多章的目标—资源对立。
+
+---
+
+### 5. 主线支线结构
+
+**是什么**：贯穿全书/多卷的核心目标线，以及围绕它展开的支线，和两者的交织方式。
+
+**判定标准**：
+- 主线：主角最核心、最长线的目标/问题；
+- 支线：阶段性目标、关系线、势力线、身世线、副本线；
+- 交织：支线如何服务/阻碍/改变主线；
+- 节奏：主线推进与支线切换的比例；
+- 收束：支线是否回收，还是变成新主线。
+
+**常见误判**：
+- 把“事件列表”当成主线；
+- 支线很多但没有一条服务主线；
+- 主线目标中途换掉，却没有解释。
+
+**网文例子**：
+> 主线是“方平考武科、改变阶层处境”；支线包括“重生身份疑云”“特殊钞票能力”“与陈凡/家人的关系”。支线不是平行小说，它们不断给主线提供资源/阻力/信息。
+
+---
+
+### 6. 分卷节奏
+
+**是什么**：全书按卷/幕/单元切分后，每一卷的目标、升级曲线、高潮位置、呼吸位和卷末钩子。
+
+**判定标准**：
+- 每卷是否有独立目标和小高潮；
+- 卷内是否有升级/压制/释放的节奏；
+- 卷末是否留下更大的问题或新舞台；
+- 卷与卷之间是否有明确的实力/关系/地图/目标升级；
+- 是否有呼吸卷/过渡卷，避免连续高压。
+
+**常见误判**：
+- 只按字数切卷，没有节奏功能；
+- 每卷都是同一套“打脸—升级—换地图”，没有变化；
+- 卷末高潮与下一卷开篇没有因果连接。
+
+**网文例子**：
+> 第一卷“阳城备考”以武科报名/体检为小高潮，卷末把舞台推向“南江武大/更大势力”；第二卷再升级资源和对手。这是分卷节奏，不是简单分章。
+
+---
+
+### 7. 伏笔布局
+
+**是什么**：作者故意埋下、暂时不解释、让读者产生疑问，并在后续推进/回收的信息或物件。
+
+**判定标准**：
+- 埋设：读者能察觉到“这里有问题/不寻常”，但暂时得不到解释；
+- 类型：
+  - 一个当前读者不懂的术语/名词；
+  - 两个人之间未澄清的关系/称呼；
+  - 一件暂时没被派上用场的物品；
+  - 角色一句当前读者不理解的话；
+  - 一个异常能力/规则/身体反应；
+  - 一个看似无关的细节/新闻/传闻；
+- 推进：后续章节再次提到、部分解释、改变含义；
+- 回收：最终解释/兑现/反转，让前面的细节获得新意义；
+- 公平性：回收时读者能回溯到埋设点，而不是作者临时编。
+
+**常见误判**：
+- 所有“没解释的东西”都标伏笔——没有后续推进/回收意图的，不是伏笔；
+- 把“作者忘了解释”当成伏笔；
+- 伏笔埋得太隐蔽，读者完全没看见；
+- 伏笔回收时没有改变读者理解，只是补一句说明。
+
+**网文例子**：
+> “方平直呼马宗师之名，陈凡严肃纠正”——这里既埋了“武道礼制”规则，也埋了“方平为什么不懂”的身份疑云。后续“重生/记忆错位”回收了这条线。
+
+---
+
+### 8. 角色弧光设计
+
+**是什么**：一个角色在多章中，目标、认知、信念、立场、关系或行为模式发生的连续变化；也包括“不变型/稳定型”角色在压力下坚持同一内核的过程。
+
+**谁必须有页面**：
+- 本章有名字或稳定称呼、且有台词/行动/关系/目标/状态的角色；
+- 主角、反派、配角、家人、导师、对手、同学都算；
+- 即使本章没有明显变化，也要建/更新页面，在 `### 第X章` 写“本章保持什么状态/为什么没有变化”；
+- 只有没有名字、没有稳定称呼的一次性背景群众可以跳过。
+
+**判定标准**：
+- 起始状态：角色一开始相信什么、要什么、怕什么；
+- 触发事件：什么事件让他开始动摇/改变；
+- 变化过程：不是一次顿悟，而是多次选择、代价、反复；
+- 变化维度：目标、认知、道德、关系、身份、能力；
+- 不变型：外部压力很大，但角色仍坚持同一内核，也要写清“为什么不变/不变的代价”；
+- 代价：改变失去了什么；
+- 阶段状态：每一章结束时，他处在弧光的哪个位置；
+- 终点/当前状态：截至最新一章，他和最初有什么不同。
+
+**常见误判**：
+- 把“角色设定了性格”当成弧光——没有变化过程不算；
+- 把“能力升级”当成弧光——能力变强不等于认知/立场变化；
+- 只有一次情绪波动，没有持续影响，不算弧光；
+- 角色每章都变，没有稳定内核，也不可信。
+
+**网文例子**：
+> 方平从“谨慎旁观、先求证”到“主动报名、承担风险”，中间经过资源困境、家庭责任、知识短板、信息不足的反复检验。这是弧光，不是单纯“变强”。
+
+---
+
+## 三、判定边界速查
+
+| 容易混淆 | 区分 |
+|----------|------|
+| 冲突 vs 张力 | 冲突是双方目标/利益对立；张力是读者对未解决结果的期待 |
+| 冲突 vs 困难 | 困难是阻力；冲突有对手/对立目标/赌注 |
+| 伏笔 vs 未解释 | 伏笔有后续推进/回收意图；未解释可能只是作者漏写 |
+| 场景转换 vs 换段 | 场景转换必须有时空/焦点/情境变化；换段不一定 |
+| 对话技巧 vs 说话 | 对话要推进信息/关系/冲突/人物，才有技巧 |
+| 描写技法 vs 形容词 | 描写要调动感官/动作/细节/心理，不是堆形容词 |
+| 角色弧光 vs 能力升级 | 弧光是认知/目标/立场/关系变化；能力升级只是手段 |
+| 世界观设计 vs 名词 | 世界观要有规则、代价、限制、例外，不只是名词 |
+| 势力结构 vs 强者 | 势力要有层级、成员、资源、目标、规则 |
+| 主线 vs 事件 | 主线是贯穿多章的核心目标/问题；事件是单章发生的事 |
+
+---
+
+## 四、分析时的硬要求
+
+1. **先定义，后判断**：不确定某现象属于哪个术语时，回到本文件对照，不要自创定义。
+2. **有证据才写“有”**：每个“有”都要能指向本章的具体段落/对话/动作。
+3. **没有证据写“无”**：不要为了填满表格硬套。
+4. **区分“本章现象”和“跨章节实体”**：
+   - 本章的写法 → 按章技法；
+   - 跨章累积的人/势力/规则/冲突/伏笔/弧光 → 实体页。
+5. **跨章节实体只追加本章变化**：已有实体页只加 `### 第X章`，不要重写历史。
+6. **抽象规则不写原书专名**：可复用设计规则用“势力A/角色B/事件C”等占位符。

package/plugins/fancy-analyze/command-input.js

@@ -0,0 +1,65 @@
+/**
+ * fancy-analyze/command-input.js —— 命令输入的归一化与子命令识别。
+ *
+ * ## 为什么需要它
+ *
+ * 用户在输入框里粘进来的内容常带零宽字符：U+200B（零宽空格）最常见，
+ * 还有 U+200C/U+200D（零宽连接符）、U+2060（单词连接符）、U+FEFF（BOM）、
+ * U+00A0（不换行空格）。
+ *
+ * 这些字符 `trim()` 不会去掉（它们不是空白字符），所以精确比较必然落空。
+ * 实测用户输入过 `summary-status␣summary`（中间粘了 U+200B），
+ * 旧代码 `lowerInput === 'summary-status'` 判不出来，
+ * 于是这条命令**掉进了"普通模式"（按书名拆书）** ——
+ * 而拆书会调 llm_wiki 的 `sources/ingest` 接口，那条路**有破坏性**。
+ *
+ * 子命令判断失败时默认掉进一个有破坏性的分支，是很糟的默认行为。
+ * 所以这里做两件事：
+ *   1. 剥掉不可见字符；
+ *   2. 用**前缀匹配**认子命令 —— 用户手滑多打了几个字，意图明显是那个
+ *      子命令，不该被当成书名去拆书。真正认不出来的仍然按书名处理
+ *      （那才是默认用法）。
+ */
+
+/** 零宽空格 / 零宽连接符 / 单词连接符 / BOM / 不换行空格。 */
+const INVISIBLE_CHARS = /[\u200B-\u200D\u2060\u00A0\uFEFF]/g;
+
+/**
+ * 剥掉命令输入里的不可见字符，并去首尾空白。
+ *
+ * @param {string} input - 原始输入
+ * @returns {string} 归一化后的输入
+ */
+export function normalizeCommandInput(input) {
+  if (typeof input !== 'string') return '';
+  return input.replace(INVISIBLE_CHARS, '').trim();
+}
+
+/**
+ * 可识别的子命令。顺序有意义：前缀匹配时长的排前面，
+ * 否则 `summary` 会先于 `summary-status` 命中。
+ */
+const SUBCOMMANDS = ['summary-status', 'summary', 'resummary', 'status', 'fix'];
+
+/**
+ * 认子命令：归一化后按前缀匹配。
+ *
+ * @param {string} normalized - 已归一化的命令输入（小写）
+ * @returns {string|null} 子命令名；不是子命令时返回 null
+ */
+export function matchSubcommand(normalized) {
+  if (typeof normalized !== 'string' || normalized.length === 0) return null;
+  // 空格当连字符：`summary status` 与 `summary-status` 是同一个命令
+  const flat = normalized.replace(/\s+/g, '-');
+  for (const name of SUBCOMMANDS) {
+    if (flat === name) return name;
+  }
+  // 前缀匹配是**刻意设计**（手滑多打的字也认）：
+  // "summary-statussummary" 要能认出是 summary-status。
+  // 2026-10-27 复核后确认：这是有意的容错，不改
+  // （收紧成"必须带分隔符"会把这份容错一起收掉）。
+  for (const name of SUBCOMMANDS) {
+    if (flat.startsWith(name)) return name;
+  }
+  return null;
+}