better-deepseek

Better DeepSeek

Better DeepSeek is a browser extension that enhances the DeepSeek chat interface with a powerful set of tools, persistent memory, and a customizable system prompt. It enables DeepSeek to generate files, run code, create presentations, and manage complex projects directly within the conversation, all while keeping your data local and private.

“Better DeepSeek” is an unofficial, independent, and community-driven open-source extension. It is NOT affiliated with, endorsed by, sponsored by, or officially connected to DeepSeek or DeepSeek AI in any way. All product names, logos, and brands are property of their respective owners.

Showcase

Memory Management	Webpage Skills	Long Work
Persona Creation	Presentations	Attach Menu

Features

Hidden System Prompt

Inject a custom system prompt that guides DeepSeek’s behavior without cluttering the chat. The prompt is automatically injected into every conversation and can be edited from the extension’s settings panel.

Tool Tags for Enhanced Output

Better DeepSeek introduces a set of special tags that DeepSeek can use to produce rich, interactive content:

• <BDS:VISUALIZER>...</BDS:VISUALIZER> – Create high-contrast, monochrome simulations and interactive diagrams using a built-in UI kit.
• <BDS:create_file fileName="path/to/file.ext">...</BDS:create_file> – Generate a downloadable file with the specified name and content.
• <BDS:pptx>...</BDS:pptx> – Generate a PowerPoint presentation using the PptxGenJS library.
• <BDS:excel>...</BDS:excel> – Generate an Excel spreadsheet using SheetJS.
• <BDS:docx>...</BDS:docx> – Generate a Word document using the docx library.
• <BDS:GET>module</BDS:GET> – Load a tool’s full reference on demand (midi, docx, xlsx, pptx, office) before using it.
• <BDS:chart>...</BDS:chart> – Generate interactive charts and data visualizations using the declarative Vega-Lite specification.
• <BDS:AUTO:REQUEST_WEB_FETCH>url</BDS:AUTO:REQUEST_WEB_FETCH> – Automatically fetch and convert a web page to markdown, then inject it into the chat context.
• <BDS:AUTO:REQUEST_GITHUB_FETCH>url</BDS:AUTO:REQUEST_GITHUB_FETCH> – Automatically fetch a GitHub repository and inject its codebase into the chat context.
• <BDS:AUTO:SEARCH_IN_DIRECTORY queries="..."> – Search codebase directories for files and symbols (active when DeepCode is enabled).
• <BDS:AUTO:LIST_DIR path="..." depth="..."> – Inspect directory contents in connected workspace (active when DeepCode is enabled).
• <BDS:AUTO:FILE_READ path="..." startLine="..." endLine="..."> – Read specific files or line ranges from the connected codebase (active when DeepCode is enabled).
• <BDS:memory_write>key: value, importance: always|called</BDS:memory_write> – Store persistent facts about the user that are injected into future prompts.
• <BDS:character_create name="..." usage="...">...</BDS:character_create> – Define a roleplay persona that DeepSeek can adopt.

DeepCode (Experimental) & DeepSeek Harness Integration

Better DeepSeek introduces DeepCode, a collaborative code planning and inspection mode designed to work alongside DeepSeek Harness.

• Interactive Code Planning: Activate DeepCode to allow DeepSeek to explore codebases, inspect file structures with auto-tools (FILE_READ, LIST_DIR, SEARCH_IN_DIRECTORY), and draft structured implementation plans.
• DeepSeek Harness Handoff: Once a plan is formulated, easily send tasks directly to DeepSeek Harness for automated execution and testing.
• Plugin Integration: Install the dsh-better-deepseek plugin in DeepSeek Harness for complete end-to-end integration.

MCP (Model Context Protocol) Tool Access

Better DeepSeek supports the Model Context Protocol for connecting to remote MCP servers. When configured, the AI can discover and invoke tools from these servers automatically.

