拼音搜索(Pinyin+English)

Pinyin Search 是《幸福工厂》的客户端搜索增强模组，支持使用拼音、首字母或混合拼音查找中文物品和建筑名称，也支持使用英文别名搜索。

仅客户端（Client-side only）：安装在需要使用增强搜索的玩家客户端，专用服务器无需安装。

重要说明：Codex／快速查找的结果范围

Codex 和 FICSIT 快速查找会先将输入转换为一个中文搜索词，再调用原版搜索，不会合并同一拼音输入对应的所有候选。例如，`tb` 不保证同时列出“铁板”“铁棒”“铜板”等不同词组的全部结果。这属于当前版本的功能范围，不表示模组未生效。

一个中文搜索词仍可返回多个物品或配方。查找指定物品时，建议输入更完整的拼音、混合拼音或直接输入中文名称，例如 `tieban`（铁板）、`tiebang`（铁棒）、`tongban`（铜板）。

如果更具体的查询仍出现异常、结果明显无关、无法点击或发生崩溃，仍欢迎反馈。

功能与入口

支持位面存储、Codex 物品／配方搜索、FICSIT 快速查找，以及无人机“所有平台”和目的地下拉框。

| 输入示例 | 用途 |
| --- | --- |
| `tieban` / `tban` | 查找铁板相关结果 |
| `qianghtb` | 查找强化铁板 |
| `zzh` / `zuzhuang` | 查找“组装”相关结果 |
| `circuit board` | 使用英文别名查找电路板 |

总开关、拼音搜索、英文别名三个设置默认开启，可在模组配置页面分别关闭。原有中文查询仍可使用。

无人机平台按实际站名匹配，不会自动给任意自定义站名生成英文翻译。

安装与兼容范围

需要使用增强搜索的玩家在自己的游戏客户端安装即可。使用 Satisfactory Mod Manager（SMM）时，请选择自己的游戏客户端作为安装目标，而不是专用服务器。

当前发行包仅提供 Windows 客户端版本，不提供专用服务器版本。请勿将本模组的客户端插件目录复制到专用服务器。

“仅客户端”不代表不能联机使用；本模组已在联网客户端进行测试，具体环境及验证范围如下。

依赖声明为 SML `^3.12.0`，游戏版本范围为 `>=502094`。

已测环境： Windows Steam、游戏 CL502094、SML `3.12.0+dev.801e40c3` 的联网客户端。

功能冻结基线已验证非空筛选中的数量变化、搜索结果点击、无人机部分生成失败后的回退，以及同一游戏进程内重新加入服务器。正式 `1.0.0` 运行包也已完成加载、英文别名查询及正常退出检查。

Epic 客户端及公开 SML 构建尚未独立实机验证。

生成对应 DLL 或依赖页面存在，不等于实机验证完成。后续游戏或其他模组改变相关界面结构时，可能需要适配；上述版本范围不是对所有未来更新的兼容保证。

已知边界与反馈

部分界面操作可能伴随脚本告警。已完成的定向测试未发现这些告警对应的数量显示、结果点击、列表回退或目的地选择异常，但不代表所有告警的根因均已消除。

问题反馈邮箱： [[email protected]](mailto:[email protected])

反馈时请提供模组版本、游戏 CL、SML 构建、Steam／Epic 平台及复现步骤。搜索异常请注明发生的界面、查询文字、预期结果与实际结果；崩溃或其他异常可附对应运行日志。

发送或公开日志前，请检查并移除账户信息、服务器地址及连接票据等敏感内容。

致谢与第三方许可

拼音查询采用本地读音数据。第三方许可文本已随插件放入 `ThirdPartyNotices` 目录。

Network Activity Transparency（网络活动披露）

本模组的搜索在本地完成，不新增外部 API 调用、遥测上传或在线翻译请求。游戏及 SML 本身的正常联网行为不属于本模组新增的外部网络请求。

AI Usage Transparency（生成式 AI 使用披露）

本模组使用 GPT-6 Astra Pro 辅助生成、修改及审查源代码和 PowerShell 构建／安装工具，并辅助整理测试方案、文档、网页介绍及更新说明。模组图标通过 ChatGPT 的图像生成功能制作。游戏内测试由作者执行并确认结果。模组运行时不调用生成式 AI 服务。