用途:为项目创建或更新 cspell 拼写检查配置,把项目专有词汇加入配置、按字母排序,并补充与项目忽略文件一致的 ignorePaths。
主要能力:检测项目语言与包管理器;确定 cspell 的安装方式与版本;找到项目任务运行器中的拼写检查脚本并以其为权威命令;解析实际生效的基础配置与逐文件覆盖配置;识别自定义词典及其启用状态;运行拼写检查、归类未知词、过滤十六进制或 Base64 等噪声;将词汇写入权威配置的 words 数组或活动词典;按字母排序并去重;补充忽略路径;最后重新运行并报告前后对比。
使用方式:先检查工作区根目录文件确定项目上下文,确认 cspell 可用(如 cspell --version 或 npx),记录版本;优先使用项目已有的拼写检查脚本,捕获其工作目录、文件 glob、--config 及配置搜索相关参数;用宽泛 glob 盘点候选配置文件,按命令实际加载情况确定权威配置;收集 dictionaryDefinitions 与活动词典;运行 cspell 收集未知词;筛选后写入权威目标;再次运行同一命令验证。
适用场景:需要为多语言项目维护拼写检查配置、减少误报、统一项目专有词汇与忽略路径时。
限制:资料描述的是 cspell 10.x 行为,项目固定其他主版本时需按该版本文档或实际输出确认;配置权威由调用命令决定,文件枚举顺序不构成权威;词典仅在有效配置启用时才生效;若无法确定唯一写入目标,应停止并询问用户,不应猜测;未提供具体收费、平台或效果数据。