• Add a server: Open Settings → MCP Servers, enter the server URL and optional API key.
• Test the connection: Click “Test” to verify the server responds and list its available tools.
• How it works: Tool schemas are injected into the system prompt. When the AI outputs <BDS:AUTO:MCP url="..." tool="..." args='...'>, the extension calls the tool and injects the result back into the conversation as an attached file.

Note: Only secure HTTPS Streamable HTTP transport is supported. Plain HTTP, localhost, private network addresses, and stdio-based MCP servers are not supported.

LONG_WORK Project Mode

When building multi-file projects, DeepSeek can use the <BDS:LONG_WORK> tag. All files created inside this block are collected, zipped, and presented as a single download after the block closes. During generation, the user sees only a “Working…” indicator, keeping the chat clean.

Persistent Memory and Skills

• Memory: Store key-value facts about the user. “Always” memories are included in every request; “called” memories appear only when their key is mentioned.
• Skills: Upload markdown files that define custom instructions or behaviors. Skills can be toggled on and off from the drawer.
• Characters: Create and manage roleplay personas. Only one character can be active at a time.

Voice Support (STT & TTS)

Better DeepSeek now supports full voice interaction:

• Voice-to-Text: Dictate your prompts using the microphone button next to the chat input. Supports optional auto-submission for a hands-free experience.
• Text-to-Speech: Assistant responses can be automatically read aloud once generation is complete.
• Language Selection: Configure your preferred voice and recognition language directly from the extension settings.

Native Navigation

The DeepSeek logo and “New Chat” button have been transformed into native links, allowing for standard browser interactions such as “Open in New Tab” via right-click or Ctrl/Cmd+Click.

User Interface

A sleek drawer slides out from a floating button on the DeepSeek page. Inside you can:

• Edit the system prompt.
• Toggle auto-download behavior for files and LONG_WORK zips.
• Import, export, download, and manage skills.
• Import, export, and manage memory entries.
• Create, edit, download, and activate characters/personas.
• Define Claude-style Projects, define project-level instructions, and upload project files and attach them to chats.

Code Block Download Buttons

Every code block in DeepSeek responses gains a “Download” button, making it easy to save snippets with the correct file extension.

Advanced File Upload

The extension adds a “+” button next to the chat input, offering:

• Upload a folder (concatenates all text files into a single workspace file).
• Import a GitHub repository (fetches and packages the repo as a text file, with optional GitHub token support for private repositories).
• Fetch a web page (converts the main content to markdown).

Installation

Recommended: Browser Stores

The easiest way to install Better DeepSeek is through the official stores:

• Chrome Web Store
• Microsoft Edge Add-ons
• Firefox Add-ons

Latest Development Build

If you want to try the very latest features before they reach the store, you can download the Latest Automated Build. Download the ZIP for browsers, or the signed APK for Android. Load the browser extension via “Load unpacked” in Chrome.

Manual Installation (Developer Mode)

If you prefer to build from source or contribute to development:

Prerequisites

• Node.js (version 18 or later)
• npm

Build from Source

1. Clone the repository:

   git clone https://github.com/EdgeTypE/better-deepseek.git
   cd better-deepseek
   

2. Install dependencies:

   npm install
   

3. Build the extension:

   npm run build
   

   This will create a dist-chrome and dist-firefox folder with the unpacked extension.

4. Load the extension in your browser:

   1. Chrome:

      1. Open Chrome and go to chrome://extensions.
      2. Enable “Developer mode” (top-right toggle).
      3. Click “Load unpacked” and select the dist-chrome folder.

   2. Firefox:

      1. Open Firefox and go to about:debugging.
      2. Click “This Firefox”.
      3. Click “Load Temporary Add-on”.
      4. Select the better-deepseek-firefox.zip file.

      Note: Firefox build is experimental.

The extension should now appear in your extensions list and be active on chat.deepseek.com.

Usage

Once installed, visit chat.deepseek.com. You will see a “BDS” button in the top-right corner. Click it to open the settings drawer.

Using Tool Tags

Simply ask DeepSeek to perform a task that would benefit from one of the tools. For example:

