dsh-download-progress

LIMITATIONS

Known limitations

- **`dsh-ops/background` 目前没有服务扩展点**。它的 `dsh` 组件只注册 `run_background` / `job_output` / `job_list` / `job_kill` 四个工具，不 `provide` 任何 cordis 服务，所以来源 ① 在本机上是"不可用"（空态里会写明）。这一格保留了结构 探测：一旦它（或别的插件）发布带 `list()` 的服务，立刻会用上，不必改代码。真正的 数据来自来源 ②。 - **指示器只在会话头**。打开会话（对话页）时可见；纯设置页 / 空态没有会话头，图标不在。 想要**全屏常驻**的浮层版本，把 `src/client/90-entry.js` 的 `SLOT_NAME` 换成 `shell.overlay` 即可（`shell.overlay` 是根作用域的浮层，那份 slot 的说明里明确写着 "a badge, a toast stack or a status pill all belong here"）——代价是它不带 `sessionId`， 会退化成不带会话围栏的全局视图。 - **图标是常驻的**，不是"有任务才出现"。空闲时它只是灰着不碍事。 - **DSH 自己的内部任务也会出现在列表里**。面板列的是 `ctx.jobs` 名册的**全部**内容—— 包括它的常驻 PowerShell/POSIX 会话（名字是那行命令的首行，例如 `$ErrorActionPreference='SilentlyContinue'`），它没有可识别进度，所以显示为"未知进度" 的走马灯条。DSH 自己的任务抽屉里同样列着它们。觉得吵的话可以在 `src/host/40-tasks.js` 的 `collectJobTasks` 里按 `kind` 过滤，但那属于按喜好筛选， 默认不替用户决定。 - **进度源目录只浅扫描一层**，不递归。 - **进度源文件最多读 256 KB 的尾部**；超过时丢掉可能被截断的首行。 - **任务输出最多回读 8 KB 尾部**（进度行几乎总在末尾）。 - 一次响应最多 64 条任务；结算超过 2 分钟的任务不再显示。 - **不杀任务、不写文件、不推进任何游标**——没有任何写路径。 - 不做 i18n：UI 文案固定中文。 ---