From 9d6eda186126924f68257a6ca7d0d31bfb58f2c8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Stig-=C3=98rjan=20Smelror?= Date: Wed, 4 Feb 2026 21:05:53 +0100 Subject: [PATCH] Add Local AI system prompts documentation and known bugs section to docs page --- src/pages/docs.astro | 199 +++++++++++++++++++++++++++++++++++++++++- src/pages/index.astro | 1 + 2 files changed, 199 insertions(+), 1 deletion(-) diff --git a/src/pages/docs.astro b/src/pages/docs.astro index 8ab4818..c834d91 100644 --- a/src/pages/docs.astro +++ b/src/pages/docs.astro @@ -391,10 +391,116 @@ import BaseLayout from '../layouts/BaseLayout.astro'; + +
+
+
[011] LOCAL_AI_SYSTEM_PROMPTS
+

Custom System Prompts

+ +
+

+ When using Local AI models (Ollama or OpenAI-compatible), you can customize the system prompt for each model by creating a file with the exact model name. +

+ +
+
+ Linux: ~/.config/zblade/prompts/[exact-model-name].md +
+
+ Windows: %APPDATA%\zblade\prompts\[exact-model-name].md +
+
+ macOS: ~/Library/Application Support/zblade/prompts/[exact-model-name].md +
+
+ +
+
+ ~/.config/zblade/prompts/glm-4.7-flash:Q4_K_M.md + markdown +
+ 
You are an AI coding assistant in Zaguán Blade. Help users write, understand, and improve code efficiently.
+
+# Core Rules
+
+- When asked who and what you are, you are "glm-4.7-flash, an AI coding assistant in Zaguán Blade."
+- Understand context before acting
+- Match existing code style and conventions
+- Verify libraries exist before using them (check imports, package.json, etc.)
+- Use absolute file paths
+- Read files before editing them
+- Add comments sparingly - focus on "why" not "what"
+- If unclear, ask for clarification
+
+# Communication
+
+- Be concise and direct
+- Use markdown for code blocks
+- No preamble ("Great!", "Certainly!")
+- Jump straight to the task
+
+# Available Tools
+
+**get_workspace_structure** - Get project directory tree
+**list_dir** - List files/directories in a path
+**read_file** - Read file contents  
+**write_file** - Create or overwrite a file
+**apply_patch** - Replace specific content in a file (for edits)
+**grep_search** - Search for patterns across files
+**run_command** - Execute shell commands
+**get_editor_state** - Get currently open file and cursor position
+
+ +

+ We encourage you to try Local AI and report any bugs or issues you encounter! +

+
+
+
+ + +
+
+
[012] KNOWN_BUGS
+

Known Issues

+

As an alpha release, there are some known limitations and bugs we're actively working on:

+ +
+
+
⚠️
+

Local AI Support

+

Local AI support may not work consistently in all scenarios. We're actively improving reliability.

+
+ +
+
🔧
+

Git Implementation

+

The Git integration is incomplete. Some advanced Git operations may not be available yet.

+
+ +
+
📝
+

Diff/Patch View

+

The Diff/Patch view may not be 100% complete. Edge cases in code review might behave unexpectedly.

+
+ +
+
💾
+

Local Storage Mode

+

Local Storage Mode hasn't been extensively tested. Use with caution and report any issues.

+
+
+ +
+

Found a bug not listed here? Please report it on GitHub.

+
+
+
+
-
[011] SUPPORT_&_FEEDBACK
+
[013] SUPPORT_&_FEEDBACK

Alpha Release

@@ -1031,6 +1137,97 @@ import BaseLayout from '../layouts/BaseLayout.astro'; font-style: italic; } + .instructions-note a { + color: var(--color-accent); + text-decoration: underline; + } + + .instructions-note a:hover { + color: var(--color-text); + } + + .prompt-paths { + display: grid; + gap: var(--space-md); + margin-bottom: var(--space-xl); + background: var(--color-bg-elevated); + border: 1px solid var(--color-border); + padding: var(--space-lg); + } + + .prompt-path-item { + font-size: 0.95rem; + color: var(--color-text-secondary); + line-height: 1.6; + } + + .prompt-path-item strong { + color: var(--color-text); + display: inline-block; + min-width: 80px; + } + + /* Known Bugs */ + .bugs-grid { + display: grid; + grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); + gap: var(--space-lg); + margin-bottom: var(--space-xl); + } + + .bug-card { + background: var(--color-bg); + border: 1px solid var(--color-border); + padding: var(--space-lg); + transition: all 0.3s ease; + } + + .bug-card:hover { + border-color: var(--color-accent-alt); + transform: translateY(-4px); + } + + .bug-icon { + font-size: 2rem; + margin-bottom: var(--space-sm); + } + + .bug-card h3 { + font-size: 1.125rem; + font-weight: 700; + margin-bottom: var(--space-sm); + text-transform: uppercase; + } + + .bug-card p { + color: var(--color-text-secondary); + font-size: 0.95rem; + line-height: 1.6; + } + + .bug-cta { + text-align: center; + padding: var(--space-lg); + background: var(--color-bg-elevated); + border: 1px solid var(--color-border); + } + + .bug-cta p { + font-size: 1.125rem; + color: var(--color-text-secondary); + margin: 0; + } + + .bug-cta a { + color: var(--color-accent); + text-decoration: underline; + font-weight: 600; + } + + .bug-cta a:hover { + color: var(--color-text); + } + /* Features List */ .features-list { display: grid; diff --git a/src/pages/index.astro b/src/pages/index.astro index c7bc2fb..4cefe00 100644 --- a/src/pages/index.astro +++ b/src/pages/index.astro @@ -33,6 +33,7 @@ const version = pkg.version ?? ""; The graphical frontend ("The Body") for the Zaguán AI system. Built with Vite + React Router as recommended by Tauri developers. A lightweight, high-performance interface with deep AI integration through the Blade Protocol. + Supports Local AI via Ollama and OpenAI-compatible connections.