前言¶
在 DeepSeek Harness (DSH) 中處理複雜工程任務時，通常需要將高層目標分解爲連續的里程碑，並保持對進度的清晰可見。如果沒有自主追蹤框架，智能體可能會在輪次之間丟失上下文，陷入被動循環，或在複雜工作流停滯時無法通知用戶。
核心功能¶
goodandready/dsh-goal 爲 DSH 引入了目標模式。它是一個自主目標執行和多輪任務追蹤引擎，帶有 Sticky Header。
狀態與控制¶
- Sticky Top Goal Banner：固定在輸入欄上方的橫幅，實時顯示已用時間、狀態（RUNNING/PAUSED/COMPLETED）、目標標題和控制按鈕。
- Play / Pause / Resume / Cancel：通過按鈕或命令即時暫停、恢復或取消自主循環。
- Milestone Breakdown & ETA：交互式清單，展示子任務狀態（pending/in_progress/completed/failed）、進度條和動態完成時間估算。
智能體增強¶
- Live Steering & Nudge：在不終止循環的情況下，動態澄清、修改或引導智能體的當前目標。
- Autonomous Agent Contract：向智能體提供
goal_set_milestones、goal_update_progress和goal_finish工具。 - Core DSH Goal Tools Interception：無縫兼容調用內置 DSH 目標工具的模型。攔截
complete、pause、resume等操作，繞過導致崩潰的權限限制，並將所有狀態更新路由到 GoalEngine。
安全與穩定性¶
- Tool-Failure Breaker：當連續工具錯誤達到配置閾值（默認 3）時，停止循環以防止令牌浪費。
- Safety Guardrails：可配置的
maxIterations安全限制和 Smart Progress Guard，用於檢測並暫停沒有進展的閒置輪次。
反饋與導出¶
- Native Browser Notifications：基於 HTML5 Notification API 的桌面推送通知，用於長任務完成或需要關注的情況。
- Token Usage Tracking & Markdown Export：追蹤會話中的提示、完成和總令牌數，支持一鍵導出 Markdown 摘要。
- Web Audio Chimes：使用 Web Audio API 提供完成或失敗時的合成音效反饋。
快速啓動¶
- 10 Quick Launch Presets：預置的工程提示詞芯片，包括 Fix Bug, Refactor YAGNI, Tests & Coverage, Code Review, Security Audit, New Feature, Docs, Upgrade Deps, Dead Code Cleanup, Performance。
- Quick Launch Button：固定在消息輸入框上方的快速啓動按鈕，可點擊彈出目標輸入模態框。
工程與協作¶
- Git Checkpoint Snapshot：自動捕獲起始提交哈希，提供
git diff和回滾命令。 - GitHub & Gitea PR Comment Export：一鍵生成格式化的 PR 評論，包含可摺疊的里程碑卡片和令牌遙測數據。
語言支持¶
- Multi-Language Auto-Detection：自動檢測用戶輸入語言（英文、中文、俄文），UI 標籤和提示注入自動跟隨。
用法¶
插件通過命令行接口與用戶交互：
/goal <objective>：啓動新的自主目標。/goal pause：暫停當前目標並停止智能體輪次。/goal resume：恢復執行並觸發智能體繼續。/goal clear：將會話目標重置爲 IDLE。/goal：顯示狀態、已用時間、ETA、迭代次數、令牌數和活躍里程碑。
架構¶
插件主要由以下幾個部分協作完成任務：
- 用戶界面與交互：處理
/goal命令、Sticky Top Goal Banner（橫幅）、Goal Details & Milestone Modal（詳情模態框）以及 Quick Launch Button（快速啓動按鈕）。 - Goal Engine Core：核心引擎（
lib/goal-engine.js），負責管理會話目標、里程碑狀態、時間計算、令牌累加器以及語言檢測（detectLanguage）。它負責將狀態同步到持久化存儲（goal-state.json）。 - Autonomous Loop：自動化驅動與輪次協調器（
lib/index.js），監聽turn/end事件。它包含 Smart Progress Guard（智能進度守衛）和迭代限制器，並根據狀態向智能體注入提示。 - Agent Tools：註冊到 Cordis 的工具集，包括
goal_set_milestones、goal_update_progress和goal_finish。
安裝與依賴¶
插件以當前 DSH 進程的權限運行。安裝前應檢查源碼與許可證。
- Node 版本：需要 Node 20+。
- 依賴項：
@deepseek-ai/schemastery。 - Peer Dependencies：
{
"@deepseek-ai/cordis": "^4.0.1",
"@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
"@deepseek-ai/schemastery": "^3.18.1",
"@deepseek-ai/dsh-goal": ">=0.1.5-rc.3"
}
適用場景與注意¶
- 適用場景：適合需要長時間運行、多步驟自動化的工程任務，如代碼重構、自動化測試、文檔生成或複雜調試流程。
- 注意：由於插件直接干預 DSH 的核心工具調用邏輯，請確保在安裝前審查其源碼實現，以符合你的安全與審計要求。
結尾¶
該插件通過提供 Sticky Header、狀態可視化和工具攔截機制，解決了 DSH 智能體在長鏈路任務中上下文丟失和缺乏反饋的問題。開發者可以通過 GitHub 或社區目錄瞭解更多詳情。
