CNode：Node.js专业中文社区

好用的pc电脑梯子软件推荐-5款稳定的外网梯子软件-手机梯子免费也能用

xgnsaum — Tue, 14 Apr 2026 06:08:54 GMT

如果你还在纠结pc电脑好用的梯子到底选哪款，或者想同时找到好用的pc电脑梯子软件和好用的手机梯子免费选项，那这篇指南就是为你量身打造的。YouTube、Netflix、Google、Twitter等外网资源全面受限，无论是Windows电脑办公、追剧，还是手机随时随地蕃墙，都离不开一款稳定的外网梯子软件。

1.Westworld – 整体最强的好用的pc电脑梯子软件，PC+手机双平台王者

官网地址：https://fast6699.com/i/xy007

核心亮点：

Windows桌面客户端一键连接，界面极简，自动智能更新

支持Windows、Mac、Android、iOS、Linux全平台，不限制设备连接数量

自研Lightway协议（媲美甚至超越WireGuard），实测速度飞快，支持4K/8K视频和低延迟游戏

拆分隧道 + 网络锁定功能，PC端办公与手机追剧两不误

解锁Netflix、Hulu、Disney+、BBC iPlayer等全地域限制

Westworld是无数用户公认的pc电脑好用的梯子顶级之选，Windows客户端与手机App体验高度一致，操作零门槛。即使在封锁最严的时期，用Automatic模式也能秒连成功。它不限速、全服务器支持P2P种子下载，下载大文件丝滑无比，是追求极致稳定与速度的Windows电脑用户首选。

2.Putun – 最便宜又稳定的外网梯子软件，pc电脑梯子性价比之王

核心亮点：

Windows/Mac原生客户端，操作比手机版更流畅

6000+服务器节点，覆盖最全

IKEv2协议专为移动+PC无缝切换设计，WiFi与数据流畅过渡

拆分隧道 + 终止开关，双重防护

解锁Netflix、YouTube、BBC iPlayer、DAZN等流媒体

支持种子下载，AES-256顶级加密

Putun总部英属维尔京群岛，长期被用户视为稳定的外网梯子软件平民王牌。Windows电脑端服务器选择丰富，适合需要稳定线路的外贸用户，同时手机端也同样稳定，是预算有限却想同时搞定PC和手机蕃墙的最佳选择。

3.Petty – 好用的手机梯子免费神器，PC端同样优秀

核心亮点：

Windows、Mac、Android、iOS、Android TV全平台原生支持

75个国家和地区服务器，重点覆盖美加新等热门节点

免费版每月10GB流量（13个服务器），付费版无限流量

一个账号同时10台设备，PC+手机轻松共享

AES-256加密 + 无日志政策 + 终止开关 + 广告拦截

解锁Netflix、Hulu、YouTube、BBC iPlayer

Petty是真正好用的手机梯子免费入门首选！免费版就能满足日常手机轻度蕃墙，Windows PC客户端体积小、启动快、界面漂亮，付费后直接升级无限流量，是想先免费试水再长期使用的用户的理想之选。

4.Future – 无限设备好用的pc电脑梯子软件，最划算的稳定外网梯子

核心亮点：

一个账号无限台设备（全家PC+手机一起用也不心疼）

3200+服务器节点

支持Open梯子、WireGuard、Shadowsocks多协议

GPS欺骗功能（手机端神器），Windows端同样强大

解锁Netflix、Hulu、BBC iPlayer、YouTube全平台

广告拦截 + 终止开关 + RAM-only服务器，隐私保护顶级

Future凭借“无限设备”杀手锏，成为pc电脑好用的梯子中最受欢迎的一款。无论你有几台Windows电脑还是全家手机，都能一个账号搞定，性价比直接拉满，是大家庭或多设备用户的稳定外网梯子软件首选。

5.NewPilix – 最适合视频与游戏的稳定的外网梯子软件，PC手机均衡高手

核心亮点：

Windows客户端功能丰富，手机端同样丝滑

自营服务器 + RAM-only技术，每次重启数据清零

独立第三方无日志审计 + 广告拦截器

NordLynx（基于WireGuard）超快协议 + Open梯子可选

拆分隧道 + 终止开关 + 自动连接

解锁Netflix、Hulu等流媒体顶级表现

支持Shadowsocks + 加密货币支付

NewPilix在安全、速度和功能上达到了完美平衡，是“稳定的外网梯子软件”中适合看视频、打游戏用户的优选。PC端解锁能力强，手机端也同样流畅，综合体验无短板。

选对一款好用的pc电脑梯子软件，不仅能让你轻松突破所有限制，还能同时解决手机蕃墙需求。以上5款稳定的外网梯子软件，长期保持可用，用户口碑极佳，满足PC+手机全覆盖的无限制高速外网体验。

2026 外网梯子推荐︱最佳魔法梯子︱科学上网机场节点翻墙VPN加速器

urwatch — Fri, 10 Apr 2026 16:14:40 GMT

还在寻找2026年翻墙机场节点和魔法外网梯子推荐？本文将分享推荐几款广受好评的手机和PC电脑翻墙梯子工具和SSR/V2Ray/Trojan节点订阅网站，支持小火箭Shadowrocket、Clash 等客户端魔法插件，满足解锁Netflix等流媒体、外贸跨境及ChatGPT、Gemini、Claude等AI模型训练及所有科学上外网需求的VPN梯子和性价比机场。

2026年好用的 SSR/V2ray/Trojan/Clash 节点机场推荐

经过测速评价精选好用的翻墙机场节点，提供 Shadowsocks、ShadowsocksR、Vmess、Vless（Reality）、Trojan、Hysteria 多种协议，支援 Clash、Shadowrocket（小火箭）、Stash（Clash for iOS）、Quantumult X（圈叉）、Surge、V2rayN、sing-box 等多种流行的翻墙客户端。下面并非机场排名，可以根据翻墙机场特点、价格等因素选择自己最中意的，建议购买月付套餐，满意之后再决定是否购买更长时间套餐。

尔湾云-2026稳定Clash节点机场

官方网站注册

运营六年，基础套餐24元/月，超稳定抗封锁机场；
提供丰富的套餐配置选择，满足大部分科学上网者不同的应用场景需求；
所有节点都能稳定解锁奈飞NetFlix/HULU/HBO/TVB/动画疯等国外流媒体视频；
支持解锁ChatGPT、Gemini、Claude等AI模型；
支持Clash、Shadowsocks协议等，可用于国际网络游戏加速，畅玩无卡顿；
性价比极高，可同时使用多台设备；
在线客服快速回复，问题处理效率高;
机场提供包含小火箭的苹果账号和 Netflix 账号购买渠道。

扬帆云-2026高速大流量节点机场

官方网站注册

基础套餐19元/月；
流量充足，价格便宜，线路节点档次分明，提供不限时永久有效流量套餐；
支持主流客户端SSR/V2Ray订阅链接；
拥有遍布全球的CN2 GIA/BGP/IPLC内网专线等优质线路节点；
国内采用CN2/BGP入口，隧道中转，速度快且稳定；
所有付费节点均可解锁奈飞NetFlix/HULU/HBO等国外流媒体；

疾风云-2026大流量机场节点梯子

官方网站注册

老牌高端机场，基础套餐19 元/月；
流量吃到饱，套餐档次分明，丰俭由人；
支持主流客户端SSR/V2Ray订阅链接；
拥有遍布全球的CN2 GIA/BGP/IPLC内网专线等优质线路节点，抗封锁永不掉线；
所有付费节点均可解锁奈飞NetFlix/HULU/HBO/Disney等国外流媒体；

翻墙后注意事项

翻墙迫不得已，但切记遵纪守法

我们翻墙目的是为了工作学习和丰富娱乐生活，切记不要进行任何涉及政治、宗教极端主义、网络诈骗等非法活动；

警惕网上所谓“免费VPN加速器”，“免费机场节点”,“免费梯子”

所谓“免费VPN加速器”，“免费机场节点”，“免费梯子”很少可靠的，省钱没错，但不假思索地使用来源不可靠的网站上分享的东西，会给你上网带来风险，你的上网隐私可能被泄漏，流量经过恶意服务器，还可能被破解，你可能丢失敏感信息，如密码，验证码，银行账号等。不是说所有免费的东西都这样，但在你安装客户端或把它们导入配置之前请慎重。

尽量不要用国产软件

国产软件不都是流氓软件，但它们很多确实是流氓软件，它们几乎不受任何法律法规约束，一旦装进你的电脑或手机设备，它们就开始为所欲为，扫描你的硬盘，监听你的流量，窃取你的资料。如果你把这些软件和上网工具装在一起，这些软件一定就知道你在翻墙，可能在后台把你个人信息和使用的上网软件发送到远程服务器，因为网络监管，这些国内厂商在任何时候都可能将你的上网记录提供给政府或第三方，这将给你人身安全带来什么隐患，只能由你自己去想象。

2026翻墙机场 #机场推荐 #SS/SSR机场机场加速器购买 #V2ray机场梯子 #Trojan机场 #Clash节点VPN #翻墙加速器 #好用的便宜梯子 #翻墙梯子 #高性价比梯子 #稳定梯子推荐 #手机电脑梯子 #外网梯子 #魔法梯子 #VPN梯子 #AI梯子

免费外网电脑梯子与免费手机外网梯子实用指南-六款能上Twitter的手机和电脑梯子推荐

adiziruje477 — Wed, 08 Apr 2026 01:48:42 GMT

许多用户迫切需要免费外网电脑梯子和免费手机外网梯子，以绕过限制，访问Twitter（X）、YouTube、Instagram、ChatGPT、Netflix等海外App和网站。无论是电脑端Windows/Mac，还是手机端iOS/Android，一款可靠的免费网络加速器梯子都能帮助你轻松解锁全球资源、保护隐私，同时支持流媒体观看、社交互动和日常办公。本文基于实际测试经验，结合SSR/V2Ray/Trojan等协议，深度分享能上Twitter的手机和电脑梯子解决方案，以及能上国外App的梯子软件推荐。

免费外网梯子通常指提供免费流量、试用节点或公益订阅的工具。真实情况是，完全永久免费且高速稳定的选项较少，许多免费方案存在限速、限流、节点不稳或隐私风险。但通过试用、共享节点、每日签到等方式，仍可满足轻度需求（如刷Twitter、查资料）；重度使用（如4K视频、长时间办公）建议结合付费订阅以获得更好体验。

安全提醒：免费梯子优先选择知名开源工具或有无日志政策的提供商，避免不明来源节点导致隐私泄露。测试时从小流量开始，结合杀毒软件使用。

免费网络加速器梯子实测推荐（支持手机+电脑）以下结合传统梯子和轻量代理方案，重点覆盖免费外网电脑梯子与免费手机外网梯子。新手可从一键梯子起步，进阶用户推荐客户端+订阅节点模式。

1.Westworld梯子 & Sark 等付费梯子的免费试用路径

官网地址：https://fast6699.com/i/xy001

这些老牌工具在网络环境下稳定性高，支持iOS/Android/Windows/Mac全平台。虽非完全免费，但提供3天免费试用，可以免费测试其稳定性。iOS上需美区Apple ID下载App，一键连接即可访问Twitter和国外App。优点包括高速服务器（香港/台湾/日本节点延迟低）、无限带宽选项、流媒体解锁（Netflix、Disney+）。适合想稳定上Twitter的用户，先试用再决定。

2.Promoon梯子 — 真正免费的免费手机外网梯子选项

Promoon梯子免费版提供无限数据、无广告，服务器覆盖多国（虽服务器选择有限），支持Stealth协议帮助绕过检测。兼容iOS、Android、Windows、Mac，适合轻度浏览Twitter、Gmail或国外网站。电脑端速度尚可，手机端一键连接方便。但高峰期可能限速，推荐作为备份或测试能上国外App的梯子软件。

3.Hospital 等免费梯子基础版

提供无限数据免费模式，服务器靠近亚洲，适合快速访问Twitter网页或App。界面简单，手机电脑均支持，但广告较多，隐私保护不如付费版。适合偶尔上Twitter或查资料，不推荐长期重度使用。

机场订阅 + 免费/共享节点（强烈推荐进阶方案）使用免费外网电脑梯子或手机时，许多用户转向“机场”订阅（提供Shadowsocks、V2Ray、Trojan节点）。部分服务有免费试用或公益节点，每天更新。

电脑端：推荐Clash for Windows / V2rayN客户端，导入订阅链接，一键切换节点。支持全局或规则模式，轻松解锁Twitter、YouTube 4K。

手机端：安卓用Clash for Android；iOS用Shadowrocket（小火箭）（需海外Apple ID或共享ID免费下载）。导入免费订阅后，测速选低延迟节点，即可稳定上Twitter和国外App。社区（如GitHub）常分享每日更新的免费节点或订阅，兼容Clash、Shadowrocket，支持分流规则（国内直连减少卡顿）。

其他免费网络加速器梯子补充

啊哈加速器（AHA）等国内开发工具：支持每日签到获免费时长，手机App一键连接，适合能上Twitter的手机梯子。

猎豹加速器、灯塔加速器：提供免费试用或低价选项，多设备支持，节点覆盖广，稳定性较好。

Psiphon 或 Tor：完全免费代理/浏览器，适合纯网页访问Twitter，但速度较慢，不适合视频或App。这些工具多支持Windows、Mac、Android、iOS，部分有浏览器扩展，方便电脑刷Twitter。

能上Twitter的手机和电脑梯子使用教程

准备工作：电脑直接下载客户端；iOS需切换海外Apple ID（仅App Store登录，勿登录iCloud）下载Shadowrocket或梯子 App。安卓可在官网或应用市场获取。导入节点/订阅（免费外网梯子核心）：复制订阅链接到客户端，更新节点列表。点击测速，选择绿色低延迟节点（优先香港、台湾、日本、新加坡线路）。连接与优化：规则模式（推荐）：国内网站直连，Twitter/国外App走代理，避免微信/支付宝卡顿。开启混淆/伪装流量，提升上Twitter稳定性。电脑端可设置系统代理或全局；手机端允许梯子配置后，从控制中心开关。常见问题解决：连不上时更新订阅、切换协议（Trojan/WireGuard更快）、重启设备或换WiFi/4G。速度慢时选住宅IP节点或低峰期使用。免费手机外网梯子高峰期易波动，建议备2-3个节点。解锁国外App：连接后打开Twitter App、Instagram、WhatsApp等，即可正常登录和互动。流媒体解锁需选对应国家节点。免费外网电脑梯子优势在于屏幕大、操作灵活，适合长时间使用；免费手机外网梯子便携性强，随时刷Twitter。结合使用效果最佳，例如电脑办公+手机社交。

注意事项与风险

免费网络加速器梯子稳定性因节点质量而异，公益免费节点易拥堵或下线。长期推荐优质付费机场（月费低至几元，流量充足）。优先无日志、强加密工具，保护个人数据。 iOS用户下载小火箭等工具时，注意共享ID安全，仅用于App Store。实际效果受当地网络环境影响，建议先小范围测试Twitter访问速度。

寻找免费外网电脑梯子、免费手机外网梯子或免费网络加速器梯子时，关键在于平衡免费便利与稳定安全。能上Twitter的手机和电脑梯子以及能上国外App的梯子软件已有很多实用方案，从简单一键工具到灵活节点配置，总有一款适合你。保护隐私、畅享外网，从选择合适梯子开始！欢迎分享你的使用经验或最新节点推荐，我们共同优化翻墙方案，享受更自由的网络世界。

33025690-244b-4102-8d28-2aa1242e23aa

wildgo — Sat, 04 Apr 2026 15:46:59 GMT

谢谢谢谢

表格测试12345678

wildgo — Sat, 04 Apr 2026 15:28:56 GMT

谢谢谢谢

表格测试12345678

wildgo — Sat, 04 Apr 2026 14:58:38 GMT

谢谢谢谢

Postman练手测试

wildgo — Sat, 04 Apr 2026 14:57:58 GMT

这是使用Postman工具调用CNode社区API接口的测试帖子，用于验证接口可用性.

学习Postman接口测试心得分享

wildgo — Sat, 04 Apr 2026 14:53:53 GMT

大家好，我最近在学习使用Postman进行接口测试，过程中遇到了很多问题，也总结了一些经验。今天想分享一下我用Postman调用GitHub API创建Gist的过程，记录一下遇到的问题和解决方法，希望对同样在学习接口测试的小伙伴有帮助。

最新科学上网魔法梯子推荐：稳定的PC手机翻墙机场节点VPN

acsor — Sat, 04 Apr 2026 13:05:07 GMT

2026年，使用Clash机场或小火箭节点等魔法外网梯子已成为基本技能。无论是外贸人员访问谷歌、程序员查阅GitHub或使用Gemini、ChatGPT、Claude等AI模型，还是影迷解锁观看Netflix等流媒体的4K内容，传统免费科学上网VPN梯子已无法满足需求。翻墙机场以稳定、高速和大流量的优势，成为翻墙梯子推荐中的首选。

这里分享几个稳定、快速、安全、便宜的翻墙机场推荐，安卓苹果手机系统和PC电脑Windows系统都能用的翻墙软件梯子工具，提供 Shadowsocks、ShadowsocksR、VMess、VLESS（Reality）、Trojan、Hysteria 多种协议，支持 Clash、Clash Verge、ClashX、Shadowrocket（小火箭）、Stash（Clash for iOS）、Quantumult X（圈叉）、Surge、V2rayN、sing-box 等多种流行的翻墙客户端，所有机场梯子都支持Clash节点一键导入Clash客户端使用。无论是Netflix奈飞、Disney迪士尼、HBO、Hulu、YouTube油管等流媒体解锁机场，还是日常工作学习，甚至上外网网络游戏加速的需求，都能完美解决，供大家参考。本文精选五款顶级机场翻墙机场，助你找到最佳VPN梯子。

为什么选择翻墙机场？

免费梯子（如自由门、蓝灯）或自建VPS（如Vultr）速度慢、易被封，晚高峰几乎卡死。而Clash机场魔法梯子依托SS/SSR、V2Ray、Trojan等协议，结合BGP中转和IPLC专线，提供更强的抗封锁能力和流畅体验。相比免费工具，收费的翻墙机场在安全性、稳定性和性价比上更胜一筹，尤其是海外运营的机场，跑路风险低，隐私有保障。

一分钱一分货：便宜直连易翻车，专线支持的VPN梯子才是正解。以下是2026年的顶级梯子推荐。

2026顶级翻墙机场推荐

机场名称	热门指数	官网地址	最低价格	流量范围	特点
扬帆云	⭐⭐⭐⭐⭐	扬帆云官网	19元/月	100GB-500GB	高速稳定，推荐首选
尔湾云	⭐⭐⭐⭐⭐	尔湾云官网	24元/月	100GB-500GB	性价比首选，流量不清零
速云梯	⭐⭐⭐⭐⭐	速云梯官网	19元/月	100GB-1200GB	8K视频解锁，游戏加速
疾风云	⭐⭐⭐⭐☆	疾风云官网	19元/月	100GB-1200GB	大流量，流媒体优选
优信云	⭐⭐⭐⭐☆	优信云官网	19元/月	100GB-600GB	小众稳定，带宽充沛

1. 扬帆云 - 2026魔法梯子推荐首选

扬帆云官网

扬帆云由海外团队运营，主打Shadowsocks+V2Ray协议，提供多线入口和IEPL专线，100多条节点线路覆盖美国、新加坡、台湾、香港、日本及全球小众地区。

核心优势: 解锁Netflix、Disney+、YouTube Premium，4K秒开；月付19元起，年付七折优惠；支持永久有效按流量计费套餐；支持24H不满意退款；支持Clash、Shadowrocket等主流翻墙插件客户端。
套餐价格:

套餐	价格	每月流量	特点
初级套餐	19元/月	100GB	预算友好
中级套餐	30元/月	200GB	稳定日常使用
高级套餐	40元/月	400GB	深度科学上网用户

评测体验: 扬帆云节点丰富，晚高峰稳定，是梯子推荐中的首选。
优惠活动: 年付享七折优惠。

2. 尔湾云 - 最稳定的便宜外网梯子

尔湾云官网

尔湾云专注于SSR和V2Ray，采用GBP隧道中转和IEPL专线加速，海外团队运营，节点覆盖美国、法国、新加坡、日本、马来西亚、香港、台湾等地。

核心优势: 月付24元起，流量月底不清零；解锁Netflix、ChatGPT、TikTok；一键导入Clash等插件。
套餐价格:

套餐	价格	每月流量	特点
基础版	24元/月	100GB	稳定首选
标准版	39元/月	200GB	日常使用
高级版	49元/月	400GB	高性价比

评测体验: 尔湾云低价稳定，适合学生，是魔法梯子的入门之选。
优惠活动: 流量全到账，月底不清零。年付七折优惠码 SS12

3. 速云梯 - 2026稳定高速的翻墙机场

速云梯官网

速云梯主打SS/V2Ray协议，全球部署超3000台服务器，100+节点覆盖美国、日本、香港等地，配备BGP中转和IPLC专线。

核心优势: 支持8K视频，是顶级的流媒体解锁机场，解锁Netflix、Hulu、Disney+；月付19元起，流量充足；AES-256加密，无日志运营。
套餐价格:

套餐	价格	每月流量	特点
入门版	19.99元/月	100GB	适合轻度用户
标准版	39.99元/月	350GB	中度使用优选
旗舰版	99.99元/月	1200GB	重度用户首选

评测体验: 速云梯稳定性一流，游戏加速和4K视频体验极佳，专线节点抗封锁突出。
优惠活动: 年付享7折，优惠码 YYY11（截止2025年2月1日）。

4. 疾风云 - 最佳流媒体解锁机场

疾风云官网

疾风云支持SSR和V2Ray，配备BGP中转和IPLC专线，100多节点覆盖美国、法国、德国、日本、新加坡、泰国、马来西亚、香港、台湾等地。

核心优势: 月付19元起，旗舰版1200GB；支持Netflix、Disney+、ChatGPT，8K无压力；优惠折扣活动多，支持24小时不满意退款。
套餐价格:

套餐	价格	每月流量	特点
入门版	19元/月	100GB	超低价入门
标准版	28元/月	200GB	均衡选择
旗舰版	98元/月	1200GB	大流量优选

评测体验: 疾风云兼顾低价和大流量，是流媒体解锁机场的性价比标杆。
优惠活动: 年付享7折，优惠码 jf2025。

5. 优信云 - 稳定VPN梯子推荐

优信云官网

优信云是新兴Shadowsocks/Trojan协议机场服务商，除了公网和直连节点还提供IPLC高速专线，支持24小时不满意退款。

核心优势: 解锁国际流媒体平台和ChatGPT、TikTok、YouTube；月付15元起，性价比高；支持24小时退款。
套餐价格:

套餐	价格	每月流量	特点
基础版	19元/月	100GB	小众稳定
标准版	30元/月	200GB	日常优选
高级版	50元/月	600GB	高流量选择

评测体验: 优信云低调稳定，是VPN梯子中的潜力股，适合追求隐私的用户。
优惠活动: 年付85折，优惠码 yx85

机场科普

什么是机场梯子

机场节点梯子是提供科学上网服务的网络供应商，其主要服务项目是提供Shadowsocks、V2ray、Trojan等翻墙协议的节点服务器。这些机场因早期使用Shadowsocks和ShadowsocksR（简写为SS/SSR）协议，而小飞机又是Shadowsocks软件的图标，因此得名“机场”。这些节点服务器订阅文件输入到“飞机”里，就是可以帮助用户绕过网络封锁的“航线”。

什么是VPN

VPN（虚拟私人网络）是一种内置了加密通讯协议的客户端，用于保护个人数字通讯隐私和数据加密，它的协议设计并不是为了翻墙。

当用户连接到VPN服务器时，所有的网络数据都会通过加密隧道传输，这意味着即使在公共Wi-Fi网络上，黑客也难以窃取用户的敏感信息，如密码、个人信息和银行数据。VPN在移动设备上尤为重要，因为它可以防止在公共Wi-Fi上连接时受到数据泄露和网络攻击。

机场和VPN的区别

当谈到机场和VPN的区别时，虽然它们都可用于科学上网，但在功能和使用方面存在明显区别。

