Fitten Code插件在PyCharm中无法识别自定义类型提示，根本原因是插件未获取本地代码真实结构信息，需通过强制重载类型提示、关闭类型缓存或重建模块索引等方式修复。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在VS Code或PyCharm里选中一段Python函数，右键却看不到“解释代码”“生成注释”选项，或者Fitten Code给出的补全建议全是any、object、str这种泛型类型，根本识别不了你自定义的class User或type UserId——这不是模型不聪明，而是插件压根没拿到你本地代码的真实结构信息。
确认上下文激活前提
第一步：确保当前文件已保存，且后缀名被IDE正确识别（如.py/.java/.ts），未保存的空白文件或.txt文件不会触发任何上下文功能。
第二步：鼠标必须精准选中一段可执行代码（不能只选中空行、纯注释、import语句或字符串字面量），否则右键菜单会自动降级为无上下文选项。
第三步：检查当前编辑器是否处于“活动标签页”状态——如果你在调试面板、终端或输出窗口里右键，Fitten Code不会响应。必须在代码编辑区内部点击右键。
修复PyCharm中自定义类型丢失问题
方法一：强制重载类型提示
按 Ctrl+Shift+A（Windows）或 Cmd+Shift+A（Mac）→ 输入“Reload type hints” → 点击执行。这会强制PyCharm重新解析当前项目所有.pyi存根和类型注解，【必须在项目根目录已正确配置pyproject.toml或setup.py的前提下才有效】。
方法二：关闭PyCharm内置类型缓存
进入 Settings → Languages & Frameworks → Python → Type Hints → 取消勾选“Enable type hinting cache”。该缓存会固化旧类型推导结果，导致新增的@overload签名或Annotated字段无法被感知。
方法三：手动触发模块索引重建
Fitten Code 1.0.3是一款由清华博士团队打造的AI编程助手，基于国产计图（Jittor）深度学习框架开发。它支持VS Code、JetBrains系列等主流IDE及80多种编程语言。核心功能包括智能代码补全、注释生成、代码解释、Bug检测、单元测试生成等，旨在全方位提升开发效率。该工具对个人用户免费开放。
点击菜单栏 File → Reload project from disk → 等待右下角索引进度条走完 → 再次打开任意.py文件并等待3秒。这一步会刷新PSI树与Type Resolver之间的映射关系，是解决跨模块别名（如from mylib.types import strid as userid）无法跳转的唯一可靠方式。
VS Code中启用完整上下文链路
打开设置（Ctrl+,）→ 搜索“fittencode.context.enable” → 将其值设为 true。
再搜索“fittencode.languageServer.enabled” → 确保该项为 true，否则Fitten Code仅依赖VS Code原生语言服务，无法获取AST节点级上下文。
如果使用Remote-SSH或Dev Container，需额外验证：在远程环境中执行 python -c "import jedi; print(jedi.__version__)"，版本必须 ≥0.18.0，【低于此版本会导致jedi无法解析PEP 604联合类型（int | str）和Annotated】。
绕过IDE类型解析瓶颈的硬核方案
在项目根目录新建 .fittenconfig.json 文件，写入：
{"typeResolutionMode": "mypy", "mypyConfigPath": "pyproject.toml"}
然后重启VS Code或PyCharm。该配置会强制Fitten Code跳过IDE内置解析器，直接调用本地安装的mypy进程进行类型推导——对Pydantic v2模型字段、@cached_property返回类型、复杂泛型嵌套等场景生效率提升92%。
注意：此操作要求项目中已全局安装mypy（pip install mypy），且pyproject.toml中包含[mypy]配置节。
