PageSourceSearch
Opt out API access

https://deepseek-gui.com/assets/ja-EYxqY-ND.js

js deepseek-gui.com collected 2026-10-08 16:13:07 UTC 335,503 bytes, 2,925 lines download raw bytes 

1const n=`---
2slug: agents-subagents-and-memory
3lang: ja
4group: workspace-tools
5order: 40
6status: published
7updatedAt: 2026-07-17
8keywords: Agent | メイン Agent | サブエージェント | 委任 | バックグラウンドタスク | 独立セッション | 並列 | キュー | 権限 | Agent Profile | 自動モデル役割 | Memory | 長期 Memory | Memory インポート | Memory エクスポート | Computer Use | マウスとキーボード操作
9title: Agent、サブエージェント、長期 Memory
10description: Agent Profile を設定して並列作業を安全に委任し、Kun の長期 Memory とコンピューター操作をユーザー、ワークスペース、プロジェクトのスコープで管理します。
11---
12
13Agent は依頼を解釈し、許可されたツールを呼び出して結果を返します。サブエージェントと Memory は複雑な作業を高速化し、会話をまたいだ連続性を保てますが、同時実行される操作と再利用される情報の範囲も広げます。自動化を増やす前に、タスク、権限、Memory のスコープを定義してください。
14
15![ランタイム、Provider、権限、高度なコントロールを表示する Agent 設定](/docs-media/screenshots/agent-settings-en.webp)
16
17*Agents ページはローカルランタイムと既定 Agent のコントロールセンターです。*
18
19- **Settings → AI assistant** から入り、上位コントロールで既定の Provider、モデル、プロンプトルール、ツール権限モードを設定します。
20- 状態と診断操作はランタイムの証拠として扱い、特定モデルがすべてのツールに対応する証明とは考えないでください。
21- ポート、バイナリ、トークン、Computer Use の変更によってランタイムが再起動する場合があります。編集前に実行中ターンを完了してください。
22
23## 既定 Agent とローカルランタイムを設定する
24
25**Settings → AI assistant** を開きます。日常的なコントロールは次のとおりです。
26
27| 設定 | 目的 | 推奨事項 |
28| --- | --- | --- |
29| Auto-start | Kun とともにローカル Agent サービスを起動 | 通常利用ではオンのままにする |
30| Model Provider / Default model | ローカルの上書きがない場合の接続とモデルを選択 | 先に Providers ページで接続と機能をテストする |
31| Code Prompt Prefix | Code の依頼前に固定の開発制約を追加 | すべてのプロジェクトに適用される安定したルールだけを残す |
32| Prompt optimization | Composer に Optimize 操作を追加し、別のモデルリクエストで下書きを書き換える | 必要に応じて専用の Provider、モデル、プロンプトを選択。タイムアウトは 1 から 600 秒、既定は 60 秒 |
33| Reduce context usage | 安全なツール説明と結果を圧縮し、簡潔な回答を依頼 | 既定でオフ。長いタスクや大規模な MCP カタログで有効化 |
34| AGENTS.md instructions | 各ターンに Kun ネイティブのグローバル・ワークスペース指示を注入 | 既定でオン。診断には前ターンのソース件数を表示 |
35
36**Assistant advanced settings** では、ローカルポートの既定は \`18899\`、範囲は \`10000–65535\` です。通常、カスタムバイナリは空のままにします。データディレクトリの既定は \`~/.kun/data\` です。ローカルアクセストークンのフィールドが空なら Kun が生成します。トークンなしのローカルアクセスを許可するのは、信頼できる開発環境だけにしてください。
37
38Auto-start、バイナリ、ポート、データディレクトリ、ランタイムトークン、ストレージ、トークンなしアクセスの変更、通常の HTTP Provider と Agent SDK Provider の切り替え、macOS での Computer Use 有効化では、ローカルランタイムが自動再起動する場合があります。先に実行中の作業を停止または完了してください。
39
40![ランタイム、ストレージ、コンテキスト、ループガードに関する高度な Agent 設定](/docs-media/screenshots/settings-agent-advanced-en.webp)
41
42*高度な設定はローカルランタイムとモデルのコンテキスト保護に直接影響するため、ほとã

42‚“どのユーザーには既定値が適切です。*
43
44- 具体的なポート、ストレージ、省略、タイムアウト、繰り返し呼び出しの問題を診断する場合にだけ、関連するコントロールを 1 つずつ変更します。
45- 保存後はランタイムがオンラインへ戻るまで待ち、小さなタスクで確認します。アクセストークンとローカルパスを共有画像やログに含めないでください。
46- 上限を大きくしても常に良くなるわけではなく、待ち時間、使用量、障害の範囲が増える場合があります。
47
48## ツール権限モードを選ぶ
49
50権限変更は次のターンから適用され、メイン Agent とその子 Agent の機能上限を設定します。
51
52| モード | 実効的な動作 |
53| --- | --- |
54| **Always ask** | すべてのツール呼び出しを確認。最も慎重で、最も頻繁に中断される |
55| **Read only** | 読み取りは自動実行可能。書き込みとコマンドは事前確認が必要で、読み取りはワークスペース内に限定 |
56| **Sensitive operations ask** | 通常の読み取りは自動実行。機密性の高い操作は確認が必要 |
57| **Ask for workspace writes** | ワークスペースのファイル変更を確認。ワークスペース外の書き込みとホストコマンドはブロックされたまま |
58| **Trusted workspace** | ワークスペース内の編集はプロンプトなしで実行。ワークスペース外の書き込みとホストコマンドはブロックされたまま |
59| **Full access** | 確認せずフルアクセス。最も高リスクで、監視可能な信頼済み作業だけに使用 |
60
61権限モードは OS のセキュリティ境界ではなく、サーバー側の認可、Git バックアップ、レビューの代わりにもなりません。カタログに表示される MCP サービス、Skill、Computer Use ツールも、このモード、Profile の機能、システム権限によって制限されます。
62
63## メイン Agent とサブエージェントを区別する
64
65| 役割 | 主な責任 | 確認すべきもの |
66| --- | --- | --- |
67| **Main agent** | 現在の会話の成果、コンテキスト、Plan、最終納品を維持 | 作業ディレクトリ、モデル、権限、Goal、受け入れ条件 |
68| **Subagent** | 範囲を限定した 1 つの子タスクを受け取り、独立して調査または実行して結果を返す | 子タスクの範囲、Profile、ツールポリシー、状態、出力の証拠 |
69| **Automatic system role** | Compact、コードレビュー、タイトル生成、要約など、焦点の明確なタスクを処理 | モデルの利用可能性、コスト、出力品質 |
70
71サブエージェントは単なる「より賢いスレッド」ではなく、メインの流れにある未記載の意図をすべて推測することもありません。委任前に、期待する結果、範囲、禁止操作、返却形式を記載してください。調査には読み取り専用の役割を優先し、変更が必要な場合だけ制御された書き込み範囲を与えます。
72
73## Agent Profile と自動役割を設定する
74
75![目的、モデル、システムプロンプトを表示する New Agent Profile フォーム](/docs-media/screenshots/agent-profile-editor-en.webp)
76
77*カスタム Agent Profile は、安定した役割と見える機能を再利用可能な設定にします。*
78
79- Profile をメイン Agent、委任、または両方に使うかを選び、明確な名前、説明、モデル、長期的なシステムプロンプトを指定します。
80- 読み取り専用または最小限の機能から始め、役割が必要とする場合だけ内蔵ツール、MCP サーバー、Skills を追加します。
81- Profile は現在の権限上限を超えられず、作業ディレクトリを自動的に分離しません。
82
83Agent とサブエージェントの設定には、内蔵 Profile とカスタム Profile があります。表示されるフィールドは、名前、説明、色、利用モード、モデル、システムプロンプト、機能スコープです。
84
85- **Delegate** は Profile を子タスクで利用可能にします。
86- **Main agent** は Profile を現在の会話の Persona または作業スタイルとして利用可能にします。
87- **Both** はメイン Agent の選択と委任の両方に公開します。
88- **Read-only / All / Custom capabilities** は、メイン Agent の機能を超えない範囲で、見える内蔵ツール、MCP サービス、Skills を制御します。
89
90![機能スコープ、内蔵ツール、MCP サーバー、Skills を表示する Agent Profile の Permissions タブ](/docs-media/screenshots/agent-profile-permissions-en.webp)
91
92*Permissions タブは、Profile で意図した役割を、明示的で確認可能な機能セットへ変えます。*
93
94- **Read-only** から始め、既知の一部が必要な場合にだけ **Custom**、信頼できる広い役割でのみ **All** を使います。
95- 内蔵ツール、MCP サーバー、Skills を個別に検索・切り替えます。件数が示すのはこの Profile が見られるものだけで、すべての Agent がアクセスできるものではありません。
96- 選択内容はメイン Agent の上限と現在のワークスペースポリシーを継承するため、ここで有効にしてもブロックされたツールや OS 権限は回避できません。
97
98タスク完了に必要な最小限の機能から、カスタム機能セットを作ります。不要なツール、MCP サービス、Skill を隠す方が、プロンプトに「使わないで」と書くより確実です。Profile の編集後は、小さな読み取り専用タスクでモデル、プロンプト、機能を確認してください。
99
100Settings → Subagents の自動モデル役割には、明示的なフォールバックがあります。
101
102| 自動役割 | 空の場合に使用 | 設定可能なコントロール |
103| --- | --- | --- |
104| Context compaction | 現在のメイン会話モデル | Provider とモデル |
105| Code review | 既定モデル | Provider、モデル、そのモデルが宣言する Reasoning effort。分離された読み取り専用タスクとして実行 |

106| Title | Small model | Provider、モデル、対応する Reasoning effort |
107| Summary | Small model | Provider、モデル、対応する Reasoning effort |
108| Small model | 既定モデル | Provider とモデル。Title と Summary で共有するフォールバック |
109
110低コストモデルはタイトルや要約に適する場合がありますが、レビューと長いコンテキストの Compact では精度とコンテキスト容量を優先してください。Compact は常にモデル要約を使います。ローカルのヒューリスティックはその呼び出しが失敗またはタイムアウトした場合の内部フォールバックにすぎないため、現在の UI に Summary mode のスイッチはありません。Provider を削除または置き換える前に、それを参照しているすべての Profile と自動役割を確認します。
111
112## 委任可能な役割を設定し、独立セッションを確認する
113
114![委任可能な役割、モデル継承、New subagent を表示する Subagents パネル](/docs-media/screenshots/subagents-panel-en.webp)
115
116*ワークベンチの Subagents パネルは、Agent が委任できる役割を設定する場所で、実行中タスクの一覧ではありません。*
117
118- 委任前に各役割の説明とモデル継承を確認します。これらの設定は役割の責任と既定機能を定義します。
119- **New subagent** は再利用可能な役割 Profile を作成します。すぐにバックグラウンド作業を開始するものではありません。
120- 委任後の Queued、Running、Approval、Failed、Completed 状態は、会話タイムラインのタスクカードに表示されます。そのカードを開いて子セッションへ移動できます。
121- 並列セッションが同じワークスペースを変更する場合があるため、書き込みを許可する前にファイル所有範囲を定義します。
122
123![読み取り専用 Explore サブエージェントの Done 状態、所要時間、ステップ数を表示する実際の委任タスクカード](/docs-media/screenshots/subagent-run-live-en.webp)
124
125*この実際の実行では、メイン Agent の読み取り専用 Explore チェックが完了し、Profile、Done 状態、経過時間、ステップ数が 1 枚のカードに表示されています。*
126
127- メイン Agent は範囲を限定した調査を、読み取り専用の **Explore** Profile に委任できます。カードには実際の Profile が表示され、**Done**、経過時間、ステップ数を確認できます。
128- 右側の外部リンクアイコンまたは矢印を選んで独立した子セッションへ入り、入力、ツール出力、状態の証拠を確認します。メイン会話はサブエージェントツールの結果を待ってから、要約または次のステップを再開します。
129- サブエージェントは選択 Profile、メイン Agent、現在のワークスペースが許可する権限を超えられません。委任しても読み取り専用の Explore 役割が書き込み可能にはなりません。
130
131良い委任タスクは独立して受け入れられます。例:
132
133> Payment モジュールの再試行動作を読み取り専用で調査してください。関連ファイル、現在の動作、可能性の高い 2 つのリスク、証拠を返してください。ファイルを編集せず、本番へ接続し得るコマンドを実行しないでください。
134
135会話タイムラインの委任タスクカードには、Queued、Running、Awaiting approval、Done、Failed の状態と、利用可能なステップ、使用量、権限ポリシーなどの詳細が表示されます。**Open child session** を使うと独立したメッセージとツール処理を確認でき、親会話へ戻る手段もあります。別の Subagents パネルが行うのは再利用可能な役割の設定だけです。
136
137Background と指定されたサブエージェントは、ほかの作業を確認している間も続行できます。パネルを閉じたり会話を切り替えたりしてもキャンセルと考えず、その状態とバックグラウンド完了通知を確認してください。子の結論も、自動的にメインの判断にはなりません。メイン Agent に結果ã

137®æ¯”較、競合解決、採用した結論の Plan、Requirement、ファイルへの記録を依頼します。
138
139## 並列数、キュー、権限を制御する
140
141![並列数、会話ごとの上限、自動モデル役割を表示するサブエージェント設定](/docs-media/screenshots/settings-subagents-en.webp)
142
143*サブエージェント設定は並列容量と、Compact、レビュー、タイトル、要約に使用するモデルを制御します。*
144
145- デバイス容量、Provider のレート制限、ファイル競合リスクに応じて並列数を設定します。上限に達すると新しいタスクはキューに入ります。
146- タイトルや要約には、出力の信頼性を保てる場合だけ低コストモデルを使い、レビューと Compact には十分な精度とコンテキスト容量を持たせます。
147- 数値上限を上げても個別結果は改善しません。書き込み可能なセッションには引き続き別ファイルまたは分離 worktree が必要です。
148
149Settings では、同時実行するサブエージェントの最大数と、メイン会話ごとの子実行数を制限します。最大並列数の既定は \`3\`、範囲は \`1–64\` です。会話ごとの子実行数の既定は \`12\`、範囲は \`1–10000\` です。並列上限に達すると新しい作業はキューに入り、会話上限に達した場合は無制限に子を作らず、既存作業を完了、失敗、統合してください。
150
151書き込み可能なサブエージェントが同じファイルを同時編集しないよう、並列作業をファイルまたは問題領域で分割します。独立した子セッションでも、ワークスペース、外部サービス、ポート、データベースを共有する場合があります。ファイル分離が必要なら独立 worktree を使います。[Git と worktree](/docs/terminal-browser-and-worktrees)を参照してください。
152
153サブエージェントはメイン Agent の機能上限を超えられませんが、「All tools」にはファイル書き込み、コマンド、MCP サービス、Skills が含まれる場合があります。Awaiting approval 状態にはユーザーの判断が必要です。子セッションを開き、正確なパス、コマンド、理由を確認して、許可または拒否します。バックグラウンド実行は、取り消せない操作の権限を緩める理由にはなりません。
154
155## Skills と Smart MCP 選択を管理する
156
157![検出済みルート、読み込みスイッチ、追加ディレクトリを表示する Agent Skills 設定](/docs-media/screenshots/settings-skills-en.webp)
158
159*Skills 設定は、Runtime がどのワークスペース、グローバル、プラグインキャッシュ、追加の指示パッケージを読み込むかを決めます。*
160
161- 検出された各ルートのソースを確認し、使用するルートだけを有効にして、追加ディレクトリは 1 行につき 1 つ明示します。
162- サードパーティの \`SKILL.md\` とスクリプトを読んでから有効にします。ソース優先度は ID の重複を解決しますが、信頼性は確立しません。
163- 読み込まれた Skill は方法とリソースを提供し、現在の Agent とワークスペースポリシーを超える権限は付与しません。
164
165![Smart tool selection、候補数、Match threshold を表示する Agent MCP 設定](/docs-media/screenshots/settings-mcp-en.webp)
166
167*Smart MCP selection はモデルに表示する外部ツールカタログを減らしますが、各サーバーの権限は変えません。*
168
169- 小さなカタログでは Direct を使い、多数の接続ツールがコンテキストを消費したり曖昧さを増やしたりする場合は Auto または Always filter を検討します。
170- 診断を見ながら候補数と Match threshold を調整します。厳しすぎる値は必要なツールを隠し、広い値はより多くのコンテキストと選択肢を公開します。
171- MCP の環境変数とヘッダーは平文のシークレットとして保護してください。Filter は機密情報を削除せず、外部アカウントの権限も制限しません。
172
173Skills は現在のワークスペースの \`.agents/skills\`、\`.claude/skills\`、\`.codex/skills\`、\`.kun/skills\`、\`skills/\` と、ユーザーディレクトリ以下の対応ã

173™ã‚‹ 4 つのグローバルルートを自動検出します。追加ディレクトリは 1 行に 1 パスを指定し、検出済みルートを個別に切り替えられます。重複する Skill ID は、ワークスペース → グローバル → Codex プラグインキャッシュ → 追加ディレクトリの順で解決されます。追加ディレクトリは電話接続とスケジュールタスクでも考慮されます。
174
175Skill は指示とリソースを提供し、現在の Agent を超える権限は得ません。サードパーティの \`SKILL.md\` とスクリプトを有効化前に読んでください。グローバルルートはすべてのワークスペースに影響し、ワークスペースルートは現在のプロジェクトに従います。Profile の Permissions タブから、個別の内蔵ツール、MCP サーバー、Skill をさらにブロックできます。
176
177MCP の **Smart external tool selection** は既定でオフです。大きなカタログを接続した場合は有効にし、次から選びます。
178
179- **Auto:** ツール数がしきい値に達した後で Filter します。既定のしきい値は \`24\` です。
180- **Always filter:** 各リクエスト前に関連ツールを検索します。
181- **Direct:** すべてのツールをモデルへ提供します。
182
183候補数の既定は \`5\`、最大候補数は \`10\`、最小 Match は \`0.15\` です。Minimum-match の UI は \`0–1\` を受け付けます。Diagnostics には Filter 可能なツールと、実際にモデルへ公開された件数が表示されます。Filter はモデルに見えるカタログを減らすだけで、サーバーを信頼済みにしたり、権限を増やしたりしません。
184
185MCP エディターは User または Workspace のスコープ、ローカルコマンド、リモート HTTP / SSE サーバーに対応します。環境値とリクエストヘッダーは \`~/.kun/mcp.json\` に平文設定として保存されます。スクリーンショット、デバッグログ、Git に含めず、信頼できない MCP サービスへ広いスコープを与えないでください。
186
187## コンテキスト、ストレージ、ループガードを調整する
188
189これらのコントロールは **Settings → AI assistant → Assistant advanced settings** にあります。具体的な長いコンテキスト、繰り返し呼び出し、互換性の問題に対処する場合を除き、既定値を維持してください。
190
191| 設定 | 現在の既定値 | UI の範囲と動作 |
192| --- | --- | --- |
193| Conversation storage | Hybrid JSONL + SQLite index | JSONL only に切り替え可能。空の SQLite パスはデータディレクトリ内で管理 |
194| Unknown-model soft / hard compaction | \`96000\` / \`108800\` tokens | 最小 \`1024\`、\`1024\` 刻み。Hard は Soft 未満にならない。一致するモデルは独自の機能 Profile を使用 |
195| Compaction summary | Model summary。15 秒、2048 tokens、96 KiB input | タイムアウト 1 から 120 秒。出力 64 から 16000 tokens。入力 1 KiB から 8 MiB |
196| Stream idle timeout | \`450000 ms\`（450 秒） | \`0–3600000 ms\`。\`0\` で無効。長いプロンプトの Prefill 中に応答しないローカルモデルでは増加を検討 |
197| Repeated tool-call guard | オン。Window \`8\`、Threshold \`3\` | Window \`1–128\`、Threshold \`2–128\`。1 ターンで同じ呼び出しが繰り返されるのを抑制し、別の方法を要求 |
198| Model-visible tool output | \`20000\` lines、\`512000\` bytes | Lines \`1–1000000\`、Bytes \`1–64 MiB\`。モデルに見える Read と Shell の出力に適用 |
199| Tool-argument maximum string | \`512 KiB\` | \`1 KiB–16 MiB\`。より長い String は実行前に省略 |
200
201**Reduce context usage** を有効にすると、説明の圧縮、結果の圧縮、簡潔な回答が既定でオンになります。履歴 Hygiene の既定値と UI 範囲は次のとおりです。
202
203| 項目 | 既定値 | UI 範囲 |
204| --- | --- | --- |
205| Tool-result lines | \`320\` | \`1–100000\` |
206| Tool-result bytes | \`32 KiB\` | \`512 B–8 MiB\` |
207| Tool-result tokens | \`8000\` | \`128–256000\` |
208| Tool-argument string bytes | \`8 KiB\` | \`512 B–8 MiB\` |
209| Tool-argument string tokens | \`2000\` | \`128–64000\` |
210| Array items | \`80\` | \`1–10000\` |
211
212この圧縮は保存済みチャット履歴を書き換えませんが、次のリクエストで送られるコンテキストを変更します。モデルが完全な出力を見られない場合は、タイムラインの省略通知を確認し、関連する上限だけを引き上げます。
213
214**Assistant status** は読み取り専用の診断画面です。更新すると、MCP、Web、Instructions、Skills、Subagents、Images、Memory の準備状況に加え、現在のワークスペースに見えるツールのソース、添付状態、Memory を確認できます。Unavailable は、その機能が現在のランタイムで読み込まれなかったことを意味します。ページの通知、ログ、対応ã

214™ã‚‹è¨­å®šã‚’あわせて使ってください。Provider の接続テストが緑でも、すべてのツールを利用できる証明にはなりません。
215
216![MCP、Web、Skills、Subagents、Images、Memory の Assistant status 診断](/docs-media/screenshots/settings-agent-diagnostics-en.webp)
217
218*Assistant status は、現在のランタイムとワークスペースに読み込まれた機能の読み取り専用 Snapshot です。*
219
220- ページを更新し、各準備状態、ソース、件数を確認してから、対応する Provider、Skills、MCP、添付、Memory の設定に戻って修正します。
221- 緑色の Provider 接続テストが証明するのは基本接続だけで、ツールと添付経路の診断の代わりにはなりません。
222- Snapshot からローカルパスと機能詳細が分かる場合があります。共有前に機密情報を削除してください。
223
224## 長期 Memory のスコープを選ぶ
225
226![スコープとライフサイクルコントロールを表示する Memory 設定](/docs-media/screenshots/memory-settings-en.webp)
227
228*Memory 設定では、Kun が保持できる情報と、再利用するスコープを確認できます。*
229
230- 情報が関連性を保つ範囲に合わせ、User、Workspace、Project のスコープを選びます。
231- 保存済み項目がすべて正しいと考えず、個別の Memory を確認して無効にします。
232- Memory はコンテキストを提供しますが、現在の依頼、ワークスペース境界、権限ポリシーを上書きしません。
233
234Memory は既定でオフです。Settings → Memory の **Enable memory** をオンにすると、会話をまたいで事実と設定を保持し、後の関連コンテキストで利用できます。既定では、各ターンに最も関連性の高い有効な Memory を最大 8 件注入します。スイッチと記録の変更は次のターンから適用されます。Memory は言語設定、コーディングスタイル、プロジェクト規約などの安定した情報に適します。一時的な状態、パスワード、トークン、未検証の想定には適しません。
235
236| スコープ | 利用範囲 | 適切な内容 |
237| --- | --- | --- |
238| **User** | すべてのワークスペース | 安定した個人設定。会社やプロジェクトのシークレットは避ける |
239| **Workspace** | 1 つの作業ディレクトリ | そのワークスペースで共有する規約 |
240| **Project** | 1 つのプロジェクトパス | リポジトリ固有の技術・プロセスルール |
241
242記録の作成または編集時に、内容、対象パス、Tag、Confidence を確認します。対象パスが実際の関連付けを確立するため、同名プロジェクトだけではスコープを識別できません。Memory の変更は通常、次のターンから適用されます。記録を編集しても実行中の応答は再計算されません。
243
244Agent が長期 Memory を追加または削除する前には、ユーザーの明示的な承認が必要です。承認前に内容とスコープをすべて読んでください。Memory の Settings ページからの手動変更は直接的な管理操作です。1 回の承認によって、後から Agent がすべての Memory を書き換える権限は与えられません。
245
246## Memory の表示、無効化、復元、インポート、エクスポート
247
248![状態、スコープ、Confidence、Tag、メンテナンスコントロールを表示する実際の有効な Memory 記録](/docs-media/screenshots/memory-record-live-en.webp)
249
250*実際の Memory ページでは、マスタースイッチ、記録概要、User スコープの Memory 1 件がまとまり、セッションをまたいだ再利用を許可する前に内容と到達範囲を確認できます。*
251
252- **Enable memory** はマスタースイッチです。概要の **Active**、**Deleted**、**Status** で現在の記録件数と Memory がオンかを確認できます。スイッチと記録の変更は次のターンから適用され、実行中の応答は書き換えません。
253- **User / Workspace / Project** の Filter は 3 つのスコープに対å¿

253œã—、各行には実効スコープ、\`confidence\`、\`tags\` が表示されます。User スコープはワークスペースをまたいで利用されます。Workspace と Project のスコープは意図した正確なパスに関連付けてください。
254- 行の操作から記録の **表示、無効化、削除**を行い、**Import、Export、New** で一括レビュー、バックアップ、手動追加ができます。パスワード、API トークン、秘密鍵、顧客データ、その他のシークレットや機密情報を Memory に決して保存せず、エクスポートファイルも機密データとして保護してください。
255
256Memory ページでは表示中の記録を検索または絞り込みでき、作成、詳細表示、編集、無効化、復元、削除に対応します。
257
258- **Disable** は記録を復元可能なまま将来の利用を停止します。保持すべきか不明な場合に役立ちます。
259- **Delete** は現在の一覧から削除し、画面から復元できません。重要なルールは先にバージョン管理されたドキュメントへ保存します。
260- **Export** は環境が対応する場合に Markdown ファイルを作成し、Memory の内容をレビューまたはバックアップできるようにします。
261- **Import** は貼り付けた記録を解析し、User、Workspace、Project の対象へ追加します。重複は除外される場合があります。
262
263インポート前にすべての項目を読んでください。別のモデルが用意した Memory を無条件に信頼しないでください。User スコープはすべてのワークスペースで利用可能になり、Workspace と Project のインポートには正確な絶対パスが必要です。エクスポートには個人設定、顧客名、社内パス、プロジェクトの事実が含まれる場合があります。保存、転送、コミット前に機密情報を削除してください。
264
265> 注意: Memory の Import と Export が扱うのは Memory 記録だけです。会話、Provider 認証情報、OAuth 許可、ファイル、すべての Kun 設定を移行する仕組みではありません。[ワークスペースの権限とセキュリティ](/docs/workspace-permissions-security)を参照してください。
266
267## Computer Use を慎重に有効にする
268
269![Computer Use 設定と OS の権限状態](/docs-media/screenshots/settings-computer-use-en.webp)
270
271*Computer Use には Kun の設定と、それに対応する OS の権限の両方が必要です。*
272
273- タスクにマウス、キーボード、画面の操作が本当に必要な場合にだけ有効にします。
274- Desktop 操作は現在のプロジェクト外の内容にも到達できるため、操作を承認する前に見えている対象を確認します。
275- スイッチをオフにすると今後の Computer Use 呼び出しは停止しますが、すでに行われたクリックや送信済みテキストは取り消せません。
276
277Computer Use を使うと、Agent がスクリーンショットを撮り、実際のマウスとキーボードを操作できます。ツールを有効にした後の利用方法には 3 つのモードがあります。
278
279- **Off:** コンピューター操作をモデルへ公開しません。
280- **Auto (vision models only):** 画像対応モデルだけに公開し、モデルが呼び出すか判断します。
281- **Always:** すべてのモデルへ公開します。最も高リスクなモードで、Vision 非対応モデルが正しく操作できるようになるわけではありません。
282
283macOS では、マウスとキーボード操作に **Accessibility**、スクリーンショットに **Screen Recording** の両方を許可します。Accessibility の権限は、再確認前に Kun を完全終了して開き直す必要がある場合があります。ほかのシステムではタスクに必要な権限だけを許可してください。
284
285Computer Use は実際の Desktop を操作し、スクリーンショットにほかのアプリケーション、通知、機密内容が写る場合があります。継続的に観察して停止できる信頼済みタスクでだけ有効にしてください。最初にパスワードマネージャー、メッセージウィンドウ、本番コンソールを閉じます。支払い、認可、完全削除、公開、取り消せないアカウント変更を決して委任しないでください。機密性のない 

285Sandbox ページから始め、厳格な承認ポリシーを維持します。
286
287現在の UI が公開するのはマスタースイッチ、利用モード、システム権限状態だけです。設定 Schema には内部的なスクリーンショットの拡大縮小とターンごとの操作 Guard もありますが、このリリースには画面コントロールがありません。それらのフィールドを手作業で編集することを、安定した公開インターフェースと考えないでください。
288
289## Design Quality のセルフチェックを使う
290
291![有効状態と Relaxed、Standard、Strict レベルを表示する Design Quality 設定](/docs-media/screenshots/settings-design-quality-en.webp)
292
293*Design Quality は、Agent が対応するフロントエンドファイルを変更した後にヒューリスティックチェックを実行します。*
294
295- 通常の作業には Standard、誤検出の可能性を受け入れてより広く確認するには Strict、信頼度の最も高い指摘だけには Relaxed を使います。

296- 指摘は修正とレビューのきっかけとして扱い、Browser、デバイス、視差効果を減らすモード、アクセシビリティツールで画面を検証します。
297- このチェックはデザインが製品要件を満たすかを判断できず、人によるビジュアル受け入れの代わりにもなりません。
298
299Design Quality は既定でオン、厳格さは **Standard** です。Agent が HTML、CSS、JSX、TSX、SVG を書き込みまたは編集した後、Kun は無差別な紫・青グラデーション、入れ子のカード、コントラスト、読みやすい行幅、\`prefers-reduced-motion\` の欠落など、一般的な AI デザインの特徴と仕上げの問題を確認し、修正用にモデルへ指摘を返します。
300
301- **Relaxed** は最も信頼できるデザイン上の特徴だけを報告します。
302- **Standard** は一般的な仕上げの問題を追加し、多くのプロジェクトに適します。
303- **Strict** はより広いヒューリスティックを追加し、ときどき誤検出する場合があります。
304
305現在の UI が公開するのは Enabled と Strictness だけです。ルールの Ignore、ファイルの Ignore、指摘件数上限は Settings コントロールのない内部設定フィールドです。このセルフチェックはレビューを支援しますが、ビジュアル受け入れ、Browser テスト、アクセシビリティ監査の代わりにはなりません。
306
307## 監査可能な Agent の作業手順を作る
308
309- 最終成果と受け入れはメイン Agent が保持し、各サブエージェントには独立してレビューできる子タスクを渡します。
310- 調査には読み取り専用 Profile を使い、書き込み作業ではファイルとツールを制限します。
311- 並列タスクの結果が返ったら、Done 状態を受け入れるのではなく、証拠、差分、テストを比較します。
312- Profile、自動役割、Memory を定期的に確認し、古くなった内容を無効にします。
313- Computer Use、MCP、特権 Skills は、信頼できて観察可能な環境でのみ一時的に有効にします。
314- 納品前に[レビューと承認](/docs/review-and-approvals)を使い、すべての並列変更と外部副作用を確認します。
315`,e=`---
316slug: code
317lang: ja
318group: modes
319order: 10
320status: published
321updatedAt: 2026-07-17
322keywords: Code | プロジェクト | ファイル参照 | 添付ファイル | Terminal | Browser | 差分
323title: Code モードを使う
324description: 実際のローカルプロジェクトでエージェントに検索、編集、コマンド実行を任せ、差分と検証を通じて結果を管理します。
325---
326
327Code は実際のローカルプロジェクトを扱います。会話、ファイル、ツール実行、Terminal、Browser プレビュー、Plan、Todo、変更確認を 1 つのワークスペースにまとめます。リポジトリの理解、問題の特定、機能の実装、変更のレビューに利用できます。
328
329![ワークスペースと権限のコントロールが表示された Code モードの New Agent 画面](/docs-media/screenshots/new-agent-en.webp)
330
331*New Agent は、ワークスペースと操作境界を選択した後にのみ Code の会話を開始します。*
332
333- **Code** アイコンから入り、直接タスクには **New Agent**、構造化された製品ワークフローには **New requirement** を選びます。
334- 最初の指示を送信する前に、ワークスペース、Provider、モデル、権限モードを確認します。
335- 新しい会話には、編集、公開、別ディレクトリへのアクセスを行う暗黙の権限はありません。
336
337[実際の Code モードのウォークスルー](/docs-media/code.mp4)
338
339## 会話を開始する
340
341![コンテキストの追加と現在のワークスペースの選択に使う Composer のコントロール](/docs-media/screenshots/composer-controls-en.webp)
342
343*Composer では、Code の 1 ターンに指示、参照、ワークスペース、実行方法をまとめます。*
344
345- 現在の依頼に必要なファイルや添付だけを追加し、下部のワークスペースコントロールを確認します。
346- 送信前に、求める結果、許可する範囲、制約、検証方法を明記します。
347- Composer が送信するのは次のターンです。すでに実行中のコマンドやバックグラウンドタスクを遡って変更するものではありません。
348
349会話を作成する前にプロジェクトを選択してください。各依頼には、目標、範囲、制約、結果の検証方法を記載します。特定のファイルに集中してもらう必要がある場合は、曖昧なファイル名を文章で挙ã

349’るのではなく、ワークスペースのファイル参照を使ってください。
350
351Composer には画像、PDF、プレーンテキスト、Markdown、CSV、JSON も添付できます。画像を理解するには Vision 対応モデルが必要です。Kun はまず PDF からテキストを抽出し、必要に応じて OCR を使用します。ファイルごと、ターンごとの件数、合計サイズには上限があります。正確な値は[入力、添付ファイル、コンテキスト](/docs/composer-attachments-and-context#画像pdf音声入力を追加する)を参照してください。
352
353## モデルと推論レベルを選ぶ
354
355![現在の Provider とモデルを表示する Composer のモデルピッカー第 1 階層](/docs-media/screenshots/composer-models-en.webp)
356
357*第 1 階層で現在の Provider とモデルを確認し、矢印からその Provider のモデル一覧へ進みます。*
358
359- Composer 下部のモデルコントロールを開いて Provider を確認し、次の階層で設定済みモデルの 1 つを選びます。
360- ツールやビジョンなど、必要な機能にモデルを合わせてください。選択できるモデルが、すべての操作に対応しているとは限りません。
361- プロジェクトを切り替えたり、古い会話を復元したりした後は、選択内容を再確認します。
362
363モデルセレクターは、そのターンを処理するモデルを決定します。Reasoning は、対応モデルで利用できる推論量を調整します。Vision、ツール使用、長いコンテキストの動作は、その Provider でモデルに宣言された機能に依存します。[Provider とモデル](/docs/providers-and-models)を参照してください。
364
365## エージェントの実行を観察する
366
367![Code ワークベンチの Files パネル](/docs-media/screenshots/files-panel-en.webp)
368
369*ワークベンチのパネルでは、エージェントの説明と確認可能なプロジェクト状態を並べて見られます。*
370
371- 画像の **Files** ツリーとコンテキストメニューでパスを確認し、正確な参照を追加またはパスをコピーします。内容はファイルを別に開いて確認してください。
372- コマンドの証拠には **Terminal**、実行中の UI には **Browser** を使います。

373- **Changes** で編集を 1 行ずつ確認します。会話の要約は差分の代わりにはなりません。
374- パネルを閉じても表示が変わるだけで、バックグラウンドプロセスは停止せず、ファイルも元に戻りません。
375
376メッセージのタイムラインでは、通常の回答、推論、ツールの入力と結果、コマンド、ファイル変更、バックグラウンドシェル、サブエージェント、承認、ユーザーフォーム、レビュー結果、生成した成果物が該当ターンの下にまとまります。カードによっては、内容のコピー、詳細の展開、成果物の保存、依頼への回答、承認の許可または拒否ができます。文章の要約は、必ず実際のツール出力や差分と照合してください。
377
378パネルを切り替えた後も、バックグラウンドシェルやサブエージェントは実行を続けることがあります。カードの状態と完了通知を正しい情報として扱ってください。ターンを停止しても、完了済みの外部リクエストやファイル書き込みは取り消されません。承認が表示されたら、正確なパス、コマンド全体、外部の送信先、理由を確認してから判断してください。エージェントに編集を停止し、証拠を要約し、範囲を縮小するよう依頼することもできます。
379
380便利なサイドパネルには次があります。
381
382- ワークスペースを閲覧する **Files**。
383- ファイル単位の統合差分と追加・削除数を確認する **Changes**。
384- 現在のワークスペースでプロジェクトコマンドを実行する **Terminal**。
385- 検出されたローカル開発 URL を開いて結果を更新する **Browser**。
386- 複数ステップの作業に使う **Plan / Todo**。
387- 補助的なメモやビジュアル素材に使う **Canvas / Whiteboard**。
388
389表示されるパネルは、タスクやバージョンによって異なる場合があります。
390
391フッターの **Focus** スイッチは、Kun / iKun マスコットのアニメーション、カメオ、演出、その他の装飾的なキャラクター表示を抑えます。サイドバーを折りたたんだり、ワークベンチのパネルを隠したり、Agent、バックグラウンドコマンド、サブエージェントを一時停止したりするものではありません。実際のパネル動作については、[ワークベンチパネル、Git、worktree](/docs/terminal-browser-and-worktrees)を参照してください。
392
393## 納品前に検証する
394
395![実際のプロジェクト差分を表示する Changes パネル](/docs-media/screenshots/changes-diff-en.webp)
396
397*Changes は、エージェントが追加または編集したファイルの最終的な範囲を確認する場所です。*
398
399- 生成された設定やロックファイルを含め、変更済みファイルと未追跡ファイルをすべて確認します。
400- 差分を依頼内容と照合し、Terminal で関連するプロジェクトチェックを実行します。
401- レビュー済みの差分にも実行時エラーは残り得ます。また、テストに合格しても無関係な変更が正当化されるわけではありません。
402
403新しいコマンドを考案させるのではなく、プロジェクトにすでにあるチェックを実行するようエージェントに依頼してください。自分でも差分を確認し、範囲外の編集がないことを確かめ、\`/review\` で再度レビューします。[レビューと承認](/docs/review-and-approvals)も参照してください。
404
405複数モジュールにまたがる作業では、[要件ワークフロー](/docs/requirement-workflow)から始めてください。安全に画面の使い方を学ぶには、[最初のタスク](/docs/first-task)を試してください。
406`,o="---\nslug: commands-and-shortcuts\nlang: ja\ngroup: safety-help\norder: 30\nstatus: published\nupdatedAt: 2026-07-17\nkeywords: スラッシュコマンド | ショートカット | new | plan | goal | review | compact | fork | BTW\ntitle: コマンドとショートカット\ndescription: Kun 内蔵のスラッシュコマンドを確認し、インストール済みバージョンのキーボードショートカットを確かめます。\n---\n\n会話の Composer で `/` を入力すると、現在利用できるコマンドが表示されます。コマンドによっては選択画面を開いたり、範囲の指定を求めたりします。インストール済みの Skills もスラッシュコマンドとして表示される場合があります。\n\n## 内蔵コマンド\n\n- `/new` は新しい会話を開始します。\n- `/plan` は現在のタスクの

