Skip to content

Web 源码知识 ​

自动生成的源码目录。修改主题 Markdown 的 code_paths 后运行 node docs/.vitepress/scripts/knowledge.mjs generate;不要手工编辑。

返回知识总入口。只读与当前模块有关的主题,再核对其中的源码、测试和状态;规划、历史不代表当前能力。

以下关联用于按源码定位和变更复核,不是完整调用图或主题所有权。跨模块链接保留在地图中,网页侧栏只列地图入口。

Web/ 根目录与跨模块关联 ​

  • 审计与部署记录:来源、查询与证据边界 — delivery.backend-records Backend审计与NAS部署历史的来源、筛选total与summary统计、展示脱敏和保留边界;空审计可能是查询失败,历史成功不证明当前服务或完整恢复。

  • Web 本地启动与 NAS 部署 — delivery.web-deployment Web 本地启动与 Windows NAS 部署的前提、参数、构建和健康检查、Git bundle 交付、备份保留及失败恢复;SkipTests 仍运行前端测试,失败不保证回退代码或数据库。

  • Web 历史性能基线 [历史] — delivery.web-performance-baseline Web 的 2026-07-18 基线及后续补充测量,保留样本、方法和比较数字;不是当前部署性能、容量或测试状态。

Web/Backend ​

  • Android 运维伴侣 — delivery.android-operations Android原生运维入口、现场HTTPS与固定签名中继的职责边界;连接、可见证据和操作授权不能互相替代。

  • HTTP 制品交付、完成计数与响应策略 — delivery.artifact-delivery Backend HTTP制品交付的Range、完成事件、下载计数、Cache-Control/ETag、HEAD副作用与JSON gzip边界;服务端迭代完成不证明客户端落盘。

  • 插件市场后端 — delivery.backend Flask 后端的组成、配置、CLI 参数、管理入口与探测边界;--storage 不隔离配置或 SQLite,命令退出 0 仍须核对业务结果。

  • Web账号、角色与会话生命周期 — delivery.backend-accounts Backend注册、角色权限、改密与找回、数据库Session撤销;配置管理员不走auth_version,跨服务安全操作可能部分成功。

  • 许可证激活与设备名额 — delivery.backend-activation 用户中心的可选许可证激活、TPM 离线凭据、在线租约和后台设备名额。

  • HTTP认证、API key与浏览器CSRF — delivery.backend-auth Backend HTTP凭据优先级、Session权限与API key scopes、key轮换失败副作用和浏览器CSRF;认证成功不等于端点授权或全流程完成。

  • 反馈归属、查询与诊断附件下载 — delivery.backend-feedback 反馈提交按服务端账号归属,普通用户只读本人记录,研发只读账号/API key可下载全部诊断附件,管理员独立更新状态;新目录使用北京时间和机器标识。

  • Backend内置任务、执行记录与恢复 — delivery.backend-jobs Backend内置任务的后台轮询、同步手动执行、SQLite单飞和启动恢复;禁用/停止不取消运行中handler,任务返回不证明历史落盘或副作用回滚。

  • 访问统计、浏览器体验与性能观测 — delivery.backend-observability Backend HTTP访问、SPA体验与性能观测的统计口径、异步丢事件、每日HMAC关联边界、日界线和进程缓存;不等于真实人数或下载完成。

  • Backend Operations 中继与只读概览 — delivery.backend-operations Backend Operations 的接口、身份与任务回执;区分在线、排队和执行完成,并说明加密快照的下载、消费与过期清理。

  • 公共站点数据、分页与文件可见性 — delivery.backend-public-data 公共站点首页、发行归档、日志、工具、Android更新和目录浏览的读模型;compact路径不同,GET可写缓存或修复旧更新目录。

  • 审计与部署记录:来源、查询与证据边界 — delivery.backend-records Backend审计与NAS部署历史的来源、筛选total与summary统计、展示脱敏和保留边界;空审计可能是查询失败,历史成功不证明当前服务或完整恢复。

  • Backend保留配置、数据库快照与隐私清理 — delivery.backend-retention Backend六项在线保留配置、SQLite快照创建、隐私清理和轮换;原子配置替换不等于全链事务,备份存在也不证明所有清理或恢复安全。

  • CVWindowsService 服务包发布与选择 — delivery.cvwindowsservice CVWindowsService 服务包的发布、LATEST_RELEASE、缓存与按版本选包;文件名通过不证明ZIP有效,发布不等于本机安装。

  • 文件中转、覆盖与公开分享 — delivery.file-transfer Web文件中转与桌面云盘的匿名上传、续传、公开分享及过期规则;桌面保存本机队列,网页队列不持久化。

  • 插件目录、详情投影与索引刷新 — delivery.plugin-catalog 插件市场列表、详情投影、索引刷新与版本缓存;compact不代表按页读取源码数据,ready不证明全量刷新无错误。

  • Web 页面与文档托管 — delivery.web-pages React 页面和 VitePress 文档的托管、开发代理、缓存、Brotli/gzip 与 Range 协商、旧分块恢复及文档索引;后台索引刷新不构建网页,也不证明已部署内容最新。

  • Web 架构与演进边界 — platform.web-architecture Web 的组成根、HTTP/服务/持久化边界、现有接口和架构检查;区分已实现约束、性能预算与后续演进目标。

  • Web 本地启动与 NAS 部署 — delivery.web-deployment Web 本地启动与 Windows NAS 部署的前提、参数、构建和健康检查、Git bundle 交付、备份保留及失败恢复;SkipTests 仍运行前端测试,失败不保证回退代码或数据库。

