为什么你需要 librime-python？
1. Python 是解释执行的脚本语言，因此可以在 rime 输入法的基础上动态地添加功能，而无需重新编译源代码、重启输入法程序，甚至无需重新部署。
2. 与 librime 本身使用的 C++ 语言相比，Python 提供了丰富的库函数，因此可以非常方便地拓展 rime 输入法的功能。Python 常见的应用场景包括字符串处理（自动纠错）、连接 HTTP 服务器（云输入）、深度学习（智能输入引擎）等。
输出当前日期：python_translator@datetime
过滤拓展区汉字：python_filter@charset
过滤前
过滤后
| 在输入方案中指定的组件名称 | 对应的 Python 脚本文件名 |
|---|---|
python_translator@<name> |
python/<name>.py |
python_filter@<name> |
python/<name>.py |
在 Python 脚本文件中按照下面的要求定义 rime_main 函数，即可实现相应组件的功能。
translator 要求 rime_main 函数的输入为 str，输出为 TranslatorAnswer 的列表。
其中，输入的 TranslatorQuery 为待翻译的內容，其中包含待翻译的输入码等多项信息；输出的列表为多个翻译结果，每一项为一个 TranslatorAnswer，其中包含 text、comment 等多项信息。
from dataclasses import dataclass
@dataclass
class TranslatorAnswer:
text: str
comment: str
def rime_main(translator_query: str) -> Optional[List[TranslatorAnswer]]:
...filter 要求 rime_main 函数的输入为 Candidate，输出为 FilterAnswer。
其中，输入的 Candidate 为翻译结果，其中包含text、comment 等多项信息；输出的 FilterAnswer 有三种：跳过（保持该翻译结果不变）、删除（将该翻译结果从候选列表中移除）和重写（修改翻译结果中的某些信息）。
# 什么也不做
def rime_main(candidate):
candidate.should_skip = True
return candidate
...cd archlinux
makepkg -si在编译时，Boost.Python 1.76.0 可能会报错，经过判断这是 Boost.Python 库本身的问题（见 boostorg/python issue #359），这时自行修改两个系统头文件即可正常编译。
FIXME：在 PKGBUILD 中，编译选项 -DBUILD_MERGED_PLUGINS=Off 被修改为 On，这是因为如果不修改，用户在 Python 脚本中 import math 会产生如下 ImportError。
ImportError: /usr/lib/python3.9/lib-dynload/math.cpython-39-x86_64-linux-gnu.so: undefined symbol: PyLong_AsLongLongAndOverflow
下一个版本修复。
FIXME：在 Windows 上遇到各种编译错误而失败，下一个版本修复。
Python 的脚本文件放在哪里？
rime 文件夹里的 python 文件夹。
我更新了 Python 脚本，应如何通知 rime 输入法？
重新部署，或者切换到其他方案再切回来。
我在某个方案中使用了 librime-python，但一选择那个方案，输入法就会崩溃，怎么知道哪里出了问题呢？
请查看 rime 的错误日志，目前崩溃的原因有：
- python 脚本语法错误
- 所 import 的库在你本地的 python 环境里找不到
不同的 Python 脚本文件中的变量会相互冲突吗？
FIXME：目前会相互冲突，因为 pybind11 不支持 sub-interpreter，下一个版本修复。
Q5. rime_main 函数会被调用几次？在什么时候被调用呢？
TODO：下一个版本补充。
Q6. 我想实现一个计数器的功能，应该如何使用全局变量？
TODO：下一个版本补充。
利用 pybind11。pybind11 提供了对 Python/C API 的 C++ 封装。对本项目而言，pybind11 提供的最重要的功能是在 C++ 代码中调用 Python 解释器。
如果你使用任何编辑器，请确保编辑器会读取项目根目录的 .clang-format，并在保存时自动格式化代码。
本项目是 Python 插件，因此遵守 Python 之禅：Explicit is better that implicit。
特别地，对于字符串类型，使用 std::string 的写法，而不使用 rime 定义的别名 rime::string，这是为了保证与 Python API 交互部分的代码不会引起误解。
由于本项目是输入法插件，当插件在运行时产生异常时，异常必须在插件内部处理完毕，不应该使输入法崩溃，且结果必须等价于插件不存在。
使用正确的现代 C++17 语法。
C++ 部分使用了哪些外部库？
使用了 pybind11。
librime-python 用的是 C++17，但 librime 是 C++14，是否会出现问题？
不会。
未来还需要做什么？
1. 修复上文提到的 bug；
2. 为 librime-python 自定义的简化版的接口添加更多功能，如读取输入法开关状态等；
3. 其他功能添加和优化。