dsh-flowglass
可视化会话执行流、工具调用、子代理与多会话并发分支。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-flowglass@0.6.1
Flowglass 以 dsh-flowglass 发布，当前版本为 0.6.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh-flowglass）DeepSeek Harness 的实时会话流程图插件。把当前会话画成三列泳道，展示工具调用、并行分组与子代理分支，并支持逐层钻取。
A live session flowgraph for DeepSeek Harness. MIT License.
skill 调用卡直接显示实际技能名，详情按技能名称、基础目录、资源说明和 Markdown 使用说明分区展示，原始 XML 保留在折叠区。1→2→1→2、1→2→2→2 等不同总体形态。右侧历史树的折叠行只显示任务摘要与拓扑，展开后再按“轮次 → 对话”展示导航明细。workspaceId（无工作区归属时才回退 cwd），并在开工后自动进入第一个分支。flowglass，通过官方 plugins.bundle.config 页面集中配置 Session 切换保持展开、大流镜开关、默认分支数量、默认视图、轮询间隔与工具显示规则；表单控件复用 Harness UI primitives。Flowglass 使用 Harness 官方 plugins.bundle.config 扩展点：侧栏「插件」→ flowglass 的详情页直接承载配置表单，插件管理页负责导航、标题与生命周期，Flowglass 不修改 Harness，也不创建另一套插件管理页面。设置先在表单中暂存，点击“保存设置”后写入当前浏览器，并立即刷新已打开的流镜。
详情页可配置切换 Session 时是否保持流镜展开、是否启用大流镜、默认 2/3/4 分支、默认精简/详细/导图视图、轮询刷新间隔，以及完整的工具显示规则。显示规则首次使用会加入 Git、GitHub CLI（gh）、pnpm、npm、DSH、Python 六条普通规则。默认规则和后来添加的自定义规则使用完全相同的交互；删除后的默认规则不会在刷新后自动补回，即使清空全部，空列表也会持久化。规则按顺序匹配并采用第一条命中项。
tools 匹配日志中的原始工具名；executables 按命令 token 的 basename 匹配，不依赖机器上的绝对路径；actions 为空时接受任意紧随其后的子命令；displayName 为空时不添加名称，卡片只保留匹配到的子命令；badge 为空时不渲染徽章。格式错误的规则会被拒绝，未匹配调用继续显示原始工具名。
[
{
"enabled": true,
"tools": ["pwsh"],
"executables": ["engram-memory.ps1"],
"displayName": "engram-lattice",
"actions": ["search", "recall", "memory"],
"badge": "记忆",
"color": "#81c784"
}
]
该示例把匹配的卡片显示为 engram-lattice search、engram-lattice recall 或 engram-lattice memory。完整输入、输出以及会话日志中的 pwsh 工具名均保持不变。规则存储在浏览器 localStorage 中，设置面板打开时会暂停自动刷新，避免覆盖尚未保存的编辑内容。
要求 DeepSeek Harness 0.1.5-rc.1 或更高（dsh --version 查看）。
dsh plugin --profile web add dsh-flowglass
升级到指定版本后重启 DSH：
dsh plugin --profile web add dsh-flowglass@<新版本>
卸载：
dsh plugin --profile web remove dsh-flowglass
dsh-flowglass 是本仓库的默认产品和默认构建目标。它是原生静态 Host/Client 插件，不使用 dynamicCordisRunner，也不产生 dyn/*。
流镜的承载面按以下优先级自动选择（同一时刻只有一条注册路径生效）：
dsh-flowglass:flow（definition id dsh-flowglass/native），出现在右侧栏 guide 的「流镜」入口；从流镜自有入口点击会 openTab 自动展开并聚焦。原生 Tab 按会话隔离（props.sessionId 是权威来源），Tab 不可见时自动暂停刷新。>=0.19.0）：原生右侧栏不可用时，若安装了 better-sidebar，则注册其「流镜」Tab。承载方式不再需要手动选择，始终按上述优先级自动适配；历史版本保存的 drawer 显示偏好会被忽略。
dsh plugin --profile web add dsh-better-sidebar # 可选；仅在原生右侧栏不可用时需要
dsh plugin --profile web add dsh-flowglass
不传功能参数，或显式传入 --flow，都会构建 dsh-flowglass：
node scripts/build-toolbox-bundle.mjs --version 0.5.0 --clean
# 等价：node scripts/build-toolbox-bundle.mjs --flow --version 0.5.0 --clean
node scripts/verify-bundle.mjs dist/toolbox-bundles/flow --pack
Push-Location dist/toolbox-bundles/flow
npm pack
Pop-Location
默认输出目录为 dist/toolbox-bundles/flow/，默认 npm 包名为 dsh-flowglass。只有构建其他功能组合时，才使用 dsh-<bundleId>-toolbox 命名；仍可通过 --name 显式覆盖。构建产物回填到 flowglass/（Copy-Item dist/toolbox-bundles/flow/* flowglass/ -Recurse -Force）。
node make-payloads.mjs # 动态桩/清单再生成（改 catalog 后）
node scripts/verify-generated.mjs # 生成物漂移检查
node scripts/verify-bundle.mjs flowglass --pack
node smoke.mjs # 全部契约冒烟（含 0.1.5-rc.2 真实组合，见下）
真实组合冒烟（smoke/sim-rc2-composition.cjs）装载真实 cordis/host-runner 走 define→批准→invoke→teardown 全链路，并核对 0.1.5 原生右侧栏/事件窗/better-sidebar 0.19.1 的发行包契约。它需要一个 0.1.5-rc.2 安装树（按优先级：DSH_INSTALL_ROOT → 仓库 .scratch/dsh-rc2-composition/ → 全局）：
New-Item -ItemType Directory -Force .scratch\dsh-rc2-composition | Out-Null
Push-Location .scratch\dsh-rc2-composition
npm init -y
npm install @deepseek-ai/dsh@0.1.5-rc.2 dsh-better-sidebar@0.19.1
Pop-Location
Flowglass 的静态产物位于 flowglass/，核心功能实现位于 plugins/flow/，共享界面框架位于 plugins/toolbox/。内部保留 toolboxRegistry、toolbox.* RPC 与 .dsh-dynamic-toolbox/ 数据路径，以兼容现有框架和历史数据；这些内部名称不改变默认安装入口。
本仓库也能构建包含全部工具的次级产品 dsh-dynamic-toolbox；它与默认的 dsh-flowglass 相互独立。只有确实需要 Jira、Git、文件、HTTP、AI 助手等整套工具时才安装：
dsh plugin --profile web add dsh-dynamic-toolbox
工具箱的重建、开发和历史说明单独维护：
dynamic-toolbox/README.md — 工具箱包REBUILD.md — 动态工具箱重建与自举PLUGIN-DEV.md — 工具箱插件开发插件.md — 动态插件架构与经验记录MIT © 2026 Iwctwbh