跳到主要内容

DOCUMENTATION / 开发文档

让实践,成为下一次的起点

从工程架构、接口集成到问题排查,查阅项目中的实现说明与实践记录。

文档正文目前以中文提供。

15 篇文档
Skills

Codex Skill 跨项目复用:本地迭代与 GitHub 同步

用独立 Git 仓库与用户级软链接管理通用 Skill,讲清目录发现、本地修改、多机同步,以及通用流程与项目约定的分工。

AI 编程 / Codex
Web Storage / RPC

Web Storage 的边界与跨域 SSO:从 Safari 差异到客户端 RPC

区分同源、同站与 Web Storage 分区,说明如何用 Cookie token 或服务端会话解除同站 SSO 对 iframe 存储共享的依赖;比较共享 Domain Cookie 与 API 主机限定的 HttpOnly Cookie,并明确鉴权、凭据请求及跨站限制。

前端开发 / React
Nginx

Nginx 全站 HTTPS 上线

对外域名统一 443 SSL + 80→301 跳转,内部域名保持 80;用 Certbot 只签不改,先签证书再覆盖配置,附域名清单与上线步骤。

后端工程 / Nginx
React

把 React 组件嵌入非 React 页面

用 createRoot 与 useEffect 把客服挂件接进官网、商城等非 React 架构,讲清 HTML 片段的生成与注入。

前端开发 / React
SMTP / IMAP

腾讯企业邮箱完整配置指南

核对管理员与成员两级权限、客户端专用密码,完成邮件客户端与 Java 接入,并排查 535 等认证问题。

后端工程 / Mail
Nginx

Next.js 15 · 四站静态上线

本机打包单个 tar.gz,上传服务器一条命令切换版本,附浏览器验收与踩坑总结。

后端工程 / Nginx
Maven

Sparrow Parent 与 BOM

按生产与交付边界划分构建基线、组件版本和业务接入,附完整 POM 示例。

后端工程 / Java
OpenAPI

springdoc-openapi 集成说明

区分 Servlet MVC 与 WebFlux 技术栈,选择匹配的接口文档依赖。

后端工程 / Java
OpenAPI

OpenAPI 分组策略

处理多 Starter 共存时的配置冲突,为 File 与 Passport 设置独立接口分组。

后端工程 / Java
Maven

Maven 依赖源码与断点调试

理解源码包、字节码行号表与断点错位,梳理发布和联调中的处理方法。

后端工程 / Java
Netty

Netty 入站消息与 OOM

通过消息处理器案例,定位未释放引用造成的内存泄漏与心跳异常。

后端工程 / Java
Netty

Netty 内存共享与释放

梳理引用计数、零拷贝和深拷贝,明确消息转发中的内存释放责任。

后端工程 / Java
Thymeleaf

Thymeleaf 模板路径配置

结合视图名前导斜杠,排查 prefix 拼接双斜杠导致的模板资源错误。

后端工程 / Java
React

useCaptcha 验证码 Hook

拆解会话初始化、图片加载与点击刷新,以及监听清理和重试边界。

前端开发 / React
Next.js

next-intl 国际化指南

串联语言路由、中间件与消息上下文,理解多文件翻译配置和常见问题。

前端开发 / React