brittanistrehlowll-oss/dsh-control-center

DSH 控制中心

V2 定位（2026-08-19 起）：薄整合层 / meta-package（installer） —— 不是独立监控后台。

V2 的运行时职责由两个插件仓库承担：dsh-lifecycle（左下角控制条：额度摘要 +
重启/关闭 + takeover overlay + 关闭后极简启动页 :3081）和 dsh-quota-panel
（额度 capsule/卡片）。本仓库只负责：

检测 DSH → 安装 dsh-quota-panel + dsh-lifecycle → 写统一配置
→ 安装/启动 Watchdog → 升级 / 卸载 / 健康检查

权威基线：docs/V2-DIRECTION.md（源自 Google Drive 00_FINAL_READ_FIRST｜20260819-V2）。
V1 的 "Supervisor-first Control Plane / Monitoring Center" 方向已降级为历史
（代码保留作 research，不继续扩张，不以它为 UI 依赖）。

用户感知三件事：① 我还有多少额度 ② 我能快速重启/关闭 DSH ③ DSH 关闭后我总有
一个稳定页面能重新打开它。

历史保留（V1 research 代码）

V1 构建的 Supervisor / Contract / Snapshot / Diagnostics / SSE / 更新验签等代码
保留在本仓库 packages/*、apps/supervisor 中供研究，不再扩张。它们验证过
真实 DSH 协议（/api/system/health + bootId、:3081 controller、RPC
session.list），对理解 DSH 运行时仍有价值。

Non-goals (V2)

- 不建设 Monitoring Center / 多页控制台 / Diagnostics Dashboard
- 不建设 Electron 壳 / 独立 React Dashboard（作为产品）
- 不为最近会话引入数据库
- 不直接杀进程 / 不接管 DSH 生命周期（仍走 marker/watchdog）
- 不在 Codex 会话内真实 stop/restart DSH（只允许 dry-run/检测）

Workspace

apps/supervisor            runnable supervisor entry (read-only first round)
apps/control-surface       gated Electron-shell placeholder (Checkpoint B/C)
packages/control-contract  all V1.1 Zod schemas (the contract)
packages/operation-journal append-only operations.jsonl + atomic JSON
packages/runtime-discovery real-surface probing + identity + ownership
packages/snapshot-store    atomic snapshots, last-good, sensitive scan
packages/security          redaction + secret detection
packages/diagnostics       PASS/WARN/FAIL/UNKNOWN across subsystems
packages/dsh-client        read-only RPC client (bounded, redacted)
packages/quota-adapter     fixed trusted-endpoint quota pipeline
packages/update-provider   official-source verify + compatibility + rollback
packages/supervisor-core   single-instance lock, journal recovery, reconcile
adapters/lifecycle/legacy-watchdog  ONLY place knowing 3080/3081/markers
tests/fake-runtime         fake DSH mirroring the real surface

Quick start

pnpm install --frozen-lockfile
pnpm test          # build + vitest
pnpm verify:contract
pnpm scan:secret   # no credentials/cookies/prompts in tracked state
pnpm scan:path     # no absolute local paths in committed files

Read-only first round (Checkpoint A)

The supervisor entry performs only the allowed first-round actions: identify
DSH, read version, read fingerprint, confirm ownership === legacy, and a
Legacy Adapter dry-run. It never stops or restarts DSH.

pnpm --filter @dsh-control-center/supervisor start -- --state-dir "%LOCALAPPDATA%\DSHControlCenter\state" --dsh-logs-dir ""

Docs

- docs/PLAN.md — frozen V1.1 plan + optimizations
- docs/WORK-INVENTORY.md — what exists / what's next
- docs/CHECKPOINTS.md — Checkpoints A/B/C acceptance
- docs/decisions/ — ADR-001..004
CI

工作流文件位于源码检出目录中的 .github/workflows/ci.yml，
但尚未提交到此仓库：发布令牌缺少
GitHub workflow 权限范围（GitHub 会拒绝在没有该权限的情况下创建/更新工作流文件的 PAT 推送）。要启用 CI：通过具有 workflow 权限范围的账户/令牌发起拉取请求来添加该文件，或为发布令牌授予该权限范围。该工作流会在 windows-latest + Node 24 上运行 pnpm build、pnpm test、verify:contract、
scan:secret、scan:path、hash:artifacts。

仓库主题

dsh-plugin、deepseek-harness、deepseek、control-center

许可证

MIT。