2026-11-02
1. 实际变更
Leroll ·
10:52:58· 将 API 文档按语音转换、系统接口、会话数据三类功能组织：双语语音转换使用 voice-conversion，健康检查与版本查询使用 system，会话文件读取使用 session-data；保留协议与参数说明，同步索引和引用。本地链接、锚点、章节编号、双语示例、适配器及解码示例离线验证与 git diff --check 通过，源码及历史正文摘要未变；未执行服务或 GPU 联调。详见续做验收。Leroll ·
11:08:38· 参考 Ollama、Prometheus、vLLM 官方接口文档，重写 API 参考：请求与响应示例前置，标准语音转换按消息流程组织，中英文分文件；源码核对与迁移历史归入 Spec，保留鉴权、音频格式、错误和异步保存限制。24 个 JSON、6 个 Shell、2 个 Python 示例静态检查、四组双语一致性、适配器及解码离线验证、本地链接与 git diff --check 通过；未修改服务代码或执行 GPU 联调，未提交或推送。参考依据及验收见 Spec。Leroll ·
11:25:19· 用户文档迁入 中文与英文目录，统一对应文件名，补齐英文配置部署与故障排查；文档索引明确翻译范围、原文与译文关系及同步规则。8 对文档、19 行配置值、同语言导航、示例静态及 API 离线验证、本地链接和 git diff --check 通过；历史报告索引去除重复英文摘要，源码、历史正文及已有暂存内容保持不变。未执行服务或 GPU 联调，未提交或推送。详见 Spec。Leroll ·
11:40:27· 将项目首页及主文档统一为中文，英文项目首页、用户索引和选定译文集中在 docs/en；中文 API 与操作指南迁回 docs/api、docs/getting-started，移除 README_ZH.md 和 docs/zh，贡献指南改为中文，同步导航、资源链接及 AGENTS 约定。8 对完整译文、用户导航、19 行配置值、示例静态检查、本地链接与锚点及 git diff --check 通过；源码、历史正文和已有暂存内容未变。未执行服务或 GPU 联调，未提交或推送。详见 Spec。Leroll ·
13:33:35· 当前文档整理已提交为26712d5。将项目题图从 1983 × 793 的 PNG（1,475,238 字节）等比例缩小为 1600 × 640 的 WebP（112,886 字节，cwebp 质量 90），体积减少约 92.3%；保留原构图，同步中英文 README 和旧日志中的题图链接。格式与尺寸、标题及小字清晰度、相对链接和 git diff --check 检查通过；图片调整未提交，未推送或重写 Git 历史。Leroll ·
14:00:13· 新增 MkDocs 文档网站、独立 uv 文档环境与 GitHub Pages 自动发布工作流，接入中英文导航、搜索和构建时链接适配，同步 README、贡献指南与索引。53 个 HTML 页面严格构建、全站链接与锚点检查、代码示例保留及错误路径拒绝检查、工作流结构与权限核对、浏览器中英文搜索和手机目录验收通过，git diff --check 通过；服务源码、主项目依赖与子模块未改动。未执行云端工作流、首次上线或 GPU 联调，未提交或推送。详见 Spec。Leroll ·
14:08:36· 按用户授权将文档网站实现提交为41fe6fe并推送到 main，创建 GitHub Pages 站点，使用 workflow 发布并强制 HTTPS。首次工作流构建与部署成功；中文站、英文站、双语项目介绍、语音转换 API 和搜索索引共六个线上地址返回 HTTP 200，内容与本地构建哈希一致。线上浏览器访问工具超时，交互验收沿用已完成的本地浏览器结果，不记为线上浏览器验证通过。详见 上线记录。Leroll ·
14:52:44· 将中文项目首页与英文项目首页的在线文档入口独立成段，说明快速开始、配置部署、API 接入和故障排查范围，移除原导航行中的重复链接。MkDocs 严格构建、53 个 HTML 页面的 4182 个本地链接与资源引用检查及 git diff --check 通过；本次仅调整双语 README 入口，文档维护方式的讨论未落实为架构改动。Leroll ·
15:33:00· 分离用户文档与开发维护入口，集中翻译和版本约定，精简双语 README 安装重复内容并为网站增加 main 分支及历史记录提示。新增配置、机器示例与客户端选项离线检查，以及源码影响和单侧译文提醒，接入文档 CI。9 对文档、54 个示例、60 个配置值、17 个回归用例、56 页严格构建、全站链接及旧锚点检查、git diff --check 通过；服务代码、历史正文、主题与框架未改，未执行 GPU 联调。详见 Spec。Leroll ·
15:35:54· 文档维护优化提交ad3bb22与 README 独立入口提交6f6799d已推送到 main；Actions内容检查、17 个回归用例、构建验证与 Pages 部署成功。双语首页、维护入口、维护指南、语音转换 API 和搜索索引六个线上地址均 HTTP 200，内容哈希与本地构建一致；浏览器视觉及移动端交互本轮未测。详见发布验收。Leroll ·
17:32:21· 将文档网站迁移至 VitePress，网站工程集中在 docs/website，正文继续使用现有 Markdown；增加酸橙浅色与暗色主题、首页任务入口、教程导航、API 字段与示例并排布局及双语本地搜索，迁移 Actions 并移除 MkDocs 构建依赖。9 对文档、54 个机器示例、60 个配置值、18 个 Python 与 9 个 Node 回归用例通过；57 个 HTML 页面、236 条实际搜索记录以及原 56 个网页路径和正文锚点检查通过。浏览器主题切换与持久化、双语搜索与语言切换、手机目录和 API 阅读、Markdown 开发预览自动刷新通过，依赖审计无已知漏洞，git diff --check 通过；服务代码、依赖和子模块未改，未执行 GPU 联调，未提交、推送或上线。详见 Spec。Leroll ·
17:43:43· 按用户授权将 VitePress 文档迁移与酸橙主题提交为6e76304并推送至 main；Actions构建与 Pages 部署成功。双语首页、中文快速开始和双语语音转换 API 均 HTTP 200，除资源文件名哈希外与本地 HTML 一致；主题 CSS、图标与页面清单一致，236 条搜索记录集合一致，首页引用的 JavaScript 资源均可读取。本轮线上验收为 HTTP 内容与资源检查，交互验收沿用本地结果。详见发布验收。Leroll ·
18:06:10· 研究成熟项目标识、音频波形设计与 Logo Design 技能，按用户确认的“彩色水流波形穿过挡板后改变”方向生成蓝橘、蓝粉两版品牌图标候选，并保存原始 PNG 和生成提示词。图片解码、尺寸与 JSON 检查通过，完成 256/64/32/16 像素目视检查；当前为白底概念稿，16 像素表现不足，尚未定稿或接入网站。未修改服务代码、现有题图和双语 README，未提交或推送。详见 Spec。Leroll ·
18:11:52· 在品牌图标 Spec记录用户否定第二轮候选的反馈，撤回当前推荐，改为探索平面水流轮廓与缩小挡板；新预览未定稿，等待具体风格参考。未新增发布素材，未修改网站或现有题图。Leroll ·
19:20:45· 按用户对平面水流稿的认可保留原稿，生成酸橙与蓝紫配色、浅色描边框及深靛色底框两版倾斜图标候选，保存 PNG、原图与编辑提示词。图片解码、尺寸、JSON、本地链接及 git diff --check 检查通过，完成 256/64/32/16 像素目视比较；当前仍为白底候选，未制作 SVG 或 favicon，未接入网站、提交或推送。详见 Spec。Leroll ·
19:30:55· 参考 Wise、Duolingo 与 Spotify 的品牌方法，新增六版向右倾斜的水流图标候选，比较酸橙白、森林绿、钴蓝、珊瑚及深绿配色与实体／留白隔板，保存六张 PNG、编辑提示词和编号对比图。图片解码、规格、JSON、本地链接与 git diff --check 检查通过，完成 96/64/32/16 像素目视比较；当前仍为白底概念稿，未接入网站、提交或推送。详见 Spec。Leroll ·
19:43:59· 围绕同色波形表达不同音色，分别探索外轮廓肩部、内部曲线留白和不对称曲线走势，每个方向生成白色及深绿两版，保存六张 PNG、完整提示词与编号对比图。图片解码、尺寸、JSON、本地文件链接及 git diff --check 检查通过，完成 96/64/32/16 像素目视比较；小尺寸细节仍有限，当前为选型候选，未接入网站、提交或推送。详见 Spec。Leroll ·
20:15:14· 按用户重新选中的森林绿圆角门框稿继续发散，生成墨青酸橙、深蓝冰青浅紫、蓝紫杏橙奶白、雾白钴蓝珊瑚四组配色，各保留一版原造型并探索一版门框变化，保存八张 PNG、目标配色与提示词及编号对比图。图片解码、尺寸、JSON、本地文件链接与 git diff --check 检查通过，完成 96/64/32/16 像素目视比较；当前仍为选型候选，未接入网站、提交或推送。详见 Spec。
