dsh-plugin-model-enhancer/README.md

# dsh-plugin-model-enhancer

DeepSeek Harness (DSH) Model Settings Enhancer & Codex Selector Plugin (Compatible with DSH 0.1.5-rc.2).

## ✨ Features

1. **Official Extension Slots Integration (Non-destructive to `ui-settings-models`)**:
   - Integrates model enhancement configuration via `settings.models.footer` and `settings.models.provider-card` (targeted at `llm-pi-ai`).
   - Supports models.dev auto-fill matching, prefilling missing capacities, image modalities (`input: ["text", "image"]`), and multi-level reasoning efforts (`minimal` / `low` / `medium` / `high` / `xhigh` / `max`).
   - Uses `ctx.remote.settings.mutate` with revision fence checking for safe, non-destructive configuration persistence.
   - Preserves official file attachment and upload pipeline (`ui-attachment` & `file-upload`), removing obsolete custom upload endpoint routes.

2. **Codex-style Model & Reasoning Effort Selector**:
   - Injected into `conversation.input.right` seamlessly alongside the official composer.
   - Reuses `ctx.modelDirectories` (`ModelDirectoryResolver`) for per-session directory resolution and selection dispatch.
   - Interactive sliding track for reasoning effort adjustments and grouped model picker popup.

3. **models.dev Cache & Proxy**:
   - Exposes exact WebServer proxy route `/api/models-dev/models` with in-memory caching and fallback.

4. **Full Bilingual Support (i18n)**:
   - Dynamic localization supporting Simplified Chinese (`zh`) and English (`en`).

## 🛠 Building & Development

```bash
npm run build      # Bundles client code to lib/client.js and emits types
npm test           # Runs Vitest unit tests
npm run typecheck  # TypeScript static type check
```

## 📦 Profile Configuration

In your profile's `package.json`:
```json
{
  "dependencies": {
    "dsh-plugin-model-enhancer": "file:../dsh-plugin-model-enhancer"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-plugin-model-enhancer"
      ]
    }
  }
}
```

## 📄 License
MIT