add: 添加了HDMI视频流Client

fix: 修复debugger获取flag失败的问题
refactor: 重新编写debugger前后端逻辑

.gitignore

@@ -9,13 +9,16 @@ lerna-debug.log*
 
 node_modules
 .DS_Store
+.vscode
 dist
+**/wwwroot
 dist-ssr
 coverage
 *.local
 
 /cypress/videos/
 /cypress/screenshots/
+DebuggerCmd.md
 
 # Editor directories and files
 .vscode/*
@@ -25,10 +28,10 @@ coverage
 *.suo
 *.ntvs*
 *.njsproj
-*.sln
 *.sw?
 
 *.tsbuildinfo
 
 # Generated Files
 *.sqlite
+components.d.ts

.justfile

@@ -1,16 +1,64 @@
+set windows-shell := ["powershell.exe", "-NoLogo", "-Command"]
+isSelfContained := "false"
+
 @_show-dir:
   echo "Current Working Directory:"
   pwd
   echo
 
-[working-directory: "server"]
+# 清空构建文件
-publish: _show-dir
+clean: 
-  dotnet publish --self-contained false -t:PublishAllRids
+  rm -rf "server/bin"
+  rm -rf "server/obj"
+  rm -rf "server.test/bin"
+  rm -rf "server.test/obj"
+  rm -rf "dist"
+  rm -rf "wwwroot"
 
-[working-directory: "server"]
+update: update-node update-dotnet
-run-server: _show-dir
+  git submodule update --init --remote --recursive
-  dotnet run
 
+update-node:
+  npm install
+  
+update-dotnet:
+  dotnet restore ./server/server.csproj
+
+# 生成Restful API到网页客户端
+gen-api:
+  npm run gen-api
+
+gen-api-from-server:
+  npx nswag openapi2tsclient /input:http://localhost:5000/swagger/v1/swagger.json /output:src/APIClient.ts
+
+# 构建服务器，包含win与linux平台
+[working-directory: "server"]
+build-server self-contained=isSelfContained: _show-dir
+  dotnet publish --self-contained {{self-contained}} -t:PublishAllRids
+  npm run build
+  rsync -avz --delete ../wwwroot/ ./bin/Release/net9.0/linux-x64/publish/wwwroot/
+  rsync -avz --delete ../wwwroot/ ./bin/Release/net9.0/win-x64/publish/wwwroot/
+
+run: run-server
+
+run-server: (build-server "true")
+  ./server/bin/Release/net9.0/linux-x64/publish/server
+
+run-web:
+  npm run build
+  npm run preview
+
+dev: dev-server
+
+# 测试服务器
+dev-server: _show-dir
+  dotnet run --watch --project ./server/server.csproj
+
+# 运行网页客户端
+dev-web: 
+  npm run dev
+  
+# 运行测试用例测试服务器
 [working-directory: "server.test"]
 test-server: _show-dir
   dotnet test --logger "console;verbosity=detailed"

FPGAWebLabServer.sln

@@ -0,0 +1,48 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio Version 17
+VisualStudioVersion = 17.0.31903.59
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "server", "server\server.csproj", "{F31D6A0D-0407-41CE-A67E-01B847488EFB}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "server.test", "server.test\server.test.csproj", "{CC274582-AC3C-4FD1-977C-96F1BC2760BD}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Debug|x64 = Debug|x64
+		Debug|x86 = Debug|x86
+		Release|Any CPU = Release|Any CPU
+		Release|x64 = Release|x64
+		Release|x86 = Release|x86
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{F31D6A0D-0407-41CE-A67E-01B847488EFB}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{F31D6A0D-0407-41CE-A67E-01B847488EFB}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{F31D6A0D-0407-41CE-A67E-01B847488EFB}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{F31D6A0D-0407-41CE-A67E-01B847488EFB}.Debug|x64.Build.0 = Debug|Any CPU
+		{F31D6A0D-0407-41CE-A67E-01B847488EFB}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{F31D6A0D-0407-41CE-A67E-01B847488EFB}.Debug|x86.Build.0 = Debug|Any CPU
+		{F31D6A0D-0407-41CE-A67E-01B847488EFB}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{F31D6A0D-0407-41CE-A67E-01B847488EFB}.Release|Any CPU.Build.0 = Release|Any CPU
+		{F31D6A0D-0407-41CE-A67E-01B847488EFB}.Release|x64.ActiveCfg = Release|Any CPU
+		{F31D6A0D-0407-41CE-A67E-01B847488EFB}.Release|x64.Build.0 = Release|Any CPU
+		{F31D6A0D-0407-41CE-A67E-01B847488EFB}.Release|x86.ActiveCfg = Release|Any CPU
+		{F31D6A0D-0407-41CE-A67E-01B847488EFB}.Release|x86.Build.0 = Release|Any CPU
+		{CC274582-AC3C-4FD1-977C-96F1BC2760BD}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{CC274582-AC3C-4FD1-977C-96F1BC2760BD}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{CC274582-AC3C-4FD1-977C-96F1BC2760BD}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{CC274582-AC3C-4FD1-977C-96F1BC2760BD}.Debug|x64.Build.0 = Debug|Any CPU
+		{CC274582-AC3C-4FD1-977C-96F1BC2760BD}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{CC274582-AC3C-4FD1-977C-96F1BC2760BD}.Debug|x86.Build.0 = Debug|Any CPU
+		{CC274582-AC3C-4FD1-977C-96F1BC2760BD}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{CC274582-AC3C-4FD1-977C-96F1BC2760BD}.Release|Any CPU.Build.0 = Release|Any CPU
+		{CC274582-AC3C-4FD1-977C-96F1BC2760BD}.Release|x64.ActiveCfg = Release|Any CPU
+		{CC274582-AC3C-4FD1-977C-96F1BC2760BD}.Release|x64.Build.0 = Release|Any CPU
+		{CC274582-AC3C-4FD1-977C-96F1BC2760BD}.Release|x86.ActiveCfg = Release|Any CPU
+		{CC274582-AC3C-4FD1-977C-96F1BC2760BD}.Release|x86.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+EndGlobal

TODO.md

@@ -0,0 +1,13 @@
+# TODO
+
+1. 后端HTTP视频流
+
+640*480, RGB565
+0x0000_0000 + 25800
+
+
+2. 信号发生器界面导入.dat文件
+3. 示波器后端交互、前端界面
+4. 逻辑分析仪后端交互、前端界面
+5. 前端重构
+6. 数据库 —— 用户登录、板卡资源分配、板卡IP地址分配

bun.lock

@@ -1,585 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "fpga-weblab",
-      "dependencies": {
-        "@trpc/client": "^10.45.2",
-        "@trpc/server": "^10.45.2",
-        "@types/lodash": "^4.17.16",
-        "lodash": "^4.17.21",
-        "log-symbols": "^7.0.0",
-        "pinia": "^3.0.1",
-        "tinypool": "^1.0.2",
-        "trpc-bun-adapter": "^1.2.2",
-        "ts-log": "^2.2.7",
-        "ts-results-es": "^5.0.1",
-        "vue": "^3.5.13",
-        "vue-router": "4",
-        "zod": "^3.24.2",
-      },
-      "devDependencies": {
-        "@tailwindcss/postcss": "^4.0.12",
-        "@tsconfig/node22": "^22.0.0",
-        "@types/bun": "^1.2.5",
-        "@types/node": "^22.13.4",
-        "@vitejs/plugin-vue": "^5.2.1",
-        "@vitejs/plugin-vue-jsx": "^4.1.1",
-        "@vue/tsconfig": "^0.7.0",
-        "autoprefixer": "^10.4.20",
-        "bun-plugin-tailwind": "^0.0.15",
-        "daisyui": "^5.0.0",
-        "npm-run-all2": "^7.0.2",
-        "postcss": "^8.5.3",
-        "tailwindcss": "^4.0.12",
-        "typescript": "~5.7.3",
-        "vite": "^6.1.0",
-        "vite-plugin-vue-devtools": "^7.7.2",
-        "vue-tsc": "^2.2.2",
-      },
-    },
-  },
-  "packages": {
-    "@alloc/quick-lru": ["@alloc/quick-lru@5.2.0", "", {}, "sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw=="],
-
-    "@ampproject/remapping": ["@ampproject/remapping@2.3.0", "", { "dependencies": { "@jridgewell/gen-mapping": "^0.3.5", "@jridgewell/trace-mapping": "^0.3.24" } }, "sha512-30iZtAPgz+LTIYoeivqYo853f02jBYSd5uGnGpkFV0M3xOt9aN73erkgYAmZU43x4VfqcnLxW9Kpg3R5LC4YYw=="],
-
-    "@antfu/utils": ["@antfu/utils@0.7.10", "", {}, "sha512-+562v9k4aI80m1+VuMHehNJWLOFjBnXn3tdOitzD0il5b7smkSBal4+a3oKiQTbrwMmN/TBUMDvbdoWDehgOww=="],
-
-    "@babel/code-frame": ["@babel/code-frame@7.26.2", "", { "dependencies": { "@babel/helper-validator-identifier": "^7.25.9", "js-tokens": "^4.0.0", "picocolors": "^1.0.0" } }, "sha512-RJlIHRueQgwWitWgF8OdFYGZX328Ax5BCemNGlqHfplnRT9ESi8JkFlvaVYbS+UubVY6dpv87Fs2u5M29iNFVQ=="],
-
-    "@babel/compat-data": ["@babel/compat-data@7.26.8", "", {}, "sha512-oH5UPLMWR3L2wEFLnFJ1TZXqHufiTKAiLfqw5zkhS4dKXLJ10yVztfil/twG8EDTA4F/tvVNw9nOl4ZMslB8rQ=="],
-
-    "@babel/core": ["@babel/core@7.26.9", "", { "dependencies": { "@ampproject/remapping": "^2.2.0", "@babel/code-frame": "^7.26.2", "@babel/generator": "^7.26.9", "@babel/helper-compilation-targets": "^7.26.5", "@babel/helper-module-transforms": "^7.26.0", "@babel/helpers": "^7.26.9", "@babel/parser": "^7.26.9", "@babel/template": "^7.26.9", "@babel/traverse": "^7.26.9", "@babel/types": "^7.26.9", "convert-source-map": "^2.0.0", "debug": "^4.1.0", "gensync": "^1.0.0-beta.2", "json5": "^2.2.3", "semver": "^6.3.1" } }, "sha512-lWBYIrF7qK5+GjY5Uy+/hEgp8OJWOD/rpy74GplYRhEauvbHDeFB8t5hPOZxCZ0Oxf4Cc36tK51/l3ymJysrKw=="],
-
-    "@babel/generator": ["@babel/generator@7.26.9", "", { "dependencies": { "@babel/parser": "^7.26.9", "@babel/types": "^7.26.9", "@jridgewell/gen-mapping": "^0.3.5", "@jridgewell/trace-mapping": "^0.3.25", "jsesc": "^3.0.2" } }, "sha512-kEWdzjOAUMW4hAyrzJ0ZaTOu9OmpyDIQicIh0zg0EEcEkYXZb2TjtBhnHi2ViX7PKwZqF4xwqfAm299/QMP3lg=="],
-
-    "@babel/helper-annotate-as-pure": ["@babel/helper-annotate-as-pure@7.25.9", "", { "dependencies": { "@babel/types": "^7.25.9" } }, "sha512-gv7320KBUFJz1RnylIg5WWYPRXKZ884AGkYpgpWW02TH66Dl+HaC1t1CKd0z3R4b6hdYEcmrNZHUmfCP+1u3/g=="],
-
-    "@babel/helper-compilation-targets": ["@babel/helper-compilation-targets@7.26.5", "", { "dependencies": { "@babel/compat-data": "^7.26.5", "@babel/helper-validator-option": "^7.25.9", "browserslist": "^4.24.0", "lru-cache": "^5.1.1", "semver": "^6.3.1" } }, "sha512-IXuyn5EkouFJscIDuFF5EsiSolseme1s0CZB+QxVugqJLYmKdxI1VfIBOst0SUu4rnk2Z7kqTwmoO1lp3HIfnA=="],
-
-    "@babel/helper-create-class-features-plugin": ["@babel/helper-create-class-features-plugin@7.26.9", "", { "dependencies": { "@babel/helper-annotate-as-pure": "^7.25.9", "@babel/helper-member-expression-to-functions": "^7.25.9", "@babel/helper-optimise-call-expression": "^7.25.9", "@babel/helper-replace-supers": "^7.26.5", "@babel/helper-skip-transparent-expression-wrappers": "^7.25.9", "@babel/traverse": "^7.26.9", "semver": "^6.3.1" }, "peerDependencies": { "@babel/core": "^7.0.0" } }, "sha512-ubbUqCofvxPRurw5L8WTsCLSkQiVpov4Qx0WMA+jUN+nXBK8ADPlJO1grkFw5CWKC5+sZSOfuGMdX1aI1iT9Sg=="],
-
-    "@babel/helper-member-expression-to-functions": ["@babel/helper-member-expression-to-functions@7.25.9", "", { "dependencies": { "@babel/traverse": "^7.25.9", "@babel/types": "^7.25.9" } }, "sha512-wbfdZ9w5vk0C0oyHqAJbc62+vet5prjj01jjJ8sKn3j9h3MQQlflEdXYvuqRWjHnM12coDEqiC1IRCi0U/EKwQ=="],
-
-    "@babel/helper-module-imports": ["@babel/helper-module-imports@7.25.9", "", { "dependencies": { "@babel/traverse": "^7.25.9", "@babel/types": "^7.25.9" } }, "sha512-tnUA4RsrmflIM6W6RFTLFSXITtl0wKjgpnLgXyowocVPrbYrLUXSBXDgTs8BlbmIzIdlBySRQjINYs2BAkiLtw=="],
-
-    "@babel/helper-module-transforms": ["@babel/helper-module-transforms@7.26.0", "", { "dependencies": { "@babel/helper-module-imports": "^7.25.9", "@babel/helper-validator-identifier": "^7.25.9", "@babel/traverse": "^7.25.9" }, "peerDependencies": { "@babel/core": "^7.0.0" } }, "sha512-xO+xu6B5K2czEnQye6BHA7DolFFmS3LB7stHZFaOLb1pAwO1HWLS8fXA+eh0A2yIvltPVmx3eNNDBJA2SLHXFw=="],
-
-    "@babel/helper-optimise-call-expression": ["@babel/helper-optimise-call-expression@7.25.9", "", { "dependencies": { "@babel/types": "^7.25.9" } }, "sha512-FIpuNaz5ow8VyrYcnXQTDRGvV6tTjkNtCK/RYNDXGSLlUD6cBuQTSw43CShGxjvfBTfcUA/r6UhUCbtYqkhcuQ=="],
-
-    "@babel/helper-plugin-utils": ["@babel/helper-plugin-utils@7.26.5", "", {}, "sha512-RS+jZcRdZdRFzMyr+wcsaqOmld1/EqTghfaBGQQd/WnRdzdlvSZ//kF7U8VQTxf1ynZ4cjUcYgjVGx13ewNPMg=="],
-
-    "@babel/helper-replace-supers": ["@babel/helper-replace-supers@7.26.5", "", { "dependencies": { "@babel/helper-member-expression-to-functions": "^7.25.9", "@babel/helper-optimise-call-expression": "^7.25.9", "@babel/traverse": "^7.26.5" }, "peerDependencies": { "@babel/core": "^7.0.0" } }, "sha512-bJ6iIVdYX1YooY2X7w1q6VITt+LnUILtNk7zT78ykuwStx8BauCzxvFqFaHjOpW1bVnSUM1PN1f0p5P21wHxvg=="],
-
-    "@babel/helper-skip-transparent-expression-wrappers": ["@babel/helper-skip-transparent-expression-wrappers@7.25.9", "", { "dependencies": { "@babel/traverse": "^7.25.9", "@babel/types": "^7.25.9" } }, "sha512-K4Du3BFa3gvyhzgPcntrkDgZzQaq6uozzcpGbOO1OEJaI+EJdqWIMTLgFgQf6lrfiDFo5FU+BxKepI9RmZqahA=="],
-
-    "@babel/helper-string-parser": ["@babel/helper-string-parser@7.25.9", "", {}, "sha512-4A/SCr/2KLd5jrtOMFzaKjVtAei3+2r/NChoBNoZ3EyP/+GlhoaEGoWOZUmFmoITP7zOJyHIMm+DYRd8o3PvHA=="],
-
-    "@babel/helper-validator-identifier": ["@babel/helper-validator-identifier@7.25.9", "", {}, "sha512-Ed61U6XJc3CVRfkERJWDz4dJwKe7iLmmJsbOGu9wSloNSFttHV0I8g6UAgb7qnK5ly5bGLPd4oXZlxCdANBOWQ=="],
-
-    "@babel/helper-validator-option": ["@babel/helper-validator-option@7.25.9", "", {}, "sha512-e/zv1co8pp55dNdEcCynfj9X7nyUKUXoUEwfXqaZt0omVOmDe9oOTdKStH4GmAw6zxMFs50ZayuMfHDKlO7Tfw=="],
-
-    "@babel/helpers": ["@babel/helpers@7.26.9", "", { "dependencies": { "@babel/template": "^7.26.9", "@babel/types": "^7.26.9" } }, "sha512-Mz/4+y8udxBKdmzt/UjPACs4G3j5SshJJEFFKxlCGPydG4JAHXxjWjAwjd09tf6oINvl1VfMJo+nB7H2YKQ0dA=="],
-
-    "@babel/parser": ["@babel/parser@7.26.9", "", { "dependencies": { "@babel/types": "^7.26.9" }, "bin": "./bin/babel-parser.js" }, "sha512-81NWa1njQblgZbQHxWHpxxCzNsa3ZwvFqpUg7P+NNUU6f3UU2jBEg4OlF/J6rl8+PQGh1q6/zWScd001YwcA5A=="],
-
-    "@babel/plugin-proposal-decorators": ["@babel/plugin-proposal-decorators@7.25.9", "", { "dependencies": { "@babel/helper-create-class-features-plugin": "^7.25.9", "@babel/helper-plugin-utils": "^7.25.9", "@babel/plugin-syntax-decorators": "^7.25.9" }, "peerDependencies": { "@babel/core": "^7.0.0-0" } }, "sha512-smkNLL/O1ezy9Nhy4CNosc4Va+1wo5w4gzSZeLe6y6dM4mmHfYOCPolXQPHQxonZCF+ZyebxN9vqOolkYrSn5g=="],
-
-    "@babel/plugin-syntax-decorators": ["@babel/plugin-syntax-decorators@7.25.9", "", { "dependencies": { "@babel/helper-plugin-utils": "^7.25.9" }, "peerDependencies": { "@babel/core": "^7.0.0-0" } }, "sha512-ryzI0McXUPJnRCvMo4lumIKZUzhYUO/ScI+Mz4YVaTLt04DHNSjEUjKVvbzQjZFLuod/cYEc07mJWhzl6v4DPg=="],
-
-    "@babel/plugin-syntax-import-attributes": ["@babel/plugin-syntax-import-attributes@7.26.0", "", { "dependencies": { "@babel/helper-plugin-utils": "^7.25.9" }, "peerDependencies": { "@babel/core": "^7.0.0-0" } }, "sha512-e2dttdsJ1ZTpi3B9UYGLw41hifAubg19AtCu/2I/F1QNVclOBr1dYpTdmdyZ84Xiz43BS/tCUkMAZNLv12Pi+A=="],
-
-    "@babel/plugin-syntax-import-meta": ["@babel/plugin-syntax-import-meta@7.10.4", "", { "dependencies": { "@babel/helper-plugin-utils": "^7.10.4" }, "peerDependencies": { "@babel/core": "^7.0.0-0" } }, "sha512-Yqfm+XDx0+Prh3VSeEQCPU81yC+JWZ2pDPFSS4ZdpfZhp4MkFMaDC1UqseovEKwSUpnIL7+vK+Clp7bfh0iD7g=="],
-
-    "@babel/plugin-syntax-jsx": ["@babel/plugin-syntax-jsx@7.25.9", "", { "dependencies": { "@babel/helper-plugin-utils": "^7.25.9" }, "peerDependencies": { "@babel/core": "^7.0.0-0" } }, "sha512-ld6oezHQMZsZfp6pWtbjaNDF2tiiCYYDqQszHt5VV437lewP9aSi2Of99CK0D0XB21k7FLgnLcmQKyKzynfeAA=="],
-
-    "@babel/plugin-syntax-typescript": ["@babel/plugin-syntax-typescript@7.25.9", "", { "dependencies": { "@babel/helper-plugin-utils": "^7.25.9" }, "peerDependencies": { "@babel/core": "^7.0.0-0" } }, "sha512-hjMgRy5hb8uJJjUcdWunWVcoi9bGpJp8p5Ol1229PoN6aytsLwNMgmdftO23wnCLMfVmTwZDWMPNq/D1SY60JQ=="],
-
-    "@babel/plugin-transform-typescript": ["@babel/plugin-transform-typescript@7.26.8", "", { "dependencies": { "@babel/helper-annotate-as-pure": "^7.25.9", "@babel/helper-create-class-features-plugin": "^7.25.9", "@babel/helper-plugin-utils": "^7.26.5", "@babel/helper-skip-transparent-expression-wrappers": "^7.25.9", "@babel/plugin-syntax-typescript": "^7.25.9" }, "peerDependencies": { "@babel/core": "^7.0.0-0" } }, "sha512-bME5J9AC8ChwA7aEPJ6zym3w7aObZULHhbNLU0bKUhKsAkylkzUdq+0kdymh9rzi8nlNFl2bmldFBCKNJBUpuw=="],
-
-    "@babel/template": ["@babel/template@7.26.9", "", { "dependencies": { "@babel/code-frame": "^7.26.2", "@babel/parser": "^7.26.9", "@babel/types": "^7.26.9" } }, "sha512-qyRplbeIpNZhmzOysF/wFMuP9sctmh2cFzRAZOn1YapxBsE1i9bJIY586R/WBLfLcmcBlM8ROBiQURnnNy+zfA=="],
-
-    "@babel/traverse": ["@babel/traverse@7.26.9", "", { "dependencies": { "@babel/code-frame": "^7.26.2", "@babel/generator": "^7.26.9", "@babel/parser": "^7.26.9", "@babel/template": "^7.26.9", "@babel/types": "^7.26.9", "debug": "^4.3.1", "globals": "^11.1.0" } }, "sha512-ZYW7L+pL8ahU5fXmNbPF+iZFHCv5scFak7MZ9bwaRPLUhHh7QQEMjZUg0HevihoqCM5iSYHN61EyCoZvqC+bxg=="],
-
-    "@babel/types": ["@babel/types@7.26.9", "", { "dependencies": { "@babel/helper-string-parser": "^7.25.9", "@babel/helper-validator-identifier": "^7.25.9" } }, "sha512-Y3IR1cRnOxOCDvMmNiym7XpXQ93iGDDPHx+Zj+NM+rg0fBaShfQLkg+hKPaZCEvg5N/LeCo4+Rj/i3FuJsIQaw=="],
-
-    "@esbuild/aix-ppc64": ["@esbuild/aix-ppc64@0.25.0", "", { "os": "aix", "cpu": "ppc64" }, "sha512-O7vun9Sf8DFjH2UtqK8Ku3LkquL9SZL8OLY1T5NZkA34+wG3OQF7cl4Ql8vdNzM6fzBbYfLaiRLIOZ+2FOCgBQ=="],
-
-    "@esbuild/android-arm": ["@esbuild/android-arm@0.25.0", "", { "os": "android", "cpu": "arm" }, "sha512-PTyWCYYiU0+1eJKmw21lWtC+d08JDZPQ5g+kFyxP0V+es6VPPSUhM6zk8iImp2jbV6GwjX4pap0JFbUQN65X1g=="],
-
-    "@esbuild/android-arm64": ["@esbuild/android-arm64@0.25.0", "", { "os": "android", "cpu": "arm64" }, "sha512-grvv8WncGjDSyUBjN9yHXNt+cq0snxXbDxy5pJtzMKGmmpPxeAmAhWxXI+01lU5rwZomDgD3kJwulEnhTRUd6g=="],
-
-    "@esbuild/android-x64": ["@esbuild/android-x64@0.25.0", "", { "os": "android", "cpu": "x64" }, "sha512-m/ix7SfKG5buCnxasr52+LI78SQ+wgdENi9CqyCXwjVR2X4Jkz+BpC3le3AoBPYTC9NHklwngVXvbJ9/Akhrfg=="],
-
-    "@esbuild/darwin-arm64": ["@esbuild/darwin-arm64@0.25.0", "", { "os": "darwin", "cpu": "arm64" }, "sha512-mVwdUb5SRkPayVadIOI78K7aAnPamoeFR2bT5nszFUZ9P8UpK4ratOdYbZZXYSqPKMHfS1wdHCJk1P1EZpRdvw=="],
-
-    "@esbuild/darwin-x64": ["@esbuild/darwin-x64@0.25.0", "", { "os": "darwin", "cpu": "x64" }, "sha512-DgDaYsPWFTS4S3nWpFcMn/33ZZwAAeAFKNHNa1QN0rI4pUjgqf0f7ONmXf6d22tqTY+H9FNdgeaAa+YIFUn2Rg=="],
-
-    "@esbuild/freebsd-arm64": ["@esbuild/freebsd-arm64@0.25.0", "", { "os": "freebsd", "cpu": "arm64" }, "sha512-VN4ocxy6dxefN1MepBx/iD1dH5K8qNtNe227I0mnTRjry8tj5MRk4zprLEdG8WPyAPb93/e4pSgi1SoHdgOa4w=="],
-
-    "@esbuild/freebsd-x64": ["@esbuild/freebsd-x64@0.25.0", "", { "os": "freebsd", "cpu": "x64" }, "sha512-mrSgt7lCh07FY+hDD1TxiTyIHyttn6vnjesnPoVDNmDfOmggTLXRv8Id5fNZey1gl/V2dyVK1VXXqVsQIiAk+A=="],
-
-    "@esbuild/linux-arm": ["@esbuild/linux-arm@0.25.0", "", { "os": "linux", "cpu": "arm" }, "sha512-vkB3IYj2IDo3g9xX7HqhPYxVkNQe8qTK55fraQyTzTX/fxaDtXiEnavv9geOsonh2Fd2RMB+i5cbhu2zMNWJwg=="],
-
-    "@esbuild/linux-arm64": ["@esbuild/linux-arm64@0.25.0", "", { "os": "linux", "cpu": "arm64" }, "sha512-9QAQjTWNDM/Vk2bgBl17yWuZxZNQIF0OUUuPZRKoDtqF2k4EtYbpyiG5/Dk7nqeK6kIJWPYldkOcBqjXjrUlmg=="],
-
-    "@esbuild/linux-ia32": ["@esbuild/linux-ia32@0.25.0", "", { "os": "linux", "cpu": "ia32" }, "sha512-43ET5bHbphBegyeqLb7I1eYn2P/JYGNmzzdidq/w0T8E2SsYL1U6un2NFROFRg1JZLTzdCoRomg8Rvf9M6W6Gg=="],
-
-    "@esbuild/linux-loong64": ["@esbuild/linux-loong64@0.25.0", "", { "os": "linux", "cpu": "none" }, "sha512-fC95c/xyNFueMhClxJmeRIj2yrSMdDfmqJnyOY4ZqsALkDrrKJfIg5NTMSzVBr5YW1jf+l7/cndBfP3MSDpoHw=="],
-
-    "@esbuild/linux-mips64el": ["@esbuild/linux-mips64el@0.25.0", "", { "os": "linux", "cpu": "none" }, "sha512-nkAMFju7KDW73T1DdH7glcyIptm95a7Le8irTQNO/qtkoyypZAnjchQgooFUDQhNAy4iu08N79W4T4pMBwhPwQ=="],
-
-    "@esbuild/linux-ppc64": ["@esbuild/linux-ppc64@0.25.0", "", { "os": "linux", "cpu": "ppc64" }, "sha512-NhyOejdhRGS8Iwv+KKR2zTq2PpysF9XqY+Zk77vQHqNbo/PwZCzB5/h7VGuREZm1fixhs4Q/qWRSi5zmAiO4Fw=="],
-
-    "@esbuild/linux-riscv64": ["@esbuild/linux-riscv64@0.25.0", "", { "os": "linux", "cpu": "none" }, "sha512-5S/rbP5OY+GHLC5qXp1y/Mx//e92L1YDqkiBbO9TQOvuFXM+iDqUNG5XopAnXoRH3FjIUDkeGcY1cgNvnXp/kA=="],
-
-    "@esbuild/linux-s390x": ["@esbuild/linux-s390x@0.25.0", "", { "os": "linux", "cpu": "s390x" }, "sha512-XM2BFsEBz0Fw37V0zU4CXfcfuACMrppsMFKdYY2WuTS3yi8O1nFOhil/xhKTmE1nPmVyvQJjJivgDT+xh8pXJA=="],
-
-    "@esbuild/linux-x64": ["@esbuild/linux-x64@0.25.0", "", { "os": "linux", "cpu": "x64" }, "sha512-9yl91rHw/cpwMCNytUDxwj2XjFpxML0y9HAOH9pNVQDpQrBxHy01Dx+vaMu0N1CKa/RzBD2hB4u//nfc+Sd3Cw=="],
-
-    "@esbuild/netbsd-arm64": ["@esbuild/netbsd-arm64@0.25.0", "", { "os": "none", "cpu": "arm64" }, "sha512-RuG4PSMPFfrkH6UwCAqBzauBWTygTvb1nxWasEJooGSJ/NwRw7b2HOwyRTQIU97Hq37l3npXoZGYMy3b3xYvPw=="],
-
-    "@esbuild/netbsd-x64": ["@esbuild/netbsd-x64@0.25.0", "", { "os": "none", "cpu": "x64" }, "sha512-jl+qisSB5jk01N5f7sPCsBENCOlPiS/xptD5yxOx2oqQfyourJwIKLRA2yqWdifj3owQZCL2sn6o08dBzZGQzA=="],
-
-    "@esbuild/openbsd-arm64": ["@esbuild/openbsd-arm64@0.25.0", "", { "os": "openbsd", "cpu": "arm64" }, "sha512-21sUNbq2r84YE+SJDfaQRvdgznTD8Xc0oc3p3iW/a1EVWeNj/SdUCbm5U0itZPQYRuRTW20fPMWMpcrciH2EJw=="],
-
-    "@esbuild/openbsd-x64": ["@esbuild/openbsd-x64@0.25.0", "", { "os": "openbsd", "cpu": "x64" }, "sha512-2gwwriSMPcCFRlPlKx3zLQhfN/2WjJ2NSlg5TKLQOJdV0mSxIcYNTMhk3H3ulL/cak+Xj0lY1Ym9ysDV1igceg=="],
-
-    "@esbuild/sunos-x64": ["@esbuild/sunos-x64@0.25.0", "", { "os": "sunos", "cpu": "x64" }, "sha512-bxI7ThgLzPrPz484/S9jLlvUAHYMzy6I0XiU1ZMeAEOBcS0VePBFxh1JjTQt3Xiat5b6Oh4x7UC7IwKQKIJRIg=="],
-
-    "@esbuild/win32-arm64": ["@esbuild/win32-arm64@0.25.0", "", { "os": "win32", "cpu": "arm64" }, "sha512-ZUAc2YK6JW89xTbXvftxdnYy3m4iHIkDtK3CLce8wg8M2L+YZhIvO1DKpxrd0Yr59AeNNkTiic9YLf6FTtXWMw=="],
-
-    "@esbuild/win32-ia32": ["@esbuild/win32-ia32@0.25.0", "", { "os": "win32", "cpu": "ia32" }, "sha512-eSNxISBu8XweVEWG31/JzjkIGbGIJN/TrRoiSVZwZ6pkC6VX4Im/WV2cz559/TXLcYbcrDN8JtKgd9DJVIo8GA=="],
-
-    "@esbuild/win32-x64": ["@esbuild/win32-x64@0.25.0", "", { "os": "win32", "cpu": "x64" }, "sha512-ZENoHJBxA20C2zFzh6AI4fT6RraMzjYw4xKWemRTRmRVtN9c5DcH9r/f2ihEkMjOW5eGgrwCslG/+Y/3bL+DHQ=="],
-
-    "@jridgewell/gen-mapping": ["@jridgewell/gen-mapping@0.3.8", "", { "dependencies": { "@jridgewell/set-array": "^1.2.1", "@jridgewell/sourcemap-codec": "^1.4.10", "@jridgewell/trace-mapping": "^0.3.24" } }, "sha512-imAbBGkb+ebQyxKgzv5Hu2nmROxoDOXHh80evxdoXNOrvAnVx7zimzc1Oo5h9RlfV4vPXaE2iM5pOFbvOCClWA=="],
-
-    "@jridgewell/resolve-uri": ["@jridgewell/resolve-uri@3.1.2", "", {}, "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw=="],
-
-    "@jridgewell/set-array": ["@jridgewell/set-array@1.2.1", "", {}, "sha512-R8gLRTZeyp03ymzP/6Lil/28tGeGEzhx1q2k703KGWRAI1VdvPIXdG70VJc2pAMw3NA6JKL5hhFu1sJX0Mnn/A=="],
-
-    "@jridgewell/sourcemap-codec": ["@jridgewell/sourcemap-codec@1.5.0", "", {}, "sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ=="],
-
-    "@jridgewell/trace-mapping": ["@jridgewell/trace-mapping@0.3.25", "", { "dependencies": { "@jridgewell/resolve-uri": "^3.1.0", "@jridgewell/sourcemap-codec": "^1.4.14" } }, "sha512-vNk6aEwybGtawWmy/PzwnGDOjCkLWSD2wqvjGGAgOAwCGWySYXfYoxt00IJkTF+8Lb57DwOb3Aa0o9CApepiYQ=="],
-
-    "@polka/url": ["@polka/url@1.0.0-next.28", "", {}, "sha512-8LduaNlMZGwdZ6qWrKlfa+2M4gahzFkprZiAt2TF8uS0qQgBizKXpXURqvTJ4WtmupWxaLqjRb2UCTe72mu+Aw=="],
-
-    "@rollup/pluginutils": ["@rollup/pluginutils@5.1.4", "", { "dependencies": { "@types/estree": "^1.0.0", "estree-walker": "^2.0.2", "picomatch": "^4.0.2" }, "peerDependencies": { "rollup": "^1.20.0||^2.0.0||^3.0.0||^4.0.0" }, "optionalPeers": ["rollup"] }, "sha512-USm05zrsFxYLPdWWq+K3STlWiT/3ELn3RcV5hJMghpeAIhxfsUIg6mt12CBJBInWMV4VneoV7SfGv8xIwo2qNQ=="],
-
-    "@rollup/rollup-android-arm-eabi": ["@rollup/rollup-android-arm-eabi@4.34.9", "", { "os": "android", "cpu": "arm" }, "sha512-qZdlImWXur0CFakn2BJ2znJOdqYZKiedEPEVNTBrpfPjc/YuTGcaYZcdmNFTkUj3DU0ZM/AElcM8Ybww3xVLzA=="],
-
-    "@rollup/rollup-android-arm64": ["@rollup/rollup-android-arm64@4.34.9", "", { "os": "android", "cpu": "arm64" }, "sha512-4KW7P53h6HtJf5Y608T1ISKvNIYLWRKMvfnG0c44M6In4DQVU58HZFEVhWINDZKp7FZps98G3gxwC1sb0wXUUg=="],
-
-    "@rollup/rollup-darwin-arm64": ["@rollup/rollup-darwin-arm64@4.34.9", "", { "os": "darwin", "cpu": "arm64" }, "sha512-0CY3/K54slrzLDjOA7TOjN1NuLKERBgk9nY5V34mhmuu673YNb+7ghaDUs6N0ujXR7fz5XaS5Aa6d2TNxZd0OQ=="],
-
-    "@rollup/rollup-darwin-x64": ["@rollup/rollup-darwin-x64@4.34.9", "", { "os": "darwin", "cpu": "x64" }, "sha512-eOojSEAi/acnsJVYRxnMkPFqcxSMFfrw7r2iD9Q32SGkb/Q9FpUY1UlAu1DH9T7j++gZ0lHjnm4OyH2vCI7l7Q=="],
-
-    "@rollup/rollup-freebsd-arm64": ["@rollup/rollup-freebsd-arm64@4.34.9", "", { "os": "freebsd", "cpu": "arm64" }, "sha512-2lzjQPJbN5UnHm7bHIUKFMulGTQwdvOkouJDpPysJS+QFBGDJqcfh+CxxtG23Ik/9tEvnebQiylYoazFMAgrYw=="],
-
-    "@rollup/rollup-freebsd-x64": ["@rollup/rollup-freebsd-x64@4.34.9", "", { "os": "freebsd", "cpu": "x64" }, "sha512-SLl0hi2Ah2H7xQYd6Qaiu01kFPzQ+hqvdYSoOtHYg/zCIFs6t8sV95kaoqjzjFwuYQLtOI0RZre/Ke0nPaQV+g=="],
-
-    "@rollup/rollup-linux-arm-gnueabihf": ["@rollup/rollup-linux-arm-gnueabihf@4.34.9", "", { "os": "linux", "cpu": "arm" }, "sha512-88I+D3TeKItrw+Y/2ud4Tw0+3CxQ2kLgu3QvrogZ0OfkmX/DEppehus7L3TS2Q4lpB+hYyxhkQiYPJ6Mf5/dPg=="],
-
-    "@rollup/rollup-linux-arm-musleabihf": ["@rollup/rollup-linux-arm-musleabihf@4.34.9", "", { "os": "linux", "cpu": "arm" }, "sha512-3qyfWljSFHi9zH0KgtEPG4cBXHDFhwD8kwg6xLfHQ0IWuH9crp005GfoUUh/6w9/FWGBwEHg3lxK1iHRN1MFlA=="],
-
-    "@rollup/rollup-linux-arm64-gnu": ["@rollup/rollup-linux-arm64-gnu@4.34.9", "", { "os": "linux", "cpu": "arm64" }, "sha512-6TZjPHjKZUQKmVKMUowF3ewHxctrRR09eYyvT5eFv8w/fXarEra83A2mHTVJLA5xU91aCNOUnM+DWFMSbQ0Nxw=="],
-
-    "@rollup/rollup-linux-arm64-musl": ["@rollup/rollup-linux-arm64-musl@4.34.9", "", { "os": "linux", "cpu": "arm64" }, "sha512-LD2fytxZJZ6xzOKnMbIpgzFOuIKlxVOpiMAXawsAZ2mHBPEYOnLRK5TTEsID6z4eM23DuO88X0Tq1mErHMVq0A=="],
-
-    "@rollup/rollup-linux-loongarch64-gnu": ["@rollup/rollup-linux-loongarch64-gnu@4.34.9", "", { "os": "linux", "cpu": "none" }, "sha512-dRAgTfDsn0TE0HI6cmo13hemKpVHOEyeciGtvlBTkpx/F65kTvShtY/EVyZEIfxFkV5JJTuQ9tP5HGBS0hfxIg=="],
-
-    "@rollup/rollup-linux-powerpc64le-gnu": ["@rollup/rollup-linux-powerpc64le-gnu@4.34.9", "", { "os": "linux", "cpu": "ppc64" }, "sha512-PHcNOAEhkoMSQtMf+rJofwisZqaU8iQ8EaSps58f5HYll9EAY5BSErCZ8qBDMVbq88h4UxaNPlbrKqfWP8RfJA=="],
-
-    "@rollup/rollup-linux-riscv64-gnu": ["@rollup/rollup-linux-riscv64-gnu@4.34.9", "", { "os": "linux", "cpu": "none" }, "sha512-Z2i0Uy5G96KBYKjeQFKbbsB54xFOL5/y1P5wNBsbXB8yE+At3oh0DVMjQVzCJRJSfReiB2tX8T6HUFZ2k8iaKg=="],
-
-    "@rollup/rollup-linux-s390x-gnu": ["@rollup/rollup-linux-s390x-gnu@4.34.9", "", { "os": "linux", "cpu": "s390x" }, "sha512-U+5SwTMoeYXoDzJX5dhDTxRltSrIax8KWwfaaYcynuJw8mT33W7oOgz0a+AaXtGuvhzTr2tVKh5UO8GVANTxyQ=="],
-
-    "@rollup/rollup-linux-x64-gnu": ["@rollup/rollup-linux-x64-gnu@4.34.9", "", { "os": "linux", "cpu": "x64" }, "sha512-FwBHNSOjUTQLP4MG7y6rR6qbGw4MFeQnIBrMe161QGaQoBQLqSUEKlHIiVgF3g/mb3lxlxzJOpIBhaP+C+KP2A=="],
-
-    "@rollup/rollup-linux-x64-musl": ["@rollup/rollup-linux-x64-musl@4.34.9", "", { "os": "linux", "cpu": "x64" }, "sha512-cYRpV4650z2I3/s6+5/LONkjIz8MBeqrk+vPXV10ORBnshpn8S32bPqQ2Utv39jCiDcO2eJTuSlPXpnvmaIgRA=="],
-
-    "@rollup/rollup-win32-arm64-msvc": ["@rollup/rollup-win32-arm64-msvc@4.34.9", "", { "os": "win32", "cpu": "arm64" }, "sha512-z4mQK9dAN6byRA/vsSgQiPeuO63wdiDxZ9yg9iyX2QTzKuQM7T4xlBoeUP/J8uiFkqxkcWndWi+W7bXdPbt27Q=="],
-
-    "@rollup/rollup-win32-ia32-msvc": ["@rollup/rollup-win32-ia32-msvc@4.34.9", "", { "os": "win32", "cpu": "ia32" }, "sha512-KB48mPtaoHy1AwDNkAJfHXvHp24H0ryZog28spEs0V48l3H1fr4i37tiyHsgKZJnCmvxsbATdZGBpbmxTE3a9w=="],
-
-    "@rollup/rollup-win32-x64-msvc": ["@rollup/rollup-win32-x64-msvc@4.34.9", "", { "os": "win32", "cpu": "x64" }, "sha512-AyleYRPU7+rgkMWbEh71fQlrzRfeP6SyMnRf9XX4fCdDPAJumdSBqYEcWPMzVQ4ScAl7E4oFfK0GUVn77xSwbw=="],
-
-    "@sec-ant/readable-stream": ["@sec-ant/readable-stream@0.4.1", "", {}, "sha512-831qok9r2t8AlxLko40y2ebgSDhenenCatLVeW/uBtnHPyhHOvG0C7TvfgecV+wHzIm5KUICgzmVpWS+IMEAeg=="],
-
-    "@sindresorhus/merge-streams": ["@sindresorhus/merge-streams@4.0.0", "", {}, "sha512-tlqY9xq5ukxTUZBmoOp+m61cqwQD5pHJtFY3Mn8CA8ps6yghLH/Hw8UPdqg4OLmFW3IFlcXnQNmo/dh8HzXYIQ=="],
-
-    "@tailwindcss/node": ["@tailwindcss/node@4.0.12", "", { "dependencies": { "enhanced-resolve": "^5.18.1", "jiti": "^2.4.2", "tailwindcss": "4.0.12" } }, "sha512-a6J11K1Ztdln9OrGfoM75/hChYPcHYGNYimqciMrvKXRmmPaS8XZTHhdvb5a3glz4Kd4ZxE1MnuFE2c0fGGmtg=="],
-
-    "@tailwindcss/oxide": ["@tailwindcss/oxide@4.0.12", "", { "optionalDependencies": { "@tailwindcss/oxide-android-arm64": "4.0.12", "@tailwindcss/oxide-darwin-arm64": "4.0.12", "@tailwindcss/oxide-darwin-x64": "4.0.12", "@tailwindcss/oxide-freebsd-x64": "4.0.12", "@tailwindcss/oxide-linux-arm-gnueabihf": "4.0.12", "@tailwindcss/oxide-linux-arm64-gnu": "4.0.12", "@tailwindcss/oxide-linux-arm64-musl": "4.0.12", "@tailwindcss/oxide-linux-x64-gnu": "4.0.12", "@tailwindcss/oxide-linux-x64-musl": "4.0.12", "@tailwindcss/oxide-win32-arm64-msvc": "4.0.12", "@tailwindcss/oxide-win32-x64-msvc": "4.0.12" } }, "sha512-DWb+myvJB9xJwelwT9GHaMc1qJj6MDXRDR0CS+T8IdkejAtu8ctJAgV4r1drQJLPeS7mNwq2UHW2GWrudTf63A=="],
-
-    "@tailwindcss/oxide-android-arm64": ["@tailwindcss/oxide-android-arm64@4.0.12", "", { "os": "android", "cpu": "arm64" }, "sha512-dAXCaemu3mHLXcA5GwGlQynX8n7tTdvn5i1zAxRvZ5iC9fWLl5bGnjZnzrQqT7ttxCvRwdVf3IHUnMVdDBO/kQ=="],
-
-    "@tailwindcss/oxide-darwin-arm64": ["@tailwindcss/oxide-darwin-arm64@4.0.12", "", { "os": "darwin", "cpu": "arm64" }, "sha512-vPNI+TpJQ7sizselDXIJdYkx9Cu6JBdtmRWujw9pVIxW8uz3O2PjgGGzL/7A0sXI8XDjSyRChrUnEW9rQygmJQ=="],
-
-    "@tailwindcss/oxide-darwin-x64": ["@tailwindcss/oxide-darwin-x64@4.0.12", "", { "os": "darwin", "cpu": "x64" }, "sha512-RL/9jM41Fdq4Efr35C5wgLx98BirnrfwuD+zgMFK6Ir68HeOSqBhW9jsEeC7Y/JcGyPd3MEoJVIU4fAb7YLg7A=="],
-
-    "@tailwindcss/oxide-freebsd-x64": ["@tailwindcss/oxide-freebsd-x64@4.0.12", "", { "os": "freebsd", "cpu": "x64" }, "sha512-7WzWiax+LguJcMEimY0Q4sBLlFXu1tYxVka3+G2M9KmU/3m84J3jAIV4KZWnockbHsbb2XgrEjtlJKVwHQCoRA=="],
-
-    "@tailwindcss/oxide-linux-arm-gnueabihf": ["@tailwindcss/oxide-linux-arm-gnueabihf@4.0.12", "", { "os": "linux", "cpu": "arm" }, "sha512-X9LRC7jjE1QlfIaBbXjY0PGeQP87lz5mEfLSVs2J1yRc9PSg1tEPS9NBqY4BU9v5toZgJgzKeaNltORyTs22TQ=="],
-
-    "@tailwindcss/oxide-linux-arm64-gnu": ["@tailwindcss/oxide-linux-arm64-gnu@4.0.12", "", { "os": "linux", "cpu": "arm64" }, "sha512-i24IFNq2402zfDdoWKypXz0ZNS2G4NKaA82tgBlE2OhHIE+4mg2JDb5wVfyP6R+MCm5grgXvurcIcKWvo44QiQ=="],
-
-    "@tailwindcss/oxide-linux-arm64-musl": ["@tailwindcss/oxide-linux-arm64-musl@4.0.12", "", { "os": "linux", "cpu": "arm64" }, "sha512-LmOdshJBfAGIBG0DdBWhI0n5LTMurnGGJCHcsm9F//ISfsHtCnnYIKgYQui5oOz1SUCkqsMGfkAzWyNKZqbGNw=="],
-
-    "@tailwindcss/oxide-linux-x64-gnu": ["@tailwindcss/oxide-linux-x64-gnu@4.0.12", "", { "os": "linux", "cpu": "x64" }, "sha512-OSK667qZRH30ep8RiHbZDQfqkXjnzKxdn0oRwWzgCO8CoTxV+MvIkd0BWdQbYtYuM1wrakARV/Hwp0eA/qzdbw=="],
-
-    "@tailwindcss/oxide-linux-x64-musl": ["@tailwindcss/oxide-linux-x64-musl@4.0.12", "", { "os": "linux", "cpu": "x64" }, "sha512-uylhWq6OWQ8krV8Jk+v0H/3AZKJW6xYMgNMyNnUbbYXWi7hIVdxRKNUB5UvrlC3RxtgsK5EAV2i1CWTRsNcAnA=="],
-
-    "@tailwindcss/oxide-win32-arm64-msvc": ["@tailwindcss/oxide-win32-arm64-msvc@4.0.12", "", { "os": "win32", "cpu": "arm64" }, "sha512-XDLnhMoXZEEOir1LK43/gHHwK84V1GlV8+pAncUAIN2wloeD+nNciI9WRIY/BeFTqES22DhTIGoilSO39xDb2g=="],
-
-    "@tailwindcss/oxide-win32-x64-msvc": ["@tailwindcss/oxide-win32-x64-msvc@4.0.12", "", { "os": "win32", "cpu": "x64" }, "sha512-I/BbjCLpKDQucvtn6rFuYLst1nfFwSMYyPzkx/095RE+tuzk5+fwXuzQh7T3fIBTcbn82qH/sFka7yPGA50tLw=="],
-
-    "@tailwindcss/postcss": ["@tailwindcss/postcss@4.0.12", "", { "dependencies": { "@alloc/quick-lru": "^5.2.0", "@tailwindcss/node": "4.0.12", "@tailwindcss/oxide": "4.0.12", "lightningcss": "^1.29.1", "postcss": "^8.4.41", "tailwindcss": "4.0.12" } }, "sha512-r59Sdr8djCW4dL3kvc4aWU8PHdUAVM3O3te2nbYzXsWwKLlHPCuUoZAc9FafXb/YyNDZOMI7sTbKTKFmwOrMjw=="],
-
-    "@trpc/client": ["@trpc/client@10.45.2", "", { "peerDependencies": { "@trpc/server": "10.45.2" } }, "sha512-ykALM5kYWTLn1zYuUOZ2cPWlVfrXhc18HzBDyRhoPYN0jey4iQHEFSEowfnhg1RvYnrAVjNBgHNeSAXjrDbGwg=="],
-
-    "@trpc/server": ["@trpc/server@10.45.2", "", {}, "sha512-wOrSThNNE4HUnuhJG6PfDRp4L2009KDVxsd+2VYH8ro6o/7/jwYZ8Uu5j+VaW+mOmc8EHerHzGcdbGNQSAUPgg=="],
-
-    "@tsconfig/node22": ["@tsconfig/node22@22.0.0", "", {}, "sha512-twLQ77zevtxobBOD4ToAtVmuYrpeYUh3qh+TEp+08IWhpsrIflVHqQ1F1CiPxQGL7doCdBIOOCF+1Tm833faNg=="],
-
-    "@types/bun": ["@types/bun@1.2.5", "", { "dependencies": { "bun-types": "1.2.5" } }, "sha512-w2OZTzrZTVtbnJew1pdFmgV99H0/L+Pvw+z1P67HaR18MHOzYnTYOi6qzErhK8HyT+DB782ADVPPE92Xu2/Opg=="],
-
-    "@types/estree": ["@types/estree@1.0.6", "", {}, "sha512-AYnb1nQyY49te+VRAVgmzfcgjYS91mY5P0TKUDCLEM+gNnA+3T6rWITXRLYCpahpqSQbN5cE+gHpnPyXjHWxcw=="],
-
-    "@types/lodash": ["@types/lodash@4.17.16", "", {}, "sha512-HX7Em5NYQAXKW+1T+FiuG27NGwzJfCX3s1GjOa7ujxZa52kjJLOr4FUxT+giF6Tgxv1e+/czV/iTtBw27WTU9g=="],
-
-    "@types/node": ["@types/node@22.13.9", "", { "dependencies": { "undici-types": "~6.20.0" } }, "sha512-acBjXdRJ3A6Pb3tqnw9HZmyR3Fiol3aGxRCK1x3d+6CDAMjl7I649wpSd+yNURCjbOUGu9tqtLKnTGxmK6CyGw=="],
-
-    "@types/ws": ["@types/ws@8.5.14", "", { "dependencies": { "@types/node": "*" } }, "sha512-bd/YFLW+URhBzMXurx7lWByOu+xzU9+kb3RboOteXYDfW+tr+JZa99OyNmPINEGB/ahzKrEuc8rcv4gnpJmxTw=="],
-
-    "@vitejs/plugin-vue": ["@vitejs/plugin-vue@5.2.1", "", { "peerDependencies": { "vite": "^5.0.0 || ^6.0.0", "vue": "^3.2.25" } }, "sha512-cxh314tzaWwOLqVes2gnnCtvBDcM1UMdn+iFR+UjAn411dPT3tOmqrJjbMd7koZpMAmBM/GqeV4n9ge7JSiJJQ=="],
-
-    "@vitejs/plugin-vue-jsx": ["@vitejs/plugin-vue-jsx@4.1.1", "", { "dependencies": { "@babel/core": "^7.26.0", "@babel/plugin-transform-typescript": "^7.25.9", "@vue/babel-plugin-jsx": "^1.2.5" }, "peerDependencies": { "vite": "^5.0.0 || ^6.0.0", "vue": "^3.0.0" } }, "sha512-uMJqv/7u1zz/9NbWAD3XdjaY20tKTf17XVfQ9zq4wY1BjsB/PjpJPMe2xiG39QpP4ZdhYNhm4Hvo66uJrykNLA=="],
-
-    "@volar/language-core": ["@volar/language-core@2.4.12", "", { "dependencies": { "@volar/source-map": "2.4.12" } }, "sha512-RLrFdXEaQBWfSnYGVxvR2WrO6Bub0unkdHYIdC31HzIEqATIuuhRRzYu76iGPZ6OtA4Au1SnW0ZwIqPP217YhA=="],
-
-    "@volar/source-map": ["@volar/source-map@2.4.12", "", {}, "sha512-bUFIKvn2U0AWojOaqf63ER0N/iHIBYZPpNGogfLPQ68F5Eet6FnLlyho7BS0y2HJ1jFhSif7AcuTx1TqsCzRzw=="],
-
-    "@volar/typescript": ["@volar/typescript@2.4.12", "", { "dependencies": { "@volar/language-core": "2.4.12", "path-browserify": "^1.0.1", "vscode-uri": "^3.0.8" } }, "sha512-HJB73OTJDgPc80K30wxi3if4fSsZZAOScbj2fcicMuOPoOkcf9NNAINb33o+DzhBdF9xTKC1gnPmIRDous5S0g=="],
-
-    "@vue/babel-helper-vue-transform-on": ["@vue/babel-helper-vue-transform-on@1.3.0", "", {}, "sha512-vrNyYNQcz1gfc87uuN+Z+On9fFOBQTYRlTUEDovpeCmjuwH83lAm6YM0VBvTx6eRTHg3SU5jP2CD+kSXY30PGg=="],
-
-    "@vue/babel-plugin-jsx": ["@vue/babel-plugin-jsx@1.3.0", "", { "dependencies": { "@babel/helper-module-imports": "^7.25.9", "@babel/helper-plugin-utils": "^7.26.5", "@babel/plugin-syntax-jsx": "^7.25.9", "@babel/template": "^7.26.9", "@babel/traverse": "^7.26.9", "@babel/types": "^7.26.9", "@vue/babel-helper-vue-transform-on": "1.3.0", "@vue/babel-plugin-resolve-type": "1.3.0", "@vue/shared": "^3.5.13" }, "peerDependencies": { "@babel/core": "^7.0.0-0" }, "optionalPeers": ["@babel/core"] }, "sha512-ODZSs93FCxLMOiMFAGJXe7QMJp1tk8hkMbk84OcHOTVwYU2cFwFu1z7jjrRv44wCCfPNkflqn6hnexVprb+G7A=="],
-
-    "@vue/babel-plugin-resolve-type": ["@vue/babel-plugin-resolve-type@1.3.0", "", { "dependencies": { "@babel/code-frame": "^7.26.2", "@babel/helper-module-imports": "^7.25.9", "@babel/helper-plugin-utils": "^7.26.5", "@babel/parser": "^7.26.9", "@vue/compiler-sfc": "^3.5.13" }, "peerDependencies": { "@babel/core": "^7.0.0-0" } }, "sha512-3SmusE11QKNKtnVfbsKegUEArpf1fXE85Dzi/Q6lvaz3MA3tmL8BXyq/vA7GJeZ183XeNpLIZHrHDdUh9V348A=="],
-
-    "@vue/compiler-core": ["@vue/compiler-core@3.5.13", "", { "dependencies": { "@babel/parser": "^7.25.3", "@vue/shared": "3.5.13", "entities": "^4.5.0", "estree-walker": "^2.0.2", "source-map-js": "^1.2.0" } }, "sha512-oOdAkwqUfW1WqpwSYJce06wvt6HljgY3fGeM9NcVA1HaYOij3mZG9Rkysn0OHuyUAGMbEbARIpsG+LPVlBJ5/Q=="],
-
-    "@vue/compiler-dom": ["@vue/compiler-dom@3.5.13", "", { "dependencies": { "@vue/compiler-core": "3.5.13", "@vue/shared": "3.5.13" } }, "sha512-ZOJ46sMOKUjO3e94wPdCzQ6P1Lx/vhp2RSvfaab88Ajexs0AHeV0uasYhi99WPaogmBlRHNRuly8xV75cNTMDA=="],
-
-    "@vue/compiler-sfc": ["@vue/compiler-sfc@3.5.13", "", { "dependencies": { "@babel/parser": "^7.25.3", "@vue/compiler-core": "3.5.13", "@vue/compiler-dom": "3.5.13", "@vue/compiler-ssr": "3.5.13", "@vue/shared": "3.5.13", "estree-walker": "^2.0.2", "magic-string": "^0.30.11", "postcss": "^8.4.48", "source-map-js": "^1.2.0" } }, "sha512-6VdaljMpD82w6c2749Zhf5T9u5uLBWKnVue6XWxprDobftnletJ8+oel7sexFfM3qIxNmVE7LSFGTpv6obNyaQ=="],
-
-    "@vue/compiler-ssr": ["@vue/compiler-ssr@3.5.13", "", { "dependencies": { "@vue/compiler-dom": "3.5.13", "@vue/shared": "3.5.13" } }, "sha512-wMH6vrYHxQl/IybKJagqbquvxpWCuVYpoUJfCqFZwa/JY1GdATAQ+TgVtgrwwMZ0D07QhA99rs/EAAWfvG6KpA=="],
-
-    "@vue/compiler-vue2": ["@vue/compiler-vue2@2.7.16", "", { "dependencies": { "de-indent": "^1.0.2", "he": "^1.2.0" } }, "sha512-qYC3Psj9S/mfu9uVi5WvNZIzq+xnXMhOwbTFKKDD7b1lhpnn71jXSFdTQ+WsIEk0ONCd7VV2IMm7ONl6tbQ86A=="],
-
-    "@vue/devtools-api": ["@vue/devtools-api@7.7.2", "", { "dependencies": { "@vue/devtools-kit": "^7.7.2" } }, "sha512-1syn558KhyN+chO5SjlZIwJ8bV/bQ1nOVTG66t2RbG66ZGekyiYNmRO7X9BJCXQqPsFHlnksqvPhce2qpzxFnA=="],
-
-    "@vue/devtools-core": ["@vue/devtools-core@7.7.2", "", { "dependencies": { "@vue/devtools-kit": "^7.7.2", "@vue/devtools-shared": "^7.7.2", "mitt": "^3.0.1", "nanoid": "^5.0.9", "pathe": "^2.0.2", "vite-hot-client": "^0.2.4" }, "peerDependencies": { "vue": "^3.0.0" } }, "sha512-lexREWj1lKi91Tblr38ntSsy6CvI8ba7u+jmwh2yruib/ltLUcsIzEjCnrkh1yYGGIKXbAuYV2tOG10fGDB9OQ=="],
-
-    "@vue/devtools-kit": ["@vue/devtools-kit@7.7.2", "", { "dependencies": { "@vue/devtools-shared": "^7.7.2", "birpc": "^0.2.19", "hookable": "^5.5.3", "mitt": "^3.0.1", "perfect-debounce": "^1.0.0", "speakingurl": "^14.0.1", "superjson": "^2.2.1" } }, "sha512-CY0I1JH3Z8PECbn6k3TqM1Bk9ASWxeMtTCvZr7vb+CHi+X/QwQm5F1/fPagraamKMAHVfuuCbdcnNg1A4CYVWQ=="],
-
-    "@vue/devtools-shared": ["@vue/devtools-shared@7.7.2", "", { "dependencies": { "rfdc": "^1.4.1" } }, "sha512-uBFxnp8gwW2vD6FrJB8JZLUzVb6PNRG0B0jBnHsOH8uKyva2qINY8PTF5Te4QlTbMDqU5K6qtJDr6cNsKWhbOA=="],
-
-    "@vue/language-core": ["@vue/language-core@2.2.8", "", { "dependencies": { "@volar/language-core": "~2.4.11", "@vue/compiler-dom": "^3.5.0", "@vue/compiler-vue2": "^2.7.16", "@vue/shared": "^3.5.0", "alien-signals": "^1.0.3", "minimatch": "^9.0.3", "muggle-string": "^0.4.1", "path-browserify": "^1.0.1" }, "peerDependencies": { "typescript": "*" }, "optionalPeers": ["typescript"] }, "sha512-rrzB0wPGBvcwaSNRriVWdNAbHQWSf0NlGqgKHK5mEkXpefjUlVRP62u03KvwZpvKVjRnBIQ/Lwre+Mx9N6juUQ=="],
-
-    "@vue/reactivity": ["@vue/reactivity@3.5.13", "", { "dependencies": { "@vue/shared": "3.5.13" } }, "sha512-NaCwtw8o48B9I6L1zl2p41OHo/2Z4wqYGGIK1Khu5T7yxrn+ATOixn/Udn2m+6kZKB/J7cuT9DbWWhRxqixACg=="],
-
-    "@vue/runtime-core": ["@vue/runtime-core@3.5.13", "", { "dependencies": { "@vue/reactivity": "3.5.13", "@vue/shared": "3.5.13" } }, "sha512-Fj4YRQ3Az0WTZw1sFe+QDb0aXCerigEpw418pw1HBUKFtnQHWzwojaukAs2X/c9DQz4MQ4bsXTGlcpGxU/RCIw=="],
-
-    "@vue/runtime-dom": ["@vue/runtime-dom@3.5.13", "", { "dependencies": { "@vue/reactivity": "3.5.13", "@vue/runtime-core": "3.5.13", "@vue/shared": "3.5.13", "csstype": "^3.1.3" } }, "sha512-dLaj94s93NYLqjLiyFzVs9X6dWhTdAlEAciC3Moq7gzAc13VJUdCnjjRurNM6uTLFATRHexHCTu/Xp3eW6yoog=="],
-
-    "@vue/server-renderer": ["@vue/server-renderer@3.5.13", "", { "dependencies": { "@vue/compiler-ssr": "3.5.13", "@vue/shared": "3.5.13" }, "peerDependencies": { "vue": "3.5.13" } }, "sha512-wAi4IRJV/2SAW3htkTlB+dHeRmpTiVIK1OGLWV1yeStVSebSQQOwGwIq0D3ZIoBj2C2qpgz5+vX9iEBkTdk5YA=="],
-
-    "@vue/shared": ["@vue/shared@3.5.13", "", {}, "sha512-/hnE/qP5ZoGpol0a5mDi45bOd7t3tjYJBjsgCsivow7D48cJeV5l05RD82lPqi7gRiphZM37rnhW1l6ZoCNNnQ=="],
-
-    "@vue/tsconfig": ["@vue/tsconfig@0.7.0", "", { "peerDependencies": { "typescript": "5.x", "vue": "^3.4.0" }, "optionalPeers": ["typescript", "vue"] }, "sha512-ku2uNz5MaZ9IerPPUyOHzyjhXoX2kVJaVf7hL315DC17vS6IiZRmmCPfggNbU16QTvM80+uYYy3eYJB59WCtvg=="],
-
-    "alien-signals": ["alien-signals@1.0.4", "", {}, "sha512-DJqqQD3XcsaQcQ1s+iE2jDUZmmQpXwHiR6fCAim/w87luaW+vmLY8fMlrdkmRwzaFXhkxf3rqPCR59tKVv1MDw=="],
-
-    "ansi-styles": ["ansi-styles@6.2.1", "", {}, "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug=="],
-
-    "autoprefixer": ["autoprefixer@10.4.20", "", { "dependencies": { "browserslist": "^4.23.3", "caniuse-lite": "^1.0.30001646", "fraction.js": "^4.3.7", "normalize-range": "^0.1.2", "picocolors": "^1.0.1", "postcss-value-parser": "^4.2.0" }, "peerDependencies": { "postcss": "^8.1.0" }, "bin": { "autoprefixer": "bin/autoprefixer" } }, "sha512-XY25y5xSv/wEoqzDyXXME4AFfkZI0P23z6Fs3YgymDnKJkCGOnkL0iTxCa85UTqaSgfcqyf3UA6+c7wUvx/16g=="],
-
-    "balanced-match": ["balanced-match@1.0.2", "", {}, "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw=="],
-
-    "birpc": ["birpc@0.2.19", "", {}, "sha512-5WeXXAvTmitV1RqJFppT5QtUiz2p1mRSYU000Jkft5ZUCLJIk4uQriYNO50HknxKwM6jd8utNc66K1qGIwwWBQ=="],
-
-    "brace-expansion": ["brace-expansion@2.0.1", "", { "dependencies": { "balanced-match": "^1.0.0" } }, "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA=="],
-
-    "browserslist": ["browserslist@4.24.4", "", { "dependencies": { "caniuse-lite": "^1.0.30001688", "electron-to-chromium": "^1.5.73", "node-releases": "^2.0.19", "update-browserslist-db": "^1.1.1" }, "bin": { "browserslist": "cli.js" } }, "sha512-KDi1Ny1gSePi1vm0q4oxSF8b4DR44GF4BbmS2YdhPLOEqd8pDviZOGH/GsmRwoWJ2+5Lr085X7naowMwKHDG1A=="],
-
-    "bun-plugin-tailwind": ["bun-plugin-tailwind@0.0.15", "", { "peerDependencies": { "typescript": "^5.0.0" } }, "sha512-qtAXMNGG4R0UGGI8zWrqm2B7BdXqx48vunJXBPzfDOHPA5WkRUZdTSbE7TFwO4jLhYqSE23YMWsM9NhE6ovobw=="],
-
-    "bun-types": ["bun-types@1.2.5", "", { "dependencies": { "@types/node": "*", "@types/ws": "~8.5.10" } }, "sha512-3oO6LVGGRRKI4kHINx5PIdIgnLRb7l/SprhzqXapmoYkFl5m4j6EvALvbDVuuBFaamB46Ap6HCUxIXNLCGy+tg=="],
-
-    "bundle-name": ["bundle-name@4.1.0", "", { "dependencies": { "run-applescript": "^7.0.0" } }, "sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q=="],
-
-    "caniuse-lite": ["caniuse-lite@1.0.30001702", "", {}, "sha512-LoPe/D7zioC0REI5W73PeR1e1MLCipRGq/VkovJnd6Df+QVqT+vT33OXCp8QUd7kA7RZrHWxb1B36OQKI/0gOA=="],
-
-    "convert-source-map": ["convert-source-map@2.0.0", "", {}, "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg=="],
-
-    "copy-anything": ["copy-anything@3.0.5", "", { "dependencies": { "is-what": "^4.1.8" } }, "sha512-yCEafptTtb4bk7GLEQoM8KVJpxAfdBJYaXyzQEgQQQgYrZiDp8SJmGKlYza6CYjEDNstAdNdKA3UuoULlEbS6w=="],
-
-    "cross-spawn": ["cross-spawn@7.0.6", "", { "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", "which": "^2.0.1" } }, "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA=="],
-
-    "csstype": ["csstype@3.1.3", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],
-
-    "daisyui": ["daisyui@5.0.0", "", {}, "sha512-U0K9Bac3Bi3zZGm6ojrw12F0vBHTpEgf46zv/BYxLe07hF0Xnx7emIQliwaRBgJuYhY0BhwQ6wSnq5cJXHA2yA=="],
-
-    "de-indent": ["de-indent@1.0.2", "", {}, "sha512-e/1zu3xH5MQryN2zdVaF0OrdNLUbvWxzMbi+iNA6Bky7l1RoP8a2fIbRocyHclXt/arDrrR6lL3TqFD9pMQTsg=="],
-
-    "debug": ["debug@4.4.0", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA=="],
-
-    "default-browser": ["default-browser@5.2.1", "", { "dependencies": { "bundle-name": "^4.1.0", "default-browser-id": "^5.0.0" } }, "sha512-WY/3TUME0x3KPYdRRxEJJvXRHV4PyPoUsxtZa78lwItwRQRHhd2U9xOscaT/YTf8uCXIAjeJOFBVEh/7FtD8Xg=="],
-
-    "default-browser-id": ["default-browser-id@5.0.0", "", {}, "sha512-A6p/pu/6fyBcA1TRz/GqWYPViplrftcW2gZC9q79ngNCKAeR/X3gcEdXQHl4KNXV+3wgIJ1CPkJQ3IHM6lcsyA=="],
-
-    "define-lazy-prop": ["define-lazy-prop@3.0.0", "", {}, "sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg=="],
-
-    "detect-libc": ["detect-libc@2.0.3", "", {}, "sha512-bwy0MGW55bG41VqxxypOsdSdGqLwXPI/focwgTYCFMbdUiBAxLg9CFzG08sz2aqzknwiX7Hkl0bQENjg8iLByw=="],
-
-    "electron-to-chromium": ["electron-to-chromium@1.5.113", "", {}, "sha512-wjT2O4hX+wdWPJ76gWSkMhcHAV2PTMX+QetUCPYEdCIe+cxmgzzSSiGRCKW8nuh4mwKZlpv0xvoW7OF2X+wmHg=="],
-
-    "enhanced-resolve": ["enhanced-resolve@5.18.1", "", { "dependencies": { "graceful-fs": "^4.2.4", "tapable": "^2.2.0" } }, "sha512-ZSW3ma5GkcQBIpwZTSRAI8N71Uuwgs93IezB7mf7R60tC8ZbJideoDNKjHn2O9KIlx6rkGTTEk1xUCK2E1Y2Yg=="],
-
-    "entities": ["entities@4.5.0", "", {}, "sha512-V0hjH4dGPh9Ao5p0MoRY6BVqtwCjhz6vI5LT8AJ55H+4g9/4vbHx1I54fS0XuclLhDHArPQCiMjDxjaL8fPxhw=="],
-
-    "error-stack-parser-es": ["error-stack-parser-es@0.1.5", "", {}, "sha512-xHku1X40RO+fO8yJ8Wh2f2rZWVjqyhb1zgq1yZ8aZRQkv6OOKhKWRUaht3eSCUbAOBaKIgM+ykwFLE+QUxgGeg=="],
-
-    "esbuild": ["esbuild@0.25.0", "", { "optionalDependencies": { "@esbuild/aix-ppc64": "0.25.0", "@esbuild/android-arm": "0.25.0", "@esbuild/android-arm64": "0.25.0", "@esbuild/android-x64": "0.25.0", "@esbuild/darwin-arm64": "0.25.0", "@esbuild/darwin-x64": "0.25.0", "@esbuild/freebsd-arm64": "0.25.0", "@esbuild/freebsd-x64": "0.25.0", "@esbuild/linux-arm": "0.25.0", "@esbuild/linux-arm64": "0.25.0", "@esbuild/linux-ia32": "0.25.0", "@esbuild/linux-loong64": "0.25.0", "@esbuild/linux-mips64el": "0.25.0", "@esbuild/linux-ppc64": "0.25.0", "@esbuild/linux-riscv64": "0.25.0", "@esbuild/linux-s390x": "0.25.0", "@esbuild/linux-x64": "0.25.0", "@esbuild/netbsd-arm64": "0.25.0", "@esbuild/netbsd-x64": "0.25.0", "@esbuild/openbsd-arm64": "0.25.0", "@esbuild/openbsd-x64": "0.25.0", "@esbuild/sunos-x64": "0.25.0", "@esbuild/win32-arm64": "0.25.0", "@esbuild/win32-ia32": "0.25.0", "@esbuild/win32-x64": "0.25.0" }, "bin": { "esbuild": "bin/esbuild" } }, "sha512-BXq5mqc8ltbaN34cDqWuYKyNhX8D/Z0J1xdtdQ8UcIIIyJyz+ZMKUt58tF3SrZ85jcfN/PZYhjR5uDQAYNVbuw=="],
-
-    "escalade": ["escalade@3.2.0", "", {}, "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA=="],
-
-    "estree-walker": ["estree-walker@2.0.2", "", {}, "sha512-Rfkk/Mp/DL7JVje3u18FxFujQlTNR2q6QfMSMB7AvCBx91NGj/ba3kCfza0f6dVDbw7YlRf/nDrn7pQrCCyQ/w=="],
-
-    "execa": ["execa@9.5.2", "", { "dependencies": { "@sindresorhus/merge-streams": "^4.0.0", "cross-spawn": "^7.0.3", "figures": "^6.1.0", "get-stream": "^9.0.0", "human-signals": "^8.0.0", "is-plain-obj": "^4.1.0", "is-stream": "^4.0.1", "npm-run-path": "^6.0.0", "pretty-ms": "^9.0.0", "signal-exit": "^4.1.0", "strip-final-newline": "^4.0.0", "yoctocolors": "^2.0.0" } }, "sha512-EHlpxMCpHWSAh1dgS6bVeoLAXGnJNdR93aabr4QCGbzOM73o5XmRfM/e5FUqsw3aagP8S8XEWUWFAxnRBnAF0Q=="],
-
-    "figures": ["figures@6.1.0", "", { "dependencies": { "is-unicode-supported": "^2.0.0" } }, "sha512-d+l3qxjSesT4V7v2fh+QnmFnUWv9lSpjarhShNTgBOfA0ttejbQUAlHLitbjkoRiDulW0OPoQPYIGhIC8ohejg=="],
-
-    "fraction.js": ["fraction.js@4.3.7", "", {}, "sha512-ZsDfxO51wGAXREY55a7la9LScWpwv9RxIrYABrlvOFBlH/ShPnrtsXeuUIfXKKOVicNxQ+o8JTbJvjS4M89yew=="],
-
-    "fs-extra": ["fs-extra@11.3.0", "", { "dependencies": { "graceful-fs": "^4.2.0", "jsonfile": "^6.0.1", "universalify": "^2.0.0" } }, "sha512-Z4XaCL6dUDHfP/jT25jJKMmtxvuwbkrD1vNSMFlo9lNLY2c5FHYSQgHPRZUjAB26TpDEoW9HCOgplrdbaPV/ew=="],
-
-    "fsevents": ["fsevents@2.3.3", "", { "os": "darwin" }, "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw=="],
-
-    "gensync": ["gensync@1.0.0-beta.2", "", {}, "sha512-3hN7NaskYvMDLQY55gnW3NQ+mesEAepTqlg+VEbj7zzqEMBVNhzcGYYeqFo/TlYz6eQiFcp1HcsCZO+nGgS8zg=="],
-
-    "get-stream": ["get-stream@9.0.1", "", { "dependencies": { "@sec-ant/readable-stream": "^0.4.1", "is-stream": "^4.0.1" } }, "sha512-kVCxPF3vQM/N0B1PmoqVUqgHP+EeVjmZSQn+1oCRPxd2P21P2F19lIgbR3HBosbB1PUhOAoctJnfEn2GbN2eZA=="],
-
-    "globals": ["globals@11.12.0", "", {}, "sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA=="],
-
-    "graceful-fs": ["graceful-fs@4.2.11", "", {}, "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ=="],
-
-    "he": ["he@1.2.0", "", { "bin": { "he": "bin/he" } }, "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw=="],
-
-    "hookable": ["hookable@5.5.3", "", {}, "sha512-Yc+BQe8SvoXH1643Qez1zqLRmbA5rCL+sSmk6TVos0LWVfNIB7PGncdlId77WzLGSIB5KaWgTaNTs2lNVEI6VQ=="],
-
-    "human-signals": ["human-signals@8.0.0", "", {}, "sha512-/1/GPCpDUCCYwlERiYjxoczfP0zfvZMU/OWgQPMya9AbAE24vseigFdhAMObpc8Q4lc/kjutPfUddDYyAmejnA=="],
-
-    "is-docker": ["is-docker@3.0.0", "", { "bin": { "is-docker": "cli.js" } }, "sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ=="],
-
-    "is-inside-container": ["is-inside-container@1.0.0", "", { "dependencies": { "is-docker": "^3.0.0" }, "bin": { "is-inside-container": "cli.js" } }, "sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA=="],
-
-    "is-plain-obj": ["is-plain-obj@4.1.0", "", {}, "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg=="],
-
-    "is-stream": ["is-stream@4.0.1", "", {}, "sha512-Dnz92NInDqYckGEUJv689RbRiTSEHCQ7wOVeALbkOz999YpqT46yMRIGtSNl2iCL1waAZSx40+h59NV/EwzV/A=="],
-
-    "is-unicode-supported": ["is-unicode-supported@2.1.0", "", {}, "sha512-mE00Gnza5EEB3Ds0HfMyllZzbBrmLOX3vfWoj9A9PEnTfratQ/BcaJOuMhnkhjXvb2+FkY3VuHqtAGpTPmglFQ=="],
-
-    "is-what": ["is-what@4.1.16", "", {}, "sha512-ZhMwEosbFJkA0YhFnNDgTM4ZxDRsS6HqTo7qsZM08fehyRYIYa0yHu5R6mgo1n/8MgaPBXiPimPD77baVFYg+A=="],
-
-    "is-wsl": ["is-wsl@3.1.0", "", { "dependencies": { "is-inside-container": "^1.0.0" } }, "sha512-UcVfVfaK4Sc4m7X3dUSoHoozQGBEFeDC+zVo06t98xe8CzHSZZBekNXH+tu0NalHolcJ/QAGqS46Hef7QXBIMw=="],
-
-    "isexe": ["isexe@3.1.1", "", {}, "sha512-LpB/54B+/2J5hqQ7imZHfdU31OlgQqx7ZicVlkm9kzg9/w8GKLEcFfJl/t7DCEDueOyBAD6zCCwTO6Fzs0NoEQ=="],
-
-    "jiti": ["jiti@2.4.2", "", { "bin": { "jiti": "lib/jiti-cli.mjs" } }, "sha512-rg9zJN+G4n2nfJl5MW3BMygZX56zKPNVEYYqq7adpmMh4Jn2QNEwhvQlFy6jPVdcod7txZtKHWnyZiA3a0zP7A=="],
-
-    "js-tokens": ["js-tokens@4.0.0", "", {}, "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ=="],
-
-    "jsesc": ["jsesc@3.1.0", "", { "bin": { "jsesc": "bin/jsesc" } }, "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA=="],
-
-    "json-parse-even-better-errors": ["json-parse-even-better-errors@4.0.0", "", {}, "sha512-lR4MXjGNgkJc7tkQ97kb2nuEMnNCyU//XYVH0MKTGcXEiSudQ5MKGKen3C5QubYy0vmq+JGitUg92uuywGEwIA=="],
-
-    "json5": ["json5@2.2.3", "", { "bin": { "json5": "lib/cli.js" } }, "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg=="],
-
-    "jsonfile": ["jsonfile@6.1.0", "", { "dependencies": { "universalify": "^2.0.0" }, "optionalDependencies": { "graceful-fs": "^4.1.6" } }, "sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ=="],
-
-    "kolorist": ["kolorist@1.8.0", "", {}, "sha512-Y+60/zizpJ3HRH8DCss+q95yr6145JXZo46OTpFvDZWLfRCE4qChOyk1b26nMaNpfHHgxagk9dXT5OP0Tfe+dQ=="],
-
-    "lightningcss": ["lightningcss@1.29.2", "", { "dependencies": { "detect-libc": "^2.0.3" }, "optionalDependencies": { "lightningcss-darwin-arm64": "1.29.2", "lightningcss-darwin-x64": "1.29.2", "lightningcss-freebsd-x64": "1.29.2", "lightningcss-linux-arm-gnueabihf": "1.29.2", "lightningcss-linux-arm64-gnu": "1.29.2", "lightningcss-linux-arm64-musl": "1.29.2", "lightningcss-linux-x64-gnu": "1.29.2", "lightningcss-linux-x64-musl": "1.29.2", "lightningcss-win32-arm64-msvc": "1.29.2", "lightningcss-win32-x64-msvc": "1.29.2" } }, "sha512-6b6gd/RUXKaw5keVdSEtqFVdzWnU5jMxTUjA2bVcMNPLwSQ08Sv/UodBVtETLCn7k4S1Ibxwh7k68IwLZPgKaA=="],
-
-    "lightningcss-darwin-arm64": ["lightningcss-darwin-arm64@1.29.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-cK/eMabSViKn/PG8U/a7aCorpeKLMlK0bQeNHmdb7qUnBkNPnL+oV5DjJUo0kqWsJUapZsM4jCfYItbqBDvlcA=="],
-
-    "lightningcss-darwin-x64": ["lightningcss-darwin-x64@1.29.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-j5qYxamyQw4kDXX5hnnCKMf3mLlHvG44f24Qyi2965/Ycz829MYqjrVg2H8BidybHBp9kom4D7DR5VqCKDXS0w=="],
-
-    "lightningcss-freebsd-x64": ["lightningcss-freebsd-x64@1.29.2", "", { "os": "freebsd", "cpu": "x64" }, "sha512-wDk7M2tM78Ii8ek9YjnY8MjV5f5JN2qNVO+/0BAGZRvXKtQrBC4/cn4ssQIpKIPP44YXw6gFdpUF+Ps+RGsCwg=="],
-
-    "lightningcss-linux-arm-gnueabihf": ["lightningcss-linux-arm-gnueabihf@1.29.2", "", { "os": "linux", "cpu": "arm" }, "sha512-IRUrOrAF2Z+KExdExe3Rz7NSTuuJ2HvCGlMKoquK5pjvo2JY4Rybr+NrKnq0U0hZnx5AnGsuFHjGnNT14w26sg=="],
-
-    "lightningcss-linux-arm64-gnu": ["lightningcss-linux-arm64-gnu@1.29.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-KKCpOlmhdjvUTX/mBuaKemp0oeDIBBLFiU5Fnqxh1/DZ4JPZi4evEH7TKoSBFOSOV3J7iEmmBaw/8dpiUvRKlQ=="],
-
-    "lightningcss-linux-arm64-musl": ["lightningcss-linux-arm64-musl@1.29.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-Q64eM1bPlOOUgxFmoPUefqzY1yV3ctFPE6d/Vt7WzLW4rKTv7MyYNky+FWxRpLkNASTnKQUaiMJ87zNODIrrKQ=="],
-
-    "lightningcss-linux-x64-gnu": ["lightningcss-linux-x64-gnu@1.29.2", "", { "os": "linux", "cpu": "x64" }, "sha512-0v6idDCPG6epLXtBH/RPkHvYx74CVziHo6TMYga8O2EiQApnUPZsbR9nFNrg2cgBzk1AYqEd95TlrsL7nYABQg=="],
-
-    "lightningcss-linux-x64-musl": ["lightningcss-linux-x64-musl@1.29.2", "", { "os": "linux", "cpu": "x64" }, "sha512-rMpz2yawkgGT8RULc5S4WiZopVMOFWjiItBT7aSfDX4NQav6M44rhn5hjtkKzB+wMTRlLLqxkeYEtQ3dd9696w=="],
-
-    "lightningcss-win32-arm64-msvc": ["lightningcss-win32-arm64-msvc@1.29.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-nL7zRW6evGQqYVu/bKGK+zShyz8OVzsCotFgc7judbt6wnB2KbiKKJwBE4SGoDBQ1O94RjW4asrCjQL4i8Fhbw=="],
-
-    "lightningcss-win32-x64-msvc": ["lightningcss-win32-x64-msvc@1.29.2", "", { "os": "win32", "cpu": "x64" }, "sha512-EdIUW3B2vLuHmv7urfzMI/h2fmlnOQBk1xlsDxkN1tCWKjNFjfLhGxYk8C8mzpSfr+A6jFFIi8fU6LbQGsRWjA=="],
-
-    "lodash": ["lodash@4.17.21", "", {}, "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg=="],
-
-    "log-symbols": ["log-symbols@7.0.0", "", { "dependencies": { "is-unicode-supported": "^2.0.0", "yoctocolors": "^2.1.1" } }, "sha512-zrc91EDk2M+2AXo/9BTvK91pqb7qrPg2nX/Hy+u8a5qQlbaOflCKO+6SqgZ+M+xUFxGdKTgwnGiL96b1W3ikRA=="],
-
-    "lru-cache": ["lru-cache@5.1.1", "", { "dependencies": { "yallist": "^3.0.2" } }, "sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w=="],
-
-    "magic-string": ["magic-string@0.30.17", "", { "dependencies": { "@jridgewell/sourcemap-codec": "^1.5.0" } }, "sha512-sNPKHvyjVf7gyjwS4xGTaW/mCnF8wnjtifKBEhxfZ7E/S8tQ0rssrwGNn6q8JH/ohItJfSQp9mBtQYuTlH5QnA=="],
-
-    "memorystream": ["memorystream@0.3.1", "", {}, "sha512-S3UwM3yj5mtUSEfP41UZmt/0SCoVYUcU1rkXv+BQ5Ig8ndL4sPoJNBUJERafdPb5jjHJGuMgytgKvKIf58XNBw=="],
-
-    "minimatch": ["minimatch@9.0.5", "", { "dependencies": { "brace-expansion": "^2.0.1" } }, "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow=="],
-
-    "mitt": ["mitt@3.0.1", "", {}, "sha512-vKivATfr97l2/QBCYAkXYDbrIWPM2IIKEl7YPhjCvKlG3kE2gm+uBo6nEXK3M5/Ffh/FLpKExzOQ3JJoJGFKBw=="],
-
-    "mrmime": ["mrmime@2.0.1", "", {}, "sha512-Y3wQdFg2Va6etvQ5I82yUhGdsKrcYox6p7FfL1LbK2J4V01F9TGlepTIhnK24t7koZibmg82KGglhA1XK5IsLQ=="],
-
-    "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
-
-    "muggle-string": ["muggle-string@0.4.1", "", {}, "sha512-VNTrAak/KhO2i8dqqnqnAHOa3cYBwXEZe9h+D5h/1ZqFSTEFHdM65lR7RoIqq3tBBYavsOXV84NoHXZ0AkPyqQ=="],
-
-    "nanoid": ["nanoid@3.3.9", "", { "bin": { "nanoid": "bin/nanoid.cjs" } }, "sha512-SppoicMGpZvbF1l3z4x7No3OlIjP7QJvC9XR7AhZr1kL133KHnKPztkKDc+Ir4aJ/1VhTySrtKhrsycmrMQfvg=="],
-
-    "node-releases": ["node-releases@2.0.19", "", {}, "sha512-xxOWJsBKtzAq7DY0J+DTzuz58K8e7sJbdgwkbMWQe8UYB6ekmsQ45q0M/tJDsGaZmbC+l7n57UV8Hl5tHxO9uw=="],
-
-    "normalize-range": ["normalize-range@0.1.2", "", {}, "sha512-bdok/XvKII3nUpklnV6P2hxtMNrCboOjAcyBuQnWEhO665FwrSNRxU+AqpsyvO6LgGYPspN+lu5CLtw4jPRKNA=="],
-
-    "npm-normalize-package-bin": ["npm-normalize-package-bin@4.0.0", "", {}, "sha512-TZKxPvItzai9kN9H/TkmCtx/ZN/hvr3vUycjlfmH0ootY9yFBzNOpiXAdIn1Iteqsvk4lQn6B5PTrt+n6h8k/w=="],
-
-    "npm-run-all2": ["npm-run-all2@7.0.2", "", { "dependencies": { "ansi-styles": "^6.2.1", "cross-spawn": "^7.0.6", "memorystream": "^0.3.1", "minimatch": "^9.0.0", "pidtree": "^0.6.0", "read-package-json-fast": "^4.0.0", "shell-quote": "^1.7.3", "which": "^5.0.0" }, "bin": { "run-p": "bin/run-p/index.js", "run-s": "bin/run-s/index.js", "npm-run-all": "bin/npm-run-all/index.js", "npm-run-all2": "bin/npm-run-all/index.js" } }, "sha512-7tXR+r9hzRNOPNTvXegM+QzCuMjzUIIq66VDunL6j60O4RrExx32XUhlrS7UK4VcdGw5/Wxzb3kfNcFix9JKDA=="],
-
-    "npm-run-path": ["npm-run-path@6.0.0", "", { "dependencies": { "path-key": "^4.0.0", "unicorn-magic": "^0.3.0" } }, "sha512-9qny7Z9DsQU8Ou39ERsPU4OZQlSTP47ShQzuKZ6PRXpYLtIFgl/DEBYEXKlvcEa+9tHVcK8CF81Y2V72qaZhWA=="],
-
-    "open": ["open@10.1.0", "", { "dependencies": { "default-browser": "^5.2.1", "define-lazy-prop": "^3.0.0", "is-inside-container": "^1.0.0", "is-wsl": "^3.1.0" } }, "sha512-mnkeQ1qP5Ue2wd+aivTD3NHd/lZ96Lu0jgf0pwktLPtx6cTZiH7tyeGRRHs0zX0rbrahXPnXlUnbeXyaBBuIaw=="],
-
-    "parse-ms": ["parse-ms@4.0.0", "", {}, "sha512-TXfryirbmq34y8QBwgqCVLi+8oA3oWx2eAnSn62ITyEhEYaWRlVZ2DvMM9eZbMs/RfxPu/PK/aBLyGj4IrqMHw=="],
-
-    "path-browserify": ["path-browserify@1.0.1", "", {}, "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g=="],
-
-    "path-key": ["path-key@3.1.1", "", {}, "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q=="],
-
-    "pathe": ["pathe@2.0.3", "", {}, "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w=="],
-
-    "perfect-debounce": ["perfect-debounce@1.0.0", "", {}, "sha512-xCy9V055GLEqoFaHoC1SoLIaLmWctgCUaBaWxDZ7/Zx4CTyX7cJQLJOok/orfjZAh9kEYpjJa4d0KcJmCbctZA=="],
-
-    "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="],
-
-    "picomatch": ["picomatch@4.0.2", "", {}, "sha512-M7BAV6Rlcy5u+m6oPhAPFgJTzAioX/6B0DxyvDlo9l8+T3nLKbrczg2WLUyzd45L8RqfUMyGPzekbMvX2Ldkwg=="],
-
-    "pidtree": ["pidtree@0.6.0", "", { "bin": { "pidtree": "bin/pidtree.js" } }, "sha512-eG2dWTVw5bzqGRztnHExczNxt5VGsE6OwTeCG3fdUf9KBsZzO3R5OIIIzWR+iZA0NtZ+RDVdaoE2dK1cn6jH4g=="],
-
-    "pinia": ["pinia@3.0.1", "", { "dependencies": { "@vue/devtools-api": "^7.7.2" }, "peerDependencies": { "typescript": ">=4.4.4", "vue": "^2.7.0 || ^3.5.11" }, "optionalPeers": ["typescript"] }, "sha512-WXglsDzztOTH6IfcJ99ltYZin2mY8XZCXujkYWVIJlBjqsP6ST7zw+Aarh63E1cDVYeyUcPCxPHzJpEOmzB6Wg=="],
-
-    "postcss": ["postcss@8.5.3", "", { "dependencies": { "nanoid": "^3.3.8", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-dle9A3yYxlBSrt8Fu+IpjGT8SY8hN0mlaA6GY8t0P5PjIOZemULz/E2Bnm/2dcUOena75OTNkHI76uZBNUUq3A=="],
-
-    "postcss-value-parser": ["postcss-value-parser@4.2.0", "", {}, "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ=="],
-
-    "pretty-ms": ["pretty-ms@9.2.0", "", { "dependencies": { "parse-ms": "^4.0.0" } }, "sha512-4yf0QO/sllf/1zbZWYnvWw3NxCQwLXKzIj0G849LSufP15BXKM0rbD2Z3wVnkMfjdn/CB0Dpp444gYAACdsplg=="],
-
-    "read-package-json-fast": ["read-package-json-fast@4.0.0", "", { "dependencies": { "json-parse-even-better-errors": "^4.0.0", "npm-normalize-package-bin": "^4.0.0" } }, "sha512-qpt8EwugBWDw2cgE2W+/3oxC+KTez2uSVR8JU9Q36TXPAGCaozfQUs59v4j4GFpWTaw0i6hAZSvOmu1J0uOEUg=="],
-
-    "rfdc": ["rfdc@1.4.1", "", {}, "sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA=="],
-
-    "rollup": ["rollup@4.34.9", "", { "dependencies": { "@types/estree": "1.0.6" }, "optionalDependencies": { "@rollup/rollup-android-arm-eabi": "4.34.9", "@rollup/rollup-android-arm64": "4.34.9", "@rollup/rollup-darwin-arm64": "4.34.9", "@rollup/rollup-darwin-x64": "4.34.9", "@rollup/rollup-freebsd-arm64": "4.34.9", "@rollup/rollup-freebsd-x64": "4.34.9", "@rollup/rollup-linux-arm-gnueabihf": "4.34.9", "@rollup/rollup-linux-arm-musleabihf": "4.34.9", "@rollup/rollup-linux-arm64-gnu": "4.34.9", "@rollup/rollup-linux-arm64-musl": "4.34.9", "@rollup/rollup-linux-loongarch64-gnu": "4.34.9", "@rollup/rollup-linux-powerpc64le-gnu": "4.34.9", "@rollup/rollup-linux-riscv64-gnu": "4.34.9", "@rollup/rollup-linux-s390x-gnu": "4.34.9", "@rollup/rollup-linux-x64-gnu": "4.34.9", "@rollup/rollup-linux-x64-musl": "4.34.9", "@rollup/rollup-win32-arm64-msvc": "4.34.9", "@rollup/rollup-win32-ia32-msvc": "4.34.9", "@rollup/rollup-win32-x64-msvc": "4.34.9", "fsevents": "~2.3.2" }, "bin": { "rollup": "dist/bin/rollup" } }, "sha512-nF5XYqWWp9hx/LrpC8sZvvvmq0TeTjQgaZHYmAgwysT9nh8sWnZhBnM8ZyVbbJFIQBLwHDNoMqsBZBbUo4U8sQ=="],
-
-    "run-applescript": ["run-applescript@7.0.0", "", {}, "sha512-9by4Ij99JUr/MCFBUkDKLWK3G9HVXmabKz9U5MlIAIuvuzkiOicRYs8XJLxX+xahD+mLiiCYDqF9dKAgtzKP1A=="],
-
-    "semver": ["semver@6.3.1", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA=="],
-
-    "shebang-command": ["shebang-command@2.0.0", "", { "dependencies": { "shebang-regex": "^3.0.0" } }, "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA=="],
-
-    "shebang-regex": ["shebang-regex@3.0.0", "", {}, "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A=="],
-
-    "shell-quote": ["shell-quote@1.8.2", "", {}, "sha512-AzqKpGKjrj7EM6rKVQEPpB288oCfnrEIuyoT9cyF4nmGa7V8Zk6f7RRqYisX8X9m+Q7bd632aZW4ky7EhbQztA=="],
-
-    "signal-exit": ["signal-exit@4.1.0", "", {}, "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw=="],
-
-    "sirv": ["sirv@3.0.1", "", { "dependencies": { "@polka/url": "^1.0.0-next.24", "mrmime": "^2.0.0", "totalist": "^3.0.0" } }, "sha512-FoqMu0NCGBLCcAkS1qA+XJIQTR6/JHfQXl+uGteNCQ76T91DMUjPa9xfmeqMY3z80nLSg9yQmNjK0Px6RWsH/A=="],
-
-    "source-map-js": ["source-map-js@1.2.1", "", {}, "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA=="],
-
-    "speakingurl": ["speakingurl@14.0.1", "", {}, "sha512-1POYv7uv2gXoyGFpBCmpDVSNV74IfsWlDW216UPjbWufNf+bSU6GdbDsxdcxtfwb4xlI3yxzOTKClUosxARYrQ=="],
-
-    "strip-final-newline": ["strip-final-newline@4.0.0", "", {}, "sha512-aulFJcD6YK8V1G7iRB5tigAP4TsHBZZrOV8pjV++zdUwmeV8uzbY7yn6h9MswN62adStNZFuCIx4haBnRuMDaw=="],
-
-    "superjson": ["superjson@2.2.2", "", { "dependencies": { "copy-anything": "^3.0.2" } }, "sha512-5JRxVqC8I8NuOUjzBbvVJAKNM8qoVuH0O77h4WInc/qC2q5IreqKxYwgkga3PfA22OayK2ikceb/B26dztPl+Q=="],
-
-    "tailwindcss": ["tailwindcss@4.0.12", "", {}, "sha512-bT0hJo91FtncsAMSsMzUkoo/iEU0Xs5xgFgVC9XmdM9bw5MhZuQFjPNl6wxAE0SiQF/YTZJa+PndGWYSDtuxAg=="],
-
-    "tapable": ["tapable@2.2.1", "", {}, "sha512-GNzQvQTOIP6RyTfE2Qxb8ZVlNmw0n88vp1szwWRimP02mnTsx3Wtn5qRdqY9w2XduFNUgvOwhNnQsjwCp+kqaQ=="],
-
-    "tinypool": ["tinypool@1.0.2", "", {}, "sha512-al6n+QEANGFOMf/dmUMsuS5/r9B06uwlyNjZZql/zv8J7ybHCgoihBNORZCY2mzUuAnomQa2JdhyHKzZxPCrFA=="],
-
-    "totalist": ["totalist@3.0.1", "", {}, "sha512-sf4i37nQ2LBx4m3wB74y+ubopq6W/dIzXg0FDGjsYnZHVa1Da8FH853wlL2gtUhg+xJXjfk3kUZS3BRoQeoQBQ=="],
-
-    "trpc-bun-adapter": ["trpc-bun-adapter@1.2.2", "", { "peerDependencies": { "@trpc/server": "^11.0.0-rc.566" } }, "sha512-TVhZEDXZvhIM2lfNTVCx9u5fu7/86b7RuhQSM0CUs4vlIan64Sfko5m0stbjqSHNgvLBsvXKtUD8FeQOQGLfpg=="],
-
-    "ts-log": ["ts-log@2.2.7", "", {}, "sha512-320x5Ggei84AxzlXp91QkIGSw5wgaLT6GeAH0KsqDmRZdVWW2OiSeVvElVoatk3f7nicwXlElXsoFkARiGE2yg=="],
-
-    "ts-results-es": ["ts-results-es@5.0.1", "", {}, "sha512-HjX/7HxQe2bXkbp8pHTjy4Ir9eHIDnDDsLDphhGqy6I9iZ/vD4QXWEIlrVRZsEX+kS2jIiiF/mnl0nKnPTiYFw=="],
-
-    "typescript": ["typescript@5.7.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-84MVSjMEHP+FQRPy3pX9sTVV/INIex71s9TL2Gm5FG/WG1SqXeKyZ0k7/blY/4FdOzI12CBy1vGc4og/eus0fw=="],
-
-    "undici-types": ["undici-types@6.20.0", "", {}, "sha512-Ny6QZ2Nju20vw1SRHe3d9jVu6gJ+4e3+MMpqu7pqE5HT6WsTSlce++GQmK5UXS8mzV8DSYHrQH+Xrf2jVcuKNg=="],
-
-    "unicorn-magic": ["unicorn-magic@0.3.0", "", {}, "sha512-+QBBXBCvifc56fsbuxZQ6Sic3wqqc3WWaqxs58gvJrcOuN83HGTCwz3oS5phzU9LthRNE9VrJCFCLUgHeeFnfA=="],
-
-    "universalify": ["universalify@2.0.1", "", {}, "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw=="],
-
-    "update-browserslist-db": ["update-browserslist-db@1.1.3", "", { "dependencies": { "escalade": "^3.2.0", "picocolors": "^1.1.1" }, "peerDependencies": { "browserslist": ">= 4.21.0" }, "bin": { "update-browserslist-db": "cli.js" } }, "sha512-UxhIZQ+QInVdunkDAaiazvvT/+fXL5Osr0JZlJulepYu6Jd7qJtDZjlur0emRlT71EN3ScPoE7gvsuIKKNavKw=="],
-
-    "vite": ["vite@6.2.1", "", { "dependencies": { "esbuild": "^0.25.0", "postcss": "^8.5.3", "rollup": "^4.30.1" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "peerDependencies": { "@types/node": "^18.0.0 || ^20.0.0 || >=22.0.0", "jiti": ">=1.21.0", "less": "*", "lightningcss": "^1.21.0", "sass": "*", "sass-embedded": "*", "stylus": "*", "sugarss": "*", "terser": "^5.16.0", "tsx": "^4.8.1", "yaml": "^2.4.2" }, "optionalPeers": ["@types/node", "jiti", "less", "lightningcss", "sass", "sass-embedded", "stylus", "sugarss", "terser", "tsx", "yaml"], "bin": { "vite": "bin/vite.js" } }, "sha512-n2GnqDb6XPhlt9B8olZPrgMD/es/Nd1RdChF6CBD/fHW6pUyUTt2sQW2fPRX5GiD9XEa6+8A6A4f2vT6pSsE7Q=="],
-
-    "vite-hot-client": ["vite-hot-client@0.2.4", "", { "peerDependencies": { "vite": "^2.6.0 || ^3.0.0 || ^4.0.0 || ^5.0.0-0 || ^6.0.0-0" } }, "sha512-a1nzURqO7DDmnXqabFOliz908FRmIppkBKsJthS8rbe8hBEXwEwe4C3Pp33Z1JoFCYfVL4kTOMLKk0ZZxREIeA=="],
-
-    "vite-plugin-inspect": ["vite-plugin-inspect@0.8.9", "", { "dependencies": { "@antfu/utils": "^0.7.10", "@rollup/pluginutils": "^5.1.3", "debug": "^4.3.7", "error-stack-parser-es": "^0.1.5", "fs-extra": "^11.2.0", "open": "^10.1.0", "perfect-debounce": "^1.0.0", "picocolors": "^1.1.1", "sirv": "^3.0.0" }, "peerDependencies": { "vite": "^3.1.0 || ^4.0.0 || ^5.0.0-0 || ^6.0.1" } }, "sha512-22/8qn+LYonzibb1VeFZmISdVao5kC22jmEKm24vfFE8siEn47EpVcCLYMv6iKOYMJfjSvSJfueOwcFCkUnV3A=="],
-
-    "vite-plugin-vue-devtools": ["vite-plugin-vue-devtools@7.7.2", "", { "dependencies": { "@vue/devtools-core": "^7.7.2", "@vue/devtools-kit": "^7.7.2", "@vue/devtools-shared": "^7.7.2", "execa": "^9.5.1", "sirv": "^3.0.0", "vite-plugin-inspect": "0.8.9", "vite-plugin-vue-inspector": "^5.3.1" }, "peerDependencies": { "vite": "^3.1.0 || ^4.0.0-0 || ^5.0.0-0 || ^6.0.0-0" } }, "sha512-5V0UijQWiSBj32blkyPEqIbzc6HO9c1bwnBhx+ay2dzU0FakH+qMdNUT8nF9BvDE+i6I1U8CqCuJiO20vKEdQw=="],
-
-    "vite-plugin-vue-inspector": ["vite-plugin-vue-inspector@5.3.1", "", { "dependencies": { "@babel/core": "^7.23.0", "@babel/plugin-proposal-decorators": "^7.23.0", "@babel/plugin-syntax-import-attributes": "^7.22.5", "@babel/plugin-syntax-import-meta": "^7.10.4", "@babel/plugin-transform-typescript": "^7.22.15", "@vue/babel-plugin-jsx": "^1.1.5", "@vue/compiler-dom": "^3.3.4", "kolorist": "^1.8.0", "magic-string": "^0.30.4" }, "peerDependencies": { "vite": "^3.0.0-0 || ^4.0.0-0 || ^5.0.0-0 || ^6.0.0-0" } }, "sha512-cBk172kZKTdvGpJuzCCLg8lJ909wopwsu3Ve9FsL1XsnLBiRT9U3MePcqrgGHgCX2ZgkqZmAGR8taxw+TV6s7A=="],
-
-    "vscode-uri": ["vscode-uri@3.1.0", "", {}, "sha512-/BpdSx+yCQGnCvecbyXdxHDkuk55/G3xwnC0GqY4gmQ3j+A+g8kzzgB4Nk/SINjqn6+waqw3EgbVF2QKExkRxQ=="],
-
-    "vue": ["vue@3.5.13", "", { "dependencies": { "@vue/compiler-dom": "3.5.13", "@vue/compiler-sfc": "3.5.13", "@vue/runtime-dom": "3.5.13", "@vue/server-renderer": "3.5.13", "@vue/shared": "3.5.13" }, "peerDependencies": { "typescript": "*" }, "optionalPeers": ["typescript"] }, "sha512-wmeiSMxkZCSc+PM2w2VRsOYAZC8GdipNFRTsLSfodVqI9mbejKeXEGr8SckuLnrQPGe3oJN5c3K0vpoU9q/wCQ=="],
-
-    "vue-router": ["vue-router@4.5.0", "", { "dependencies": { "@vue/devtools-api": "^6.6.4" }, "peerDependencies": { "vue": "^3.2.0" } }, "sha512-HDuk+PuH5monfNuY+ct49mNmkCRK4xJAV9Ts4z9UFc4rzdDnxQLyCMGGc8pKhZhHTVzfanpNwB/lwqevcBwI4w=="],
-
-    "vue-tsc": ["vue-tsc@2.2.8", "", { "dependencies": { "@volar/typescript": "~2.4.11", "@vue/language-core": "2.2.8" }, "peerDependencies": { "typescript": ">=5.0.0" }, "bin": { "vue-tsc": "./bin/vue-tsc.js" } }, "sha512-jBYKBNFADTN+L+MdesNX/TB3XuDSyaWynKMDgR+yCSln0GQ9Tfb7JS2lr46s2LiFUT1WsmfWsSvIElyxzOPqcQ=="],
-
-    "which": ["which@5.0.0", "", { "dependencies": { "isexe": "^3.1.1" }, "bin": { "node-which": "bin/which.js" } }, "sha512-JEdGzHwwkrbWoGOlIHqQ5gtprKGOenpDHpxE9zVR1bWbOtYRyPPHMe9FaP6x61CmNaTThSkb0DAJte5jD+DmzQ=="],
-
-    "yallist": ["yallist@3.1.1", "", {}, "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g=="],
-
-    "yoctocolors": ["yoctocolors@2.1.1", "", {}, "sha512-GQHQqAopRhwU8Kt1DDM8NjibDXHC8eoh1erhGAJPEyveY9qqVeXvVikNKrDz69sHowPMorbPUrH/mx8c50eiBQ=="],
-
-    "zod": ["zod@3.24.2", "", {}, "sha512-lY7CDW43ECgW9u1TcT3IoXHflywfVqDYze4waEz812jR/bZ8FHDsl7pFQoSZTz5N+2NqRXs8GBwnAwo3ZNxqhQ=="],
-
-    "@vue/devtools-core/nanoid": ["nanoid@5.1.3", "", { "bin": { "nanoid": "bin/nanoid.js" } }, "sha512-zAbEOEr7u2CbxwoMRlz/pNSpRP0FdAU4pRaYunCdEezWohXFs+a0Xw7RfkKaezMsmSM1vttcLthJtwRnVtOfHQ=="],
-
-    "cross-spawn/which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],
-
-    "npm-run-path/path-key": ["path-key@4.0.0", "", {}, "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ=="],
-
-    "vue-router/@vue/devtools-api": ["@vue/devtools-api@6.6.4", "", {}, "sha512-sGhTPMuXqZ1rVOk32RylztWkfXTRhuS7vgAKv0zjqk8gbsHkJ7xfFf+jbySxt7tWObEJwyKaHMikV/WGDiQm8g=="],
-
-    "cross-spawn/which/isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],
-  }
-}

bunfig.toml

@@ -1,2 +0,0 @@
-[serve.static]
-plugins = ["bun-plugin-tailwind"]

flake.lock

@@ -2,12 +2,12 @@
   "nodes": {
     "nixpkgs": {
       "locked": {
-        "lastModified": 1741246872,
+        "lastModified": 1748929857,
-        "narHash": "sha256-Q6pMP4a9ed636qilcYX8XUguvKl/0/LGXhHcRI91p0U=",
+        "narHash": "sha256-lcZQ8RhsmhsK8u7LIFsJhsLh/pzR9yZ8yqpTzyGdj+Q=",
-        "rev": "10069ef4cf863633f57238f179a0297de84bd8d3",
+        "rev": "c2a03962b8e24e669fb37b7df10e7c79531ff1a4",
-        "revCount": 763342,
+        "revCount": 810143,
         "type": "tarball",
-        "url": "https://api.flakehub.com/f/pinned/NixOS/nixpkgs/0.1.763342%2Brev-10069ef4cf863633f57238f179a0297de84bd8d3/01956ed4-f66c-7a87-98e4-b7e58f4aa591/source.tar.gz"
+        "url": "https://api.flakehub.com/f/pinned/NixOS/nixpkgs/0.1.810143%2Brev-c2a03962b8e24e669fb37b7df10e7c79531ff1a4/01973914-8b42-7168-9ee2-4d6ea6946695/source.tar.gz"
       },
       "original": {
         "type": "tarball",

flake.nix

@@ -18,10 +18,12 @@
         default = pkgs.mkShell {
           packages = with pkgs; [
             # Frontend
-            bun
+            nodejs
             sqlite
             sqls
             sql-studio
+            zlib
+            bash
             # Backend
             (dotnetCorePackages.combinePackages [
               dotnetCorePackages.sdk_9_0
@@ -37,9 +39,10 @@
             typescript-language-server
           ];
           shellHook = ''
-            export PATH=$PATH:$HOME/.bun/bin
+            export PATH=$PATH:/home/sikongjueluo/.dotnet/tools
+            export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:${pkgs.zlib}/lib
+            export DOTNET_ROOT=${pkgs.dotnetCorePackages.sdk_9_0}/share/dotnet
           '';
-          
         };
       });
     };

package.json

@@ -1,30 +1,42 @@
 {
   "name": "fpga-weblab",
-  "version": "0.0.0",
+  "version": "0.1.0",
   "private": true,
   "type": "module",
-  "main": "./server/index.ts",
   "scripts": {
-    "dev": "vite",
+    "dev": "vite --host",
     "build": "run-p type-check \"build-only {@}\" --",
     "preview": "vite preview",
     "build-only": "vite build",
     "type-check": "vue-tsc --build",
-    "server": "run --watch ./server/index.ts"
+    "gen-api": "npx tsx scripts/GenerateWebAPI.ts"
   },
   "dependencies": {
-    "@trpc/client": "^10.45.2",
+    "@microsoft/signalr": "^9.0.6",
-    "@trpc/server": "^10.45.2",
+    "@svgdotjs/svg.js": "^3.2.4",
+    "@tanstack/vue-table": "^8.21.3",
     "@types/lodash": "^4.17.16",
-    "all": "^0.0.0",
+    "@types/signalr": "^2.4.3",
+    "@vueuse/core": "^13.5.0",
+    "async-mutex": "^0.5.0",
+    "axios": "^1.11.0",
+    "echarts": "^5.6.0",
+    "highlight.js": "^11.11.1",
+    "konva": "^9.3.20",
     "lodash": "^4.17.21",
     "log-symbols": "^7.0.0",
+    "lucide-vue-next": "^0.525.0",
+    "marked": "^12.0.0",
+    "mathjs": "^14.4.0",
     "pinia": "^3.0.1",
-    "tinypool": "^1.0.2",
+    "reka-ui": "^2.3.1",
     "ts-log": "^2.2.7",
     "ts-results-es": "^5.0.1",
     "vue": "^3.5.13",
+    "vue-echarts": "^7.0.3",
+    "vue-konva": "^3.2.1",
     "vue-router": "4",
+    "yocto-queue": "^1.2.1",
     "zod": "^3.24.2"
   },
   "devDependencies": {
@@ -36,10 +48,15 @@
     "@vue/tsconfig": "^0.7.0",
     "autoprefixer": "^10.4.20",
     "daisyui": "^5.0.0",
+    "node-fetch": "^3.3.2",
     "npm-run-all2": "^7.0.2",
+    "nswag": "^14.3.0",
     "postcss": "^8.5.3",
     "tailwindcss": "^4.0.12",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.20.3",
     "typescript": "~5.7.3",
+    "unplugin-vue-components": "^28.8.0",
     "vite": "^6.1.0",
     "vite-plugin-vue-devtools": "^7.7.2",
     "vue-tsc": "^2.2.2"

public/EquipmentTemplates/MatrixKey.json

@@ -0,0 +1,314 @@
+{
+  "version": 1,
+  "author": "template",
+  "editor": "system",
+  "parts": [
+    {
+      "id": "board",
+      "type": "BaseBoard",
+      "x": 0,
+      "y": 0,
+      "attrs": {
+        "size": 1.2,
+        "width": 400,
+        "height": 400,
+        "roundCorner": 20
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": false,
+      "isOn": true,
+      "index": 0
+    },
+    {
+      "id": "key_0_0",
+      "type": "MechanicalButton",
+      "x": 50,
+      "y": 50,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "1",
+        "bindMatrixKey": "0",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 0
+    },
+    {
+      "id": "key_0_1",
+      "type": "MechanicalButton",
+      "x": 150,
+      "y": 50,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "2",
+        "bindMatrixKey": "1",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 1
+    },
+    {
+      "id": "key_0_2",
+      "type": "MechanicalButton",
+      "x": 250,
+      "y": 50,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "3",
+        "bindMatrixKey": "2",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 2
+    },
+    {
+      "id": "key_0_3",
+      "type": "MechanicalButton",
+      "x": 350,
+      "y": 50,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "A",
+        "bindMatrixKey": "3",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 3
+    },
+    {
+      "id": "key_1_0",
+      "type": "MechanicalButton",
+      "x": 50,
+      "y": 150,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "4",
+        "bindMatrixKey": "4",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 4
+    },
+    {
+      "id": "key_1_1",
+      "type": "MechanicalButton",
+      "x": 150,
+      "y": 150,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "5",
+        "bindMatrixKey": "5",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 5
+    },
+    {
+      "id": "key_1_2",
+      "type": "MechanicalButton",
+      "x": 250,
+      "y": 150,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "6",
+        "bindMatrixKey": "6",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 6
+    },
+    {
+      "id": "key_1_3",
+      "type": "MechanicalButton",
+      "x": 350,
+      "y": 150,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "B",
+        "bindMatrixKey": "7",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 7
+    },
+    {
+      "id": "key_2_0",
+      "type": "MechanicalButton",
+      "x": 50,
+      "y": 250,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "7",
+        "bindMatrixKey": "8",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 8
+    },
+    {
+      "id": "key_2_1",
+      "type": "MechanicalButton",
+      "x": 150,
+      "y": 250,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "8",
+        "bindMatrixKey": "9",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 9
+    },
+    {
+      "id": "key_2_2",
+      "type": "MechanicalButton",
+      "x": 250,
+      "y": 250,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "9",
+        "bindMatrixKey": "10",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 10
+    },
+    {
+      "id": "key_2_3",
+      "type": "MechanicalButton",
+      "x": 350,
+      "y": 250,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "C",
+        "bindMatrixKey": "11",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 11
+    },
+    {
+      "id": "key_3_0",
+      "type": "MechanicalButton",
+      "x": 50,
+      "y": 350,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "*",
+        "bindMatrixKey": "12",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 12
+    },
+    {
+      "id": "key_3_1",
+      "type": "MechanicalButton",
+      "x": 150,
+      "y": 350,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "0",
+        "bindMatrixKey": "13",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 13
+    },
+    {
+      "id": "key_3_2",
+      "type": "MechanicalButton",
+      "x": 250,
+      "y": 350,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "#",
+        "bindMatrixKey": "14",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 14
+    },
+    {
+      "id": "key_3_3",
+      "type": "MechanicalButton",
+      "x": 350,
+      "y": 350,
+      "attrs": {
+        "size": 0.5,
+        "bindKey": "D",
+        "bindMatrixKey": "15",
+        "pins": []
+      },
+      "rotate": 0,
+      "group": "MatrixKeypad",
+      "positionlock": false,
+      "hidepins": true,
+      "isOn": false,
+      "index": 15
+    }
+  ],
+  "connections": []
+}

public/doc/01/doc.md

@@ -0,0 +1,175 @@
+# 基础-1-流水灯
+
+## 1.1 章节导读
+
+流水灯实验作为基础实验的第一个实验是非常合适的，本章我们利用试验箱中的LED进行点亮LED，并实现流水灯的功能。
+
+## 1.2 理论学习
+
+相信大家之前肯定接触过单片机等设备，而学习这些设备的第一个实验例程往往都是点亮一个LED。本次实验在点亮LED的基础上另LED灯依次闪亮，循环不止，实现“流水”的功能。其原理是依次控制连接到LED的IO口的电平高低，让LED的闪亮间隔为0.5s，以实现流水灯的效果。
+
+## 1.3 实战演练
+
+### 1.3.1实验目标
+
+依次点亮实验板中的8个LED灯，两灯点亮间隔为0.5s，每次点亮持续0.5s，实现流水灯效果。
+
+### 1.3.2硬件资源
+
+实验板上有0~31共32个LED灯的资源，每4个LED灯为一组，分别是绿，红，蓝，黄四种颜色，本次实验使用8个LED进行验证。
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/1.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:30%"/>
+    <br>		<!--换行-->
+    图1.LED扩展板	<!--标题-->
+    </center>
+</div>
+
+通过原理图可以得知，本试验箱的LED灯为高电平时点亮。
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/2.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:40%"/>
+    <br>		<!--换行-->
+    图2.LED扩展板原理图	<!--标题-->
+    </center>
+</div>
+
+### 1.3.3程序设计
+
+流水灯的设计与分频器，计数器的逻辑相似，只是多了LED灯的点亮部分。为了实现计数器肯定需要时钟信号sysclk，也需要一个复位信号rstn，同时为了驱动LED，需要8个IO口。所以模块的端口如下表所示：
+
+| 端口名称 | 端口位宽               | 端口类型           |功能描述
+|:----------:|:----:|:----:|:--------------------:|
+| sysclk | 1Bit | Input | 输入时钟，频率27M |
+| rstn | 1Bit | Input | 复位信号，低电平有效 |
+| led | 8Bit | Output | LED控制信号 |
+
+
+为了使灯点亮0.5s，我们应该设计一个计数器或者是分频器，先将板载27M高频时钟降速。在27M时钟下计数0.5s，需要计数器计数13_500_000个数，也就是计数器从0开始计数到13_499_999。所以我们定义一个寄存器cnt，每一次时钟上升沿cnt就加1，当计数到13_499_999时，led的状态改变，同时cnt归零重新开始计数。
+
+为了实现8个led流水的效果，我们将0定义为led灭，1表示亮，初始状态led = 8’b0000_0001，当经过0.5s后，也就是cnt等于13_499_999的时候，第一个led灭，第二个led亮起，也就是led = 8‘b0000_0010。同理，再过0.5s，led = 8’b0000_0100，再过0.5s，led = 8‘b0000_1000以此类推。
+
+根据上面的规律我们很容易发现，led的流水是靠1的移位来实现的，也就是最基本的左移(<<)和右移(>>)运算符去实现。在这里我们需要向左移位，并且每次只需要移动1位。模块的参考代码（waterled_top.v）如下所示：
+
+```verilog
+module waterled_top(
+    input sysclk,    //27MHz system clock
+    input rstn,      //active low reset
+    output [7:0] led
+   );
+    parameter CNT_MAX = 32'd13_499_999;
+    reg [7:0] led_reg;
+    reg [31:0] cnt;
+    //cnt 当cnt == CNT_MAX时变为0，计数0.5秒
+    always @(posedge sysclk) begin
+        if (!rstn)
+            cnt <= 0;
+        else if (cnt < CNT_MAX)
+            cnt <= cnt + 1;
+        else 
+            cnt <= 0;
+    end
+    //led_reg 当cnt == CNT_MAX时，左移一位。
+    always @(posedge sysclk) begin
+        if (!rstn)
+            led_reg <= 8'b0000_0001;
+        else if (led_reg == 8'b1000_0000 && cnt == CNT_MAX)//led7亮0.5s后重回led0
+            led_reg <= 8'b0000_0001; 
+        else if (cnt == CNT_MAX) //0.5s后左移
+            led_reg <= led_reg << 1;
+        else
+            led_reg <= led_reg;
+    end
+    //led
+    assign led = led_reg;
+endmodule
+```
+
+### 1.3.4仿真验证
+
+为上述模块编写仿真模块，参考代码（waterled_top_tb.v）如下：
+
+```verilog
+`timescale 1ns/1ns
+module waterled_top_tb;
+
+    reg sysclk;
+    reg rstn;
+    wire [7:0] led;
+
+    // 实例化待测试模块
+    waterled_top #(
+        .CNT_MAX(32'd100)//为了加快仿真速度，将模块内部CNT_MAX由13_499_999变为1000
+    )uut (
+        .sysclk(sysclk),
+        .rstn(rstn),
+        .led(led)
+    );
+    // 产生系统时钟：周期约为 27Mhz
+    initial begin
+        sysclk = 0;
+        forever #(500/27) sysclk = ~sysclk;
+    end
+    // 初始化和复位过程
+    initial begin
+        // 初始化
+        rstn = 0;
+        #100;           // 保持复位100ns
+        rstn = 1;       // 释放复位
+    end
+endmodule
+```
+
+为了加速仿真，我们在仿真文件中另CNT_MAX的值为100。同时为了便于仿真，可以直接点击sim文件夹下hebav文件夹中的do.bat文件即可利用ModuleSim对模块进行仿真，仿真波形如下：
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/3.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:70%"/>
+    <br>		<!--换行-->
+    图3.流水灯仿真波形（一）	<!--标题-->
+    </center>
+</div>
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/4.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:70%"/>
+    <br>		<!--换行-->
+    图4.流水灯仿真波形（二）	<!--标题-->
+    </center>
+</div>
+
+从图3我们可以看到，端口信号led的值经过一定时间之后就进行了左移，并且在图4中我们也可以发现，当cnt的值等于CNT_MAX的时候led进行左移，与我们设计的目标相符合，可以进行下一步上板验证了。
+
+### 1.3.5上板验证
+
+仿真已经通过，可以进行上板验证，上板前要先进行管脚约束。端口与对应管脚如下表所示：
+| 端口名称 |信号类型| 对应管脚|功能
+|:----:|:----:|:----:|:----:|
+| sysclk | Input |  | 时钟 |
+| rstn | Input |  | 复位 |
+| led[0] | Output |  | LED |
+| led[1] | Output |  | LED |
+| led[2] | Output |  | LED |
+| led[3] | Output |  | LED |
+| led[4] | Output |  | LED |
+| led[5] | Output |  | LED |
+| led[6] | Output |  | LED |
+| led[7] | Output |  | LED |
+
+管脚分配可以直接编写.fdc文件，也可以使用PDS内置的工具进行分配。
+
+完成管脚分配之后就可以生成sbit文件，将文件提交到网站后点击烧录，即可将sbit下载到实验板中，在摄像头页面即可观察到流水灯的现象。
+
+## 1.4 章末总结
+
+本次实验主要学习使用左移(<<)和右移(>>)运算符实现移位，但实际应用中也可以使用位拼接（{}）进行更加复杂的移位操作，各位同学可以尝试学习。

public/doc/02/doc.md

@@ -0,0 +1,258 @@
+# 基础-2-按键检测与消抖
+
+## 2.1 章节导读
+
+在数字电路中，按键是最常用的人机交互输入方式。然而，机械式按键在按下或释放过程中会产生抖动信号，直接读取会引起误触发。本章我们将实现一个可靠的按键检测模块，完成信号的消抖和下降沿检测，以便为更复杂的模块如状态机切换、模式转换等提供稳定的触发信号。
+
+## 2.2 理论学习
+
+由于机械结构的限制，按键在触发的一瞬间，其接触点会发生数次抖动，导致输出信号在0和1之间反复跳变。这种现象称为“抖动”。为避免系统错误响应，需要对按键信号进行“消抖”处理。
+
+常见的软件消抖方法包括定时器延时，而在软件中通常使用计数器。在本实验中，采用对输入信号进行采样判断，当其状态发生变化时开始计数，若持续稳定一定时长后，才认为按键真正改变。
+
+在此基础上，若需检测按键的“按下事件”，则还需进一步提取其上升沿（或下降沿）作为一个单周期的“有效触发”信号。
+
+## 2.3 实战演练
+
+### 2.3.1 实验目标
+
+实现一个具有消抖功能的按键检测模块，并进一步提取其下降沿触发信号，输出一个单时钟周期宽度的 `btn_flag` 信号，用于后级逻辑判断。同时为了使实验现象更加明显，设置8位的IO输出连接led，当检测到 `btn_flag` 信号后8位信号`led`会自加1。
+
+### 2.3.2 硬件资源
+
+本实验使用试验箱上普通按键输入资源，输入信号经过电平转换后进入 FPGA 芯片，输出信号可连接状态指示灯以观察效果。
+
+根据原理图可知实验板的按键按下是低电平，不按为高电平。
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/1.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:30%"/>
+    <br>		<!--换行-->
+    图1.实验板的按键资源	<!--标题-->
+    </center>
+</div>
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/2.png"
+         alt="实验板按键原理图"
+         style="zoom:60%"/>
+    <br>		<!--换行-->
+    图2.实验板按键原理图	<!--标题-->
+    </center>
+</div>
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/xx.png"
+         alt="数字孪生"
+         style="zoom:60%"/>
+    <br>		<!--换行-->
+    图3.远程实验界面按键	<!--标题-->
+    </center>
+</div>
+
+### 2.3.3 程序设计
+
+为了实现稳定的按键检测逻辑，设计流程如下：
+
+1. 对输入 `btn` 进行采样，形成 `btn_temp`；
+2. 若检测到 `btn_temp` 与当前 `btn` 状态不一致，则开始计数；
+3. 若计数器 `cnt` 达到设定阈值（如255），则认为按键状态稳定，更新 `btn_ggle`；
+4. 实验板的按键按下是低电平，不按为高电平。所以对 `btn_ggle` 打两拍形成 `btn_flag_d0` 和 `btn_flag_d1`，再判断其下降沿，输出一个时钟周期的`btn_flag`；
+5. 检测到信号`btn_flag`后，信号`led <= led + 1`。
+
+该模块的参考代码如下（`btn_ggle.v`）：
+
+```verilog
+module btn_ggle(
+    input wire clk,
+    input wire rstn,
+    input wire btn,
+    output wire btn_flag,
+    output reg [7:0] led
+);
+reg btn_ggle;
+reg btn_flag_d0,btn_flag_d1;
+reg [7:0] cnt;
+reg btn_temp;
+//检测按键状态
+always @(posedge clk) btn_temp <= btn;
+//按键状态改变时开始计数
+always @(posedge clk) begin
+    if(~rstn) cnt <= 0;
+    else if(btn_temp != btn) cnt <= 1;
+    else if(cnt != 0) cnt <= cnt + 1;
+    else cnt <= 0;
+end
+//计数到255时认为按键值稳定
+always @(posedge clk) begin
+    if(~rstn) btn_ggle <= btn;
+    else if(cnt == 8'hFF) btn_ggle <= btn_temp;
+    else btn_ggle <= btn_ggle;
+end
+//对btn_ggle信号延迟打拍
+always @(posedge clk) begin
+    if(~rstn) begin
+        btn_flag_d0 <= 0;
+        btn_flag_d1 <= 0;
+    end
+    else begin
+        btn_flag_d0 <= btn_ggle;
+        btn_flag_d1 <= btn_flag_d0;
+    end
+end
+//btn_flag检测btn_ggle的下降沿
+assign btn_flag = ~btn_flag_d0 && btn_flag_d1;
+//检测到按键按下的标志位（btn_flag），led会加1
+always @(posedge clk) begin
+    if(~rstn) led <= 0;
+    else if(btn_flag) led <= led + 1;
+    else led <= led;
+end
+endmodule 
+```
+
+### 2.3.4 仿真验证
+
+为验证功能的正确性，设计测试平台（`btn_ggle_tb.v`），代码如下：
+
+```verilog
+`timescale 1ns/1ns
+module btn_ggle_tb;
+
+reg clk;
+reg rstn;
+reg btn;
+wire btn_flag;
+wire [7:0] led;
+btn_ggle btn_ggle_inst (
+    .clk(clk),
+    .rstn(rstn),
+    .btn(btn),
+    .btn_flag(btn_flag),
+    .led(led)
+);
+
+// 27MHz 时钟周期约为 37.037ns，取37ns近似
+always #(500/27) clk = ~clk; // 半周期18.5ns ≈ 27MHz
+
+initial begin
+    // 初始化
+    clk = 0;
+    rstn = 0;
+    btn = 1;        // 按键默认未按下，高电平有效
+
+    // 释放复位
+    #200;
+    rstn = 1;
+
+    // 模拟带抖动的按下过程
+    #1000  btn = 0;
+    #100   btn = 1; // 抖动
+    #100   btn = 0;
+    #100   btn = 1;
+    #100   btn = 0;
+    // 稳定按下
+    #100000 btn = 0;
+
+    // 模拟抖动松开过程
+    #300000 btn = 1;
+    #100    btn = 0;
+    #100    btn = 1;
+    #100    btn = 0;
+    #100    btn = 1;
+    // 稳定松开
+    #100000 btn = 1;
+
+    // 第二次按下
+    #300000 btn = 0;
+    #100000 btn = 0;
+
+    #300000 $finish;
+end
+
+endmodule
+```
+
+利用ModuleSim进行仿真，部分仿真波形如下图所示：
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/3.png"
+         alt="仿真波形（一）"
+         style="zoom:60%"/>
+    <br>		<!--换行-->
+    图4.仿真波形（一）	<!--标题-->
+    </center>
+</div>
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/4.png"
+         alt="仿真波形（二）"
+         style="zoom:60%"/>
+    <br>		<!--换行-->
+    图5.仿真波形（二）	<!--标题-->
+    </center>
+</div>
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/5.png"
+         alt="仿真波形（三）"
+         style="zoom:60%"/>
+    <br>		<!--换行-->
+    图6.仿真波形（三）	<!--标题-->
+    </center>
+</div>
+
+从仿真波形二和三中，我们可以看到，当我们模拟按键按下（1 ----> 0），当按键抖动（`btn`在0和1之间来回跳转）时，`cnt`的值会变回1重新开始计数，直到按键稳定按下（`btn`的值稳定不变，为0），`cnt`稳定增加，当`cnt`的值增加到`8‘hFF`时，认为按键按下，`btn_ggle`存储此时的按键状态，同时`btn_flag`检测到下降沿，拉高一个时钟周期。`led`信号也加一。
+
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/6.png"
+         alt="仿真波形（四）"
+         style="zoom:60%"/>
+    <br>		<!--换行-->
+    图7.仿真波形（四）	<!--标题-->
+    </center>
+</div>
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/7.png"
+         alt="仿真波形（五）"
+         style="zoom:60%"/>
+    <br>		<!--换行-->
+    图8.仿真波形（五）	<!--标题-->
+    </center>
+</div>
+
+
+从波形三和四中，我们可以看到，当模拟按键抬起时（0 ----> 1），按键的抖动也会使`cnt`重新计数，直到稳定，`cnt`计数到`8’hFF`时，更新`btn_ggle`，由于按键是抬起，`btn_flag`不变，`led`不变。
+
+### 2.3.5 上板验证
+
+完成仿真后，可进行上板验证。端口连接如下表所示：
+
+| 端口名称 | 类型    |  管脚 |说明       |
+| -------- | ------ | ------ | ---------- |
+| clk      | Input  |  | 27MHz 时钟 |
+| rstn     | Input  |  | 低电平复位 |
+| btn      | Input  |      | 外部按钮   |
+| btn_flag | Output |      | 上升沿标志 |
+| led[0] | Output |      | 驱动led |
+| led[1] | Output |      | 驱动led |
+| led[2] | Output |      | 驱动led    |
+| led[3] | Output |      | 驱动led    |
+| led[4] | Output |      | 驱动led    |
+| led[5] | Output |      | 驱动led |
+| led[6] | Output |      | 驱动led |
+| led[7] | Output |      | 驱动led    |
+
+将`.sbit`文件上传至平台，并下载到实验板，多次按下按键，观察led灯跳转，如果按下1次按键led只跳转一次，那么说明达成实验目标。
+
+## 2.4 章末总结
+
+本实验通过一个典型的按键检测例子，介绍了数字系统中常用的消抖和边沿检测方法，掌握了如何利用计数器和触发器组合进行抖动抑制与事件捕捉。在更复杂的设计中，这类基础模块可作为控制逻辑的可靠触发信号源，具有广泛应用价值。

public/doc/03/doc.md

@@ -0,0 +1,244 @@
+# 基础-3-数码管实验
+
+---
+
+在许多项目设计中，我们通常需要一些显示设备来显示我们需要的信息，可以选择的显示设备有很多，而数码管是使用最多，最简单的显示设备之一。
+
+## 3.1 章节导读
+本章将通过数码管驱动实验讲解FPGA数字系统中重要的"选通控制"概念。读者将学习到：
+1. 数码管工作原理与动态扫描技术
+2. 多路复用（Multiplexing）设计方法
+3. 参数化模块设计技巧
+4. 外设驱动时序规划
+5. ASCII到段码的转换原理
+
+实验将使用Verilog HDL实现一个支持8位数码管显示、包含字符动态滚动和选通控制的完整系统。
+
+
+## 3.2 理论学习
+### 3.2.1 数码管结构
+- 7段数码管组成：A-G段+DP小数点
+- 共阳/共阴类型区分（本实验采用共阳型，低电平有效）
+
+### 3.2.2 动态扫描原理
+```
+显示周期 = 刷新周期 × 数码管数量
+人眼视觉暂留效应（>60Hz）
+扫描频率计算公式：f_scan = f_clk / CLK_CYCLE
+```
+
+### 3.2.3 关键技术
+- 时分复用：分时选通数码管
+- 段码生成：ASCII字符到七段码转换
+- 消隐处理：消除切换时的视觉残留
+
+### 3.2.4 设计指标
+| 参数 | 值 | 说明 |
+|-------|-----|-------------------|
+| 位数 | 8   | 数码管数量        |
+| 频率 | 200Hz | 单管刷新频率     |
+| 分辨率 | 8bit | 段码控制（含小数点）|
+
+
+## 3.2 实战演练
+### 3.3.1 系统架构
+```verilog
+系统框图：
+[Top模块] → [显示驱动模块] → [选通控制模块]
+           ↖ ASCII数据生成 ↙ 时钟分频
+```
+
+### 3.3.2 模块设计
+#### led_display_selector
+```verilog
+module led_display_selector #(
+    parameter NUM = 4,
+    parameter VALID_SIGNAL = 1'b0,
+    parameter CLK_CYCLE = 1000
+)(
+    input  wire             clk,
+    input  wire             rstn,
+    input  wire [NUM*8-1:0] led_in,
+    output  reg [7:0]       led_display_seg,//[DP,G,F,E,D,C,B,A]
+    output  reg [NUM-1:0]   led_display_sel
+);
+
+reg [31:0] clk_cnt;
+always @(posedge clk or negedge rstn) begin
+    if (!rstn) clk_cnt <= 0;
+    else if(clk_cnt == CLK_CYCLE) clk_cnt <= 0;
+    else clk_cnt <= clk_cnt + 1;
+end
+
+wire seg_change = (clk_cnt == CLK_CYCLE) ? 1'b1 : 1'b0;
+
+always @(posedge clk or negedge rstn) begin
+    if(!rstn) led_display_sel <= {{(NUM-1){~VALID_SIGNAL}}, VALID_SIGNAL};
+    else if (seg_change) led_display_sel <= {led_display_sel[NUM-2:0], led_display_sel[NUM-1]};
+    else led_display_sel <= led_display_sel;
+end
+
+integer i;
+always @(*) begin
+    for(i=0;i<NUM;i=i+1) begin
+        if(led_display_sel[NUM-1-i] == VALID_SIGNAL)
+            led_display_seg = led_in[i*8 +: 8] ^ ({8{~VALID_SIGNAL}});
+    end
+end
+
+endmodule //led_display_ctrl
+```
+
+#### led_display_driver
+```verilog
+module led_display_driver(// 8个数码管显示，阳极管（在selector中已经做了阴阳处理）
+    input wire           clk,
+    input wire           rstn,
+    input wire [8*8-1:0] assic_seg, //ASSIC coding
+    input wire [7:0]     seg_point, //显示小数点
+
+    output wire [7:0]    led_display_seg,
+    output wire [7:0]    led_display_sel
+);
+
+reg [8*8-1:0] led_in;
+
+integer i;
+always @(*) begin
+    led_in = 0;
+    for(i=0;i<8;i=i+1) begin //led_in[i*8 +: 8] <---> assic_seg[i*8 +: 8]
+        case (assic_seg[i*8 +: 8])
+            "0":     led_in[i*8 +: 8] = (8'h3f) | {seg_point[i],7'b0};
+            "1":     led_in[i*8 +: 8] = (8'h06) | {seg_point[i],7'b0};
+            "2":     led_in[i*8 +: 8] = (8'h5b) | {seg_point[i],7'b0};
+            "3":     led_in[i*8 +: 8] = (8'h4f) | {seg_point[i],7'b0};
+            "4":     led_in[i*8 +: 8] = (8'h66) | {seg_point[i],7'b0};
+            "5":     led_in[i*8 +: 8] = (8'h6d) | {seg_point[i],7'b0};
+            "6":     led_in[i*8 +: 8] = (8'h7d) | {seg_point[i],7'b0};
+            "7":     led_in[i*8 +: 8] = (8'h07) | {seg_point[i],7'b0};
+            "8":     led_in[i*8 +: 8] = (8'h7f) | {seg_point[i],7'b0};
+            "9":     led_in[i*8 +: 8] = (8'h6f) | {seg_point[i],7'b0};
+            "A","a": led_in[i*8 +: 8] = (8'h77) | {seg_point[i],7'b0};
+            "B","b": led_in[i*8 +: 8] = (8'h7c) | {seg_point[i],7'b0};
+            "C","c": led_in[i*8 +: 8] = (8'h39) | {seg_point[i],7'b0};
+            "D","d": led_in[i*8 +: 8] = (8'h5e) | {seg_point[i],7'b0};
+            "E","e": led_in[i*8 +: 8] = (8'h79) | {seg_point[i],7'b0};
+            "F","f": led_in[i*8 +: 8] = (8'h71) | {seg_point[i],7'b0};
+            "G","g": led_in[i*8 +: 8] = (8'h3d) | {seg_point[i],7'b0};
+            "H","h": led_in[i*8 +: 8] = (8'h76) | {seg_point[i],7'b0};
+            "I","i": led_in[i*8 +: 8] = (8'h0f) | {seg_point[i],7'b0};
+            "J","j": led_in[i*8 +: 8] = (8'h0e) | {seg_point[i],7'b0};
+            "K","k": led_in[i*8 +: 8] = (8'h75) | {seg_point[i],7'b0};
+            "L","l": led_in[i*8 +: 8] = (8'h38) | {seg_point[i],7'b0};
+            "M","m": led_in[i*8 +: 8] = (8'h37) | {seg_point[i],7'b0};
+            "N","n": led_in[i*8 +: 8] = (8'h54) | {seg_point[i],7'b0};
+            "O","o": led_in[i*8 +: 8] = (8'h5c) | {seg_point[i],7'b0};
+            "P","p": led_in[i*8 +: 8] = (8'h73) | {seg_point[i],7'b0};
+            "Q","q": led_in[i*8 +: 8] = (8'h67) | {seg_point[i],7'b0};
+            "R","r": led_in[i*8 +: 8] = (8'h31) | {seg_point[i],7'b0};
+            "S","s": led_in[i*8 +: 8] = (8'h49) | {seg_point[i],7'b0};
+            "T","t": led_in[i*8 +: 8] = (8'h78) | {seg_point[i],7'b0};
+            "U","u": led_in[i*8 +: 8] = (8'h3e) | {seg_point[i],7'b0};
+            "V","v": led_in[i*8 +: 8] = (8'h1c) | {seg_point[i],7'b0};
+            "W","w": led_in[i*8 +: 8] = (8'h7e) | {seg_point[i],7'b0};
+            "X","x": led_in[i*8 +: 8] = (8'h64) | {seg_point[i],7'b0};
+            "Y","y": led_in[i*8 +: 8] = (8'h6e) | {seg_point[i],7'b0};
+            "Z","z": led_in[i*8 +: 8] = (8'h59) | {seg_point[i],7'b0};
+            " ":     led_in[i*8 +: 8] = (8'h00) | {seg_point[i],7'b0};
+            "-":     led_in[i*8 +: 8] = (8'h40) | {seg_point[i],7'b0};
+            "_":     led_in[i*8 +: 8] = (8'h08) | {seg_point[i],7'b0};
+            "=":     led_in[i*8 +: 8] = (8'h48) | {seg_point[i],7'b0};
+            "+":     led_in[i*8 +: 8] = (8'h5c) | {seg_point[i],7'b0};
+            "(":     led_in[i*8 +: 8] = (8'h39) | {seg_point[i],7'b0};
+            ")":     led_in[i*8 +: 8] = (8'h0F) | {seg_point[i],7'b0};
+            default: led_in[i*8 +: 8] = (8'h00) | {seg_point[i],7'b0};
+        endcase
+    end
+end
+
+led_display_selector #(
+	.NUM          	( 8     ),
+	.VALID_SIGNAL 	( 1'b0  ), //阳极管，低电平亮
+	.CLK_CYCLE    	( 5000 ))
+u_led_display_selector(
+	.clk             	( clk              ),
+	.rstn            	( rstn             ),
+	.led_in          	( led_in           ),
+	.led_display_seg 	( led_display_seg  ),
+	.led_display_sel 	( led_display_sel  )
+);
+
+endmodule //moduleName
+```
+
+#### led_display_top
+```verilog
+
+module led_diaplay_top(
+    //system io
+    input  wire       external_clk ,
+    input  wire       external_rstn,
+    //led display io
+    output wire [7:0] led_display_seg,
+    output wire [7:0] led_display_sel
+);
+
+reg [43*8-1:0] assic_seg;
+reg [7:0]     seg_point;
+
+reg [31:0] clk_cnt;
+always @(posedge external_clk or negedge external_rstn) begin
+    if(!external_rstn) clk_cnt <= 0;
+    else clk_cnt <= clk_cnt + 1;
+end
+
+always @(posedge external_clk or negedge external_rstn) begin
+    if(!external_rstn) begin
+        assic_seg <= "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ -_=+()";
+        seg_point <= 8'b00000001;
+    end else if({clk_cnt[24]==1'b1} && (clk_cnt[23:0]==25'b0))begin
+        assic_seg <= {assic_seg[8*43-8-1:0], assic_seg[8*43-1 -: 8]};
+        seg_point <= {seg_point[6:0], seg_point[7]};
+    end else begin
+        assic_seg <= assic_seg;
+        seg_point <= seg_point;
+    end
+end
+
+led_display_driver u_led_display_driver(
+	.clk             	( external_clk             ),
+	.rstn            	( external_rstn            ),
+	.assic_seg       	( assic_seg[8*43-1 -: 8*8] ),
+	.seg_point       	( seg_point                ),
+	.led_display_seg 	( led_display_seg          ),
+	.led_display_sel 	( led_display_sel          )
+);
+
+endmodule //led_diaplay_top
+```
+
+### 3.3.3 上板验证步骤
+1. 设置参数：CLK_CYCLE=5000（对应200Hz扫描频率）
+2. 绑定管脚：连接数码管段选/位选信号
+3. 观察现象：字符"01234567"应稳定显示
+4. 修改assic_seg初始值验证滚动功能
+
+---
+
+## 3.4 章末总结
+**关键收获：**
+1. 掌握动态扫描消除器件闪烁的原理
+2. 理解参数化设计（NUM/VALID_SIGNAL）的优势
+3. 学习时序控制中计数器的重要作用
+4. 实践ASCII到硬件编码的转换方法
+
+**设计亮点：**
+- 支持阴阳极自动适配（通过VALID_SIGNAL参数）
+- 字符环形缓冲区实现无缝滚动
+- 参数化设计增强模块复用性
+
+---
+
+## 3.5 拓展训练
+
+结合流水灯实验和数码管实验：数码管显示数字，标识出当前流水到了哪一个灯

public/doc/04/doc.md

@@ -0,0 +1,212 @@
+# 基础-4-矩阵键盘实验
+
+## 4.1 章节导读
+本章将介绍**矩阵键盘检测电路的设计与实现方法**，通过Verilog HDL语言完成4×4矩阵键盘的扫描识别模块，掌握**多键输入设备的行列扫描原理、消抖机制以及按键编码处理方式**。
+
+矩阵键盘作为常见的人机交互接口之一，广泛应用于嵌入式系统、数字电路和微控制器项目中。与独立按键不同，矩阵键盘在节省IO资源的同时，对扫描逻辑和时序处理提出了更高的要求。实验中我们将采用**逐行扫描法**，结合状态机与延时消抖手段，确保按键信息的准确采集。
+
+
+## 4.2 理论学习
+### 4.2.1 矩阵键盘结构
+<div>           <!--块级封装-->
+    <center>    <!--将图片和文字居中-->
+    <img src="./images/1.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:80%"/>
+    <br>        <!--换行-->
+    图1.矩阵键盘原理图 <!--标题-->
+    </center>
+</div>
+
+实验板8个引脚分别连接矩阵键盘的KEY1~KEY8，该矩阵键盘的原理如下：将KEY1~KEY4脚设置为输出引脚，KEY5~KEY8设置为输入引脚。以KEY1和KEY5为例，当没有按键按下时，KEY1和VCC之间是断路，此时R1为上拉电阻，电路几乎没有电流流过，KEY5检测到的电压恰好是VCC，为1。**所以按键不按下，KEY5~KEY8检测到1。**
+
+如果按键按下。此时KEY5~KEY8检测到的值与KEY1~KEY4的输出电压有关。以KEY1和KEY5为例，如果KEY1输出为0，按键1按下，VCC和KEY1之间形成通路，KEY5检测到0。但如果KEY1输出为1，此时即使按键按下，VCC和KEY1之间也几乎没有电流，此时KEY5检测到高阻态，也就是1。所以，**如果行输出电平为0，并且按键按下，KEY5~8会检测到0；如果行输出电平为1，按键按下，KEY5~8检测到1。**
+
+现在我们看懂了原理图就可以开始设计verilog，根据原理图我们知道，只有行电平（KEY1~4的输出电平）为0时，按键按下，KEY5~8才会检测到0。那么我们可以用行扫描的逻辑设计：
+
+1. FPGA按顺序将1到4行中的一行输出为低电平，其余3行为高电平（或高阻态）。
+2. FPGA逐个读取每列引脚（KEY5~8）的电平，若某列为低电平，则说明该行和该列交汇处的按键被按下。
+3. 可以在没有按键按下时，把所有行的输出电平都拉低，直到有按键按下时，重复1~2的步骤扫描。
+
+
+## 4.2 实战演练
+### 4.3.1 系统架构
+``` verilog
+系统框图：
+[Top模块] = {矩阵键盘扫描模块 → 按键上升沿检测模块}
+```
+
+### 4.3.2 模块设计
+
+根据上述原理，设计行扫描矩阵键盘检测模块如下：
+
+#### matrix_key
+```verilog
+module matrix_key #(
+    parameter ROW_NUM = 4,
+    parameter COL_NUM = 4,
+    parameter DEBOUNCE_TIME = 2000,
+    parameter DELAY_TIME = 200
+) (
+    input  wire clk,
+    input  wire rstn,
+    output  reg [ROW_NUM-1:0] row,
+    input  wire [COL_NUM-1:0] col,
+    output  reg [ROW_NUM*COL_NUM-1:0] key_out
+);
+
+    localparam ROW_ACTIVE = 1'b0;   // 行有效电平
+    localparam ROW_INACTIVE = 1'b1; // 行无效电平
+    localparam COL_PRESSED = 1'b0;  // 列按下电平
+    localparam COL_RELEASED = 1'b1; // 列释放电平
+    
+    reg [ROW_NUM-1:0][COL_NUM-1:0] key; // 按键状态寄存器
+
+    reg [2:0] cu_st, nt_st;
+    localparam [2:0] ST_IDLE = 3'b001;
+    localparam [2:0] ST_SCAN = 3'b010;
+    localparam [2:0] ST_DEBOUNCE = 3'b100;
+
+    wire btn_pressed = ((|(~(col ^ {COL_NUM{COL_PRESSED}}))) && (cu_st == ST_IDLE)) || (key_out != 0); // 只要有一个按键按下，btn_pressed为1
+    reg [31:0] delay_cnt; // 延时计数器
+    reg [31:0] debounce_cnt; // 消抖计数器
+    reg [ROW_NUM-1:0] row_cnt; // 行计数器
+
+    always @(posedge clk or negedge rstn) begin
+        if(!rstn) delay_cnt <= 0;
+        else if(cu_st == ST_SCAN) begin
+            if(delay_cnt == DELAY_TIME) delay_cnt <= 0;
+            else delay_cnt <= delay_cnt + 1;
+        end else delay_cnt <= 0;
+    end
+
+    always @(posedge clk or negedge rstn) begin
+        if(!rstn) row_cnt <= 0;
+        else if(cu_st == ST_SCAN) begin
+            if(delay_cnt == DELAY_TIME) row_cnt <= row_cnt + 1;
+            else row_cnt <= row_cnt;
+        end else row_cnt <= 0;
+    end
+
+    always @(posedge clk or negedge rstn) begin
+        if(!rstn) debounce_cnt <= 0;
+        else if(cu_st == ST_DEBOUNCE) begin
+            if(debounce_cnt == DEBOUNCE_TIME) debounce_cnt <= 0;
+            else debounce_cnt <= debounce_cnt + 1;
+        end else debounce_cnt <= 0;
+    end
+
+    /*
+    处理逻辑
+    ROW作为输出，COL作为输入
+    1. ST_IDLE状态，所有ROW都拉至有效电平
+    2. 若没有按键按下，所有COL都为释放电平
+    3. 若有按键按下，按下的按键所在的COL会变为按下电平
+    4. 进入ST_SCAN状态，启动扫描，ROW全部置为无效电平，并逐次改变为有效电平。（此时，COL会都变成列释放电平）
+    5. 如果某一个ROW行有效电平时，COL变成了列按下电平，则说明该ROW和COL交点的按键被按下
+    6. 每一行都扫描一遍。
+    7. 进入ST_DEBOUNCE状态，所有ROW都拉至行有效电平，在此期间不进行扫描。
+    8. DEBOUNCE时间到后，进入IDLE状态。
+    */
+
+    always @(posedge clk or negedge rstn) begin
+        if(!rstn) cu_st <= ST_IDLE;
+        else cu_st <= nt_st;
+    end
+
+    always @(*) begin
+        if(!rstn) nt_st <= ST_IDLE;
+        else case(cu_st)
+            ST_IDLE: begin
+                if(btn_pressed) nt_st <= ST_SCAN;
+                else nt_st <= ST_IDLE;
+            end
+            ST_SCAN: begin
+                if((delay_cnt == DELAY_TIME) && (row_cnt == ROW_NUM-1)) nt_st <= ST_DEBOUNCE;
+                else nt_st <= ST_SCAN;
+            end
+            ST_DEBOUNCE: begin
+                if(debounce_cnt == DEBOUNCE_TIME) nt_st <= ST_IDLE;
+                else nt_st <= ST_DEBOUNCE;
+            end
+            default: nt_st <= ST_IDLE;
+        endcase
+    end
+
+    integer i, j;
+    always @(posedge clk or negedge rstn) begin
+        if(!rstn) key <= 0;
+        else for(i=0; i<ROW_NUM; i=i+1) 
+                for(j=0; j<COL_NUM; j=j+1)
+                    if((cu_st == ST_SCAN) && (delay_cnt == DELAY_TIME) && (row_cnt == i)) key[i][j] <= (col[j] == COL_PRESSED)?(1'b1):(1'b0);
+                    else key[i][j] <= key[i][j]; // 其他情况不变
+    end
+
+    always @(*) begin
+        for(i=0;i<ROW_NUM;i=i+1) begin
+            for(j=0;j<COL_NUM;j=j+1) begin
+                key_out[i*COL_NUM+j] <= key[i][j];
+            end
+        end
+    end
+
+    always @(posedge clk or negedge rstn) begin
+        if(!rstn) row <= {ROW_NUM{ROW_ACTIVE}};
+        else if(cu_st == ST_IDLE && nt_st == ST_SCAN) row <= {{(ROW_NUM-1){ROW_INACTIVE}}, ROW_ACTIVE};
+        else if(cu_st == ST_SCAN) begin
+            if(delay_cnt == DELAY_TIME) row <= {row[ROW_NUM-1:0],ROW_INACTIVE};
+            else row <= row;
+        end else row <= {ROW_NUM{ROW_ACTIVE}};
+    end
+endmodule //matrix_key
+```
+
+为了能够观察到现象，使用板载8个led和实验箱8个led进行显示，按下矩阵键盘的按键，对应led就会亮，顶层文件如下所示：
+
+#### matrix_key_top
+
+```verilog
+module matrix_key_top(
+//system io
+input  wire       external_clk ,
+input  wire       external_rstn,
+
+input  wire [ 3:0] col,
+output wire [ 3:0] row,
+output wire [15:0] led
+);
+
+wire [15:0] key_out;
+
+assign led = key_out;
+matrix_key #(
+	.ROW_NUM       	( 4     ),
+	.COL_NUM       	( 4     ),
+	.DEBOUNCE_TIME 	( 10000 ),
+	.DELAY_TIME    	( 2000  ))
+u_matrix_key(
+	.clk     	( external_clk  ),
+	.rstn    	( external_rstn ),
+	.row     	( row           ),
+	.col     	( col           ),
+	.key_out 	( key_out       )
+);
+endmodule
+```
+
+### 4.3.3 上板验证步骤
+1. 设置参数：CLK_CYCLE=5000（对应200Hz扫描频率）
+2. 绑定管脚：连接led和矩阵键盘管脚
+
+---
+
+## 4.4 章末总结
+**关键收获：**
+1. 掌握矩阵键盘行扫描原理，能看懂原理图
+3. 学习时序控制中计数器的重要作用
+
+---
+
+## 4.5 拓展训练
+
+可以将数码管与矩阵键盘相结合

public/doc/05/doc.md

@@ -0,0 +1,194 @@
+# 基础-5-PWM呼吸灯
+
+## 5.1 章节导读
+
+本章将实现 PWM（脉宽调制）呼吸灯效果，即控制 LED 灯的亮度在一个周期内从暗到亮再从亮到暗，形成如人呼吸般的灯光变化。通过该实验可以掌握 PWM 占空比调节以及 FPGA 控制 LED 的基本方法。
+
+## 5.2 理论学习
+
+呼吸灯在我们的生活中很常见，在电脑上多作为消息提醒指示灯而被广泛使用，其效果是小灯在一段时间内从完全熄灭的状态逐渐变到最亮，再在同样的时间段内逐渐达到完全熄灭的状态，并循环往复。这种效果就像“呼吸”一样。而实现”呼吸“的方法就是PWM技术。
+
+PWM（Pulse Width Modulation）是一种常用的控制技术，其核心思想是通过控制一个周期内信号为高电平的时间比例（占空比）来实现输出电压或亮度的变化。也就是说只要我们在小时间段内，led灯的亮度依次增加，然后依次减小，即可实现”呼吸“的效果。
+
+
+
+## 5.3 实战演练
+
+### 5.3.1 实验目标
+
+实现 LED 呼吸灯效果，亮度逐渐变亮再逐渐变暗，周而复始，整体周期约为2秒，视觉上更加自然流畅。
+
+### 5.3.2 硬件资源
+
+实验板提供 32 颗 LED 灯，本实验选用其中的 1 颗绿色 LED 进行 PWM 控制
+
+<div>           <!--块级封装-->
+    <center>    <!--将图片和文字居中-->
+    <img src="./images/1.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:30%"/>
+    <br>        <!--换行-->
+    图1.LED扩展板   <!--标题-->
+    </center>
+</div>
+
+通过原理图可以得知，本试验箱的LED灯为高电平时点亮。
+
+<div>           <!--块级封装-->
+    <center>    <!--将图片和文字居中-->
+    <img src="./images/2.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:40%"/>
+    <br>        <!--换行-->
+    图2.LED扩展板原理图    <!--标题-->
+    </center>
+</div>
+### 5.3.3 程序设计
+
+本模块的设计事实上是两个计数器，所以肯定需要时钟信号sysclk，也需要一个rstn复位信号，同时需要一个IO口驱动LED。所以模块的端口如下表所示：
+
+| 端口名称 | 端口位宽               | 端口类型           |功能描述|
+|:----------:|:----:|:----:|:--------------------:|
+| sysclk | 1Bit | Input | 输入时钟，频率27M |
+| rstn | 1Bit | Input | 复位信号，低电平有效 |
+| led | 1Bit | Output | LED控制信号 |
+
+为了实现一个视觉上柔和自然的 LED 呼吸效果，我们设定完整的呼吸周期为 2 秒，即 LED 亮度在 1 秒内逐渐增强，接着在另 1 秒内逐渐减弱。整个过程由占空比（duty cycle）的变化来控制 PWM 输出的高电平持续时间。
+
+在本设计中，使用实验板的 27MHz 系统时钟。为了获得合适的 PWM 控制精度，我们将一个 PWM 周期设定为 1ms，这对应 27000 个时钟周期（27M ÷ 1000）。通过一个名为 `pwm_cnt` 的计数器来实现这一周期性计数，当 `pwm_cnt` 小于占空比 `duty` 的值时，LED 输出高电平，从而控制亮度。
+
+为了实现“呼吸”变化，我们再设计另一个计数器 `duty`，它每 1ms（即 `pwm_cnt` 计满一次）更新一次。前 1000ms 内占空比逐渐增加，即 `duty` 每次增加，从而输出高电平的时间逐步变长，LED 亮度逐渐增强；后 1000ms 内占空比逐渐减小，每次减小，LED 亮度逐渐变弱。如此循环往复，即可实现 LED 的“柔和呼吸”效果。
+
+那么，占空比 duty 的变化步长如何选择？考虑到：一个 1ms是 27000 个时钟；如果我们希望1ms内led亮的时间为1us的倍数，那么我们可以将27000分成1000份，一份是27。如果duty的每次增减是27，那么也就对应了led每次亮灭的时间增减了1us。也就是说当duty为27时，led亮的时间为1us，1ms过后，duty变为54，led亮的时间为2us，以此类推，当duty为27000时，led亮满1ms。这样就实现了led亮的时间逐渐增加的效果。
+
+模块的参考代码如下所示（`pwm.v`）：
+
+```verilog
+module pwm(
+    input wire sysclk,     // 27MHz 系统时钟
+    input wire rstn,    // 低有效复位
+    output wire led     // PWM 控制LED输出
+);
+
+parameter PWM_PERIOD = 16'd27000;//1ms
+// 单一PWM周期，1ms
+// duty上升的次数是1000次，下降的次数也是1000次，说明pwm的半周期是 1ms * 1000 = 1s
+// pwm的一次全周期是 1s * 2 = 2s
+reg [15:0] pwm_cnt;
+reg [15:0] duty;
+reg inc_dec_flag;//0表示duty+ ，1表示duty-
+//计数器1，不断累加
+always @(posedge sysclk or negedge rstn) begin
+    if (!rstn)
+        pwm_cnt <= 0;
+    else if (pwm_cnt < PWM_PERIOD - 1)
+        pwm_cnt <= pwm_cnt + 1;
+    else
+        pwm_cnt <= 0;
+end
+//计数器2，控制占空比，单一周期结束进行一次累加或者减
+always @(posedge sysclk or negedge rstn) begin
+    if (!rstn)
+        duty <= 0;
+    else if (pwm_cnt == PWM_PERIOD - 1)begin
+        if(inc_dec_flag == 0)
+            duty <= duty + 27;
+        else 
+            duty <= duty - 27;
+    end
+    else duty <= duty;
+end
+//加减的标志位，半周期结束后反转。
+always @(posedge sysclk or negedge rstn) begin
+    if(~rstn)
+        inc_dec_flag <= 0;
+    else if(duty == PWM_PERIOD)
+        inc_dec_flag <= 1;
+    else if(duty == 0)
+        inc_dec_flag <= 0;
+    else 
+        inc_dec_flag <= inc_dec_flag;
+end
+
+assign led = (pwm_cnt < duty) ? 1'b1 : 1'b0;
+endmodule
+```
+
+
+
+### 5.3.4 仿真验证
+
+为了验证模块功能，我们可以编写仿真模块，并将 `PWM_PERIOD` 等比例缩小为270，以便快速验证。以下为仿真文件（`pwm_tb.v`）：
+
+```verilog
+`timescale 1ns/1ns
+module pwm_tb;
+
+    reg sysclk;
+    reg rstn;
+    wire led;
+
+    // 实例化待测试模块
+    pwm #(
+        .PWM_PERIOD(270)//为了减少仿真时间，将单一pwm周期从27000等比例缩小为270
+    ) pwm_inst (
+        .sysclk(sysclk),
+        .rstn(rstn),
+        .led(led)
+      );
+    // 产生系统时钟：周期约为 27Mhz
+    initial begin
+        sysclk = 0;
+        forever #(500/27) sysclk = ~sysclk;
+    end
+
+    // 初始化和复位过程
+    initial begin
+        // 初始化
+        rstn = 0;
+        #100;           // 保持复位100ns
+        rstn = 1;       // 释放复位
+    end
+
+endmodule
+```
+
+同时为了便于仿真，可以直接点击sim文件夹下hebav文件夹中的do.bat文件即可利用ModuleSim对模块进行仿真，仿真波形如下：
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/3.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:60%"/>
+    <br>		<!--换行-->
+    图3.呼吸灯仿真波形（一）	<!--标题-->
+    </center>
+</div>
+
+<div>           <!--块级封装-->
+    <center>    <!--将图片和文字居中-->
+    <img src="./images/4.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:60%"/>
+    <br>        <!--换行-->
+    图4.呼吸灯仿真波形（二）   <!--标题-->
+    </center>
+</div>
+
+通过观察波形我们发现led输出为1的时间在逐步增加之后逐步减小，duty的值从0增加到270后减小，符合设计预期，可以进行下一步上板验证。
+
+### 5.3.5 上板验证
+
+仿真验证通过后，即可进行上板测试。在实际使用时需要进行管脚约束。以下为参考端口与分配示例：
+
+| 端口名称 | 信号类型 | 对应管脚 | 功能               |
+| -------- | -------- | -------- | ------------------ |
+| clk      | Input    |          | 27MHz时钟          |
+| rstn     | Input    |          | 复位               |
+| led      | Output   |          | 输出PWM信号连接LED |
+
+完成管脚绑定后生成 `.sbit` 文件，上传到实验平台后进行烧录，即可在摄像头画面中看到 LED 呼吸闪烁效果。
+
+## 5.4 章末总结
+
+本章我们学习了 PWM 控制的基本原理及其在 LED 呼吸灯上的应用，同时通过不断改变PWM占空比方式使呼吸过程更加平滑自然。该方法不仅适用于视觉灯效控制，还广泛应用于马达调速、音量控制等模拟量调节领域。你可以进一步尝试调整占空比范围、节奏速度，甚至扩展到多个 LED 同步/异步呼吸控制，实现更加炫酷的视觉效果。

public/doc/06/doc.md

@@ -0,0 +1,650 @@
+# 基础-6-HDMI显示
+
+## 6.1 章节导读
+
+随着多媒体技术的快速发展，高清显示已成为嵌入式系统与FPGA应用中不可或缺的一部分。HDMI（High-Definition Multimedia Interface）作为目前最主流的视频数字传输标准，广泛应用于电视、显示器、笔记本、摄像头等各类终端设备中。相比传统的模拟VGA接口，HDMI具有传输带宽高、支持音视频同步、无压缩信号传输等优点，能更好地满足现代图像处理和显示系统的需求。
+
+在FPGA开发中，掌握HDMI显示技术不仅是实现图像/视频输出的基础能力，更是后续图像识别、视频监控、图形用户界面（GUI）等复杂系统设计的前提。因此，本实验以HDMI显示为核心内容，带领大家从零开始构建一个完整的视频输出链路。通过配置显示参数、生成时序控制信号、输出RGB图像数据等关键步骤，最终实现在HDMI接口上稳定输出画面。
+
+在本次实验中我们将学习利用实验板的HDMI接口和MS7210芯片，进行HDMI显示实验的设计。
+
+## 6.2 理论学习
+
+### 6.2.1 VGA时序
+
+VGA显示是在行同步和帧同步（场同步）的信号同步下，按照从上到下，从左到右的顺序，扫描到显示屏上。VGA扫描方式见下图所示：
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/1.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:50%"/>
+    <br>		<!--换行-->
+    图1.VGA扫描顺序	<!--标题-->
+    </center>
+</div>
+
+如上图所示，每一帧图像都是从左上角开始，逐行扫描形成，所以规定最左上角的像素点为第一个像素点，坐标是（0，0），以这个像素为起点，向右x坐标逐渐增大，向下y坐标逐渐增大，重复若干次后扫描到右下角完成一帧图像的扫描，扫描完成后进行图像消隐，随后指针跳回左上角重新进行新一帧的扫描。
+
+ 在扫描的过程中会对每一个像素点进行单独赋值，使每个像素点显示对应色彩信息，当扫描速度足够快，加之人眼的视觉暂留特性，我们会看到一幅完整的图片，这就是VGA 显示的原理。
+
+VGA显示除了要有像素点的信息，还需要有行同步（HSync）和场同步（VSync）两个信号辅助显示。行同步信号规定了一行像素的开始与结束，场同步信号规定了一帧图像的开始与结束。在VESA DMT 1.12版本的标准文档中给出的VGA时序图如下图所示：
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/2.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:100%"/>
+    <br>		<!--换行-->
+    图2.VGA标准时序	<!--标题-->
+    </center>
+</div>
+
+行同步时序如下图所示：
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/3.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:100%"/>
+    <br>		<!--换行-->
+    图3.行同步时序	<!--标题-->
+    </center>
+</div>
+
+行同步的一个扫周期要经过6个部分，分别是Sync（同步）、 Back Porch（后沿）、 Left Border（左边框）、 “Addressable” Video（有效图像）、 Right Border（右边框）、 Front Porch（前沿），这些过程的长度都是以像素为单位的，也就是以像素时钟为单位，例如Sync的值为96，也就意味着Sync阶段要经历96个像素时钟。HSync信号会在Sync同步阶段拉高（不同的芯片可能有不同标准）以确定新一行的开始与上一行的结束。而完整的一行像素很多，但有效的真正能显示在屏幕上的像素只有 “Addressable” Video（有效图像）部分的像素，其他阶段的像素均无效，无法显示在屏幕中。
+
+场同步时序如下图所示：
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/4.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:100%"/>
+    <br>		<!--换行-->
+    图4.场同步时序	<!--标题-->
+    </center>
+</div>
+
+场同步时序与行同步时序相同，也是分为6个部分，在Sync同步阶段拉高，标志着一帧的结束和新一帧的开始，其中像素只有在“Addressable” Video（有效图像）阶段才有效，其他阶段均无效。而场同步信号的基本单位是行，比如Sync的值为2，也就意味着Sync同步阶段要经历两行。
+
+那么我们将行同步和场同步信号结合起来，遍可以得到一帧图像的样貌，如下图所示：
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/5.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:100%"/>
+    <br>		<!--换行-->
+    图5.一帧图像组成示意图	<!--标题-->
+    </center>
+</div>
+
+可以看到在行场同步信号构成了一个二维坐标系，原点在左上方，中间遍形成了一帧图像，而真正能显示在屏幕中的图像只有 “Addressable” Video（有效图像）部分。
+
+现在我们知道了行同步和场同步都要经历6个部分，那么这些部分的长度都是如何规定的呢？VGA 行时序对行同步时间、 消隐时间、 行视频有效时间和行前肩时间有特定的规范， 场时序也是如此。 常用VGA 分辨率时序参数如下表所示：
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/6.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:100%"/>
+    <br>		<!--换行-->
+    图6.常用VGA分辨率时序参数	<!--标题-->
+    </center>
+</div>
+
+### 6.2.2 MS7210芯片
+
+MS7210是一款HD发送芯片，支持4K@30Hz的视频3D传输格式。可以支持的最高分辨率高达4K@30Hz，最高采样率达到300MHz。MS7210支持YUV和RGB 之间的色彩空间转换，数字接口支持YUV以及RGB格式输入。MS7210的IIS接口以及S/PDIF 接口支持高清音频的传输，其中S/PDIF接口既可以兼容IEC61937标准下的压缩音频传输，同时还支持高比特音频（HBR）的传输，在高比特音频（HBR）模式下，音频采样率最高为768KHz。MS7210的IIC 地址可以根据SA引脚进行选择。当 SA引脚上拉到电源电压或者悬空时，地址为 OxB2。当 SA 引脚连接到 GND 时，地址为0x56。
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/7.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:100%"/>
+    <br>		<!--换行-->
+    图7.MS7210芯片	<!--标题-->
+    </center>
+</div>
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/8.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:50%"/>
+    <br>		<!--换行-->
+    图8.MS7210功能框图	<!--标题-->
+    </center>
+</div>
+
+MS7210芯片可以通过IIC协议对内部寄存器进行配置，有关芯片寄存器配置需要向芯片厂家进行申请。
+
+## 6.3 实战演练
+
+### 6.3.1实验目标
+
+### 6.3.2硬件资源
+
+实验板共有一个HDMI-OUT接口，由MS7210驱动，一个HDMI-IN接口，由MS7200驱动。
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/9.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:30%"/>
+    <br>		<!--换行-->
+    图9.板载HDMI芯片	<!--标题-->
+    </center>
+</div>
+
+
+实验箱配备一个小型HDMI显示器，该显示器HDMI接口与HDMI-OUT接口连接，图像可以显示在显示屏中，通过摄像头可以在网站观察现象
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/xxx.png"
+         alt="实验箱显示器"
+         style="zoom:40%"/>
+    <br>		<!--换行-->
+    图10.实验箱显示器	<!--标题-->
+    </center>
+</div>
+
+
+### 6.3.3程序设计
+
+在设计程序时，我们先对本实验工程有一个整体认知，首先来看一下HDMI彩条显示实验的整体框图。
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/xxxx.png"
+         alt="实验箱显示器"
+         style="zoom:40%"/>
+    <br>		<!--换行-->
+    图11.HDMI彩条显示整体框图	<!--标题-->
+    </center>
+</div>
+
+可见整个实验一共由好多个模块组成，下面是各个模块简介
+| 模块名称 |功能描述| 备注 |
+|:----:|:----:|:----:|
+| hdmi_top | 顶层模块 ||
+| ms7210_ctrl_iic_top | ms7210芯片配置和iic顶层模块 |参考小眼睛例程|
+| ms7210_ctl | ms7210芯片配置和时序控制模块 |使用小眼睛例程|
+| iic_dri | iic驱动模块 |使用小眼睛例程|
+| vga_ctrl | vga时序信号生成模块 |参考野火例程|
+| vga_pic | vga像素数据生成模块 |参考野火例程|
+
+本次实验主要完成vga_ctrl和vga_pic模块的设计。
+
+对于vga_ctrl模块，我们主要完成hsync，vsync信号，xy坐标，数据有效rgb_valid信号的设计。经过我们前面的学习已经对vga时序有了一定的了解，我们可以想象到这几个信号也只是一种计数器而已。
+
+本实验要实现640x480的彩条显示，相关参数如下所示：
+
+```Verilog
+//parameter define
+parameter H_SYNC    =   10'd96  ,   //行同步
+          H_BACK    =   10'd40  ,   //行时序后沿
+          H_LEFT    =   10'd8   ,   //行时序左边框
+          H_VALID   =   10'd640 ,   //行有效数据
+          H_RIGHT   =   10'd8   ,   //行时序右边框
+          H_FRONT   =   10'd8   ,   //行时序前沿
+          H_TOTAL   =   10'd800 ;   //行扫描周期
+parameter V_SYNC    =   10'd2   ,   //场同步
+          V_BACK    =   10'd25  ,   //场时序后沿
+          V_TOP     =   10'd8   ,   //场时序上边框
+          V_VALID   =   10'd480 ,   //场有效数据
+          V_BOTTOM  =   10'd8   ,   //场时序下边框
+          V_FRONT   =   10'd2   ,   //场时序前沿
+          V_TOTAL   =   10'd525 ;   //场扫描周期
+```
+
+首先设计两个计数器`cnt_h`和`cnt_v`分别对像素和行进行计数，一个像素时钟过后`cnt_h`加一，一行过后`cnt_v`加一，扫描完一帧之后，计数器归零。
+
+而其他的状态信号则可以根据计数器的计数进行设计。hsync信号只要`cnt_h < H_SYNC`就拉高，vsync信号类似。当计数到有效数据部分数据有效信号rgb_valid就可以拉高，注意，由于时序逻辑有一个时钟周期的反应时间，所以xy的坐标变化比rgb_valid提前一个时钟周期。参考代码如下所示：
+
+```verilog
+`timescale  1ns/1ns
+////////////////////////////////////////////////////////////////////////
+// Author        : EmbedFire
+// 实验平台: 野火FPGA系列开发板
+// 公司    : http://www.embedfire.com
+// 论坛    : http://www.firebbs.cn
+// 淘宝    : https://fire-stm32.taobao.com
+////////////////////////////////////////////////////////////////////////
+
+module  vga_ctrl
+(
+    input   wire            vga_clk     ,   //输入工作时钟,频率25MHz
+    input   wire            sys_rst_n   ,   //输入复位信号,低电平有效
+    input   wire    [15:0]  pix_data    ,   //输入像素点色彩信息
+
+    output  wire    [11:0]  pix_x       ,   //输出VGA有效显示区域像素点X轴坐标
+    output  wire    [11:0]  pix_y       ,   //输出VGA有效显示区域像素点Y轴坐标
+    output  wire            hsync       ,   //输出行同步信号
+    output  wire            vsync       ,   //输出场同步信号
+    output  wire            rgb_valid   ,
+    output  wire    [15:0]  rgb             //输出像素点色彩信息
+);
+
+//********************************************************************//
+//****************** Parameter and Internal Signal *******************//
+//********************************************************************//
+//parameter define
+parameter H_SYNC    =   10'd96  ,   //行同步
+          H_BACK    =   10'd40  ,   //行时序后沿
+          H_LEFT    =   10'd8   ,   //行时序左边框
+          H_VALID   =   10'd640 ,   //行有效数据
+          H_RIGHT   =   10'd8   ,   //行时序右边框
+          H_FRONT   =   10'd8   ,   //行时序前沿
+          H_TOTAL   =   10'd800 ;   //行扫描周期
+parameter V_SYNC    =   10'd2   ,   //场同步
+          V_BACK    =   10'd25  ,   //场时序后沿
+          V_TOP     =   10'd8   ,   //场时序上边框
+          V_VALID   =   10'd480 ,   //场有效数据
+          V_BOTTOM  =   10'd8   ,   //场时序下边框
+          V_FRONT   =   10'd2   ,   //场时序前沿
+          V_TOTAL   =   10'd525 ;   //场扫描周期
+
+//wire  define
+wire            pix_data_req    ;   //像素点色彩信息请求信号
+
+//reg   define
+reg     [11:0]  cnt_h           ;   //行同步信号计数器
+reg     [11:0]  cnt_v           ;   //场同步信号计数器
+
+//********************************************************************//
+//***************************** Main Code ****************************//
+//********************************************************************//
+
+//cnt_h:行同步信号计数器
+always@(posedge vga_clk or negedge sys_rst_n)
+    if(sys_rst_n == 1'b0)
+        cnt_h   <=  12'd0   ;
+    else    if(cnt_h == H_TOTAL - 1'd1)
+        cnt_h   <=  12'd0   ;
+    else
+        cnt_h   <=  cnt_h + 1'd1   ;
+
+//hsync:行同步信号
+assign  hsync = (cnt_h  <=  H_SYNC - 1'd1) ? 1'b1 : 1'b0  ;
+
+//cnt_v:场同步信号计数器
+always@(posedge vga_clk or negedge sys_rst_n)
+    if(sys_rst_n == 1'b0)
+        cnt_v   <=  12'd0 ;
+    else    if((cnt_v == V_TOTAL - 1'd1) &&  (cnt_h == H_TOTAL-1'd1))
+        cnt_v   <=  12'd0 ;
+    else    if(cnt_h == H_TOTAL - 1'd1)
+        cnt_v   <=  cnt_v + 1'd1 ;
+    else
+        cnt_v   <=  cnt_v ;
+
+//vsync:场同步信号
+assign  vsync = (cnt_v  <=  V_SYNC - 1'd1) ? 1'b1 : 1'b0  ;
+
+//rgb_valid:VGA有效显示区域
+assign  rgb_valid = (((cnt_h >= H_SYNC + H_BACK + H_LEFT)
+                    && (cnt_h < H_SYNC + H_BACK + H_LEFT + H_VALID))
+                    &&((cnt_v >= V_SYNC + V_BACK + V_TOP)
+                    && (cnt_v < V_SYNC + V_BACK + V_TOP + V_VALID)))
+                    ? 1'b1 : 1'b0;
+
+//pix_data_req:像素点色彩信息请求信号,超前rgb_valid信号一个时钟周期
+assign  pix_data_req = (((cnt_h >= H_SYNC + H_BACK + H_LEFT - 1'b1)
+                    && (cnt_h < H_SYNC + H_BACK + H_LEFT + H_VALID - 1'b1))
+                    &&((cnt_v >= V_SYNC + V_BACK + V_TOP)
+                    && (cnt_v < V_SYNC + V_BACK + V_TOP + V_VALID)))
+                    ? 1'b1 : 1'b0;
+
+//pix_x,pix_y:VGA有效显示区域像素点坐标
+assign  pix_x = (pix_data_req == 1'b1)
+                ? (cnt_h - (H_SYNC + H_BACK + H_LEFT - 1'b1)) : 12'hfff;
+assign  pix_y = (pix_data_req == 1'b1)
+                ? (cnt_v - (V_SYNC + V_BACK + V_TOP)) : 12'hfff;
+
+//rgb:输出像素点色彩信息
+assign  rgb = (rgb_valid == 1'b1) ? pix_data : 16'b0 ;
+
+endmodule
+```
+
+对于vga_pic模块，我们可以根据x坐标范围（0~639）分成十份，每一份输出不同的颜色。参考代码如下所示：
+
+```verilog
+`timescale  1ns/1ns
+////////////////////////////////////////////////////////////////////////
+// Author        : EmbedFire
+// 实验平台: 野火FPGA系列开发板
+// 公司    : http://www.embedfire.com
+// 论坛    : http://www.firebbs.cn
+// 淘宝    : https://fire-stm32.taobao.com
+////////////////////////////////////////////////////////////////////////
+
+module  vga_pic
+(
+    input   wire            vga_clk     ,   //输入工作时钟,频率25MHz
+    input   wire            sys_rst_n   ,   //输入复位信号,低电平有效
+    input   wire    [11:0]  pix_x       ,   //输入VGA有效显示区域像素点X轴坐标
+    input   wire    [11:0]  pix_y       ,   //输入VGA有效显示区域像素点Y轴坐标
+
+    output  reg     [15:0]  pix_data        //输出像素点色彩信息
+);
+
+//********************************************************************//
+//****************** Parameter and Internal Signal *******************//
+//********************************************************************//
+//parameter define
+parameter   H_VALID =   12'd640 ,   //行有效数据
+            V_VALID =   12'd480 ;   //场有效数据
+
+parameter   RED     =   16'hF800,   //红色
+            ORANGE  =   16'hFC00,   //橙色
+            YELLOW  =   16'hFFE0,   //黄色
+            GREEN   =   16'h07E0,   //绿色
+            CYAN    =   16'h07FF,   //青色
+            BLUE    =   16'h001F,   //蓝色
+            PURPPLE =   16'hF81F,   //紫色
+            BLACK   =   16'h0000,   //黑色
+            WHITE   =   16'hFFFF,   //白色
+            GRAY    =   16'hD69A;   //灰色
+
+//********************************************************************//
+//***************************** Main Code ****************************//
+//********************************************************************//
+//pix_data:输出像素点色彩信息,根据当前像素点坐标指定当前像素点颜色数据
+always@(posedge vga_clk or negedge sys_rst_n)
+    if(sys_rst_n == 1'b0)
+        pix_data    <= 16'd0;
+    else    if((pix_x >= 0) && (pix_x < (H_VALID/10)*1))
+        pix_data    <=  RED;
+    else    if((pix_x >= (H_VALID/10)*1) && (pix_x < (H_VALID/10)*2))
+        pix_data    <=  ORANGE;
+    else    if((pix_x >= (H_VALID/10)*2) && (pix_x < (H_VALID/10)*3))
+        pix_data    <=  YELLOW;
+    else    if((pix_x >= (H_VALID/10)*3) && (pix_x < (H_VALID/10)*4))
+        pix_data    <=  GREEN;
+    else    if((pix_x >= (H_VALID/10)*4) && (pix_x < (H_VALID/10)*5))
+        pix_data    <=  CYAN;
+    else    if((pix_x >= (H_VALID/10)*5) && (pix_x < (H_VALID/10)*6))
+        pix_data    <=  BLUE;
+    else    if((pix_x >= (H_VALID/10)*6) && (pix_x < (H_VALID/10)*7))
+        pix_data    <=  PURPPLE;
+    else    if((pix_x >= (H_VALID/10)*7) && (pix_x < (H_VALID/10)*8))
+        pix_data    <=  BLACK;
+    else    if((pix_x >= (H_VALID/10)*8) && (pix_x < (H_VALID/10)*9))
+        pix_data    <=  WHITE;
+    else    if((pix_x >= (H_VALID/10)*9) && (pix_x < H_VALID))
+        pix_data    <=  GRAY;
+    else
+        pix_data    <=  BLACK;
+
+endmodule
+```
+
+在顶层模块，我们首先要利用PLL ip核生成iic的驱动时钟进行初始化，由于ms7210芯片的需要，我们通过计数设置一个延迟复位信号，由于我们的彩条颜色是按照RGB565格式生成的，所以需要向RGB888进行转换，只需要填0补位即可，同时由于板载时钟是27M与25.175M相差不大，所以直接使用板载时钟作为像素时钟输出。然后我们将输出的行场同步信号，像素时钟，像素数据，像素数据有效信号等与模块相连接即可完成设计。顶层模块参考代码如下：
+
+```Verilog
+`timescale 1ns / 1ns
+module hdmi_top(
+    input wire          sys_clk       ,// input system clock 50MHz   
+    input               rstn_in       , 
+    output              rstn_out      ,
+    output              hd_scl        ,
+    inout               hd_sda        ,
+    output              led_int       ,
+
+//hdmi_out 
+    output              pixclk_out    ,//pixclk                           
+    output  wire        vs_out        , 
+    output  wire        hs_out        , 
+    output  wire        de_out        ,
+    output  wire [7:0]  r_out         , 
+    output  wire [7:0]  g_out         , 
+    output  wire [7:0]  b_out         
+
+);
+wire                        cfg_clk    ;
+wire                        locked     ;
+wire                        rstn       ;
+wire                        init_over  ;
+reg  [15:0]                 rstn_1ms   ;
+//**********************************************//
+//*****************MS7210初始化******************//
+//**********************************************//
+//**************仿真时不编译此部分***************//
+`ifndef SIM
+//初始化成功标志
+assign    led_int    =     init_over;
+//生成10M IIC时钟
+PLL u_pll (
+  .clkout0(cfg_clk),    // output
+  .lock(locked),          // output
+  .clkin1(sys_clk)       // input
+);
+//ms7210初始化模块
+ms7210_ctrl_iic_top ms7210_ctrl_iic_top_inst(
+    .clk         (  cfg_clk    ), //input       clk,
+    .rst_n       (  rstn_out   ), //input       rstn,
+                        
+    .init_over   (  init_over  ), //output      init_over,
+    .iic_scl     (  hd_scl    ), //output      iic_scl,
+    .iic_sda     (  hd_sda    )  //inout       iic_sda
+);
+//延迟复位
+always @(posedge cfg_clk)
+begin
+	if(!locked)
+	    rstn_1ms <= 16'd0;
+	else
+	begin
+		if(rstn_1ms == 16'h2710)
+		    rstn_1ms <= rstn_1ms;
+		else
+		    rstn_1ms <= rstn_1ms + 1'b1;
+	end
+end
+assign rstn_out = (rstn_1ms == 16'h2710) && rstn_in;
+//**********************************************//
+`else
+assign led_int  =     1;
+assign rstn_out = rstn_in;
+
+`endif
+//**********************************************//
+//**********************************************//
+//**********************************************//
+//**********************************************//
+wire [15:0] rgb565;
+wire [15:0] pix_data ;
+wire [11:0] pix_x;
+wire [11:0] pix_y;
+//vga行场同步控制模块
+vga_ctrl  vga_ctrl_inst (
+    .vga_clk        (sys_clk        ),
+    .sys_rst_n      (rstn_out       ),
+    .pix_data       (pix_data       ),
+    .pix_x          (pix_x          ),
+    .pix_y          (pix_y          ),
+    .hsync          (hs_out         ),
+    .vsync          (vs_out         ),
+    .rgb_valid      (de_out         ),
+    .rgb            (rgb565         )
+  );
+//彩条数据生成模块
+vga_pic  vga_pic_inst (
+    .vga_clk        (sys_clk        ),
+    .sys_rst_n      (rstn_out       ),
+    .pix_x          (pix_x          ),
+    .pix_y          (pix_y          ),
+    .pix_data_out   (pix_data       )
+  );
+//RGB565转RGB888
+    assign pixclk_out   =  sys_clk    ;//直接使用27M时钟，与25.175相差不大
+    assign r_out = {rgb565[15:11],3'b0};
+    assign g_out = {rgb565[10: 5],2'b0};
+    assign b_out = {rgb565[ 4: 0],3'b0};
+endmodule
+```
+
+
+
+### 6.3.4仿真验证
+
+由于仿真不需要对MS7210芯片进行初始化，所以我们在top文件中加入条件编译指令，并且在仿真文件中定义SIM宏，那么就可以在仿真中不编译ms7210初始化相关代码，只对vga时序进行仿真。我们只需要提供时钟和复位，即可对模块进行仿真。仿真文件如下所示：
+
+```verilog
+`timescale 1ns / 1ns
+`define SIM
+module hdmi_top_tb;
+
+  // Parameters
+
+  //Ports
+  reg  sys_clk;
+  reg rstn_in;
+  wire rstn_out;
+  wire hd_scl;
+  wire hd_sda;
+  wire led_int;
+  wire pixclk_out;
+  wire  vs_out;
+  wire  hs_out;
+  wire  de_out;
+  wire [7:0] r_out;
+  wire [7:0] g_out;
+  wire [7:0] b_out;
+
+  initial begin
+    sys_clk = 0;
+    rstn_in = 0;
+    #100
+    rstn_in = 1;
+  end
+  always #(500/27) sys_clk = ~sys_clk;
+  hdmi_top  hdmi_top_inst (
+    .sys_clk(sys_clk),
+    .rstn_in(rstn_in),
+    .rstn_out(rstn_out),
+    .hd_scl(hd_scl),
+    .hd_sda(hd_sda),
+    .led_int(led_int),
+    .pixclk_out(pixclk_out),
+    .vs_out(vs_out),
+    .hs_out(hs_out),
+    .de_out(de_out),
+    .r_out(r_out),
+    .g_out(g_out),
+    .b_out(b_out)
+  );
+
+endmodule
+```
+
+直接点击sim文件夹下hebav文件夹中的do.bat文件即可利用ModuleSim对模块进行仿真，仿真波形如下：
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/10.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:100%"/>
+    <br>		<!--换行-->
+    图10.仿真波形（一）	<!--标题-->
+    </center>
+</div>
+
+从上图我们可以发现vsync信号拉高了两个行同步信号的长度，与设计相符
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/11.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:100%"/>
+    <br>		<!--换行-->
+    图11.仿真波形（二）	<!--标题-->
+    </center>
+</div>
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/12.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:100%"/>
+    <br>		<!--换行-->
+    图12.仿真波形（三）	<!--标题-->
+    </center>
+</div>
+
+从图11和12中我们可以看到当cnt_h信号计数结束后会恢复0，cnt_v会加一，hsync信号会拉高96个像素时钟（0~95）cnt_h和hsync与设计相符。
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/13.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:100%"/>
+    <br>		<!--换行-->
+    图13.仿真波形（四）	<!--标题-->
+    </center>
+</div>
+
+如图13所示，当cnt_h计数到H_SYNC + H_BACK + H_LEFT，也就是144时，rgb_valid拉高，xy轴坐标比rgb_valid提前一个时钟周期，以便pix_data准备好数据，符合设计。
+
+<div>			<!--块级封装-->
+    <center>	<!--将图片和文字居中-->
+    <img src="./images/14.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:100%"/>
+    <br>		<!--换行-->
+    图14.仿真波形（五）	<!--标题-->
+    </center>
+</div>
+
+从每一行看，每一行被分成了10个部分，每部分像素数据分别对应不同颜色，符合设计要求。可以进行下一步上板验证。
+
+### 6.3.5上板验证
+
+仿真已经通过，可以进行上板验证，上板前要先进行管脚约束。端口与对应管脚如下表所示：
+| 端口名称 |信号类型| 对应管脚|功能|
+|:----:|:----:|:----:|:----:|
+| sysclk | Input | D18 | 27M时钟 |
+|  rstn_in   | Input | C22 | 外部输入复位 |
+| rstn_out | Output | G25 | 输出ms7210复位 |
+| hd_scl | Output | K22 | iic SCL信号 |
+| hd_sda | Output | K23 | iic SDA信号 |
+| led_int | Output | A20 | 配置完成信号 |
+| pixclk_out | Output | G25 | 像素时钟输出 |
+| vs_out | Output | R21 | Vsync输出 |
+| hs_out | Output | R20 | Hsync输出 |
+| de_out | Output | N19 | RGB_valid输出 |
+| r_out[0] | Output | N21 | RGB888输出 |
+| r_out[1] | Output | L23 | RGB888输出 |
+| r_out[2] | Output | L22 | RGB888输出 |
+| r_out[3] | Output | L25 | RGB888输出 |
+| r_out[4] | Output | L24 | RGB888输出 |
+| r_out[5] | Output | K26 | RGB888输出 |
+| r_out[6] | Output | K25 | RGB888输出 |
+| r_out[7] | Output | P16 | RGB888输出 |
+| g_out[0] | Output | T25 | RGB888输出 |
+| g_out[1] | Output | P25 | RGB888输出 |
+| g_out[2] | Output | R25 | RGB888输出 |
+| g_out[3] | Output | P24 | RGB888输出 |
+| g_out[4] | Output | P23 | RGB888输出 |
+| g_out[5] | Output | N24 | RGB888输出 |
+| g_out[6] | Output | N23 | RGB888输出 |
+| g_out[7] | Output | N22 | RGB888输出 |
+| b_out[0] | Output | P19 | RGB888输出 |
+| b_out[1] | Output | P21 | RGB888输出 |
+| b_out[2] | Output | P20 | RGB888输出 |
+| b_out[3] | Output | M22 | RGB888输出 |
+| b_out[4] | Output | M21 | RGB888输出 |
+| b_out[5] | Output | N18 | RGB888输出 |
+| b_out[6] | Output | R22 | RGB888输出 |
+| b_out[7] | Output | T22 | RGB888输出 |
+
+
+管脚分配可以直接编写.fdc文件，也可以使用PDS内置的工具进行分配。完成管脚分配之后就可以生成sbit文件，将文件提交到网站后点击烧录，即可将sbit下载到实验板中，在摄像头页面即可观察到显示屏中显示出彩条。
+
+## 6.4 章末总结
+
+本次实验主要学习VGA时序的相关知识，并使用HD硬核进行HDMI显示，感兴趣的同学可以尝试使用HDMI显示其他图像。

public/doc/11/doc.md

@@ -0,0 +1,400 @@
+# 进阶-1-密码锁实验
+
+## 1.1 章节导读
+本章作为进阶的第一个实验，主要学习状态机的写法和使用，同时联系前面所学的数码管和矩阵键盘，完成一个密码锁的设计。
+
+
+## 1.2 理论学习
+### 1.2.1 FSM状态机
+
+在数字逻辑设计中，**有限状态机（FSM, Finite State Machine）**是一种根据输入和当前状态决定下一个状态和输出的模型，广泛用于顺序逻辑电路的控制部分。
+
+在本实验中，我们将使用 FSM 构建密码锁的控制逻辑，用于管理**按键输入过程、密码比对、开锁显示、错误处理等多个步骤**。
+
+FSM 通常包含以下几个组成部分：
+
+- **状态定义（State）**：用来描述系统当前所处的逻辑阶段。例如：待输入、输入中、校验中、成功、失败等。
+
+- **状态转移条件（Transition）**：根据输入信号（如按键、定时器、复位）从一个状态跳转到另一个状态。
+
+- **输出控制（Output）**：每个状态下系统应有的行为，比如更新数码管、检测密码、拉高开锁信号等。
+
+常见的 FSM 类型包括：
+
+- **Moore 状态机：**输出只与当前状态有关，结构更稳定；
+- **Mealy 状态机：**输出与当前状态和输入有关，反应更灵敏。
+
+在本例中我们要设计一个状态机去对密码锁进行控制。首先我们应该先给密码锁分一下他会处于什么状态，每个状态有什么输出（本例中将密码锁设计成下述4个状态）：
+
+1. SETUP状态：该状态下可以设置4位密码，输入4位数字后按#键设置密码有效，*清空设置，数码管输出4位数字输入
+2. LOCK状态：锁定状态，可以输入密码解锁，按#确定，*键清空输入，数码管输出4位数字输入
+3. ERROR状态：如果输入密码错误，或者操作错误，进入此状态，数码管输出ERROR
+4. UNLOCK状态：解锁状态，可以按*重设密码，也可以按#重新锁定，数码管输出UNLOCK
+
+然后确定状态之间如何进行转移：
+
+1. SETUP状态：输入4位数字后按#键设置密码有效，有效后进入LOCK状态
+2. LOCK状态：输入密码，按#确定后如果密码正确进入UNLOCK状态，如果错误进入ERROR状态
+3. ERROR状态：按下任意按键后进入LOCK状态
+4. UNLOCK状态：按下#键进入LOCK状态，按*键进入SETUP状态重设密码
+
+根据上述状态转移逻辑，我们可以画出状态转移图，状态转移图如下图所示：
+
+<div>           <!--块级封装-->
+    <center>    <!--将图片和文字居中-->
+    <img src="./images/1.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:100%"/>
+    <br>        <!--换行-->
+    图1.状态转移图  <!--标题-->
+    </center>
+</div>
+
+我们已经了解了本次实验所使用的状态机，那么如何使用verilog编写状态机呢？主要有三种方法，分别是：三段式状态机，二段式状态机，一段式状态机。
+
+三段式状态机写法如下：
+
+- 状态机第一段，时序逻辑，非阻塞赋值，传递寄存器的状态。
+- 状态机第二段，组合逻辑，阻塞赋值，根据当前状态和当前输入，确定下一个状态机的状态。
+- 状态机第三代，时序逻辑，非阻塞赋值，因为是 Mealy 型状态机，根据当前状态和当前输入，确定输出信号。
+
+二段式状态机将三段式状态机二三段糅合在一起，一段式状态机则将三段式状态机三段融合。推荐使用三段式状态机，只有在状态转移逻辑非常简单，状态很少时会采用一段式状态机。
+
+### 1.2.2 数码管
+
+见基础实验3
+
+### 1.2.3 矩阵键盘
+
+见基础实验4
+
+## 1.3 实战演练
+### 1.3.1 系统架构
+``` verilog
+系统框图：
+```
+
+### 1.3.2 模块设计
+首先是密码锁状态机逻辑，本例采用三段式状态机写法。代码如下：
+
+#### password_lock
+
+```verilog
+module password_lock(
+    input  wire clk,
+    input  wire rstn,
+    input  wire [15:0] key_trigger,
+    output  reg [8*8-1:0] assic_seg,
+    output wire [7:0] seg_point
+);
+
+/*
+    K00   K01   K02   K03   |   1   2   3   A
+                            |
+    K04   K05   K06   K07   |   4   5   6   B   
+                            |
+    K08   K09   K10   K11   |   7   8   9   C
+                            |
+    K12   K13   K14   K15   |   *   0   #   D
+*/
+
+/*
+密码锁状态机设定：
+1. SETUP状态 ：设置密码，按*清空输入，按#确认输入进入LOCK状态，不足4位#键无效
+2. LOCK状态  ：锁定状态，按*清空输入，按#确认输入，不足4位#键无效，密码正确解锁，错误则进入ERROR状态
+3. ERROR状态 ：密码错误状态，按任意键返回LCOK状态
+4. UNLOCK状态：解锁状态，按*重设密码，按#重新锁定，其余键无效
+
+1-D键为输入
+*为清空之前的输入
+#为确认输入
+
+*/
+
+wire flag_setup_password;
+wire flag_input_pass;
+wire flag_input_confirm;
+wire flag_error_return;
+wire flag_relock;
+wire flag_reset;
+
+localparam [2:0] ST_SETUP  = 3'b001;
+localparam [2:0] ST_LOCK   = 3'b010;
+localparam [2:0] ST_ERROR  = 3'b100;
+localparam [2:0] ST_UNLOCK = 3'b101;
+
+reg [2:0] cu_st, nt_st;
+reg [4*4-1:0] password, input_password;
+reg [2:0] input_num;
+
+assign flag_setup_password = (cu_st == ST_SETUP) && (key_trigger[14]) && (input_num == 3'b100);
+assign flag_input_confirm  = (cu_st == ST_LOCK) && (key_trigger[14]) && (input_num == 3'b100);
+assign flag_input_pass     = (cu_st == ST_LOCK) && (password == input_password) && (input_num == 3'b100);
+assign flag_error_return   = (cu_st == ST_ERROR) && (|key_trigger);
+assign flag_relock         = (cu_st == ST_UNLOCK) && (key_trigger[14]);
+assign flag_reset          = (cu_st == ST_UNLOCK) && (key_trigger[12]);
+//状态机第一段，传递寄存器状态
+always @(posedge clk or negedge rstn) begin
+    if(~rstn) cu_st <= ST_SETUP;
+    else cu_st <= nt_st;
+end
+//状态机第二段，确定下一个状态机状态
+always @(*) begin
+    case(cu_st)
+        ST_SETUP : nt_st <= (flag_setup_password)?(ST_LOCK):(ST_SETUP);
+        ST_LOCK  : nt_st <= (flag_input_confirm)?((flag_input_pass)?(ST_UNLOCK):(ST_ERROR)):(ST_LOCK);
+        ST_ERROR : nt_st <= (flag_error_return)?(ST_LOCK):(ST_ERROR);
+        ST_UNLOCK: nt_st <= (flag_relock)?(ST_LOCK):((flag_reset)?(ST_SETUP):(ST_UNLOCK));
+        default  : nt_st <= ST_SETUP;
+    endcase
+end
+//状态机第三段，根据状态和输入确定输出，这里由于信号较多，分了多个always块，也可以用case语句写在同一个always块中
+always @(posedge clk or negedge rstn) begin
+    if(~rstn) password <= 0;
+    else if((cu_st == ST_SETUP) && (input_num != 3'b100)) begin
+             if(key_trigger[00]) password <= {password[0+:3*4], 4'h1};
+        else if(key_trigger[01]) password <= {password[0+:3*4], 4'h2};
+        else if(key_trigger[02]) password <= {password[0+:3*4], 4'h3};
+        else if(key_trigger[03]) password <= {password[0+:3*4], 4'hA};
+        else if(key_trigger[04]) password <= {password[0+:3*4], 4'h4};
+        else if(key_trigger[05]) password <= {password[0+:3*4], 4'h5};
+        else if(key_trigger[06]) password <= {password[0+:3*4], 4'h6};
+        else if(key_trigger[07]) password <= {password[0+:3*4], 4'hB};
+        else if(key_trigger[08]) password <= {password[0+:3*4], 4'h7};
+        else if(key_trigger[09]) password <= {password[0+:3*4], 4'h8};
+        else if(key_trigger[10]) password <= {password[0+:3*4], 4'h9};
+        else if(key_trigger[11]) password <= {password[0+:3*4], 4'hC};
+        else if(key_trigger[12]) password <= 0;
+        else if(key_trigger[13]) password <= {password[0+:3*4], 4'h0};
+        else if(key_trigger[14]) password <= password;
+        else if(key_trigger[15]) password <= {password[0+:3*4], 4'hD};
+        else password <= password;
+    end else password <= password;
+end
+
+always @(posedge clk or negedge rstn) begin
+    if(~rstn) input_password <= 0;
+    else if(cu_st == ST_LOCK) begin
+        if(input_num == 3'b100) input_password <= input_password;
+        else if(key_trigger[00]) input_password <= {input_password[0+:3*4], 4'h1};
+        else if(key_trigger[01]) input_password <= {input_password[0+:3*4], 4'h2};
+        else if(key_trigger[02]) input_password <= {input_password[0+:3*4], 4'h3};
+        else if(key_trigger[03]) input_password <= {input_password[0+:3*4], 4'hA};
+        else if(key_trigger[04]) input_password <= {input_password[0+:3*4], 4'h4};
+        else if(key_trigger[05]) input_password <= {input_password[0+:3*4], 4'h5};
+        else if(key_trigger[06]) input_password <= {input_password[0+:3*4], 4'h6};
+        else if(key_trigger[07]) input_password <= {input_password[0+:3*4], 4'hB};
+        else if(key_trigger[08]) input_password <= {input_password[0+:3*4], 4'h7};
+        else if(key_trigger[09]) input_password <= {input_password[0+:3*4], 4'h8};
+        else if(key_trigger[10]) input_password <= {input_password[0+:3*4], 4'h9};
+        else if(key_trigger[11]) input_password <= {input_password[0+:3*4], 4'hC};
+        else if(key_trigger[12]) input_password <= 0;
+        else if(key_trigger[13]) input_password <= {input_password[0+:3*4], 4'h0};
+        else if(key_trigger[14]) input_password <= input_password;
+        else if(key_trigger[15]) input_password <= {input_password[0+:3*4], 4'hD};
+        else input_password <= input_password;
+    end else input_password <= 0;
+end
+
+always @(posedge clk or negedge rstn) begin
+    if(~rstn) input_num <= 0;
+    else if(cu_st == ST_SETUP || cu_st == ST_LOCK) begin
+        if(flag_setup_password || flag_input_confirm) input_num <= 0;
+        else if(key_trigger[00] || key_trigger[01] || key_trigger[02] || key_trigger[03] ||
+           key_trigger[04] || key_trigger[05] || key_trigger[06] || key_trigger[07] ||
+           key_trigger[08] || key_trigger[09] || key_trigger[10] || key_trigger[11] ||
+                              key_trigger[13]                    || key_trigger[15])
+            input_num <= (input_num < 3'b100)?(input_num + 1):(input_num);
+        else if(key_trigger[12]) input_num <= 0;
+        else input_num <= input_num;
+    end else input_num <= 0;
+end
+
+assign seg_point = 8'b0;
+always @(posedge clk or negedge rstn) begin
+    if(~rstn) assic_seg <= "12345678";
+    else case(cu_st)
+        ST_SETUP :begin
+            assic_seg[0+:8] <= "-";
+            assic_seg[8+:8] <= "-";
+            assic_seg[16+:8] <= (input_num > 0)?(hex2assic(password[0+:4])):("_");
+            assic_seg[24+:8] <= (input_num > 1)?(hex2assic(password[4+:4])):("_");
+            assic_seg[32+:8] <= (input_num > 2)?(hex2assic(password[8+:4])):("_");
+            assic_seg[40+:8] <= (input_num > 3)?(hex2assic(password[12+:4])):("_");
+            assic_seg[48+:8] <= "-";
+            assic_seg[56+:8] <= "-";
+        end
+        ST_LOCK  :begin
+            assic_seg[0+:8] <= "=";
+            assic_seg[8+:8] <= "=";
+            assic_seg[16+:8] <= (input_num > 0)?(hex2assic(input_password[0+:4])):("-");
+            assic_seg[24+:8] <= (input_num > 1)?(hex2assic(input_password[4+:4])):("-");
+            assic_seg[32+:8] <= (input_num > 2)?(hex2assic(input_password[8+:4])):("-");
+            assic_seg[40+:8] <= (input_num > 3)?(hex2assic(input_password[12+:4])):("-");
+            assic_seg[48+:8] <= "=";
+            assic_seg[56+:8] <= "=";
+        end
+        ST_ERROR : assic_seg <= "  ERROR ";
+        ST_UNLOCK: assic_seg <= " unlock ";
+        default  : assic_seg <= "12345678";
+    endcase
+end
+
+
+function [7:0] hex2assic;
+    input [3:0] hex;
+    case(hex)
+        4'h0: hex2assic = "0"; // 0
+        4'h1: hex2assic = "1"; // 1
+        4'h2: hex2assic = "2"; // 2
+        4'h3: hex2assic = "3"; // 3
+        4'h4: hex2assic = "4"; // 4
+        4'h5: hex2assic = "5"; // 5
+        4'h6: hex2assic = "6"; // 6
+        4'h7: hex2assic = "7"; // 7
+        4'h8: hex2assic = "8"; // 8
+        4'h9: hex2assic = "9"; // 9
+        4'hA: hex2assic = "A"; // A
+        4'hB: hex2assic = "B"; // B
+        4'hC: hex2assic = "C"; // C
+        4'hD: hex2assic = "D"; // D
+        4'hE: hex2assic = "E"; // E
+        4'hF: hex2assic = "F"; // F
+        default: hex2assic = " ";
+    endcase
+endfunction
+
+endmodule //password_lock
+```
+
+矩阵键盘行扫描模块在前面基础实验已经介绍过，但这次实验还需要为矩阵键盘添加按键上升沿检测模块，代码如下：
+
+#### matrix_key_trigger
+
+```verilog
+module matrix_key_trigger(
+    input  wire clk,
+    input  wire rstn,
+    input  wire [15:0] key,
+    output wire [15:0] key_trigger
+);
+
+// 按键上升沿捕获模块
+
+reg [15:0] key_d; // 上一时钟周期的按键状态
+reg [15:0] key_d2; // 上两时钟周期的按键状态
+
+assign key_trigger = (key_d) & (~key_d2);
+
+always @(posedge clk or negedge rstn) begin
+    if (!rstn) begin
+        key_d <= 0;
+        key_d2 <= 0;
+    end else begin
+        key_d <= key;
+        key_d2 <= key_d;
+    end
+end
+
+endmodule //matrix_key_decode
+```
+
+至于数码管模块，为了方便，在led_display_driver模块添加了参数定义，并未进行其他修改。
+
+最后将几个模块例化在顶层，将端口相连接，代码如下所示：
+
+#### password_lock_top
+
+```verilog
+
+module password_lock_top #(
+    parameter VALID_SIGNAL = 1'b0,
+    parameter CLK_CYCLE = 5000
+)(
+//system io
+input  wire       external_clk ,
+input  wire       external_rstn,
+
+output wire [7:0] led_display_seg,
+output wire [7:0] led_display_sel,
+
+input  wire [3:0] col,
+output wire [3:0] row
+);
+
+wire [15:0] key_out;
+wire [15:0] key_trigger;
+wire [8*8-1:0] assic_seg;
+wire [7:0] seg_point;
+
+led_display_driver #(
+    .VALID_SIGNAL (VALID_SIGNAL),
+    .CLK_CYCLE (CLK_CYCLE)
+)u_led_display_driver(
+	.clk             	( external_clk    ),
+	.rstn            	( external_rstn   ),
+	.assic_seg       	( assic_seg       ),
+	.seg_point       	( seg_point       ),
+	.led_display_seg 	( led_display_seg ),
+	.led_display_sel 	( led_display_sel )
+);
+
+matrix_key #(
+	.ROW_NUM       	( 4     ),
+	.COL_NUM       	( 4     ),
+	.DEBOUNCE_TIME 	( 10000 ),
+	.DELAY_TIME    	( 2000  ))
+u_matrix_key(
+	.clk     	( external_clk  ),
+	.rstn    	( external_rstn ),
+	.row     	( row           ),
+	.col     	( col           ),
+	.key_out 	( key_out       )
+);
+
+matrix_key_trigger u_matrix_key_trigger(
+	.clk         	( external_clk ),
+	.rstn        	( external_rstn),
+	.key         	( key_out      ),
+	.key_trigger 	( key_trigger  )
+);
+
+password_lock u_password_lock(
+    .clk         	( external_clk ),
+    .rstn        	( external_rstn),
+    .key_trigger 	( key_trigger  ),
+    .assic_seg   	( assic_seg    ),
+	.seg_point   	( seg_point    )
+);
+
+endmodule //led_diaplay_top
+
+```
+
+### 1.3.3 上板验证步骤
+
+---
+
+可以直接将矩阵键盘，数码管的管脚约束文件中的约束复制到本次实验的管脚约束文件中。
+
+将生成的sbit文件烧录好后，即可使用网页界面的虚拟按键进行使用。
+
+## 1.4 章末总结
+
+本章通过设计一个简易密码锁系统，综合运用了前面基础实验中学习的**矩阵键盘扫描**、**数码管显示**等知识，并引入了**有限状态机（FSM）**的设计方法，完成了一个具有较强工程实用性的综合实验。
+
+通过本实验，你应该掌握了以下几点核心能力：
+
+- 理解并运用 状态机进行系统流程控制；
+- 将多个功能模块（键盘、数码管、比较器）整合为一个完整系统；
+- 设计基于状态的控制逻辑，实现密码输入、校验、反馈显示等功能；
+- 理解数字电路系统中控制与数据路径的分离思想。
+
+密码锁系统虽然逻辑简单，但已经具备了完整嵌入式控制系统的基本结构，是后续更复杂项目设计的重要基础。
+
+## 1.5 拓展训练
+
+为了进一步加深对本实验内容的理解，并锻炼系统设计与工程实现能力，你可以尝试完成以下拓展任务：
+
+1. **增加防爆破机制**：限定密码错误尝试次数，例如连续三次错误后锁定一段时间，并在数码管上提示“Err”。
+2. **利用按键实现简易菜单系统**拓展状态机结构，允许通过矩阵键盘导航菜单，如“输入密码”、“查看状态”、“设置新密码”等。

public/doc/13/doc.md

@@ -0,0 +1,350 @@
+# 进阶-3-频率计
+
+## 3.1 章节导读
+
+本实验将基于实验平台设计并实现一个简易频率计，用于测量输入信号的频率值，并通过数码管进行实时显示。实验核心是掌握ADC模块的使用方法，被测信号频率的获取方法及其在数字系统中的处理流程。
+
+## 3.2 理论学习
+
+### 3.2.1 ADC模块
+
+实验平台有一块8bit高速ADDA模块，其中ADC模块使用AD9280芯片，支持最高32MSPS的速率，模拟电压输入范围为-5~+5V，ADC模块可以根据输入电压的大小将其转换为0~255（2的8次方）的数值。模块有一个clk管脚和8个data管脚，data的输入速率和驱动时钟有关，给clk管脚的驱动时钟越快，采样率越高，data的输入速率越高。
+
+<div>           <!--块级封装-->
+    <center>    <!--将图片和文字居中-->
+    <img src="./images/1.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:30%"/>
+    <br>        <!--换行-->
+    图1.ADDA模块示意图   <!--标题-->
+    </center>
+</div>
+
+### 3.2.2 数码管模块
+
+数码管模块在前面基础实验3已经介绍过，这里不再赘述。
+
+## 3.3 实战演练
+
+### 3.3.1实验目标
+
+能够驱动板载ADC模块，对ADC模块的输入数据进行测试，计算输入信号的频率值，并在数码管模块中显示。
+
+### 3.3.2硬件资源
+
+实验所需的信号源来自我们的实验平台，实验平台集成一个以FPGA为基础的dds信号发生器，该dds信号发生器可以输出频率可调的方波，正弦波，三角波，锯齿波等，用户可以在web平台使用并且改变输出波形和频率。
+
+<div>           <!--块级封装-->
+    <center>    <!--将图片和文字居中-->
+    <img src="./images/2.png"
+         alt="无法显示图片时显示的文字"
+         style="zoom:30%"/>
+    <br>        <!--换行-->
+    图2.ADDA实验示意图   <!--标题-->
+    </center>
+</div>
+
+用户接收到信号源之后需自行设计逻辑处理数据并显示。
+
+### 3.3.3程序设计
+
+#### pulse_gen.v
+
+首先用户接收到的是8bit波形数据，要直接利用波形数据计算频率不是很方便，计算频率数据，我们只需要计算其脉冲的个数即可，所以我们设计一个模块，通过设计一个脉冲阈值trig_level，高于阈值的就计算为一次脉冲，输出一个周期的高电平方便后续模块计数，模块代码如下：
+
+```verilog
+module pulse_gen(
+    input           rstn,      //系统复位，低电平有效
+    
+    input  [7:0]    trig_level,
+    input           ad_clk,     //AD9280驱动时钟
+    input  [7:0]    ad_data,    //AD输入数据
+    
+    output          ad_pulse    //输出的脉冲信号
+);
+//因为可能会有抖动，设置一个范围值避免反复触发
+parameter THR_DATA = 3;
+
+//reg define
+reg          pulse;
+reg          pulse_delay;
+
+//*****************************************************
+//**                    main code
+//*****************************************************
+
+assign ad_pulse = pulse & pulse_delay;
+
+//根据触发电平，将输入的AD采样值转换成高低电平
+always @ (posedge ad_clk or negedge rstn)begin
+    if(!rstn)
+        pulse <= 1'b0;
+    else begin
+        if((trig_level >= THR_DATA) && (ad_data < trig_level - THR_DATA))
+            pulse <= 1'b0;
+        else if(ad_data > trig_level + THR_DATA)
+            pulse <= 1'b1;
+    end    
+end
+
+//延时一个时钟周期，用于消除抖动
+always @ (posedge ad_clk or negedge rstn)begin
+    if(!rstn)
+        pulse_delay <= 1'b0;
+    else
+        pulse_delay <= pulse;
+end
+
+endmodule 
+```
+
+#### cymometer.v
+
+下面根据pulse_gen信号生成的脉冲数据进行计数，计算其频率。我们这里采用门控时钟法，用 `clk_fs`（参考时钟）作为时间基准，测量 `clk_fx`（被测信号）的频率。
+
+门控时钟法的原理很简单，也就是在一个**固定时间窗内**（即门控时间 `GATE_TIME`），**计数被测时钟 clk_fx 的上升沿次数**，再结合参考时钟 `clk_fs` 的计数值，就可以算出频率：
+$$
+\text{频率} = \frac{\text{被测脉冲数量}}{\text{门控时间（秒）}} = \frac{fx\_cnt}{fs\_cnt / \text{CLK\_FS}} = \frac{\text{CLK\_FS} \times fx\_cnt}{fs\_cnt}
+$$
+
+| 步骤 | 描述                                                         |
+| ---- | ------------------------------------------------------------ |
+| **1**    | 使用 `clk_fx` 作为计数时钟，控制一个门控时间 `gate` 信号     |
+|  **2**     | 当 `gate` 为高电平时，`fx_cnt_temp` 开始统计 `clk_fx` 的脉冲个数 |
+|  **3**      | 同时将 `gate` 同步到参考时钟 `clk_fs`，并计数 `fs_cnt_temp`，记录 `gate` 高电平持续期间 `clk_fs` 的个数 |
+|  **4**     | 一旦 `gate` 下降沿到来（通过打拍检测），将计数值冻结到 `fx_cnt` 和 `fs_cnt` 中 |
+|  **5**     | 最后用上述表达式计算频率输出。                          |
+
+代码设计如下：
+
+```verilog
+module cymometer
+   #(parameter    CLK_FS = 26'd50_000_000) // 基准时钟频率值
+    (   //system clock
+        input                 clk_fs ,     // 基准时钟信号
+        input                 rstn  ,     // 复位信号
+
+        //cymometer interface
+        input                 clk_fx ,     // 被测时钟信号
+        output   reg [19:0]   data_fx      // 被测时钟频率输出
+);
+
+//parameter define
+localparam   MAX       =  30;              // 定义fs_cnt、fx_cnt的最大位宽
+localparam   GATE_TIME = 16'd2_000;        // 门控时间设置
+
+//reg define
+reg                gate        ;           // 门控信号
+reg                gate_fs     ;           // 同步到基准时钟的门控信号
+reg                gate_fs_r   ;           // 用于同步gate信号的寄存器
+reg                gate_fs_d0  ;           // 用于采集基准时钟下gate下降沿
+reg                gate_fs_d1  ;           // 
+reg                gate_fx_d0  ;           // 用于采集被测时钟下gate下降沿
+reg                gate_fx_d1  ;           // 
+reg    [   58:0]   data_fx_t    ;          // 
+reg    [   15:0]   gate_cnt    ;           // 门控计数
+reg    [MAX-1:0]   fs_cnt      ;           // 门控时间内基准时钟的计数值
+reg    [MAX-1:0]   fs_cnt_temp ;           // fs_cnt 临时值
+reg    [MAX-1:0]   fx_cnt      ;           // 门控时间内被测时钟的计数值
+reg    [MAX-1:0]   fx_cnt_temp ;           // fx_cnt 临时值
+
+//wire define
+wire               neg_gate_fs;            // 基准时钟下门控信号下降沿
+wire               neg_gate_fx;            // 被测时钟下门控信号下降沿
+
+//*****************************************************
+//**                    main code
+//*****************************************************
+
+//边沿检测，捕获信号下降沿
+assign neg_gate_fs = gate_fs_d1 & (~gate_fs_d0);
+assign neg_gate_fx = gate_fx_d1 & (~gate_fx_d0);
+
+//门控信号计数器，使用被测时钟计数
+always @(posedge clk_fx or negedge rstn) begin
+    if(!rstn)
+        gate_cnt <= 16'd0; 
+    else if(gate_cnt == GATE_TIME + 5'd20)
+        gate_cnt <= 16'd0;
+    else
+        gate_cnt <= gate_cnt + 1'b1;
+end
+
+//门控信号，拉高时间为GATE_TIME个实测时钟周期
+always @(posedge clk_fx or negedge rstn) begin
+    if(!rstn)
+        gate <= 1'b0;
+    else if(gate_cnt < 4'd10)
+        gate <= 1'b0;     
+    else if(gate_cnt < GATE_TIME + 4'd10)
+        gate <= 1'b1;
+    else if(gate_cnt <= GATE_TIME + 5'd20)
+        gate <= 1'b0;
+    else 
+        gate <= 1'b0;
+end
+
+//将门控信号同步到基准时钟下
+always @(posedge clk_fs or negedge rstn) begin
+    if(!rstn) begin
+        gate_fs_r <= 1'b0;
+        gate_fs   <= 1'b0;
+    end
+    else begin
+        gate_fs_r <= gate;
+        gate_fs   <= gate_fs_r;
+    end
+end
+
+//打拍采门控信号的下降沿（被测时钟下）
+always @(posedge clk_fx or negedge rstn) begin
+    if(!rstn) begin
+        gate_fx_d0 <= 1'b0;
+        gate_fx_d1 <= 1'b0;
+    end
+    else begin
+        gate_fx_d0 <= gate;
+        gate_fx_d1 <= gate_fx_d0;
+    end
+end
+
+//打拍采门控信号的下降沿（基准时钟下）
+always @(posedge clk_fs or negedge rstn) begin
+    if(!rstn) begin
+        gate_fs_d0 <= 1'b0;
+        gate_fs_d1 <= 1'b0;
+    end
+    else begin
+        gate_fs_d0 <= gate_fs;
+        gate_fs_d1 <= gate_fs_d0;
+    end
+end
+
+ //门控时间内对被测时钟计数
+always @(posedge clk_fx or negedge rstn) begin
+    if(!rstn) begin
+        fx_cnt_temp <= 32'd0;
+        fx_cnt <= 32'd0;
+    end
+    else if(gate)
+        fx_cnt_temp <= fx_cnt_temp + 1'b1;
+    else if(neg_gate_fx) begin
+        fx_cnt_temp <= 32'd0;
+        fx_cnt   <= fx_cnt_temp;
+    end
+end 
+
+//门控时间内对基准时钟计数
+always @(posedge clk_fs or negedge rstn) begin
+    if(!rstn) begin
+        fs_cnt_temp <= 32'd0;
+        fs_cnt <= 32'd0;
+    end
+    else if(gate_fs)
+        fs_cnt_temp <= fs_cnt_temp + 1'b1;
+    else if(neg_gate_fs) begin
+        fs_cnt_temp <= 32'd0;
+        fs_cnt <= fs_cnt_temp;
+    end
+end
+
+//计算被测信号频率
+always @(posedge clk_fs or negedge rstn) begin
+    if(!rstn) begin
+        data_fx_t <= 1'b0;
+    end
+    else if(gate_fs == 1'b0)
+        data_fx_t <= CLK_FS * fx_cnt ;
+end
+
+always @(posedge clk_fs or negedge rstn) begin
+    if(!rstn) begin
+        data_fx <= 20'd0;
+    end
+    else if(gate_fs == 1'b0)
+        data_fx <= data_fx_t / fs_cnt ;
+end
+
+endmodule 
+```
+
+#### frequency_meter.v
+
+由于之前基础实验设计过数码管显示模块，本次实验不在赘述，但因为数码管模块是输入ascii码进行显示的，而现在输出频率数据是一个20bit的二进制数，所以我们应该先想办法将二进制转成ascii码再连接数码管模块进行显示。BCD转ascii码通过查表的方式即可完成。但二进制转BCD码的算法不是特别简单，之后会在基础实验部分讲解。
+
+顶层模块代码如下：
+
+```verilog
+module frequency_meter(
+    input         clk,
+    input         rstn,       // 复位信号
+    output        ad_clk,     // AD时钟
+    input  [7:0]  ad_data,    // AD输入数据
+    output [7:0]  led_display_seg,
+    output wire [7:0] led_display_sel
+);
+wire ad_pulse;
+wire [19:0] data_fx;
+wire [25:0] bcd;
+wire [31:0] data_bcd;
+wire [63:0] asciidata;
+assign data_bcd = {6'b00,bcd};
+//生成ad驱动时钟，由于使用杜邦线连接，ad_clk不要超过10M
+PLL PLLinst(
+    .clkout0(ad_clk),    // output 10M
+    .lock(),
+    .clkin1(clk)       // input
+);
+
+pulse_gen  pulse_gen_inst (
+    .rstn(rstn),
+    .trig_level(8'd128),
+    .ad_clk(ad_clk),
+    .ad_data(ad_data),
+    .ad_pulse(ad_pulse)
+  );
+
+cymometer # (
+    .CLK_FS(32'd27_000_000)
+  )
+  cymometer_inst (
+    .clk_fs(clk),
+    .rstn(rstn),
+    .clk_fx(ad_pulse),
+    .data_fx(data_fx)
+  );
+//二进制转bcd码模块
+bin2bcd # (
+    .W(20)
+  )
+  bin2bcd_inst (
+    .bin(data_fx),
+    .bcd(bcd)
+  );
+//4位BCD码转ascii模块，例化8次使8个bcd同时输出ascii
+genvar i;
+generate
+  for (i = 0; i < 8; i = i + 1) begin : generate_module
+    bcd2ascii  bcd2ascii_inst (
+        .bcd(data_bcd[i*4 +:4]),
+        .asciidata(asciidata[i*8 +: 8])
+      );
+  end
+endgenerate
+//数码管显示模块
+led_display_driver  led_display_driver_inst (
+    .clk(clk),
+    .rstn(rstn),
+    .assic_seg(asciidata),
+    .seg_point(8'b00000000),
+    .led_display_seg(led_display_seg),
+    .led_display_sel(led_display_sel)
+  );
+endmodule
+```
+
+### 3.3.4仿真验证
+
+### 3.3.5上板验证
+
+## 3.4 章末总结

scripts/GenerateWebAPI.ts

@@ -0,0 +1,432 @@
+import { spawn, exec, ChildProcess } from "child_process";
+import { promisify } from "util";
+import fetch from "node-fetch";
+import * as fs from "fs";
+
+const execAsync = promisify(exec);
+
+// Windows 支持函数
+function getCommand(command: string): string {
+  // dotnet 在 Windows 上不需要 .cmd 后缀
+  if (command === "dotnet") {
+    return "dotnet";
+  }
+  return process.platform === "win32" ? `${command}.cmd` : command;
+}
+
+function getSpawnOptions() {
+  return process.platform === "win32"
+    ? { stdio: "pipe", shell: true }
+    : { stdio: "pipe" };
+}
+
+async function waitForServer(
+  url: string,
+  maxRetries: number = 30,
+  interval: number = 1000,
+): Promise<boolean> {
+  for (let i = 0; i < maxRetries; i++) {
+    try {
+      const response = await fetch(url);
+      if (response.ok) {
+        console.log("✓ Server is ready");
+        return true;
+      }
+    } catch (error) {
+      // Server not ready yet
+    }
+    console.log(`Waiting for server... (${i + 1}/${maxRetries})`);
+    await new Promise((resolve) => setTimeout(resolve, interval));
+  }
+  return false;
+}
+
+// 改进全局变量类型
+let serverProcess: ChildProcess | null = null;
+let webProcess: ChildProcess | null = null;
+
+async function startWeb(): Promise<ChildProcess> {
+  console.log("Starting Vite frontend...");
+  return new Promise((resolve, reject) => {
+    const process = spawn(
+      getCommand("npm"),
+      ["run", "dev"],
+      getSpawnOptions() as any,
+    );
+
+    let webStarted = false;
+
+    process.stdout?.on("data", (data) => {
+      const output = data.toString();
+      console.log(`Web: ${output}`);
+
+      // 检查 Vite 是否已启动
+      if (
+        (output.includes("Local:") || output.includes("ready in")) &&
+        !webStarted
+      ) {
+        webStarted = true;
+        resolve(process);
+      }
+    });
+
+    process.stderr?.on("data", (data) => {
+      console.error(`Web Error: ${data}`);
+    });
+
+    process.on("error", (error) => {
+      reject(error);
+    });
+
+    process.on("exit", (code, signal) => {
+      console.log(`Web process exited with code ${code} and signal ${signal}`);
+      if (!webStarted) {
+        reject(new Error(`Web process exited unexpectedly with code ${code}`));
+      }
+    });
+
+    // 存储进程引用
+    webProcess = process;
+
+    // 超时处理
+    setTimeout(() => {
+      if (!webStarted) {
+        reject(new Error("Web server failed to start within timeout"));
+      }
+    }, 10000); // 10秒超时
+  });
+}
+
+async function startServer(): Promise<ChildProcess> {
+  console.log("Starting .NET server...");
+  return new Promise((resolve, reject) => {
+    const process = spawn(
+      getCommand("dotnet"),
+      ["run", "--property:Configuration=Release"],
+      {
+        cwd: "server",
+        ...getSpawnOptions(),
+      } as any,
+    );
+
+    let serverStarted = false;
+
+    process.stdout?.on("data", (data) => {
+      const output = data.toString();
+      console.log(`Server: ${output}`);
+
+      // 检查服务器是否已启动
+      if (output.includes("Now listening on:") && !serverStarted) {
+        serverStarted = true;
+        resolve(process);
+      }
+    });
+
+    process.stderr?.on("data", (data) => {
+      console.error(`Server Error: ${data}`);
+    });
+
+    process.on("error", (error) => {
+      reject(error);
+    });
+
+    process.on("exit", (code, signal) => {
+      console.log(
+        `Server process exited with code ${code} and signal ${signal}`,
+      );
+      if (!serverStarted) {
+        reject(
+          new Error(`Server process exited unexpectedly with code ${code}`),
+        );
+      }
+    });
+
+    // 存储进程引用
+    serverProcess = process;
+
+    // 超时处理
+    setTimeout(() => {
+      if (!serverStarted) {
+        reject(new Error("Server failed to start within timeout"));
+      }
+    }, 10000); // 10秒超时
+  });
+}
+
+async function stopServer(): Promise<void> {
+  console.log("Stopping server...");
+
+  if (!serverProcess) {
+    console.log("No server process to stop");
+    return;
+  }
+
+  try {
+    // 检查进程是否还存在
+    if (serverProcess.killed || serverProcess.exitCode !== null) {
+      console.log("✓ Server process already terminated");
+      serverProcess = null;
+      return;
+    }
+
+    // 发送 SIGTERM 信号
+    const killed = serverProcess.kill("SIGTERM");
+    if (!killed) {
+      console.warn("Failed to send SIGTERM to server process");
+      return;
+    }
+
+    // 设置超时，如果 3 秒内没有退出则强制终止
+    const timeoutPromise = new Promise<void>((resolve) => {
+      setTimeout(() => {
+        if (
+          serverProcess &&
+          !serverProcess.killed &&
+          serverProcess.exitCode === null
+        ) {
+          console.log("Force killing server process...");
+          serverProcess.kill("SIGKILL");
+        }
+        resolve();
+      }, 3000); // 减少超时时间到3秒
+    });
+
+    await Promise.race([timeoutPromise]);
+  } catch (error) {
+    console.warn("Warning: Could not stop server process:", error);
+  } finally {
+    serverProcess = null;
+
+    // 只有在进程可能没有正常退出时才执行清理
+    // 移除自动清理逻辑，因为正常退出时不需要
+  }
+}
+
+async function stopWeb(): Promise<void> {
+  console.log("Stopping web server...");
+
+  if (!webProcess) {
+    console.log("No web process to stop");
+    return;
+  }
+
+  try {
+    // 检查进程是否还存在
+    if (webProcess.killed || webProcess.exitCode !== null) {
+      console.log("✓ Web process already terminated");
+      webProcess = null;
+      return;
+    }
+
+    // 发送 SIGTERM 信号
+    const killed = webProcess.kill("SIGTERM");
+    if (!killed) {
+      console.warn("Failed to send SIGTERM to web process");
+      return;
+    }
+
+    // 设置超时，如果 3 秒内没有退出则强制终止
+    const timeoutPromise = new Promise<void>((resolve) => {
+      setTimeout(() => {
+        if (webProcess && !webProcess.killed && webProcess.exitCode === null) {
+          console.log("Force killing web process...");
+          webProcess.kill("SIGKILL");
+        }
+        resolve();
+      }, 3000);
+    });
+
+    await Promise.race([timeoutPromise]);
+  } catch (error) {
+    console.warn("Warning: Could not stop web process:", error);
+  } finally {
+    webProcess = null;
+  }
+}
+
+async function postProcessApiClient(): Promise<void> {
+  console.log("Post-processing API client...");
+  try {
+    const filePath = "src/APIClient.ts";
+
+    // 检查文件是否存在
+    if (!fs.existsSync(filePath)) {
+      throw new Error(`API client file not found: ${filePath}`);
+    }
+
+    // 读取文件内容
+    let content = fs.readFileSync(filePath, "utf8");
+
+    // 替换 ArgumentException 中的 message 属性声明
+    content = content.replace(
+      /(\s+)message!:\s*string;/g,
+      "$1declare message: string;",
+    );
+    content = content.replace(
+      "{ AxiosError, AxiosInstance, AxiosRequestConfig, AxiosResponse, CancelToken }",
+      "{ AxiosError, type AxiosInstance, type AxiosRequestConfig, type AxiosResponse, type CancelToken }",
+    );
+
+    // 写回文件
+    fs.writeFileSync(filePath, content, "utf8");
+
+    console.log("✓ API client post-processing completed");
+  } catch (error) {
+    throw new Error(`Failed to post-process API client: ${error}`);
+  }
+}
+
+async function generateApiClient(): Promise<void> {
+  console.log("Generating API client...");
+  try {
+    const url = "http://127.0.0.1:5000/GetAPIClientCode";
+    const response = await fetch(url);
+    if (!response.ok) {
+      throw new Error(
+        `Failed to fetch API client code: ${response.status} ${response.statusText}`,
+      );
+    }
+    const code = await response.text();
+
+    // 写入 APIClient.ts
+    const filePath = "src/APIClient.ts";
+    fs.writeFileSync(filePath, code, "utf8");
+    console.log("✓ API client code fetched and written successfully");
+
+    // 添加后处理步骤
+    await postProcessApiClient();
+  } catch (error) {
+    throw new Error(`Failed to generate API client: ${error}`);
+  }
+}
+
+async function generateSignalRClient(): Promise<void> {
+  console.log("Generating SignalR TypeScript client...");
+  try {
+    // TypedSignalR.Client.TypeScript.Analyzer 会在编译时自动生成客户端
+    // 我们只需要确保服务器项目构建一次即可生成 TypeScript 客户端
+    const { stdout, stderr } = await execAsync(
+      "dotnet build --configuration Release",
+      { cwd: "./server" }
+    );
+    if (stdout) console.log(stdout);
+    if (stderr) console.error(stderr);
+    console.log("✓ SignalR TypeScript client generated successfully");
+  } catch (error) {
+    throw new Error(`Failed to generate SignalR client: ${error}`);
+  }
+}
+
+async function main(): Promise<void> {
+  try {
+    // Generate SignalR client
+    await generateSignalRClient();
+    console.log("✓ SignalR TypeScript client generated successfully");
+
+    // Start web frontend first
+    await startWeb();
+    console.log("✓ Frontend started");
+
+    // Wait a bit for frontend to fully initialize
+    await new Promise((resolve) => setTimeout(resolve, 3000));
+
+    // Start server
+    await startServer();
+    console.log("✓ Backend started");
+
+    // Wait for server to be ready (给服务器额外时间完全启动)
+    await new Promise((resolve) => setTimeout(resolve, 2000));
+
+    // Check if swagger endpoint is available
+    const serverReady = await waitForServer(
+      "http://localhost:5000/swagger/v1/swagger.json",
+    );
+
+    if (!serverReady) {
+      throw new Error("Server failed to start within the expected time");
+    }
+
+    // Generate API client
+    await generateApiClient();
+
+    console.log("✓ API generation completed successfully");
+  } catch (error) {
+    console.error("❌ Error:", error);
+    process.exit(1);
+  } finally {
+    // Always try to stop processes in order: server first, then web
+    await stopServer();
+    await stopWeb();
+  }
+}
+
+// 改进的进程终止处理 - 添加防重复执行
+let isCleaningUp = false;
+
+const cleanup = async (signal: string) => {
+  if (isCleaningUp) {
+    console.log("Cleanup already in progress, ignoring signal");
+    return;
+  }
+
+  isCleaningUp = true;
+  console.log(`\nReceived ${signal}, cleaning up...`);
+
+  try {
+    await Promise.all([stopServer(), stopWeb()]);
+  } catch (error) {
+    console.error("Error during cleanup:", error);
+  }
+
+  // 立即退出，不等待
+  process.exit(0);
+};
+
+process.on("SIGINT", () => cleanup("SIGINT"));
+process.on("SIGTERM", () => cleanup("SIGTERM"));
+
+// 处理未捕获的异常
+process.on("uncaughtException", async (error) => {
+  if (isCleaningUp) return;
+
+  console.error("❌ Uncaught exception:", error);
+  isCleaningUp = true;
+
+  try {
+    await Promise.all([stopServer(), stopWeb()]);
+  } catch (cleanupError) {
+    console.error("Error during cleanup:", cleanupError);
+  }
+
+  process.exit(1);
+});
+
+process.on("unhandledRejection", async (reason, promise) => {
+  if (isCleaningUp) return;
+
+  console.error("❌ Unhandled rejection at:", promise, "reason:", reason);
+  isCleaningUp = true;
+
+  try {
+    await Promise.all([stopServer(), stopWeb()]);
+  } catch (cleanupError) {
+    console.error("Error during cleanup:", cleanupError);
+  }
+
+  process.exit(1);
+});
+
+main().catch(async (error) => {
+  if (isCleaningUp) return;
+
+  console.error("❌ Unhandled error:", error);
+  isCleaningUp = true;
+
+  try {
+    await Promise.all([stopServer(), stopWeb()]);
+  } catch (cleanupError) {
+    console.error("Error during cleanup:", cleanupError);
+  }
+
+  process.exit(1);
+});

server.test/.gitignore

@@ -1,2 +1,3 @@
 bin
 obj
+bitstream

server.test/NumberTest.cs

@@ -0,0 +1,286 @@
+using System.Collections;
+using Common;
+
+namespace CommonTest;
+
+/// <summary>
+/// 针对 Common.Number 的单元测试，覆盖所有公开方法
+/// </summary>
+public class NumberTest
+{
+    /// <summary>
+    /// 测试 NumberToBytes 的正常与异常情况
+    /// </summary>
+    [Fact]
+    public void Test_NumberToBytes()
+    {
+        // 测试大端（isLowNumHigh=false）
+        var result1 = Number.NumberToBytes(0x12345678ABCDEF01, 8, false);
+        Assert.True(result1.IsSuccessful);
+        Assert.Equal(new byte[] { 0x12, 0x34, 0x56, 0x78, 0xAB, 0xCD, 0xEF, 0x01 }, result1.Value);
+
+        // 测试小端（isLowNumHigh=true）
+        var result2 = Number.NumberToBytes(0x12345678ABCDEF01, 8, true);
+        Assert.True(result2.IsSuccessful);
+        Assert.Equal(new byte[] { 0x01, 0xEF, 0xCD, 0xAB, 0x78, 0x56, 0x34, 0x12 }, result2.Value);
+
+        // 测试长度不足（4字节）
+        var result3 = Number.NumberToBytes(0x12345678, 4, false);
+        Assert.True(result3.IsSuccessful);
+        Assert.Equal(new byte[] { 0x12, 0x34, 0x56, 0x78 }, result3.Value);
+
+        // 测试超长
+        var result4 = Number.NumberToBytes(0x1, 9, false);
+        Assert.False(result4.IsSuccessful);
+    }
+
+    /// <summary>
+    /// 测试 BytesToUInt64 的正常与异常情况
+    /// </summary>
+    [Fact]
+    public void Test_BytesToUInt64()
+    {
+        // 正常大端
+        var bytes = new byte[] { 0x12, 0x34, 0x56, 0x78, 0xAB, 0xCD, 0xEF, 0x01 };
+        var result = Number.BytesToUInt64((byte[])bytes.Clone(), false);
+        Assert.True(result.IsSuccessful);
+        Assert.Equal(0x12345678ABCDEF01UL, result.Value);
+
+        // 正常小端
+        var bytes2 = new byte[] { 0x01, 0xEF, 0xCD, 0xAB, 0x78, 0x56, 0x34, 0x12 };
+        var result2 = Number.BytesToUInt64((byte[])bytes2.Clone(), true);
+        Assert.True(result2.IsSuccessful);
+        Assert.Equal(0x12345678ABCDEF01UL, result2.Value);
+
+        // 异常：长度超限
+        var result3 = Number.BytesToUInt64(new byte[9], false);
+        Assert.False(result3.IsSuccessful);
+
+        // 异常：不足8字节
+        var result4 = Number.BytesToUInt64(new byte[] { 0x01, 0x02 }, false);
+        Assert.False(result4.IsSuccessful); // BitConverter.ToUInt64 需要8字节
+    }
+
+    /// <summary>
+    /// 测试 BytesToUInt32 的正常与异常情况
+    /// </summary>
+    [Fact]
+    public void Test_BytesToUInt32()
+    {
+        // 正常大端
+        var bytes = new byte[] { 0x12, 0x34, 0x56, 0x78 };
+        var result = Number.BytesToUInt32((byte[])bytes.Clone(), false);
+        Assert.True(result.IsSuccessful);
+        Assert.Equal(0x12345678U, result.Value);
+
+        // 正常小端
+        var bytes2 = new byte[] { 0x78, 0x56, 0x34, 0x12 };
+        var result2 = Number.BytesToUInt32((byte[])bytes2.Clone(), true);
+        Assert.True(result2.IsSuccessful);
+        Assert.Equal(0x12345678U, result2.Value);
+
+        // 异常：长度超限
+        var result3 = Number.BytesToUInt32(new byte[5], false);
+        Assert.False(result3.IsSuccessful);
+
+        // 异常：不足4字节
+        var result4 = Number.BytesToUInt32(new byte[] { 0x01, 0x02 }, false);
+        Assert.False(result4.IsSuccessful); // BitConverter.ToUInt32 需要4字节
+    }
+
+    /// <summary>
+    /// 测试 UInt32ArrayToBytes 的正常与异常情况
+    /// </summary>
+    [Fact]
+    public void Test_UInt32ArrayToBytes()
+    {
+        // 正常情况
+        var arr = new UInt32[] { 0x12345678, 0xABCDEF01 };
+        var result = Number.UInt32ArrayToBytes(arr);
+        Assert.True(result.IsSuccessful);
+        // BlockCopy 按小端序
+        Assert.Equal(new byte[] { 0x78, 0x56, 0x34, 0x12, 0x01, 0xEF, 0xCD, 0xAB }, result.Value);
+
+        // 空数组
+        var result2 = Number.UInt32ArrayToBytes(new UInt32[0]);
+        Assert.True(result2.IsSuccessful);
+        Assert.Empty(result2.Value);
+    }
+
+    /// <summary>
+    /// 测试 MultiBitsToBytes 和 MultiBitsToNumber (ulong)
+    /// </summary>
+    [Fact]
+    public void Test_MultiBitsToBytesAndNumber_Ulong()
+    {
+        // 合并两个比特段
+        var result = Number.MultiBitsToNumber(0b101UL, 3, 0b11UL, 2);
+        Assert.True(result.IsSuccessful);
+        Assert.Equal((ulong)0b10111, result.Value);
+
+        // 合并为字节数组
+        var bytesResult = Number.MultiBitsToBytes(0b101UL, 3, 0b11UL, 2);
+        Assert.True(bytesResult.IsSuccessful);
+        Assert.Equal(new byte[] { 0b10111 }, bytesResult.Value);
+
+        // 超过64位
+        var failResult = Number.MultiBitsToNumber(0xFFFFFFFFFFFFFFFF, 64, 1, 1);
+        Assert.False(failResult.IsSuccessful);
+    }
+
+    /// <summary>
+    /// 测试 MultiBitsToNumber (uint)
+    /// </summary>
+    [Fact]
+    public void Test_MultiBitsToNumber_Uint()
+    {
+        var result = Number.MultiBitsToNumber(0b101U, 3, 0b11U, 2);
+        Assert.True(result.IsSuccessful);
+        Assert.Equal((uint)0b10111, result.Value);
+
+        // 超过64位
+        var failResult = Number.MultiBitsToNumber(uint.MaxValue, 64, 1, 1);
+        Assert.False(failResult.IsSuccessful);
+    }
+
+    /// <summary>
+    /// 测试 BitsCheck (ulong)
+    /// </summary>
+    [Fact]
+    public void Test_BitsCheck_Ulong()
+    {
+        // 完全匹配
+        Assert.True(Number.BitsCheck(0b1101UL, 0b1101UL));
+        // 不匹配
+        Assert.False(Number.BitsCheck(0b1101UL, 0b1001UL));
+        // 掩码
+        Assert.True(Number.BitsCheck(0b1101UL, 0b1001UL, 0b1001UL));
+    }
+
+    /// <summary>
+    /// 测试 BitsCheck (uint)
+    /// </summary>
+    [Fact]
+    public void Test_BitsCheck_Uint()
+    {
+        Assert.True(Number.BitsCheck(0b1011U, 0b1011U));
+        Assert.False(Number.BitsCheck(0b1011U, 0b1001U));
+        Assert.True(Number.BitsCheck(0b1011U, 0b1001U, 0b1001U));
+    }
+
+    /// <summary>
+    /// 测试 ToBit
+    /// </summary>
+    [Fact]
+    public void Test_ToBit()
+    {
+        // 取第0位
+        var result = Number.ToBit(0b1010U, 0);
+        Assert.True(result.IsSuccessful);
+        Assert.False(result.Value);
+
+        // 取第1位
+        var result2 = Number.ToBit(0b1010U, 1);
+        Assert.True(result2.IsSuccessful);
+        Assert.True(result2.Value);
+
+        // 负数位置
+        var result3 = Number.ToBit(0b1010U, -1);
+        Assert.False(result3.IsSuccessful);
+    }
+
+    /// <summary>
+    /// 测试 BitsToNumber
+    /// </summary>
+    [Fact]
+    public void Test_BitsToNumber()
+    {
+        // 5位BitArray
+        var bits = new BitArray(new bool[] { true, true, false, true, false }); // 0b01011
+        var result = Number.BitsToNumber(bits);
+        Assert.True(result.IsSuccessful);
+        Assert.Equal((uint)0b01011, result.Value);
+
+        // 超过32位
+        var bits2 = new BitArray(33);
+        Assert.Throws<ArgumentException>(() => Number.BitsToNumber(bits2));
+    }
+
+    /// <summary>
+    /// 测试 StringToBytes
+    /// </summary>
+    [Fact]
+    public void Test_StringToBytes()
+    {
+        // 16进制字符串
+        var bytes = Number.StringToBytes("1234ABCD");
+        Assert.Equal(new byte[] { 0x12, 0x34, 0xAB, 0xCD }, bytes);
+
+        // 8位字符串
+        var bytes2 = Number.StringToBytes("01020304");
+        Assert.Equal(new byte[] { 0x01, 0x02, 0x03, 0x04 }, bytes2);
+    }
+
+    /// <summary>
+    /// 测试 ReverseBytes
+    /// </summary>
+    [Fact]
+    public void Test_ReverseBytes()
+    {
+        // 步长为2
+        var src = new byte[] { 0x01, 0x02, 0x03, 0x04 };
+        var result = Number.ReverseBytes(src, 2);
+        Assert.True(result.IsSuccessful);
+        Assert.Equal(new byte[] { 0x02, 0x01, 0x04, 0x03 }, result.Value);
+
+        // 步长为4
+        var src2 = new byte[] { 0x01, 0x02, 0x03, 0x04 };
+        var result2 = Number.ReverseBytes(src2, 4);
+        Assert.True(result2.IsSuccessful);
+        Assert.Equal(new byte[] { 0x04, 0x03, 0x02, 0x01 }, result2.Value);
+
+        // 步长为1（无变化）
+        var src3 = new byte[] { 0x01, 0x02, 0x03, 0x04 };
+        var result3 = Number.ReverseBytes(src3, 1);
+        Assert.True(result3.IsSuccessful);
+        Assert.Equal(src3, result3.Value);
+
+        // 步长为0（异常）
+        var result4 = Number.ReverseBytes(src3, 0);
+        Assert.False(result4.IsSuccessful);
+
+        // 步长不能整除
+        var result5 = Number.ReverseBytes(src3, 3);
+        Assert.False(result5.IsSuccessful);
+    }
+
+    /// <summary>
+    /// 测试 ReverseBits (byte)
+    /// </summary>
+    [Fact]
+    public void Test_ReverseBits_Byte()
+    {
+        // 0b00010010 -> 0b01001000
+        byte src = 0b00010010;
+        byte reversed = Number.ReverseBits(src);
+        Assert.Equal(0b01001000, reversed);
+
+        // 0b11110000 -> 0b00001111
+        Assert.Equal(0b00001111, Number.ReverseBits(0b11110000));
+    }
+
+    /// <summary>
+    /// 测试 ReverseBits (byte[])
+    /// </summary>
+    [Fact]
+    public void Test_ReverseBits_ByteArray()
+    {
+        var src = new byte[] { 0b00010010, 0b11110000 };
+        var reversed = Number.ReverseBits(src);
+        Assert.Equal(new byte[] { 0b01001000, 0b00001111 }, reversed);
+
+        // 空数组
+        var reversed2 = Number.ReverseBits(new byte[0]);
+        Assert.Empty(reversed2);
+    }
+}

server.test/UDPServerTest.cs

@@ -1,162 +0,0 @@
-using System.Net;
-using System.Text;
-using Common;
-using Xunit.Abstractions;
-
-namespace server.test;
-
-public sealed class RepeatAttribute : Xunit.Sdk.DataAttribute
-{
-    private readonly int count;
-
-    public RepeatAttribute(int count)
-    {
-        if (count < 1)
-        {
-            throw new System.ArgumentOutOfRangeException(
-                paramName: nameof(count),
-                message: "Repeat count must be greater than 0."
-                );
-        }
-        this.count = count;
-    }
-
-    public override System.Collections.Generic.IEnumerable<object[]> GetData(System.Reflection.MethodInfo testMethod)
-    {
-        foreach (var iterationNumber in Enumerable.Range(start: 1, count: this.count))
-        {
-            yield return new object[] { iterationNumber };
-        }
-    }
-}
-
-public class UDPServerTest
-{
-    const string address = "127.0.0.1";
-    const int port = 33000;
-    private static readonly UDPServer udpServer = new UDPServer(port);
-
-    private readonly ITestOutputHelper output;
-
-    public UDPServerTest(ITestOutputHelper output)
-    {
-        this.output = output;
-        udpServer.Start();
-    }
-
-    [Fact]
-    public void UDPDataDeepClone()
-    {
-        var udpData = new UDPData()
-        {
-            DateTime = DateTime.Now,
-            Address = "127.0.0.1",
-            Port = 1234,
-            Data = new byte[] { 0xf0, 00, 00, 00 },
-            HasRead = false
-        };
-        var cloneUdpData = udpData.DeepClone();
-
-        Assert.Equal(udpData.DateTime, cloneUdpData.DateTime);
-        Assert.Equal(udpData.Address, cloneUdpData.Address);
-        Assert.Equal(udpData.Port, cloneUdpData.Port);
-        Assert.Equal(udpData.Data, cloneUdpData.Data);
-        Assert.Equal(udpData.HasRead, cloneUdpData.HasRead);
-
-        udpData.DateTime = DateTime.Now;
-        udpData.Address = "192.168.1.1";
-        udpData.Port = 33000;
-        udpData.Data = new byte[] { 0xFF, 00, 00, 00 };
-        udpData.HasRead = true;
-
-        Assert.NotNull(cloneUdpData.DateTime);
-        Assert.NotNull(cloneUdpData.Address);
-        Assert.NotNull(cloneUdpData.Port);
-        Assert.NotNull(cloneUdpData.Data);
-        Assert.NotNull(cloneUdpData.HasRead);
-
-        Assert.NotEqual(udpData.DateTime, cloneUdpData.DateTime);
-        Assert.NotEqual(udpData.Address, cloneUdpData.Address);
-        Assert.NotEqual(udpData.Port, cloneUdpData.Port);
-        Assert.NotEqual(udpData.Data, cloneUdpData.Data);
-        Assert.NotEqual(udpData.HasRead, cloneUdpData.HasRead);
-    }
-
-    [Theory]
-    [InlineData(new object[] { new string[] { "Hello World!", "Hello Server!", "What is your problem?" } })]
-    public async Task UDPServerFindString(string[] textArray)
-    {
-        Assert.True(udpServer.IsRunning);
-
-        var serverEP = new IPEndPoint(IPAddress.Parse(address), port);
-
-        foreach (var text in textArray)
-        {
-            Assert.True(await UDPClientPool.SendStringAsync(serverEP, [text]));
-            var ret = await udpServer.FindDataAsync(address);
-            Assert.True(ret.HasValue);
-            var data = ret.Value;
-            Assert.Equal(address, data.Address);
-            Assert.Equal(text, Encoding.ASCII.GetString(data.Data));
-        }
-    }
-
-    [Theory]
-    [InlineData(new object[] { new UInt32[] { 0xF0_00_00_00, 0xFF_00_00_00, 0xFF_FF_FF_FF } })]
-    public async Task UDPServerFindBytes(UInt32[] bytesArray)
-    {
-        Assert.True(udpServer.IsRunning);
-
-        var serverEP = new IPEndPoint(IPAddress.Parse(address), port);
-
-        foreach (var number in bytesArray)
-        {
-            Assert.True(await UDPClientPool.SendBytesAsync(serverEP, Number.NumberToBytes(number, 4).Value));
-            var ret = await udpServer.FindDataAsync(address);
-            Assert.True(ret.HasValue);
-            var data = ret.Value;
-            Assert.Equal(address, data.Address);
-            Assert.Equal(number, Number.BytesToNumber(data.Data));
-        }
-    }
-
-    [Theory]
-    [InlineData(new object[] { new UInt32[] { 0xF0_00_00_00, 0xF0_01_00_00 } })]
-    public async Task UDPServerWaitResp(UInt32[] bytesArray)
-    {
-        Assert.True(udpServer.IsRunning);
-
-        var serverEP = new IPEndPoint(IPAddress.Parse(address), port);
-
-        foreach (var number in bytesArray)
-        {
-            Assert.True(await UDPClientPool.SendBytesAsync(serverEP, Number.NumberToBytes(number, 4).Value));
-
-            var ret = await udpServer.WaitForAckAsync(address);
-            Assert.True(ret.IsSuccessful);
-            var data = ret.Value;
-            Assert.True(data.IsSuccessful);
-            Assert.Equal(number, Number.BytesToNumber(data.ToBytes()));
-        }
-    }
-
-    [Theory]
-    [InlineData(new object[] { new UInt64[] { 0x0F_00_00_00_01_02_02_02, 0x0F_01_00_00_FF_FF_FF_FF } })]
-    public async Task UDPServerWaitData(UInt64[] bytesArray)
-    {
-        Assert.True(udpServer.IsRunning);
-
-        var serverEP = new IPEndPoint(IPAddress.Parse(address), port);
-
-        foreach (var number in bytesArray)
-        {
-            Assert.True(await UDPClientPool.SendBytesAsync(serverEP, Number.NumberToBytes(number, 8).Value));
-
-            var ret = await udpServer.WaitForDataAsync(address);
-            Assert.True(ret.IsSuccessful);
-            var data = ret.Value;
-            Assert.True(data.IsSuccessful);
-            Assert.Equal(number, Number.BytesToNumber(data.ToBytes()));
-        }
-    }
-}

server/.gitignore

@@ -1,3 +1,5 @@
 obj
 bin
+bitstream
+bsdl
 

server/Program.cs

@@ -1,7 +1,17 @@
+using System.Security.Claims;
+using System.Text;
+using Microsoft.AspNetCore.Authentication.JwtBearer;
 using Microsoft.AspNetCore.Http.Features;
+using Microsoft.Extensions.FileProviders;
+using Microsoft.IdentityModel.Tokens;
 using Newtonsoft.Json;
 using NLog;
 using NLog.Web;
+using NSwag;
+using NSwag.CodeGeneration.TypeScript;
+using NSwag.Generation.Processors.Security;
+using server.Services;
+using TypedSignalR.Client.DevTools;
 
 // Early init of NLog to allow startup and exception logging, before host is built
 var logger = NLog.LogManager.Setup()
@@ -9,14 +19,13 @@ var logger = NLog.LogManager.Setup()
                       .GetCurrentClassLogger();
 logger.Debug("Init Main...");
 
-
 try
 {
     var builder = WebApplication.CreateBuilder(args);
 
     // Services Settings
     // Add services to the container.
-    builder.Services.AddControllersWithViews();
+    // builder.Services.AddControllersWithViews();
 
     // NLog: Setup NLog for Dependency injection
     builder.Logging.ClearProviders();
@@ -36,9 +45,69 @@ try
         options.SerializerSettings.NullValueHandling = NullValueHandling.Ignore;
     });
 
+    // Add JWT Token Authorization
+    builder.Services
+        .AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
+        .AddJwtBearer(options =>
+        {
+            options.TokenValidationParameters = new TokenValidationParameters
+            {
+                ValidateIssuer = true,
+                ValidateAudience = true,
+                ValidateLifetime = true,
+                ValidateIssuerSigningKey = true,
+                RequireExpirationTime = true,
+                ValidIssuer = "dlut.edu.cn",
+                ValidAudience = "dlut.edu.cn",
+                IssuerSigningKey = new SymmetricSecurityKey(
+                    Encoding.UTF8.GetBytes("my secret key 1234567890my secret key 1234567890")),
+            };
+            options.Authority = $"http://{Global.localhost}:5000";
+            options.RequireHttpsMetadata = false;
+        });
+    // Add JWT Token Authorization Policy
+    builder.Services.AddAuthorization(options =>
+    {
+        options.AddPolicy("Admin", policy =>
+        {
+            policy.RequireClaim(ClaimTypes.Role, new string[] {
+                Database.User.UserPermission.Admin.ToString(),
+            });
+        });
+    });
+
+    // Add CORS policy
+    if (builder.Environment.IsDevelopment())
+    {
+        builder.Services.AddCors(options =>
+        {
+            options.AddPolicy("Development", policy => policy
+                .AllowAnyOrigin()
+                .AllowAnyMethod()
+                .AllowAnyHeader()
+            );
+        });
+    }
+    builder.Services.AddCors(options =>
+    {
+        options.AddPolicy("Users", policy => policy
+            .AllowAnyOrigin()
+            .AllowAnyMethod()
+            .AllowAnyHeader()
+        );
+        options.AddPolicy("SignalR", policy => policy
+            .WithOrigins("http://localhost:5173")
+            .AllowAnyHeader()
+            .AllowAnyMethod()
+            .AllowCredentials()
+        );
+    });
+
+    // Use SignalR
+    builder.Services.AddSignalR();
+
     // Add Swagger
-    builder.Services.AddControllers();
+    builder.Services.AddSwaggerDocument(options =>
-    builder.Services.AddOpenApiDocument(options =>
     {
         options.PostProcess = document =>
         {
@@ -60,34 +129,126 @@ try
                 // }
             };
         };
+
+        // Authorization
+        options.AddSecurity("Bearer", new NSwag.OpenApiSecurityScheme
+        {
+            Description = "请输入token,格式为 Bearer xxxxxxxx（注意中间必须有空格）",
+            Name = "Authorization",
+            In = NSwag.OpenApiSecurityApiKeyLocation.Header,
+            Type = NSwag.OpenApiSecuritySchemeType.ApiKey,
         });
+        options.OperationProcessors.Add(new OperationSecurityScopeProcessor("Bearer"));
+    });
+
+
+    // 添加 HTTP 视频流服务
+    builder.Services.AddSingleton<HttpVideoStreamService>();
+    builder.Services.AddHostedService(provider => provider.GetRequiredService<HttpVideoStreamService>());
 
     // Application Settings
     var app = builder.Build();
     // Configure the HTTP request pipeline.
-    app.UseExceptionHandler("/Home/Error");
+    if (!app.Environment.IsDevelopment())
+    {
+        // app.UseExceptionHandler("/Home/Error");
         // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
         app.UseHsts();
+
+        // Serve static files
+        logger.Info($"Use Static Files : {Path.Combine(Directory.GetCurrentDirectory(), "wwwroot")}");
+        app.UseDefaultFiles();
+        app.UseStaticFiles(); // Serves files from wwwroot by default
+
+        // Assets Files
+        app.UseStaticFiles(new StaticFileOptions
+        {
+            FileProvider = new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", "assets")),
+            RequestPath = "/assets"
+        });
+
+        // Log Files
+        if (!Directory.Exists(Path.Combine(Directory.GetCurrentDirectory(), "log")))
+        {
+            Directory.CreateDirectory(Path.Combine(Directory.GetCurrentDirectory(), "log"));
+        }
+        app.UseStaticFiles(new StaticFileOptions
+        {
+            FileProvider = new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), "log")),
+            RequestPath = "/log"
+        });
+
+        // Exam Files (实验静态资源)
+        if (Directory.Exists(Path.Combine(Directory.GetCurrentDirectory(), "exam")))
+        {
+            app.UseStaticFiles(new StaticFileOptions
+            {
+                FileProvider = new PhysicalFileProvider(Path.Combine(Directory.GetCurrentDirectory(), "exam")),
+                RequestPath = "/exam"
+            });
+        }
+
+        app.MapFallbackToFile("index.html");
+    }
+
     app.UseHttpsRedirection();
-    app.UseStaticFiles();
     app.UseRouting();
+    app.UseCors();
+    app.UseAuthentication();
     app.UseAuthorization();
 
-    // if (app.Environment.IsDevelopment())
+    // Swagger
-    // {
+    app.UseOpenApi(settings =>
-    app.UseOpenApi();
+    {
+        settings.PostProcess = (document, httpRequest) =>
+        {
+            document.Servers.Clear();
+            document.Servers.Add(new NSwag.OpenApiServer { Url = $"http://{Global.localhost}:5000" });
+        };
+    });
     app.UseSwaggerUi();
-    // }
+
+    // SignalR
+    app.UseWebSockets();
+    app.UseSignalRHubSpecification();
+    app.UseSignalRHubDevelopmentUI();
+
+    // Router
+    app.MapControllers();
+    app.MapHub<server.Hubs.JtagHub.JtagHub>("hubs/JtagHub");
 
     // Setup Program
     MsgBus.Init();
 
-    // Router
+    // Generate API Client
-    // API Get
+    app.MapGet("GetAPIClientCode", async (HttpContext context) =>
-    app.MapGet("/", () => Results.Redirect("/swagger"));
+    {
-    app.MapControllers();
+        try
+        {
+            var document = await OpenApiDocument.FromUrlAsync($"http://{Global.localhost}:5000/swagger/v1/swagger.json");
 
-    app.Run("http://localhost:5000");
+            var settings = new TypeScriptClientGeneratorSettings
+            {
+                ClassName = "{controller}Client",
+                UseAbortSignal = false,
+                Template = TypeScriptTemplate.Axios,
+                TypeScriptGeneratorSettings = {
+                },
+            };
+
+            var generator = new TypeScriptClientGenerator(document, settings);
+            var code = generator.GenerateFile();
+
+            return Results.Text(code, "text/plain; charset=utf-8", Encoding.UTF8);
+        }
+        catch (Exception err)
+        {
+            logger.Error(err);
+            return Results.Problem(err.ToString());
+        }
+    }).RequireCors("Development");
+
+    app.Run();
 }
 catch (Exception exception)
 {
@@ -106,4 +267,3 @@ finally
     // Close Program
     MsgBus.Exit();
 }
-

server/Properties/launchSettings.json

@@ -5,18 +5,20 @@
       "commandName": "Project",
       "dotnetRunMessages": true,
       "launchBrowser": true,
-      "applicationUrl": "http://localhost:5188",
+      "applicationUrl": "http://0.0.0.0:5000",
       "environmentVariables": {
-        "ASPNETCORE_ENVIRONMENT": "Development"
+        "ASPNETCORE_ENVIRONMENT": "Development",
+        "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "Microsoft.AspNetCore.SpaProxy"
       }
     },
     "https": {
       "commandName": "Project",
       "dotnetRunMessages": true,
       "launchBrowser": true,
-      "applicationUrl": "https://localhost:7070;http://localhost:5188",
+      "applicationUrl": "https://0.0.0.0:7278;http://0.0.0.0:5000",
       "environmentVariables": {
-        "ASPNETCORE_ENVIRONMENT": "Development"
+        "ASPNETCORE_ENVIRONMENT": "Development",
+        "ASPNETCORE_HOSTINGSTARTUPASSEMBLIES": "Microsoft.AspNetCore.SpaProxy"
       }
     }
   }

server/server.csproj

@@ -1,5 +1,5 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
-  <Import Project="PublishAllRids.targets" />
+  <Import Project="PublishAllRids.xml" />
 
   <PropertyGroup>
     <TargetFramework>net9.0</TargetFramework>
@@ -8,17 +8,40 @@
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <RuntimeIdentifiers>win-x64;linux-x64;</RuntimeIdentifiers>
     <PublishSingleFile>true</PublishSingleFile>
+    <SpaRoot>../</SpaRoot>
+    <SpaProxyServerUrl>http://localhost:5173</SpaProxyServerUrl>
+    <SpaProxyLaunchCommand>npm run dev</SpaProxyLaunchCommand>
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="DotNext" Version="5.19.1" />
+    <PackageReference Include="ArpLookup" Version="2.0.3" />
-    <PackageReference Include="DotNext.Threading" Version="5.19.1" />
+    <PackageReference Include="DotNext" Version="5.23.0" />
+    <PackageReference Include="DotNext.Threading" Version="5.23.0" />
+    <PackageReference Include="Honoo.IO.Hashing.Crc" Version="1.3.3" />
+    <PackageReference Include="linq2db.AspNet" Version="5.4.1" />
+    <PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="9.0.7" />
     <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="9.0.4" />
+    <PackageReference Include="Microsoft.AspNetCore.SpaProxy" Version="9.0.4" />
     <PackageReference Include="Microsoft.OpenApi" Version="1.6.23" />
     <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
     <PackageReference Include="NLog" Version="5.4.0" />    
     <PackageReference Include="NLog.Web.AspNetCore" Version="5.4.0" />
     <PackageReference Include="NSwag.AspNetCore" Version="14.3.0" />
+    <PackageReference Include="NSwag.CodeGeneration.TypeScript" Version="14.4.0" />
+    <PackageReference Include="OpenCvSharp4" Version="4.11.0.20250507" />
+    <PackageReference Include="OpenCvSharp4.runtime.win" Version="4.11.0.20250507" />
+    <PackageReference Include="SixLabors.ImageSharp" Version="3.1.10" />
+    <PackageReference Include="System.Data.SQLite.Core" Version="1.0.119" />
+    <PackageReference Include="Tapper.Analyzer" Version="1.13.1">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+    <PackageReference Include="TypedSignalR.Client.DevTools" Version="1.2.4" />
+    <PackageReference Include="TypedSignalR.Client.TypeScript.Analyzer" Version="1.15.0">
+      <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
+      <PrivateAssets>all</PrivateAssets>
+    </PackageReference>
+    <PackageReference Include="TypedSignalR.Client.TypeScript.Attributes" Version="1.15.0" />
   </ItemGroup>
 
 </Project>

server/src/ArpClient.cs

@@ -0,0 +1,634 @@
+using System.Diagnostics;
+using System.Net.NetworkInformation;
+using ArpLookup;
+using System.Runtime.InteropServices;
+using System.Net;
+using System.Text.RegularExpressions;
+
+/// <summary>
+/// ARP 记录管理静态类（跨平台支持）
+/// </summary>
+public static class ArpClient
+{
+    private static NLog.Logger logger = NLog.LogManager.GetCurrentClassLogger();
+
+    /// <summary>
+    /// 读取所有 ARP 记录
+    /// </summary>
+    /// <returns>ARP 记录列表</returns>
+    public static async Task<List<ArpEntry>> GetArpTableAsync()
+    {
+        var entries = new List<ArpEntry>();
+
+        try
+        {
+            string command = GetArpListCommand();
+            var result = await ExecuteCommandAsync(command);
+            if (result.IsSuccess)
+            {
+                var lines = result.Output.Split('\n', StringSplitOptions.RemoveEmptyEntries);
+
+                foreach (var line in lines)
+                {
+                    var entry = ParseArpEntry(line);
+                    if (entry != null)
+                    {
+                        entries.Add(entry);
+                    }
+                }
+            }
+        }
+        catch (Exception ex)
+        {
+            throw new Exception($"读取 ARP 表失败: {ex.Message}");
+        }
+
+        return entries;
+    }
+
+    /// <summary>
+    /// 动态更新指定 IP 的 ARP 记录
+    /// </summary>
+    /// <param name="ipAddress">要更新的 IP 地址</param>
+    /// <returns>是否成功发送 Ping</returns>
+    public static async Task<bool> UpdateArpEntryAsync(string ipAddress)
+    {
+        if (string.IsNullOrWhiteSpace(ipAddress))
+            throw new ArgumentException("IP 地址不能为空", nameof(ipAddress));
+
+        try
+        {
+            var ret = await ArpClient.DeleteArpEntryAsync(ipAddress);
+            if (!ret)
+            {
+                logger.Error($"删除 ARP 记录失败: {ipAddress}");
+            }
+
+            PhysicalAddress? mac = await Arp.LookupAsync(IPAddress.Parse(ipAddress));
+            if (mac == null)
+                return false;
+
+            return true;
+        }
+        catch
+        {
+            return false;
+        }
+    }
+
+    /// <summary>
+    /// 添加 ARP 记录
+    /// </summary>
+    /// <param name="ipAddress">IP 地址</param>
+    /// <param name="macAddress">MAC 地址</param>
+    /// <param name="interfaceName">网络接口名称（可选）</param>
+    /// <returns>是否成功</returns>
+    public static async Task<bool> AddArpEntryAsync(string ipAddress, string macAddress, string? interfaceName = null)
+    {
+        if (string.IsNullOrWhiteSpace(ipAddress))
+            throw new ArgumentException("IP 地址不能为空", nameof(ipAddress));
+
+        if (string.IsNullOrWhiteSpace(macAddress))
+            throw new ArgumentException("MAC 地址不能为空", nameof(macAddress));
+
+        try
+        {
+            // 格式化 MAC 地址以适配不同操作系统
+            string formattedMac = FormatMacAddress(macAddress);
+            string command = await GetArpAddCommandAsync(ipAddress, formattedMac, interfaceName);
+            var result = await ExecuteCommandAsync(command);
+            return result.IsSuccess;
+        }
+        catch (Exception ex)
+        {
+            throw new Exception($"添加 ARP 记录失败: {ex.Message}");
+        }
+    }
+
+    /// <summary>
+    /// 删除 ARP 记录
+    /// </summary>
+    /// <param name="ipAddress">要删除的 IP 地址</param>
+    /// <param name="interfaceName">网络接口名称（可选）</param>
+    /// <returns>是否成功</returns>
+    public static async Task<bool> DeleteArpEntryAsync(string ipAddress, string? interfaceName = null)
+    {
+        if (string.IsNullOrWhiteSpace(ipAddress))
+            throw new ArgumentException("IP 地址不能为空", nameof(ipAddress));
+
+        try
+        {
+            string command = GetArpDeleteCommand(ipAddress, interfaceName);
+            var result = await ExecuteCommandAsync(command);
+            return result.IsSuccess;
+        }
+        catch (Exception ex)
+        {
+            throw new Exception($"删除 ARP 记录失败: {ex.Message}");
+        }
+    }
+
+    /// <summary>
+    /// 清空所有 ARP 记录
+    /// </summary>
+    /// <returns>是否成功</returns>
+    public static async Task<bool> ClearArpTableAsync()
+    {
+        try
+        {
+            string command = GetArpClearCommand();
+            var result = await ExecuteCommandAsync(command);
+            return result.IsSuccess;
+        }
+        catch (Exception ex)
+        {
+            throw new Exception($"清空 ARP 表失败: {ex.Message}");
+        }
+    }
+
+    /// <summary>
+    /// 查询特定 IP 的 ARP 记录
+    /// </summary>
+    /// <param name="ipAddress">IP 地址</param>
+    /// <returns>ARP 记录，如果不存在则返回 null</returns>
+    public static async Task<ArpEntry?> GetArpEntryAsync(string ipAddress)
+    {
+        if (string.IsNullOrWhiteSpace(ipAddress))
+            throw new ArgumentException("IP 地址不能为空", nameof(ipAddress));
+
+        try
+        {
+            string command = GetArpQueryCommand(ipAddress);
+            var result = await ExecuteCommandAsync(command);
+            if (result.IsSuccess)
+            {
+                var lines = result.Output.Split('\n', StringSplitOptions.RemoveEmptyEntries);
+                foreach (var line in lines)
+                {
+                    var entry = ParseArpEntry(line);
+                    if (entry != null && entry.IpAddress == ipAddress)
+                    {
+                        return entry;
+                    }
+                }
+            }
+        }
+        catch (Exception ex)
+        {
+            throw new Exception($"查询 ARP 记录失败: {ex.Message}");
+        }
+
+        return null;
+    }
+
+    /// <summary>
+    /// 获取 ARP 列表命令
+    /// </summary>
+    private static string GetArpListCommand()
+    {
+        return "arp -a";
+    }
+
+    /// <summary>
+    /// 获取 ARP 添加命令
+    /// </summary>
+    private static async Task<string> GetArpAddCommandAsync(string ipAddress, string macAddress, string? interfaceName)
+    {
+        if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+        {
+            if (!string.IsNullOrWhiteSpace(interfaceName))
+            {
+                // 通过 arp -a 获取接口索引
+                var interfaceIdx = await GetWindowsInterfaceIndexAsync(interfaceName);
+                if (interfaceIdx.HasValue)
+                {
+                    return $"netsh -c i i add neighbors {interfaceIdx.Value} {ipAddress} {macAddress}";
+                }
+            }
+            return $"arp -s {ipAddress} {macAddress}";
+        }
+        else if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux))
+        {
+            return string.IsNullOrWhiteSpace(interfaceName)
+                ? $"arp -s {ipAddress} {macAddress}"
+                : $"arp -s {ipAddress} {macAddress} -i {interfaceName}";
+        }
+        else if (RuntimeInformation.IsOSPlatform(OSPlatform.OSX))
+        {
+            return string.IsNullOrWhiteSpace(interfaceName)
+                ? $"arp -s {ipAddress} {macAddress}"
+                : $"arp -s {ipAddress} {macAddress} ifscope {interfaceName}";
+        }
+        else
+        {
+            throw new PlatformNotSupportedException("不支持的操作系统平台");
+        }
+    }
+
+    /// <summary>
+    /// 获取 Windows 接口索引
+    /// </summary>
+    /// <param name="interfaceIp">接口IP地址</param>
+    /// <returns>接口索引（十进制），如果未找到则返回null</returns>
+    private static async Task<int?> GetWindowsInterfaceIndexAsync(string interfaceIp)
+    {
+        try
+        {
+            var result = await ExecuteCommandAsync("arp -a");
+            if (!result.IsSuccess)
+                return null;
+
+            var lines = result.Output.Split('\n', StringSplitOptions.RemoveEmptyEntries);
+
+            foreach (var line in lines)
+            {
+                // 匹配接口行格式: Interface: 172.6.1.5 --- 0xa
+                var interfacePattern = @"Interface:\s+(\d+\.\d+\.\d+\.\d+)\s+---\s+(0x[a-fA-F0-9]+)";
+                var match = Regex.Match(line, interfacePattern);
+
+                if (match.Success && match.Groups[1].Value == interfaceIp)
+                {
+                    // 将十六进制索引转换为十进制
+                    var hexIndex = match.Groups[2].Value;
+                    // 去掉 "0x" 前缀
+                    var hexValue = hexIndex.StartsWith("0x", StringComparison.OrdinalIgnoreCase)
+                        ? hexIndex.Substring(2)
+                        : hexIndex;
+
+                    if (int.TryParse(hexValue, System.Globalization.NumberStyles.HexNumber, null, out int decimalIndex))
+                    {
+                        logger.Debug($"找到接口 {interfaceIp} 的索引: {hexIndex} -> {decimalIndex}");
+                        return decimalIndex;
+                    }
+                }
+            }
+
+            logger.Warn($"未找到接口 {interfaceIp} 的索引");
+            return null;
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, $"获取接口 {interfaceIp} 索引失败");
+            return null;
+        }
+    }
+
+    /// <summary>
+    /// 获取 ARP 删除命令
+    /// </summary>
+    private static string GetArpDeleteCommand(string ipAddress, string? interfaceName)
+    {
+        if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+        {
+            return $"arp -d {ipAddress}";
+        }
+        else if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux))
+        {
+            return string.IsNullOrWhiteSpace(interfaceName)
+                ? $"arp -d {ipAddress}"
+                : $"arp -d {ipAddress} -i {interfaceName}";
+        }
+        else if (RuntimeInformation.IsOSPlatform(OSPlatform.OSX))
+        {
+            return string.IsNullOrWhiteSpace(interfaceName)
+                ? $"arp -d {ipAddress}"
+                : $"arp -d {ipAddress} ifscope {interfaceName}";
+        }
+        else
+        {
+            throw new PlatformNotSupportedException("不支持的操作系统平台");
+        }
+    }
+
+    /// <summary>
+    /// 获取 ARP 清空命令
+    /// </summary>
+    private static string GetArpClearCommand()
+    {
+        if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+        {
+            return "arp -d *";
+        }
+        else if (RuntimeInformation.IsOSPlatform(OSPlatform.Linux))
+        {
+            return "ip neigh flush all";
+        }
+        else if (RuntimeInformation.IsOSPlatform(OSPlatform.OSX))
+        {
+            return "arp -d -a";
+        }
+        else
+        {
+            throw new PlatformNotSupportedException("不支持的操作系统平台");
+        }
+    }
+
+    /// <summary>
+    /// 获取 ARP 查询命令
+    /// </summary>
+    private static string GetArpQueryCommand(string ipAddress)
+    {
+        return $"arp -a {ipAddress}";
+    }
+
+    /// <summary>
+    /// 执行系统命令
+    /// </summary>
+    /// <param name="command">命令</param>
+    /// <returns>命令执行结果</returns>
+    private static async Task<CommandResult> ExecuteCommandAsync(string command)
+    {
+        try
+        {
+            ProcessStartInfo processInfo;
+
+            if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+            {
+                processInfo = new ProcessStartInfo
+                {
+                    FileName = "cmd.exe",
+                    Arguments = $"/c {command}",
+                    RedirectStandardOutput = true,
+                    RedirectStandardError = true,
+                    UseShellExecute = false,
+                    CreateNoWindow = true
+                };
+            }
+            else
+            {
+                processInfo = new ProcessStartInfo
+                {
+                    FileName = "/bin/bash",
+                    Arguments = $"-c \"{command}\"",
+                    RedirectStandardOutput = true,
+                    RedirectStandardError = true,
+                    UseShellExecute = false,
+                    CreateNoWindow = true
+                };
+            }
+
+            logger.Debug($"Executing command: {processInfo.FileName} {processInfo.Arguments}");
+
+            using var process = new Process { StartInfo = processInfo };
+            process.Start();
+
+            var output = await process.StandardOutput.ReadToEndAsync();
+            var error = await process.StandardError.ReadToEndAsync();
+
+            await process.WaitForExitAsync();
+
+            logger.Debug($"Command output: {output}");
+            if (!string.IsNullOrWhiteSpace(error))
+                logger.Debug($"Command error: {error}");
+            logger.Debug($"Command exit code: {process.ExitCode}");
+
+            return new CommandResult
+            {
+                IsSuccess = process.ExitCode == 0,
+                Output = output,
+                Error = error,
+                ExitCode = process.ExitCode
+            };
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, $"Command execution failed: {command}");
+            return new CommandResult
+            {
+                IsSuccess = false,
+                Error = ex.Message,
+                ExitCode = -1
+            };
+        }
+    }
+
+    /// <summary>
+    /// 解析 ARP 记录行
+    /// </summary>
+    /// <param name="line">ARP 记录行</param>
+    /// <returns>解析后的 ARP 记录</returns>
+    private static ArpEntry? ParseArpEntry(string line)
+    {
+        if (string.IsNullOrWhiteSpace(line))
+            return null;
+
+        if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+        {
+            return ParseWindowsArpEntry(line);
+        }
+        else
+        {
+            return ParseUnixArpEntry(line);
+        }
+    }
+
+    /// <summary>
+    /// 解析 Windows ARP 记录
+    /// </summary>
+    private static ArpEntry? ParseWindowsArpEntry(string line)
+    {
+        // 跳过空行和标题行
+        if (string.IsNullOrWhiteSpace(line) ||
+            line.Contains("Interface:") ||
+            line.Contains("Internet Address") ||
+            line.Contains("Physical Address") ||
+            line.Contains("Type"))
+        {
+            return null;
+        }
+
+        // Windows arp -a 输出格式: IP地址 物理地址 类型
+        // 示例: 172.6.0.1             e4-3a-6e-29-c3-5b     dynamic
+        var pattern = @"^\s*(\d+\.\d+\.\d+\.\d+)\s+([a-fA-F0-9-]{17})\s+(\w+)\s*$";
+        var match = Regex.Match(line, pattern);
+
+        if (match.Success)
+        {
+            return new ArpEntry
+            {
+                IpAddress = match.Groups[1].Value,
+                MacAddress = FormatMacAddress(match.Groups[2].Value), // 格式化 MAC 地址
+                Type = match.Groups[3].Value
+            };
+        }
+
+        return null;
+    }
+
+    /// <summary>
+    /// 解析 Unix/Linux ARP 记录
+    /// </summary>
+    private static ArpEntry? ParseUnixArpEntry(string line)
+    {
+        // Unix/Linux arp -a 输出格式: hostname (ip) at mac [ether] PERM on interface
+        var pattern = @"(\S+)\s+\((\d+\.\d+\.\d+\.\d+)\)\s+at\s+([a-fA-F0-9:]{17})\s+\[(\w+)\]\s+(\w+)\s+on\s+(\S+)";
+        var match = Regex.Match(line, pattern);
+
+        if (match.Success)
+        {
+            return new ArpEntry
+            {
+                Hostname = match.Groups[1].Value,
+                IpAddress = match.Groups[2].Value,
+                MacAddress = FormatMacAddress(match.Groups[3].Value), // 格式化 MAC 地址
+                Type = match.Groups[5].Value,
+                Interface = match.Groups[6].Value
+            };
+        }
+
+        // 匹配简单格式: ip mac interface
+        var simplePattern = @"(\d+\.\d+\.\d+\.\d+)\s+([a-fA-F0-9:]{17})\s+(\S+)";
+        var simpleMatch = Regex.Match(line, simplePattern);
+
+        if (simpleMatch.Success)
+        {
+            return new ArpEntry
+            {
+                IpAddress = simpleMatch.Groups[1].Value,
+                MacAddress = FormatMacAddress(simpleMatch.Groups[2].Value), // 格式化 MAC 地址
+                Interface = simpleMatch.Groups[3].Value
+            };
+        }
+
+        return null;
+    }
+
+    /// <summary>
+    /// 判断当前进程是否具有管理员（或 root）权限
+    /// </summary>
+    /// <returns>如果有管理员权限返回 true，否则返回 false</returns>
+    public static bool IsAdministrator()
+    {
+        if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+        {
+            // Windows: 检查当前用户是否为管理员
+            using var identity = System.Security.Principal.WindowsIdentity.GetCurrent();
+            var principal = new System.Security.Principal.WindowsPrincipal(identity);
+            return principal.IsInRole(System.Security.Principal.WindowsBuiltInRole.Administrator);
+        }
+        else
+        {
+            // Unix/Linux/macOS: 检查是否为 root 用户
+            return Environment.UserName == "root" || (Environment.GetEnvironmentVariable("USER") == "root");
+        }
+    }
+
+    /// <summary>
+    /// 检查指定 IP 是否存在对应的 MAC，如果不存在则删除原有 ARP 记录并新增
+    /// </summary>
+    /// <param name="ipAddress">IP 地址</param>
+    /// <param name="macAddress">MAC 地址</param>
+    /// <param name="interfaceName">网络接口名称（可选）</param>
+    /// <returns>是否成功</returns>
+    public static async Task<bool> CheckOrAddAsync(string ipAddress, string macAddress, string? interfaceName = null)
+    {
+        if (string.IsNullOrWhiteSpace(ipAddress))
+            throw new ArgumentException("IP 地址不能为空", nameof(ipAddress));
+        if (string.IsNullOrWhiteSpace(macAddress))
+            throw new ArgumentException("MAC 地址不能为空", nameof(macAddress));
+
+        // 格式化 MAC 地址以适配不同操作系统
+        string formattedMac = FormatMacAddress(macAddress);
+
+        var entry = await GetArpEntryAsync(ipAddress);
+        if (entry != null && string.Equals(FormatMacAddress(entry.MacAddress), formattedMac, StringComparison.OrdinalIgnoreCase))
+        {
+            // 已存在且 MAC 匹配，无需操作
+            return true;
+        }
+
+        // 若存在但 MAC 不匹配，先删除
+        if (entry != null)
+        {
+            await DeleteArpEntryAsync(ipAddress, interfaceName);
+        }
+
+        // 新增 ARP 记录
+        var ret = await AddArpEntryAsync(ipAddress, formattedMac, interfaceName);
+        if (!ret) logger.Error($"添加 ARP 记录失败: {ipAddress} -> {formattedMac} on {interfaceName}");
+        return true;
+    }
+
+    /// <summary>
+    /// 格式化 MAC 地址为指定平台格式
+    /// </summary>
+    /// <param name="macAddress">原始 MAC 地址</param>
+    /// <returns>格式化后的 MAC 地址</returns>
+    public static string FormatMacAddress(string macAddress)
+    {
+        if (string.IsNullOrWhiteSpace(macAddress))
+            return string.Empty;
+
+        var cleaned = macAddress.Replace("-", "").Replace(":", "").ToLowerInvariant();
+        if (cleaned.Length != 12)
+            return macAddress;
+
+        if (RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
+        {
+            // Windows: XX-XX-XX-XX-XX-XX
+            return string.Join("-", Enumerable.Range(0, 6).Select(i => cleaned.Substring(i * 2, 2)));
+        }
+        else
+        {
+            // Unix/Linux/macOS: xx:xx:xx:xx:xx:xx
+            return string.Join(":", Enumerable.Range(0, 6).Select(i => cleaned.Substring(i * 2, 2)));
+        }
+    }
+}
+/// <summary>
+/// ARP 记录条目
+/// </summary>
+public class ArpEntry
+{
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public string Hostname { get; set; } = string.Empty;
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public string IpAddress { get; set; } = string.Empty;
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public string MacAddress { get; set; } = string.Empty;
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public string Type { get; set; } = string.Empty;
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public string Interface { get; set; } = string.Empty;
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public override string ToString()
+    {
+        return $"{IpAddress} -> {MacAddress} ({Interface})";
+    }
+}
+
+/// <summary>
+/// 命令执行结果
+/// </summary>
+public class CommandResult
+{
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public bool IsSuccess { get; set; }
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public string Output { get; set; } = string.Empty;
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public string Error { get; set; } = string.Empty;
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public int ExitCode { get; set; }
+}

server/src/BsdlParser.cs

@@ -0,0 +1,193 @@
+using DotNext;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
+
+namespace BsdlParser;
+
+/// <summary>
+/// [TODO:description]
+/// </summary>
+public class BoundaryScanRegs
+{
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public class CellEntry
+    {
+        /// <summary>
+        /// [TODO:description]
+        /// </summary>
+        [JsonProperty("cell_number")]
+        [JsonRequired]
+        public int CellNumber { get; set; }
+
+        /// <summary>
+        /// [TODO:description]
+        /// </summary>
+        [JsonProperty("cell_name")]
+        [JsonRequired]
+        public string CellName { get; set; } = "UnknownCellName";
+
+        /// <summary>
+        /// [TODO:description]
+        /// </summary>
+        [JsonProperty("port_id")]
+        public string? PortID { get; set; }
+
+        /// <summary>
+        /// [TODO:description]
+        /// </summary>
+        [JsonProperty("function")]
+        [JsonRequired]
+        public string? Function { get; set; }
+
+        /// <summary>
+        /// [TODO:description]
+        /// </summary>
+        [JsonProperty("safe_bit")]
+        [JsonRequired]
+        public string? SafeBit { get; set; }
+
+        /// <summary>
+        /// [TODO:description]
+        /// </summary>
+        [JsonProperty("ccell")]
+        public string? CCell { get; set; }
+
+        /// <summary>
+        /// [TODO:description]
+        /// </summary>
+        [JsonProperty("disabel_value")]
+        public string? DisableValue { get; set; }
+
+        /// <summary>
+        /// [TODO:description]
+        /// </summary>
+        [JsonProperty("disabel_result")]
+        public string? DisableResult { get; set; }
+    }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    [JsonProperty("register_length")]
+    [JsonRequired]
+    public int RegisterLength { get; set; }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    [JsonProperty("registers")]
+    [JsonRequired]
+    public CellEntry[] Registers { get; set; } = new CellEntry[] { };
+
+}
+
+/// <summary>
+/// [TODO:description]
+/// </summary>
+public class Parser
+{
+    private static NLog.Logger logger = NLog.LogManager.GetCurrentClassLogger();
+
+    private const string BOUNDARY_REGS_DESP = "boundary_registers.json";
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public JObject BoundaryRegsDesp { get; }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <returns>[TODO:return]</returns>
+    public Parser()
+    {
+        var filePath = Path.Combine(Environment.CurrentDirectory, BOUNDARY_REGS_DESP);
+        if (!Path.Exists(filePath))
+            throw new Exception($"Counld not find boundary_registers.json in {filePath}");
+
+        this.BoundaryRegsDesp = JObject.Parse(File.ReadAllText(filePath));
+    }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public Optional<int> GetBoundaryRegsNum()
+    {
+        var ret = this.BoundaryRegsDesp["register_length"];
+        if (ret is null) return new();
+        return Convert.ToInt32(ret);
+    }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <returns>[TODO:return]</returns>
+    public Optional<List<BoundaryScanRegs.CellEntry>> GetBoundaryPorts()
+    {
+        var registers = this.BoundaryRegsDesp["registers"]?.ToList();
+        if (registers is null) return new();
+
+        var cellList = new List<BoundaryScanRegs.CellEntry>();
+        foreach (var item in registers)
+        {
+            var cell = item.ToObject<BoundaryScanRegs.CellEntry>();
+            if (cell is null) return new();
+            cellList.Add(cell);
+        }
+
+        return cellList;
+    }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <returns>[TODO:return]</returns>
+    public Optional<List<BoundaryScanRegs.CellEntry>> GetBoundaryLogicalPorts()
+    {
+        var registers = this.BoundaryRegsDesp["registers"]?.ToList().Where((item) =>
+        {
+            return item["port_id"] is not null;
+        });
+        if (registers is null) return new();
+
+        var cellList = new List<BoundaryScanRegs.CellEntry>();
+        foreach (var item in registers)
+        {
+            var cell = item.ToObject<BoundaryScanRegs.CellEntry>();
+            if (cell is null) return new();
+            cellList.Add(cell);
+        }
+
+        return cellList;
+    }
+
+    // public Result<string> GetLogicalPorts()
+    // {
+    //     using (Py.GIL())
+    //     {
+    //         using (PyModule scope = Py.CreateScope())
+    //         {
+    //             string code = $@"
+    //                 bsdl_parser = BsdlParser({this.filePath})
+    //                 result = json.dumps(bsdl_parser.GetLogicPortDesp(), indent=2)
+    //             ";
+    //
+    //             var localVariables = new PyDict();
+    //             scope.Exec(code, localVariables);
+    //             if (!localVariables.HasKey("result"))
+    //                 return new(new Exception($"PythonNet doesn't has result from dict: {localVariables}"));
+    //
+    //             var result = localVariables.GetItem("result");
+    //             if (result is null)
+    //                 return new(new Exception($"PythonNet get null from dict: {localVariables}"));
+    //
+    //             var resultString = result.ToString();
+    //             if (resultString is null)
+    //                 return new(new Exception($"Pythonnet convert PyObject to string failed :{result}"));
+    //             return resultString;
+    //         }
+    //     }
+    // }
+}

server/src/Common.cs

@@ -1,178 +0,0 @@
-using DotNext;
-
-namespace Common
-{
-    /// <summary>
-    /// 数字处理工具
-    /// </summary>
-    public class Number
-    {
-        /// <summary>
-        /// 整数转成二进制字节数组
-        /// </summary>
-        /// <param name="num">整数</param>
-        /// <param name="length">整数长度</param>
-        /// <param name="isRightHigh">是否高位在右边</param>
-        /// <returns>二进制字节数组</returns>
-        public static Result<byte[]> NumberToBytes(ulong num, uint length, bool isRightHigh = false)
-        {
-            if (length > 8)
-            {
-                throw new ArgumentException(
-                    "Unsigned long number can't over 8 bytes(64 bits).",
-                    nameof(length)
-                );
-            }
-
-            var arr = new byte[length];
-
-            if (isRightHigh)
-            {
-                for (var i = 0; i < length; i++)
-                {
-                    arr[length - 1 - i] = Convert.ToByte((num >> (i << 3)) & (0xFF));
-                }
-            }
-            else
-            {
-                for (var i = 0; i < length; i++)
-                {
-                    arr[i] = Convert.ToByte((num >> ((int)(length - 1 - i) << 3)) & (0xFF));
-                }
-            }
-            return arr;
-        }
-
-        /// <summary>
-        /// 二进制字节数组转成整数
-        /// </summary>
-        /// <param name="bytes">二进制字节数组</param>
-        /// <param name="isRightHigh">是否高位在右边</param>
-        /// <returns>整数</returns>
-        public static Result<ulong> BytesToNumber(byte[] bytes, bool isRightHigh = false)
-        {
-            if (bytes.Length > 8)
-            {
-                throw new ArgumentException(
-                    "Unsigned long number can't over 8 bytes(64 bits).",
-                    nameof(bytes)
-                );
-            }
-
-            ulong num = 0;
-            int len = bytes.Length;
-
-            if (isRightHigh)
-            {
-                for (var i = 0; i < len; i++)
-                {
-                    num += Convert.ToUInt64((UInt64)bytes[len - 1 - i] << (i << 3));
-                }
-            }
-            else
-            {
-                for (var i = 0; i < len; i++)
-                {
-                    num += Convert.ToUInt64((UInt64)bytes[i] << ((int)(len - 1 - i) << 3));
-                }
-            }
-
-            return num;
-        }
-
-
-
-        /// <summary>
-        /// 比特合并成二进制字节
-        /// </summary>
-        /// <param name="bits1">[TODO:parameter]</param>
-        /// <param name="bits1Len">[TODO:parameter]</param>
-        /// <param name="bits2">[TODO:parameter]</param>
-        /// <param name="bits2Len">[TODO:parameter]</param>
-        /// <returns>[TODO:return]</returns>
-        public static Result<byte[]> MultiBitsToBytes(ulong bits1, uint bits1Len, ulong bits2, uint bits2Len)
-        {
-            return NumberToBytes(MultiBitsToNumber(bits1, bits1Len, bits2, bits2Len).Value,
-                        (bits1Len + bits2Len) % 8 != 0 ? (bits1Len + bits2Len) / 8 + 1 : (bits1Len + bits2Len) / 8);
-        }
-
-        /// <summary>
-        /// 比特合并成整型
-        /// </summary>
-        /// <param name="bits1">[TODO:parameter]</param>
-        /// <param name="bits1Len">[TODO:parameter]</param>
-        /// <param name="bits2">[TODO:parameter]</param>
-        /// <param name="bits2Len">[TODO:parameter]</param>
-        /// <returns>[TODO:return]</returns>
-        public static Result<ulong> MultiBitsToNumber(ulong bits1, uint bits1Len, ulong bits2, uint bits2Len)
-        {
-            if (bits1Len + bits2Len > 64) throw new ArgumentException("Two Bits is more than 64 bits");
-
-            ulong num = (bits1 << Convert.ToInt32(bits2Len)) | bits2;
-            return num;
-        }
-
-        /// <summary>
-        /// 比特合并成整型
-        /// </summary>
-        /// <param name="bits1">[TODO:parameter]</param>
-        /// <param name="bits1Len">[TODO:parameter]</param>
-        /// <param name="bits2">[TODO:parameter]</param>
-        /// <param name="bits2Len">[TODO:parameter]</param>
-        /// <returns>[TODO:return]</returns>
-        public static Result<uint> MultiBitsToNumber(uint bits1, uint bits1Len, uint bits2, uint bits2Len)
-        {
-            if (bits1Len + bits2Len > 64) throw new ArgumentException("Two Bits is more than 64 bits");
-
-            uint num = (bits1 << Convert.ToInt32(bits2Len)) | bits2;
-            return num;
-        }
-
-        /// <summary>
-        /// 比特位检查
-        /// </summary>
-        /// <param name="srcBits">[TODO:parameter]</param>
-        /// <param name="dstBits">[TODO:parameter]</param>
-        /// <param name="mask">[TODO:parameter]</param>
-        /// <returns>[TODO:return]</returns>
-        public static bool BitsCheck(ulong srcBits, ulong dstBits, ulong mask = 0xFFFF_FFFF_FFFF_FFFF)
-        {
-            return (srcBits & mask) == dstBits;
-        }
-
-        /// <summary>
-        /// 比特位检查
-        /// </summary>
-        /// <param name="srcBits">[TODO:parameter]</param>
-        /// <param name="dstBits">[TODO:parameter]</param>
-        /// <param name="mask">[TODO:parameter]</param>
-        /// <returns>[TODO:return]</returns>
-        public static bool BitsCheck(uint srcBits, uint dstBits, uint mask = 0xFFFF_FFFF)
-        {
-            return (srcBits & mask) == dstBits;
-        }
-
-
-        /// <summary>
-        /// 字符串转二进制字节数组
-        /// </summary>
-        /// <param name="str">[TODO:parameter]</param>
-        /// <param name="numBase">[TODO:parameter]</param>
-        /// <returns>[TODO:return]</returns>
-        public static byte[] StringToBytes(string str, int numBase = 16)
-        {
-            var len = str.Length;
-            var bytesLen = len / 2;
-            var bytes = new byte[bytesLen];
-
-            for (var i = 0; i < bytesLen; i++)
-            {
-                bytes[i] = Convert.ToByte(str.Substring(i * 2, 2), 16);
-            }
-
-            return bytes;
-        }
-
-    }
-
-}

server/src/Common/Global.cs

@@ -0,0 +1,21 @@
+using System.Net;
+using System.Net.Sockets;
+
+public static class Global
+{
+
+    public static readonly string localhost = "127.0.0.1";
+
+    public static string GetLocalIPAddress()
+    {
+        var host = Dns.GetHostEntry(Dns.GetHostName());
+        foreach (var ip in host.AddressList)
+        {
+            if (ip.AddressFamily == AddressFamily.InterNetwork)
+            {
+                return ip.ToString();
+            }
+        }
+        throw new Exception("No network adapters with an IPv4 address in the system!");
+    }
+}

server/src/Common/Image.cs

@@ -0,0 +1,358 @@
+using System.Text;
+using DotNext;
+using SixLabors.ImageSharp;
+using SixLabors.ImageSharp.Formats.Jpeg;
+using SixLabors.ImageSharp.PixelFormats;
+
+namespace Common;
+
+/// <summary>
+/// 图像处理工具
+/// </summary>
+public class Image
+{
+    /// <summary>
+    /// 将 RGB565 格式转换为 RGB24 格式
+    /// RGB565: 5位红色 + 6位绿色 + 5位蓝色 = 16位 (2字节)
+    /// RGB24: 8位红色 + 8位绿色 + 8位蓝色 = 24位 (3字节)
+    /// </summary>
+    /// <param name="rgb565Data">RGB565格式的原始数据</param>
+    /// <param name="width">图像宽度</param>
+    /// <param name="height">图像高度</param>
+    /// <param name="isLittleEndian">是否为小端序（默认为true）</param>
+    /// <returns>RGB24格式的转换后数据</returns>
+    public static Result<byte[]> ConvertRGB565ToRGB24(byte[] rgb565Data, int width, int height, bool isLittleEndian = true)
+    {
+        if (rgb565Data == null)
+            return new(new ArgumentNullException(nameof(rgb565Data)));
+
+        if (width <= 0 || height <= 0)
+            return new(new ArgumentException("Width and height must be positive"));
+
+        // 计算像素数量
+        var expectedPixelCount = width * height;
+        var actualPixelCount = rgb565Data.Length / 2;
+
+        if (actualPixelCount < expectedPixelCount)
+        {
+            return new(new ArgumentException(
+                $"RGB565 data length insufficient. Expected: {expectedPixelCount * 2} bytes, Actual: {rgb565Data.Length} bytes"));
+        }
+
+        try
+        {
+            var pixelCount = Math.Min(actualPixelCount, expectedPixelCount);
+            var rgb24Data = new byte[pixelCount * 3];
+
+            for (int i = 0; i < pixelCount; i++)
+            {
+                // 读取 RGB565 数据
+                var rgb565Index = i * 2;
+                if (rgb565Index + 1 >= rgb565Data.Length) break;
+
+                // 组合成16位值
+                UInt16 rgb565;
+                if (isLittleEndian)
+                {
+                    rgb565 = (UInt16)(rgb565Data[rgb565Index] | (rgb565Data[rgb565Index + 1] << 8));
+                }
+                else
+                {
+                    rgb565 = (UInt16)((rgb565Data[rgb565Index] << 8) | rgb565Data[rgb565Index + 1]);
+                }
+
+                // 提取各颜色分量
+                var r5 = (rgb565 >> 11) & 0x1F;  // 高5位为红色
+                var g6 = (rgb565 >> 5) & 0x3F;   // 中间6位为绿色
+                var b5 = rgb565 & 0x1F;          // 低5位为蓝色
+
+                // 转换为8位颜色值
+                var r8 = (byte)((r5 * 255) / 31);  // 5位扩展到8位
+                var g8 = (byte)((g6 * 255) / 63);  // 6位扩展到8位
+                var b8 = (byte)((b5 * 255) / 31);  // 5位扩展到8位
+
+                // 存储到 RGB24 数组
+                var rgb24Index = (i%2 == 0)?((i+1) * 3):((i-1) * 3);
+                rgb24Data[rgb24Index] = r8;     // R
+                rgb24Data[rgb24Index + 1] = g8; // G
+                rgb24Data[rgb24Index + 2] = b8; // B
+            }
+
+            return rgb24Data;
+        }
+        catch (Exception ex)
+        {
+            return new(ex);
+        }
+    }
+
+    /// <summary>
+    /// 将 RGB24 格式转换为 RGB565 格式
+    /// RGB24: 8位红色 + 8位绿色 + 8位蓝色 = 24位 (3字节)
+    /// RGB565: 5位红色 + 6位绿色 + 5位蓝色 = 16位 (2字节)
+    /// </summary>
+    /// <param name="rgb24Data">RGB24格式的原始数据</param>
+    /// <param name="width">图像宽度</param>
+    /// <param name="height">图像高度</param>
+    /// <param name="isLittleEndian">是否为小端序（默认为true）</param>
+    /// <returns>RGB565格式的转换后数据</returns>
+    public static Result<byte[]> ConvertRGB24ToRGB565(byte[] rgb24Data, int width, int height, bool isLittleEndian = true)
+    {
+        if (rgb24Data == null)
+            return new(new ArgumentNullException(nameof(rgb24Data)));
+
+        if (width <= 0 || height <= 0)
+            return new(new ArgumentException("Width and height must be positive"));
+
+        var expectedPixelCount = width * height;
+        var actualPixelCount = rgb24Data.Length / 3;
+
+        if (actualPixelCount < expectedPixelCount)
+        {
+            return new(new ArgumentException(
+                $"RGB24 data length insufficient. Expected: {expectedPixelCount * 3} bytes, Actual: {rgb24Data.Length} bytes"));
+        }
+
+        try
+        {
+            var pixelCount = Math.Min(actualPixelCount, expectedPixelCount);
+            var rgb565Data = new byte[pixelCount * 2];
+
+            for (int i = 0; i < pixelCount; i++)
+            {
+                var rgb24Index = i * 3;
+                if (rgb24Index + 2 >= rgb24Data.Length) break;
+
+                // 读取 RGB24 数据
+                var r8 = rgb24Data[rgb24Index];
+                var g8 = rgb24Data[rgb24Index + 1];
+                var b8 = rgb24Data[rgb24Index + 2];
+
+                // 转换为5位、6位、5位
+                var r5 = (UInt16)((r8 * 31) / 255);
+                var g6 = (UInt16)((g8 * 63) / 255);
+                var b5 = (UInt16)((b8 * 31) / 255);
+
+                // 组合成16位值
+                var rgb565 = (UInt16)((r5 << 11) | (g6 << 5) | b5);
+
+                // 存储到 RGB565 数组
+                var rgb565Index = i * 2;
+                if (isLittleEndian)
+                {
+                    rgb565Data[rgb565Index] = (byte)(rgb565 & 0xFF);
+                    rgb565Data[rgb565Index + 1] = (byte)(rgb565 >> 8);
+                }
+                else
+                {
+                    rgb565Data[rgb565Index] = (byte)(rgb565 >> 8);
+                    rgb565Data[rgb565Index + 1] = (byte)(rgb565 & 0xFF);
+                }
+            }
+
+            return rgb565Data;
+        }
+        catch (Exception ex)
+        {
+            return new(ex);
+        }
+    }
+
+    /// <summary>
+    /// 将 RGB24 数据转换为 JPEG 格式
+    /// </summary>
+    /// <param name="rgb24Data">RGB24格式的图像数据</param>
+    /// <param name="width">图像宽度</param>
+    /// <param name="height">图像高度</param>
+    /// <param name="quality">JPEG质量（1-100，默认80）</param>
+    /// <returns>JPEG格式的字节数组</returns>
+    public static Result<byte[]> ConvertRGB24ToJpeg(byte[] rgb24Data, int width, int height, int quality = 80)
+    {
+        if (rgb24Data == null)
+            return new(new ArgumentNullException(nameof(rgb24Data)));
+
+        if (width <= 0 || height <= 0)
+            return new(new ArgumentException("Width and height must be positive"));
+
+        if (quality < 1 || quality > 100)
+            return new(new ArgumentException("Quality must be between 1 and 100"));
+
+        var expectedDataLength = width * height * 3;
+        if (rgb24Data.Length < expectedDataLength)
+        {
+            return new(new ArgumentException(
+                $"RGB24 data length insufficient. Expected: {expectedDataLength} bytes, Actual: {rgb24Data.Length} bytes"));
+        }
+
+        try
+        {
+            using var image = new SixLabors.ImageSharp.Image<Rgb24>(width, height);
+
+            // 将 RGB 数据复制到 ImageSharp 图像
+            for (int y = 0; y < height; y++)
+            {
+                for (int x = 0; x < width; x++)
+                {
+                    int index = (y * width + x) * 3;
+                    if (index + 2 < rgb24Data.Length)
+                    {
+                        var pixel = new Rgb24(rgb24Data[index], rgb24Data[index + 1], rgb24Data[index + 2]);
+                        image[x, y] = pixel;
+                    }
+                }
+            }
+
+            using var stream = new MemoryStream();
+            image.SaveAsJpeg(stream, new JpegEncoder { Quality = quality });
+            return stream.ToArray();
+        }
+        catch (Exception ex)
+        {
+            return new(ex);
+        }
+    }
+
+    /// <summary>
+    /// 将 RGB565 数据直接转换为 JPEG 格式
+    /// </summary>
+    /// <param name="rgb565Data">RGB565格式的图像数据</param>
+    /// <param name="width">图像宽度</param>
+    /// <param name="height">图像高度</param>
+    /// <param name="quality">JPEG质量（1-100，默认80）</param>
+    /// <param name="isLittleEndian">是否为小端序（默认为true）</param>
+    /// <returns>JPEG格式的字节数组</returns>
+    public static Result<byte[]> ConvertRGB565ToJpeg(byte[] rgb565Data, int width, int height, int quality = 80, bool isLittleEndian = true)
+    {
+        // 先转换为RGB24
+        var rgb24Result = ConvertRGB565ToRGB24(rgb565Data, width, height, isLittleEndian);
+        if (!rgb24Result.IsSuccessful)
+        {
+            return new(rgb24Result.Error);
+        }
+
+        // 再转换为JPEG
+        return ConvertRGB24ToJpeg(rgb24Result.Value, width, height, quality);
+    }
+
+    /// <summary>
+    /// 创建 MJPEG 帧头部
+    /// </summary>
+    /// <param name="frameDataLength">帧数据长度</param>
+    /// <param name="boundary">边界字符串（默认为"--boundary"）</param>
+    /// <returns>MJPEG帧头部字节数组</returns>
+    public static byte[] CreateMjpegFrameHeader(int frameDataLength, string boundary = "--boundary")
+    {
+        var header = $"{boundary}\r\nContent-Type: image/jpeg\r\nContent-Length: {frameDataLength}\r\n\r\n";
+        return Encoding.ASCII.GetBytes(header);
+    }
+
+    /// <summary>
+    /// 创建 MJPEG 帧尾部
+    /// </summary>
+    /// <returns>MJPEG帧尾部字节数组</returns>
+    public static byte[] CreateMjpegFrameFooter()
+    {
+        return Encoding.ASCII.GetBytes("\r\n");
+    }
+
+    /// <summary>
+    /// 创建完整的 MJPEG 帧数据
+    /// </summary>
+    /// <param name="jpegData">JPEG数据</param>
+    /// <param name="boundary">边界字符串（默认为"--boundary"）</param>
+    /// <returns>完整的MJPEG帧数据</returns>
+    public static Result<byte[]> CreateMjpegFrame(byte[] jpegData, string boundary = "--boundary")
+    {
+        if (jpegData == null)
+            return new(new ArgumentNullException(nameof(jpegData)));
+
+        try
+        {
+            var header = CreateMjpegFrameHeader(jpegData.Length, boundary);
+            var footer = CreateMjpegFrameFooter();
+
+            var totalLength = header.Length + jpegData.Length + footer.Length;
+            var frameData = new byte[totalLength];
+
+            var offset = 0;
+            Array.Copy(header, 0, frameData, offset, header.Length);
+            offset += header.Length;
+
+            Array.Copy(jpegData, 0, frameData, offset, jpegData.Length);
+            offset += jpegData.Length;
+
+            Array.Copy(footer, 0, frameData, offset, footer.Length);
+
+            return frameData;
+        }
+        catch (Exception ex)
+        {
+            return new(ex);
+        }
+    }
+
+    /// <summary>
+    /// 验证图像数据长度是否正确
+    /// </summary>
+    /// <param name="data">图像数据</param>
+    /// <param name="width">图像宽度</param>
+    /// <param name="height">图像高度</param>
+    /// <param name="bytesPerPixel">每像素字节数</param>
+    /// <returns>验证结果</returns>
+    public static bool ValidateImageDataLength(byte[] data, int width, int height, int bytesPerPixel)
+    {
+        if (data == null || width <= 0 || height <= 0 || bytesPerPixel <= 0)
+            return false;
+
+        var expectedLength = width * height * bytesPerPixel;
+        return data.Length >= expectedLength;
+    }
+
+    /// <summary>
+    /// 获取图像格式信息
+    /// </summary>
+    /// <param name="format">图像格式枚举</param>
+    /// <returns>格式信息</returns>
+    public static ImageFormatInfo GetImageFormatInfo(ImageFormat format)
+    {
+        return format switch
+        {
+            ImageFormat.RGB565 => new ImageFormatInfo("RGB565", 2, "16-bit RGB format (5R+6G+5B)"),
+            ImageFormat.RGB24 => new ImageFormatInfo("RGB24", 3, "24-bit RGB format (8R+8G+8B)"),
+            ImageFormat.RGBA32 => new ImageFormatInfo("RGBA32", 4, "32-bit RGBA format (8R+8G+8B+8A)"),
+            ImageFormat.Grayscale8 => new ImageFormatInfo("Grayscale8", 1, "8-bit grayscale format"),
+            _ => new ImageFormatInfo("Unknown", 0, "Unknown image format")
+        };
+    }
+}
+
+/// <summary>
+/// 图像格式枚举
+/// </summary>
+public enum ImageFormat
+{
+    /// <summary>
+    /// RGB565
+    /// </summary>
+    RGB565,
+
+    /// <summary>
+    /// RGB888 / RGB24
+    /// </summary>
+    RGB24,
+
+    /// <summary>
+    /// RGBA8888 / RGBA32
+    /// </summary>
+    RGBA32,
+
+    /// <summary>
+    /// 灰度图
+    /// </summary>
+    Grayscale8
+}
+
+/// <summary>
+/// 图像格式信息
+/// </summary>
+public record ImageFormatInfo(string Name, int BytesPerPixel, string Description);

server/src/Common/Number.cs

@@ -0,0 +1,351 @@
+using System.Collections;
+using DotNext;
+
+namespace Common;
+/// <summary>
+/// 数字处理工具
+/// </summary>
+public class Number
+{
+    private static readonly byte[] BitReverseTable = new byte[] {
+            0x00, 0x80, 0x40, 0xc0, 0x20, 0xa0, 0x60, 0xe0,
+            0x10, 0x90, 0x50, 0xd0, 0x30, 0xb0, 0x70, 0xf0,
+            0x08, 0x88, 0x48, 0xc8, 0x28, 0xa8, 0x68, 0xe8,
+            0x18, 0x98, 0x58, 0xd8, 0x38, 0xb8, 0x78, 0xf8,
+            0x04, 0x84, 0x44, 0xc4, 0x24, 0xa4, 0x64, 0xe4,
+            0x14, 0x94, 0x54, 0xd4, 0x34, 0xb4, 0x74, 0xf4,
+            0x0c, 0x8c, 0x4c, 0xcc, 0x2c, 0xac, 0x6c, 0xec,
+            0x1c, 0x9c, 0x5c, 0xdc, 0x3c, 0xbc, 0x7c, 0xfc,
+            0x02, 0x82, 0x42, 0xc2, 0x22, 0xa2, 0x62, 0xe2,
+            0x12, 0x92, 0x52, 0xd2, 0x32, 0xb2, 0x72, 0xf2,
+            0x0a, 0x8a, 0x4a, 0xca, 0x2a, 0xaa, 0x6a, 0xea,
+            0x1a, 0x9a, 0x5a, 0xda, 0x3a, 0xba, 0x7a, 0xfa,
+            0x06, 0x86, 0x46, 0xc6, 0x26, 0xa6, 0x66, 0xe6,
+            0x16, 0x96, 0x56, 0xd6, 0x36, 0xb6, 0x76, 0xf6,
+            0x0e, 0x8e, 0x4e, 0xce, 0x2e, 0xae, 0x6e, 0xee,
+            0x1e, 0x9e, 0x5e, 0xde, 0x3e, 0xbe, 0x7e, 0xfe,
+            0x01, 0x81, 0x41, 0xc1, 0x21, 0xa1, 0x61, 0xe1,
+            0x11, 0x91, 0x51, 0xd1, 0x31, 0xb1, 0x71, 0xf1,
+            0x09, 0x89, 0x49, 0xc9, 0x29, 0xa9, 0x69, 0xe9,
+            0x19, 0x99, 0x59, 0xd9, 0x39, 0xb9, 0x79, 0xf9,
+            0x05, 0x85, 0x45, 0xc5, 0x25, 0xa5, 0x65, 0xe5,
+            0x15, 0x95, 0x55, 0xd5, 0x35, 0xb5, 0x75, 0xf5,
+            0x0d, 0x8d, 0x4d, 0xcd, 0x2d, 0xad, 0x6d, 0xed,
+            0x1d, 0x9d, 0x5d, 0xdd, 0x3d, 0xbd, 0x7d, 0xfd,
+            0x03, 0x83, 0x43, 0xc3, 0x23, 0xa3, 0x63, 0xe3,
+            0x13, 0x93, 0x53, 0xd3, 0x33, 0xb3, 0x73, 0xf3,
+            0x0b, 0x8b, 0x4b, 0xcb, 0x2b, 0xab, 0x6b, 0xeb,
+            0x1b, 0x9b, 0x5b, 0xdb, 0x3b, 0xbb, 0x7b, 0xfb,
+            0x07, 0x87, 0x47, 0xc7, 0x27, 0xa7, 0x67, 0xe7,
+            0x17, 0x97, 0x57, 0xd7, 0x37, 0xb7, 0x77, 0xf7,
+            0x0f, 0x8f, 0x4f, 0xcf, 0x2f, 0xaf, 0x6f, 0xef,
+            0x1f, 0x9f, 0x5f, 0xdf, 0x3f, 0xbf, 0x7f, 0xff
+        };
+
+    /// <summary>
+    /// 整数转成二进制字节数组
+    /// </summary>
+    /// <param name="num">整数</param>
+    /// <param name="length">整数长度</param>
+    /// <param name="isLowNumHigh">是否高位在数组索引低</param>
+    /// <returns>二进制字节数组</returns>
+    public static Result<byte[]> NumberToBytes(ulong num, uint length, bool isLowNumHigh = false)
+    {
+        if (length > 8)
+        {
+            return new(new ArgumentException(
+                "Unsigned long number can't over 8 bytes(64 bits).",
+                nameof(length)
+            ));
+        }
+
+        var arr = new byte[length];
+
+        if (isLowNumHigh)
+        {
+            for (var i = 0; i < length; i++)
+            {
+                arr[i] = Convert.ToByte((num >> (i << 3)) & (0xFF));
+            }
+        }
+        else
+        {
+            for (var i = 0; i < length; i++)
+            {
+                arr[i] = Convert.ToByte((num >> ((int)(length - 1 - i) << 3)) & (0xFF));
+            }
+        }
+        return arr;
+    }
+
+    /// <summary>
+    /// 二进制字节数组转成64bits整数
+    /// </summary>
+    /// <param name="bytes">二进制字节数组</param>
+    /// <param name="isLowNumHigh">是否高位在数组索引低</param>
+    /// <returns>整数</returns>
+    public static Result<UInt64> BytesToUInt64(byte[] bytes, bool isLowNumHigh = false)
+    {
+        if (bytes.Length > 8)
+        {
+            return new(new ArgumentException(
+                "Unsigned long number can't over 8 bytes(64 bits).",
+                nameof(bytes)
+            ));
+        }
+
+        UInt64 num = 0;
+        int len = bytes.Length;
+
+        try
+        {
+            if (!isLowNumHigh)
+            {
+                Array.Reverse(bytes);
+            }
+            num = BitConverter.ToUInt64(bytes, 0);
+
+            return num;
+        }
+        catch (Exception error)
+        {
+            return new(error);
+        }
+    }
+
+    /// <summary>
+    /// 二进制字节数组转成32bits整数
+    /// </summary>
+    /// <param name="bytes">二进制字节数组</param>
+    /// <param name="isLowNumHigh">是否高位在数组索引低</param>
+    /// <returns>整数</returns>
+    public static Result<UInt32> BytesToUInt32(byte[] bytes, bool isLowNumHigh = false)
+    {
+        if (bytes.Length > 4)
+        {
+            return new(new ArgumentException(
+                "Unsigned long number can't over 4 bytes(32 bits).",
+                nameof(bytes)
+            ));
+        }
+
+        UInt32 num = 0;
+        int len = bytes.Length;
+
+        try
+        {
+            if (!isLowNumHigh)
+            {
+                Array.Reverse(bytes);
+            }
+            num = BitConverter.ToUInt32(bytes, 0);
+
+            return num;
+        }
+        catch (Exception error)
+        {
+            return new(error);
+        }
+
+    }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <param name="uintArray">[TODO:parameter]</param>
+    /// <returns>[TODO:return]</returns>
+    public static Result<byte[]> UInt32ArrayToBytes(UInt32[] uintArray)
+    {
+        byte[] byteArray = new byte[uintArray.Length * 4];
+        try
+        {
+            Buffer.BlockCopy(uintArray, 0, byteArray, 0, uintArray.Length * 4);
+            return byteArray;
+        }
+        catch (Exception error)
+        {
+            return new(error);
+        }
+    }
+
+
+
+    /// <summary>
+    /// 比特合并成二进制字节
+    /// </summary>
+    /// <param name="bits1">第一个比特值</param>
+    /// <param name="bits1Len">第一个比特值的长度（位数）</param>
+    /// <param name="bits2">第二个比特值</param>
+    /// <param name="bits2Len">第二个比特值的长度（位数）</param>
+    /// <returns>合并后的二进制字节数组</returns>
+    public static Result<byte[]> MultiBitsToBytes(ulong bits1, uint bits1Len, ulong bits2, uint bits2Len)
+    {
+        return NumberToBytes(MultiBitsToNumber(bits1, bits1Len, bits2, bits2Len).Value,
+                    (bits1Len + bits2Len) % 8 != 0 ? (bits1Len + bits2Len) / 8 + 1 : (bits1Len + bits2Len) / 8);
+    }
+
+    /// <summary>
+    /// 比特合并成整型
+    /// </summary>
+    /// <param name="bits1">第一个比特值</param>
+    /// <param name="bits1Len">第一个比特值的长度（位数）</param>
+    /// <param name="bits2">第二个比特值</param>
+    /// <param name="bits2Len">第二个比特值的长度（位数）</param>
+    /// <returns>合并后的整型值</returns>
+    public static Result<ulong> MultiBitsToNumber(ulong bits1, uint bits1Len, ulong bits2, uint bits2Len)
+    {
+        if (bits1Len + bits2Len > 64) return new(new ArgumentException("Two Bits is more than 64 bits"));
+
+        ulong num = (bits1 << Convert.ToInt32(bits2Len)) | bits2;
+        return num;
+    }
+
+    /// <summary>
+    /// 比特合并成整型
+    /// </summary>
+    /// <param name="bits1">第一个比特值</param>
+    /// <param name="bits1Len">第一个比特值的长度（位数）</param>
+    /// <param name="bits2">第二个比特值</param>
+    /// <param name="bits2Len">第二个比特值的长度（位数）</param>
+    /// <returns>合并后的整型值</returns>
+    public static Result<uint> MultiBitsToNumber(uint bits1, uint bits1Len, uint bits2, uint bits2Len)
+    {
+        if (bits1Len + bits2Len > 64) return new(new ArgumentException("Two Bits is more than 64 bits"));
+
+        uint num = (bits1 << Convert.ToInt32(bits2Len)) | bits2;
+        return num;
+    }
+
+    /// <summary>
+    /// 比特位检查
+    /// </summary>
+    /// <param name="srcBits">源比特值</param>
+    /// <param name="dstBits">目标比特值</param>
+    /// <param name="mask">掩码（默认为全1）</param>
+    /// <returns>检查结果（是否匹配）</returns>
+    public static bool BitsCheck(ulong srcBits, ulong dstBits, ulong mask = 0xFFFF_FFFF_FFFF_FFFF)
+    {
+        return (srcBits & mask) == dstBits;
+    }
+
+    /// <summary>
+    /// 比特位检查
+    /// </summary>
+    /// <param name="srcBits">源比特值</param>
+    /// <param name="dstBits">目标比特值</param>
+    /// <param name="mask">掩码（默认为全1）</param>
+    /// <returns>检查结果（是否匹配）</returns>
+    public static bool BitsCheck(uint srcBits, uint dstBits, uint mask = 0xFFFF_FFFF)
+    {
+        return (srcBits & mask) == dstBits;
+    }
+
+    /// <summary>
+    /// 获取整型对应位置的比特
+    /// </summary>
+    /// <param name="srcBits">整型数字</param>
+    /// <param name="location">位置</param>
+    /// <returns>比特</returns>
+    public static Result<bool> ToBit(UInt32 srcBits, int location)
+    {
+        if (location < 0)
+            return new(new ArgumentException(
+                "Location can't be negetive", nameof(location)));
+
+        return ((srcBits >> location) & ((UInt32)0b1)) == 1;
+    }
+
+    /// <summary>
+    /// 将BitArray转化为32bits无符号整型
+    /// </summary>
+    /// <param name="bits">BitArray比特数组</param>
+    /// <returns>32bits无符号整型</returns>
+    public static Result<UInt32> BitsToNumber(BitArray bits)
+    {
+        if (bits.Length > 32)
+            throw new ArgumentException("Argument length shall be at most 32 bits.");
+
+        var array = new UInt32[1];
+        bits.CopyTo(array, 0);
+        return array[0];
+    }
+
+
+    /// <summary>
+    /// 字符串转二进制字节数组
+    /// </summary>
+    /// <param name="str">输入的字符串</param>
+    /// <param name="numBase">进制（默认为16进制）</param>
+    /// <returns>转换后的二进制字节数组</returns>
+    public static byte[] StringToBytes(string str, int numBase = 16)
+    {
+        var len = str.Length;
+        var bytesLen = len / 2;
+        var bytes = new byte[bytesLen];
+
+        for (var i = 0; i < bytesLen; i++)
+        {
+            bytes[i] = Convert.ToByte(str.Substring(i * 2, 2), 16);
+        }
+
+        return bytes;
+    }
+
+    /// <summary>
+    /// 反转字节数组中的子数组
+    /// </summary>
+    /// <param name="srcBytes">源字节数组</param>
+    /// <param name="distance">子数组的长度（反转的步长）</param>
+    /// <returns>反转后的字节数组</returns>
+    public static Result<byte[]> ReverseBytes(byte[] srcBytes, int distance)
+    {
+        if (distance <= 0)
+            return new(new ArgumentException("Distance can't be negetive", nameof(distance)));
+
+        var srcBytesLen = srcBytes.Length;
+        if (distance > srcBytesLen)
+            return new(new ArgumentException(
+                "Distance is larger than bytesArray", nameof(distance)));
+        if (srcBytesLen % distance != 0)
+            return new(new ArgumentException(
+                "The length of bytes can't be divided by distance without reminder", nameof(distance)));
+
+        var dstBytes = new byte[srcBytesLen];
+        var buffer = new byte[distance];
+
+        for (int i = 0; i < srcBytesLen; i += distance)
+        {
+            Buffer.BlockCopy(srcBytes, i, buffer, 0, distance);
+            Array.Reverse(buffer);
+            Buffer.BlockCopy(buffer, 0, dstBytes, i, distance);
+        }
+
+        return dstBytes;
+    }
+
+    /// <summary>
+    /// 反转字节内比特顺序（使用查找表的方法）
+    /// </summary>
+    /// <param name="srcByte">字节</param>
+    /// <returns>反转后的字节</returns>
+    public static byte ReverseBits(byte srcByte)
+    {
+        return BitReverseTable[srcByte];
+    }
+
+    /// <summary>
+    /// 反转字节数组的字节内比特顺序（使用查找表的方法）
+    /// </summary>
+    /// <param name="srcBytes">字节数组</param>
+    /// <returns>反转后的字节字节数组</returns>
+    public static byte[] ReverseBits(byte[] srcBytes)
+    {
+        var bytesLen = srcBytes.Length;
+        var dstBytes = new byte[bytesLen];
+        for (int i = 0; i < bytesLen; i++)
+        {
+            dstBytes[i] = BitReverseTable[srcBytes[i]];
+        }
+        return dstBytes;
+    }
+}

server/src/Common/SemaphorePool.cs

@@ -0,0 +1,116 @@
+using System.Collections.Concurrent;
+using DotNext;
+
+namespace Common;
+
+/// <summary>
+/// [TODO:description]
+/// </summary>
+public class SemaphorePool
+{
+    private SemaphoreSlim semaphore;
+    private ConcurrentQueue<int> queue;
+    private int beginNum;
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public int RemainingCount { get; }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public int MaxCount { get; }
+
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <param name="initialCount">[TODO:parameter]</param>
+    /// <param name="beginNum">[TODO:parameter]</param>
+    /// <returns>[TODO:return]</returns>
+    public SemaphorePool(int initialCount, int beginNum = 0)
+    {
+        semaphore = new SemaphoreSlim(initialCount);
+        queue = new ConcurrentQueue<int>();
+        this.beginNum = beginNum;
+        this.RemainingCount = initialCount;
+        this.MaxCount = initialCount;
+        for (int i = 0; i < initialCount; i++)
+        {
+            queue.Enqueue(beginNum + i);
+        }
+    }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <param name="initialCount">[TODO:parameter]</param>
+    /// <param name="maxCount">[TODO:parameter]</param>
+    /// <param name="beginNum">[TODO:parameter]</param>
+    /// <returns>[TODO:return]</returns>
+    public SemaphorePool(int initialCount, int maxCount, int beginNum = 0)
+    {
+        semaphore = new SemaphoreSlim(initialCount, maxCount);
+        queue = new ConcurrentQueue<int>();
+        this.beginNum = beginNum;
+        this.RemainingCount = initialCount;
+        this.MaxCount = maxCount;
+        for (int i = 0; i < initialCount; i++)
+        {
+            queue.Enqueue(beginNum + i);
+        }
+    }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <returns>[TODO:return]</returns>
+    public Result<int> Wait()
+    {
+        semaphore.Wait();
+
+        int pop;
+        if (queue.TryDequeue(out pop))
+        {
+            return pop;
+        }
+        else
+        {
+            return new(new Exception($"TODO"));
+        }
+    }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <returns>[TODO:return]</returns>
+    public async ValueTask<Result<int>> WaitAsync()
+    {
+        await semaphore.WaitAsync();
+
+        int pop;
+        if (queue.TryDequeue(out pop))
+        {
+            return pop;
+        }
+        else
+        {
+            return new(new Exception($"TODO"));
+        }
+    }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <returns>[TODO:return]</returns>
+    public void Release()
+    {
+        semaphore.Release();
+        queue.Clear();
+        for (int i = 0; i < MaxCount; i++)
+        {
+            queue.Enqueue(beginNum + i);
+        }
+    }
+}

server/src/Common/String.cs

@@ -0,0 +1,20 @@
+namespace Common;
+
+/// <summary>
+/// 字符串处理工具
+/// </summary>
+public class String
+{
+    /// <summary>
+    /// 反转字符串
+    /// </summary>
+    /// <param name="s">输入的字符串</param>
+    /// <returns>反转后的字符串</returns>
+    public static string Reverse(string s)
+    {
+        char[] charArray = s.ToCharArray();
+        Array.Reverse(charArray);
+        return new string(charArray);
+    }
+
+}

server/src/Controllers/BsdlParserController.cs

@@ -0,0 +1,30 @@
+using Microsoft.AspNetCore.Cors;
+using Microsoft.AspNetCore.Mvc;
+
+namespace server.Controllers;
+
+/// <summary>
+/// [TODO:description]
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+public class BsdlParserController : ControllerBase
+{
+    private static NLog.Logger logger = NLog.LogManager.GetCurrentClassLogger();
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <returns>[TODO:return]</returns>
+    [EnableCors("Development")]
+    [HttpGet("GetBoundaryLogicalPorts")]
+    public IResult GetBoundaryLogicalPorts()
+    {
+        var parser = new BsdlParser.Parser();
+        var ret = parser.GetBoundaryLogicalPorts();
+        if (ret.IsNull) return TypedResults.InternalServerError("Get Null");
+        return TypedResults.Ok(ret.Value);
+    }
+}
+
+

server/src/Controllers/DDSController.cs

@@ -0,0 +1,108 @@
+using Microsoft.AspNetCore.Cors;
+using Microsoft.AspNetCore.Mvc;
+
+namespace server.Controllers;
+
+/// <summary>
+/// [TODO:description]
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+public class DDSController : ControllerBase
+{
+    private static NLog.Logger logger = NLog.LogManager.GetCurrentClassLogger();
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <param name="address">[TODO:parameter]</param>
+    /// <param name="port">[TODO:parameter]</param>
+    /// <param name="channelNum">[TODO:parameter]</param>
+    /// <param name="waveNum">[TODO:parameter]</param>
+    /// <returns>[TODO:return]</returns>
+    [HttpPost("SetWaveNum")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ArgumentException), StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(typeof(Exception), StatusCodes.Status500InternalServerError)]
+    public async ValueTask<IResult> SetWaveNum(string address, int port, int channelNum, int waveNum)
+    {
+        var dds = new Peripherals.DDSClient.DDS(address, port);
+
+        var ret = await dds.SetWaveNum(channelNum, waveNum);
+        if (ret.IsSuccessful)
+        {
+            logger.Info($"Device {address} set output wave num successfully");
+            return TypedResults.Ok(ret.Value);
+        }
+        else
+        {
+            logger.Error(ret.Error);
+            return TypedResults.InternalServerError(ret.Error);
+        }
+    }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <param name="address">[TODO:parameter]</param>
+    /// <param name="port">[TODO:parameter]</param>
+    /// <param name="channelNum">[TODO:parameter]</param>
+    /// <param name="waveNum">[TODO:parameter]</param>
+    /// <param name="step">[TODO:parameter]</param>
+    /// <returns>[TODO:return]</returns>
+    [HttpPost("SetFreq")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ArgumentException), StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(typeof(Exception), StatusCodes.Status500InternalServerError)]
+    public async ValueTask<IResult> SetFreq(string address, int port, int channelNum, int waveNum, UInt32 step)
+    {
+        var dds = new Peripherals.DDSClient.DDS(address, port);
+
+        var ret = await dds.SetFreq(channelNum, waveNum, step);
+        if (ret.IsSuccessful)
+        {
+            logger.Info($"Device {address} set output freqency successfully");
+            return TypedResults.Ok(ret.Value);
+        }
+        else
+        {
+            logger.Error(ret.Error);
+            return TypedResults.InternalServerError(ret.Error);
+        }
+    }
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    /// <param name="address">[TODO:parameter]</param>
+    /// <param name="port">[TODO:parameter]</param>
+    /// <param name="channelNum">[TODO:parameter]</param>
+    /// <param name="waveNum">[TODO:parameter]</param>
+    /// <param name="phase">[TODO:parameter]</param>
+    /// <returns>[TODO:return]</returns>
+    [HttpPost("SetPhase")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(ArgumentException), StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(typeof(Exception), StatusCodes.Status500InternalServerError)]
+    public async ValueTask<IResult> SetPhase(string address, int port, int channelNum, int waveNum, int phase)
+    {
+        var dds = new Peripherals.DDSClient.DDS(address, port);
+
+        var ret = await dds.SetPhase(channelNum, waveNum, phase);
+        if (ret.IsSuccessful)
+        {
+            logger.Info($"Device {address} set output phase successfully");
+            return TypedResults.Ok(ret.Value);
+        }
+        else
+        {
+            logger.Error(ret.Error);
+            return TypedResults.InternalServerError(ret.Error);
+        }
+
+    }
+
+}

server/src/Controllers/DataController.cs

@@ -0,0 +1,492 @@
+using System.IdentityModel.Tokens.Jwt;
+using System.Net;
+using System.Security.Claims;
+using System.Text;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Cors;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.IdentityModel.Tokens;
+
+namespace server.Controllers;
+
+/// <summary>
+/// 数据控制器
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+public class DataController : ControllerBase
+{
+    private static NLog.Logger logger = NLog.LogManager.GetCurrentClassLogger();
+    // 固定的实验板IP,端口,MAC地址
+    private const string BOARD_IP = "169.254.109.0";
+
+    /// <summary>
+    /// [TODO:description]
+    /// </summary>
+    public class UserInfo
+    {
+        /// <summary>
+        /// 用户的唯一标识符
+        /// </summary>
+        public Guid ID { get; set; }
+
+        /// <summary>
+        /// 用户的名称
+        /// </summary>
+        public required string Name { get; set; }
+
+        /// <summary>
+        /// 用户的电子邮箱
+        /// </summary>
+        public required string EMail { get; set; }
+
+        /// <summary>
+        /// 用户关联的板卡ID
+        /// </summary>
+        public Guid BoardID { get; set; }
+
+        /// <summary>
+        /// 用户绑定板子的过期时间
+        /// </summary>
+        public DateTime? BoardExpireTime { get; set; }
+    }
+
+    /// <summary>
+    /// 获取本机IP地址（优先选择与实验板同网段的IP）
+    /// </summary>
+    /// <returns>本机IP地址</returns>
+    private IPAddress GetLocalIPAddress()
+    {
+        try
+        {
+            var boardIpSegments = BOARD_IP.Split('.').Take(3).ToArray();
+
+            // 优先选择与实验板IP前三段相同的IP
+            var sameSegmentIP = System.Net.NetworkInformation.NetworkInterface
+                .GetAllNetworkInterfaces()
+                .Where(nic => nic.OperationalStatus == System.Net.NetworkInformation.OperationalStatus.Up
+                              && nic.NetworkInterfaceType != System.Net.NetworkInformation.NetworkInterfaceType.Loopback)
+                .SelectMany(nic => nic.GetIPProperties().UnicastAddresses)
+                .Where(addr => addr.Address.AddressFamily == System.Net.Sockets.AddressFamily.InterNetwork)
+                .Select(addr => addr.Address)
+                .FirstOrDefault(addr =>
+                {
+                    var segments = addr.ToString().Split('.');
+                    return segments.Length == 4 &&
+                           segments[0] == boardIpSegments[0] &&
+                           segments[1] == boardIpSegments[1] &&
+                           segments[2] == boardIpSegments[2];
+                });
+
+            if (sameSegmentIP != null)
+                return sameSegmentIP;
+
+            // 如果没有找到同网段的IP，返回第一个可用的IP
+            return System.Net.NetworkInformation.NetworkInterface
+                .GetAllNetworkInterfaces()
+                .Where(nic => nic.OperationalStatus == System.Net.NetworkInformation.OperationalStatus.Up
+                              && nic.NetworkInterfaceType != System.Net.NetworkInformation.NetworkInterfaceType.Loopback)
+                .SelectMany(nic => nic.GetIPProperties().UnicastAddresses)
+                .Where(addr => addr.Address.AddressFamily == System.Net.Sockets.AddressFamily.InterNetwork)
+                .Select(addr => addr.Address)
+                .FirstOrDefault() ?? IPAddress.Loopback;
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取本机IP地址失败");
+            return IPAddress.Loopback;
+        }
+    }
+
+    /// <summary>
+    /// 用户登录，获取 JWT 令牌
+    /// </summary>
+    /// <param name="name">用户名</param>
+    /// <param name="password">用户密码</param>
+    /// <returns>JWT 令牌字符串</returns>
+    [HttpPost("Login")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(string), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public IActionResult Login(string name, string password)
+    {
+        // 验证用户密码
+        using var db = new Database.AppDataConnection();
+        var ret = db.CheckUserPassword(name, password);
+        if (!ret.IsSuccessful) return StatusCode(StatusCodes.Status500InternalServerError, "数据库操作失败");
+        if (!ret.Value.HasValue) return BadRequest("用户名或密码错误");
+        var user = ret.Value.Value;
+
+        // 生成 JWT
+        var tokenHandler = new JwtSecurityTokenHandler();
+        var key = Encoding.ASCII.GetBytes("my secret key 1234567890my secret key 1234567890");
+        var tokenDescriptor = new SecurityTokenDescriptor
+        {
+            Subject = new ClaimsIdentity(new Claim[]
+            {
+                new Claim(ClaimTypes.Name, user.Name),
+                new Claim(ClaimTypes.Email, user.EMail),
+                new Claim(ClaimTypes.Role, user.Permission.ToString())
+            }),
+            Expires = DateTime.UtcNow.AddHours(1),
+            SigningCredentials = new SigningCredentials(
+                new SymmetricSecurityKey(key), SecurityAlgorithms.HmacSha256Signature),
+            Audience = "dlut.edu.cn",
+            Issuer = "dlut.edu.cn",
+        };
+        var token = tokenHandler.CreateToken(tokenDescriptor);
+        var jwt = tokenHandler.WriteToken(token);
+
+        return Ok(jwt);
+    }
+
+    /// <summary>
+    /// 测试用户认证，需携带有效 JWT
+    /// </summary>
+    /// <returns>认证成功信息</returns>
+    [Authorize]
+    [HttpGet("TestAuth")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(string), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public IActionResult TestAuth()
+    {
+        return Ok("认证成功！");
+    }
+
+    /// <summary>
+    /// 测试管理员用户认证，需携带有效 JWT
+    /// </summary>
+    /// <returns>认证成功信息</returns>
+    [Authorize("Admin")]
+    [HttpGet("TestAdminAuth")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(string), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public IActionResult TestAdminAuth()
+    {
+        return Ok("认证成功！");
+    }
+
+    /// <summary>
+    /// 获取当前用户信息
+    /// </summary>
+    /// <returns>用户信息，包括ID、用户名、邮箱和板卡ID</returns>
+    [Authorize]
+    [HttpGet("GetUserInfo")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(UserInfo), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public IActionResult GetUserInfo()
+    {
+        // Get User Name
+        var userName = User.Identity?.Name;
+        if (string.IsNullOrEmpty(userName))
+            return Unauthorized("未找到用户名信息");
+
+        // Get User Info
+        using var db = new Database.AppDataConnection();
+        var ret = db.GetUserByName(userName);
+        if (!ret.IsSuccessful)
+            return StatusCode(StatusCodes.Status500InternalServerError, "数据库操作失败");
+
+        if (!ret.Value.HasValue)
+            return BadRequest("用户不存在");
+
+        var user = ret.Value.Value;
+        return Ok(new UserInfo
+        {
+            ID = user.ID,
+            Name = user.Name,
+            EMail = user.EMail,
+            BoardID = user.BoardID,
+            BoardExpireTime = user.BoardExpireTime,
+        });
+    }
+
+    /// <summary>
+    /// 注册新用户
+    /// </summary>
+    /// <param name="name">用户名（不超过255个字符）</param>
+    /// <param name="email">邮箱地址</param>
+    /// <param name="password">用户密码</param>
+    /// <returns>操作结果，成功返回 true，失败返回错误信息</returns>
+    [HttpPost("SignUpUser")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public IActionResult SignUpUser(string name, string email, string password)
+    {
+        // 验证输入参数
+        if (string.IsNullOrWhiteSpace(name))
+            return BadRequest("用户名不能为空");
+
+        if (name.Length > 255)
+            return BadRequest("用户名不能超过255个字符");
+
+        if (string.IsNullOrWhiteSpace(email))
+            return BadRequest("邮箱不能为空");
+
+        if (string.IsNullOrWhiteSpace(password))
+            return BadRequest("密码不能为空");
+
+        try
+        {
+            using var db = new Database.AppDataConnection();
+            var ret = db.AddUser(name, email, password);
+            return Ok(ret);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "注册用户时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "注册失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 获取一个空闲的实验板（普通用户权限）
+    /// </summary>
+    /// <param name="durationHours">绑定持续时间（小时），默认为1小时</param>
+    [Authorize]
+    [HttpGet("GetAvailableBoard")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(Database.Board), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async ValueTask<IActionResult> GetAvailableBoard(int durationHours = 1)
+    {
+        try
+        {
+            var userName = User.Identity?.Name;
+            if (string.IsNullOrEmpty(userName))
+                return Unauthorized("未找到用户名信息");
+
+            using var db = new Database.AppDataConnection();
+            var userRet = db.GetUserByName(userName);
+            if (!userRet.IsSuccessful || !userRet.Value.HasValue)
+                return BadRequest("用户不存在");
+
+            var user = userRet.Value.Value;
+            var expireTime = DateTime.UtcNow.AddHours(durationHours);
+
+            var boardOpt = db.GetAvailableBoard(user.ID, expireTime);
+            if (!boardOpt.HasValue)
+                return NotFound("没有可用的实验板");
+
+            var boardInfo = boardOpt.Value;
+            if (!(await ArpClient.CheckOrAddAsync(boardInfo.IpAddr, boardInfo.MacAddr, GetLocalIPAddress().ToString())))
+            {
+                logger.Error($"无法配置ARP，实验板可能会无法连接");
+            }
+
+            return Ok(boardInfo);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取空闲实验板时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "获取失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 解除当前用户绑定的实验板（普通用户权限）
+    /// </summary>
+    [Authorize]
+    [HttpPost("UnbindBoard")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public IActionResult UnbindBoard()
+    {
+        try
+        {
+            var userName = User.Identity?.Name;
+            if (string.IsNullOrEmpty(userName))
+                return Unauthorized("未找到用户名信息");
+
+            using var db = new Database.AppDataConnection();
+            var userRet = db.GetUserByName(userName);
+            if (!userRet.IsSuccessful || !userRet.Value.HasValue)
+                return BadRequest("用户不存在");
+
+            var user = userRet.Value.Value;
+            var result = db.UnbindUserFromBoard(user.ID);
+            return Ok(result > 0);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "解除实验板绑定时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "解除失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 用户根据实验板ID获取实验板信息（普通用户权限）
+    /// </summary>
+    [Authorize]
+    [HttpGet("GetBoardByID")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(Database.Board), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async Task<IActionResult> GetBoardByID(Guid id)
+    {
+        try
+        {
+            using var db = new Database.AppDataConnection();
+            var ret = db.GetBoardByID(id);
+            if (!ret.IsSuccessful)
+                return StatusCode(StatusCodes.Status500InternalServerError, "数据库操作失败");
+            if (!ret.Value.HasValue)
+                return NotFound("未找到对应的实验板");
+
+            var boardInfo = ret.Value.Value;
+            if (!(await ArpClient.CheckOrAddAsync(boardInfo.IpAddr, boardInfo.MacAddr, GetLocalIPAddress().ToString())))
+            {
+                logger.Error($"无法配置ARP，实验板可能会无法连接");
+            }
+
+            return Ok(boardInfo);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取实验板信息时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "获取失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 新增板子（管理员权限）
+    /// </summary>
+    [Authorize("Admin")]
+    [HttpPost("AddBoard")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(Guid), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public IActionResult AddBoard(string name)
+    {
+        if (string.IsNullOrWhiteSpace(name))
+            return BadRequest("板子名称不能为空");
+        try
+        {
+            using var db = new Database.AppDataConnection();
+            var ret = db.AddBoard(name);
+            return Ok(ret);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "新增板子时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "新增失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 删除板子（管理员权限）
+    /// </summary>
+    [Authorize("Admin")]
+    [HttpDelete("DeleteBoard")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(int), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public IActionResult DeleteBoard(Guid id)
+    {
+        if (id == Guid.Empty)
+            return BadRequest("板子Guid不能为空");
+
+        try
+        {
+            using var db = new Database.AppDataConnection();
+            var ret = db.DeleteBoardByID(id);
+            return Ok(ret);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "删除板子时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "删除失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 获取全部板子（管理员权限）
+    /// </summary>
+    [Authorize("Admin")]
+    [HttpGet("GetAllBoards")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(Database.Board[]), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public IActionResult GetAllBoards()
+    {
+        try
+        {
+            using var db = new Database.AppDataConnection();
+            var boards = db.GetAllBoard();
+            return Ok(boards);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取全部板子时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "获取失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 更新板卡名称（管理员权限）
+    /// </summary>
+    [Authorize("Admin")]
+    [HttpPost("UpdateBoardName")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(int), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public IActionResult UpdateBoardName(Guid boardId, string newName)
+    {
+        if (boardId == Guid.Empty)
+            return BadRequest("板子Guid不能为空");
+        if (string.IsNullOrWhiteSpace(newName))
+            return BadRequest("新名称不能为空");
+        try
+        {
+            using var db = new Database.AppDataConnection();
+            var result = db.UpdateBoardName(boardId, newName);
+            return Ok(result);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "更新板卡名称时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "更新失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 更新板卡状态（管理员权限）
+    /// </summary>
+    [Authorize("Admin")]
+    [HttpPost("UpdateBoardStatus")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(int), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public IActionResult UpdateBoardStatus(Guid boardId, Database.Board.BoardStatus newStatus)
+    {
+        if (boardId == Guid.Empty)
+            return BadRequest("板子Guid不能为空");
+        try
+        {
+            using var db = new Database.AppDataConnection();
+            var result = db.UpdateBoardStatus(boardId, newStatus);
+            return Ok(result);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "更新板卡状态时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "更新失败，请稍后重试");
+        }
+    }
+}

server/src/Controllers/DebuggerController.cs

@@ -0,0 +1,467 @@
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Cors;
+using Microsoft.AspNetCore.Mvc;
+using Peripherals.DebuggerClient;
+
+namespace server.Controllers;
+
+/// <summary>
+/// FPGA调试器控制器，提供信号捕获、触发、数据读取等调试相关API
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+[Authorize]
+public class DebuggerController : ControllerBase
+{
+    private static readonly NLog.Logger logger = NLog.LogManager.GetCurrentClassLogger();
+
+    /// <summary>
+    /// 表示单个信号通道的配置信息
+    /// </summary>
+    public class ChannelConfig
+    {
+        /// <summary>
+        /// 通道名称
+        /// </summary>
+        required public string name;
+        /// <summary>
+        /// 通道显示颜色（如前端波形显示用）
+        /// </summary>
+        required public string color;
+        /// <summary>
+        /// 通道信号线宽度（位数）
+        /// </summary>
+        required public UInt32 wireWidth;
+        /// <summary>
+        /// 信号线在父端口中的起始索引（bit）
+        /// </summary>
+        required public UInt32 wireStartIndex;
+        /// <summary>
+        /// 父端口编号
+        /// </summary>
+        required public UInt32 parentPort;
+        /// <summary>
+        /// 捕获模式（如上升沿、下降沿等）
+        /// </summary>
+        required public CaptureMode mode;
+    }
+
+    /// <summary>
+    /// 调试器整体配置信息
+    /// </summary>
+    public class DebuggerConfig
+    {
+        /// <summary>
+        /// 时钟频率
+        /// </summary>
+        required public UInt32 clkFreq;
+        /// <summary>
+        /// 总端口数量
+        /// </summary>
+        required public UInt32 totalPortNum;
+        /// <summary>
+        /// 捕获深度（采样点数）
+        /// </summary>
+        required public UInt32 captureDepth;
+        /// <summary>
+        /// 触发器数量
+        /// </summary>
+        required public UInt32 triggerNum;
+        /// <summary>
+        /// 所有信号通道的配置信息
+        /// </summary>
+        required public ChannelConfig[] channelConfigs;
+    }
+
+    /// <summary>
+    /// 单个通道的捕获数据
+    /// </summary>
+    public class ChannelCaptureData
+    {
+        /// <summary>
+        /// 通道名称
+        /// </summary>
+        required public string name;
+        /// <summary>
+        /// 通道捕获到的数据（Base64编码的UInt32数组）
+        /// </summary>
+        required public string data;
+    }
+
+    /// <summary>
+    /// 获取当前用户绑定的调试器实例
+    /// </summary>
+    private DebuggerClient? GetDebugger()
+    {
+        try
+        {
+            var userName = User.Identity?.Name;
+            if (string.IsNullOrEmpty(userName))
+                return null;
+
+            using var db = new Database.AppDataConnection();
+            var userRet = db.GetUserByName(userName);
+            if (!userRet.IsSuccessful || !userRet.Value.HasValue)
+                return null;
+
+            var user = userRet.Value.Value;
+            if (user.BoardID == Guid.Empty)
+                return null;
+
+            var boardRet = db.GetBoardByID(user.BoardID);
+            if (!boardRet.IsSuccessful || !boardRet.Value.HasValue)
+                return null;
+
+            var board = boardRet.Value.Value;
+            return new DebuggerClient(board.IpAddr, board.Port, 1);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取调试器实例时发生异常");
+            return null;
+        }
+    }
+
+    /// <summary>
+    /// 设置指定信号线的捕获模式
+    /// </summary>
+    /// <param name="wireNum">信号线编号（0~511）</param>
+    /// <param name="mode">捕获模式</param>
+    [HttpPost("SetMode")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> SetMode(UInt32 wireNum, CaptureMode mode)
+    {
+        if (wireNum > 512)
+        {
+            return BadRequest($"最多只能建立512位信号线");
+        }
+
+        try
+        {
+            var debugger = GetDebugger();
+            if (debugger == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await debugger.SetMode(wireNum, mode);
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"设置捕获模式失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置捕获模式失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "设置捕获模式时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 为每个通道中的每根线设置捕获模式
+    /// </summary>
+    /// <param name="config">调试器配置信息，包含所有通道的捕获模式设置</param>
+    [HttpPost("SetChannelsMode")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> SetChannelsMode([FromBody] DebuggerConfig config)
+    {
+        if (config == null || config.channelConfigs == null)
+            return BadRequest("配置无效");
+
+        try
+        {
+            var debugger = GetDebugger();
+            if (debugger == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            foreach (var channel in config.channelConfigs)
+            {
+                // 检查每个通道的配置
+                if (channel.wireWidth > 32 ||
+                    channel.wireStartIndex > 32 ||
+                    channel.wireStartIndex + channel.wireWidth > 32)
+                {
+                    return BadRequest($"通道 {channel.name} 配置错误");
+                }
+
+                for (uint i = 0; i < channel.wireWidth; i++)
+                {
+                    var result = await debugger.SetMode(channel.wireStartIndex * (channel.parentPort * 32) + i, channel.mode);
+                    if (!result.IsSuccessful)
+                    {
+                        logger.Error($"设置通道 {channel.name} 第 {i} 根线捕获模式失败: {result.Error}");
+                        return StatusCode(StatusCodes.Status500InternalServerError, $"设置通道 {channel.name} 第 {i} 根线捕获模式失败");
+                    }
+                }
+            }
+
+            return Ok(true);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "为每个通道中的每根线设置捕获模式时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 启动触发器，开始信号捕获
+    /// </summary>
+    [HttpPost("StartTrigger")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> StartTrigger()
+    {
+        try
+        {
+            var debugger = GetDebugger();
+            if (debugger == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await debugger.StartTrigger();
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"启动触发器失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "启动触发器失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "启动触发器时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 读取触发器状态标志
+    /// </summary>
+    [HttpGet("ReadFlag")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(byte), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> ReadFlag()
+    {
+        try
+        {
+            var debugger = GetDebugger();
+            if (debugger == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await debugger.ReadFlag();
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"读取触发器状态标志失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "读取触发器状态标志失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "读取触发器状态标志时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 清除触发器状态标志
+    /// </summary>
+    [HttpPost("ClearFlag")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> ClearFlag()
+    {
+        try
+        {
+            var debugger = GetDebugger();
+            if (debugger == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await debugger.ClearFlag();
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"清除触发器状态标志失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "清除触发器状态标志失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "清除触发器状态标志时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 读取捕获数据（等待触发完成后返回各通道采样数据）
+    /// </summary>
+    /// <param name="config">调试器配置信息，包含采样深度、端口数、通道配置等</param>
+    /// <param name="cancellationToken">取消操作的令牌</param>
+    [HttpPost("ReadData")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(ChannelCaptureData[]), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> ReadData([FromBody] DebuggerConfig config, CancellationToken cancellationToken)
+    {
+        // 检查每个通道的配置
+        foreach (var channel in config.channelConfigs)
+        {
+            if (channel.wireWidth > 32 ||
+                channel.wireStartIndex > 32 ||
+                channel.wireStartIndex + channel.wireWidth > 32)
+            {
+                return BadRequest($"通道 {channel.name} 配置错误");
+            }
+        }
+
+        try
+        {
+            var debugger = GetDebugger();
+            if (debugger == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            // 等待捕获标志位
+            while (true)
+            {
+                cancellationToken.ThrowIfCancellationRequested();
+                var flagResult = await debugger.ReadFlag();
+                if (!flagResult.IsSuccessful)
+                {
+                    logger.Error($"读取捕获标志失败: {flagResult.Error}");
+                    return StatusCode(StatusCodes.Status500InternalServerError, "读取捕获标志失败");
+                }
+                if (flagResult.Value == 1)
+                {
+                    var clearResult = await debugger.ClearFlag();
+                    if (!clearResult.IsSuccessful)
+                    {
+                        logger.Error($"清除捕获标志失败: {clearResult.Error}");
+                        return StatusCode(StatusCodes.Status500InternalServerError, "清除捕获标志失败");
+                    }
+                    break;
+                }
+                await Task.Delay(500, cancellationToken);
+            }
+
+            var dataResult = await debugger.ReadData(config.totalPortNum);
+            if (!dataResult.IsSuccessful)
+            {
+                logger.Error($"读取捕获数据失败: {dataResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "读取捕获数据失败");
+            }
+
+            var freshResult = await debugger.Refresh();
+            if (!freshResult.IsSuccessful)
+            {
+                logger.Error($"刷新调试器状态失败: {freshResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "刷新调试器状态失败");
+            }
+
+            var rawData = dataResult.Value;
+            // logger.Debug($"rawData: {BitConverter.ToString(rawData)}");
+            int depth = (int)config.captureDepth;
+            int portDataLen = 4 * depth;
+            int portNum = (int)config.totalPortNum;
+            var channelDataList = new List<ChannelCaptureData>();
+
+            foreach (var channel in config.channelConfigs)
+            {
+                int port = (int)channel.parentPort;
+                int wireStart = (int)channel.wireStartIndex;
+                int wireWidth = (int)channel.wireWidth;
+
+                // 每个port的数据长度
+                int portOffset = port * portDataLen;
+
+                var channelUintArr = new UInt32[depth];
+                for (int i = 0; i < depth; i++)
+                {
+                    // 取出该port的第i个采样点的4字节
+                    int sampleOffset = portOffset + i * 4;
+                    if (sampleOffset + 4 > rawData.Length)
+                    {
+                        logger.Error($"数据越界: port {port}, sample {i}");
+                        return StatusCode(StatusCodes.Status500InternalServerError, "数据越界");
+                    }
+                    var sampleBytes = rawData[sampleOffset..(sampleOffset + 4)];
+                    UInt32 sample = Common.Number.BytesToUInt32(sampleBytes, true).Value;
+                    // 提取wireWidth位
+                    UInt32 mask = (wireWidth == 32) ? 0xFFFFFFFF : ((1u << wireWidth) - 1u);
+                    channelUintArr[i] = (sample >> wireStart) & mask;
+                }
+                var channelBytes = new byte[4 * depth];
+                Buffer.BlockCopy(channelUintArr, 0, channelBytes, 0, channelBytes.Length);
+                // logger.Debug($"{channel.name} HexData: {BitConverter.ToString(channelBytes)}");
+                var base64 = Convert.ToBase64String(channelBytes);
+                channelDataList.Add(new ChannelCaptureData { name = channel.name, data = base64 });
+            }
+
+            return Ok(channelDataList.ToArray());
+        }
+        catch (OperationCanceledException)
+        {
+            logger.Info("读取捕获数据请求被取消");
+            return StatusCode(StatusCodes.Status499ClientClosedRequest, "客户端已取消请求");
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "读取捕获数据时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 刷新调试器状态（重置采集状态等）
+    /// </summary>
+    [HttpPost("Refresh")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> Refresh()
+    {
+        try
+        {
+            var debugger = GetDebugger();
+            if (debugger == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await debugger.Refresh();
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"刷新调试器状态失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "刷新调试器状态失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "刷新调试器状态时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+}

server/src/Controllers/ExamController.cs

@@ -0,0 +1,291 @@
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Cors;
+using Microsoft.AspNetCore.Mvc;
+using DotNext;
+
+namespace server.Controllers;
+
+/// <summary>
+/// 实验控制器
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+public class ExamController : ControllerBase
+{
+    private static NLog.Logger logger = NLog.LogManager.GetCurrentClassLogger();
+
+    /// <summary>
+    /// 实验信息类
+    /// </summary>
+    public class ExamInfo
+    {
+        /// <summary>
+        /// 实验的唯一标识符
+        /// </summary>
+        public required string ID { get; set; }
+
+        /// <summary>
+        /// 实验名称
+        /// </summary>
+        public required string Name { get; set; }
+
+        /// <summary>
+        /// 实验描述
+        /// </summary>
+        public required string Description { get; set; }
+
+        /// <summary>
+        /// 实验创建时间
+        /// </summary>
+        public DateTime CreatedTime { get; set; }
+
+        /// <summary>
+        /// 实验最后更新时间
+        /// </summary>
+        public DateTime UpdatedTime { get; set; }
+
+        /// <summary>
+        /// 实验标签
+        /// </summary>
+        public string[] Tags { get; set; } = Array.Empty<string>();
+
+        /// <summary>
+        /// 实验难度（1-5）
+        /// </summary>
+        public int Difficulty { get; set; } = 1;
+
+        /// <summary>
+        /// 普通用户是否可见
+        /// </summary>
+        public bool IsVisibleToUsers { get; set; } = true;
+    }
+
+    /// <summary>
+    /// 实验简要信息类（用于列表显示）
+    /// </summary>
+    public class ExamSummary
+    {
+        /// <summary>
+        /// 实验的唯一标识符
+        /// </summary>
+        public required string ID { get; set; }
+
+        /// <summary>
+        /// 实验名称
+        /// </summary>
+        public required string Name { get; set; }
+
+        /// <summary>
+        /// 实验创建时间
+        /// </summary>
+        public DateTime CreatedTime { get; set; }
+
+        /// <summary>
+        /// 实验最后更新时间
+        /// </summary>
+        public DateTime UpdatedTime { get; set; }
+
+        /// <summary>
+        /// 实验标签
+        /// </summary>
+        public string[] Tags { get; set; } = Array.Empty<string>();
+
+        /// <summary>
+        /// 实验难度（1-5）
+        /// </summary>
+        public int Difficulty { get; set; } = 1;
+
+        /// <summary>
+        /// 普通用户是否可见
+        /// </summary>
+        public bool IsVisibleToUsers { get; set; } = true;
+    }
+
+    /// <summary>
+    /// 创建实验请求类
+    /// </summary>
+    public class CreateExamRequest
+    {
+        /// <summary>
+        /// 实验ID
+        /// </summary>
+        public required string ID { get; set; }
+
+        /// <summary>
+        /// 实验名称
+        /// </summary>
+        public required string Name { get; set; }
+
+        /// <summary>
+        /// 实验描述
+        /// </summary>
+        public required string Description { get; set; }
+
+        /// <summary>
+        /// 实验标签
+        /// </summary>
+        public string[] Tags { get; set; } = Array.Empty<string>();
+
+        /// <summary>
+        /// 实验难度（1-5）
+        /// </summary>
+        public int Difficulty { get; set; } = 1;
+
+        /// <summary>
+        /// 普通用户是否可见
+        /// </summary>
+        public bool IsVisibleToUsers { get; set; } = true;
+    }
+
+    /// <summary>
+    /// 获取所有实验列表
+    /// </summary>
+    /// <returns>实验列表</returns>
+    [Authorize]
+    [HttpGet("list")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(ExamSummary[]), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public IActionResult GetExamList()
+    {
+        try
+        {
+            using var db = new Database.AppDataConnection();
+            var exams = db.GetAllExams();
+
+            var examSummaries = exams.Select(exam => new ExamSummary
+            {
+                ID = exam.ID,
+                Name = exam.Name,
+                CreatedTime = exam.CreatedTime,
+                UpdatedTime = exam.UpdatedTime,
+                Tags = exam.GetTagsList(),
+                Difficulty = exam.Difficulty,
+                IsVisibleToUsers = exam.IsVisibleToUsers
+            }).ToArray();
+
+            logger.Info($"成功获取实验列表，共 {examSummaries.Length} 个实验");
+            return Ok(examSummaries);
+        }
+        catch (Exception ex)
+        {
+            logger.Error($"获取实验列表时出错: {ex.Message}");
+            return StatusCode(StatusCodes.Status500InternalServerError, $"获取实验列表失败: {ex.Message}");
+        }
+    }
+
+    /// <summary>
+    /// 根据实验ID获取实验详细信息
+    /// </summary>
+    /// <param name="examId">实验ID</param>
+    /// <returns>实验详细信息</returns>
+    [Authorize]
+    [HttpGet("{examId}")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(ExamInfo), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public IActionResult GetExam(string examId)
+    {
+        if (string.IsNullOrWhiteSpace(examId))
+            return BadRequest("实验ID不能为空");
+
+        try
+        {
+            using var db = new Database.AppDataConnection();
+            var result = db.GetExamByID(examId);
+
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"获取实验时出错: {result.Error.Message}");
+                return StatusCode(StatusCodes.Status500InternalServerError, $"获取实验失败: {result.Error.Message}");
+            }
+
+            if (!result.Value.HasValue)
+            {
+                logger.Warn($"实验不存在: {examId}");
+                return NotFound($"实验 {examId} 不存在");
+            }
+
+            var exam = result.Value.Value;
+            var examInfo = new ExamInfo
+            {
+                ID = exam.ID,
+                Name = exam.Name,
+                Description = exam.Description,
+                CreatedTime = exam.CreatedTime,
+                UpdatedTime = exam.UpdatedTime,
+                Tags = exam.GetTagsList(),
+                Difficulty = exam.Difficulty,
+                IsVisibleToUsers = exam.IsVisibleToUsers
+            };
+
+            logger.Info($"成功获取实验信息: {examId}");
+            return Ok(examInfo);
+        }
+        catch (Exception ex)
+        {
+            logger.Error($"获取实验 {examId} 时出错: {ex.Message}");
+            return StatusCode(StatusCodes.Status500InternalServerError, $"获取实验失败: {ex.Message}");
+        }
+    }
+
+    /// <summary>
+    /// 创建新实验
+    /// </summary>
+    /// <param name="request">创建实验请求</param>
+    /// <returns>创建结果</returns>
+    [Authorize("Admin")]
+    [HttpPost]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(ExamInfo), StatusCodes.Status201Created)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    [ProducesResponseType(StatusCodes.Status403Forbidden)]
+    [ProducesResponseType(StatusCodes.Status409Conflict)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public IActionResult CreateExam([FromBody] CreateExamRequest request)
+    {
+        if (string.IsNullOrWhiteSpace(request.ID) || string.IsNullOrWhiteSpace(request.Name) || string.IsNullOrWhiteSpace(request.Description))
+            return BadRequest("实验ID、名称和描述不能为空");
+
+        try
+        {
+            using var db = new Database.AppDataConnection();
+            var result = db.CreateExam(request.ID, request.Name, request.Description, request.Tags, request.Difficulty, request.IsVisibleToUsers);
+
+            if (!result.IsSuccessful)
+            {
+                if (result.Error.Message.Contains("已存在"))
+                    return Conflict(result.Error.Message);
+                
+                logger.Error($"创建实验时出错: {result.Error.Message}");
+                return StatusCode(StatusCodes.Status500InternalServerError, $"创建实验失败: {result.Error.Message}");
+            }
+
+            var exam = result.Value;
+            var examInfo = new ExamInfo
+            {
+                ID = exam.ID,
+                Name = exam.Name,
+                Description = exam.Description,
+                CreatedTime = exam.CreatedTime,
+                UpdatedTime = exam.UpdatedTime,
+                Tags = exam.GetTagsList(),
+                Difficulty = exam.Difficulty,
+                IsVisibleToUsers = exam.IsVisibleToUsers
+            };
+
+            logger.Info($"成功创建实验: {request.ID}");
+            return CreatedAtAction(nameof(GetExam), new { examId = request.ID }, examInfo);
+        }
+        catch (Exception ex)
+        {
+            logger.Error($"创建实验 {request.ID} 时出错: {ex.Message}");
+            return StatusCode(StatusCodes.Status500InternalServerError, $"创建实验失败: {ex.Message}");
+        }
+    }
+}

server/src/Controllers/JtagController.cs

@@ -0,0 +1,354 @@
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Cors;
+using Microsoft.AspNetCore.Mvc;
+using Database;
+
+namespace server.Controllers;
+
+/// <summary>
+/// JTAG 控制器 - 提供 JTAG 相关的 API 操作
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+[Authorize] // 添加用户认证要求
+public class JtagController : ControllerBase
+{
+    private static NLog.Logger logger = NLog.LogManager.GetCurrentClassLogger();
+
+    /// <summary>
+    /// 控制器首页信息
+    /// </summary>
+    /// <returns>控制器描述信息</returns>
+    [HttpGet]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(string), StatusCodes.Status200OK)]
+    public string Index()
+    {
+        logger.Info($"User {User.Identity?.Name} accessed Jtag controller index");
+        return "This is Jtag Controller";
+    }
+
+    /// <summary>
+    /// 获取 JTAG 设备的 ID Code
+    /// </summary>
+    /// <param name="address">JTAG 设备地址</param>
+    /// <param name="port">JTAG 设备端口</param>
+    /// <returns>设备的 ID Code</returns>
+    [HttpGet("GetDeviceIDCode")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(uint), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(Exception), StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async ValueTask<IResult> GetDeviceIDCode(string address, int port)
+    {
+        logger.Info($"User {User.Identity?.Name} requesting device ID code from {address}:{port}");
+
+        try
+        {
+            var jtagCtrl = new Peripherals.JtagClient.Jtag(address, port);
+            var ret = await jtagCtrl.ReadIDCode();
+
+            if (ret.IsSuccessful)
+            {
+                logger.Info($"User {User.Identity?.Name} successfully got device {address} ID code: 0x{ret.Value:X8}");
+                return TypedResults.Ok(ret.Value);
+            }
+            else
+            {
+                logger.Error($"User {User.Identity?.Name} failed to get device {address} ID code: {ret.Error}");
+                return TypedResults.InternalServerError(ret.Error);
+            }
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, $"User {User.Identity?.Name} encountered exception while getting device {address} ID code");
+            return TypedResults.InternalServerError(ex);
+        }
+    }
+
+    /// <summary>
+    /// 读取 JTAG 设备的状态寄存器
+    /// </summary>
+    /// <param name="address">JTAG 设备地址</param>
+    /// <param name="port">JTAG 设备端口</param>
+    /// <returns>状态寄存器的原始值、二进制表示和解码值</returns>
+    [HttpGet("ReadStatusReg")]
+    [EnableCors("Users")]
+    [ProducesResponseType(StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async ValueTask<IResult> ReadStatusReg(string address, int port)
+    {
+        logger.Info($"User {User.Identity?.Name} requesting status register from {address}:{port}");
+
+        try
+        {
+            var jtagCtrl = new Peripherals.JtagClient.Jtag(address, port);
+            var ret = await jtagCtrl.ReadStatusReg();
+
+            if (ret.IsSuccessful)
+            {
+                var binaryValue = Common.String.Reverse(Convert.ToString(ret.Value, 2).PadLeft(32, '0'));
+                var decodeValue = new Peripherals.JtagClient.JtagStatusReg(ret.Value);
+                logger.Info($"User {User.Identity?.Name} successfully read device {address} Status Register: \n\t 0b{binaryValue} \n\t {decodeValue}");
+                return TypedResults.Ok(new
+                {
+                    original = ret.Value,
+                    binaryValue,
+                    decodeValue,
+                });
+            }
+            else
+            {
+                logger.Error($"User {User.Identity?.Name} failed to read device {address} status register: {ret.Error}");
+                return TypedResults.InternalServerError(ret.Error);
+            }
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, $"User {User.Identity?.Name} encountered exception while reading device {address} status register");
+            return TypedResults.InternalServerError(ex);
+        }
+    }
+
+    /// <summary>
+    /// 通过 JTAG 下载比特流文件到 FPGA 设备
+    /// </summary>
+    /// <param name="address">JTAG 设备地址</param>
+    /// <param name="port">JTAG 设备端口</param>
+    /// <param name="bitstreamId">比特流ID</param>
+    /// <returns>下载结果</returns>
+    [HttpPost("DownloadBitstream")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(string), StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(typeof(Exception), StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async ValueTask<IResult> DownloadBitstream(string address, int port, int bitstreamId)
+    {
+        logger.Info($"User {User.Identity?.Name} initiating bitstream download to device {address}:{port} using bitstream ID: {bitstreamId}");
+
+        try
+        {
+            // 获取当前用户名
+            var username = User.Identity?.Name;
+            if (string.IsNullOrEmpty(username))
+            {
+                logger.Warn("Anonymous user attempted to download bitstream");
+                return TypedResults.Unauthorized();
+            }
+
+            // 从数据库获取用户信息
+            using var db = new Database.AppDataConnection();
+            var userResult = db.GetUserByName(username);
+            if (!userResult.IsSuccessful || !userResult.Value.HasValue)
+            {
+                logger.Error($"User {username} not found in database");
+                return TypedResults.BadRequest("用户不存在");
+            }
+
+            var user = userResult.Value.Value;
+
+            // 从数据库获取比特流
+            var bitstreamResult = db.GetResourceById(bitstreamId);
+
+            if (!bitstreamResult.IsSuccessful)
+            {
+                logger.Error($"User {username} failed to get bitstream from database: {bitstreamResult.Error}");
+                return TypedResults.InternalServerError($"数据库查询失败: {bitstreamResult.Error?.Message}");
+            }
+
+            if (!bitstreamResult.Value.HasValue)
+            {
+                logger.Warn($"User {username} attempted to download non-existent bitstream ID: {bitstreamId}");
+                return TypedResults.BadRequest("比特流不存在");
+            }
+
+            var bitstream = bitstreamResult.Value.Value;
+
+            // 处理比特流数据
+            var fileBytes = bitstream.Data;
+            if (fileBytes == null || fileBytes.Length == 0)
+            {
+                logger.Warn($"User {username} found empty bitstream data for ID: {bitstreamId}");
+                return TypedResults.BadRequest("比特流数据为空，请重新上传");
+            }
+
+            logger.Info($"User {username} processing bitstream file of size: {fileBytes.Length} bytes");
+
+            // 定义缓冲区大小: 32KB
+            byte[] buffer = new byte[32 * 1024];
+            byte[] revBuffer = new byte[32 * 1024];
+            long totalBytesProcessed = 0;
+
+            // 使用内存流处理文件
+            using (var inputStream = new MemoryStream(fileBytes))
+            using (var outputStream = new MemoryStream())
+            {
+                int bytesRead;
+                while ((bytesRead = await inputStream.ReadAsync(buffer, 0, buffer.Length)) > 0)
+                {
+                    // 反转 32bits
+                    var retBuffer = Common.Number.ReverseBytes(buffer, 4);
+                    if (!retBuffer.IsSuccessful)
+                    {
+                        logger.Error($"User {username} failed to reverse bytes: {retBuffer.Error}");
+                        return TypedResults.InternalServerError(retBuffer.Error);
+                    }
+                    revBuffer = retBuffer.Value;
+
+                    for (int i = 0; i < revBuffer.Length; i++)
+                    {
+                        revBuffer[i] = Common.Number.ReverseBits(revBuffer[i]);
+                    }
+
+                    await outputStream.WriteAsync(revBuffer, 0, bytesRead);
+                    totalBytesProcessed += bytesRead;
+                }
+
+                // 获取处理后的数据
+                var processedBytes = outputStream.ToArray();
+                logger.Info($"User {username} processed {totalBytesProcessed} bytes for device {address}");
+
+                // 下载比特流
+                var jtagCtrl = new Peripherals.JtagClient.Jtag(address, port);
+                var ret = await jtagCtrl.DownloadBitstream(processedBytes);
+
+                if (ret.IsSuccessful)
+                {
+                    logger.Info($"User {username} successfully downloaded bitstream '{bitstream.ResourceName}' to device {address}");
+                    return TypedResults.Ok(ret.Value);
+                }
+                else
+                {
+                    logger.Error($"User {username} failed to download bitstream to device {address}: {ret.Error}");
+                    return TypedResults.InternalServerError(ret.Error);
+                }
+            }
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, $"User encountered exception while downloading bitstream to device {address}");
+            return TypedResults.InternalServerError(ex);
+        }
+    }
+
+    /// <summary>
+    /// 执行边界扫描，获取所有端口状态
+    /// </summary>
+    /// <param name="address">JTAG 设备地址</param>
+    /// <param name="port">JTAG 设备端口</param>
+    /// <returns>边界扫描结果</returns>
+    [HttpPost("BoundaryScanAllPorts")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(string), StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(typeof(Exception), StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async ValueTask<IResult> BoundaryScanAllPorts(string address, int port)
+    {
+        logger.Info($"User {User.Identity?.Name} initiating boundary scan for all ports on device {address}:{port}");
+
+        try
+        {
+            var jtagCtrl = new Peripherals.JtagClient.Jtag(address, port);
+            var ret = await jtagCtrl.BoundaryScan();
+
+            if (!ret.IsSuccessful)
+            {
+                logger.Error($"User {User.Identity?.Name} boundary scan failed for device {address}: {ret.Error}");
+                if (ret.Error is ArgumentException)
+                    return TypedResults.BadRequest(ret.Error);
+                else
+                    return TypedResults.InternalServerError(ret.Error);
+            }
+
+            logger.Info($"User {User.Identity?.Name} successfully completed boundary scan for device {address}");
+            return TypedResults.Ok(ret.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, $"User {User.Identity?.Name} encountered exception during boundary scan for device {address}");
+            return TypedResults.InternalServerError(ex);
+        }
+    }
+
+    /// <summary>
+    /// 执行逻辑端口边界扫描
+    /// </summary>
+    /// <param name="address">JTAG 设备地址</param>
+    /// <param name="port">JTAG 设备端口</param>
+    /// <returns>逻辑端口状态字典</returns>
+    [HttpPost("BoundaryScanLogicalPorts")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(Dictionary<string, bool>), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(Exception), StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async ValueTask<IResult> BoundaryScanLogicalPorts(string address, int port)
+    {
+        logger.Info($"User {User.Identity?.Name} initiating logical ports boundary scan on device {address}:{port}");
+
+        try
+        {
+            var jtagCtrl = new Peripherals.JtagClient.Jtag(address, port);
+            var ret = await jtagCtrl.BoundaryScanLogicalPorts();
+
+            if (!ret.IsSuccessful)
+            {
+                logger.Error($"User {User.Identity?.Name} logical ports boundary scan failed for device {address}: {ret.Error}");
+                if (ret.Error is ArgumentException)
+                    return TypedResults.BadRequest(ret.Error);
+                else
+                    return TypedResults.InternalServerError(ret.Error);
+            }
+
+            logger.Info($"User {User.Identity?.Name} successfully completed logical ports boundary scan for device {address}, found {ret.Value?.Count} ports");
+            return TypedResults.Ok(ret.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, $"User {User.Identity?.Name} encountered exception during logical ports boundary scan for device {address}");
+            return TypedResults.InternalServerError(ex);
+        }
+    }
+
+    /// <summary>
+    /// 设置 JTAG 时钟速度
+    /// </summary>
+    /// <param name="address">JTAG 设备地址</param>
+    /// <param name="port">JTAG 设备端口</param>
+    /// <param name="speed">时钟速度 (Hz)</param>
+    /// <returns>设置结果</returns>
+    [HttpPost("SetSpeed")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(Exception), StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async ValueTask<IResult> SetSpeed(string address, int port, UInt32 speed)
+    {
+        logger.Info($"User {User.Identity?.Name} setting JTAG speed to {speed} Hz for device {address}:{port}");
+
+        try
+        {
+            var jtagCtrl = new Peripherals.JtagClient.Jtag(address, port);
+            var ret = await jtagCtrl.SetSpeed(speed);
+
+            if (!ret.IsSuccessful)
+            {
+                logger.Error($"User {User.Identity?.Name} failed to set speed for device {address}: {ret.Error}");
+                if (ret.Error is ArgumentException)
+                    return TypedResults.BadRequest(ret.Error);
+                else
+                    return TypedResults.InternalServerError(ret.Error);
+            }
+
+            logger.Info($"User {User.Identity?.Name} successfully set JTAG speed to {speed} Hz for device {address}");
+            return TypedResults.Ok(ret.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, $"User {User.Identity?.Name} encountered exception while setting speed for device {address}");
+            return TypedResults.InternalServerError(ex);
+        }
+    }
+}

server/src/Controllers/LogicAnalyzerController.cs

@@ -0,0 +1,419 @@
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Cors;
+using Microsoft.AspNetCore.Mvc;
+using Peripherals.LogicAnalyzerClient;
+
+namespace server.Controllers;
+
+/// <summary>
+/// 逻辑分析仪控制器
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+[Authorize]
+public class LogicAnalyzerController : ControllerBase
+{
+    private static readonly NLog.Logger logger = NLog.LogManager.GetCurrentClassLogger();
+
+    /// <summary>
+    /// 信号触发配置
+    /// </summary>
+    public class SignalTriggerConfig
+    {
+        /// <summary>
+        /// 信号索引 (0-7)
+        /// </summary>
+        public int SignalIndex { get; set; }
+
+        /// <summary>
+        /// 操作符
+        /// </summary>
+        public SignalOperator Operator { get; set; }
+
+        /// <summary>
+        /// 信号值
+        /// </summary>
+        public SignalValue Value { get; set; }
+    }
+
+    /// <summary>
+    /// 捕获配置
+    /// </summary>
+    public class CaptureConfig
+    {
+        /// <summary>
+        /// 全局触发模式
+        /// </summary>
+        public GlobalCaptureMode GlobalMode { get; set; }
+        /// <summary>
+        /// 捕获深度
+        /// </summary>
+        public int CaptureLength { get; set; } = 2048 * 32;
+        /// <summary>
+        /// 预采样深度
+        /// </summary>
+        public int PreCaptureLength { get; set; } = 2048;
+        /// <summary>
+        /// 有效通道
+        /// </summary>
+        public AnalyzerChannelDiv ChannelDiv { get; set; } = AnalyzerChannelDiv.EIGHT;
+        /// <summary>
+        /// 信号触发配置列表
+        /// </summary>
+        public SignalTriggerConfig[] SignalConfigs { get; set; } = Array.Empty<SignalTriggerConfig>();
+    }
+
+    /// <summary>
+    /// 获取逻辑分析仪实例
+    /// </summary>
+    private Analyzer? GetAnalyzer()
+    {
+        try
+        {
+            var userName = User.Identity?.Name;
+            if (string.IsNullOrEmpty(userName))
+                return null;
+
+            using var db = new Database.AppDataConnection();
+            var userRet = db.GetUserByName(userName);
+            if (!userRet.IsSuccessful || !userRet.Value.HasValue)
+                return null;
+
+            var user = userRet.Value.Value;
+            if (user.BoardID == Guid.Empty)
+                return null;
+
+            var boardRet = db.GetBoardByID(user.BoardID);
+            if (!boardRet.IsSuccessful || !boardRet.Value.HasValue)
+                return null;
+
+            var board = boardRet.Value.Value;
+            return new Analyzer(board.IpAddr, board.Port, 0);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取逻辑分析仪实例时发生异常");
+            return null;
+        }
+    }
+
+    /// <summary>
+    /// 设置捕获模式
+    /// </summary>
+    /// <param name="captureOn">是否开始捕获</param>
+    /// <param name="force">是否强制捕获</param>
+    /// <returns>操作结果</returns>
+    [HttpPost("SetCaptureMode")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> SetCaptureMode(bool captureOn, bool force = false)
+    {
+        try
+        {
+            var analyzer = GetAnalyzer();
+            if (analyzer == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await analyzer.SetCaptureMode(captureOn, force);
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"设置捕获模式失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置捕获模式失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "设置捕获模式时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 读取捕获状态
+    /// </summary>
+    /// <returns>捕获状态</returns>
+    [HttpGet("GetCaptureStatus")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(CaptureStatus), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> GetCaptureStatus()
+    {
+        try
+        {
+            var analyzer = GetAnalyzer();
+            if (analyzer == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await analyzer.ReadCaptureStatus();
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"读取捕获状态失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "读取捕获状态失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "读取捕获状态时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 设置全局触发模式
+    /// </summary>
+    /// <param name="mode">全局触发模式</param>
+    /// <returns>操作结果</returns>
+    [HttpPost("SetGlobalTrigMode")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> SetGlobalTrigMode(GlobalCaptureMode mode)
+    {
+        try
+        {
+            var analyzer = GetAnalyzer();
+            if (analyzer == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await analyzer.SetGlobalTrigMode(mode);
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"设置全局触发模式失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置全局触发模式失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "设置全局触发模式时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 设置信号触发模式
+    /// </summary>
+    /// <param name="signalIndex">信号索引 (0-7)</param>
+    /// <param name="op">操作符</param>
+    /// <param name="val">信号值</param>
+    /// <returns>操作结果</returns>
+    [HttpPost("SetSignalTrigMode")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> SetSignalTrigMode(int signalIndex, SignalOperator op, SignalValue val)
+    {
+        try
+        {
+            if (signalIndex < 0 || signalIndex > 31)
+                return BadRequest("信号索引必须在0-31之间");
+
+            var analyzer = GetAnalyzer();
+            if (analyzer == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await analyzer.SetSignalTrigMode(signalIndex, op, val);
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"设置信号触发模式失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置信号触发模式失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "设置信号触发模式时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 设置深度、预采样深度、有效通道
+    /// </summary>
+    /// <param name="capture_length">深度</param>
+    /// <param name="pre_capture_length">预采样深度</param>
+    /// <param name="channel_div">有效通道(0-[1],1-[2],2-[4],3-[8],4-[16],5-[32])</param>
+    /// <returns>操作结果</returns>
+    [HttpPost("SetCaptureParams")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> SetCaptureParams(int capture_length, int pre_capture_length, AnalyzerChannelDiv channel_div)
+    {
+        try
+        {
+            if (capture_length < 0 || capture_length > 2048*32)
+                return BadRequest("采样深度设置错误");
+            if (pre_capture_length < 0 || pre_capture_length >= capture_length)
+                return BadRequest("预采样深度必须小于捕获深度");
+
+            var analyzer = GetAnalyzer();
+            if (analyzer == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await analyzer.SetCaptureParams(capture_length, pre_capture_length, channel_div);
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"设置深度、预采样深度、有效通道失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置深度、预采样深度、有效通道失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "设置深度、预采样深度、有效通道失败时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 批量配置捕获参数
+    /// </summary>
+    /// <param name="config">捕获配置</param>
+    /// <returns>操作结果</returns>
+    [HttpPost("ConfigureCapture")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> ConfigureCapture([FromBody] CaptureConfig config)
+    {
+        try
+        {
+            if (config == null)
+                return BadRequest("配置参数不能为空");
+
+            var analyzer = GetAnalyzer();
+            if (analyzer == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            // 设置全局触发模式
+            var globalResult = await analyzer.SetGlobalTrigMode(config.GlobalMode);
+            if (!globalResult.IsSuccessful)
+            {
+                logger.Error($"设置全局触发模式失败: {globalResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置全局触发模式失败");
+            }
+
+            // 设置信号触发模式
+            foreach (var signalConfig in config.SignalConfigs)
+            {
+                if (signalConfig.SignalIndex < 0 || signalConfig.SignalIndex > 31)
+                    return BadRequest($"信号索引{signalConfig.SignalIndex}超出范围0-31");
+
+                var signalResult = await analyzer.SetSignalTrigMode(
+                    signalConfig.SignalIndex, signalConfig.Operator, signalConfig.Value);
+                if (!signalResult.IsSuccessful)
+                {
+                    logger.Error($"设置信号{signalConfig.SignalIndex}触发模式失败: {signalResult.Error}");
+                    return StatusCode(StatusCodes.Status500InternalServerError,
+                        $"设置信号{signalConfig.SignalIndex}触发模式失败");
+                }
+            }
+            // 设置深度、预采样深度、有效通道
+            var paramsResult = await analyzer.SetCaptureParams(
+                config.CaptureLength, config.PreCaptureLength, config.ChannelDiv);
+            if (!paramsResult.IsSuccessful)
+            {
+                logger.Error($"设置深度、预采样深度、有效通道失败: {paramsResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置深度、预采样深度、有效通道失败");
+            }
+
+            return Ok(true);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "配置捕获参数时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 强制捕获
+    /// </summary>
+    /// <returns>操作结果</returns>
+    [HttpPost("ForceCapture")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> ForceCapture()
+    {
+        try
+        {
+            var analyzer = GetAnalyzer();
+            if (analyzer == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await analyzer.SetCaptureMode(true, true);
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"强制捕获失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "强制捕获失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "强制捕获时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 读取捕获数据
+    /// </summary>
+    /// <returns>捕获的波形数据（Base64编码）</returns>
+    [HttpGet("GetCaptureData")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(string), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> GetCaptureData(int capture_length = 2048 * 32)
+    {
+        try
+        {
+            var analyzer = GetAnalyzer();
+            if (analyzer == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await analyzer.ReadCaptureData(capture_length);
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"读取捕获数据失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "读取捕获数据失败");
+            }
+
+            // 将二进制数据编码为Base64字符串返回
+            var base64Data = Convert.ToBase64String(result.Value);
+            return Ok(base64Data);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "读取捕获数据时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+}

server/src/Controllers/MatrixKeyController.cs

@@ -0,0 +1,101 @@
+using System.Collections;
+using Microsoft.AspNetCore.Cors;
+using Microsoft.AspNetCore.Mvc;
+
+namespace server.Controllers;
+
+/// <summary>
+/// 矩阵键控制器，用于管理矩阵键的启用、禁用和状态设置
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+public class MatrixKeyController : ControllerBase
+{
+    private static NLog.Logger logger = NLog.LogManager.GetCurrentClassLogger();
+
+    /// <summary>
+    /// 启用矩阵键控制。
+    /// </summary>
+    /// <param name="address">设备的IP地址</param>
+    /// <param name="port">设备的端口号</param>
+    /// <returns>返回操作结果的状态码</returns>
+    [HttpPost("EnabelMatrixKey")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(Exception), StatusCodes.Status500InternalServerError)]
+    public async ValueTask<IResult> EnabelMatrixKey(string address, int port)
+    {
+        var matrixKeyCtrl = new Peripherals.MatrixKeyClient.MatrixKey(address, port);
+        var ret = await matrixKeyCtrl.EnableControl();
+
+        if (ret.IsSuccessful)
+        {
+            logger.Info($"Enable device {address}:{port.ToString()} matrix key finished: {ret.Value}.");
+            return TypedResults.Ok(ret.Value);
+        }
+        else
+        {
+            logger.Error(ret.Error);
+            return TypedResults.InternalServerError(ret.Error);
+        }
+    }
+
+    /// <summary>
+    /// 禁用矩阵键控制。
+    /// </summary>
+    /// <param name="address">设备的IP地址</param>
+    /// <param name="port">设备的端口号</param>
+    /// <returns>返回操作结果的状态码</returns>
+    [HttpPost("DisableMatrixKey")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(Exception), StatusCodes.Status500InternalServerError)]
+    public async ValueTask<IResult> DisableMatrixKey(string address, int port)
+    {
+        var matrixKeyCtrl = new Peripherals.MatrixKeyClient.MatrixKey(address, port);
+        var ret = await matrixKeyCtrl.DisableControl();
+
+        if (ret.IsSuccessful)
+        {
+            logger.Info($"Disable device {address}:{port.ToString()} matrix key finished: {ret.Value}.");
+            return TypedResults.Ok(ret.Value);
+        }
+        else
+        {
+            logger.Error(ret.Error);
+            return TypedResults.InternalServerError(ret.Error);
+        }
+    }
+
+    /// <summary>
+    /// 设置矩阵键的状态。
+    /// </summary>
+    /// <param name="address">设备的IP地址</param>
+    /// <param name="port">设备的端口号</param>
+    /// <param name="keyStates">矩阵键的状态数组，长度应为16</param>
+    /// <returns>返回操作结果的状态码</returns>
+    [HttpPost("SetMatrixKeyStatus")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(typeof(Exception), StatusCodes.Status500InternalServerError)]
+    public async ValueTask<IResult> SetMatrixKeyStatus(string address, int port, [FromBody] bool[] keyStates)
+    {
+        if (keyStates.Length != 16)
+            return TypedResults.BadRequest($"The length of key states should be 16 instead of {keyStates.Length}");
+
+        var matrixKeyCtrl = new Peripherals.MatrixKeyClient.MatrixKey(address, port);
+        var ret = await matrixKeyCtrl.ControlKey(new BitArray(keyStates));
+
+        if (ret.IsSuccessful)
+        {
+            logger.Info($"Set device {address}:{port.ToString()} matrix key finished: {ret.Value}.");
+            return TypedResults.Ok(ret.Value);
+        }
+        else
+        {
+            logger.Error(ret.Error);
+            return TypedResults.InternalServerError(ret.Error);
+        }
+    }
+}
+

server/src/Controllers/NetConfigController.cs

@@ -0,0 +1,776 @@
+using System.Net;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Cors;
+using Microsoft.AspNetCore.Mvc;
+using Peripherals.NetConfigClient;
+
+namespace server.Controllers;
+
+/// <summary>
+/// 网络配置控制器（仅管理员权限）
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+[Authorize("Admin")]
+public class NetConfigController : ControllerBase
+{
+    private static readonly NLog.Logger logger = NLog.LogManager.GetCurrentClassLogger();
+
+    // 固定的实验板IP,端口,MAC地址
+    private const string BOARD_IP = "169.254.109.0";
+    private const int BOARD_PORT = 1234;
+
+    // 本机网络信息
+    private readonly IPAddress _localIP;
+    private readonly byte[] _localMAC;
+    private readonly string _localIPString;
+    private readonly string _localMACString;
+    private readonly string _localInterface;
+
+    public NetConfigController()
+    {
+        // 初始化本机IP地址
+        _localIP = GetLocalIPAddress();
+        _localIPString = _localIP?.ToString() ?? "未知";
+
+        // 初始化本机MAC地址
+        _localMAC = GetLocalMACAddress();
+        _localMACString = _localMAC != null ? BitConverter.ToString(_localMAC).Replace("-", ":") : "未知";
+
+        // 获取本机网络接口名称
+        _localInterface = GetLocalNetworkInterface();
+
+        logger.Info($"NetConfigController 初始化完成 - 本机IP: {_localIPString}, 本机MAC: {_localMACString}, 接口: {_localInterface}");
+    }
+
+    /// <summary>
+    /// 获取本机IP地址（优先选择与实验板同网段的IP）
+    /// </summary>
+    /// <returns>本机IP地址</returns>
+    private IPAddress GetLocalIPAddress()
+    {
+        try
+        {
+            var boardIpSegments = BOARD_IP.Split('.').Take(3).ToArray();
+
+            // 优先选择与实验板IP前三段相同的IP
+            var sameSegmentIP = System.Net.NetworkInformation.NetworkInterface
+                .GetAllNetworkInterfaces()
+                .Where(nic => nic.OperationalStatus == System.Net.NetworkInformation.OperationalStatus.Up
+                              && nic.NetworkInterfaceType != System.Net.NetworkInformation.NetworkInterfaceType.Loopback)
+                .SelectMany(nic => nic.GetIPProperties().UnicastAddresses)
+                .Where(addr => addr.Address.AddressFamily == System.Net.Sockets.AddressFamily.InterNetwork)
+                .Select(addr => addr.Address)
+                .FirstOrDefault(addr =>
+                {
+                    var segments = addr.ToString().Split('.');
+                    return segments.Length == 4 &&
+                           segments[0] == boardIpSegments[0] &&
+                           segments[1] == boardIpSegments[1] &&
+                           segments[2] == boardIpSegments[2];
+                });
+
+            if (sameSegmentIP != null)
+                return sameSegmentIP;
+
+            // 如果没有找到同网段的IP，返回第一个可用的IP
+            return System.Net.NetworkInformation.NetworkInterface
+                .GetAllNetworkInterfaces()
+                .Where(nic => nic.OperationalStatus == System.Net.NetworkInformation.OperationalStatus.Up
+                              && nic.NetworkInterfaceType != System.Net.NetworkInformation.NetworkInterfaceType.Loopback)
+                .SelectMany(nic => nic.GetIPProperties().UnicastAddresses)
+                .Where(addr => addr.Address.AddressFamily == System.Net.Sockets.AddressFamily.InterNetwork)
+                .Select(addr => addr.Address)
+                .FirstOrDefault() ?? IPAddress.Loopback;
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取本机IP地址失败");
+            return IPAddress.Loopback;
+        }
+    }
+
+    /// <summary>
+    /// 获取本机MAC地址
+    /// </summary>
+    /// <returns>本机MAC地址字节数组</returns>
+    private byte[] GetLocalMACAddress()
+    {
+        try
+        {
+            return System.Net.NetworkInformation.NetworkInterface
+                .GetAllNetworkInterfaces()
+                .Where(nic => nic.OperationalStatus == System.Net.NetworkInformation.OperationalStatus.Up
+                              && nic.NetworkInterfaceType != System.Net.NetworkInformation.NetworkInterfaceType.Loopback)
+                .Select(nic => nic.GetPhysicalAddress()?.GetAddressBytes())
+                .FirstOrDefault(bytes => bytes != null && bytes.Length == 6) ?? new byte[6];
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取本机MAC地址失败");
+            return new byte[6];
+        }
+    }
+
+    /// <summary>
+    /// 获取本机网络接口名称
+    /// </summary>
+    /// <returns>网络接口名称</returns>
+    private string GetLocalNetworkInterface()
+    {
+        return GetLocalIPAddress().ToString();
+    }
+
+    /// <summary>
+    /// 初始化ARP记录
+    /// </summary>
+    /// <returns>是否成功</returns>
+    private async Task<bool> InitializeArpAsync()
+    {
+        try
+        {
+            return await ArpClient.UpdateArpEntryAsync(BOARD_IP);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "初始化ARP记录失败");
+            return false;
+        }
+    }
+
+    /// <summary>
+    /// 获取主机IP地址
+    /// </summary>
+    /// <returns>主机IP地址</returns>
+    [HttpGet("GetHostIP")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(string), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async Task<IActionResult> GetHostIP()
+    {
+        try
+        {
+            if (!(await InitializeArpAsync()))
+            {
+                throw new Exception("无法配置ARP记录");
+            }
+
+            var netConfig = new NetConfig(BOARD_IP, BOARD_PORT, 0);
+            var result = await netConfig.GetHostIP();
+
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"获取主机IP失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, $"获取失败: {result.Error}");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取主机IP时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "获取失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 获取板卡IP地址
+    /// </summary>
+    /// <returns>板卡IP地址</returns>
+    [HttpGet("GetBoardIP")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(string), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async Task<IActionResult> GetBoardIP()
+    {
+        try
+        {
+            if (!(await InitializeArpAsync()))
+            {
+                throw new Exception("无法配置ARP记录");
+            }
+
+            var netConfig = new NetConfig(BOARD_IP, BOARD_PORT, 0);
+            var result = await netConfig.GetBoardIP();
+
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"获取板卡IP失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, $"获取失败: {result.Error}");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取板卡IP时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "获取失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 获取主机MAC地址
+    /// </summary>
+    /// <returns>主机MAC地址</returns>
+    [HttpGet("GetHostMAC")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(string), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async Task<IActionResult> GetHostMAC()
+    {
+        try
+        {
+            if (!(await InitializeArpAsync()))
+            {
+                throw new Exception("无法配置ARP记录");
+            }
+
+            var netConfig = new NetConfig(BOARD_IP, BOARD_PORT, 0);
+            var result = await netConfig.GetHostMAC();
+
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"获取主机MAC地址失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, $"获取失败: {result.Error}");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取主机MAC地址时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "获取失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 获取板卡MAC地址
+    /// </summary>
+    /// <returns>板卡MAC地址</returns>
+    [HttpGet("GetBoardMAC")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(string), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async Task<IActionResult> GetBoardMAC()
+    {
+        try
+        {
+            if (!(await InitializeArpAsync()))
+            {
+                throw new Exception("无法配置ARP记录");
+            }
+
+            var netConfig = new NetConfig(BOARD_IP, BOARD_PORT, 0);
+            var result = await netConfig.GetBoardMAC();
+
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"获取板卡MAC地址失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, $"获取失败: {result.Error}");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取板卡MAC地址时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "获取失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 获取所有网络配置信息
+    /// </summary>
+    /// <returns>网络配置信息</returns>
+    [HttpGet("GetNetworkConfig")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(NetworkConfigDto), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async Task<IActionResult> GetNetworkConfig()
+    {
+        try
+        {
+            if (!(await InitializeArpAsync()))
+            {
+                throw new Exception("无法配置ARP记录");
+            }
+
+            var netConfig = new NetConfig(BOARD_IP, BOARD_PORT, 0);
+
+            var hostIPResult = await netConfig.GetHostIP();
+            var boardIPResult = await netConfig.GetBoardIP();
+            var hostMACResult = await netConfig.GetHostMAC();
+            var boardMACResult = await netConfig.GetBoardMAC();
+
+            var config = new NetworkConfigDto
+            {
+                HostIP = hostIPResult.IsSuccessful ? hostIPResult.Value : "获取失败",
+                BoardIP = boardIPResult.IsSuccessful ? boardIPResult.Value : "获取失败",
+                HostMAC = hostMACResult.IsSuccessful ? hostMACResult.Value : "获取失败",
+                BoardMAC = boardMACResult.IsSuccessful ? boardMACResult.Value : "获取失败"
+            };
+
+            return Ok(config);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取网络配置信息时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "获取失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 获取本机所有网络接口信息
+    /// </summary>
+    /// <returns>网络接口信息列表</returns>
+    [HttpGet("GetLocalNetworkInterfaces")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(List<NetworkInterfaceDto>), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public IActionResult GetLocalNetworkInterfaces()
+    {
+        try
+        {
+            var interfaces = System.Net.NetworkInformation.NetworkInterface
+                .GetAllNetworkInterfaces()
+                .Where(nic => nic.OperationalStatus == System.Net.NetworkInformation.OperationalStatus.Up
+                              && nic.NetworkInterfaceType != System.Net.NetworkInformation.NetworkInterfaceType.Loopback)
+                .Select(nic => new NetworkInterfaceDto
+                {
+                    Name = nic.Name,
+                    Description = nic.Description,
+                    Type = nic.NetworkInterfaceType.ToString(),
+                    Status = nic.OperationalStatus.ToString(),
+                    IPAddresses = nic.GetIPProperties().UnicastAddresses
+                        .Where(addr => addr.Address.AddressFamily == System.Net.Sockets.AddressFamily.InterNetwork)
+                        .Select(addr => addr.Address.ToString())
+                        .ToList(),
+                    MACAddress = nic.GetPhysicalAddress().ToString()
+                })
+                .ToList();
+
+            return Ok(interfaces);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取本机网络接口信息时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "获取失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 设置主机IP地址
+    /// </summary>
+    /// <param name="hostIp">主机IP地址</param>
+    /// <returns>操作结果</returns>
+    [HttpPost("SetHostIP")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async Task<IActionResult> SetHostIP(string hostIp)
+    {
+        if (string.IsNullOrWhiteSpace(hostIp))
+            return BadRequest("主机IP地址不能为空");
+
+        if (!IPAddress.TryParse(hostIp, out var hostIpAddress))
+            return BadRequest("主机IP地址格式不正确");
+
+        try
+        {
+            if (!(await InitializeArpAsync()))
+            {
+                throw new Exception("无法配置ARP记录");
+            }
+
+            var netConfig = new NetConfig(BOARD_IP, BOARD_PORT, 0);
+            var result = await netConfig.SetHostIP(hostIpAddress);
+
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"设置主机IP失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, $"设置失败: {result.Error}");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "设置主机IP时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "设置失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 设置板卡IP地址
+    /// </summary>
+    /// <param name="newBoardIp">新的板卡IP地址</param>
+    /// <returns>操作结果</returns>
+    [HttpPost("SetBoardIP")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async Task<IActionResult> SetBoardIP(string newBoardIp)
+    {
+        if (string.IsNullOrWhiteSpace(newBoardIp))
+            return BadRequest("新的板卡IP地址不能为空");
+
+        if (!IPAddress.TryParse(newBoardIp, out var newIpAddress))
+            return BadRequest("新的板卡IP地址格式不正确");
+
+        try
+        {
+            if (!(await InitializeArpAsync()))
+            {
+                throw new Exception("无法配置ARP记录");
+            }
+
+            var netConfig = new NetConfig(BOARD_IP, BOARD_PORT, 0);
+            var result = await netConfig.SetBoardIP(newIpAddress);
+
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"设置板卡IP失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, $"设置失败: {result.Error}");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "设置板卡IP时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "设置失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 设置板卡MAC地址
+    /// </summary>
+    /// <param name="boardMac">板卡MAC地址（格式：AA:BB:CC:DD:EE:FF）</param>
+    /// <returns>操作结果</returns>
+    [HttpPost("SetBoardMAC")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async Task<IActionResult> SetBoardMAC(string boardMac)
+    {
+        if (string.IsNullOrWhiteSpace(boardMac))
+            return BadRequest("板卡MAC地址不能为空");
+
+        // 解析MAC地址
+        if (!TryParseMacAddress(boardMac, out var macBytes))
+            return BadRequest("MAC地址格式不正确，请使用格式：AA:BB:CC:DD:EE:FF");
+
+        try
+        {
+            if (!(await InitializeArpAsync()))
+            {
+                throw new Exception("无法配置ARP记录");
+            }
+            // 创建网络配置客户端
+            var netConfig = new NetConfig(BOARD_IP, BOARD_PORT, 0);
+            var result = await netConfig.SetBoardMAC(macBytes);
+
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"设置板卡MAC地址失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, $"设置失败: {result.Error}");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "设置板卡MAC地址时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "设置失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 设置主机MAC地址
+    /// </summary>
+    /// <param name="hostMac">主机MAC地址（格式：AA:BB:CC:DD:EE:FF）</param>
+    /// <returns>操作结果</returns>
+    [HttpPost("SetHostMAC")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async Task<IActionResult> SetHostMAC(string hostMac)
+    {
+        if (string.IsNullOrWhiteSpace(hostMac))
+            return BadRequest("主机MAC地址不能为空");
+
+        // 解析MAC地址
+        if (!TryParseMacAddress(hostMac, out var macBytes))
+            return BadRequest("MAC地址格式不正确，请使用格式：AA:BB:CC:DD:EE:FF");
+
+        try
+        {
+            if (!(await InitializeArpAsync()))
+            {
+                throw new Exception("无法配置ARP记录");
+            }
+
+            var netConfig = new NetConfig(BOARD_IP, BOARD_PORT, 0);
+            var result = await netConfig.SetHostMAC(macBytes);
+
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"设置主机MAC地址失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, $"设置失败: {result.Error}");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "设置主机MAC地址时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "设置失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 自动获取本机IP地址并设置为实验板主机IP
+    /// </summary>
+    /// <returns>操作结果</returns>
+    [HttpPost("UpdateHostIP")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async Task<IActionResult> UpdateHostIP()
+    {
+        try
+        {
+            if (_localIP == null)
+                return StatusCode(StatusCodes.Status500InternalServerError, "无法获取本机IP地址");
+
+            if (!(await InitializeArpAsync()))
+            {
+                throw new Exception("无法配置ARP记录");
+            }
+
+            var netConfig = new NetConfig(BOARD_IP, BOARD_PORT, 0);
+            var result = await netConfig.SetHostIP(_localIP);
+
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"自动设置主机IP失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, $"设置失败: {result.Error}");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "自动设置主机IP时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "设置失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 更新主机MAC地址
+    /// </summary>
+    /// <returns>操作结果</returns>
+    [HttpPost("UpdateHostMAC")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    public async Task<IActionResult> UpdateHostMAC()
+    {
+        try
+        {
+            if (_localMAC == null || _localMAC.Length != 6)
+                return StatusCode(StatusCodes.Status500InternalServerError, "无法获取本机MAC地址");
+
+            if (!(await InitializeArpAsync()))
+            {
+                throw new Exception("无法配置ARP记录");
+            }
+
+            var netConfig = new NetConfig(BOARD_IP, BOARD_PORT, 0);
+            var result = await netConfig.SetHostMAC(_localMAC);
+
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"设置主机MAC地址失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, $"设置失败: {result.Error}");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "设置主机MAC地址时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "设置失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 获取本机网络信息
+    /// </summary>
+    /// <returns>本机网络信息</returns>
+    [HttpGet("GetLocalNetworkInfo")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(object), StatusCodes.Status200OK)]
+    public IActionResult GetLocalNetworkInfo()
+    {
+        return Ok(new
+        {
+            LocalIP = _localIPString,
+            LocalMAC = _localMACString,
+            LocalInterface = _localInterface
+        });
+    }
+
+    /// <summary>
+    /// 解析MAC地址字符串为字节数组
+    /// </summary>
+    /// <param name="macAddress">MAC地址字符串</param>
+    /// <param name="macBytes">解析后的字节数组</param>
+    /// <returns>是否解析成功</returns>
+    private static bool TryParseMacAddress(string macAddress, out byte[] macBytes)
+    {
+        macBytes = Array.Empty<byte>();
+
+        if (string.IsNullOrWhiteSpace(macAddress))
+            return false;
+
+        // 移除可能的分隔符并统一为冒号
+        var cleanMac = macAddress.Replace("-", ":").Replace(" ", "").ToUpper();
+
+        // 验证格式
+        if (cleanMac.Length != 17 || cleanMac.Count(c => c == ':') != 5)
+            return false;
+
+        var parts = cleanMac.Split(':');
+        if (parts.Length != 6)
+            return false;
+
+        try
+        {
+            macBytes = new byte[6];
+            for (int i = 0; i < 6; i++)
+            {
+                macBytes[i] = Convert.ToByte(parts[i], 16);
+            }
+            return true;
+        }
+        catch
+        {
+            macBytes = Array.Empty<byte>();
+            return false;
+        }
+    }
+}
+
+/// <summary>
+/// 网络配置数据传输对象
+/// </summary>
+public class NetworkConfigDto
+{
+    /// <summary>
+    /// 主机IP地址
+    /// </summary>
+    public string? HostIP { get; set; }
+
+    /// <summary>
+    /// 板卡IP地址
+    /// </summary>
+    public string? BoardIP { get; set; }
+
+    /// <summary>
+    /// 主机MAC地址
+    /// </summary>
+    public string? HostMAC { get; set; }
+
+    /// <summary>
+    /// 板卡MAC地址
+    /// </summary>
+    public string? BoardMAC { get; set; }
+}
+
+/// <summary>
+/// 网络配置操作结果
+/// </summary>
+public class NetworkConfigResult
+{
+    /// <summary>
+    /// 主机IP设置结果
+    /// </summary>
+    public bool? HostIPResult { get; set; }
+
+    /// <summary>
+    /// 主机IP设置错误信息
+    /// </summary>
+    public string? HostIPError { get; set; }
+
+    /// <summary>
+    /// 板卡IP设置结果
+    /// </summary>
+    public bool? BoardIPResult { get; set; }
+
+    /// <summary>
+    /// 板卡IP设置错误信息
+    /// </summary>
+    public string? BoardIPError { get; set; }
+
+    /// <summary>
+    /// 主机MAC设置结果
+    /// </summary>
+    public bool? HostMACResult { get; set; }
+
+    /// <summary>
+    /// 主机MAC设置错误信息
+    /// </summary>
+    public string? HostMACError { get; set; }
+
+    /// <summary>
+    /// 板卡MAC设置结果
+    /// </summary>
+    public bool? BoardMACResult { get; set; }
+
+    /// <summary>
+    /// 板卡MAC设置错误信息
+    /// </summary>
+    public string? BoardMACError { get; set; }
+}
+
+/// <summary>
+/// 网络接口信息数据传输对象
+/// </summary>
+public class NetworkInterfaceDto
+{
+    /// <summary>
+    /// 网络接口名称
+    /// </summary>
+    public string Name { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 网络接口描述
+    /// </summary>
+    public string Description { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 网络接口类型
+    /// </summary>
+    public string Type { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 网络接口状态
+    /// </summary>
+    public string Status { get; set; } = string.Empty;
+
+    /// <summary>
+    /// IP地址列表
+    /// </summary>
+    public List<string> IPAddresses { get; set; } = new();
+
+    /// <summary>
+    /// MAC地址
+    /// </summary>
+    public string MACAddress { get; set; } = string.Empty;
+}

server/src/Controllers/OscilloscopeController.cs

@@ -0,0 +1,484 @@
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Cors;
+using Microsoft.AspNetCore.Mvc;
+using Peripherals.OscilloscopeClient;
+
+namespace server.Controllers;
+
+/// <summary>
+/// 示波器API控制器 - 普通用户权限
+/// </summary>
+[ApiController]
+[Route("api/[controller]")]
+[Authorize]
+public class OscilloscopeApiController : ControllerBase
+{
+    private static readonly NLog.Logger logger = NLog.LogManager.GetCurrentClassLogger();
+
+    /// <summary>
+    /// 示波器完整配置
+    /// </summary>
+    public class OscilloscopeFullConfig
+    {
+        /// <summary>
+        /// 是否启动捕获
+        /// </summary>
+        public bool CaptureEnabled { get; set; }
+
+        /// <summary>
+        /// 触发电平（0-255）
+        /// </summary>
+        public byte TriggerLevel { get; set; }
+
+        /// <summary>
+        /// 触发边沿（true为上升沿，false为下降沿）
+        /// </summary>
+        public bool TriggerRisingEdge { get; set; }
+
+        /// <summary>
+        /// 水平偏移量（0-1023）
+        /// </summary>
+        public ushort HorizontalShift { get; set; }
+
+        /// <summary>
+        /// 抽样率（0-1023）
+        /// </summary>
+        public ushort DecimationRate { get; set; }
+
+        /// <summary>
+        /// 是否自动刷新RAM
+        /// </summary>
+        public bool AutoRefreshRAM { get; set; } = true;
+    }
+
+    /// <summary>
+    /// 示波器状态和数据
+    /// </summary>
+    public class OscilloscopeDataResponse
+    {
+        /// <summary>
+        /// AD采样频率
+        /// </summary>
+        public uint ADFrequency { get; set; }
+
+        /// <summary>
+        /// AD采样幅度
+        /// </summary>
+        public byte ADVpp { get; set; }
+
+        /// <summary>
+        /// AD采样最大值
+        /// </summary>
+        public byte ADMax { get; set; }
+
+        /// <summary>
+        /// AD采样最小值
+        /// </summary>
+        public byte ADMin { get; set; }
+
+        /// <summary>
+        /// 波形数据（Base64编码）
+        /// </summary>
+        public string WaveformData { get; set; } = string.Empty;
+    }
+
+    /// <summary>
+    /// 获取示波器实例
+    /// </summary>
+    private Oscilloscope? GetOscilloscope()
+    {
+        try
+        {
+            var userName = User.Identity?.Name;
+            if (string.IsNullOrEmpty(userName))
+                return null;
+
+            using var db = new Database.AppDataConnection();
+            var userRet = db.GetUserByName(userName);
+            if (!userRet.IsSuccessful || !userRet.Value.HasValue)
+                return null;
+
+            var user = userRet.Value.Value;
+            if (user.BoardID == Guid.Empty)
+                return null;
+
+            var boardRet = db.GetBoardByID(user.BoardID);
+            if (!boardRet.IsSuccessful || !boardRet.Value.HasValue)
+                return null;
+
+            var board = boardRet.Value.Value;
+            return new Oscilloscope(board.IpAddr, board.Port);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取示波器实例时发生异常");
+            return null;
+        }
+    }
+
+    /// <summary>
+    /// 初始化示波器
+    /// </summary>
+    /// <param name="config">示波器配置</param>
+    /// <returns>操作结果</returns>
+    [HttpPost("Initialize")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> Initialize([FromBody] OscilloscopeFullConfig config)
+    {
+        try
+        {
+            if (config == null)
+                return BadRequest("配置参数不能为空");
+
+            if (config.HorizontalShift > 1023)
+                return BadRequest("水平偏移量必须在0-1023之间");
+
+            if (config.DecimationRate > 1023)
+                return BadRequest("抽样率必须在0-1023之间");
+
+            var oscilloscope = GetOscilloscope();
+            if (oscilloscope == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            // 首先关闭捕获
+            var stopResult = await oscilloscope.SetCaptureEnable(false);
+            if (!stopResult.IsSuccessful)
+            {
+                logger.Error($"关闭捕获失败: {stopResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "关闭捕获失败");
+            }
+
+            // 设置触发电平
+            var levelResult = await oscilloscope.SetTriggerLevel(config.TriggerLevel);
+            if (!levelResult.IsSuccessful)
+            {
+                logger.Error($"设置触发电平失败: {levelResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置触发电平失败");
+            }
+
+            // 设置触发边沿
+            var edgeResult = await oscilloscope.SetTriggerEdge(config.TriggerRisingEdge);
+            if (!edgeResult.IsSuccessful)
+            {
+                logger.Error($"设置触发边沿失败: {edgeResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置触发边沿失败");
+            }
+
+            // 设置水平偏移量
+            var shiftResult = await oscilloscope.SetHorizontalShift(config.HorizontalShift);
+            if (!shiftResult.IsSuccessful)
+            {
+                logger.Error($"设置水平偏移量失败: {shiftResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置水平偏移量失败");
+            }
+
+            // 设置抽样率
+            var rateResult = await oscilloscope.SetDecimationRate(config.DecimationRate);
+            if (!rateResult.IsSuccessful)
+            {
+                logger.Error($"设置抽样率失败: {rateResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置抽样率失败");
+            }
+
+            // 刷新RAM
+            if (config.AutoRefreshRAM)
+            {
+                var refreshResult = await oscilloscope.RefreshRAM();
+                if (!refreshResult.IsSuccessful)
+                {
+                    logger.Error($"刷新RAM失败: {refreshResult.Error}");
+                    return StatusCode(StatusCodes.Status500InternalServerError, "刷新RAM失败");
+                }
+            }
+
+            // 设置捕获开关
+            var captureResult = await oscilloscope.SetCaptureEnable(config.CaptureEnabled);
+            if (!captureResult.IsSuccessful)
+            {
+                logger.Error($"设置捕获开关失败: {captureResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置捕获开关失败");
+            }
+
+            return Ok(true);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "初始化示波器时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 启动捕获
+    /// </summary>
+    /// <returns>操作结果</returns>
+    [HttpPost("StartCapture")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> StartCapture()
+    {
+        try
+        {
+            var oscilloscope = GetOscilloscope();
+            if (oscilloscope == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await oscilloscope.SetCaptureEnable(true);
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"启动捕获失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "启动捕获失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "启动捕获时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 停止捕获
+    /// </summary>
+    /// <returns>操作结果</returns>
+    [HttpPost("StopCapture")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> StopCapture()
+    {
+        try
+        {
+            var oscilloscope = GetOscilloscope();
+            if (oscilloscope == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await oscilloscope.SetCaptureEnable(false);
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"停止捕获失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "停止捕获失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "停止捕获时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 获取示波器数据和状态
+    /// </summary>
+    /// <returns>示波器数据和状态信息</returns>
+    [HttpGet("GetData")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(OscilloscopeDataResponse), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> GetData()
+    {
+        try
+        {
+            var oscilloscope = GetOscilloscope();
+            if (oscilloscope == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var freqResult = await oscilloscope.GetADFrequency();
+            var vppResult = await oscilloscope.GetADVpp();
+            var maxResult = await oscilloscope.GetADMax();
+            var minResult = await oscilloscope.GetADMin();
+            var waveformResult = await oscilloscope.GetWaveformData();
+
+            if (!freqResult.IsSuccessful)
+            {
+                logger.Error($"获取AD采样频率失败: {freqResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "获取AD采样频率失败");
+            }
+
+            if (!vppResult.IsSuccessful)
+            {
+                logger.Error($"获取AD采样幅度失败: {vppResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "获取AD采样幅度失败");
+            }
+
+            if (!maxResult.IsSuccessful)
+            {
+                logger.Error($"获取AD采样最大值失败: {maxResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "获取AD采样最大值失败");
+            }
+
+            if (!minResult.IsSuccessful)
+            {
+                logger.Error($"获取AD采样最小值失败: {minResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "获取AD采样最小值失败");
+            }
+
+            if (!waveformResult.IsSuccessful)
+            {
+                logger.Error($"获取波形数据失败: {waveformResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "获取波形数据失败");
+            }
+
+            var response = new OscilloscopeDataResponse
+            {
+                ADFrequency = freqResult.Value,
+                ADVpp = vppResult.Value,
+                ADMax = maxResult.Value,
+                ADMin = minResult.Value,
+                WaveformData = Convert.ToBase64String(waveformResult.Value)
+            };
+
+            return Ok(response);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "获取示波器数据时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 更新触发参数
+    /// </summary>
+    /// <param name="level">触发电平（0-255）</param>
+    /// <param name="risingEdge">触发边沿（true为上升沿，false为下降沿）</param>
+    /// <returns>操作结果</returns>
+    [HttpPost("UpdateTrigger")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> UpdateTrigger(byte level, bool risingEdge)
+    {
+        try
+        {
+            var oscilloscope = GetOscilloscope();
+            if (oscilloscope == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            // 设置触发电平
+            var levelResult = await oscilloscope.SetTriggerLevel(level);
+            if (!levelResult.IsSuccessful)
+            {
+                logger.Error($"设置触发电平失败: {levelResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置触发电平失败");
+            }
+
+            // 设置触发边沿
+            var edgeResult = await oscilloscope.SetTriggerEdge(risingEdge);
+            if (!edgeResult.IsSuccessful)
+            {
+                logger.Error($"设置触发边沿失败: {edgeResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置触发边沿失败");
+            }
+
+            return Ok(true);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "更新触发参数时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 更新采样参数
+    /// </summary>
+    /// <param name="horizontalShift">水平偏移量（0-1023）</param>
+    /// <param name="decimationRate">抽样率（0-1023）</param>
+    /// <returns>操作结果</returns>
+    [HttpPost("UpdateSampling")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> UpdateSampling(ushort horizontalShift, ushort decimationRate)
+    {
+        try
+        {
+            if (horizontalShift > 1023)
+                return BadRequest("水平偏移量必须在0-1023之间");
+
+            if (decimationRate > 1023)
+                return BadRequest("抽样率必须在0-1023之间");
+
+            var oscilloscope = GetOscilloscope();
+            if (oscilloscope == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            // 设置水平偏移量
+            var shiftResult = await oscilloscope.SetHorizontalShift(horizontalShift);
+            if (!shiftResult.IsSuccessful)
+            {
+                logger.Error($"设置水平偏移量失败: {shiftResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置水平偏移量失败");
+            }
+
+            // 设置抽样率
+            var rateResult = await oscilloscope.SetDecimationRate(decimationRate);
+            if (!rateResult.IsSuccessful)
+            {
+                logger.Error($"设置抽样率失败: {rateResult.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "设置抽样率失败");
+            }
+
+            return Ok(true);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "更新采样参数时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+
+    /// <summary>
+    /// 手动刷新RAM
+    /// </summary>
+    /// <returns>操作结果</returns>
+    [HttpPost("RefreshRAM")]
+    [EnableCors("Users")]
+    [ProducesResponseType(typeof(bool), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status500InternalServerError)]
+    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
+    public async Task<IActionResult> RefreshRAM()
+    {
+        try
+        {
+            var oscilloscope = GetOscilloscope();
+            if (oscilloscope == null)
+                return BadRequest("用户未绑定有效的实验板");
+
+            var result = await oscilloscope.RefreshRAM();
+            if (!result.IsSuccessful)
+            {
+                logger.Error($"刷新RAM失败: {result.Error}");
+                return StatusCode(StatusCodes.Status500InternalServerError, "刷新RAM失败");
+            }
+
+            return Ok(result.Value);
+        }
+        catch (Exception ex)
+        {
+            logger.Error(ex, "刷新RAM时发生异常");
+            return StatusCode(StatusCodes.Status500InternalServerError, "操作失败，请稍后重试");
+        }
+    }
+}