Smart Work Planner

### Features

| Module | What it does |

| Smart Assign | One click: reads every job's real workload (chop / harvest / dig markers, blueprints, production queues) and assigns priority slots 1–5 for all villagers at once. Busy jobs get 1 worker first, more slots as workload grows; Hauling is held at 3 workers as the lowest priority. |

| Auto Adjust | With Auto:On, priorities are re-sorted automatically whenever work appears or disappears (tree/harvest/dig/fish marks, blueprint placement) plus an hourly in-game fallback. Nothing is written when the plan hasn't changed (no jitter). |

| Training Mode | Tick the checkbox on a job column and its slot goes to the lowest-skill villager (priority 1) so they level up on the job. Only villagers who like the job (Eager/Passionate) and are below the cap qualify. |

| Skill Cap Slider | Focus training mode: one trainee is locked in until they reach the cap (1–50, default 20), then they return to normal duty and the next lowest-skill villager takes over. Balanced mode simply re-picks the lowest each round. |

| Worker Lock | Checkbox next to each villager's name: their whole row is excluded from auto-assign — you manage it manually. |

| Exclusive Cook & Researcher | The Cook and Research columns are reserved for the single highest-skill villager (must pass the workstation's required-skill check); everyone else's cell is emptied so they stop being pulled away. If nobody meets the skill requirement, the column falls back to normal (all 5). |

### How to Use

1. Install BepInEx 5. 4. 23+ (x64), drop `SmartWorkPlanner.dll` into `BepInEx/plugins/`.

2. In game, open the vanilla Work panel — the Smart Assign / Auto buttons, Training button, Skill Cap slider and legend appear at the top and bottom-left; a lock checkbox appears beside each name.

3. Click Smart Assign for an instant redistribution, or toggle Auto:On to keep it updated all game.

4. Tick the train checkbox on columns you want to level up, choose Balanced/Focus and set the cap slider.

5. UI text follows the game language (11 languages). Customize strings in `BepInEx/config/SmartWorkPlanner.lang.json`.

### Good to Know (actual behavior)

- "I clicked Smart Assign but nothing changed."

- Columns with no active work are left alone — a row of 5s is the correct result, not a bug.

- Villagers already at their target priority are not rewritten (idempotent); only real changes are written.

- Locked villagers' rows are never touched.

- Rest / Patient / Urgent Haul / Firefight columns are always left to the vanilla game.

- "His priority is 1, why is he doing something else?"

- Vanilla GOAP rule: a job already in progress is never interrupted by re-prioritizing. The villager finishes the current goal, then picks the next job by the new priorities.

- Equal priorities are executed left-to-right (vanilla rule) — a same-numbered column further left wins the tie.

- Who becomes the cook / researcher? The absolute highest skill in the settlement, filtered by the workstation's required-skill check; stars (Eager/Passionate) and current-job hysteresis only break ties.

- Do the stars (Eager/Passionate) matter? Yes — they add a tie-breaking bonus when picking workers; for the exclusive Cook/Researcher, raw skill level always comes first.

- Safe to add/remove anytime. The mod only writes the game's own job priorities (exactly like editing the panel by hand); removing it keeps the last assigned state. No save-file structures are touched.

| 板块 | 说明 |

| 智能安排 | 一键读取每项工作的真实工作量（砍树/采收/挖矿标记、蓝图、生产队列），立即为所有村民分配 1~5 档。有活的行业先给 1 人，工作量越大名额越多；搬运固定 3 人垫底档。 |

| 自动调整 | 开启后，工作出现/消失（标记增删、蓝图摆放）时自动重排，游戏内每小时兜底核对；计划无变化时不写入，避免抖动。 |

| 训练模式 | 在工作列上勾选后，该列名额给技能最低的村民（1 档），干活练级。候选人须"喜欢"这份工作（Eager/Passionate）且技能未达上限。 |

| 技能上限滑条 | 养号模式：锁定一名学员练到上限（1-50，默认 20）即毕业回常规档，下一个最低技能者顶上；平衡模式每轮重选最低者。 |

| 角色锁定 | 村民名字旁的勾选框：整行排除在自动分配之外，完全手动管理。 |

| 厨师/研究员专职独占 | 这两列只保留全据点技能最高的一人（须过工作台技能门槛），其余人的该列清空，不再被拉去打杂；若无人达标，该列自动回退全员 5。 |

1. 安装 BepInEx 5. 4. 23+（x64），将 `SmartWorkPlanner.dll` 放入 `BepInEx/plugins/`。

2. 进游戏打开原版工作面板：顶部有智能安排/自动按钮，左下角有训练按钮与上限滑条，每个名字旁有锁定勾选框。

3. 点智能安排立即重排一次，或打开自动:开全程托管。

4. 想练级的列勾上训练，切换平衡/养号并调好上限滑条。

5. 界面文字跟随游戏语言（11 种），可在 `BepInEx/config/SmartWorkPlanner.lang.json` 自行修改。

### 实际情况说明（重要）

- "点了智能安排没变化？"

- 没有活干的列不会降档——全员 5 就是正确结果，不是失效。

- 已在目标档位的村民不会重写（幂等），只写真正需要的变化。

- 锁定的村民整行不碰。

- 休息/病人/紧急搬运/消防四列永远交给原版逻辑。

- "明明设了 1，为什么还去干别的活？"

- 原版 GOAP 机制：正在执行的活不会被重新调优先级打断，干完当前目标后才按