dsh-superagent/docs/005-面板.md

005 面板

在 DeepSeek Harness Web 侧边栏打开 Superagent 来监督 agent。面板优先显示需要人的工作，其次是系统健康与历史。本文建立在 000 理念 到 004 提示词 之上。

三个问题

打开面板回答三个问题，按这个顺序：

1. 现在有事需要我吗？
2. 系统健康吗，在做对的事吗？
3. 一件工作从 Trigger 经 Eval 到 Ticket 的历史是什么？

标签页

标签页跟着工作流走：Overview、Source、Trigger、Eval、Execution、Settings。在仓库与账号设置成功之前，Overview 显示缺了什么，并链接到相关设置。

标签页	显示
Overview	需要处理的 Ticket、系统问题、最近 24 小时的活动计数、以及 Executor 负载。每个块链接到它的明细页
Source	Source 状态、设置问题、以及非零计数。被过滤的 Triggers 与被丢弃的消息覆盖与 Overview 相同的 24 小时窗口
Trigger	按 Subscribed、Evaluating、New Triggers in 24 h 或 All Threads 过滤的 Threads。每个 Thread 按新到旧显示它的 Triggers、Decisions 与 Subscriptions
Eval	Decisions 及其理由与命中的规则
Execution	Executor 状态、Pause 处理，以及按 Open、Pending、Working、Waiting for a Trigger、Ended 过滤的 Tickets。Ticket 详情显示 actions、授权、等待中的 Inputs、Subscriptions 与 Assignments
Settings	Sources、Eval、Execution、Prompts 与 Deployment。每个分组都带有自己的保存历史

读单条记录

一条被丢弃的消息链接到它的 Ticket，没有 Ticket 时链接到它的 Thread。Source 页面说明是那个对话消失了，还是 Source 不再监听它。

仍由某个 Executor 认领的人类跟进会标为 Delivered to Ticket，不经过 Eval。Thread 上还会显示交还原因与仅收上下文的 Subscriptions。Evaluate again 可以把这条跟进送进 Eval，或重试一个从未得到有效判断的 Trigger：被其 Source 过滤掉的、Eval 不可用的、或已送达但既无非 stop 的 Decision 也无 Executor 认领的消息。

Ticket 详情显示发起的 Trigger、Decision 与理由、scope 和 Policy 版本。Assignments 与次要细节折叠在直接操作的下方。Input 投递失败、或一次被阻/失败的 Report 之后 Ticket 在等人时，可以 Retry。Ended Tickets 显示结果，例如 Pull request merged 或 Stopped by a person。

Settings 分组

• Sources： 每个 Source 一张卡片，带它的开关、字段与已验证的账号事实。GitHub 还提供对 Issue、pull request、评论与默认分支 CI 全量接收的开关。轮询与读取上限在 Advanced 里。

• Eval： Policy 版本与规则，然后是 On each Source 与 Eval 设置。每个 Source 标签里含它的允许名单、成员同步、准入表与 bot 名单。同步在启动时与点 Sync now 时运行。准入表区分接收范围、发送者成员身份、以及消息是否点名 agent。Eval 设置选择 accept mode、超时与评估模型。

• Execution： worker 模型、并发、目录根、prepare command 与被屏蔽的命令。点一个可用变量会把它插入 prepare command。

• Prompts： Edit 修改团队分节、内置部件与技能。Full prompt 显示拼装后的全文，并与已存文本或默认文本对比。History 列出各版本。编辑过的内置部件标为 changed 并可重置；模板列出其必需占位符。

  升级改动了某个被覆盖的默认值时，会标 Default updated（默认内容已更新）。面板在团队文本上方比较新旧默认值；若旧的默认值没被记录，则改为比较团队文本与新默认值。选 Keep my text 或 Use the new default。已移除部件的覆盖列在标签栏下方，下次保存时被丢弃。

• Deployment： 启动问题与 Check again、状态目录与机器限制。保存的限制无需重启即生效。DeepSeek Harness 的 Plugin Manager 暴露同一页面。

搜索

头部搜索按文本、id、Feishu 消息 id 或已存的链接（例如一条 GitHub 评论的 URL）查找 Triggers。原始消息里缺失的 Feishu 链接，只有在当前进程存活期间被 host 读到之后才可搜。

搜索还能按 #12 或 GitHub URL 这类引用找 Threads，按标题或匹配 Thread 找 Tickets。

原则

1. 只关心要紧的。 每个元素要么回答三个问题之一，要么删掉。一个数字只有当它改变监督者的动作时才出现。
2. 定义精确。 各类别有可核对的定义、互斥、且覆盖所有情形，像 Ticket 阶段那样。标签说这一行在等谁、需要什么，而不是内部状态码。
3. 一个概念一个地方。 Source 状态归 Source；Threads 和 Triggers 归 Trigger；Decisions 归 Eval；Tickets 归 Execution。设置按它们配置的概念分组。Overview 汇总这些页面并链接过去，而不是变成又一个明细视图。
4. 领域结构。 面板使用领域术语。内部标识符只出现在折叠的细节里，能解析出名字的地方用名字代替标识符。
5. 状态诚实。 一个计数等于它链接去的列表的长度，且没有任何状态与其他事实矛盾。
6. 默认安静。 健康的状态不多占空间。问题必须可操作；一次偶发的网络错误不算。需要人的行直接就地提供它的动作。页面解释保持一句话，更多细节放（?）提示里。破坏性动作要确认。
7. 控件一致。 使用 DeepSeek Harness 的设计令牌与控件行为。同样的信息在整个面板里应当长得一样。每个设置分组只有一条保存栏，仅在存在改动、保存进行中或保存失败时可见。