new plugin: Notes

[hugo529100]

https://github.com/hugo529100/hfs-Notes

A simpler one-sentence introduction: This is a quick note-taking notebook that I rely on and must have for my daily work. It supports drag-and-drop uploading of images, files, and short videos, and can even automatically analyze and locally record web articles copied and pasted into it. All of this is properly stored on a local server to prevent my digital notes from being lost.

在阅读下面用AI写的内容之前，我先简单介绍这个插件，为了满足我日常工作生活便捷需要而利用deepseek写下这个工具，并且会在随后的日子里不断使用、完善、优化，力求做到最纯粹的多设备同步的档案记录，值得注意的是需要登录后刷新页面才会出现这个按钮，由于我一直时个人工作使用，所以不会考虑多用户介入共用，虽然这是基于聊天插件进行改进开发，但我日常很少与人聊天，所以都基本是自言自语为主要用途，基于安全性考虑大家斟酌使用。

Before reading the AI-generated content below, let me briefly introduce this plugin. I created this tool with the help of DeepSeek to meet the convenience needs of my daily work and life, and I will continue to use, refine, and optimize it over time, striving to make it the most streamlined multi-device synchronization archive tool possible. One thing to note is that you need to refresh the page after logging in for the button to appear. Since I have always used it for personal work, I do not consider multi-user shared access. Although this was developed based on a chat plugin, I rarely chat with others in daily life, so it is primarily used for self-dialogue. For security considerations, please use it with discretion.

more about the themes or plugins：
https://github.com/hugo529100?tab=repositories

SHANA.Screenrecorder-2026-09-30-10-05-15-820.mp4

SHANA.Screenrecorder-2026-09-30-10-06-06-31.mp4

Notes Plugin - User Guide
📝 Introduction
Notes is a lightweight note-taking tool integrated directly into HFS (HTTP File Server). It allows you to:

Create multiple independent tabs to organize your notes

Support text, images, videos, audio, and file attachments

Auto-save notes with real-time synchronization

Search, star, and collapse notes for better management

🚀 Getting Started

1. Open Notes
   Click the 「✐ Notes」 button in the HFS top menu bar. The notes panel will slide out from the right side.

2. Send a Note
   Type your message in the input box at the bottom

Press Shift + Enter to send

3. Upload Files
   Long press the "Send" button (about 0.6 seconds) → Select files to upload

Or simply drag & drop files directly into the notes panel

Supported formats are automatically converted to the appropriate markup:

Images → [img:fileID]

Videos/Audio → [mov:fileID:displayName]

Other files → [att:fileID:displayName]

📂 Tab Management
Switch Tabs
Click on a tab name at the top to switch. Each tab stores its notes independently.

Filter by Stars
Single-click an active tab → Toggle "show only starred notes"

Rename a Tab
Double-click the tab name → Enter new name → Press Enter to confirm

Reorder Tabs
Click the sort buttons (◀ ▶) next to the tabs

Drag to adjust the order

📂 Category Management
Create/Assign Categories
In the plugin.js configuration, set the category field for each tab. Tabs with the same category will be automatically grouped together.

Switch Categories
Click a category label to filter and display only the tabs belonging to that category.

Rename a Category
Double-click the category name → Enter new name → Press Enter to confirm

Reorder Categories
Double-click the "All" category to enter sorting mode → Use ◀ ▶ buttons to adjust the order

⭐ Note Operations
Edit a Note
Double-click on the note content → Enter edit mode

Click ✓ to save, or press Shift + Enter

Click ✕ to cancel

Delete a Note
Click the ✕ button in the top-right corner of the note → Confirm deletion (all attachments will be removed as well)

Star a Note
Click the ★ button next to the note to mark it as important

Collapse/Expand
Click the ▼/▶ button in the top-right corner of the note to collapse long notes and save space

Copy Content
In edit mode, click the Ⓒ button to copy the entire note content

🔍 Search Function
Click the ⌢ search button at the top

Enter a keyword → Automatically searches all historical notes

Use the ▲/▼ buttons to jump to the previous/next match

🖥️ Fullscreen Mode
Click the "Notes" title to enter fullscreen mode (desktop only)

In fullscreen mode, all tabs in the current category are displayed side by side (up to 3 columns)

Press Esc or click ✕ to exit

🎯 Keyboard Shortcuts
Action Shortcut
Send note Shift + Enter
Save edit Shift + Enter
Cancel edit Esc
Open/Close Notes Click menu button
⚙️ Admin Settings
The following options can be configured in the HFS plugin settings:

Setting Description
Tab List Add/remove/configure tabs and categories
Restrict Users Restrict access to specific users
Backup Interval Auto-backup interval (hours)
Auto Export TXT Export notes as TXT files during backup
Thumbnail Settings Video thumbnail format (JPG/GIF) and quality
FFmpeg Path Path to FFmpeg for video thumbnail extraction
📦 Storage Locations
Type Path
Note data storage/notes/tabs/[TabName]/
Images storage/notes/img/[TabName]/
Videos/Audio storage/notes/mov/[TabName]/
Attachments storage/notes/att/[TabName]/
Thumbnails storage/notes/thumb/[TabName]/
Backups storage/notes/backup/
❓ FAQ
Q: Can guests use Notes?
A: Yes, but only on tabs marked as "public notes," and they can only send plain text.

Q: What is the file size limit?
A: Images up to 80MB, other files up to 200MB.

Q: Are notes automatically backed up?
A: Yes, backups run automatically at the configured interval and are retained for the specified number of days.

📌 Tip: All data is stored on the server. Please perform regular backups to ensure data safety.