工作区状态条 dugujun3-cloud/dshos-dock

dshos-dock

给 DeepSeek Harness（DSH）Web GUI 用的 Workspace-OS 状态栏。

对话输入框上方一条细长的常驻状态栏，告诉你智能体工作区正在做什么：

dshos-dock · tasks 12 (running 2 / awaiting 1) · last run-done 14:32 · checkup 2026-09-04

数据来自工作区里一份轻量的文本契约（.dshos/），归你所有——没有数据库，没有云端，没有遥测。插件只读，零运行时依赖。

功能

- 输入框上方的状态栏——任务计数（总数 / 运行中 / 等待中）、最近一次运行事件及时间、最近一份清单/审计笔记的日期。
- 实时刷新——每 30 秒轮询本地端点，无需刷新页面。
- 契约优先的数据——工作区里的 .dshos/ 文件夹决定一切（见数据契约）。任何脚本、任何智能体、任何 cron 任务都能写入。
- 优雅降级——还没有 .dshos/？状态栏会显示友好的「未初始化」提示，而不是让 UI 崩掉。
- 兼容旧版布局——自动识别 操作系统/ + 状态/ 的 DSH-OS 布局，兼容已有的工作区治理目录树。
- 根目录可配置——用一行 cordis 补丁配置就能指向任意目录。
- 只读 + 零依赖——宿主只注册一个 GET 端点；从不写入，从不 POST，从不外呼。

外观

┌─────────────────────────────────────────────────────────────────────┐
│ dshos-dock · tasks 12 (running 2 / awaiting 1) · last run-done 14:32 · checkup 2026-09-04 │ ╰─────────────────────────────────────────────────────────────────────╯ [ input box below — as usual ]

dshos-dock demo

安装

需要一个 DeepSeek Harness web 配置档（由 npm 管理的 ~/.dsh/profiles/web）。

方式 A——用 dsh plugin（推荐，自动应用 bundle 补丁）

dsh plugin --profile web add github:dugujun3-cloud/dshos-dock

方式 B——手动（pnpm）

pnpm --dir ~/.dsh/profiles/web add <repo-or-package>

然后在配置档的 cordis.patch.yml 里注册插件（放在 bundle 层之后）：

dshos-dock：workspace-OS 状态条（任务/事件/自检）
- insert:
- id: dshos-dock
name: dshos-dock
optional: custom data root (workspace root OR a .dshos dir).
The dock auto-detects <root>/.dshos/ (contract) or the legacy
操作系统/ + 状态/ DSH-OS layout inside it. config: root: /absolute/path/to/workspace

重启 DSH web，状态栏就会出现在输入框上方。

数据契约

在工作区根目录创建 .dshos/：

.dshos/
├── status.json # optional kernel state
├── tasks/ # one JSON file per task
│ └── my-task.json
├── events.jsonl # one JSON line per event
└── checklists/ # markdown audit notes (the newest is shown)

status.json

json
{ "status": "active", "current_stage": "stage-3" }

tasks/my-task.json
json
{
"project": "My Project",
"status": "in_progress", // in_progress | awaiting_acceptance | done | ...
"current_stage": "build",
"updated_at": "2026-09-04T08:00:00Z"
}

events.jsonl（每行一个事件，这里只显示最后 6 条） jsonl {"ts": "2026-09-04T14:32:00.000Z", "event": "run-done", "task_id": "my-task"}

checklists/ —— 任意 markdown 文件；文件名按字典序排最后的那一个，就是「自检」日期。

API

GET /dshos/status 返回（示例）： json { "at": "2026-09-04T15:00:00.000Z", "kernel": "dshos-dock", "ready": true, "source": ".dshos",
"os": { "status": "active", "current_stage": "stage-3" },
"tasks": { "total": 3, "running": 1, "awaiting": 1, "list": [ /* up to 8 / ] },
"events": [ { "ts": "...", "event": "run-done", "task": "my-task" } ],
"latestChecklist": "2026-09-04.md",
"listErr": null
}

为什么会有这个插件

智能体框架让你轻松跑起长时间的任务，却很难看见*它。这个插件只是一个更大想法的尾巴：给你的工作区装一套操作系统 —— 一组稳定的文件，记录状态、任务、事件和审计，再加一条 12 像素高的状态条，随时回答「我的智能体现在在干什么？」。

你可以用任何智能体、任何脚本、任何定时任务来驱动 .dshos/。加一行状态、一块任务看板、一个评审面板、一个自检面板 —— 契约由你定。

向后兼容

如果你的工作区已经在用 DSH-OS 布局（操作系统/ + 状态/ 两个文件夹，里面有 workflow_status.json 和 runtime/runs_log.jsonl），状态条会自动识别，无需任何迁移。

开发 sh
node test-host.mjs # 20 assertions, zero deps

License

MIT © dugujun3-cloud

中文简介

dshos-dock 是一个 DeepSeek Harness（DSH）Web 插件：在对话输入框上方常驻一条状态条，显示工作区任务统计（总数/进行中/待验收）、最近一次运行事件和最新自检日期。

- 数据由工作区内 .dshos/ 目录的文本约定驱动——无数据库、无云端、无遥测。
- 只读 + 零运行时依赖：宿主侧只注册一个 GET /dshos/status 端点，30 秒轮询刷新。
- 没有 .dshos/ 时优雅降级（显示"未初始化"提示），兼容 操作系统/+状态/ 旧布局（自动探测）。
- 支持 cordis 配置 config.root 指定任意数据根目录。

安装（在系统终端执行）： sh
dsh plugin --profile web add github:dugujun3-cloud/dshos-dock

或手动：pnpm --dir ~/.dsh/profiles/web add github:dugujun3-cloud/dshos-dock

然后在 ~/.dsh/profiles/web/cordis.patch.yml 追加： yaml
- insert:
- id: dshos-dock
name: dshos-dock

重启 DSH 后状态条即出现在输入框上方。数据契约见上方英文文档（.dshos/ 布局）。

License

MIT