dsh-media-skills — DeepSeek Harness のための無料画像読み取り・生成スキル

# 🎨 dsh-media-skills ### *チャット欄に画像を直接貼り付け —— 無料のビジョンモデルと画像読み取り・生成スキル* [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE) [![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](https://python.org) [![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-Skill-4D6BFE)](https://github.com/topics/dsh-plugin)
[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) に「目」と「筆」を——2 つの無料スキル、1 つの無料ビジョンモデル、さらにテキスト専用セッションへの画像貼り付け。キーのハードコードは一切なし。 [機能](#-機能) · [クイックスタート](#-クイックスタート) · [使い方](#-使い方) · [ビジョン設定ガイド](../SETUP_VISION.md) [**English**](../../README.md) · [**简体中文**](README_ZH.md) · [**繁體中文**](README_ZH_TW.md) · [**日本語**](README_JA.md) · [**한국어**](README_KO.md) · [**Español**](README_ES.md) · [**Deutsch**](README_DE.md) · [**Português**](README_PT.md) · [**Русский**](README_RU.md)

--- ## ✨ 機能 | 機能 | 内容 | モデル | 費用 | |---|---|---|---| | 📎 画像貼り付け自動読み取り | **テキスト専用セッション**（例: deepseek-v4-pro）の入力欄に「画像を追加」ボタン（クリップ）が現れ、貼り付けた画像はビジョンモデルが自動でテキスト説明に変換して現行モデルへ渡す | 智譜 GLM-4V-Flash | 無料 | | 🧠 ビジョンモデルルート | インストール後、モデルセレクターに**自動で**「智譜 GLM-4V-Flash（視覚）」が追加され、新規セッションで画像について直接会話できる | 智譜 GLM-4V-Flash | 無料 | | 👁️ `vision-review` | 画像・スクリーンショットの分析 / 認識 / 説明、UI の視覚的バグ（重なり・はみ出し・ずれ）の検出、ウォーターマーク / ロゴ検出、画像のテキスト化 | 智譜 GLM-4V-Flash | 無料 | | 🎨 `media-tools` | 画像・イラスト・アバター・背景・バナーの生成 | SiliconFlow Kolors | 無料・ウォーターマークなし | > ⚠️ 正直な注記：「画像貼り付け自動読み取り」は DeepSeek Harness **本体**の機能（`api-proxy` の画像受付ロジック）です。このバンドルが提供するのは**モデル設定 + 読み取り/生成スキル**。ビジョンモデルはどの DSH ビルドでも動作しますが、自動読み取りの利便性には本体側の対応が必要です。判定方法は [../SETUP_VISION.md](../SETUP_VISION.md) の FAQ Q1 を参照。 ## ⚡ クイックスタート 1. バンドルをインストール： ```sh dsh plugin --profile add github:akqwpeter-prog/dsh-media-skills ``` 2. **まず無料でキーを取得**：[open.bigmodel.cn](https://open.bigmodel.cn) に登録/ログイン → 「API Keys」（glm-4v-flash は無料）。生成も使うなら [siliconflow.cn](https://siliconflow.cn) でも作成（Kolors は無料）。その後 Zhipu のキーを設定—— Web GUI（**設定 → モデル** → zhipu-vision プロバイダーの **API Key 欄**）またはクレデンシャルファイルで： ```sh # ~/.dsh/.credentials.yaml（chmod 600） GLM_API_KEY: <あなたの Zhipu キー> ``` 3. `dsh web` を**完全に再起動**し、`Cmd+Shift+R` でハードリフレッシュ。 4. 確認：モデルセレクターに **「智譜 GLM-4V-Flash（視覚）」** が表示されること。本体が貼り付け読み取りに対応していれば、入力欄左下に **📎「画像を追加」ボタン**が表示される。任意のセッションに画像を貼ると、テキスト説明として届く。詳細な手順・仕組み・トラブルシューティング：**[../SETUP_VISION.md](../SETUP_VISION.md)** ## 🔑 キーキーは**このリポジトリに一切保存されない**。スキルスクリプトは次の順で読み取る：環境変数 → `~/.dsh/secrets/media-tools.env` → `~/.codex/secrets/media-tools.env`（後方互換）。ビジョンモデルルートは DSH のクレデンシャルストアから `GLM_API_KEY` を読む。キー入手先（いずれも無料）：智譜 [open.bigmodel.cn](https://open.bigmodel.cn) → API Keys（glm-4v-flash）；SiliconFlow [siliconflow.cn](https://siliconflow.cn) → API Keys（Kolors）。 ```sh # ~/.dsh/secrets/media-tools.env（chmod 600、1 行に KEY=value） GLM_API_KEY=... SILICONFLOW_API_KEY=... ``` ## 🚀 使い方画像を読む 3 つの方法： | 方法 | 使い方 | 向いている場面 | |---|---|---| | **A. 直接貼り付け（推奨）** | 任意のセッションでクリップボタン / ドラッグ / ペーストして送信 | 日常的な画像の質問——ファイル保存もモデル切り替えも不要 | | **B. ビジョンモデルセッション** | 新規会話で「智譜 GLM-4V-Flash（視覚）」を選び、画像を貼って会話 | 画像を中心にした複数ターンの会話、ネイティブ `read_image` | | **C. ファイル + スキル** | 画像をワークスペースに置き「vision-review でこの画像を読んで」と言う | 一括チェック、スクリプト化した処理 | 説明の言語はメッセージの言語に自動追従（中国語メッセージ→中国語の説明、英語メッセージ→英語の説明、テキストなし→中国語）。そのほか、こう言うだけ： - 「この画像を見て / このスクリーンショットの視覚バグをチェックして」→ `vision-review` - 「〜の画像を生成して」→ `media-tools` ## 🗺️ 構成 ``` dsh-media-skills/ ├── package.json # dsh.bundle マニフェスト ├── cordis.patch.yml # プラグインレイヤー ├── index.js # スキル登録 + zhipu-vision モデルルートの自動書き込み ├── skills/ │ ├── vision-review/ # 画像読み取り │ └── media-tools/ # 画像生成 ├── docs/ │ ├── SETUP_VISION.md # ビジョン設定ガイド（中国語） │ ├── SETUP_VISION_EN.md # detailed setup guide (English) │ └── lang/ # 各言語 README ├── scripts/make-banner.py # docs/social-preview.png の再生成 └── docs/social-preview.png ``` ## 🤝 DSH プラグインエコシステムに参加 DeepSeek Harness 開発者プレビューは、Harness 開発者向けのテスト段階にあります。コアプラグインとベース API は進化を続けます。オープンソースで、オープンで、再利用可能で、組み合わせ可能なインフラの上で、世界中の開発者とともに知能の限界を探求していきましょう。 - [dsh-plugin トピック](https://github.com/topics/dsh-plugin) - [クイックスタート](https://deepseek-harness.github.io/deepseek-harness/guide/quickstart) - [DeepSeek Harness リポジトリ](https://github.com/deepseek-ai/deepseek-harness) > このリポジトリに [`dsh-plugin`](https://github.com/topics/dsh-plugin) トピックを付けて発見されやすくしましょう。 ## 📄 License [MIT](../../LICENSE)