deepseek-harness/docs/tool-catalog.zh.md

<!-- 闍ｱ譁�ｺ先枚莉ｶ逕ｱ scripts/gen-tool-catalog.ts 逕滓��帶悽荳ｭ譁�枚莉ｶ譏ｯ騾夊ｿ�曙隸ｭ驟榊ｯｹ扈ｴ謚､逧�ｻ剰ｯ�ｮ｡蟇ｹ萓ｧ縲�
     譖ｴ譁ｰ譌ｶ蜈郁ｿ占｡� `pnpm run gen-tool-catalog` 譖ｴ譁ｰ闍ｱ譁�ｼ悟�譖ｴ譁ｰ譛ｬ譁�ｻｶ蟷ｶ霑占｡� `pnpm run verify-translation-pairing --write docs/tool-catalog.md` 驥肴眠隶ｰ蠖暮�蟇ｹ縲� -->

# 蟾･蜈ｷ Schema 逶ｮ蠖�

[English](tool-catalog.md) | 荳ｭ譁�

蟾ｲ蜿大ｸ�薯莉ｶ蜷� `ctx.tools` 謠蝉ｾ帷噪謇€譛蛾擇蜷第ｨ｡蝙狗噪蟾･蜈ｷ�壽ｨ｡蝙矩€夊ｿ�ｳｻ扈滓署遉ｺ隸咲ｻ�｣�執蠕礼噪 `name`縲～description` 蜥� JSON Schema `parameters`縲よ悽逶ｮ蠖墓弍[蟄千ｳｻ扈滄｡ｵ髱｢](subsystems/core.md)�育ｱｻ蝙句所豈城｡ｵ逕滓�逧� `cordis-surface` 謗･郤ｿ蛹ｺ蝓滂ｼ臥噪陦･蜈�ｼ帶悽鬘ｵ蛻怜�逧�弍蜷� agent�域匱閭ｽ菴難ｼ画署萓帷噪*蟾･蜈ｷ*縲�

闍ｱ譁�ｺ先枚莉ｶ逕ｱ邉ｻ扈�**逕滓�**�悟ｹｶ騾夊ｿ� `pnpm run verify-tool-catalog`��doc-sync`�域枚譯｣蜷梧ｭ･髣ｨ遖�ｼ臥噪荳€驛ｨ蛻�ｼ蛾ｪ瑚ｯ∵眠魎懷ｺｦ�帶悽荳ｭ譁�枚莉ｶ菴應ｸｺ扈剰ｯ�ｮ｡蟇ｹ萓ｧ騾夊ｿ�曙隸ｭ驟榊ｯｹ扈ｴ謚､縲ゆｸ� Cordis 逶ｮ蠖包ｼ育ｺｯ貅千�� AST 螟�炊�我ｸ榊酔�瑚恭譁�函謌仙勣莨壼惠逵溷ｮ樔ｸ贋ｸ区枚荳ｭ**蜷ｯ蜉ｨ**豈丈ｸｪ蟾･蜈ｷ謠剃ｻｶ蟷ｶ隸ｻ蜿� `ctx.tools.schemas()`�悟屏荳ｺ蟾･蜈ｷ schema 譌�豕暮€夊ｿ�撕諤∝�譫仙ｮ悟�遑ｮ螳夲ｼ御ｾ句ｦりｿ占｡梧慮螻募ｼ€逧�椢荳ｾ縲∵蕎謗･逧�緒霑ｰ縲∫罰驟咲ｽｮ蜀ｳ螳夂噪蜷咲ｧｰ莉･蜿贋ｽｿ逕ｨ蜴溷ｧ� JSON Schema 逧� MCP 蟾･蜈ｷ縲ょｮ梧紛諤ｧ螳亥梱莨� glob 蛹ｹ驟� `packages/*/tool-*`�帛ｦよ棡逕滓�蝎ｨ逧�星蜉ｨ manifest�亥�謨ｰ謐ｮ貂�黒�蛾＠貍丈ｻｻ菴募桁�梧｣€譟･蟆ｱ莨壼､ｱ雍･�悟屏豁､譁ｰ蟾･蜈ｷ荳堺ｼ壼惠譌�莠ｺ蟇溯ｧ臥噪諠��荳狗ｼｺ蟆第枚譯｣縲ょ盾隗ー蟾･蜈ｷ schema 逶ｮ蠖� Agent Note](../.agents/notes/implemented/process/2026-07-02-tool-schema-catalog.md)縲�

闌�峩�啻packages/*/tool-*` 荳句ｷｲ蜿大ｸ�噪莠ｧ蜩∝ｷ･蜈ｷ�梧ｯ丈ｸｪ蟾･蜈ｷ蝮�ｽｿ逕ｨ蜈ｶ**鮟倩ｮ､**驟咲ｽｮ蜷ｯ蜉ｨ�帑ｽ�ｦよ棡譟蝉ｸｪ Config 蟄玲ｮｵ譏ｯ**蠢�｡ｫ鬘ｹ**荳疲ｲ｡譛蛾ｻ倩ｮ､蛟ｼ�檎函謌仙勣蟆ｱ蠢�｡ｻ菴懷�騾画叫�悟ｯｹ蠎泌桁逧�ｯｴ譏惹ｼ夊ｮｰ蠖墓悽鬘ｵ螻慕､ｺ逧�弍蜩ｪ荳ｪ蛻�髪縲よｳｨ蜀檎噪蟾･蜈ｷ**蜷咲ｧｰ**蜿ｯ莉･譏ｯ蜉�霓ｽ譌ｶ驟咲ｽｮ�御ｾ句ｦ� `tool-subagent` 逧� `toolName`�悟屏豁､驛ｨ鄂ｲ蜿ｯ閭ｽ莉･荳榊酔蜷咲ｧｰ謌夜｢晏､門錐遘ｰ謠蝉ｾ帶汾荳ｪ蛹�ｼ帛ｦよ棡蟄伜惠髫丈ｺｧ蜩∝書蟶�噪蛻ｫ蜷搾ｼ悟ｯｹ蠎泌桁逧�ｯｴ譏惹ｼ壻ｺ井ｻ･隶ｰ蠖輔€Ａexamples/` 荳ｭ逧�ｼ皮､ｺ蟾･蜈ｷ�井ｾ句ｦ� `echo`�我ｸ榊惠闌�峩蜀�ｼ瑚ｿ吩ｸ� Cordis 逶ｮ蠖穂ｻ�ｶｵ逶門桁逧�激蝗ｴ荳€閾ｴ縲�

## 蟾･蜈ｷ蛹�丐蟆�

荳玖｡ｨ蟆�ｨ｡蝙句庄隗∫噪蟾･蜈ｷ蜷咲ｧｰ荳主�閭悟錘逧�薯莉ｶ蛹�柱譛榊苅 seam 蟇ｹ蠎碑ｵｷ譚･縲ょ推蛹�ｫ�闃る囂蜷守ｻ吝�遑ｮ蛻�噪 JSON Schema縲�

| 蟾･蜈ｷ蛹� | 讓｡蝙句庄隗∝錐遘ｰ | 萓晁ｵ� | 蜀吝��丞ｽｱ蜩� | 髫丈ｺｧ蜩∝書蟶�噪蛻ｫ蜷� | 驛ｨ鄂ｲ隸ｴ譏� |
| --- | --- | --- | --- | --- | --- |
| `@deepseek-ai/dsh-tool-ask-user` | `ask_user_question` | `ctx.tools`縲～ctx.userInteraction` | `tool/call`縲～tool/result after a UI/provider answers the question` | - | ask_user_question 莨壽嘯蛛懷ｷ･蜈ｷ隹�畑�檎峩蛻ｰ蠖灘燕 UI 謠蝉ｾ帶婿霑泌屓莠ｺ邀ｻ遲疲｡医€� |
| `@deepseek-ai/dsh-tools` | `run_code` | `ctx.tools`縲～ctx.codeRuntime (execution time)`縲～ctx.systemPrompt` | `tool/call`縲～one tool/code-dispatch-start + tool/code-dispatch pair per bridged sub-call`縲～tool/result` | - | 蝨ｨ `mode: code`�汁mode: both` 荳具ｼ悟ｮ�罰蟾･蜈ｷ豕ｨ蜀瑚｡ｨ謇€譛会ｼ御ｽ應ｸｺ蜿ｯ霑�ｻ､閭ｽ蜉帛ｱゆｹ句､也噪菫晉蕗莨�霎捺惻蛻ｶ�亥盾隗� Code Mode Agent Note�峨€ょ惠 `code` 荳具ｼ悟ｮ�弍豕ｨ蜀瑚｡ｨ蟇ｹ蜊剰ｮｮ譬ｼ蠑擾ｼ�ire format�臥噪蜚ｯ荳€雍｡迪ｮ�帛�莉門庄隗∬�蜉帛惠菴ｿ逕ｨ蟾ｲ蜉�霓ｽ霑占｡梧慮隸ｭ險€逕滓�逧� SDK 遶�闃ゆｸｭ螢ｰ譏弱€らｨ句ｺ城€夊ｿ� binding 隹�畑霑吩ｺ幄�蜉幢ｼ瑚ｰ�畑謖臥�蜴溽函蟷ｶ蜿醍ｺｦ螳夊ｰ�ｺｦ�壼星蜉ｨ鬘ｺ蠎丞柱遲也払驕ｵ蠕ｪ謠蝉ｺ､鬘ｺ蠎擾ｼ悟ｹｶ蜿大ｮ牙�逧��謨ｰ菴捺怙螟夐㍾蜿�謇ｧ陦� `maxParallelSubCalls` 荳ｪ縲りｰ�畑莨夐㍾譁ｰ霑帛�螳梧紛荳泌女螳亥梱菫晄侃逧�ｷ･蜈ｷ豬∵ｰｴ郤ｿ�悟ｹｶ蟆�ｯ丈ｸｪ蠏悟･玲鴬陦悟�閨泌芦豁､螟門ｱらｻ捺棡縲� |
| `@deepseek-ai/dsh-plan-mode` | `exit_plan_mode` | `ctx.tools`縲～ctx.systemPrompt`縲～ctx.userInteraction (execution time, opportunistic)` | `tool/call`縲～plan/mode inactive on an approved review`縲～tool/result` | - | 隗��譛ｪ豼€豢ｻ譌ｶ�憩xit_plan_mode 莉堺ｿ晉蕗蝨ｨ髱｢蜷第ｨ｡蝙狗噪 schema 荳ｭ�瑚ｿ呎�ｷ迥ｶ諤∬ｽｬ謐｢荳堺ｼ壼惠隗��遲也払蜿俶峩荵句､夜｢晏､夜€�謌仙ｷ･蜈ｷ逶ｮ蠖募序蜉ｨ縲ょ�謇ｧ陦瑚ｷｯ蠕�ｼ壽拠扈晁ｧ��讓｡蠑丈ｹ句､也噪隹�畑�帛惠隗��讓｡蠑丈ｸ具ｼ悟ｮ�€夊ｿ�畑謌ｷ莠､莠� seam 謠蝉ｺ､隶｡蛻抵ｼ域音蜃�ｼ乗�ｹ謐ｮ蜿埼ｦ育ｻｧ扈ｭ隗���会ｼ梧音蜃�錘莨壼惠豁･鬪､霎ｹ逡瑚ｮｰ蠖戊ｧ��讓｡蠑丞ｷｲ蛛懃畑縲� |
| `@deepseek-ai/dsh-tool-bash` | `bash` | `ctx.tools`縲～ctx.bash`縲～ctx.systemPrompt`縲～ctx.bashEnv`縲～ctx.tasks at call time for run_in_background` | `tool/call`縲～tool/result` | - | bash 蟾･蜈ｷ譏ｯ bash 謇ｧ陦悟勣 seam 髱｢蜷第ｨ｡蝙狗噪豸郁ｴｹ譁ｹ縲ゆｽｿ逕ｨ `run_in_background` 逧�ｿ占｡御ｼ壽ｳｨ蜀悟芦騾夂畑 `ctx.tasks` 霑占｡梧慮�悟ｹｶ騾夊ｿ� `task_*` 蟾･蜈ｷ�域擂閾ｪ `@deepseek-ai/dsh-tool-tasks`�画噺髮�ｼ丞●豁｢�帷ｦ∫畑 `enableRunInBackground` 驟咲ｽｮ�磯ｻ倩ｮ､荳ｺ true�牙錘�瑚ｯ･蜿よ焚莨夊｢ｫ螳悟�遘ｻ髯､縲� |
| `@deepseek-ai/dsh-tool-pwsh` | `pwsh` | `ctx.tools`縲～ctx.bash`縲～ctx.systemPrompt`縲～ctx.bashEnv`縲～ctx.tasks at call time for run_in_background` | `tool/call`縲～tool/result` | - | pwsh 蟾･蜈ｷ譏ｯ Windows 扈�粋荳ｭ bash 謇ｧ陦悟勣 seam 逧� PowerShell 譁ｹ險€豸郁ｴｹ譁ｹ�育罰 `@deepseek-ai/dsh-pwsh-local` 遲� PowerShell 謇ｧ陦悟勣荳ｺ `ctx.bash` 謠蝉ｾ帛錘遶ｯ�会ｼ幃勁豐咏ｮｱ謗･蜿｣螟厄ｼ悟ｮ�€宣｡ｹ蟇ｹ蠎� bash 蟾･蜈ｷ隹�畑縲ゆｽｿ逕ｨ `run_in_background` 逧�ｿ占｡御ｼ壽ｳｨ蜀悟芦騾夂畑 `ctx.tasks` 霑占｡梧慮�悟ｹｶ騾夊ｿ� `task_*` 蟾･蜈ｷ謾ｶ髮�ｼ丞●豁｢�帶汚邂｡逧� `DSH_*` 邇ｯ蠅�擂閾ｪ `@deepseek-ai/dsh-bash-env`縲よｯ乗ｬ｡隹�畑驛ｽ蝨ｨ譁ｰ霑帷ｨ倶ｸｭ霑占｡鯉ｼ御ｸ堺ｽｿ逕ｨ謖∽ｹ� PTY 莨夊ｯ昴€りｷｯ蠕�㊦逕ｨ蜴溽函 `C:\...` 蠖｢蠑擾ｼ悟序驥城㊦逕ｨ `$env:NAME`縲� |
| `@deepseek-ai/dsh-tool-cordis` | `cordis_inspect`縲～cordis_mount`縲～cordis_unmount` | `ctx.tools` | `tool/call`縲～tool/result`縲～process-local temporary Plugin lifecycle` | - | 荳榊惠莉ｻ菴暮囂莠ｧ蜩∝書蟶�噪譬台ｸｭ�碁怙隕∵怏諢城€画叫蜷ｯ逕ｨ�帑ｸｴ譌ｶ Plugin 莉｣遐∝庄莉･隶ｿ髣ｮ逵溷ｮ櫁ｿ占｡梧慮�瑚ｧ� .agents/notes/implemented/feature/2026-07-08-self-referential-cordis-toolset.md縲ら罰 cordis_mount 蛻帛ｻｺ逧�薯莉ｶ蝨ｨ蜊ｸ霓ｽ謌� DSH 驥榊星荵句燕蜿ｯ莉･豕ｨ蜀�**鬚晏､也噪**讓｡蝙句庄隗∝ｷ･蜈ｷ�帛書逕溯ｿ咏ｱｻ蟾･蜈ｷ髮�序譖ｴ譌ｶ�檎ｳｻ扈滉ｼ夊ｮｰ蠖募ｮ梧紛荳疲怏蜿伜勘逧�ｯｷ豎ょ､ｴ縲� |
| `@deepseek-ai/dsh-tool-bash-persistent` | `bash` | `ctx.tools`縲～ctx.pty`縲～an owning Agent at execution time` | `tool/call`縲～PTY shell state`縲～tool/result` | - | 荳€荳ｪ謖画園譛芽€�囈遖ｻ逧�戟荵� bash 蟾･蜈ｷ�幃Κ鄂ｲ扈�粋謠蝉ｾ� PTY 蜷守ｫｯ�悟ｹｶ蜿ｯ隕�尠髱｢蜷第ｨ｡蝙狗噪邇ｯ蠅�緒霑ｰ縲� |
| `@deepseek-ai/dsh-tool-str-replace-editor` | `str_replace_editor` | `ctx.tools`縲～ctx.fs` | `tool/call`縲～fs/observed after view presence/absence, edit absence, or successful mutation`縲～tool/result` | - | 蝓ｺ莠取枚莉ｶ邉ｻ扈� seam 逧�峡遶区衍逵具ｼ丞�蟒ｺ�丞髪荳€蟄鈴擇驥乗崛謐｢�乗潔陦梧薯蜈･蟾･蜈ｷ�帛庄荳惹ｻｻ菴� shell 謌也ｻ育ｫｯ謗･蜿｣扈�粋縲� |
| `@deepseek-ai/dsh-tool-fs` | `edit`縲～read`縲～read_image`縲～write` | `ctx.tools`縲～ctx.fs`縲～ctx.systemPrompt`縲～ctx.attachments (read_image registration)`縲～ctx.llm + an image-capable route (read_image execution)` | `tool/call`縲～fs/write-intent or fs/edit-intent for mutations`縲～fs/observed after read presence/absence or successful file operation`縲～durable attachment (read_image)`縲～tool/result` | - | 蜈郁ｯｻ蜷主��冗ｼ冶ｾ醍ｭ也払逕ｱ `@deepseek-ai/dsh-fs-policy` 豺ｻ蜉��帛ｮ�弍荳€荳ｪ `fs/*` 莠倶ｻｶ髣ｨ遖∵薯莉ｶ�御ｸ堺ｼ壽隼蜿� schema縲ょ刈霓ｽ霑吩ｺ帛ｷ･蜈ｷ逧�Κ鄂ｲ謖蛾｢�悄荵溷ｺ泌刈霓ｽ隸･謠剃ｻｶ縲よｲ｡譛� `ctx.attachments` 譌ｶ `read_image` 荳堺ｼ壽ｳｨ蜀鯉ｼ帛� schema 荳手ｷｯ逕ｱ譌�蜈ｳ�梧鴬陦梧慮髯､髱樒｡ｮ蛻�ｷｯ逕ｱ逧�ｨ｡蝙句｣ｰ譏主崟蜒剰ｾ灘��悟凄蛻呎拠扈昴€� |
| `@deepseek-ai/dsh-tool-fs-search` | `glob`縲～grep` | `ctx.tools`縲～ctx.subprocess`縲～ctx.systemPrompt` | `tool/call`縲～tool/result` | - | glob 蜥� grep 譏ｯ譌�譚｡莉ｶ蜿ｯ逕ｨ逧�書邇ｰ蟾･蜈ｷ�碁€夊ｿ� ctx.subprocess spawn 髫丞桁謠蝉ｾ帷噪 ripgrep 莠瑚ｿ帛宛譁�ｻｶ��@vscode/ripgrep`�会ｼ悟ｹｶ菴應ｸｺ譎ｮ騾壼燕蜿ｰ隹�畑霑占｡鯉ｼ檎ｻ昜ｸ堺ｽ應ｸｺ蜷主床莉ｻ蜉｡�帶裏髴€蝨ｨ螳ｿ荳ｻ譛ｺ螳芽｣� `rg`�御ｹ滉ｸ咲ｻ剰ｿ� shell 螻ゅ€よ悽逶ｮ蠖穂ｽｿ逕ｨ `sampleOverCapGlobResults: true`�幃Κ鄂ｲ蠢�｡ｻ譏ｾ蠑城€画叫隸･陦御ｸｺ縲らｻ捺棡雜�ｿ�ｸ企剞譌ｶ�御ｼ夐€夊ｿ�庄騾臥噪 ctx.spillStore 蜷守ｫｯ菫晏ｭ伜ｮ梧紛逧��ｼ蠑丞喧蛻苓｡ｨ�帛惠蜈ｱ鄂ｮ驛ｨ鄂ｲ荳ｭ�悟ｦよ棡蜷守ｫｯ蜈ｬ蠑€譛ｬ蝨ｰ霍ｯ蠕�ｼ瑚ｿ泌屓逧�ｮ壻ｽ堺ｿ｡諱ｯ蜿ｯ萓帛錘扈ｭ隸ｻ蜿厄ｼ乗頗邏｢縲� |
| `@deepseek-ai/dsh-tool-pty` | `terminal_close`縲～terminal_list`縲～terminal_open`縲～terminal_read`縲～terminal_send`縲～terminal_signal` | `ctx.tools`縲～ctx.pty`縲～ctx.systemPrompt`縲～ctx.tasks at call time for run_in_background` | `tool/call`縲～tool/result` | - | 霑� 6 荳ｪ扈育ｫｯ蟾･蜈ｷ髴€隕�€画叫蜷ｯ逕ｨ�檎畑莠手｡･蜈�ｸ€谺｡諤ｧ bash�乗枚莉ｶ邉ｻ扈溷ｷ･蜈ｷ縲Ａterminal_send(run_in_background: true)` 莨壽ｳｨ蜀悟芦 `ctx.tasks`�孕chema 荳榊桁蜷ｫ TUI縲∝�蜷肴潔髞ｮ蠎丞�縲。EL縲∬ｰ�紛蟆ｺ蟇ｸ縲∬�蜉ｨ蜷ｯ蜉ｨ蜥瑚ｷｨ agent 蜈ｱ莠ｫ縲� |
| `@deepseek-ai/dsh-tool-goal` | `create_goal`縲～get_goal`縲～update_goal` | `ctx.tools`縲～ctx.agents`縲～ctx.goals`縲～ctx.systemPrompt`縲～a calling Agent in an authorized open turn` | `tool/call`縲～goal/change for mutations`縲～tool/result` | - | create縲‘dit縲｝ause 蜥� resume 隕∵ｱら峩謗･譚･閾ｪ莠ｺ邀ｻ逧��ｹ譚�剞�嫩omplete 蜥� blocked 荵滓磁蜿礼｡ｮ蛻�噪蠖灘燕 Goal Round縲Ｃlocked 逧�ｻ倩ｮ､荳矩剞譏ｯ 3 荳ｪ闔ｷ蜃�噪 Round縲� |
| `@deepseek-ai/dsh-tool-schedule` | `schedule_create`縲～schedule_delete`縲～schedule_list` | `ctx.tools`縲～ctx.sessions`縲ヾession 謖∽ｹ�喧縲∵悴譚･蛻帛ｻｺ逧� live 譬ｹ Agent | `tool/call`縲～schedule/change create or delete`縲～tool/result` | - | 莉�惠騾画叫蜷ｯ逕ｨ逧� Schedule 謠剃ｻｶ蜉�霓ｽ蜷主�蟒ｺ逧� live 譬ｹ Agent scope 蜀�ｳｨ蜀後€ら沿譛ｬ 1 謗･蜿� after_seconds縲∵仞蠑冗ｻ晏ｯｹ at 蜥梧怏逡悟崋螳夐€溽紫 every_seconds�悟ｹｶ謚ｫ髴ｲ session-local 莠､莉假ｼ帷ｮ｡逅�ｯｻ蜿紋ｸ主序譖ｴ蠢�｡ｻ騾夊ｿ��莠ｫ逧� Session 謖∽ｹ�喧 barrier縲� |
| `@deepseek-ai/dsh-tool-lsp` | `lsp` | `ctx.tools`縲～ctx.lsp`縲～ctx.systemPrompt` | `tool/call`縲～tool/result` | - | lsp 蟾･蜈ｷ蟆�署萓帶婿騾画叫蜥瑚ｯｭ險€譛榊苅蝎ｨ蟄占ｿ帷ｨ狗ｽｮ莠� ctx.lsp 荵句錘�悟屏豁､蜈ｶ讓｡蝙句庄隗� schema 蝨ｨ譖ｴ謐｢謠蝉ｾ帶婿譌ｶ菫晄戟遞ｳ螳壹€りｿ占｡梧慮隕∵ｱょｷｲ豕ｨ蜀梧署萓帶婿�御ｾ句ｦ� `@deepseek-ai/dsh-lsp-local`�帛ｦよ棡豐｡譛画署萓帶婿�梧衍隸｢莨夊ｿ泌屓扈捺桷蛹� `LSP_UNAVAILABLE` 髞呵ｯｯ�瑚€御ｸ堺ｼ壽隼蜿� schema縲� |
| `@deepseek-ai/dsh-tool-ralph` | `ralph` | `ctx.tools`縲～ctx.workflows`縲～ctx.subagents`縲～ctx.systemPrompt`縲～a calling Agent (exec.agent parents every fresh round)` | `tool/call`縲～tool/result`縲～workflow and child session events during execution` | - | 蝗ｺ螳夂噪蜑榊床蟾･菴懈ｵ∽ｼ壼惠豈丈ｸｪ Round 蜷ｯ蜉ｨ荳€荳ｪ蜈ｨ譁ｰ逧�ｻ捺桷蛹門ｭ千ｺｧ�帶ｨ｡蝙句宵閭ｽ騾画叫荳榊庄蜿倡岼譬�柱蜿ｯ騾臥噪 Round 荳企剞縲� |
| `@deepseek-ai/dsh-tool-skill` | `skill` | `ctx.tools`縲～ctx.agents`縲～ctx.skills` | `tool/call`縲～tool/result`縲～user/message replacement catalogs via agent.inject()` | - | - |
| `@deepseek-ai/dsh-tool-session-query` | `session_event_read`縲～session_event_search`縲～session_event_trace`縲～session_search`縲～session_trace` | `ctx.tools`縲～ctx.systemPrompt`縲～ctx.sessionQuery`縲～a calling Agent for workspace authority` | `tool/call`縲～tool/result` | - | 霑� 5 荳ｪ蜿ｪ隸ｻ蟾･蜈ｷ莨夐嚼阯乗署萓帶婿貂ｸ譬�ｼ悟ｹｶ譬ｹ謐ｮ荳榊庄蜿倡噪隹�畑 agent 莨夊ｯ昜ｸｺ豈丈ｸｪ扈捺棡謗域揀縲りｯ･蛹�怙隕�€画叫蜷ｯ逕ｨ�幃怙隕∝ｼｺ蛻ｶ謌ｪ豁｢譌ｶ髣ｴ謌夜剞蛻ｶ陦悟�霎灘�逧�ｻ�粋霑倅ｼ壽撃霓ｽ騾夂畑雜�慮謌� spill 遲也払縲� |
| `@deepseek-ai/dsh-tool-subagent` | `subagent` | `ctx.tools`縲～ctx.subagents`縲～ctx.systemPrompt` | `tool/call`縲～tool/result`縲～child session events through the chosen provider` | `subagent`縲～subagent_fork` | 豕ｨ蜀檎噪蟾･蜈ｷ蜷咲ｧｰ蜿門�莠主刈霓ｽ譌ｶ `toolName` 驟咲ｽｮ�磯ｻ倩ｮ､荳ｺ `subagent`�会ｼ帑ｸ願ｿｰ schema 蟇ｹ蠎秘ｻ倩ｮ､蛟ｼ縲る囂莠ｧ蜩∝書蟶�噪扈�粋莨壻ｸｺ豈丈ｸｪ subagent 蜷守ｫｯ蜉�霓ｽ荳€谺｡隸･蛹�ｼ悟屏豁､讓｡蝙玖ｿ倅ｼ夂恚蛻ｰ扈大ｮ壼芦 fork 蜷守ｫｯ逧� `subagent_fork`縲よｯ丈ｸｪ螳樔ｾ狗噪謠剰ｿｰ縲～run_in_background` 蜿よ焚荳� system prompt 遲也払蜿門�莠主ｮ��蟾ｱ逧� `backgroundMode` 蜥� `enableRunInBackground`�悟屏豁､荳､荳ｪ髫城刋 schema 蟷ｶ荳咲嶌蜷鯉ｼ啻subagent` 荳ｺ `continuable`�檎怐逡･蜿よ焚譌ｶ鮟倩ｮ､蜷主床霑占｡鯉ｼ悟ｹｶ逕ｱ runtime 閾ｪ蜉ｨ謚暮€堤ｻ捺據扈捺棡�嫣subagent_fork` 菫晄戟 `one-shot`�檎怐逡･蜿よ焚譌ｶ鮟倩ｮ､蜑榊床霑占｡後€りｯｦ隗� `packages/bundle/base/cordis.patch.yml` 蜥� `examples/acp-agent/cordis.yml`縲� |
| `@deepseek-ai/dsh-tool-subagent-control` | `interrupt_agent`縲～list_agents`縲～send_message` | `ctx.tools`縲～ctx.subagents`縲～ctx.agents and ctx.sessionProjections (list_agents only)` | `tool/call`縲～tool/result`縲～child session events through ctx.subagents` | - | 霑吩ｺ帶弍謗ｧ蛻ｶ蜿ｯ扈ｧ扈ｭ蜷主床 subagent 逧��螻€蜻ｽ蜷榊ｷ･蜈ｷ�夂ｻ大ｮ壽署萓帶婿逧� `tool-subagent` 螳樔ｾ区ｳｨ蜀御ｸ榊酔逧�ｧ疲ｴｾ蟾･蜈ｷ�帶悽蛹�ｳｨ蜀御ｸ€谺｡ `send_message` 蜥� `interrupt_agent`�悟嘗逕ｱ `list_agents` 騾夊ｿ�黒迢ｬ蜉�霓ｽ逧� `/list-agents` 謠剃ｻｶ謠蝉ｾ幢ｼ悟�逶ｮ蠖戊｡御ｽｿ逕ｨ sessionProjections 蜥悟ｮ樊慮 Agent 豕ｨ蜀瑚｡ｨ縲� |
| `@deepseek-ai/dsh-tool-subagent-report` | `report` | `ctx.subagents`縲～ctx.systemPrompt`縲～a live continuable in-process child Agent` | `tool/call`縲～tool/result`縲～a user-role message in the direct parent session` | - | 謖牙庄扈ｧ扈ｭ逧�ｿ帷ｨ句�蟄千ｺｧ豕ｨ蜀鯉ｼ瑚€碁撼蜈ｨ螻€豕ｨ蜀鯉ｼ悟屏豁､隸･ schema 莉�惠霑咏ｧ榊ｭ千ｺｧ蜀�Κ蜿ｯ隗�ｼ悟ｹｶ荳比ｸ榊女蜈ｶ蜈ｨ螻€ `toolFilter` 蠖ｱ蜩阪€ょ酔荳€莉ｽ雍｡迪ｮ霑倅ｼ壼ｮ芽｣�ｭ千ｺｧ菴懃畑蝓溽噪 `tool:report` 邉ｻ扈滓署遉ｺ隸� section�梧悽逶ｮ蠖穂ｸ肴ｸｲ譟楢ｯ･ section縲る擇蜷醍宛郤ｧ逧� `send_message` 蟾･蜈ｷ蜊慕峡螳芽｣�€� |
| `@deepseek-ai/dsh-tool-tasks` | `task_kill`縲～task_list`縲～task_output` | `ctx.tools`縲～ctx.tasks`縲～ctx.systemPrompt` | `tool/call`縲～tool/result`縲～user/message via agent.inject() for background completion notices` | - | 荳惹ｻｻ蜉｡遘咲ｱｻ譌�蜈ｳ逧�錘蜿ｰ莉ｻ蜉｡謗ｧ蛻ｶ蝎ｨ�壼錘蜿ｰ bash 蜻ｽ莉､縲￣TY 蜿鷹€∝柱 subagent 驛ｽ騾夊ｿ�嶌蜷檎噪 3 荳ｪ蟾･蜈ｷ隸ｻ蜿悶€∝�蜃ｺ蜥檎ｻ域ｭ｢縲ょ刈霓ｽ隸･謠剃ｻｶ莨壽撃謗･謗ｧ蛻ｶ蝎ｨ�御ｻ手€悟星逕ｨ逕滉ｺｧ譁ｹ逧� `ctx.tasks.start()`縲� |
| `@deepseek-ai/dsh-tool-todo` | `todo_write` | `ctx.tools`縲～owning Agent session` | `tool/call`縲～todo/write`縲～tool/result` | - | todo_write 譏ｯ莨夊ｯ晄園譛臥噪迥ｶ諤�ｼ婉I 蟆�怙譁ｰ逧� todo/write 莠倶ｻｶ貂ｲ譟謎ｸｺ譽€譟･貂�黒縲ＡallowParallelInProgress` 譏ｯ豐｡譛蛾ｻ倩ｮ､蛟ｼ逧�ｿ�｡ｫ鬘ｹ�悟屏豁､譛ｬ逶ｮ蠖墓�遑ｮ騾画叫 `true`�悟ｯｹ蠎疲緒霑ｰ蜈∬ｮｸ蜷梧慮蟄伜惠螟壻ｸｪ `in_progress` 鬘ｹ縲る€画叫 `false` 逧�Κ鄂ｲ莨夊執蠕怜酔荳€蟾･蜈ｷ�御ｽ�緒霑ｰ莨夊ｦ∵ｱょ宵閭ｽ譛� 1 荳ｪ豢ｻ蜉ｨ莉ｻ蜉｡縲� |
| `@deepseek-ai/dsh-tool-workflow` | `workflow` | `ctx.tools`縲～ctx.workflows`縲～ctx.systemPrompt`縲～a calling Agent (exec.agent parents the script children)` | `tool/call`縲～tool/result` | - | - |
| `@deepseek-ai/dsh-tool-web` | `web_fetch`縲～web_search` | `ctx.tools`縲～ctx.web`縲～ctx.systemPrompt` | `tool/call`縲～tool/result` | - | web_search 蜥� web_fetch 蟆�署萓帶婿騾画叫鄂ｮ莠� ctx.web 荵句錘�御ｽｿ讓｡蝙句庄隗� schema 蝨ｨ譖ｴ謐｢蜷守ｫｯ譌ｶ菫晄戟遞ｳ螳壹€� |

## `@deepseek-ai/dsh-tool-ask-user`

### `ask_user_question`

扈ｧ扈ｭ謫堺ｽ懷燕�悟ｦよ棡髴€隕∫｡ｮ隶､縲�€画叫謌也ｼｺ螟ｱ逧�ｿ｡諱ｯ�瑚ｯｷ蜷醍畑謌ｷ謠仙�邂€譏朱琉鬚倥€ょ書騾∽ｸ€荳ｪ謌門､壻ｸｪ髣ｮ鬚假ｼ梧ｯ丈ｸｪ髣ｮ鬚倬�蟶ｦ荳€荳ｪ遞ｳ螳� id�瑚ｯ･ id 莨壼惠遲疲｡井ｸｭ蜴滓�ｷ霑泌屓縲�

```json
{
  "type": "object",
  "properties": {
    "questions": {
      "type": "array",
      "description": "Questions to ask the user before continuing.",
      "items": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "id": {
            "type": "string",
            "description": "Stable id for this question; echoed in the answer."
          },
          "question": {
            "type": "string",
            "description": "The specific question to ask the user."
          },
          "header": {
            "type": "string",
            "description": "Optional short heading for the question, such as \"Confirm\" or \"Choose Mode\"."
          },
          "options": {
            "type": "array",
            "description": "Optional choices to show the user. If you recommend one, put it first and append \"(Recommended)\" to that label.",
            "items": {
              "type": "object",
              "additionalProperties": true,
              "properties": {
                "label": {
                  "type": "string",
                  "description": "Short user-facing option label."
                },
                "description": {
                  "type": "string",
                  "description": "One sentence explaining the tradeoff or impact."
                }
              },
              "required": [
                "label"
              ]
            }
          },
          "multi_select": {
            "type": "boolean",
            "description": "Whether the user may select more than one option. Defaults to false."
          }
        },
        "required": [
          "id",
          "question"
        ]
      }
    }
  },
  "required": [
    "questions"
  ]
}
```

譚･貅撰ｼ喙`packages/interaction/tool-ask-user/src/index.ts`](../packages/interaction/tool-ask-user/src/index.ts)

ask_user_question 莨壽嘯蛛懷ｷ･蜈ｷ隹�畑�檎峩蛻ｰ蠖灘燕 UI 謠蝉ｾ帶婿霑泌屓莠ｺ邀ｻ遲疲｡医€�

## `@deepseek-ai/dsh-tools`

### `run_code`

髓亥ｯｹ蜿ｯ逕ｨ蟾･蜈ｷ謇ｧ陦� TypeScript 遞句ｺ上€りｯｷ郛門�蠑よｭ･蜃ｽ謨ｰ逧�**蜃ｽ謨ｰ菴�**�井ｻ�ｽｿ逕ｨ蜿ｯ謫ｦ髯､隸ｭ豕包ｼ帶髪謖�｡ｶ螻� `await` 蜥� `return`�会ｼ悟ｹｶ譬ｹ謐ｮ邉ｻ扈滓署遉ｺ隸堺ｸｭ逧�｣ｰ譏趣ｼ御ｻ･ `await tools.name(args)` 蠖｢蠑剰ｰ�畑蟾･蜈ｷ縲ょ宵譛画遠蜊ｰ謌冶ｿ泌屓逧��螳ｹ莨壻ｼ�蝗橸ｼ瑚ｯｷ隹ｨ諷守ｭ幃€峨€�

```json
{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "The program: the body of an async TypeScript function."
    },
    "description": {
      "type": "string",
      "description": "Clear, concise description of what this program does in active voice, 5-10 words (shown in the UI). Examples: \"Count TODO markers across packages\"; \"Read failing test and its fixture\"; \"Rename config key in every cordis.yml\"."
    }
  },
  "required": [
    "code",
    "description"
  ]
}
```

譚･貅撰ｼ喙`packages/core/tools/src/code-mode.ts`](../packages/core/tools/src/code-mode.ts)

蝨ｨ `mode: code`�汁mode: both` 荳具ｼ悟ｮ�罰蟾･蜈ｷ豕ｨ蜀瑚｡ｨ謇€譛会ｼ御ｽ應ｸｺ蜿ｯ霑�ｻ､閭ｽ蜉帛ｱゆｹ句､也噪菫晉蕗莨�霎捺惻蛻ｶ�亥盾隗� Code Mode Agent Note�峨€ょ惠 `code` 荳具ｼ悟ｮ�弍豕ｨ蜀瑚｡ｨ蟇ｹ蜊剰ｮｮ譬ｼ蠑冗噪蜚ｯ荳€雍｡迪ｮ�帛�莉門庄隗∬�蜉帛惠菴ｿ逕ｨ蟾ｲ蜉�霓ｽ霑占｡梧慮隸ｭ險€逕滓�逧� SDK 遶�闃ゆｸｭ螢ｰ譏弱€らｨ句ｺ城€夊ｿ� binding 隹�畑霑吩ｺ幄�蜉幢ｼ瑚ｰ�畑謖臥�蜴溽函蟷ｶ蜿醍ｺｦ螳夊ｰ�ｺｦ�壼星蜉ｨ鬘ｺ蠎丞柱遲也払驕ｵ蠕ｪ謠蝉ｺ､鬘ｺ蠎擾ｼ悟ｹｶ蜿大ｮ牙�逧��謨ｰ菴捺怙螟夐㍾蜿�謇ｧ陦� `maxParallelSubCalls` 荳ｪ縲りｰ�畑莨夐㍾譁ｰ霑帛�螳梧紛荳泌女螳亥梱菫晄侃逧�ｷ･蜈ｷ豬∵ｰｴ郤ｿ�悟ｹｶ蟆�ｯ丈ｸｪ蠏悟･玲鴬陦悟�閨泌芦豁､螟門ｱらｻ捺棡縲�

## `@deepseek-ai/dsh-plan-mode`

### `exit_plan_mode`

莉�惠隗��讓｡蠑丈ｸ倶ｽｿ逕ｨ縲よ署莠､隶｡蛻剃ｾ帷畑謌ｷ隸�ｮ｡�悟ｹｶ蝨ｨ闔ｷ謇ｹ蜷朱€€蜃ｺ隗��讓｡蠑上€ょ書騾�**螳梧紛逧�** Markdown 隶｡蛻抵ｼ御ｻ･荳€荳ｪ荳ｺ隶｡蛻貞多蜷咲噪 # 譬�｢伜ｼ€螟ｴ縲ら畑謌ｷ蜿ｯ莉･謇ｹ蜃�ｼ井ｻ惹ｽ�逧�ｸ倶ｸ€豁･鬪､襍ｷ謇ｧ陦瑚ｮ｡蛻抵ｼ会ｼ御ｹ溷庄莉･隕∵ｱらｻｧ扈ｭ隗���帛�蜿埼ｦ井ｼ夐€夊ｿ�ｷ･蜈ｷ扈捺棡霑泌屓�瑚ｯｷ菫ｮ謾ｹ蜷主�谺｡謠蝉ｺ､縲�

```json
{
  "type": "object",
  "properties": {
    "plan": {
      "type": "string",
      "description": "The complete plan, as markdown, starting with a # heading that names it."
    }
  },
  "required": [
    "plan"
  ]
}
```

譚･貅撰ｼ喙`packages/plan/plan-mode/src/index.ts`](../packages/plan/plan-mode/src/index.ts)

隗��譛ｪ豼€豢ｻ譌ｶ�憩xit_plan_mode 莉堺ｿ晉蕗蝨ｨ髱｢蜷第ｨ｡蝙狗噪 schema 荳ｭ�瑚ｿ呎�ｷ迥ｶ諤∬ｽｬ謐｢荳堺ｼ壼惠隗��遲也払蜿俶峩荵句､夜｢晏､夜€�謌仙ｷ･蜈ｷ逶ｮ蠖募序蜉ｨ縲ょ�謇ｧ陦瑚ｷｯ蠕�ｼ壽拠扈晁ｧ��讓｡蠑丈ｹ句､也噪隹�畑�帛惠隗��讓｡蠑丈ｸ具ｼ悟ｮ�€夊ｿ�畑謌ｷ莠､莠� seam 謠蝉ｺ､隶｡蛻抵ｼ域音蜃�ｼ乗�ｹ謐ｮ蜿埼ｦ育ｻｧ扈ｭ隗���会ｼ梧音蜃�錘莨壼惠豁･鬪､霎ｹ逡瑚ｮｰ蠖戊ｧ��讓｡蠑丞ｷｲ蛛懃畑縲�

## `@deepseek-ai/dsh-tool-bash`

### `bash`

謇ｧ陦� bash 蜻ｽ莉､��bash -c`�牙ｹｶ霑泌屓 stdout/stderr縲よｯ乗ｬ｡隹�畑驛ｽ蝨ｨ譁ｰ shell 荳ｭ霑占｡鯉ｼ夊ｰ�畑荵矩龍荳堺ｿ晉蕗莉ｻ菴慕憾諤�ｼ�wd縲∝序驥上€∝�謨ｰ�会ｼ瑚ｯｷ莨�蜈･ `workdir`�御ｸ崎ｦ∽ｽｿ逕ｨ `cd`縲る撼髮ｶ騾€蜃ｺ莨壽冠蜻贋ｸｺ `[exit code: N]`縲ょｽ灘燕 harness 邇ｯ蠅�ｿ｡諱ｯ騾夊ｿ�汚邂｡逧� `$DSH_*` 蜿倬㍼蜈ｬ蠑€�碁怙隕∵慮隸ｷ譽€譟･霑吩ｺ帛序驥上€ょ多莉､蜿ｯ閭ｽ蝨ｨ譁�ｻｶ豐咏ｮｱ荳ｭ霑占｡鯉ｼ幄｢ｫ髦ｻ豁｢逧�枚莉ｶ謫堺ｽ懈冠蜻贋ｸｺ `[sandbox: file access denied under <mode> mode]`�瑚ｿ呎弍遲也払諡堤ｻ晢ｼ瑚€御ｸ肴弍蜻ｽ莉､郛ｺ髯ｷ�瑚ｯｷ蜍ｿ謐｢荳€遘肴婿蠑城㍾隸輔€りｾ�柄逧�ｾ灘�莨壽穐譁ｭ�悟宵菫晉蕗蟆ｾ驛ｨ�帛ｦょ庄逕ｨ�悟ｮ梧紛霎灘�莨壻ｿ晏ｭ伜芦譁�ｻｶ蟷ｶ謚･蜻雁�霍ｯ蠕�€ょｯｹ莠朱柄譌ｶ髣ｴ霑占｡檎噪蜻ｽ莉､�瑚ｯｷ隶ｾ鄂ｮ `run_in_background: true`�夊ｰ�畑莨夂ｫ句叉霑泌屓 task id�帑ｽｿ逕ｨ `task_output` 隸ｻ蜿冶ｾ灘��御ｽｿ逕ｨ `task_kill` 蛛懈ｭ｢莉ｻ蜉｡縲�

```json
{
  "type": "object",
  "properties": {
    "command": {
      "type": "string",
      "description": "The bash command to execute."
    },
    "description": {
      "type": "string",
      "description": "Clear, concise description of what this command does in active voice, 5-10 words (shown in the UI). Examples: \"ls\" 竊� \"List files in current directory\"; \"git status\" 竊� \"Show working tree status\"; \"npm install\" 竊� \"Install package dependencies\"."
    },
    "timeoutMs": {
      "type": "number",
      "description": "Timeout in milliseconds. The executor applies its configured default and cap, and kills the command on expiry."
    },
    "workdir": {
      "type": "string",
      "description": "Working directory for this command. Defaults to the session workspace; a relative path is resolved against it."
    },
    "run_in_background": {
      "type": "boolean",
      "description": "Run in the background and return a task id immediately (collect with task_output, stop with task_kill). No timeout applies."
    }
  },
  "required": [
    "command",
    "description"
  ]
}
```

譚･貅撰ｼ喙`packages/bash/tool-bash/src/index.ts`](../packages/bash/tool-bash/src/index.ts)

bash 蟾･蜈ｷ譏ｯ bash 謇ｧ陦悟勣 seam 髱｢蜷第ｨ｡蝙狗噪豸郁ｴｹ譁ｹ縲ゆｽｿ逕ｨ `run_in_background` 逧�ｿ占｡御ｼ壽ｳｨ蜀悟芦騾夂畑 `ctx.tasks` 霑占｡梧慮�悟ｹｶ騾夊ｿ� `task_*` 蟾･蜈ｷ�域擂閾ｪ `@deepseek-ai/dsh-tool-tasks`�画噺髮�ｼ丞●豁｢�帷ｦ∫畑 `enableRunInBackground` 驟咲ｽｮ�磯ｻ倩ｮ､荳ｺ true�牙錘�瑚ｯ･蜿よ焚莨夊｢ｫ螳悟�遘ｻ髯､縲�

## `@deepseek-ai/dsh-tool-pwsh`

### `pwsh`

謇ｧ陦� PowerShell 蜻ｽ莉､��pwsh -Command`�牙ｹｶ霑泌屓 stdout/stderr縲よｯ乗ｬ｡隹�畑驛ｽ蝨ｨ譁ｰ逧� pwsh 霑帷ｨ倶ｸｭ霑占｡鯉ｼ夊ｰ�畑荵矩龍荳堺ｿ晉蕗莉ｻ菴慕憾諤�ｼ�wd縲∝序驥上€∝�謨ｰ�会ｼ瑚ｯｷ莨�蜈･ `workdir`�御ｸ崎ｦ∽ｽｿ逕ｨ `cd`縲りｷｯ蠕�㊦逕ｨ Windows 蜴溽函蠖｢蠑擾ｼ�C:\...`�会ｼ帑ｽｿ逕ｨ `$env:NAME` 隸ｻ蜿也識蠅�序驥上€る撼髮ｶ騾€蜃ｺ莨壽冠蜻贋ｸｺ `[exit code: N]`縲ょｽ灘燕 harness 邇ｯ蠅�ｿ｡諱ｯ騾夊ｿ�汚邂｡逧� `$env:DSH_*` 蜿倬㍼蜈ｬ蠑€�碁怙隕∵慮隸ｷ譽€譟･霑吩ｺ帛序驥上€ょ多莉､蜿ｯ閭ｽ蝨ｨ譁�ｻｶ豐咏ｮｱ荳ｭ霑占｡鯉ｼ幄｢ｫ髦ｻ豁｢逧�枚莉ｶ謫堺ｽ懈冠蜻贋ｸｺ `[sandbox: file access denied under <mode> mode]`�瑚ｿ呎弍遲也払諡堤ｻ晢ｼ瑚€御ｸ肴弍蜻ｽ莉､郛ｺ髯ｷ�瑚ｯｷ蜍ｿ謐｢荳€遘肴婿蠑城㍾隸輔€りｾ�柄逧�ｾ灘�莨壽穐譁ｭ�悟宵菫晉蕗蟆ｾ驛ｨ�帛ｦょ庄逕ｨ�悟ｮ梧紛霎灘�莨壻ｿ晏ｭ伜芦譁�ｻｶ蟷ｶ謚･蜻雁�霍ｯ蠕�€ょ惠 Windows 荳奇ｼ瑚｢ｫ蠑ｺ蛻ｶ扈域ｭ｢逧�多莉､莨壻ｻ･ `[exit code: 1]` 扈鍋ｮ嶺ｸ比ｸ榊ｸｦ菫｡蜿ｷ譬�ｮｰ�瑚ｯｷ蟆��隗�ｸｺ荳ｭ譁ｭ�瑚€御ｸ肴弍蜻ｽ莉､螟ｱ雍･縲ょｯｹ莠朱柄譌ｶ髣ｴ霑占｡檎噪蜻ｽ莉､�瑚ｯｷ隶ｾ鄂ｮ `run_in_background: true`�夊ｰ�畑莨夂ｫ句叉霑泌屓 task id�帑ｽｿ逕ｨ `task_output` 隸ｻ蜿冶ｾ灘��御ｽｿ逕ｨ `task_kill` 蛛懈ｭ｢莉ｻ蜉｡縲�

```json
{
  "type": "object",
  "properties": {
    "command": {
      "type": "string",
      "description": "The PowerShell command to execute."
    },
    "description": {
      "type": "string",
      "description": "Clear, concise description of what this command does in active voice, 5-10 words (shown in the UI). Examples: \"ls\" 竊� \"List files in current directory\"; \"git status\" 竊� \"Show working tree status\"; \"Get-Process\" 竊� \"List running processes\"."
    },
    "timeoutMs": {
      "type": "number",
      "description": "Timeout in milliseconds. The executor applies its configured default and cap, and kills the command on expiry."
    },
    "workdir": {
      "type": "string",
      "description": "Working directory for this command. Defaults to the session workspace; a relative path is resolved against it."
    },
    "run_in_background": {
      "type": "boolean",
      "description": "Run in the background and return a task id immediately (collect with task_output, stop with task_kill). No timeout applies."
    }
  },
  "required": [
    "command",
    "description"
  ]
}
```

譚･貅撰ｼ喙`packages/bash/tool-pwsh/src/index.ts`](../packages/bash/tool-pwsh/src/index.ts)

pwsh 蟾･蜈ｷ譏ｯ Windows 扈�粋荳ｭ bash 謇ｧ陦悟勣 seam 逧� PowerShell 譁ｹ險€豸郁ｴｹ譁ｹ�育罰 `@deepseek-ai/dsh-pwsh-local` 遲� PowerShell 謇ｧ陦悟勣荳ｺ `ctx.bash` 謠蝉ｾ帛錘遶ｯ�会ｼ幃勁豐咏ｮｱ謗･蜿｣螟厄ｼ悟ｮ�€宣｡ｹ蟇ｹ蠎� bash 蟾･蜈ｷ隹�畑縲ゆｽｿ逕ｨ `run_in_background` 逧�ｿ占｡御ｼ壽ｳｨ蜀悟芦騾夂畑 `ctx.tasks` 霑占｡梧慮�悟ｹｶ騾夊ｿ� `task_*` 蟾･蜈ｷ謾ｶ髮�ｼ丞●豁｢�帶汚邂｡逧� `DSH_*` 邇ｯ蠅�擂閾ｪ `@deepseek-ai/dsh-bash-env`縲よｯ乗ｬ｡隹�畑驛ｽ蝨ｨ譁ｰ霑帷ｨ倶ｸｭ霑占｡鯉ｼ御ｸ堺ｽｿ逕ｨ謖∽ｹ� PTY 莨夊ｯ昴€りｷｯ蠕�㊦逕ｨ蜴溽函 `C:\...` 蠖｢蠑擾ｼ悟序驥城㊦逕ｨ `$env:NAME`縲�

## `@deepseek-ai/dsh-tool-cordis`

### `cordis_inspect`

譽€譟･蠖灘燕 DSH 霑帷ｨ倶ｸｭ逧�ｮ樊慮 Cordis 霑占｡梧慮縲ょ宵隸ｻ縲らｫ�闃ょ桁諡ｬ�啻services`�域園譛牙ｷｲ謠蝉ｾ帷噪 ctx 譛榊苅蜿頑凶譛牙ｮ�噪謠剃ｻｶ fiber�峨€～plugins`�域園譛牙ｮ樊慮謠剃ｻｶ fiber 蜿雁�逕溷多蜻ｨ譛溽憾諤�ｼ峨€～tools`�亥ｽ灘燕豕ｨ蜀檎噪讓｡蝙句庄隗∝ｷ･蜈ｷ�悟叉菴�蜿ｯ莉･隹�畑逧�ｷ･蜈ｷ�峨€～temporary`�井ｻ�罰 cordis_mount 蛻帛ｻｺ逧�ｸｴ譌ｶ Plugin�喨d縲∝錐遘ｰ縲∫憾諤√€∵署萓帷噪譛榊苅縲∫ｭ牙ｾ�噪譛榊苅蜥悟ｭ倡ｻｭ譛滂ｼ峨€～api`�域ｯ丈ｸｪ**螳樊慮**譛榊苅逧�婿豕慕ｭｾ蜷堺ｻ･蜿雁盾謨ｰ�剰ｿ泌屓蛟ｼ邀ｻ蝙句ｽ｢迥ｶ�帷ｼ門�隹�畑譛榊苅逧�薯莉ｶ莉｣遐∝燕隸ｷ蜈磯�隸ｻ�峨€～events`�域ｯ丈ｸｪ harness 莠倶ｻｶ逧��豢ｾ讓｡蠑丞柱遑ｮ蛻�ｭｾ蜷搾ｼ帛惠豁､騾画叫逶大成逶ｮ譬�ｼ峨€ゆｸｴ譌ｶ Plugin 莉�ｭ伜惠莠主�蟄倅ｸｭ�御ｼ壼惠蜷守ｻｭ霓ｮ谺｡荳ｭ菫晄戟豢ｻ蜉ｨ�悟ｹｶ蝨ｨ cordis_unmount縲∝ｷ･蜈ｷ髮�査霓ｽ謌� DSH 驥榊星蜷取ｶ亥､ｱ�帑ｸ堺ｼ夊�蜉ｨ諱｢螟阪€Ａtemporary` 譏ｯ `plugins` 逧�ｭ宣寔縲ら怐逡･ `what` 蜿ｯ闔ｷ蜿門�驛ｨ 6 荳ｪ遶�闃ゅ€ゆｽｿ逕ｨ `what:"api"` 謌� `what:"events"` 譌ｶ�悟庄莨�蜈･遑ｮ蛻�噪 `name`�悟ｰ�激蝗ｴ郛ｩ蟆丞芦荳€荳ｪ譛榊苅�丈ｺ倶ｻｶ�悟ｹｶ蛹�性蜈ｶ蜴溷ｧ区ｺ千�� JSDoc縲�

```json
{
  "type": "object",
  "properties": {
    "what": {
      "type": "string",
      "description": "Limit the report to one section. Omit for all sections.",
      "enum": [
        "services",
        "plugins",
        "tools",
        "temporary",
        "api",
        "events"
      ]
    },
    "name": {
      "type": "string",
      "description": "Exact service key or event name whose original JSDoc to include; valid only with what:\"api\" or what:\"events\"."
    }
  }
}
```

譚･貅撰ｼ喙`packages/self-modification/tool-cordis/src/index.ts`](../packages/self-modification/tool-cordis/src/index.ts)

### `cordis_mount`

蝨ｨ蠖灘燕 DSH 霑帷ｨ倶ｸｭ謖りｽｽ荳ｴ譌ｶ Cordis Plugin縲ょｮ��蟒ｺ逧�弍蜀�ｭ倅ｸｭ逧�ｿ占｡梧慮 Plugin�瑚€御ｸ肴弍蟾ｲ螳芽｣��蟾ｲ驟咲ｽｮ逧� Plugin縲りｯ･謠剃ｻｶ莨壼惠蜷守ｻｭ霓ｮ谺｡荳ｭ菫晄戟豢ｻ蜉ｨ�檎峩蛻ｰ謇ｧ陦� cordis_unmount縲∝ｷ･蜈ｷ髮�査霓ｽ謌� DSH 驥榊星縲ょｮ�ｸ堺ｼ壼�蟒ｺ譁�ｻｶ縲∝ｮ芽｣�桁縲∽ｿｮ謾ｹ cordis.yml 謌紋ｸｪ莠ｺ�城｡ｹ逶ｮ驟咲ｽｮ縲∝惠驥榊星蜷惹ｿ晉蕗�御ｹ滉ｸ堺ｼ夊�蜉ｨ霓ｬ荳ｺ豌ｸ荵�薯莉ｶ縲り凶隕∽ｿ晉蕗�瑚ｯｷ隶ｩ Agent 騾夊ｿ�ｸｸ隗�ｼ€蜿大ｷ･菴懈ｵ∝ｮ樒鴫 SDK Plugin 謌門庄螳芽｣�噪 profile bundle縲ょｮ�庄閭ｽ蠖ｱ蜩榊酔荳€霑帷ｨ倶ｸｭ逧��莉紋ｼ夊ｯ晢ｼ帶ｲ咏ｮｱ荳肴弍螳牙�霎ｹ逡鯉ｼ梧ｳｨ蜈･逧�恪蜉｡莨夊ｮｿ髣ｮ逵溷ｮ櫁ｿ占｡梧慮縲Ａcode` 莨夂ｫ句叉菴應ｸｺ蠑よｭ･ JavaScript 蜃ｽ謨ｰ逧��謨ｰ菴灘惠髫皮ｦｻ豐咏ｮｱ荳ｭ霑占｡鯉ｼ悟ｹｶ荳�**蠢�｡ｻ** `return` 荳€荳ｪ謠剃ｻｶ縲よ髪謖∽ｸ､遘榊ｽ｢蠑擾ｼ壼�謨ｰ蠖｢蠑� `return (ctx) => { 窶ｦ }`�悟ｮ�ｸ榊｣ｰ譏� inject�悟屏豁､蜿ｯ莉･豕ｨ蜀悟ｷ･蜈ｷ縲∫尅蜷ｬ莠倶ｻｶ蜥梧署萓帶恪蜉｡�御ｽ�ｮｿ髣ｮ**莉ｻ菴�**譛榊苅�井ｾ句ｦ� ctx.bash�蛾�莨壽鴨蜃ｺ蠑ょｸｸ�帑ｻ�惠荳埼怙隕∵恪蜉｡譌ｶ菴ｿ逕ｨ縲ょｯｹ雎｡蠖｢蠑� `return { name?, inject: ['bash', 'llm', 窶ｦ], apply(ctx) { 窶ｦ } }`�悟ｮ�｣ｰ譏惹ｾ晁ｵ厄ｼ靴ordis 蜿ｪ蝨ｨ譛榊苅蟄伜惠蜷取ｿ€豢ｻ謠剃ｻｶ��**莨伜�菴ｿ逕ｨ**霑咏ｧ榊ｽ｢蠑上€ゆｽ�蜿ｪ閭ｽ隶ｿ髣ｮ inject 荳ｭ蛻怜�逧�恪蜉｡�壼叉菴ｿ譛ｪ螢ｰ譏守噪譛榊苅蟄伜惠�瑚ｮｿ髣ｮ螳�ｹ滉ｼ壽鴨蜃ｺ蠑ょｸｸ�悟屏荳ｺ螯よ棡謠蝉ｾ帶婿陲ｫ蜊ｸ霓ｽ�梧悴螢ｰ譏守噪萓晁ｵ門ｰ�裏豕墓ｸ�炊縲ゆｻ｣遐∬ｰ�畑譛榊苅**荵句燕**�瑚ｯｷ隸ｻ蜿� cordis_inspect 逧� what:"api"�帛ｮ�ｼ壼�蜃ｺ譁ｹ豕慕ｭｾ蜷堺ｻ･蜿雁盾謨ｰ�剰ｿ泌屓蛟ｼ逧�ｱｻ蝙句ｽ｢迥ｶ�御ｸ崎ｦ∫懸豬句ｭ玲ｮｵ邀ｻ蝙具ｼ御ｾ句ｦ� bash 霑占｡檎噪 stdout 譏ｯ蟇ｹ雎｡閠碁撼蟄礼ｬｦ荳ｲ縲ょ惠 `apply` 蜀�ｼ瑚ｯｷ菴ｿ逕ｨ譬�㊥ Cordis API�夐€夊ｿ� `ctx.on(event, listener)` 隗ょｯ滉ｺ倶ｻｶ�郁ｧ� cordis_inspect 逧� what:"events"�会ｼ梧�隹�畑 `harness.registerTool(ctx, harness.defineTool({ name, description, parameters: { text: { type: 'string', required: true } }, output: { schema: { type: 'string' }, render(_args, value) { return [{ type: 'text', text: value }] } }, async execute(args) { return args.text } }))` 荳ｺ閾ｪ蟾ｱ謠蝉ｾ帶眠蟾･蜈ｷ�幄ｯ･蟾･蜈ｷ莨壼惠菴�逧�**荳倶ｸ€豁･鬪､**蜿ｯ隹�畑縲ょｷ･蜈ｷ蜿よ焚�壽ｯ丈ｸｪ髞ｮ**蟆ｱ譏ｯ**荳€荳ｪ螻樊€ｧ�悟叉 { type: 'string'|'number'|'integer'|'boolean'|'null'|'object'|'array'|'json', required?: true, description?, enum?, const?, items?, properties? }�帶ｯ丈ｸｪ逶ｴ謗･ DSL 蟇ｹ雎｡驛ｽ螢ｰ譏� additionalProperties: true|false�瑚€� oneOf: [schema, schema, ...] 莨壼叙莉｣ type�瑚｡ｨ遉ｺ諱ｰ螂ｽ蛹ｹ驟堺ｸ€荳ｪ謌仙遭逧�＃蜷医€ゆｹ滓磁蜿怜次蟋� JSON Schema { type: 'object', properties, required?: [窶ｦ] } 蛹�｣�ｱゑｼ悟�荳ｭ蟇ｹ雎｡鮟倩ｮ､蠑€謾ｾ縲ょｷ･蜈ｷ逧� `execute` **蠢�｡ｻ**霑泌屓 `output.schema` 螢ｰ譏守噪譌�謐� JSON 蛟ｼ�嫣output.render(args, value)` 蜊慕峡霑泌屓 Native�乗ｨ｡蝙句�螳ｹ蝮励€ゆｸｴ譌ｶ Plugin 蜿ｯ莉･**扈�粋**�壻ｸ€荳ｪ Plugin 蜿ｯ莉･騾夊ｿ� `ctx.provide('name', value)` 謠蝉ｾ帶恪蜉｡�悟嘗荳€荳ｪ蛻吝庄螢ｰ譏� `inject: ['name']` 譚･豸郁ｴｹ螳�ｼ帶ｶ郁ｴｹ譁ｹ莨壼惠謠蝉ｾ帶婿蜃ｺ邇ｰ蜑堺ｿ晄戟遲牙ｾ�ｼ梧署萓帶婿蜊ｸ霓ｽ蜷朱㍾譁ｰ蝗槫芦遲牙ｾ�憾諤√€ょ惠 `apply` 荳ｭ豕ｨ蜀檎噪荳€蛻��莨夂罰 cordis_unmount 閾ｪ蜉ｨ貂�炊縲よｲ咏ｮｱ蜈ｨ螻€蟇ｹ雎｡�啻console`�亥ｸｦ `[cordis:<id>]` 譬�ｭｾ�悟�蜈･ harness 扈育ｫｯ�峨€～harness.defineTool`縲～harness.registerTool`縲～btoa`縲～atob`縲～TextEncoder`縲～TextDecoder`縲�ode API 蟾ｲ**遖∫畑**�壽枚莉ｶ邉ｻ扈滂ｼ冗ｽ醍ｻ懶ｼ丞ｮ壽慮蟾･菴懷ｿ�｡ｻ騾夊ｿ� Cordis 譛榊苅螳梧��檎ｻ昜ｸ崎�菴ｿ逕ｨ Node 蜀�ｽｮ閭ｽ蜉幢ｼ嫣require`縲～setTimeout`�汁setInterval` 蜥� `fetch` 莨壽鴨蜃ｺ驥榊ｮ壼髄髞呵ｯｯ�形process` 蜥� `Buffer` 譛ｪ螳壻ｹ峨€ょｺ疲隼逕ｨ inject: ['fs'] + ctx.fs 螟�炊譁�ｻｶ縲（nject: ['web'] + ctx.web 螟�炊 HTTP縲（nject: ['bash'] + ctx.bash 螟�炊霑帷ｨ九€（nject: ['timer'] + ctx.setTimeout/ctx.setInterval 螟�炊螳壽慮�郁ｿ吩ｺ帶弍 fiber effect�悟査霓ｽ譌ｶ閾ｪ蜉ｨ貂�炊�会ｼ嫩ordis_inspect 逧� what:"api" 莨壼ｱ慕､ｺ**蠖灘燕**霑占｡梧慮謠蝉ｾ帷噪閭ｽ蜉帙€りｯｷ郛門�**郤ｯ** JavaScript�御ｸ崎ｦ∽ｽｿ逕ｨ TypeScript�井ｸ榊ｾ嶺ｽｿ逕ｨ `as` 謌也ｱｻ蝙区ｳｨ隗｣�峨€よｳｨ諢丈ｺ矩｡ｹ��(1) waterfall�育€大ｸ�ｼ丈ｺ倶ｻｶ�我ｺ倶ｻｶ�井ｾ句ｦ� tools/pre-execute�我ｼ壼髄逶大成蝎ｨ莨�蜈･譛€蜷惹ｸ€荳ｪ `next` 蝗櫁ｰ�ｼ瑚ｯ･蝗櫁ｰ�**蠢�｡ｻ**陲ｫ隹�畑�帑ｸ崎ｰ�畑 `next()` 蟆ｱ霑泌屓莨�**遏ｭ霍ｯ**豁､谺｡隹�畑縲る勁髱樔ｽ�譛画э諡ｦ謌

```json
{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "JavaScript body returning a temporary Plugin; evaluated now and saved nowhere."
    }
  },
  "required": [
    "code"
  ]
}
```

譚･貅撰ｼ喙`packages/self-modification/tool-cordis/src/index.ts`](../packages/self-modification/tool-cordis/src/index.ts)

### `cordis_unmount`

蜊ｸ霓ｽ蠖灘燕霑帷ｨ倶ｸｭ逕ｱ cordis_mount 蛻帛ｻｺ逧�ｸｴ譌ｶ Plugin縲ょｮ�ｼ夂ｭ牙ｾ�ｯ･謠剃ｻｶ逧�ｷ･蜈ｷ縲∫尅蜷ｬ蝎ｨ縲∵恪蜉｡縲∝ｮ壽慮蝎ｨ蜿雁�莉冶�譛画譜譫懷�驛ｨ貂�炊螳梧�縲ょ宵謗･蜿� dyn-N 荳ｴ譌ｶ id�帶裏豕慕ｧｻ髯､ Loader縲∝ｷｲ驟咲ｽｮ謌門ｷｲ螳芽｣�噪 Plugin縲�

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The temporary Plugin id returned by cordis_mount (for example \"dyn-1\"); valid only in this process and invalid after unmount or restart."
    }
  },
  "required": [
    "id"
  ]
}
```

譚･貅撰ｼ喙`packages/self-modification/tool-cordis/src/index.ts`](../packages/self-modification/tool-cordis/src/index.ts)

荳榊惠莉ｻ菴暮囂莠ｧ蜩∝書蟶�噪譬台ｸｭ�碁怙隕∵怏諢城€画叫蜷ｯ逕ｨ�帑ｸｴ譌ｶ Plugin 莉｣遐∝庄莉･隶ｿ髣ｮ逵溷ｮ櫁ｿ占｡梧慮�瑚ｧ� .agents/notes/implemented/feature/2026-07-08-self-referential-cordis-toolset.md縲ら罰 cordis_mount 蛻帛ｻｺ逧�薯莉ｶ蝨ｨ蜊ｸ霓ｽ謌� DSH 驥榊星荵句燕蜿ｯ莉･豕ｨ蜀�**鬚晏､也噪**讓｡蝙句庄隗∝ｷ･蜈ｷ�帛書逕溯ｿ咏ｱｻ蟾･蜈ｷ髮�序譖ｴ譌ｶ�檎ｳｻ扈滉ｼ夊ｮｰ蠖募ｮ梧紛荳疲怏蜿伜勘逧�ｯｷ豎ょ､ｴ縲�

## `@deepseek-ai/dsh-tool-bash-persistent`

### `bash`

蝨ｨ謖∽ｹ� bash shell 荳ｭ霑占｡悟多莉､縲ょ桁諡ｬ蠖灘燕逶ｮ蠖募柱蟾ｲ蟇ｼ蜃ｺ邇ｯ蠅�序驥丞惠蜀�噪迥ｶ諤∽ｼ壼惠豁､ agent 逧�､壽ｬ｡隹�畑荵矩龍菫晉蕗縲�

```json
{
  "type": "object",
  "properties": {
    "command": {
      "type": "string",
      "description": "The bash command to run. Relative path is preferred in the command."
    }
  },
  "required": [
    "command"
  ]
}
```

譚･貅撰ｼ喙`packages/pty/tool-bash-persistent/src/index.ts`](../packages/pty/tool-bash-persistent/src/index.ts)

荳€荳ｪ謖画園譛芽€�囈遖ｻ逧�戟荵� bash 蟾･蜈ｷ�幃Κ鄂ｲ扈�粋謠蝉ｾ� PTY 蜷守ｫｯ�悟ｹｶ蜿ｯ隕�尠髱｢蜷第ｨ｡蝙狗噪邇ｯ蠅�緒霑ｰ縲�

## `@deepseek-ai/dsh-tool-str-replace-editor`

### `str_replace_editor`

逕ｨ莠取衍逵九€∝�蟒ｺ蜥檎ｼ冶ｾ第枚莉ｶ逧��螳壻ｹ臥ｼ冶ｾ大ｷ･蜈ｷ��

* 迥ｶ諤∽ｼ壼惠蜻ｽ莉､隹�畑莉･蜿贋ｸ守畑謌ｷ逧�ｮｨ隶ｺ荵矩龍謖∽ｹ�ｿ晉蕗
* 螯よ棡 `path` 譏ｯ譁�ｻｶ�形view` 莨壽仞遉ｺ蠎皮畑 `cat -n` 蜷守噪扈捺棡縲ょｦよ棡 `path` 譏ｯ逶ｮ蠖包ｼ形view` 莨壼�蜃ｺ譛€螟壼髄荳� 2 螻ら噪髱樣嚼阯乗枚莉ｶ蜥檎岼蠖�
* 螯よ棡謖�ｮ夂噪 `create` 蜻ｽ莉､逶ｮ譬� `path` 蟾ｲ菴應ｸｺ譁�ｻｶ蟄伜惠�悟�荳崎�菴ｿ逕ｨ隸･蜻ｽ莉､
* 螯よ棡 `command` 莠ｧ逕溯ｾ�柄霎灘��瑚ｾ灘�莨夊｢ｫ謌ｪ譁ｭ蟷ｶ譬�ｮｰ荳ｺ `<response clipped>`

菴ｿ逕ｨ `str_replace` 蜻ｽ莉､譌ｶ隸ｷ豕ｨ諢擾ｼ�

* `old_str` 蜿よ焚蠎比ｸ主次譁�ｻｶ荳ｭ荳€陦梧�螟夊｡瑚ｿ樒ｻｭ蜀�ｮｹ**螳悟�**蛹ｹ驟阪€りｯｷ逡呎э遨ｺ逋ｽ蟄礼ｬｦ��
* 螯よ棡 `old_str` 蜿よ焚蝨ｨ譁�ｻｶ荳ｭ荳榊髪荳€�悟�荳堺ｼ壽鴬陦梧崛謐｢縲りｯｷ遑ｮ菫晏惠 `old_str` 荳ｭ蛹�性雜ｳ螟溽噪荳贋ｸ区枚�御ｽｿ蜈ｶ蜚ｯ荳€
* `new_str` 蜿よ焚蠎泌桁蜷ｫ逕ｨ莠取崛謐｢ `old_str` 逧�ｷｲ郛冶ｾ題｡�

```json
{
  "type": "object",
  "properties": {
    "command": {
      "type": "string",
      "description": "The commands to run. Allowed options are: `view`, `create`, `str_replace`, `insert`.",
      "enum": [
        "view",
        "create",
        "str_replace",
        "insert"
      ]
    },
    "path": {
      "type": "string",
      "description": "Absolute path to file or directory, e.g. `/repo/file.py` or `/repo`."
    },
    "file_text": {
      "type": "string",
      "description": "Required parameter of `create` command, with the content of the file to be created."
    },
    "insert_line": {
      "type": "integer",
      "description": "Required parameter of `insert` command. The `new_str` will be inserted AFTER the line `insert_line` of `path`."
    },
    "new_str": {
      "type": "string",
      "description": "Optional parameter of `str_replace` command containing the new string (if not given, no string will be added). Required parameter of `insert` command containing the string to insert."
    },
    "old_str": {
      "type": "string",
      "description": "Required parameter of `str_replace` command containing the string in `path` to replace."
    },
    "view_range": {
      "type": "array",
      "description": "Optional parameter of `view` command when `path` points to a file. If none is given, the full file is shown. If provided, the file will be shown in the indicated line number range, e.g. [11, 12] will show lines 11 and 12. Indexing at 1 to start. Setting `[start_line, -1]` shows all lines from `start_line` to the end of the file.",
      "items": {
        "type": "integer"
      }
    }
  },
  "required": [
    "command",
    "path"
  ]
}
```

譚･貅撰ｼ喙`packages/fs/tool-str-replace-editor/src/index.ts`](../packages/fs/tool-str-replace-editor/src/index.ts)

蝓ｺ莠取枚莉ｶ邉ｻ扈� seam 逧�峡遶区衍逵具ｼ丞�蟒ｺ�丞髪荳€蟄鈴擇驥乗崛謐｢�乗潔陦梧薯蜈･蟾･蜈ｷ�帛庄荳惹ｻｻ菴� shell 謌也ｻ育ｫｯ謗･蜿｣扈�粋縲�

## `@deepseek-ai/dsh-tool-fs`

### `edit`

騾夊ｿ�崛謐｢蟄鈴擇驥乗枚譛ｬ譚･郛冶ｾ醍鴫譛� UTF-8 譁�悽譁�ｻｶ縲�

```json
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "description": "Path to edit, resolved by the filesystem backend."
    },
    "old_string": {
      "type": "string",
      "description": "Literal text to replace. Must match exactly."
    },
    "new_string": {
      "type": "string",
      "description": "Literal replacement text. Use an empty string to delete the match."
    },
    "replace_all": {
      "type": "boolean",
      "description": "Replace all matches. Defaults to false; when false, old_string must appear exactly once."
    }
  },
  "required": [
    "file_path",
    "old_string",
    "new_string"
  ]
}
```

譚･貅撰ｼ喙`packages/fs/tool-fs/src/index.ts`](../packages/fs/tool-fs/src/index.ts)

### `read`

隸ｻ蜿� UTF-8 譁�悽譁�ｻｶ�悟ｹｶ霑泌屓蟶ｦ陦悟捷逧��螳ｹ縲�

```json
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "description": "Path to read, resolved by the filesystem backend."
    },
    "offset": {
      "type": "number",
      "description": "1-based first line to return. Defaults to 1."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of lines to return. Defaults to 2000."
    }
  },
  "required": [
    "file_path"
  ]
}
```

譚･貅撰ｼ喙`packages/fs/tool-fs/src/index.ts`](../packages/fs/tool-fs/src/index.ts)

### `read_image`

隸ｻ蜿� PNG/JPEG/WebP/GIF 譁�ｻｶ蟷ｶ霑泌屓蝗ｾ蜒乗悽霄ｫ縲りｦ∵ｱょｽ灘燕讓｡蝙区磁蜿怜崟蜒剰ｾ灘�縲�

```json
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "description": "Path to the image file, resolved by the filesystem backend."
    }
  },
  "required": [
    "file_path"
  ]
}
```

譚･貅撰ｼ喙`packages/fs/tool-fs/src/index.ts`](../packages/fs/tool-fs/src/index.ts)

### `write`

蛻帛ｻｺ謌門ｮ悟�譖ｿ謐｢ UTF-8 譁�悽譁�ｻｶ縲�

```json
{
  "type": "object",
  "properties": {
    "file_path": {
      "type": "string",
      "description": "Path to write, resolved by the filesystem backend."
    },
    "content": {
      "type": "string",
      "description": "Full UTF-8 text content to write."
    }
  },
  "required": [
    "file_path",
    "content"
  ]
}
```

譚･貅撰ｼ喙`packages/fs/tool-fs/src/index.ts`](../packages/fs/tool-fs/src/index.ts)

蜈郁ｯｻ蜷主��冗ｼ冶ｾ醍ｭ也払逕ｱ `@deepseek-ai/dsh-fs-policy` 豺ｻ蜉��帛ｮ�弍荳€荳ｪ `fs/*` 莠倶ｻｶ髣ｨ遖∵薯莉ｶ�御ｸ堺ｼ壽隼蜿� schema縲ょ刈霓ｽ霑吩ｺ帛ｷ･蜈ｷ逧�Κ鄂ｲ謖蛾｢�悄荵溷ｺ泌刈霓ｽ隸･謠剃ｻｶ縲よｲ｡譛� `ctx.attachments` 譌ｶ `read_image` 荳堺ｼ壽ｳｨ蜀鯉ｼ帛� schema 荳手ｷｯ逕ｱ譌�蜈ｳ�梧鴬陦梧慮髯､髱樒｡ｮ蛻�ｷｯ逕ｱ逧�ｨ｡蝙句｣ｰ譏主崟蜒剰ｾ灘��悟凄蛻呎拠扈昴€�

## `@deepseek-ai/dsh-tool-fs-search`

### `glob`

譟･謇ｾ霍ｯ蠕�源驟� glob 讓｡蠑冗噪譁�ｻｶ縲ょ宵霑泌屓蛹ｹ驟咲噪譁�ｻｶ霍ｯ蠕�ｼ檎ｻ昜ｸ崎ｿ泌屓逶ｮ蠖包ｼ帛桁諡ｬ髫占酪譁�ｻｶ蜥瑚｢ｫ蠢ｽ逡･逧�枚莉ｶ�御ｽ�賜髯､ VCS 蜈�焚謐ｮ逶ｮ蠖輔€よ怙螟壽潔菫ｮ謾ｹ譌ｶ髣ｴ鬘ｺ蠎剰ｿ泌屓 100 譚｡霍ｯ蠕�ｼ帛ｦよ棡扈捺棡譖ｴ螟夲ｼ悟�謾ｹ荳ｺ霑泌屓莉朱｡ｶ螻よ擅逶ｮ荳ｭ謚ｽ譬ｷ逧� 100 譚｡霍ｯ蠕�ｼ瑚ｯｴ譏主ｷｲ謚ｽ譬ｷ�悟ｹｶ謚･蜻雁ｮ梧紛謗貞ｺ丞�陦ｨ逧�ｿ晏ｭ倅ｽ咲ｽｮ縲りｯ･蟾･蜈ｷ荳肴椢荳ｾ逶ｮ蠖墓擅逶ｮ縲�

```json
{
  "type": "object",
  "properties": {
    "pattern": {
      "type": "string",
      "description": "Glob pattern to match file paths against (e.g. \"**/*.ts\", \"src/**/*.test.js\"). A pattern with no \"/\" matches the basename at any depth, so \"*\" and \"*.ts\" both search the whole tree; include a separator to anchor the depth."
    },
    "path": {
      "type": "string",
      "description": "Directory to search in. Defaults to the session workspace; a relative path resolves against it."
    }
  },
  "required": [
    "pattern"
  ]
}
```

譚･貅撰ｼ喙`packages/fs/tool-fs-search/src/index.ts`](../packages/fs/tool-fs-search/src/index.ts)

### `grep`

菴ｿ逕ｨ ripgrep 豁｣蛻呵｡ｨ霎ｾ蠑乗頗邏｢譁�ｻｶ蜀�ｮｹ縲りｿ泌屓蟶ｦ陦悟捷逧�源驟崎｡鯉ｼ悟ｹｶ謖画枚莉ｶ蛻�ｻ�€ょ燕 250 譚｡蛹ｹ驟堺ｼ夂峩謗･霑泌屓�帷ｻ捺棡霎ｾ蛻ｰ荳企剞譌ｶ莨壽冠蜻雁ｮ梧紛蛹ｹ驟榊�陦ｨ逧�ｿ晏ｭ倅ｽ咲ｽｮ縲ょｦる怙蜻ｨ霎ｹ荳贋ｸ区枚�瑚ｯｷ蟇ｹ蛹ｹ驟咲噪譁�ｻｶ菴ｿ逕ｨ read縲�

```json
{
  "type": "object",
  "properties": {
    "pattern": {
      "type": "string",
      "description": "Regular expression to search for (ripgrep syntax)."
    },
    "path": {
      "type": "string",
      "description": "File or directory to search. Defaults to the session workspace; a relative path resolves against it."
    },
    "include": {
      "type": "string",
      "description": "One glob filter for which files to search (e.g. \"*.ts\", \"*.{js,jsx}\"). Not a list; negation is not supported."
    }
  },
  "required": [
    "pattern"
  ]
}
```

譚･貅撰ｼ喙`packages/fs/tool-fs-search/src/index.ts`](../packages/fs/tool-fs-search/src/index.ts)

glob 蜥� grep 譏ｯ譌�譚｡莉ｶ蜿ｯ逕ｨ逧�書邇ｰ蟾･蜈ｷ�碁€夊ｿ� ctx.subprocess spawn 髫丞桁謠蝉ｾ帷噪 ripgrep 莠瑚ｿ帛宛譁�ｻｶ��@vscode/ripgrep`�会ｼ悟ｹｶ菴應ｸｺ譎ｮ騾壼燕蜿ｰ隹�畑霑占｡鯉ｼ檎ｻ昜ｸ堺ｽ應ｸｺ蜷主床莉ｻ蜉｡�帶裏髴€蝨ｨ螳ｿ荳ｻ譛ｺ螳芽｣� `rg`�御ｹ滉ｸ咲ｻ剰ｿ� shell 螻ゅ€よ悽逶ｮ蠖穂ｽｿ逕ｨ `sampleOverCapGlobResults: true`�幃Κ鄂ｲ蠢�｡ｻ譏ｾ蠑城€画叫隸･陦御ｸｺ縲らｻ捺棡雜�ｿ�ｸ企剞譌ｶ�御ｼ夐€夊ｿ�庄騾臥噪 ctx.spillStore 蜷守ｫｯ菫晏ｭ伜ｮ梧紛逧��ｼ蠑丞喧蛻苓｡ｨ�帛惠蜈ｱ鄂ｮ驛ｨ鄂ｲ荳ｭ�悟ｦよ棡蜷守ｫｯ蜈ｬ蠑€譛ｬ蝨ｰ霍ｯ蠕�ｼ瑚ｿ泌屓逧�ｮ壻ｽ堺ｿ｡諱ｯ蜿ｯ萓帛錘扈ｭ隸ｻ蜿厄ｼ乗頗邏｢縲�

## `@deepseek-ai/dsh-tool-pty`

### `terminal_close`

蜈ｳ髣ｭ荳€荳ｪ謖∽ｹ�ｻ育ｫｯ�悟ｹｶ遲牙ｾ��謐戊執荳疲園譛臥噪霑帷ｨ区�大ｮ悟�騾€蜃ｺ縲�

```json
{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Terminal session id."
    }
  },
  "required": [
    "sessionId"
  ]
}
```

譚･貅撰ｼ喙`packages/pty/tool-pty/src/index.ts`](../packages/pty/tool-pty/src/index.ts)

### `terminal_list`

蛻怜�蠖灘燕 agent 謇€譛臥噪謖∽ｹ�ｻ育ｫｯ莨夊ｯ昴€�

```json
{
  "type": "object",
  "properties": {}
}
```

譚･貅撰ｼ喙`packages/pty/tool-pty/src/index.ts`](../packages/pty/tool-pty/src/index.ts)

### `terminal_open`

騾夊ｿ�ｷｲ豕ｨ蜀檎噪蜷守ｫｯ邀ｻ蝙句�蟒ｺ謖画園譛芽€�囈遖ｻ逧�戟荵�ｻ育ｫｯ莨夊ｯ昴€る怙隕∝惠螟壽ｬ｡蟾･蜈ｷ隹�畑荵矩龍菫晉蕗 shell 謌� REPL 迥ｶ諤∵慮�瑚ｯｷ菴ｿ逕ｨ豁､蟾･蜈ｷ縲�

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Registered terminal backend type, usually \"shell\"."
    },
    "name": {
      "type": "string",
      "description": "Optional owner-local display name such as \"main\" or \"gdb\"."
    },
    "cwd": {
      "type": "string",
      "description": "Initial working directory. Defaults to the deployment workspace root."
    }
  },
  "required": [
    "type"
  ]
}
```

譚･貅撰ｼ喙`packages/pty/tool-pty/src/index.ts`](../packages/pty/tool-pty/src/index.ts)

### `terminal_read`

莉取戟荵�ｻ育ｫｯ隸ｻ蜿紋ｸ€鬘ｵ譛臥阜逧�ｿ晉蕗霎灘��御ｸ榊書騾∬ｾ灘�縲�

```json
{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Terminal session id."
    },
    "offset": {
      "type": "number",
      "description": "Newest-relative line offset (default 0)."
    },
    "count": {
      "type": "number",
      "description": "Requested line count (default 500; backend caps apply)."
    }
  },
  "required": [
    "sessionId"
  ]
}
```

譚･貅撰ｼ喙`packages/pty/tool-pty/src/index.ts`](../packages/pty/tool-pty/src/index.ts)

### `terminal_send`

蜷第戟荵�ｻ育ｫｯ蜿鷹€∵枚譛ｬ縲るｻ倩ｮ､莨壽署莠､ Enter�悟ｹｶ遲牙ｾ�署遉ｺ隨ｦ縲《tdin 遲牙ｾ�€∬ｾ灘�髱咎ｻ倥€∬ｶ�慮謌紋ｼ夊ｯ晞€€蜃ｺ縲ょ錘蜿ｰ讓｡蠑丈ｼ夊ｿ泌屓萓� task_output�春ask_kill 菴ｿ逕ｨ逧� task id縲�

```json
{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Terminal session id returned by terminal_open or terminal_list."
    },
    "text": {
      "type": "string",
      "description": "UTF-8 text to write to the terminal."
    },
    "submit": {
      "type": "boolean",
      "description": "Submit Enter after text (default true). Set false for control characters or incomplete REPL input."
    },
    "run_in_background": {
      "type": "boolean",
      "description": "Return a task id immediately; collect with task_output or stop with task_kill."
    }
  },
  "required": [
    "sessionId",
    "text"
  ]
}
```

譚･貅撰ｼ喙`packages/pty/tool-pty/src/index.ts`](../packages/pty/tool-pty/src/index.ts)

### `terminal_signal`

蜷第戟荵�ｻ育ｫｯ蠖灘燕逧�燕蜿ｰ霑帷ｨ狗ｻ�書騾∝�隶ｸ逧�ｿ｡蜿ｷ縲�

```json
{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "Terminal session id."
    },
    "signal": {
      "type": "string",
      "description": "Signal to deliver. Shell-targeted SIGKILL is rejected; use terminal_close.",
      "enum": [
        "SIGINT",
        "SIGTERM",
        "SIGKILL",
        "SIGTSTP",
        "SIGHUP"
      ]
    }
  },
  "required": [
    "sessionId",
    "signal"
  ]
}
```

譚･貅撰ｼ喙`packages/pty/tool-pty/src/index.ts`](../packages/pty/tool-pty/src/index.ts)

霑� 6 荳ｪ扈育ｫｯ蟾･蜈ｷ髴€隕�€画叫蜷ｯ逕ｨ�檎畑莠手｡･蜈�ｸ€谺｡諤ｧ bash�乗枚莉ｶ邉ｻ扈溷ｷ･蜈ｷ縲Ａterminal_send(run_in_background: true)` 莨壽ｳｨ蜀悟芦 `ctx.tasks`�孕chema 荳榊桁蜷ｫ TUI縲∝�蜷肴潔髞ｮ蠎丞�縲。EL縲∬ｰ�紛蟆ｺ蟇ｸ縲∬�蜉ｨ蜷ｯ蜉ｨ蜥瑚ｷｨ agent 蜈ｱ莠ｫ縲�

## `@deepseek-ai/dsh-tool-goal`

### `create_goal`

蠖灘ｽ灘燕逶ｴ謗･莠ｺ邀ｻ隸ｷ豎よ弍髴€隕∬ｷｨ閾ｪ荳ｻ Goal Round 謖∫ｻｭ謗ｨ霑帷噪髟ｿ譛溽岼譬�慮�悟�蟒ｺ荳€荳ｪ謖∽ｹ�喧逧�酔莨夊ｯ晏ｮ梧�逶ｮ譬�€ょ叉菴ｿ逕ｨ謌ｷ豐｡譛画�遑ｮ隸ｴ縲悟�蟒ｺ逶ｮ譬�€搾ｼ御ｽ�荵溷庄莉･謗ｨ譁ｭ蜈ｶ諢丞崟縲ゆｸ崎ｦ∫畑莠守ｮ€蜊慕噪蜊戊ｽｮ蟾･菴懊€よ鴬陦梧慮莨壽拠扈晞撼莠ｺ邀ｻ譚�剞蜥� subagent 譚�剞縲�

```json
{
  "type": "object",
  "properties": {
    "objective": {
      "type": "string",
      "description": "The concrete completion objective inferred from the direct human request."
    },
    "max_goal_rounds": {
      "type": "number",
      "description": "Optional positive safe-integer limit on automatic continuation rounds."
    }
  },
  "required": [
    "objective"
  ]
}
```