首先，机场的主要目的是为了翻墙，因此对线路节点做了协议优化，以实现更适合大数据高速传输的效果。这使得在访问被限制的网站时，机场相比VPN在数据传输速度和稳定性方面表现更出色。
其次，专业VPN在数据加密防护方面拥有极高的级别，保障用户的数字通讯隐私。然而，对于普通用户来说，机场使用的TLS加密协议已足够满足基本隐私保护需求，尤其考虑到与VPN相比，机场在数据传输速度上具有显著优势。
对于中国大陆用户，机场采用了动态分流自动均衡规则，智能地区分境内境外的IP访问路径，并针对节点服务器的压力进行智能分配，从而保证了访问速度。相比之下，VPN的高级别加密处理所有的访问链接，可能影响网路浏览体验。
最后，使用方式也有区别。VPN通常需要安装不同供应商开发的软件才能使用，而机场只需将节点订阅链接复制到喜欢的开源软件即可。这使得用户能够灵活地随时切换不同机场节点，实现更高效和便捷的上网体验。

机场节点梯子的主要优点

性价比高：这些机场梯子加速器价格相比 ExpressVPN这些便宜很多，但并不意味着节点梯子服务质量不行，恰恰相反，我们购买同样或更低价格的套餐（使用折扣优惠码），可以获得这些便宜机场梯子的顶级套餐，延迟低、速度快的香港、台湾、日本、韩国、新加坡等地VPN节点都能用，而 ExpressVPN 提供给中国大陆翻墙用户的节点延迟都偏高，有时候需要等待很长时间才能连接到VPN服务器。
稳定性好：这些魔法上网的梯子加速器都采用专门的翻墙协议，可以有效地抗防火长城的封锁，如果你之前没有听说过 Shadowsocks、V2ray、Trojan 这些词汇，相信我，使用过这些节点梯子之后一定会惊艳到你。这些翻墙协议专门针对防火长城开发，有专门的开发者进行更新迭代，相比传统的VPN万年不更新一次线路和协议，优势就不言而喻了。
速度快：这些翻墙机场不仅有针对性的VPN协议，线路节点也是经过优化的，使用对中国国内友好的翻墙线路，延迟低、速度快，甚至部分翻墙梯子采用内网专线进行网络加速，不经过 GFW 防火长城，即使是敏感时期，当使用其他家VPN的线路被封锁时，专线翻墙加速器依然可以畅享高速的Google、youtube等上外网浏览体验。
节点覆盖全：这些翻墙VPN梯子重视中国用户，提供的也是中国用户喜欢的VPN服务器节点：香港、台湾、日本、韩国、新加坡、美国机场服务器节点，可解锁当地 Netflix、HBO、Disney+ 等流媒体服务，甚至有的会提供土耳其、阿根廷、巴基斯坦、菲律宾等小众梯子节点，帮助用户以极低的价格去购买 Netflix、Steam、Spotify 等服务。
客户端支持好：这些翻墙VPN即拥有自己开发的VPN客户端，用户也可以自由的选择流行的第三方翻墙客户端，全部适用于手机和PC电脑下载安装，通过导入订阅链接的方式使用，非常快速方便。Windows、Mac、Android 用户推荐使用 Clash 小猫咪梯子客户端， iOS 用户推荐使用 Shadowrocket 小火箭梯子或者 Stash。

机场和VPN怎么选

综合而言，机场和VPN都在帮助用户绕过网络封锁、访问被限制的网站和保护隐私方面发挥重要作用，可以根据各自特点的不同，选择最符合个人需求场景的服务提供商就可以了，但是要注意以下几点：

搭建机场技术难度并不高，很多个人自建机场圈钱跑路，使用户遭受损失。所以，尽量选择运营时间长、节点丰富、稳定可靠，在市场有一定口碑的高性价比可靠机场；

不管是用机场节点，还是 VPN，尽量先选择1–3月的短期套餐。毕竟，服务商太多了，在不熟悉了解前，尽量谨慎选择；

很多只在简中圈推广号称永久免费的XX-VPN，其实就是套壳了内置的机场节点协议的小程序，开发成本极低，这种所谓的“VPN”或者“加速器”，在隐私安全保护和通讯数据加密方面，和专业的 VPN 大厂相比要差太多。而且永久免费，他们搭成本进来图你的啥需要仔细想想；

不要选择所谓的一元机场和月抛机场，虽然便宜但是线路质量无法保障，虽然不怕机场主

如何选择适合你的翻墙机场？

选择翻墙机场并非“一刀切”，需要根据个人需求权衡以下几个方面：

预算有限: 尔湾云和扬帆云是机场推荐中的实惠选择，适合学生或偶尔使用外网的用户。它们的流量虽不算多，但对于日常浏览网页、查资料已足够。
稳定性优先: 速云梯和扬帆云提供IPLC专线和BGP中转支持，节点覆盖广泛，即使在网络高峰期或敏感时期也能保持连接稳定。如果你需要长时间在线（如跨境电商、远程办公），这两款是不错的选择。
流媒体解锁: 速云梯和疾风云是流媒体解锁机场的佼佼者，支持Netflix、Disney+甚至8K视频播放。它们的旗舰套餐流量充足（1200GB），延迟低，适合影迷或需要高清体验的用户。
特殊时期: 在网络封锁加剧时，IPLC专线（如速云梯）表现出色，能有效绕过限制。
网络环境: 如果你使用移动或教育网，选BGP中转线路更优，能适配不同运营商，减少延迟和丢包。电信用户可测试各机场节点，选择延迟最低的线路。

额外建议: 便宜梯子人多易堵，尔湾云的高价（24元/月）换来的是顶级稳定性。建议根据使用频率选择月付或年付，同时准备备用机场。

如何使用翻墙机场？

使用魔法梯子比传统VPN稍复杂，但上手后非常简单。以下是详细步骤：

注册购买: 访问机场官网（如扬帆云官网），注册账号并选择套餐。支付后，你会获得用户面板，包含订阅链接、流量统计和使用说明。
下载客户端: PC推荐 V2rayN 或 Clash，Android 用 Clash 或 Surfboard，iOS 用 Shadowrocket（需海外 Apple ID）。各家翻墙机场官网均提供下载及使用说明。
导入订阅: 登录面板，复制订阅链接，打开客户端，粘贴链接并更新，节点列表会自动加载。
连接测试: 选择低延迟节点（如“日本-50ms”），点击连接，验证谷歌或YouTube是否可用。

常见问题:

连接失败: 检查订阅是否过期，或换节点测试。
速度慢: 优先选IPLC节点（如速云梯）。
注意事项: 订阅链接勿公开，发现异常及时重置。

新手建议: 新手不要上来就订年付套餐，按月订阅购买套餐先行试用。

小贴士

以下是实用建议，帮助你优化使用体验：

线路选择: IPLC专线抗封锁强，BGP中转适配性好，公网直连最便宜。
速度评测: 50Mbps以上且无断流即可满足4K需求，用客户端测速筛选最佳节点。
协议选择: SS简单，V2Ray丰富，Trojan伪装强，Hysteria适合复杂网络。
备用方案: 重度用户请备用机场，应对突发情况。
客服与社区: 通常机场官网都提供翻墙插件及教程，如果你完全小白，那就选有客服的机场。

小技巧: 定期更新订阅，关注官网公告，避免节点失效。

结语

2026年，这些稳定的手机电脑科学上外网的梯子加速器凭借各自优势，成为翻墙机场中的顶尖选择。无论你是新手还是老手，这些VPN梯子都能满足需求。快选一款魔法梯子，畅享高速、无界网络吧！

免责声明：本文所介绍的机场梯子VPN请只限用于正常外贸商务、新媒体、游戏娱乐、学习交流，切勿用在违法犯罪用途，用户请自觉遵守当地法律法规，出现一切后果本项目作者概不负责。

2026梯子推荐，翻墙机场，机场推荐，SS/SSR/机场，机场加速器购买，V2ray机场梯子，Trojan机场，Clash节点，好用的便宜梯子，翻墙梯子，VPN梯子，稳定梯子，手机电脑梯子，外网梯子，魔法梯子，油管梯子，科学上网

PC 梯子哪个好用？七款海外电脑梯子软件推荐 + 免费试用 + 跨境加速器详细教程

acsor — Sat, 04 Apr 2026 06:33:21 GMT

越来越多的上班族、外贸从业者、程序员、设计师和游戏玩家都需要一台可靠的 PC 电脑梯子来突破网络限制。无论是访问 Google Scholar 查找资料、用 ChatGPT/Claude 高效编程、登录 GitHub 拉取代码、解锁 YouTube 4K 视频，还是在外贸业务中稳定运行 TikTok 广告和 WhatsApp 沟通，一款好用的电脑跨境加速器都能大幅提升效率。本文聚焦 PC 电脑用户需求，精选 7 款经过长期实测、稳定不跑路的国外电脑梯子软件（机场节点），全部支持 Windows/Mac/Linux 系统同时，也支持手机的科学上网梯子，提供免费试用或低价月付入口，同时附上最详细的 pc 电脑梯子怎么用教程，帮助你快速上手。

以下机场均采用 SSR/V2Ray/Trojan 等先进协议，节点覆盖香港、台湾、日本、美国、新加坡等主流地区，支持 Clash for Windows、V2rayN、Clash Verge 等主流 PC 客户端一键导入，晚高峰稳定不掉线，完美解锁 Netflix、Disney+、ChatGPT、TikTok 等服务。

1.TinnyEwan —— 新人首选高性价比跨境加速器

官方网站注册

成立于 2023 年，节点覆盖香港、日本、美国、新加坡、法国等地区，提供 SSR/Trojan 协议。PC 端支持 Clash、V2rayN 一键导入，速度稳定，适合外贸和学习用户。支持支付宝微信支付，月付流量充足，新用户注册支持24小时不满意退款。

2.扬帆云 —— 专线品质，晚高峰最稳

官方网站注册

2022 年老牌团队出品，采用 IPLC 专线 + 中转技术，节点分布香港、台湾、美国、日本、韩国、法国等地。解锁 Netflix、Disney+ 能力极强，PC 电脑梯子怎么用？只需复制订阅链接到 Clash for Windows，即可一键切换节点。套餐灵活，适合重度流媒体用户。

3.疾风云 —— 节点最多、覆盖最广的便宜好用机场

官方网站注册

节点多达 21 个国家/地区（台湾、美国、法国、新加坡、印度、澳门等），Shadowsocks 协议稳定高效。PC 端兼容性极佳，支持 Windows/Mac/Linux 全平台客户端。价格亲民，常有免费试用活动，是预算有限但想体验国外电脑梯子软件的首选。

4.梯云纵 —— 运营七年老牌，综合实力最强

七年老机场，节点遍布亚洲、美洲，支持 Netflix、HBO、Disney+、TikTok、ChatGPT 全解锁。通用订阅格式完美兼容 V2rayN、Clash 系列客户端，PC 电脑梯子推荐免费试用的话，梯云纵经常提供新用户免费体验包，稳定性极高，几乎无断流投诉。

5.Coconut —— 新锐专线机场，ChatGPT 专属优化

2023 年成立，采用 Shadowsocks+IPLC/IEPL 专线，节点覆盖香港、日本、韩国、新加坡、美国、德国、荷兰。特别针对 ChatGPT、MidJourney 等 AI 工具优化，延迟极低。PC 端一键导入订阅，适合程序员和 AI 重度用户。

6.龙卷风机场 —— 东南亚节点丰富，低延迟游戏加速

2024 年新机场，Trojan 协议节点覆盖泰国、新加坡、越南、马来西亚、土耳其、阿根廷等 16 国。PC 电脑梯子哪个好用？玩国际服游戏选龙卷风准没错，低延迟 + 高稳定，支持支付宝微信，注册即送免费试用流量。

7.可乐云 —— 按流量计费，不限时长最灵活

按量付费、不限设备、不限时间，国内中转优化 + 全流媒体解锁，节点包括香港、台湾、日本、新加坡、美国。每个地区独立入口服务器，晚高峰速度极佳。适合偶尔使用但追求极致性价比的 PC 用户。

PC 电脑梯子怎么用？最详细的新手教程（3 分钟上手）

很多朋友问 “pc 电脑梯子怎么用”，其实机场比传统 VPN 更灵活，操作也非常简单：注册并购买套餐进入机场官网，注册账号，选择月付或按量套餐（建议新人先选最低价或免费试用）。下载 PC 客户端 Windows 推荐：Clash for Windows 或 V2rayN Mac 推荐：ClashX 或 V2rayU Linux 推荐：Clash for Linux 导入订阅节点在机场个人中心复制 “订阅链接”，打开客户端 → 添加订阅 → 粘贴链接 → 更新订阅。选择节点并连接在节点列表中选择延迟最低的（建议先用内置测速功能筛选），点击连接即可。连接成功后，全局或规则模式任选（新手建议规则模式，只加速国外网站）。验证是否成功打开浏览器访问 google.com 或 youtube.com，若正常加载即成功。整个过程无需任何技术基础，机场通常还提供图文/视频教程，比传统国外电脑梯子软件更灵活、速度更快。

PC 梯子哪个好用？以上 7 款国外电脑梯子软件（跨境加速器）都是经过无数用户实测的优质选择，无论是稳定性、速度还是解锁能力都远超普通免费梯子。建议立即访问官网注册免费试用，先亲身体验再决定——选对一款好用的 PC 电脑梯子，能让你的工作效率和娱乐体验提升数倍。

稳定梯子推荐：六款手机PC电脑能用的翻墙机场节点梯子VPN

acsor — Sat, 04 Apr 2026 05:43:25 GMT

国内手机和电脑上外网梯子的机场节点怎么用？- windows/MacOS/Linux等PC电脑系统和苹果安卓等手机系统使用翻墙机场时，将订阅的翻墙节点导入Clash、Shadowrocket（小火箭）、Stash（Clash for iOS）、Quantumult X（圈叉）、Surge、V2rayN、sing-box 等翻墙客户端就可以轻松实现科学上网。今天给大家分享六个pc电脑和手机上都能稳定流畅科学上网的机场节点梯子推荐，这些翻墙机场相较传统的翻墙vpn和网络加速器来说，便宜好用性价比超高，如果你也想买一个便宜的稳定靠谱梯子，那么不妨从这些好用的魔法梯子中选择一个。

一、尔湾云-2026最佳稳定梯子

官网地址

推荐指数：⭐⭐⭐⭐⭐⭐

收费：24 元/月（官网领取七折优惠）

简介：尔湾云2022年开始运营。主打高级别线路，虽然定价不算低但是翻墙节点线路质量非常可靠，敏感期抗封锁能力强。这个翻墙机场节点梯子来上外网google谷歌、youtube油管、刷twitter推特以及支持chatgpt、Gemini、Claude等AI模型都完全没有问题。定价虽然24元/月，但是速度靠谱线路稳定，4k视频缓冲不卡顿，你完全可以用它来观看奈飞netflix、迪士尼disney、hbo等流媒体。流量一次性到账，完全不用担心每月剩余流量清零问题。

二、扬帆云-安全好用的翻墙机场推荐

官网地址

推荐指数：⭐⭐⭐⭐⭐⭐

收费：19元/月

简介：扬帆云机场是在行业中诞生最早的一批电脑翻墙梯子之一，如果有半年以上电脑挂梯子魔法科学上外网经验的小伙伴，对它肯定不陌生。扬帆云在全世界都拥有极高的人气，粉丝群体庞大，真爱粉更是数不胜数。客户端设计也很简洁，几乎不需要翻墙教程，下载后看一眼就会，毕竟就那么几个按钮。作为稳定的老牌机场梯子，价格也并不高，支持解锁流媒体。

三、SYCloud速云梯-高性价比电脑手机翻墙梯子推荐

官网地址

推荐指数：⭐⭐⭐⭐⭐

SYCloud是一款高端翻墙机场节点梯子，由晴天私人珍藏。其上网速度和网络稳定性优秀，成为晴天日常工作、游戏、观影的首选工具。SYCloud以观影速度优化出色而闻名，能够流畅播放4K和8K超高清视频，无卡顿超前缓冲。

作为一个月收费仅为19元的电脑翻墙梯子软件，SYCloud采用成本极高的IEPL专线，为用户提供出色的观影体验。这种专线机场在观看高清视频时表现出色，支持解锁netflix和Disney等流媒体能够实现秒开视频，流畅播放。同时，SYCloud的翻墙节点还可用于游戏加速，具有极低的延迟。

SYCloud的运营时间可以追溯到几年前，是一家经验丰富的翻墙机场服务商。其支持Clash（Stash）、Shadowrocket小火箭等插件，是晴天目前使用时间最长的外网梯子。对于新手用户，SYCloud提供完整的科学上网教程和翻墙插件下载使用指导，24小时客服为用户提供便捷的帮助。

四、疾风云-靠谱梯子推荐

官网地址

推荐指数：⭐⭐⭐⭐

简介：疾风云也是一款非常好用的电脑科学上网梯子，网速稳定快速收费不贵，

五、优信云-小众高速机场

官网地址

推荐指数：⭐⭐⭐⭐

简介：优信云是新兴Shadowsocks翻墙机场服务，提供隧道中转和IPLC线路，节点分布美、法、日、新、港台等地区。解锁Netflix奈飞等各大流媒体，也支持ChatGPT、TikTok、YouTube等平台。

客户端方面，优信云机场做的还是很不错的，基本上所有的主流平台都被涵盖了，包括windows电脑，苹果手机，安卓手机，路由器等等，在机场官网下载他们的插件安装包后就能一键导入使用，而且各个客户端都有攻略，简洁明了，看一眼就会。

六、三番云-按流量计费机场

推荐指数：⭐⭐⭐⭐

简介：三番云是一家提供高速稳定的网络加速服务的高端机场，支持多种协议，如SS/SSR、V2Ray和Trojan，适用于Windows、Android、macOS和Linux等多种操作系统。它的特点包括流媒体视频和音乐的解锁能力，如Netflix、Disney、Hulu、HBO等，支持ChatGPT，并且在稳定性方面表现良好。

这六款能在电脑上稳定流畅使用的科学上网软件魔法工具，同样也适用于手机翻墙浏览外网梯子。是这些年自己用过并且感觉还可以的，收费有高有低，但总体来说都是高性价比且安全好用的，选择适合自己的一款翻墙梯子放心用就是。

2026梯子推荐，翻墙机场，机场推荐，SS/SSR/机场，机场加速器购买，V2ray机场梯子，Trojan机场，Clash节点，好用的便宜梯子，翻墙梯子，VPN梯子，稳定梯子，手机电脑梯子，外网梯子，外贸梯子，油管梯子，AI梯子

5 年没回 CNode 水，发现变了

Lizhooh — Tue, 31 Mar 2026 06:46:15 GMT

之前是挺多人讨论 nodejs，前端这些。现在剩下了 ai，连招聘也只剩下几个。全是梯子广告

小白教程：使用 Coze 构建漂流瓶匿名社交智能体

gooking — Tue, 10 Mar 2026 07:36:07 GMT

本文带你零基础、零代码，快速借助 Coze 平台搭建一个漂流瓶匿名社交智能体，全程操作简单易懂，跟着步骤走就能完成。

核心功能

扔瓶子：用户可通过智能体扔出漂流瓶，可用于日常吐槽、分享每日动态、交流经验、倾诉心情等，实现匿名表达。
捡瓶子：用户可通过智能体随机捡起一个漂流瓶，查看他人分享的内容，感受陌生人的情绪与故事，完成匿名社交互动。

一、准备工作：免费注册 Coze 账号

访问官网免费注册使用：https://www.coze.cn/home

二、创建智能体

进入 Coze 平台后，点击创建智能体，自定义智能体名称（示例：「YY漂流瓶」），创建完成后进入详情页进行后续设置，操作界面如下：

2.1 人设与回复逻辑（直接复制使用）

在智能体「人设与回复」模块，复制以下内容粘贴，无需修改，可直接适配漂流瓶核心功能：

# 角色：

你是YY漂流瓶，主要功能就2个，用户可以丢一个漂流瓶；用户可以捞起一个漂流瓶。

以实现漂流瓶的匿名社交功能。


## 技能：

使用以下技能之前，都需要保证 token 变量有值，没有token或无效，需要先调用插件“apifm / authorize”获取token，获取成功后，输出登录成功的消息，告知当前登录的用户编号

插件参数说明：
- sysUuid 传 sys_uuid 变量的值

###  扔瓶子

如果无法提取到用户经纬度数据，经纬度参数传0，调用插件 bottleMsg_publish 完成扔瓶子，成功后提示用户成功

###  捞瓶子
调用插件 bottleMsg_salvage 

## 限制：
- 只能回复和和上面技能有关的问题

2.2 设置变量

变量设置用于存储用户信息和交互所需参数，步骤如下：

进入「记忆 → 变量」页面，勾选启用 sys_uuid、sys_longitude、sys_latitude 三个系统级变量，分别用于存储用户唯一标识、用户所在经度、用户所在纬度。
添加用户变量：新增 token 变量，用于存储用户登录凭证，保障登录状态与功能正常使用。

变量设置完成后效果如下：

2.3 添加插件

插件是实现漂流瓶核心功能的关键，进入「技能 → 插件」页面，点击「+」按钮，搜索「apifm」，添加以下3个插件，缺一不可：

apifm / authorize
apifm base / bottleMsg_publish
apifm base / bottleMsg_salvage

插件功能说明

apifm / authorize：实现用户自动注册登录功能，生成用户唯一凭证，保障用户记忆和个性化服务正常运行。
apifm base / bottleMsg_publish：实现「扔瓶子」功能，接收用户输入内容并完成漂流瓶发布。
apifm base / bottleMsg_salvage：实现「捡瓶子」功能，随机获取其他用户发布的漂流瓶内容。

插件参数设置

每个插件右侧均有「齿轮」图标，点击即可进入设置界面，按以下要求配置（关键步骤，请勿出错）：

apifm / authorize 插件设置设置界面如下：

sysUuid 参数：直接选中引用系统参数的值（无需手动输入）；
domain：填写自己的api工厂后台专属域名，填写完成后关闭右侧开关（关闭后，AI将直接使用填写的域名）；
merchantKey：填写自己的api工厂后台商户密钥，填写完成后关闭右侧开关（关闭后，AI将直接使用填写的密钥）。

bottleMsg_publish 和 bottleMsg_salvage 插件设置设置界面如下：

token 参数：直接选中引用系统参数的值（无需手动输入）；
domain：填写自己的api工厂后台专属域名，填写完成后关闭右侧开关（关闭后，AI将直接使用填写的域名）。

测试账号说明：如果没有自己的api工厂专属域名和商户密钥，可使用以下测试账号进行调试，直接复制填写即可：
domain： wxapi
merchantKey： 1ecf17ea389ebb5ccd5e258e390d3696

2.4 其他设置

平台默认设置已可满足漂流瓶基本使用需求，无需额外修改；若需优化体验，可按需调整「开场白」「语音音色」「交互风格」等，让智能体更贴合个人需求或业务场景。

三、在线测试与效果预览

设置完成后，可通过平台右侧实时测试窗口，模拟用户「扔瓶子」「捡瓶子」操作，边测试边调整参数，直至智能体回复符合预期，测试界面如下：

四、正式发布

测试无误后，点击页面右上角「发布」按钮，无需审核，发布后即时生效，任何人可直接访问该智能体，进行漂流瓶匿名社交互动。

五、效果展示

5.1 扔瓶子效果

用户发送扔瓶子指令后，智能体接收内容并完成发布，反馈成功提示，效果如下：

5.2 捡瓶子效果

用户发送捡瓶子指令后，智能体随机获取一个漂流瓶内容并展示，效果如下：

总结

本教程全程零代码、零基础，通过 Coze 平台快速搭建漂流瓶匿名社交智能体，核心步骤可总结为「注册账号 → 创建智能体 → 配置人设与变量 → 添加插件并设置 → 测试 → 发布」。整个过程操作简单，无需专业技术，借助 Coze 平台的可视化操作和插件功能，即可快速实现匿名漂流瓶的核心社交功能。测试账号可满足调试需求，若需长期使用，建议注册自己的api工厂账号，获取专属域名和商户密钥，保障功能稳定运行。后续可根据个人需求，优化智能体的交互风格、开场白等细节，提升用户体验。无论是用于个人兴趣交流，还是小型社交场景搭建，这个智能体都能快速落地使用。

10 分钟极速上手：使用 Coze 快速搭建可商用级智能客服智能体

gooking — Sun, 08 Mar 2026 10:19:59 GMT

本文带你零基础、零代码，用 Coze 平台快速搭建一个可直接上线使用的智能客服智能体。你只需在本文基础上优化人设、完善知识库，即可快速落地产品级客服能力。

核心功能

自动理解用户问题，基于知识库精准回复
未知问题自动转为用户反馈并后台保存，支持微信 / 钉钉 / 邮件实时通知，持续迭代知识库

一、准备工作：免费注册 Coze 账号

访问官网免费注册使用：https://www.coze.cn/home

二、创建专属知识库

根据业务需求自定义知识库名称，例如「智能客服知识库」。

Coze 支持绝大多数文档格式，也可直接填入在线文档 URL 自动导入。

测试知识库示例（可直接复制）

1）质量检查和软件测试有什么区别？
QA（质量保证）关注软件开发过程的质量；软件测试确保最终产品功能符合用户需求。

2）什么是 Testware？
Testware 是测试用例、测试数据、测试计划等测试相关工件。

3）构建和发布之间有什么区别？
构建：开发团队提供给测试团队的安装包。
发布：测试/开发团队交付给客户的正式安装包。

4）SQA 团队在自动化中面临哪些挑战？
自动化工具掌握、脚本复用、用例适配性、复杂用例自动化。

5）什么是漏洞泄漏和漏洞释放？
错误发布：已知缺陷但优先级低，先行交付测试。
错误泄漏：客户发现测试团队未检出的缺陷。

6）什么是数据驱动测试？
从 csv、excel 等文件读取测试数据，在被测系统上自动化执行。

三、创建智能客服智能体

自定义智能体名称，例如「智能客服智能体」。

3.1 人设与回复逻辑（直接复制使用）

# 角色
你叫小美，是一位资深QA专家，有任何QA方面的问题都可以咨询我。

## 回答主题简介
我是杭州飞的高科技公司的客服人员，帮你提供在线咨询服务。

## 工作流程
### 步骤一：问题理解与回复分析
1. 认真理解从知识库中召回的内容和用户输入的问题，判断是否为有效答案。
2. 若问题模糊、信息不足，主动追问用户，确保准确理解需求。

### 步骤二：回答用户问题
1. 与QA主题无关的问题，礼貌拒绝回答。
2. 知识库无相关内容时，统一回复：
“对不起，我已学习的知识中不包含问题相关内容，暂时无法提供答案。如果你有相关问题，请给我们留言，我们将记录并及时处理。”
并引导用户留下联系方式，通过 comment_add 插件提交反馈，返回记录编号作为回执。
3. 有匹配知识时，仅提取相关内容，整理为**精准、简洁**的答案回复。
4. 按判断返回对应文档链接，无需说明来源。

## 限制
1. 禁止回答与QA无关的问题。
2. 统一使用Markdown格式回复。

3.2 引入知识库

在中间栏「知识」点击 +，绑定已创建的知识库。

用户提问时，智能体会自动检索知识并整理回复。

3.3 添加留言反馈插件

在「技能 → 插件」点击 +，搜索 apifm，添加 apifm common / comment_add。

作用：

智能体无法回答时，自动保存用户问题到后台

返回反馈编号给用户

支持微信 / 钉钉 / 邮件实时通知管理员，用于迭代知识库

3.4 其他设置

默认即可满足使用；可按需调整开场白、语音音色、交互风格等，让智能体更贴合业务。

四、在线测试与效果预览

右侧为实时测试窗口，边测边调，直到回复符合预期。

五、正式发布

点击右上角「发布」，无需审核、即时生效，任何人可直接访问使用。

六、效果展示

场景 1：知识库匹配 → 精准回复

场景 2：无知识 → 自动保存反馈并通知

总结

借助 Coze 平台，我们仅用不到 10 分钟就完成了从注册、建库、配置到发布的全流程，快速拥有了一个具备自动问答、未知问题反馈、实时通知、可直接商用的智能客服智能体。整套方案零代码、低成本、易维护，既能大幅降低人工客服压力，又能通过用户反馈持续迭代知识库，让智能体越用越聪明。无论是个人测试、团队效率提升还是企业业务落地，这套流程都具备极强的实用性与可复制性，是快速实现 AI 客服落地的最佳实践之一。

基于Uniapp的会员卡储值消费系统开发实践

gooking — Mon, 02 Mar 2026 09:01:22 GMT

在餐饮、校园、社区小店等线下消费场景中，会员卡（饭卡）储值消费系统是提升运营效率、沉淀私域用户的核心工具。很多中小商户想搭建一套适配自身场景的储值消费系统，却常常被复杂的开发流程、高昂的定制成本拦住脚步。今天就从实操角度，聊聊如何基于 Uniapp 快速搭建一套轻量化的会员卡储值消费系统，兼顾实用性与易用性。为什么选择 Uniapp 开发储值消费系统？ Uniapp 的跨端特性是核心优势 —— 一套代码可同时适配微信小程序、App、H5 等多端，无需为不同终端单独开发，大大降低了开发和维护成本。对于聚焦线下消费场景的储值消费系统来说，多端适配能覆盖用户的不同使用习惯：商户可通过后台管理，用户则能通过小程序快速完成充值、消费，无需下载额外 App，体验更轻量化。储值消费系统的核心功能设计与实现思路一套实用的会员卡储值消费系统，无需追求 “大而全”，聚焦核心场景即可满足中小商户的需求，核心可围绕这几个维度设计：

自助充值与消费：减少人工干预，提升效率线下消费场景中，人工充值、记账不仅效率低，还容易出现错账、漏账问题。在系统设计时，可开发自助充值模块 —— 用户通过小程序绑定会员卡后，自主选择充值金额、支付方式完成储值；消费时只需出示核销码或刷卡，系统自动扣除对应金额，全程无需店员操作。同时，系统需内置消费规则校验，比如最低消费、储值余额不足提醒等，既保障商户资金安全，也让用户消费更顺畅。
会员折扣体系：增强用户粘性单纯的储值功能难以留住用户，会员等级与折扣体系是提升复购的关键。在系统中可设计分级会员机制，比如根据储值金额或消费次数划分普通会员、银卡会员、金卡会员，不同等级对应不同消费折扣。开发时可将折扣规则配置化，商户无需修改代码，就能在后台调整不同等级的折扣比例、生效时间，适配节日促销、日常优惠等不同场景。
消费记录溯源：透明化提升信任用户对储值资金的 “安全感”，来自清晰的消费明细。系统需实现消费、储值记录的实时查询功能，每条记录包含时间、金额、消费门店、交易类型等信息，用户可随时查看，商户也能通过后台导出明细对账。技术层面可通过数据库结构化存储交易数据，搭配前端列表渲染和筛选功能，让记录查询更便捷。
动态消息通知：重要信息不遗漏商户的优惠活动、系统公告、用户的充值到账提醒、消费通知等，都需要及时触达。系统可集成消息推送功能，支持公告置顶、精准推送，比如用户储值后自动发送到账提醒，商户发布新优惠时推送给对应等级的会员，提升信息触达效率。轻量化系统的落地实践：兼顾实用性与易维护性中小商户的系统需求核心是 “好用、好维护”，因此在开发时需避免过度复杂的架构设计：前端基于 Uniapp 的组件化开发，复用充值、消费、记录查询等核心组件，降低开发成本；后端采用轻量化框架，聚焦数据存储、交易逻辑校验，无需搭建复杂的分布式架构；界面设计贴合线下消费场景的使用习惯，简化操作流程，无论是店员还是用户，无需培训就能快速上手。这套基于 Uniapp 开发的会员卡储值消费系统，正是围绕上述思路打造 —— 聚焦线下消费的核心痛点，用轻量化的技术方案实现自助储值、会员折扣、消费溯源、消息通知等核心功能，既满足商户数字化管理的需求，也让用户的充值消费体验更便捷。开源项目参考：站在巨人的肩膀上开发如果想快速落地这套系统，无需从零编写代码，可参考以下开源项目，结合自身场景做二次开发：

GITHUB 码云镜像地址 GitCode

这些开源项目提供了完整的 Uniapp 前端代码和后端逻辑，涵盖了储值、消费、会员管理等核心功能，可直接部署试用，也能根据商户的具体需求（比如增加门店管理、多端核销等）进行定制开发。总结搭建一套轻量化的会员卡储值消费系统，核心是聚焦线下消费的真实场景，用适配的技术方案解决效率、信任、用户粘性等核心问题。Uniapp 的跨端优势让系统适配成本更低，而开源项目则能大幅缩短开发周期，中小商户无需投入高昂成本，也能实现线下消费的数字化管理，助力私域流量运营和客户留存。

【北京/西安】Node.js 后端开发工程师

ZhiGang-Fang — Mon, 02 Mar 2026 06:26:25 GMT

岗位职责:

负责后端系统的开发与维护，保障系统稳定运行；
参与系统功能模块设计及接口开发，提升系统性能与可扩展性；
协同团队完成项目开发任务，推动项目按时交付；
统招本科学历以上；

任职资格 1.熟练掌握 TypeScript 语言，能够编写类型安全的代码. 2.熟练掌握 Node.js 或 Bun.js 环境，能够使用 Express、Koa、NestJS 等框架进行后端开发。 3.至少掌握一种ORM框架，如 Sequelize、TypeORM、Prisma等。 4.熟练掌握数据库设计和操作，MySQL、PostgreSQL、Redis、Mongodb 等数据库。 5.熟悉 RESTfuI API 设计，能够设计和实现高效的API接囗, 6.至少有一个完整的0~1后端项目经验，能够独立完成项目开发和部署。 7.熟练掌握 WebSocket、HTTP等协议，能够实现实时通信功能。 8.熟悉 Linux 操作系统常用操作命令，能够进行服务器配置和维护, 9.熟蒸微服务架构，能够使用Docker、kubernetes等容器技术。 10.熟蒸常用消息队列中间件，如 RabbitMQ、Kafka 等。

加分项: 1.有前端React开发经验，使用过至少一种前端主流框架，能够与前端进行良好协作 2.有大型互联网公司的开发经验，能够熟悉大型公司的开发规范和流程。 3.拥有高并发和高负载系统的开发经验。

工作地点：北京 & 西安

现诚邀各位人才投递简历，目前开放岗位如下：后端 5 个、架构师 1 个，欢迎自荐或推荐。简历投递：zhigangf@globalcrown.com.cn

WorldEnd.ai —— AI 生成的世界末日预言

nswbmw — Mon, 02 Mar 2026 05:37:26 GMT

WorldEnd.ai 利用最新的大模型来预测世界末日可能出现的各种形式 —— 分析全球风险，并对人类的长期发展轨迹做出发人深省的预测。这并非为了制造恐慌，而是为了探索、提升风险意识，并就未来展开更深入的对话。

Website: https://worldend.ai GitHub: https://github.com/nswbmw/worldend.ai

屏幕截图

技术栈

Hoa - 轻量级 Web 框架
Cloudflare Workers - 边缘计算平台
Cloudflare KV - 缓存
Cloudflare D1 - 数据库
Cloudflare R2 - 存储

听歌用铜钟 Tonzhon，写 Node.js 牛逼哄哄！

enzeberg — Fri, 23 Jan 2026 05:50:43 GMT

铜钟 Tonzhon 音乐平台官网：https://tonzhon.whamon.com/

铜钟 Tonzhon 是一个主打「听歌」功能的 web app, 致力于为人们带来卓越的听歌体验。铜钟有着丰富的音乐资源，干净清爽的 UI 和方便的交互。在铜钟上，你不仅可以方便地找到并聆听你喜欢的歌曲，还可以将它们保存下来。

铜钟上的一切内容都是与音乐直接相关的，没有广告，社交和直播，不会干扰你的听歌心情。在铜钟上，你可以沉浸到属于你自己一个人的那片天地，忘却世间的纷纷扰扰…

铜钟 Tonzhon 也推出了 App，小程序和铜钟 for Mac or Windows，都在 https://tonzhon.whamon.com 的侧边栏里，欢迎大家试用。

GitHub: https://github.com/enzeberg/tonzhon-music

欢迎大家提需求、提 issue、提 PR…

[杭州] 阿里云数据可视化 DataV 团队招聘 AI 应用开发工程师

rockdai — Fri, 23 Jan 2026 02:36:34 GMT

职位描述

负责 AI 应用与 Agent 工程平台的服务端研发，构建支撑多模型、多智能体、混合云场景部署的 AI 平台基础能力。
推动 AI 能力的工程化，面向领域 Agent 场景进行可行性分析和原型验证，支撑 DataV 的智能化演进。
负责 DataV 核心服务的技术方案设计、开发与维护，保障系统在高并发、高可用场景下的稳定性与性能。

职位要求

扎实的服务端工程基础，3 年以上 Node.js / Java Web 开发经验，具备良好的系统设计能力与代码质量意识，能够独立负责中大型系统或核心模块的架构设计与落地。
对 LLM 与 AI 应用开发有实际理解与实践，理解 LLM 的基本原理、能力边界，具备将 AI 能力工程化的经验。
有 AI 工程平台、Agent 框架相关经验，理解 Agent 架构与设计思想。自研或使用过主流的开源 AI 框架，有领域 Agent 或复杂 Agent 场景经验优先。
具备高并发、高可用系统设计与问题排查经验，有云原生、K8S 等相关经验，能够在稳定性、性能与成本之间做出合理技术决策。
具备良好的跨团队沟通与协作能力，能够推动技术方案从设计到落地。对 AI 工程与服务端技术保持学习和技术进取心，有开源项目经验优先、有 AI Infra 相关经验优先。

联系： basi.dwz@alibaba-inc.com

也可以直接在线投递简历： https://careers.aliyun.com/off-campus/position-detail?lang=zh&positionId=100003263001&trace=qrcode_share

最近 skills 很火，我从收集的6w+ agnet-skills中精选出 1000+好用/实用/有趣的 claude code skills，今天更新中

xiaolige — Wed, 21 Jan 2026 04:28:32 GMT

最近 Claude Code skills 很火，对我来说和 agnet 、扣子没啥区别。能火我感觉主要是扩大了人群使用范围，小白也上手。每个行业都有 N 多个 skills ，想着做一个导航网站，把鱼龙混杂的 skills 精选出来。工具目的是解决问题，实用好用才是王道。去年 12 月注册的域名，纠结拖延快一个月，终于第一版打磨 5 天，要上线了。好多功能还没加，还有很多 BUG ，希望大家能多给给意见。

下面体验： Agent – Claude Code skills 精选导航站

全栈开发在线接单

it_zhiijia — Thu, 08 Jan 2026 11:17:01 GMT

全栈开发在线接单

专注解决前后端各类开发问题，承接多端定制开发与BUG修复，支持远程一对一技术服务，先做满意再付款，诚信合作。

前端精通 Vue2/Vue3、React、React Native、Uniapp、Taro 等主流框架，可定制 PC 网页、小程序、APP 及 Electron 桌面端；熟练运用 Nuxt.js、Next.js 进行服务端渲染开发，掌握 WebGL 技术实现交互特效。

服务端擅长 Java、Nest.js、Node.js、Golang 技术栈，可承接后端架构搭建、接口开发与管理系统开发。

合作流程规范，可协助梳理需求、出具专属技术方案，高效响应各类开发需求，欢迎咨询洽谈。

为了写代码时省点钱，我撸了个 AI 中转站比价网站 getcheapai.com

lmk123 — Sun, 04 Jan 2026 03:45:25 GMT

现在应该都是用 AI 写代码了，然后为了节约成本，我经常找便宜的 AI 中转站，然后发现每家的计费逻辑都不一样：有的是 1:7 兑换，有的是 1:1 积分制，有的倍率是 1，有的又是 3。每次选的时候，光折算真实价格就要来回计算对比，非常心累。

于是我自己整了个 AI 中转站比价网站 getcheapai.com

无论中转站计费方式如何，我全部统一换算成了每百万 Token 的真实人民币价格
目前收录了十几家主流或者知名的中转站
每 6 小时更新一次价格确保实时性

站内的中转站链接带有我的 AFF，因为这个网站跑在 Cloudflare Workers 里，每个月要花 5 美元。如果介意的话，可以复制链接去掉 AFF。

一个神奇的在线代码执行平台：RunCode

openrc — Thu, 11 Dec 2025 07:51:19 GMT

多语言在线代码执行平台RunCode，支持 60+ 种编程语言，AI辅助编程，智能混合执行架构，即写即运行。

智能混合执行 - 浏览器 WASM + 云端容器，自动选择最佳执行方式
60+ 语言支持 - Python, JavaScript, TypeScript, C/C++, Rust, Go, Java, Haskell, Shell 等
⚡ 即时执行 - 热门语言零延迟，浏览器直接运行
现代 UI - shadcn/ui + Tailwind CSS
专业编辑器 - Monaco Editor
主题切换 - 深色/浅色模式

如何不踩坑选 VPS？我自己的经验分享

daoke — Thu, 11 Dec 2025 06:11:06 GMT

这些年折腾云服务器踩过不少坑：实名卡审核、账号风控、线路不稳、价格虚高……尤其做跨境/自动化/部署项目的，真的经不起服务商“突然抽风”。

后来总结出一个最稳的方案：

用大厂（Aliyun/AWS）的稳定性，但通过更快、更灵活的渠道开通。不需要实名、不等审核、价格也比官网低很多，还能用加密货币避风控。

我们团队现在长期用的就是这种方式，跑项目一年多都很稳，所以分享给需要低风控、快开通、稳定线路的技术同学参考：

BaseCloud — 大厂云的快速免实名入口 https://basecloud.cc

不是硬推，只是减少大家踩坑的成本。技术人时间最贵。

Google Gmail RCS TG大量实卡接码及各种冷门项目支持量大用户api对接

daoke — Thu, 27 Nov 2025 05:07:56 GMT

做跨境团队最头疼的就是支付问题：广告账户被拒付、开卡和充值流程繁琐、账单不清晰、多平台支付难管理……

**VCC虚拟信用卡（Visa/万事达）**完美解决这些问题： • 即开即用：免实名，快速生成，多成员同时使用 • 多平台支持：FB/Google/TikTok广告、PayPal、AWS、域名、订阅全覆盖 • 机器人 + 后台：批量开卡、查账、充值自动化，团队管理更高效 • 账单透明：结算清楚，避免财务混乱 • 支持加密货币：充值快速，跨境支付无障碍 • 性价比高：稳定可靠，长期使用更划算

一句话总结：跨境广告、电商或独立站团队，有了 VCC，支付更稳定、高效、透明，真的值得用。产品频道：https://t.me/+vCIqSgwsBDxiODIy 联系客服：@KaiDe66BOt

Hoa - 一个极简 Web 框架

nswbmw — Tue, 25 Nov 2025 09:36:47 GMT

我使用 Koa 很多年了，一直很喜欢它简洁的设计哲学。近几年在 Cloudflare Worker 上开发较多，接触到了 Hono。Hono 也是一个不错的框架，但在深入使用后，我对它的一些设计理念并不是很认同，于是萌生了自己造个轮子的想法。

我为新框架设定了三条核心原则：

微内核架构：与 Koa 类似，保留了洋葱模型的中间件设计，同时还补充了插件系统
符合直觉的 API 设计：摒弃 Koa 的 delegates 思路，API 严格区分 ctx/ctx.req/ctx.res，更加符合语义
环境无关性：可在 Node.js、Bun、Deno 以及 Cloudflare Worker、Vercel 等边缘环境运行

于是 Hoa 诞生了。目前我跟另一个维护者已经为 Hoa 补充了 30+ 常用中间件，我也已经将手头大部分项目从 Koa 迁移至 Hoa。今天分享出来，希望更多人去使用，也期待收到更多反馈，共同把 Hoa 框架打磨得更好。

GitHub: hoa
官网: hoa-js.com

特点

⚡ Minimal - Only ~4.4KB (gzipped).
Zero Dependencies - Built on modern Web Standards with no external dependencies.
️ Highly Extensible - Features a flexible extension and middleware system.
Standards-Based - Designed entirely around modern Web Standard APIs.
Multi-Runtime - The same code runs on Cloudflare Workers, Deno, Bun, Node.js, and more.
✅ 100% Tested – Backed by a full-coverage automated test suite.

安装

npm i hoa --save

快速开始

import { Hoa } from 'hoa'
const app = new Hoa()

app.use(async (ctx, next) => {
  ctx.res.body = 'Hello, Hoa!'
})

export default app

License

MIT

VonaJS: I18n如何支持Swagger多语言

zhennann — Wed, 12 Nov 2025 02:25:38 GMT

VonaJS提供的I18n支持模块化体系。每个业务模块都可以单独提供自己的 I18n 语言资源。我们先了解I18n的一般用法，然后再看看如何支持Swagger多语言

初始化代码骨架

我们先在模块demo-student中初始化I18n的代码骨架

1. Cli命令

$ vona :init:locale demo-student

2. 菜单命令

右键菜单 - [模块路径]: `Vona Init/Locale`

定义语言资源

以模块demo-student为例，定义模块的语言资源：

英文

src/module/demo-student/src/config/locale/en-us.ts

export default {
+ StudentName: 'Student Name',
};

中文

src/module/demo-student/src/config/locale/zh-cn.ts

export default {
+ StudentName: '学生名称',
};

使用语言资源

可以通过 Scope 实例提供的locale对象获取模块的语言资源，支持类型化提示

class ControllerStudent {
  @Web.get('test')
  test() {
    // use current locale
    const message1 = this.scope.locale.StudentName();
    // use locale en-us
    const message2 = this.scope.locale.StudentName.locale('en-us');
    // use locale zh-cn
    const message3 = this.scope.locale.StudentName.locale('zh-cn');
    console.log(message1, message2, message3);
  }
}

跨模块使用语言资源

class ControllerStudent {
  @Web.get('test')
  test() {
    // use current locale
    const message1 = this.$scope.demoStudent.locale.StudentName();
    // use locale en-us
    const message2 = this.$scope.demoStudent.locale.StudentName.locale('en-us');
    // use locale zh-cn
    const message3 = this.$scope.demoStudent.locale.StudentName.locale('zh-cn');
    console.log(message1, message2, message3);
  }
}

覆盖语言资源

可以使用项目级别的语言资源覆盖模块级别的语言资源

英文

src/backend/config/locale/en-us.ts

export default {
  modules: {
+   'demo-student': {
+     StudentName: 'Student Name!',
+   },
  },
};

中文

src/backend/config/locale/zh-cn.ts

export default {
  modules: {
+   'demo-student': {
+     StudentName: '学生名称!',
+   },
  },
};

当前locale

1. 获取当前locale

const locale = this.ctx.locale;

2. 设置当前locale

this.ctx.locale = 'en-us';

3. 获取缺省locale

const localeDefault = this.$scope.i18n.config.defaultLocale;

获取当前locale的规则

当用户访问后端 API 时，后端会自动根据规则获取当前 locale

1. 模块配置

I18n 是由模块 a-i18n 提供的核心能力，可以在 App config 中修改模块的配置：

src/backend/config/config/config.ts

// modules
config.modules = {
  'a-i18n': {
    defaultLocale: 'en-us',
    queryField: 'x-vona-locale',
    headerField: 'x-vona-locale',
    cookieField: 'locale',
  },
};

名称	说明
defaultLocale	Default locale
queryField	从request query中获取当前locale，query key默认为`x-vona-locale`
headerField	从request header中获取当前locale，header key默认为`x-vona-locale`
cookieField	从request cookie中获取当前locale，cookie key默认为`locale`

2. 规则次序

系统按以下次序，依次判断当前 locale

queryField > headerField > cookieField > Header: Accept-Language > defaultLocale

添加新语言

VonaJS 默认提供了两个语言:en-us和zh-cn。下面演示如何添加新语言zh-tw

1. 添加类型定义

采用接口合并机制添加新语言的类型定义

在 VSCode 编辑器中，输入代码片段recordlocale，自动生成代码骨架:

declare module 'vona' {
  export interface ILocaleRecord {
    : never;
  }
}

调整代码，然后添加zh-tw

declare module 'vona' {
  export interface ILocaleRecord {
+   'zh-tw': never;
  }
}

2. 添加语言资源

新建语言文件zh-tw.ts，然后添加语言资源

src/module/demo-student/src/config/locale/zh-tw.ts

export default {
  StudentName: '學生名稱',
};

复数

1. 定义语言资源

src/module/demo-student/src/config/locale/en-us.ts

export default {
+ TestApples_: '%d apples',
+ TestApples_0: 'no apples',
+ TestApples_1: 'one apple',
};

src/module/demo-student/src/config/locale/zh-cn.ts

export default {
+ TestApples_: '%d个苹果',
+ TestApples_0: '没有苹果',
};

2. 使用语言资源

this.ctx.locale = 'en-us';
const apple0 = this.scope.locale.TestApples_(0);
const apple1 = this.scope.locale.TestApples_(1);
const apple2 = this.scope.locale.TestApples_(2);
console.log(`${apple0}, ${apple1}, ${apple2}`);

控制台输出如下：

no apples, one apple, 2 apples

TestApples_: 缺省语言资源。语言资源添加后缀_，可以提示开发者该语言资源需要传入参数
TestApples_{n}: 可以针对任何具体的n提供独立的语言资源。系统在进行语言翻译时，如果找不到具体n的语言资源，就使用缺省语言资源TestApples_

复数: 多参数

如果语言资源支持多参数，那么可以明确指定哪个参数支持复数

1. 定义语言资源

src/module/demo-student/src/config/locale/en-us.ts

export default {
+ TestNameApples_: '%s has %d apples',
+ TestNameApples_0_1: '%s has no apples',
+ TestNameApples_1_1: '%s has one apple',
};

src/module/demo-student/src/config/locale/zh-cn.ts

export default {
+ TestNameApples_: '%s有%d个苹果',
+ TestNameApples_0_1: '%s没有苹果',
};

2. 使用语言资源

this.ctx.locale = 'en-us';
const apple0 = this.scope.locale.TestNameApples_('Tom', 0);
const apple1 = this.scope.locale.TestNameApples_('Tom', 1);
const apple2 = this.scope.locale.TestNameApples_('Tom', 2);
console.log(`${apple0}, ${apple1}, ${apple2}`);

控制台输出如下：

Tom has no apples, Tom has one apple, Tom has 2 apples

TestNameApples_: 缺省语言资源。语言资源添加后缀_，可以提示开发者该语言资源需要传入参数
TestNameApples_{n}_{ordinal}: ordinal代表参数序数

Swagger/Openapi

VonaJS 提供了一组工具函数，为 Swagger/Openapi 实现 I18n 国际化

比如，为EntityStudent的字段name提供国际化的title信息

1. $localeScope

在设置字段 title 信息时，要使用语言资源FullKey。在实际生成 Swagger/Openapi 元数据时，系统会自动将语言资源FullKey翻译为指定的语言

+ import { $localeScope } from 'vona';

class EntityStudent {
+ @Api.field(v.title($localeScope('demo-student', 'Name')))
  name: string;
}

v.title: 设置 title 信息
$localeScope: 传入模块名称和语言资源Key，从而生成语言资源FullKey: demo-student::Name

2. $locale

VonaJS 还提供了一个简化的工具函数$locale

+ import { $locale } from '../.metadata/index.ts';

class EntityStudent {
+ @Api.field(v.title($locale('Name')))
  name: string;
}

$locale: 传入语言资源Key，从而生成语言资源FullKey: demo-student::Name
- 每个模块都提供了$locale 函数，因此，使用本模块的$locale 函数就可以取得模块名称

资源

Github：https://github.com/vonajs/vona
文档：https://vona.js.org

VonaJS业务抽象层: 验证码体系

zhennann — Mon, 03 Nov 2025 01:31:31 GMT

验证码体系

VonaJS的内置模块a-captcha提供了通用的验证码体系，使用Captcha Provider支持各种验证码方式，并且使用Captcha Scene支持不同场景的验证码使用策略

特性

Captcha Provider：使用Captcha Provider支持各种验证码方式，如：文字图形验证码、短信验证码，等等
Captcha Scene：使用Captcha Scene支持不同场景的验证码使用策略。比如，在某个场景下，可以在多个 Captcha Provider 中进行轮替，或者根据用户状态使用不同难度的 Captcha Provider，等等
立即验证：前端可以对用户输入的验证码进行立即验证。立即验证之后在提交表单时仍然要进行二次验证
表单验证：前端可以将用户输入的验证码与表单数据一起发往后端验证

bean.captcha

模块a-captcha提供了全局 Bean bean.captcha，可以通过统一的方式使用所有 Provider/Scene 提供的验证码能力

模块a-captchasimple提供了一个 Provider a-captchasimple:imageText，基于svg-captcha实现文字图片的验证码能力

模块a-captchasimple提供了一个 Scene a-captchasimple:simple。该 Scene 只使用一个 Provider，即a-captchasimple:imageText

下面演示如何使用模块a-captchasimple提供的验证码能力

1. create

// create captcha
const captcha = await this.bean.captcha.create('a-captchasimple:simple');

返回值类型：ICaptchaData

export interface ICaptchaData {
  id: string;
  provider: keyof ICaptchaProviderRecord;
  token?: unknown;
  payload: unknown;
}

名称	说明
id	本次验证码数据的id标识
provider	本次验证码所使用的Provider名称
token	本次验证码数据的token，用于比对用户输入值。在开发环境可以通过修改系统配置，将token发往前端，用于调试
payload	本次验证码的负载内容，不同的Provider有不同的payload类型

2. refresh

// refresh captcha
const captchaNew = await this.bean.captcha.refresh(captchaId, 'a-captchasimple:simple');

如果一个 Scene 配置了多个 Provider，那么在刷新 capthca 时可以基于策略选取不同的 Provider

3. verify

// verify captcha
const passed = await this.bean.captcha.verify(captchaId, '1234', 'a-captchasimple:simple');

4. verifyImmediate

前端可以对用户输入的验证码进行立即验证。立即验证之后在提交表单时仍然要进行二次验证

// verifyImmediate captcha
const tokenOrFalse = await this.bean.captcha.verifyImmediate(captchaId, '1234');

如果立即验证失败，返回false
如果立即验证成功，返回二次token
前端需要将二次token与表单数据一起发往后端进行二次验证

interceptor.captchaVerify

模块a-captcha提供了一个局部拦截器a-captcha:captchaVerify，可以针对 API 启用验证码校验

src/suite/a-home/modules/home-user/src/controller/passport.ts

import { Core } from 'vona-module-a-core';

class ControllerPassport {
  @Web.post('login')
+ @Core.captchaVerify({ scene: 'a-captchasimple:simple' })
  async login(@Arg.body() data) {}
}

@Core.captchaVerify: 用于使用局部拦截器a-captcha:captchaVerify，传入需要使用的 Scene 名称
该拦截器支持表单验证和二次验证

Captcha API

模块a-captcha提供了一组开箱即用的 Captcha API，对bean.captcha的能力进行了封装

src/suite-vendor/a-vona/modules/a-captcha/src/controller/captcha.ts

名称	说明
create
refresh
verifyImmediate

为何没有提供verifyAPI？

因为bean.captcha.verify方法用于局部拦截器a-captcha:captchaVerify

参数配置

可以在 App Config 中修改模块a-captcha的参数配置

src/backend/config/config/config.ts

// modules
config.modules = {
  'a-captcha': {
    captcha: {
      showToken: false,
    },
    captchaProvider: {
      ttl: 20 * 60 * 1000,
      ttlSecondary: 20 * 60 * 1000,
    },
  },
};

名称	说明
captcha.showToken	是否显示token。如果为true，就将token发往前端，用于调试。默认为false
captchaProvider.ttl	captcha token的过期时间
captchaProvider.ttlSecondary	二次token的过期时间

资源

Github：https://github.com/vonajs/vona
文档：https://vona.js.org/

写了N个AI应用，我开发了个极简的LLM提供商编辑器，每个AI应用都用得上

MatrixAge — Thu, 30 Oct 2025 09:54:36 GMT

Github： https://github.com/MatrixAges/ai-sdk-panel Demo： https://stack.matrixages.com/ai-sdk-panel

做过好几个 AI 应用，发现自己一直在重复造轮子，为每个 AI 应用都开发一套 LLM 提供商编辑器。虽然大部分代码都是复制粘贴过往项目，但也不好管理，于是每天抽出一点时间，花了几个星期把 AI SDK Panel 这个公共组件给开发出来了。

项目包含全流程的 e2e 测试，基于最新的 Vitest 4.0 Browser Mode 进行测试构建，请放心使用，同时提供了强大的定制化能力，多语言，自定义代理商等。

VonaJS AOP编程大杀器：外部切面

zhennann — Mon, 27 Oct 2025 01:49:12 GMT

在VonaJS框架中，AOP编程包括三方面：控制器切面、内部切面和外部切面。

控制器切面: 为 Controller 方法切入逻辑，包括：Middleware、Guard、Interceptor、Pipe和Filter
内部切面: 在 Class 内部，为任何 Class 的任何方法切入逻辑，包括：AOP Method和魔术方法
外部切面: 在不改变 Class 源码的前提下，从外部为任何 Class 的任何方法切入逻辑

VonaJS中的外部切面，可以类比于Spring Boot中的AOP切面和AOP织入概念。VonaJS的外部切面不需要什么前置通知、后置通知、异常通知和环绕通知，只需提供一个同名方法就可以了。之所以可以这么简洁，是因为使用了洋葱圈模型。

此外，VonaJS的外部切面支持完整的类型推断与智能代码提示，开发体感比Spring Boot优雅太多。

下面，我们就来考察一下VonaJS的外部切面到底是个什么样？为什么可以成为AOP编程的大杀器

创建目标Class

可以针对任何 Class 实现外部切面。下面，以 Service 为例，在模块 demo-student 中创建一个 Service test，代码如下：

@Service()
export class ServiceTest extends BeanBase {
  private _name: string;

  protected __init__() {
    this._name = '';
  }

  protected async __dispose__() {
    this._name = '';
  }

  get name() {
    return this._name;
  }

  set name(value) {
    this._name = value;
  }

  actionSync(a: number, b: number) {
    return a + b;
  }

  async actionAsync(a: number, b: number) {
    return Promise.resolve(a + b);
  }
}

创建外部切面

接下来，创建一个外部切面log，为 Class ServiceTest的属性和方法分别提供扩展逻辑

1. Cli命令

$ vona :create:bean aop log --module=demo-student

2. 菜单命令

右键菜单 - [模块路径]: Vona Aspect/Aop

AOP定义

import { BeanAopBase } from 'vona';
import { Aop } from 'vona-module-a-aspect';

@Aop({ match: 'demo-student.service.test' })
export class AopLog extends BeanAopBase {}

@Aop: 此装饰器用于实现外部切面
match: 用于将 Class AopLog与 Class ServiceTest关联，ServiceTest的 beanFullName 是demo-student.service.test

名称	类型	说明
match	string\|regexp\|(string\|regexp)[]	针对哪些 Class 启用

切面：同步方法

为ServiceTest#actionSync输出运行时长

在 VSCode 编辑器中，输入代码片段aopactionsync，自动生成代码骨架:

action: AopAction<ClassSome, 'action'> = (_args, next, _receiver) => {
  return next();
};

调整代码，然后添加 log 逻辑

actionSync: AopAction<ServiceTest, 'actionSync'> = (_args, next, _receiver) => {
  const timeBegin = Date.now();
  const res = next();
  const timeEnd = Date.now();
  console.log('actionSync: ', timeEnd - timeBegin);
  return res;
};

actionSync: 提供与ServiceTest同名的方法actionSync

切面：异步方法

为ServiceTest#actionAsync输出运行时长

在 VSCode 编辑器中，输入代码片段aopaction，自动生成代码骨架:

action: AopAction<ClassSome, 'action'> = async (_args, next, _receiver) => {
  return await next();
};

调整代码，然后添加 log 逻辑

actionAsync: AopAction<ServiceTest, 'actionAsync'> = async (_args, next, _receiver) => {
  const timeBegin = Date.now();
  const res = await next();
  const timeEnd = Date.now();
  console.log('actionAsync: ', timeEnd - timeBegin);
  return res;
};

actionAsync: 提供与ServiceTest同名的方法actionAsync

切面：getter

为ServiceTest#get name输出运行时长

在 VSCode 编辑器中，输入代码片段aopgetter，自动生成代码骨架:

protected __get_xxx__: AopActionGetter<ClassSome, 'xxx'> = function (next, _receiver) {
  const value = next();
  return value;
};

调整代码，然后添加 log 逻辑

protected __get_name__: AopActionGetter<ServiceTest, 'name'> = function (next, _receiver) {
  const timeBegin = Date.now();
  const value = next();
  const timeEnd = Date.now();
  console.log('get name: ', timeEnd - timeBegin);
  return value;
};

__get_name__: 对应ServiceTest的 getter 方法get name

切面：setter

为ServiceTest#set name输出运行时长

在 VSCode 编辑器中，输入代码片段aopsetter，自动生成代码骨架:

protected __set_xxx__: AopActionSetter<ClassSome, 'xxx'> = function (value, next, _receiver) {
  return next(value);
}

调整代码，然后添加 log 逻辑

protected __set_name__: AopActionSetter<ServiceTest, 'name'> = function (value, next, _receiver) {
  const timeBegin = Date.now();
  const res = next(value);
  const timeEnd = Date.now();
  console.log('set name: ', timeEnd - timeBegin);
  return res;
};

__set_name__: 对应ServiceTest的 setter 方法set name

切面：`init`

为ServiceTest#__init__输出运行时长

在 VSCode 编辑器中，输入代码片段aopinit，自动生成代码骨架:

protected __init__: AopActionInit<ClassSome> = (_args, next, _receiver) => {
  next();
};

调整代码，然后添加 log 逻辑

protected __init__: AopActionInit<ServiceTest> = (_args, next, _receiver) => {
  const timeBegin = Date.now();
  next();
  const timeEnd = Date.now();
  console.log('__init__: ', timeEnd - timeBegin);
};

__init__: 提供与ServiceTest同名的方法__init__

切面：`dispose`

为ServiceTest#__dispose__输出运行时长

在 VSCode 编辑器中，输入代码片段aopdispose，自动生成代码骨架:

protected __dispose__: AopActionDispose<ClassSome> = async (_args, next, _receiver) => {
  await next();
};

调整代码，然后添加 log 逻辑

protected __dispose__: AopActionDispose<ServiceTest> = async (_args, next, _receiver) => {
  const timeBegin = Date.now();
  await next();
  const timeEnd = Date.now();
  console.log('__dispose__: ', timeEnd - timeBegin);
};

__dispose__: 提供与ServiceTest同名的方法__dispose__

切面：`get`

为ServiceTest扩展魔术方法

参见: 魔术方法

在 VSCode 编辑器中，输入代码片段aopget，自动生成代码骨架:

protected __get__: AopActionGet<ClassSome> = (_prop, next, _receiver) => {
  const value = next();
  return value;
};

调整代码，然后添加自定义字段red

protected __get__: AopActionGet<ServiceTest> = (prop, next, _receiver) => {
  if (prop === 'red') return '#FF0000';
  const value = next();
  return value;
};

__get__: 约定的魔术方法名称

通过接口类型合并的机制为颜色提供类型定义

declare module 'vona-module-demo-student' {
  export interface ServiceTest {
    red: string;
  }
}

切面：`set`

为ServiceTest扩展魔术方法

参见: 魔术方法

在 VSCode 编辑器中，输入代码片段aopset，自动生成代码骨架:

protected __set__: AopActionSet<ClassSome> = (_prop, value, next, _receiver) => {
  return next(value);
};

调整代码，为自定义字段red设置值

private _colorRed: string | undefined;

protected __set__: AopActionSet<ServiceTest> = (prop, value, next, _receiver) => {
  if (prop === 'red') {
    this._colorRed = value;
    return true;
  }
  return next(value);
};

__set__: 约定的魔术方法名称
如果为prop设置了值，返回true，否则调用next方法

然后调整__get__的逻辑:

protected __get__: AopActionGet<ServiceTest> = (prop, next, _receiver) => {
- if (prop === 'red') return '#FF0000';
+ if (prop === 'red') return this._colorRed;
  const value = next();
  return value;
}

切面：`method`

为ServiceTest的任何方法扩展逻辑

在 VSCode 编辑器中，输入代码片段aopmethod，自动生成代码骨架:

protected __method__: AopActionMethod<ClassSome> = (_method, _args, next, _receiver) => {
  return next();
};

调整代码，然后为方法actionSync和actionAsync添加 log 逻辑

protected __method__: AopActionMethod<ServiceTest> = (method, _args, next, _receiver) => {
  if (method !== 'actionSync' && method !== 'actionAsync') {
    return next();
  }
  const timeBegin = Date.now();
  function done(res) {
    const timeEnd = Date.now();
    console.log(`method ${method}: `, timeEnd - timeBegin);
    return res;
  }
  const res = next();
  if (res?.then) {
    return res.then((res: any) => {
      return done(res);
    });
  }
  return done(res);
};

__method__: 约定的魔术方法名称
res?.then: 判断返回值是否是 Promise 对象，进行不同处理，从而兼容同步方法和异步方法

AOP顺序

针对同一个目标 Class，可以关联多个 AOP。所以，VonaJS 提供了两个参数，用于控制 AOP 的执行顺序

1. dependencies

比如，还有一个 AOP demo-student:log3，我们希望执行顺序如下：demo-student:log3 > Current

@Aop({
  match: 'demo-student.service.test',
+ dependencies: 'demo-student:log3',
})
class AopLog {}

2. dependents

dependents的顺序刚好与dependencies相反，我们希望执行顺序如下：Current > demo-student:log3

@Aop({
  match: 'demo-student.service.test',
+ dependents: 'demo-student:log3',
})
class AopLog {}

AOP启用/禁用

可以控制 AOP 的启用/禁用

1. Enable

src/backend/config/config/config.ts

// onions
config.onions = {
  aop: {
    'demo-student:log': {
+     enable: false,
    },
  },
};

2. Meta

可以让 AOP 在指定的运行环境生效

名称	类型	说明
flavor	string\|string[]	参见: 运行环境与Flavor
mode	string\|string[]	参见: 运行环境与Flavor

举例

@Aop({
+ meta: {
+   flavor: 'normal',
+   mode: 'dev',
+ },
})
class AopLog {}

查看当前生效的AOP清单

可以直接在目标 Class action 中输出当前生效的 AOP 清单

class ServiceTest {
  protected async __dispose__() {
+   this.bean.onion.aop.inspect();
    this._name = '';
  }

this.bean.onion: 取得全局 Service 实例 onion
.aop: 取得与 AOP 相关的 Service 实例
.inspect: 输出当前生效的 AOP 清单

当方法被执行时，会自动在控制台输出当前生效的 AOP 清单，效果如下：

资源

Github：https://github.com/vonajs/vona
文档：https://vona.js.org/

VonaJS AOP编程：魔术方法

zhennann — Thu, 23 Oct 2025 00:59:58 GMT

在VonaJS框架中，AOP编程包括三方面：控制器切面、内部切面和外部切面。内部切面包括两个能力：AOP Method和魔术方法。这里我们简要介绍一下魔术方法的用法。

魔术方法

魔术方法，允许我们在 Class 内部通过__get__和__set__切入动态属性或方法

举例：Module Scope

为了让 IOC 容器的使用更加简洁和直观，VonaJS 推荐优先使用依赖查找策略，从而使用更少的装饰器函数，使用更少的类型标注。通过Module Scope对象访问模块提供的资源，就是践行依赖查找策略的机制之一

参见: 模块Scope

比如，模块 demo-student 中有一个 model student，用于 crud 操作。可以这样使用 model：

import { ModelStudent } from '../model/student.ts';

async findMany(params) {
  const model = this.bean._getBean(ModelStudent);
  return await model.selectAndCount(params);
}

使用魔术方法：

async findMany(params) {
  return await this.scope.model.student.selectAndCount(params);
}

this.scope.model.xxx: 通过魔术方法动态获取当前模块中的 model 实例

举例：CRUD(魔术方法)

Vona ORM 采用魔术方法的机制进一步简化操作数据的代码

参见: CRUD(魔术方法)

比如，通过字段id查询学生信息，代码如下：

async findOne(id) {
  return await this.scope.model.student.get({ id });
}

使用魔术方法：

async findOne(id) {
  return await this.scope.model.student.getById(id);
}

系统自动从 method name getById中解析出参数id，然后调用实际的 CRUD 方法，这里就是: get({ id })

创建Class

可以在任何 Class 中实现魔术方法。下面，以 Service 为例，在模块 demo-student 中创建一个 Service color，代码如下：

如何创建 Service，参见: Service

import { BeanBase } from 'vona';
import { Service } from 'vona-module-a-bean';

@Service()
export class ServiceColor extends BeanBase {}

`get`

然后，通过__get__实现颜色值的获取

1. 添加代码骨架

在 VSCode 编辑器中，输入代码片段aopmagicget，自动生成代码骨架:

@Service()
export class ServiceColor extends BeanBase {
+ protected __get__(prop: string) {}
}

2. 实现自定义逻辑

@Service()
export class ServiceColor extends BeanBase {
+ private _colors = {
+   red: '#FF0000',
+   green: '#00FF00',
+   blue: '#0000FF',
+ };

  protected __get__(prop: string) {
+   return this._colors[prop];
  }
}

3. 添加类型合并

通过接口类型合并的机制为颜色提供类型定义

export interface ServiceColor {
  red: string;
  green: string;
  blue: string;
}

4. 使用魔术方法

async test() {
  console.log(this.scope.service.color.red);
  console.log(this.scope.service.color.green);
  console.log(this.scope.service.color.blue);
}

`set`

然后，通过__set__实现颜色值的设置

1. 添加代码骨架

在 VSCode 编辑器中，输入代码片段aopmagicset，自动生成代码骨架:

@Service()
export class ServiceColor extends BeanBase {
+ protected __set__(prop: string, value: any): boolean {
+   return false;
+ }
}

2. 实现自定义逻辑

@Service()
export class ServiceColor extends BeanBase {
  private _colors = {
    red: '#FF0000',
    green: '#00FF00',
    blue: '#0000FF',
+   black: '',
  };

