メインコンテンツへ移動
学習に戻る
02ワークベンチ読了目安 18 分初心者

初心者向け · 技術用語

DeepSeek Harness 技術用語クイックリファレンス

知らない用語は定義を調べ、日常の例と結び付けてください。実際に試したい場合は、後半の inventory.csv の実習で、ファイルの読み取り、合計の確認、一つの値の変更、復元まで進めてみましょう。

最終検証日
2026年9月6日
ガイドのソース基準
0.1.3-alpha.1
インストール状況
選択した項目の記録を確認
検証済みの範囲
  • DeepSeek Harness alpha.1 アーキテクチャと Web UI の語彙
  • DSH Themes の公開と外観に関する用語
  • 専門的な定義と短い日常的な説明
このページについて
  1. このリファレンスの使い方
  2. モデル、Agent、Harness
  3. 作業の整理方法
  4. 権限と安全
  5. 外観とインターフェース
  6. パッケージと検証
  7. 用語がまだ分からないとき
  8. 実習:ファイルの読み取りから変更の確認まで
  9. ファイル変更と会話履歴を区別する

このリファレンスの使い方

  1. ブラウザーのページ内検索で用語を探します。
  2. 正確さが必要なときは専門的な定義を読みます。
  3. まだ抽象的なら、日常的な説明を読みます。
  4. 権限変更、拡張の導入、パッケージ公開の前には、リンク先の詳しいガイドも確認します。

モデル、Agent、Harness

用語専門的な説明身近な例
AI モデル入力を解釈し、文章、コード、その他の出力を生成する統計的な仕組みです。モデルだけでコンピューターにアクセスすることはありません。日常的な説明:机で考える人に相当します。机、道具、鍵、記録は別の仕組みが用意します。
Agentモデルに指示、コンテキスト、ツール、繰り返し処理を組み合わせ、目標に向かって複数の手順を進める実行役です。日常的な説明:一度答えるだけでなく、調べ、作業し、結果を確認して続ける担当者です。
Agent HarnessAgent のためにモデル、ツール、コンテキスト、権限、セッション、画面を調整するソフトウェアです。日常的な説明:作業者を囲む管理された工房です。使える道具、鍵のかかった扉、記録内容を決めます。
Providerモデルを Harness で使えるようにし、要求形式と認証方法を処理するサービスまたはアダプターです。日常的な説明:同じ工房に異なる電力会社をつなげますが、会社ごとに契約と接続方法が違います。
Toolファイルを読む、文章を変える、コマンドを実行する、情報を探すなど、Agent が要求できる名前付き機能です。日常的な説明:道具箱の中の一つの道具です。置いてあっても、承認なしで使えるとは限りません。
Context現在のモデル要求に渡される指示、選ばれた履歴、ファイル、ツール結果などの情報です。日常的な説明:今回の判断のため机に開いた資料です。過去すべてを永久に覚える仕組みではありません。

作業の整理方法

用語専門的な説明身近な例
Workspace作業ディレクトリを指定し、関連する作業を整理するプロジェクトの場所。選択自体はセキュリティ境界を作りません。身近な例:作業指示書に書かれた住所です。鍵やアクセス規則は実行環境と権限設定が別に決めます。
Session一つの継続作業について、メッセージ、モデル出力、ツール操作、状態を保存する記録です。日常的な説明:後日戻っても話し合いと作業が分かるプロジェクト日誌です。
Turn一つの受け付けられた利用者入力によって始まる完全な応答周期で、複数のモデル処理やツール操作を含むことがあります。日常的な説明:窓口で一件依頼すると、回答までに内部で複数の作業が行われます。
StepTurn の中で行われる一回のモデル要求と、それに続くツール呼び出しです。日常的な説明:チェックリストの一項目です。Turn は依頼全体を表します。
Pluginサービス、イベント、ツール、画面部品などを Harness に追加する読み込み可能なソフトウェア単位です。日常的な説明:工房に追加する新しい機械や操作パネルです。
Profile一緒に起動する bundle、プラグイン、設定レイヤーを決める名前付き構成です。日常的な説明:仕事の種類ごとに保存した工房の設定です。DeepSeek Harness には web と headless のテンプレートがあります。
Skill範囲の決まった作業を Agent に教える、再利用可能な指示と補助資料のまとまりです。日常的な説明:確認済みの作業手順カードです。やり方は教えますが、新しいコンピューター権限を自動で与えません。
Runtimeタスクが実際に動くソフトウェア処理、依存版、設定、OS 環境です。日常的な説明:同じレシピでも実際の台所は違います。検証は本当に使う台所で行います。
Diff2つの状態の間でファイルや文章がどう変わったかを構造化して示す比較で、それ自体はどちらの状態も適用しません。日常的な説明:変更行を強調した変更前後の対照表です。diff を読むだけでは変更を採用したことになりません。
Hook指定したイベントの前後または途中で、定義済みの処理を実行するよう設定したトリガーです。日常的な説明:決まった応答につながる呼び鈴です。コードを実行できるため、出所と権限を確認します。
MCPModel Context Protocol の略で、Agent や Harness が MCP server を通じて外部ツールやデータへ接続するための標準規格です。日常的な説明:作業台と別のサービスを結ぶ共通コネクターです。接続できることは、そのサービスが信頼できる証明ではありません。
Cloudローカルコンピューターの外で提供され、独自のファイル、認証情報、ネットワーク、保存期間、課金境界を持つリモート実行環境です。日常的な説明:別の建物に借りる作業室です。仕事を渡す前に、鍵、保管、費用、後片付けの規則を確認します。