406実装計画を作成または更新します。\n- `/goal` は長時間の作業を通じて維持すべき成果を設定します。\n- `/research` は証拠と情報源を重視して、質問を反復的に調査します。\n- `/review` は未コミットの変更、ベースブランチ、コミット、またはカスタム範囲を確認します。\n- `/compact` は古いコンテキストを、継続に必要な情報へ圧縮します。\n- `/fork` は現在のコンテキストから独立した会話ブランチを作成します。\n- `/archive` は現在の会話をアーカイブします。\n- `/restore` は復元可能なアーカイブ済み会話を復元します。\n- `/btw` はメインの作業を中断せず、コンテキストを引き継いだサイド会話を作成します。\n\nたとえば、計画とレビューが必要な作業では、次の順序をよく使います。\n\n```text\n/goal\n/plan\n/review\n```\n\nコマンドは権限を回避しません。`/review` はコードの正しさを証明せず、`/plan` はすべてのステップを自動実行しません。また、重要な制約は `/compact` の前に記録する必要があります。\n\n`/research` は証拠を優先するオーケストレーション用プロンプトであり、独立して動作が保証された Deep Research のステートマシンではありません。最新ページへのアクセスは、引き続き Web、MCP、ネットワーク、Provider の利用状況に依存するため、情報源を自分で確認してください。\n\n## 適切なコマンドを選ぶ\n\n- 範囲が不明確な場合は、`/research` または Requirement から始めます。\n- 依存関係のあるステップには `/plan` を使い、成果を維持する必要がある場合は `/goal` も追加します。\n- 別の方法を試すには `/fork` を使います。\n- 関連する質問を 1 つだけ別に扱うには `/btw` を使います。\n- コンテキスト容量に近づいたら、重要事項を記録してから `/compact` を使います。\n- 納品前にプロジェクトのチェックを実行し、その後 `/review` を使います。\n\n## キーボードショートカット\n\nショートカットは、OS、現在のフォーカス、ユーザー設定によって異なります。インストール済みバージョンの **Settings → Shortcuts** を正しい情報として扱ってください。変更前に、OS、ブラウザー、入力メソッドのショートカットと競合しないか確認します。\n\nEnter、改行、送信に関する Composer の動作も設定に左右される場合があります。機密性の高いコマンドや長い未保存文章が入力欄にある状態ではなく、無害なメッセージで変更をテストしてください。\n\n## ショートカットを設定する\n\n![カスタマイズ可能なキー割り当てを表示するキーボードショートカット設定](/docs-media/screenshots/settings-shortcuts-en.webp)\n\n*Settings → Shortcuts には、このインストールで実際に適用されるキー割り当てが表示され、記憶した一覧より確実です。各コマンドには 1 つの組み合わせを登録できます。*\n\n- ページ検索で目的のコマンドを探し、現在のキー割り当てをクリックします。\n- 取り込み中に、使用したいキーの組み合わせを押します。名前を入力する必要はありません。\n- その組み合わせを別のコマンドがすでに使っている場合、Kun は該当コマンドを示して保存をブロックします。別の組み合わせを選ぶか、競合するコマンドを先に変更してください。\n- `Esc` を押すと取り込みをキャンセルし、元の割り当てを維持します。\n- コマンド行の丸いリセットアイコンをクリックすると、内蔵の既定割り当てに戻ります。\n\n![Toggle Plan mode の割り当てを取り込む際、Ctrl+N が New chat ですでに使われていることを示す Kun](/docs-media/screenshots/keyboard-shortcuts-conflict-live-en.webp)\n\n*実際の競合検証状態です。重複する `Ctrl+N` は New chat を置き換えず、Toggle Plan mode にも保存さã

