2. 配置（可选）

name / label 不用填（自动从图集文件名推导）。只有需要改尺寸、归一化、气泡文案等时才建 config.json：

Copy-Item config.example.json config.json

config.json 字段（name/label 可省略，缺省取图集文件名）：

字段	说明	默认
`name`	插件名（也是 node_modules 目录名 / 注册名）	图集文件名
`label`	悬浮层里显示的标签	图集文件名
`spritesheetPath`	图集相对路径	自动检测
`spriteVersionNumber`	图集版本：`1`（8×9）或 `2`（8×11，含注视帧）	自动检测（按图集尺寸 1872/2288）
`size`	显示宽度 px	`120`
`pin`	初始位置（`bottom-right` / `bottom-left` / …）	`bottom-right`
`normalize`	可选：逐行尺寸归一化 `[null, …, { s, cx, cy }, …]`	无
`look.enabled`	是否开启「眼睛跟随鼠标」；旧版桌宠（无注视帧）设为 `false`	`true`
`look.deadzone`	注视死区（px，指针距桌宠中心小于该值不触发）	`28`
`bubble.enabled`	是否显示进度气泡	`true`
`bubble.maxChars`	流式文本截取长度	`140`
`bubble.runningText`	工具运行时文案（`{tool}` 会被替换成工具名）	`运行中：{tool}…`
`bubble.workingText`	工作但无工具名时的文案	`工作中…`
`bubble.thinkingText`	思考时的文案	`思考中…`

💡 版本自动识别：build.js 会按图集尺寸自动判断 v1/v2——高 1872px = v1 （9 行，无注视帧，自动关闭鼠标追踪），高 2288px = v2（11 行，含 16 方向注视帧，自动开启鼠标追踪）。所以一般不需要手动设 spriteVersionNumber；只有当你的图集不是标准尺寸时，才需要在 config.json 里显式指定。

codex-to-dsh-pet

安装

说明文档

2. 配置（可选）