• “Create a Python script that calculates the Fibonacci sequence and run it.”
• “Make an interactive pendulum simulation.”
• “Generate a PowerPoint presentation about climate change.”
• “Build a complete React to-do app as a downloadable project.”

DeepSeek will use the appropriate tags automatically (guided by the injected system prompt).

Managing Memory

When DeepSeek writes to memory using <BDS:memory_write>, the entries appear in the “Stored Memory” section of the drawer. You can also manually import/export memory as JSON.

Uploading Folders and GitHub Repos

Click the “+” button next to the chat input to reveal the advanced upload menu. Choose “Upload Folder” to select a local directory; the extension will concatenate all text files into a single upload. On browsers without the File System Access API (Firefox), the folder picker falls back to the browser’s native directory input so the flow still works. “GitHub Repo” fetches the repository as a ZIP and converts it to a gitingest-style text file for context.

For private repositories, add a classic GitHub personal access token with repo scope in Advanced Settings. The token is stored locally in the extension and is only sent to GitHub when you explicitly fetch a repository.

Changelog

v0.1.16 (2026-11-06)

• Full-Session Export: “Select All” now reads DeepSeek’s local history cache, so long conversations export completely (Markdown, PDF, HTML, images) instead of stopping at the messages loaded on the page.
• Remote Config on Android: the app now fetches the published config through the native bridge, keeping feature flags and composer buttons in sync with the browser builds.
• @ Skill Mentions: type @ in the composer to add a skill to a single message without changing your active skill set. An active-skills chip lets you see and manage them.
• Skill Discovery: the Skill menu can search skills.sh and install new skills without overwriting your own.
• Bug Fixes & UI/UX Improvements: Firefox PDF export, Brave web search, MCP URL validation, Android downloads/attachments, tag and RAG handling, plus many smaller fixes and interface refinements.

v0.1.15 (2026-10-09)

• New Feature: BDS Live (Experimental). Talk to DeepSeek out loud instead of typing — a hands-free voice mode with live transcription and spoken replies. Headphones are strongly recommended (otherwise the microphone picks up your speakers). BDS Live relies on browser APIs that Firefox does not implement, so it is currently unavailable there; for the best experience use a Chromium-based browser (Chrome, Edge, Brave, Opera, …).
• New Feature: Context Menu Actions. Right-click anywhere and use Ask DeepSeek on selected text, or Summarize with DeepSeek on a page. Both open DeepSeek in a new tab with your selection — or a summary request for the page URL — ready to send.
• New Feature: MIDI Music Generation. BDS can now compose music and melodies for you and play them right in the chat with an interactive piano-roll card, complete with volume control and .mid file download. (Don’t set your expectations too high!)
• New Feature: First-Run Voice Language Prompt. The first time you use any voice feature, BDS now asks which language you want to speak, so speech recognition and playback start on the right foot.
• New Feature: Multi-Forge Repository Import. Alongside GitHub, repositories can now be imported from GitLab, HuggingFace, and Codeberg via the Attach Menu.
• New Feature: MCP Servers as Search Providers. Configured MCP servers can now be used as automatic search providers, alongside the built-in engines.
• Bug Fixes & UI/UX Improvements: Various bug fixes and interface refinements across the extension.

v0.1.14 (2026-09-19)

• Advanced Charts: Comprehensive, interactive charts can now be generated using Vega-Lite (<BDS:chart>).
• New Language Support: Added Persian (Farsi) language support. (Thanks to @asedmammad)
• MCP Server Improvements: Enhancements and stability fixes across the MCP server integration.
• BDS Parser Improvements: The BDS tag parser has been improved; BDS tags are now detected and handled with significantly greater reliability.
• Status Monitor Update: Migrated to DeepSeek’s new status API schema. Please note that DeepSeek’s new Status API is still unstable, so status tracking may not be as reliable as before.

v0.1.13 (2026-08-26)