406‚Œã¾ã›ã‚“。*\n\n- Send、Reload、Close、Quit など影響の大きいショートカットを変更した後は、問題のない状態でテストしてください。\n- リセットすると Kun の内蔵割り当てに戻りますが、OS や入力メソッドが予約したキーの組み合わせを解放することはできません。\n\n| コマンド | 現在の内蔵割り当て |\n| --- | --- |\n| Toggle Plan mode | `Shift+Tab` |\n| New conversation / choose workspace | `Ctrl+N` / `Ctrl+O` |\n| Toggle terminal / open Settings | `` Ctrl+` `` / `Ctrl+,` |\n| Undo / redo | `Ctrl+Z` / `Ctrl+Y` |\n| Cut / copy / paste / select all | `Ctrl+X` / `Ctrl+C` / `Ctrl+V` / `Ctrl+A` |\n| Reload / zoom / reset zoom | `Ctrl+R` / `Ctrl++`, `Ctrl+-` / `Ctrl+0` |\n| Developer tools / close window / quit | `Ctrl+Shift+I` / `Ctrl+W` / `Alt+F4` |\n| Minimize / toggle maximize | 既定では未割り当て |\n\nこれらは現在の Kun 内蔵値であり、OS が各組み合わせを利用可能なままにする保証ではありません。Reload、Close、Quit、Developer Tools を変更する際は特に注意してください。エディターが割り当てを取り込む場合は、空のワークベンチ領域にフォーカスして再度テストします。\n\nこれらのコマンドを組み合わせる方法については、[長時間タスクを管理する](/docs/long-running-tasks)を参照してください。\n",s=`---
407slug: composer-attachments-and-context
408lang: ja
409group: workspace-tools
410order: 20
411status: published
412updatedAt: 2026-07-17
413keywords: Composer | 入力 | メッセージキュー | モデルピッカー | Reasoning | Plan | Goal | ファイル参照 | ディレクトリ参照 | 画像添付 | PDF | 音声入力 | Web 状態 | プロンプト最適化 | コンテキスト容量 | Compact
414title: 入力、添付ファイル、コンテキスト
415description: Composer で指示、モデル、添付ファイル、フォローアップを整理し、長い会話のコンテキスト容量と情報境界を管理します。
416---
417
418Composer は Kun の各ターンを制御する場所です。どのテキスト、ローカル参照、モデル、作業モードを送信するかを決めます。送信前に 10 秒かけて作業ディレクトリ、モデル、権限、添付ファイルを確認する方が、後から範囲外の操作を取り消そうとするより確実です。
419
420![添付ファイル、ワークスペース、モデル、推論、送信のコントロールを表示する Composer](/docs-media/screenshots/composer-controls-en.webp)
421
422*Composer はターンの入力と実行方法を 1 つのコンパクトな操作領域にまとめます。*
423
424- 対応する添付ファイルには **+** メニューを使い、ローカル参照を解決する場所はワークスペースコントロールで決めます。
425- 送信前にモデルと推論コントロールを確認します。影響するのは次のターンで、完了済みの作業ではありません。
426- 送信操作は表示中の下書きと参照だけを送ります。モデルに不要な認証情報は決して貼り付けないでください。
427
428## 実行可能で検証できる依頼を書く
429
430信頼できる依頼には少なくとも次の 4 点を含めます。
431
4321. **成果:** 最終結果をどのようにするか。
4332. **範囲:** 調査または変更できるファイル、ページ、モジュール。
4343. **境界:** 変更してはいけないものと、ネットワークアクセス、依存関係のインストール、コマンドを許可するか。
4354. **検証:** 実行すべきチェックまたは自分で確認する結果。
436
437たとえば、「\`src/auth\` 以下の Refresh Token 失敗経路だけを分析し、まだファイルは編集せず、証拠と最小の修正案を返してください」は、「ログインのバグを見て」より制御しやすい依頼です。\`/\` を入力すると現在のコンテキストで利用可能なコマンドが開きます。詳細は[コマンドとショートカット](/docs/commands-and-shortcuts)を参照してください。
438

439Composer のヒントには、現在の送信と改行のキー割り当てが表示されます。ショートカットはカスタマイズでき、フォーカスにも左右されるため、長いプロンプトを書く前に改行操作を確認し、認証情報や未完成のコマンドを誤って送らないようにしてください。
440
441## Kun が追加情報を必要とするときにフォームへ回答する
442
443範囲、方法、リスク境界を変える判断が Agent に不足している場合、Kun は現在のツール呼び出しを一時停止し、会話内に構造化された質問フォームを表示します。気軽な返信を待つ通常のチャットメッセージではありません。回答を選択または入力して送信するまで、呼び出しは続行しません。
444
445![実際のタスクを一時停止し、入力フォームでリリース範囲を求める Kun](/docs-media/screenshots/user-input-live-en.webp)
446
447*この実際の実行では、Agent は Release scope の質問で停止しています。フォームには Core flow と Full regression のプリセットがあり、カスタム回答フィールドも利用できます。*
448
449- 質問、各プリセット、その説明を読み、意図した境界に合う選択肢を選びます。該当しない場合は下のフィールドにカスタム回答を入力してください。
450- プリセットを選ぶかカスタム回答を送信すると、Kun は待機中のツール呼び出しへ回答を返し、同じターンを再開します。作業を続行すべきでない場合は、フォームをバックグラウンドで待たせずターンを停止してください。
451- フォームは処理を止める判断地点として扱います。回答は次の動作を変えられますが、ワークスペース権限を拡張したり、承認を回避したり、結果を検証したりはしません。
452
453## 実行中にフォローアップメッセージをキューへ入れる
454
455現在のターンがまだ実行中でも入力して送信できます。メッセージはキューに入り、現在の応答が完了した後に順番どおり送信されます。キューは「読み取り専用の分析後に、承認が必要な変更を列挙してください」のような明確なフォローアップに役立ちます。実行中の高リスク操作を緊急に修正する用途には適しません。
456
457![実行中のターンと、Composer 上部に Guide と削除操作を備えた 1 件のキューメッセージを表示する Kun](/docs-media/screenshots/composer-queue-guide-en.webp)
458
459*キューのカードは Composer 上部に分かれて残ります。Guide はプレーンテキストを実行中のターンへ誘導しようとし、削除はそのフォローアップだけを取り除きます。*
460
461- **Guide** は、ランタイムが Steering に対応し、メッセージがプレーンテキストの場合にだけ表示されます。強制停止のコントロールではありません。
462- キューの順序を確認し、古くなったメッセージや矛盾するメッセージを削除します。
463- 現在の動作を停止するには、まず Stop 操作を使い、その後に範囲を限定した指示を送ります。
464- 実行中ターンの結果によって後続メッセージの前提が変わる場合があるため、長いキューは小さくレビュー可能なまとまりにします。
465
466キューへの追加によって要件が統合されたり、Goal と Plan が自動更新されたりはしません。方向性を維持する必要がある場合は、明示的に管理してください。
467
468### 実行中のターンを Guide するかキューを待つ
469
470キューの各カードには、メッセージがプレーンテキストで、現在のランタイムが Steering に対応する場合に **Guide** があります。Guide はそのテキストを実行中のターンへ送り、ランタイムが受け付けた後にキューから削除します。「調査を読み取り専用に保ってください」のようなタイミングの重要な修正に使います。安全でã

470ªã„操作を直ちに終える必要がある場合は Stop を使用してください。
471
472Plan メッセージ、添付ファイル、ファイル参照、Composer のコンテキスト、Design または Write のコンテキスト、生成済み GUI Plan の Payload では、テキストだけの Steering 契約で追加データを維持できないため、意図的に Guide を利用できません。実行中ターンがすでに終了している、Steering が未対応、またはリクエストが失敗した場合、Kun はエラーを報告し、メッセージは通常のキュー処理用に残ります。
473
474Code ではターンの実行中も、分かれたモデルと推論のコントロールを編集できます。値は次にキューへ送るメッセージとともに取得され、実行中のモデルや Effort は変わりません。そのため 2 つのキューメッセージが意図的に異なるモデルまたは推論レベルを使用する場合があります。長いキューを続けて処理させる前に、各カードを確認してください。
475
476## モデル、Reasoning effort、Plan、Goal を選ぶ
477
478![現在の Provider とモデルを表示する Composer のモデルピッカー第 1 階層](/docs-media/screenshots/composer-models-en.webp)
479
480*第 1 階層で現在の Provider とモデルを確認し、矢印からその Provider に設定されたモデル一覧を開きます。*
481
482- ターン開始前に、Tools、Vision、コンテキスト長、Reasoning に必要な正確なモデルを選びます。
483- 一覧にあるモデルでも、認証情報、Endpoint、機能の宣言が誤っていると失敗します。
484- モデルの切り替えは後続ターンに影響し、完了済みのツール呼び出しを再実行しません。
485
486![Composer の Reasoning レベルピッカー](/docs-media/screenshots/composer-reasoning-en.webp)
487
488*Reasoning は、対応を宣言するモデルに対する会話単位の Effort コントロールです。*
489
490- 曖昧な複数ステップの分析では Effort を上げ、定型的で範囲の明確なターンでは下げます。
491- 進め方を提案して確認するには **Plan**、長い作業を通じて完了条件を維持するには **Goal** を使います。
492- 高い Reasoning 設定はファイル権限を拡張せず、モデルの Tools や Vision 対応も保証しません。
493
494モデルピッカーはそのターンのテキストモデルを選択します。Reasoning はモデルが対応を宣言する場合にだけ適用されます。高い Effort では待ち時間と使用量が増える場合がありますが、正しさは保証されません。画像、ツール呼び出し、長いコンテキストにも、モデルが該当機能に対応する必要があります。[Provider とモデル](/docs/providers-and-models)を参照してください。
495
496| コントロール | 使用する場面 | 自動的には行わないこと |
497| --- | --- | --- |
498| **Agent** | 範囲が明確で調査または実行を開始できる | 承認やプロジェクトチェックの回避 |
499| **Plan** | 作業が複数ステップにまたがり、実行前に分解すべき | Plan が存在するだけで実装または採用 |
500| **Goal** | 1 つの成果を多くのターンで見える状態に保つ必要がある | 曖昧な目標を安全な境界へ変換 |
501
502Goal は設定、編集、一時停止、再開、クリアができます。要件が変わったら、古いキューを続行する前に Goal と Plan を更新します。[長時間タスクとコンテキストを管理する](/docs/long-running-tasks)を参照してください。
503
504## ワークスペースのファイルとディレクトリを参照する
505
506![ワークスペース内容の検索と参照に使う Files パネル](/docs-media/screenshots/files-panel-en.webp)
507
508*画像には現在のツリーと、選択中ファイルの Add reference、Copy path 操作が表示されています。*
509
510- 現在のワークスペースを展開し、必要なコンテキストを含む最小のファイルまたはフォルダーを選びます。
511- 項目が意図したプロジェクトまたは worktree に属することを確認し、表示中のコンテキストメニューから **Add file reference** を使うかパスをコピーします。
512- ファイルを閲覧しても書き込みアクセスは付与されず、エディターの未保存の最新状態がディスクにある保証もありません。
513
514ファイルとフォルダーの項目を使うか、\`@\` と入力して現在のワークスペースを検索し、明示的なファイルまたはディレクトリ参照を追加します。参照はターンの見えるコンテキストとして送信され、メッセージとともに表示されたままになります。曖昧なファイル名を入力するより確実です。
515
516ディレクトリ参照は狭く保ちます。大きな依存関係フォルダー、ビルド出力、認証情報を含むディレクトリは、コンテキスト、ノイズ、情報公開のリスクを増やします。Files パネルでもワークスペースを閲覧し、選択したファイルまたはフォルダーを Composer へ追加できます。[ワークベンチパネル](/docs/terminal-browser-and-worktrees)を参照してください。
517
518会話を移動、作業ディレクトリを変更、ファイルを外部編集した場合は、古い参照を削除して選び直します。参照はファイルの Snapshot ではなく、そのパスを変更する権限も付与しません。実効的な境界はワークスペースとツールポリシーによって引き続き定義されます。
519
520## 画像、PDF、音声入力を追加する
521
522Composer は PNG、JPEG、WebP 画像と、PDF、プレーンテキスト、Markdown、CSV、JSON ドキュメントを受け付けます。画像には Vision 対応モデルが必要です。Kun はドキュメントからテキストの抽出を試み、スキャン PDF では OCR が必要な場合があります。添付を利用できない、モデルが画像を見られない、ドキュメントに読めるテキストがない、と画面に表示された場合は、ファイル全体を繰り返しアップロードせず、対応モデルへ切り替え、より明確な資料を渡すか、必要なページだけを貼り付けてください。
523
524現在の既定値は次のとおりです。ランタイムの機能メタデータによって、ファイル単位の上限がさらに低くなる場合があります。
525
526| 上限 | 現在の既定値 |
527| --- | --- |
528| 1 ターンの添付ファイル数 | 最大 8 件 |
529| 1 ターンの添付ファイル合計 | 最大 20 MiB |
530| 1 回のアップロードの生データ | 最大 10 MiB |
531| 画像 1 件 | 最大 5 MiB、最長辺 4096px |
532| ドキュメント 1 件 | 最大 10 MiB、抽出文字数 200,000 文字 |
533
534上限を超えた項目はアップロードまたは送信前に失敗します。チェックを回避するためにファイル名を変えず、資料を分割して関連ページだけを残してください。画像はモデルä

534º’換の代替形式に圧縮される場合があり、抽出されたドキュメントテキストには省略を示す印が付く場合があります。
535
536音声入力には、ローカル Whisper、音声対応 Provider、カスタム音声サービスのいずれかを有効にする必要があります。リモート文字起こしでは録音がそのサービスへ送信されます。ローカルモデルは最初にダウンロードする必要があり、ディスク容量とメモリを使います。音声コントロールには「停止して送信」があります。最初のテストでは短く無害なメッセージを話し、マイク権限、文字起こし言語、送信動作を確認してください。
537
538> 注意: 添付ファイル、Scan、録音には、名前、アカウント情報、場所、社内画面、非表示のメタデータが含まれる場合があります。タスクに必要な最小範囲へ切り取ってください。便利なコンテキストとして API キー、トークン、非公開ファイルを決してアップロードしないでください。
539
540## Web の状態とプロンプト最適化を理解する
541
542**Web on / Web off** は機能の状態です。Web on は現在のランタイムで Web ツールを利用できること、Web off は無効または利用不可であることを意味します。ターン単位のネットワークスイッチではなく、回答が最新情報を確認した証明でもありません。閲覧が必要な場合は明示的に依頼し、情報源と日付範囲を限定して、ツールの証拠を確認してください。閲覧してほしくない場合も依頼に記載します。
543
544Agent の \`web_search\` / \`web_fetch\` と Code の Browser パネルは別の入口です。ツールは検索結果またはページ内容をモデルへ返し、Browser はローカル開発ページをユーザーが確認するために使います。\`/research\` は証拠を重視した調査ターンを構成しますが、独立して動作が保証されたバックグラウンド Research のステートマシンではなく、情報源が自動的に最新だと証明しません。
545
546プロンプト最適化が有効な場合、そのボタンは現在の下書きを Settings で選択したモデルへ送り、書き換えてエディター内のテキストを置き換えます。非公式な説明を成果、範囲、受け入れ確認へ整理する際に役立ちますが、トーンの変更、制約の削除、依頼していない内容の追加が起こる場合があります。
547
548最適化前後のテキストを比較し、特に否定表現、パス、数値、権限、受け入れ条件に注意します。最適化モデルが外部 Provider を使う場合、下書きもデバイス外へ送られます。機密性の高いプロンプトでは自動最適化に依存しないでください。
549
550## 使用量の概要を読む
551
552空の会話には、ローカルに記録された使用量のヒートマップが表示される場合があります。Overview と Models タブでは All、90 日、30 日、7 日の範囲を選び、トークン、推定コスト、Cache hit と節約量、現在と最長の連続利用日数、モデルごとの Cached input、Uncached input、Output を要約します。
553
554これは傾向を示す画面で、Provider の請求書ではありません。コストは Kun が把握する価格と Provider から返される Usage に依存し、不足、遅延、カスタム請求によって異なる場合があります。請求については Provider の管理画面を正しい情報源とし、空のヒートマップがリクエスト無料を意味すると考えないでください。
555
556## コンテキスト容量を監視し、意図的に Compact する
557
558コンテキスト容量コントロールは使用済み・合計トークン、ウィンドウの使用率、自動 Compact のしきい値を表示します。使用量を Tools、System、Skills、Messages、Other、Free に分け、一部の合計またはカテゴリは推定と表示される場合があります。継続の判断材料であり、請求値ではなく、Provi

558der が表示されたすべてのトークンを受け付ける保証もありません。Kun は 75% から警告します。現在の Compact しきい値に達する前に重要事項を保全してください。
559
560ウィンドウが埋まってきたら、次を行います。
561
5621. 重要な制約、未完了の作業、検証結果を Requirement、Plan、プロジェクトファイルへ記録します。
5632. 不要になった添付ファイルと広いディレクトリ参照を削除します。
5643. \`/compact\` を使って過去の作業履歴を要約します。
5654. 次の段階へ進む前に、保持された要約を確認します。
566
567Compact は継続を可能にするため、一部の作業詳細を破棄します。重要な判断がチャットだけにあり、証拠が記録されていない、または正確な表現が引き続き必要な間は Compact しないでください。タスクが新しい成果へ変わった場合は、1 つのコンテキストを伸ばし続けるより、新規会話または Fork した会話の方が明確なことがあります。
568
569## 送信前の最小チェックを行う
570
571- 作業ディレクトリと Git ブランチが正しい。
572- モデルが必要な Tools、画像、コンテキストサイズに対応する。
573- Agent / Plan と Goal が現在の段階に合っている。
574- ファイル、ディレクトリ、画像、PDF、音声のコンテキストに必要なものだけが含まれている。
575- Web とプロンプト最適化のネットワーク境界を受け入れられる。
576- 実行中ターンとキューメッセージが矛盾していない。
577- 書き込み、コマンド、Computer Use、その他の高リスク操作に適切な承認境界が残っている。
578
579実際のプロジェクト変更では、この Composer チェックと[変更をレビューして承認を処理する](/docs/review-and-approvals)を組み合わせてください。
580`,t=`---
581slug: connect-phone
582lang: ja
583group: automation
584order: 30
585status: published
586updatedAt: 2026-07-17
587keywords: 電話接続 | Feishu | Lark | WeChat | Telegram | Bot トークン | Webhook
588title: 電話から Kun に接続する
589description: Feishu、Lark、WeChat、Telegram を接続し、メッセージブリッジとリモートの Agent アクセスを安全に管理します。
590---
591
592Connect Phone は Kun を Feishu、Lark、WeChat、Telegram に接続し、メッセージクライアントから作業を依頼したり結果を受け取ったりできるようにします。認証方法と利用可能な機能はチャンネルによって異なるため、現在の画面に表示される手順に従ってください。
593
594![Kun サイドバー下部の Connect Phone 項目](/docs-media/screenshots/connect-phone-sidebar-en.webp)
595
596*Settings の横にある電話アイコンから、リモートメッセージ接続フローを開きます。*
597
598- サイドバー下部の電話アイコンから開きます。通常の Code 会話とは別です。
599- 対応するメッセージチャンネルを接続し、リモート作業を受信または送信するために使用します。
600- 電話を接続しても、ワークスペース権限、承認、デスクトップランタイムが利用可能である必要性は回避されません。
601
602## チャンネルを接続する
603
604- **Feishu、Lark、WeChat:** 通常は QR またはブリッジのフローを使います。QR コードには有効期限があるため、時間切れになったら更新して新しいコードを読み取ります。
605- **Telegram:** QR コードではなく Bot Token を使います。トークンは Bot の認証情報として扱い、決して共有したり公開ファイルに保存したりしないでください。
606
607接続前に、そのアカウントで許可される自動化を確認し、管理された会話でテストします。組織が管理するアカウントには、管理者ポリシーが適用される場合があります。
608
609## マスタースイッチを理解する
610
611Connect Phone のマスタースイッチは既定でオフです。制御するのは IM メッセージブリッジとローカル Webhook サービスだけです。オフにしても通常の Kun デスクトップチャットは停止しませんが、接続済みチャンネルはブリッジを通じた作業の送受信ができなくなります。Schedule には独自のスイッチがあり、Connect Phone がスケジュールタスクを有効または無効にすることはありません。
612
613## 最初のテストを実行する
614
6151. チャンネルを選択し、QR またはトークンによるセットアップを完了します。
6162. 接続サービスを有効にし、利用可能な状態になるまで待ちます。
6173. 短い状況要約など、読み取り専用の依頼から始めます。
6184. メッセージが意図した会話に属し、機密性の高いローカル情報を公開していないことを確認します。
6195. その後にだけ、ワークスペースやツールが必要なタスクを試します。
620
621リモートのリクエストも Kun の権限と承認ポリシーに従います。操作にデスクトップでの確認が必要な場合、電話からの依頼は待機状態になることがあります。
622
623## チャンネルのフィールドとワークスペース
624
625![チャンネル、ワークスペース、サービスのコントロールを表示する Connect Phone 設定](/docs-media/screenshots/settings-connect-phone-en.webp)
626
627*Settings → Connect Phone には、サービススイッチとチャンネル固有の設定が表示されます。*
628
629- QR、トークン、Webhook、アカウントのフィールドは連携先によって異なるため、最初にチャンネルを選びます。
630- ローカルツールを使うタスクを許可する前に、明示的なワークスペースと Phone Agent の Identity を設定します。
631- Bot トークンと Webhook シークレットを、スクリーンショット、プロンプト、リポジトリ、共有診断ログに含ã

631‚ãªã„でください。
632
633各チャンネルは個別に有効化でき、表示名、モデル、ワークスペースの上書き、Agent Profile を設定できます。基礎となる Provider には選択したモデルの既存設定が使われ、実行モードはチャンネル単位の項目ではなく Connect Phone 全体の設定です。ワークスペースが空の場合は Connect Phone の既定値が使われます。上書きはそのチャンネルの今後の作業を変更しますが、既存の会話は移動しません。
634
635- **Feishu / Lark:** インストールまたは読み取りフローに従い、中国向け Feishu または国際向け Lark を選びます。チャンネルごとのストリーミングは任意です。オフの場合、処理完了後に結果が送信されます。
636- **WeChat:** ローカルブリッジ接続を完了し、WeChat から最初のリクエストを送ってセッションを確立します。
637- **Telegram:** Bot Token を入力し、Allowed Chat IDs でアクセスを制限します。一覧を空にすると、プライベートチャットのすべてのユーザーが許可されます。現在グループチャットには対応していません。利便性のために不明な Chat ID を受け入れず、本番利用前に許可 ID を明示的に列挙してください。
638
639モデルピッカーには設定済みのテキストモデルが表示されます。添付ファイルと画像の理解には、選択したモデルとチャンネル経路がその機能に対応している必要があります。
640
641## Phone Agent の Identity と返信ルール
642
643チャンネルごとに、名前、説明、Identity、Personality、About User、返信ルール、タイムアウトを含む Agent Profile を設定できます。これらは長期間使われるシステム指示として扱い、許可する操作、禁止する操作、確認を求める条件、既定の回答長を定義します。このテキストフィールドに API キーやチャンネルシークレットを決して入力しないでください。
644
645最初のメッセージ設定は、セッション確立時にウェルカムメッセージや説明を送信するかを制御します。**Recent threads** には \`1–50\` を指定でき、既定値は \`5\` です。変わるのは \`/list-threads\` が返す範囲だけで、古い会話は削除されません。
646
647## 電話コマンド早見表
648
649電話ブリッジは次の管理コマンドを受け付けます。\`/\` の代わりに \`-\` を接頭辞として使えます。
650
651- \`/help\` はヘルプを表示し、\`/new\` または \`/clear\` は新しいトピックを開始します。
652- \`/stop\` は現在のターンを停止し、\`/pwd\` はワークスペース、\`/usage\` は使用量を表示します。
653- \`/list-skills\` と \`/list-mcp\` は利用可能な拡張機能を確認します。
654- \`/list-goal\` は Goal を表示し、\`/goal <text>\` は設定または更新します。
655- \`/list-threads\`、\`/current\`、\`/switch <number or ID>\` は会話を管理します。
656- \`/list-model\` と \`/model <number>\` はテキストモデルを確認または切り替えます。
657
6581 件の電話メッセージには最大 3 個、各 50 MiB までのファイルを添付できます。プラットフォーム側により低い上限が設定される場合があります。受信後もワークスペースとツール権限が適用されます。サイズ上限はマルウェアや内容を検査するものではありません。
659
660## 利用可能性、承認、停止
661
662電話の入口はクラウドホスティングではありません。コンピューター、Kun、ランタイム、チャンネルブリッジがオンラインのままである必要があります。スリープ、アプリ終了、ネットワーク変更、期限切れの認証情報によって作業は中断されます。電話からの依頼でもデスクトップ承認は回避されません。監視できない場合は慎重な権限モードを使用してください。
663
664\`/stop\` が作用するのは実行中のターンで、すでに完了したコマンド、外部リクエスト、ファイル変更は取り消しません。関連するãƒ

664‡ã‚¹ã‚¯ãƒˆãƒƒãƒ—会話に戻り、タイムラインと変更を確認してください。
665
666## Webhook とセキュリティ
667
668ローカル Webhook とリレーは高度な連携です。必要なエンドポイントだけを公開し、強力なシークレットを使い、ローカルサービスを信頼できないネットワークへ直接公開せず、外部入力を検証してください。リモートプロンプトに API キー、非公開ファイル、本番の認証情報を決して含めないでください。
669
670期限切れの QR コード、無効な WeChat ブリッジ、誤った Telegram トークン、無効なマスタースイッチは、いずれも接続を妨げます。[トラブルシューティング](/docs/troubleshooting)を参照してください。
671
672[設定概要](/docs/settings-overview)には、チャンネル単位の設定もすべて索引化されています。定期的なリモート作業については、[スケジュールタスク](/docs/schedules)を参照してください。
673`,r=`---
674slug: data-updates-and-diagnostics
675lang: ja
676group: settings
677order: 40
678status: published
679updatedAt: 2026-07-17
680keywords: アーカイブ済み会話 | データ移行 | kunpack | アップデートチャンネル | Stable | Frontier | LLM 診断 | リクエストログ | 復元
681title: データ、アップデート、診断
682description: アーカイブ済み会話を管理し、条件付きで利用可能な移行を安全に理解して、アップデートと LLM 診断ツールを使用します。
683---
684
685メンテナンス設定は履歴、バージョン、診断の証拠に影響します。アーカイブとアップデートは通常の操作です。完全削除、移行のインポート、デバッグデータの共有には、より慎重な確認が必要です。
686
687## アーカイブ済み会話を管理する
688
689![検索、アーカイブ件数、空の状態を表示する Archives 設定](/docs-media/screenshots/settings-archives-en.webp)
690
691*この画像はアーカイブが 0 件の状態です。復元と完全削除の操作は、アーカイブ済み項目がある場合にだけ表示されます。*
692
693- 検索フィールドと件数で現在の結果範囲を確認します。アーカイブが空なら操作可能な行はありません。
694- 項目がある場合、復元または完全削除を判断する前に検索して開きます。
695- Restore は会話を有効なナビゲーションへ戻します。別にディスクから削除されたファイルは復元しません。
696- このページからの Delete は取り消せず、まだ実行中のタスクを停止する代わりにはなりません。
697
698Archives はアーカイブ済み会話をワークスペース別にまとめ、タイトル、プレビュー、パス、モデル、モードを検索できます。項目を開いて履歴を読み、Restore で有効な一覧に戻すか、Delete でこのページから復元できない形で完全削除します。
699
700これらの操作にはローカル Runtime が必要です。オフラインの場合は、アーカイブを管理する前に Runtime を復元してください。完全削除では確認を求められ、確認後は復元できません。
701
702アーカイブは会話を非表示にして保持しますが、実行中のターンを停止しません。アーカイブ前に作業の完了を待つか停止します。後からコンテキストが役立つ可能性がある場合は、削除よりアーカイブを優先してください。完全なライフサイクルについては、[ワークスペース、プロジェクト、会話](/docs/workspace-and-conversations)を参照してください。
703
704## アップデートチャンネルを選ぶ
705
706![Stable チャンネルの確認完了後、利用可能なバージョンと Open download page を表示する Kun Version and updates](/docs-media/screenshots/version-update-available-live-en.webp)
707
708*この単独の画像には Stable、現在のバージョン 0.1.0、利用可能なバージョン 0.2.26、手動インストールの **Open download page** が表示されています。バージョンは撮影時点の状態にすぎないため、自分のアップデート画面の値に従ってください。この画像を撮るためにダウンロードやインストールは開始していません。*
709
710- 最初にチャンネルを選び、**Check for updates** を実行します。予測しやすい日常作業には **Stable**、より早く頻繁な動作変更を受け入れられる場合にだけ **Frontier** を使います。
711- 確認が完了すると、そのチャンネルの最新結果として、最新版、利用可能なバージョン、エラーなどが表示されます。チャンネル変更後は再度確認してください。

712- 画像のビルドは自動更新に対応していないため、**Open download page** が表示されます。この操作はリリースのダウンロードページを開き、ユーザーがパッケージを選んでインストールできるようにします。画像は操作をクリックする前に撮影されています。
713- 自動更新に対応するビルドでは、同じ領域でダウンロード、インストール、再起動へ進みます。バージョンを見つけたことやダウンロード完了は、インストール完了を意味しません。
714- どちらの更新方法でも、インストールや再起動で中断される前に、ドキュメントを保存し、重要なターンを完了して、Schedule、Loop、電話タスクを確認します。
715
716Version and updates では Stable または Frontier を選び、既定の Stable から **Check for updates** を使ってそのチャンネルの最新バージョンを確認できます。Stable は本番や長時間の作業に適し、Frontier は機能を早く公開する代わりに動作が変わりやすくなります。後続のコントロールはビルドによって異なります。自動更新ビルドはダウンロード、インストール、再起動へ進み、手動インストールビルドは **Open download page** を表示します。
717
718Kun が新しいバージョンを検出すると、Code ワークベンチのトップバーにも一時的な更新操作が表示されます。自動更新ビルドではダウンロード、インストール、再起動の進捗を表示し、手動のみのビルドではダウンロードページへの入口を表示します。更新がない場合は表示されません。チャンネル、現在のバージョン、完全な状態について正しい情報源となるのは、引き続き **Settings → Version & updates** です。
719
720更新前にドキュメントを保存し、重要なターンを完了して、Schedule、Loop、電話接続に失うことのできない作業がないか確認します。Downloaded は Installed を意味せず、インストールすると Kun が再起動します。表示された状態をインストールと再起動まで追ってください。更新後にモデルやメディアが失敗する場合は、データを削除する前に Provider と設定の互換性を確認します。
721
722## LLM リクエスト診断を使う
723
724![ランタイム機能の準備状況を表示する Assistant status 診断](/docs-media/screenshots/settings-agent-diagnostics-en.webp)
725
726*読み取り専用の Assistant status から始め、Provider の接続と、ツール、添付、機能読み込みの問題を区別します。*
727
728- 個別の設定を変える前に、MCP、Web、Instructions、Skills、Subagents、Images、Memory の準備状況を更新します。
729- Provider の緑色のテストはこのランタイムスナップショットより範囲が狭く、すべての Agent 機能が読み込まれたことを証明しません。
730- 状態ページを共有する前に、Provider のアドレス、ローカルパス、プロジェクト識別子を削除してください。
731
732![Kun の LLM リクエストトラブルシューティングに表示された最近のリクエストの折りたたみ行](/docs-media/screenshots/troubleshooting-rounds-live-en.webp)
733
734*折りたたみ行はリクエストの簡易索引です。ID、モデル、時刻、所要時間を読み、通常の終了理由とエラー状態を区別します。*
735
736- 自動再試行は近い時間に発生し得るため、リクエスト ID で正確に失敗したラウンドを照合します。想定外のモデルは Provider と会話の選択に問題があることを示します。
737- 所要時間は即時失敗、タイムアウト、応答が返った状態の区別に役立ちます。正常完了では終了理由を読み、エラーがある場合はエラー詳細を正しい情報として扱います。
738- **Refresh** は現在の Runtime がメモリに保持する記録を再読み込みするだけです。別のモデルリクエストを送信せず、取得されã

738ªã‹ã£ãŸã‚¿ãƒ¼ãƒ³ã‚’後から補いません。
739- 行を展開する前に画面共有または録画を停止します。リクエスト本文と詳細には、プロンプト全文、メッセージ、ファイルの抜粋、ツール引数、ローカルパスが含まれる場合があります。共有するのは機密情報を削除した最小限の証拠だけにしてください。
740- メモリに保持されるのは最新 25 ラウンドだけです。Runtime の再起動で消去されるため、必要な証拠は機密情報を削除してから再起動前に保存してください。
741- 機密内容を扱うため取得はオプトインで、通常のリリースビルドでは無効な場合があります。再現可能なリクエスト後に Refresh しても空なら、設定を手作業で編集して取得設定を回避せず、**Assistant status** とアプリケーションログを使ってください。
742
743取得が利用可能で有効な場合、LLM リクエスト診断は最新 25 件のモデルリクエストをメモリに保持します。Provider、モデル、URL、開始・終了時刻、所要時間、リクエスト本文、テキスト、推論、ツール呼び出し、使用量、終了理由、エラーが含まれます。Runtime の再起動で一覧は消去されます。リクエスト構築、ネットワークや Provider、モデル出力、ツール解析の失敗を区別するために役立ちます。
744
745次の順序で確認します。
746
7471. Provider、モデル、URL が想定した値か確認します。
7482. HTTP、タイムアウト、認証エラーを探します。
7493. 終了理由と使用量があるか確認します。
7504. モデルが返した不正なツール呼び出しを確認します。
7515. リクエスト本文に意図したコンテキストが含まれるか確認します。
752
753画面にはプロンプト全文、ファイルの抜粋、ツール引数、モデル出力が表示される場合があります。共有前に URL パラメーター、個人情報、ソースコード、顧客資料を削除してください。
754
755## データ移行は条件付きで利用できる
756
757![このビルドで機能が無効であることを表示する Data migration 設定](/docs-media/screenshots/settings-data-migration-en.webp)
758
759*ページ自体が正しい情報源です。撮影したビルドではカテゴリが表示されていますが、新しい移行操作は明示的に無効です。*
760
761- この警告が表示されている間、そのビルドに利用できる対応済みのエクスポートまたはインポートコントロールはありません。
762- 将来の対応リリースでコントロールが表示された場合は、\`.kunpack\` パッケージを使用する前に、含まã

762‚Œã‚‹ãƒ‡ãƒ¼ã‚¿ã®æ¦‚要と競合・復元手順を読んでください。
763- 隠しコマンド、手作業で編集した設定、互換性のないビルドで作成したパッケージを使ってリリース制限を回避しないでください。
764
765Settings では、現在のリリースパッケージが明示的に機能を有効にしている場合だけ、新しい Data migration 操作を許可します。通常のパッケージビルドでは既定で無効で、一部のビルドは中断した操作の復元だけを公開する場合があります。開発ビルド、ソース、ナビゲーションに名前が表示されても、Stable パッケージで有効である証明にはなりません。
766
767利用できる場合、\`.kunpack\` にはワークスペースファイル、履歴、添付ファイル、到達可能な成果物、関連 Memory、Design / Write / Plan / SDD / Fork のレジストリ、移植可能な UI 設定、Loop と Schedule の定義を含められます。エクスポート時に範囲を選び、実行中セッションの扱いを決め、機密ファイルの警告を確認し、非公開パッケージには 8 文字以上のパスフレーズを設定します。
768
769> 警告: パスフレーズは復元できません。暗号化されていないパッケージには、ワークスペースと会話の内容が平文で含まれる場合があります。
770
771## 移行で決して引き継がれないもの
772
773パッケージには、API キー、Provider 認証情報、OAuth セッション、システムのキーチェーン内容、ランタイムトークン、デバイスの Identity、権限付与、Terminal プロセス、ログ、キャッシュ、Connect のシークレット、実行中の外部バインディングは含まれません。移行先のコンピューターで Provider とシステムの同意を再設定してください。
774
775インポートしたワークスペースは信頼されていない状態のままです。Hook、コマンド、Extensions、Loops、Schedules、電話チャンネルは自動実行されません。ワークスペース、Provider、モデル、外部送信先を確認するまで、Workflow とスケジュールタスクを無効にしておきます。
776
777## インポート、競合、復元
778
779インポートは、送信先のベースと競合ポリシーを求める前に、パッケージ形式、バージョン、チェックサム、容量、アーカイブの安全性を検証します。Keep both が最も安全な既定値です。Merge と backup-then-replace では項目ごとのレビューが必要です。異なるプラットフォーム間のインポートでは、大文字と小文字、Unicode、予約名、パス長、シンボリックリンクの制限にã

779‚‚対応する必要があります。
780
781確認中にキャンセルしても送信先は変更されず、ステージング中のキャンセルでは一時データが消去されます。コミット中にキャンセルまたはクラッシュした場合、Kun は次回起動時に続行またはロールバックを求めます。移行レポートも診断資料であるため、共有前にパスとメタデータを確認してください。
782
783## 問題発生時に証拠を保全する
784
785エラー後にすぐログを消去、アーカイブを削除、インポートを繰り返さないでください。アプリケーションのバージョンとチャンネル、失敗時刻、影響を受けた会話または移行操作、Provider とモデル、最小限の再現手順を記録します。まず[トラブルシューティング](/docs/troubleshooting)を参照してください。ファイルや権限の問題では、[ワークスペースの権限とセキュリティ](/docs/workspace-permissions-security)も確認します。
786`,i=`---
787slug: design
788lang: ja
789group: modes
790order: 20
791status: published
792updatedAt: 2026-07-17
793keywords: Design | UI デザイン | プロトタイプ | キャンバス | デザインシステム | Code への引き継ぎ
794title: Design モードを使う
795description: 要件と参考資料から画面の方向性を生成し、キャンバス上で反復して、承認したデザインを Code に引き継ぎます。
796---
797
798Design では、実装前に画面の方向性を見て評価できます。Web サイトやアプリケーションを説明し、参考資料を追加して、複数案を比較し、キャンバスとプロトタイプを編集した後、採用した結果を要件と Code に戻せます。
799
800## Design ワークスペースを理解する
801
802![ドキュメント、レイヤー、Screen キャンバス、ツールレール、Design Assistant が表示された Kun Design](/docs-media/screenshots/design-screen-live-en.webp)
803
804*実際の Design ワークスペースは 3 つの領域で構成されます。左側にドキュメント、Screens、レイヤー、中央に編集可能なキャンバス、右側に生成と変更を行う Design Assistant があります。*
805
806- **ドキュメントとレイヤー:** **New design** でドキュメントを作成します。ドキュメントを展開して Screen ã

806‚’選び、キャンバスのレイヤーを確認、非表示、ロックできます。ドキュメント行の名前変更と削除は、そのデザインドキュメントだけに作用します。
807- **キャンバスとツールレール:** キャンバスには実際の Screen が描画されます。フローティングレールから選択、Screen とボードオブジェクトの作成、画像、Motion、デザインシステムの確認、プロトタイプ再生を利用でき、下端にはズーム、取り消し、やり直しがあります。
808- **Assistant とコンテキスト:** Web または App を対象として選び、ビューポートと現在の Screen コンテキストを確認します。Design Assistant に画面の生成や変更を依頼すると、選択した Screen が添付されます。現在の成果物を変更する意図がない場合は、先にそのコンテキストを外してください。
809
810一般的な Screen の作業手順は、デザインドキュメントを作成または選択し、キャンバスのツールレールで **Screen** を選び、対象ビューポートを確認してから、Assistant に内容の生成を依頼します。次に進む前に、描画された画面と操作を確認してください。Screen の上にある **Quality の数値** は、現在の品質チェックで見つかった指摘の件数であり、スコアではありません。開いて指摘と提案を読み、Modify または修復フローを使って、再度結果を確認します。
811
812> **Design ワークスペースは Code プロジェクトとは別です。** Design はまず **Settings > Design > Default workspace** を使用します。空の場合、現在選択中の Code リポジトリではなく、Kun 内蔵のデザインワークスペースにフォールバックします。Screens、キャンバスファイル、エクスポートをプロジェクト内に置く場合は、最初に既定のワークスペースをそのプロジェクトディレクトリに設定してください。
813
814## 最初のデザインを作る
815
816![プロジェクト一覧、空のキャンバス、Design Assistant のプロンプト領域が表示された Design ワークスペース](/docs-media/screenshots/design-new-project-en.webp)
817
818*Design アイコンから入り、左側でプロジェクトを作成または選択して、右側の Design Assistant に UI を説明します。*
819
820- 方向性を生成する前に、**New design** で成果物とワークスペースを定義します。
821- 最初のブリーフで、対象デバイス、必要な画面、実際のコンテンツ、参考画像を提示します。
822- Design の出力はレビュー用の成果物です。明示的に引き継ぐまで Code プロジェクトは変更されません。
823
824対象デバイス、ページの目的、主なユーザー、必要な内容、避けたいスタイルを明記してください。「高級感を出して」のような依頼より、具体的な依頼の方が評価しやすくなります。例:
825
826> デスクトップ向けデータ管理ツールのログイン後の概要画面をデザインしてください。失敗したジョブと本日の処理量を優先し、主要アクションを 1 つ明確にしてください。実用的な情報密度を保ち、マーケティングページのような巨大なヒーローは避けてください。
827
828既存のブランド、スクリーンショット、要件ドラフトがある場合は、デザインコンテキストとして追加します。画像解析には Vision 対応モデルが必要です。
829
830## 方向性を比較して反復する
831
832Design は、複数の方向性、ページ、バージョンを生成できます。Directions ビューでは、ビジュアルとフローの選択、ページの網羅性、スコア、推定コストを比較し、方向性を採用、アーカイブ、復元できます。色、角丸、モーションより先に、階層と重要なフローを比較してください。未検証ページが一度に多数作られないよう、複数ページ生成は意図的に有効にします。
833
834方向性を採用してもアプリケーションコードにはなりません。反復と引き継ぎの基準が定まるだけです。デザインドキュメントは作成、名前変更、複製、削除、お気に入り登録、バージョン管理ができます。削除前に必要なものをエクスポートしてください。
835
836## デザイン成果物の種類を理解する
837
838Design ワークスペースには、インタラクティブな HTML 画面、統合ボード上の構造化オブジェクト、SVG / Motion 成果物、旧バージョンから移行したデザインを含められます。HTML は素早いページ案とプレビュー、ボードは構造化編集、SVG / Motion はベクターやアニメーション作業に適しています。エクスポート、プロトタイプ、Code への引き継ぎ操作は種類によって異なります。
839
840既存の \`DESIGN.md\` やデザインコンテキストから続けることもできます。インポートしただけでは現在のコードとの一致は確認できません。最初に対è

840±¡ãƒ‡ãƒã‚¤ã‚¹ã€ãƒšãƒ¼ã‚¸ä¸€è¦§ã€ãƒˆãƒ¼ã‚¯ãƒ³ã€ãƒ¯ãƒ¼ã‚¯ã‚¹ãƒšãƒ¼ã‚¹ã‚’確認してください。
841
842## キャンバスとプロトタイプを操作する
843
844![選択中の Frame、レイヤー行、キャンバスのハンドル、Properties インスペクターが表示された Design ワークスペース](/docs-media/screenshots/design-workspace-en.webp)
845
846*実際に選択された Frame は Layers に表示され、キャンバス上に紫のリサイズハンドルが付き、Properties には X / Y / W / H、Fill、Stroke、Corner radius、Opacity が表示されます。*
847
848- ハンドルをドラッグしたり正確なジオメトリを入力したりする前に、対象オブジェクトを選択します。白い塗りは現在の Frame の外観にすぎず、生成済みの製品画面ではありません。
849- 広範囲な操作を行う前に、レイヤー行の目とロックを使って表示と編集を制御します。
850- **Empty box · auto image slot** でこの Frame の画像生成を Assistant に渡せますが、プロンプトには目的、ソース、受け入れ境界を引き続き指定する必要があります。
851- プレビュー品質は実装の証明にはなりません。Code に引き継いだ後、レスポンシブ動作と実データを再度確認してください。
852
853統合ボードには Select、Hand、Frame、Screen、長方形、楕円、線、矢印、テキスト、画像スロット、画像アップロード、フリーハンド描画があります。取り消し・やり直し、ズーム、フィット、選択範囲へズーム、グリッド、ミニマップにも対応しています。
854
855Layers パネルでは、内容の折りたたみ、非表示、表示、ロック、ロック解除ができます。Properties では位置、サイズ、整列、分布、スナップ、塗り、線、角丸、透明度、テキストを設定します。画像には注釈を付けられ、空の長方形は AI 画像スロットにできます。広範囲な操作の前に、変更すべきでないレイヤーをロックしてください。
856
857## Prototype、Live App、Motion
858
859Prototype は画面を接続し、Web または App のビューポートでフローを再生します。AI は不足している遷移先を作成できますが、重要な状態、戻る経路、フォームエラー、権限は人がテストする必要があります。デスクトップ、タブレット、モバイルの幅はプレビューであり、実機検証ではありません。
860
861Live App は、Code が開発サーバーを起動した後にローカルアプリケーションを関連付け、実際の DOM をデザインコンテキストとして選択できます。内蔵の Browser と Live App はどちらもローカルサービスを必要とします。Browser は一般的な開発プレビューで、Live App はデザインとコードの関連付けに対応します。
862
863![Motion のタイムライン、プリセット、キーフレーム、再生コントロールを開いた Kun Design](/docs-media/screenshots/design-motion-live-en.webp)
864
865*Screen を選んで Motion を開きます。下部のタイムラインにトラックとキーフレームが表示され、ヘッダーでは再生ヘッド、長さ、再生モード、速度、タイムラインのズームを操作できます。*
866
867- アニメーション対象の Screen またはレイヤーを選び、ツールレールから **Motion** を開きます。Fade、Move、Scale、Rotate のプリセットを適用するか、X、Y、回転、水平・垂直スケール、不透明度のプロパティを追加し、再生ヘッド位置にキーフレームを置きます。Auto-key がオンなら、再生ヘッドを動かしてプロパティを変更すると自動的に記録されます。オフの場合は明示的にキーフレームを追加します。
868- 再生・一時停止とスクラブでタイミングを確認し、合計時間、Once、Loop、Ping-pong の動作と再生速度を設定します。画像ã

868®ã²ã—形は Y トラックの実際のキーフレームです。
869- SVG 内のアニメーションは、レイヤー全体の Motion とは別です。視差効果を減らす設定が有効な場合、自動再生は停止しますがスクラブプレビューは利用できます。
870
871## デザインシステムを使ってレビューする
872
873ページ間でルールを共有する場合は、色、タイポグラフィ、角丸、密度、トークン、コンポーネントを整理します。shadcn/ui、Material、iOS / Apple、Fluent のプリセットから始めることもできます。システムパネルでは、システムの作成、更新、検証、選択範囲への適用、公開ができます。
874
875Design Tools では、次のステップの計画、キャンバスの批評、指摘の修復、システムの検証、納品パッケージのプレビューができます。品質チェックは、一般的な AI 生成物の問題、コントラスト、線幅、操作領域、余白、階層、整列、視差効果を減らす設定を対象とします。厳しいヒューリスティックチェックでは誤検出もあり得ます。広範囲に適用する前に、トークンとコンポーネントの意味を確認してください。
876
877## 結果を Code に引き継ぐ
878
879Design を Requirement から開始した場合は、要件ブロックと受け入れ条件を維持します。Code に移る前に、何がビジュアルの参考で、どの操作が必須で、どの内容がまだプレースホルダーかを明確にします。
880
881Code Binding、変更履歴、ドリフト指標は、デザインと実装がまだ一致しているかを示すのに役立ちます。Prepare implementation と Apply latest changes が書き込むファイルは、引き続きレビューが必要です。成果物の種類に応じて、コントラクト、UI レポート、納品パッケージを作成し、PNG、SVG、HTML、PDF、Penpot パッケージ、\`DESIGN.md\`、\`DESIGN_SYSTEM.md\` をエクスポートできます。
882
883Live Preview には通常、プロジェクトの開発サーバーが必要です。エクスポートに成功しても実装ではなく、Code Binding も損失のない双方向同期を保証しません。引き継ぎ後にプロジェクトチェックを実行し、Diff を確認してください。既定のビューポート、ワークスペース、Design → Code の動作については、[作業モードと Terminal の設定](/docs/mode-and-tool-settings)を参照してください。
884
885プレビューが空、キャンバスが不完全、またはモデルが参考画像を解釈できない場合は、[トラブルシューティング](/docs/troubleshooting)を参照してください。
886`,a=`---
887slug: faq
888lang: ja
889group: safety-help
890order: 40
891status: published
892updatedAt: 2026-07-17
893keywords: FAQ | よくある質問 | ローカルランタイム | 対応 OS | データ | モデル | 復元
894title: よくある質問
895description: Kun の目的、対応プラットフォーム、データ、モデル、自動化、復元動作について簡潔に回答します。
896---
897
898![Kun の Code ワークスペースと主要項目が揃ったサイドバー](/docs-media/screenshots/kun-sidebar-tour-en.webp)
899
900*この実際の Kun ワークスペースには、FAQ 全体で参照する主要項目が表示されています。*
901
902- 上部で **Code**、**Write**、**Design** を切り替えます。各モードはそれぞれ独自のワークスペースモデルを保持します。
903- サイドバーからエージェント、要件、連携、自動化、プロジェクト、会話を利用できます。
904- Settings と電話接続は明示的な項目です。いずれも Kun を完全オフラインにしたり、承認境界をなくしたりするものではありません。
905
906## Kun は一般的な AI チャットツールと何が違いますか？
907
908Kun では、要件、デザイン、計画、ファイル編集、コマンド、Todo、承認、レビューを 1 つのデスクトップワークフローで確認できます。目標を定義し、結果を検証するのは引き続きユーザーです。監督なしでソフトウェアを完成させるサービスではありません。
909

910## どの OS に対応していますか？
911
912現在のリリースでは、macOS、64 ビット版 Windows、x64 Linux 向けのパッケージを提供しています。現在のリリースページに記載されたアーキテクチャと形式を使用してください。[ダウンロードとインストール](/docs/install)も参照してください。
913
914## Kun は完全にオフラインで動作しますか？
915
916いいえ。ランタイムと作業データはローカル優先ですが、モデルへのリクエストは設定した Provider に送信されます。MCP、プロキシ、メッセージブリッジも外部サービスに接続することがあります。[ワークスペースの権限とセキュリティ](/docs/workspace-permissions-security)を参照してください。
917
918## DeepSeek を使う必要がありますか？
919
920いいえ。初期フローでは DeepSeek、Xiaomi MiMo、MiniMax が提示され、後からほかのプリセットや互換サービスを追加できます。ツール、ビジョン、推論の対応状況はモデルによって異なります。
921
922## コーディングの知識がなくても Kun を使えますか？
923
924Write、Design、プロジェクトの読み取り専用の説明には利用できます。ただしコード変更を受け入れるには、受け入れ目標と基本的なリスクを理解する必要があります。不慣れなコマンドには承認ベースの権限を使用し、結果を評価できる人にレビューを依頼してください。
925
926## どの添付ファイルに対応していますか？
927
928チャットは PNG、JPEG、WebP、PDF に対応しています。画像の理解には Vision モデルが必要です。Kun は PDF からテキストを抽出し、OCR を使用する場合があります。ファイルごと、および 1 ターン全体のサイズ上限があります。
929
930## コンピューターの電源を切った後も Schedule は実行されますか？
931
932クラウドサービスのような実行保証はありません。コンピューターと Kun ランタイムが利用可能である必要があり、スリープによって実行されない場合もあります。[スケジュールタスクを作成する](/docs/schedules)を参照してください。
933
934## Plugin、Skill、Extension は同じものですか？
935
936いいえ。MCP はツールを接続し、Skill は再利用可能な手順を提供し、\`.kunx Extension\` はより包括的な UI とランタイム機能を追加できます。[MCP、Skills、Extensions](/docs/plugins-skills-extensions)を参照してください。
937
938## 削除した会話を復元できますか？
939
940アーカイブした会話は復元できます。通常、削除は取り消せません。重要な要件や判断はチャット履歴だけに頼らず、プロジェクトドキュメントにも保存してください。
941
942## より信頼性の高い結果を得るにはどうすればよいですか？
943
944範囲と受け入れ条件を定義し、最小のステップから始め、ツールの証拠と差分を確認し、プロジェクトの既存チェックを実行して、納品前にレビューしてください。複雑な作業では[要件ワークフロー](/docs/requirement-workflow)を使用してください。
945
946## バグ報告には何を含めるべきですか？
947
948OS、Kun のバージョン、Provider とモデル、最小限の再現手順、機密情報を削除したエラーまたはログを含めてください。API キー、トークン、非公開ファイル、完全なローカルパスは決して送信しないでください。まず[トラブルシューティング](/docs/troubleshooting)を参照してください。
949`,d=`---
950slug: feature-overview
951lang: ja
952group: getting-started
953order: 40
954status: published
955updatedAt: 2026-07-17
956keywords: 機能概要 | ユーザーガイド | Code | Design | Write | Requirement | Composer | Agent | サブエージェント | Memory | Computer Use | Schedule | Loop | 電話接続 | Provider | メディア生成 | MCP | Skills | Extensions | worktree | 設定
957title: Kun の全機能概要
958description: Kun の安定したユーザー向け機能をタスク別に確認し、関連する操作ガイドや安全ガイドへ移動できます。
959---
960
961このページは、Kun を利用するユーザー向けの機能マップです。機能が表示されるかどうかは、現在のリリース、OS、モデルの機能、Provi

961der の設定、ローカルランタイムの状態によって異なります。外部サービスや昇格されたアクセスを使う機能が、既定で有効とは限りません。
962
963![Code ワークスペースに表示された Kun の完全なサイドバー](/docs-media/screenshots/kun-sidebar-tour-en.webp)
964
965*メインサイドバーは Kun のタスクマップで、中央には現在のワークスペースが表示されます。*
966
967- **Code / Write / Design** でワークスペースモードを切り替えます。Code はローカルプロジェクト、Write はドキュメント、Design はビジュアル成果物を扱います。それぞれのファイルや操作が自動的に相互利用できるわけではありません。
968- **New Agent** は直接の会話を開始し、**New Requirement** は選択中のプロジェクトで、要件からデザイン、実装へ進む構造化ワークフローを開始します。
969- **Plugins** は MCP と Skills、**Extensions** はインストール済みの \`.kunx\` 機能、**Scheduled tasks** は時間ベースの自動化を管理し、**Create Loop** は再利用可能なノードワークフローを作成します。
970- **Projects** はディレクトリに紐付いた作業をまとめ、**Conversations** は独立したチャットを保持します。検索と追加の操作はそれぞれのセクションに属します。フッターの **Focus** スイッチは、サイドバーのレイアウトやタスク状態を変えずに、Kun マスコットのアニメーションと装飾的なカメオを抑えます。
971- 下部の **Settings** はすべての設定カテゴリ、**Connect phone** はリモートチャンネル設定を開き、**Theme** は外観だけを変更します。モデルの動作や権限は変わりません。
972
973## 主なワークスペースを選ぶ
974

975| 項目 | 用途 | はじめに読むガイド |
976| --- | --- | --- |
977| **Code** | ローカルプロジェクトの検索と編集、コマンドの実行、差分の確認、結果の検証 | [Code モードを使う](/docs/code) |
978| **Design** | 要件と参考資料から方向性、キャンバス、プロトタイプを生成して Code に引き継ぐ | [Design モードを使う](/docs/design) |
979| **Write** | Markdown や長文の編集、AI による推敲、資料の調査、ドキュメントのエクスポート、プレゼンテーションの作成 | [Write モードを使う](/docs/write) |
980| **Requirement** | 目標を明確にして要件ブロックと受け入れ条件を記録し、Plan、Todo、実装へ進む | [要件から検証まで](/docs/requirement-workflow) |
981
982これらの項目は Provider、Agent、権限、ローカルランタイムを共有しますが、異なる作業ディレクトリを使用し、異なるツールを公開する場合があります。最初に[初期設定](/docs/initial-setup)を完了し、小さなタスクで接続を確認してください。
983
984## プロジェクト、会話、入力コンテキストを管理する
985

986Kun では、Code の会話をローカルプロジェクトに紐付けることも、特定のプロジェクトに属さない通常の会話を作ることもできます。サイドバーでは作業ディレクトリの選択、検索、名前変更、ピン留め、移動、アーカイブ、復元、会話の完全削除ができます。以前のコンテキストからフォークしたり、メインの流れを中断すべきでない質問にサイド会話を使ったりすることもできます。[プロジェクト、ワークスペース、会話](/docs/workspace-and-conversations)を参照してください。
987
988Composer はテキスト以外にも対応します。モデルと推論量の選択、Agent と Plan の切り替え、Goal の設定、フォローアップのキュー追加、ワークスペースのファイルやディレクトリの参照、利用可能な場合の画像、PDF、音声入力の追加ができます。Web インジケーターは Web ツールが利用可能かを示すもので、すべてのターンがネットワークにアクセスするという意味ではありません。[入力、添付ファイル、コンテキスト](/docs/composer-attachments-and-context)を参照してください。
989
990## ワークベンチパネルで作業を完了して確認する
991
992Code では、タスクの横に複数の確認画面が表示されます。
993
994| パネルまたはツール | 主な用途 |
995| --- | --- |
996| **Files** | ワークスペースのファイルやディレクトリを閲覧、プレビュー、参照する |
997| **Changes** | 変更済みファイル、追加・削除数、差分を確認する |
998| **Terminal** | 現在の作業ディレクトリで実際のシェルコマンドを実行する |
999| **Browser** | ローカル開発アドレスを開き、ページや操作を確認する |
1000| **Canvas / Whiteboard** | 補助的な図、説明、ビジュアルコンテキストを保持する |
1001| **Plan / Todo** | 複数ステップの進め方、要件の網羅状況、進捗を確認する |
1002| **Side conversations / Subagents** | 並行調査、委任したタスク、返された結果を確認する |
1003
1004Git ブランチや分離された worktree を使うと実験的な変更を分けられますが、コミット、バックアップ、人によるレビューの代わりにはなりません。操作手順とリスクについては、[ワークベンチパネル、Git、worktree](/docs/terminal-browser-and-worktrees)を参照してください。
1005
1006## 目標から計画、実行、レビューへ進む
1007
1008- **Goal** は継続的な成果を見える状態に保ち、一時停止、再開、クリアができます。
1009- **Plan** は依存関係のある作業を検証可能なステップに分け、**Todo** は実行状態を表示します。
1010- **Requirement** は元の意図、要件ブロック、受け入れ条件を保持します。要件が変わったら計画を再確認してください。
1011- **Review** はワークスペースの変更、ブランチ差分、コミット、カスタム範囲を確認できますが、テストや人による受け入れの代わりにはなりません。
1012- **Compact** は会話が上限に近づいた際、継続に必要な情報を保ちながら古いコンテキストを要約します。
1013
1014複数段階の作業については、[長時間タスクとコンテキストを管理する](/docs/long-running-tasks)を参照してください。納品前には、[変更をレビューして承認を処理する](/docs/review-and-approvals)のチェックリストを使用します。
1015
1016## 作業を自動化して電話から接続する
1017
1018| 機能 | 動作 | ランタイム境界 |
1019| --- | --- | --- |
1020| **Schedule** | ワークスペース、モデル、依存関係、任意の分離 worktree を指定して、タスクを 1 回、毎日、または一定間隔で実行する | コンピューター、Kun ランタイム、必要な Provider が利用可能である必要があります。未回答の承認で実行が止まる場合があります |
1021| **Loop** | トリガー、AI、条件、ループ、出力ノードを、実行履歴付きの再利用可能なワークフローにまとめる | 有効化前に入力、出力、失敗経路をノード単位でテストします |
1022| **Connect Phone** | Feishu / Lark、WeChat、Telegram を通じてタスクを開始し、結果を受け取る | Bot トークンと Webhook シークレットは認証情報として扱い、リモートメッセージは信頼できない入力として扱います |
1023
1024[スケジュールタスクを作成する](/docs/schedules)、[Loop を作成して実行する](/docs/loops)、[電話から Kun に接続する](/docs/connect-phone)を参照してください。リモートの入口がモデル、ワークスペース、承認の制約を回避することはありません。
1025
1026## モデル、メディア、拡張機能を設定する
1027
1028Provider は認証情報、リクエスト先、プロトコルの動作を定義します。モデルはテキスト、ビジョン、推論、ツール使用、コンテキストの機能を決めます。画像生成、音声文字起こし、テキスト読み上げ、音楽、動画には通常、それぞれ対応する Provider、モデル、ローカルリソースが必要です。テキストモデルへの接続が成功しても、メディア機能が利用できるとは限りません。まず[Provider とモデル](/docs/providers-and-models)を確認してください。
1029
1030Kun には、境界の異なる 4 つの拡張方法もあります。
1031
1032- **MCP** は外部ツールやサービスに接続します。
1033- **Skills** はエージェントに再利用可能な指示、スクリプト、リソースを提供します。
1034- **Extensions** は \`.kunx\` パッケージで UI、Agent、ツール、Provider、アカウント機能を追加します。
1035- **Appearance / Mode workshop** は Agent のツールを追加せず、Kun のビジュアル上の人格や装飾を変更します。
1036
1037それぞれ権限と信頼境界が異なります。インストールまたは有効化前に[MCP、Skills、Extensions](/docs/plugins-skills-extensions)を読み、出所が不明なものは機密情報を含まないワークスペースでのみテストしてください。
1038
1039## Agent、Memory、コンピューター操作を使う
1040
1041Agent Profile では目的、モデル、システムプロンプト、機能範囲を定義できます。メイン Agent は範囲を限定したタスクをサブエージェントに委任できます。サブエージェントはキューに入り、並列に実行され、バックグラウンドで継続する場合があり、それぞれ開くことのできる独立セッションを保持します。Memory はユーザー、ワークスペース、プロジェクトの各スコープで、会話をまたいで設定や事実を引き継げます。記録の表示、編集、無効化、復元、インポート、エクスポート、削除も可能です。[Agent、サブエージェント、長期 Memory](/docs/agents-subagents-and-memory)を参照してください。
1042
1043**Computer Use** を使うと、エージェントがスクリーンショットを撮り、実際のマウスとキーボードを操作できます。利用方法は Off、Vision モデルで Auto、Always から選べます。macOS ではアクセシビリティと画面収録の権限も必要です。高リスクな機能であるため、継続的に観察して停止できる、信頼できる範囲の狭いタスクでのみ有効にしてください。
1044
1045> 注意: サブエージェント、Memory、Computer Use、MCP、Extensions は、いずれも実行時に利用可能な情報や操作を広げる可能性があります。モデルや Profile を選んでもそのリスクはなくなりません。実効的な境界は、ワークスペース、ツールポリシー、OS の権限、ユーザーのレビューで決まります。[ワークスペースの権限とセキュリティ](/docs/workspace-permissions-security)を参照してください。
1046
1047## 設定、アップデート、診断、データを管理する
1048

1049Settings では、言語とテーマ、デスクトップ動作、Provider、Write、Design、メディアと音声、Agent、サブエージェント、権限、worktree、Memory、ショートカット、電話接続、Terminal、アップデート、トラブルシューティング情報を一元管理します。通常のフォーム変更は、新しい入力が約 450 ms ないと自動保存されます。プロセスレベルのパラメーターを保存するとローカルランタイムが自動的に再起動します。再接続を待ってから続行し、重要なターンの実行中は値を変更しないでください。ほかの設定は即時、次のターン、またはアプリ再起動後に適用される場合があります。現在のコントロール横にある説明に従ってください。
1050
1051- インストール済みバージョンと利用可能なアップデートは **Version & Updates** で確認します。インストーラーについては[ダウンロードとインストール](/docs/install)に記載されたリリースチャンネルを使用してください。
1052- **Archived conversations** で履歴を復元または完全に削除します。アーカイブは削除ではありません。
1053- **Diagnostics** でランタイム機能、ログ、最近のモデルリクエスト詳細を確認します。共有前に認証情報、プロンプト内容、ローカルパスを削除してください。
1054- **Data migration** は、現在の Stable リリースに明示的に表示され、対応している場合にだけ使用します。最初に移行範囲、暗号化パスワード、移行先デバイスを確認してください。移行パッケージは API キー、OAuth 許可、OS の信頼設定のバックアップではありません。
1055
1056設定が反映されない、ランタイムがオフライン、または項目が見つからない場合は、まず[トラブルシューティング](/docs/troubleshooting)を参照してください。エラーを回避するためだけにフルアクセスへ切り替えないでください。
1057`,l=`---
1058slug: first-task
1059lang: ja
1060group: getting-started
1061order: 30
1062status: published
1063updatedAt: 2026-07-17
1064keywords: 最初のタスク | プロジェクトを開く | Code | 検証 | 新しい会話
1065title: 最初のタスクを完了する
1066description: 小さな読み取り専用タスクを通じて、プロジェクト、会話、ツール呼び出し、検証について学びます。
1067---
1068
1069最初のセッションでは、すぐに広範囲の編集を依頼せず、Kun にプロジェクトの説明を求めてみましょう。不要な変更を加えることなく、Provider への接続、ワークスペースへのアクセス、ツールの実行を確認できます。
1070
1071![最初の Code ワークスペースを選ぶための New Agent 画面](/docs-media/screenshots/new-agent-en.webp)
1072
1073*New Agent では、最初のメッセージを送る前にワークスペースと実行境界を確認できます。*
1074
1075- **Code → New Agent** を開き、調査対象となる小規模なプロジェクトフォルダーを選びます。
1076- 読み取り専用の依頼を送る前に、Provider、モデル、慎重な権限モードを確認します。
1077- この画面では会話のコンテキストが作成されますが、それだけでプロジェクトがテストされたり、編集が許可されたりするわけではありません。
1078
1079## プロジェクトを開く
1080
1081![最初のワークスペースを選ぶための Projects と Conversations セクション](/docs-media/screenshots/sidebar-projects-conversations-en.webp)
1082
1083*実際のリポジトリを調査するタスクでは、プロジェクトに紐付いた会話を選びます。*
1084
1085- **Projects** で対象ディレクトリを追加または開き、単独の **Conversations** と区別してください。
1086- ツールに読み取りを許可する前に、表示されたプロジェクト名とフルパスを確認します。
1087- プロジェクトを選ぶとコンテキストが設定されますが、コマンドの実行やファイルの変更は行われません。
1088
10891. **Code** を開きます。
10902. ローカルのプロジェクトフォルダーを選択するか追加します。
10913. 新しい会話を開始し、正しいワークスペースが表示されていることを確認します。
10924. プロジェクトに機密ファイルが含まれている場合は、読み取り専用または承認ベースの権限モードを使用します。
1093
1094Kun のワークスペースとは、明示的に選択したローカルディレクトリです。Wr

1094ite スペースと Design ワークスペースはそれぞれ用途が異なり、自動的に現在のコードプロジェクトになることはありません。
1095
1096## 小さく具体的な質問をする
1097
1098次のような依頼を試してください。
1099
1100> このプロジェクトを読み取り専用モードで調査してください。目的、主要なエントリーポイント、起動方法、最も重要な 3 つのディレクトリを説明してください。参照したファイルを示し、何も変更しないでください。
1101
1102Kun はファイルを読み、コードベースを検索して、ツールの実行結果を表示することがあります。最終的な文章だけで判断せず、どの証拠が使われているかに注目してください。
1103
1104## 結果を検証する
1105
1106![読み取り専用の最初のタスク後に表示された場合は想定外となる、2 ファイルのサンプル差分を示す Changes パネル](/docs-media/screenshots/changes-diff-en.webp)
1107
1108*意図的に編集した 2 ファイルのサンプルです。推奨した読み取り専用タスクの後にこの状態が表示されたら調査が必要です。指示どおりに実行されていれば Changes は空のままです。*
1109
1110- まずパネルを開きます。画像の \`src/app.ts\` とチェックリストの編集は一例であり、読み取り専用プロンプトで期待される結果ではありません。
1111- 行が 1 つでも表示された場合は、続行前に追加と削除の内容を確認してください。誰が、または何が作成した変更か把握するまでは破棄しないでください。
1112- Changes パネルが空であることから確認できるのはファイルの状態だけです。回答と実際のプロジェクト構造も照合してください。
1113
1114![エージェントが報告したプロジェクトパスを確認するための Files パネル](/docs-media/screenshots/files-panel-en.webp)
1115
1116*現在のワークスペースツリーと、正確な参照の追加やパスのコピーに使えるファイルのコンテキストメニューが表示されています。*
1117
1118- 回答で挙げられたファイルを展開し、パスとエントリーポイントがプロジェクトと一致することを確認します。
1119- **Add file reference** は、関連する最小限の項目にだけ使用してください。**Copy absolute/relative path** を使うと、同名ファイルを区別できます。
1120- 必要な場合に限ってコマンドの証拠を求め、Terminal で終了ステータスを確認します。
1121- 存在しないファイルを指している説明は、もっともらしくても検証済みとはいえません。
1122
1123- 説明は README や設定ファイルと一致していますか。
1124- エージェントが示したファイルは実際に存在しますか。
1125- 何も編集しないという指示を守っていますか。
1126- コマンドを実行した場合、そのコマンドと出力はタスクに関係していますか。
1127
1128ファイルに変更があった場合は、Changes または差分ビューを開いて正確な内容を確認してください。もっともらしい回答は検証の代わりにはなりません。
1129
1130## 次のステップ
1131
1132接続を確認できたら、1 つのラベルを変更して既存のプロジェクトチェックを実行するなど、明確な受け入れ確認を含む範囲の狭い編集を試してください。より大きな機能に着手する前に、[要件ワークフロー](/docs/requirement-workflow)、[Code モード](/docs/code)、[レビューと承認](/docs/review-and-approvals)を読んでください。
1133`,c=`---
1134slug: general-and-desktop-settings
1135lang: ja
1136group: settings
1137order: 20
1138status: published
1139updatedAt: 2026-07-17
1140keywords: 一般設定 | 言語 | テーマ | フォント | ワークスペース | ログイン時に起動 | トレイ | 通知 | ログ | Persona workshop
1141title: 一般設定、デスクトップ設定、画面設定
1142description: 言語、テーマ、ワークスペースルート、起動・終了動作、通知、Checkpoint、ログ、Kun の Mode workshop を設定します。
1143---
1144
1145一般設定では、アプリケーション全体の外観、既定の場所、デスクトップ動作を制御します。通常の Settings の編集は、入力を止めてから約 450 ms 後に自動保存さã

1145‚Œã¾ã™ã€‚ヘッダーには Saving、Saved、Save failed の状態が表示され、個別の Save ボタンはありません。
1146
1147![言語、外観、倍率、ワークスペースルートを表示する一般設定](/docs-media/screenshots/settings-general-en.webp)
1148
1149*General は、画面全体と既定の場所に関する動作を設定する最初の場所です。*
1150
1151- **Settings → General** を開き、言語、テーマ、倍率、コンテンツ幅、管理対象ワークスペースルートを変更します。
1152- 各変更後に保存状態を確認してください。パスと倍率の設定は、新しく開くワークスペースまたは画面全体に影響する場合があります。
1153- 外観の変更は、モデル出力、ツール権限、現在のプロジェクトのファイルを変更しません。
1154
1155## 画面とワークスペースルート
1156
1157| 設定 | 選択肢と既定値 | 効果 |
1158| --- | --- | --- |
1159| Language | 英語または簡体字中国語。既定は英語 | アプリケーションの画面言語を変更 |
1160| Theme | System、light、dark。既定は System | System は OS の外観変更に追従 |
1161| UI text scale | 70% から 140% まで 1% 刻み。既定は 82% | エクスポートしたファイル内のテキストではなく、アプリケーション画面全体を拡大縮小 |
1162| Chat content width | 640 から 1200px まで 8px 刻みに正規化。既定は 896px | メインメッセージ列の最大幅を変更 |
1163| Default workspace | 既定は \`~/.kun/default_workspace\` | 新しい Code プロジェクトとアプリケーションワークスペースが必要な機能で使用 |
1164| Conversation workspace | macOS / Windows は \`~/Documents/Kun\`、Linux は \`~/.local/share/Kun/conversations\` | プロジェクトに属さない会話はここにタイムスタンプ付き子フォルダーを作成 |
1165| Cursor spotlight | 既定でオン、色は \`#85c1f1\` | 無効化、色選択、6 桁の 16 進値入力、色調調整が可能。外観だけに影響 |
1166
1167グローバルルートを変更しても、既存のプロジェクト、会話履歴、添付ファイルは移動しません。プロジェクトの会話は元のディレクトリに紐付いたままです。ボリュームが見つからない、またはパスが移動した場合は、Agent に書き込みを依頼する前に復元するか有効なディレクトリを選択します。長期間使うプロジェクトでは、一時ストレージや頻繁に切断されるストレージを避けてください。
1168
1169## デスクトップ動作と通知
1170
1171![起動、終了、トレイ、通知の動作を表示するデスクトップ設定](/docs-media/screenshots/settings-desktop-en.webp)
1172
1173*Desktop 設定は、OS 上のアプリケーションとしての Kun の動作を制御します。*
1174
1175- 長時間の作業を利用可能な状態に保つ方法に合わせて、ログイン時起動、ウィンドウを閉じたときの動作、トレイ、通知を選びます。
1176- ウィンドウを閉じることとアプリ終了は異なる場合があるため、Schedule や電話接続に依存する前に、選択した動作を確認します。
1177- 通知権限は OS にも制御され、Kun の外で許可が必要な場合があります。
1178
1179| 設定 | プラットフォームと既定値 | 意味 |
1180| --- | --- | --- |
1181| Open at login | 既定でオフ。macOS と Windows のみ | Kun を OS のログイン項目に登録 |
1182| Start minimized | 既定でオフ。現在は Windows のみ | Open at login が有効な場合だけ利用可能。ログイン時起動を無効にすると、この項目も無効化 |
1183| When closing a window | 毎回確認、トレイに保持、終了。既定は毎回確認 | Tray はアプリとローカルランタイムを維持し、Quit はアプリとローカルのバックグラウンド作業を終了 |
1184| Turn-complete notification | 既定でオン | Kun に対する OS の通知権限も必要 |
1185
1186Kun をトレイに保持すると Schedule、Loop、電話接続の継続に役立ちますが、デバイスのスリープ、ネットワーク切断、OS の電源ポリシーは回避できません。無人タスクではシステムの電源設定とタスク自身の状態を両方確認してください。
1187
1188## オンボーディングと旧会話のインポート
1189
1190Preview onboarding は直ちに実行される操作です。現在の設定をリセットせず、言語、Provi

1190der、権限のツアーを再度開きます。
1191
1192旧形式のインポートは、次の 2 つの古い場所を自動的に検索します。
1193
1194- \`~/.deepseekgui/kun/threads\`
1195- \`~/.deepseekgui/coreagent/threads\`
1196
1197別の旧会話ディレクトリを手動で選択することもできます。ページでは、すでに存在する会話とインポート可能な会話が区別されます。インポート後、新しい会話を表示するためにローカルランタイムの再起動を求められる場合があります。まず重要なデータをバックアップし、その後いくつかのワークスペースパスと添付ファイルを確認してください。
1198
1199旧会話のインポートはデバイス間移行ではありません。デバイス間のデータ処理については、[データ、アップデート、診断](/docs/data-updates-and-diagnostics)を参照してください。
1200
1201## Git Checkpoint のクリーンアップ
1202
1203![Git Checkpoint の保持、クリーンアップ、アプリケーションログに関する一般設定](/docs-media/screenshots/settings-checkpoints-logs-en.webp)
1204
1205*Checkpoint とログは復元と診断に役立ちますが、どちらも保持範囲を制限し、非公開パスを慎重に扱う必要があります。*
1206
1207- Checkpoint が無制限に増えないよう、クリーンアップ時期、保存ディレクトリ、会話ごとの上限を設定します。通常の Git コミットとは異なります。
1208- トラブルシューティングに必要な期間だけログを保持し、共有前にキー、プロンプト、ユーザー名、顧客プロジェクトのパスを削除します。
1209- Checkpoint の復元はワークスペースを書き換える場合があります。最初に Changes を確認し、まだ必要な作業を保全してください。
1210
1211Kun は対応するターンで Git Checkpoint を作成できます。一般設定で使用するディスク容量を制限します。
1212
1213| 設定 | 選択肢と既定値 | 意味 |
1214| --- | --- | --- |
1215| Automatic cleanup | 既定でオン | 無効にすると古い Checkpoint が増え続けるため、ディスクを手動で監視する必要あり |
1216| Cleanup interval | 1、2、3、5、10 日。既定は 3 日 | 自動クリーンアップが有効な場合にだけ使用 |
1217| Checkpoint directory | 既定は空 | 空の場合は \`<dataDir>/git-checkpoints\`。必要に応じて別のボリュームを使用 |
1218| Maximum per conversation | 1 から 100。既定は 5 | 上限を超えると古い Checkpoint を削除 |
1219
1220Checkpoint はプロジェクトの通常の Git 履歴ではなく、唯一のバックアップとしてはいけません。コミットするソースツリーの外にカスタム Checkpoint ディレクトリを置いてください。復元によってワークスペースが書き換わる場合があります。先に[Terminal、プレビュー、worktree](/docs/terminal-browser-and-worktrees)を読んでください。
1221
1222## ログ
1223
1224アプリケーションログは既定でオンです。保持期間は 1、2、3、5、7 日から選べ、既定は 3 日です。Open log directory を使うと現在の場所が直接開きます。
1225
1226ログにはエラー、ランタイム状態、モデル識別子、ローカルパスが含まれる場合があります。機密情報を確認してから、関連する抜粋だけを共有してください。アプリケーションログと LLM ラウンド診断は別です。モデルリクエストの詳細は[データ、アップデート、診断](/docs/data-updates-and-diagnostics)を参照してください。
1227
1228## Mode workshop
1229
1230![Kun の外観パッケージを選択・管理する Mode workshop](/docs-media/screenshots/image-workshop-en.webp)
1231
1232*Mode workshop は、Agent ランタイムを変更せず、マスコットと宣言型ビジュアルパッケージを管理します。*
1233
1234- 内蔵の外観を選ぶか、\`manifest.json\` を含む信頼済みフォルダーをインストールし、プレビューしてからカードを有効にします。

1235- パッケージを削除すると Kun にインストールされたコピーが消えるため、再インストールする可能性がある場合は元のフォルダーを保持します。
1236- Persona の素材は表示だけを変更し、メディア Provider を呼び出したり、ツール、Skills、権限を追加したりしません。
1237
1238Mode workshop は 3D、パーティクル、パフォーマンスのトグル集ではありません。現在の画面では次の外観タイプを提供します。
1239
1240| 外観 | 意味 |
1241| --- | --- |
1242| Default Kun | アプリケーションに内蔵され、削除不可 |
1243| Retroma | Default Kun カードの羊皮紙パレットボタン。Light テーマだけに作用する内蔵パレット |
1244| iKun | 初回セットアップ時に事前インストールされる公式サンプル UI プラグイン。ほかのプラグインと同様に有効化または削除可能 |
1245
1246Install from folder を選び、\`manifest.json\` と画像素材を含むプラグインディレクトリを指定します。インストール済みプラグインはカードとして表示され、有効化または削除できます。ファイルは \`~/.kun/ui-plugins/<plugin-id>\` に保存されます。削除するとインストール済みコピーが消えるため、再インストールする場合は元フォルダーを保持します。外観変更はすぐ適用され、専用の UI 設定ストアに保持されます。モデル、ツール権限、通常の Settings データは変更しません。
1247
1248UI プラグインは**宣言型の画像パッケージ**です。Kun のキャラクター枠、ローカライズされた作業ラベル、許可リスト内の \`--ds-*\` テーマトークン、任意のカメオを提供できます。Kun がコピーするのは Manifest と、参照された PNG、WebP、JPG、JPEG、GIF 画像だけです。ソースディレクトリの JavaScript、HTML、カスタム CSS、その他の実行可能ファイルをコピーまたは実行しません。存在しない枠は Default Kun にフォールバックし、読み込み失敗時も既定の外観に戻ります。
1249
1250パッケージ作成者は、\`manifest.json\` でアプリ全体、サイドバー、メインステージについて、Light と Dark テーマ別の背景レイヤーも宣言できます。各レイヤーは \`cover\` または \`contain\`、9 方向のアンカー、\`0\` から \`1\` の透明度に対応します。背景は PNG、WebP、JPG、JPEG に対応しますが GIF は不可です。Kun は画像を検証して内部データ URL に変換するため、背景パスからリモート URL を取得したり CSS を注入したりできません。
1251
1252同梱の iKun パッケージが初回セットアップで登録されるのは一度だけです。削除しても起動のたびに強制再インストールされません。必要になったら、有効なプラグインフォルダーから再インストールしてください。
1253
1254## リセットとトラブルシューティングの順序
1255
12561 グループずつリセットします。最初にテーマ、テキスト倍率、コンテンツ幅、次にパスの存在、最後にデスクトップ動作またはローカルの Terminal / Write の既定値を確認します。Persona プラグインの問題では、そのプラグインを削除または再インストールする前に Default Kun に切り替えます。ヘッダーに Save failed が表示されたら連続した編集を止め、[トラブルシューティング](/docs/troubleshooting)でログとディスク状態を確認してください。
1257`,u=`---
1258slug: initial-setup
1259lang: ja
1260group: getting-started
1261order: 20
1262status: published
1263updatedAt: 2026-07-17
1264keywords: 初回起動 | API キー | Token Plan | Provider | 権限
1265title: 初期設定
1266description: Kun を安全に使い始めるために、既定の権限、モデル Provider、アクセス方法を選びます。
1267---
1268
1269初回起動時に、Kun は既定の権限モードとモデル Provider の設定を求めます。どちらも後から変更できるため、最初からすべての詳細設定を行う必要はありません。
1270
1271![Kun の初回起動時に表示される Provider と権限の設定画面](/docs-media/screenshots/onboarding-provider-permissions-en.webp)
1272
1273*オンボーディング画面では、Provider への接続と既定のツール権限境界を設定します。*
1274
1275- Provider を選び、そのサービスで必要な認証情報ã

1275®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ã ã‘を入力します。
1276- 機密性の高い操作やワークスペースへの書き込み前に確認を求める権限モードから始めてください。
1277- オンボーディングを完了すると既定値が保存されます。ただし、実際にテストするまでは、認証情報、モデルの機能、プロジェクトへのアクセスが正しいことを証明するものではありません。
1278
1279## 1. 既定の権限モードを選ぶ
1280
1281権限モードは、ファイルの読み取り、ワークスペースの変更、コマンドの実行前に、エージェントが確認を求める条件を制御します。最初のプロジェクトでは、機密性の高い操作やワークスペースへの書き込み前に確認を求めるモードから始めてください。リスクを理解し、そのプロジェクトを信頼できる場合に限り、より制限の少ないモードを使用してください。
1282
1283詳しい比較は[ワークスペースの権限とセキュリティ](/docs/workspace-permissions-security)を参照してください。
1284
1285## 2. モデル Provider を選ぶ
1286
1287初回起動フローでは DeepSeek、Xiaomi MiMo、MiniMax が提示されます。すでにアカウントと認証情報を持っている Provider を選んでください。後から Settings → Providers で、ほかのプリセットや互換性のあるカスタムサービスを追加できます。
1288
1289Provider とモデルは同じものではありません。Provider は接続と請求を処理し、モデルはテキスト、ビジョン、推論、ツール使用の各機能を決めます。詳しくは[Provider とモデル](/docs/providers-and-models)を参照してください。
1290
1291## 3. アクセス方法を選ぶ
1292
1293Provider によっては、標準 API と Token Plan の両方を提供しています。それぞれで認証情報、リージョン、エンドポイントが異なる場合があります。Provider の管理画面に表示されている製品を選び、通常の API キーを Token Plan の認証情報として使えるとは考えないでください。
1294
1295認証情報を入力する際は、次の点に注意してください。
1296
1297- 誤って入った空白や改行を削除する。
1298- キーをチャット、スクリーンショット、公開リポジトリに決して貼り付けない。
1299- Provider が指定するリージョンと接続先を使用する。
1300- 自分が管理するデバイスには、自分の認証情報だけを保存する。
1301
1302## 4. 保存して確認する
1303
1304保存すると、Kun はローカルランタイムと既定のモデルを準備します。Settings → Providers では、接続のテスト、利用可能なモデルの取得、モデル機能の宣言の調整を行えます。
1305
1306接続に失敗した場合は、まずキー、アクセス方法、リージョン、プロキシを確認し、それから[トラブルシューティング](/docs/troubleshooting)を参照してください。セットアップできたら、[最初のタスク](/docs/first-task)へ進みます。
1307`,g=`---
1308slug: install
1309lang: ja
1310group: getting-started
1311order: 10
1312status: published
1313updatedAt: 2026-07-17
1314keywords: インストール | ダウンロード | macOS | Windows | Linux | アップデート
1315title: ダウンロードとインストール
1316description: macOS、Windows、Linux に適した Kun パッケージを選び、初回起動まで完了する方法を説明します。
1317---
1318
1319Kun は macOS、Windows、Linux で利用できるデスクトップアプリケーションです。Kun 公式サイトのダウンロードセクション、またはプロジェクトの GitHub Releases から入手してください。出所を確認できないミラーサイトのパッケージは避けてください。
1320
1321![デスクトップへのインストールが完了した後に表示される Kun の初回起動画面](/docs-media/screenshots/onboarding-provider-permissions-en.webp)
1322
1323*初回起動に成功すると、Provider と既定の権限を設定するオンボーディングが開きます。*
1324
1325- OS とプロセッサアーキテクチャに合ったパッケージをインストールし、通常どおり Kun を起動します。
1326- この画面が表示されればデスクトップ画面は起動できていますが、モデルへの接続やツールへのアクセスが確認されたわけではありません。
1327- アプリの入手元と、使用する Provider アカウントを確認するまではキーを貼り付けないでください。
1328

1329## 適切なパッケージを選ぶ
1330
1331- **macOS:** 「この Mac について」で Apple シリコンか Intel プロセッサかを確認し、対応する DMG または ZIP を選びます。
1332- **Windows:** 現在のインストーラーは 64 ビット版 Windows 向けの EXE です。
1333- **Linux:** 現在のパッケージは x64 AppImage です。ディストリビューションによっては、ファイルのプロパティでプログラムとしての実行を許可する必要があります。
1334
1335Kun は継続的に更新されています。このガイドに記載された情報ではなく、リリースページに表示されるバージョン番号、ファイルサイズ、対応パッケージ一覧を最新の正しい情報として扱ってください。
1336
1337## インストールして起動する
1338
13391. OS とアーキテクチャに合ったパッケージをダウンロードします。
13402. 各プラットフォームの通常の手順でインストールするか、パッケージを開きます。
13413. 初回起動時に、OS からアプリの入手元の確認や、ファイルおよびマイクへのアクセス許可を求められることがあります。使用する機能に必要な権限だけを許可してください。
13424. Kun のセットアップ画面が表示されるまで待ち、[初期設定](/docs/initial-setup)へ進みます。
1343
1344OS によってアプリがブロックされた場合は、まずファイルが公式リリースページから取得したものか確認し、システムのセキュリティメッセージを読んでください。警告を回避するためだけにシステムの保護機能を恒久的に無効化しないでください。
1345
1346## インストールを確認する
1347
1348正常に起動すると、セットアップフローとともに Code と Work の 2 つの主要ワークスペースが表示されます。Design は Code 内で選ぶタスクタイプです。Kun はコンピューター上でランタイムを起動し、モデルへのリクエストは設定した Provider に送信します。
1349
1350ウィンドウが開かない、ランタイムがオフラインのままになる、またはパッケージに互換性がない場合は、[トラブルシューティング](/docs/troubleshooting)を参照してください。
1351
1352## アップデート
1353
1354Kun では Stable または Frontier のアップデートチャンネルが提供される場合があります。インストール済みバージョンに表示される選択肢を使用してください。重要な作業中にアップデートする場合は、その前にドキュメントを保存し、未コミットのプロジェクト変更を保全してください。
1355`,p=`---
1356slug: long-running-tasks
1357lang: ja
1358group: workflows
1359order: 30
1360status: published
1361updatedAt: 2026-07-17
1362keywords: 長時間タスク | goal | todo | compact | fork | BTW | コンテキスト
1363title: 長時間タスクとコンテキストを管理する
1364description: Goal、Plan、Todo、Compact、会話の分岐を使い、複数段階の作業を方向づけて復元可能な状態に保ちます。
1365---
1366
1367長いタスクで難しいのは、コードの生成そのものではない場合があります。多くのターンを通じて、目標、証拠、判断を失わないことが重要です。Kun は Goal、Plan、Todo、Compact、Fork、BTW を提供し、方向性、実行状態、補助的な調査を管理します。
1368
1369![長いタスク中に追跡している作業を表示する Todo パネル](/docs-media/screenshots/todo-panel-en.webp)
1370
1371*Todo は長い実行を目に見える項目に分け、チャットの文章とは独立して状態を確認できるようにします。*
1372
1373- Goal と Plan が明確になった後、ワークベンチツールから **Todo** を開きます。
1374- 項目は成果を中心に記述し、証拠が得られるたびに更新します。チェック済みの項目は実際の結果に対応すべきです。
1375- Todo は状態を追跡するもので、スケジューラーでも、バックグラウンド作業が実行中であることの保証でもありません。
1376
1377## 成果を見える状態に保つ
1378
1379\`/goal\` を使って具体的な結果を設定します。有用な Goal は「作業を続ける」のようなプロセスではなく、完了条件を記述します。新しい段階の開始時に、Goal が引き続き要件に一致するか確認してください。要件が変わった場合は、続行前に Goal と Plan を更新します。
1380
1381Composer の **More actions** を開き、**Pursue goal** を選んで、この会話で継続的に進める成果を入力します。
1382
1383![編集、一時停止、その他の操作を備えた、現在の Kun 会話で進行中の実際の Goal バー](/docs-media/screenshots/goal-panel-live-en.webp)
1384
1385*進行中の Goal バーは、現在の会話の後続ターンにも 1 つの完了条件を表示し続けます。*
1386
1387- Goal は現在のスレッドだけに属します。別の会話、ブランチ、ワークスペースには自動適用されません。新しい会話では適切ã

1387ª Goal を改めて設定してください。
1388- 有効な Goal はいつでも編集または一時停止できます。一時停止した Goal は再開でき、More actions からクリアできます。要件が変わったら、古い方向性で続行する前に Goal を更新します。
1389- Goal は後続ターンを同じ結果へ向かわせますが、ツール権限、ワークスペース範囲、ネットワークアクセスを拡張せず、承認も回避できません。
1390
1391## Plan と Todo で作業を調整する
1392
1393Composer の **More actions** から **Plan** を開きます。実行を始めるか決める前に、Goal をステップと検証方法に分けるよう Kun に依頼します。
1394
1395![左に会話、右に Markdown レビューパネルと Plan カードを表示する Kun の Plan モード](/docs-media/screenshots/plan-panel-live-en.webp)
1396
1397*Plan は生成済みですが、まだ実行されていません。左側で議論を続け、右側で各項目を確認し、実行できる状態になったときだけ Build を使います。*
1398
1399- Kun は Plan をワークスペース内の \`.kunsdd/plan/\` に Markdown ファイルとして保存します。右パネルには実際のファイル、保存状態、全文が表示されるため、最初に Goal、ステップ、検証条件を確認できます。
1400- 変更するには、左側の会話で新しい範囲や制約を説明します。Kun は右側に表示された Plan を更新します。最初の下書きは変更できない最終 Plan ではありません。
1401- **Build** は Plan から実行へ戻り、Plan に沿って作業を開始します。Plan を生成しても、コマンド実行、製品ファイルの変更、ステップの完了は行われません。
1402
1403Plan は依存関係のあるステップを表し、Todo は保留、実行中、完了を示します。各ステップに観察可能な成果を持たせてください。たとえば「データベースを対応する」ではなく、「マイグレーションを追加し、既存のデータベーステストに合格する」とします。
1404
1405チェックボックスの完了は受け入れではありません。各段階の境界で、差分、コマンド出力、受け入れ条件を確認します。
1406
1407## コンテキストの増加を制御する
1408
1409会話が長くなると、コンテキストビューに容量とその使用先が表示されます。\`/compact\` は過去の作業を、継続に必要な情報へ要約します。Compact の前に、重要な制約、未解決の質問、検証結果が要件、Plan、または明示的なメッセージに記録されていることを確認してください。
1410
1411## メインスレッドを逸らさず調査する
1412
1413![元のメインスレッドを表示した未送信のサイド会話 Composer](/docs-media/screenshots/branch-conversation-en.webp)
1414
1415*Composer はメインスレッドのコンテキストを持つ Side / BTW の質問を準備しています。送信して初めてサイド会話が作成されます。*
1416
1417- 送信前に上部に表示される元のスレッドを確認します。未送信のパネルを閉じても何も作成されず、作成済みのサイド会話を隠してもキャンセルやマージはされません。
1418- **Fork** はここに表示されたコントロールではなく、独立した会話を作る別の操作です。別の方法を試す場合に使用します。
1419- セッションがワークスペースを共有する場合があるため、作成する会話でファイル編集を許可するか明記し、採用した証拠をメインスレッドへ戻します。
1420
1421![委任可能な役割、モデル継承、New subagent を表示する Subagents パネル](/docs-media/screenshots/subagents-panel-en.webp)
1422
1423*Subagents は委任に使える役割を設定します。実行中タスクの状態は、委任後に作成されるタイムラインカードに表示されます。*
1424
1425- 最初に役割の責任範囲とモデルの継承を確認します。**New subagent** は役割 Profile を作成するもので、タスクを実行しません。
1426- 境界と成果物が明確な作業だけを委任し、タイムラインのタスクカードから子セッションを開いて確認します。
1427- 各結果を確認してからメインタスクの一部として扱います。
1428- 並列 Agent が共有ファイルで競合する場合があるため、所有範囲を割り当てるか分離 worktree を使用します。
1429
1430- \`/fork\` は現在のコンテキストから独立した会話を作り、別の実装方法を試す際に役立ちます。
1431- \`/btw\` はメインタスクを中断すべきでない関連質問について、コンテキストを引き継いだサイド会話を作ります。
1432- Assistant の回答からフォークすると、特定の判断時点を別経路の開始点として保持できます。
1433
1434ブランチで得た結論が、自動的にメインスレッドの事実になることはありません。戻ったら、採用する結果を明示的に持ち帰ってください。
1435
1436## アーカイブと復元
1437
1438後から必要になる会話はアーカイブし、作業を再開するときに復元します。通常、削除は取り消せません。重要なプロジェクト判断の

1438唯一のバックアップとして、アーカイブ済みチャット履歴に依存しないでください。
1439
1440信頼できる流れは、Goal を定義 → Plan を作成 → Todo に沿って実行 → 各段階を検証 → 必要に応じて Compact → \`/review\` で完了、です。
1441`,m=`---
1442slug: loops
1443lang: ja
1444group: automation
1445order: 20
1446status: published
1447updatedAt: 2026-07-17
1448keywords: Create Loop | workflow | trigger | webhook | condition | loop | human approval
1449title: Loop を作成して実行する
1450description: トリガー、AI、条件、反復、出力を、再利用可能なローカルのビジュアルワークフローにまとめます。
1451---
1452
1453Create Loop は、安定した一連のステップを再利用するための Kun のビジュアルワークフローツールです。Schedule が主に「いつ実行するか」を扱うのに対し、Create Loop は「どのノードを実行し、データをどう渡すか」を定義します。両方を組み合わせて利用できます。Create Loop は Workflow 機能全体を指し、その中の **Loop ノード**はフロー制御ノードの 1 つにすぎません。
1454
1455## 最小限のワークフローを作る
1456
1457![手動トリガー、ノードライブラリ、設定パネル、実行コントロールを表示する新しい Loop キャンバス](/docs-media/screenshots/loop-canvas-en.webp)
1458
1459*新しい Loop は Manual トリガーから始まります。左のライブラリからノードを追加し、右側で選択中のノードを設定してから、Run once でテストします。*
1460
1461- ノード種別横の \`+\` 操作でトリガーの後にノードを追加し、各出力を意図した後続入力につなぎます。
1462- ノードを選択して右側で入力を設定します。グラフから推測するのではなく、実際の実行を確認する場所が **Run log** タブです。
1463- 最初に機密性のないデータでテストします。見た目上つながったグラフでも、検証またはランタイム権限で失敗する場合があります。
1464
14651. サイドバーから **Create Loop** を開き、New を選びます。Kun は直ちに無効状態の **Untitled Create Loop** を作成し、キャンバスを開いて Manual トリガーを追加します。
14662. 目的に合わせて名前を変えます。オンデマンドのワークフローでは Manual を残し、自動化が必要なら Schedule または Webhook トリガーに置き換えるか追加します。
14673. 必要な AI、HTTP、Code、condition、field-processing、その他のノードを追加します。
14684. 呼び出し側が最終結果を判断できるよう、明示的な Output ノードを追加します。
14695. 無効のまま、副作用のないサンプルデータで Run once を実行します。テストに合格した後にだけ、有効化または Agent callable にします。
1470
1471別のトリガーを追加せず、既定の Manual トリガーを削除すると、通常の方法でワークフローを開始できません。出力ノードがない場合、途中のステップは成功しても呼び出し側が有用な結果を受け取れないことがあります。インポートまたはコピーしたワークフローは無効のままにし、シークレット、送信先 URL、ローカルスクリプトを再確認してください。
1472
1473## 条件、分岐、反復
1474
1475Condition と Switch はデータに基づいて経路を選びます。Loop は条件を満たす間の繰り返しや、コレクションの反復処理ができます。モデルコスト、レート制限、エラーが予想外に増えないよう、並列数と反復回数を必要最小限にしてください。Kun は並列数、反復、ネストを制限します。現在のエディターに表示される上限を使用してください。
1476
1477Merge、Filter、Sort、Limit、Aggregate を使うと複数経路の結果を整形できます。複雑なワークフローは、個別にテストできるサブワークフローに分割します。
1478
1479条件ループの既定は最大 10 回で、上限は 100 回です。For each は順次、または 1 から 8 の並列数で実行できます。Loop と Subworkflow を合わせたネストは 5 階層までã

1479§ã™ã€‚ガードに達すると無限に続かず実行を停止するため、認識しやすい「未完了」の出力を定義してください。
1480
1481## 25 種類のノード早見表
1482
1483| グループ | 現在のノード |
1484| --- | --- |
1485| Trigger | Manual、Schedule、Webhook |
1486| AI とメディア | AI Agent、Generate Image、Parameter Extractor、Question Classifier |
1487| フロー制御 | Condition、Switch、Subworkflow、Loop、Delay、Human Approval |
1488| データ | Filter、Set Fields、Sort、Limit、Aggregate、Merge、Template、JSON |
1489| 操作と出力 | Code、HTTP Request、Output、Custom |
1490
1491Code と Custom ノードはローカルの JavaScript、Python、Shell ロジックを実行でき、コンピューター上でコードを実行するのと同じリスクがあります。Generate Image は[メディア生成](/docs/media-generation)に依存し、AI Agent には動作する Provider が必要で、HTTP Request は送信先サービスにデータを送ります。
1492
1493## ノード入力、変数、シークレット
1494
1495ノードは上流からテキストまたは JSON を受け取り、フィールド内で以前の出力を参照できます。エディターには \`json\` 以下のフィールドなど、利用可能な式が表示されます。実際の入力を接続する前に、固定サンプルデータで経路をテストしてください。後続ノードに不安定な文章の推測を任せず、Set Fields、Template、JSON で明示的な形を作ります。
1496
1497機密値は Secret 変数または保護された設定に保存します。UI とログは機密値を伏せようとしますが、ノードのコードが意図的にシークレットを出力することは可能です。トークンをノード名、通常のフィールド、モックデータ、エクスポートしたワークフローに決して入れないでください。
1498
1499## テスト、再試行、失敗ポリシー
1500
1501ノードを単独でテストするか、モック入力を与えます。一般的なコントロールには、有効状態、再試行、失敗時停止、続行、フォールバックがあります。1 つのノード、次に 1 つの分岐、最後に完全なワークフローを検証します。
1502
1503Continue はエラーを後続に渡すため、次のノードがエラー構造を認識する場合だけ安全です。並列 For each は出力順序を保ちますが、ポリシーでは引き続き即時失敗または部分収集を選ぶ必要があります。最終 Output だけを見るのではなく、実行履歴とログで失敗したノードを特定してください。
1504
1505## 有効化して Agent 呼び出しを許可する
1506
1507保存と有効化は同じではありません。自動実行の前にワークフローを有効にします。Agent がツールとして呼び出せるようにする場合は、**Agent callable** も有効にします。安定した入力、明確な出力、理解済みの権限境界を持つワークフローだけを公開してください。
1508
1509有効なワークフローはローカル実行 API からも呼び出せます。Webhook、ローカル API、Agent Tool は、同じノードグラフへの異なる入口です。呼び出し側は合意済みの入力を渡し、Output ノードを正式な結果として扱う必要があります。インポート、エクスポート、ノードプリセット、カスタムモジュールは設定の再利用に役立ちますが、インポートしたワークフローはシークレットと送信先 URL を確認するまで無効にしてください。
1510
1511## Hook と再帰の境界
1512
1513Create Loop は、\`PreToolUse\`、\`PostToolUse\`、\`UserPromptSubmit\`、\`TurnStart\`、\`TurnEnd\`、\`PreCompact\` の Agent フェーズに関連付けられます。Hook はイベントを監視でき、一部のフェーズでは後の動作をブロックまたは書き換えられます。現在のエディターが公開する操作だけを使用してください。
1514
1515同じワークフロー、ツール、サブワークフローを呼び出す Hook は再帰する可能性があります。反復、ノード数、タイムアウトのガードを設定する前に、対象ツールとトリガー条件を限定します。短時間で完了できない長いメディア処理を \`PreToolUse\` に置かないでください。
1516
1517## 人による承認と再起動
1518

1519Human Approval ノードは、ユーザーの判断を待つため実行を一時停止します。待機状態がランタイムのメモリだけに保持され、アプリケーションの再起動で失われる場合があるため、再起動後も維持すべき承認には依存しないでください。
1520
1521Webhook とローカル API は高度な入口です。ノード名とログに認証情報を入れず、リクエスト元を制限して、外部入力を検証してください。
1522
1523実行に失敗したら、トリガーから始めて入力と出力をノード単位で確認し、その後[トラブルシューティング](/docs/troubleshooting)を参照してください。
1524`,P=`---
1525slug: media-generation
1526lang: ja
1527group: integrations
1528order: 30
1529status: published
1530updatedAt: 2026-07-17
1531keywords: 画像生成 | 音声文字起こし | Whisper | TTS | 音楽生成 | 動画生成 | Vision | マルチモーダル
1532title: 画像、音声、音楽、動画の機能を使う
1533description: マルチモーダル入力とメディア生成を区別し、画像、文字起こし、TTS、音楽、動画のモデルを正しく設定します。
1534---
1535
1536Kun における「マルチモーダル」には 2 つの異なる機能群があります。Chat モデルに画像や PDF を読ませることと、専用モデルに画像、音声、音楽、動画の生成を依頼することです。同じ Provider を共有する場合も、まったく異なるプロトコル、モデル、請求を使う場合もあります。テキストチャットが動作しても、メディアツールを利用できるとは限りません。
1537
1538![内蔵の Kun Persona と外観プラグインカードを表示する Mode workshop](/docs-media/screenshots/image-workshop-en.webp)
1539
1540*Mode workshop は画像素材を使用しますが、アプリケーションの外観を変更するもので、AI 画像生成の経路には含まれません。*
1541
1542- このページでは Default Kun、Retroma、または信頼できる宣言型外観パッケージを選びます。画像生成 Provider は必要ありません。
1543- Persona を変えても、Vision、画像生成、ファイルツールは Agent に追加されません。
1544- 外観パッケージを生成メディアと考えず、実際のメディア機能は以下の Settings セクションで設定してテストしてください。
1545
1546## 5 つの機能経路を区別する
1547
1548| 機能 | ユーザーの入口 | 必要な設定 | 結果 |
1549| --- | --- | --- | --- |
1550| 画像の理解 | Composer に画像を追加 | Vision を有効にした Chat モデル | モデルが画像を読む |
1551| 音声入力 | Composer のマイク | Speech to text またはローカル Whisper | テキストが Composer に入力される |
1552| 画像生成 | Agent、Design、Write、Loop | Image Provider とモデル | 画像ファイル |
1553| 音声と音楽 | Agent のメディアツール | TTS または Music Provider | 音声ファイル |
1554| 動画生成 | Agent のメディアツール | Video Provider、モデル、Job の選択肢 | 動画ファイル |
1555
1556画像と PDF の入力については、[Composer、添付ファイル、コンテキスト](/docs/composer-attachments-and-context)を参照してください。このガイドではメディアツールとその設定に焦点を当てます。
1557
1558## 最初に既定値と実効範囲を確認する
1559
1560すべてのメディア機能は既定でオフです。現在のリリースで Settings から設定でき、実際に反映される主な値は次のとおりです。
1561
1562| 機能 | 現在の既定値 | 値または実効範囲 |
1563| --- | --- | --- |
1564| Image | OpenAI Images、Auto 品質、**1K** 解像度、180 秒 | Auto / Low / Medium / High 品質。Auto / 1K / 2K 解像度。カスタム \`WxH\`。タイムアウト 10 から 600 秒 |
1565| STT | 初回有効化時は Local Whisper Small、自動言語、60 秒 | Auto / zh / en / ja / ko。リモートタイムアウト 5 から 600 秒 |
1566| TTS | OpenAI Speech、MP3、120 秒 | MP3 / WAV / FLAC。タイムアウト 10 から 600 秒 |
1567| Music | MiniMax Music、MP3、300 秒 | MP3 / WAV / FLAC。タイムアウト 10 から 900 秒 |

1568| Video | MiniMax Video、6 秒、1080P、900 秒のタイムアウト、10 秒の Polling | 長さ 1 から 30 秒。768P / 1080P。タイムアウト 30 から 1800 秒。Polling 1 から 60 秒 |
1569
1570> 注: 現在のメディアページでは、TTS、音楽、動画について、ランタイムの実効上限を超える値を入力できます。たとえば画面上の最大値は TTS が 900 秒、音楽が 1800 秒、動画タイムアウトが 3600 秒、Polling が 120 秒ですが、設定の適用時にはそれぞれ 600、900、1800、60 秒に制限されます。値が元に戻ったり誤解されたりしないよう、上の表を使用してください。
1571
1572## 画像生成を設定する
1573
1574![画像生成の Provider、モデル、出力設定](/docs-media/screenshots/media-image-settings-en.webp)
1575
1576*Settings → Media generation では、画像の既定値を通常の Chat モデルと分けて設定します。*
1577
1578- 互換性のある Provider と画像モデルを選び、サイズ、形式、品質の既定値を確認します。
1579- Design、Agent、Loop で設定を使う前に、小さなリクエストでテストします。
1580- モデルの利用可能性、モデレーション、コスト、正確な寸法は外部サービスの条件に従います。
1581
1582Settings → Media generation を開きます。画像生成を有効にし、画像モデルを宣言する Provider を選びます。設定済み Provider が一致しない場合は、カスタム Endpoint を選びます。カスタム接続にはプロトコル、Base URL、API キー、Model ID が必要です。
1583
1584品質、既定の解像度またはサイズ、タイムアウトも設定できます。既定の解像度は Auto ではなく **1K** です。カスタムサイズで使えるのは \`auto\` または \`1024x1024\` のような \`widthxheight\` だけです。不正な値は消去され、解像度 Tier へフォールバックします。既定値は Agent が値を指定しない場合にだけ適用されます。通常、高品質・高解像度ほど待ち時間、ファイルサイズ、コストが増えます。Design の AI 画像スロット、Write のインフォグラフィック、Loop の画像ノードは、すべてこの経路が正常であることに依存します。
1585
1586カスタム画像 Endpoint では OpenAI Images、MiniMax Image、Codex Responses Image を使用できます。設定済み Provider を選ぶと、画像プロトコル、Base URL、認証情報、モデルの選択肢を継承します。Custom Image API に戻すと、以前入力したカスタムフィールドが復元されます。
1587
1588> 重要: サービスが同じ ID を互換性のある画像プロトコルから明示的に公開している場合を除き、通常の Chat Model ID を画像モデルのフィールドに入力しないでください。
1589
1590## 音声文字起こしを設定する
1591
1592![有効状態、リモート Provider、モデル、言語、Test を表示する Speech-to-text 設定](/docs-media/screenshots/media-stt-settings-en.webp)
1593
1594*画像は有効なリモート ASR 経路を示しています。内蔵テスト音声を送る前に、Provider、モデル、言語を確認してください。*
1595
1596- 選択した設定済み Provider は音声をそのサービスへ送ります。Test が確認するのは認証情報、モデルの Routing、接続であり、マイク権限ではありません。
1597- Provider コントロールで Local Whisper を選ぶこともできますが、オフライン文字起こし前にモデルファイルが Ready と表示される必要があります。
1598- 文字起こし結果はテキスト入力です。指示として送信される前に確認してください。
1599
1600Settings → Speech to text を有効にすると、音声入力フローを利用できます。次のソースのいずれかを選びます。
1601
1602- **Local Whisper:** STT の初回有効化時に既定で選択されます。ダウンロード後はオフラインで文字起こしできます。既定ソースは Hugging Face、既定モデルは推奨の Whisper Small (Q5_1) です。HF-Mirror と HF CDN も確認して選択できます。
1603- **Configured Provider:** 音声モデルと認証情報を宣言する Provider を再利用します。
1604- **Custom speech API:** OpenAI Transcriptions または MiMo ASR を選び、Base URL、専用の API キー、モデルを入力します。
1605
1606ローカルモデルの選択肢は次のとおりです。ダウンロードサイズは UI に表示される概算値です。
1607
1608| モデル | ダウンロード | メモリの目安 | CPU スレッド | トレードオフ |
1609| --- | --- | --- | --- | --- |
1610| Whisper Base (Q5_1) | 約 57 MB | 100 から 300 MB | 1 から 2 | 最小のリソース、基本的な品質 |
1611| **Whisper Small (Q5_1)** | 約 181 MB | 300 から 600 MB | 2 から 4 | 推奨の既定値。品質とリソースのバランス |
1612| Whisper Medium (Q5_0) | 約 514 MB | 800 から 1200 MB | 4 から 8 | より高品質、最も多いリソース使用 |
1613
1614ページには Missing、Downloading、Ready、Error が表示され、ソースの確認、ダウンロード、キャンセル、削除ができます。モデルを選んでもインストールはされません。オフライン利用前に Ready と表示される必要があります。
1615
1616言語は Auto のままにするか、\`zh\`、\`en\`、\`ja\`、\`ko\` を選ぶと曖昧さを減らせます。リモートタイムアウトの既定は 60 秒で、5 から 600 秒を受け付けます。録音前に内蔵テストを実行し、その後 OS のマイク権限を許可します。テストが送信するのは認証、Base URL、モデルの Routing を確認するための 0.5 秒ã

1616® Tone だけです。文字起こしが空でも接続が動作している場合があります。テストは成功するのに録音が動かない場合は、最初にマイク権限を確認してください。
1617
1618## 音声と音楽の生成を設定する
1619
1620![Music と Video の個別スイッチ、Providers、モデル、出力の既定値を表示する Media generation 下部の設定](/docs-media/screenshots/media-audio-video-settings-en.webp)
1621
1622*画像は Music と Video に焦点を当てています。その上の Speech グループには独自のスイッチ、Provider、モデル、形式、タイムアウトがあります。*
1623
1624- 画像のグループでは Music と Video を個別に有効化します。一方の成功によって他方は設定されません。
1625- 使用する機能にだけ TTS、Music、Video を設定し、それぞれ別に Provider とモデルを確認します。
1626- 長時間または高価な生成の前に、Voice、長さ、形式、出力場所を確認します。
1627- 生成出力は外部 Provider に送られる場合があり、そのコンテンツとライセンス条件に従います。
1628
1629Speech generation を有効にすると \`generate_speech\` が登録されます。Provider または Custom API を選び、プロトコル、モデル、Voice、出力形式、タイムアウトを確認します。カスタムプロトコルは OpenAI Speech、MiniMax T2A、MiMo TTS です。出力の既定は MP3、タイムアウトは 120 秒で、実効範囲は 10 から 600 秒です。Voice の値はサービス固有で、あるモデルの名前が別のモデルでは使えない場合があります。
1630
1631Music generation を有効にすると \`generate_music\` が登録されます。現在のカスタムプロトコルは MiniMax Music です。出力の既定は MP3、タイムアウトは 300 秒で、実効範囲は 10 から 900 秒です。歌、器楽、カバーへの対応は選択したモデルによって異なります。宣言されていない編集機能を想定せず、目的、長さ、スタイル、歌声が必要かを指定してください。
1632
1633TTS と Music はどちらも MP3、WAV、FLAC に対応します。この設定はリクエスト上の希望で、最終的な Container と Encoding は Provider の実際の対応状況に依存します。
1634
1635## 動画生成を設定する
1636
1637Video generation を有効にすると \`generate_video\` が登録されます。サービスによっては、Text-to-Video または開始・終了の参考 Frame に対応します。現在のカスタムプロトコルは MiniMax Video です。長さの既定は 6 秒で、1 から 30 秒を受け付けます。解像度の既定は 1080P で、768P も利用できます。全体のタイムアウトは既定で 900 秒、実効範囲は 30 から 1800 秒です。Polling は既定で 10 秒、実効範囲は 1 から 60 秒です。
1638
1639動画生成は一般的に非同期です。結果パネルを閉じても、Provider 側の Job がキャンセルされるとは限りません。Polling が短すぎるとリクエストが増え、タイムアウトが短いと素材の準備前に待機を終了する場合があります。参考画像も選択した Provider へ送信されます。
1640
1641## Agent、Write、Design、Loop でメディアを使う
1642
1643スイッチを有効にしても、ツールを登録可能にするだけです。実行できるかどうかは、現在の Agent のツールポリシー、Provider の状態、タスク境界によって引き続き制御されます。依頼には目的、形式、寸法または長さ、スタイルの制約、送信先を含め、テキスト要約だけを信頼せず生成されたファイルを確認してください。
1644
1645- **Design**: AI 画像スロット用のビジュアル方向性、素材、コンテンツを作成。
1646- **Write**: イラスト、インフォグラフィック、付随メディアを作成。
1647- **Code**: ワークスペース内に管理された製品素材を作成。
1648- **Loop**: メディアノードを前処理、条件、出力へ接続。
1649
1650## コスト、プライバシー、トラブルシューティング
1651
1652リモートのメディアリクエストは、プロンプトと添付した元資料をその Provider へ送り、別途請求される場合があります。人物写真、顧客資料、未公開コンテンツを送る前に、権限と Provider の規約を確認します。API キーをチャットやワークスペースファイルへ決して入れないでください。Provider Profile のキーは対応環境では保護された認証情報ストレージを使いますが、メディアページの Custom API に入力したキーは通常のローカル設定です。同等の保護があると考えず、Sett

1652ings のエクスポートまたはバックアップ前にカスタムキーを削除してください。
1653
1654次の順序でトラブルシューティングします。有効状態 → Provider の認証情報 → プロトコルと Base URL → モデル機能 → タイムアウト → ツール権限。テキストは動作するのにメディアが失敗する場合は、Chat モデルを繰り返し変えるのではなく、対応するメディア経路をテストしてください。詳しくは[トラブルシューティング](/docs/troubleshooting)と[Provider とモデル](/docs/providers-and-models)を参照してください。
1655`,h=`---
1656slug: mode-and-tool-settings
1657lang: ja
1658group: settings
1659order: 30
1660status: published
1661updatedAt: 2026-07-17
1662keywords: Write 設定 | Design 設定 | Terminal 設定 | 自動保存 | インライン補完 | タイポグラフィ | デザイン引き継ぎ | ANSI
1663title: Write、Design、Terminal の設定
1664description: Write のワークスペース、保存、インライン候補と選択ツール、Design の引き継ぎとキャンバスの既定値、Terminal の色を設定します。
1665---
1666
1667これらのグループでは Settings のヘッダーに保存状態が表示され、通常の編集は入力を止めてから約 450 ms 後に自動保存されます。既定値と記載された選択肢は主に、その後に開く、または作成するコンテキストに影響します。編集中のファイルや実行中のコマンドについては、現在のワークスペースに表示される状態を使用してください。
1668
1669![ワークスペースルート、自動保存、ドキュメント動作を表示する Write 設定](/docs-media/screenshots/settings-write-en.webp)
1670
1671*Settings → Write では、Writing Space とドキュメント保存の既定値を設定します。*
1672
1673- 重要なドキュメントを開く前に、管理対象の執筆ルートと自動保存動作を設定します。
1674- ヘッダーの保存状態を確認してください。Settings の自動保存とドキュメントの自動保存は別の操作です。

1675- 該当コントロールに明記されていない限り、既定値を変えても開いているファイルは移動または書き換えられません。
1676
1677## Write: ワークスペースとドキュメントの自動保存
1678
1679Settings の自動保存と Write ドキュメントの自動保存は別です。前者は設定を保持し、後者は編集中のドキュメントをディスクへ書き戻します。
1680
1681| 設定 | 範囲と既定値 | 意味 |
1682| --- | --- | --- |
1683| Default writing space | 既定は \`~/.kun/write_workspace\` | Write が最初に開くディレクトリ。変更するとそのディレクトリが有効になり、スペース一覧にも保持 |
1684| Document autosave | 既定でオン | オフの場合、Write で手動保存 |
1685| Autosave delay | 5 から 1800 秒まで 5 秒刻み。既定は 180 秒 | 編集がこの時間行われなかった後にディスクへ書き込み |
1686
1687別のプログラムが同じファイルを変更した場合は、続行前に競合を解決してください。Writing Space は通常のフォルダーで、クラウド同期やバージョン管理ではありません。重要な下書きは Git、バージョン管理付きクラウドドライブ、その他のバックアップシステムに保存します。
1688
1689## Write: タイポグラフィ
1690
1691| 設定 | 選択肢と既定値 | 効果 |
1692| --- | --- | --- |
1693| Font | System、Source Han Sans、Microsoft YaHei、PingFang、SimHei、SimSun、KaiTi、Custom。既定は System | Custom では CSS の \`font-family\` スタックを指定可能 |
1694| Font size | 10 から 48px まで 1px 刻み。既定は 16px | Write のエディターとプレビューに影響 |
1695| Line height | 1.4 から 2.2 まで 0.05 刻み。既定は 1.75 | 文章の密度を変更 |
1696
1697Reset typography はフォント、サイズ、行の高さだけをリセットし、ドキュメントは削除しません。タイポグラフィ設定によってエクスポートにフォントファイルが埋め込まれるわけではありません。受信者が選択したフォントを持たない場合、設定済みスタックのフォールバックが使用されます。
1698
1699## Write: インライン候補
1700
1701![Write のインライン候補設定とモデルコントロール](/docs-media/screenshots/settings-write-inline-en.webp)
1702
1703*展開した画像では、候補が有効で Provider / モデルを継承し、ドキュメント参照、650 ms の Balanced 速度、推奨頻度、96 文字の短い補完、256 文字の段落補完が設定されています。*
1704
1705- 継承した Provider / モデルは、対象の作業に対応する場合にだけ維持します。認証情報は Provider ページに残ります。
1706- 展開されたコントロールを 1 つずつ調整します。短い遅延と広い頻度は呼び出しを増やし、2 つの長さ上限は短い候補と段落候補を制限します。
1707- 候補は下書きです。意味、事実、トーンを確認してから、表示された操作で採用してください。
1708
1709インライン候補は既定でオンです。エディターに灰色の補完テキストが表示され、\`Tab\` で採用、\`Esc\` で非表示にできます。詳しい操作は[Write モードを使う](/docs/write)を参照してください。
1710
1711| 設定 | 選択肢と既定値 | 効果 |
1712| --- | --- | --- |
1713| Provider | 既定では現在の AI assistant Provider を継承。設定済みの別 Provider も選択可能 | 認証情報をここへ再入力せず、Provider ページで管理 |
1714| Model | 既定では現在の Assistant モデルを継承。継承元がない場合は \`deepseek-v4-flash\` にフォールバック | Provider のモデルを選ぶかカスタム Model ID を入力 |
1715| Reference workspace documents | 既定でオン | Writing Space 内の別の Markdown ファイルをキーワード / BM25 で検索。ベクトルインデックスは作成しない |
1716| Trigger delay | 300 / 650 / 1000 / 1500ms。既定は 650ms | 短いほど頻繁にリクエストを送信 |
1717| Acceptance threshold | 0.38 / 0.52 / 0.68 / 0.82。既定は 0.52 | 高いほど厳密になり、信頼度の低い候補を多く抑制 |
1718| Short maximum tokens | 16 から 512 まで 8 刻み。既定は 96 | 通常の補完の長さとコストを制限 |
1719| Paragraph inspiration | 既定でオン | 境界で長く停止した後、より長いアイデアを提示可能 |
1720| Paragraph maximum tokens | 64 から 1024 まで 16 刻み。既定は 256 | 長い候補の長さとコストを制限 |
1721
1722別の Provider またはモデルを選んでも、変更されるのは Write のインライン候補だけで、メイン Agent のモデルは置き換わりません。通常、遅延を短くし、しきい値を下げ、トークン上限を上げると、リクエスト頻度、待ち時間、コストが増えます。最初に機密性のない下書きで変更をテストしてください。
1723
1724## Write: 選択ツールと Writing Agents
1725
1726選択ツールには、インフォグラフィック生成、UI デザインの下書き生成、インタラクティブ HTML プロトタイプ生成の 3 つの上書きプロンプトがあります。ç©

1726ºã®ãƒ•ã‚£ãƒ¼ãƒ«ãƒ‰ã§ã¯å†…蔵プロンプトを使用します。各上書きには最大 4,000 文字を保存できます。
1727
1728クイック操作は最大 12 個です。新規インストールでは Polish、Explain、Reformat、Distill、Bolder、Quieter、Critique の 7 つがあります。各操作は次の 2 モードのいずれかを使います。
1729
1730- **Edit in place**: 選択範囲を置き換える前に、モデル出力をレビュー用の赤・緑の差分で表示します。
1731- **Send to assistant**: 選択範囲と指示を Write サイドバーの会話へ渡します。
1732
1733クイック操作は追加、削除、既定値への復元ができます。ラベルまたはプロンプトが空なら内蔵コピーを使います。既定値への復元では、現在のクイック操作と 3 つのカスタム上書きプロンプトがすべて置き換わります。
1734
1735カスタム Writing Agent の一覧は既定で空で、最大 12 件を登録できます。各 Agent には絵文字、40 文字までの名前、4,000 文字までの Persona / 動作プロンプトがあります。これは再利用可能なプロンプトであり、権限のサンドボックスではありません。ファイル書き込みと外部ツールは、現在のワークスペースと Agent ポリシーに引き続き従います。
1736
1737## Write: 診断記録
1738
1739候補ログとテキスト編集診断には、送信したコンテキスト、モデルの生出力、解析結果が表示されるため、ドキュメント本文を含む場合があります。トラブルシューティングのためだけに開き、完全なスクリーンショットを公開せず、不要になった機密記録を消去してください。
1740
1741## Design: Code への引き継ぎ
1742
1743![引き継ぎと Code ワークスペースの既定値を表示する Design 設定](/docs-media/screenshots/settings-design-en.webp)
1744
1745*Design 設定は、採用した成果物を Code への引き継ぎ用に準備する方法を決めます。*
1746
1747- 成果物を実装へ送る前に、対象の動作とワークスペースを意図的に選びます。
1748- 引き継ぎはコンテキストと成果物を渡しますが、レスポンシブ動作や本番準備の完了を証明しません。
1749- 名前の似たワークスペースや worktree が複数ある場合は、送信先プロジェクトを再確認します。
1750
1751現在の Design Settings ページにあるのは、引き継ぎ、キャンバス、ワークスペースのコントロールだけです。非表示のブランド、モデル、プロンプトのフィールドはありません。
1752
1753| 設定 | 既定値 | 意味 |
1754| --- | --- | --- |
1755| Target stack | 空、最大 200 文字 | Implement with Code に \`React + Tailwind + shadcn/ui\` などのヒントを与える。空の場合は Kun がプロジェクトを調査 |
1756| Have the Code Agent follow the design system | オン | 公開済みデザイン仕様を実装コンテキストへ追加 |
1757| Publish \`DESIGN_SYSTEM.md\` | オン | 引き継ぎ時にデザインシステムファイルをワークスペースへ書き込み可能にする |
1758
1759これらのスイッチはリポジトリのルールを上書きせず、アクセシビリティやデバイス互換性を証明しません。引き継ぎ前に、送信先、フレームワーク、必須項目を確認します。完全なワークフローは[Design モードを使う](/docs/design)を参照してください。
1760
1761## Design: キャンバスとワークスペース
1762
1763| 設定 | 選択肢と既定値 | 意味 |
1764| --- | --- | --- |
1765| Default viewport | Mobile、tablet、desktop。既定は Desktop | 新しいキャンバスの初期サイズ |
1766| Default view | Preview または Code。既定は Preview | 最初に開く側 |
1767| Canvas background | Light または dark。既定は Light | 表示用の背景だけを変更 |
1768| Live refresh | 既定でオン | Agent または外部ファイルの更新に応じてプレビューを更新 |
1769| Device frame | 既定でオン | Mobile / tablet に表示用フレームを表示。実機検証ではない |
1770| Default design workspace | 既定は空 | 空の場合、現在の Code / Write フォルダーではなく Kun 内蔵の独立した Design ワークスペースを使用。指定パスは新しい Design コンテキストに適用 |
1771
1772Live refresh がオフの場合、外部変更を見るには手動で再読み込みします。\`.kun-design\` 成果物を現在のプロジェクトに置くには、そのプロジェクトディレクトリを明示的に選択してください。既定ディレクトリを変えても既存の成果物は移動しません。切り替え後に Design へ入り直し、現在のドキュメントの場所を確認します。
1773
1774## Terminal の色
1775
1776![ANSI パレットと表示コントロールを備えた Terminal 設定](/docs-media/screenshots/settings-terminal-en.webp)
1777
1778*Terminal 設定が影響するのはコマンド出力の表示であり、Shell の実行ポリシーではありません。*
1779
1780- 有効なテーマ上で出力を読みやすくするため、ANSI パレットを調整します。
1781- カスタマイズ後もエラー、警告、差分の色を区別できることを確認します。
1782- 色を変えても、失敗したコマンド、存在しない Shell、不足している権限は解決しません。
1783
1784Terminal 設定は表示だけを制御します。**Shell、起動コマンド、環境変数、作業ディレクトリは設定しません。**
1785
1786| モード | 動作 |
1787| --- | --- |
1788| Follow application（既定） | アプリの Light / Dark テーマ用の内蔵 Terminal パレットを使い、ANSI 色を維持 |
1789| No color | モノクロ出力のため、基本色と拡張 ANSI 色を前景色に変換 |
1790| Custom | 前景、背景、カーソル、選択背景、16 色すべての ANSI 色を設定 |
1791
1792カスタム色には \`#rgb\`、\`#rrggbb\`、アルファ付き \`#rrggbbaa\` を指定できます。初期のカスタム Dark 値は前景 \`#e6e9ef\`、背景 \`#151d31\`、カーソル \`#e6e9ef\`、選択 \`#264f78aa\` と、内蔵の ANSI 16 色パレットです。Reset で Follow application に戻ります。
1793
1794色は Shell、コマンド環境、出力テキスト、終了コードを変えません。赤色が常にエラーとは限らず、モノクロも成功の証明ではありません。操作については[Terminal、プレビュー、worktree](/docs/terminal-browser-and-worktrees)を参照してください。
1795
1796## 安全に設定を調整する
1797
1798一度に 1 グループを変更し、無害なテストを実行します。候補の品質がずれた場合は、最初に Provider / モデルの継承、650ms の遅延、0.52 のしきい値、既定のトークン上限を復元します。Design の引き継ぎがずれた場合は Stack のヒントを消去します。Terminal 出力が読みづらい場合は Follow application に戻します。Write の診断記録を、内容を含まない通常のログであるかのように共有しないでください。
1799`,w=`---
1800slug: plugins-skills-extensions
1801lang: ja
1802group: integrations
1803order: 20
1804status: published
1805updatedAt: 2026-07-17
1806keywords: plugin | MCP | Skill | Extension | kunx | OAuth | 権限
1807title: MCP、Skills、Extensions、外観
1808description: Kun の 4 つの拡張システムを区別し、インストール前にソース、権限、スコープ、ランタイムのリスクを確認します。
1809---
1810
1811Kun には名前が似ていても異なる 4 つの拡張システムがあります。MCP は外部ツールを接続し、Skill は再利用可能な作業方法を提供し、\`.kunx Extension\` は画面、Agent、ツール、Provider、アカウント機能を追加でき、外観プラグインは Kun の人格と装飾だけを変更します。インストール経路、権限、ランタイムには互換性がありません。
1812
1813[実際の Extension 画面のウォークスルー](/docs-media/ikun-ui-plugin.mp4)
1814
1815## MCP
1816
1817![設定済み MCP サーバーを表示する Plugins ページ](/docs-media/screenshots/plugins-mcp-en.webp)
1818
1819*MCP ビューには外部ツールサーバーと接続状態が表示されます。*
1820
1821- **Plugins → MCP** から入り、サーバーの追加、確認、有効化、無効化を行います。
1822- Agent で有効にする前に、コマンド、エンドポイント、環境、公開されるツールを確認します。
1823- 接続済みサーバーは利用可能なツールを増やしますが、そのサーバー自身の認証情報と Kun の権限ポリシーによって引き続き制限されます。
1824
1825MCP サーバーにより、エージェントは Browser、コードホスト、検索サービス、ナレッジベース、その他のツールを利用できます。Plugins では推奨項目を閲覧し、ローカルの \`stdio\` サーバーまたはリモートの Streamable HTTP サーバーを追加できます。接続状態とツール数を確認し、接続の有効化、無効化、検索、更新ができます。アカウント認証が必要な Connector は OAuth フローを開きます。リモートサーバーには HTTPS を使用してください。
1826
1827インストール前に、接続先サービス、読み取れるデータ、書き込み可能かを確認します。OAuth 中に表示される権限は境界の一部にすぎず、外部アカウント自体の権限も影響します。\`stdio\` コマンドは現在の OS ユーザーとして実行され、環境変数とリクエストヘッダーにはシークレットが含まれる場合があります。
1828
1829> 機密設定: MCP の環境変数とヘッダーは \`~/.kun/mcp.json\` に平文で保存さã

1829‚Œã¾ã™ã€‚そのファイル、完全な診断情報、シークレットを含むスクリーンショットを共有せず、ローカルアカウントとそのバックアップへのアクセスを保護してください。
1830
1831## Skills
1832
1833![インストール済み Skills とソース詳細を表示する Plugins ページ](/docs-media/screenshots/plugins-skills-en.webp)
1834
1835*Skills は再利用可能な指示パッケージであり、バックグラウンドサービスではありません。*
1836
1837- **Plugins → Skills** から入り、インストール済みパッケージ、スコープ、ソースを確認します。
1838- Skill のワークフローがタスクに合う場合に使用し、機密性の高い作業を任せる前に要求される操作を読みます。
1839- Skill をインストールしても、Provider、MCP サーバー、画面の Extension が自動追加されるわけではありません。
1840
1841Skill はエージェント向けの指示、スクリプト、リソースの集合です。スラッシュコマンドとして表示されたり、一致するタスクで自動使用されたりします。Skills の検出、更新、有効化、無効化、作成、GitHub からのインポートができます。有効な Skill コマンドは内蔵コマンドとともに表示され、メニューには最大 40 件が表示されます。
1842
1843Kun は優先順にプロジェクトとグローバルのルートを検出します。\`.agents\`、\`.claude\`、\`.codex\`、\`.kun\`、\`skills/\` の場所、Codex プラグインキャッシュ、設定した追加ディレクトリが含まれます。名前が重複する場合は、現在のワークスペースに表示されたソースを正しいものとして扱います。
1844
1845Skill を有効にする前に、特にスクリプト、コマンド、外部アクセスを読んでください。プロジェクト Skill はリポジトリとともに配布され得ますが、プロジェクト内に置かれていることは安全性の証明にはなりません。
1846
1847## \`.kunx\` Extensions
1848
1849![インストール済みと利用可能な Kun Extension を表示する Extensions Center](/docs-media/screenshots/extensions-center-en.webp)
1850
1851*Extensions は、画面とランタイム機能を追加できる \`.kunx\` パッケージ専用の独立したセンターです。*
1852
1853- サイドバーの **Extensions** から入り、パッケージの識別情報、ソース、権限、有効状態を確認します。
1854- Extension の画面上の指示で必要とされる場合だけ再起動または再読み込みし、新しい項目や設定を確認します。
1855- ソースや権限の根拠を確認できない Extension は削除または無効にします。外観プラグインと同じものではありません。
1856
1857Extensions はより包括的なシステムで、主要な入口は Plugins 一覧ではなくサイドバーの **Extensions** です。Extension Center には Installed、Install、Diagnostics のビューがあり、Extension をグローバルまたはワークスペース単位で有効にできます。Extension は左右のサイドバー、エディタータブ、全画面ページ、トップバー、Composer とメッセージの操作、コマンド、メニュー、プレビュー、Agents、ツール、Providers を追加できます。Manifest が機能を提供する場合にだけ、その項目が表示されます。
1858
1859ローカルの \`.kunx\` ファイル、開発ディレクトリ、カスタムインデックスのバージョンをインストールする前に、公開者、正確なバージョン、要求される権限を確認します。Node Extension は信頼された OS コードとして実行され、表示された権限一覧は OS のサンドボックスではありません。Direct DOM アクセスは画面環境に直接到達できるため、より高いリスクがあります。
1860
1861Extension が **Settings → Extensions** に表示されるのは、Manifest が設定を提供する場合だけです。JSON Schema から Boolean、enum、number、string、array、object のコントロールを生成でき、値はグローバルまたは現在のワークスペーススコープを使用できます。パスワード、トークン、シークレットに見えるフィールドは通常の平文入力として表示されず、Extension は Account API を通じてそれらの認証情報を管理すべきです。編集前に現在のスコープを確認し、ワークスペース値をすべてのプロジェクトで共有される設定と取り違えないようにします。
1862
1863Extension のソースによっては自動アップデート確認が提供されません。アップグレード時に権限を再確認し、問題が起きたら診断、ログ、ロールバック情報を使用します。Extension をアンインストールしても、作成したデータが保持される場合があります。
1864
1865## Mode workshop と外観プラグイン
1866
1867![Kun の人格と外観パッケージのカードを表示する Mode workshop](/docs-media/screenshots/image-workshop-en.webp)
1868
1869*Mode workshop はマスコットと画面装飾のパッケージを選びます。画像を生成したり Agent ツールを公開したりはしません。*
1870
1871- Default Kun、Retroma を選ぶか、信頼できる宣言型の外観フォルダーをインストールし、目的のカードをプレビューして有効にします。
1872- パッケージを削除するとインストール済みコピーが消えるため、再インストールする可能性がある場合は元ディレクトリを保管します。

1873- 外観の出力はツールをインストールせず、モデル機能を追加せず、ランタイム権限も付与しません。
1874
1875**Settings → Mode workshop** は、内蔵の Default Kun と Retroma の人格、および \`~/.kun/ui-plugins\` にインストールされた外観プラグインを管理します。外観パッケージは宣言型のビジュアルコンテンツで、プラグインコードは実行しません。変更するのはマスコットや画面装飾だけで、Agent ツールを追加したり、MCP や Node Extension の機能を受け取ったりしません。ソースは引き続き信頼できる必要がありますが、外観パッケージを Skill、MCP サーバー、\`.kunx\` Extension と混同しないでください。
1876
1877## 最小限の仕組みを選ぶ
1878
1879- 外部ツールの接続には MCP を使います。
1880- 指示、手順、スクリプトの再利用には Skill を使います。
1881- より包括的な UI、アカウントシステム、Provider 連携に限って Extension を検討します。
1882- Kun のビジュアル上の人格だけを変える場合は Mode workshop を使います。
1883
1884どの仕組みでも、最小権限、信頼できるソース、機密性のないワークスペースでの最初のテストを優先してください。[ワークスペースの権限とセキュリティ](/docs/workspace-permissions-security)を参照してください。
1885`,k=`---
1886slug: providers-and-models
1887lang: ja
1888group: integrations
1889order: 10
1890status: published
1891updatedAt: 2026-07-17
1892keywords: Provider | モデル | API キー | Token Plan | Base URL | Vision | Tools | Reasoning
1893title: Provider とモデルを設定する
1894description: 自分のキーや互換サービスを安全にテストしながら、Provider、エンドポイント、モデル、機能の宣言を理解します。
1895---
1896
1897Kun はユーザーが設定したモデルサービスを使用します。**Provider** は接続情報、認証情報、プロトコルのルールを保存します。**Model** はその接続を通じて実際に呼び出されるモデルです。**Capabilities** は、モデルが画像を見られるか、ツールを使えるか、推論コントロールを受け付けるかを Kun に伝えます。
1898
1899![接続フィールドを表示する Provider 一覧とエディター](/docs-media/screenshots/provider-list-editor-en.webp)
1900
1901*Settings → Providers では、一覧内の保存済みサービスと、選択した Provider の編集可能な接続情報が分かれています。*
1902
1903- 既存のプリセットを選ぶか、互換性のあるカスタムサービスを追加し、必要なエンドポイントと認証情報のフィールドだけを入力します。
1904- Provider を既定値として選ぶ前に **Test Connection** を使用します。
1905- スクリーンショットや診断でキーを公開せず、接続成功が Tools または Vision への対応を証明すると考えないでください。
1906
1907## 内蔵またはカスタム Provider を使う
1908
1909初回起動フローでは DeepSeek、Xiaomi MiMo、MiniMax が提示されます。Settings → Providers には追加のオプトインプリセットが表示される場合があり、互換サービスまたはセルフホストサービスも追加できます。プリセットは開始点です。利用可能性について正しい情報源となるのは、Provider の管理画面と現在のアカウントです。
1910
1911Provider 一覧では接続の作成、編集、テスト、削除ができ、既存項目へ更新済み公式プリセットを適用できます。削除前に、既定の Agent、Write、Design、Schedule、Claw、サブエージェント、メディアでの参照を確認してください。ローカル接続を削除しても、Provider のアカウントは削除されず、サーバー側のキーも無効になりません。
1912
1913## ChatGPT または Claude のサブスクリプションでログインする
1914
1915サブスクリプション Provider は独自のログインフローを使い、通常の API キー接続とは異なります。
1916
1917| Provider の経路 | ログイン方法 | 重要な境界 |
1918| --- | --- | --- |
1919| **Codex / ChatGPT** | Codex Provider を選び、**Log in to ChatGPT** を選択します。Browser のコールバックログインが利用できない、またはローカルポートが使用中の場合は、**Use device code instead** を使い、表示された確認ページを開いて 1 回限りのコードを入力します。 | 保存さã

1919‚ŒãŸ OAuth 認証情報はログインした ChatGPT アカウントに属します。Disconnect は Kun のローカル認証情報を消去します。サーバー側で無効にする必要がある場合は、アカウントのセキュリティコントロールを使います。 |
1920| **Claude Pro/Max subscription** | Agent SDK サブスクリプション Provider を選びます。ページで不足が報告された場合はサブスクリプションランタイムをダウンロードし、**Log in / get subscription token** を選びます。Kun は既存の Claude Code ログインの検出、\`claude setup-token\` の実行、手動で貼り付けたトークンの受け付けができます。 | 公式 Claude Agent SDK を通じて自分のサブスクリプションを使用します。Anthropic API の請求とは異なり、現在の規約と利用可能なモデルについては Provider の情報が正しいものとなります。 |
1921
1922![Browser ログインとデバイスコードの代替手段を表示する ChatGPT サブスクリプション Provider](/docs-media/screenshots/provider-codex-auth-en.webp)
1923
1924*ChatGPT サブスクリプション接続には、通常の API キーフィールドではなく専用の OAuth フローがあります。*
1925
1926- Browser コールバックには **Log in to ChatGPT** を優先し、そのコールバックを利用できない場合にだけデバイスコードの経路を使います。
1927- 画像は意図的にログイン前で止めています。有効なデバイスコード、アカウント情報、ログイン完了状態を決して共有しないでください。
1928
1929![ログイン、setup-token、手動トークンの選択肢を表示する Claude Pro または Max サブスクリプション Provider](/docs-media/screenshots/provider-claude-auth-en.webp)
1930
1931*Claude サブスクリプションページでは、既存の Claude Code ログイン、\`claude setup-token\`、任意の手動貼り付けが区別されています。*
1932
1933- ローカルログインが検出されない場合は、ログインまたは setup-token のフローを開始し、その後 **Re-check** を使います。
1934- 手動でのトークン貼り付けは代替手段です。録画、ログ、Composer、ワークスペースファイルにトークンを含めないでください。
1935
1936Claude ランタイムのダウンロードはバックグラウンドで続行され、ページを開き直すと進捗が復元されます。ログイン後、Kun はサブスクリプションで対応する Model ID を Provider 一覧へ取得できます。手動トークンが空なら、互換性のある既存ホスト CLI ログインを使用できます。取得または貼り付けたトークンがある場合はそちらが優先されます。OAuth 認証情報、setup token、確認コード、アカウント識別子を Composer、ログ、スクリーンショット、プロジェクトファイルへ決して貼り付けないでください。
1937
1938外部ログインを完了するのは、Provider が想定するドメインだけにしてください。1 回限りのデバイスコードも有効な間は機密情報です。ログインに失敗した場合は、別の試行を始める前にその試行をキャンセルし、ローカルのコールバックまたはランタイム状態を再確認します。サブスクリプション認証情報を無関係な API キーで置き換えないでください。
1939
1940## 接続フィールドを理解する
1941
1942- **API Key / Token Plan credential:** アクセス認証情報。2 つの製品種別で同じキーを利用できるとは限りません。
1943- **Base URL:** サービスのベースアドレス。
1944- **Endpoint:** Kun が呼び出すプロトコルのパスまたはリクエスト形式。
1945- **Model ID:** サービスが認識する正確なモデル名。
1946
1947記憶を頼りに URL を組み立てないでください。プロトコルによっては Base URL にバージョンとリソースパスを含み、別のものは Endpoint に置きます。パス部分の重複または欠落によって 404 がよく発生します。プリセットから始め、変更時は Provider の公式手順に従ってください。
1948
1949通常の HTTP 互換サービスと Agent SDK Provider ではランタイムへの接続方法が異なるため、種別を切り替えるとランタイムが自動再起動する場合があります。設定済みプロキシは該当のモデルリクエストに作用しますが、ローカル Terminal やシステム Browser を自動的にプロキシしません。
1950
1951## モデル一覧を管理する
1952

1953Provider には Chat、Image、Speech-to-Text、TTS、Music、Video の 6 種類のモデルを保存できます。正確な ID を手動入力するか、モデル検索に対応する場合は Fetch / Import Models を使い、追加する項目を選びます。検索できても、そのアカウントでモデルを呼び出せる証明にはなりません。依存する各機能をテストしてください。
1954
1955Chat モデルでは、コンテキストウィンドウ、最大出力、Vision、ツール呼び出し、Reasoning、対応する Effort 値と推論プロトコル、モデル単位の Endpoint Format の上書きを宣言できます。上限には Provider のドキュメントを使用してください。実際より大きいコンテキスト値を指定しても本当のウィンドウは広がらず、Kun の Compact 保護が遅れる場合があります。
1956
1957Chat モデルを手動追加すると、フォームの既定値はコンテキストウィンドウ \`128000\`、Tool calling がオン、Vision と Reasoning がオフ、Provider の Endpoint Format です。次を設定できます。
1958
1959- コンテキストウィンドウと最大出力トークン。UI では 32K、64K、128K、256K、1M のショートカット、または正のカスタム値を指定可能。
1960- 画像入力と Tool calling の機能。
1961- 対応する Reasoning effort \`off / low / medium / high / max\`、既定の Effort、リクエストプロトコル。
1962- モデル単位の Endpoint Format の上書きと Alias。
1963
1964Reasoning 機能のエディターには内部の \`auto\` 値が表示されません。プリセットには、UI に意図的に表示されない通信互換性のメタデータも含まれる場合があります。これらの非表示フィールドはユーザー設定ではなく、手動で管理すべきではありません。Image、STT、TTS、Music、Video の項目では主に Model ID を設定し、プロトコルと Base URL は対応する Provider 機能に属します。
1965
1966## モデル機能を宣言する
1967
1968![Tools、Vision、Reasoning のモデル機能コントロール](/docs-media/screenshots/model-capabilities-en.webp)
1969
1970*機能の宣言は、そのモデルが対応すると想定されるコントロールと Payload を Kun に伝えます。*
1971
1972- 正確なモデルと Endpoint が対応する場合にだけ、Tools、Vision、Reasoning を有効にします。
1973- Provider の最新ドキュメントと小さなテストリクエストを証拠として使います。
1974- 機能スイッチは Kun のリクエスト動作を変えますが、リモートモデルにない機能を追加することはできません。
1975
1976モデルが実際に対応する機能を設定します。
1977
1978- 通常のテキスト会話には **Chat**。
1979- アップロード画像の理解には **Vision**。
1980- Agent がファイル、コマンド、その他のツールへアクセスするには **Tools**。
1981- 対応する推論コントロールには **Reasoning**。
1982- 入出力の上限には **Context / Max output**。
1983
1984未対応の機能を選んでも、モデルにその機能は追加されません。リクエスト失敗や不安定な動作を招くだけです。
1985
1986モデルピッカーには通常、現在の画面に適した有効なモデルが表示されます。Vision は画像添付、Tools は Agent への適合性、Reasoning は Effort コントロールの表示を決めます。画像、音声、音楽、動画の設定は、対応するメディアモデル種別を参照します。[メディアと音声の機能](/docs/media-generation)を参照してください。
1987
1988## Token Plan、既定値、ローカルの上書き
1989
1990Provider によっては従量制 API と Token Plan の両方を提供します。認証情報、Base URL、プロトコルが異なる場合があります。通常の API キーを Token Plan フィールドに入れず、設定した接続をアカウントの製品に合わせてください。Plan やリージョンの Badge は設定を助けるだけで、実際の割当量と請求は Provider によって決まります。
1991
1992Agents 設定はグローバルの既定 Provider / モデルを選びます。Composer、Write、Design、Schedule、Claw、サブエージェントはそれを継承または上書きできます。デバッグ時は、グローバルの既定値だけでなく、実際のターンに表示されたモデルを確認してください。
1993
1994## リクエストの再試行を設定する
1995
1996各 HTTP Provider には独自のリクエスト再試行ポリシーがあります。既定はオフ、つまり追加試行 \`0\` 回です。オンにすると最初は \`3\` 回が選ばれ、\`1–10\` 回で調整できます。初期待機時間は \`3000 ms\` で、\`0–600000 ms\` を受け付けます。既定で再試行されるのは HTTP \`429\` と \`503\` だけで、ほかの \`400–599\` ステータスコードも入力できます。
1997

1998回数は**最初のリクエスト後の追加再試行**を意味します。Kun は有効な \`Retry-After\` レスポンスヘッダーを最優先し、なければ小さなランダム揺らぎを伴う指数バックオフを使い、1 回の待機を 10 分以内に制限します。明示的に列挙した一時的な HTTP レスポンスだけを再試行してください。ネットワーク切断、認可失敗、不正なリクエスト、不正なモデル出力を無差別な再試行で隠してはいけません。
1999
2000Streaming リクエストが正常な応答を受けて出力を開始した後は、内容品質の問題でリクエスト全体を再送しません。高価なモデルや副作用を生む可能性がある上流 Gateway では、再試行回数を控えめにしてください。
2001
2002## 接続をテストしてプロキシを設定する
2003
2004保存後に Test Connection を使い、Provider が検索に対応する場合は Fetch Models を使います。基本テストの成功は、すべての機能が動作する証明ではありません。Design で依存する前に、Code で読み取り専用のツール呼び出しを試し、無害な画像で Vision を確認します。
2005
2006ネットワークでプロキシが必要な場合は、Providers の下部でグローバルなモデルリクエスト用プロキシを有効にします。対応 URL スキームは \`http\`、\`https\`、\`socks\`、\`socks4\`、\`socks4a\`、\`socks5\`、\`socks5h\` です。スキームとホスト名は必須で、ポートは省略できます。不正または入力途中の URL はフィールドに残りますが、リクエスト適用時には「プロキシなし」として扱われます。
2007
2008このプロキシは Kun のモデルと関連する Provider 通信に適用されます。内蔵 Terminal、システム Browser、その他のアプリケーションは自動的にプロキシされません。プロキシは End-to-End で保護されていない通信を監視または改変し、送信先やリクエストのメタデータを見られる場合があります。信頼できるものだけを使用してください。
2009
2010画像生成、文字起こし、TTS、音楽、動画は別々の機能です。Provider の認証情報を再利用する場合も、異なるプロトコルとモデルを必要とする場合もあります。テキストモデルが動作しても、メディア機能が設定済みとは限りません。
2011
2012Provider Profile の API キーは、プラットフォームが対応する場合は保護された認証情報ストレージへ移され、UI には Mask された値が表示されます。カスタムの画像、STT、TTS、音楽、動画の API キー、ランタイムトークン、Claw / Telegram の認証情報は通常のローカル設定です。Provider Profile のキーと同じ保護があると考えないでください。Settings のエクスポート、ログ共有、ユーザーデータのバックアップ前に削除してください。
2013
2014保存動作とほかの全カテゴリについては、[設定概要](/docs/settings-overview)を参照してください。
2015
2016一般的な接続失敗については、[トラブルシューティング](/docs/troubleshooting)を参照してください。
2017`,C=`---
2018slug: requirement-workflow
2019lang: ja
2020group: workflows
2021order: 10
2022status: published
2023updatedAt: 2026-07-17
2024keywords: 要件 | SDD | 受け入れ条件 | plan | todo | 要件のドリフト
2025title: 要件から検証まで
2026description: アイデアを要件、デザインコンテキスト、実装計画、Todo、検証可能な結果へと変換します。
2027---
2028
2029Kun の中心的なワークフローは、エージェントに一文を渡してすぐ編集を依頼することから始まりません。意図をレビュー可能な要件に変え、デザイン、計画、実装、検証へ進みます。小さな変更は Code から直接始めても構いません。複数の画面、モジュール、製品判断にまたがるタスクでは、完全なワークフローを使用してください。
2030
2031![Kun Code サイドバーの New Requirement 項目](/docs-media/screenshots/kun-sidebar-tour-en.webp)
2032
2033*New Requirement は New Agent のすぐ下にあり、選択中のプロジェクトで構造化ワークフローを開始します。*
2034
2035- **Code** を開き、**Projects** でプロジェクトを確認してから、**New requirement** を選びます。
2036- 受け入れ条件、調査、デザイン、計画、実装を 1 つの追跡可能なスレッドで扱う必要がある場合に使用します。
2037- 小さく、すでに仕様が決まっているタスクでは **New Agent** がより簡潔な入口になります。どちらの経路でもレビューや権限境界はなくなりません。
2038
2039[実際の要件から Plan へのウォークスルー](/docs-media/sdd.mp4)
2040
2041## 1. 要件を作成する
2042
2043サイドバーから **New Requirement** を選びます。有用な要件には少なくとも次を含めます。
2044
2045- **背景:** なぜ作業が重要で、現在何が問題なのか。
2046- **目標:** ユーザーまたはシステムにとって何を変えるのか。
2047- **受け入れ条件:** 完了をどのように判断するのか。
2048- **境界:** 対象外のものと、後退させてはいけないもの。
2049
2050実装案を要件であるかのように見せないでください。技術的な方法が未定なら、まず成果と制約を記述します。
2051
2052![中央に requirement.md、右側に Requirement AI を表示する実際の Kun 要件エディター](/docs-media/screenshots/requirement-editor-live-en.webp)
2053
2054*New Requirement から入ると、Kun は元の要件と明確化ツールを 1 つのワークスペースにまとめます。*
2055

2056- 中央の \`requirement.md\` は、現在の要件について編集可能な正しい情報源です。**Saved** は最新の下書きが書き込まれたことを意味しますが、要件がレビューや受け入れを通過したことを意味しません。
2057- 右側の **Requirement AI** は、不足している質問の発見、プロジェクトコンテキストの調査、下書きから要件ブロックと受け入れ条件への構造化を支援します。出力をプロジェクトの事実と照合してください。
2058- 現在の下書きを次の段階に進められる状態になったときだけ **Next** を選びます。実装を自動承認するものでも、受け入れ条件を満たしたと証明するものでもありません。
2059
2060## 2. 明確化して調査する
2061
2062要件 Assistant は不足している質問を行い、プロジェクトを調べ、下書きを構造化できます。その提案をリポジトリと照合してください。ビジネスルール、外部連携、セキュリティ境界については、ユーザーが最終判断を行う必要があります。
2063
2064エディターには異なる分析方法もあります。Jobs はユーザーが達成しようとすることに焦点を当て、Assumption Mapping と Experiments は不確実性を検証し、Premortem は起こり得る失敗を明らかにし、Problem Tree は原因を分解し、Triage は優先順位付けを助け、WWA や PRD はさらに構造を追加します。これらは思考のテンプレートであり、必須の順序ではありません。最も重要な不確実性を減らすものを使用してください。
2065
2066下書きは自動保存され、確認または復元できる履歴を保持します。再生成や再計画の前に、意図的な編集が上書きされないよう、現在のリビジョンが保存済みか確認してください。\`.kunsdd\` のエクスポートでは要件構造を引き継げますが、インポート後にプロジェクトパス、メディア参照、バージョン差を再確認します。
2067
2068## 3. 必要に応じて Design に進む
2069
2070画面の作業では、デザインコンテキスト、方向性、インフォグラフィック、プロトタイプを生成して Design で探索を続けられます。プロトタイプ生成には対応する Vision モデルが必要ですが、要件とテキストによる計画は Vision なしでも利用できます。Code の前に方向性を確定すると、実装時にレイアウトを推測する量を減らせます。[Design モード](/docs/design)を参照してください。
2071
2072## 4. Plan を生成して確認する
2073
2074![要件から生成された実装項目を追跡する Todo パネル](/docs-media/screenshots/todo-panel-en.webp)
2075
2076*Todo は、採用された要件と計画に続く、実行可能な作業項目をè

2076¡¨ç¤ºã—ます。*
2077
2078- 各項目が受け入れ条件に対応し、観察可能な完了条件を持つことを確認します。
2079- 会話の要約だけに頼らず、依存関係と未完了の作業を見える状態に保ちます。
2080- 完了した Todo 項目も、差分、コマンド出力、製品の動作が検証されるまでは状態の主張にすぎません。
2081
2082Plan を生成したら、すべての要件ブロックが網羅されているか確認します。Plan パネルからステップを Todo に同期できます。未対応の要件が残る場合は、Build を選ぶ前に Plan を改善してください。
2083
2084有用な Plan は、影響を受ける領域、検証方法、依存関係を特定します。要件の見出しを繰り返すだけでは不十分です。
2085
2086## 5. 実装して変更を扱う
2087
2088Build 中は、Todo で現在、保留、完了の作業を分けます。後から要件の下書きが変わると、Kun は要件と Plan の間のドリフトを示す場合があります。古い Plan で新しい要件を進めず、範囲を再確認し、必要に応じて再計画してください。
2089
2090## 6. 受け入れに戻る
2091
2092実装が完了したら、差分を確認して、プロジェクトの既存チェックを実行し、未コミットの変更、ベースブランチ、または選択したコミットに \`/review\` を使います。最後にすべての受け入れ条件を評価します。完了した Todo の一覧だけでは、要件の完了を証明できません。
2093
2094続けて[レビューと承認](/docs/review-and-approvals)と[長時間タスクを管理する](/docs/long-running-tasks)を参照してください。
2095`,S=`---
2096slug: review-and-approvals
2097lang: ja
2098group: workflows
2099order: 20
2100status: published
2101updatedAt: 2026-07-17
2102keywords: レビュー | 差分 | 承認 | 権限 | コードレビュー | 書き込みアクセス
2103title: 変更をレビューして承認を処理する
2104description: 操作の承認と結果のレビューを分け、変更を受け入れる前にコマンド、ファイル、リスクを確認します。
2105---
2106
2107Kun における承認とレビューは、異なる問題を解決します。**承認**は機密性の高い可能性がある操作の前に行い、その操作を実行してよいかを決めます。**レビュー**は作成済みの変更を調べ、正しいかどうかの判断を助けます。どちらもプロジェクトのテストや人による受け入れの代わりにはなりません。
2108
2109![実際のファイル差分を表示する Changes パネル](/docs-media/screenshots/changes-diff-en.webp)
2110
2111*Changes パネルは、Code ワークスペースですでに行われた編集を示す主要な視覚的証拠です。*
2112
2113- ワークベンチツールから **Changes** を開き、変更済みファイルと未追跡ファイルをすべて確認します。
2114- 受け入れ確認を実行する前に、追加と削除を合意済みの範囲と照合します。
2115- 差分がきれいに見えても、未実行のコマンドを承認したことにも、製品が動作する証明にもなりません。
2116
2117## 承認リクエストを処理する
2118
2119![承認ポリシーのモードを表示する権限設定](/docs-media/screenshots/settings-permissions-en.webp)
2120
2121*選択中の権限モードによって、どのツール操作で承認プロンプトが必要になるかが決まります。*
2122
2123- 機密性の高いタスクを処理する前に、**Settings → AI assistant → Access** を開いて **Permissions** セクションを確認します。
2124- 確認が必要な操作を見える状態に保つモードを選び、各プロンプトのパス、コマンド、送信先を評価します。
2125- ポリシー変更が影響するのは将来の操作です。既存のプロンプトを承認したり、完了済みの操作を取り消したりはしません。
2126
2127エージェントがファイルを書き込む、コマンドを実行する、または制限された別のツールを使おうとすると、Kun は承認リクエストを表示する場合があります。表示されるかどうかは、現在の権限モードと対象の操作によって決まります。
2128
2129![送信先パスと Allow、Deny 操作を表示する実際の Kun 書き込みツール承認カード](/docs-media/screenshots/tool-approval-live-en.webp)
2130
2131*実際の書き込み承認カードでは、ツール名、書き込み引数、送信先パスがタスクのタイムラインに表示されるため、Allow または Deny を選ぶ前に確認できます。*
2132
2133- 表示された操作を確認した後にだけ **Allow** を選びます。書き込み後は、承認を結æž

2133œã®å—け入れと考えず、作成されたファイルを **Changes** で確認してください。
2134- **Deny** を選ぶと、送信先ファイルを書き込まずにこのツール呼び出しをブロックします。範囲が広すぎた点を説明し、より限定されたパス、内容、操作で再試行できるようにします。
2135- 承認はカードに表示された特定の操作だけに適用されます。意図的に権限モードを変更しない限り、その後の制限された操作でも再度確認を求められる場合があります。
2136
2137承認前に、次を確認してください。
2138
21391. その操作は現在のタスクに属していますか。
21402. パスは想定したワークスペース内ですか。
21413. コマンドが何かを削除、上書き、公開、アップロードする可能性はありますか。
21424. 認証情報、個人データ、本番環境が関係しますか。
21435. より小さな読み取り専用操作で先に証拠を集められませんか。
2144
2145曖昧、予想外に広範囲、または期限切れのリクエストは拒否し、より具体的なステップを提案するようエージェントに依頼します。権限モードについては[ワークスペースの権限とセキュリティ](/docs/workspace-permissions-security)を参照してください。
2146
2147## ファイル変更を確認する
2148
2149Changes または差分パネルでは、ファイルごとの追加と削除を確認できます。各ファイルで次を確認してください。
2150
2151- 依頼した範囲外の変更。
2152- 説明のない設定、ロックファイル、生成ファイルの更新。
2153- 不足しているエラー処理、エッジケース、製品コピーの要件。
2154- 誤って書き込まれたキー、トークン、ローカルマシンのパス。
2155
2156## \`/review\` を使う
2157
2158\`/review\` は、未コミットの変更、ベースブランチからの変更、選択したコミット、カスタム指示で記述した範囲を調べられます。指摘は追加調査の手掛かりです。すべてのバグが見つかった保証ではなく、それぞれの主張を引き続き検証する必要があります。
2159
2160可能であればレビュー前にプロジェクトの既存の型チェック、テスト、ビルドを実行し、失敗した出力を証拠としてエージェントに渡します。
2161
2162## Write で編集を採用または拒否する
2163
2164![保存済みドキュメントと Summarize、Draft、Polish 操作を表示する準備完了状態の Writing Assistant](/docs-media/screenshots/write-editor-ai-en.webp)
2165
2166*画像は Diff Review ではなく開始状態です。採用または拒否できる変更は、選択範囲の編集結果が返された後にだけ表示されます。*
2167
2168- **Polish selection** を選ぶ前に、有用な最小範囲を選択します。ドキュメント全体の要約とアウトライン操作は、用途が異なります。
2169- 編集結果が返されたら、採用または拒否する前に、赤・緑の表現と周囲のコンテキストを確認します。
2170- 有用な最小単位で採用または拒否し、その後リンク、事実、書式、固有名詞を確認します。
2171- 提案を採用するとドキュメント状態が書き込まれます。Code の差分承認やツール権限とは別です。
2172
2173Write ではインラインの AI 編集を比較できる形で表示します。採用前に文章全体を読んでください。提案を拒否しても、その提案が破棄されるだけで、元の文章がすでに目標を満たす証明にはなりません。
2174
2175実践上の原則は、操作を許可する前に境界を確認し、その結果を受け入れる前に証拠を確認することです。
2176`,v=`---
2177slug: schedules
2178lang: ja
2179group: automation
2180order: 10
2181status: published
2182updatedAt: 2026-07-17
2183keywords: Schedule | スケジュールタスク | 自動化 | 依存関係 | worktree | スリープを防ぐ
2184title: スケジュールタスクを作成する
2185description: デバイスの利用状況と権限境界を守りながら、æ¤

2185œè¨¼å¯èƒ½ãªã‚¿ã‚¹ã‚¯ã‚’ 1 回、毎日、または一定間隔で実行します。
2186---
2187
2188Schedule は、毎日のプロジェクト状況の要約、失敗ログの定期確認、特定時刻のレポート生成など、入力が明確で結果をレビューできる反復作業に適しています。クラウドでホストされるサービスではないため、実行にはコンピューターと Kun ランタイムが利用可能である必要があります。
2189
2190![空の状態、New task、Keep awake コントロールを表示する Scheduled tasks](/docs-media/screenshots/schedule-editor-en.webp)
2191
2192*Scheduled tasks はローカルのタスク一覧を開き、保存済みタスクがない場合は明示的な空の状態を表示します。*
2193
2194- **New task** は、名前、プロンプト、タイミング、実行先を設定するフォームを開きます。
2195- **Keep awake** は Kun の実行中にスリープを防ぐ助けになるだけで、Schedule をクラウドサービスにするものではありません。
2196- **No scheduled tasks yet** は一覧が空であることを意味し、Runtime の失敗や実行エラーを示すものではありません。
2197
2198## タスクを作成する
2199
2200![タスク内容、モデル設定、毎日の実行時刻を表示する Schedule の Create task フォーム](/docs-media/screenshots/schedule-task-config-en.webp)
2201
2202*画像にはフォーム上部のタスク内容、Code または IM クライアント、Provider、モデル、推論、毎日の時刻が表示されています。Run environment と Schedule settings は折りたたまれた状態です。*
2203
2204- 具体的なプロンプトを書き、画像にあるクライアント、Provider、モデル、推論、1 回、毎日、一定間隔、手動のタイミングを確認します。
2205- 保存前に **Run environment** と **Schedule settings** を展開し、正確なワークスペース、依存関係、優先度、利用可能な分離 worktree の選択肢を設定します。
2206- タスクを保存または有効化してもコンピューターはオンラインのままにならず、通常のツール権限も回避されません。
2207
2208サイドバーから **Schedule** を開き、タスクを作成して次を設定します。
2209
2210- 名前と具体的なタスクプロンプト。
2211- 手動、1 回、毎日、一定間隔のタイミング。
2212- Code ワークスペースや設定済み IM クライアントなどの実行先。
2213- ワークスペース、Provider、モデル、推論設定。
2214- 有効状態、優先度、ほかのタスクへの依存関係。
2215- コード変更を分離する必要がある場合の独立 worktree。
2216
2217表示される正確な選択肢は、実行先と Kun のバージョンによって異なります。
2218
2219名前は 50 文字、タスクプロンプトは 8,000 文字までです。実行間隔は 1 から 10,080 分、優先度は 0 から 100 です。上限に達する場合は、無関係な目標を 1 つの大きすぎるプロンプトに隠さず分割してください。
2220
2221## タスクと実行履歴を管理する
2222
2223![Scheduled tasks サイドバーと、状態、タイミング、モデル、操作が表示された保存済みタスク行](/docs-media/screenshots/schedule-task-live-en.webp)
2224
2225*サイドバーの **Scheduled tasks** を選ぶとローカルのタスク一覧が開きます。**Daily project summary** は、有効スイッチがオンになった実際の保存済み手動タスクです。*
2226
2227- 右端のスイッチでそのタスクを有効または無効にします。名前の横にある **Idle**、**Running**、**Done** は現在または直近の状態を示し、代わりに **Manual** や、保存された 1 回、毎日、一定間隔のスケジュール種別が表示される場合があります。
2228- メタデータ行には **Next run**、**Last run**、Provider、モデル、推論レベルが並びます。画像の \`DeepSeek / kun-docs-demo · Med\` は、DeepSeek Provider、\`kun-docs-demo\` モデル、中程度の推論を意味します。
2229- 再生アイコンで保存済み設定を今すぐ実行し、鉛筆で編集、ゴミ箱で削除します。手動実行は、スケジュールする前にワークスペース、権限、出力を確認する最も安全な方法であり、次の予定時刻はずれません。
2230- バナーの説明は文字どおりです。タスクが実行されるのは、コンピューターが起動して Kun を利用できる間だけです。**Keep awake** は作業予定中のスリープを防ぐ助けになりますが、消費電力が増える場合があります。シャットダウン後、Kun の終了後、必要なネットワーク接続がない状態では実行できません。
2231
2232Schedule 一覧ではタスクを絞り込み、開く、編集、有効化・無効化、今すぐ実行、削除ができます。各タスクには直近の実行、次の実行、最近の結果、最新の実行会話へのリンクが表示されます。
2233
2234Run now は、次の予定時刻をずらさず、現在保存さã

2234‚Œã¦ã„る設定を確認します。タスクを削除しても、そのタスクが作成した会話やワークスペースファイルは自動削除されません。まず最新のスレッドを開き、必要な結果を保全してください。
2235
2236## 最初に手動で検証する
2237
2238自動実行を有効にする前に、同じプロンプトを手動実行します。正しいワークスペースが使われ、応答できない承認を必要とせず、人または後続タスクが解釈できる結果が生成されることを確認してください。
2239
2240良いプロンプトには、期間、入力場所、許可する変更、出力形式が記載されています。「過去 24 時間のテスト失敗を Markdown で要約し、読み取り専用で分析してコードは編集しないでください」は、「プロジェクトを確認して」より信頼できます。
2241
2242## デバイスを利用可能に保つ
2243
2244コンピューターがスリープ中、またはランタイムが利用できない場合、Schedule は実行が保証されたクラウドジョブのようには動作しません。スリープ防止オプションが利用できる場合もありますが、消費電力に影響します。重要な締め切りをデスクトップのスケジュールだけに依存させず、外部リマインダーなどの代替手段も用意してください。
2245
2246## 依存関係と分離
2247
2248入力の準備前にレポートが始まらないよう、順番に実行する必要があるタスクには依存関係を使います。分離 worktree はコード変更の重複を減らしますが、ブランチ競合、未コミット作業、worktree の容量制限は引き続き適用されます。
2249
2250タスクが実行されなかった場合は、有効になっていたか、コンピューターを利用できたか、依存関係が完了したか、Provider が接続されていたか、承認が未回答のままではないかを確認します。さらに詳しい確認は[トラブルシューティング](/docs/troubleshooting)を参照してください。
2251
2252後続タスクは、依存タスクが成功した後にだけ続行すべきです。優先度は、同時に実行可能になったタスクの順番を決めます。モデル品質を上げるものではありません。Code タスクは現在のワークスペースまたは分離 worktree を使用できます。IM タスクには接続済みの電話チャンネルも必要です。ワークスペース、Provider、モデル、推論、実行モード、電話の送信先をそれぞれ確認してください。
2253
2254## 既定値、スリープ防止、安全性
2255
2256Schedule のマスタースイッチは自動スケジュール全体を制御し、各タスクも有効にする必要があります。グローバルの既定値は繰り返し入力を減らしますが、保存済みタスクを書き換えません。Keep awake は Kun の実行中に一部のスリープ状態を防げますが、アプリ終了後には実行せず、ネットワークや Provider の利用可能性を保証しません。
2257
2258スケジュールされた作業は、選択した Agent とツールポリシーに従います。無人の作業では読み取り専用または機密操作の承認を優先し、人の同意をいつまでも待つ重要経路を避けてください。自動的なコード変更には分離 worktree を使い、結果の会話で Diff をレビューします。[ワークスペースの権限とセキュリティ](/docs/workspace-permissions-security)を参照してください。
2259`,A=`---
2260slug: settings-overview
2261lang: ja
2262group: settings
2263order: 10
2264status: published
2265updatedAt: 2026-08-02
2266keywords: 設定 | 自動保存 | 構成 | 設定索引 | 再起動 | Provider | Agent | 権限
2267title: 設定概要と完全な索引
2268description: Kun における設定の保存方法を理解し、すべてのカテゴリの効果、依存関係、詳細ガイドを 1 つの索引から確認します。
2269---
2270
2271Kun は画面、モデル、作業モード、Agents、データ、メンテナンスを中心に設定を分類しています。ほとã

2271‚“どの変更は自動保存され、直ちに適用されます。ランタイムプロセスのパラメーターや OS の権限によっては、ランタイムの再読み込みまたはアプリ再起動が必要です。
2272
2273![すべての主要カテゴリを表示する Kun Settings の完全なサイドバー](/docs-media/screenshots/settings-sidebar-index-en.webp)
2274
2275*Settings サイドバーは、内蔵設定グループの完全なナビゲーション索引です。*
2276
2277- 画面の既定値は **General**、モデル接続は **Providers** から始め、モード固有のグループは必要な場合だけ使用します。
2278- **Agents**、**Subagents**、権限、Skills、MCP、Memory、Computer Use は自動化の境界に影響するため、慎重に確認する必要があります。
2279- アーカイブ、移行、アップデート、診断、トラブルシューティングはライフサイクルと証拠を管理します。一部の項目は、現在のビルドが対応している場合にだけ表示されます。
2280- Extension が提供する設定は動的に表示される場合があり、その Extension のソースと権限とあわせて評価してください。
2281
2282## Settings を開いて保存を確認する
2283
2284サイドバー下部またはアプリケーションメニューから Settings を開きます。右上の状態には、編集内容が保存中、保存済み、失敗のいずれかが表示されます。通常、個別の Save ボタンはありません。エラーが表示された場合は、キー、パス、権限が適用されたと考えず、メッセージを保持して再試行してください。
2285
2286ページは、新しい入力が約 450 ms ないと変更を書き込み、ワークベンチに戻る際には最後の保留中の編集を反映します。無効なランタイムポートなどの不正な入力があると、該当の更新は通常適用されません。
2287
2288![既定モデル、自動起動、高度な設定への入口を表示する Agent 設定](/docs-media/screenshots/agent-settings-en.webp)
2289
2290*Agents ページには日常的な既定値と、権限、Skills、MCP、高度なランタイムコントロール、診断へのリンクがあります。*
2291
2292- 最初に既定の Provider、モデル、自動起動を確認し、現在のタスクに必要な詳細カテゴリだけに進みます。
2293- ポート、データディレクトリ、ランタイムトークンの変更ではローカルサービスが再起動する場合があるため、重要な作業が終わるまで待つか停止してから編集します。
2294- モード、会話、Profile、Schedule がグローバルモデルを上書きする場合があります。トラブルシューティングでは既定値と現在のコンテキストの両方を確認してください。
2295
2296## 設定カテゴリの完全な索引
2297
2298| Settings の項目 | 主な内容 | 詳細ガイド |
2299| --- | --- | --- |
2300| General | 言語、テーマ、倍率、コンテンツ幅、ルート、デスクトップ動作、通知、ログ | [一般設定とデスクトップ設定](/docs/general-and-desktop-settings) |
2301| Providers | Providers、認証情報、プロトコル、モデル、機能の宣言 | [Provider とモデル](/docs/providers-and-models) |
2302| Extensions | インストール済み Extension が提供する動的設定。利用可能な場合にだけ表示 | [MCP、Skills、Extensions](/docs/plugins-skills-extensions) |
2303| Write | 執筆ルート、自動保存、タイポグラフィ、インライン候補、クイック操作、ログ | [作業モードと Terminal の設定](/docs/mode-and-tool-settings) |
2304| Design | Design → Code、キャンバスの既定値、デザインワークスペース | [作業モードと Terminal の設定](/docs/mode-and-tool-settings) |
2305| Media generation | 画像、TTS、音楽、動画の生成 | [メディアと音声の機能](/docs/media-generation) |
2306| Speech to text | ローカル Whisper またはリモート ASR、言語、モデル、テスト | [メディアと音声の機能](/d

2306ocs/media-generation) |
2307| AI assistant | 既定の Provider / モデル、ランタイム、Computer Use、Skills、MCP、権限、高度な調整 | [Agent、サブエージェント、Memory](/docs/agents-subagents-and-memory) |
2308| Subagents | 並列数とセッション単位の上限、役割、モデル、プロンプト、機能 | [Agent、サブエージェント、Memory](/docs/agents-subagents-and-memory) |
2309| Archived chats | アーカイブ済み会話の検索、表示、復元、完全削除 | [データ、アップデート、診断](/docs/data-updates-and-diagnostics) |
2310| Data migration | 条件付きで利用できる \`.kunpack\` のエクスポート、インポート、復元 | [データ、アップデート、診断](/docs/data-updates-and-diagnostics) |
2311| Worktrees | ブランチ接頭辞、管理対象 worktree の確認と削除 | [Terminal、プレビュー、worktree](/docs/terminal-browser-and-worktrees) |
2312| Memory | 有効化、スコープ、記録管理、インポート、エクスポート | [Agent、サブエージェント、Memory](/docs/agents-subagents-and-memory) |
2313| Keyboard shortcuts | 検索、取り込み、競合警告、リセット | [コマンドとショートカット](/docs/commands-and-shortcuts) |
2314| Mode workshop | Kun の人格、Retroma パレット、宣言型 UI プラグイン | [一般設定とデスクトップ設定](/docs/general-and-desktop-settings) |
2315| Version & updates | Stable / Frontier チャンネル、確認、ダウンロード、インストール | [データ、アップデート、診断](/docs/data-updates-and-diagnostics) |
2316| Connect phone | Claw の既定値、チャンネル、ワークスペース、セッションアクセス | [電話を接続する](/docs/connect-phone) |
2317| Terminal | Native、モノクロ、カスタム ANSI パレット | [作業モードと Terminal の設定](/docs/mode-and-tool-settings) |
2318| Troubleshooting | 最近のモデルリクエスト、出力、ツール呼び出し、使用量、エラー | [データ、アップデート、診断](/docs/data-updates-and-diagnostics) |
2319
2320ツール権限、Skills、MCP は独立したサイドバー項目ではなく、**AI assistant** 内のジャンプ先です。ポリシーの詳細は[ワークスペースの権限とセキュリティ](/docs/workspace-permissions-security)、拡張の仕組みは[MCP、Skills、Extensions](/docs/plugins-skills-extensions)を参照してください。
2321
2322## 高度な調整の前に一般設定を変更する
2323
2324初期設定で通常必要なのは、言語、既定のワークスペース、Provider とチャットモデル、ツール権限、使用する音声またはメディア機能だけです。ランタイムバイナリ、ポート、ストレージバックエンド、Compact のしきい値、ツール出力上限、MCP 検索パラメーターは高度な設定です。特定の障害や導入要件がない限り、既定値を維持してください。
2325
2326> 重要: 設定項目が多くても、すべてのフィールドを入力する必要はありません。互換性のないサービスのパラメーターをコピーするより、使わない機能を無効のままにする方が安全です。
2327
2328## 継承と上書きを理解する
2329
2330Write、Design、Schedule、Claw、サブエージェントは、グローバルの Provider とモデルを継承するか、ローカルの選択を使えます。通常、空のフィールドは継承を意味します。上書きを追加した後のトラブルシューティングでは、グローバル接続とその機能のローカル値を両方確認する必要があります。
2331
2332メディアも同様に、Provider が宣言したモデルを再利用するか、カスタム API に切り替えられます。サービスが実際に別の認証情報を必要とする場合を除き、同じキーを複数箇所に保存しないでください。
2333
2334## 再起動と OS の権限を扱う
2335
2336ランタイムバイナリ、ポート、自動起動、データディレクトリ、ランタイムトークン、ストレージモードまたは SQLite パス、安全でã

2336ªã„ローカルアクセス、HTTP と Agent SDK の Provider 種別の切り替え、macOS の Computer Use トグルはプロセス起動に影響し、保存後にローカル Runtime を自動再起動する場合があります。マイク、アクセシビリティ、画面収録の権限は OS に属します。Kun のトグルはシステムの同意に代わらず、同意変更後にアプリ再起動が必要な場合があります。
2337
2338機能が古い値を使い続ける場合は、保存状態を確認してから該当ビューを開き直すか、新しいターンを開始します。ページが求める場合にだけ再起動してください。診断手順については[トラブルシューティング](/docs/troubleshooting)を参照してください。
2339
2340## キー、パス、診断データを保護する
2341
2342Provider Profile の API キーは、対応環境では保護されたアカウントまたは認証情報ストレージへ移されますが、すべてのフィールドが OS のキーチェーンを使うわけではありません。カスタムの画像、STT、TTS、音楽、動画のキー、ランタイムトークン、Claw または Telegram の認証情報は通常のローカル設定です。MCP の環境変数とヘッダーは \`~/.kun/mcp.json\` に平文で保存さã

2342‚Œã¾ã™ã€‚
2343
2344シークレットは専用のフィールドにだけ入力し、Kun の設定ファイル、ローカルアカウント、デバイスのバックアップを機密情報として扱ってください。スクリーンショットを共有する前にキーを隠し、パスからユーザー名や顧客プロジェクトが分からないか確認します。LLM 診断、Write ログ、移行レポートには、プロンプト、ファイルの抜粋、モデル出力、パスが含まれる場合があります。問題解決に必要な最小限だけを共有してください。
2345`,b=`---
2346slug: terminal-browser-and-worktrees
2347lang: ja
2348group: workspace-tools
2349order: 30
2350status: published
2351updatedAt: 2026-07-17
2352keywords: Files | Changes | 差分 | Terminal | Browser | ローカルプレビュー | Canvas | Whiteboard | Plan | Todo | サイド会話 | サブエージェントパネル | Git ブランチ | Worktree | マージ | リベース | ロールバック
2353title: ワークベンチパネル、Git、worktree
2354description: Files、Changes、Terminal、Browser、タスクパネルで実際のプロジェクトを確認し、リスクのある変更を Git ブランチと独立 worktree で分離します。
2355---
2356
2357Code ワークベンチは、会話、プロジェクトファイル、コマンド、プレビュー、変更の証拠を同じタスクの横に表示します。各パネルは異なる状態の見方であり、別のパネルのバックアップではありません。ファイルが見えても保存済みとは限らず、差分があってもテスト合格を証明せず、Browser ページが動作してもすべての環境が正しいとは限りません。
2358
2359## 確認内容に合ったパネルを選ぶ
2360
2361| 確認したいこと | 主な入口 | あわせて確認するもの |
2362| --- | --- | --- |
2363| ファイルが存在し、何が含まれるか | Files | パス、タイムスタンプ、ディスク上の最新バージョン |
2364| エージェントが何を変更したか | Changes | すべての差分、未追跡ファイル、プロジェクトチェック |
2365| コマンドが動作するか | Terminal | 終了ステータス、完全な出力、副作用 |
2366| ローカルページが動作するか | Browser | 起動アドレス、Console または Terminal のエラー、重要な操作 |
2367| 複数ステップのタスクがどこまで進んだか | Plan / Todo | 要件、受け入れ条件、実際の証拠 |
2368| 並行調査が何を返したか | Side conversations / Subagents | 独立セッション、権限、ファイル範囲 |
2369
2370パネルは必要に応じて開き、切り替え、閉じられます。通常、画面を閉じても、その基になるファイル、コマンド、セッション、実行状態は取り消されません。
2371
2372## Files を閲覧し、Changes をレビューする
2373
2374![現在のワークスペースツリーとファイルのコンテキストメニューを表示する Files パネル](/docs-media/screenshots/files-panel-en.webp)
2375
2376*画像にはディスク上のツリーと、選択中ファイルの Add reference、Copy path 操作が表示されています。*
2377
2378- 親フォルダーを展開してパスを区別します。対応ファイルを選ぶとワークベンチのタブで開きます。
2379- **Add file reference** は関連する最小項目に使い、検証用には絶対パスまたは相対パスをコピーします。
2380- タスクで必要な場合を除き、生成出力、依存関係ツリー、シークレットを広いコンテキストに含めないでください。
2381- Files は Browser でありバックアップではありません。保存状態とバージョン管理は別に確認します。
2382
2383![ファイルごとの追加、削除、差分内容を表示する Changes パネル](/docs-media/screenshots/changes-diff-en.webp)
2384
2385*Changes はレビュー範囲を、プロジェクト内の変更済みファイルと未追跡ファイルに絞ります。*
2386
2387- 納品前にすべてのファイルと、説明のないロックファイルまたは設定変更を確認します。
2388- 差分で範囲を確認し、動作にはプロジェクトチェックを実行します。
2389- 変更を Revert または Discard するのは別の操作で、破壊的な場合があります。
2390
2391Files では現在のワークスペースを展開し、対応ファイルをプレビューし、ファイルまたはフォルダー参照を Composer に追加できます。追加前に相対パスを確認してください。エージェントに「より多くのコンテキスト」を与えるためだけに、依存関係ツリー、ビルド出力、認証情報ファイル、大きなバイナリを含めないでください。
2392
2393Changes は変更済みファイル、追加・削除数、差分を表示します。納品前に少なくとも次を確認します。
2394
23951. 依頼した範囲内のファイルだけが表示される。

23962. すべての削除に理由があり、名前変更を無関係な削除と追加として誤解していない。
23973. 設定、ロックファイル、生成出力、テスト Snapshot が意図的に変更されている。
23984. 関連する未追跡ファイルや未保存編集が欠落していない。
23995. エージェントの要約が差分と一致する。
2400
2401Changes はレビュー画面であり、自動的な受け入れコントロールではありません。理解できない箇所は、そのファイルコンテキストに戻り、説明または範囲を限定した編集を依頼します。[変更をレビューして承認を処理する](/docs/review-and-approvals)を参照してください。
2402
2403Files ではファイルまたはディレクトリの作成、更新、パスのコピー、システムのファイルマネージャーでの表示、Composer への追加もできます。Code、Markdown、SVG、一般的な画像には適切なプレビューが使われます。タブはピン留めでき、対応ã

2403™ã‚‹ãƒ†ã‚­ã‚¹ãƒˆãƒ“ューには閲覧モードがあります。大きなファイルは省略されるか読み取り専用へ制限される場合があります。そのプレビューを完全なファイルとして扱わず、対象を絞った検索または外部エディターを使用してください。外部で開いた後は、そのアプリケーションが保存を制御します。
2404
2405### 既定の外部エディターを選ぶ
2406
2407Code ワークベンチのトップバーにある **Choose default editor** コントロールには、Kun がこのコンピューターで利用可能だと検出したエディター、Terminal、Viewer が表示されます。選択は以降に開く際のために記憶されます。**Line** Badge のあるアプリケーションは通常、差分、ファイル参照、診断結果から移動するとき、行と列を含むファイル位置を受け取れます。
2408
2409![検出済みアプリケーション、Line 機能、既定エディターを表示し、Open files with を展開したオンラインの Kun ワークベンチ](/docs-media/screenshots/external-editor-picker-en.webp)
2410
2411*メニューにはこのコンピューターで検出されたアプリケーションが表示されます。チェックマークは既定の開き方、Line は位置を指定した移動への

2411対応を意味します。*
2412
2413- メニューにあるのは、このコンピューターで実際に利用可能なアプリケーションだけです。インストールされていないエディターは表示されません。
2414- 既定エディターは開き方の設定です。Agent にワークスペース全体へのアクセスを与えたり、Kun のワークスペース書き込み権限を変えたりはしません。
2415- 外部アプリケーションでファイルを開く、保存する、実行する際の動作は、そのアプリケーションが制御します。Kun に戻って Files と Changes を更新し、ディスク上の状態を確認してください。
2416
2417## Terminal で実際のコマンドを実行する
2418
2419![コマンド出力を表示する統合 Terminal パネル](/docs-media/screenshots/terminal-panel-en.webp)
2420
2421*Terminal は選択中のワークスペースでコマンドを実行し、タスクの横に見える出力を保持します。*
2422
2423- 特に worktree または似た名前のプロジェクトでは、実行前にプロンプトのディレクトリとコマンドを確認します。
2424- エージェントの要約だけに頼らず、終了ステータス、完全な出力、生成されたファイルを証拠として扱います。
2425- パネルを閉じてもバックグラウンドプロセスが終了するとは限りません。必要な場合は明示的に停止します。
2426
2427Terminal は現在の作業ディレクトリで実際の Shell を開きます。プロジェクトに記載された Install、Test、型チェック、Build、Git、開発サーバーのコマンドに使います。\`pwd\` または各プラットフォームの相当コマンドで場所を確認し、README、Package script、プロジェクトドキュメントのコマンドを優先してください。
2428
2429自分で入力したコマンドでも、ファイル削除、Git 履歴の書き換え、グローバルソフトウェアのインストール、ネットワークアクセスを行えます。Agent のツール承認を Terminal の安全境界として扱わないでください。Enter を押す前に、コマンド、引数、引用符、Wildcard、対象環境を確認します。
2430
2431開発サーバーの実行時は完全な出力を保持します。ポート、起動 URL、エラーは Browser とあわせて確認する必要がよくあります。テスト成功を報告するときは、「検証済み」とだけ述べず、実際のコマンドと結果を記録してください。
2432
2433Terminal は複数タブと、New、Clear、Restart、Rename、Close、Close Others、Close All に対応します。Clear は見える Buffer を隠すだけで、コマンドは取り消しません。Restart はそのタブのプロセスを終了し、新しい Shell を起動します。タブを閉じると実行中の開発サーバーが終了する場合があります。**Open native terminal** はシステムアプリケーションを起動します。その Profile、環境、履歴は Kun の Terminal 色設定の外にあります。
2434
2435## Browser と Canvas で結果を確認する
2436
2437![中国語 UI の Kun ウィンドウで完全なローカルアプリケーションプレビューを表示する Browser パネル](/docs-media/screenshots/browser-preview-en.webp)
2438
2439*この実際の画像では Kun の中国語ロケールを使用しています。Browser タブには、どのロケールでも共通して使う完全な \`127.0.0.1:41739\` アドレス、localhost ページ、実行中プレビュー状態が表示されています。*
2440
2441- Terminal で開発サーバーを起動し、その正確なローカルアドレスを Browser で開きます。
2442- Terminal と Console の失敗を監視しながら、重要な操作とレスポンシブ状態をテストします。
2443- プレビューの成功が証明するのはテストしたランタイムと経路だけで、本番デプロイやすべての Browser ではありません。
2444
2445![描画ツールのパレットを備えた空の Whiteboard キャンバス](/docs-media/screenshots/whiteboard-panel-en.webp)
2446
2447*新しい Whiteboard は空のキャンバスから始まります。見えるツールパレットを使って意図的に構造を追加します。*
2448
2449- 直線的な会話より、関係を図で表す方が明確な場合に使います。
2450- 正しい情報源となる要件と実装ファイルは通常の場所に保持します。
2451- Board 成果物は意図を伝えますが、それ自体では Plan を実行せず、コードも変更しません。
2452
2453Browser にはアドレスバー、Back、Forward、Reload、Auto Follow、Open Externally、Reset があります。Auto Follow は既定でオンで、検出された開発サーバー URL を使用します。Reset は現在の URL を消去し、Auto Follow をオフにします。localhost、Private network、\`.local\`、Docker host の HTTP または HTTPS 開発アドレスを受け付けますが、一般的な公開 Web 用 Browser ではありません。
2454
2455Browser は永続的な WebView Partition を使うため、ローカルサイトの Cookie と Storage が会話をまたいで残る場合があります。URL の Reset ではサイトデータは消去されません。信頼できないプレビューに実際のアカウントや本番認証情報を入力しないでください。Agent の \`web_search\` / \`web_fetch\` とも別です。Browser は操作を確認するために使い、Web ツールはリモート内容をモデルへ返します。
2456
2457現在、独立した **Settings → Browser** カテゴリはありません。URL と Auto Follow はローカルの Browser パネル状態です。Theme、Language、Terminal 色の設定によって、プレビュー中のページが再装飾されることはありません。
2458
2459Browser は、検出または手動入力したローカル開発アドレスを開き、更新して、レイアウト、Route、操作を確認するために役立ちます。別プロジェクトや古いプロセスをタスクの結果と取り違えないよう、サーバーが現在のワークスペースから起動されたことを確認してください。
2460
2461Browser の検証では、ホームページが開くかだけでなく、要件にある状態を確認します。たとえば Desktop と狭い Layout、Loading と Empty state、Error、Keyboard 操作です。Browser 内のページも外部 API を呼び出す場合があります。信頼できないプロジェクトへ実際のアカウントまたは本番認証情報を入力しないでください。
2462
2463Canvas / Whiteboard は、フロー図、構造的な説明、ビジュアル補助を保持できます。議論に役立ちますが、タスクが Canvas の保存を成果物として明示しない限り、プロジェクトコード、Requirements、デザインシステムの唯一の情報源にしないでください。
2464
2465## Plan、Todo、サイド会話、サブエージェントを確認する
2466
2467![タスク項目と完了状態を表示する Todo パネル](/docs-media/screenshots/todo-panel-en.webp)
2468
2469*Todo は実装進捗を、個別にレビューできる項目として表示します。*
2470
2471- 完了にする前に、各項目を Plan と受け入れ条件と照合します。
2472- 証拠によって作業が残っていると分かった場合は、項目を再度開きます。
2473- Todo の状態はテスト合格やバックグラウンドセッションの成功を証明しません。
2474
2475![委任可能な役割、モデル継承、New subagent を表示する Subagents パネル](/docs-media/screenshots/subagents-panel-en.webp)
2476
2477*Subagents は委任に利用可能な役割を設定する場所で、実行中タスクの一覧ではありません。*
2478
2479- 委任前に役割の責任とモデル継承を確認します。**New subagent** は再利用可能な役割 Profile を作成し、タスクは実行しません。
2480- 委任後は、タイムラインのタスクカードから範囲、権限状態、ツールの証拠、独立した子セッションを確認します。
2481- 各タスクに明確なファイル所有範囲または分離がない限り、重複する書き込みを避け、採用した証拠をメインタスクへ戻します。
2482
2483![元のメインスレッドを表示する未送信のサイド会話 Composer](/docs-media/screenshots/branch-conversation-en.webp)
2484
2485*この Composer は関連する Side / BTW の質問を準備します。送信後にだけサイド会話が作成されます。*
2486
2487- 送信前に上部の元メインスレッドを確認します。未送信の Composer を閉じても何も作成されません。
2488- **Fork** はここに表示されたコントロールではなく、独立した会話を作る別操作です。作成済みサイド会話は、範囲の限定された関連質問に使います。
2489- 作成する会話が共有ワークスペースを編集できるか、読み取り専用にするかを確認します。パネルを隠してもマージやキャンセルはされません。
2490- Branch は推論、ファイル変更、受け入れ判断を自動的にマージしません。
2491
2492- **Plan** は複数ステップの進め方、関連範囲、利用可能な要件の網羅状況を示します。要件変更後は差分に基づく再計画を確認します。
2493- **Todo** は実行状態を示します。項目をチェックしても、テストや受け入れに自動合格しません。
2494- **Side conversations** は関連質問に並行して回答します。パネルを隠しても結論はメインの流れへ移りません。
2495- **タイムラインの委任タスクカード**は、Queued、Running、Awaiting approval、Done、Failed の状態を示し、独立した子セッションを開けます。Subagents パネル自体は再利用可能な役割を設定します。
2496
2497並列タスクは同じワークスペースを調査または変更する場合があります。それぞれに明確なファイル範囲と適切ã

2497ªæ›¸ãè¾¼ã¿ãƒãƒªã‚·ãƒ¼ã‚’設定します。結果が返ったら、矛盾する推奨事項を連結せず、証拠と差分を比較してください。[Agent、サブエージェント、長期 Memory](/docs/agents-subagents-and-memory)を参照してください。
2498
2499## Git ブランチと分離 worktree を選ぶ
2500
2501![新規ブランチの接頭辞、保存パス、会話 worktree がない状態を表示する Git worktree 設定](/docs-media/screenshots/worktree-settings-en.webp)
2502
2503*現在の画像は基本設定と空の worktree 一覧を示しています。作成後に Session、占有状態、管理操作が表示されます。*
2504
2505- 新規ブランチの接頭辞を設定し、保存パスを確認し、Refresh で現在のプロジェクトの会話 worktree を再読み込みします。
2506- worktree 行が存在する場合、操作前にリポジトリ、ブランチ、関連会話、未コミット状態を確認します。
2507- worktree の作成、マージ、リベース、クリーンアップ前に、未コミットのユーザー変更がどこにあるかを確認します。
2508- 分離は重複を減らしますが、レビュー、コミット、バックアップ、競合処理の代わりにはなりません。
2509
2510ブランチピッカーでは Git ブランチの検索、切り替え、作成ができます。別の worktree ですでにチェックアウトされているブランチなら、Kun はその場所を開けます。切り替え前に現在のブランチの未コミット変更を確認し、以前のタスクの状態が次のタスクへ混入しないようにしてください。
2511
2512**Worktree mode** を有効にすると、新しい会話は選択したブランチから独立したチェックアウトの作成を試みます。各会話が独自のチェックアウトディレクトリを持てるため、並列実装、リスクのある実験、長いバックグラウンドタスクに役立ちます。ディレクトリが Git リポジトリでない、ブランチ未選択、作成失敗、利用可能な worktree Pool が上限の場合、画面に問題が表示され、代わりに通常の会話が作成される場合があります。続行前に実際の環境インジケーターを確認してください。
2513
2514Worktree 設定ページには Main branch、Pool の場所、関連会話、占有状態、未コミット状態が表示されます。利用可能な場合は、作成、Release、Remove、Main への Merge、Main からの Sync（Rebase）操作があります。新しいブランチ名の接頭辞も設定できます。
2515
2516> 警告: worktree が分離するのは Git のチェックアウトだけです。データベース、Container、ポート、クラウドリソース、OS 設定、グローバル Cache、外部サービスは共有される場合があります。2 つの worktree から同じ本番リソースを同時に操作しないでください。
2517
2518> 強い警告: Worktree 設定の **Remove** には現在 2 回目の確認がなく、worktree を強制削除します。未コミットまたは未追跡の内容が直ちに失われる可能性があります。選ぶ前に \`git status\` と Changes を確認し、残す必要のあるすべてのファイルをコミットまたはバックアップしてください。チャット履歴は復元用コピーではありません。
2519
2520## マージ、クリーンアップ、復元前に証拠を保全する
2521
2522worktree のマージ、リベース、Release、Remove の前に次を行います。
2523
25241. 未コミットと未追跡の内容を含め、Changes と \`git status\` を確認します。
25252. プロジェクトの既存チェックを実行し、必要なログまたはスクリーンショットを保全します。
25263. 意味のあるコミットを作るか、残す必要のあるファイルを明示的にバックアップします。
25274. 対象の Main branch と同期方向を確認します。
25285. 競合を解決し、検証を再実行します。
2529
2530一部のクリーンアップ操作は未コミット変更の警告を表示しますが、Remove 自体には確認による保護がありません。強制 Reset、Remove、Cleanup は変更を恒久的に破棄する場合があり、チャット履歴からすべてのファイルを再構築することはできません。タスクが範囲外へ進んだ場合は Agent を停止し、現在の状態を保全して、ブロック単位の Revert、Git 復元、分離 worktree の破棄を選ぶ前に差分を確認します。影響するすべてのチェックアウトを理解するまでは、Remove または Cleanup all を使わないでください。
2531
2532引き継ぎ時には、使用したブランチまたは worktree、実際に実行したコマンド、残っている変更、人が確認すべき項目を報告します。ワークスペースの信頼とコマンド境界については、[ワークスペースの権限とセキュリティ](/docs/workspace-permissions-security)を参照してください。
2533`,M=`---
2534slug: troubleshooting
2535lang: ja
2536group: safety-help
2537order: 20
2538status: published
2539updatedAt: 2026-07-17
2540keywords: トラブルシューティング | ランタイム | Provider | 添付ファイル | worktree | Schedule | ログ
2541title: トラブルシューティング
2542description: ランタイム、モデル、権限境界、正確なタスク範囲から調べて、Kun でよくある問題を診断します。
2543---
2544

2545まず作業を保存し、Kun のバージョン、OS、Provider、モデル、ワークスペース、エラーメッセージ全文を記録します。スクリーンショットやログを共有する前に、キー、トークン、ローカルユーザー名、非公開パスを削除してください。
2546
2547## ローカルランタイムを利用できない
2548
2549![ランタイム機能とツール準備状況を表示する Assistant の状態診断](/docs-media/screenshots/settings-agent-diagnostics-en.webp)
2550
2551*Assistant status では、接続可能な Provider と、Agent 機能が完全に読み込まれたランタイムを区別できます。*
2552
2553- 更新し、MCP、Web、Instructions、Skills、Subagents、Images、Memory のうち、最初に利用不可となっている機能を確認します。
2554- その機能の設定とログに戻り、Full access で失敗を回避するのではなく、新しい読み取り専用ターンで確認します。
2555
2556典型的な症状には、会話を開始できない、サービスがオフラインのままになる、再起動を繰り返す、などがあります。
2557
25581. Settings で AI Assistant サービスの自動起動が許可されていることを確認します。
25592. 複数のインスタンスを起動せず、画面からランタイムを再起動します。
25603. ローカルのセキュリティソフトがプロセスをブロックしていないか、別のアプリケーションがポートを使っていないか確認します。
25614. アップデート後に問題が始まった場合は、そのバージョンが提供するログ、診断、ロールバック項目を使用します。
2562
2563## Provider またはモデルのリクエストが失敗する
2564
2565![Kun の LLM リクエストトラブルシューティングに表示された最近のリクエストの折りたたみ行](/docs-media/screenshots/troubleshooting-rounds-live-en.webp)
2566
2567*各折りたたみ行にはリクエスト ID、モデル、時刻、所要時間が表示されます。完了リクエストには終了理由が表示され、失敗リクエストはエラー状態から確認します。*
2568
2569- まず失敗時刻を照合し、リクエスト ID で近い時間に起きた再試行を区別します。想定外のモデルの場合は、Provider と会話での選択を確認してください。
2570- 所要時間から、即時の認証失敗、タイムアウト、完了したモデル応答を区別できます。終了理由はモデルが終了した理由を示します。エラーがある場合はエラー詳細が正しく、終了理由だけでは成功を証明できません。
2571- **Refresh** は、現在の Runtime がメモリに保持している記録を再読み込みするだけです。リクエストを再送せず、以前のターンの記録も復元しません。
2572- 行を展開する前に、画面が共有または録画されていないことを確認します。リクエスト本文にはプロンプト全文、メッセージ、ファイルの抜粋、ツール引数、ローカルパスが含まれる場合があります。取得またはエクスポート前に、必要最小限の証拠だけになるよう機密情報を削除してください。
2573- 画面がメモリに保持するのは最新 25 ラウンドだけで、Runtime を再起動すると消去されます。
2574- 取得により機密内容が露出する可能性があるため、オプトインであり、通常のリリースビルドでは無効な場合があります。再現可能なリクエスト後に Refresh しても一覧が空なら、設定を手作業で編集して強制的に有効にせず、**Assistant status** とアプリケーションログを使ってください。
2575
2576失敗したリクエストを成功したリクエスト 1 つと比較し、モデル、プロトコル、権限を同時に入れ替えるのではなく、関連する設定を 1 つずつ変更します。
2577
2578- 基本接続には Test Connection を使います。
2579- API または Token Plan の製品、リージョン、認証情報が一致することを確認します。
2580- Base URL と Endpoint でパス部分が重複または欠落していないか確認します。
2581- Provider が表示する正確な Model ID を使用します。
2582- 残高、レート制限、プロキシ、ネットワークアクセスを確認します。
2583- Tools、Vision、Reasoning が失敗する場合は、機能の宣言を確認します。
2584
2585基本テストは成功するのに Agent のツールが失敗する場合、基本的なネットワークではなく、モデルの機能またはエンドポイントプロトコルに問題があることがよくあります。
2586
2587## Kun が読み取り、書き込み、コマンド実行を行えない
2588
2589現在のプロジェクトパスと権限モードを確認します。Read only、Ask for workspace writes、Trusted workspace では、書き込みとコマンドの境界が異なります。承認が期限切れになった場合は、より小さく具体的な操作を再度ä¾

2589é ¼ã™ã‚‹ã‚ˆã†ã‚¨ãƒ¼ã‚¸ã‚§ãƒ³ãƒˆã«æ±‚めてください。フォルダーが Git リポジトリではない、ブランチが別の worktree で開いている、容量上限に達した、未コミットの変更に対応が必要、といった理由で worktree を利用できないこともあります。
2590
2591## 画像、PDF、マイクが動作しない
2592
2593チャットの添付ファイルは PNG、JPEG、WebP、PDF に対応しています。既定の上限は、画像が 5 MiB、ドキュメントが 10 MiB、1 ターン全体で 20 MiB です。画像には Vision モデルが必要で、スキャン PDF には OCR が必要な場合があります。音声入力には OS のマイク権限と、設定済みの文字起こし Provider またはダウンロード済みのローカル Whisper モデルが必要です。
2594
2595## Design または Write が予期せず動作する
2596
2597Design の Live Preview には対応する開発サーバーへの接続が必要で、参考画像には Vision が必要です。Write は大きなファイルをセーフモードまたは一部を省略した読み取り専用コンテンツとして開く場合があります。別のエディターがドキュメントを変更した場合は、バージョンの競合を解決してください。PPT Master には Python 3.10 以降、有効な関連 Skill ディレクトリ、保存済みの元ドキュメントが必要です。
2598
2599## Schedule、Loop、電話接続が失敗する
2600
2601- Schedule: タスクが有効で、コンピューターが起動中で、依存関係が完了し、待機中の承認がないことを確認します。
2602- Loop: Trigger と Output があり、有効になっていることを確認します。Agent の呼び出しには Agent callable も必要です。
2603- Human Approval: メモリ内の待機は、アプリケーション再起動後に失われる場合があります。
2604- Phone: マスタースイッチ、QR の有効期限、WeChat ブリッジ、Telegram Bot Token を確認します。
2605
2606## MCP または Extension が反映されない
2607
2608MCP の設定変更後は、該当ランタイムを再起動します。Skill のルートとプロジェクトスコープを確認してください。Extension では、ワークスペースの信頼、権限、正確なバージョン、Diagnostics を確認します。Node または Direct DOM Extension には、より高い信頼レベルが必要です。
2609
2610問題が解決しない場合は、新しい会話、読み取り専用権限、最小入力を使って最小限の再現手順を作ります。機密情報を含まない手順とログを記録し、プロジェクトのサポートチャンネルを利用してください。
2611`,T=`---
2612slug: workspace-and-conversations
2613lang: ja
2614group: workspace-tools
2615order: 10
2616status: published
2617updatedAt: 2026-07-17
2618keywords: プロジェクト | ワークスペース | 作業ディレクトリ | 通常の会話 | 会話検索 | 名前変更 | ピン留め | 会話の移動 | アーカイブ | 復元 | 削除 | Fork | BTW | サイド会話
2619title: プロジェクト、ワークスペース、会話
2620description: 正しい作業ディレクトリを選び、プロジェクトと通常の会話を整理し、セッションを安全に移動、アーカイブ、復元、Fork します。
2621---
2622
2623Kun は作業ディレクトリを基に、エージェントがファイルを読む場所、コマンドを実行する場所、プロジェクトとして理解する範囲を決めます。会話履歴には判断を残せますが、ディスク上のファイル、Git コミット、バックアップの代わりにはなりません。作業開始前に、サイドバーと Composer に実際に使用するディレクトリが表示されていることを確認してください。
2624
2625![Code サイドバーの Projects と Conversations セクション](/docs-media/screenshots/sidebar-projects-conversations-en.webp)
2626
2627*Projects はディレクトリに紐付いた作業をまとめ、Conversations は自動管理されるワークスペースを持つ独立したチャットを保持します。*
2628
2629- 管理したいセクション内の追加と検索コントロールを使います。
2630- リポジトリの作業ではプロジェクト会話を開き、ファイルまたはコマンドツールを許可する前にパスを確認します。
2631- サイドバー項目の移動または削除は整理方法を変えますが、必ずしもディスク上のファイルを移動・削除するわけではありません。
2632
2633## プロジェクトと通常の会話を区別する
2634
2635| 種類 | 適した用途 | 作業ディレクトリ |
2636| --- | --- | --- |
2637| **Project conversation** | コードベース、Web サイト、ドキュメントリポジトリ、再利用可能なローカルディレクトリ | 選択したディレクトリに紐付き、そのプロジェクトの下に表示 |
2638| **Regular conversation** | 一時的な分析、一般的な質問、まだ分類されていない作業 | Conversation workspace を使用し、通常のプロジェクトとしては表示されない |
2639| **Write / Design workspace** | 長いドキュメントまたはデザイン成果物 | 各モードで管理。現在の Code プロジェクトだと考えなã

2639„こと |
2640
2641会話の種類によってモデル機能は変わりません。タスクがローカル内容の読み取り、書き込み、実行を行う場合は、最初にパスと権限を確認します。Code の完全なワークフローは[Code モードを使う](/docs/code)を参照してください。
2642
2643## 作業ディレクトリを選んで維持する
2644
26451. Code でローカルディレクトリを選ぶか、既存プロジェクトの下に会話を作成します。
26462. 親ディレクトリとフルパスを使って、特にコピー、外付けドライブ、worktree にある同名プロジェクトを区別します。
26473. 「エントリーポイントと既存チェックを列挙してください」のような読み取り専用の依頼から始め、エージェントに見える内容を確認します。
26484. その後にだけ、書き込み、コマンド実行、Plan の作成を始めます。
2649
2650サイドバーからプロジェクト項目を削除しても、ディスク上のプロジェクトは削除されません。逆に Finder、File Explorer、Terminal でディレクトリを移動、名前変更、切断した場合、Kun は古いパスを自動的に有効にできません。ストレージデバイスを再接続するか、有効なディレクトリを選択してください。
2651
2652> 注意: Kun が自動作成した通常の会話用ディレクトリを、長期プロジェクトとして追加しないでください。必要なファイルがある場合は、自分で明示的に管理する場所へコピーし、その場所をプロジェクトとして開きます。
2653
2654## 会話を検索、表示、識別する
2655
2656サイドバーは会話をプロジェクト別にまとめ、実行中、未読、ピン留め、アーカイブ、worktree 使用などの状態を表示します。会話検索で一覧を絞り込み、結果を開く前にタイトル、プロジェクト、パスを確認します。タイトルが同じでも、同じプロジェクトに属する証明にはなりません。
2657
2658会話の実行中に別の画面へ移動できます。戻ったら、タスク完了を想定せず、最新の状態、ツール結果、保留中の承認を読んでください。Goal、Plan、Todo、復元方法については、[長時間タスクとコンテキストを管理する](/docs/long-running-tasks)を参照してください。
2659
2660## 会話の名前変更、ピン留め、移動
2661
2662![名前変更、ピン留め、移動、アーカイブ、削除を表示する会話操作メニュー](/docs-media/screenshots/conversation-actions-en.webp)
2663
2664*会話の操作メニューでは、整理の操作と取り消せないライフサイクル操作が分かれています。*
2665

2666- Rename と Pin はナビゲーションに影響し、対応している場合、Move は会話のプロジェクトグループを変更します。
2667- Archive は履歴を保持して非表示にし、Delete は利用可能な復元経路から完全に削除します。
2668- Archive、Delete、Move の前に実行中の作業を停止し、対象の会話を確認します。
2669
2670- **Rename** は表示される会話タイトルだけを変更します。プロジェクトディレクトリ、Git ブランチ、成果物の名前は変わりません。
2671- **Pin** は頻繁に使う会話を見つけやすくします。ピンを外しても削除されません。
2672- **Move** は、その会話の今後のメッセージで使用する既定のプロジェクト作業ディレクトリを変更します。既存履歴は書き換わりません。
2673
2674Move が変えるのはメタデータです。ファイル、Checkpoint、Git worktree、生成済み成果物、以前に取得した動的コンテキストは移動しません。移動後は新しい読み取り専用確認から始め、エージェントに新しいディレクトリを伝えて、必要なファイル参照を改めて追加します。
2675
2676実行中または完了監視中の会話は移動できません。worktree に紐付いた会話もプロジェクト間で移動できません。目的のプロジェクトが送信先一覧にない場合は、似たパスを選ばず、その作業ディレクトリを追加してください。
2677
2678## アーカイブ、復元、完全削除
2679
2680会話メニューから Archive を選ぶと、履歴を Kun に保持したまま、その会話が有効なサイドバーから消えます。管理するには **Settings → Archived chats** を開きます。
2681
2682![検索、表示、復元、完全削除コントロールを備え、ワークスペース別に分類された Kun の Archived chats 設定](/docs-media/screenshots/archives-row-live-en.webp)
2683
2684*Archived chats はワークスペース別に分類されます。検索フィールド、タイトル、Restore ボタン、ゴミ箱アイコンで項目を検索、表示、アーカイブ解除、完全削除できます。*
2685
2686- 検索フィールドで一覧を絞り、操作前にワークスペースグループを確認します。会話タイトルをクリックすると保持された履歴が開きます。
2687- **Restore** をクリックすると会話のアーカイブを解除し、有効なサイドバーに戻します。ゴミ箱アイコンは完全削除を開始するもので、別の復元操作ではありません。
2688- 会話をアーカイブ、復元、削除しても、ワークスペース内のプロジェクトファイルは削除されず、エージェントがディスクへ書き込んだ変更も取り消されません。
2689
2690完全削除はアーカイブとは異なります。確認後、その会話は Kun のアーカイブ一覧から復元できません。削除前に、有用な結論をプロジェクトドキュメント、Requirement、Plan、その他のバージョン管理されたファイルへ移し、関連成果物が保存済みであることを確認します。ファイル変更を戻すには、会話削除に頼らず、Changes、Git、Checkpoint を確認してください。
2691
2692## メインの流れを Fork してサイド会話を作る
2693
2694![元のメインスレッドを表示する未送信のサイド会話 Composer](/docs-media/screenshots/branch-conversation-en.webp)
2695
2696*この初期パネルは関連質問を準備しています。送信した後にだけサイド会話が作成されます。*
2697
2698- Side / BTW の質問を送信する前に、上部に表示された元のスレッドを確認し、作成された会話でメッセージとツール操作を確認します。
2699- 未送信の Composer を閉じても何も作成されません。サイド会話の作成後、パネルを非表示または閉じても、マージ、キャンセル、削除はされません。
2700- \`/fork\` はここに表示されたコントロールではなく、独立した会話を作る別操作です。ファイル編集を分離する必要がある場合は Git worktree を使用します。
2701
2702Kun には複数の分岐方法があります。
2703
2704- \`/fork\` は現在のコンテキストから独立した会話を作り、別の方法を試す場合に役立ちます。
2705- Assistant の回答から Fork すると、その判断時点までのメッセージを保持し、以降のターンは新しいブランチに属します。
2706- \`/btw\` は現在のタスクを中断すべきでない関連質問について、メインのコンテキストを継承したサイド会話を作ります。
2707
2708サイド会話はパネルから開く、最小化、非表示にできます。現在の操作によっては、サイドの目印を外してセッションをメイン一覧に表示したり、基になるサイドセッションを破棄したりもできます。パネルを閉じる、または非表示にしても結論はメインの流れへマージされず、会話の削除と同じとは限りません。
2709
2710メインの流れに戻ったら、採用した結論、却下した内容、Goal、Plan、ファイルの更新が必要かを明示します。ブランチのファイル変更が同じ作業ディレクトリを共有する場合があるため、会話の分岐だけではコードを分離できません。ファイル単位の分離が必要な場合は、[Git と worktree](/docs/terminal-browser-and-worktrees)を使ってください。
2711
2712## Git worktree で会話を分離する
2713
2714Kun が作成または検出した Git worktree を管理するには、**Settings → Worktrees** を開きます。会話の開始時にブランチピッカーで Worktree モードを有効にし、ブランチを選びます。Kun は独立したチェックアウトの作成を試み、成功した worktree をその会話に関連付けます。
2715
2716![Kun Worktrees 設定に表示された実際のブランチ、worktree パス、会話の関連付け、Refresh、Remove コントロール](/docs-media/screenshots/worktree-row-live-en.webp)
2717
2718*この実際の worktree 行には \`docs/worktree-demo\` ブランチ、ディスク上のパス、\`Conversation: Not linked\` が表示されています。ブランチピッカーから新しい会話用に作成した worktree では、ここに会話との関連付けが表示されます。*
2719
2720- **New branch prefix** が影響するのは、その後 Kun が作成するブランチ名だけです。既存ブランチの名前や既存 worktree のパスは変わりません。
2721- 各行で実際のブランチ、フルパス、Conversation の状態を確認します。\`Not linked\` は現在関連付けられた Kun 会話がないことを意味し、ブランチがないという意味ではありません。
2722- **Refresh** は現在の Git worktree 状態を再読み込みします。Kun の外で w

2722orktree を追加または削除したり、ブランチを切り替えたりした後に使います。
2723- **Remove** は worktree のチェックアウトディレクトリを削除します。そのブランチをメインブランチへマージしません。最初に Changes と \`git status\` で未コミット・未追跡の作業を確認し、残すものをコミットまたはバックアップしてください。
2724
2725worktree が分離するのは Git のチェックアウトで、データベース、ポート、Container、クラウドリソース、システムレベルの設定は分離しません。作成、同期、マージ、クリーンアップの完全な境界については、[ワークベンチパネル、Git、worktree](/docs/terminal-browser-and-worktrees)を参照してください。
2726
2727## 古いメッセージの編集、Rewind、ファイルの復元
2728
2729ターンが実行中でないときに、過去のユーザーメッセージにカーソルを合わせ、Edit を選んで変更・再送信できます。Kun は同じ会話をそのターンまで巻き戻し、後続メッセージとキュー済み入力を削除し、編集したテキストから新しいターンを開始します。古い履歴に修正を追記する操作ではありません。
2730
2731そのターンに Workspace Checkpoint がある場合、編集・再送信はまず対応するファイル状態の復元を試みます。復元失敗時は再送信を停止し、成功した復元では後続のファイル変更も破棄される可能性があります。最初に Changes を確認し、必要なものをコミットまたはバックアップしてください。現在の経路を保ったまま別のプロンプトを試す場合は、かなり古いメッセージを編集せず Fork を優先します。
2732
2733Assistant の回答にある **Restore workspace** は別の操作です。会話を書き換えず、関連する Git Checkpoint からディスク状態を復元します。Kun は確認を求めます。一部の Checkpoint で大きな未追跡ファイルが除外された場合、リスクを列挙して再度確認します。続行すると、最初に救済用 Checkpoint が作成されます。その後 \`git status\`、差分、プロジェクトチェックを確認してください。救済ポイントは恒久的なバックアップではありません。
2734
2735> 違いを明確にしてください。Rewind は会話のタイムラインを変更し、Checkpoint はファイル状態を変更し、Fork は別の会話経路を保持します。いずれも通常の Git コミットと外部バックアップの代わりにはなりません。
2736
2737## 安全な整理手順を作る
2738
2739- 「new chat」や「test」のような曖昧なラベルではなく、成果と範囲が分かるタイトルを使います。
2740- 重要な制約はチャット履歴だけでなく、Requirement またはプロジェクトファイルにも保存します。
2741- Move、Fork、Rewind、Restore の後は、ディレクトリ、ブランチ、モデル、権限を再確認します。
2742- タスクの最後にファイルを保存し、チェックを実行し、Changes を確認してから会話をアーカイブします。
2743- 完全削除前に、判断、添付ファイル参照、検証結果が未保存のまま残っていないことを確認します。
2744
2745会話管理が答えるのは「この作業をどこで続けるか」です。ファイルの安全性を証明するものではありません。書き込み、コマンド、外部サービスについては、引き続き[ワークスペースの権限とセキュリティ](/docs/workspace-permissions-security)に従ってください。
2746`,f=`---
2747slug: workspace-permissions-security
2748lang: ja
2749group: safety-help
2750order: 10
2751status: published
2752updatedAt: 2026-07-17
2753keywords: ワークスペース | 権限モード | ローカル優先 | プライバシー | フルアクセス | セキュリティ
2754title: ワークスペースの権限とセキュリティ
2755description: ツール権限モードを選び、ローカル実行、外部モデルへのリクエスト、Extension の信頼に関する実際の境界を理解します。
2756---
2757
2758Kun は設定、会話状態、ログ、作業データをコンピューターに保存し、ローカルランタイムを通じてエージェントループを実行します。「ローカル優先」は「完全オフライン」という意味ではありません。モデルへのリクエストや有効にした外部ツールは、それぞれのサービスに接続します。
2759
2760![利用可能なツールアクセスモードを表示する権限設定](/docs-media/screenshots/settings-permissions-en.webp)
2761
2762*Settings → AI assistant → Access を開くと、ツールアクセスと承認プロンプトの既定の上限を定める Permissions セクションが表示されます。*
2763
2764- 機密性の高い操作や書き込みをレビューできるモードから始め、信頼できる範囲の限定されたタスクでのみアクセスを引き上げます。
2765- モード変更前に、現在のワークスペースと会話を再確認します。通常、変更は次のターンから適用されます。
2766- 権限コントロールは許可される操作を制限または拡張しますが、操作を正しいものや取り消し可能なものにはしません。
2767
2768## 6 つのツール権限モード
2769
2770権限の変更は通常、次の会話ターンから適用されます。
2771
2772- **Always ask:** すべてのツール呼び出しを確認します。最も慎重で、最も頻繁に中断されるモードです。

2773- **Read only:** 読み取りツールは自動実行されます。書き込み、編集、コマンドは事前確認が必要で、読み取りはワークスペース内の内容に限定されます。
2774- **Sensitive operations ask:** 通常の読み取りは自動実行され、機密性の高い操作は事前確認が必要です。
2775- **Ask for workspace writes:** ワークスペースのファイル変更は事前確認が必要です。ワークスペース外への書き込みとホストコマンドは引き続きブロックされます。
2776- **Trusted workspace:** ワークスペース内のファイル変更はプロンプトなしで実行されます。ワークスペース外への書き込みとホストコマンドは引き続きブロックされます。
2777- **Full access:** 確認せず、フルアクセスを許可します。最もリスクの高いモードで、完全に信頼できるタスクと環境でのみ使用します。
2778
2779> 警告: Full access では、重要な操作前に確認する機会がなã

2779ãªã‚Šã¾ã™ã€‚不慣れなプロジェクト、機密性の高い認証情報を含むディレクトリ、範囲が不明確なタスクで、承認を避けるためだけに使用しないでください。
2780
2781不慣れなリポジトリを開くときは、Read only または Sensitive operations ask から始めます。権限はモデル品質の設定ではありません。書き込みを許可してもモデルの精度は上がらず、実行できる操作が増えるだけです。
2782
2783## ワークスペースの境界
2784
2785特に似た名前のフォルダー、外付けドライブ、worktree を扱う場合は、サイドバーに表示されたプロジェクトパスを確認します。現在のワークスペース外にある無関係なパスを許可しないでください。リポジトリの入手元とビルドスクリプトを理解した後にだけワークスペースを信頼します。
2786
2787Plan モードは調査と進め方の提案に使います。ファイルを変更したり、副作用のあるコマンドを実行したりしてはいけません。計画から実装へ移る際は、モード、ワークスペース、権限ポリシーを再確認します。Plan に書かれたコマンドは実行許可ではありません。
2788
2789## 認証情報と外部サービス
2790
2791API キー、Token Plan 認証情報、Bot トークン、Webhook シークレット、OAuth 許可は機密情報です。チャットメッセージ、要件、プロジェクトファイル、スクリーンショット、ログに貼り付けないでください。モデル Provider は、リクエストの完了に必要なプロンプトと関連コンテキストを受け取ります。その Provider のプライバシー条件に応じてデータ範囲を選んでください。
2792
2793Provider Profile の API キーは、対応環境では保護された認証情報ストレージを使用します。ただし、カスタムメディアキー、ランタイムトークン、電話チャンネルの認証情報は通常のローカル設定に残る場合があります。MCP の環境変数とヘッダーは \`~/.kun/mcp.json\` に平文で保存さã

2793‚Œã¾ã™ã€‚設定ファイル、ローカルアカウント、デバイスのバックアップ、診断情報を機密データとして扱ってください。
2794
2795HTTP または SOCKS プロキシ、MCP サーバー、メッセージブリッジも内容を扱う場合があります。信頼できるサービスだけを有効にし、使わなくなったトークンを無効化してください。
2796
2797## Computer Use
2798
2799![デスクトップアクセス要件を表示する Computer Use 設定](/docs-media/screenshots/settings-computer-use-en.webp)
2800
2801*Computer Use は通常のプロジェクトツールに加え、画面、マウス、キーボードの操作を可能にします。*
2802
2803- 目に見えるデスクトップ操作が必要なタスクでのみ有効にし、OS の権限状態を確認します。
2804- 操作はリポジトリファイルに限定されないため、非公開のウィンドウと無関係なアプリケーションを閉じます。
2805- 対象を監視し、動作が意図から外れたら停止します。アクセスを無効にしても、完了済みのクリックや送信は取り消せません。
2806
2807Computer Use は画面を取得し、実際のマウスとキーボードを操作できるため、通常のファイルツールよりリスクが高くなります。macOS ではアクセシビリティと画面収録へのアクセスが必要で、許可後に Kun の完全な再起動が必要な場合があります。監視して停止できる信頼済みの作業でだけ一時的に有効にします。パスワードマネージャー、非公開チャット、本番コンソールを先に閉じ、支払い、公開、認可、完全削除、その他の取り消しが難しいアカウント操作には決して使用しないでください。3 つの公開モードについては、[Agent、サブエージェント、Memory](/docs/agents-subagents-and-memory#computer-use-を慎重に有効にする)を参照してください。
2808
2809## Extensions、自動化、スクリプト
2810
2811Skill にはスクリプトを含められ、MCP \`stdio\` サーバーはローカルプロセスを起動でき、Node Extension は OS のコードを実行できます。画面上の権限一覧は完全な OS サンドボックスではありません。Direct DOM Extension は特にリスクが高いため、まずソースを調べ、機密性のないワークスペースでテストしてください。
2812
2813Workflow の JavaScript、Python、Shell、HTTP、Webhook、Hook ノードにも、ローカルまたは外部への副作用があり得ます。Hook は Agent フローを監視、ブロック、書き換えでき、再帰する場合があります。Human Approval の待機がアプリ再起動後も維持される保証はありません。Workflow を有効にする前に、入力、シークレット、再試行と失敗ポリシー、すべての出力先を確認してください。実行可能なキャンバスはセキュリティレビュー済みという意味ではありません。
2814
2815## ロールバック、worktree、削除
2816
2817Conversation Rewind、Fork、Git Checkpoint、Worktree は、4 つの異なる仕組みです。メッセージを巻き戻してもディスク上のファイルは復元されない場合があります。Checkpoint の復元ではファイルが除外され、救済ポイントが作られる場合があります。Fork がコピーするのはコンテキストだけです。Worktree は Git のチェックアウトを分離しますが、データベース、ポート、クラウドリソース、システム設定は分離しません。
2818
2819> 強い警告: Settings で Worktree を **Remove** すると、2 回目の確認なしでチェックアウトが強制削除されます。未コミットと未追跡の内容が直ちに失われる可能性があります。使用前に Changes と \`git status\` を確認し、必要なものをすべてコミットまたはバックアップしてください。
2820
2821## 移行と削除
2822
2823データ移行はリリースによって制限され、Stable ビルドでは利用できない場合があります。対応ビルドには利用可能なエクスポート範囲が表示されます。API、OAuth、システムの認証情報と信頼状態は、移行パッケージに含めるべきではありません。保護されたパッケージのパスワードを失うと復元でã

2823ã¾ã›ã‚“。アーカイブ済み会話は復元できますが、完全削除は通常取り消せません。
2824
2825承認チェックリストについては、[レビューと承認](/docs/review-and-approvals)を参照してください。
2826`,D=`---
2827slug: write
2828lang: ja
2829group: modes
2830order: 30
2831status: published
2832updatedAt: 2026-07-17
2833keywords: Write | Writing Space | Markdown | PDF | AI 編集 | エクスポート | PPT
2834title: Write モードを使う
2835description: 専用の執筆スペースでドキュメントを編集し、資料を調査し、AI の変更をレビューして、一般的な形式にエクスポートします。
2836---
2837
2838Write はコードプロジェクトとは別の執筆ワークスペースです。記事、製品ドキュメント、調査メモ、プレゼンテーション資料に利用できます。複数の Writing Space を管理でき、ファイルツリーではテキストファイルの作成、名前変更、削除と、画像や PDF の読み取り専用表示ができます。スペースを選び、新しい下書きを作るか既存の内容を開いてください。
2839
2840![Writing Spaces、welcome ファイル、New draft、AI にアウトラインを依頼する操作が表示された Write の開始ワークスペース](/docs-media/screenshots/write-workspace-en.webp)
2841
2842*画像の **No file open** 状態では、編集前にも現在の Writing Space、ウェルカムカード、**New draft**、**Ask AI for an outline**、**Refresh tree**、**Switch space** が表示されます。*
2843
2844- 空のドキュメントには **New draft** を選ぶか、現在のスペースから \`welcome.md\` を開きます。ドキュメント操作で扱う内容を得るには、Assistant に開いているドキュメントが必要です。
2845- **Refresh tree** は外部で変更されたファイルを再読み込みし、**Switch space** は現在の Code プロジェクトではなく執筆ルートを切り替えます。
2846- 同名のファイルを編集したりスペースを切り替えたりする前に、フルパスと保存状態を確認します。
2847- 画像と PDF は資料として利用できますが、Markdown やテキストのように直接編集はできません。
2848
2849[実際の Write モードのウォークスルー](/docs-media/write.mp4)
2850
2851## 表示と保存
2852
2853ファイルやバージョンに応じて、Rich、Live、Source、Split、Preview でリッチ編集、Markdown ソース、ライブ出力、または両方を表示できます。行番号、折り返し、フォントサイズ、Focus、閲覧状態も調整できます。主に編集できるのは Markdown、MDX、テキストで、画像と PDF は直接編集できません。
2854
2855![Writing Space ツリー、ドキュメントエディター、Writing Assistant の 3 列構成でリリースノートを編集中の Kun Write](/docs-media/screenshots/write-editor-live-en.webp)
2856
2857*実際の編集状態には 3 つの領域があります。左側でスペースとファイルを管理し、中央で現在のドキュメントを編集し、右側の Assistant でファイルまたは選択範囲のコンテキストを扱います。*
2858
2859- 最初に左のツリーでスペースと選択中のファイルを確認します。ファイル行には Finder などで表示、名前変更、削除の操作があり、スペース行ではファイルやフォルダーの作成、外部変更の更新ができます。

2860- 中央のヘッダーには、ファイル名、行数、文字数、表示モード、文字サイズ、保存状態が表示されます。**Saved** は現在のディスク上のバージョンと同期済みであることを意味します。**Unsaved** の作業から離れる前に、保存を待つか実行してください。
2861- 右の Assistant には現在のファイル名が表示され、**Summarize document**、**Draft an outline**、**Polish selection** を利用できます。別の Writing Space にあるすべてのファイルを暗黙に読み込むことはありません。
2862
2863Write は保存状態と自動保存の動作を表示しますが、エクスポート、外部エディターへの切り替え、広範囲な AI 編集を行う前に、最新の内容がディスクに保存されていることを確認してください。
2864
2865別のアプリケーションがファイルを変更した場合は、どちらを残すか決める前にバージョンを比較してください。レビューせずに自動保存で新しい正しい編集を上書きしないでください。
2866
2867## AI Assistant を使う
2868
2869![保存済みドキュメントと Summarize、Draft、Polish 操作が表示された、準備完了状態の Writing Assistant](/docs-media/screenshots/write-editor-ai-en.webp)
2870
2871*編集を依頼する前の準備完了状態です。Assistant はドキュメントに紐付いていますが、インライン提案や赤・緑の差分はまだ表示されていません。*
2872
2873- **Summarize document** と **Draft an outline** はドキュメントのコンテキストを使います。**Polish selection** でã

2873¯ã€æœ‰ç”¨ãªæœ€å°ç¯„囲を選択し、読者、意図、変更してはいけない事実を指定します。
2874- Diff Review は選択範囲の編集結果が返された後にだけ表示されます。画像の **Saved** は現在のファイル状態を表し、AI の提案を採用したことを意味しません。
2875- インライン補完は別のフローです。表示された灰色のテキストを採用するには \`Tab\`、非表示にするには \`Esc\` を押します。
2876- Assistant は構造や表現を改善できますが、引用、主張、リンク、書式には引き続き人による確認が必要です。
2877
2878![書式、Add quote、執筆 Skill、カスタム Writing Agent の設定項目を表示する Kun Write の選択メニュー](/docs-media/screenshots/write-selection-live-en.webp)
2879
2880*選択メニューはハイライトした箇所だけに作用します。上部に書式、中央に引用とクイック Skill があり、カスタム Writing Agent は Settings から追加します。*
2881
2882- **Normal text** メニューで段落スタイルを設定します。太字、斜体、取り消し線、インラインコードが変えるのは書式だけです。**Add quote** は選択範囲を Assistant のコンテキストに送りますが、それだけで検証済みの引用になるわけではありません。
2883- **Polish**、**Explain**、**Reformat**、**Distill**、**Bolder**、**Quieter**、**Critique** は選択範囲を使って AI 操作を開始します。選択範囲を狭く保ち、**Unsaved** 状態に注意して、返された Diff を採用前に確認してください。
2884- 再利用可能な役割、トーン、ルールセットには、**Add a writing agent in Settings** を選びます。Write に戻り、設定した Agent を呼び出す前に対象箇所を再選択します。
2885
2886テキストを選択して、推敲、再構成、要約、強いまたは控えめなトーン、批評、説明を依頼できます。カスタムプロンプトでは読者と望む結果を指定できます。インライン編集には比較が表示されます。ドキュメント全体を一度に採用するより、箇所ごとに採用または拒否する方が安全です。
2887
2888Write Assistant は、現在のファイル、選択範囲、PDF ページ、その他の資料を参照できます。事実に基づく文章では、主張の根拠を示すよう依頼し、元資料でその主張を確認してください。
2889
2890しばらく入力しないと、インライン候補が灰色の補完として表示されます。\`Tab\` で採用、\`Esc\` で非表示、\`Cmd/Ctrl+Shift+Space\` で明示的に候補を要求できます。ドキュメント横断検索では、用語と事実の一貫性を保つため、高速な BM25 / キーワード検索の抜粋を使います。これはベクトルデータベースではなく、情報源の検証に代わるものでもありません。
2891
2892Continuity、Coordinator、Editor、Foreshadowing の各ペルソナは、それぞれ異なる執筆役割を担い、カスタム Agent は Settings で追加できます。選択範囲を編集すると Diff Review に入り、個別または一括で採用・拒否できます。採用前にリンク、引用、書式、固有名詞を確認してください。
2893
2894## PDF と画像を読む
2895
2896PDF リーダーはページ移動、ズーム、検索、前後の一致箇所への移動、テキスト選択に対応します。選択したテキストとページコンテキストを Assistant に送って説明を求められます。スキャンされた PDF では OCR を利用する場合があり、画像の理解には Vision モデルが必要です。大きなファイルはセーフモードまたは一部を省略した読み取り専用コンテンツとして開く場合があります。ファイルを分割するか、必要な部分だけを渡してください。
2897
2898![ズーム、Fit、システムで開く操作、画像メタデータを備えた実際の画像プレビューで PNG を表示する Kun Write](/docs-media/screenshots/write-image-preview-live-en.webp)
2899
2900*画像は読み取り専用プレビューで開きます。上部バーでズームと **Fit** を操作し、右上のボタンでシステムアプリからファイルを開き、フッターで MIME タイプ、ファイルサイズ、ピクセル寸法を確認できます。*
2901
2902- マイナス、スライダー、プラスで細部を確認し、**Fit** で画像全体をビューポート内に戻します。これらはプレビュー倍率だけを変更し、元画像は変更しません。
2903- 外部で開くボタンは、注釈や編集のためにシステムの既定アプリケーションを使用します。Kun に戻ったら、ファイルツリーを更新してアプリ外での変更を読み込みます。
2904- \`image/png\`、ファイルサイズ、\`1440 × 900\` などのフッター値は、形式と解像度の確認に役立ちます。AI に画像の確認を依頼する前に、選択した Provider とモデルが画像入力に対å¿

2904œã—ていることも確認してください。
2905
2906[実際の PDF 調査のウォークスルー](/docs-media/pdf-research.mp4)
2907
2908## エクスポート
2909
2910現在の Write のエクスポート機能は、HTML、PDF、PNG、DOC、DOCX と、リッチテキストのコピーに対応しています。HTML Prototype では、適切な内容をインタラクティブなプレビューにできます。正確な選択肢はコンテンツとランタイム環境によって異なります。作成できたことだけを確認するのではなく、成果物を開いてページ分割、フォント、画像、リンク、コードブロックを確認してください。
2911
2912![オンラインドキュメント、HTML、PDF、PNG、DOC、DOCX に対応する実際の Kun Write エクスポートメニュー](/docs-media/screenshots/write-export-live-en.webp)
2913
2914*上部バーの **Export** メニューでは、**Copy for online docs** と 5 つのファイル形式がまとまっています。現在のドキュメントを保存してから、納品先に合った形式を選びます。*
2915
2916- **Copy for online docs** は、オンラインエディターに貼り付けるためのリッチコンテンツを作ります。HTML は Web 構造を保ち、PDF と PNG は固定レイアウトの出力、DOC / DOCX はワープロで編集可能な形式です。
2917- エクスポートの成功はレイアウトの承認ではありません。成果物を開き、見出し、ページ分割、フォントのフォールバック、画像品質、リンク、リスト、コードブロックをページごとに確認してください。
2918- 指定された形式はそれぞれ個別にレビューします。正しい PDF が、DOCX やオンラインドキュメントへ貼り付けた内容と同じように表示されるとは限りません。
2919
2920## PPT Master
2921
2922スライドを生成する前に、アウトライン、枚数、対象者、ビジュアルの方向性を確認します。PPT Master には Python 3.10 以降が必要で、分離された依存環境をインストールして使用します。元の Markdown を編集することなく、Writing Space の \`presentations/\` ディレクトリにネイティブ編集可能な \`.pptx\` を書き出します。利用できない場合は、関連する Skill ディレクトリが有効か確認し、[トラブルシューティング](/docs/troubleshooting)を参照してください。
2923
2924自動保存、タイポグラフィ、選択操作、インライン候補モデル、調整項目については、[作業モードと Terminal の設定](/docs/mode-and-tool-settings)を参照してください。
2925`,K=Object.assign({"../../../content/docs/ja/agents-subagents-and-memory.md":n,"../../../content/docs/ja/code.md":e,"../../../content/docs/ja/commands-and-shortcuts.md":o,"../../../content/docs/ja/composer-attachments-and-context.md":s,"../../../content/docs/ja/connect-phone.md":t,"../../../content/docs/ja/data-updates-and-diagnostics.md":r,"../../../content/docs/ja/design.md":i,"../../../content/docs/ja/faq.md":a,"../../../content/docs/ja/feature-overview.md":d,"../../../content/docs/ja/first-task.md":l,"../../../content/docs/ja/general-and-desktop-settings.md":c,"../../../content/docs/ja/initial-setup.md":u,"../../../content/docs/ja/install.md":g,"../../../content/docs/ja/long-running-tasks.md":p,"../../../content/docs/ja/loops.md":m,"../../../content/docs/ja/media-generation.md":P,"../../../content/docs/ja/mode-and-tool-settings.md":h,"../../../content/docs/ja/plugins-skills-extensions.md":w,"../../../content/docs/ja/providers-and-models.md":k,"../../../content/docs/ja/requirement-workflow.md":C,"../../../content/docs/ja/review-and-approvals.md":S,"../../../content/docs/ja/schedules.md":v,"../../../content/docs/ja/settings-overview.md":A,"../../../content/docs/ja/terminal-browser-and-worktrees.md":b,"../../../content/docs/ja/troubleshooting.md":M,"../../../content/docs/ja/workspace-and-conversations.md":T,"../../../content/docs/ja/workspace-permissions-security.md":f,"../../../content/docs/ja/write.md":D});export{K as default};

Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.