br1nosense/dsh-project-manager

README 摘要

@dsh-user/dsh-project-manager DSH 项目管理插件：在 DSH Web 界面以 悬浮窗口 形式管理开发项目——添加/删除项目、 一键启动/停止/重启、文件变更热重载自动重启、实时日志查看与持久化。 功能 - 悬浮窗口 ：显示在 DSH Web 界面右下角（ shell.overlay ），可 拖拽移动 （标题栏拖动）、 折叠/展开 （右上角按钮）；位置与折叠状态记忆在 localStorage，窗口尺寸变化时自动钳回可视区域。 - 项目列表 ：每个项目卡片显示状态徽标（运行中/启动中/停止中/已退出/失败/已停止）、 PID、工作目录、启动命令。 - 启动 / 停止 / 重启 ：每个项目一行操作按钮。Windows 下停止使用 taskkill /T 杀整棵进程树，不会残留子进程。 - 添加项目 ：名称、工作目录、启动命令（如 npm run dev / python app.py ）、 附加参数、自动启动、热重载开关、热重载文件后缀白名单、附加环境变量。 - 热重载 ： fs.watch 递归监听项目目录，文件变更（按后缀白名单过滤、忽略 node modules/.git/dist 等）去抖 500ms 后自动重启进程。 - 日志 ：每个项目的 stdout/stderr 按行写入内存环形缓冲（上限可配，默认 2000 行） 并持久化到 logs/ .log ；悬浮窗内可展开日志查看器，增量轮询、自动滚动、清空。 安装 方式一：GitHub 克隆（推荐） 方式二：本地目录 安装后重启 dsh web（或由 HMR 自动热更新 client bundle）。验证： 常见问题：安装插件后 dsh 启动失败（peerDependencies 解析） 症状 ：安装本插件（bundle）后重启 dsh，web 启动报错 / 起不来。 原因 ：本插件把 @deepseek-ai/schemastery （以及 @deepseek-ai/cordis 、 @deepseek-ai/dsh-settings ） 声明为 peerDependencies ，但插件目录（clone 下来的仓库）下没有 node modules 。Node ESM 会从插件 所在目录 逐级向上 查找 node modules ，却找不到 DSH 自身嵌套目录里的这几个包（dsh 安装目录通常 不在该查找路径上）。 修复 （一次性，本地环境级）：在 插件工作区根目录 （即插件目录的父目录，如把插件 clone 到 C:\code\AI\DSH\dsh-project-manager ，则根目录是 C:\code\AI\DSH ）的 node modules\@deepseek-ai\ 下 创建 3 个目录联接（Junction），指向 DSH 自带的同名包： 包 …

分类