• Critical Hotfix: Resolved an issue caused by a recent DeepSeek update that broke the extension. Core extension functionality has been restored. We are monitoring the situation closely and follow-up hotfixes will be issued for any minor remaining issues.
• New Feature: Search Provider List. Users can now choose, reorder, and prioritize automatic search providers (Bing and DuckDuckGo) in settings.

v0.1.12 (2026-08-15)

• New Feature: DeepCode (Experimental). A collaborative coding mode that works alongside DeepSeek Harness. Enable DeepCode to plan tasks and execute multi-step code workflows with AI, then seamlessly transfer the plan to DeepSeek Harness. For full integration, install the dsh-better-deepseek plugin in DeepSeek Harness.
• New Feature: DeepCode Auto Tools. Added three new BDS auto tools: <BDS:AUTO:SEARCH_IN_DIRECTORY>, <BDS:AUTO:LIST_DIR>, and <BDS:AUTO:FILE_READ> (active when DeepCode mode is enabled) for codebase exploration.
• New Feature: Queued Prompts. If you send a message while DeepSeek is still generating a response, BDS automatically queues your prompt and submits it seamlessly as soon as generation completes.
• New Feature: Download Support for Created Items. Added download/export support for custom Personas and Skills directly from the drawer.
• Bug Fix: Fixed a parser issue affecting Long Work and related tool blocks caused by recent DeepSeek UI changes.
• Codebase Cleanup: Removed deprecated legacy tool cards from the codebase.
• Android Improvement: Added User-Agent header metadata to searches performed on Android devices.
• Stability & UI/UX Improvements: General bug fixes and interface refinements.

v0.1.11 (2026-07-27)

• New Feature: MCP (Model Context Protocol) Server Support. Connect remote MCP servers to give DeepSeek access to external tools. For detailed information, visit the Advanced Settings. (See MCP section above for details.)
• New Feature: Dynamic Tables. Sort data and reorder columns directly in tables generated by DeepSeek, making data analysis more interactive.
• Stability & UX Improvements: Dozens of bug fixes and UI/UX improvements across the extension.

v0.1.10 (2026-06-30)

• New Feature: BDS:IMAGE Tag with Wikimedia Commons. DeepSeek can now search and display images from Wikimedia Commons directly in conversations. Supports query, count, width, category, caption attributes, fullscreen viewer with keyboard navigation, lazy loading, and result caching.
• New Feature: Slash-Command System. A complete command subsystem with autocomplete, argument hints, and keyboard shortcuts. Built-in commands for common tasks, custom command-to-snippet mapping, and a context hand-off feature that compresses long conversations and opens a fresh session with summarized context. You can also define your own commands using saved snippets.
• New Feature: Load All History. Fetch full session history from the DeepSeek API, enabling complete exports and accurate token usage calculations even for sessions with lazy-loaded messages.
• New Feature: Message Timestamps. Display precise timestamps for each message. Configurable via a toggle in Settings.
• New Feature: Lua & Ruby Code Runners. DeepSeek can now write and execute Lua and Ruby code directly in the chat, powered by Fengari and Opal runtimes.
• Deep Research Improvements: Added 128K context budget guard to prevent context window overflow, adaptive step handling with deduplication and validation, automatic recovery from AUTO tag emission issues, report synthesis, and auto search narrowing with DDG/Bing fallback ranking. (Thanks to @WhiteLicorice).
• New Feature: Search functionality in SettingsPanel to quickly find settings. Advanced settings grouped into collapsible accordions for a cleaner experience.
• UI/UX Improvements: Enhanced markdown styling using design system variables. BDS tool cards now appear at their original position within the message text instead of being appended at the end, with improved markdown styling throughout.
• Bug Fixes: Escape character handling in AI-generated BDS tag content. Whitespace preservation in code blocks. Improved send button detection and retry logic. Markdown reconstruction and list handling improvements. Various stability fixes.

v0.1.9 (2026-06-13)

