dongsheng123132/dshx

dshx 是做什麼的？

使用 dshx 作為上游 dsh --profile headless 執行階段的機器邊界。保持任務範圍明確，並將工作目錄設定為明確的空間。

準備就緒

執行：

dshx doctor --json

在委派付費/模型工作之前，要求 node_supported、dsh_available 和 api_key_present 均為 true。切勿輸出憑證值。

如果缺少 dshx，請說明固定的安裝指令，並僅在使用者授權後執行：

npm install -g @hfshfg/[email protected]

委派單一任務

偏好使用 stdin，這樣任務文字就不會依賴於 shell 的引號處理：

dshx run --stdin --cwd ./workspace --timeout 1800000 --json

將任務透過管道或重新導向傳入 stdin。若指令長度超過 24,000 個字元，請將原始素材寫入已授權的工作目錄內，並發送一個引用該檔案的簡短任務。

根據任務選擇適當的逾時時間。一般編碼工作保留預設的 30 分鐘；診斷任務則使用較短的界限。除非使用者明確要求持久執行，否則不要設定無限制的逾時。

解讀結果

• ok: true，reason: completed：回傳或摘要顯示 text，並報告 duration_ms。
• reason: failed：報告上游的退出碼與簡潔的診斷資訊。
• reason: timeout：說明程序樹已在宣告的界限處被終止；不要聲稱任務已完成。
• reason: output_limit：縮小任務範圍，或要求 DSH 在工作目錄中寫入結果檔案。
• 退出碼 2 表示本機參數/輸入錯誤；修正呼叫方式後再重試。

將 stdout 視為結果通道，stderr 視為診斷資訊。不要解析 ANSI 或旋轉動畫輸出；dshx 會從機器結果中移除它們。

界限

• 僅委派使用者授權工作目錄內的工作。
• 請勿將 API 金鑰或其他機密資訊包含在任務文字、argv 或輸出摘要中。
• 請勿使用 dsh web 進行代理間委派；它是面向人類的瀏覽器 UI。
• 在將 DSH 變更和測試結果呈現為完整之前，請先審查它們。
• 請記住 DeepSeek Harness 是開發者預覽版，dshx 0.2.1 固定使用 @deepseek-ai/dsh 0.1.0-rc.6。