Core & Frontier

当 AI 或 Agent 通过 GitHub 搜索项目时，仓库名称、Description 和 Topics 直接影响项目能否进入候选结果，README 和项目文档则影响它能否被正确理解。本文说明如何补充中英文关键词、项目定位和机器友好的文档入口，提高项目被检索和准确推荐的概率。

AI 能在短时间内生成大量代码，研发的难点会从“怎样写得更快”转向“怎样让实现始终符合真实意图”。本文说明 Living Spec 和 Delta Spec，以及 Executable Spec 和 Ephemeral Spec 的取舍，并给出一套 Spec Coding 实践，适合快速迭代项目。

使用 MinerU 将 PDF 转换为 Markdown 时，正文标题可能全部变成一级标题，导致原有的章节层级丢失。本文介绍两种解决方法：启用 MinerU 的 LLM 辅助标题优化，让模型在解析阶段完成标题分级；或者根据 PDF 目录、书签等已有结构，对生成的 Markdown 做确定性的后处理。

在 Windows 上使用 Docker Desktop 时，本地服务可能报错提示端口被占用。此时执行 netstat -ano | findstr :8081 却返回空内容，无法定位占用端口的进程。本文记录这一问题的排查过程与解决方法。

大模型生成一段回答往往要几秒甚至更久，等完整结果生成后再一次性返回，用户只能对着空白页面干等。本文介绍流式响应中用到的 Mono、Flux、Sinks、Disposable、flatMap 和背压，并给出一个基于 Spring WebFlux 与 SSE 的完整示例。

针对单台服务器上 Java 服务启动缓慢、发布期间容易中断的问题，本文通过 Nginx 双端口轮换，让旧实例持续提供服务，在新实例启动并通过健康检查后再切换流量，实现 Java 服务的零停机更新。

在 IntelliJ IDEA 中运行 Java 程序或测试方法时，可能会遇到报错：Command line is too long. Shorten the command line via JAR manifest or via a classpath file and rerun.

Git是一个开源的分布式版本控制系统，用以有效、高速的处理从很小到非常大的项目版本管理。本文主要介绍在Git提交过程中，Commit Message应该遵循的规范。

Git是一个开源的分布式版本控制系统，用以有效、高速的处理从很小到非常大的项目版本管理。本文主要介绍在多人协作开发时候的一些规范，主要思想概念为反向合并（Back-Merge）。

Git是一个开源的分布式版本控制系统，用以有效、高速的处理从很小到非常大的项目版本管理。本文主要介绍Git的常用命令以及GitHub仓库管理。