运行时依赖
无特殊依赖
安装命令
点击复制官方npx clawhub@latest install bquery
镜像加速npx clawhub@latest install bquery --registry https://cn.longxiaskill.com镜像同步中
技能文档
bQuery 技能 当任务涉及 @bquery/bquery 时调用本技能。bQuery 是模块化、TypeScript 优先、零构建的浏览器库,融合 jQuery 式 DOM 操作与信号、异步流、Web Components、动画、路由、存储、声明式视图、表单、无障碍助手、媒体观察器、插件、devtools、测试与 SSR。
当前公开基线
- watchDebounce()、watchThrottle() 为公开响应式 API
- bq-error、bq-aria 属于视图层
- useIntersectionObserver()、useResizeObserver()、useMutationObserver() 为公开媒体组合式 API
- concurrency 模块含 worker 助手、RPC 助手、池、响应式 worker 包装及 parallel()、batchTasks()、map()、filter()、reduce()、pipeline() 等高阶助手
触发条件 满足以下任一即启用:
- package.json 含 @bquery/bquery 导入
- 使用 @bquery/bquery 或其子路径(如 @bquery/bquery/core、@bquery/bquery/reactive…)
- 用户提及:bQuery、bq-* 指令、signals、Web Components、零构建浏览器应用、bQuery router/store/forms/motion/testing/SSR
- 仓库已采用 bQuery 约定
主规则
- 优先 TypeScript;仓库纯 JavaScript 除外
- 优先子路径导入,避免根包
- 选最小可用模块
- 优先浏览器原生模式,而非框架抽象
- 及时清理 effects、watchers、observers、sockets、workers、listeners
- 渲染前净化不可信 HTML
- 使用 view 模块时提示 CSP:视图求值用 new Function(),需 unsafe-eval
- 默认考虑无障碍,尊重 prefers-reduced-motion
- 未明确要求不引入 React/Vue/Svelte
导入策略 精准导入:
import { $, $$ } from '@bquery/bquery/core';
import { signal, computed, effect, watch, watchDebounce, watchThrottle } from '@bquery/bquery/reactive';
import { component, html } from '@bquery/bquery/component';
仅做演示时才用根入口。模块速查
- DOM 操作 → @bquery/bquery/core
- 状态/异步 → @bquery/bquery/reactive
- Worker/并发 → @bquery/bquery/concurrency
- Web Components → @bquery/bquery/component
- 动画 → @bquery/bquery/motion
- 安全/CSP → @bquery/bquery/security
- 路由 → @bquery/bquery/router
- 存储 → @bquery/bquery/store
- 声明式视图 → @bquery/bquery/view
- 表单 → @bquery/bquery/forms
- 无障碍 → @bquery/bquery/a11y
- 测试 → @bquery/bquery/testing
- SSR → @bquery/bquery/ssr