QXJ 项目文档

简体中文

English
日本語

简体中文

English
日本語

主题

更新日志 ​

本页记录 QXJ 文档站的版本演进与历次更新，按版本号倒序排列。当前版本 v1.7.3。

版本号规则遵循 Semantic Versioning：主版本号为重大结构调整，次版本号为新功能/新板块，修订号为问题修复与内容完善。

[v1.7.3] - 2026-10-09 ​

✨ 新增 ​

  • 新增更新日志页（本页），右上角版本号由外部跳转改为直达本页；导航「快速开始 → 参考与工具」与 /guide/ 侧边栏同步增加入口（0225f634）
  • 协议解析文档新增 Mermaid 可视化图示四幅：二进制帧结构图（64B v2 帧头逐字段标注）、安全机制分层图、SM2 四步握手时序图、SECURE 加解密流程图，复杂协议一图读懂（e8a8061b）

📝 文档 ​

  • 大幅扩充协议解析文档，补齐工程实现细节（05353c40）：
    • 三端（鸿蒙 APP / Django 后端 / Wireshark Lua 解析器）字段对齐关系表
    • 通信功能码总表与 enc_auth 值域逐项说明
    • INIT / RESP / ACK / TOKEN 各帧数据域全部表格化
    • 后端安全校验清单（协议特征校验、长度校验、状态机流转）
    • 组帧能力说明与 SECURE 加解密全流程拆解
    • 源码模块职责划分与真实抓包示例对照
  • Wireshark 解析器文档更新：新增端口 4607 / 14607 / 8080 流量识别说明、协议特征校验逻辑、修复 media_type 表名错误、补充 HTTPS 抓包前置操作指引（0bc2e24c）

[v1.7.2] - 2026-10-09 ​

