Iwctwbh/dsh-flowglass 预览 preview

Iwctwbh/dsh-flowglass

插件Plugin ⭐ 5 MIT web-ui

> A DeepSeek Harness plugin: turn the current session into a live flowgraph — three lanes, subagent branches, parallel groups, drill-down — plus a hot-reloadable session toolbox in the same drawer. MIT License. >

catalog 简介 / catalog descriptioncatalog description:流镜 Flowglass — DeepSeek Harness session flowgraph,实时可视化消息、工具组、子代理分支与步骤详情。

编辑导读Editor's Brief

## 核心特性
- Flowglass 将当前 DeepSeek Harness 会话渲染为实时流程图,采用三泳道布局、工具调用输入与输出卡片,并每两秒自动刷新。
- 子代理会话显示为独立分支,点击入口操作可打开子会话流程图,并提供面包屑导航,支持无限嵌套。
- 同时发生的工具调用会被分组到虚线并行框中,运行中的调用会高亮显示以指示当前步骤。
- 工具卡片和消息卡片可在侧层浮层中打开完整参数、结果、内容、模型和 token 元数据,不会改变流程图布局或滚动位置。
- 同一抽屉还提供 21 个可热重载的 mini-tools,覆盖项目数据、实用工具、会话洞察、AI 辅助、自检和主题选择。

## 使用场景
- Web UI 用户可以将正在进行的 agent 会话查看为用户步骤、助手步骤、工具调用和派生子代理的可视化轨迹。
- 开发者可以从同一抽屉中检查 Jira 记录、Git 历史、工作区文件、HTTP 响应、端口和计算工具。
- 会话调试可以使用同一抽屉中的 token 用量、prompt 组装、上下文窗口、工具 schema、全文搜索和血缘视图。

## 技术细节
- 动态负载是一个约 0.9 KB 的磁盘加载 stub,而实现文件保留在磁盘上,因此重新运行插件即可应用修改,无需重新定义或重新审批。
- 工具箱框架使用 Host 侧注册表和 RPC,以及 Client 侧抽屉、标签栏和 tb- 面板设计系统。
- 可选的 host-bootstrap/ 可以在会话打开时启动框架,仅需零次模型调用和一次审批点击,并且启动时可在约 0.3 秒内从 plugins.json 重建缺失插件。
- 编译后的 bundle 是按 bundleId 命名空间的静态 Host/Client 包,可通过 scripts/build-toolbox-bundle.mjs 构建,并由 verify-generated.mjsverify-bundle.mjssmoke.mjs 验证。

## 注意事项
- 动态插件需要支持 Cordis dynamic-plugin 的 DeepSeek Harness 和工作区目录,而编译后的静态 bundle 不支持热重载,需要添加新版本并重启 DSH。
- selfview 依赖仅动态可用的 harness bridge,在其原生 Remote 迁移实现之前会被静态编译器拒绝。
- Jira 等服务的凭据必须存储在 Harness 凭据存储或环境变量中,而不是存放在仓库里。

## Core Features
- Flowglass renders the current DeepSeek Harness session as a live flowgraph with a three-lane layout, tool-call input and output cards, and automatic refresh every two seconds.
- Subagent sessions appear as separate branches, and clicking the entry action opens the child session flowgraph with breadcrumb navigation for unlimited nesting.
- Simultaneous tool calls are grouped in a dashed parallel frame, while running calls receive a highlight to indicate the active step.
- Tool and message cards open full arguments, results, content, model, and token metadata in a side overlay without changing the flow layout or scroll position.
- The same drawer provides 21 hot-reloadable mini-tools covering project data, utilities, session insight, AI assistance, self-inspection, and theme selection.

## Use Cases
- Web UI users can inspect an ongoing agent session as a visual trace of user steps, assistant steps, tool calls, and spawned subagents.
- Developers can examine Jira records, Git history, workspace files, HTTP responses, ports, and calculation utilities from the same drawer.
- Session debugging can use token usage, prompt assembly, context window, tool schemas, full-text search, and lineage views from the same drawer.

## Technical Details
- The dynamic payload is a disk-loading stub of about 0.9 KB, while implementation files remain on disk so re-running a plugin applies edits without re-definition or re-approval.
- The toolbox framework uses a Host-side registry and RPC plus a Client-side drawer, tab bar, and tb- panel design system.
- Optional host-bootstrap/ can start the framework when a session opens with zero model calls and one approval click, and startup can rebuild missing plugins from plugins.json in about 0.3 seconds.
- Compiled bundles are static Host/Client packages namespaced by bundleId, can be built with scripts/build-toolbox-bundle.mjs, and are verified by verify-generated.mjs, verify-bundle.mjs, and smoke.mjs.

## Notes
- Dynamic plugins require DeepSeek Harness with Cordis dynamic-plugin support and a workspace directory, while compiled static bundles do not hot-reload and require adding a new version plus restarting DSH.
- selfview depends on the dynamic-only harness bridge and is rejected by the static compiler until its native Remote migration is implemented.
- Credentials for services such as Jira must be stored in the Harness credential store or environment variables rather than in the repository.

安装Install

dsh plugin --profile web add dsh-flowglass

Iwctwbh/dsh-flowglass 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

上一个 Prev adhdgofly-dsh-ext