lingxin-maz / dsh-profilespanel

dsh-profilespanel · DeepSeek Harness 插件集合

仓库名 dsh-profilespanel · 本仓库采用 dsh-plugins 格式：每个插件一个独立目录、根 README 提供安装指引（当前含 1 个插件）。

插件：dsh-profile-panel — DSH 插件状态面板 / profile 运维控制台：观察、诊断、变更管理与 Agent 化——当前 profile、bundle 状态、待重启检测（SSE）、一键重启、多 profile 同步安装（含双端模式）、供应链版本预览、回滚/撤销、更新检测与对齐、健康检查、profile 对比、启动报告、审计日志、市场对接与 Agent 工具。

---

插件列表

插件	npm 包名	说明	安装命令
dsh-profile-panel	dsh-profile-panel	插件状态面板 / profile 运维控制台	dsh plugin --profile <name> add dsh-profile-panel

每个插件均为独立包（自带 package.json / cordis.patch.yml / src / lib / client / tests），可单独安装，也可通过下方 GitHub 直装整仓获取。

---

仓库结构

路径	作用
package.json	插件包定义（main → lib/index.js；dsh 字段声明 bundle patch 与客户端注入）
cordis.patch.yml	bundle 层栈插入声明（dsh.bundle.patch）
src/	TypeScript 源码（宿主端 + src/client/ 客户端）
lib/	编译后的宿主端代码 + 类型声明（package.json 的 main 指向 lib/index.js）
client/	编译后的客户端 bundle（exports["./client"]，设置页面板 UI）
tests/	宿主单测（tests/host/）+ 客户端组件测试（tests/client/）
scripts/	构建辅助脚本（normalize-client-banner.mjs）
tsconfig*.json / tsdown.config.ts / vitest*.config.ts	类型检查、构建与测试配置
.github/workflows/ci.yml	push/PR 自动 typecheck + build + test

构建产物（lib/ + client/）随仓库提交：github: 直装无需在消费端构建，装完即可运行（prepare 脚本保留作刷新路径）。

---

dsh-profile-panel · 插件状态面板 / profile 运维控制台

npm 包名 dsh-profile-panel

DSH 插件状态面板：观察、诊断、变更管理与 Agent 化——当前 profile、bundle 状态、待重启检测（SSE）、一键重启、多 profile 同步安装（含双端模式）、供应链版本预览、回滚/撤销、更新检测与对齐、健康检查、profile 对比、启动报告、审计日志、市场对接与 Agent 工具。

项目优势 / Why this plugin

DeepSeek Harness 生态里已有 dshmarket（安装市场）、官方 dsh-host-plugin-inventory（只读清单）、dsh-client-ui-settings-plugins（仅配置编辑）。本插件定位是它们都缺的那一层：profile 的运维控制台：

能力	dsh-profilespanel	dshmarket	官方内置
多 profile 同步安装（单端/双端 web+desktop/自定义勾选）	✅ 逐 profile 回报	单 profile	❌
供应链版本预览（minimumReleaseAge 发布年龄预警 + 建议 pin）	✅	部分	❌
安装前快照 + 失败自动回滚 + 手动撤销	✅	部分	❌
更新检测 / 单条更新 / 跨 profile 版本对齐	✅	有	❌
待重启检测 + SSE 实时推送（含其他 profile）	✅	有	❌
健康检查（缺失包/peer 缺口/孤儿 bundle/层栈重复 + 重启后组合预览）	✅	❌	❌
两 profile 并排 diff（版本漂移/漏装）	✅	❌	❌
启动报告（boot 激活结果 + 失败原因）	✅	❌	只读部分
审计日志（本地 JSONL 变更时间线）	✅	❌	❌
Agent 工具（profile_status / profile_updates / profile_sync_install / profile_restart）	✅	❌	❌
免重启热加载（宿主支持时）	✅	有	❌
一键重启（桌面端优雅 dispose → relaunch）	✅	有	❌
市场对接：下载模块内置市场搜索 + github: 直装	✅	本体即市场	❌

其他优势：

