DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

Ghost233 /

Ghost233/GhostAgentSentinel

Verified

面向各类 AI agent 的通用任务与运行状态监控工具

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@56adb1c2

GhostAgentSentinel

面向 AI agent 的本机只读执行监控工具。两端共用代码并分别运行独立 Core。DSH 观察主代理及多级子代理,Codex 观察本机主聊天及分叉主会话。当前源码及两端本地安装包版本为 0.4.8。本地验收范围见发布验证范围。

同一份 Codex 插件提供会话检查与全局安装设置两个独立面板,无需另一份设置插件。监控页分为“当前问题”和“详情”,顶部 GS 在滚动时固定,依据放在对应问题下。设置页分为“设置”“通知记录”和“连接诊断”,模型分组自动保存,两个模型各有“读取列表”和“检查连接”。

双队列设置将会话查询与模型分析分开。Codex 默认同时查询 2 个会话,查询间隔为 1.5 秒;LLM 分析默认 1 路,可改为 4 路。两个并发数均支持 1~16,查询间隔支持 0.25~3600 秒,修改后按安装自动保存。分析队列取得材料后独立运行,同一执行的待处理材料合并,不重复排队。已监控的执行结束后补一次收尾摘要。DSH 直接接收原生事件,只提供 LLM 并发设置。

执行摘要固定回答三件事:“在做什么”“有什么进展”“卡在哪里”。正常调查、测试运行中和任务尚未完成不自动算作阻碍。观察缺口和六项检查单独说明,已有总结和原始引用继续保留。

JEV 根据摘要和原始记录判断当前执行是否阻塞。摘要旁显示“已阻塞”“未阻塞”或“待确认”及简短原因,可展开查看依据。DSH 的“详情”展示带观察范围和引用的部分观察摘要。已监控的执行结束后,可在对应节点查看收尾摘要。

Codex 通知采用聊天优先:先显示聊天名称,再显示问题状态、原因和下一步。点击通知打开对应聊天;技术 ID 留在诊断记录,已恢复故障另行标明。缺少明确聊天身份的来源级提醒不猜测目标。

兼容性按公开接口响应和记录结构判断,App、构建号和 CLI 版本仅作诊断信息。未知事件形成明确材料缺口,后续已知记录继续采集;结构损坏、身份或可信前缀不符仍停止对应读取。分叉继承中的未知材料也保留缺口,不显示为正常结论。模型配置、暂停和原有读取预算继续保留。

0.2.10 修复 GMD 总结请求继承默认思考预算、反复耗尽输出额度而无法发布结果的问题。只对已声明受管能力的 GMD 总结请求限制思考预算,预填与生成使用同一策略;有缺口的材料继续显示带引用的部分观察总结。

0.2.8 修复工具返回图片阻断后续采集和长会话超预算后跳过模型的问题。材料不足时显示带引用的“部分观察总结”,列出缺口,相关检查保持不可判断。

0.2.7 修复过期身份占满采集额度及补读过程反复提醒。正文和结果继续保留 24 小时,过期身份仍精确防重放。进入对应聊天且会话检查面板可见时,撤下该聊天已显示的通知;故障记录和后续新提醒保留。Codex 更新时按安装身份复制旧 Core 中的自身资料,启动独立 Core;DSH 保持运行,不需要一起停用。

安装

从 GitHub 发布页 下载对应版本的 DSH 安装包 ghost-agent-sentinel-<版本>.tgz,解压到长期保留的目录。在 DSH 的“插件 → 安装第三方插件”中选择解压后的 package 目录,安装并启用 ghost-agent-sentinel。

Codex 通过 GitHub 仓库市场安装。添加仓库后,按“插件 → 个人 → GhostSentinel(或 GhostSentinel test)→ 添加”安装。正式版与 test 可独立安装和并存,配置、通知和暂停状态各自保存。

