poi-plugin-kcps-terminal

主页

介绍

这是为 KancollePlayerSimulator Kai/Evol （以下简称KCPS）提供支持的poi浏览器插件。

安装方法见下方安装一节。

它启动一个http服务器，客户端（KCPS）使用Get方法配合参数获取需要的数据。

（这个仓库只与该插件相关，讨论KCPS的内容请至KCPS的仓库）

提供支持的接口包括：

• 鼠标动作
• 截取画面
• 刷新页面
• 获取数据

考虑到KCPS的目标不只是在poi浏览器上使用，因此保持较少的通用接口且（尽量）不特定于浏览器的返回内容是有必要的。

可供修改的选项：

• 端口

  http服务器监听端口，用于与脚本本体通信。

• 口令

  简易的认证机制。原理简单，便于移植。明文通信，虽不能防止中间人窃听，但可以给非要在公网计算机上运行插件的人一种保护机制。

• 缩放

  返回画面相对于游戏默认画面大小(1200×720)的比例。传输前会按这个比例将截图缩放，因此影响画面质量的首先是浏览器自身的画面大小。这会影响传输带宽、判断的准确性。这里以默认画面大小为标准的好处是在随意改变窗口大小时返回的图片分辨率也是固定的（实际上KCPS不要求返回的画面大小固定）。

• JPEG质量

  设置返回JPEG格式图片的质量。这会影响CPU占用、传输带宽、判断的准确性。

因为这些不属于与KCPS通信的接口的定义，因此不影响移植。

已知问题

• poi不可以最小化

  最小化后游戏画面会停止渲染，无法正常获取图像。最小化不可以，但被其他应用遮挡是可以的。

• poi分离模式下截图服务器会卡住

  这个是玄学问题，我没有JS开发经验，解决不了，据说可能是remote导致的。

• 系统显示设置开启HDR后无法截图

  开启HDR后，截图会变得一片黑。脚本就不能用了。不知道是哪里的问题。

• Windows保留端口可能导致服务器无法启动

  Windows的Hyper-V、WSL等功能会随机保留一些端口区间，默认端口5277也可能被覆盖，此时插件错误日志中会出现EACCES字样。可用管理员权限执行netsh interface ipv4 show excludedportrange protocol=tcp查看保留区间，然后在插件设置中改用一个未被保留的端口（不要忘记把KCPS中的端口设置改成一样的）；也可以用管理员权限执行netsh interface ipv4 add excludedportrange protocol=tcp startport=5277 numberofports=1把端口预先保留给自己，防止其被系统占用。

安装

本插件2.0.0及以上版本要求poi版本不低于10.7.0（更早版本的poi会自动安装本插件1.4.7版）。

在poi浏览器“扩展程序”设置中输入本插件包名poi-plugin-kcps-terminal点“安装”就可以了。

安装（以及禁用后再启用插件）后必须刷新游戏，以让插件获得游戏api数据。

安装后使用任意网页浏览器访问localhost:5277/capture（也可以直接点击插件界面中的测试链接），这时可以看到游戏的截图，说明插件运行正常。

poi 10.7.0 的额外操作（poi 10.8.0 中已修复该问题，所以不再需要此处的步骤）

请按以下步骤修改用于启动poi浏览器的快捷方式（不建议修改开始菜单中的那个快捷方式；原因是，poi不知道为什么，每次启动都要重写开始菜单的快捷方式，所以你如果改了那个快捷方式就是白改了；比如可以在桌面上新建一个快捷方式再改）：

• 打开poi快捷方式所在文件夹。
• 打开poi快捷方式的“属性”窗口（右键单击，选择“属性”）。
• 修改目标(T):，在原有内容的末尾添加内容 --disable-site-isolation-trials --disable-features=CalculateNativeWinOcclusion（比如，将“C:\Program Files\poi\poi.exe”改为"C:\Program Files\poi\poi.exe" --disable-site-isolation-trials --disable-features=CalculateNativeWinOcclusion，注意"和--之间有空格）。
• 点击“确定”保存修改。
• 在此之后请始终使用此快捷方式启动poi。

不进行此修改会导致KCPS无法执行鼠标动作而后报错多次点击失败（10.7之前版本的poi默认自带这个修改，所以该问题仅在10.7版开始出现）。

开发

我在这之前几乎从没接触过Web开发，JavaScript更是过去尝试去学了几次都失败了。

这么几行代码也要捣鼓几天才做出个基本的样子。

Github其实我也不是很会用。

要干的事还不少……

欢迎有兴趣的朋友在此基础上继续开发。

因发现同行抄袭还不公开源代码，许可变更为GPL，以从道义上避免后续再出现该类状况

更新记录

2.0.0

• 使用TypeScript重写，源代码模块化，构建后仍为单文件
• 全新设置界面（使用poi内置的Blueprint组件库）：端口和缩放在失焦或回车时才生效（避免输入过程中服务器反复重启）、JPEG质量改为滑块、支持一键生成随机口令
• 界面中显示服务器运行状态、截图测试链接（可复制）与错误日志
• 查询不到数据时返回合法JSON（null），修复部分接口返回undefined字符串的问题
• 修改端口后正确断开旧连接
• /mouse缺少参数时返回400而不是点击(0,0)
• 新增/version接口（无需口令），返回插件版本与支持的协议列表，供未来协议协商使用
• 最低支持的poi版本为10.7.0

1.4.7

• 尝试定位有些用户用10.6版以上poi时获取数据时报错传入undefined的问题。

1.4.5 & 1.4.6

• 适配poi 10.7.0

1.4.3 & 1.4.4

• 修复不能正确记录基地航空队任务变更的Bug

1.4.2

• 移除了WinAPI功能

1.4.1

• 适配electron 8.3.0

1.4.0

• 适配poi10.5中新版electron的新截图API，同时兼容旧版poi
• 支持新旧最多两种winapi鼠标操作本机代码库

1.3.2

• 适配electron 6.1.5

1.3.0~1.3.1

• 增加联合舰队类型api

1.2.3

• 修复了“基于Windows操作系统API的鼠标模拟机制”模式下系统缩放非100%时无法正确点击的Bug。