-
Notifications
You must be signed in to change notification settings - Fork 97
Troubleshooting
这页按问题类型整理。排障时优先复现一个最小场景，不要同时改多个配置。
| 问题 | 优先检查 |
|---|---|
| DeepSeek++ 侧边栏没有出现 | 扩展是否启用、当前页面是否支持、浏览器是否重启 |
| DeepSeek 页面提示未登录 | 当前浏览器 profile 是否已经登录 DeepSeek Web |
| 右键菜单不工作 | 是否选中文本、入口是否启用、普通网页是否配置 API Key |
| web search / web fetch 失败 | 工具开关、网络、站点权限和目标网页可访问性 |
| MCP tools 失败 | MCP 服务是否运行、连接测试是否通过、工具列表是否刷新 |
| Shell MCP 失败 | Shell Native Host、浏览器类型、扩展 ID 和重启状态 |
| conversation export 异常 | 当前会话、导出格式、浏览器下载权限和附件状态 |
| project context 没生效 | 项目资料是否启用、资料是否和当前任务相关、是否进入了正确会话 |
| artifact download 异常 | 文件名、浏览器下载权限、产物内容和是否被安全策略拦截 |
先检查：
- 是否已经安装并启用扩展。
- 当前页面是否是 chat.deepseek.com 或扩展支持的页面。
- 浏览器扩展管理页是否有错误提示。
- 是否重启过浏览器。
如果是手动加载 Release 包，确认加载的是解压后的扩展目录，而不是 zip 文件本身。
回到 DeepSeek 网页版 完成登录，再刷新页面。侧边栏对话如果依赖 DeepSeek 页面登录态，也需要当前浏览器 profile 已登录。
如果你想在普通网页使用侧边栏对话和右键场景，请在设置页配置官方 API Key。
检查：
- 是否选中了文本。
- 当前页面是否允许扩展注入。
- 是否已在设置里启用相关入口。
- 普通网页是否已配置官方 API Key。
- 浏览器是否刚安装扩展但还没重启。
检查：
-
工具页对应工具是否启用。 - 当前网络是否能访问搜索源或目标网页。
- 网页读取是否需要站点权限。
- 目标网页是否需要登录、反爬或脚本渲染。
可以先用一个公开网页做最小测试，再回到原目标页面。
检查：
-
MCP页服务配置是否保存。 - 测试连接是否通过。
- 服务端是否正在运行。
- 本机防火墙、代理或端口是否阻断连接。
- 工具列表是否已刷新。
如果是 Shell 预设，先运行：
npx deepseek-pp-shell-host status --browser chrome按顺序检查：
- Shell Native Host 是否安装。
- 安装时使用的浏览器和当前浏览器是否一致。
- 安装时填入的扩展 ID 是否正确。
- 安装后是否重启浏览器。
-
MCP页 Shell 预设测试是否通过。 - 工具列表是否刷新。
重新安装：
npx deepseek-pp-shell-host install --browser chrome --extension-id <扩展ID>确认：
- Shell Native Host 可用。
- OfficeCLI 命令版已安装。
- 文档路径是真实本机路径。
- 当前任务没有使用占位路径。
- Skill 中的操作目标明确，例如检查、读取、修改或验证。
如果不确定本机路径，可以先让 Shell 工具列目录或检查文件是否存在。
确认：
- 当前版本是 0.6.4 或更新。
- Shell Native Host 已安装并测试通过。
-
工具页相关工具已启用。 - 本机 Python 环境可用。
先用非常小的表达式或脚本做 smoke test，再执行较复杂任务。
检查：
- 是否选择了正确项目。
- 目标资料是否已添加并启用。
- 当前任务是否明确需要这些资料。
- 资料内容是否只是文件名，缺少用途说明或关键摘要。
- 是否把长期偏好错误放在项目资料里，而不是记忆里。
建议用一个很小的问题测试，例如让 DeepSeek 总结当前项目资料中某条明确说明，再继续复杂任务。
检查：
- 浏览器是否允许下载。
- 文件名和扩展名是否合理。
- 任务是否要求生成单文件还是项目包。
- 输出是否包含不应进入文件的敏感信息。
- 多文件产物是否缺少 README、入口文件或必要配置。
如果只是摘录一条回答，优先用单消息 Markdown 导出；如果是完整对话归档，使用对话导出。
检查：
- 当前导出的是哪个 DeepSeek 会话。
- 选择的是 HTML、Markdown 还是 PDF。
- 是否开启可读模式。
- 消息中是否包含尚未支持完整正文导出的附件。
- 浏览器下载权限是否正常。
敏感对话导出后，分享前请手动检查文件内容。
检查：
- 任务是否启用。
- cron 或 RRULE 是否有效。
- 最小间隔是否低于 15 分钟。
- 浏览器是否保持运行。
- 对应 DeepSeek 会话是否还能打开。
- 任务卡片是否显示错误信息。
建议先点击“立即运行”确认任务本身可执行，再排查定时规则。
建议提供：
- DeepSeek++ 版本。
- 浏览器名称和版本。
- 操作系统。
- 复现步骤。
- 预期行为和实际行为。
- 不含敏感信息的截图或日志。
- 如果涉及项目上下文、MCP、本机工具或导出文件，提供脱敏后的最小示例。
反馈入口：GitHub Issues
The most common causes are that the extension is disabled, the browser has not been restarted, or the current page is not a supported DeepSeek++ page.
Check whether the MCP service is saved, running, reachable, tested successfully, and refreshed in the tool list. For Shell tools, also verify Shell Native Host installation and browser restart.
Check that the web search tool is enabled, the network can reach the search source, and the target page does not require unavailable login or site permissions.
Confirm the current DeepSeek conversation, export format, readable mode, browser download permission, and whether the message includes attachments whose file bodies are not yet exported.
DeepSeek++ wiki: open-source DeepSeek browser extension documentation for bilingual AI agent workflows, memory, Skills, project context, artifact downloads, MCP tools, web search, conversation export, and automation.