DSH Host 需要支持 Node.js 22.13 或更新版本及 node:sqlite。DSH 插件使用宿主提供的 SDK 和 React,没有 npm 运行依赖或安装脚本。当前原版宿主缺少部分历史补采和父代理等待依据时,明确显示覆盖缺口,见 安装说明与兼容性。

查看运行情况

DSH 使用下列入口。Codex 在当前聊天的 GhostSentinel 会话面板中查看。

  • 全局总览:在右侧“新标签页 → Sentinel”打开,按主会话分组查看已接入后台及其代理树,问题优先,可隐藏正常节点。
  • 当前会话检查:输入框下方的 GS 入口显示绿、黄、红、灰四类代理数量。点击后查看当前代理及其后代,依据直接放在对应节点下方。无法显示底部入口的只读会话使用顶部备用入口。
  • 后台持续:隐藏或关闭总览后,后台采集、分析和通知检查继续。桌面通知需要连接中的 DSH 客户端及通知权限。

绿灯表示当前正常或有依据地等待用户/子代理;黄灯表示观察中的疑点或静默;红灯表示已有依据的告警;灰灯表示尚无判断或覆盖缺口。每个活动代理只计一次,已结束节点退出运行计数。新材料排队时,可保留仍有效的上轮绿灯并标注“上轮正常 · 待分析”。

首次检查没有可见执行活动可显示黄灯;已有活动后,连续静默至少 60 秒再黄。代理文字、工具开始和工具结果均算活动。黄灯本身不发送桌面告警,无输出也不等于卡死。

接入与模型配置

每份独立 DSH 配置启用一次插件。使用同一监控数据目录的后台共用核心;总览的来源清单显示已连接、等待连接、断开及停用的配置。清单只覆盖已登记范围,不保证自动发现整机全部后台。

每份安装独立保存总结模型和 JEV 判断模型,同一安装内的聊天共用设置。DSH、Codex 正式版与 test 可选择同一服务,修改一方的设置只影响该安装。旧共享模型配置需要重新手填,不迁移或导入,也不删除其它观察资料。

Codex 从同一插件的全局入口打开安装设置,DSH 从宿主系统设置打开 Sentinel。设置不依赖当前聊天身份或采集成功。分别填写两个角色的服务地址和模型 ID,完成有效分组编辑后自动保存;半填输入保留为草稿,旧有效配置继续使用。

总结模型使用 /v1/chat/completions,JEV 判断使用 /v1/systemone。两个地址可相同,只接受回环 HTTP(S) 地址,不保存 API 密钥。普通聊天接口可用不证明 JEV 判断接口可用。插件不下载、更换或启动模型。

每个模型的“读取列表”和“检查连接”分别执行只读查询。除 GET /v1/models 外,可用 GMD 的 /api/v1/models 补充模型角色;同一模型可以同时支持文本与 JEV。读取列表只更新候选,保留手填;检查连接只核对在线和所填模型,不发送聊天材料或推理请求。服务在线、模型可见与本轮分析成功分别显示;模型可见不证明 JEV 能力已经验证。

本轮总结模型和 JEV 均成功,且输出与引用有效后,发布附依据的完整执行摘要。有效摘要只覆盖部分材料时,标注观察范围并保留上次完整摘要。分析失败或未完成时,旧摘要按历史显示。保存配置会取消本安装的旧分析并忽略晚到结果,活动任务按新配置公平排队。采集、原任务及其它安装继续运行,手动暂停保持。

未配置模型或模型失败时仍采集,并如实显示依赖失败、不可判断、排队和滞后。失败后沿用分析队列退避,默认间隔为 60、120、240、480 秒,最长 900 秒。同一服务和模型恢复后自动继续合法分析;恢复不解除手动暂停。模型判断准确度、GPU 拥堵和推理耗时不属于本次框架发布的验收承诺。

