喵个咪的博客喵个咪的博客
TX7DO
文章列表
文章分类
文章标签
时间线
TX7DO
文章列表
文章分类
文章标签
时间线
健康养生 1fastapi 1随笔日志 1产品设计 1AI 6软件工程 2工程文化 1GoWind 110架构设计 3Go-Kratos 107Golang 153架构 1ASIO 2cron 1rclone 1flutter 1RxDart 1Make 2CMake 2Ninja 1设计模式 3Cache Aside Pattern 1缓存设计模式 1汽车 1go 2CDC 1PostgreSQL 6Centos 1docker 1杀毒 1CLion 1云手机 1GoogleTest 1Cococs2dx 1Cocos Creator 1代码注释 1IDE 3Python 4TRC20 1C++ 8类型转换 1CQRS 1Kafka Streams 1Bazel 2Docker 21Go 7crontab 1客户留存率 1EFK 1RustDesk 1Jitsi Meet 1Traefik 1Swagger 1Docker Hub 1VIM 1Word 1VBA 1Doris 2量化交易 2Flutter 19Widget 1Ent 4SQL 2Excel 2配色 1TypeScript 3C# 1Sealed Class 2微信小程序 1人脸识别 2RK3588S 1Android Studio 1iOS 1GetX 1鸿蒙 1字体渲染 1期货 1Futures 1地理围栏 1GEO 1Git 2AI Agent 2pgvector 1RAG 1BI 2大屏 1数据可视化 1通知系统 1打印 1前端组件 2chromedp 1工作流引擎 2Vue3 6React 7Protobuf 9Dart 1CMS 9设计系统 1响应式 1审批流 2内容治理 1React.js 1LLM 1数据安全 1Vue 6Nuxt 1OpenSearch 1搜索 1分布式任务 1Taro 1CRDT 1协同编辑 1ERP 2数据一致性 2BPMN 1IAM 1JWT 1Casbin 1OPA 1ent 1数据库 1IM 11音视频 1CRM 1消息系统 1OA 2协作文档 1知识库 1研发效能 1DevOps 1开放平台 1私有化部署 4选型 2实时协作 1算法 6记账 1工作流 1MQTT 3运维平台 2分布式 1Shop 4电商 1订单系统 1短视频 2多租户 2移动端 1推荐系统 1GoWind Toolkit 2代码生成 3Element Plus 1Ant Design 1UBA 5大数据分析 4ClickHouse 1OLAP 2数据架构 1Rust 6微服务 1WebRTC 3Security 3SaaS 1MongoDB 1Kratos 2CRUD 1GORM 1Wire 1Headless CMS 1WASM 1随机种子 1MacOS 3Ubuntu 2GCC 1Godot 1Clang 1Superset 1CentOS 1OpenCV 1咖啡 1Android 1Google Play 1Unity WebGL 1Dexie 1IndexedDB 1htop 1Postgresql 1Mattermost 1Qt 4TL;DR 1Swift 1Javascript 2JetBrains 1Typescript 1libuv 1Linux 1本地化 1国际化 1状态同步 1帧同步 1泡泡水 1Markdown 1机器学习 1QTT 1MSB 1LSB 1MySQL 1npm 1pnpm 1yarn 1OCR 1OHLC 1OLTP 1OpenAI 1OpenAPI 1数织 1Ping 1人体姿态识别 1全文搜索 1交叉表 1Prometheus 1Docx 1QUIC 1Reactor 1Websocket 1KCP 1Kratos-Transport 1Redis 1REST 1CoTURN 2RushWind 5契约测试 1中后台 1开源项目 1数据权限 1API设计 1gRPC 1RBAC 1SDD 1Selenium 1基准测试 1Spine 1股票 1Roguelike 2ThingsBoard 3时间戳 1时序数据库 3交易所 1Unity 2用户画像 1PgBouncer 1Vite 1WebGL 1加权随机 1数据血缘 1Roguelite 1Protocol 1WiFi 1WSL 3Windows 4
GoWind CMS 拆解:在 Go 里给 TipTap 搭一套 Yjs 协同后端

Date: 10/22/2026Category: GoWind风行Tag: Golang, GoWind, CRDT, 协同编辑, CMS

本文回答一个问题:两个人同时编辑同一篇富文本,从浏览器到 Go 服务端再到数据库,中间要处理哪些协议、锁、持久化与竞态?

GoWind CMS 的帖子/页面编辑页支持多人同编:在线光标、无冲突合并、断线恢复、离线内容回流。后端没有用任何现成的协同 SaaS,而是在 Go 侧搭了一套 Yjs 兼容的 WebSocket 服务(COLLAB_ADDR,默认 :6602),与 TipTap 的 Collaboration 扩展直连。这个功能的实现从 v1 到 v2.5 演进了三版(编辑锁 → 持久化自愈 → 服务端权威种子化),每一版解决一类问题,踩过的坑都留在了代码注释里——这篇按演进顺序拆。

基于 Taro 的 Headless CMS 多端前端架构:技术解析与二次开发导引

Date: 6/4/2026Category: GoWind风行Tag: Taro, React, CMS, GoWind

本文面向希望基于此项目进行二次开发的前端工程师,从技术栈选型、核心架构设计、关键模块实现到二开实践路径,提供一份完整的技术地图。


一、技术栈总览

本项目是一个 Taro 多端 CMS 内容展示前端,一套代码同时编译为 H5、微信/支付宝/抖音小程序等多端应用:

层面 技术 版本 用途
框架 Taro 4.1.x 多端统一框架
UI 库 React 18.x 视图层
语言 TypeScript 5.x 类型安全
构建 Vite 4.x 编译打包
样式 Tailwind CSS 3.x 原子化 CSS
小程序适配 weapp-tailwindcss 4.x 小程序端 Tailwind rem→rpx 转换
状态管理 Zustand 5.x 轻量响应式 Store(Context 模式)
数据层 TanStack React Query 5.x 服务端状态管理
国际化 i18next + react-i18next 25.x / 16.x 多语言翻译
HTTP 客户端 Axios 1.x REST 通信
代码高亮 highlight.js 11.x 语法着色
Markdown marked 17.x 内容解析
数学公式 KaTeX 0.16.x LaTeX 渲染
流程图 Mermaid 11.x 图表渲染
实时通信 SSE (fetch-event-source) 2.x 服务端推送
GoWind CMS 拆解:社交分发引擎——10 平台适配器、状态闸门与自愈定时任务

Date: 10/22/2026Category: GoWind风行Tag: Golang, GoWind, 分布式任务, CMS

本文回答一个问题:"把这篇文章一键发到 10 个平台、明早 9 点准时发、失败自动重试、发布后还能回拉互动数据"——这句话拆成工程问题,一共有几层?

GoWind CMS 的社交分发功能连接 10 个平台(Bluesky / Mastodon / DEV.to / Telegram / WordPress / 微信公众号 / Nostr / 微博 / LinkedIn / 博客园),支持内容一键分发、定时发布、改期重排、失败重试、互动统计回拉,并把这些能力以 MCP 工具的形式暴露给 AI 代理。这篇文章拆它的五层:平台适配器、凭据生命周期、发布状态机、定时自愈、统计回拉——每一层都有可以直接迁移的工程决策。

GoWind CMS 拆解:搜索三板斧——高亮、联想、同义词

Date: 11/11/2026Category: GoWind风行Tag: Golang, GoWind, OpenSearch, 搜索, CMS

本文回答一个问题:接了 OpenSearch 之后,「能搜到」与「搜得好」之间还差哪三步——以及为什么同义词偏偏放查询侧而不是索引侧?

GoWind CMS 的搜索底座早就有了:帖子标题/摘要/正文建 OpenSearch 索引,租户隔离过滤,smartcn 中文分词。但「有搜索引擎」和「搜索体验」之间隔着三件事——用户看不见命中原因(没有高亮)、输一半就要自己猜完整词(没有联想)、换个说法就搜不到(没有同义词)。10 月底的 42a73c29 一次把三件补齐,这篇逐件拆,重点讲第四节的选型:同义词为什么放查询侧。

基于 Nuxt 4 的现代 Headless CMS 前端:架构深度解析与二次开发指南

Date: 6/3/2026Category: GoWind风行Tag: Vue, Nuxt, CMS, GoWind

本文面向希望基于此项目进行二次开发的前端工程师,系统性地讲解项目的技术选型、架构设计与模块划分,并提供扩展开发的实操指引。


一、项目概览

本项目是一个面向内容管理的现代前端应用,使用 Nuxt 4(Vue 3)构建,支持 SSR/SSG 双模式部署,提供文章、分类、标签、评论等完整的内容管理功能,并内置多语言(中英文)和暗色模式支持。

核心特性一览

特性 技术方案
框架 Nuxt 4(Vue 3.5+)
样式 Tailwind CSS v4 + CSS 变量主题系统
UI 组件库 shadcn-vue(基于 Reka UI)
状态管理 Pinia + 持久化插件
数据请求 Axios + TanStack Vue Query
国际化 @nuxtjs/i18n(prefix 路由策略)
内容渲染 marked + Shiki + KaTeX + Mermaid
富文本编辑 Tiptap
API 协议 Protobuf 生成 TypeScript HTTP 客户端
部署 SSG 静态生成 + SPA fallback
基于 Next.js 的 Headless CMS 前端架构:技术解析与二次开发导引

Date: 6/3/2026Category: GoWind风行Tag: React, React.js, CMS, GoWind

本文面向希望基于此项目进行二次开发的前端工程师,从技术栈选型、核心架构设计、关键模块实现到二开实践路径,提供一份完整的技术地图。


一、技术栈总览

本项目是一个静态导出型 CMS 内容展示前端,采用以下核心技术栈:

层面 技术 版本 用途
框架 Next.js (App Router) 16.x 静态导出、路由、SSG
UI 库 React 19.x 视图层
语言 TypeScript 5.x 类型安全
样式 Tailwind CSS 4.x 原子化 CSS
组件库 shadcn/ui (Radix UI) 最新 无障碍 UI 原语
状态管理 Zustand 5.x 轻量响应式 Store
数据层 TanStack React Query 5.x 服务端状态管理
国际化 next-intl 4.x 多语言路由与翻译
HTTP 客户端 Axios 1.x REST 通信
代码高亮 Shiki 4.x 双主题语法着色
Markdown marked 17.x 内容解析
数学公式 KaTeX 0.16.x LaTeX 渲染
流程图 Mermaid 11.x 图表渲染
富文本编辑 Tiptap 3.x 评论编辑器
实时通信 SSE (fetch-event-source) 2.x 服务端推送
GoWind CMS 拆解:发布审批——多级推进、逐级角色与全程留痕

Date: 11/11/2026Category: GoWind风行Tag: GoWind, CMS, 审批流, 内容治理, Golang

本文回答一个问题:一篇文章从「提交审核」到「正式发布」,审批流怎么推进(第几级了)、谁有权批(每级什么角色)、每一次动作如何留痕(谁在何时批了什么)、以及怎么保证不被 Update 接口绕过去?

GoWind CMS 的发布审批是内容域的最后一道闸:文章提交后进入审核中,审批人逐级推进(级数与每级角色都是租户可配的),末级通过才置 PUBLISHED;每一次 SUBMIT/APPROVE/REJECT 都落 sys_review_logs 表留痕,审核中的内容被 Update 接口封死了直改状态的后门。页面(page)走同款语义。这篇按审批流的四个组成部分拆:状态机、推进、授权、留痕与闸门。

GoWind CMS 拆解:Flutter 设计系统内核——双态 token、四档断点与自适应壳层

Date: 11/11/2026Category: GoWind风行Tag: Flutter, GoWind, CMS, 设计系统, 响应式

本文回答一个问题:一个内容型 Flutter 应用要让「观感」由内核说了算——色值怎么定、字号怎么钉、断点怎么分、栅格列数怎么算、导航壳怎么保证跨断点不丢状态?把这套设计系统内核的三层结构逐层拆开。

GoWind CMS 的 Flutter C 端(内容消费 App)有一套完整的设计系统内核:lib/src/core/themes/ 承载主题(色、形、字、体、壳五件套),lib/src/core/layout/ 承载响应式结构(四档断点 + 栅格反推 + 自适应壳层)。它的架构是清晰的三层模型——价值层(色值唯一事实源)、语义层(页面只许取语义 token)、结构层(断点管宏观、栅格反推管密度、单壳双态管导航),每层都配了把设计约束钉进 CI 的测试。实机观感先看四屏——首页、探索、详情、我的:

基于 Flutter 的 Headless CMS 全平台前端架构:技术解析与二次开发导引

Date: 6/7/2026Category: GoWind风行Tag: Flutter, Dart, CMS, GoWind

本文面向希望基于此项目进行二次开发的 Flutter 工程师,从技术栈选型、核心架构设计、关键模块实现到二开实践路径,提供一份完整的技术地图。


一、技术栈总览

本项目是一个 Flutter 全平台 CMS 内容展示前端,一套 Dart 代码同时编译为 iOS、Android、Web、macOS、Windows 等多端应用:

层面 技术 版本 用途
框架 Flutter 3.x (Dart 3.12+) 全平台 UI 框架
语言 Dart 3.x 类型安全 + 空安全
状态管理 flutter_bloc + Cubit 9.x 响应式状态(Cubit 模式)
服务定位 GetIt 9.x 轻量 IoC 容器(单例管理)
路由 GoRouter 17.x 声明式路由 + ShellRoute
国际化 flutter_intl (intl) 0.21.x ARB 翻译文件 + 代码生成
HTTP 客户端 Dio + Retrofit 5.x / 4.x REST 通信 + 类型安全客户端
API 代码生成 swagger_parser 1.43.x OpenAPI → Dart 模型 + 客户端
数据缓存 cached_query 3.x Query/Mutation 缓存管理
响应式适配 flutter_screenutil 5.x 手机端设计稿适配(Web 端禁用)
Markdown flutter_markdown 0.7.x 内容解析
HTML 渲染 flutter_widget_from_html 0.17.x 富文本渲染
加密 encrypt + crypto 5.x / 3.x AES 加密(Token 持久化)
JWT jose 0.3.x JWT Token 解析
图片缓存 cached_network_image 3.x 网络图片缓存
骨架屏 shimmer 3.x 加载占位动画
环境变量 flutter_dotenv 6.x .env 文件管理
日志 logger 2.x 结构化日志