• New Feature: Multi-System Prompt Mode & Advanced Scheduling. Use multiple system prompt entries with per-entry scheduling - first message, every N turns, or always.
• New Feature: DeepResearch. Tell DeepSeek a topic, review the generated plan, and upon approval it conducts deep multi-step research automatically. (Thanks to @WhiteLicorice).
• Visualizer Rework: Visualizer widgets can now be resized and downloaded. The entire UI has been reworked for a cleaner experience.
• Export/Import Overhaul: All extension data (settings, skills, memories, characters, projects) can now be exported and imported with optional encryption support.
• Custom CSS Rework: The custom CSS system has been updated. You can now save snippets as snippets and activate multiple snippets at the same time.

v0.1.8 (2026-06-01)

• Memory Rework: The called memory system has been reworked with a token overlap-based approach for better context matching.
• Saved Items (Bookmarks & Snippets): Save messages for later access. Create snippets and send them with a single click.
• Skill Creator Tool: Ask AI to create a custom skill for you directly from the chat.
• Import Memory from Another AI: Import your memory from other AI platforms into DeepSeek.
• API Playground: A built-in playground to easily test the DeepSeek API.
• Auto Search Tool: Replaced the removed Expert mode link reading and search with our own integrated search tool.
• New Option: Ability to disable automatic system date/time injection into prompts.
• New Language: Chinese (zh-CN) language support added. (Thanks to @PandaYuuHa)
• Custom CSS & Presets: Add custom CSS overrides to the DeepSeek UI with built-in preset themes.
• Bug Fixes and UX Improvements: Numerous bug fixes and UX refinements across the extension.

v0.1.7 (2026-05-22)

• New Feature: Localization System. Better DeepSeek now supports multiple languages. Help us improve translations or add your own language, visit Localization page.
• New Feature: Custom Prompts. Create, save, and switch between multiple system prompts with ease.
• New Feature: Project RAG Search. A primitive RAG system for searching through project files and local folders.
• New Feature: Server status checker that notifies you when DeepSeek servers are experiencing issues.
• New Feature: Announcement banner for BDS updates and important notices.
• UX Improvements: Collapse/expand toggle for long messages in prompt box and message box. Extension icon now opens the DeepSeek website on click. Renderable cards for Web Fetch and GitHub Fetch operations.
• Bug Fixes and Tool Improvements: Resolved font and size rendering issues in the DeepSeek interface. BDS tool parser improvements, Office tool improvements, and various performance optimizations.

v0.1.6 (2026-05-12)

• New Platform: Better DeepSeek is now available on Android. (Thanks to @WhiteLicorice).
• New Feature: Chat Filtering & Grouping. Organize your conversations with tags and filter them from the sidebar.
• New Feature: Reworked Export UI. Export full sessions or specific messages as Markdown, PDF, HTML, or Images.
• New Tool: BDS:AUTO:CODE_RUNNER. DeepSeek can now request code execution and see results directly.
• New Feature: Server Status Checker. Real-time monitoring of DeepSeek’s server status with user notifications.
• New UI: Renderable card for character creation.
• UX Improvement: Various UI refinements and performance optimizations.

v0.1.5 (2026-05-06)

• New Feature: Advanced system prompt injection control. Choose between “Always”, “First Message”, or “Every X” messages with customizable intervals.
• New Feature: Private repository import support via GitHub Personal Access Tokens. (Thanks to @WhiteLicorice).
• New Feature: Token price estimation and context window display for API-equivalent usage.
• New Feature: What’s New popup in the extension.
• New Option: “Disable Memory” toggle in Settings.
• Bug Fixes and UX Improvements: Resolved critical issues with message handling and UI state. General UI polishing and various bug fixes. (Thanks to @WhiteLicorice and @ferxal)

v0.1.4 (2026-04-30)

• New Feature: Projects menu for better organizational control (Thanks to @WhiteLicorice).
• New Feature: Search functionality added to the session history sidebar.
• UX Improvement: Settings menu rework with an “Advanced Settings” accordion to save drawer space.
• New Option: Ability to disable the Hidden System Prompt entirely.
• New Option: “Force Language” setting to ensure DeepSeek responds in your preferred language.

