Cheeserackery/deepseek-time#dsh

This package is the DeepSeek Harness (DSH) adapter. It registers through the native conversation.input.dock slot, then places the indicator outside the sidebar near the bottom of the viewport. It supports pointer dragging with viewport clamping and remembers the last position in the browser profile.

When the indicator is hovered, it requests a fresh balance through a DSH Host-side route. The Host resolves DEEPSEEK_API_KEY through DSH's credentials service and calls only https://api.deepseek.com/user/balance; the key never enters the browser or plugin UI. Simultaneous hover requests are coalesced while one request is in flight, but completed results are not cached. If no key is configured or the upstream request fails, the indicator continues to show the time period and displays a generic balance status.

Build

Run these commands from the repository root after cloning it:

npm run build
npm run verify

The build generates lib/client.js, lib/index.js, and the shared modules under src/. Do not edit generated files manually. Keep lib/index.js: it is the intentionally empty host entry that allows DSH to load this Web-only package without breaking startup.

Install Into DSH

DSH loads this package as a local profile bundle. From the DSH Web profile directory, add the adapter package with pnpm, using the path where this repository was cloned:

pnpm add "file:<clone-path>\adapters\dsh"
pnpm install

Edit the DSH Web profile's package.json and add deepseek-time once to the existing dsh.profile.bundles list. pnpm add adds the dependency but does not select the bundle automatically. The package metadata supplies the dsh.bundle patch and the dsh.client entry; do not remove the package root export, main, lib/index.js, or cordis.patch.yml. Run pnpm install after the edit, then restart DSH.

The relevant structure is:

{
  "dsh": { "profile": { "bundles": ["existing bundle", "deepseek-time"] } },
  "dependencies": { "deepseek-time": "file:<clone-path>/adapters/dsh" }
}

Add these entries to the existing object; do not replace the profile's other bundles or dependencies.

When migrating from an older release, change the profile dependency path from adapters/harness to adapters/dsh before running pnpm install. For an existing installation, rebuild this repository, run the same pnpm add command again, confirm the bundle list, and restart DSH. If the plugin is not visible, check that the profile dependency points to this adapter directory and that the generated lib/client.js exists.

Remove

From the DSH Web profile directory:

# First remove "deepseek-time" from dsh.profile.bundles in package.json.
pnpm remove deepseek-time
pnpm install

Restart DSH after removal.

Compatibility Notes

• The adapter includes a small DSH Host entry for the local balance route and a Web client entry; it does not replace or patch the DSH application.
• Balance display requires DEEPSEEK_API_KEY to be configured in DSH's Models/credentials settings. No key is placed in package.json, source files, browser storage, or the repository.
• The drag position is browser-profile state. Clearing site data resets it to the default location outside the sidebar.
• It uses the shared Beijing-time rules: weekday peak 09:00-12:00 and 14:00-18:00 (Monday-Friday); weekends are idle all day.
• The DSH UI must expose conversation.input.dock; the adapter does not patch DSH application source or inject global CSS.
• The project is distributed under the MIT License. See the repository root LICENSE file.