Web/Frontend ​

  • 插件市场后端 — delivery.backend Flask 后端的组成、配置、CLI 参数、管理入口与探测边界;--storage 不隔离配置或 SQLite,命令退出 0 仍须核对业务结果。

  • 许可证激活与设备名额 — delivery.backend-activation 用户中心的可选许可证激活、TPM 离线凭据、在线租约和后台设备名额。

  • 反馈归属、查询与诊断附件下载 — delivery.backend-feedback 反馈提交按服务端账号归属,普通用户只读本人记录,研发只读账号/API key可下载全部诊断附件,管理员独立更新状态;新目录使用北京时间和机器标识。

  • 访问统计、浏览器体验与性能观测 — delivery.backend-observability Backend HTTP访问、SPA体验与性能观测的统计口径、异步丢事件、每日HMAC关联边界、日界线和进程缓存;不等于真实人数或下载完成。

  • 审计与部署记录:来源、查询与证据边界 — delivery.backend-records Backend审计与NAS部署历史的来源、筛选total与summary统计、展示脱敏和保留边界;空审计可能是查询失败,历史成功不证明当前服务或完整恢复。

  • Backend保留配置、数据库快照与隐私清理 — delivery.backend-retention Backend六项在线保留配置、SQLite快照创建、隐私清理和轮换;原子配置替换不等于全链事务,备份存在也不证明所有清理或恢复安全。

  • CVWindowsService 服务包发布与选择 — delivery.cvwindowsservice CVWindowsService 服务包的发布、LATEST_RELEASE、缓存与按版本选包;文件名通过不证明ZIP有效,发布不等于本机安装。

  • 文件中转、覆盖与公开分享 — delivery.file-transfer Web文件中转与桌面云盘的匿名上传、续传、公开分享及过期规则;桌面保存本机队列,网页队列不持久化。

  • Web 页面与文档托管 — delivery.web-pages React 页面和 VitePress 文档的托管、开发代理、缓存、Brotli/gzip 与 Range 协商、旧分块恢复及文档索引;后台索引刷新不构建网页,也不证明已部署内容最新。

  • Web 架构与演进边界 — platform.web-architecture Web 的组成根、HTTP/服务/持久化边界、现有接口和架构检查;区分已实现约束、性能预算与后续演进目标。

  • Web 本地启动与 NAS 部署 — delivery.web-deployment Web 本地启动与 Windows NAS 部署的前提、参数、构建和健康检查、Git bundle 交付、备份保留及失败恢复;SkipTests 仍运行前端测试,失败不保证回退代码或数据库。

基于 MIT License 发布。