譚･貅撰ｼ喙`packages/goal/tool-goal/src/index.ts`](../packages/goal/tool-goal/src/index.ts)

### `get_goal`

隸ｻ蜿門ｽ灘燕逧�酔莨夊ｯ晉岼譬�ｼ悟桁諡ｬ遑ｮ蛻�噪 id�俊evision縲∫岼譬�€�亳谿ｵ縲∝ｷｲ螳梧�逧�ｻｶ扈ｭ Round 謨ｰ縲ヽound 荳企剞縲∝ｭ伜惠譌ｶ逧�仆蝪槫次蝗��御ｻ･蜿頑弍蜷ｦ蟾ｲ蜃�､�ｸ倶ｸ€谺｡蟒ｶ扈ｭ縲よ峩譁ｰ逶ｮ譬�燕隸ｷ蜈郁ｰ�畑豁､蟾･蜈ｷ縲�

```json
{
  "type": "object",
  "properties": {}
}
```

譚･貅撰ｼ喙`packages/goal/tool-goal/src/index.ts`](../packages/goal/tool-goal/src/index.ts)

### `update_goal`

譖ｴ譁ｰ遑ｮ蛻�噪蠖灘燕逶ｮ譬� revision縲Ｆdit縲｝ause 蜥� resume 隕∵ｱら峩謗･逧�｡ｶ螻ゆｺｺ邀ｻ隸ｷ豎ゅ€ょ惠閾ｪ蜉ｨ蟒ｶ扈ｭ蠖灘燕逶ｮ譬�悄髣ｴ�御ｹ溷�隶ｸ complete 蜥� blocked縲ょ惠霎ｾ蛻ｰ驟咲ｽｮ逧�怙蟆� Round 謨ｰ荵句燕莨壽拠扈� blocked�帶ｨ｡蝙倶ｻ埼｡ｻ蛻､譁ｭ逶ｸ蜷梧擅莉ｶ譏ｯ蜷ｦ蝨ｨ霑吩ｺ� Round 荳ｭ謖∫ｻｭ蟄伜惠�悟ｹｶ蝨ｨ blocked_reason 荳ｭ莠井ｻ･隸ｴ譏弱€�

```json
{
  "type": "object",
  "properties": {
    "goal_id": {
      "type": "string",
      "description": "Exact id returned by get_goal."
    },
    "revision": {
      "type": "number",
      "description": "Exact positive revision returned by get_goal."
    },
    "action": {
      "type": "string",
      "description": "edit | pause | resume | complete | blocked",
      "enum": [
        "edit",
        "pause",
        "resume",
        "complete",
        "blocked"
      ]
    },
    "objective": {
      "type": "string",
      "description": "Replacement objective; valid only with action edit."
    },
    "max_goal_rounds": {
      "type": "number",
      "description": "Replacement cap; valid only with action edit."
    },
    "blocked_reason": {
      "type": "string",
      "description": "Concrete blocking condition; required only with action blocked."
    }
  },
  "required": [
    "goal_id",
    "revision",
    "action"
  ]
}
```

譚･貅撰ｼ喙`packages/goal/tool-goal/src/index.ts`](../packages/goal/tool-goal/src/index.ts)

create縲‘dit縲｝ause 蜥� resume 隕∵ｱら峩謗･譚･閾ｪ莠ｺ邀ｻ逧��ｹ譚�剞�嫩omplete 蜥� blocked 荵滓磁蜿礼｡ｮ蛻�噪蠖灘燕 Goal Round縲Ｃlocked 逧�ｻ倩ｮ､荳矩剞譏ｯ 3 荳ｪ闔ｷ蜃�噪 Round縲�

## `@deepseek-ai/dsh-tool-schedule`

### `schedule_create`

蝨ｨ蠖灘燕莨夊ｯ昜ｸｭ蛻帛ｻｺ荳€譚｡謠宣�縲りｯｷ謠蝉ｾ幃撼遨ｺ prompt 蜥梧�螂ｽ荳€荳ｪ selector�壽ｭ｣逧�ｮ牙�謨ｴ謨ｰ after_seconds 蟒ｶ譌ｶ�帑ｽ應ｸｺ荳･譬ｼ蟶ｦ蛛冗ｧｻ譌･譛滓慮髣ｴ謌匁悽蝨ｰ譌･譛滂ｼ乗慮髣ｴ蟇ｹ雎｡逧� at�帶�荳榊ｰ丈ｺ� 300 逧�ｮ牙�謨ｴ謨ｰ every_seconds縲ょ崋螳夐€溽紫謠宣�蟋狗ｻ井ｸ主�蟒ｺ譌ｶ蛻ｻ蟇ｹ鮨撰ｼ御ｼ夊ｷｳ霑�漠霑�噪蜿醍函譌ｶ轤ｹ�悟ｹｶ謚頑ｯ乗擅騾ｾ譛溯ｧ��逧�怙譁ｰ荳€荳ｪ蜿醍函譌ｶ轤ｹ蜷亥ｹｶ蛻ｰ荳€荳ｪ謇ｹ谺｡荳ｭ縲ゆｺ､莉俶ｨ｡蠑乗弍 session-local�壼宵譛画ｭ､莨夊ｯ晏､�ｺ� live 迥ｶ諤∵慮�梧署驢呈燕莨壼㊥譌ｶ霑占｡鯉ｼ帛凄蛻呎署驢剃ｼ夊ｿ帛� overdue 迥ｶ諤�ｼ檎峩閾ｳ莨夊ｯ晄△螟阪€�

```json
{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Reminder content to present when the target becomes due."
    },
    "after_seconds": {
      "type": "number",
      "description": "Positive safe-integer delay in seconds."
    },
    "every_seconds": {
      "type": "number",
      "description": "Fixed-rate safe-integer interval in seconds, at least 300."
    },
    "at": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "date": {
              "type": "string"
            },
            "time": {
              "type": "string"
            },
            "time_zone": {
              "type": "string"
            }
          },
          "required": [
            "date",
            "time",
            "time_zone"
          ]
        }
      ],
      "description": "Absolute target as strict offset RFC 3339 or local date/time with an explicit IANA zone."
    }
  },
  "required": [
    "prompt"
  ]
}
```

譚･貅撰ｼ喙`packages/schedule/tool-schedule/src/tools.ts`](../packages/schedule/tool-schedule/src/tools.ts)

### `schedule_delete`

菴ｿ逕ｨ schedule_create 謌� schedule_list 霑泌屓逧�｡ｮ蛻� id�悟唖髯､蠖灘燕莨夊ｯ昜ｸｭ逧�ｸ€譚｡豢ｻ蜉ｨ謠宣�縲よ悴遏･謌門ｷｲ扈冗ｻ捺據逧� id 莨夊ｿ泌屓 deleted false縲�

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Exact session-local schedule id."
    }
  },
  "required": [
    "id"
  ]
}
```

譚･貅撰ｼ喙`packages/schedule/tool-schedule/src/tools.ts`](../packages/schedule/tool-schedule/src/tools.ts)

### `schedule_list`

謖牙�蟒ｺ鬘ｺ蠎丞�蜃ｺ蠖灘燕莨夊ｯ昜ｸｭ逧�園譛画ｴｻ蜉ｨ謠宣��悟桁諡ｬ遑ｮ蛻� id縲ゞTC 逶ｮ譬�€《cheduled 謌� overdue 迥ｶ諤�ｼ御ｻ･蜿� session-local 莠､莉俶ｨ｡蠑上€�

```json
{
  "type": "object",
  "properties": {}
}
```

譚･貅撰ｼ喙`packages/schedule/tool-schedule/src/tools.ts`](../packages/schedule/tool-schedule/src/tools.ts)

莉�惠騾画叫蜷ｯ逕ｨ逧� Schedule 謠剃ｻｶ蜉�霓ｽ蜷主�蟒ｺ逧� live 譬ｹ Agent scope 蜀�ｳｨ蜀後€ら沿譛ｬ 1 謗･蜿� after_seconds縲∵仞蠑冗ｻ晏ｯｹ at 蜥梧怏逡悟崋螳夐€溽紫 every_seconds�悟ｹｶ謚ｫ髴ｲ session-local 莠､莉假ｼ帷ｮ｡逅�ｯｻ蜿紋ｸ主序譖ｴ蠢�｡ｻ騾夊ｿ��莠ｫ逧� Session 謖∽ｹ�喧 barrier縲�

## `@deepseek-ai/dsh-tool-lsp`

### `lsp`

譟･隸｢隸ｭ險€譛榊苅蝎ｨ�御ｻ･邊ｾ遑ｮ蟇ｼ闊ｪ莉｣遐√€Ｐperation 蜿ｯ蜿� goToDefinition縲’indReferences縲“oToImplementation 謌� hover縲Ｍine 蜥� character 譏ｯ莉� 1 蠑€蟋狗噪 UTF-16 蜈画��攝譬�€ＧindReferences 蛹�性螢ｰ譏弱€�

```json
{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "description": "goToDefinition, findReferences, goToImplementation, or hover.",
      "enum": [
        "goToDefinition",
        "findReferences",
        "goToImplementation",
        "hover"
      ]
    },
    "file_path": {
      "type": "string",
      "description": "The source file to query, relative to the workspace or absolute."
    },
    "line": {
      "type": "number",
      "description": "One-based line of the cursor."
    },
    "character": {
      "type": "number",
      "description": "One-based UTF-16 column of the cursor."
    }
  },
  "required": [
    "operation",
    "file_path",
    "line",
    "character"
  ]
}
```

譚･貅撰ｼ喙`packages/lsp/tool-lsp/src/index.ts`](../packages/lsp/tool-lsp/src/index.ts)

lsp 蟾･蜈ｷ蟆�署萓帶婿騾画叫蜥瑚ｯｭ險€譛榊苅蝎ｨ蟄占ｿ帷ｨ狗ｽｮ莠� ctx.lsp 荵句錘�悟屏豁､蜈ｶ讓｡蝙句庄隗� schema 蝨ｨ譖ｴ謐｢謠蝉ｾ帶婿譌ｶ菫晄戟遞ｳ螳壹€りｿ占｡梧慮隕∵ｱょｷｲ豕ｨ蜀梧署萓帶婿�御ｾ句ｦ� `@deepseek-ai/dsh-lsp-local`�帛ｦよ棡豐｡譛画署萓帶婿�梧衍隸｢莨夊ｿ泌屓扈捺桷蛹� `LSP_UNAVAILABLE` 髞呵ｯｯ�瑚€御ｸ堺ｼ壽隼蜿� schema縲�

## `@deepseek-ai/dsh-tool-ralph`

### `ralph`

蝗ｴ扈穂ｸ€荳ｪ荳榊庄蜿倡岼譬�ｿ占｡御ｽｿ逕ｨ蜈ｨ譁ｰ agent 逧�燕蜿ｰ Ralph 蠕ｪ邇ｯ縲ゆｻ�ｽ鍋峩謗･莠ｺ邀ｻ譏守｡ｮ隕∵ｱ� Ralph 謌紋ｽｿ逕ｨ蜈ｨ譁ｰ agent 霑ｭ莉｣譌ｶ菴ｿ逕ｨ縲よｯ丈ｸｪ Round 驛ｽ莨壼星蜉ｨ荳€荳ｪ蜈ｨ譁ｰ蟄千ｺｧ�瑚ｯ･蟄千ｺｧ逵倶ｸ榊芦辷ｶ郤ｧ蟇ｹ隸晄�蜈亥燕蟄蝉ｼ夊ｯ晢ｼ帛�莠ｫ蟾･菴懷玄蜈�ｽ馴柄譛溯ｮｰ蠢�ｼ軍ound 荵矩龍蜿ｪ莨�騾呈怏逡檎噪扈捺桷蛹匁冠蜻翫€ょｽ灘ｷ･菴懆ｿ帷ｨ区冠蜻雁ｮ梧�縲∵冠蜻雁�菴馴仆蝪樣｡ｹ謌冶ｾｾ蛻ｰ Round 荳企剞譌ｶ�瑚ｰ�畑霑泌屓縲よ勸騾夂噪髟ｿ譛溷酔莨夊ｯ晏ｷ･菴懷ｺ比ｽｿ逕ｨ goal 蟾･蜈ｷ縲�

```json
{
  "type": "object",
  "properties": {
    "objective": {
      "type": "string",
      "description": "The immutable completion objective for every fresh Ralph round."
    },
    "maxRounds": {
      "type": "number",
      "description": "Optional positive safe-integer round cap, bounded by the deployment ceiling."
    }
  },
  "required": [
    "objective"
  ]
}
```

譚･貅撰ｼ喙`packages/workflow/tool-ralph/src/index.ts`](../packages/workflow/tool-ralph/src/index.ts)

蝗ｺ螳夂噪蜑榊床蟾･菴懈ｵ∽ｼ壼惠豈丈ｸｪ Round 蜷ｯ蜉ｨ荳€荳ｪ蜈ｨ譁ｰ逧�ｻ捺桷蛹門ｭ千ｺｧ�帶ｨ｡蝙句宵閭ｽ騾画叫荳榊庄蜿倡岼譬�柱蜿ｯ騾臥噪 Round 荳企剞縲�

## `@deepseek-ai/dsh-tool-skill`

### `skill`

蜉�霓ｽ蜿ｯ逕ｨ skill�域橿閭ｽ�臥噪螳梧紛隸ｴ譏弱€ょ惠謇ｧ陦檎せ蜷肴汾鬘ｹ skill 謌紋ｸ主�譏守｡ｮ蛹ｹ驟咲噪莉ｻ蜉｡蜑搾ｼ瑚ｯｷ菴ｿ逕ｨ莨夊ｯ� skill 逶ｮ蠖穂ｸｭ逧�｡ｮ蛻�錐遘ｰ隹�畑豁､蟾･蜈ｷ縲�

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The exact skill name from the available skills list."
    }
  },
  "required": [
    "name"
  ]
}
```

譚･貅撰ｼ喙`packages/skill/tool-skill/src/index.ts`](../packages/skill/tool-skill/src/index.ts)

## `@deepseek-ai/dsh-tool-session-query`

### `session_event_read`

莉惹ｸ€荳ｪ蟾ｲ闔ｷ謗域揀逧�ｼ夊ｯ昜ｸｭ隸ｻ蜿紋ｸ€荳ｪ螳梧紛荳疲悴蛻�闃ら噪莠倶ｻｶ�御ｻ･蜿雁庄騾臥噪逶ｸ驍ｻ蜴溷ｧ倶ｺ倶ｻｶ讎りｿｰ縲�

```json
{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Target session id. Omit for the current session."
    },
    "seq": {
      "type": "integer",
      "description": "Target event sequence number."
    },
    "before": {
      "type": "integer",
      "description": "Number of preceding raw events to summarize. Omit for none."
    },
    "after": {
      "type": "integer",
      "description": "Number of following raw events to summarize. Omit for none."
    }
  },
  "required": [
    "seq"
  ]
}
```

譚･貅撰ｼ喙`packages/session-query/tool-session-query/src/index.ts`](../packages/session-query/tool-session-query/src/index.ts)

### `session_event_search`

蝨ｨ荳€荳ｪ蟾ｲ闔ｷ謗域揀逧�ｼ夊ｯ昜ｸｭ謳懃ｴ｢蜈亥燕莠倶ｻｶ�帛ｦよ棡謳懃ｴ｢蠖灘燕莨夊ｯ晢ｼ悟�謗帝勁謇ｧ陦梧ｭ､谺｡隹�畑逧�ｭ･鬪､縲�

```json
{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Target session id. Omit for the current session."
    },
    "query": {
      "type": "string",
      "description": "Literal full-text query over the target session."
    },
    "seq_from": {
      "type": "integer",
      "description": "Inclusive event sequence lower bound."
    },
    "seq_to": {
      "type": "integer",
      "description": "Inclusive event sequence upper bound."
    },
    "time_from": {
      "type": "string",
      "description": "Inclusive timezone-qualified ISO 8601 event-time lower bound."
    },
    "time_to": {
      "type": "string",
      "description": "Inclusive timezone-qualified ISO 8601 event-time upper bound."
    },
    "event_types": {
      "type": "array",
      "description": "Event types to include.",
      "items": {
        "type": "string"
      }
    },
    "surfaces": {
      "type": "array",
      "description": "Event surfaces to include.",
      "items": {
        "type": "string",
        "enum": [
          "current",
          "shadowed",
          "log-only"
        ]
      }
    }
  },
  "required": [
    "query"
  ]
}
```

譚･貅撰ｼ喙`packages/session-query/tool-session-query/src/index.ts`](../packages/session-query/tool-session-query/src/index.ts)

### `session_event_trace`

隸ｻ蜿門ｷｲ闔ｷ謗域揀莨夊ｯ昜ｸｭ譟蝉ｸｪ莠倶ｻｶ逧�園譛臥峩謗･譖ｿ謐｢蜈ｳ邉ｻ�御ｻ･蜿願ｯ･莠倶ｻｶ荳主�蠑慕畑逧�擂貅蝉ｺ倶ｻｶ荵矩龍逧��邉ｻ縲�

```json
{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Target session id. Omit for the current session."
    },
    "seq": {
      "type": "integer",
      "description": "Target event sequence number."
    }
  },
  "required": [
    "seq"
  ]
}
```

譚･貅撰ｼ喙`packages/session-query/tool-session-query/src/index.ts`](../packages/session-query/tool-session-query/src/index.ts)

### `session_search`