権限と安全

用語専門的な説明身近な例
Permission操作を許可するか、拒否するか、実行時に判断するかを示す規則です。日常的な説明:扉の入室名簿です。注意を促す文章だけでは入室制御になりません。
Approval特定の操作を続ける前に、人または方針が出す許可です。日常的な説明:鍵のかかった棚の前で作業者が止まり、鍵を使ってよいか尋ねます。
Sandboxプロセスが起こせる影響の一部を制限する技術的な境界です。範囲は環境と設定で変わります。日常的な説明:柵のある作業場所です。ファイル、ネットワーク、プロセスのどこまで柵があるか確認が必要です。
Credentialモデルサービス、リポジトリ、保護されたシステムで本人確認に使う秘密または識別トークンです。日常的な説明:鍵や銀行カードです。専用の設定や秘密保管場所に置き、チャットやプロジェクトファイルに書きません。
最小権限現在のタスクに必要なアクセスだけを、必要な期間だけ与える考え方です。日常的な説明:訪問者には会議室の鍵だけを渡し、建物全体の親鍵は渡しません。
Rollback変更が失敗した、または不要になったとき、以前の確認済み状態へ戻す準備済み操作です。日常的な説明:交換前に前の動作品と戻し方を保存しておきます。

外観とインターフェース

用語専門的な説明身近な例
セマンティックトークン固定色ではなく、背景や強調色など用途で名前を付けたデザイン値です。日常的な説明:「壁の色」や「警告灯」という用途ラベルです。Theme ごとに同じ用途へ別の色を割り当てられます。
Theme製品構造を変えず、通常は light と dark の両方を覆う、まとまりのある外観値です。日常的な説明:壁や家具の位置はそのまま、部屋の色と照明計画を変えます。
Full Skinより厳しい証拠規則のもとで、セマンティック値、管理された画像、生成スタイルを組み合わせる DSH Themes の公開区分です。日常的な説明:色、照明、一部の装飾を変えます。DSH Themes の形式であり、DeepSeek Harness 公式のネイティブ形式ではありません。
Plugin外観値だけでなく、画面上の作業手順を変更または追加する拡張です。日常的な説明:新しい操作パネルや作業場所を追加するため、見た目と同じくらい動作と権限が重要です。
TransportWeb 画面と実行中の Harness プロセスの間で要求、イベント、状態を運ぶ接続です。日常的な説明:操作室と工房を結ぶ配送路です。画面が見えても、配送路が接続済みとは限りません。

パッケージと検証

用語専門的な説明身近な例
Packageコード、メタデータ、資源、設定をまとめて導入する、版付きの配布単位です。日常的な説明:密封された商品箱です。棚の商品名だけでは、この箱の中身を証明できません。
Artifactダウンロード、導入、試験、公開の対象になる、正確なビルド済みファイルです。日常的な説明:手元に届いた実物の箱であり、カタログの商品説明ではありません。
SHA-256成果物の全バイトから計算する暗号学的ダイジェストで、安定したファイル指紋として使います。日常的な説明:指紋が一致すればファイルのバイトは同じです。ただし安全性やライセンスまで証明しません。
Sidecar成果物の横に別ファイルとして置き、識別情報、互換性、ハッシュ、証拠参照を記す機械可読記録です。日常的な説明:箱に添えた検査カードです。カードと箱の両方が一致する必要があります。
Attestation何を、どの環境で、どの入力に対して確認し、結果がどうだったかを示す署名済みまたは管理された記録です。日常的な説明:日付と対象が書かれた検査報告です。別の版の報告では目の前の項目を認証できません。
認証基準項目が必要な検証を完了したときの、正確な Harness 版と証拠の組み合わせです。日常的な説明:上流が新しくても、検査済みの版は古いことがあります。「新しい」と「認証済み」は別です。

用語がまだ分からないとき

  1. 01

    正確な用語を見つける

    製品名を含め、表示された言葉をそのままコピーします。

  2. 02

    どの層の話か分ける

    知能、作業整理、権限、画面、検証のどれを表すか考えます。

  3. 03

    製品固有の意味を確認する

    同じ言葉でも DeepSeek Harness、Pi、Codex などで意味が狭くなることがあります。

  4. 04

    危険な操作の前で止まる

    アクセス、認証情報、導入、削除に関係するなら、リンク先ガイドまたは公式資料を先に読みます。

見つけた用語から学習を続ける

実習:ファイルの読み取りから変更の確認まで

