# SkyForgeWorkFile

**Repository Path**: ching_an/sky-forge-work-file

## Basic Information

- **Project Name**: SkyForgeWorkFile
- **Description**: 凌云工坊开源项目文件，主要包含免费版项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-13
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SkyForge 资料仓库（sky-forge-work-file）

本仓库用于存放 SkyForge 网站的可下载资料源文件，并由网站仓库的同步脚本自动读取。

## 仓库结构说明

```text
sky-forge-work-file/
├─ 技术资料/                         # 主资料目录（网站同步默认扫描）
│  ├─ ...
│  └─ .resource.yml                  # 每个资料条目的元信息文件（按目录分布）
├─ 电子设计/                         # 其他资料目录（可扩展）
├─ resources.index.json              # 可选全量索引（用于网站快速同步）
├─ tool/
│  └─ SkyForgeResourceTool/          # C# 入库工具源码（VS2013）
│     ├─ Program.cs
│     ├─ SkyForgeResourceTool.csproj
│     ├─ bin/                        # 编译输出
│     └─ obj/                        # 编译中间文件
├─ README.md                         # 中文说明
└─ README.en.md                      # English README
```

## 元信息文件（.resource.yml）

每个资料条目通过 `.resource.yml` 描述，常见字段：

```yml
id: res-20260518-102152
mode: file            # file 或 bundle
path: 技术资料/电路/ADI滤波器设计教程.pdf
title: ADI滤波器设计教程
module: 电路
category: 教程
tags:
  - 开源资料
  - 电路
desc: ADI出的滤波器设计教程，17个pdf
updatedAt: 2026-05-18
```

说明：
- `mode=file`：`path` 指向单个文件。
- `mode=bundle`：`path` 指向目录，网站下载链接会优先选择该目录下压缩包（zip/rar/7z）。

## 工具使用说明（SkyForgeResourceTool）

工具路径：
- `tool/SkyForgeResourceTool.exe`

开发环境：
- Visual Studio 2013
- .NET Framework 4.5

主要功能：
- 选择来源文件/文件夹（支持拖拽、粘贴复制的文件对象）
- 自动判断 `file` / `bundle`
- 自动生成标题（默认取来源文件名/文件夹名，可手改）
- 选择仓库目标目录并执行入库
- 写入或更新 `.resource.yml`
- 支持删除已有条目
- 支持维护/生成 `resources.index.json`

基本入库流程：
1. 打开工具并确认“仓库目录”为本仓库根目录。
2. 选择来源（文件或文件夹）。
3. 选择目标目录（建议放在 `技术资料` 下对应分类目录）。
4. 填写/确认模块、分类、标签、简介。
5. 点击“执行入库”。
6. 提交并推送仓库变更。

## 与网站仓库联动

网站仓库（`Soft/SkyForge`）通过以下命令同步本仓库资料：

```bash
npm run resources:sync
```

当前同步脚本支持：
- 优先读取 `resources.index.json`（更快）
- 无索引时回退扫描 `.resource.yml`

## 维护建议

- 优先通过工具入库，减少手写 YAML 出错。
- 目录名与标题尽量统一，避免后续检索混乱。
- 大文件（>100MB）建议使用分卷或外链方案，不要直接推送普通 Git 对象。