kaiwen.work 维护记录目录
本目录用于存放 AI 协助维护该 Typecho 网站时产出的所有参考文档、变更记录和分析报告，便于长期维护时追溯和学习。
目录约定
- 文件命名：
{序号}-{简短描述}.md，按时间顺序递增 - 每次较大变更新增一份记录文档，说明背景、方案、改动点、影响面
当前文档索引
| 序号 | 文档 | 说明 | 日期 |
|---|---|---|---|
| 00 | 00-dev-errors.md | AI 开发错误记录（每次新开发前必读） | 2026-04-29 |
| 01 | 01-architecture-analysis.md | 网站整体架构与目录结构分析（基础参考） | 2026-04-24 |
| 02 | 02-json-tool-page.md | 文本工具页面（JSON格式化/压缩、URL编解码、MD5/SHA-256/Base64加密、T2I Prompt 语法高亮/展开/压缩，纯前端） | 2026-05-14 |
| 03 | 03-bangumi-api-notes.md | Bangumi API 文档研究笔记（接口分组、枚举值、请求示例） | 2026-04-28 |
| 04 | 04-github-api-notes.md | GitHub REST + GraphQL API 笔记（贡献日历、仓库、事件） | 2026-04-28 |
| 05 | 05-steam-api-notes.md | Steam Web API 笔记（玩家信息、近期游戏、徽章、封面 URL） | 2026-04-28 |
| 06 | 06-activity-page-notes.md | 个人动态页完整架构（异步加载、双层缓存、三模块设计、更新时间显示） | 2026-04-29 |
| 07 | 07-nav-dropdown-tools.md | 导航栏下拉工具菜单（父子页面层级、hover+click 双模式、深色适配） | 2026-04-29 |
| 08 | 08-maintenance-pages.md | 维护文档公开页面（独立页面模板、动态文件映射规则、Markdown 渲染） | 2026-04-29 |
| 09 | 09-novel-search.md | 轻小说查询页面（SQLite 查询 API、封面代理缓存、Bangumi 评分徽章 + 条目跳转 + 人工校准、详情页 bangumi 大图封面、前端多条件搜索） | 2026-05-07 |
| 10 | 10-novel-epub-converter.md | 轻小说 EPUB 转换页面（wenku8 链接 → TXT → EPUB，SSE 实时进度，章节检测双策略 + 章节目录增强，封面优先本地 bangumi 大图） | 2026-05-07 |
公开页面
本目录文档已通过 Typecho 独立页面公开展示，访问路径：/maintenance（网站维护目录）。
页面结构：
- 目录页（slug:
maintenance，模板：维护文档目录）→ 展示本 README.md + 文档列表卡片 - 详情页（slug:
maintenance-NN，模板：维护文档详情）→ 动态加载对应.md文件 - 详情页均为顶级独立页面，不设父子关系，由目录页通过 slug 前缀自动收录
新增维护文档的完整流程：
- 在本目录新建
{NN}-{描述}.md（NN 为两位数字序号） - 在本 README.md 的文档索引表中追加一行
在 Typecho 后台 → 撰写 → 独立页面 → 新建页面：
- 父页面：无
- 模板：选"维护文档详情"
- Slug：设为
maintenance-{NN}（与文件序号一致）
模板文件位置：{TYPECHO_ROOT}/usr/themes/classic-22/maintenance-index.php（目录页）和 maintenance-doc.php（详情页）。
维护原则（摘要）
- 不修改 Typecho 核心目录（
/var/、/admin/、/install/），主题和插件改动限于/usr/themes/和/usr/plugins/；根目录下的自定义 PHP API 端点（如activity-api.php、novel-api.php）属于允许的补充，Typecho 升级不会覆盖这类文件 - 不修改
/var/、/admin/、/install/等核心目录 - 敏感文件（
config.inc.php、SQLite 数据库）不入 Git - 每次变更在本目录追加记录
- 维护文档中禁止写入任何敏感信息，包括但不限于：API Key、Access Token、数据库密码等凭证；敏感信息统一存放在
config.inc.php（已在.gitignore） - 文档中涉及服务器真实路径时，使用占位符（如
{TYPECHO_ROOT}），实际路径记录在config.inc.php注释中
详见 01-architecture-analysis.md 第 10 节"后续维护规范"。