Sphinx递归自动摘要:重复对象的警告，:noindex:选项会破坏链接

如果Sphinx recursive autosummary（Sphinx递归自动摘要）出现重复对象的警告，可以尝试添加:noindex:选项以在索引中忽略重复项，但这会破坏链接。解决此问题的一种方法是在conf.py文件中添加如下代码：

from sphinx.ext.autosummary import Autosummary
from sphinx.util.inspect import safe_getattr

class UniqueAutosummary(Autosummary):
    def get_items(self, names):
        items = {}
        for refname in names:
            items[refname] = safe_getattr(self.env.resolve_xref(refname, self.builder, self.current_docname), 'canonical_name', None) or refname
        return list(set(items.values())), items

def setup(app):
    app.add_config_value('autosummary_generate', True, 'html')
    app.add_config_value('autosummary_generate_overwrite', False, 'html')
    app.add_directive('unique-autosummary', UniqueAutosummary)

然后，使用:unique-autosummary:替换:autosummary:，生成唯一的自动摘要。例如：

.. unique-autosummary::
   :toctree: generated

   my.module.function1
   my.module.function1
   my.module.function2

这将生成一个唯一的自动摘要，其中重复的条目被忽略，并且链接仍然有效。