dsh-pin-recall

Readme

# dsh-pin-recall

Pin assistant replies (or tool/text evidence) in a DeepSeek Harness session, then recall them into the model turn — with a Web card button.

[中文文档](./README.zh-CN.md)

## Install

```sh
# from a built checkout
dsh plugin --profile web add /absolute/path/to/dsh-pin-recall

# or from GitHub (after you publish)
dsh plugin --profile web add github:YOUR_USER/dsh-pin-recall
```

Restart `dsh --profile web` (or `pnpm dsh web` from a harness checkout). Open the Web UI and hard-refresh.

Requires Node.js and a profile that already stacks `@deepseek-ai/dsh-base` + `@deepseek-ai/dsh-web-app`.

## Web UI

On a **finished** assistant message, the bottom action row shows:

| Control | Action |
|---|---|
| Outline star | Toggle pin / unpin for that reply (fills when pinned; state hydrates from the session) |
| Corner-down-left icon | Inject all pins and wake the agent (`title`: 召回…) |

## Commands

| Command | Effect |
|---|---|
| `/pin` · `/pin last` | Pin newest tool result or assistant message |
| `/pin tool` · `/pin assistant` | Pin newest of that kind |
| `/pin msg <messageId>` | Toggle pin for one assistant message (Web card) |
| `/pin status <messageId>` | Report whether that assistant message is pinned |
| `/pin text …` | Pin free-form text |
| `/pins` | List active pins |
| `/recall` | Queue all pins **and wake** the agent |
| `/recall p1` | Queue one pin and wake |
| `/recall quiet` | Queue without waking (send a message yourself) |
| `/unpin p1` · `/unpin all` | Remove pins |

Pins are durable session events (`pin/set`, `pin/remove`). Keep this plugin installed to resume sessions that contain them.

## Develop

```sh
npm install
npm run build
```

`lib/index.js` is the Host half; `lib/client.js` is the ModuleLoader browser bundle.

Sibling layout expected when typechecking against a local harness is optional — this package uses ambient shims.

## License

MIT