look-here

Readme

# Look Here / 喏这里

English | [简体中文](README.zh-CN.md)

Look Here is a selection-first plugin for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web UI. Select text in a DSH conversation to explain it, ask a follow-up, save the answer, or attach an annotation without interrupting the main session.

## Highlights

- **Explain from a selection:** select conversation text and use the nearby dot for a quick explanation or custom question.
- **Keep side work separate:** explanations and follow-ups use an independent `ctx.llm` call and do not add messages to the main DSH session.
- **Choose the answer model:** follow the active session or select a provider and model in the plugin settings.
- **Save reading memory:** keep full answers or excerpts and surface previous explanations when the same term appears again.
- **Build an annotation batch:** collect multiple anchored notes, edit them in the drawer, then drag them into the DSH composer.
- **Stay in control:** dropping annotations only updates the draft. Look Here never sends the main-session message automatically.
- **Match your environment:** Chinese and English UI, theme colors, configurable selection gestures, and reduced-motion support.

## Requirements

- Node.js 22.19+ on the 22.x release line, or Node.js 24+
- DeepSeek Harness `0.1.0-rc.7`
- A DSH `web` profile

The supported Harness version and verified plugin contracts are recorded in [COMPATIBILITY.md](docs/dsh-adaptation/COMPATIBILITY.md).

## Install from GitHub

```sh
npx @deepseek-ai/dsh plugin --profile web add github:ZanderKong/look-here
npx @deepseek-ai/dsh --profile web --dump-config
npx @deepseek-ai/dsh --profile web
```

Restart the Web service after installation. The dumped config should include a `# == look-here` layer, and the UI is available at `http://127.0.0.1:3080` by default.

For a reproducible installation, append `#<commit-or-tag>` to the GitHub spec.

## Install from a local checkout

```sh
git clone https://github.com/ZanderKong/look-here.git
cd look-here
npm install
npm run check
npx @deepseek-ai/dsh plugin --profile web add .
npx @deepseek-ai/dsh --profile web
```

## Use it

1. Open a DSH conversation and select text in an assistant response.
2. Short-press the selection dot to explain, or long-press it to ask or annotate. The priority can be changed in settings.
3. Save useful explanations, add follow-ups, or collect several annotations.
4. Drag the annotation basket into the composer, review the draft, and send it yourself.

## Diagnostics

Run these commands in the browser DevTools console:

```js
await __LOOK_HERE_DSH_DIAGNOSTICS__.health()
await __LOOK_HERE_DSH_DIAGNOSTICS__.selfTest()
await __LOOK_HERE_DSH_DIAGNOSTICS__.quickExplainJobs()
await __LOOK_HERE_DSH_DIAGNOSTICS__.storage()
```

## Development

```sh
npm install
npm run build:dsh
npm test
```

`npm run check` rebuilds the distributable DSH client and host files before running the complete test suite.

## Project layout

```text
dsh/                  DSH host, client adapters, Cordis patch, and build script
src/                  Shared product core adapted from the Chrome extension
dist/dsh/             Committed installable host and client artifacts
tests/dsh/            DSH adapter and behavior tests
docs/dsh-adaptation/  Architecture, compatibility, installation, and parity notes
```

See [Architecture](docs/dsh-adaptation/ARCHITECTURE.md), [Installation and acceptance](docs/dsh-adaptation/INSTALL.md), and the [Parity checklist](docs/dsh-adaptation/PARITY_CHECKLIST.md) for implementation details.

## Privacy and data handling

- Selected text, surrounding conversation context, questions, and follow-ups are sent through the model provider configured in DeepSeek Harness.
- Plugin settings, saved explanations, and annotations are stored locally in the browser profile used by the DSH Web UI.
- The plugin does not read or store a model API key and does not automatically submit composer drafts.

Avoid selecting sensitive information unless the configured model provider is allowed to process it.

## Origin

Look Here adapts the interaction model and product core of the [original Chrome extension](https://github.com/ZanderKong/whats-this-again) to the DeepSeek Harness Web UI. Host-specific behavior lives behind DSH adapters; it is not a separate feature rewrite.

## Community discovery

This repository uses the [`dsh-plugin`](https://github.com/topics/dsh-plugin) topic recommended by the DeepSeek Harness project, so it can be discovered from the Harness plugin community on GitHub.

## License

[MIT](LICENSE)