convoport

DeepSeek Harness plugin: auto-capture your DeepSeek web conversations, store them 100% locally, import selected messages into workspace sessions, and see how many tokens you've saved.

中文说明

What it does

Architecture

Browser extension (MV3)                dsh plugin (this repo)
┌──────────────────────┐   POST   ┌──────────────────────────────┐
│ content script       │ ────────▶ │ lib/index.js  server half    │
│ · chat.deepseek.com  │ /capture │ · /capture/ingest    ingest   │
│ · official API pull  │          │ · /capture/sessions  list     │
│ · batched reporting  │          │ · /capture/messages  detail   │
└──────────────────────┘          │ · /capture/stats     stats    │
                                  │ · /capture/import    new sess │
                                  │ lib/client.js  Web sidebar    │
                                  │   sidebar.footer.action slot  │
                                  └──────────────────────────────┘

Install

# 1. Install the plugin
dsh plugin --profile web add convoport
# Restart dsh web, refresh the browser.

# 2. Load the browser extension (extension/ ships inside the npm package;
#    also available from this repo)
#    Path: node_modules/convoport/extension/  (or repo extension/)
#    chrome://extensions → enable Developer mode → Load unpacked → pick extension/
#    Optional: click the extension icon → Options → confirm the backend URL
#    is http://127.0.0.1:3080 (the dsh web port).

Note: Chrome deliberately blocks command-line loading of unpacked extensions; the manual "Load unpacked" step above is required (it's the standard flow).

Usage

1. With the extension enabled, just chat on chat.deepseek.com — the extension syncs automatically.
2. A "⛁ Convoport" button appears at the bottom of the Web sidebar:
   • Stat cards: total tokens saved / conversations / today's captures / estimated savings
   • Capture list: title, message count, tokens, import status
3. Click a conversation → message-level picker: check the messages you want (quick-select "first 3 / last 3 / all / clear").
4. Click "Import selected → new session (N)" — a new session appears in the sidebar; its history is exactly the messages you picked. Continue chatting there.

A /capture command also shows the stats overview right in the chat.

API

Token accounting

• Prefers DeepSeek's official accumulated_token_count (the extension writes per-message token_count).
• Falls back to the Harness-style heuristic: 4 chars/token + structural overhead (same as dsh-token-meter).
• The stats page/command output always states the method; estimated savings use a $0.02 / 1k tokens reference price.

Development

# Local development (link install):
# in your profile's package.json dependencies, add:
#   "convoport": "link:<path-to-this-repo>"
# then run:
dsh plugin --profile web add convoport   # triggers reconcile

Server-side changes (lib/index.js) require restarting dsh web; client-side (lib/client.js) is read live without cache — just refresh the browser.

Tests

npm test              # all suites except extension-e2e
npm run test:e2e      # extension→plugin full chain (needs dsh web running)
npm run pack:check    # inspect what npm pack would publish