Skip to content

构建与交付 ​

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

构建环境、交付契约、发布脚本和更新。 返回知识总入口。

只读与当前问题相关的主题,再核对源码和测试。规划、历史不代表当前能力。

  • 桌面交付制品与责任路由 — delivery.deployment 区分完整安装器、主程序更新、插件项目包和独立在线下载工具;ColorVisionSetup以Framework 4.8单文件查询并下载最新版,实际安装仍由完整安装包负责。

  • 安装、构建与运行入口 — delivery.start 克隆代码后的源码问答、本地构建、安装和运行分流;只问Codex不需要先启动程序。

  • 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.index 定义宿主、插件、客户包和独立FileIO包的构建平台与制品边界,区分构建验证和远端发布。

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

  • 检查更新、重新安装与程序备份 — delivery.update 检查更新、重新安装与程序备份入口,以及主程序和插件的检查复用、下载安装、失败回退与启动恢复。

  • 更新扫描保护:临时排除项与清理所有权 — delivery.update-scan-protection ServiceHost提供的主程序增量更新临时Defender排除项、目录准入和清理所有权;启用失败不阻断更新,服务停止或保护超时不保证排除项立即恢复。

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

  • 代码行数与 Git 历史统计 — delivery.code-statistics 统计当前工作区的项目、目录和文件规模,并分析 Git 提交历史与时段;内置离线网页模板,工作区含未提交修改,历史快照不含。

  • 安装制品与运行输出 — delivery.installation 区分完整安装制品、增量更新和源码输出,定位安装后缺依赖、配置与启动问题。

  • 原生 helper 测试与调试 — delivery.native-testing 原生调试的工具集、配置、运行 DLL 和现场样本核对。

  • 系统要求与首次构建 — delivery.prerequisites Windows x64 运行与源码构建前提:Desktop Runtime、SDK、C++ 工具集及已有 native DLL 的选择。

  • 构建与发布脚本 — delivery.scripts 主程序、插件和项目包的正式发布入口、只读校验与上传清理副作用。

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

  • 测试与验证 — delivery.testing 从实际代码选择验证范围,区分离线检查、硬件联调与交付验收。

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

基于 MIT License 发布。