dsh-you-should-know
在 DeepSeek Harness 任务中提醒用户理解重要事实和方案取舍。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:lolipop-1x1/dsh-you-should-know#b88d873a02e402af24bafb9c258119c18f19a9d4
You Should Know 以 dsh-you-should-know 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
You Should Know: surface important facts and trade-offs while a task is running
A task reminder plugin for DeepSeek Harness. It observes the existing conversation while a task is running and surfaces important facts, trade-offs, and background knowledge you may have missed.
Actual Harness acceptance-test screenshot using a fictional task. The header is an AI-generated conceptual illustration.
Installation · Usage · Settings · How it works · Usage and data · Development and contributing
| Component | Requirement |
|---|---|
| DeepSeek Harness | >=0.2.0-rc.2 <0.3.0-0 |
| Node.js | >=22.19.0 |
| Interface | Web, and desktop clients using the same conversation input area |
Development dependencies are locked to 0.2.0-rc.2; CI covers both 0.2.0-rc.2 and 0.2.1-alpha.1. The compatibility range covers the 0.2 series, but preview APIs may differ in other versions. The 0.3 series is not yet supported. Profiles without a supported input area do not start automatic observation.
git clone https://github.com/lolipop-1x1/dsh-you-should-know.git
cd dsh-you-should-know
npm ci
npm run check
npm pack
Add the generated package to your Harness profile:
dsh plugin --profile web add -w /absolute/path/dsh-you-should-know-0.1.0.tgz
Replace web with your profile name and adjust the absolute package path. The -w option allows pnpm to install at the profile's workspace root. Desktop users can use the plugin installation interface or bundled CLI.
Restart the target Harness profile after installation so the host loads both plugin modules. Open Settings → You Should Know to confirm that the plugin loaded.
A prebuilt package does not need a source build during installation. When installing source through a Git URL, prepare installs development dependencies and builds the plugin. pnpm 10 or later may require explicit build approval for this package.
Automatic observation is enabled by default, and the observer follows the main session model. Existing saved settings are preserved. Start a task normally; short tasks usually do not reach a check, and a note is not guaranteed on every turn.
| Action | Result |
|---|---|
| Learn more | View the reason and impact; reuse an existing explanation in the same language when available |
| Knew this already / Understood | Save the topic to reduce repeated notes |
| Chat in main session | Insert the note and explanation only when there is no draft or attachment; you send it |
| Dismiss | Close the note and briefly offer feedback options |
| Minimize / Open note | Change the panel display without submitting feedback or marking the topic as understood |
Notes help you understand a task. They are not fact checks or execution reviews: they may miss important details or be inaccurate. Bring a note into the main session when you want to discuss it further.
Open Settings → You Should Know. Changes save automatically.
| Setting | Default | Options |
|---|---|---|
| Automatic observation | Enabled | Enabled, disabled |
| Language | Follow system | Follow system, 中文, English |
| Observer model | Follow the main session model | Independently select a model configured in Harness |
| Observation interval | 6 model steps | 6, 12, 18, or a custom positive integer |
| Checks per turn | Unlimited (0) | Unlimited, 1, 3, 5, or a custom non-negative integer |
| Topic history | Up to 50 entries each in Seen and Known | Inspect, refresh, and confirm clearing each list separately |
English settings: automatic observation, language, and observer model English settings: observation interval, checks per turn, and topic history
The English menu is shown in two panels. Automatic observation is disabled in this example; see the table for factory defaults.
Language controls the plugin menu and prompts for future notes and explanations. “Follow system” uses the current Harness interface language: Simplified Chinese for Chinese locales, and English otherwise. Existing notes keep their original text. Selecting an observer model does not change the main session model.
Both topic lists are shared across sessions and help avoid repeated notes. Clearing requires confirmation and affects only the selected list; the other list and current note remain. Clearing one list therefore does not guarantee that a topic will appear again. Detecting the same topic with different wording also depends on the model, so complete deduplication is not guaranteed.
The observer reads existing context. It does not execute tools, read new files, or write observation requests and responses into the main conversation. Following the main model preserves the request prefix so the provider can attempt cache reuse; actual cache hits and pricing depend on the provider.
Automatic observation makes extra model calls, even when no note appears. The plugin currently uses full conversation context without trimming or an extra summarization call. Disable observation, increase the interval, or set a per-turn limit to control extra calls. Expanding a note makes a separate model request when no usable explanation exists. Cancellation does not guarantee that remote billing stops.
Requests use the model services already configured in Harness. When you select an independent observer model, full context is sent to that model's provider. The plugin does not store its own API keys, add telemetry, or upload feedback externally.
Notes, explanations, topics, and required interaction state are saved in the Harness storage domain; the host manages the path and backend. Full request snapshots stay in memory only. Prompts ask the model not to repeat credentials or personal information in notes, but this does not remove such information from the full context sent to the model.
Report bugs or suggest improvements through Issues, or contribute a Pull Request. Include the Harness and plugin versions, operating system, profile, reproduction steps, and expected result. Remove credentials, private conversations, and personal paths.
npm ci
npm run check
check verifies the lockfile, types, behavior tests, build, and runtime entry points. For client interaction changes, start the browser regression page:
npm run test:browser
Open the printed URL and click “运行回归” (Run regression). The default port is 3100, configurable through YSK_TEST_PORT. This page uses real components with mock APIs and does not connect to actual sessions. Model quality, usage, and compatibility still need validation in the target Harness.
| Directory | Responsibility |
|---|---|
src/core/ | Prompts, parsing, and state rules |
src/host/ | Model calls, scheduling, and host integration |
src/client/ | Floating notes, settings, and Chinese/English UI |
tests/ | Behavior tests and browser regression page |
See the contribution guide and design document, both currently in Chinese, for detailed conventions, behavior, storage, and advanced configuration.
This project is licensed under MIT.