前言¶
在 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 或社区目录了解更多详情。
