ARTICLE · 1334269
dsh-superagent 文档|005 面板

在 DeepSeek Harness Web 侧边栏中打开 Superagent,即可对智能体进行监督。面板优先呈现需要人工处理的工作,其次是系统健康状态与历史记录。本文档建立在 000 理念 至 004 提示词 的基础上。
三个问题
打开面板即回答三个问题,顺序如下:
现在有什么需要我处理? 系统是否健康、是否在做正确的事? 某一件工作从触发器(Trigger)经评估(Eval)到工单(Ticket)的完整历史是什么?
标签页
标签页依照工作流的顺序排列:概览(Overview)、来源(Source)、触发器(Trigger)、评估(Eval)、执行(Execution) 和 设置(Settings)。在仓库与账号配置成功之前,概览页会显示缺失项,并链接到相应设置。
单条记录的解读
被丢弃的消息会链接到对应的工单;若该消息没有工单,则链接到对应的会话线程。来源页会说明是该会话本身消失了,还是来源停止了对它的监听。
仍由执行器持有的人工追加消息会标记为 已送达工单(Delivered to Ticket),不进入评估。会话线程还会显示交还原因以及仅提供上下文的订阅。重新评估(Evaluate again) 可以把该追加消息送入评估,或重试一个没有有效判定的触发器——包括被其来源过滤掉的触发器、评估不可用时的触发器,以及既无非中止决策、也无执行器确认的已送达消息。
工单详情显示发起该工单的触发器、决策及理由、作用域和策略(Policy)版本。分派与次级详情折叠在即时操作下方。当输入投递失败,或某工单在上报(Report)被拦截或失败后转为等待人工处理时,可以使用 重试(Retry)。已结束的工单会显示结果,例如 拉取请求已合并(Pull request merged) 或 已被人工停止(Stopped by a person)。
设置分组
- 来源(Sources):
每个来源一张卡片,包含其开关、字段以及经过验证的账号信息。GitHub 还提供针对新议题(Issue)、拉取请求、评论以及默认分支 CI 的“全部接收(receive-all)”开关。轮询与读取上限位于高级(Advanced)选项中。 - 评估(Eval):
策略版本与规则,随后是 各来源设置(On each Source) 与评估设置。每个来源的标签页包含其允许列表、成员同步、准入表以及机器人列表。同步在启动时运行,也可点击 立即同步(Sync now)。准入表区分接收范围、发送者成员身份,以及消息是否在呼叫智能体。评估设置用于选择接收模式、超时时间和判定模型。 - 执行(Execution):
worker 模型、并发数、目录根路径、准备命令(prepare command)与拦截命令(blocked commands)。点击某个可用变量即可将其插入准备命令。 - 提示词(Prompts):编辑(Edit)
可修改团队段落、内置片段与技能。完整提示词(Full prompt) 显示组装后的文本,并将其与已保存文本或默认文本进行比较。历史(History) 列出版本。被编辑过的内置片段会标记为已修改,并可以重置;模板会列出其必需的占位符。
升级若修改了被覆盖的默认内容,会将其标记为 默认内容已更新(Default updated)。面板会在团队文本上方比较新旧默认内容。若旧默认内容未被记录,则改为将团队文本与新默认内容比较。可选择 保留我的文本(Keep my text) 或 使用新默认(Use the new default)。对已被移除部分的覆盖会列在标签栏下方,并在下次保存时被丢弃。 - 部署(Deployment): 启动问题及 重新检查(Check again)、状态目录与机器限制。已保存的限制无需重启即可生效。DeepSeek Harness 插件管理器提供同样的页面。
搜索
顶部的搜索可按文本、id、飞书消息 id 或已存储的链接(例如 GitHub 评论 URL)查找触发器。若原始消息中缺失飞书链接,只有当宿主在本次进程运行期间读取到该链接后,它才可被搜索到。
搜索还可以按 #12 这类引用或 GitHub URL 查找会话线程,按标题或匹配的会话线程查找工单。
原则
- 聚焦重点。
每个元素都在回答三个问题之一,否则就删除。只有当一个数字会改变监督者的行动时,才显示它。 - 定义精确。
每个类别都有可核验的定义,互斥且穷尽——工单阶段即是如此。标签说明某一行在等待谁、需要什么,而不是内部状态码。 - 一个概念只有一个归属地。
来源状态归来源页;会话线程与触发器归触发器页;决策归评估页;工单归执行页。设置按其配置的概念分组。概览页对这些页面做汇总并链接过去,而不是成为又一个详细视图。 - 遵循领域结构。
面板使用领域术语。内部标识符只出现在折叠的详情中;能解析出名称的地方用名称替代标识符。 - 状态诚实。
计数必须与其链接到的列表长度一致,任何状态都不得与其他事实矛盾。 - 默认安静。
健康状态不占用额外空间。问题必须可行动;一次偶发的网络错误不足以成为问题。需要人工处理的行直接提供其操作。页面说明保持一句话,更多细节放在 (?) 悬浮提示中。破坏性操作需要确认。 - 控件一致。
使用 DeepSeek Harness 的设计令牌(design token)与控件行为。同一信息在整个面板中应保持相同的外观。每个设置区块只有一个保存栏,仅在存在改动、正在保存或保存失败时可见。















































































