一、平台简介

Yixn Html 部署系统用于托管纯静态单页 HTML 文档。你只需要准备一个 .html 或 .htm 文件，上传后系统会自动保存为 index.html，并生成一个长期有效的独立访问链接。

本平台不提供后端语言、数据库、动态接口等能力，仅作为静态资源目录使用。这一点在下文的「五、使用规范」中会再次说明。

二、快速开始

1. 填写站点信息。在首页表单中填写「网站显示名称」和「管理密码」。名称会显示在站点列表上，密码用于进入管理页和删除站点，请务必单独记录并妥善保管。
2. 选择文件。点击上传区域，或直接把文件拖拽进虚线框内。系统只接受 .html 与 .htm 扩展名。
3. 点击「上传并部署」。系统会自动校验文件类型和大小，然后把文件重命名为 index.html 保存到一个独立目录，同时生成形如 h.3v4.top/site/数字/index.html 的访问地址。
4. 访问或管理。点击「访问」直接打开页面；点击「管理」并输入密码后可进入文件管理器，编辑 HTML/CSS/JS，上传图片、字体等静态资源，或删除整个站点。

三、支持的格式与限制

文件扩展名不符合要求时，系统会直接拒绝，不会尝试解析内容。请不要尝试改名后缀绕过校验，即使上传成功，服务器也不会执行任何脚本，反而可能因为引用路径错误导致页面失效。

四、关于管理密码

1. 管理密码是进入「管理」页、执行文件操作、删除站点的唯一凭证。

2. 密码经 password_hash 加盐哈希后存储，平台无法查看明文，也无法帮你找回或重置。

3. 密码一旦丢失，你可以继续访问已部署的页面，但无法再编辑、上传资源或删除站点。

4. 忘记密码时的现实做法是：重新上传一个新站点继续使用，旧站点如果内容仍可正常访问，可以保留不动。

五、使用规范

1. 上传内容由上传者自行负责，平台不对内容的合法性、准确性作任何担保。

2. 严禁上传违法、色情、赌博、诈骗、侵权、钓鱼或恶意代码等内容。

3. 一经发现违规内容，平台有权不另行通知，直接删除站点并封禁 IP。

4. 站点为公开可访问的页面，请勿在其中放置任何个人隐私、密钥、未公开资料等敏感内容。

5. 平台可能因维护、故障或不可抗力中断服务，不承担赔偿责任，建议重要内容自行保留一份本地备份。

6. 平台不会主动通过邮件、QQ、微信等方式联系你索取密码。若收到此类消息，一律视为诈骗，不要回复，不要点击任何链接。

六、关于站点编号

1. 每个站点都会分配一个纯数字编号，从 1 开始依次递增，显示在站点名称下方。

2. 编号不会被回收。即使删除了站点 #7，下一个新站点依然是 #8，不会重新用 #7。

3. 站点列表按编号从大到小排序，与你何时更新文件无关。这样在更新某个站点内容时，卡片不会跳到列表顶部，方便查找。

4. 站点 ID 一旦生成即固定，访问链接不会因为文件更新而改变。

七、关于文件管理器

1. 进入方式：在站点卡片点击「管理」，输入上传时设置的密码。

2. 文件管理器支持：新建目录、上传单个文件、在线编辑文本文件、删除文件或目录。

3. 目录名只能包含字母、数字、下划线、点、短横线，其他字符会被自动替换为下划线。

4. 上传文件时，系统只接受静态资源扩展名（html、css、js、json、txt、md、svg、png、jpg、gif、webp、ico、woff、woff2、ttf、mp4、mp3、pdf 等）。

5. 任何 PHP 等脚本文件一律拒绝上传，这是硬性安全限制。

6. 删除文件前请认真确认文件名。目录删除会连同其下所有内容一起移除，不可恢复。

7. 单次上传文件后若提示「文件已存在」，说明当前目录下已有同名文件，请先删除旧文件再上传，或改用其他文件名。

八、关于删除站点

1. 删除站点需要输入该站点的管理密码。

2. 删除后，站点目录、sites.json 记录、site_passwords.json 记录都会永久移除，不可恢复。

3. 删除前，请务必确认弹窗里显示的站点名称与你想要删除的一致。

4. 如果密码输错，弹窗会提示「密码错误或站点不存在」，此时不会删除任何内容，可以重新尝试。

九、常见问题

问：上传提示「只允许上传 HTML 或 HTM 文件」怎么办？
答：请确认文件扩展名确实是 .html 或 .htm。部分系统默认隐藏扩展名，重命名时注意不要变成 index.html.html。

问：忘记管理密码了怎么办？
答：很抱歉，密码无法找回，也无法重置。可以重新上传一个新站点继续使用；旧站点如果仍能正常访问，可以保留不动。

问：可以一次上传多个文件吗？
答：首页上传只接受单个 HTML 文件。如果需要 CSS、JS、图片等资源，请先上传 HTML，再进入「管理」逐个上传资源，或把它们直接内联到 HTML 中。

问：上传后访问显示空白或样式丢失？
答：多因 CSS / JS / 图片未一起上传导致外链 404。请检查 HTML 中的引用路径是否为相对路径，并把对应资源通过「管理」上传到相同目录下。

问：站点列表顺序为什么不是我最近更新过的排在最前？
答：列表按站点编号降序排列，与文件更新时间无关，这样更方便稳定地找到自己的站点。

问：站点访问链接会变吗？
答：不会。链接格式固定为 /site/站点ID/index.html，更新文件不影响链接。