暂存-说明文档（部分）

2026-05-16 00:45:51 +08:00
parent 91bedce2d7
commit 9c8de5e664
63 changed files with 2818 additions and 92 deletions
--- a/app/assets/doc/printer_helper_de.md
+++ b/app/assets/doc/printer_helper_de.md
@@ -0,0 +1,58 @@
+# Drucker-Helfer — Kurzanleitung
+
+## Inhaltsverzeichnis
+- Druckerstatus
+- Druck vorbereiten
+- Steuerung
+- Drucker-Helfer (diese Seite)
+- Systemkonfiguration (Admin)
+- OctoPrint-Panel (Admin)
+
+---
+
+## Druckerstatus
+
+Zeigt aktuellen Druckerzustand, Temperaturen und aktive Aufgaben an.
+
+![Druckerstatus Platzhalterbild](assets/doc/images/printer_status_de.png)
+
+---
+
+## Druck vorbereiten
+
+GCode an den Drucker senden, Temperaturen setzen und mit `Druck vorbereiten` bzw. `Jetzt drucken` starten.
+
+![Druck vorbereiten Platzhalterbild](assets/doc/images/printer_prepare_de.png)
+
+---
+
+## Steuerung
+
+Manuelle Grundsteuerungen: Achsen homing, Düsen/Betten bewegen, Pause/Fortsetzen, Druck abbrechen.
+
+![Steuerung Platzhalterbild](assets/doc/images/printer_control_de.png)
+
+---
+
+## Drucker-Helfer (diese Seite)
+
+Tipps zur Fehlerbehebung (Netzwerk, Filament, Bettleveling) und Checkliste vor dem Drucken.
+
+![Drucker Helfer Platzhalterbild](assets/doc/images/printer_helper_de.png)
+
+---
+
+## Systemkonfiguration (Admin)
+
+Admin-Einstellungen für Druckerabmessungen, Limits, Basisprofile und Verbindungsdaten.
+
+![Systemkonfiguration Platzhalterbild](assets/doc/images/printer_system_de.png)
+
+---
+
+## OctoPrint-Panel (Admin)
+
+Eingebettetes OctoPrint-Panel: `OctoPrint Basis-URL` und API-Key konfigurieren, Live-Panel verwenden.
+
+![OctoPrint Platzhalterbild](assets/doc/images/printer_octoprint_de.png)
+
--- a/app/assets/doc/printer_helper_en.md
+++ b/app/assets/doc/printer_helper_en.md
@@ -0,0 +1,64 @@
+# Printer Helper — Quick Guide
+
+## Table of Contents
+- Printer Status
+- Prepare Print
+- Control
+- Printer Helper (this page)
+- System Configuration (Admin)
+- OctoPrint Panel (Admin)
+
+---
+
+## Printer Status
+
+Shows current printer state, temperatures and active job information.
+
+![Printer Status placeholder image](assets/doc/images/printer_status_en.png)
+
+Use this page to monitor `Printer Status` and `Active Print Job`.
+
+---
+
+## Prepare Print
+
+Send prepared GCode to the printer, set temperatures and start a print using `Prepare Print` and `Print Now`.
+
+![Prepare Print placeholder image](assets/doc/images/printer_prepare_en.png)
+
+---
+
+## Control
+
+Basic manual controls: home axes, move nozzle/bed, pause/resume and cancel print.
+
+![Control placeholder image](assets/doc/images/printer_control_en.png)
+
+---
+
+## Printer Helper (this page)
+
+Guides common troubleshooting steps (connectivity, filament, bed leveling) and quick checks before printing.
+
+![Printer Helper placeholder image](assets/doc/images/printer_helper_en.png)
+
+---
+
+## System Configuration (Admin)
+
+Admin-only settings for printer dimensions, limits, shared profiles and connection settings.
+
+![System Config placeholder image](assets/doc/images/printer_system_en.png)
+
+---
+
+## OctoPrint Panel (Admin)
+
+Embedded OctoPrint panel: configure `OctoPrint Base URL`, API key and use the live panel when available.
+
+![OctoPrint Panel placeholder image](assets/doc/images/printer_octoprint_en.png)
+
+---
+
+If you want I can add annotated screenshots for specific printer models.
+
--- a/app/assets/doc/printer_helper_zh-cn.md
+++ b/app/assets/doc/printer_helper_zh-cn.md
@@ -0,0 +1,60 @@
+# 打印助手 — 快速指南
+
+## 目录
+- 打印机状态
+- 准备打印
+- 控制
+- 打印助手（本页）
+- 系统配置（管理员）
+- OctoPrint 面板（管理员）
+
+---
+
+## 打印机状态
+
+显示当前打印机状态、温度和任务信息。
+
+![打印机状态 占位图](assets/doc/images/printer_status_zh-cn.png)
+
+可在此查看 `打印机状态` 与 `当前打印任务`。
+
+---
+
+## 准备打印
+
+将准备好的 GCode 发送到打印机，设置温度并使用 `准备打印` 或 `立即打印` 开始。
+
+![准备打印 占位图](assets/doc/images/printer_prepare_zh-cn.png)
+
+---
+
+## 控制
+
+手动控制：回原点、移动喷嘴/平台、暂停/恢复与取消打印。
+
+![控制 占位图](assets/doc/images/printer_control_zh-cn.png)
+
+---
+
+## 打印助手（本页）
+
+提供常见故障排查步骤（网络、挤出机、床平整）和打印前检查清单。
+
+![打印助手 占位图](assets/doc/images/printer_helper_zh-cn.png)
+
+---
+
+## 系统配置（管理员）
+
+管理员设置打印机尺寸、限制、基础配置和连接信息。
+
+![系统配置 占位图](assets/doc/images/printer_system_zh-cn.png)
+
+---
+
+## OctoPrint 面板（管理员）
+
+内嵌 OctoPrint 面板：配置 `OctoPrint 基础 URL`、API 密钥并使用可用的实时面板。
+
+![OctoPrint 占位图](assets/doc/images/printer_octoprint_zh-cn.png)
+
--- a/app/assets/doc/slice_helper_de.md
+++ b/app/assets/doc/slice_helper_de.md
@@ -0,0 +1,82 @@
+# Slice-Helfer — Kurzanleitung
+
+## Inhaltsverzeichnis
+- Startseite
+- Meine Dateien
+- Plater (Bauteilplatte)
+- Konto-Verwaltung
+- Slice-Helfer (diese Seite)
+- Systemeinstellungen (Admin)
+- Benutzerverwaltung (Admin)
+- API-Schlüssel (Admin)
+
+---
+
+## Startseite
+
+Übersicht des Slicer-Dashboards und schnelle Aktionen.
+
+![Startseite Bild](../../assets/img/slice_helper/home_de.png)
+
+Benutzen Sie die Navigation, um `Startseite` zu öffnen und über `STL Hochladen & Slicen` einen neuen Slice zu starten.
+
+---
+
+## Meine Dateien
+
+Verwalten Sie hochgeladene STL- und GCode-Dateien: hochladen, herunterladen, löschen.
+
+![Meine Dateien Bild](../../assets/img/slice_helper/my-files_de.png)
+
+Wichtige Aktionen: `STL hochladen`, `GCode Herunterladen`, `Löschen`.
+
+---
+
+## Plater (Bauteilplatte)
+
+Modelle auf der Bauteilplatte anordnen, verschieben, drehen und skalieren. Vor dem Slicen `Zusammenführen & Slicen`.
+
+![Plater Bild](../../assets/img/slice_helper/plater_de.png)
+
+---
+
+## Konto-Verwaltung
+
+Für angemeldete Benutzer: Profil, Passwort ändern und aktive Sitzungen verwalten.
+
+![Konto Bild](../../assets/img/slice_helper/account-management_de.png)
+
+---
+
+## Slice-Helfer (diese Seite)
+
+Erklärung der empfohlenen Slicing-Schritte: `Qualitätsprofil` wählen, `Support` und `Fülldichte` konfigurieren, dann `Hochladen & Slicen`.
+
+![Slice Helfer Bild](../../assets/img/slice_helper/slice-helper_de.png)
+
+Statusmeldungen: `Wartend`, `Slicen`, `Gesliced`, `Fehlgeschlagen`.
+
+---
+
+## Systemeinstellungen (Admin)
+
+Admins konfigurieren globale Slicer-Engines und Standardprofile.
+
+![Systemeinstellungen Bild](../../assets/img/slice_helper/system-settings_de.png)
+
+---
+
+## Benutzerverwaltung (Admin)
+
+Admins können Benutzer hinzufügen/ändern und Quoten sowie Rollen setzen (`Benutzer`, `Admin`).
+
+![Benutzerverwaltung Bild](../../assets/img/slice_helper/user-management_de.png)
+
+---
+
+## API-Schlüssel (Admin)
+
+Verwalten Sie API-Schlüssel für externe Integrationen: `Neuen API-Schlüssel erstellen` und `Schlüssel generieren`.
+
+![API Schlüssel Bild](../../assets/img/slice_helper/api-keys_de.png)
+
--- a/app/assets/doc/slice_helper_en.md
+++ b/app/assets/doc/slice_helper_en.md
@@ -0,0 +1,88 @@
+# Slice Helper — Quick Guide
+
+## Table of Contents
+- Home
+- My Files
+- Plater (Build Plate)
+- Account Management
+- Slice Helper (this page)
+- System Settings (Admin)
+- User Management (Admin)
+- API Keys (Admin)
+
+---
+
+## Home
+
+Overview of the slicer dashboard and quick actions.
+
+![Home image](../../assets/img/slice_helper/home_en.png)
+
+Use the top navigation to open `Home` and start a new slice via `Upload & Slice STL`.
+
+---
+
+## My Files
+
+Manage uploaded STL and GCode files. You can upload, delete and download sliced GCode.
+
+![My Files image](../../assets/img/slice_helper/my-files_en.png)
+
+Common actions: `Upload STL`, `Download GCode`, `Delete`.
+
+---
+
+## Plater (Build Plate)
+
+Arrange models on the build plate before slicing. Use translate/rotate/scale tools and `Merge & Slice`.
+
+![Plater image](../../assets/img/slice_helper/plater_en.png)
+
+Tip: ensure all models fit the printable area before slicing.
+
+---
+
+## Account Management
+
+Available when logged in. Update profile, change password, and manage active sessions.
+
+![Account image](../../assets/img/slice_helper/account-management_en.png)
+
+---
+
+## Slice Helper (this page)
+
+This page explains slice workflows and recommended settings. Choose a `Quality Profile`, set `Support` and `Infill Density` then `Upload & Slice`.
+
+![Slice Helper image](../../assets/img/slice_helper/slice-helper_en.png)
+
+Status messages: `Waiting`, `Slicing`, `Sliced`, `Failed`.
+
+---
+
+## System Settings (Admin)
+
+Admins can configure global slicer engines and default profiles under `System Settings`.
+
+![System Settings image](../../assets/img/slice_helper/system-settings_en.png)
+
+---
+
+## User Management (Admin)
+
+Admins can add/edit users, set quotas and roles (`User`, `Admin`).
+
+![User Management image](../../assets/img/slice_helper/user-management_en.png)
+
+---
+
+## API Keys (Admin)
+
+Manage API keys used by external tools. `Create New API Key`, name it and `Generate Key`.
+
+![API Keys image](../../assets/img/slice_helper/api-keys_en.png)
+
+---
+
+If you need example workflows or screenshots, tell me which page to expand.
+
--- a/app/assets/doc/slice_helper_zh-cn.md
+++ b/app/assets/doc/slice_helper_zh-cn.md
@@ -0,0 +1,84 @@
+# 切片助手 — 快速指南
+
+## 目录
+- 主页
+- 我的文件
+- 构建板 (Plater)
+- 账号管理
+- 切片助手（本页）
+- 系统设置（管理员）
+- 用户管理（管理员）
+- API 密钥（管理员）
+
+---
+
+## 主页
+
+切片仪表盘概览与快速操作入口。
+
+![主页 图片](../../assets/img/slice_helper/home_zh-cn.png)
+
+使用导航栏进入“主页”，通过 `上传并切片 STL` 开始新切片。
+
+---
+
+## 我的文件
+
+管理已上传的 STL 与 GCode，可上传、下载或删除文件。
+
+![我的文件 图片](../../assets/img/slice_helper/my-files_zh-cn.png)
+
+常用操作：`上传STL`、`下载 GCode`、`删除`。
+
+---
+
+## 构建板 (Plater)
+
+在构建板上放置与调整模型（平移/旋转/缩放），确认位置后使用 `合并并切片`。
+
+![构建板 图片](../../assets/img/slice_helper/plater_zh-cn.png)
+
+提示：切片前确保模型均在可打印范围内。
+
+---
+
+## 账号管理
+
+登录用户可在此更新资料、修改密码并管理活跃会话。
+
+![账号管理 图片](../../assets/img/slice_helper/account-management_zh-cn.png)
+
+---
+
+## 切片助手（本页）
+
+本页说明推荐的切片流程与设置：选择 `质量配置`、设置 `支撑` 与 `填充密度`，然后 `上传 & 切片`。
+
+![切片助手 图片](../../assets/img/slice_helper/slice-helper_zh-cn.png)
+
+状态提示：`等待中`、`切片中`、`已切片`、`失败`。
+
+---
+
+## 系统设置（管理员）
+
+管理员可在此配置全局切片引擎与默认配置文件。
+
+![系统设置 图片](../../assets/img/slice_helper/system-settings_zh-cn.png)
+
+---
+
+## 用户管理（管理员）
+
+管理员可添加/编辑用户并设置配额与角色（`普通用户`、`管理员`）。
+
+![用户管理 图片](../../assets/img/slice_helper/user-management_zh-cn.png)
+
+---
+
+## API 密钥（管理员）
+
+管理外部工具使用的 API 密钥；点击 `创建新的 API 密钥`，输入名称并 `生成密钥`。
+
+![API 密钥 图片](../../assets/img/slice_helper/api-keys_zh-cn.png)
+