websocket

星标14

分支5

更新时间2026年5月13日 05:37

WebSocket 使用规范. 需要在前端订阅后端事件通知时使用

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

来源

sail-sail

sail-sail/nest

打开 GitHub 仓库查看创作者相关仓库

下载

WebSocket 使用规范

架构

uni/src/compositions/websocket.ts  (移动端客户端)
  ├── subscribe(topic, callback)   - 订阅主题
  └── unSubscribe(topic, callback) - 取消订阅

src/compositions/websocket.ts (PC端客户端)
  ├── subscribe(topic, callback)   - 订阅主题
  └── unSubscribe(topic, callback) - 取消订阅

deno 后端: lib/websocket
  └── websocket_dao.publish(topic, payload) - 推送消息到前端

使用示例

前端订阅 (Vue/TS)

import {
  subscribe,
  unSubscribe,
} from "@/compositions/websocket.ts";

try {
  await subscribe("newBookingOrder", (data) => {
    // data: 后端推送的 payload
    // 处理通知/更新 UI 等
  });
} catch (err) {
  // 订阅失败时记录错误，并根据业务决定是否提示用户或重试
  console.error("subscribe newBookingOrder failed", err);
}

try {
  await unSubscribe("newBookingOrder", callback);
} catch (err) {
  // 取消订阅失败时同样要记录，避免重复订阅或页面卸载后残留监听
  console.error("unSubscribe newBookingOrder failed", err);
}

后端发布 (Deno)

import { publish } from "/lib/websocket/websocket.dao.ts";

await publish(
  "newBookingOrder",
  {
    booking_order_id: id.toString(),
  }
);

同仓库更多 Skills

同仓库

officecli

sail-sail/nest

Create, analyze, proofread, and modify Office documents (.docx, .xlsx, .pptx) using the officecli CLI tool. Use when the user wants to create, inspect, check formatting, find issues, add charts, or modify Office documents.

2026-05-2014

tm-ui-components

sail-sail/nest

tm-ui 组件 API 与源码定位。仅在需要核对某个 tm 组件的 props、events、slots、ref 方法或源码路径时使用；不要用于通用页面开发、样式规范或业务逻辑问题

2026-05-1714

uni-spec

sail-sail/nest

移动端页面开发规范。开发 UI 界面时使用

创建新业务模块时使用

数据库建表规范。创建新表 SQL 时必须遵循；SQL 建完后必须继续阅读 table-config skill 来生成 {mod}.ts 配置

2026-05-1314

dict

sail-sail/nest

系统字典和业务字典配置。SQL 中有 dict: 或 dictbiz: 标注的字段时使用

2026-05-1314

name	websocket
description	WebSocket 使用规范. 需要在前端订阅后端事件通知时使用
compatibility	Vue 3 + Deno 后端
metadata	{"version":"1.0"}

WebSocket 使用规范

架构

uni/src/compositions/websocket.ts  (移动端客户端)
  ├── subscribe(topic, callback)   - 订阅主题
  └── unSubscribe(topic, callback) - 取消订阅

src/compositions/websocket.ts (PC端客户端)
  ├── subscribe(topic, callback)   - 订阅主题
  └── unSubscribe(topic, callback) - 取消订阅

deno 后端: lib/websocket
  └── websocket_dao.publish(topic, payload) - 推送消息到前端

使用示例

前端订阅 (Vue/TS)

import {
  subscribe,
  unSubscribe,
} from "@/compositions/websocket.ts";

try {
  await subscribe("newBookingOrder", (data) => {
    // data: 后端推送的 payload
    // 处理通知/更新 UI 等
  });
} catch (err) {
  // 订阅失败时记录错误，并根据业务决定是否提示用户或重试
  console.error("subscribe newBookingOrder failed", err);
}

try {
  await unSubscribe("newBookingOrder", callback);
} catch (err) {
  // 取消订阅失败时同样要记录，避免重复订阅或页面卸载后残留监听
  console.error("unSubscribe newBookingOrder failed", err);
}

后端发布 (Deno)

import { publish } from "/lib/websocket/websocket.dao.ts";

await publish(
  "newBookingOrder",
  {
    booking_order_id: id.toString(),
  }
);