v0.1.3 (2026-04-28)

• New Feature: Added “Ask Questions” tool. DeepSeek can now ask for clarification when unsure about context or instructions.
• New Feature: Export full sessions to Markdown and PDF.
• UX Improvement: Added a button to reset the system prompt to default.
• Bug Fix: Resolved full page reloading issues when clicking the DeepSeek logo or the “New Chat” button.

v0.1.2 (2026-04-23)

• Cross-Browser Support: Added experimental support for Firefox.
• Enhanced Code Runners: Updated Python runner and added new JavaScript and TypeScript execution environments.
• GitHub Integration: Added support for fetching and injecting GitHub repositories directly into the chat via BDS:AUTO.

v0.1.1 (2026-04-18)

• New Feature: Added full Voice Support (Speech-to-Text and Text-to-Speech).
• New Feature: Configurable voice and recognition languages in Settings.
• UX Improvement: Logo and “New Chat” button are now real <a> tags, supporting “Open in new tab”.
• Improved Reliability: Better handling of stalled streams and automatic closing of tags.

Development

Project Structure

better-deepseek/
├── src/
│ ├── background/                      # Service worker for cross-origin requests
│ ├── content/                         # Content script (runs on DeepSeek page)
│ │ ├── dom/                           # DOM manipulation utilities
│ │ ├── files/                         # File/folder/GitHub readers and code block downloads
│ │ ├── parser/                        # BDS tag parsing and sanitization
│ │ ├── tools/                         # Tool card renderers (HTML, Python, PPTX, etc.)
│ │ ├── ui/                            # Svelte components for the drawer and overlays
│ │ └── index.js                       # Content script entry point
│ ├── injected/                        # Script injected into the page's MAIN world
│ ├── lib/                             # Shared utilities (ZIP, download, hashing, etc.)
│ ├── platform/                        # Platform-specific globals and polyfills
│ │ ├── android-bridge-shim.js         # Android native bridge wrappers
│ │ ├── android-chrome-polyfill.js     # chrome.* API polyfill for Android
│ │ ├── globals-android.js             # Android platform globals entry
│ │ └── globals-chrome.js              # Chrome platform globals entry
│ ├── sandbox/                         # Sandboxed iframe for PPTX/Excel/DOCX generation
│ └── styles/                          # CSS files
├── android/                           # Android WebView app
│ ├── app/
│ │ ├── src/main/
│ │ │ ├── java/com/betterdeepseek/app/
│ │ │ │ ├── MainActivity.kt            # Full-screen WebView Activity
│ │ │ │ └── WebViewBridge.kt           # @JavascriptInterface bridge
│ │ │ ├── assets/bds/                  # Auto-populated by build:android
│ │ │ └── res/ # Android resources
│ │ └── build.gradle.kts
│ ├── build.gradle.kts
│ ├── settings.gradle.kts
│ └── gradle/
├── static/
│ ├── manifest.json                    # Extension manifest
│ └── sandbox.html                     # Sandbox page
├── scripts/                           # Build helper scripts
├── tests/                             # Test suites (unit, integration, E2E)
├── build.js                           # Vite multi-target build configuration
└── package.json

Building and Watching

• npm run build – Production build.
• npm run dev – Development build with watch mode.

After making changes, rebuild the extension and reload it from chrome://extensions (click the refresh icon on the extension card).

Building for Android

Better DeepSeek can run as a standalone Android app. It wraps chat.deepseek.com in a WebView and injects the BDS enhancement layer.

Prerequisites

Environment Variables

Set these in your system or user environment variables (Windows — use setx in Command Prompt, not PowerShell):

JAVA_HOME=C:\Program Files\Eclipse Adoptium\jdk-17.0.19.10-hotspot
ANDROID_HOME=C:\Users\YourName\AppData\Local\Android\Sdk

Also add %ANDROID_HOME%\platform-tools to your Path.

PowerShell pitfall: In PowerShell, use $env:JAVA_HOME and & to call executables. In Command Prompt, use %JAVA_HOME% and double‑quote paths with spaces: "%JAVA_HOME%\bin\java" -version.