小さな在庫表で、用語と実際の操作を結び付けます。ファイルを読み、計算を確認し、値を一つ変更して、何が保存されるか確かめましょう。空の練習用フォルダーを作り、クイックスタートに従って Harness Web のワークスペースとモデルを設定します。

text
item,quantity,unit_price
tea,3,12
mug,2,25
bag,1,18
練習用フォルダーに inventory.csv として保存
  1. 01

    ワークスペースを選ぶ

    inventory.csv を含むフォルダーを選びます。作業ディレクトリを選択するだけでは、ファイルシステムやネットワークを隔離するサンドボックスは作られません。

  2. 02

    実行設定を確認する

    このセッションのモデルと権限プリセットを確認します。profile はプラグインと設定の組み合わせであり、作業フォルダーや保存された会話とは別です。

  3. 03

    読み取りを依頼する

    下のプロンプトを送り、実際のファイル読み取り呼び出しと結果を展開して、手元のファイルと各行を照合します。自然な回答だけでは読み取りの証明になりません。

text
選択中のワークスペースの inventory.csv を読み、各商品の quantity × unit_price と小計、合計を示してください。実際に読んだファイルのパスも示し、ファイルは変更しないでください。読めない場合は不足するツールや権限を説明し、内容を作り上げないでください。
最初の依頼:読み取りと計算

期待値は tea が 36、mug が 50、bag が 18、合計が 104 です。これは算術の確認であり、モデルの能力評価ではありません。違う場合は入力行、掛け算、足し算を別々に確認します。

用語専門的な説明身近な例
ワークスペースinventory.csv があるフォルダー。画面で選んだパスとツール呼び出しのパスを照合します。
モデルとツールモデルが読み取りを要求し、登録されたツールが内容またはエラーを返します。最終回答を実行ログと見なさず、呼び出しと結果を確認します。
コンテキスト返された CSV を次のモデル要求で利用できます。編集後は再読み取りを依頼します。以前の結果は古い可能性があります。
ターンとステップ一つの依頼のターンに、複数のモデル要求やツール呼び出しが含まれる場合があります。実際の呼び出しを数え、一つのユーザーメッセージと一回のモデル要求を同一視しません。
セッション継続中の会話には、確定したメッセージやツールの動作が記録されます。同じセッションを開いて以前の読み取りを確認します。ファイルの復元とは別です。

ファイル変更と会話履歴を区別する

text
inventory.csv の tea の quantity だけを 3 から 4 に変更してください。保存したファイルを再度読み、変更した行と全商品の小計、合計を示してください。他のデータ行は変更しないでください。
ファイル変更と会話履歴を区別する

保存した行は tea,4,12、合計は 116 になるはずです。自分でもファイルを開いて元の例と比べます。セッションを開き直したり分岐したりしても、ファイル変更は自動で戻りません。例の初期状態に戻すには、その行を tea,3,12 に戻して 104 を確認します。Git を使う場合は、復元する内容を決める前に差分を確認してください。

  • 呼び出しがない、またはファイルが見つからない場合は、作業場所とファイル名を確認します。パスの誤りを無制限の権限で解決しようとしないでください。
  • 操作が拒否された場合は、実際の承認・サンドボックスエラーと対象範囲を読みます。profile 名や「読み取りのみ」という依頼文自体には強制力がありません。
  • 変更後も 104 と答える場合は、現在のファイルを読み直し、会話中の古い結果を参照していないか確認します。

一次資料となる公式文書を読む

よくある質問

変更を行う前に

フォーマット、互換性、証拠、ロールバックに関する回答

このガイドでは何を確認しますか?

このガイドの対象:DeepSeek Harness alpha.1 アーキテクチャと Web UI の語彙、DSH Themes の公開と外観に関する用語、専門的な定義と短い日常的な説明

最初に何をすべきですか?

知らない用語は定義を調べ、日常の例と結び付けてください。実際に試したい場合は、後半の inventory.csv の実習で、ファイルの読み取り、合計の確認、一つの値の変更、復元まで進めてみましょう。

最も重要な境界は何ですか?

たとえ話は理解の助けになりますが、製品の正確な動作を置き換えません。特に権限、サンドボックス、認証情報、互換性は実際の設定と証拠を確認してください。

プロファイルはファイルシステムのサンドボックスですか?

いいえ。プロファイルは読み込むプラグインと設定を決めます。ファイルシステムやプロセスの隔離は、使用中の実行器とサンドボックスの設定によって決まります。

正しい回答ならツールを実行した証拠になりますか?

いいえ。実際の呼び出しと返された内容を確認し、ファイルも自分で調べてください。期待値は照合用であり、ファイルアクセスの証明ではありません。

古いセッションを開くとファイルも元に戻りますか?

戻りません。会話履歴と作業ファイルは別の状態です。現在のファイルを確認し、必要な復元操作を明示的に行います。

学習を続ける

検証済みの証拠から続ける

公開済みのアーティファクトを比較するか、インストール手順に戻ります。