Python集成文档

[Cassy-Lee]

期待Python的文档，毕竟python算是最常用的解释语言之一了
话说以后会不会有插件形式的支持？就是启动后通过python、js、lua这样的简单解释语言来添加复杂action和复杂recognition
另外，AdbController似乎有一个用于extras设置的config参数，能不能直接包装成参数，或者直接做成一个拓展（毕竟extras实际上和adb关系不大，并且似乎可以用于点击屏幕）？或者至少json不要套那么多层？

[Cassy-Lee]

如果单独写文档麻烦，也可以直接用python的文档功能，给每一个类和函数加上详细标注，然后通过某种方式生成或者直接指出可以用pydoc查看

[neko-para]

话说以后会不会有插件形式的支持？就是启动后通过python、js、lua这样的简单解释语言来添加复杂action和复杂recognition

目前MaaFw应该是不会计划直接嵌入某一个特定语言的解释器; 现阶段, ExecAgent可以视为一个替代品, 即通过启动指定进程作为自定义任务的载体.

另外，AdbController似乎有一个用于extras设置的config参数，能不能直接包装成参数，或者直接做成一个拓展（毕竟extras实际上和adb关系不大，并且似乎可以用于点击屏幕）？

AdbController的配置中的config参数, 目前用于两个方向;

• 对于非EmulatorExtra模式, 该部分可以覆盖特定操作的进程命令(例如, 针对某种模拟器, 需要用特殊的进程命令才能连接, 而不是普通的adb connect)
• 对于EmulatorExtra模式, 该部分提供了模拟器特定的配置参数;
  • 例如, 对于Mumu, 需要通过这个参数来指定目标模拟器的一些信息, 比如多开

通常情况下, 这个参数只需要直接透传从toolkit侧获取的信息即可.

这个不是用于点击屏幕, 而是点击屏幕的命令可以用这个参数进行覆盖替换.

或者至少json不要套那么多层？

没看懂什么套那么多层.

如果单独写文档麻烦，也可以直接用python的文档功能，给每一个类和函数加上详细标注，然后通过某种方式生成或者直接指出可以用pydoc查看

目前文档确实很欠缺, 倒不是某种语言缺失, 主要是目前MaaFw整体逻辑结构比较缺; 各个语言的binding基本还是和C接口保持同步的.

可以看看等一下 #283 (虽然也不一定有用)