服务明确声明支持 gmd-prefill/1 时,空闲分析机会可预填总结模型;前一操作完成并释放后再继续。预填只发送共享证据前缀。正式生成固定本轮材料,依次发送三次请求,每次回答一个问题。三次共用同一缓存身份。校验全部回答及引用后,合并三行摘要,再由 JEV 根据摘要和原始依据判断。未声明支持的服务沿用普通分析接口;受管操作失败不会改发另一份非受管生成。未知状态继续异步核对,只有本次操作的可信结束或未提交证明才解除其调用资格。真实预填需要匹配版本的 GMD、GhostSplash 与实际受支持的模型组合,不能靠填写模型名称启用。

数据和提醒

默认保存到 ~/.ghost-agent-sentinel。任务身份、状态、输入、输出和工具记录以短摘录保留,默认每条最多 240 字符单元,截断与缺口会标明。观察事件、摘要、证据和告警滚动保存 24 小时;来源配置另行持久保存。插件不会给原聊天发消息、控制原任务或主动读取工作区补采版本指纹。

显式认证头、常见凭据字段、私钥和已识别的凭据读取命令在采集与核心接收处整字段省略,并标明缺口。该规则不能识别任意形式的秘密文本。

六项检查包括推进不足、偏离请求、同类返工、完整验证重复成本、当前版本本地验证缺口和长等待。子代理按实际委派任务及仍有效的用户限制检查;缺少应有证据时保留不可判断。活动代理公平排队,各自在一轮分析结束后冷却 60 秒;成功且条件未变的结果可复用。

Codex 持续监控来源有效且仍在执行的会话,接入时无需再发送用户消息。当前请求未核实时,仍总结近期活动,并按执行证据检查同类返工和完整验证重复成本。推进不足、偏离请求和当前版本本地验证缺口分别显示请求证据不足。手动暂停和来源失联停止对应分析,确认执行结束后只补收尾摘要。

同一主会话的多代理告警最多等待 3 秒合并为通知,同一持续问题至少间隔 10 分钟再次提醒。任务结束、来源失联或依据失效时停止对应重复提醒。系统接受通知与用户实际看见分别表达。取消分析会忽略晚到结果,底层模型计算可能稍后结束。

任务告警和监控故障通知按安装分别控制,关闭后取消对应待发提醒,重新开启不补积压。DSH 监控故障通知后置,设置明确显示“暂不支持”。通知记录汇总本安装全部已监控聊天,两类合计保留最近 24 小时内最新 1000 条,按页读取,保留真实聊天归属和投递状态。

旧运行 Core 不会因更新插件文件自动获得新接口。缺少通知读取或撤销能力时,客户端明确报不支持;未发出的保存请求显示明确拒绝,不伪报保存成功,也不自动替换或终止 Core。维护窗口的人工切换说明见 安装说明。

开发与验证

源码测试在本地 macOS arm64 完成,依赖已构建的 DSH-Workflow SDK 与其测试解析器。默认查找同级 DSH-Workflow 目录,也可指定绝对路径:

npm ci --ignore-scripts
npm ci --prefix chatgpt --ignore-scripts
npm run build:record-snapshot
export DSH_WORKFLOW_ROOT=/absolute/path/to/DSH-Workflow
npm run check
npm test
npm run test:resources

GitHub Actions 只负责打包、核对版本/文件清单/哈希并上传产物,不运行测试或真实宿主验收。仅调整 workflow 时,复用未受影响的本地证据,只验证相关配置和打包;发布门槛见 发布流程。

SDK 缺失时检查会明确失败。普通用户安装发布包不需要这套开发环境。运行包不包含合成测试驱动、真实会话记录、模型服务或本机连接信息。

  • 安装与兼容性
  • 发布验证范围
  • 发布流程与完成条件
  • 版本说明
  • 开发接口契约
  • ChatGPT 只读观察开发候选
  • 领域术语
—/ 5

No ratings yet

Verified DSH bundle

Commit 56adb1c27f9d

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout