@wdyy/skills 0.1.19 → 0.1.21

package/README.md

@@ -7,7 +7,7 @@
 ```text
 AGENTS.md                         全局基线、技术栈、OpenSpec 流程与 Skill 路由
 OpenSpec                           单项变更的需求、设计、任务、实施与归档
-.well-known/skills/wdyy-*         数据库、内部接口、日志、部署的专业规则
+.well-known/skills/wdyy-*         数据库、日志、部署、医院 UI 的专业规则
 ```
 
 当前 `.well-known/skills/index.json` 登记 5 个企业 Skill。
@@ -15,10 +15,10 @@ OpenSpec                           单项变更的需求、设计、任务、实
 | Skill | 职责 |
 |---|---|
 | `wdyy-database-standard` | PostgreSQL 18 数据库设计、版本化迁移、数据兼容性与 DDL 校验。 |
-| `wdyy-api-standard` | 根据“获取XX数据”“使用XX接口”等需求定位接口 reference，并按已确认契约写入调用方式。 |
 | `wdyy-bug-record` | 手动汇总当前任务已解决的问题，并按模板追加至 `docs/bug_record.md`。 |
 | `wdyy-logging-standard` | 结构化日志、敏感字段移除、traceId、前端异常上报与日志轮转。 |
 | `wdyy-deployment-standard` | 在 Linux、macOS Docker Desktop 或 Windows Docker Desktop + WSL2/Linux 容器模式中，使用本地基础镜像构建前后端独立镜像，分别导出并统一压缩交付，远程数据库直连并一键部署整个项目栈。 |
+| `wdyy-ui` | 统一医院信息系统页面的布局、清新生命绿配色、医院 Logo、常用组件和响应式行为，不定义业务流程、接口或数据模型。 |
 
 ## 使用方式
 
@@ -29,7 +29,11 @@ npm install -g @wdyy/skills
 wdyy init
 ```
 
-`wdyy init` 会在系统用户目录 `.agents/skills/` 安装或更新 5 个受管理 Skill，不在目标项目创建 `.agents/skills/`。它还会执行 `git init`，创建或补齐 `.gitignore` 的 `.env`、`node_modules/`、`venv/`、`.pnpm-store/`、`logs/`、`dist/`、`.DS_Store`、`*.tar.gz` 规则，创建 `src/frontend`、`src/backend`、`database`、`deploy`、`docs`、`scripts`、`tests`，并以相同的“前端、后端、数据库、API、部署”结构创建缺失的 `.env` 与 `.env.example`。默认前端监听 `0.0.0.0:5173`、后端监听 `0.0.0.0:3000`、数据库端口为 `5432`；已有环境文件保持不变。随后命令执行 `openspec init`、创建或追加 `docs/bug_record.md` 模板。若目标项目已有 `AGENTS.md`，原文件保持不变，命令将生成 `AGENTS_new.md`。
+`wdyy init` 会在系统用户目录 `.agents/skills/` 安装或更新 5 个受管理 Skill，并删除其中旧的 `wdyy-api-standard`，但不在目标项目创建 `.agents/skills/`。它还会执行 `git init`，创建或补齐 `.gitignore` 的 `.env`、`node_modules/`、`venv/`、`.pnpm-store/`、`logs/`、`dist/`、`.DS_Store`、`*.tar.gz` 规则，创建 `src/frontend`、`src/backend`、`database`、`deploy`、`docs`、`scripts`、`tests`，并以相同的“前端、后端、数据库、API、部署”结构创建缺失的 `.env` 与 `.env.example`。默认前端监听 `0.0.0.0:5173`、后端监听 `0.0.0.0:3000`、数据库端口为 `5432`；已有环境文件保持不变。随后命令执行 `openspec init`、创建或追加 `docs/bug_record.md` 模板。若目标项目已有 `AGENTS.md`，原文件保持不变，命令将生成 `AGENTS_new.md`。
+
+生成的项目规则要求：接口实现仅以工程师人工提供的 YAML 文件为依据；未提供 YAML 或接口契约不完整时必须询问工程师，不得从旧 Skill、reference、远程目录或其他来源推断或编造。既有项目需要重新执行 `wdyy init` 才会生成包含该要求的新规则文件。
+
+生成的项目规则还要求：每个经确认的变更完成并通过全部测试与验证后创建对应 Git commit，不得提交未完成或验证失败的状态；每个变更依据对应 OpenSpec 的需求、场景和任务编写或更新相关测试，交付前必须解决全部测试与验证失败，不得跳过或隐瞒。既有项目重新执行 `wdyy init` 后，可从新生成的 `AGENTS_new.md` 审阅并合并该规则。
 
 ### 仅更新已安装的 Skill
 
@@ -38,14 +42,15 @@ wdyy init
 ```bash
 npm install -g @wdyy/skills@latest
 wdyy update-skill wdyy-logging-standard
+wdyy update-skill wdyy-ui
 wdyy update-skill --all
 ```
 
-`wdyy update-skill <skill-name>` 只接受 5 个受管理的 `wdyy-*` Skill，且仅替换系统用户目录 `.agents/skills/` 中的指定目录；`--all` 替换全部 5 个受管理 Skill。两种方式都不会写入调用项目的 `AGENTS.md`、`AGENTS_new.md`、`docs/bug_record.md` 或 `.agents/skills/`，也不会执行 `openspec init`。首次初始化或需要重新生成项目规则时，使用 `wdyy init`。
+`wdyy update-skill <skill-name>` 只接受 5 个受管理的 `wdyy-*` Skill，且仅替换系统用户目录 `.agents/skills/` 中的指定目录；`--all` 替换全部 5 个受管理 Skill并删除旧的 `wdyy-api-standard`。两种方式都不会写入调用项目的 `AGENTS.md`、`AGENTS_new.md`、`docs/bug_record.md` 或 `.agents/skills/`，也不会执行 `openspec init`。首次初始化或需要重新生成项目规则时，使用 `wdyy init`。
 
 部署 Skill 生成的标准流程为：在 Linux、macOS Docker Desktop，或 Windows Docker Desktop + WSL2/Linux 文件系统的项目根目录执行 `./deploy.sh build`，只使用本地已有的 Node、Nginx 基础镜像构建 `<项目名>_frontend:latest` 与 `<项目名>_backend:latest`，分别导出两个镜像 tar，并统一封装为 `deploy/<项目名>-docker.tar.gz`。工程师人工复制并解压该压缩包，在受支持的 Linux engine 上无参数执行 `./deploy.sh` 即校验、加载并整体部署前后端；macOS/arm64 Docker Desktop 可通过禁止拉取的实际目标镜像探针验证并运行 `linux/amd64` 包，而不是仅按 Server 原生架构拒绝。另可执行 `./deploy.sh stop` 和 `./deploy.sh status`。数据库通过 `.env` 直连远程 PostgreSQL，不生成数据库容器；前后端的宿主机与容器端口都来自 `.env`，容器名与镜像 repository 相同，使用 `unless-stopped`，并验证 24 小时制 CST（UTC+8）；日志直接保存在部署根 `logs/`。不支持原生 PowerShell 或 Windows 容器模式。
 
-中大型变更先使用 `/opsx:explore` 或 `/opsx:propose <change-name>`，在方案确认后使用 `/opsx:apply`；完成验证后使用 `/opsx:archive`。涉及数据库、内部 API、日志、部署时，按 `AGENTS.md` 的路由加载相应企业 Skill。所有 URL、端口和 IP 地址从 `.env` 读取，不得硬编码；所有项目管理的日志直接写入项目根目录 `logs/`；生产部署不使用蓝绿发布。不得提交秘密或生产环境 `.env`。项目完成后创建 `README.md`，说明技术栈、目录结构和安装部署。
+中大型变更先使用 `/opsx:explore` 或 `/opsx:propose <change-name>`，在方案确认后使用 `/opsx:apply`；完成验证后使用 `/opsx:archive`。涉及数据库、日志、部署或医院信息系统 UI 时，按 `AGENTS.md` 的路由加载相应企业 Skill；接口实现仅依据工程师人工提供的 YAML。所有 URL、端口和 IP 地址从 `.env` 读取，不得硬编码；所有项目管理的日志直接写入项目根目录 `logs/`；生产部署不使用蓝绿发布。不得提交秘密或生产环境 `.env`。项目完成后创建 `README.md`，说明技术栈、目录结构和安装部署。
 
 ## 固定技术栈
 

package/lib/wdyy-cli.js

@@ -1,5 +1,5 @@
 import { spawnSync } from 'node:child_process';
-import { access, appendFile, cp, mkdir, mkdtemp, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { access, appendFile, cp, lstat, mkdir, mkdtemp, readFile, rename, rm, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -7,12 +7,14 @@ import { fileURLToPath } from 'node:url';
 const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..');
 const managedSkillNames = [
   'wdyy-database-standard',
-  'wdyy-api-standard',
   'wdyy-bug-record',
   'wdyy-logging-standard',
-  'wdyy-deployment-standard'
+  'wdyy-deployment-standard',
+  'wdyy-ui'
 ];
 
+const removedManagedSkillNames = ['wdyy-api-standard'];
+
 const defaultProjectDirectories = [
   'src/frontend',
   'src/backend',
@@ -81,16 +83,21 @@ const generatedAgentsContent = `# 企业开发规则
 | 场景 | 必须使用的 Skill |
 |---|---|
 | PostgreSQL 表、DDL、迁移、数据兼容性 | \`wdyy-database-standard\` |
-| 获取已登记接口数据、使用已登记接口 | \`wdyy-api-standard\` |
 | 汇总当前任务已解决的 BUG、漏洞或运行异常 | 手动调用 \`wdyy-bug-record\`，追加写入 \`docs/bug_record.md\` |
 | 结构化日志、traceId、完整原始入参、前端异常上报 | \`wdyy-logging-standard\` |
 | 统一 Docker 交付、Linux/Mac/Windows WSL2 双镜像、远程数据库与整栈一键部署 | \`wdyy-deployment-standard\` |
+| 医院信息系统页面的新建、改造或审查 | \`wdyy-ui\`；不负责定义业务流程、接口或数据模型 |
 
 ## 通用边界
 
 - 项目根目录应提供真实可执行的 \`pnpm dev\`、\`pnpm build\`、\`pnpm test\`、\`pnpm lint\` 命令；\`pnpm dev\` 只负责前后端的启动，不得启动或管理数据库。
+- 接口实现仅以工程师人工提供的 YAML 文件为依据。未提供 YAML 或 YAML 中的接口契约不完整时，必须询问工程师；不得从已删除的 Skill、旧 reference、远程目录或其他来源推断或编造接口细节。
+- 生成的接口文档必须符合 OpenAPI 3.1 规范，并声明 \`openapi: 3.1.0\`。
+- 在下载或安装任何项目依赖前，必须先从官方发布渠道确认当前最新稳定版本，并检查该版本及其传递依赖的公开漏洞修复状态。原则上必须使用最新稳定版本；不得使用已过时的依赖，也不得使用存在未修复高危（High/Critical）漏洞的依赖。若最新稳定版本不兼容，或不存在满足安全要求的版本，必须停止安装并报告依赖名称、候选版本、兼容性及漏洞证据，等待工程师确认；不得擅自降级、忽略审计结果或添加豁免。
 - 代码、配置、迁移、测试与部署文件必须以实际实现为准；不得用模板虚构已实现能力。
 - 所有需求（如数据库变更、流程变更、功能变更、从零开发项目等），必须先使用\`openspec-explore\`技能确认需求，再根据实际情况，使用\`openspec\`的其它技能。
+- 每个经确认的变更完成并通过全部测试与验证后，必须创建一个对应的 Git commit，以支持追踪和回滚；不得提交未完成或验证失败的状态。
+- 每个变更都必须依据对应 OpenSpec 的需求、场景和任务编写或更新相关测试；交付前必须解决所有测试与验证失败，不得跳过或隐瞒失败。
 - 所有项目管理的日志必须直接写入项目根目录 \`logs/\`，不得通过环境变量改写目录或创建服务、实例、日期等日志子目录。
 - 生产部署必须使用 \`wdyy-deployment-standard\`：在 Linux、macOS Docker Desktop 或 Windows Docker Desktop + WSL2/Linux 容器模式中，只使用已有基础镜像构建前后端两个独立 Linux 镜像，分别导出后封装为一个压缩包；数据库直连远程实例且不得使用数据库容器；解压后无参数执行 \`./deploy.sh\`，一次性部署整个前后端项目栈。禁止原生 PowerShell、Windows 容器模式、自动拉取镜像、交互菜单和单独操作一个服务。
 - 不得静默吞错、跳过验证、以兜底逻辑掩盖未决问题。
@@ -128,6 +135,22 @@ async function installManagedSkills(skillsRoot, writtenPaths, skillNames = manag
   }
 }
 
+async function removeDeprecatedManagedSkills(skillsRoot, writtenPaths) {
+  for (const skillName of removedManagedSkillNames) {
+    const destination = join(skillsRoot, skillName);
+    try {
+      await lstat(destination);
+    } catch (error) {
+      if (error.code === 'ENOENT') continue;
+      throw error;
+    }
+
+    await rm(destination, { recursive: true, force: true });
+    writtenPaths.push(destination);
+    console.log(`已删除旧 Skill: ${destination}`);
+  }
+}
+
 function getGlobalSkillsRoot() {
   return join(homedir(), '.agents', 'skills');
 }
@@ -249,7 +272,9 @@ export async function run(argumentsList) {
       const gitExitCode = initializeGit(process.cwd(), writtenPaths);
       if (gitExitCode !== 0) return gitExitCode;
       await writeAgentsFile(process.cwd(), writtenPaths);
-      await installManagedSkills(getGlobalSkillsRoot(), writtenPaths);
+      const globalSkillsRoot = getGlobalSkillsRoot();
+      await installManagedSkills(globalSkillsRoot, writtenPaths);
+      await removeDeprecatedManagedSkills(globalSkillsRoot, writtenPaths);
       await appendGitIgnoreEntries(process.cwd(), writtenPaths);
       await createDefaultProjectLayout(process.cwd(), writtenPaths);
       await appendBugRecordTemplate(process.cwd(), writtenPaths);
@@ -266,7 +291,8 @@ export async function run(argumentsList) {
 
   if (argumentsList[0] === 'update-skill') {
     const skillArguments = argumentsList.slice(1);
-    const skillNames = skillArguments.length === 1 && skillArguments[0] === '--all'
+    const updateAll = skillArguments.length === 1 && skillArguments[0] === '--all';
+    const skillNames = updateAll
       ? managedSkillNames
       : skillArguments.length === 1 && managedSkillNames.includes(skillArguments[0])
         ? [skillArguments[0]]
@@ -279,7 +305,9 @@ export async function run(argumentsList) {
 
     const writtenPaths = [];
     try {
-      await installManagedSkills(getGlobalSkillsRoot(), writtenPaths, skillNames);
+      const globalSkillsRoot = getGlobalSkillsRoot();
+      await installManagedSkills(globalSkillsRoot, writtenPaths, skillNames);
+      if (updateAll) await removeDeprecatedManagedSkills(globalSkillsRoot, writtenPaths);
       return 0;
     } catch (error) {
       console.error(`Skill 更新失败: ${error.message}`);

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@wdyy/skills",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "企业内部开发 Skill 与项目初始化命令",
   "type": "module",
+  "packageManager": "pnpm@12.1.0",
   "bin": {
     "wdyy": "bin/wdyy.js"
   },
@@ -13,7 +14,8 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=24"
+    "node": ">=24",
+    "pnpm": "12.1.0"
   },
   "scripts": {
     "test": "node --test tests/*.test.mjs",

package/.well-known/skills/wdyy-api-standard/SKILL.md

@@ -1,52 +0,0 @@
----
-name: wdyy-api-standard
-description: 根据“获取XX数据”“使用XX接口”“使用指定查询名称”等具体需求，定位已登记的接口 reference；对于 HIS SQL 查询，从远程查询目录按 name 精确匹配，并按已确认的接口契约将调用方式写入程序。Use when 需要查询或实现一个已登记接口或 HIS SQL 查询的数据调用时。
-disable-model-invocation: true
----
-
-# 接口路由
-
-## 用途
-
-本 Skill 只负责根据具体需求定位接口 reference，并将已确认的接口调用方式写入程序。接口明细和 HIS SQL 查询目录使用规则一律维护在 `reference/` 中，每个接口一个文档。
-
-## 何时使用
-
-- 用户描述“获取XX数据”“使用XX接口”或等价的数据查询、接口调用需求时。
-- 用户描述“使用 `<查询名称>`”并需要从已登记 HIS SQL 查询目录实现调用时。
-- 需要将已登记接口的 URL、入参和返回值处理方式写入程序时。
-
-## 路由步骤
-
-1. 根据需求中的数据名称、业务对象或接口名称，在 `reference/api-*.md` 中查找候选业务接口，排除仅用于说明格式的 `api-demo.md`。
-2. 若需求为“使用 `<查询名称>`”且未直接匹配接口名称，则读取 `reference/api-his-sql.md`，按其中的远程目录和查询名称匹配规则处理。
-3. 仅在唯一匹配时读取对应 reference。匹配 `api-sso` 时，在写入调用代码前运行 `node <Skill目录>/scripts/ensure-sso-env-example.mjs --target <目标项目根目录>`：目标 `.env.example` 缺失、`SSO_BASE_URL` 重复或已有不同值时，明确报告错误并等待工程师处理；工程师确认替换唯一的不同值后，才使用 `--replace-existing` 重试。不得创建或修改 `.env`。
-4. 使用对应 reference 的接口 URL、JSON 入参和 JSON 返回值编写调用方式。
-5. 按 reference 的“备注”实现特殊调用要求。
-6. 若没有匹配接口、存在多个候选接口，或 URL、入参、返回值不完整，先要求补充或确认接口信息；不得编造调用细节。
-
-## 接口文档约定
-
-- `reference/api-demo.md` 仅说明接口文档格式，不得作为业务调用依据；其中可使用 `XXX` 等占位内容。
-- 一个接口对应一个 `reference/api-接口名称.md` 文件。
-- 文件名去除 `.md` 后必须与“接口名称”字段一致。
-- 每个业务接口文档必须按以下顺序包含六个一级标题：
-
-```md
-# 接口名称：api-xxx
-
-# 接口用途：中文描述
-
-# 接口URL：
-
-# 入参格式：JSON
-
-# 返回值：JSON
-
-# 备注：特殊使用方法说明
-```
-
-## 禁止事项
-
-- 不得依据接口名称或业务描述猜测 URL、请求字段、返回字段或特殊调用方式。
-- 不得将多个接口明细重新堆放回本 `SKILL.md`。

package/.well-known/skills/wdyy-api-standard/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "wdyy-api-standard"
-  short_description: "Route APIs and named HIS SQL queries into program code"
-  default_prompt: "Use $wdyy-api-standard to resolve the documented API or named HIS SQL query and write its call into the program."

package/.well-known/skills/wdyy-api-standard/reference/api-demo.md

@@ -1,27 +0,0 @@
-# 模板示例
-
-# 接口名称：api-demo
-
-# 接口用途：XXX
-
-# 接口URL：XXX
-
-# 入参格式：JSON
-
-```json
-{
-  "visitId": "6275033"
-}
-```
-
-# 返回值：JSON
-
-```json
-{
-  "code": 200,
-  "data": [{}, {}],
-  "msg": "success"
-}
-```
-
-# 备注：使用就诊号作为 `visitId` 参数调用；调用前应由业务上下文提供实际就诊号。

package/.well-known/skills/wdyy-api-standard/reference/api-his-sql.md

@@ -1,53 +0,0 @@
-# 接口名称：api-his-sql
-
-# 接口用途：执行 SQL 查询并返回查询结果
-
-# 接口URL：http://172.26.1.64:8999/api/database/query
-
-`POST` 请求，`Content-Type` 为 `application/json`。
-
-HIS SQL 查询目录：
-
-- 人工查看：`http://172.26.1.64:9003/lihuanyu/cache_query/-/blob/main/cache-query.json?ref_type=heads`
-- 程序读取：`http://172.26.1.64:9003/lihuanyu/cache_query/-/raw/main/cache-query.json`
-
-# 入参格式：JSON
-
-```json
-{
-  "sql": "<cache-query.json 中匹配对象的 sql 原文>",
-  "params": [
-    "<按照匹配对象 params 顺序提供的实际值>"
-  ]
-}
-```
-
-按以下步骤生成项目程序中的调用方式：
-
-1. 每次实现调用时读取“程序读取”地址，解析当前 `cache-query.json`；不得使用本地缓存或本 reference 中的示例 SQL 代替远程目录。
-2. 遍历 JSON 顶层对象的全部值，仅选择对象 `name` 与用户指定查询名称完全相等的候选项；不得使用 JSON 顶层键代替 `name` 匹配。
-3. 仅允许一个匹配对象。零个匹配或多个同名匹配时，明确报告问题并停止生成调用方式。
-4. 要求匹配对象包含非空字符串 `sql` 和数组 `params`。将 `sql` 原样写入请求体，不得生成、改写或拼接 SQL。
-5. 将目录中的 `params` 视为实际参数值的名称和顺序说明，不得把这些名称直接作为实际值发送。若用户或业务上下文未提供全部实际值，按数组顺序要求补充。
-6. 获得全部实际值后，按照目录 `params` 的相同顺序写入请求体 `params` 数组。
-
-例如，用户描述“使用 `get_diagnosis_info`”时，按对象 `name` 匹配该查询，并依次要求提供“开始日期”“结束日期”“诊断名称”；SQL 必须使用该匹配对象当前登记的原文。
-
-# 返回值：JSON
-
-```json
-{
-  "data": [
-    {
-      "SSUSR_RowId": 20292,
-      "SSUSR_Initials": "20684",
-      "SSUSR_Name": "马俊"
-    }
-  ],
-  "success": true,
-  "count": 1,
-  "message": "查询执行成功"
-}
-```
-
-# 备注：本 Skill 只将调用方式写入项目程序，不直接向本接口发送查询请求。远程目录不可访问、指定 `name` 不存在、存在多个同名对象、`sql` 不是非空字符串或 `params` 不是数组时，必须明确报告具体问题；不得使用旧副本、示例 SQL、顶层键匹配或自行生成 SQL 继续实现。

package/.well-known/skills/wdyy-api-standard/reference/api-sms.md

@@ -1,67 +0,0 @@
-# 接口名称：api-sms
-
-# 接口用途：向一个或多个手机号发送相同的短信内容
-
-# 接口URL：http://172.26.1.80:8998/api/sms/send
-
-`POST` 请求，`Content-Type` 为 `application/json; charset=utf-8`。当前地址为内网默认地址；生产或测试环境地址如有差异，以部署方提供的地址为准。
-
-# 入参格式：JSON
-
-```json
-{
-  "mobiles": [
-    "13800000001",
-    "13800000002"
-  ],
-  "content": "【系统通知】您的验证码是1234"
-}
-```
-
-- `mobiles`：必填，`array[string]`，接收短信的手机号列表；单次最多 200 个手机号。
-- `content`：必填，`string`，短信正文内容。
-- 接入方不传入 token、`userCode` 或 `token` 等短信网关凭证。
-
-# 返回值：JSON
-
-成功提交至短信网关时返回 HTTP `200`：
-
-```json
-{
-  "msgId": "2601291081805244415"
-}
-```
-
-`msgId` 为短信网关消息流水号，表示请求已提交至网关，不表示短信已最终送达。
-
-失败或被拦截时返回 `error` 字段。手机号列表为空或短信内容为空时返回 HTTP `400`：
-
-```json
-{
-  "error": "Error: Mobile number array cannot be empty."
-}
-```
-
-```json
-{
-  "error": "Error: Content cannot be empty."
-}
-```
-
-触发发送限流时返回 HTTP `429`：
-
-```json
-{
-  "error": "Too many requests: 手机号138****0001获取短信过于频繁，请稍后再试"
-}
-```
-
-短信网关拒绝或返回异常时，接口仍可能返回 HTTP `200`：
-
-```json
-{
-  "error": "-41"
-}
-```
-
-# 备注：使用 `POST` 请求调用；响应体存在 `msgId` 才表示提交成功，存在 `error` 表示发送失败或被拦截，不能只根据 HTTP 状态码判断成功。调用方应避免在日志中完整输出手机号、短信内容及验证码。调用前确认短信签名与模板已报备，并遵守单次最多 200 个手机号、单 IP 每分钟最多 120 次、单手机号每分钟最多 3 次的限流规则。

package/.well-known/skills/wdyy-api-standard/reference/api-sso.md

@@ -1,87 +0,0 @@
-# 接口名称：api-sso
-
-# 接口用途：接入统一认证中心，完成外部系统登录、Token 状态校验和登录态用户修改密码
-
-# 接口URL：
-
-默认认证中心基础地址为 `http://172.26.1.80:9002`。使用本接口前，先运行 `node <Skill目录>/scripts/ensure-sso-env-example.mjs --target <目标项目根目录>`，把 `SSO_BASE_URL=http://172.26.1.80:9002` 写入目标项目已有的 `.env.example`。部署环境地址如有差异，以认证中心提供的实际地址为准；不得在代码中硬编码认证中心地址、端口或 JWT 签名密钥。接口路径如下：
-
-| 用途 | 方法 | 路径 |
-|---|---|---|
-| 外部系统登录 | `POST` | `/api/v1/auth/login` |
-| Token 验签 | `POST` | `/api/v1/auth/verify` |
-| 修改密码 | `POST` | `/api/v1/auth/change-password` |
-
-三者均使用 `application/json; charset=utf-8`。登录无需 Token；验签和改密请求使用 `Authorization: Bearer <JWT_TOKEN>` 传入登录成功后取得的 Token。
-
-# 入参格式：JSON
-
-登录请求：
-
-```json
-{
-  "employee_id": "<EMPLOYEE_ID>",
-  "password": "<PASSWORD>",
-  "sys_id": "<SYSTEM_ID>"
-}
-```
-
-- `employee_id` 与 `username` 二选一，均按用户工号处理。
-- `password`、`sys_id` 必填；`sys_id` 为已启用接入系统的 ID，可为 number 或 string。
-
-验签请求可使用空 JSON 请求体，并在请求头携带 Bearer Token。修改密码请求：
-
-```json
-{
-  "old_password": "<OLD_PASSWORD>",
-  "new_password": "<NEW_PASSWORD>"
-}
-```
-
-- 改密仍须在请求头携带 Bearer Token。
-- `new_password` 长度必须为 6 至 100 个字符。
-
-# 返回值：JSON
-
-外部系统登录成功时，响应结构为：
-
-```json
-{
-  "code": 200,
-  "message": "<DISPLAY_MESSAGE>",
-  "data": {
-    "allowed": true,
-    "user_id": "<USER_ID>",
-    "employee_id": "<EMPLOYEE_ID>",
-    "name": "<USER_NAME>",
-    "token": "<JWT_TOKEN>",
-    "permissions": [
-      {
-        "dept_id": "<DEPARTMENT_ID>",
-        "dept_name": "<DEPARTMENT_NAME>",
-        "roles": [
-          {
-            "role_id": "<ROLE_ID>",
-            "role_name": "<ROLE_NAME>",
-            "description": "<ROLE_DESCRIPTION>"
-          }
-        ]
-      }
-    ]
-  }
-}
-```
-
-验签成功时 `data` 含 `valid`、`allowed`、`user_id`、`employee_id`、`name` 和 `sys_id`。改密成功时 `data` 含 `user_id`、`employee_id` 和 `name`。
-
-所有接口使用 `{ code, message, data }` 结构。HTTP 状态码及 `code` 的含义：`200` 成功、`400` 参数错误、`401` 认证失败或 Token 无效/过期、`403` 无目标系统权限或权限已失效、`404` 接入系统不存在或已停用、`500` 服务端异常。
-
-# 备注：
-
-- 不得依赖 `message` 的精确文案；登录和验签根据 HTTP 状态码、`code`、`data.valid`、`data.allowed` 判断结果。
-- 登录成功后仅在需要的安全存储中保存 Token；日志、异常上报和前端状态中不得明文记录密码、Token、JWT 签名密钥或连接信息。
-- 仅当登录响应 `data.allowed` 为 `true` 才进入目标系统；根据 `permissions` 内按科室聚合的角色控制业务入口。
-- 服务端需要确认登录态或权限是否仍有效时调用验签接口。验签返回 `valid: false` 或 `allowed: false` 时，清除本地登录态并要求重新登录或联系管理员。
-- 用户改密成功后，清除旧 Token 并提示用户使用新密码重新登录。
-- 不得用管理端 `/api/auth/*` 接口替代本 reference 中的外部系统 `/api/v1/auth/*` 接口。
-- `.env.example` 缺失时明确报错，不得创建该文件或修改 `.env`。已有相同 `SSO_BASE_URL` 时不重复写入；已有不同值时保留原值并等待工程师确认。工程师确认替换唯一的不同值后，才使用 `--replace-existing`；重复定义时始终报错。

package/.well-known/skills/wdyy-api-standard/scripts/ensure-sso-env-example.mjs

@@ -1,76 +0,0 @@
-import { access, readFile, writeFile } from 'node:fs/promises';
-import { constants } from 'node:fs';
-import { resolve } from 'node:path';
-
-const DEFAULT_SSO_BASE_URL = 'http://172.26.1.80:9002';
-
-function usage() {
-  throw new Error('Usage: node ensure-sso-env-example.mjs --target <project-root> [--replace-existing]');
-}
-
-function parseArguments(argumentsList) {
-  let target;
-  let replaceExisting = false;
-
-  for (let index = 0; index < argumentsList.length; index += 1) {
-    const argument = argumentsList[index];
-    if (argument === '--target') {
-      if (target || index + 1 >= argumentsList.length) usage();
-      target = argumentsList[index + 1];
-      index += 1;
-    } else if (argument === '--replace-existing') {
-      if (replaceExisting) usage();
-      replaceExisting = true;
-    } else {
-      usage();
-    }
-  }
-
-  if (!target) usage();
-  return { target: resolve(target), replaceExisting };
-}
-
-function findSsoBaseUrlLines(content) {
-  return content.split(/(?<=\n)/).flatMap((line, index) => {
-    const match = line.match(/^SSO_BASE_URL=([^\r\n]*)(\r?\n)?$/);
-    return match ? [{ index, value: match[1], line, newline: match[2] ?? '' }] : [];
-  });
-}
-
-async function main() {
-  const { target, replaceExisting } = parseArguments(process.argv.slice(2));
-  const examplePath = resolve(target, '.env.example');
-
-  try {
-    await access(examplePath, constants.F_OK);
-  } catch {
-    throw new Error(`Missing required configuration file: ${examplePath}`);
-  }
-
-  const content = await readFile(examplePath, 'utf8');
-  const entries = findSsoBaseUrlLines(content);
-  if (entries.length > 1) throw new Error('Duplicate SSO_BASE_URL definitions in .env.example');
-
-  if (entries.length === 0) {
-    const separator = content.length === 0 || content.endsWith('\n') ? '' : '\n';
-    await writeFile(examplePath, `${content}${separator}SSO_BASE_URL=${DEFAULT_SSO_BASE_URL}\n`);
-    process.stdout.write(`Added SSO_BASE_URL to ${examplePath}\n`);
-    return;
-  }
-
-  const [entry] = entries;
-  if (entry.value === DEFAULT_SSO_BASE_URL) {
-    process.stdout.write(`SSO_BASE_URL is already configured in ${examplePath}\n`);
-    return;
-  }
-
-  if (!replaceExisting) {
-    throw new Error('SSO_BASE_URL already has a different value; retain it and obtain engineer confirmation before using --replace-existing');
-  }
-
-  const replacement = `SSO_BASE_URL=${DEFAULT_SSO_BASE_URL}${entry.newline}`;
-  await writeFile(examplePath, content.replace(entry.line, replacement));
-  process.stdout.write(`Replaced SSO_BASE_URL in ${examplePath}\n`);
-}
-
-await main();

