配置说明
环境变量、配置文件、默认值、必填项、敏感项与示例
网页端
网页端无环境变量与运行时配置文件，全部配置以源码常量形式存在：
| 配置项 | 位置 | 说明 |
|---|---|---|
| 站点全部中文文案 | 文字设置.ts | 唯一修改点；键名不可改 |
| 英文站文案 | src/gallery/Strings/en-US/Resources.ts | 与中文站同步 |
| 致谢列表 | 鸣谢文本.ts | 独立于 文字设置.ts |
| AI 导航站点 | AI导航文本.ts | 名称 / 简介 / 网址 |
| 软件数据 | 软件数据/apps/*.json | 一软件一文件 |
| 分类 | 软件数据/categories.json | 4 个分类 |
| 版本号 | 文字设置.ts 的 app.version（3 处）、英文站 Resources.ts 的 app.version、package.json 的 version | 需同步修改 |
| 加速下载镜像通道 | src/gallery/githubMirror.ts 的 MIRROR_CHANNELS | 增删镜像只改此处 |
| 提交入口 | src/gallery/submitEndpoints.ts | 与桌面端 ShellConfig.SubmitEndpoints 对应 |
| 忽略名单 | 软件数据/update-ignore.json | 由 scripts/update-ignore.mjs 维护 |
构建期环境变量
| 变量 | 取值 | 作用 |
|---|---|---|
SINGLEFILE | 1 | 单文件打包（npm run build:single 即 cross-env SINGLEFILE=1 vite build） |
CI Secrets
| Secret | 用途 |
|---|---|
FTP_SERVER / FTP_USERNAME / FTP_PASSWORD | FTP 镜像部署 |
WEBDAV_USERNAME / WEBDAV_PASSWORD | OpenList WebDAV 部署 |
GITHUB_TOKEN | 工作流内置，自动注入 |
凭据绝不入仓
仓库是公开的，写入即公开，且进入 git 历史后无法撤回，只能更换凭据。所有凭据必须通过仓库 Secrets 注入，不得明文写入仓库任何文件（含注释）。
本地开发用令牌
| 变量 | 说明 |
|---|---|
GITHUB_TOKEN | 可选。不配置时走匿名接口，限流 60 次/小时 |
Windows 7 兼容版
外壳常量集中在 src/Core/ShellConfig.cs，无外部配置文件，无环境变量（除 CSH_SIMULATE_WIN7 排障开关外）。用户设置持久化于 %LOCALAPPDATA%\ClassSoftwareHub\settings.json。
核心常量
| 常量 | 当前值 | 说明 |
|---|---|---|
SiteUrl | https://classsoftwarehub.us.ci | 站点地址；正式发版只改这一行 |
ShellVersion | 1.2.0-insider1.0 | 版本号唯一来源 |
VersionPrefix | dv | 版本号前缀 |
UpdateRepoOwner / UpdateRepoName | c1201y / ClassSoftwareHub-windows7 | 更新仓库；Win7 版独立成库 |
UpdateTagPrefix | ""（空串） | 独立仓库后留空；合库时填上前缀 |
UpdateToken | ""（空） | 留空走匿名（60 次/小时）；⚠️ 永远不要写死在公开仓库里 |
SiteRepoOwner / SiteRepoName / SiteRepoBranch | c1201y / ClassSoftwareHub / main | 软件数据来源仓库 |
SiteRepoDataDir | 软件数据 | 仓库中软件数据目录 |
SubmitEndpoints | https://cshapi.132614.xyz、https://submit.132614.xyz | 提交服务入口，按顺序尝试 |
SubmitTimeoutMs | 10000 | 提交请求超时 |
ContentManifestUrl | https://classsoftwarehub.us.ci/content/manifest.json | 备用内容来源 |
ContentManifestUrlFallback | https://pan.132614.xyz/dav/%E7%BD%91%E7%AB%99/content/manifest.json | 网盘备用来源 |
SiteVersionTarget / SiteVersionDisplay | v2.3.4 / v2.3.4 - Tangram (20260927PR01) | 与站点对齐的版本号 |
LoadTimeoutSeconds | 25 | 导航超时 |
TitleBarHeight | 48 | 标题栏高度 |
MutexName | ClassSoftwareHub.Desktop.SingleInstance | 单实例互斥名 |
ActivateEventName | ClassSoftwareHub.Desktop.ActivateMainWindow | 唤醒主窗口的命名事件 |
WebView2DownloadUrl | WebView2 官方下载页 | 运行时缺失时的引导地址 |
DevContentDir | 开发机站点工程产物目录 | 仅本机存在，正式用户机器自动跳过 |
用户设置
src/Services/SettingsStore.cs 的 AppSettings，节选关键项：
| 设置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
Backdrop | string | acrylic | acrylic / mica / solid |
Theme | string | system | system / light / dark |
SplitTheme | bool | false | 外部组件使用单独外观 |
ExternalTheme | string | system | 外部组件外观，仅 SplitTheme 开启时生效 |
CloseToTray | bool | true | 点关闭收进托盘而非退出 |
AlwaysOnTop | bool | false | 主窗口置顶 |
AutoStart | bool | false | 开机启动 |
MinimizeOnStart | bool | false | 开机启动时最小化 |
TelemetryEnabled | bool | false | 遥测上报，默认关闭；当前实现为空操作 |
PaletteOnTop | bool | true | 工具浮窗置顶 |
SidebarEnabled | bool | true | 屏幕右侧工具侧边栏 |
SidebarMode | string | dock | dock（贴靠，仅左右两边）/ free（自由，四条边） |
SidebarEdge | string | right | 贴靠模式的边 |
SidebarFreeEdge | string | right | 自由模式的边 |
SidebarModuleIds | string[] | { "pick-number", "timer", "stopwatch", "clock" } | 侧边栏模块与顺序 |
提交服务（外部）
提交服务为自建 Cloudflare Worker（代号 classhub），源码不在仓库内。客户端可见的路由与协议见接口与数据模型。
Worker 侧配置项（如 OSS_MAX_BYTES）待确认。
安装脚本
| 配置 | 位置 | 值 |
|---|---|---|
| 版本号 | #define DesktopVersion | 与 ShellVersion 一字不差（不带 dv） |
| AppId | [Setup] AppId | {{C4E7B2A1-6D38-4F5C-9A17-0E8B3D5C7F42} |
| 默认安装目录 | DefaultDirName | {localappdata}\Programs\ClassSoftwareHub-Win7 |
| 权限要求 | PrivilegesRequired | lowest |
| 最低系统版本 | MinVersion | 6.1sp1 |
| 允许架构 | ArchitecturesAllowed | x64compatible |
| 压缩 | Compression | lzma2/max + SolidCompression |
贡献者
椰汁更新日志
2026/10/20 06:59
查看所有更新日志
6b8a2-于
版权所有
版权归属：ClassSoftwareHub
许可证：GPL-3.0