Compare commits

..
5 Commits
10 changed files with 153 additions and 18 deletions

No files matched your search

+13 -13
View File
@@ -1,7 +1,7 @@
# HelixNotes
[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](https://gitlab.com/ArkHost/HelixNotes/-/blob/main/LICENSE)
[![Latest Release](https://img.shields.io/badge/release-v1.3.7-green)](https://gitlab.com/ArkHost/HelixNotes/-/releases/v1.3.7)
[![Latest Release](https://img.shields.io/badge/release-v1.3.8-green)](https://gitlab.com/ArkHost/HelixNotes/-/releases/v1.3.8)
[![Website](https://img.shields.io/badge/web-helixnotes.com-purple)](https://helixnotes.com)
[![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20Windows%20%7C%20macOS%20%7C%20Android-lightgrey)]()
@@ -10,7 +10,7 @@ A local markdown note-taking app built with Tauri, SvelteKit, and Rust.
Your notes are stored as standard Markdown files on your local filesystem.
No cloud, no lock-in.
## Download (v1.3.7)
## Download (v1.3.8)
### Linux
@@ -29,7 +29,7 @@ Install [Flatpak](https://flatpak.org/setup/) first if it is not already availab
The AppImage works only on Fedora 43+, Arch Linux, and openSUSE Tumbleweed (x86_64).
[Download AppImage](https://download.helixnotes.com/releases/v1.3.7/HelixNotes_1.3.7_amd64.AppImage)
[Download AppImage](https://download.helixnotes.com/releases/v1.3.8/HelixNotes_1.3.8_amd64.AppImage)
#### Distro-specific packages
@@ -119,16 +119,16 @@ sudo eopkg it helixnotes
#### Manual package downloads
- [.deb](https://download.helixnotes.com/releases/v1.3.7/HelixNotes_1.3.7_amd64.deb) (Ubuntu 22.04+)
- [.rpm](https://download.helixnotes.com/releases/v1.3.7/HelixNotes-1.3.7-1.x86_64.rpm)
- [.deb](https://download.helixnotes.com/releases/v1.3.8/HelixNotes_1.3.8_amd64.deb) (Ubuntu 22.04+)
- [.rpm](https://download.helixnotes.com/releases/v1.3.8/HelixNotes-1.3.8-1.x86_64.rpm)
### Windows
[Download Installer](https://download.helixnotes.com/releases/v1.3.7/HelixNotes_1.3.7_x64-setup.exe) (Windows 10/11)
[Download Installer](https://download.helixnotes.com/releases/v1.3.8/HelixNotes_1.3.8_x64-setup.exe) (Windows 10/11)
### macOS (v1.3.6)
The macOS 1.3.7 release is delayed. Version 1.3.6 remains available below.
The macOS 1.3.8 release is delayed. Version 1.3.6 remains available below.
[Download .dmg (Apple Silicon)](https://download.helixnotes.com/releases/v1.3.6/HelixNotes_1.3.6_aarch64.dmg) (M-series Macs)
@@ -142,7 +142,7 @@ xattr -cr /Applications/HelixNotes.app
### Android
[Download APK](https://download.helixnotes.com/releases/v1.3.7/HelixNotes_1.3.7_android.apk)
[Download APK](https://download.helixnotes.com/releases/v1.3.8/HelixNotes_1.3.8_android.apk)
---
@@ -163,17 +163,17 @@ All releases: [gitlab.com/ArkHost/HelixNotes/-/releases](https://gitlab.com/ArkH
- Manual notebook sorting (drag to reorder above, into, or below)
- External `.md` viewer mode with import-to-vault flow
- PDF preview, Obsidian import, "Show in File Manager"
- [Editable Live preview](docs/live-preview.md) alongside rich text and Markdown source, with one compact editor-mode selector and a three-button new-note preference (1.3.8, unreleased)
- [Quick vault switching](docs/vault-switching.md) from the title bar, with saved-vault paths, Add vault and Manage Vaults (1.3.8, unreleased)
- [Editable Live preview](docs/live-preview.md) alongside rich text and Markdown source, with one compact editor-mode selector and a three-button new-note preference
- [Quick vault switching](docs/vault-switching.md) on desktop and mobile, with saved-vault paths, Add vault and Manage Vaults
- AI writing tools (Ollama / OpenAI-compatible / Anthropic / OpenAI)
- [Provider model discovery and opt-in image input](docs/ai-models-and-images.md) (1.3.8, unreleased)
- [Provider model discovery and opt-in image input](docs/ai-models-and-images.md)
- **Optional WebDAV sync** to your own server (Nextcloud, ownCloud, a NAS): manual or automatic, with keep-both conflict copies
- Version history with main-area diffs and rendered read-only snapshots, automatic backups
- Multi-window, file associations, focus mode, view mode
- Themes (light, dark, and built-in palettes), accent colors, fonts including bundled Ubuntu and Ubuntu Mono, 80-200% interface scale
- [Daily-note templates](docs/daily-note-templates.md), with per-vault Markdown import/editing and date/title placeholders, applied only to new notes
- Interface languages: English, Russian, Dutch, German, Spanish, French, Italian, Portuguese (Portugal) and Portuguese (Brazil), with live switching
- [MCP integration](docs/mcp.md) in Settings, with a packaged helper, per-vault read-only access and opt-in native note editing; no Node.js installation required (1.3.8, unreleased)
- [Desktop MCP integration](docs/mcp.md) in Settings, with a packaged helper, per-vault read-only access and opt-in native note editing; no Node.js installation required
- Local plain-text files, no company cloud
### Version history
@@ -215,7 +215,7 @@ See the [translation guide and example file](docs/translations/README.md) for pl
### Prerequisites
- [Rust](https://rustup.rs/) (1.88+)
- [Node.js](https://nodejs.org/) (18+)
- [Node.js](https://nodejs.org/) (22 LTS or later)
- [pnpm](https://pnpm.io/)
- System dependencies for Tauri: see [Tauri prerequisites](https://v2.tauri.app/start/prerequisites/)
+1 -1
View File
@@ -1,6 +1,6 @@
# AI models and image input
These changes are planned for 1.3.8 and are not in the published 1.3.7 packages.
Included in HelixNotes 1.3.8 on desktop and mobile.
## Choose a model
+1 -1
View File
@@ -1,6 +1,6 @@
# Live Preview
Work for 1.3.8, in release preparation. Version 1.3.8 has not yet been published.
Included in HelixNotes 1.3.8 on desktop and mobile.
## Choose an editor mode
+1 -1
View File
@@ -1,6 +1,6 @@
# Connect an AI client to HelixNotes
Desktop integration for **1.3.8**, in release preparation. No 1.3.8 release tag or npm package has been published.
Included in **HelixNotes 1.3.8** for Linux, Windows and macOS. The native helper is packaged with the app; no Node.js or npm installation is required.
## Set it up
+1 -1
View File
@@ -1,6 +1,6 @@
# Quick vault switching
Work for 1.3.8, in release preparation. Version 1.3.8 has not yet been published.
Included in HelixNotes 1.3.8 on desktop and mobile.
The desktop title bar shows the current vault name beside the app name. Open its dropdown to switch directly to another saved vault. Each row shows its name and folder path, with a checkmark on the current vault. Paths distinguish vaults with identical names; long names truncate in the title bar but remain readable in the menu.
+2 -1
View File
@@ -19,8 +19,9 @@
"test:mcp": "pnpm --filter @helixnotes/mcp test",
"test:rust": "cargo test --manifest-path src-tauri/Cargo.toml",
"test:browser": "playwright test --config tests/browser/playwright.config.ts --workers=2",
"test:updater-packaging": "python3 -m unittest discover -s packaging/updater -p 'test_*.py'",
"lint:rust": "cargo fmt --manifest-path src-tauri/Cargo.toml --check && cargo clippy --manifest-path src-tauri/Cargo.toml --all-targets -- -D warnings",
"verify": "pnpm check && pnpm test && pnpm test:mcp && pnpm test:rust && pnpm test:mcp:native && pnpm lint:rust && pnpm build",
"verify": "pnpm check && pnpm test && pnpm test:updater-packaging && pnpm test:mcp && pnpm test:rust && pnpm test:mcp:native && pnpm lint:rust && pnpm build",
"tauri": "tauri",
"tauri:dev": "tauri dev",
"tauri:build": "tauri build"
+1
View File
@@ -0,0 +1 @@
__pycache__/
+34
View File
@@ -0,0 +1,34 @@
# Windows updater packaging
Tauri updater 2.10 accepts a signed NSIS executable directly. The public Windows
feed uses `HelixNotes_<version>_x64-setup.exe` and its matching `.exe.sig`.
Legacy ZIP updater archives must contain exactly one installer at their root,
with **ZIP_STORED** entries. The updater's `zip` dependency disables default
features and has no Deflate decoder. A ZIP opening successfully in Python,
Explorer or 7-Zip does not prove that the updater can extract it.
Prepare compatibility archives from the already-tested installers:
```sh
python3 packaging/updater/prepare_windows_updaters.py \
--version 1.3.8 --installers /path/to/installers --output /path/to/staging
pnpm test:updater-packaging
```
Sign each final archive with the existing Tauri updater identity. Verify every
signature against the public key embedded in the app. Never reuse an installer's
signature for its ZIP wrapper. Regenerate release checksums after signing.
Before publication, test the actual previous Windows release's **Download &
Install** flow against the final payload and signature. Verify that the upgraded
app reports the target version and preserves synthetic notes. Keep personal
profiles backed up and restore them after QA.
## 1.3.8 correction
The initial compatibility ZIPs incorrectly used Deflate. This reproduced
`unsupported Zip archive: Compression method not supported` in the native
1.3.7 Windows app. The feed was changed to the existing signed native EXE and
an actual 1.3.7-to-1.3.8 in-app update passed. Both compatibility ZIPs were
repacked as Stored and re-signed; installer binaries were not changed.
@@ -0,0 +1,55 @@
#!/usr/bin/env python3
"""Wrap existing signed Windows installers for Tauri's legacy ZIP updater.
Tauri updater 2.10 builds zip with default-features=false. Only ZIP_STORED
entries work; Python's ability to extract Deflate does not prove compatibility.
"""
import argparse
import hashlib
from pathlib import Path
import re
import zipfile
def validate_archive(archive: Path, installer: Path) -> None:
with zipfile.ZipFile(archive) as wrapper:
entries = wrapper.infolist()
if len(entries) != 1 or entries[0].filename != installer.name:
raise ValueError("Updater ZIP must contain exactly one root-level installer")
if entries[0].compress_type != zipfile.ZIP_STORED or entries[0].flag_bits & 1:
raise ValueError("Tauri requires unencrypted ZIP_STORED installer entries")
if hashlib.sha256(wrapper.read(entries[0])).digest() != hashlib.sha256(installer.read_bytes()).digest():
raise ValueError("Wrapped installer differs from the tested original")
def build_archive(installer: Path, archive: Path) -> None:
if not installer.is_file() or installer.suffix.lower() not in {".exe", ".msi"}:
raise ValueError("Expected an existing Windows EXE or MSI installer")
archive.parent.mkdir(parents=True, exist_ok=True)
temporary = archive.with_name(archive.name + ".tmp")
try:
with zipfile.ZipFile(temporary, "w", compression=zipfile.ZIP_STORED) as wrapper:
wrapper.write(installer, arcname=installer.name, compress_type=zipfile.ZIP_STORED)
validate_archive(temporary, installer)
temporary.replace(archive)
finally:
temporary.unlink(missing_ok=True)
def main() -> None:
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument("--version", required=True)
parser.add_argument("--installers", type=Path, required=True)
parser.add_argument("--output", type=Path, required=True)
args = parser.parse_args()
if not re.fullmatch(r"\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?", args.version):
parser.error("Invalid release version")
prefix = "HelixNotes_" + args.version
for source, target in [(prefix + "_x64-setup.exe", prefix + "_x64-setup.nsis.zip"),
(prefix + "_x64_en-US.msi", prefix + "_x64_en-US.msi.zip")]:
build_archive(args.installers / source, args.output / target)
print("Validated ZIP_STORED:", target)
if __name__ == "__main__":
main()
@@ -0,0 +1,44 @@
import tempfile
from pathlib import Path
import unittest
import zipfile
from prepare_windows_updaters import build_archive, validate_archive
class WindowsUpdaterArchiveTests(unittest.TestCase):
def setUp(self):
self.temp = tempfile.TemporaryDirectory()
self.addCleanup(self.temp.cleanup)
self.root = Path(self.temp.name)
self.installer = self.root / "HelixNotes_1.3.8_x64-setup.exe"
self.installer.write_bytes(b"MZ" + b"synthetic installer payload\n" * 100)
self.archive = self.root / "update.zip"
def test_generated_archive_is_stored_and_preserves_exact_installer(self):
build_archive(self.installer, self.archive)
validate_archive(self.archive, self.installer)
with zipfile.ZipFile(self.archive) as archive:
self.assertEqual(archive.infolist()[0].compress_type, zipfile.ZIP_STORED)
self.assertEqual(archive.read(self.installer.name), self.installer.read_bytes())
def test_deflate_is_rejected_even_when_python_can_extract_it(self):
with zipfile.ZipFile(self.archive, "w", compression=zipfile.ZIP_DEFLATED) as archive:
archive.write(self.installer, self.installer.name)
with self.assertRaisesRegex(ValueError, "ZIP_STORED"):
validate_archive(self.archive, self.installer)
def test_nested_installer_is_rejected(self):
with zipfile.ZipFile(self.archive, "w") as archive:
archive.write(self.installer, "nested/" + self.installer.name)
with self.assertRaisesRegex(ValueError, "root-level"):
validate_archive(self.archive, self.installer)
def test_changed_installer_is_rejected(self):
build_archive(self.installer, self.archive)
self.installer.write_bytes(b"different payload")
with self.assertRaisesRegex(ValueError, "differs"):
validate_archive(self.archive, self.installer)
if __name__ == "__main__":
unittest.main()