package/.well-known/skills/wdyy-api-standard/scripts/ensure-sso-env-example.test.mjs

@@ -1,66 +0,0 @@
-import assert from 'node:assert/strict';
-import { execFile } from 'node:child_process';
-import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { dirname, join } from 'node:path';
-import test from 'node:test';
-import { fileURLToPath } from 'node:url';
-import { promisify } from 'node:util';
-
-const run = promisify(execFile);
-const script = join(dirname(fileURLToPath(import.meta.url)), 'ensure-sso-env-example.mjs');
-const defaultValue = 'SSO_BASE_URL=http://172.26.1.80:9002';
-const created = [];
-
-async function fixture(content) {
-  const root = await mkdtemp(join(tmpdir(), 'wdyy-api-sso-'));
-  created.push(root);
-  if (content !== undefined) await writeFile(join(root, '.env.example'), content);
-  return root;
-}
-
-async function invoke(root, ...argumentsList) {
-  return run(process.execPath, [script, '--target', root, ...argumentsList]);
-}
-
-test.after(async () => {
-  await Promise.all(created.map((path) => rm(path, { recursive: true, force: true })));
-});
-
-test('缺少 .env.example 时明确失败且不创建文件', async () => {
-  const root = await fixture();
-  await assert.rejects(invoke(root), /Missing required configuration file/);
-  await assert.rejects(readFile(join(root, '.env.example')));
-});
-
-test('追加默认 SSO 地址且保持 .env.example 其他内容', async () => {
-  const root = await fixture('API_URL=/api\n');
-  await invoke(root);
-  assert.equal(await readFile(join(root, '.env.example'), 'utf8'), `API_URL=/api\n${defaultValue}\n`);
-});
-
-test('已存在默认 SSO 地址时不重复写入', async () => {
-  const root = await fixture(`${defaultValue}\n`);
-  await invoke(root);
-  assert.equal(await readFile(join(root, '.env.example'), 'utf8'), `${defaultValue}\n`);
-});
-
-test('不同 SSO 地址默认保留且明确失败', async () => {
-  const root = await fixture('SSO_BASE_URL=http://sso.internal:9002\n');
-  const before = await readFile(join(root, '.env.example'));
-  await assert.rejects(invoke(root), /different value/);
-  assert.deepEqual(await readFile(join(root, '.env.example')), before);
-});
-
-test('重复 SSO 地址明确失败且不修改文件', async () => {
-  const root = await fixture(`${defaultValue}\nSSO_BASE_URL=http://sso.internal:9002\n`);
-  const before = await readFile(join(root, '.env.example'));
-  await assert.rejects(invoke(root), /Duplicate SSO_BASE_URL definitions/);
-  assert.deepEqual(await readFile(join(root, '.env.example')), before);
-});
-
-test('明确替换后更新唯一的不同 SSO 地址', async () => {
-  const root = await fixture('SSO_BASE_URL=http://sso.internal:9002\n');
-  await invoke(root, '--replace-existing');
-  assert.equal(await readFile(join(root, '.env.example'), 'utf8'), `${defaultValue}\n`);
-});