このリファレンスの使い方
- ブラウザーのページ内検索で用語を探します。
- 正確さが必要なときは専門的な定義を読みます。
- まだ抽象的なら、日常的な説明を読みます。
- 権限変更、拡張の導入、パッケージ公開の前には、リンク先の詳しいガイドも確認します。
モデル、Agent、Harness
| 用語 | 専門的な説明 | 身近な例 |
|---|---|---|
| AI モデル | 入力を解釈し、文章、コード、その他の出力を生成する統計的な仕組みです。モデルだけでコンピューターにアクセスすることはありません。 | 日常的な説明：机で考える人に相当します。机、道具、鍵、記録は別の仕組みが用意します。 |
| Agent | モデルに指示、コンテキスト、ツール、繰り返し処理を組み合わせ、目標に向かって複数の手順を進める実行役です。 | 日常的な説明：一度答えるだけでなく、調べ、作業し、結果を確認して続ける担当者です。 |
| Agent Harness | Agent のためにモデル、ツール、コンテキスト、権限、セッション、画面を調整するソフトウェアです。 | 日常的な説明：作業者を囲む管理された工房です。使える道具、鍵のかかった扉、記録内容を決めます。 |
| Provider | モデルを Harness で使えるようにし、要求形式と認証方法を処理するサービスまたはアダプターです。 | 日常的な説明：同じ工房に異なる電力会社をつなげますが、会社ごとに契約と接続方法が違います。 |
| Tool | ファイルを読む、文章を変える、コマンドを実行する、情報を探すなど、Agent が要求できる名前付き機能です。 | 日常的な説明：道具箱の中の一つの道具です。置いてあっても、承認なしで使えるとは限りません。 |
| Context | 現在のモデル要求に渡される指示、選ばれた履歴、ファイル、ツール結果などの情報です。 | 日常的な説明：今回の判断のため机に開いた資料です。過去すべてを永久に覚える仕組みではありません。 |
作業の整理方法
| 用語 | 専門的な説明 | 身近な例 |
|---|---|---|
| Workspace | タスクの中心となる、選択したプロジェクトの場所です。中のファイルとコマンドが主な作業範囲になります。 | 日常的な説明：作業者に渡した一つの部屋であり、建物全体への通行証ではありません。 |
| Session | 一つの継続作業について、メッセージ、モデル出力、ツール操作、状態を保存する記録です。 | 日常的な説明：後日戻っても話し合いと作業が分かるプロジェクト日誌です。 |
| Turn | 一つの受け付けられた利用者入力によって始まる完全な応答周期で、複数のモデル処理やツール操作を含むことがあります。 | 日常的な説明：窓口で一件依頼すると、回答までに内部で複数の作業が行われます。 |
| Step | Turn の中で行われる一回のモデル要求と、それに続くツール呼び出しです。 | 日常的な説明：チェックリストの一項目です。Turn は依頼全体を表します。 |
| Plugin | サービス、イベント、ツール、画面部品などを Harness に追加する読み込み可能なソフトウェア単位です。 | 日常的な説明：工房に追加する新しい機械や操作パネルです。 |
| Profile | 一緒に起動する bundle、プラグイン、設定レイヤーを決める名前付き構成です。 | 日常的な説明：仕事の種類ごとに保存した工房の設定です。DeepSeek Harness には web と headless のテンプレートがあります。 |
| Skill | 範囲の決まった作業を Agent に教える、再利用可能な指示と補助資料のまとまりです。 | 日常的な説明：確認済みの作業手順カードです。やり方は教えますが、新しいコンピューター権限を自動で与えません。 |
| Runtime | タスクが実際に動くソフトウェア処理、依存版、設定、OS 環境です。 | 日常的な説明：同じレシピでも実際の台所は違います。検証は本当に使う台所で行います。 |
| Diff | 2つの状態の間でファイルや文章がどう変わったかを構造化して示す比較で、それ自体はどちらの状態も適用しません。 | 日常的な説明：変更行を強調した変更前後の対照表です。diff を読むだけでは変更を採用したことになりません。 |
| Hook | 指定したイベントの前後または途中で、定義済みの処理を実行するよう設定したトリガーです。 | 日常的な説明：決まった応答につながる呼び鈴です。コードを実行できるため、出所と権限を確認します。 |
| MCP | Model Context Protocol の略で、Agent や Harness が MCP server を通じて外部ツールやデータへ接続するための標準規格です。 | 日常的な説明：作業台と別のサービスを結ぶ共通コネクターです。接続できることは、そのサービスが信頼できる証明ではありません。 |
| Cloud | ローカルコンピューターの外で提供され、独自のファイル、認証情報、ネットワーク、保存期間、課金境界を持つリモート実行環境です。 | 日常的な説明：別の建物に借りる作業室です。仕事を渡す前に、鍵、保管、費用、後片付けの規則を確認します。 |
権限と安全
| 用語 | 専門的な説明 | 身近な例 |
|---|---|---|
| Permission | 操作を許可するか、拒否するか、実行時に判断するかを示す規則です。 | 日常的な説明：扉の入室名簿です。注意を促す文章だけでは入室制御になりません。 |
| Approval | 特定の操作を続ける前に、人または方針が出す許可です。 | 日常的な説明：鍵のかかった棚の前で作業者が止まり、鍵を使ってよいか尋ねます。 |
| Sandbox | プロセスが起こせる影響の一部を制限する技術的な境界です。範囲は環境と設定で変わります。 | 日常的な説明：柵のある作業場所です。ファイル、ネットワーク、プロセスのどこまで柵があるか確認が必要です。 |
| Credential | モデルサービス、リポジトリ、保護されたシステムで本人確認に使う秘密または識別トークンです。 | 日常的な説明：鍵や銀行カードです。専用の設定や秘密保管場所に置き、チャットやプロジェクトファイルに書きません。 |
| 最小権限 | 現在のタスクに必要なアクセスだけを、必要な期間だけ与える考え方です。 | 日常的な説明：訪問者には会議室の鍵だけを渡し、建物全体の親鍵は渡しません。 |
| Rollback | 変更が失敗した、または不要になったとき、以前の確認済み状態へ戻す準備済み操作です。 | 日常的な説明：交換前に前の動作品と戻し方を保存しておきます。 |
外観とインターフェース
| 用語 | 専門的な説明 | 身近な例 |
|---|---|---|
| セマンティックトークン | 固定色ではなく、背景や強調色など用途で名前を付けたデザイン値です。 | 日常的な説明：「壁の色」や「警告灯」という用途ラベルです。Theme ごとに同じ用途へ別の色を割り当てられます。 |
| Theme | 製品構造を変えず、通常は light と dark の両方を覆う、まとまりのある外観値です。 | 日常的な説明：壁や家具の位置はそのまま、部屋の色と照明計画を変えます。 |
| Full Skin | より厳しい証拠規則のもとで、セマンティック値、管理された画像、生成スタイルを組み合わせる DSH Themes の公開区分です。 | 日常的な説明：色、照明、一部の装飾を変えます。DSH Themes の形式であり、DeepSeek Harness 公式のネイティブ形式ではありません。 |
| UI Extension | 外観値だけでなく、画面上の作業手順を変更または追加する拡張です。 | 日常的な説明：新しい操作パネルや作業場所を追加するため、見た目と同じくらい動作と権限が重要です。 |
| Transport | Web 画面と実行中の Harness プロセスの間で要求、イベント、状態を運ぶ接続です。 | 日常的な説明：操作室と工房を結ぶ配送路です。画面が見えても、配送路が接続済みとは限りません。 |
パッケージと検証
| 用語 | 専門的な説明 | 身近な例 |
|---|---|---|
| Package | コード、メタデータ、資源、設定をまとめて導入する、版付きの配布単位です。 | 日常的な説明：密封された商品箱です。棚の商品名だけでは、この箱の中身を証明できません。 |
| Artifact | ダウンロード、導入、試験、公開の対象になる、正確なビルド済みファイルです。 | 日常的な説明：手元に届いた実物の箱であり、カタログの商品説明ではありません。 |
| SHA-256 | 成果物の全バイトから計算する暗号学的ダイジェストで、安定したファイル指紋として使います。 | 日常的な説明：指紋が一致すればファイルのバイトは同じです。ただし安全性やライセンスまで証明しません。 |
| Sidecar | 成果物の横に別ファイルとして置き、識別情報、互換性、ハッシュ、証拠参照を記す機械可読記録です。 | 日常的な説明：箱に添えた検査カードです。カードと箱の両方が一致する必要があります。 |
| Attestation | 何を、どの環境で、どの入力に対して確認し、結果がどうだったかを示す署名済みまたは管理された記録です。 | 日常的な説明：日付と対象が書かれた検査報告です。別の版の報告では目の前の項目を認証できません。 |
| 認証基準 | 項目が必要な検証を完了したときの、正確な Harness 版と証拠の組み合わせです。 | 日常的な説明：上流が新しくても、検査済みの版は古いことがあります。「新しい」と「認証済み」は別です。 |
用語がまだ分からないとき
- 01
正確な用語を見つける
製品名を含め、表示された言葉をそのままコピーします。
- 02
どの層の話か分ける
知能、作業整理、権限、画面、検証のどれを表すか考えます。
- 03
製品固有の意味を確認する
同じ言葉でも DeepSeek Harness、Pi、Codex などで意味が狭くなることがあります。
- 04
危険な操作の前で止まる
アクセス、認証情報、導入、削除に関係するなら、リンク先ガイドまたは公式資料を先に読みます。
見つけた用語から学習を続ける
一次資料となる公式文書を読む
DeepSeek Harness v0.1.1-rc.2 リリースこのガイドが参照する上流のリリースタグとソースコミットを確認します。DeepSeek Harness RC.2 README固定された製品定義、開発者プレビューの境界、Web UI の起動経路を確認します。DeepSeek Harness RC.2 アーキテクチャ固定されたプラグイン、Profile、バンドル、ツール、セッションモデルを確認します。DeepSeek Harness RC.2 Web UI ガイド固定されたモデル設定、ワークスペース選択、最初のタスク、承認動作を確認します。DeepSeek Harness の権限プリセットsandbox mode と approval policy の組み合わせ、および実際の強制境界を確認します。DeepSeek Harness の Skills サブシステム探索、プロバイダー、識別子、読み込み、呼び出しの境界を確認します。
よくある質問
変更を行う前に
フォーマット、互換性、証拠、ロールバックに関する回答
このガイドでは何を確認しますか？
このガイドの対象：DeepSeek Harness rc.2 のアーキテクチャと Web UI 用語、DSH Themes の公開と外観に関する用語、専門的な定義と短い日常的な説明
最初に何をすべきですか？
用語を暗記する必要はありません。分からない言葉を見つけたら、まず正確な定義を読み、次に日常的な説明で身近なものと結び付けてください。
最も重要な境界は何ですか？
たとえ話は理解の助けになりますが、製品の正確な動作を置き換えません。特に権限、サンドボックス、認証情報、互換性は実際の設定と証拠を確認してください。
学習を続ける
検証済みの証拠から続ける
公開済みのアーティファクトを比較するか、インストール手順に戻ります。