项目开发原始需求管理

本文档由人工维护，AI受限编辑 ，仅允许在每个 ## TODO 下加个子标题 ### DONE 关联 task_log.md 的完成任务ID记录。

需求ID 格式：TODO:YYYY-MM-DD/n ，日期/编号。日期表示头脑风暴冒出该需求想法的 日期，若一天中产出多个想法则加编号。仅有初步概念但未细化的需求暂不加日期 id ， 先快速列出 TODO: 标题，后面有细化内容时再赋日期 id ，转为正式需求。

上版本摘要

xyjson v1.0 版本已完成主要开发目标，实现了对 yyjson 库的 C++ 封装，支持操作符重载、 迭代器、性能优化等功能。主要特性包括：单头文件库设计、灵活的JSON操作符、完整的 文档体系和示例应用。项目已达到稳定状态，可作为生产环境使用。

task_todo v1.0

TODO:2025-12-03/1 优化 CMake 构建脚本利于其他项目集成依赖

发现将 xyjson 也作为其他项目的依赖时，用 FetchContent 下载后会把 xyjson 的单元测试、example 也编译，这是不必要的。需要增加一个选项，略过那些编译，只编译 xyjson 接口库的最小实现。

DONE:20251203~151520

@Glm4.6

TODO:2025-12-16/1 流水线署 docs 为 github page

• 使用默认的 Jekyll 简单方案构建文档网页；
• 自动为 md 添加 Front Matter；
• 长文档 TOC 目录表支持

DONE:20251216~102630

关键问题修改：

• md 表格要求前后有空行，注释可能也不行，修改生成 md 表格的脚本加上空行
• 使用 js 自动生成目标栏
• 使用 js 触发中文换行多出的空格