謳懃ｴ｢隹�畑譁ｹ蟾･菴懷玄荳ｭ逧��蜑堺ｼ夊ｯ晢ｼ悟ｹｶ莉取ｯ丈ｸｪ莨夊ｯ晁ｿ泌屓蛹ｹ驟榊ｺｦ譛€鬮倡噪莠倶ｻｶ縲�

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Literal full-text query over prior session history."
    },
    "session_ids": {
      "type": "array",
      "description": "Optional session ids to include.",
      "items": {
        "type": "string"
      }
    },
    "created_at_from": {
      "type": "string",
      "description": "Inclusive timezone-qualified ISO 8601 creation-time lower bound."
    },
    "created_at_to": {
      "type": "string",
      "description": "Inclusive timezone-qualified ISO 8601 creation-time upper bound."
    },
    "parent_session_ids": {
      "type": "array",
      "description": "Optional direct parent session ids.",
      "items": {
        "type": "string"
      }
    },
    "include_root_sessions": {
      "type": "boolean",
      "description": "Include sessions with no parent in the parent filter."
    },
    "availability": {
      "type": "array",
      "description": "Require at least one selected source availability.",
      "items": {
        "type": "string",
        "enum": [
          "live",
          "persisted"
        ]
      }
    },
    "event_seq_from": {
      "type": "integer",
      "description": "Inclusive event sequence lower bound."
    },
    "event_seq_to": {
      "type": "integer",
      "description": "Inclusive event sequence upper bound."
    },
    "event_time_from": {
      "type": "string",
      "description": "Inclusive timezone-qualified ISO 8601 event-time lower bound."
    },
    "event_time_to": {
      "type": "string",
      "description": "Inclusive timezone-qualified ISO 8601 event-time upper bound."
    },
    "event_types": {
      "type": "array",
      "description": "Event types to include.",
      "items": {
        "type": "string"
      }
    },
    "event_surfaces": {
      "type": "array",
      "description": "Event surfaces to include.",
      "items": {
        "type": "string",
        "enum": [
          "current",
          "shadowed",
          "log-only"
        ]
      }
    }
  },
  "required": [
    "query"
  ]
}
```

譚･貅撰ｼ喙`packages/session-query/tool-session-query/src/index.ts`](../packages/session-query/tool-session-query/src/index.ts)

### `session_trace`

隸ｻ蜿門峩扈穂ｸ€荳ｪ莨夊ｯ晉噪蟾ｲ謗域揀莨夊ｯ晁ｰｱ邉ｻ�悟桁諡ｬ螳梧紛蜿ｯ隗∫噪逾門�蜥悟錘莉｣蜈ｳ邉ｻ縲�

```json
{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Target session id. Omit for the current session."
    }
  }
}
```

譚･貅撰ｼ喙`packages/session-query/tool-session-query/src/index.ts`](../packages/session-query/tool-session-query/src/index.ts)

霑� 5 荳ｪ蜿ｪ隸ｻ蟾･蜈ｷ莨夐嚼阯乗署萓帶婿貂ｸ譬�ｼ悟ｹｶ譬ｹ謐ｮ荳榊庄蜿倡噪隹�畑 agent 莨夊ｯ昜ｸｺ豈丈ｸｪ扈捺棡謗域揀縲りｯ･蛹�怙隕�€画叫蜷ｯ逕ｨ�幃怙隕∝ｼｺ蛻ｶ謌ｪ豁｢譌ｶ髣ｴ謌夜剞蛻ｶ陦悟�霎灘�逧�ｻ�粋霑倅ｼ壽撃霓ｽ騾夂畑雜�慮謌� spill 遲也払縲�

## `@deepseek-ai/dsh-tool-subagent`

### `subagent`

蟆�ｸ€鬘ｹ閾ｪ蛹�性莉ｻ蜉｡蟋疲ｴｾ扈� subagent�亥惠閾ｪ霄ｫ荳贋ｸ区枚荳ｭ蟾･菴懃噪迢ｬ遶� agent�会ｼ檎畑螳�査霓ｽ閨夂┬荳皮峡遶狗噪蟾･菴懶ｼ御ｾ句ｦら�皮ｩｶ縲�剞螳夊激蝗ｴ逧�ｮ樒鴫謌門�譫撰ｼ御ｻ･蜈肴ｶ郁€怜ｽ灘燕蟇ｹ隸晉噪荳贋ｸ区枚縲Ｔubagent 莨夊ｿ泌屓扈捺棡�御ｽ�ｸ堺ｼ夊ｿ泌屓荳ｭ髣ｴ豁･鬪､縲りｯｷ謠蝉ｾ帛ｮ梧紛縲∫峡遶狗噪謠千､ｺ隸搾ｼ悟屏荳ｺ螳�恚荳榊芦蠖灘燕蟇ｹ隸昴€よｭ､隹�畑鮟倩ｮ､遲牙ｾ�ｻ捺棡縲りｮｾ鄂ｮ `run_in_background: true` 蜿ｯ霑泌屓 task id�帑ｽｿ逕ｨ `task_output` 謾ｶ髮�ｻ捺棡�御ｽｿ逕ｨ `task_kill` 蛛懈ｭ｢莉ｻ蜉｡縲�

```json
{
  "type": "object",
  "properties": {
    "description": {
      "type": "string",
      "description": "A short (3-5 word) description of the delegated task, for display."
    },
    "prompt": {
      "type": "string",
      "description": "The complete, self-contained task for the subagent. It does not share this conversation's context, so include everything it needs."
    },
    "run_in_background": {
      "type": "boolean",
      "description": "Whether to run as a background task and return its id. Defaults to false; collect with task_output or stop with task_kill."
    }
  },
  "required": [
    "description",
    "prompt"
  ]
}
```

譚･貅撰ｼ喙`packages/subagent/tool-subagent/src/index.ts`](../packages/subagent/tool-subagent/src/index.ts)

豕ｨ蜀檎噪蟾･蜈ｷ蜷咲ｧｰ蜿門�莠主刈霓ｽ譌ｶ `toolName` 驟咲ｽｮ�磯ｻ倩ｮ､荳ｺ `subagent`�会ｼ帑ｸ願ｿｰ schema 蟇ｹ蠎秘ｻ倩ｮ､蛟ｼ縲る囂莠ｧ蜩∝書蟶�噪扈�粋莨壻ｸｺ豈丈ｸｪ subagent 蜷守ｫｯ蜉�霓ｽ荳€谺｡隸･蛹�ｼ悟屏豁､讓｡蝙玖ｿ倅ｼ夂恚蛻ｰ扈大ｮ壼芦 fork 蜷守ｫｯ逧� `subagent_fork`縲よｯ丈ｸｪ螳樔ｾ狗噪謠剰ｿｰ縲～run_in_background` 蜿よ焚荳� system prompt 遲也払蜿門�莠主ｮ��蟾ｱ逧� `backgroundMode` 蜥� `enableRunInBackground`�悟屏豁､荳､荳ｪ髫城刋 schema 蟷ｶ荳咲嶌蜷鯉ｼ啻subagent` 荳ｺ `continuable`�檎怐逡･蜿よ焚譌ｶ鮟倩ｮ､蜷主床霑占｡鯉ｼ悟ｹｶ逕ｱ runtime 閾ｪ蜉ｨ謚暮€堤ｻ捺據扈捺棡�嫣subagent_fork` 菫晄戟 `one-shot`�檎怐逡･蜿よ焚譌ｶ鮟倩ｮ､蜑榊床霑占｡後€りｯｦ隗� `packages/bundle/base/cordis.patch.yml` 蜥� `examples/acp-agent/cordis.yml`縲�

## `@deepseek-ai/dsh-tool-subagent-control`

### `interrupt_agent`

譬ｹ謐ｮ agent id 隸ｷ豎ょ叙豸亥錘蜿ｰ agent 逧�ｽ灘燕霓ｮ谺｡縲ら岼譬�庄莉･譏ｯ菴�逧�峩謗･蟄千ｺｧ�御ｹ溷庄莉･譏ｯ蝨ｨ菴�荳区婿蛻帛ｻｺ逧�峩豺ｱ螻� agent縲ょ宵譛牙ｽ灘燕霓ｮ谺｡莨壼●豁｢�壼ｷｲ扈乗賜髦溷書扈呵ｯ･ agent 逧�ｶ域�莨壻ｸ€逶ｴ謳∫ｽｮ蛻ｰ蜷守ｻｭ逧� send_message�帛ｮ�星蜉ｨ逧� agent 莨夂ｻｧ扈ｭ霑占｡鯉ｼ幄ｯ･ agent 譛ｬ霄ｫ莉榊庄謗･蜿怜錘扈ｭ謫堺ｽ懊€ょ●豁｢隸ｷ豎り｢ｫ謗･蜿怜錘�梧ｭ､隹�畑遶句叉霑泌屓�悟屏豁､逶ｮ譬�庄閭ｽ霑倅ｼ夂洒證りｿ占｡鯉ｼ帑ｸｭ譁ｭ荳€荳ｪ蟾ｲ扈丞ｮ梧�逧� agent 譏ｯ蜿ｯ謗･蜿礼噪遨ｺ謫堺ｽ懊€�

```json
{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "The agent id of the running agent to interrupt."
    }
  },
  "required": [
    "agent_id"
  ]
}
```

譚･貅撰ｼ喙`packages/subagent/tool-subagent-control/src/index.ts`](../packages/subagent/tool-subagent-control/src/index.ts)

### `list_agents`

謖画戟荵� id 蜥梧��ｭｾ蛻怜�菴�逧�庄扈ｧ扈ｭ蜷主床 subagent縲ら畑螳�屓蠢�ｽ�蜷ｯ蜉ｨ霑�頭莠� subagent�瑚€御ｸ肴弍霓ｮ隸｢螳梧�諠��窶披€敗ubagent 螳梧�譌ｶ菴�莨夊｢ｫ蜻顔衍縲ら憾諤∵擂閾ｪ螳樊慮豕ｨ蜀瑚｡ｨ�嗷unning 陦ｨ遉ｺ agent 豁､蛻ｻ豁｣蝨ｨ蟾･菴懶ｼ嬖dle 陦ｨ遉ｺ蟾ｲ蜉�霓ｽ菴�､�ｺ手ｽｮ谺｡荵矩龍�悟庄閭ｽ豁｣蝨ｨ遲牙ｾ�ｮ�星蜉ｨ逧� agent�孑eady 陦ｨ遉ｺ螳�宵蟄伜惠莠主ｭ伜お荳ｭ窶披€泌庄諱｢螟崎€碁撼扈域€�ｼ御ｹ滉ｸ崎｡ｨ遉ｺ譛臥ｻ捺棡遲牙ｾ�噺髮�ｼ嫣send_message` 莨壼惠蜷御ｸ€蟇ｹ隸昜ｸ雁ｼ€蜷ｯ譁ｰ逧�ｽｮ谺｡�御ｸ疲裏隶ｺ螟�ｺ主頭遘咲憾諤�ｼ檎峩謗･蟄千ｺｧ驛ｽ莉榊庄菴應ｸｺ `send_message` 逧�岼譬�€りｯ･蠢ｫ辣ｧ蟷ｶ髱樊兜騾呈価隸ｺ�嫣send_message` 莨壽鴬陦梧揀螽∵｣€譟･�御ｻ榊庄閭ｽ螟ｱ雍･縲よ裏豕戊ｯｻ蜿也噪蟄千ｺｧ莨壻ｽ應ｸｺ隸頑妙菫｡諱ｯ謚･蜻奇ｼ瑚€御ｸ堺ｼ夊｢ｫ髱咎ｻ倅ｸ｢蠑�€Ａdescendants` 菴懃畑蝓滉ｼ壽潔遞ｳ螳夂噪蜑榊ｺ城｡ｺ蠎城″蜴�ｽ�荳区婿逧�紛譽ｵ譬托ｼ悟ｹｶ荳ｺ豈丈ｸｪ譚｡逶ｮ譬�ｳｨ蜈ｶ謖∽ｹ�噪逶ｴ謗･辷ｶ莨夊ｯ� id 蜥梧ｷｱ蠎ｦ縲ょ宵譛画ｷｱ蠎ｦ荳ｺ 1 逧�擅逶ｮ蜿ｯ莉･菴ｿ逕ｨ `send_message`�帶峩豺ｱ逧�擅逶ｮ蜿ｪ閭ｽ菴應ｸｺ `interrupt_agent` 逧�€咎€臥岼譬�€�

```json
{
  "type": "object",
  "properties": {
    "scope": {
      "type": "string",
      "description": "children (default) lists direct children only; descendants walks the complete tree below you.",
      "enum": [
        "children",
        "descendants"
      ]
    }
  }
}
```

譚･貅撰ｼ喙`packages/subagent/tool-subagent-control/src/list-agents.ts`](../packages/subagent/tool-subagent-control/src/list-agents.ts)

### `send_message`

譬ｹ謐ｮ subagent id 蜷大錘蜿ｰ subagent 蜿鷹€∵ｶ域��檎ｻｧ扈ｭ蜷御ｸ€谿ｵ蟇ｹ隸昴€りｯ･豸域�莨壽�荳ｺ subagent 逧�ｸ倶ｸ€霓ｮ谺｡�壼ｦよ棡螳�ｻ榊惠蟾･菴懶ｼ梧ｶ域�莨夂ｭ牙ｾ�ｽ灘燕霓ｮ谺｡扈捺據�悟屏豁､譌�豕墓隼蜿伜ｷｲ扈丞ｼ€蟋狗噪蟾･菴懈婿蜷代€よｭ､隹�畑荳堺ｼ夊ｿ泌屓 subagent 逧�ｭ疲｡茨ｼ悟宵莨夂｡ｮ隶､豸域�蟾ｲ謚暮€抵ｼ悟屏豁､隸ｷ逕ｨ螳��豢ｾ譖ｴ螟壼ｷ･菴懊€りｰ�畑螟ｱ雍･陦ｨ遉ｺ豸域�**譛ｪ**謚暮€偵€�

```json
{
  "type": "object",
  "properties": {
    "subagent_id": {
      "type": "string",
      "description": "The subagent id returned when the background subagent was started."
    },
    "message": {
      "type": "string",
      "description": "The message to deliver to the subagent."
    }
  },
  "required": [
    "subagent_id",
    "message"
  ]
}
```

譚･貅撰ｼ喙`packages/subagent/tool-subagent-control/src/index.ts`](../packages/subagent/tool-subagent-control/src/index.ts)

霑吩ｺ帶弍謗ｧ蛻ｶ蜿ｯ扈ｧ扈ｭ蜷主床 subagent 逧��螻€蜻ｽ蜷榊ｷ･蜈ｷ�夂ｻ大ｮ壽署萓帶婿逧� `tool-subagent` 螳樔ｾ区ｳｨ蜀御ｸ榊酔逧�ｧ疲ｴｾ蟾･蜈ｷ�帶悽蛹�ｳｨ蜀御ｸ€谺｡ `send_message` 蜥� `interrupt_agent`�悟嘗逕ｱ `list_agents` 騾夊ｿ�黒迢ｬ蜉�霓ｽ逧� `/list-agents` 謠剃ｻｶ謠蝉ｾ幢ｼ悟�逶ｮ蠖戊｡御ｽｿ逕ｨ sessionProjections 蜥悟ｮ樊慮 Agent 豕ｨ蜀瑚｡ｨ縲�

## `@deepseek-ai/dsh-tool-subagent-report`

### `report`

蜷大星蜉ｨ菴�逧� agent 謚･蜻企€牙ｮ壼�螳ｹ縲ょ惠菴�扈捺據蜑崎ｰ�畑荳€谺｡�檎ｻ吝�閾ｪ蛹�性逧�怙扈育ｻ捺棡�帛ｽ楢ｿ帛ｺｦ謌門書邇ｰ莨壽隼蜿倩ｯ･ agent 謗･荳区擂逧�｡悟勘譌ｶ�御ｹ溷庄莉･譖ｴ譌ｩ隹�畑縲りｯ･ agent 荳惹ｽ�蜈ｱ莠ｫ蟾･菴懷玄�御ｽ�ｸ堺ｼ夊�蜉ｨ謾ｶ蛻ｰ菴�逧� transcript�域枚譛ｬ隶ｰ蠖包ｼ峨€∝ｷ･蜈ｷ霎灘�謌匁耳逅�ｼ悟屏豁､螳梧�菴�逧�ｷ･菴懈悽霄ｫ蟷ｶ荳咲ｭ我ｺ惹ｺ､蜃ｺ扈捺棡縲よ冠蜻贋ｸ堺ｼ夂ｻ捺據菴�逧�ｽｮ谺｡謌門ｮ梧�菴�逧�ｷ･菴懶ｼ御ｸ泌宵譛臥峩謗･辷ｶ郤ｧ莨壽噺蛻ｰ縲ょ､ｱ雍･逧�ｰ�畑莉榊庄閭ｽ蟾ｲ扈城€∬ｾｾ�悟屏豁､荳崎ｦ∫峇逶ｮ驥榊､阪€�

```json
{
  "type": "object",
  "properties": {
    "output": {
      "type": "string",
      "description": "Actionable content for your parent; summarize conclusions and reference relevant shared paths."
    }
  },
  "required": [
    "output"
  ]
}
```

譚･貅撰ｼ喙`packages/subagent/tool-subagent-report/src/index.ts`](../packages/subagent/tool-subagent-report/src/index.ts)

謖牙庄扈ｧ扈ｭ逧�ｿ帷ｨ句�蟄千ｺｧ豕ｨ蜀鯉ｼ瑚€碁撼蜈ｨ螻€豕ｨ蜀鯉ｼ悟屏豁､隸･ schema 莉�惠霑咏ｧ榊ｭ千ｺｧ蜀�Κ蜿ｯ隗�ｼ悟ｹｶ荳比ｸ榊女蜈ｶ蜈ｨ螻€ `toolFilter` 蠖ｱ蜩阪€ょ酔荳€莉ｽ雍｡迪ｮ霑倅ｼ壼ｮ芽｣�ｭ千ｺｧ菴懃畑蝓溽噪 `tool:report` 邉ｻ扈滓署遉ｺ隸� section�梧悽逶ｮ蠖穂ｸ肴ｸｲ譟楢ｯ･ section縲る擇蜷醍宛郤ｧ逧� `send_message` 蟾･蜈ｷ蜊慕峡螳芽｣�€�

## `@deepseek-ai/dsh-tool-tasks`

### `task_kill`

譬ｹ謐ｮ task id 隸ｷ豎ょ叙豸域ｭ｣蝨ｨ霑占｡檎噪蜷主床莉ｻ蜉｡縲よｭ､隹�畑遶句叉霑泌屓�帑ｻｻ蜉｡逧�ｷ･菴懃悄豁｣蛛懈ｭ｢蜷趣ｼ御ｼ壻ｻ･ killed 迥ｶ諤∫ｻ鍋ｮ励€�

```json
{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "description": "Task id returned by the tool that started the background work."
    },
    "reason": {
      "type": "string",
      "description": "Optional short reason, recorded in the log and forwarded to the task."
    }
  },
  "required": [
    "task_id"
  ]
}
```

譚･貅撰ｼ喙`packages/tasks/tool-tasks/src/index.ts`](../packages/tasks/tool-tasks/src/index.ts)

### `task_list`

蛻怜�菴�逧�錘蜿ｰ莉ｻ蜉｡�亥桁諡ｬ豁｣蝨ｨ霑占｡悟柱蟾ｲ螳梧�逧�ｻｻ蜉｡�牙所蜈ｶ id縲∫ｧ咲ｱｻ蜥檎憾諤√€�

```json
{
  "type": "object",
  "properties": {}
}
```

譚･貅撰ｼ喙`packages/tasks/tool-tasks/src/index.ts`](../packages/tasks/tool-tasks/src/index.ts)

### `task_output`

隸ｻ蜿門錘蜿ｰ莉ｻ蜉｡縲よｵ∝ｼ丈ｻｻ蜉｡蜿ｪ霑泌屓閾ｪ荳頑ｬ｡隸ｻ蜿紋ｻ･譚･逧�ｾ灘��帶怙扈郁ｾ灘�莉ｻ蜉｡莨壼惠扈鍋ｮ怜錘霑泌屓扈捺棡縲よｯ丈ｸｪ蜩榊ｺ秘�莉･ `[status: ...]` 扈灘ｰｾ縲りｯｻ蜿夜ｻ倩ｮ､荳埼仆蝪橸ｼ幄ｮｾ鄂ｮ `wait: true` 蜷趣ｼ梧怙髟ｿ遲牙ｾ�芦驟咲ｽｮ逧�ｸ企剞縲�

```json
{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "description": "Task id returned by the tool that started the background work."
    },
    "wait": {
      "type": "boolean",
      "description": "Block until the task reaches a terminal status or the timeout expires. A timed-out wait returns [status: running] and leaves the task alive."
    },
    "timeout_ms": {
      "type": "number",
      "description": "Max wait in milliseconds (only meaningful with wait: true). Defaults to the configured wait timeout; capped by the configured maximum."
    }
  },
  "required": [
    "task_id"
  ]
}
```

譚･貅撰ｼ喙`packages/tasks/tool-tasks/src/index.ts`](../packages/tasks/tool-tasks/src/index.ts)

荳惹ｻｻ蜉｡遘咲ｱｻ譌�蜈ｳ逧�錘蜿ｰ莉ｻ蜉｡謗ｧ蛻ｶ蝎ｨ�壼錘蜿ｰ bash 蜻ｽ莉､縲￣TY 蜿鷹€∝柱 subagent 驛ｽ騾夊ｿ�嶌蜷檎噪 3 荳ｪ蟾･蜈ｷ隸ｻ蜿悶€∝�蜃ｺ蜥檎ｻ域ｭ｢縲ょ刈霓ｽ隸･謠剃ｻｶ莨壽撃謗･謗ｧ蛻ｶ蝎ｨ�御ｻ手€悟星逕ｨ逕滉ｺｧ譁ｹ逧� `ctx.tasks.start()`縲�

## `@deepseek-ai/dsh-tool-todo`

### `todo_write`

隶ｰ蠖募ｹｶ譖ｴ譁ｰ蠖灘燕蟾･菴懃噪扈捺桷蛹紋ｻｻ蜉｡蛻苓｡ｨ縲よｯ乗ｬ｡隹�畑驛ｽ隕∝書騾�**螳梧紛蛻苓｡ｨ**�悟ｮ�ｼ�**譖ｿ謐｢**荵句燕逧��陦ｨ�御ｸ肴髪謖∝ｱ€驛ｨ譖ｴ譁ｰ謌夜€宣｡ｹ郛冶ｾ代€りｯｷ逕ｨ螳�ｧ��螟壽ｭ･鬪､蟾･菴懷ｹｶ螻慕､ｺ霑帛ｺｦ�壼ｼ€蟋句燕荳ｺ豈丈ｸｪ蜈ｷ菴捺ｭ･鬪､豺ｻ蜉�荳€鬘ｹ todo縲ょｰ�ｽ灘燕豁｣蝨ｨ螟�炊逧�ｯ城｡ｹ todo 譬�ｮｰ荳ｺ `in_progress`�帷｡ｮ螳槫ｹｶ陦瑚ｿ占｡梧慮�井ｾ句ｦょｹｶ蜿� subagent 謌門錘蜿ｰ蜻ｽ莉､�牙庄蜷梧慮譬�ｮｰ螟夐｡ｹ�碁｡ｺ蠎丞ｷ･菴懷�譬�ｮｰ 1 鬘ｹ縲ょ宵隕∝ｷ･菴懷ｰ壽悴螳梧��悟ｰｱ蠎碑�蟆第怏荳€鬘ｹ莉ｻ蜉｡荳ｺ `in_progress`縲よ汾鬘ｹ todo 螳梧�蜷守ｫ句叉譬�ｮｰ荳ｺ `completed`�御ｸ崎ｦ∵音驥乗��ｮｰ螳梧��帛宵譛牙�驛ｨ蟾･菴懷ｮ梧�蜷趣ｼ梧燕蜿ｯ莉･豐｡譛� `in_progress` 鬘ｹ縲らｮ€蜊慕噪蜊墓ｭ･鬪､莉ｻ蜉｡譌�髴€菴ｿ逕ｨ蛻苓｡ｨ縲ら憾諤�ｼ啻pending`�域悴蠑€蟋具ｼ峨€～in_progress`�域ｭ｣蝨ｨ螟�炊�峨€～completed`�亥ｷｲ螳梧��峨€�

```json
{
  "type": "object",
  "properties": {
    "todos": {
      "type": "array",
      "description": "The COMPLETE task list, replacing any previous list.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "content": {
            "type": "string",
            "description": "What the task is 窶� a short imperative line."
          },
          "status": {
            "type": "string",
            "description": "pending (not started) | in_progress (now) | completed (done).",
            "enum": [
              "pending",
              "in_progress",
              "completed"
            ]
          }
        },
        "required": [
          "content",
          "status"
        ]
      }
    }
  },
  "required": [
    "todos"
  ]
}
```

譚･貅撰ｼ喙`packages/todo/tool-todo/src/index.ts`](../packages/todo/tool-todo/src/index.ts)

todo_write 譏ｯ莨夊ｯ晄園譛臥噪迥ｶ諤�ｼ婉I 蟆�怙譁ｰ逧� todo/write 莠倶ｻｶ貂ｲ譟謎ｸｺ譽€譟･貂�黒縲ＡallowParallelInProgress` 譏ｯ豐｡譛蛾ｻ倩ｮ､蛟ｼ逧�ｿ�｡ｫ鬘ｹ�悟屏豁､譛ｬ逶ｮ蠖墓�遑ｮ騾画叫 `true`�悟ｯｹ蠎疲緒霑ｰ蜈∬ｮｸ蜷梧慮蟄伜惠螟壻ｸｪ `in_progress` 鬘ｹ縲る€画叫 `false` 逧�Κ鄂ｲ莨夊執蠕怜酔荳€蟾･蜈ｷ�御ｽ�緒霑ｰ莨夊ｦ∵ｱょ宵閭ｽ譛� 1 荳ｪ豢ｻ蜉ｨ莉ｻ蜉｡縲�

## `@deepseek-ai/dsh-tool-workflow`

### `workflow`

霑占｡檎畑莠主､ｧ隗�ｨ｡郛匁賜 subagent 逧� JavaScript 蟾･菴懈ｵ∬�譛ｬ縲ょｽ灘ｷ･菴應ｼ壼�謨｣蛻ｰ隶ｸ螟夂嶌莠堤峡遶狗噪驛ｨ蛻�慮�瑚ｯｷ菴ｿ逕ｨ豁､蟾･蜈ｷ�御ｾ句ｦょｮ｡譟･螟ｧ驥乗枚莉ｶ縲∵鴬陦瑚ｿ∫ｧｻ縲∝ｼ€螻募､夊ｧ貞ｺｦ遐皮ｩｶ謌門ｯｹ蜿醍鴫霑幄｡悟ｯｹ謚怜ｼ城ｪ瑚ｯ�ｼ帶ｭ､譌ｶ蠎泌ｰ�ｼ匁賜蜀呎�閼壽悽�瑚€御ｸ肴弍騾占ｽｮ蟋疲ｴｾ縲�

蟾･菴懈ｵ∫噪霄ｫ莉ｽ騾夊ｿ� `meta` 蜿よ焚莉･ JSON 蠖｢蠑丈ｼ�蜈･�壼ｿ�｡ｫ逧� `name`�育ｮ€遏ｭ kebab-case�牙柱 `description` 蟄礼ｬｦ荳ｲ�御ｻ･蜿雁庄騾臥噪 `whenToUse` 蟄礼ｬｦ荳ｲ蜥� `phases` 謨ｰ扈�ｼ�{title, detail?, provider?, model?}`�峨€Ａscript` 蜿よ焚蜿ｪ閭ｽ譏ｯ郤ｯ JavaScript **蜃ｽ謨ｰ菴�**�御ｸ崎�譏ｯ TypeScript�御ｹ滉ｸ崎�蛹�性 `export const meta` 隸ｭ蜿･�嬶eta 譏ｯ蜿よ焚閠碁撼莉｣遐√€り�譛ｬ謾ｯ謖�｡ｶ螻� await�幄ｯｷ莉･ `return <value>` 扈灘ｰｾ�瑚ｯ･蛟ｼ蠢�｡ｻ蜿ｯ莉･ JSON 蠎丞�蛹厄ｼ悟ｹｶ菴應ｸｺ豁､蟾･蜈ｷ逧�ｻ捺棡縲�

閼壽悽蜃ｽ謨ｰ菴捺署萓帑ｻ･荳矩朝蟄撰ｼ�

- `agent(prompt, opts?): Promise<any>`�夊ｿ占｡御ｸ€荳ｪ subagent 逶ｴ閾ｳ螳梧�縲ゆｸ肴署萓� `opts.schema` 譌ｶ�瑚ｧ｣譫蝉ｸｺ蟄千ｺｧ譛€扈域枚譛ｬ�帶署萓� `opts.schema` 譌ｶ�悟ｮ�ｿ�｡ｻ譏ｯ莉･蟇ｹ雎｡荳ｺ譬ｹ縲∽ｸ�**蜿ｪ閭ｽ**菴ｿ逕ｨ type/properties/required/additionalProperties/items/enum/const/oneOf 逧� JSON Schema�御ｸ肴髪謖� pattern/format/謨ｰ蛟ｼ霎ｹ逡鯉ｼ梧ｭ､譌ｶ隗｣譫蝉ｸｺ騾夊ｿ��｡鬪檎噪蟇ｹ雎｡縲ょｭ千ｺｧ螟ｱ雍･譌ｶ隗｣譫蝉ｸｺ `null`�悟庄菴ｿ逕ｨ `.filter(Boolean)` 霑�ｻ､縲ょ�莉夜€蛾｡ｹ蛹�峡 `label`�域仞遉ｺ蜷咲ｧｰ�峨€～phase`�郁ｿ帛ｺｦ扈�ｼ会ｼ御ｻ･蜿顔嶌莠堤峡遶狗噪 `provider`�汁model` LLM�亥､ｧ隸ｭ險€讓｡蝙具ｼ臥岼譬�ｦ�尠鬘ｹ�御ｸ､閠�庄蜊慕峡謠蝉ｾ帙€ょ�莉紋ｻｻ菴暮€蛾｡ｹ��effort`�汁isolation`�汁agentType`�蛾�莨壽�遑ｮ謚･髞吶€�
- `pipeline(items, ...stages): Promise<any[]>`�夊ｮｩ豈丈ｸｪ譚｡逶ｮ蛻�悪扈剰ｿ�推髦ｶ谿ｵ�碁亳谿ｵ荵矩龍**豐｡譛�**螻城囿�帛､夐亳谿ｵ蟾･菴應ｼ伜�菴ｿ逕ｨ螳�€よｯ丈ｸｪ髦ｶ谿ｵ謗･謾ｶ `(prev, item, index)`縲よ勸騾夂噪髦ｶ谿ｵ蠑ょｸｸ莨壼ｰ�ｯ･**譚｡逶ｮ**蜿倅ｸｺ `null`�悟ｹｶ霍ｳ霑�ｮ�噪蜑ｩ菴咎亳谿ｵ縲�
- `parallel(thunks): Promise<any[]>`�壼ｹｶ蜿題ｿ占｡碁峺蜿よ焚蜃ｽ謨ｰ蟷ｶ遲牙ｾ�**蜈ｨ驛ｨ**螳梧�縲ょｮ�ｼ壼ｽ｢謌仙ｱ城囿�御ｻ�ｽ捺汾荳ｪ髦ｶ谿ｵ遑ｮ螳樣怙隕∵ｱ�€ｻ蜈ｨ驛ｨ蜈亥燕扈捺棡譌ｶ菴ｿ逕ｨ縲よ鴨蜃ｺ蠑ょｸｸ逧� thunk 隗｣譫蝉ｸｺ `null`縲�
- `phase(title)`�壼ｼ€蟋倶ｸ€荳ｪ霑帛ｺｦ髦ｶ谿ｵ�嫣log(message)`�夊ｯｴ譏手ｿ帛ｺｦ�嫣args`�壼ｷ･蜈ｷ隹�畑逧� `args` 霎灘��悟次譬ｷ謠蝉ｾ帙€�

螯よ棡隸ｯ逕ｨ髓ｩ蟄撰ｼ亥盾謨ｰ髞呵ｯｯ縲∵悴遏･騾蛾｡ｹ縲∽ｸ榊女謾ｯ謖∫噪 schema縲∬ｧｦ蜿台ｸ企剞�会ｼ梧鴨蜃ｺ逧�漠隸ｯ**諤ｻ莨�**扈域ｭ｢閼壽悽�檎ｻ昜ｸ堺ｼ夐€€蛹紋ｸｺ蜊穂ｸｪ譚｡逶ｮ逧� `null`縲�

郤ｦ譚滂ｼ壼ｹｶ蜿台ｸ企剞蜥� agent 諤ｻ謨ｰ荳企剞蝮�ｼ夂函謨茨ｼ帑ｸ肴署萓帶枚莉ｶ邉ｻ扈溘€∫ｽ醍ｻ懊€∝ｮ壽慮蝎ｨ謌� Node.js API縲ょ�菴灘ｷ･菴懃罰 agent 螳梧��瑚�譛ｬ蜿ｪ雍溯ｴ｣郛匁賜縲りｯ･霑占｡悟惠蜑榊床謇ｧ陦鯉ｼ壽紛荳ｪ閼壽悽螳梧�蜷趣ｼ瑚ｰ�畑謇堺ｼ夊ｿ泌屓縲�

```json
{
  "type": "object",
  "properties": {
    "script": {
      "type": "string",
      "description": "The plain-JS workflow script body (top-level await allowed; NO `export const meta` statement; end with `return <json-value>`)."
    },
    "meta": {
      "type": "object",
      "description": "The workflow identity block (plain JSON 窶� never code).",
      "additionalProperties": true,
      "properties": {
        "name": {
          "type": "string",
          "description": "Short kebab-case workflow name."
        },
        "description": {
          "type": "string",
          "description": "One-line description of what the workflow does."
        },
        "whenToUse": {
          "type": "string",
          "description": "Optional guidance on when this workflow applies."
        },
        "phases": {
          "type": "array",
          "description": "Optional phase declarations matched by phase() calls.",
          "items": {
            "type": "object",
            "additionalProperties": true,
            "properties": {
              "title": {
                "type": "string",
                "description": "The phase title phase() calls match by exact string."
              },
              "detail": {
                "type": "string",
                "description": "Optional one-line description of the phase."
              },
              "provider": {
                "type": "string",
                "description": "Optional provider override this phase is expected to use."
              },
              "model": {
                "type": "string",
                "description": "Optional model override this phase is expected to use."
              }
            },
            "required": [
              "title"
            ]
          }
        }
      },
      "required": [
        "name",
        "description"
      ]
    },
    "args": {
      "type": "object",
      "description": "Optional JSON input exposed to the script as the `args` global (wrap a bare list as a field, e.g. {\"files\": [...]}).",
      "additionalProperties": true
    }
  },
  "required": [
    "script",
    "meta"
  ]
}
```

譚･貅撰ｼ喙`packages/workflow/tool-workflow/src/index.ts`](../packages/workflow/tool-workflow/src/index.ts)

## `@deepseek-ai/dsh-tool-web`

### `web_fetch`

闔ｷ蜿匁欠螳� HTTP(S) URL 逧��螳ｹ�悟ｹｶ蟆��隗｣遐∽ｸｺ譁�悽蜷手ｿ泌屓縲�

```json
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The HTTP(S) URL to fetch."
    }
  },
  "required": [
    "url"
  ]
}
```

譚･貅撰ｼ喙`packages/web/tool-web/src/index.ts`](../packages/web/tool-web/src/index.ts)

### `web_search`

蝨ｨ Web 荳頑頗邏｢譛€譁ｰ菫｡諱ｯ縲りｿ泌屓蜿ｯ騾臥噪鞫倩ｦ∫ｭ疲｡亥柱貅� URL 蛻苓｡ｨ縲�

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query."
    }
  },
  "required": [
    "query"
  ]
}
```

譚･貅撰ｼ喙`packages/web/tool-web/src/index.ts`](../packages/web/tool-web/src/index.ts)

web_search 蜥� web_fetch 蟆�署萓帶婿騾画叫鄂ｮ莠� ctx.web 荵句錘�御ｽｿ讓｡蝙句庄隗� schema 蝨ｨ譖ｴ謐｢蜷守ｫｯ譌ｶ菫晄戟遞ｳ螳壹€