插件功能无效主因是版本不兼容或API地址失效，需依次检查Typora版本适配性、更新硬编码的v4接口地址、注入兼容层补丁、切换社区维护分支，并在必要时禁用插件签名验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在Typora中启用DeepSeek V4相关插件后发现功能完全无效，既无响应也无报错提示，则很可能是插件自身版本过旧，或其内部硬编码的API接口地址已失效。以下是解决此问题的步骤：
一、确认插件是否适配当前Typora版本
Typora自1.10版本起对插件系统进行了深度重构，包括Worker线程策略收紧、API命名空间变更及HTTP请求拦截增强。旧版DeepSeek V4插件若未更新至兼容Typora 1.10+的构建，将无法注册服务或发起有效请求。
1、打开Typora，进入「帮助」→「关于Typora」，查看当前版本号（如1.11.18）。
2、定位插件目录：Windows路径为 %APPDATA%\Typora\plugin\custom\plugins\deepseek-v4\，macOS为 ~/Library/Application Support/Typora/plugin/custom/plugins/deepseek-v4/，Linux为 ~/.config/Typora/plugin/custom/plugins/deepseek-v4/。
3、检查该目录下是否存在 package.json 文件，并打开查看其中的 "typoraVersion" 字段值是否 ≥ 当前Typora主版本号（例如 "1.11.0"）。
二、手动更新插件核心接口地址
部分DeepSeek V4插件仍使用已停用的旧版API端点（如 https://api.deepseek.com/v1/chat/completions），而新版要求强制使用 https://api.deepseek.com/v4/chat/completions 或带身份校验的代理路由。插件若未动态读取配置，会直接硬编码失效地址。
1、在插件目录中找到 index.js 或 main.js 文件。
2、用文本编辑器打开，搜索关键词 "https://api.deepseek.com" 或 "/v1/chat"。
3、将匹配到的旧URL替换为："https://api.deepseek.com/v4/chat/completions"。
4、同时查找并修改请求头中 "Authorization" 字段的构造逻辑，确保其格式为 "Bearer YOUR_API_KEY"，而非旧式 "Token YOUR_API_KEY"。
三、注入运行时兼容层补丁
当插件依赖已被移除的Typora内部模块（如 window.typora.app.file.getFilePath()）时，需通过自定义JS注入方式模拟缺失接口，避免执行中断。
1、在Typora安装目录的 resources/app/plugin/core/ 下新建文件 deepseek-compat.js。
2、写入以下内容：
if (!window.typora?.app?.file?.getFilePath) { window.typora = window.typora || {}; window.typora.app = window.typora.app || {}; window.typora.app.file = { getFilePath: () => window._options?.filePath || "" }; }
3、打开 %APPDATA%\Typora\plugin\global\settings\custom_plugin.user.toml，在末尾添加：
[pluginLoader] inject = ["deepseek-compat.js"]
四、切换至社区维护的替代插件分支
原DeepSeek V4插件官方已停止维护，但社区存在多个持续更新的Fork版本，它们已适配Typora 1.11系列并内置V4专用请求封装。
1、访问GitHub镜像仓库：https://gitcode.com/gh_mirrors/de/deepseek-typora-plugin。
2、下载最新Release中的 deepseek-v4-typora-1.11.x.zip 压缩包。
3、解压后，将整个文件夹重命名为 deepseek-v4，覆盖原插件目录。
4、重启Typora，在「编辑」→「插件」→「DeepSeek V4」中检查状态灯是否变为绿色。
五、禁用安全策略强制加载未签名插件
Typora 1.11.16+默认启用插件签名验证，若插件未经过官方签名，即使代码正确也会被静默屏蔽。需临时关闭校验以验证功能是否恢复。
1、关闭Typora进程，确保无后台残留。
2、打开注册表编辑器（regedit），导航至：HKEY_CURRENT_USER\Software\Typora。
3、右键空白处 → 新建 → DWORD (32位) 值，命名为 disablePluginSignatureCheck。
4、双击该值，将“数值数据”设为 1，点击确定。
5、重新启动Typora并启用插件。