• 双端一次装齐：自动检测桌面端 GUI（runtime / profile / app-data 三级），「web + desktop」一键同步安装；
• 供应链安全：安装前预览发布年龄，识别 minimumReleaseAge 策略降级（downgraded 标记），建议显式 pin；
• 安全模型对齐 dshmarket：变更接口仅接受同源环回请求、拒绝代理转发头；安装目标严格校验（registry 包名 / 严格形态 github:owner/repo[#path:/sub]），拒绝本地路径、git URL 与命令注入；审计日志纯本地、不含对话内容；
• 零遥测：不上报任何数据，离线时优雅降级（warning 而非失败）。

---

功能

• 观察（Profile / 插件面板）：当前 boot 的 profile、bundle 清单（已加载 ✓ / 待重启 ⚠、来源归因：内置/依赖/patch、可热加载标记）、profile 目录路径、桌面端下次启动 profile（active + lastKnownGood）；
• 待重启检测 + 实时推送：监听所有 webCapable profile 的 package.json / pnpm-lock.yaml / node_modules/.modules.yaml；当前 profile 变更出现「需要重启」横幅，其他 profile 待重启以提示条展示；SSE 实时推送（断线自动回落轮询）；
• 一键重启：桌面端走 desktopRuntime.requestRestart()（优雅 dispose → app.relaunch()）；纯 dsh web 显示 CLI 重启提示；支持「安装后自动重启」倒计时 + 取消；
• 同步安装（双端模式）：自动检测桌面端 GUI，检测到时可一键「web + desktop 双端」或「仅当前端」，也可自定义勾选全部 profile；逐 profile 回报（含 downgraded 供应链降级标记）；
• 安装助手：安装前版本预览——latest、发布年龄、minimumReleaseAge 策略预警与建议 pin；
• 回滚与撤销：安装前自动落盘 manifest 快照；部分失败可选自动回滚；手动「撤销最近变更」；
• 更新检测与同步：逐 bundle 对照 registry 检查过期版本，单条更新 / 全部更新 / 跨 profile 对齐同一版本；
• 健康检查：缺失包、peer 缺口、孤儿 bundle、层栈重复 + 「重启后组合」dry-run 预览；
• Profile 对比：两 profile 并排 diff（仅单侧存在 / 版本漂移）；
• 启动报告：最近一次 boot 的 bundle 激活结果（含失败原因）；
• 审计日志：本地 JSONL 变更时间线（安装/更新/撤销/重启/对齐；路径缩写，不含对话内容）；
• Agent 工具：profile_status / profile_updates / profile_sync_install / profile_restart 面向模型注册，变更类走宿主审批；
• 热加载：声明 dsh.hot 的待重启 bundle 提供「热加载（免重启）」选项（宿主不支持时降级提示）；
• 市场对接（F17）：下载模块内置市场搜索（与 dshmarket 同源目录：awesome-dsh-plugin.com，离线回退本机 dshmarket 快照）；结果一键带入安装区并自动预览；支持 github:owner/repo[#path:/sub] 直装（市场里大部分插件是 GitHub-only，npm registry 查不到）；市场页可通过 dsh-profile-panel:install-target 事件或 #dshpp-install=<target> 深链把包名直接送进下载模块。

---

安装说明 / Installation

前置要求

• 已安装 DeepSeek Harness（桌面端或 dsh CLI），并有一个 webCapable profile（如 desktop / web）；
• 有可用的 pnpm（安装器通过 pnpm 解析 registry / GitHub 目标；桌面端自带 pnpm 时自动使用）。

方式一：npm 安装（推荐，正式发布后）

dsh plugin --profile <name> add dsh-profile-panel
# 发布首日可能受 minimumReleaseAge 策略影响而解析旧版，可用显式版本：
dsh plugin --profile <name> add dsh-profile-panel@1.0.0

方式二：GitHub 直装（未发布 npm 时）

本仓库已包含构建产物（lib/ + client/），github: 安装无需在消费端构建，装完即可运行：

dsh plugin --profile <name> add github:lingxin-maz/dsh-profilespanel

方式三：本地路径（开发 / 联调）

dsh plugin --profile desktop add ../dsh-profilespanel

安装后

1. 重启 DSH（或等待面板提示）使 bundle 进入运行组合；
2. 打开 设置 → Profile / 插件（settings 面板的 profile-panel 分区）即见完整面板；
3. 验证：GET http://127.0.0.1:<port>/api/profile-panel/status 返回 200 即安装成功。

---

配置（cordis.yml，可选）

profile-panel:
  profile: web                  # 显式指定 profile（默认：桌面端取 desktopProfiles，纯 CLI 取 --profile，缺省 web）
  allowRestart: true            # false 时禁用一键重启（systemd/pm2 托管场景）
  pollIntervalMs: 5000          # 变更检测轮询间隔
  minimumReleaseAgeDays: 7      # 供应链版本预览的发布年龄阈值（F1）

---

HTTP 接口

接口	方法	语义
/api/profile-panel/status	GET	profile 名/目录、bundle 清单（含来源归因/热加载标记）、pendingRestart、变更明细、重启能力、可安装 profile 列表、桌面端检测与 selection、其他 profile 待重启
/api/profile-panel/events	GET	SSE 状态推送（pending / clean / installing / installed / restarting）
/api/profile-panel/poll	GET	SSE 的长轮询回落通道（?since=<seq>）
/api/profile-panel/restart	POST	一键重启（同源 + 环回门控；桌面端 202，纯 web 501 + hint）
/api/profile-panel/install	POST	多 profile 同步安装 { package, spec?, profiles[]?, mode?('single'|'dual'|'all'), preview?, rollback?, autoRestart? }；package 亦接受 github:owner/repo[#path:/sub]（F17，不可带 spec）
/api/profile-panel/install-preview	POST	安装事前版本/发布年龄预警（F1）；GitHub 目标返回来源预览（F17）
/api/profile-panel/market/search	GET	市场搜索（dshmarket 同源目录）?q=<关键词>&limit=<1-20>（F17）
/api/profile-panel/undo	POST	撤销最近变更（恢复 manifest 快照，F2）
/api/profile-panel/updates	GET	逐 bundle 更新检测（F3）
/api/profile-panel/update	POST	更新指定 bundle（F3）
/api/profile-panel/align	POST	多 profile 版本对齐（F3）
/api/profile-panel/health	GET	健康检查 + 重启后组合预览（F6）
/api/profile-panel/diff	GET	两 profile 并排 diff（?profiles=a,b，F7）
/api/profile-panel/boot-report	GET	最近一次 boot 激活报告（F9）
/api/profile-panel/audit	GET	审计时间线（F10）
/api/profile-panel/hot-reload	POST	免重启加载 HMR 能力 bundle（F12）
/api/profile-panel/cancel-restart	POST	取消待执行的重启（F13）

---

开发

pnpm install
pnpm typecheck   # 宿主端 + 客户端类型检查
pnpm build       # 宿主端 tsc + 客户端 tsdown（产物 lib/ 与 client/）
pnpm test        # 宿主单测 + 客户端组件测试

CI（.github/workflows/ci.yml）会在 push/PR 时自动执行 typecheck / build / test。

安全模型（对齐 dshmarket）

• 变更类接口仅接受同源 POST 且来自环回地址，拒绝任何代理转发头；
• 安装仅接受 registry 包名/版本 spec，以及严格形态的 github:owner/repo[#path:/sub] 目标；拒绝本地路径、git URL、http 源与命令注入；
• 面板路径展示对 home 前缀缩写；审计日志纯本地、不含对话内容；不上报任何数据。

已知边界

• 本插件自身升级后同样出现待重启提示（预期行为）；
• 面板对 profile 选择状态只读，切换 active profile 请用桌面应用托盘菜单；
• 多 profile 安装默认不自动回滚（可勾选 rollback；undo 恢复 manifest 后需 pnpm install 重建 node_modules）；
• 桌面端检测为启发式（profile / app-data 命中不代表桌面端正在运行）；dual 目标另一端缺失时降级为单端 + warning；
• 热加载为尽力而为：宿主不支持时降级为重启提示；
• updates / install-preview 依赖 registry 可用性，离线时降级为 warning；
• GitHub 直装跟随仓库 HEAD（无版本号语义），安装后的依赖名以仓库 package.json 的 name 为准；更新检测对这类依赖跳过 registry 查询；
• 市场搜索在线目录不可达时回退本机 dshmarket 快照（可能滞后于在线目录），两者都没有时降级为空结果 + warning；
• 设置外壳为单页导航且未提供跨分区切换 API：市场侧「跳转到下载模块」通过事件/深链预填实现（面板下次打开时自动填入并预览），无法强制宿主切到本分区——如需自动切页，需上游宿主或 dshmarket 配合。