Verify the toolchain

Open a Command Prompt (cmd.exe) and run:

echo %JAVA_HOME%
"%JAVA_HOME%\bin\java" -version
echo %ANDROID_HOME%
dir %ANDROID_HOME%\platforms
dir %ANDROID_HOME%\build-tools
dir %ANDROID_HOME%\cmdline-tools
gradle --version

You should see OpenJDK 17, android-34, 34.0.0 in build‑tools, latest in cmdline‑tools, and Gradle 8.7.

Create local.properties

In the android/ directory, create a file named local.properties:

sdk.dir=C:\\Users\\YourName\\AppData\\Local\\Android\\Sdk

Use double backslashes — this is a Java properties file. This file is gitignored and must never be committed.

Bootstrap the Gradle wrapper (one-time)

cd android
gradle wrapper --gradle-version 8.7 --distribution-type bin

This creates gradlew.bat and the gradle/wrapper/ folder. After this you can build with gradlew — the system Gradle is no longer needed.

Build the JavaScript bundles

npm run build:android

This runs Vite with --target=android and copies the output (content.js, injected.js, sandbox.js, sandbox.html, content.css) into android/app/src/main/assets/bds/.

Build the APK

cd android
gradlew assembleDebug

The first build downloads Gradle and Android dependencies — expect a few minutes. Subsequent builds are fast. The debug APK lands at:

android\app\build\outputs\apk\debug\app-debug.apk

Install and run

adb install android\app\build\outputs\apk\debug\app-debug.apk

Requires a physical device with USB debugging enabled, or an Android emulator (create one via Android Studio’s Device Manager — API 34, x86_64, Google Play system image recommended).

Common pitfalls

Design Principles

• The content script uses Svelte 5 for reactive UI components.
• The injected script patches window.fetch and XMLHttpRequest to modify outgoing chat completion requests.
• All data (settings, skills, memories, characters) is stored locally using chrome.storage.local.
• The extension is designed to be non-intrusive: it only modifies the DOM by adding host containers next to messages and hiding original markdown when tool tags are present.

Privacy

Better DeepSeek does not collect, transmit, or sell any personal data. All settings, memories, skills, and characters are stored locally on your device. If you configure a GitHub personal access token for private repository support, it is stored locally and only sent to GitHub when you explicitly fetch a repository. See the full Privacy Policy for details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub. Before submitting a PR, ensure that your code builds without errors and follows the existing style.

Testing

Run the main test commands before opening a PR:

• npm run test:unit - runs the Vitest unit and integration suite with coverage.
• npm run test:e2e - runs the Playwright browser-extension end-to-end suite.
• npm run test - runs the default browser-focused local test stack.
• npm run test:e2e:android - runs the Android WebView simulator Playwright suite against dist-android/.
• npm run test:android - builds the Android web bundle and runs the Android simulator suite.
• npm run android:test - runs the Kotlin unit tests in android/.
• npm run android:assemble:debug - builds the debug APK through the Gradle wrapper.
• npm run test:ci:web - runs the web CI-equivalent flow: Chrome build, Vitest, then Playwright.
• npm run test:ci:android - runs the Android CI-equivalent flow: Android bundle build, APK assembly, Android Playwright, then Kotlin unit tests.
• npm run test:ci - runs both CI-equivalent jobs locally.

For fuller testing notes, suite layout, and conventions, see TESTING.md.

Acknowledgements and Disclaimer

Use it at your own risk. Better DeepSeek is an independent project and is not affiliated with DeepSeek. It uses several open-source libraries, including:

• Svelte
• PptxGenJS
• SheetJS
• docx
• fflate
• Readability
• Turndown

“Better DeepSeek” is an unofficial, independent, and community-driven open-source extension. It is NOT affiliated with, endorsed by, sponsored by, or officially connected to DeepSeek or DeepSeek AI in any way. All product names, logos, and brands are property of their respective owners.

Contributors