[pull] master from the1812:master

.agents/skills/bilibili-evolved-dev-server/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: bilibili-evolved-dev-server
+description: Bilibili-Evolved local dev server workflow. Use when working in the Bilibili-Evolved repository and needing to start the dev server, compile or watch one registry component/plugin, create a component/plugin scaffold through the dev server, reason about HTTP build-on-request versus WebSocket commands, or use DevClient during local feature development.
+---
+
+# Bilibili Evolved Dev Server
+
+## Core Model
+
+- Read `AGENTS.md` and `CONTRIBUTING.md` before making repo changes.
+- Use PowerShell syntax on Windows.
+- Use `pnpm`; do not use npm.
+- Start the local dev server with:
+
+```powershell
+pnpm tsx dev-tools/dev-server/index.ts
+```
+
+- HTTP serves static resources only, but requesting `/registry/dist/components/<id>.js` or `/registry/dist/plugins/<id>.js` may trigger build-on-request before serving the file.
+- WebSocket is the control plane for explicit commands such as build, watch, stop, create, and session query.
+- `dist/`, `registry/dist/`, and generated feature docs are not normal development changes.
+
+## Feature Commands
+
+Use these commands when the dev server is already running:
+
+```powershell
+pnpm tsx dev-tools/dev-server/command.ts sessions
+pnpm tsx dev-tools/dev-server/command.ts build component style/hide/banner
+pnpm tsx dev-tools/dev-server/command.ts build plugin video/player/speed
+pnpm tsx dev-tools/dev-server/command.ts watch component style/hide/banner
+pnpm tsx dev-tools/dev-server/command.ts stop component style/hide/banner
+```
+
+- `build` compiles one feature once without creating a watcher.
+- `watch` starts or reuses one feature watcher.
+- `stop` stops one watcher.
+- `sessions` prints active watched feature paths.
+- Prefer these commands over full registry builds when validating one component or plugin.
+
+## Creating Features
+
+Create new registry component/plugin scaffolds through the dev server command:
+
+```powershell
+$authorName = gh api user --jq ".login"
+$authorLink = gh api user --jq ".html_url"
+pnpm tsx dev-tools/dev-server/command.ts create component style/my-feature myFeature "My Feature" $authorName $authorLink "Feature description."
+pnpm tsx dev-tools/dev-server/command.ts create plugin video/player/my-plugin myPlugin "My Plugin" $authorName $authorLink "Plugin description."
+```
+
+Before creating a feature, get the current GitHub user from `gh` with `gh api user --jq ".login"` and use that as `authorName`; get the profile URL with `gh api user --jq ".html_url"` and use that as `authorLink`. If `gh` is unavailable, not authenticated, or returns a blank value, ask the user for the GitHub username/profile link before running `create`. Do not use the code agent name, local OS username, or local Git `user.name` / `user.email` for author metadata.
+
+After creation, inspect and edit the generated `index.ts` and `index.md`. Keep component/plugin names specific and camelCase, include author metadata for contributor-created features, and keep descriptions in `index.md`.
+
+## DevClient
+
+- DevClient connects to `ws://localhost:<port>`.
+- Starting debug from the settings panel rewrites the feature update URL to the local `/registry/dist/...` URL and relies on HTTP build-on-request.
+- Stopping debug, losing the dev server, or seeing a feature session disappear should restore the original update URL.
+- If debugging state looks wrong, query sessions first, then inspect DevClient `devRecords` and auto-update URLs.
+
+## Browser Checks
+
+- Bilibili Evolved depends on a userscript manager extension such as Tampermonkey. The built-in browser and Playwright do not provide that extension environment and are not reliable for runtime behavior checks.
+- If real browser validation is useful and available, try controlling the user's Chrome browser because it can use the installed userscript manager, extension permissions, login state, and real Bilibili pages.
+- Browser validation is optional for this skill. If Chrome, the userscript manager, account state, or the target page is unavailable, continue the dev server workflow and report that browser validation was not performed.
+
+## Validation
+
+- For TypeScript changes, run `pnpm run type`.
+- For lint-sensitive changes, run `pnpm run lint-check`.
+- For core userscript changes, run `pnpm run build-core`.
+- For registry feature changes, run `pnpm tsx dev-tools/dev-server/command.ts build <component|plugin> <id>` while the dev server is running; the compiled output is served from memory.

.agents/skills/bilibili-evolved-dev-server/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Bilibili Evolved Dev Server"
+  short_description: "Use the local dev server and feature commands."
+  default_prompt: "Use $bilibili-evolved-dev-server to compile or watch one Bilibili Evolved feature with the local dev server."

.browserslistrc

@@ -0,0 +1,19 @@
+> 1%
+last 2 versions
+not dead
+chrome > 105
+edge > 105
+firefox > 127
+safari > 15.4
+not and_chr > 0
+not and_ff > 0
+not and_qq > 0
+not and_uc > 0
+not android > 0
+not baidu > 0
+not ios_saf > 0
+not kaios > 0
+not op_mob > 0
+not op_mini all
+not samsung > 0
+not ie > 0

.editorconfig

@@ -0,0 +1,13 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Tab indentation
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+quote_type = single

.eslintignore

@@ -0,0 +1,7 @@
+packages/
+typings/
+**/dist/
+dev/
+node_modules/
+!.github-json/
+.eslintrc.*

.eslintrc.js

@@ -0,0 +1,111 @@
+module.exports = {
+  env: {
+    browser: true,
+    es2020: true,
+  },
+  extends: [
+    'plugin:vue/recommended',
+    'plugin:@typescript-eslint/recommended',
+    'airbnb-base',
+    'plugin:prettier/recommended',
+  ],
+  globals: {
+    Atomics: 'readonly',
+    SharedArrayBuffer: 'readonly',
+  },
+  parser: 'vue-eslint-parser',
+  parserOptions: {
+    ecmaVersion: 2020,
+    parser: '@typescript-eslint/parser',
+    sourceType: 'module',
+  },
+  plugins: ['vue', '@typescript-eslint', 'prettier'],
+  rules: {
+    'prettier/prettier': 'error',
+
+    'import/no-unresolved': 'off',
+    'import/extensions': 'off',
+    'import/no-extraneous-dependencies': 'off',
+    'import/prefer-default-export': 'off',
+    'import/no-default-export': 'error',
+    'import/no-named-default': 'off',
+
+    '@typescript-eslint/member-delimiter-style': 'off',
+    '@typescript-eslint/explicit-function-return-type': 'off',
+    '@typescript-eslint/explicit-module-boundary-types': 'off',
+    '@typescript-eslint/no-unused-vars': 'error',
+    '@typescript-eslint/no-shadow': ['error', { builtinGlobals: false }],
+    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/no-use-before-define': ['error'],
+    '@typescript-eslint/no-redeclare': 'error',
+    '@typescript-eslint/naming-convention': [
+      'error',
+      {
+        selector: 'enumMember',
+        format: ['PascalCase'],
+      },
+    ],
+
+    'vue/multi-word-component-names': 'off',
+    'vue/max-attributes-per-line': 'off',
+    'vue/html-self-closing': 'off',
+    'vue/no-v-html': 'off',
+    'vue/require-prop-types': 'off',
+    'vue/one-component-per-file': 'off',
+    'vue/singleline-html-element-content-newline': 'off',
+
+    // 使用 @typescript-eslint/no-unused-vars, 否则 interface 都是 unused
+    'no-unused-vars': 'off',
+    'no-console': 'off',
+    'no-undef': 'off',
+    'no-param-reassign': 'off',
+    'no-continue': 'off',
+    'no-plusplus': 'off',
+    'no-eval': 'off',
+    'no-useless-constructor': 'off',
+    'no-unused-expressions': 'off',
+    'no-await-in-loop': 'off',
+    'no-restricted-syntax': 'off',
+    'no-useless-escape': 'off',
+    'no-empty-function': ['error', { allow: ['constructors'] }],
+    'no-return-assign': ['error', 'except-parens'],
+    'no-redeclare': 'off',
+    'no-script-url': 'off',
+    'no-shadow': 'off',
+    'no-use-before-define': 'off',
+    'no-alert': 'off',
+    'no-restricted-globals': 'off',
+
+    'arrow-body-style': 'off',
+    'prefer-arrow-callback': 'off',
+    'object-curly-newline': 'off',
+    'linebreak-style': 'off',
+    camelcase: 'off',
+    'lines-between-class-members': 'off',
+    radix: ['error', 'as-needed'],
+    'max-classes-per-file': 'off',
+    'class-methods-use-this': 'off',
+    'prefer-destructuring': [
+      'error',
+      {
+        VariableDeclarator: {
+          array: false,
+          object: true,
+        },
+        AssignmentExpression: {
+          array: false,
+          object: false,
+        },
+      },
+    ],
+    curly: ['error', 'all'],
+  },
+  overrides: [
+    {
+      files: ['*.vue', 'shims.d.ts', 'webpack/**/*.ts', 'registry/webpack/**/*.ts'],
+      rules: {
+        'import/no-default-export': 'off',
+      },
+    },
+  ],
+}

.github/DISCUSSION_TEMPLATE/功能建议-ideas.yml

@@ -0,0 +1,24 @@
+title: 功能建议
+labels: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        默认您已阅读 [常见问题解答](https://github.com/the1812/Bilibili-Evolved/discussions/1301)
+        请勿重复发起, 发之前记得搜索一下. 如果需要反馈 Bug, 请前往 [Issues](https://github.com/the1812/Bilibili-Evolved/issues) 发起.
+  - type: textarea
+    id: description
+    attributes:
+      label: 期望的效果
+      description: 描述你遇到的问题, 以及建议的解决方式
+      placeholder: 请输入
+    validations:
+      required: true
+  - type: input
+    id: script-version
+    attributes:
+      label: 脚本版本
+      description: 可在设置面板的关于弹窗中找到脚本版本信息
+      placeholder: 请输入
+    validations:
+      required: true

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+custom:
+  - https://github.com/the1812/Bilibili-Evolved/blob/preview/doc/donate.md