已死亡站点适配说明

[Rhilip]

在 PTPP -> PTD 的迁移过程中，因为历时较长，部分站点已经关闭、需要标记为死亡。
但PTPP和PTD在存储用户数据的结构上存在差异，且因为PTD已经移除了自定义站点功能（参见 #10 中相关），所以用户会因无站点适配而无法导入PTPP中已经获取的已死亡站点的用户数据。

---

现就此类站点的适配说明如下：

1. 给该站点取一个不与其他站点重复的 siteId （siteId 应该为全小写英文字母+数字的组合）
2. 需要提供一张已死亡站点的 favicon，建议大小在 20KiB以下，命名为 ${siteId}.${'png' | 'icon' | 'svg'}，并放置在 /public/icons/site 目录下

Note

你可以在 CzBiX/qb-web 、 mantou568/pre-dessert-sites 或其他网站（例如 https://web.archive.org/ ）寻找 favicon。如果你的PTPP中曾经获取过该站点的 favicon， 也可以通过 base64-to-image 的方式转换出对应文件。

3. 需要提供一个简化版的站点配置，命名为 ${siteId}.ts，并放置在 /src/packages/site/definitions 目录下，对该站点配置说明如下：

Note

ISiteMetadata 的完整定义请参 @pkg/site/types/site.ts，以下仅提供最小实现范例。

import type { ISiteMetadata } from "../types";

export const siteMetadata: ISiteMetadata = {
  version: 1,
  id: "siteId",  // 站点ID，要与文件名相同！
  name: "siteName",  // 站点名称，据实修改即可

  type: "private",   // 站点类型，据实修改即可
  schema: "NexusPHP",  // 站点模版，据实修改即可

  /**
   *  关键！!  如果 urls[0]解析出的host 和 PTPP 中定义的一致，则不用额外定义 host 项，否则  host 需要和 PTPP 中定义的host完全一致！ 
   * 如果 PTPP 中有其他 CDN 链接，请依次填入 urls；如果 PTPP 中定义了 formerHosts ，请一并提供。
   */
  urls: ["https://siteurl.com/"],
  host: "siteurl.com",

  isDead: true,   // 关键！
  
  // 其他如同 search, userInfo, levelRequirements 等配置项，建议不提供！
  
  // 请勿提供 userInputSettingMeta 配置项！
}

4. 请尽量提供 PT-Plugin-Plus 的 master或dev 分支中存在或曾经存在过的站点配置文件链接，方便我们开发组快速核对。