2008924/dsh-progress-viz

README excerpt

dsh Progress Viz 实时可视化 dsh（headless 模式）任务执行过程的独立看板工具包——读取会话事件流，呈现阶段进度、ETA 与实时动态流，纯本地运行。 English: dsh Progress Viz is a self-contained dashboard that visualizes dsh headless task execution in real time. It parses the local session event stream ( session.jsonl.zstd ) to show stage progress, ETA and a live activity feed — 100% local, no API calls, no tokens consumed. 背景痛点 dsh 在 headless 模式下只输出 最终答案 ，执行过程（读哪些文件、跑了什么命令、任务清单推进到哪一步）完全不可见。任务一跑就是几分钟甚至更久，期间无法判断： - 任务是否还活着、卡在哪一步？ - 当前处于整个任务的哪个阶段、还剩多少阶段？ - 大概还要等多久？ 原理 dsh 会把每次任务的完整事件流实时追加写入本地会话文件： （zstd 压缩的 JSONL，每行一个事件， type 字段区分类型。） 本工具关心的事件（v1.1 扩展后）： 事件类型 含义 用途 todo/write 模型写入任务清单（ data.todos ，每项有 content + status ） 阶段数据源 ：取第一个未完成项为当前阶段 step/start 步骤边界 无 todo 时的兜底计数 tool/call 工具调用（ data.name + data.arguments ） 最近动作 + 事件流/时间线 session/title dsh 自动生成的任务标题（ data.title ） 任务标题 （卡片优先显示，无标题回退 cwd basename） assistant/message 模型消息（ data.usage 含 token 统计） 成本估算 ：累计 tokens × DeepSeek 定价常量 解压必须用 zstandard 的 stream reader 全量流式解压（ decompressobj 只能解第一个 frame 是已知的坑）。看板每 4 秒轮询一次（重新扫描最近任务列表并逐任务解析），页面每 5 秒自动刷新。 安装与快速开始 本项目是 纯脚本型 包（无 console script 入口、不提供 import 模块）， pip install . 只是安装依赖并注册元信息；运行方式与直接运行脚本完全一致： 在项目目录执行 python dashboard.py [port] （或 python -m das…

Category