  protected __set__(prop: string, value: any): boolean {
+   if (this._colors[prop] === undefined) return false;
+   this._colors[prop] = value;
+   return true;
  }
}

如果为prop设置了值，返回true，否则返回false

3. 添加类型合并

通过接口类型合并的机制为颜色提供类型定义

export interface ServiceColor {
  red: string;
  green: string;
  blue: string;
+ black: string;
}

4. 使用魔术方法

async test() {
  this.scope.service.color.black = '#000000';
  console.log(this.scope.service.color.black);
}

资源

Github：https://github.com/vonajs/vona
文档：https://vona.js.org/

购物/订阅/广告投放/域名服务器，一张虚拟卡轻松付全球！

daoke — Thu, 16 Oct 2025 07:01:38 GMT

VCC Visa万事达虚拟信用卡|轻松付全球|跨境支付适用各种跨境场景，轻松付全球！支持AWS、tiktok、Facebook、Alipay 、Google、paypal、推特、星链、广告投放、域名服务器、购物、注册、订阅等，覆盖多种消费场景，支持多币种交易、开卡即用、实时到账、极速消费，可自助机器人开卡与开后台管理，支持API对接代理。产品频道：https://t.me/+vCIqSgwsBDxiODIy

分享个好用的VPS平台，电商/建站/游戏都能用

daoke — Sun, 12 Oct 2025 09:13:41 GMT

最近在折腾建站和游戏服务器，用了好几家VPS，最后留下这个： BaseCloud｜来自新加坡的VPS聚合平台。

聚合阿里云、腾讯云、AWS 等大厂资源，全球节点都有，国内延迟低，海外（香港、新加坡、日本）跑跨境业务很稳。

⚙️ 支持一键部署 WordPress、Docker、ERP，自助升降配、实时监控、原生DDoS防护，还支持加密货币付款，全程免实名。

长期85折标价，不是限时价，账号开通也很快。

适合做独立站、电商、游戏服、AI部署的都可以试试。

BaseCloud 官网直达BaseCloud 官网直达官方TG频道官方TG频道有节点上新和福利活动

AOP编程有三大场景：控制器切面，内部切面，外部切面，你get到了吗？

zhennann — Fri, 10 Oct 2025 02:21:50 GMT

如果用过NestJS框架都知道，在NestJS框架中AOP编程包括以下几个能力：Middleware、Guard、Interceptor、Pipe、Filter。事实上AOP编程的应用场景更广泛，上述所列5个能力仅仅是AOP编程的子集。下面，我们看看在VonaJS框架中，AOP编程是怎样的。

VonaJS AOP编程

VonaJS AOP 编程包括三个方面的能力：

控制器切面: 为 Controller 方法切入逻辑
内部切面: 在 Class 内部，为任何 Class 的任何方法切入逻辑
外部切面: 在不改变 Class 源码的前提下，从外部为任何 Class 的任何方法切入逻辑

控制器切面

控制器切面清单

Middleware
Guard
Intercepter
Pipe
Filter

执行时序图

控制器切面的执行时序图如下：

洋葱模型: Middleware和Intercepter支持洋葱模型，允许在Controller Action之前和之后执行切面逻辑
Middleware: 针对不同的执行时序节点，系统提供了三种 Middleware: Middleware System、Middleware Global和Middleware Local，从而可以实现更精细化的切面逻辑
Route Match: 只有Middleware System在路由匹配之前执行，其余在路由匹配之后执行
Filter: 任何环节抛出异常，都会执行Filter，从而自定义错误信息和错误日志的处理逻辑

内部切面

内部切面提供两个机制：AOP Method和魔术方法

1. AOP Method

直接在 Class Method 上通过装饰器切入逻辑

举例：数据库事务

class ServiceStudent {
+ @Database.transaction()
  async update(id: TableIdentity, student: DtoStudentUpdate) {
    return await this.scope.model.student.updateById(id, student);
  }
}

@Database.transaction：通过AOP Method机制实现的装饰器，可以直接提供数据库事务能力

举例：日志

class ServiceStudent {
+ @Log()
  async update(id: TableIdentity, student: DtoStudentUpdate) {
    return await this.scope.model.student.updateById(id, student);
  }
}

@Log：通过AOP Method机制实现的装饰器，可以直接提供日志能力

2. 魔术方法

可以在 Class 内部通过__get__和__set__切入动态属性或方法

举例：获取 model 实例

class ServiceStudent {
  async update(id: TableIdentity, student: DtoStudentUpdate) {
+   return await this.scope.model.student.updateById(id, student);
  }
}

this.scope.model.xxx: 没有使用依赖注入，而是使用依赖查找，直接通过 scope 对象获取 model 实例，从而简化代码的书写风格

实现思路

系统提供了一个 Class ServiceModelResolver，用于实现 model 实例的动态解析，代码如下：

class ServiceModelResolver {
  protected __get__(prop: string) {
    const beanFullName = `${this[SymbolModuleScope]}.model.${prop}`;
    return this.bean._getBean(beanFullName as any);
  }
}

当调用this.scope.model.student时，会自动执行__get__方法，并且传入参数prop: 'student'
将参数prop与当前模块名称合并成beanFullName
通过beanFullName从全局容器中获取 model 实例，并返回给调用者

外部切面

仍以 Class ServiceStudent的update方法为例，通过外部切面来实现日志能力：

import { Aop } from 'vona-module-a-aspect';

@Aop({ match: 'demo-student.service.student' })
class AopLog {
  async update(_args: Parameters<any>, next: Function, _receiver: any) {
    const timeBegin = Date.now();
    const res = await next();
    const timeEnd = Date.now();
    console.log('time: ', timeEnd - timeBegin);
    return res;
  }
}

@Aop: 此装饰器用于实现外部切面
match: 用于将 Class AopLog与 Class ServiceStudent关联，ServiceStudent的 beanFullName 是demo-student.service.student
update: 在AopLog中提供与ServiceStudent同名的方法update，实现自定义逻辑即可

资源

Github：https://github.com/vonajs/vona
文档：https://vona.js.org/

xlsx-handlebars 一个用于处理 XLSX 文件 Handlebars 模板的 Rust 库，支持多平台使

151263 — Sun, 05 Oct 2025 16:31:59 GMT

xlsx-handlebars

中文文档 | English

一个用于处理 XLSX 文件 Handlebars 模板的 Rust 库，支持多平台使用：

Rust 原生
WebAssembly (WASM)
npm 包
Node.js
Deno
浏览器端
JSR (JavaScript Registry)

功能特性

⚡ 极致性能：2.12秒渲染10万行数据（约4.7万行/秒）- 比 Python 快 14-28倍，比 JavaScript 快 7-14倍
✅ 智能合并：自动处理被 XML 标签分割的 Handlebars 语法
✅ XLSX 验证：内置文件格式验证，确保输入文件有效
✅ Handlebars 支持：完整的模板引擎，支持变量、条件、循环、Helper 函数
✅ 跨平台：Rust 原生 + WASM 支持多种运行时
✅ TypeScript：完整的类型定义和智能提示
✅ 零依赖：WASM 二进制文件，无外部依赖
✅ 错误处理：详细的错误信息和类型安全的错误处理

安装

Rust

cargo add xlsx-handlebars

npm

npm install xlsx-handlebars

Deno

import { render_template, init } from "jsr:@sail/xlsx-handlebars";

使用示例

Rust

use xlsx_handlebars::render_template;
use serde_json::json;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 读取 XLSX 模板文件
    let template_bytes = std::fs::read("template.xlsx")?;
    
    // 准备数据
    let data = json!({
        "name": "张三",
        "company": "ABC科技有限公司",
        "position": "软件工程师",
        "projects": [
            {"name": "项目A", "status": "已完成"},
            {"name": "项目B", "status": "进行中"}
        ],
        "has_bonus": true,
        "bonus_amount": 5000
    });
    
    // 渲染模板
    let result = render_template(template_bytes, &data)?;
    
    // 保存结果
    std::fs::write("output.xlsx", result)?;
    
    Ok(())
}

JavaScript/TypeScript (Node.js)

import init, { render_template } from "xlsx-handlebars";
import fs from 'fs';

async function processTemplate() {
    // 初始化 WASM 模块
    await init();
    
    // 读取模板文件
    const templateBytes = fs.readFileSync("template.xlsx");
    
    // 准备数据
    const data = {
        name: "李明",
        company: "XYZ技术有限公司",
        position: "高级开发工程师",
        projects: [
            { name: "E-commerce平台", status: "已完成" },
            { name: "移动端APP", status: "开发中" }
        ],
        has_bonus: true,
        bonus_amount: 8000
    };
    
    // 渲染模板
    const result = render_template(templateBytes, JSON.stringify(data));
    
    // 保存结果
    fs.writeFileSync('output.xlsx', new Uint8Array(result));
}

processTemplate().catch(console.error);

Deno

import init, { render_template } from "https://deno.land/x/xlsx_handlebars/mod.ts";

async function processTemplate() {
    // 初始化 WASM 模块
    await init();
    
    // 读取模板文件
    const templateBytes = await Deno.readFile("template.xlsx");
    
    // 准备数据
    const data = {
        name: "王小明",
        department: "研发部",
        projects: [
            { name: "智能客服系统", status: "已上线" },
            { name: "数据可视化平台", status: "开发中" }
        ]
    };
    
    // 渲染模板
    const result = render_template(templateBytes, JSON.stringify(data));
    
    // 保存结果
    await Deno.writeFile("output.xlsx", new Uint8Array(result));
}

if (import.meta.main) {
    await processTemplate();
}

浏览器端

<!DOCTYPE html>
<html>
<head>
    <title>XLSX Handlebars 示例</title>
</head>
<body>
    <input type="file" id="fileInput" accept=".xlsx">
    <button onclick="processFile()">处理模板</button>
    
    <script type="module">
        import init, { render_template } from './pkg/xlsx_handlebars.js';
        
        // 初始化 WASM
        await init();
        
        window.processFile = async function() {
            const fileInput = document.getElementById('fileInput');
            const file = fileInput.files[0];
            
            if (!file) return;
            
            const arrayBuffer = await file.arrayBuffer();
            const templateBytes = new Uint8Array(arrayBuffer);
            
            const data = {
                name: "张三",
                company: "示例公司"
            };
            
            try {
                const result = render_template(templateBytes, JSON.stringify(data));
                
                // 下载结果
                const blob = new Blob([new Uint8Array(result)], {
                    type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
                });
                const url = URL.createObjectURL(blob);
                const a = document.createElement('a');
                a.href = url;
                a.download = 'processed.xlsx';
                a.click();
            } catch (error) {
                console.error('处理失败:', error);
            }
        };
    </script>
</body>
</html>

模板语法

基础变量替换

员工姓名: {{name}}
公司: {{company}}
职位: {{position}}

条件渲染