✨ 新增 ​

  • 交付文档板块全面完善并定稿（0e8f2b3b），五份交付文档内容齐备：
    • 《用户手册》：按"安装 → 操作 → 运维"三大章组织，含 16 个管理页面的逐项操作说明、十类故障排查与巡检表
    • 《部署文档》：11 章全流程部署步骤，覆盖两套真实环境（外网测试服 gunicorn 直连 TLS、阿里云域名服宝塔 Nginx 反代）
    • 《验收技术总结》：对齐原文 V3 版（文件编号 IIE-MCS-ISTCS-SDSR），补写原文留空的 3.1 / 3.2 / 3.3 / 4.1 / 第五章并以【编者补充】显式标识
    • 《接口设计详录》：五类接口合计 108 个（外部 15 + 后台公共服务 3 + JSBridge 6 + 配套函数库 5 + 内部 REST API 79），内部 API 逐项对照 qxj-backend-admin 导出的 OpenAPI Schema 核对，剔除 /api/v2/* 历史接口
    • 《测试材料》：42 个功能测试用例（13 类）+ 3 个性能效率用例，格式参照权威第三方测试机构报告样板，结果列留空待现场执行
  • 新增第三方业务系统接入指南（/development/integration）：明确平台方与业务方交付边界，提供前端接入六步 / 后端接入六步、端到端联调流程与验收清单，配套 qxj-frontend-mock-demo / qxj-backend-mock-demo 的 before / after 可运行代码对照

🌍 国际化 ​

  • 同步翻译英文 / 日文首页：将最新中文首页（项目简介、核心特性表、快速开始、架构说明、技术亮点、文档导航地图七大板块）完整翻译为英日双语，mermaid 图节点文本同步本地化（559ef779）

[v1.7.1] - 2026-10-08 ​

♻️ 重构 ​

  • 移除主导航中重复的「快速开始」入口，收敛导航层级，避免与「项目指南」下拉内的入口重复（107e561e）

[v1.7.0] - 2026-10-08 ​

✨ 新增 ​

  • 新增交付文档板块（/delivery/）：总览与编写指南、用户手册、部署文档、验收技术总结、接口设计详录、测试材料六大页面，建立"网页即交付底稿"的编写约定（d06b36c1）
  • 全面扩充仓库介绍：31 个仓库按职责分为八大类，补齐全景拓扑、分组说明、分支策略与端口域名约定（d06b36c1）
  • 主题增强面板对齐官方演示站全量选项：布局切换、主题色板、卡片圆角、页面过渡动画、代码块样式等均可在线调整（109ba8b9）

[v1.6.4] - 2026-10-08 ​

🐛 修复 ​

  • 关闭右下角「前往评论」按钮——评论系统尚未接入，避免死链误导访客（b374600b）
  • 左上角 logo 统一改用 logo.svg 矢量图，修复高分屏下位图发虚问题（23a45774）

[v1.6.3] - 2026-10-08 ​

🐛 修复 ​

  • 修复密码门禁 tryUnlock 中 keyBytes 类型在 TypeScript 5.7 下的编译报错，显式收窄为 BufferSource（91be67b1）

[v1.6.2] - 2026-10-08 ​

🔐 安全 ​

  • 站点密码门禁升级（8a05d870）：
    • 由明文口令比对升级为 AES-GCM 金丝雀（canary）验证方案
    • 口令经 PBKDF2 派生密钥后仅存 localStorage，明文口令不落盘、不传输
    • 以固定金丝雀密文做验证，口令错误即解密失败，抗篡改与抗离线爆破能力显著提升

[v1.6.1] - 2026-10-08 ​

🐛 修复 ​

  • 首页 hero 文案与图标调整，目录按钮改为按页面类型按需显示，移除冗余的大纲切换按钮（39b5e524、61faa7a3）

🔧 其他 ​

  • 新增 pnpm dev 别名脚本，本地启动命令统一（309b6a0c）

[v1.6.0] - 2026-10-08 ​

✨ 新增 ​

  • 基于 vitepress-theme-teek 源码重建主题工程，将 main 分支全部文档内容完整迁移至新主题，保留全部既有页面、路由与锚点结构（fdb34b9c）

[v1.5.2] - 2026-10-08 ​

🐛 修复 ​

  • 覆盖 --tk-bg-img-default 变量，移除首页火焰装饰背景图，回归文档站视觉风格（9e4045c3）
  • 通过 teekConfigContext 关闭 spotlight / banner 等主题装饰图形，减少视觉干扰（fbb97878）

[v1.5.1] - 2026-10-08 ​

🐛 修复 ​

  • editLink 的 pattern 由 edit 改为 Gitea 的 _edit，「在 Gitea 上编辑此页」跳转恢复正常（a69fd76d）

[v1.5.0] - 2026-10-08 ​

✨ 新增 ​

  • 主题整体切换至 vitepress-theme-teek，保留 main 分支全部内容，为后续主题增强能力打底（ac5e0671）

[v1.4.0] - 2026-10-08 ​

✨ 新增 ​

  • 站点级能力集中落地（d7c921ba）：
    • 站点 logo 与 ICP 备案信息
    • 中英日三语 i18n 框架（导航、侧边栏、界面文案全量本地化）
    • SDK API 参考页（Python 后端 SDK / JavaScript 前端 SDK）
    • 开发环境 badge 标识
    • Markdown 语法速查页
    • 全站密码门禁
    • 移动端响应式适配
    • 官方默认样式对齐

[v1.3.1] - 2026-10-08 ​

📝 文档 ​

  • 站点内容例行更新与多处细节完善（c3493688）

[v1.3.0] - 2026-10-08 ​

📝 文档 ​

  • 文档目录迁移至 docs/ 子目录，仓库根结构收敛，构建配置同步调整（0fe315be）
  • 新增 Markdown 扩展演示页：集中展示本站支持的容器、徽章、任务列表、脚注、公式等扩展语法，供写作时对照（0fe315be）

[v1.2.1] - 2026-10-08 ​

🐛 修复 ​

  • 修复首页 features 卡片死链：/architecture/multi-device → /architecture/harmonyos（b08f7e91）
  • 修复 mermaid startOnLoad: true 导致的首页 Syntax error，改为 false 后按需初始化， diagram 渲染恢复稳定（d9263d21）

[v1.2.0] - 2026-10-08 ​

📝 文档 ​

  • 新增 repositories 章节：18 个核心仓库全览与分仓详述（鸿蒙浏览器、认证后端 admin、管理前端 admin、应用商店官网、前后端 SDK、Mock Demo、辅助工具群等）（bd4ed4e5）
  • 同步修正旧页面中帧头格式、RBAC 权限模型、安全日志的口径描述，与最新工程实现对齐（bd4ed4e5）
  • 收敛导航与侧边栏结构；pnpm-workspace 放行 esbuild 原生构建，修复干净环境下的安装失败问题（bd4ed4e5）

[v1.1.0] - 2026-10-04 ​

✨ 新增 ​

  • 补充 README.md，说明仓库用途、本地启动与构建方式（89330007）

🔧 其他 ​

  • 将 node_modules 与 dist 移出版本控制，补充 .gitignore 规则，避免构建产物污染仓库（806325d4）

[v1.0.0] - 2026-10-04 ​

✨ 新增 ​

  • 文档站初始化：基于 VitePress 搭建 QXJ 项目文档站（a55c7d96）
  • 建立首页、项目指南、架构设计、核心功能、API 参考、仓库总览、开发指南等基础栏目结构
  • 接入 mermaid 图表、代码分组、自定义容器等 Markdown 扩展能力
最近更新