# ScWK-ui

**Repository Path**: SC-SPM/ScWK-ui

## Basic Information

- **Project Name**: ScWK-ui
- **Description**: SC工坊 ScWorkShop 前端项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-17
- **Last Updated**: 2026-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 生存战争工坊前端

面向生存战争玩家与创作者的资源百科前端。基于 Vue 3、TypeScript 与 Vite，视觉语言与 `scwk-docs` Wiki 保持一致。

## 当前页面

- `/`：发现首页、分类入口、社区精选与动态
- `/resources`：按类型、游戏版本、关键词和热度筛选资源
- `/resource/:slug`：介绍、项目资料、专属教程、版本文件、依赖关系、更新日志与评论区
- `/submit`、`/resource/:id/edit`：使用社区身份发布、上传和编辑资源
- `/community`：社区账号登录、创作中心、本人资源预览与一键转移
- `/admin`：本站角色授权、资源审核、评论管理与审计概览

通用教程与开发资料统一维护在 <https://docs.scwk.net>。生产站点为 <https://www.scwk.net>，API 为 <https://api.scwk.net>；API 端点直接使用域名根路径，例如 `https://api.scwk.net/auth/register`，不增加 `/api` 前缀。

`src/data/catalog.ts` 只保留 TypeScript 类型与资源类型的界面映射，不包含业务记录。数据接入遵循 `../ScWK/docs/architecture.md` 的接口契约。

需要实时获取的首页、资源列表、详情、下载解析和评论均使用 `POST`，前端请求同时启用 `cache: no-store`。

资源详细介绍使用 Markdown，由 `marked` 解析后再经 `DOMPurify` 过滤；社区转移的旧 HTML 内容由后端转换为 Markdown。社区站点统一使用 <https://scbbs.top>。

项目发布、编辑、腾讯云 COS 文件上传、评分、收藏和评论使用工坊独立账号；社区账号作为快捷注册、账号绑定和资源转移的兼容入口。文件通过工坊 API 签发的限时 PUT URL 直传 COS，上传完成后由后端校验，公开地址统一为 `https://cdn.scwk.net`。平台管理员权限由工坊独立授予，不继承或修改社区角色。

## 开发

```bash
npm ci
npm run dev
npm run typecheck
npm run build
```

## 视觉基准

复用 Wiki 的木质棕、草绿色、纸张底色与方正像素细节。Logo 来自 `scwk-docs` 的已有公开资产；项目不内置演示资源，所有业务数据均由后端 API 提供。