# 学习仓库 **Repository Path**: lyd_java/com.lyd.work ## Basic Information - **Project Name**: 学习仓库 - **Description**: lyd的fw仓库 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2021-11-16 - **Last Updated**: 2026-11-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # dsh-multischool-ops · 多校运维台 > 通过 **edu MCP** 统一操作多所学校服务器,替代原来的 HexHub 部署面板。 ![插件](assets/icon.svg) ## 它解决什么 一个面板管多所学校的服务器运维: | 站 | 内容 | |---|---| | **服务器站** | 按学校分组的服务器清单 + 常驻命令台(选机器 → 输命令 → 看结果) | | **产品站** | 产品 / 部署包清单,**全局包配置**(包名、下载地址、Nacos 服务名)可编辑 | | **更新站** | 两种模式:**A · Ansible 生成**(hosts.ini + 命令 + **执行后自查**)/ **B · 分步 Shell**(逐步执行,>60s 自动异步) | | **服务配置站** | 每校的服务清单:biz_identifier、Nacos 服务名、部署路径、包名、下载地址、启停脚本、端口 | 关键设计: - **不依赖 HexHub**:所有远端操作走 edu MCP 的 `server_exec_command` - **Nacos 实例发现**:hosts.ini 的主机是服务真实注册的实例,不是学校机器清单 - **部署路径自动探测**:没配就 `find` 出来,并排除备份目录 - **>60s 自动切异步**:走 edu 运维计划,立即返回、后台跑、前端轮询 ## 安装 ```bash # 在 DSH profile 里加这个插件 pnpm add link:D:/path/to/dsh-multischool-ops # 并在 profile 的 dsh.profile.bundles 里加一行 "dsh-multischool-ops" ``` 插件入口:`lib/edu-index.js`;前端:`client/client.js`(随插件自动加载)。 ## 配置 ### edu 连接 ```jsonc // ~/.dsh/multischool-ops/config.json { "edu": { "url": "https://yanfa.scedu.tech/api/mcp", "apiKey": "<你的 key>", "timeout": 30000 } } ``` 也支持环境变量 `EDU_MCP_API_KEY` / `DSH_EDU_MCP_API_KEY`(key 不写进仓库)。 ### 配置目录 ``` ~/.dsh/multischool-ops/ config.json # edu 连接 global.json # 全局配置(步骤模板、全局包配置 package_defaults) schools/.json # 每校的服务清单、Nacos 配置、异步任务/计划复用关系 ``` ## 常用接口 | 接口 | 说明 | |---|---| | `GET /servers` | 服务器清单(按校分组) | | `GET /schools` | 学校列表 | | `GET /products` / `GET /packages` | 产品与部署包 | | `GET /school-config?id=` / `GET /global-config` | 配置读取 | | `POST /exec` | 执行命令(≤60s) | | `POST /update/generate-ansible` | 生成 hosts.ini + ansible 命令 | | `POST /update/generate-steps` | 生成分步 shell 计划 | | `POST /update/run-step` | 执行一步(>60s 自动切异步) | | `POST /update/async-status` | 查询异步执行状态 | | `POST /update/self-check` | Mode A 执行后自查(`action`: `snapshot` / `verify`) | | `GET /edu-tools` | 本插件注册到 agent 工具面的 edu 工具清单 | ## 排错 | 现象 | 原因与处理 | |---|---| | 「未找到 Nacos 地址」 | 该校机器上既没有 `--nacos.url=` 也没有客户端快照目录 → 在「学校服务配置 → Nacos 配置」手填 | | 「Nacos 返回不是 JSON」 | 多半是鉴权失败或地址不对,看返回片段;Nacos 开了鉴权要在学校配置里填 username/password | | 「Nacos 实例 X 不在 edu 服务器清单内」 | edu 只能对在册机器下发命令 → 改用模式 A(Ansible 生成),或把该机器登记到 edu | | 「该目标机上已有异步任务在执行中」 | edu 计划级互斥,等上一个结束 | | hosts.ini 主机多 | 未配 Nacos 服务名时回退到学校服务器清单,可在配置页补上服务名 | ## 目录结构 ``` lib/ edu-index.js # 插件入口 + 路由 edu-api.js # 业务 API(Nacos 发现、ansible 生成、异步执行) edu-channel.js # edu MCP 通道(含频控退避) edu-config.js # 配置读取(config.json / 环境变量) config-store2.js # 配置持久化 nacos-discovery.js # Nacos 实例发现(复用旧插件的解析逻辑) ansible-ini.js # hosts.ini 生成(复用旧插件的 buildGroups/buildHostsIni) service-dir.js # 部署目录探测 + 排除备份路径 self-check.js # Mode A 执行后自查的探针与判据 edu-tools.js # P5:注册 edu 白名单工具到 agent 工具面 + 全局守卫 shell-quote.js # POSIX 单引号转义 client/client.js # 前端 legacy/ # 旧 HexHub 插件实现的归档(仅参考,不参与运行) docs/ # 实施记录(P3 / P4) test/ # 测试 ``` ## 测试 ```bash npm test # 15 个套件(离线,含新链路) npm run test:live # 真实 edu 端到端(会打 edu 接口,注意频控 60 次/分) npm run check # 语法检查 ``` ## 相关文档 - [FRONTEND.md](FRONTEND.md) —— 前端改造说明 - [BACKEND-CONTRACT.md](BACKEND-CONTRACT.md) —— 接口契约与实现状态 - [docs/P3-实施记录.md](docs/P3-实施记录.md) —— Nacos 发现 + ansible 复用 + 目录探测 - [docs/P4-实施记录.md](docs/P4-实施记录.md) —— >60s 异步执行 - [docs/MODE-A-自查-实施记录.md](docs/MODE-A-自查-实施记录.md) —— Mode A 执行后自查 - [docs/P5-实施记录.md](docs/P5-实施记录.md) —— edu 工具白名单进 agent 工具面