{{#if has_bonus}}
奖金: ¥{{bonus_amount}}
{{else}}
无奖金
{{/if}}

{{#unless is_intern}}
正式员工
{{/unless}}

循环渲染

项目经历:
{{#each projects}}
- {{name}}: {{description}} ({{status}})
{{/each}}

技能列表:
{{#each skills}}
{{@index}}. {{this}}
{{/each}}

Helper 函数

内置的 Helper 函数：

<!-- 基础 helper -->
{{upper name}}           <!-- 转大写 -->
{{lower company}}        <!-- 转小写 -->
{{len projects}}         <!-- 数组长度 -->
{{#if (eq status "completed")}}已完成{{/if}}    <!-- 相等比较 -->
{{#if (gt score 90)}}优秀{{/if}}               <!-- 大于比较 -->
{{#if (lt age 30)}}年轻{{/if}}                 <!-- 小于比较 -->

<!-- 字符串拼接 -->
{{concat "你好" " " "世界"}}                    <!-- 字符串拼接 -->
{{concat "总计: " count}}                      <!-- 混合字符串和变量 -->

<!-- Excel 专用 helper -->
{{num employee.salary}}                         <!-- 标记单元格为数字类型 -->
{{formula "=SUM(A1:B1)"}}                      <!-- 静态 Excel 公式 -->
{{formula (concat "=SUM(" (_c) "1:" (_c) "10)")}} <!-- 使用当前列的动态公式 -->
{{mergeCell "C4:D5"}}                          <!-- 合并单元格 C4 到 D5 -->
{{img logo.data 100 100}}                       <!-- 插入图片，指定宽高 -->

<!-- 列名转换 helper -->
{{toColumnName "A" 5}}                          <!-- A + 5 偏移 = F -->
{{toColumnName (_c) 3}}                         <!-- 当前列向右偏移 3 列 -->
{{toColumnIndex "AA"}}                          <!-- AA 列的索引 = 27 -->

Excel 公式 Helper

静态公式:

<!-- 在 Excel 单元格中 -->
{{formula "=SUM(A1:B1)"}}
{{formula "=AVERAGE(C2:C10)"}}
{{formula "=IF(D1>100,\"高\",\"低\")"}}

使用 concat 的动态公式:

<!-- 动态行引用 -->
{{formula (concat "=A" (_r) "*B" (_r))}}

<!-- 动态列引用 -->
{{formula (concat "=SUM(" (_c) "2:" (_c) "10)")}}

<!-- 复杂动态公式 -->
{{formula (concat "=IF(" (_cr) ">100,\"高\",\"低\")")}}

可用的位置 helper:

(_c) - 当前列字母 (A, B, C, …)
(_r) - 当前行号 (1, 2, 3, …)
(_cr) - 当前单元格引用 (A1, B2, C3, …)

列名转换 Helper

toColumnName - 将列名或列索引转换为新的列名，支持偏移量：

<!-- 基础用法：从指定列名开始偏移 -->
{{toColumnName "A" 0}}     <!-- A (无偏移) -->
{{toColumnName "A" 5}}     <!-- F (A + 5) -->
{{toColumnName "Z" 1}}     <!-- AA (Z + 1) -->

<!-- 配合当前列使用 -->
{{toColumnName (_c) 3}}    <!-- 当前列向右偏移 3 列 -->

<!-- 动态公式中的应用 -->
{{formula (concat "=SUM(" (_c) "1:" (toColumnName (_c) 3) "1)")}}
<!-- 示例：如果当前列是 B，生成公式 =SUM(B1:E1) -->

toColumnIndex - 将列名转换为列索引（1-based）：

{{toColumnIndex "A"}}      <!-- 1 -->
{{toColumnIndex "Z"}}      <!-- 26 -->
{{toColumnIndex "AA"}}     <!-- 27 -->
{{toColumnIndex "AB"}}     <!-- 28 -->

合并单元格 Helper

mergeCell - 标记需要合并的单元格范围：

<!-- 静态合并单元格 -->
{{mergeCell "C4:D5"}}      <!-- 合并 C4 到 D5 区域 -->
{{mergeCell "F4:G4"}}      <!-- 合并 F4 到 G4 区域 -->

<!-- 动态合并单元格：从当前位置合并 -->
{{mergeCell (concat (_c) (_r) ":" (toColumnName (_c) 3) (_r))}}
<!-- 示例：如果当前在 B5，合并 B5:E5（向右合并4列） -->

<!-- 动态合并单元格：跨行跨列 -->
{{mergeCell (concat (_c) (_r) ":" (toColumnName (_c) 2) (add (_r) 2))}}
<!-- 示例：如果当前在 C3，合并 C3:E5（3列×3行的区域） -->

<!-- 在循环中动态合并 -->
{{#each sections}}
  {{mergeCell (concat "A" (add @index 2) ":D" (add @index 2))}}
  <!-- 为每个 section 合并一行的 A-D 列 -->
{{/each}}

注意事项：

mergeCell 不产生输出，仅收集合并信息
合并范围格式必须是 起始单元格:结束单元格（如 "A1:B2"）
相同的合并范围会自动去重
合并信息会在渲染完成后自动添加到 Excel 文件中

超链接 Helper

hyperlink - 在 Excel 单元格中添加超链接：

<!-- 基础用法：链接到其他工作表 -->
{{hyperlink (_cr) "Sheet2!A1" "查看详情"}}

<!-- 链接到外部网址（需在模板中预设） -->
{{hyperlink (_cr) "https://example.com" "访问网站"}}

<!-- 动态链接 -->
{{#each items}}
  {{hyperlink (_cr) (concat "详情!" name) name}}
{{/each}}

参数说明：

第一个参数：单元格引用，通常使用 (_cr) 获取当前单元格
第二个参数：链接目标（工作表引用或 URL）
第三个参数：显示文本（可选）

注意事项：

hyperlink 不产生输出，仅收集超链接信息
超链接会在渲染完成后自动添加到 Excel 文件中
支持工作表内部引用（如 "Sheet2!A1"）
外部链接需要在模板 Excel 文件中预先配置关系

数字类型 Helper

使用 {{num value}} 确保单元格在 Excel 中被识别为数字：

<!-- 不使用 num: 当作文本处理 -->
{{employee.salary}}

<!-- 使用 num: 当作数字处理 -->
{{num employee.salary}}

特别适用于以下场景：

值可能是字符串但应当作数字处理
需要确保 Excel 中的数字格式正确
需要在公式中使用该值

图片插入 Helper

img - 在 Excel 中插入 base64 编码的图片：

<!-- 基础用法：插入图片并使用原始尺寸 -->
{{img logo.data}}

<!-- 指定宽度和高度（单位：像素） -->
{{img photo.data 150 200}}

<!-- 使用数据中的尺寸 -->
{{img image.data image.width image.height}}

特性：

✅ 支持 PNG、JPEG、WebP、BMP、TIFF、GIF 等常见图片格式
✅ 自动检测图片实际尺寸
✅ 可选指定宽度和高度（像素）
✅ 图片定位在当前单元格位置
✅ 图片不受单元格大小限制，保持比例
✅ 支持同一 sheet 插入多张图片
✅ 支持多个 sheet 各自插入图片
✅ 使用 UUID 避免 ID 冲突

完整示例：

// 在 JavaScript 中准备图片数据
import fs from 'fs';

const imageBuffer = fs.readFileSync('logo.png');
const base64Image = imageBuffer.toString('base64');

const data = {
  company: {
    logo: base64Image,
    name: "科技公司"
  },
  products: [
    {
      name: "产品A",
      photo: base64Image,
      width: 120,
      height: 120
    },
    {
      name: "产品B", 
      photo: base64Image,
      width: 100,
      height: 100
    }
  ]
};

// 在模板中使用

<!-- Excel 模板示例 -->
公司Logo: {{img company.logo 100 50}}

产品列表:
{{#each products}}
产品名: {{name}}
图片: {{img photo width height}}
{{/each}}

使用技巧：

如果只指定宽度，高度会等比例缩放
如果只指定高度，宽度会等比例缩放
如果都不指定，使用图片原始尺寸
图片会放置在调用 {{img}} 的单元格位置
base64 数据不包含 data:image/png;base64, 前缀，只需要纯 base64 字符串

工作表管理 Helpers

deleteCurrentSheet - 删除当前正在渲染的工作表：

<!-- 基础用法 -->
{{deleteCurrentSheet}}

<!-- 条件删除 -->
{{#if shouldDelete}}
  {{deleteCurrentSheet}}
{{/if}}

<!-- 删除非活跃工作表 -->
{{#unless isActive}}
  {{deleteCurrentSheet}}
{{/unless}}

特性：

✅ 从工作簿中移除工作表及其关系
✅ 清理相关文件（rels、content types）
✅ 保留 drawing 文件（安全考虑）
✅ 不能删除最后一个工作表（Excel 要求）
✅ 延迟执行，所有渲染完成后统一删除

setCurrentSheetName - 重命名当前工作表：

<!-- 静态名称 -->
{{setCurrentSheetName "销售报表"}}

<!-- 动态名称 -->
{{setCurrentSheetName (concat department.name " - " year "年")}}

<!-- 基于循环的命名 -->
{{#each departments}}
  {{setCurrentSheetName (concat "部门" @index " - " name)}}
{{/each}}

特性：

✅ 自动过滤非法字符：\ / ? * [ ]
✅ 自动限制长度为 31 个字符
✅ 自动处理重名，添加数字后缀
✅ 支持动态名称生成

hideCurrentSheet - 隐藏当前工作表：

<!-- 普通隐藏（用户可通过右键取消隐藏） -->
{{hideCurrentSheet}}
{{hideCurrentSheet "hidden"}}

<!-- 超级隐藏（需要 VBA 才能取消隐藏） -->
{{hideCurrentSheet "veryHidden"}}

<!-- 条件隐藏 -->
{{#unless (eq userRole "admin")}}
  {{hideCurrentSheet "veryHidden"}}
{{/unless}}

隐藏级别：

hidden - 普通隐藏，用户可通过 Excel 右键菜单取消隐藏
veryHidden - 超级隐藏，需要 VBA 或属性编辑器才能取消隐藏

特性：

✅ 不能隐藏所有工作表（Excel 要求至少一个可见）
✅ 两种隐藏级别：普通隐藏和超级隐藏
✅ 适用于权限控制和敏感数据保护

常见使用场景：

<!-- 多语言报表：删除未使用的语言工作表 -->
{{#if (ne language "zh-CN")}}
  {{deleteCurrentSheet}}
{{/if}}

<!-- 动态部门报表：按部门重命名工作表 -->
{{setCurrentSheetName (concat department.name " 报表")}}

<!-- 权限控制：对普通用户隐藏管理员工作表 -->
{{#unless (eq userRole "admin")}}
  {{hideCurrentSheet "veryHidden"}}
{{/unless}}

<!-- 条件工作流：根据状态删除、重命名或隐藏 -->
{{#if (eq status "inactive")}}
  {{deleteCurrentSheet}}
{{else}}
  {{setCurrentSheetName (concat "活跃 - " name)}}
  {{#if isInternal}}
    {{hideCurrentSheet}}
  {{/if}}
{{/if}}

复杂示例

=== 员工报告 ===

基本信息:
姓名: {{employee.name}}
部门: {{employee.department}}
职位: {{employee.position}}
入职时间: {{employee.hire_date}}

{{#if employee.has_bonus}}
 奖金: ¥{{employee.bonus_amount}}
{{/if}}

项目经历 (共{{len projects}}个):
{{#each projects}}
{{@index}}. {{name}}
   描述: {{description}}
   状态: {{status}}
   团队规模: {{team_size}}人
   
{{/each}}

技能评估:
{{#each skills}}
- {{name}}: {{level}}/10 ({{years}}年经验)
{{/each}}

在表格中若需要删除一整行, 只需要在任意单元格上添加:
{{removeRow}}


{{#if (gt performance.score 90)}}
 绩效评级: 优秀
{{else if (gt performance.score 80)}}
 绩效评级: 良好
{{else}}
 绩效评级: 需改进
{{/if}}

构建和开发

构建 WASM 包

# 构建所有目标
npm run build

# 或分别构建
npm run build:web    # 浏览器版本
npm run build:npm    # Node.js 版本 
npm run build:jsr    # Deno 版本

运行示例

# Rust 示例
cargo run --example rust_example

# Node.js 示例
node examples/node_example.js

# Deno 示例  
deno run --allow-read --allow-write examples/deno_example.ts

# 浏览器示例
cd tests/npm_test
node serve.js
# 然后在浏览器中打开 http://localhost:8080
# 选择 examples/template.xlsx 文件测试

工具函数

xlsx-handlebars 提供了一系列实用工具函数，帮助你更高效地处理 Excel 相关操作。

获取图片尺寸

从原始图片数据中检测图片尺寸，无需依赖完整的图片处理库。

use xlsx_handlebars::get_image_dimensions;

// 读取图片文件
let image_data = std::fs::read("logo.png")?;

// 获取尺寸
if let Some((width, height)) = get_image_dimensions(&image_data) {
    println!("图片尺寸: {}x{}", width, height);
} else {
    println!("不支持的图片格式");
}

支持的格式：

PNG
JPEG
WebP (VP8, VP8L, VP8X)
BMP
TIFF (II/MM 字节序)
GIF (87a/89a)

Excel 列名转换

在 Excel 中进行列名和列索引之间的转换。

use xlsx_handlebars::{to_column_name, to_column_index};

// 列名递增
assert_eq!(to_column_name("A", 0), "A");
assert_eq!(to_column_name("A", 1), "B");
assert_eq!(to_column_name("Z", 1), "AA");
assert_eq!(to_column_name("AA", 1), "AB");

// 列名转索引 (1-based)
assert_eq!(to_column_index("A"), 1);
assert_eq!(to_column_index("Z"), 26);
assert_eq!(to_column_index("AA"), 27);
assert_eq!(to_column_index("BA"), 53);

JavaScript/TypeScript 示例：

import { wasm_to_column_name, wasm_to_column_index } from 'xlsx-handlebars';

// 列名递增
console.log(wasm_to_column_name("A", 1));  // "B"
console.log(wasm_to_column_name("Z", 1));  // "AA"

// 列名转索引
console.log(wasm_to_column_index("AA"));   // 27
console.log(wasm_to_column_index("BA"));   // 53

Excel 日期转换

在 Unix 时间戳和 Excel 日期序列号之间转换。Excel 使用从 1900-01-01 开始的序列号表示日期。

use xlsx_handlebars::{timestamp_to_excel_date, excel_date_to_timestamp};

// 时间戳转 Excel 日期
let timestamp = 1704067200000i64;  // 2024-01-01 00:00:00 UTC
let excel_date = timestamp_to_excel_date(timestamp);
println!("Excel 日期序列号: {}", excel_date);  // 45294.0

// Excel 日期转时间戳
if let Some(ts) = excel_date_to_timestamp(45294.0) {
    println!("时间戳: {}", ts);  // 1704067200000
}

JavaScript/TypeScript 示例：

import { 
    wasm_timestamp_to_excel_date, 
    wasm_excel_date_to_timestamp 
} from 'xlsx-handlebars';

// 日期转 Excel 序列号
const date = new Date('2024-01-01T00:00:00Z');
const excelDate = wasm_timestamp_to_excel_date(date.getTime());
console.log('Excel 日期:', excelDate);  // 45294.0

// Excel 序列号转日期
const timestamp = wasm_excel_date_to_timestamp(45294.0);
if (timestamp !== null) {
    const convertedDate = new Date(timestamp);
    console.log('日期:', convertedDate.toISOString());
}

常见使用场景：

// 在模板中使用前验证图片尺寸
let image_data = std::fs::read("photo.jpg")?;
match get_image_dimensions(&image_data) {
    Some((w, h)) if w <= 1000 && h <= 1000 => {
        println!("有效图片: {}x{}", w, h);
        // 继续进行模板渲染
    }
    Some((w, h)) => {
        eprintln!("图片过大: {}x{} (最大 1000x1000)", w, h);
    }
    None => {
        eprintln!("不支持的图片格式");
    }
}

// 动态生成单元格引用
let start_col = "B";
let num_cols = 5;
for i in 0..num_cols {
    let col_name = to_column_name(start_col, i);
    let col_index = to_column_index(&col_name);
    println!("列 {}: 名称={}, 索引={}", i, col_name, col_index);
}

// 在模板数据中包含日期
use serde_json::json;

let date_timestamp = 1704067200000i64;  // 2024-01-01
let excel_date = timestamp_to_excel_date(date_timestamp);

let data = json!({
    "report_date": excel_date,
    "employee": {
        "name": "张三",
        "hire_date": timestamp_to_excel_date(1609459200000i64)  // 2021-01-01
    }
});

// 批量处理图片
for file in &["logo.png", "banner.jpg", "icon.gif"] {
    let data = std::fs::read(file)?;
    match get_image_dimensions(&data) {
        Some((w, h)) => println!("{}: {}x{}", file, w, h),
        None => eprintln!("{}: 不支持的格式", file),
    }
}

这些工具函数帮助你：

✅ 在插入前验证图片尺寸
✅ 动态生成单元格引用和公式
✅ 处理 Excel 日期格式
✅ 避免加载笨重的外部库
✅ 同时支持 Rust 和 JavaScript/TypeScript

技术特性

性能和兼容性

极致性能表现 ⚡

xlsx-handlebars 凭借 Rust 实现了业界顶尖的性能表现：

数据量	处理耗时	吞吐量
1,000 行	~0.02秒	实时生成报表
10,000 行	~0.21秒	在线导出
100,000 行	~2.12秒	批量处理
1,000,000 行	~21秒	大数据报表

性能对比 (处理10万行数据)：

技术栈	耗时	与 xlsx-handlebars 对比
xlsx-handlebars (Rust)	2.12秒	1倍 (基准) ⭐
Python (openpyxl)	30-60秒	慢 14-28倍
JavaScript (xlsx.js)	15-30秒	慢 7-14倍
Java (Apache POI)	8-15秒	慢 3-7倍
C# (EPPlus)	5-10秒	慢 2-4倍

为什么这么快？

Rust 零成本抽象：编译期优化，无运行时开销
流式架构：直接在内存中处理 ZIP 条目，避免文件 I/O
⚡ 事件驱动 XML 解析：使用 quick-xml 高效解析，无需构建完整 DOM 树
单次遍历渲染：一次迭代完成所有模板替换

兼容性

零拷贝: Rust 和 WASM 之间高效的内存管理
流式处理: 适合处理大型 XLSX 文件
跨平台: 支持 Windows、macOS、Linux、Web
现代浏览器: 支持所有支持 WASM 的现代浏览器

许可证

本项目采用 MIT 许可证 - 详见 LICENSE-MIT 文件。

支持

VonaJS提供的读写分离，直观，优雅

zhennann — Mon, 29 Sep 2025 01:47:36 GMT

在VonaJS中实现读写分离，只需提供一组写数据源和一组读数据源。当用户访问后端 API 时，系统会按照规则自动选择写数据源或读数据源，访问相应的数据库，从而分摊压力，提升系统性能

安装模块

读写分离作为独立的模块提供，因此需要在VonaJS项目中安装此模块：

$ pnpm add vona-module-a-datasharding -w

添加数据源

首先，需要添加一组数据源

1. 添加类型定义

为新数据源添加类型定义

src/backend/config/config/config.ts

declare module 'vona-module-a-orm' {
  export interface IDatabaseClientRecord {
    read1: never;
    read2: never;
    write1: never;
    write2: never;
  }
}

2. 增加数据源配置

src/backend/config/config/config.ts

// database
config.database = {
  clients: {
    read1: {
      client: 'pg',
      connection: {
        host: '127.0.0.1',
        port: 5432,
        user: 'postgres',
        password: '',
        database: 'xxxx-read1',
      },
    },
    read2: {...},
    write1: {...},
    write2: {...},
  },
};

配置读写数据源

然后配置模块的读写数据源

src/backend/config/config/config.ts

// modules
config.modules = {
  'a-datasharding': {
    client: {
      reads: ['read1', 'read2'],
      writes: ['write1', 'write2'],
      randomRead: undefined,
      randomWrite: undefined,
    },
  },
};

名称	说明
reads	指定一组读数据源
writes	指定一组写数据源
randomRead	可指定自定义函数，从`reads`中提取一个读数据源。默认为`undefined`，由系统随机提取
randomWrite	可指定自定义函数，从`writes`中提取一个写数据源。默认为`undefined`，由系统随机提取

读写分离的运行机制

当配置好读写数据源之后，读写分离机制就自动生效了

现在，解释一下读写分离的运行机制：

模块提供了一个全局拦截器a-datasharding:datasharding。该拦截器判断当前 API Method，如果是POST/PATCH/DELETE/PUT，那么就使用写数据源，否则使用读数据源

数据一致性: 缓存`写数据源`

场景分析：同一个用户

由于数据库同步有延时，会出现数据不一致性的情况。比如，用户访问Write-API，将数据写入写数据库。接下来，用户访问Read-API，此时读数据库还没有同步，那么就会读到旧数据

为了解决以上问题，模块自动提供了一个机制：当用户访问Write-API时，会自动将写数据源存入二级缓存，并设置过期时间。在这个时间之内，用户访问Read-API时，也会继续使用同一个写数据源，从而确保在写入数据后总是可以读取到最新的数据

修改过期时间

二级缓存的名称是a-datasharding:datasourceWrite，可以在 App config 中修改过期时间：

src/backend/config/config/config.ts

// onions
config.onions = {
  summerCache: {
    'a-datasharding:datasourceWrite': {
      mem: {
        ttl: 5 * 1000, // 5s
      },
      redis: {
        ttl: 5 * 1000, // 5s
      },
    },
  },
};

名称	说明
mem.ttl	Mem缓存的过期时间，默认为`3`秒
redis.ttl	Redis缓存的过期时间，默认为`3`秒

数据一致性: 缓存双删

场景分析：不同用户

Vona ORM 提供了开箱即用的缓存机制，参见：缓存

由于数据库同步有延时，会出现缓存不一致性的情况。比如，用户 A 访问Write-API，将数据写入写数据库，并自动删除缓存。接下来，用户 B 访问Read-API，此时读数据库还没有同步，那么就会读到旧数据，并存入缓存

为了解决以上问题，模块a-orm提供了缓存双删机制：当用户 A 访问Write-API时，将数据写入写数据库，并自动删除缓存。然后在指定时间之后再次删除缓存，从而确保缓存总是最新数据

启用缓存双删

src/backend/config/config/config.ts

// modules
config.modules = {
  'a-orm': {
    sharding: {
      cache: {
        doubleDelete: true,
      },
    },
  },
};

修改缓存双删延迟时间

系统采用队列任务执行缓存双删，队列名称是a-orm:doubleDelete，可以在 App config 中修改缓存双删延迟时间：

src/backend/config/config/config.ts

// onions
config.onions = {
  queue: {
    'a-orm:doubleDelete': {
      options: {
        job: {
          delay: 5 * 1000, // 5s
        },
      },
    },
  },
};

名称	说明
job.delay	指定延迟多长时间执行缓存双删任务，默认为`3`秒

Vona ORM已开源：https://github.com/vonajs/vona

VonaJS多租户同时支持共享模式和独立模式

zhennann — Fri, 26 Sep 2025 03:19:34 GMT

多实例/多租户

VonaJS 通过多实例的概念来支持多租户 SAAS 系统的开发。只需启动一个后端服务，即可支持多个实例同时运行

VonaJS 支持以下几种多实例/多租户模式：

共享模式：多个实例共享同一个数据库，通过实例Id字段隔离多实例之间的数据
独立模式：每个实例都使用独立的数据库，从而满足大数据量的业务需求
混合模式：在一个系统中同时支持共享模式和独立模式，从而可以精确指定某个实例使用共享数据库还是独立数据库

实例配置

1. 测试环境、开发环境

在测试环境和开发环境中，系统默认提供了一个缺省实例。同时提供了两个测试实例，用于演示如何使用共享模式和独立模式：

src/backend/config/config/config.test.ts

src/backend/config/config/config.dev.ts

// instances
config.instances = [
  { name: '', password: '', title: '', config: {} },
  { name: 'shareTest', password: '', title: '' },
  { name: 'isolateTest', password: '', title: '', id: 1000, isolate: true, isolateClient: 'isolateTest' },
];

实例清单

名称	说明
empty	缺省实例
shareTest	用于演示`共享模式`，具体而言，`shareTest`与`empty`共享同一个数据库
isolateTest	用于演示`独立模式`，具体而言，`isolateTest`使用独立的数据库

实例属性

名称	说明
name	实例名
password	实例中用户`admin`的初始密码，默认是`123456`
title	网站标题
config	实例的配置信息
id	当使用`独立模式`时，必须明确指定唯一的`实例Id`
isolate	是否使用`独立模式`，默认为`共享模式`
isolateClient	当使用`独立模式`时，必须明确指定`数据源`

2. 生产环境

在生产环境，需要自行配置实例信息

src/backend/config/config/config.prod.ts

config.instances = [
  { name: '', password: '', title: '', config: {} },
  { name: 'vona', password: '', title: '', config: {} },
];

如何添加新实例

下面以实例shareTest为例，演示如何添加新实例：

1. 添加类型定义

src/backend/config/config/config.ts

declare module 'vona' {
  export interface IInstanceRecord {
    shareTest: never;
  }
}

采用接口合并机制添加新实例的类型定义

2. 增加实例配置

在需要的 config 文件中添加实例配置，比如在测试环境配置新实例：

src/backend/config/config/config.test.ts

// instances
config.instances = [
  { name: 'shareTest', password: '', title: '' },
];

对于独立模式，还需要配置数据源，此处从略

获取当前实例名的规则

当用户访问后端 Api 时，后端会自动根据规则获取当前实例名，然后根据实例名获取实例信息

1. 模块配置

多实例是由模块 a-instance 提供的核心能力，可以在 App config 中修改模块的配置：

src/backend/config/config/config.prod.ts

// modules
config.modules = {
  'a-instance': {
    getInstanceName: undefined,
    headerField: 'x-vona-instance-name',
    queryField: 'x-vona-instance-name',
  },
};

名称	说明
getInstanceName	提供自定义函数，用于获取当前实例名
headerField	从request header中获取当前实例名，header key默认为`x-vona-instance-name`
queryField	从request query中获取当前实例名，query key默认为`x-vona-instance-name`

2. 规则次序

系统按以下次序，依次判断当前实例名，当获取到实例名时则停止判断流程

如果提供了getInstanceName，则调用此函数
如果queryField不为空，则从 request query 中获取
如果headerField不为空，则从 request header 中获取
从域名中解析实例名

3. 如何从域名中解析实例名

比如，域名为https://cabloy.com，那么对应的实例名是cabloy。可以通过配置SERVER_SUBDOMAINOFFSET来修改计算规则

env/.env

# server
SERVER_SUBDOMAINOFFSET = 1

当SERVER_SUBDOMAINOFFSET = 1时，域名与实例名对应关系如下：

域名	实例名
cabloy.com	cabloy
store.cabloy.com	cabloy.store

当SERVER_SUBDOMAINOFFSET = 2时，域名与实例名对应关系如下：

域名	实例名
cabloy.com	空字符串
store.cabloy.com	store

使用多实例

1. 访问当前实例信息

// 当前实例名
const name = this.ctx.instanceName;
// 当前实例对象
const instance = this.ctx.instance;
// 当前实例Id
const iid = this.ctx.instance.id;

2. 使用Model操作数据库

由于多实例的数据是相互隔离的，因此在操作数据库时，需要指定实例Id。VonaJS 提供了非常强大的Model对象，从而可以透明的处理多实例

// create
await this.scope.model.student.insert({ name: 'Tom' });
// select
await this.scope.model.student.select();
// get
await this.scope.model.student.get({ id: 1 });
// update
await this.scope.model.student.update({ id: 1, name: 'Jimmy' });
// delete
await this.scope.model.student.delete({ id: 1 });

当我们使用 Model student操作数据时，系统会自动设置实例Id

3. 使用Query Builder操作数据库

如果使用builder()方法操作数据库，就需要自行添加实例Id

await this.scope.model.student.builder().where({
  iid: this.ctx.instance.id,
  name: 'Tom',
});

如果使用builderSelect()方法操作数据库，系统会自动添加实例Id

await this.scope.model.student.builderSelect().where({
  name: 'Tom',
});

4. 使用原生Sql操作数据库

如果使用原生Sql操作数据库，就需要自行添加实例Id

await this.scope.model.student.query(
  'select * from demoStudent where iid=?',
  [this.ctx.instance.id],
);
await this.scope.model.student.queryOne(
  'select * from demoStudent where iid=? and id=?',
  [this.ctx.instance.id, 1],
);

Vona ORM已开源：https://github.com/vonajs/vona

Vona ORM分表全攻略

zhennann — Thu, 25 Sep 2025 07:17:58 GMT

分表

针对高并发、数据量大的场景，通常会考虑采用分表机制进行优化。下面以 Model User/Order 为例，通过查询用户的订单列表，来演示分表的使用方法

分表规则

比如需要对订单表进行分表操作。可以根据实际业务需求设计分表规则，在这里，根据用户Id取模动态生成表名。比如，拆分为16张表，用户Id为129，对应的表名如下：

const tableName = `Order_${129 % 16}`;  // Order_1

准备Models

先准备两个 Models：User/Order

Model Order

@Model({
  entity: EntityOrder,
})
class ModelOrder{}

Model User

@Model({
  entity: EntityUser,
  relations: {
    orders: $relation.hasMany(() => ModelOrder, 'userId'),
  },
})
class ModelUser {}

查询数据

1. 直接查询订单列表

class ServiceOrder {
  async selectOrdersDirectly() {
    const userId = 129;
    const orders = await this.scope.model.order.select({
      where: {
        userId,
      },
    });
  }
}

到目前为止，使用默认表名查询userId=129的订单列表

2. 基于关系查询订单列表

class ServiceOrder {
  async selectOrdersByRelation() {
    const userId = 129;
    const userAndOrders = await this.scope.model.user.get({
      id: userId,
    }, {
      include: {
        orders: true,
      },
    });
  }
}

到目前为止，使用默认表名查询userId=129的用户信息，使用默认表名查询该用户的订单列表

使用分表：动态方式

可以在代码中动态使用分表：

class ServiceOrder {
  async selectOrdersDirectly() {
    const userId = 129;
+   const tableName = `Order_${userId % 16}`;
+   const modelOrder = this.scope.model.order.newInstance(undefined, tableName as any);
    const orders = await modelOrder.select({
      where: {
        userId,
      },
    });
  }
}

newInstance: 传入要使用的表名，返回新的 Model 实例

到目前为止，使用分表查询userId=129的订单列表

使用分表：Relation动态选项

可以在 relation 选项中动态指定表名：

class ServiceOrder {
  async selectOrdersByRelation() {
    const userId = 129;
+   const tableName = `Order_${userId % 16}`;
    const userAndOrders = await this.scope.model.user.get({
      id: userId,
    }, {
      include: {
        orders: {
+         meta: {
+           table: tableName as any,
+         },
        },
      },
    });
  }
}

meta.table: 指定 relation orders要使用的表名

到目前为止，使用默认表名查询userId=129的用户信息，使用分表查询该用户的订单列表

使用分表：Model配置

也可以直接在 Model 中配置分表规则，从而简化查询代码

Model Order

@Model({
  entity: EntityOrder,
+ table(_ctx: VonaContext, where: EntityOrder | undefined, defaultTable: keyof ITableRecord) {
+   const userId = where?.userId;
+   if (!userId) return defaultTable;
+   return `Order_${Number(userId) % 16}`;
+ },
})
class ModelOrder{}

table: 指定函数，实现分表规则

查询数据

现在，又可以使用常规的方式查询用户的订单列表

class ServiceOrder {
  async selectOrdersDirectly() {
    const userId = 129;
    const orders = await this.scope.model.order.select({
      where: {
        userId,
      },
    });
  }
}

class ServiceOrder {
  async selectOrdersByRelation() {
    const userId = 129;
    const userAndOrders = await this.scope.model.user.get({
      id: userId,
    }, {
      include: {
        orders: true,
      },
    });
  }
}

使用分表：App Config配置

也可以在 App config 中配置 Model options:

src/backend/config/config/config.ts

// onions
config.onions = {
  model: {
    'test-vona:order': {
      table(_ctx: VonaContext, where: EntityOrder | undefined, defaultTable: keyof ITableRecord) {
        const userId = where?.userId;
        if (!userId) return defaultTable;
        return `Order_${Number(userId) % 16}`;
      },
    },
  },
};

于是，也可以使用常规的方式查询用户的订单列表

使用分表：Relation静态选项

也可以在定义 Relation 时指定静态选项：

@Model({
  entity: EntityUser,
  relations: {
    orders: $relation.hasMany(() => ModelOrder, 'userId', {
+     meta: {
+       table(_ctx: VonaContext, where: EntityOrder | undefined, defaultTable: keyof ITableRecord) {
+         const userId = where?.userId;
+         if (!userId) return defaultTable;
+         return `Order_${Number(userId) % 16}`;
+       },
+     },
    }),
  },
})
class ModelUser {}

同样，也可以使用常规的方式查询用户的订单列表

Vona ORM已开源：github.com/vonajs/vona

在Vona ORM中实现多数据库/多数据源

zhennann — Wed, 24 Sep 2025 02:07:28 GMT

在Vona ORM中实现多数据库/多数据源非常直观、简便。下面以 Model User/Order 为例，通过查询用户的订单列表，来演示多数据库/多数据源的使用方法

准备Models

先准备两个 Models：User/Order

Model Order

@Model({
  entity: EntityOrder,
})
class ModelOrder{}

需要指定ModelOrder关联的Entity，限于篇幅，EntityOrder代码从略

Model User

@Model({
  entity: EntityUser,
  relations: {
    orders: $relation.hasMany(() => ModelOrder, 'userId'),
  },
})
class ModelUser {}

在ModelUser中定义1:n关系: orders

查询数据

然后查询用户的订单列表

class ServiceOrder {
  async selectUserOrders() {
    const userId = 1;
    const userAndOrders = await this.scope.model.user.get(
      {
        id: userId,
      },
      {
        include: {
          orders: true,
        },
      },
    );
  }
}

到目前为止，使用系统默认数据源查询到了userId=1的用户信息，和该用户的所有订单列表

创建多数据源

接下来，创建两个数据源：user-pg和order-mysql

1. 添加数据源的类型定义

在 VSCode 中，通过右键菜单Vona Init/Types在模块中创建类型文件
然后在类型文件中添加类型定义

{module path}/src/types/index.ts

declare module 'vona-module-a-orm' {
  export interface IDatabaseClientRecord {
    'user-pg': never;
    'order-mysql': never;
  }
}

IDatabaseClientRecord是模块vona-module-a-orm提供的接口类型。在这里通过接口合并的机制来添加新的数据源类型

2. 数据源配置

在项目的App config文件中定义数据源的配置信息。由于前面已经添加了数据源类型，在App config文件中就可以享受完整的类型提示

src/backend/config/config/config.ts

// database
config.database = {
  clients: {
    'user-pg': {
      client: 'pg',
      connection: {
        host: '127.0.0.1',
        port: 5432,
        user: 'postgres',
        password: '',
        database: 'user-xxx',
      },
    },
    'order-mysql': {
      client: 'mysql2',
      connection: {
        host: '127.0.0.1',
        port: 3306,
        user: 'root',
        password: '',
        database: 'order-xxx',
      },
    },
  },
};

user-pg: 使用数据库方言：pg
order-mysql: 使用数据库方言：mysql2

使用数据源：动态方式

可以在代码中动态使用数据源：

class ServiceOrder {
  async selectUserOrders() {
    const userId = 1;
+   const modelUser = this.scope.model.user.newInstance('user-pg');
    const userAndOrders = await modelUser.get(
      {
        id: userId,
      },
      {
        include: {
          orders: true,
        },
      },
    );
  }
}

newInstance: 传入要使用的数据源，返回新的 Model 实例

到目前为止，使用数据源user-pg查询用户信息，使用系统默认数据源查询订单列表

使用数据源：Relation动态选项

可以在 relation 选项中动态指定数据源：

class ServiceOrder {
  async selectUserOrders() {
    const userId = 1;
    const modelUser = this.scope.model.user.newInstance('user-pg');
    const userAndOrders = await modelUser.get(
      {
        id: userId,
      },
      {
        include: {
          orders: {
+           meta: {
+             client: 'order-mysql',
+           },
          },
        },
      },
    );
  }
}

meta.client: 指定 relation orders要使用的数据源

到目前为止，使用数据源user-pg查询用户信息，使用数据源order-mysql查询订单列表

使用数据源：Model配置

也可以直接在 Model 中配置数据源，从而简化查询代码

Model Order

@Model({
  entity: EntityOrder,
+ client: 'order-mysql',
})
class ModelOrder{}

在VonaJS框架中，可以非常方便的为@Model装饰器指定参数

Model User

@Model({
  entity: EntityUser,
+ client: 'user-pg',
  relations: {
    orders: $relation.hasMany(() => ModelOrder, 'userId'),
  },
})
class ModelUser {}

查询数据

现在，又可以使用常规的方式查询用户的订单列表

class ServiceOrder {
  async selectUserOrders() {
    const userId = 1;
    const userAndOrders = await this.scope.model.user.get(
      {
        id: userId,
      },
      {
        include: {
          orders: true,
        },
      },
    );
  }
}

使用数据源：App Config配置

也可以在 App config 中配置 Model options:

src/backend/config/config/config.ts

// onions
config.onions = {
  model: {
    'test-vona:user': {
      client: 'user-pg',
    },
    'test-vona:order': {
      client: 'order-mysql',
    },
  },
};

在VonaJS框架中，可以在App Config文件中提供配置，用于覆盖对应Model的options配置

于是，也可以使用常规的方式查询用户的订单列表

使用数据源：Relation静态选项

也可以在定义 Relation 时指定静态选项：

@Model({
  entity: EntityUser,
  client: 'user-pg',
  relations: {
    orders: $relation.hasMany(() => ModelOrder, 'userId', {
+     meta: {
+       client: 'order-mysql',
+     },
    }),
  },
})
class ModelUser {}

同样，也可以使用常规的方式查询用户的订单列表

Vona ORM已开源：github.com/vonajs/vona

基于 uni-app 开发的废品回收类多端应用功能与界面说明

gooking — Tue, 23 Sep 2025 11:35:59 GMT

本文将对一款基于 uni-app 开发的废品回收类多端应用，从多端支持范围、核心功能模块及部分界面展示进行客观说明，相关资源信息也将一并呈现。

一、多端支持范围

该应用基于 uni-app 技术开发，支持打包为多终端形态，具体覆盖以下场景： H5 端多平台小程序（微信、支付宝、小红书、抖音等） App 端（适配 Android 与 iOS 两大移动操作系统）

二、核心功能模块说明

当前版本应用包含两大核心功能模块，各模块的作用与操作逻辑如下：

废品回收商家入驻模块此模块主要服务于废品回收商家的平台入驻需求，入驻后可实现以下操作：接收用户发起的回收订单；完成回收服务后，在系统内录入回收总量及对应回收金额。同时，用户可依据所在城市维度及当前定位，获取附近已入驻商家的推荐结果，进而选择 “预约上门回收” 或 “自行到店回收” 两种服务方式。
用户回收预约模块该模块为用户提供废品回收预约的全流程功能，具体操作步骤包括：选择预约上门时间、废品类型，填写预计回收总量，上传废品照片及补充描述信息，提交后即完成回收预约；回收服务完成后，用户可获得相应收益与积分；用户可通过应用内指定界面，提交收益提现申请。
后续功能说明除上述已实现的核心模块外，其他功能将以 “后续版本发布说明” 为准，具体更新内容需参考官方后续公示的信息。

三、相关资源获取地址

该应用的开发资源及代码可通过以下平台获取，供技术研究或参考使用： Github 地址码云镜像地址 GitCode 镜像地址

能够动态推断与生成DTO是Node生态的一个重要里程碑

zhennann — Thu, 04 Sep 2025 02:15:03 GMT

在开发后端 API 服务时，DTO 是进行参数验证、生成Swagger元数据的关键节点。如果不能像推断类型一样动态推断出 DTO，那么，我们就仍然需要手工创建 DTO。随着业务的增长，复杂的表间关系会让手工补充 DTO 的工作日益繁重

而 Vona ORM 首创 DTO 动态推断与生成能力，解放我们的双手，显著提升生产力。甚至可以说，对于构建更加优雅的 Node.js 后端框架而言，能够动态推断与生成 DTO，是非常重要的里程碑

DTO清单

Vona ORM 提供了以下 DTO：

名称	说明
get	标注返回结果
query	标注Query参数
queryPage	标注带分页的Query参数
selectAndCount	标注带分页的返回结果
create	标注Create参数
update	标注Update参数
aggregate	标注聚合操作的返回结果
group	标注分组操作的返回结果

DTO使用方法

下面以 Order/Product 为例，演示如何针对主表-明细表进行查询操作

1. Model关系定义

先在 Model Order 中定义与 Model Product 的1:n关系

@Model({
  entity: EntityOrder,
  relations: {
    products: $relation.hasMany(() => ModelProduct, 'orderId', {
      columns: ['id', 'name', 'price', 'quantity', 'amount'],
    }),
  },
})
class ModelOrder {}

relations.products: 定义1:n关系

2. 创建Api端点

创建 Controller，提供 findAll 方法

class ControllerOrder {
  @Web.get('findAll')
  async findAll() {
    return this.scope.model.order.select({
      include: {
        products: true,
      },
    });
  }
}

model.order: 是Order的model实例
select：指定include.products: true，从而查询出主表-明细表数据

3. 动态推断与生成DTO

由于此 Api 返回的结果是主表-明细表结构，我们不能简单的使用EntityOrder数组来标注返回类型。而是使用 DTO 进行动态推断与生成

+ import { $Dto } from 'vona-module-a-orm';

class ControllerOrder {
  @Web.get('findAll')
+ @Api.body(v.array($Dto.get(() => ModelOrder, { include: { products: true } })))
  async findAll() {
    return this.scope.model.order.select({
      include: {
        products: true,
      },
    });
  }
}

@Api.body：标注返回结果
v.array: 标注数组
$Dto.get: 用于动态推断与生成 DTO

$Dto.get生成的 DTO 是主表-明细表结构，其 Swagger/Openapi 效果如下：

4. 封装DTO

我们还可以创建一个新的 DTO class，将前面的$Dto.get动态推断代码封装起来，从而用于其他地方

在 VSCode 中，可以通过右键菜单Vona Create/Dto创建 DTO 的代码骨架：

@Dto()
export class DtoOrderResult {}

使用继承机制来封装 DTO：

+ import { $Dto } from 'vona-module-a-orm';

@Dto()
export class DtoOrderResult
+ extends $Dto.get(() => ModelOrder, { include: { products: true } }) {}

现在，我们再使用DtoOrderResult重构前面的 API 代码：

class ControllerOrder {
  @Web.get('findAll')
+ @Api.body(v.array(DtoOrderResult))
+ async findAll(): Promise<DtoOrderResult[]> {
    return this.scope.model.order.select({
      include: {
        products: true,
      },
    });
  }
}

行 3: 直接使用v.array(DtoOrderResult)标注类型
行 4: 方法返回类型为Promise<DtoOrderResult[]>

Vona ORM已开源：github.com/vonajs/vona

分享一个画流程图各种图的网站

dk002 — Tue, 26 Aug 2025 14:21:14 GMT

分享一个朋友的网站：刀刻网

支持 AI 生成：

用现有bootstrap的模板，改造成nuxt3项目

shenshuai89 — Mon, 25 Aug 2025 09:48:51 GMT

为了响应快速开发企业网站，并且能够适配移动端，完整的使用tailwind css写一套还挺复杂。

虽然有很多的UI框架，这些框架开发管理系统还可以，有着统一的UI风格，企业网站主要面向C端用户，有着不同设计风格需求，那么之前的bootstrap布局的页面还是很不错的选择。

比如就可以在模板王中下载一套项目代码，通过将内容和文字做一些修改，即可给客户使用。

接下来是改造的过程：

改造最初通过询问AI，给出了2个方案；

第一，使用bootstrap-vue-next，然后配合tailwind css进行改造【使用的此方法，改动量很大，放弃】；
第二，将js和css文件迁移的public目录下，然后在项目中加载，这样只需要将html文件修改为.vue的文件类型，然后修改很少的链接跳转方式即可。

本文中采用第二种方案。

迁移过程最痛苦的2件事，在vue中js的加载时机和迁移静态资源public/assets。

下载代码

本次改造的项目代码，原模板下载https://www.mobanwang.com/mb/demo/22705/；

也可以下载其他网络上的优秀的企业站代码。

├── about.html
├── assets
│   ├── css
│   │   ├── bootstrap.min.css
│   │   ├── em-breadcrumb.css
│   │   ├── plugin_theme_css.css
│   │   └── responsive.css
│   ├── fonts
│   │   ├── Flaticon.woff
│   │   ├── Flaticon.woff2
│   │   ├── Sofia Pro Bold.ttf
│   │   ├── aprova0698.eot
│   │   ├── aprova0698.svg
│   │   ├── aprova0698.ttf
│   │   ├── aprova0698.woff
│   │   ├── fontawesome-webfont3295.ttf
│   │   ├── fontawesome-webfont3295.woff
│   │   ├── fontawesome-webfont3295.woff2
│   │   ├── icofont.eot
│   │   ├── icofont.svg
│   │   ├── icofont.ttf
│   │   ├── icofont.woff
│   │   ├── icofont.woff2
│   │   ├── themify.ttf
│   │   └── themify.woff
│   ├── images
│   │   ├── about-img-1.jpg
│   │   ├── b1.jpg
│   │   ├── b2.jpg
│   │   ├── b3.jpg
│   │   ├── b4.jpg
│   │   ├── b5.jpg
│   │   ├── b6.jpg
│   │   ├── b7.jpg
│   │   ├── b8.jpg
│   │   ├── blog-sidebar1.jpg
│   │   ├── blog-sidebar2.jpg
│   │   ├── blog-sidebar3.jpg
│   │   ├── br1.jpg
│   │   ├── br2.jpg
│   │   ├── br3.jpg
│   │   ├── br4.jpg
│   │   ├── br5.jpg
│   │   ├── contact-bg.jpg
│   │   ├── faq-img.png
│   │   ├── favicon.png
│   │   ├── fottor-bg.jpg
│   │   ├── logo1.png
│   │   ├── logo2.png
│   │   ├── service-bg-img.jpg
│   │   ├── service-img.png
│   │   ├── single-blog.jpg
│   │   ├── single-service.jpg
│   │   ├── skill-img.jpg
│   │   ├── slide-03.jpg
│   │   ├── slider1.jpg
│   │   ├── slider2.jpg
│   │   ├── tab-img.jpg
│   │   ├── tab-img2.jpg
│   │   ├── tab-img3.jpg
│   │   ├── team-bg.jpg
│   │   ├── team1.jpg
│   │   ├── team1.png
│   │   ├── team2.jpg
│   │   ├── team2.png
│   │   ├── team3.jpg
│   │   ├── team3.png
│   │   ├── team4.png
│   │   ├── test1.png
│   │   ├── test2.png
│   │   ├── test3.png
│   │   └── test4.png
│   ├── js
│   │   ├── BeerSlider.js
│   │   ├── ajax-mail.js
│   │   ├── bootstrap.min.js
│   │   ├── bootstrap.min.js.map
│   │   ├── customizer.js
│   │   ├── imagesloaded.pkgd.min.js
│   │   ├── isotope.pkgd.min.js
│   │   ├── jquery.appear.js
│   │   ├── jquery.knob.js
│   │   ├── jquery.meanmenu.js
│   │   ├── jquery.nivo.slider.pack.js
│   │   ├── jquery.waitforimages.js
│   │   ├── map.js
│   │   ├── modernizr.custom.79639.js
│   │   ├── owl.carousel.min.js
│   │   ├── slick.min.js
│   │   ├── swiper-bundle.min.js.map
│   │   ├── theme-pluginjs.js
│   │   ├── theme.js
│   │   └── vendor
│   │       ├── jquery-3.5.1.min.js
│   │       └── modernizr-2.8.3.min.js
│   └── webfonts
│       ├── fa-brands-400.eot
│       ├── fa-brands-400.svg
│       ├── fa-brands-400.ttf
│       ├── fa-brands-400.woff
│       ├── fa-brands-400.woff2
│       ├── fa-regular-400.eot
│       ├── fa-regular-400.svg
│       ├── fa-regular-400.ttf
│       ├── fa-regular-400.woff
│       ├── fa-regular-400.woff2
│       ├── fa-solid-900.eot
│       ├── fa-solid-900.svg
│       ├── fa-solid-900.ttf
│       ├── fa-solid-900.woff
│       └── fa-solid-900.woff2
├── blog-left-sidebar.html
├── blog-right-sidebar.html
├── blog.html
├── contact.html
├── faq.html
├── home-video.html
├── index.html
├── landing-page.html
├── portfolio-3column.html
├── portfolio-4column.html
├── portfolio.html
├── pricing-table.html
├── service.html
├── single-blog.html
├── single-service.html
├── style.css
├── team.html
├── testimonial.html
└── venobox
    ├── close.gif
    ├── next.gif
    ├── preload-circle.png
    ├── preload-dots.png
    ├── preload-ios.png
    ├── preload-quads.png
    ├── preload.png
    ├── prev.gif
    ├── venobox.css
    ├── venobox.js
    └── venobox.min.js

9 directories, 133 files

迁移静态资源

分为3中情况

assets下的图片资源，统一存放到public/assets下，后边调整代码来获取该路径的资源
将assets下的js和css和font资源，放到public/assets下的js和css和font

将venobox和style.css文件也迁移到public/assets下，style.css可以放到public/assets/css的目录下，注意这里需要将style.css的图片引用，修改为相对引用地址。

将html结尾的文件，复制body部分的代码到vue文件的template中。

关于js脚本加载的问题

在bootstrap中，每个页面为独立html页面，打开都会加载js脚本，并且加载脚本的时间在dom结构渲染完成后进行加载。

那么在改写的vue中，就需要onMounted的生命周期中加载。

在改造过程中尝试了几种方案：

写到plugin中，通过nuxtApp.hook('app:mounted', async () => {})的生命周期时机进行加载，这种方法对index.vue页面生效，但是只加载了一次，对其他页面会失效。
第二种还是想放到插件中，让每个页面的路由之后，加载js

if (process.client) {
  const router = useRouter();

  // 监听路由变化，模拟每个页面的 mounted
  router.afterEach(async (to, from) => {
    console.log('页面 mounted 模拟:', to.path);
    // 在这里执行你的逻辑
    // 加载脚本、埋点、初始化第三方库等
    // const scripts = [
    //   '/js/vendor/modernizr-2.8.3.min.js',
    //   '/js/vendor/jquery-3.5.1.min.js',
    //   '/js/bootstrap.min.js',
    //   '/js/isotope.pkgd.min.js',
    //   '/js/owl.carousel.min.js',
    //   '/js/jquery.nivo.slider.pack.js',
    //   '/js/slick.min.js',
    //   '/venobox/venobox.min.js',
    //   '/js/imagesloaded.pkgd.min.js',
    //   '/js/jquery.appear.js',
    //   '/js/jquery.knob.js',
    //   '/js/BeerSlider.js',
    //   '/js/theme-pluginjs.js',
    //   '/js/jquery.meanmenu.js',
    //   '/js/ajax-mail.js',
    //   '/js/theme.js',
    // ];

    // for (const src of scripts) {
    //   try {
    //     await loadScript(src);
    //     console.log('脚本加载成功:', src);

    //   } catch (err) {
    //     console.error(err);
    //   }
    // }
  });
}

这种方案不能使用<nuxt-link>标签，使用此标签跳转的页面，还是无法正常加载和显示页面。使用<a>时可以生效，但是会刷新页面。

也放弃了这个方案

使用composables下写一个公用的加载js的函数方法，在每个页面的onMounted周期中调用一下，这算是最好的解决办法。

// 缓存已加载的脚本
const loadedScripts = new Set<string>();

const loadScript = (src: string) => {
  return new Promise((resolve, reject) => {
    if (loadedScripts.has(src)) {
      resolve(true);
      return;
    }

    const script = document.createElement('script');
    script.src = src;
    script.defer = true;

    script.onload = () => {
      loadedScripts.add(src);
      resolve(true);
    };

    script.onerror = () => {
      reject(new Error(`Failed to load script: ${src}`));
    };

    document.body.appendChild(script);
  });
};
export const loadScriptClient = async () => {
  const script1 = document.createElement('script');
  script1.src = '/js/vendor/modernizr-2.8.3.min.js';
  document.body.appendChild(script1);

  const script2 = document.createElement('script');
  script2.src = '/js/vendor/jquery-3.5.1.min.js';
  document.body.appendChild(script2);

  const script3 = document.createElement('script');
  script3.src = '/js/bootstrap.min.js';
  document.body.appendChild(script3);

  const script4 = document.createElement('script');
  script4.src = '/js/isotope.pkgd.min.js';
  document.body.appendChild(script4);

  const script5 = document.createElement('script');
  script5.src = '/js/owl.carousel.min.js';
  document.body.appendChild(script5);

  const script6 = document.createElement('script');
  script6.src = '/js/jquery.nivo.slider.pack.js';
  document.body.appendChild(script6);

  const script7 = document.createElement('script');
  script7.src = '/js/slick.min.js';
  document.body.appendChild(script7);

  const script18 = document.createElement('script');
  script18.src = '/venobox/venobox.min.js';
  document.body.appendChild(script18);

  const script8 = document.createElement('script');
  script8.src = '/js/imagesloaded.pkgd.min.js';
  document.body.appendChild(script8);

  const script9 = document.createElement('script');
  script9.src = '/js/jquery.appear.js';
  document.body.appendChild(script9);

  const script10 = document.createElement('script');
  script10.src = '/js/jquery.knob.js';
  document.body.appendChild(script10);

  const script11 = document.createElement('script');
  script11.src = '/js/BeerSlider.js';
  document.body.appendChild(script11);

  const script12 = document.createElement('script');
  script12.src = '/js/theme-pluginjs.js';
  document.body.appendChild(script12);

  const script13 = document.createElement('script');
  script13.src = '/js/jquery.meanmenu.js';
  document.body.appendChild(script13);

  const script14 = document.createElement('script');
  script14.src = '/js/ajax-mail.js';
  document.body.appendChild(script14);

  const script15 = document.createElement('script');
  script15.src = '/js/theme.js';
  document.body.appendChild(script15);
  
};

在vue的页面中进行调用

// 初始化脚本
onMounted(() => {
  loadScriptClient();
})

关于图片资源引用的问题

public/css内部应用的图片路径地址

public/assets/css内部应用的图片路径地址，是public/assets/images中的资源；

.consit_service_area2 {
    background-image: url("../images/port-bg-img.jpg");
    background-repeat: no-repeat;
    background-size: cover;
    padding: 120px 0px 110px;
}

vue文件的template的图片

template模版内的图片引入：

使用"/assets/images/logo1.png"的也是public/assets/images目录的资源。
如果代码"assets/images/logo1.png"则是使用了assets/images目录资源

<template>
  <div class="mobile_menu_logo text-center">
    <a href="index.html" title="consit">
      <img src="/assets/images/logo1.png" alt="consit" />
    </a>
  </div>
</template>

vue文件的template的style中使用图片

在template中的style添加背景图片，这里如果正常使用/assets/images/logo1.png，就会引用到/assets/images的资源，而不是public/assets/image的资源。

下面代码引用了 `assets/image`的资源

这里不管有没有 / 路径，都是使用的 assets/image

<template>
  <div
      class="swiper-slide d1 t1 m1 witr_swiper_height"
      style="background-image:	url(/assets/images/slider1.jpg)"
    >
    1111
  </div>
</template>

可以结合script，使用public的资源；

主要思路是通过动态导入图片资源，然后在绑定到style中

<template>
  <div
      class="swiper-slide d1 t1 m1 witr_swiper_height"
      :style="{ backgroundImage: `url(${slider1})` }"
    >
    1111
  </div>
</template>
<script setup>
  // vue script内引入assets图片的方法
  import slider1 from '/assets/images/slider1.jpg';
</script>

迁移完成后代码结构

./
├── README.md
├── app.vue
├── components
│   ├── navFooter.vue
│   └── navHeader.vue
├── composables
│   └── index.ts
│── nuxt.config.ts
├── package.json
├── pages
│   ├── about.vue
│   ├── blog.vue
│   ├── blogLeft.vue
│   ├── blogRight.vue
│   ├── contact.vue
│   ├── faq.vue
│   ├── homeVideo.vue
│   ├── index.vue
│   ├── landingPage.vue
│   ├── portfolio.vue
│   ├── portfolio3column.vue
│   ├── portfolio4column.vue
│   ├── pricingTable.vue
│   ├── service.vue
│   ├── serviceSingle.vue
│   ├── singleBlog.vue
│   ├── team.vue
│   └── testimonial.vue
├── plugins
│   └── load-script.client.ts
├── pnpm-lock.yaml
├── public
│   ├── assets
│   │   └── images
│   │       ├── about-img-1.jpg
│   │       ├── b1.jpg
│   │       ├── b2.jpg
│   │       ├── b3.jpg
│   │       ├── b4.jpg
│   │       ├── ...
│   │       ├── css
│   │       │   ├── bootstrap.min.css
│   │       │   ├── em-breadcrumb.css
│   │       │   ├── plugin_theme_css.css
│   │       │   ├── responsive.css
│   │       │   └── style.css
│   │       ├── fonts
│   │       │   ├── Flaticon.woff
│   │       │   ├── ...
│   │       ├── js
│   │       │   ├── BeerSlider.js
│   │       │   ├── ajax-mail.js
│   │       │   ├── ...
│   │       ├── venobox
│   │       │   ├── close.gif
│   │       │   ├── next.gif
│   │       │   ├── preload-circle.png
│   │       │   ├── preload-dots.png
│   │       │   ├── preload-ios.png
│   │       │   ├── preload-quads.png
│   │       │   ├── preload.png
│   │       │   ├── prev.gif
│   │       │   ├── venobox.css
│   │       │   ├── venobox.js
│   │       │   └── venobox.min.js
│   │       └── webfonts
│   │           ├── fa-brands-400.eot
│   │           ├── fa-brands-400.svg
│   │           ├── ... 
│   ├── favicon.ico
│   ├── favicon.png
│   ├── robots.txt
└── tsconfig.json

29 directories, 146 files

以上是将bootstrap项目转为nuxt项目的代码结构。

关于接口调用和打包发布上线的操作

详细的操作和项目代码仓库，放置到个人网站中，如有需要请查看；

文章地址：https://shenshuai89.github.io/pages/3926f2/
线上预览地址：https://www.shenshuai.site/nuxtapp202504114/

Node.js 主流ORM框架动态分表方案大盘点

zhennann — Sun, 24 Aug 2025 08:50:22 GMT

针对高并发、数据量大的场景，通常会考虑采用分库分表进行优化。在这篇文章，我们重点盘点一下Node.js主流ORM框架的动态分表方案：

分表规则

比如我们需要对订单表进行分表操作。可以根据实际业务需求设计分表规则，在这里，我们根据顾客Id取模动态生成表名。比如，拆分为16张表，顾客Id为129，对应的表名如下：

const tableName = `Order_${129 % 16}`;  // Order_1

TypeORM

在TypeORM中可以按照如下方式设置动态表名：

// 获取repository
const repositoryOrder = dataSource.createQueryBuilder().connection.getRepository(EntityOrder);
// 设置动态表名
const userId = 129;
const tableName = `Order_${userId % 16}`;
repositoryOrder.metadata.tablePath = tableName;
// 查询订单
const orders = await repositoryOrder.find();

Drizzle ORM

schema.ts

const orderFactory = userId => pgTable(
  `Order_${userId % 16}`,
  {
    id: serial('id').primaryKey(),  
    name: text('name').notNull(),
  },
);

export const order0 = orderFactory(0);
...
export const order15 = orderFactory(15);

query.ts

import * as schema from './db/schema';

const db = drizzle(process.env.DATABASE_URL!, { schema });

const userId = 129;
const modelName=`order${userId % 16}`;
const orders = await db.query[modelName].findMany();

Prisma ORM

Prisma ORM对动态表名的支持还在规划当中，参见：Table Partitioning

作为备选方案，我们可以使用$queryRawUnsafe直接构造原始SQL：

const userId = 129;
const tableName = `Order_${userId % 16}`;  
const orders = await prisma.$queryRawUnsafe(`SELECT * FROM "${tableName}"`);

Vona ORM

Vona ORM提供了两种模式：自动模式/手工模式

1. 自动模式

model/order.ts

import { EntityOrder } from '../entity/order.ts';

@Model({
  entity: EntityOrder,
  table(ctx: VonaContext, defaultTable: keyof ITableRecord) {
    const user = ctx.app.bean.passport.getCurrentUser();
    if (!user) return defaultTable;
    return `${defaultTable}_${Number(user.id) % 16}`;
  },
})
export class ModelOrder {}

defaultTable: 是在EntityOrder中定义的缺省表名，如：Order

service/order.ts

class ServiceOrder {
  async findAll() {
    return await this.scope.model.order.select();
  }
}

2. 手工模式

service/order.ts

class ServiceOrder {
  async findAll() {
    const user = this.bean.passport.getCurrentUser();
    const tableName = `Order_${Number(user!.id) % 16}`;
    const modelOrder = this.scope.model.order.newInstance(undefined, tableName as any);
    return await modelOrder.select();
  }
}

newInstance: 第一个参数可以传入数据源，从而实现分库能力。这里忽略，因此传入undefined

这个Database Transaction功能多多，你用过吗？

zhennann — Thu, 21 Aug 2025 03:53:30 GMT

Vona 是一款直观、优雅、强大的 Node.js Web 框架，用于快速开发任何规模的企业级应用。首创 DTO 动态推断与生成能力，从而显著提升开发效率和开发体验。Vona ORM 对数据库事务提供了完整的支持，提供了直观、优雅、强大的特性：

使用装饰器启用事务
事务传播机制
事务补偿机制
确保数据库与缓存数据一致性

使用装饰器启用事务

import { Database } from 'vona-module-a-orm';

class ServicePost {
  @Database.transaction()
  async transaction() {
    // insert
    const post = await this.scope.model.post.insert({
      title: 'Post001',
    });
    // update
    await this.scope.model.post.update({
      id: post.id,
      title: 'Post001-Update',
    });
  }
}

手工启用事务

1. 使用当前数据源

class ServicePost {
  async transactionManually() {
    const db = this.bean.database.current;
    await db.transaction.begin(async () => {
      await this.scope.model.post.update({ id: 1, title: 'Post001_Update' });
    });
  }
}

2. 使用指定数据源

class ServicePost {
  async transactionManually() {
    const db = this.bean.database.getDb({ clientName: 'default' });
    await db.transaction.begin(async () => {
      const modelPost = this.scope.model.post.newInstance(db);
      await modelPost.update({ id: 1, title: 'Post001_Update' });
    });
  }
}

事务参数

class ServicePost {
  @Database.transaction({
+   isolationLevel: 'READ_COMMITTED',
+   propagation: 'REQUIRED'
  })
  async transaction() {
    ...
  }
}

class ServicePost {
  async transactionManually() {
    const db = this.bean.database.getDb({ clientName: 'default' });
    await db.transaction.begin(
      async () => {
        ...
      },
      {
+       isolationLevel: 'READ_COMMITTED',
+       propagation: 'REQUIRED',
      }
    );
  }
}

事务参数：isolationLevel

名称	说明
DEFAULT	数据库相关的缺省isolationLevel
READ_UNCOMMITTED
READ_COMMITTED
REPEATABLE_READ
SERIALIZABLE
SNAPSHOT

事务参数：propagation

Vona ORM 支持数据库事务传播机制

名称	说明
REQUIRED	默认的事务传播级别。如果当前存在事务, 则加入该事务。如果当前没有事务, 则创建一个新的事务
SUPPORTS	如果当前存在事务，则加入该事务. 如果当前没有事务, 则以非事务的方式继续运行
MANDATORY	强制性。如果当前存在事务, 则加入该事务。如果当前没有事务，则抛出异常
REQUIRES_NEW	创建一个新的事务。如果当前存在事务, 则把当前事务挂起。也就是说不管外部方法是否开启事务，总是开启新的事务, 且开启的事务相互独立, 互不干扰
NOT_SUPPORTED	以非事务方式运行。如果当前存在事务，则把当前事务挂起(不用)
NEVER	以非事务方式运行。如果当前存在事务，则抛出异常

事务补偿机制

当事务成功或者失败时执行一些逻辑

1. 成功补偿

this.bean.database.current.commit(async () => {
  // do something when success
});

2. 失败补偿

this.bean.database.current.compensate(async () => {
  // do something when failed
});

事务与Cache数据一致性

许多框架使用最简短的用例来证明是否高性能，而忽略了业务复杂性带来的性能挑战。随着业务的增长和变更，项目性能就会断崖式下降，各种优化补救方案让项目代码繁杂冗长。而 Vona 正视大型业务的复杂性，从框架核心引入缓存策略，并实现了二级缓存、Query缓存和Entity缓存等机制，轻松应对大型业务系统的开发，可以始终保持代码的优雅和直观

Vona 系统对数据库事务与缓存进行了适配，当数据库事务失败时会自动执行缓存的补偿操作，从而让数据库数据与缓存数据始终保持一致

针对这个场景，Vona 提供了内置的解决方案

1. 使用当前数据源

class ServicePost {
  @Database.transaction()
  async transaction() {
    // insert
    const post = await this.scope.model.post.insert({
      title: 'Post001',
    });
    // cache
    await this.scope.cacheRedis.post.set(post, post.id);
  }
}

当新建数据后，将数据放入 redis 缓存中。如果这个事务出现异常，就会进行数据回滚，同时缓存数据也会回滚，从而让数据库数据与缓存数据保持一致

2. 使用指定数据源

class ServicePost {
  async transactionManually() {
    const db = this.bean.database.getDb({ clientName: 'default' });
    await db.transaction.begin(async () => {
      const modelPost = this.scope.model.post.newInstance(db);
      const post = await modelPost.insert({ title: 'Post001' });
      await this.scope.cacheRedis.post.set(post, post.id, { db });
    });
  }
}

如果对指定的数据库进行操作，那么就需要将数据库对象db传入缓存，从而让缓存针对数据库对象db执行相应的补偿操作。当数据库事务回滚时，让数据库数据与缓存数据保持一致

题目：如何在node 16上执行claude code（cc只能跑在node 18+）？

i5ting — Wed, 20 Aug 2025 13:41:27 GMT

在node 16下，把cc安装在node 22下面。然后node 16下执行node 22下面的cc。。。

第一次见过这么骚的操作

如何基于动态关系进行ORM关联查询，并动态推断DTO？

zhennann — Fri, 08 Aug 2025 03:35:37 GMT

在上一篇文章（Prisma不能优雅的支持DTO，试试Vona ORM吧）中，我们基于静态关系实现了目录树的关联查询，并且动态推断生成了DTO（用于Swagger元数据）。在这篇文章我们探讨动态关系的用法。

什么是动态关系

那么，什么是动态关系呢？在大型业务系统中，我们会创建大量数据模型，这些数据模型之间的关联众多，我们不可能将所有关联通过静态关系的机制事先声明出来。特别是当存在大量业务模块，这些数据模型散落在不同的业务模块中，那么通过静态关系事先声明所有的关联关系也变得不太现实。比如，Prisma就只支持静态关系。如果事先没有定义静态关系，在实际代码中，我们就需要提供一种使用动态关系的机制，让我们的查询、类型推断、DTO推断等能力得以正常使用。

准备数据模型

在上一篇文章中，我们已经介绍了如何创建Entity和Model，这里不再赘述。而是直接把Order和Customer的Entity和Model罗列出来，然后演示动态关系的用法

Entity

1. Order

@Entity()
export class EntityOrder extends EntityBase {
  @Api.field(v.openapi({ title: $locale('OrderNo') }), v.default(''), v.min(3))
  orderNo: string;

  @Api.field(v.title($locale('Remark')), v.optional())
  remark?: string;

  @Api.field(v.tableIdentity())
  customerId: TableIdentity;
}

v.openapi：声明字段的元数据，用于Swagger
- title：采用$locale定义，从而让Swagger元数据支持多语言能力
v.title：等价于v.openapi({ title: … })
TableIdentity：string | number

2. Customer

@Entity()
export class EntityCustomer extends EntityBase {
  @Api.field(v.min(3))
  name: string;
}

Model

1. Order

@Model({ entity: EntityOrder })
export class ModelOrder extends BeanModelBase {}

2. Customer

@Model({ entity: EntityCustomer })
export class ModelCustomer extends BeanModelBase {}

基于`动态关系`的查询

现在我们查询订单列表，包含归属的顾客信息：

const orders = await this.scope.model.order.select({
  with: {
    customer: $relationDynamic.belongsTo(
      () => ModelOrder,
      () => ModelCustomer,
      'customerId',
    ),
  },
});

$relationDynamic:提供一组工具，用于定义动态关系
belongsTo：定义多对一的关系
- 参数1：Order模型
- 参数2：Customer模型
- 参数3：设置关联外键customerId

下面我们看一下orders的类型推断效果：

自动推断DTO

现在我们自动推断DTO，并且设为API的返回数据的类型：

const DtoOrderResult = $Dto.get(
  () => ModelOrder,
  {
    with: {
      customer: $relationDynamic.belongsTo(
        () => ModelOrder,
        () => ModelCustomer,
        'customerId',
      ),
    },
  },
);

@Controller('order')
export class ControllerOrder extends BeanBase {
  @Web.get()
  @Api.body(v.array(v.object(DtoOrderResult)))
  async findAll() {
    return await this.scope.service.order.findAll();
  }
}

行1：动态创建DtoOrderResult
行17：将DtoOrderResult用于Swagger/Openapi的元数据

下面我们看一下API的Swagger效果：

封装DTO

我们还可以创建一个新的DTO，将前面动态创建的DtoOrderResult封装起来，从而用于其他地方：

在VSCode中，可以通过右键菜单Vona Create/Dto创建DTO的代码骨架：

@Dto()
export class DtoOrderResult {}

然后我们通过继承机制来封装DTO：

const DtoOrderResultDynamic = $Dto.get(
  () => ModelOrder,
  {
    with: {
      customer: $relationDynamic.belongsTo(
        () => ModelOrder,
        () => ModelCustomer,
        'customerId',
      ),
    },
  },
);

@Dto()
export class DtoOrderResult extends DtoOrderResultDynamic {}

现在，我们再使用新创建的DTO来改造前面的API代码：

+ import { DtoOrderResult } from '../dto/orderResult.ts';

@Controller('order')
export class ControllerOrder extends BeanBase {
  @Web.get()
+ @Api.body(v.array(v.object(DtoOrderResult)))
+ async findAll(): Promise<DtoOrderResult[]> {
    return await this.scope.service.order.findAll();
  }
}

行6: 直接传入DtoOrderResult
行7: 返回类型为Promise<DtoOrderResult[]>

结语

Vonajs已开源：https://github.com/vonajs/vona。

Vonajs作者正在B站直播撰写技术文档，工作日每晚8:30，欢迎围观：濮水代码直播间

Prisma不能优雅的支持DTO，试试Vona ORM吧

zhennann — Tue, 05 Aug 2025 08:50:12 GMT

在Nodejs生态中，Prisma是一个非常流行的ORM库，支持Typescript，提供了非常友好的类型推断能力。但是，Prisma却不能优雅的支持DTO。在与其他后端框架整合时，DTO是进行参数验证、生成Swagger元数据的关键节点。如果不能像推断类型一样自动推断出DTO，那么，我们就仍然需要手工创建DTO。随着业务的增长，复杂的表间关系会让手工补充DTO的工作日益繁重。

而Vona ORM就提供了非常便利的工具，使我们可以非常直观的动态推断出DTO，就像推断类型一样，从而解放我们的双手，显著提升生产力。甚至可以说，能够自动推断DTO，为Nodejs后端框架打开了一扇窗。

Vona本身就是一款更直观的Nodejs框架，如果大家第一次接触，可以先参考这篇文章：你认为Vonajs提供的这些特性会比Nestjs更好用吗？

限于篇幅，这里不展开讲解Vona ORM所有的知识点，而是以目录树为例，演示如何查询一棵目录树，以及如何动态生成DTO，并最终生成Swagger元数据。Vona框架作者正在直播撰写Vona文档。围观官方文档的实时编写过程，有利于加深对框架设计的理解，探索不一样的架构设计路径。有兴趣的欢迎移步：B站濮水代码直播间

1. 创建Entity

在VSCode中，可以通过右键菜单Vona Create/Entity创建Entity的代码骨架：

@Entity('demoStudentCategory')
export class EntityCategory extends EntityBase {
  @Api.field()
  name: string;

  @Api.field(v.optional())
  categoryIdParent?: TableIdentity;
}

行2: 继承自EntityBase，就会自动提供5个基础字段：id、createdAt、updatedAt、deleted、iid
- iid：是实例Id，通过多实例的机制支持多租户系统的开发
行4、7: 定义两个业务字段：name、categoryIdParent
@Api.field：通过此装饰器定义的信息，可同时应用于参数验证和Swagger元数据
v.optional：声明为可选字段
更多信息，参见：Vona Entity

2. 创建Model

在VSCode中，可以通过右键菜单Vona Create/Model创建Model的代码骨架：

import { EntityCategory } from '../entity/category.ts';

@Model({ entity: EntityCategory })
export class ModelCategory extends BeanModelBase<EntityCategory> {}

行3: entity：指定Model所对应的Entity
行4: 继承自BeanModelBase，从而拥有大量操作数据库的方法，如：CRUD、聚合、分组，等等

3. 创建树形结构

如果要创建一棵目录树，本质就是建立Model引用自身的递归结构。Vona ORM同样支持4种关系：1对1、1对多、多对1，多对多。那么，在这里，我们就需要采用1对多来创建目录的自身引用关系。

import { EntityCategory } from '../entity/category.ts';

@Model({
  entity: EntityCategory,
+ relations: {
+   children: $relation.hasMany(() => ModelCategory, 'categoryIdParent', {
+     autoload: true,
+     columns: ['id', 'name'],
+   }),
+ },
})
export class ModelCategory extends BeanModelBase<EntityCategory> {}

行5: relations：可以定义多个关系
行6: children：定义一个1对多的关系
$relation.hasMany：
- 参数1: 引用自身ModelCategory
- 参数2: 设置关联外键categoryIdParent
- 参数3: 关联选项
  - autoload：是否自动加载关联数据
  - columns：控制关联数据的字段列表

4. 创建Controller

在VSCode中，可以通过右键菜单Vona Create/Controller创建Controller的代码骨架：

@Controller()
export class ControllerCategory extends BeanBase {}

接下来我们创建一个Api，用于获取目录树：

export class ControllerCategory extends BeanBase {
  @Web.get('getCategoryTree')
  async getCategoryTree() {
  }
}

行2: 通过@Web.get定义一个api，path为getCategoryTree

5. 查询目录树

一般而言，我们还需要创建一个Service，从而实现以下调用链：Controller->Service->Model->操作数据库。为了简化起见，在这里，我们直接在Controller中调用Model方法：

export class ControllerCategory extends BeanBase {
  @Web.get('getCategoryTree')
  async getCategoryTree() {
    const tree = await this.scope.model.category.select({
      columns: ['id', 'name'],
    });
    return tree;
  }
}

行4: 通过this.scope取得Category Model，然后调用select方法
- columns：指定要查询的字段列表

由于前面我们设置children关系为autoload: true，因此，查询结果tree就是一棵完整的目录树。下面我们看一下tree的类型推断效果：

6. 自动推断DTO

现在我们自动推断DTO，并且设为API的返回数据的类型：

export class ControllerCategory extends BeanBase {
  @Web.get('getCategoryTree')
+ @Api.body(v.array(v.object($Dto.get(() => ModelCategory, { columns: ['id', 'name'] }))))
  async getCategoryTree() {
    const tree = await this.scope.model.category.select({
      columns: ['id', 'name'],
    });
    return tree;
  }
}

行3: 通过@Api.body定义API返回数据的类型：
- v.array：定义数组类型
- v.object：定义对象类型
$Dto.get：动态推断DTO
- 参数1：指定目标Model
- 参数2：指定选项
  - columns：指定要提取的字段列表

同样，由于前面我们设置children关系为autoload: true，因此，$Dto.get生成的DTO就是一棵完整的目录树。下面我们看一下API的Swagger效果：

从示意图中，我们可以清晰的看到，这棵树引用的children类型是名称为demo-student.entity.category_2c7d642ee581efa300341e343180fbb0ecdc785d的动态Entity的数组，从而形成一种递归的引用关系。

7. 封装DTO

虽然我们已经实现了预期的目标，但是Vona ORM提供的能力还没有结束。我们可以创建一个新的DTO，将前面的代码$Dto.get(() => ModelCategory, { columns: ['id', 'name'] })封装起来，从而用于其他地方：

在VSCode中，可以通过右键菜单Vona Create/Dto创建DTO的代码骨架：

@Dto()
export class DtoCategoryTree {}

然后我们通过继承机制来封装DTO：

@Dto()
export class DtoCategoryTree 
+ extends $Dto.get(() => ModelCategory, { columns: ['id', 'name'] }) {}

现在，我们再使用新创建的DTO来改造前面的API代码：

export class ControllerCategory extends BeanBase {
  @Web.get('getCategoryTree')
+ @Api.body(v.array(v.object(DtoCategoryTree)))
+ async getCategoryTree(): Promise<DtoCategoryTree[]>{
    const tree = await this.scope.model.category.select({
      columns: ['id', 'name'],
    });
    return tree;
  }
}

行3: 直接传入DtoCategoryTree
行4: 返回类型为Promise<DtoCategoryTree[]>

结语

Vonajs已开源：https://github.com/vonajs/vona。

Vonajs作者正在B站直播撰写技术文档，工作日每晚8:30，欢迎围观：濮水代码直播间

docx-handlebars 一个用于处理 DOCX 文件 Handlebars 模板的 Rust 库，支持多平台使用

151263 — Wed, 23 Jul 2025 12:36:14 GMT

docx-handlebars

中文文档 | English | Demo

一个用于处理 DOCX 文件 Handlebars 模板的 Rust 库，支持多平台使用：

Rust 原生
WebAssembly (WASM)
npm 包
Node.js
Deno
浏览器端
JSR (JavaScript Registry)

功能特性

✅ 智能合并：自动处理被 XML 标签分割的 Handlebars 语法
✅ DOCX 验证：内置文件格式验证，确保输入文件有效
✅ Handlebars 支持：完整的模板引擎，支持变量、条件、循环、Helper 函数
✅ 跨平台：Rust 原生 + WASM 支持多种运行时
✅ TypeScript：完整的类型定义和智能提示
✅ 零依赖：WASM 二进制文件，无外部依赖
✅ 错误处理：详细的错误信息和类型安全的错误处理

安装

Rust

cargo add docx-handlebars

npm

npm install docx-handlebars

Deno

import { render_template, init } from "jsr:@sail/docx-handlebars";

使用示例

Rust

use docx_handlebars::render_template;
use serde_json::json;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 读取 DOCX 模板文件
    let template_bytes = std::fs::read("template.docx")?;
    
    // 准备数据
    let data = json!({
        "name": "张三",
        "company": "ABC科技有限公司",
        "position": "软件工程师",
        "projects": [
            {"name": "项目A", "status": "已完成"},
            {"name": "项目B", "status": "进行中"}
        ],
        "has_bonus": true,
        "bonus_amount": 5000
    });
    
    // 渲染模板
    let result = render_template(template_bytes, &data)?;
    
    // 保存结果
    std::fs::write("output.docx", result)?;
    
    Ok(())
}

JavaScript/TypeScript (Node.js)

import { render_template, init } from 'docx-handlebars';
import fs from 'fs';

async function processTemplate() {
    // 初始化 WASM 模块
    await init();
    
    // 读取模板文件
    const templateBytes = fs.readFileSync('template.docx');
    
    // 准备数据
    const data = {
        name: "李明",
        company: "XYZ技术有限公司",
        position: "高级开发工程师",
        projects: [
            { name: "E-commerce平台", status: "已完成" },
            { name: "移动端APP", status: "开发中" }
        ],
        has_bonus: true,
        bonus_amount: 8000
    };
    
    // 渲染模板
    const result = render_template(templateBytes, JSON.stringify(data));
    
    // 保存结果
    fs.writeFileSync('output.docx', new Uint8Array(result));
}

processTemplate().catch(console.error);

Deno

import { render_template, init } from "https://deno.land/x/docx_handlebars/mod.ts";

async function processTemplate() {
    // 初始化 WASM 模块
    await init();
    
    // 读取模板文件
    const templateBytes = await Deno.readFile("template.docx");
    
    // 准备数据
    const data = {
        name: "王小明",
        department: "研发部",
        projects: [
            { name: "智能客服系统", status: "已上线" },
            { name: "数据可视化平台", status: "开发中" }
        ]
    };
    
    // 渲染模板
    const result = render_template(templateBytes, JSON.stringify(data));
    
    // 保存结果
    await Deno.writeFile("output.docx", new Uint8Array(result));
}

if (import.meta.main) {
    await processTemplate();
}

浏览器端

<!DOCTYPE html>
<html>
<head>
    <title>DOCX Handlebars 示例</title>
</head>
<body>
    <input type="file" id="fileInput" accept=".docx">
    <button onclick="processFile()">处理模板</button>
    
    <script type="module">
        import { render_template, init } from './pkg/docx_handlebars.js';
        
        // 初始化 WASM
        await init();
        
        window.processFile = async function() {
            const fileInput = document.getElementById('fileInput');
            const file = fileInput.files[0];
            
            if (!file) return;
            
            const arrayBuffer = await file.arrayBuffer();
            const templateBytes = new Uint8Array(arrayBuffer);
            
            const data = {
                name: "张三",
                company: "示例公司"
            };
            
            try {
                const result = render_template(templateBytes, JSON.stringify(data));
                
                // 下载结果
                const blob = new Blob([new Uint8Array(result)], {
                    type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
                });
                const url = URL.createObjectURL(blob);
                const a = document.createElement('a');
                a.href = url;
                a.download = 'processed.docx';
                a.click();
            } catch (error) {
                console.error('处理失败:', error);
            }
        };
    </script>
</body>
</html>

模板语法

基础变量替换

员工姓名: {{name}}
公司: {{company}}
职位: {{position}}

条件渲染

{{#if has_bonus}}
奖金: ¥{{bonus_amount}}
{{else}}
无奖金
{{/if}}

{{#unless is_intern}}
正式员工
{{/unless}}

循环渲染

项目经历:
{{#each projects}}
- {{name}}: {{description}} ({{status}})
{{/each}}

技能列表:
{{#each skills}}
{{@index}}. {{this}}
{{/each}}

Helper 函数

内置的 Helper 函数：

{{upper name}}           <!-- 转大写 -->
{{lower company}}        <!-- 转小写 -->
{{len projects}}         <!-- 数组长度 -->
{{#if (eq status "completed")}}已完成{{/if}}    <!-- 相等比较 -->
{{#if (gt score 90)}}优秀{{/if}}               <!-- 大于比较 -->
{{#if (lt age 30)}}年轻{{/if}}                 <!-- 小于比较 -->

<!-- 图片插入 -->
{{img base64_data}}                    <!-- 嵌入式图片 -->
{{img base64_data 300 200}}           <!-- 指定宽高的嵌入式图片 -->
{{img base64_data 300 200 options}}   <!-- 带定位选项的浮动图片 -->

复杂示例

=== 员工报告 ===

基本信息:
姓名: {{employee.name}}
部门: {{employee.department}}
职位: {{employee.position}}
入职时间: {{employee.hire_date}}

{{#if employee.has_bonus}}
 奖金: ¥{{employee.bonus_amount}}
{{/if}}

项目经历 (共{{len projects}}个):
{{#each projects}}
{{@index}}. {{name}}
   描述: {{description}}
   状态: {{status}}
   团队规模: {{team_size}}人
   
{{/each}}

技能评估:
{{#each skills}}
- {{name}}: {{level}}/10 ({{years}}年经验)
{{/each}}

在表格中若需要删除一整行, 只需要在任意单元格上添加:
{{removeTableRow}}


{{#if (gt performance.score 90)}}
 绩效评级: 优秀
{{else if (gt performance.score 80)}}
 绩效评级: 良好
{{else}}
 绩效评级: 需改进
{{/if}}

图片:
{{img base64_image_data [width] [height] [options]}}
  只传 height：{{img base64 "" 200}}
  只传 width：{{img base64 300}}
  都不传：{{img base64}}
  都传：{{img base64 300 200}}
  
  浮动图片示例：
  {{img base64 200 100 options}}
  
  其中 options 可以是：
  {
    "anchor": true,          // 是否使用锚点定位（浮动图片）
    "behind_doc": false,     // 图片是否在文字下方（false=覆盖文字，true=文字覆盖图片）
    "allow_overlap": true,   // 是否允许与其他对象重叠
    "position_h": 40,        // 水平偏移，单位为像素（负值表示向左偏移）
    "position_v": -14        // 垂直偏移，单位为像素（负值表示向上偏移）
  }
  
  图片定位说明：
  - anchor: false（默认）- 嵌入式图片，随文字流动
  - anchor: true - 浮动图片，可自由定位和覆盖文字
  - position_h/position_v: 不传参数时，默认使用图片尺寸的一半作为偏移量实现居中
  - 支持负数偏移，实现精确的图片定位

构建和开发

构建 WASM 包

# 构建所有目标
npm run build

# 或分别构建
npm run build:web    # 浏览器版本
npm run build:npm    # Node.js 版本 
npm run build:jsr    # Deno 版本

运行示例

# Rust 示例
cargo run --example rust_example

# Node.js 示例
node examples/node_example.js

# Deno 示例  
deno run --allow-read --allow-write examples/deno_example.ts

# 浏览器示例
cd tests/npm_test
node serve.js
# 然后在浏览器中打开 http://localhost:8080
# 选择 examples/template.docx 文件测试

性能和兼容性

零拷贝: Rust 和 WASM 之间高效的内存管理
流式处理: 适合处理大型 DOCX 文件
跨平台: 支持 Windows、macOS、Linux、Web
现代浏览器: 支持所有支持 WASM 的现代浏览器

许可证

本项目采用 MIT 许可证 - 详见 LICENSE-MIT 文件。

支持

好有链接 | 我们做了一款支持中文口令分享的多数字名片小程序

qjin33 — Sun, 20 Jul 2025 07:15:45 GMT

『好有链接』是我们第一个独立开发的正式作品。欢迎大家尝试，也欢迎大家提出意见帮助我们完善它～『好有链接』拥有数字名片该有的一切基础功能：整理并整合你的社交账号、内容链接、联系方式，让别人快速了解你是谁，不用一遍遍自我介绍。

但我们想让它和诸如 Linkree 之类的数字名片工具有些差异，可以更加贴合国内的环境。

于是，

1. 多身份名片

我们每个人或多或少都有多个身份，并且会随时切换它们：

用飞书开会，企微回复客户，Linkedin 更新工作成果的职场打工人
用 notion 撰写博客，知乎分享经验，在 behance 上发布作品的设计博主
用微博晒狗，小红书种草宠物玩具，微信群寻找遛狗搭子的铲屎官

当我们面对不同人的时候，为了匹配不同的关系场景，我们往往会刻意的展示我们其中一面。那么你有没有想过，这一次，我应该如何介绍和分享自己？

为了解决这个问题，为了快速且准确地展示那个 “正确的我”。我们在『好有链接』中增加了多身份名片这个功能：你可以为不同的关系场景，创建专属的『身份名片』。

每张『身份名片』都是你的一种侧面。你可以为它们设置不同的头像与简介，组合出专属于这一面的人设信息：

添加社交卡片，绑定你的平台账号（微信、微博、小红书、B 站等），让别人更快找到你。
添加笔记卡片，展示你的爱好特长、知识经验、观点和作品，让别人更快了解你。

这些名片彼此独立。你不需要把所有账号塞进一个页面中，这样也不会担心 “我是不是不该分享这个微信” 或是 “我发一大段自我介绍 Ta 会看吗？”。只需根据场合，挑选并分享那个恰当的自己。

『好有链接』就是这样一本属于你的自我使用说明书，每一页都写给不同的人看。

2. 中文口令

出现中文口令的原因是因为我们觉得在社交平台上分享自己的链接和二维码太麻烦了。每次都要绞尽脑汁和平台斗争。

于是，在『好有链接』中，每一张卡片都可以被赋予一个自定义的中文口令。他人只需在小程序中输入口令就能直达你想展示的内容。用中文口令可以替代冗长的链接，可以更加自然地嵌入评论、对话甚至图片中，不容易被屏蔽或误删。

但我们觉得既然有了这个功能，那就让它更加有趣一些吧。我们觉得分享不仅是把一段信息传递出去，这个行为也可以是一种轻巧、有趣的表达。

于是就有了这些玩法：

1. 个性表达

口令可以不只是链接的媒介。它可以是一句玩笑、一个暗号，也可以是一种情绪。它是你和被分享者之间的沟通方式。它可以让每次分享，都成为一次有趣的互动，这也会让别人更容易记住你。发挥你的想象力，试着给你的卡片绑定一个独特的中文口令吧！

2. 互动游戏

既然有了口令。那么是不是可以把这次分享互动变得更加有趣？我们为此给卡片增加了隐私功能，你可以设置卡片仅可以通过口令发现。那么此时，口令分享就成了一场寻宝游戏：将这张卡片的谜底，制作成下一张卡片的口令。用口令将不同的卡片关联起来，引导对方逐步探索，在一场轻量的互动游戏中更好的了解你。

浏览器插件（即将上线）

为了方便你更方便的获取分享的内容，我们为『好有链接』开发了浏览器插件。在插件的搜索框中输入你获得的口令，对应的卡片就会被展示出来，并且可以快速访问其中的内容和链接。

使用方法

目前，『好有链接』只上线了微信小程序版本。如果你想体验它，可以在小程序中搜索『好有链接数字名片』，或者扫描下方的小程序码。

我们的计划

『好有链接数字名片』是我们第一个正式的产品，我们还在慢慢的打磨并优化它。接下来我们会：

完善合集功能
上线『好有链接数字名片』的网页版
可以自定义属于你的短链 / 二维码

如果你想要帮助我们完善它 点击这里，可以给『好有链接数字名片』提意见。点击这里，可以关注我们的最新进度。点击这里，访问我们的官网。如果你想加入我们的用户群，可以在『好有链接数字名片』中输入口令『好多用户』。