如何修改JupyterLab帮助弹窗显示属性？移除指定字段或调整顺序

问题场景 #

在JupyterLab中，多数类和函数的帮助弹窗仅展示签名（signature）与文档字符串（docstring），阅读体验正常。但Altair中像alt.X().bin这类通过属性setter创建的Bin类快捷方式，帮助弹窗会额外显示Call signature、Type、String form、File字段，严重干扰文档阅读；而直接查看Bin类（如alt.Bin?）的弹窗则显示正常。

需求目标 #

1. 移除帮助弹窗中的冗余字段；
2. 若无法完全移除，至少将文档字符串调整至签名之后。

已尝试操作 #

查看dir(alt.X().bin)返回的属性列表，未找到可直接调整弹窗显示的入口，属性列表如下：

['__call__',
 '__class__',
 '__delattr__',
 '__dict__',
 '__dir__',
 '__doc__',
 '__eq__',
 '__format__',
 '__ge__',
 '__get__',
 '__getattribute__',
 '__gt__',
 '__hash__',
 '__init__',
 '__init_subclass__',
 '__le__',
 '__lt__',
 '__module__',
 '__ne__',
 '__new__',
 '__reduce__',
 '__reduce_ex__',
 '__repr__',
 '__setattr__',
 '__signature__',
 '__sizeof__',
 '__str__',
 '__subclasshook__',
 '__weakref__',
 'cls',
 'obj',
 'prop',
 'schema']

注：该快捷方式由Altair的PR修改生成，核心逻辑在altair/utils/schemapi.py中，无法创建最小复现示例。

可行解决方案 #

临时方案：直接查看目标类文档 #

若仅需临时查阅文档，直接调用help(alt.Bin)或在Jupyter中执行alt.Bin?，即可获取无冗余字段的正常帮助弹窗。

手动修复单个属性 #

alt.X().bin本质是一个descriptor实例，Jupyter帮助系统会优先解析descriptor的元数据而非目标类的文档。可手动覆盖其文档和签名属性：

import altair as alt
from inspect import signature

# 获取Bin类的原始文档与签名
target_doc = alt.Bin.__doc__
target_sig = signature(alt.Bin)

# 覆盖快捷方式的属性
x_bin = alt.X().bin
x_bin.__doc__ = target_doc
x_bin.__signature__ = target_sig

修改后执行x_bin?，弹窗将显示正常的签名与文档字符串。

长期方案：修改Altair源码 #

在altair/utils/schemapi.py中，创建这类patched快捷方式的代码处，让descriptor实例自动继承目标类的文档和签名。例如在对应的Property类初始化方法中添加：

from inspect import signature

class Property:
    def __init__(self, cls, *args, **kwargs):
        self.cls = cls
        # 继承目标类的文档与签名
        self.__doc__ = cls.__doc__
        self.__signature__ = signature(cls)
        # 原有初始化逻辑...

这样所有通过该方式生成的快捷属性，都会自动同步目标类的文档信息，Jupyter帮助弹窗将默认显示正常内容。

内容的提问来源于stack exchange，提问作者joelostblom