Installation for end users

Download the current public release from the CBE Toolbox download page. Choose the installer for your operating system.

The current installers are not signed. Your operating system may show a warning during download or first launch.

macOS

1. Download the Apple Silicon (arm64) DMG.

2. Open the DMG and drag CBE Toolbox into Applications.

3. Try to open CBE Toolbox from Applications. If macOS says that the app is damaged, choose Cancel.

4. Open Terminal and run:

   xattr -dr com.apple.quarantine "/Applications/CBE Toolbox.app"
   

5. Open the app again.

Windows

1. Download the EXE installer.
2. If Edge blocks the download, open its download menu and choose Keep → Show more → Keep anyway.
3. Right-click the downloaded file, open Properties, select Unblock if shown, and choose OK.
4. Run the installer. Installing for the current user is sufficient and does not require administrator rights.
5. If SmartScreen appears, choose More info → Run anyway. If your institution removes that option, contact local IT.

Linux

1. Download the AppImage.

2. Make it executable and start it:

   chmod +x CBE-Toolbox-*.AppImage
   ./CBE-Toolbox-*.AppImage
   

Verify the download

The build page also provides SHA256SUMS.txt. Compare the checksum before opening the installer:

• macOS: shasum -a 256 CBE-Toolbox-*.dmg
• Windows PowerShell: Get-FileHash CBE-Toolbox-*.exe -Algorithm SHA256
• Linux: sha256sum CBE-Toolbox-*.AppImage

The printed checksum must match the line for your file in SHA256SUMS.txt.

Connect a model

CBE Toolbox needs access to an AI model. Your institution may provide the connection, or you may use your own OpenAI-compatible provider. Institutional builds can already contain a configured connection.

Messages and the relevant material for each request are sent to the configured provider. Check the provider's privacy and retention terms before adding course material. See Local persistence versus provider transfer.

To configure the connection:

1. Open Settings with the gear at the top right.
2. Open Model.
3. Enter the base URL, model ID and API key supplied by your institution or provider.
4. Choose Save.
5. Run Test connection.

Do not paste an API key into a Chat, screenshot or support ticket.

Installation for local IT

Build the application

The source repository is https://github.com/phylaxe/cbe-toolbox. Obtain repository access from the project owner, then use Node.js 22.19 or newer.

git clone https://github.com/phylaxe/cbe-toolbox.git
cd cbe-toolbox
npm ci
npm run build
npm test

Create the installer on the target platform:

• macOS: npm run dist:mac --workspace packages/app
• Windows: npm run dist:win --workspace packages/app
• Linux: npm run dist:linux --workspace packages/app
• Checksums: npm run checksums --workspace packages/app

The output is written to packages/app/release/.

A build without CBE_DEFAULT_LLM_API_KEY starts without a preconfigured key. If the variable is present while packaging, the key is included as the first-run default. Users can still edit or remove the connection in Settings. The current default endpoint and model are defined in packages/app/src/main/default-connection.ts.

Provide the model service

CBE Toolbox follows a bring-your-own-provider model. The institution supplies either its own GPU-backed inference service or an approved external provider.

Provide users with:

• an OpenAI-compatible HTTPS base URL;
• a process for obtaining an API key;
• the model IDs available to them;
• any supported context-window and reasoning settings;
• the provider's privacy, retention, training and regional terms.

Client devices need outbound HTTPS access to that endpoint. The app uses the provider's model-list and chat-completions routes. It does not require an inbound port on the lecturer's device.

Review local storage and backups under What is stored locally. Provider keys must not be placed in shared scripts, tickets or documentation.

From first launch to useful work

1. Install the current build. Download it from Installation for end users.

2. Check the model connection. If your institution has not configured it, follow Connect a model. 3. Create or select a Course. Open the course list through the course name at the top. Create a Course for the module you want to design, transfer or review, or select an existing Course. 4. Describe the work. Write one concrete request, for example:

   • “Help me adapt this seminar to CBE. Start with the assessment challenge.”
   • “Critically review the challenge in my recorded design.”

3. Add relevant material if needed. Paste a short description or attach a local file. Import material into the Course Wiki when you want to reuse it in later Chats. See Attachment or course Wiki?. 6. Send the request. Enter sends; Shift+Enter adds a line. Course data remains on this installation. The configured model provider receives the material needed to answer. See Local persistence versus provider transfer.

The overview shows the main areas of the workspace and the first actions.

The narrow view shows the overview above the conversation and message field.

If you cannot continue

• Model connection: Connect a model
• App or answer error: Common symptoms and safe recovery
• Questions about material and privacy: Privacy, data and storage

Purpose and limits

Use the Toolbox to design a CBE module, transfer existing teaching into CBE, or critically review a design. It keeps decisions visible, checks coherence and provides CBE methodology. You remain responsible for subject expertise, institutional decisions and the final module.

Know the workspace

The active Course owns its Chats, recorded design and Wiki. The left side leads to Courses and their stored Chats/Wiki. The centre is the conversation. The right side contains CBE Process Canvas, the recorded design, and CBE Maturity, a working reading of that design. The person and gear at the top right open Profile and Settings for the whole app. The header course name always tells you which Course is active.

Keep the surfaces distinct:

• the conversation carries reasoning, questions and decisions;
• CBE Process Canvas records settled design components;
• CBE Maturity reads the recorded design against the PIONEER continuum;
• the course Wiki holds reusable material you imported for this Course;
• the corpus is curated CBE methodology shipped with the Toolbox.

The workspace shows Courses on the left, the conversation in the centre and CBE Process Canvas on the right.

The narrow view shows the conversation between the collapsed side panels.

Courses

Open the course list through the course name at the top. Create a Course, select another Course, or open its details to rename or delete it. Switching changes the conversation, Canvas, Maturity and Wiki together. Deleting moves the Course folder to the operating system trash. Running answers and Wiki imports must finish before deletion.

The course list shows the active Course, another Course and the field for creating a Course.

Chats, New Session and background work

A Course can retain stored Chats. Continue the open Chat, or resume an older stored Chat from that Course's detail view. New Session starts a fresh conversational context for the same Course; it does not erase the Canvas, step coverage, Maturity reading or previous stored Chat.

If you switch Courses while an answer is running, that work may continue in the background and remains bound to its original Course. Returning shows the matching answer and state. The square Stop control ends the visible running answer; text already received remains and is marked as stopped. A cut-off response offers Continue or Retry. Completed turns and design state are persisted at turn boundaries and survive an app restart.

The conversation shows an answer in progress and the Stop control in the message field.

Design, transfer and critical review—without a mode switch

State the intended work in your request:

• Design: name the module or design decision you want to develop. With no chosen entry point, the work starts from ambition and framing.
• Transfer: provide the existing teaching or a concise description and say what should be adapted. The existing material—not a blank questionnaire—is the starting point.
• Critical review: ask to expose weaknesses or stress-test an available design. The review starts from that design; if it is missing, the Toolbox asks for it rather than inventing findings.

There is no mode menu. If two interpretations would produce materially different next work, the assistant asks one focused clarification. You can redirect the intent during a Chat without resetting the Course or erasing recorded work.

Choose the support you want

The assistant may invite you once to choose lasting support: more step-by-step guidance, collaboration on a draft, or concise feedback. The preference applies across Courses and restarts until you explicitly change or clear it. A one-off request such as “give me one example here” changes only that moment. The preference is separate from the Profile's estimates and says nothing about your competence.

A support preference is not consent to formulate course content. Neither experience, difficulty, silence, limited time nor a preference authorises the assistant to write a component for your module. You can ask to change or clear the lasting preference in the conversation.

The conversation confirms the selected concise support preference.

Formulation help remains your decision

The assistant may formulate text for your own module only after you explicitly ask for it or accept a specific offer. It then works step by step:

1. it restates your decision and the component currently being drafted;
2. it drafts that component, names open gaps and labels any assumption;
3. you correct or accept the wording;
4. the assistant refines or records the accepted part.

A request for a whole design still starts with the current component rather than silently inventing every missing decision. Accepting wording settles the requested text; it does not settle named gaps. Suggestions without support in your material remain labelled assumptions, not facts.

CBE Process Canvas

The Canvas follows ten design steps: 1 frame · 2 learning outcomes · 3 assessment · 4 challenge · 5 stakeholders · 6 learning journey · 7 activities · 8 deliverables · 9 alignment matrix · 10 readiness. You may start where your work is; the order is guidance, not a form you must complete linearly. After step 3 the conversation checks that challenge, outcomes and assessment cohere before it proposes deeper work.

Each step has a focus and a depth: open, rough, refined or detailed. Cards hold settled components. An empty field is an unanswered decision, not a defect to fill automatically. Revisions update the existing card. You can clear a card deliberately and discuss annotations through the conversation. Export produces deterministic Markdown from the recorded host state; it is a design document, not a diagnostic log.

The Canvas shows ten steps, the current focus and cards at different depths.

CBE Maturity

Your overall target is the intended ambition. The achieved reading is derived by the app from the recorded criterion readings; it is not a score the assistant pushes directly. The first reading begins when the coherence gate after step 3 has a subject to assess. Thin evidence produces a provisional reading, not an inflated one.

The seven current PIONEER criteria are:

1. Societal (real-world) challenge — openness and connection to a real issue;
2. Stakeholder involvement — from occasional input to co-creation;
3. Inter-/transdisciplinary — structural integration of academic and non-academic knowledge;
4. Student agency and role of the teacher — student decisions and facilitation;
5. Iterative learning process — testing, feedback, reflection and adaptation;
6. Value-orientation and reflection — ethics and societal impact;
7. Societal impact and transferability — outcomes reaching relevant communities or action.

Each criterion can show current and target levels. A reading may be provisional when evidence is thin, stale after the design changes, or capped by a named reservation you chose to leave unresolved. Discuss or refresh it in the conversation; levels are read-only in the panel and cannot be edited by hand.

The panel shows the overall target, achieved reading and the seven criterion readings.

Attachment or course Wiki?

An attachment is read into the next conversation turn. It appears as a removable pill above the message field and is sent with that message. It is not automatically atomised.

The app-owned menu separates the one-turn attachment route from conversational Help.

The narrow view shows the same attachment and Help actions.

A Wiki import creates reusable atoms for the active Course. Use it when the material should be browsed and retrieved across later Chats. Both routes accept the one current set: PDF, DOCX, PPTX, XLSX, TXT, MD and CSV. CSV remains text. XLSX extraction preserves sheet names, grid positions, empty cells, cached values before formulas, ISO dates and merged-cell positions. Old or macro-capable Excel forms (.xls, .xlsb, .xlsm) are refused by name; save a copy as .xlsx and retry.

Import material into the Wiki

Start import from the active Course's Wiki. Each local document gets its own background row and outcome. Processing is isolated and bounded; one failed document does not discard its siblings. You may abort and retry. Switching Courses does not redirect a run: it stays bound to the Course where it began, and that Course shows its progress when reopened. On success the atom list refreshes automatically. The import accepts local files only; it does not fetch web pages, feeds or other network sources automatically.

The Wiki shows separate progress rows for a completed and a running document.

Browse and search the Wiki

In a Course's Wiki, filter the atom list by words from headings, metadata or body text; open an atom for its source details and related links. Switch between the list and knowledge-graph projections of the same atoms. The graph is another view of the stored links, not a different store.

The list view shows searchable Wiki atoms and their previews.

The graph view shows the links between the same Wiki atoms.

Sources and citations

The curated corpus contains CBE methodology; the Course Wiki contains your reusable course material. If the same source exists in both, the active Course's Wiki takes precedence. A citation in the conversation is clickable: open its detail, inspect the cited section and check the source. A corpus citation is verified against the corpus; a Wiki citation resolves through that Course's index.

The source view shows the cited passage and its document details.

The assistant may make a working suggestion when the available sources do not support a claim. It must clearly label the suggestion as unverified.

Picker questions

A Picker presents a genuine closed choice as pills. It may allow one or several choices and may include Other, which opens free text. Use Tab/Shift+Tab to move, Space or Enter to select, and Escape to leave the current pill. A single ordinary option submits immediately; multiple choices use the submit control. After submission the answer is frozen and returns as the next turn.

The Picker shows three choices and an Other option for free text.

The narrow view stacks the same choices above the message field.

If a Picker cannot be shown, answer the question in prose.

Settings and versions

Open the overlay from the gear at the top right.

Open Settings with Cmd+, on macOS or Ctrl+, on Windows/Linux. F1 opens Help. The application menu also provides the standard editing, zoom, full-screen, window and quit actions.

• The model group holds endpoint, model id and key, connection test, context window and reasoning controls.
• Appearance holds theme, accent, chat text size and interface language. The globe-and-code control in the header changes the same language immediately; it does not choose the language of your teaching content.
  • The information group reports installed app and Skill versions, shows the local CBE Toolbox identity, links to the official PIONEER Alliance website in the system browser, and provides the rereadable first-use overview.
• The corpus group refreshes current content where available.

The open selector lists the available interface languages.

The narrow header shows the same language selector.

The information group shows the installed app and Skill versions.

The narrow overlay shows the same installed version information.

The update notice appears above the open Settings overlay.

The narrow view places the update notice above Settings.

App updates and content refresh use separate controls in Settings.

Common symptoms and safe recovery

The model is not configured or the connection test fails

Your local Course files remain safe. Open the gear at the top right and the group containing endpoint, model id and key. Check for an accidental surrounding quote, the exact base URL, model id, key and context/reasoning support. Save and test again. If the endpoint is unreachable from a browser/network test or your institution blocks it, contact local IT; do not paste the key into a ticket.

The provider reports a rate limit or model error

Keep the Chat open. Wait for the provider's stated retry period or choose an approved model/endpoint. Retry the request once. Repeated retries can worsen a rate limit. If the provider gives a request id, share that id—not your prompt or key—with the authorised provider administrator.

An answer appears stalled, is stopped or is cut off

While the working status is visible, wait or use the square Stop control. Stop keeps text already received. For an explicitly cut-off answer, choose Continue to finish it or Retry to regenerate the turn. Do not start repeated parallel requests. If the app remains unresponsive, close it only after waiting for local persistence, reopen the Course and inspect the last completed turn.

The Course or stored Chat does not open

Return to the course list and select the Course again. A missing or damaged lossless JSON sidecar can make Resume unavailable while its readable Markdown archive remains listed. Preserve the Course folder and contact support before deleting anything. If a Course deletion was intentional, use the operating system trash to restore its whole folder.

An attachment cannot be extracted

Remove the pending attachment, keep the original, and check that its extension is in PDF, DOCX, PPTX, XLSX, TXT, MD, CSV and that the file itself opens normally. Image-only pages or protected/corrupt office files may yield no usable text. Create an accessible text-based copy rather than overwriting the original.

Excel material is refused

.xls, .xlsb and .xlsm are deliberately refused. Open the original in a trusted spreadsheet application, use Save As to create a separate .xlsx copy, inspect that copy and attach/import it again. Do not merely rename the extension.

A Wiki import is refused, fails or is aborted

A new import can start only for the active Course and only when that Course has no live import. Re-activate the intended Course and retry the failed document. One document's failure does not erase successful siblings. A run that cannot reach the model ends visibly and remains retryable. If you switched Courses, reopen the origin Course to see or abort its run.

CBE Maturity says provisional or stale

This is a state description, not data loss. Provisional means evidence is thin; stale means the recorded design changed after the reading. Ask in the conversation to discuss or refresh the reading. Criterion levels are not manually editable.

A citation cannot be opened or verified

Keep the answer but treat the claim as unverified. Reopen the citation and inspect its detail. If a section is missing, ask the assistant to identify the exact source passage or state the gap. For Wiki material, confirm the atom still exists in the active Course. Never treat a plausible-looking broken link as evidence.

A Picker does not render or shows a failure

Continue in prose: repeat the question briefly and state your choice. The assistant should recover with an ordinary question rather than exposing technical details. Your earlier Course work is unaffected.

App update or content refresh fails

Keep the installed version. Retry only after confirming network access and the current release/content source with local IT. Do not disable certificate checks or replace files inside the app bundle. On unsigned macOS builds, obtain the next installer manually; content refresh is not an app update.

What to share with support

Start with app/Skill version, operating system/version, time, visible symptom, steps that led to it, and a redacted screenshot or copied visible error. Version 0.1.16 has no one-click support export. Share neither provider keys nor personal student data. Do not send a whole app-data/Course folder by default. If authorised support needs a specific session Markdown, JSON sidecar or diagnostic file, agree the exact file and secure channel, retain an untouched backup and redact confidential content.

Contact local IT when policy, certificate, proxy, endpoint reachability, installer trust or storage permissions are involved. Contact the product/release owner for a reproducible app defect tied to the exact version.

What is stored locally

The Toolbox writes its state to the operating system's app-data folder:

• macOS: ~/Library/Application Support/CBE Toolbox/
• Windows: %APPDATA%\CBE Toolbox\
• Linux: ~/.config/CBE Toolbox/

Inside it, each Course has its own folder with course context, course-owned sessions, Canvas/design state, Wiki originals/extractions/atoms and related material. Deleting a Course moves that folder as a unit to the operating system trash.

Some records are intentionally outside every Course: app/model settings, the lecturer-wide Profile estimates, lecturer identity, lasting support preference, interface/onboarding choices and workspace pointers. The provider key is stored with app configuration and protected through the operating system's credential encryption where available. It is not written into a Course.

Back up one Course or the whole installation

1. Finish any running answer or Wiki import and close the app.
2. Preserve the original folder; copy rather than move it.
3. For one Course, copy that Course's complete folder, including all session and Wiki sidecars. This preserves course-owned work but not lecturer-wide Profile/support/identity or app/model configuration.
4. For a complete backup, copy the whole CBE Toolbox app-data folder using an institutionally approved encrypted destination.
5. Restore only to a compatible reviewed installation and keep the backup untouched until the restored state has been checked.

An operating-system-encrypted provider credential may not decrypt on another machine or account. Copying one Course or even the app-data folder does not guarantee a portable usable key; re-enter it through the settings surface when authorised.

Local persistence versus provider transfer

Course work is persisted on your device. When you send a request, the configured model receives what it needs to answer: your messages, relevant attached or Wiki material and retrieved corpus passages. The app sends this to the endpoint shown in the settings overlay's model group, not to a CBE or Bridge & Binary inference service.

If that endpoint is an external service, the material leaves your device and that provider's retention, training, region and data-protection terms apply. Read those terms. If the endpoint runs on your own device through loopback (for example a locally managed compatible server), the model exchange stays local. Content/version checks are separate network operations and do not change which model receives a chat request.

Do not submit personal student data

Personal student data is not accepted for chat, attachments or Wiki ingestion. Remove or anonymise names, identifiers, contact details, grades, free-text feedback and any combination that could identify a student before adding material. A provider contract does not turn identifiable student data into acceptable input. If anonymisation would remove essential meaning, do not submit the material and consult your institution's privacy contact.

Keyboard operation

• In the composer, Enter sends and Shift+Enter inserts a newline. Cmd+Enter and Ctrl+Enter also send. Input-method composition is respected, so confirming composed text does not accidentally send.
• Use Tab/Shift+Tab to move through ordinary controls. Activation uses Enter or Space according to the control.
• The composer + menu, header language selector, panel disclosures, settings/profile overlay and Picker are keyboard-operable.
• The native application menu follows platform conventions: settings uses Cmd+, on macOS and Ctrl+, on Windows/Linux, Help uses F1, and the Edit/View/Window items provide native editing, zoom, full-screen and window actions.
• Escape closes the currently open menu, language list, disclosure, panel layer or overlay where that surface owns Escape, and returns focus to its trigger when appropriate. The language list also supports arrow movement, Home/End and typeahead.
• In a Picker, Tab/Shift+Tab moves between choices, Space or Enter selects, and Escape leaves the focused choice. The free-text choice accepts typing and Enter submission.
• Escape does not stop an answer. Move focus to the square Stop control and activate it. This prevents a global Escape press from destroying work while you are dismissing another surface. The app does not advertise a global shortcut palette. If a path above does not work, use the focused on-screen control and report the visible failure rather than guessing an undocumented key.

Focus, names and non-colour status

Keyboard focus is visibly outlined. Closing a popup or overlay returns focus locally where appropriate; selecting a Course moves focus into the matching workspace rather than leaving it on a hidden control. Opening the first-use card does not steal focus.

The official PIONEER Alliance control in the information group is a keyboard-focusable link whose description says it opens the system browser; a failed open leaves focus and the app in place for a retry.

Primary icon controls carry accessible names. Running work is exposed as a text status and the composer changes to a separately named Stop control; colour is not the only signal. Maturity uncertainty/staleness, the active Course, selected language, selected Picker choices and open disclosures also carry text, state or accessible semantics in addition to colour. Chat turn roles remain available to assistive technology even when the visual role label is hidden.

Text size, narrow widths, zoom and native dialogs

The appearance settings provide chat text size. The app-owned layout is designed to remain usable at the supported narrow width of 775 CSS pixels and at 200% browser-equivalent zoom, including the first-use card, transcript and composer. Side panels can collapse to preserve the centre conversation.

Operating-system file pickers, installer windows and security prompts follow your operating system's keyboard and screen-reader behaviour. Use the accessibility guidance for your operating system.

If focus becomes trapped or content overlaps at your text/zoom setting, preserve the Course, record OS/version, window size, text setting and the focused control, then follow What to share with support.

Glossary

• Course: the local workspace for one module, including Chats, design state and course Wiki.
• conversation / Chat: the sequence of your requests and assistant responses in a Course.
• New Session: a fresh conversational context that keeps the Course's recorded design and older stored Chat.
• CBE Process Canvas: the ten-step record of settled design components.
• card: one recorded component on the Canvas.
• focus: the design step currently being worked on.
• depth: how far a step has been worked: open, rough, refined or detailed.
• CBE Maturity: a working reading of the recorded design against the PIONEER continuum.
• target: the intended overall ambition or the desired level for a criterion.
• achieved reading: the app-derived overall level from recorded current criterion readings.
• criterion: one of the seven PIONEER dimensions used by the Maturity reading.
• corpus: curated CBE methodology delivered with the Toolbox.
• course Wiki: reusable material imported for one Course.
• atom: one focused, searchable note produced from Wiki material, with source and related links.
• attachment: a local file supplied to the next conversation turn, not automatically added to the Wiki.
• citation: a clickable reference to a corpus document or Course-Wiki atom.
• support preference: your explicit lasting choice for guided, collaborative or concise assistance; not an estimate of competence and not consent to formulate content.
• reasoning: a provider/model setting controlling supported reasoning effort; it is not the visible explanation in the answer and not a CBE work mode.

Frequently asked questions

Do I need to complete the ten steps in order?

No. Start at your relevant decision; open fields remain visible. The coherence check after step 3 still matters. See CBE Process Canvas.

Should I attach a file or import it into the Wiki?

Attach for the next turn; import for reusable Course material. See Attachment or course Wiki?.

Does choosing guided support let the assistant write my module?

No. Preference controls assistance style, not authorship consent. See Choose the support you want and Formulation help remains your decision.

Where are my files and what should I back up?

See What is stored locally and the Back up one Course or the whole installation.

Is an uncited suggestion verified CBE methodology?

No. It can be useful working material but must remain non-authoritative. See sources and citations.

Can I use personal student data?

No. Remove or anonymise it before chat, attachment or Wiki ingestion. See Do not submit personal student data.

Where do I get the current installer?

Download it from Installation for end users.

How do I recover from a visible error?

Keep the original work and use the symptom-first Common symptoms and safe recovery.

Installation für Endnutzer:innen

Laden Sie das aktuelle öffentliche Release auf der Download-Seite der CBE Toolbox herunter. Wählen Sie den Installer für Ihr Betriebssystem.

Die aktuellen Installer sind nicht signiert. Das Betriebssystem kann deshalb beim Download oder beim ersten Start eine Warnung zeigen.

macOS

1. Laden Sie die DMG-Datei für Apple Silicon (arm64) herunter.

2. Öffnen Sie die DMG-Datei und ziehen Sie CBE Toolbox nach Programme.

3. Öffnen Sie CBE Toolbox aus Programme. Falls macOS meldet, die App sei beschädigt, wählen Sie Abbrechen.

4. Öffnen Sie Terminal und führen Sie diesen Befehl aus:

   xattr -dr com.apple.quarantine "/Applications/CBE Toolbox.app"
   

5. Öffnen Sie die App erneut.

Windows

1. Laden Sie den EXE-Installer herunter.
2. Falls Edge den Download blockiert, öffnen Sie das Download-Menü und wählen Beibehalten → Mehr anzeigen → Trotzdem beibehalten.
3. Klicken Sie mit der rechten Maustaste auf die Datei, öffnen Sie Eigenschaften, aktivieren Sie falls vorhanden Zulassen und wählen Sie OK.
4. Starten Sie den Installer. Die Installation für den aktuellen Benutzer reicht aus und benötigt keine Administratorrechte.
5. Falls SmartScreen erscheint, wählen Sie Weitere Informationen → Trotzdem ausführen. Fehlt diese Möglichkeit aufgrund einer Richtlinie, wenden Sie sich an die lokale IT.

Linux

1. Laden Sie das AppImage herunter.

2. Machen Sie die Datei ausführbar und starten Sie sie:

   chmod +x CBE-Toolbox-*.AppImage
   ./CBE-Toolbox-*.AppImage
   

Download prüfen

Auf der Build-Seite finden Sie auch SHA256SUMS.txt. Vergleichen Sie die Prüfsumme vor dem Öffnen:

• macOS: shasum -a 256 CBE-Toolbox-*.dmg
• Windows PowerShell: Get-FileHash CBE-Toolbox-*.exe -Algorithm SHA256
• Linux: sha256sum CBE-Toolbox-*.AppImage

Die ausgegebene Prüfsumme muss der Zeile für Ihre Datei in SHA256SUMS.txt entsprechen.

Modell verbinden

Die CBE Toolbox benötigt Zugriff auf ein KI-Modell. Ihre Institution kann die Verbindung bereitstellen. Sie können auch einen eigenen OpenAI-kompatiblen Provider verwenden. Institutionelle Builds können bereits vorkonfiguriert sein.

Nachrichten und das für eine Anfrage relevante Material werden an den konfigurierten Provider gesendet. Prüfen Sie dessen Datenschutz- und Aufbewahrungsbedingungen, bevor Sie Kursmaterial hinzufügen. Siehe Lokale Speicherung und Übermittlung an den Provider.

So richten Sie die Verbindung ein:

1. Öffnen Sie Settings über das Zahnrad oben rechts.
2. Öffnen Sie Model.
3. Tragen Sie Basis-URL, Modell-ID und API-Schlüssel Ihrer Institution oder Ihres Providers ein.
4. Wählen Sie Save.
5. Führen Sie Test connection aus.

Schreiben Sie einen API-Schlüssel nie in einen Chat, Screenshot oder Supportfall.

Installation für lokale IT

Anwendung bauen

Das Quellrepository ist https://github.com/phylaxe/cbe-toolbox. Beziehen Sie den Repository-Zugang vom Projektverantwortlichen und verwenden Sie Node.js 22.19 oder neuer.

git clone https://github.com/phylaxe/cbe-toolbox.git
cd cbe-toolbox
npm ci
npm run build
npm test

Erstellen Sie den Installer auf der Zielplattform:

• macOS: npm run dist:mac --workspace packages/app
• Windows: npm run dist:win --workspace packages/app
• Linux: npm run dist:linux --workspace packages/app
• Prüfsummen: npm run checksums --workspace packages/app

Die Dateien werden nach packages/app/release/ geschrieben.

Ein Build ohne CBE_DEFAULT_LLM_API_KEY startet ohne vorkonfigurierten Schlüssel. Ist die Variable beim Packaging gesetzt, wird der Schlüssel als Standard für den ersten Start eingebunden. Nutzende können die Verbindung in Settings ändern oder löschen. Der aktuelle Standard für Endpunkt und Modell steht in packages/app/src/main/default-connection.ts.

Modellservice bereitstellen

Die CBE Toolbox folgt einem Bring-your-own-provider-Modell. Die Institution stellt einen eigenen GPU-basierten Inferenzdienst oder einen freigegebenen externen Provider bereit.

Geben Sie den Nutzenden:

• eine OpenAI-kompatible HTTPS-Basis-URL;
• einen Prozess zum Bezug eines API-Schlüssels;
• die verfügbaren Modell-IDs;
• unterstützte Einstellungen für Kontextfenster und Reasoning;
• Informationen zu Datenschutz, Aufbewahrung, Training und Region des Providers.

Die Endgeräte benötigen ausgehenden HTTPS-Zugriff auf diesen Endpunkt. Die App verwendet die Routen für Modellliste und Chat Completions. Auf dem Gerät der dozierenden Person muss kein eingehender Port geöffnet werden.

Lokale Ablage und Sicherung beschreibt Was lokal gespeichert wird. Provider-Schlüssel gehören nicht in gemeinsame Skripte, Tickets oder Dokumentation.

Vom ersten Start zur nützlichen Arbeit

1. Aktuellen Build installieren. Laden Sie ihn unter Installation für Endnutzer:innen herunter.

2. Modellverbindung prüfen. Falls Ihre Institution sie nicht vorkonfiguriert hat, folgen Sie Modell verbinden. 3. Course erstellen oder auswählen. Öffnen Sie die Kursliste über den Kursnamen oben. Erstellen Sie einen Course für das Modul, das Sie gestalten, übertragen oder prüfen möchten, oder wählen Sie einen bestehenden Course. 4. Arbeit beschreiben. Formulieren Sie eine konkrete Anfrage, zum Beispiel:

   • „Hilf mir, dieses Seminar auf CBE zu übertragen. Beginne bei der Herausforderung in der Leistungsbewertung.“
   • „Prüfe die Challenge in meinem aufgezeichneten Entwurf kritisch.“

3. Bei Bedarf Material ergänzen. Fügen Sie eine kurze Beschreibung ein oder hängen Sie eine lokale Datei an. Importieren Sie Material ins Course Wiki, wenn Sie es in späteren Chats wiederverwenden möchten. Siehe Anhang oder Course Wiki?. 6. Anfrage senden. Enter sendet, Shift+Enter fügt eine neue Zeile ein. Course-Daten bleiben in dieser Installation. Der konfigurierte Modell-Provider erhält das für die Antwort benötigte Material. Siehe Lokale Speicherung und Übermittlung an den Provider.

Die Übersicht zeigt die wichtigsten Bereiche und die ersten Schritte.

Die schmale Ansicht zeigt die Übersicht über Gespräch und Eingabefeld.

Falls Sie nicht weiterkommen

• Modellverbindung: Modell verbinden
• Fehler in App oder Antwort: Häufige Symptome und sichere Wiederherstellung
• Fragen zu Material und Datenschutz: Datenschutz, Daten und Ablage

Zweck und Grenzen

Mit der Toolbox können Sie ein CBE-Modul gestalten, bestehende Lehre auf CBE übertragen oder einen Entwurf kritisch prüfen. Sie hält Entscheidungen sichtbar, prüft die Kohärenz und stellt CBE-Methodik bereit. Fachliche, institutionelle und abschliessende Entscheide bleiben bei Ihnen.

Orientierung im Arbeitsbereich

Der aktive Course besitzt seine Chats, den aufgezeichneten Entwurf und sein Wiki. Links gelangen Sie zu Courses und deren gespeicherten Chats/Wiki. In der Mitte liegt das Gespräch. Rechts befinden sich CBE Process Canvas, der aufgezeichnete Entwurf, und CBE Maturity, eine Arbeitslesart dieses Entwurfs. Person und Zahnrad oben rechts öffnen Profile und Settings für die ganze App. Der Kursname im Kopfbereich zeigt immer, welcher Course aktiv ist.

Unterscheiden Sie die Flächen:

• Im Gespräch entstehen Begründungen, Fragen und Entscheidungen.
• CBE Process Canvas hält vereinbarte Gestaltungselemente fest.
• CBE Maturity liest den aufgezeichneten Entwurf am PIONEER-Kontinuum.
• Das Course Wiki enthält wiederverwendbares Material, das Sie für diesen Course importiert haben.
• Der Corpus ist die mitgelieferte, kuratierte CBE-Methodik.

Der Arbeitsbereich zeigt links die Courses, in der Mitte das Gespräch und rechts den CBE Process Canvas.

Die schmale Ansicht zeigt das Gespräch zwischen den eingeklappten Seitenpanels.

Courses

Öffnen Sie die Kursliste über den Kursnamen oben. Erstellen Sie einen Course, wählen Sie einen anderen oder öffnen Sie seine Details zum Umbenennen und Löschen. Beim Wechsel ändern sich Gespräch, Canvas, Maturity und Wiki gemeinsam. Beim Löschen wandert der Course-Ordner in den Papierkorb des Betriebssystems. Laufende Antworten und Wiki-Importe müssen vorher enden.

Die Kursliste zeigt den aktiven Course, einen weiteren Course und das Feld zum Erstellen.

Chats, New Session und Arbeit im Hintergrund

Ein Course kann gespeicherte Chats behalten. Setzen Sie den offenen Chat fort oder nehmen Sie in den Course-Details einen älteren Chat wieder auf. New Session startet einen frischen Gesprächskontext für denselben Course; Canvas, Schrittstand, Maturity-Lesart und der bisherige gespeicherte Chat bleiben erhalten.

Wenn Sie während einer laufenden Antwort den Course wechseln, kann die Arbeit im Hintergrund weiterlaufen und bleibt an den ursprünglichen Course gebunden. Bei der Rückkehr sehen Sie die passende Antwort und den passenden Zustand. Das quadratische Stop-Steuerelement beendet die sichtbare laufende Antwort; bereits empfangener Text bleibt als gestoppt markiert. Bei einer abgeschnittenen Antwort werden Fortsetzen oder Wiederholen angeboten. Abgeschlossene Turns und Entwurfszustand werden an Turn-Grenzen gespeichert und überstehen einen Neustart der App.

Das Gespräch zeigt eine laufende Antwort und das Stop-Steuerelement im Eingabefeld.

Gestaltung, Übertragung und kritische Prüfung – ohne Modusschalter

Benennen Sie in Ihrer Anfrage die gewünschte Arbeit:

• Gestaltung: Nennen Sie Modul oder Gestaltungsentscheidung. Ohne eigenen Einstieg beginnt die Arbeit bei Ambition und Rahmen.
• Übertragung: Geben Sie die bestehende Lehre oder eine knappe Beschreibung mit und sagen Sie, was angepasst werden soll. Das vorhandene Material – nicht ein leerer Fragebogen – ist der Ausgangspunkt.
• Kritische Prüfung: Bitten Sie darum, Schwächen aufzudecken oder einen vorhandenen Entwurf einem Stresstest zu unterziehen. Fehlt der Entwurf, fragt die Toolbox danach, statt Befunde zu erfinden.

Es gibt kein Modusmenü. Würden zwei Lesarten zu wesentlich anderer nächster Arbeit führen, stellt der Assistent eine gezielte Klärungsfrage. Sie können die Absicht während eines Chats ändern, ohne den Course zurückzusetzen oder aufgezeichnete Arbeit zu löschen.

Gewünschte Unterstützung wählen

Der Assistent kann Sie einmal einladen, eine dauerhafte Unterstützung zu wählen: mehr schrittweise Anleitung, Zusammenarbeit an einem Entwurf oder knappe Rückmeldung. Diese Präferenz gilt über Courses und Neustarts hinweg, bis Sie sie ausdrücklich ändern oder löschen. Eine einmalige Bitte wie „Gib mir hier ein Beispiel“ gilt nur für diesen Moment. Die Präferenz ist von den Einschätzungen im Profile getrennt und sagt nichts über Ihre Kompetenz aus.

Eine Unterstützungspräferenz ist keine Zustimmung, Inhalte für Ihren Course zu formulieren. Erfahrung, Schwierigkeit, Schweigen, knappe Zeit oder eine Präferenz berechtigen den Assistenten nicht, eine Komponente Ihres Moduls zu schreiben. Im Gespräch können Sie die dauerhafte Präferenz ändern oder löschen lassen.

Das Gespräch bestätigt die gewählte knappe Unterstützungspräferenz.

Formulierungshilfe lässt die Entscheidung bei Ihnen

Text für Ihr eigenes Modul darf der Assistent erst formulieren, nachdem Sie ausdrücklich darum gebeten oder ein konkretes Angebot angenommen haben. Danach arbeitet er schrittweise:

1. Er gibt Ihre Entscheidung und die aktuell bearbeitete Komponente wieder.
2. Er entwirft diese Komponente, nennt offene Lücken und kennzeichnet jede Annahme.
3. Sie korrigieren oder akzeptieren den Wortlaut.
4. Der Assistent verfeinert oder zeichnet den akzeptierten Teil auf.

Auch die Bitte um einen ganzen Entwurf beginnt bei der aktuellen Komponente, statt fehlende Entscheide stillschweigend zu erfinden. Akzeptierter Wortlaut klärt den gewünschten Text, nicht die benannten Lücken. Vorschläge ohne Grundlage in Ihrem Material bleiben gekennzeichnete Annahmen und werden nicht zu Tatsachen.

CBE Process Canvas

Der Canvas folgt zehn Gestaltungsschritten: 1 Rahmen · 2 Lernziele · 3 Assessment · 4 Challenge · 5 Stakeholder · 6 Lernreise · 7 Aktivitäten · 8 Ergebnisse · 9 Alignment-Matrix · 10 Bereitschaft. Sie können dort beginnen, wo Ihre Arbeit steht; die Reihenfolge ist Orientierung und kein linear auszufüllendes Formular. Nach Schritt 3 prüft das Gespräch die Kohärenz von Challenge, Lernzielen und Assessment, bevor es vertiefende Arbeit vorschlägt.

Jeder Schritt hat einen Fokus und eine Tiefe: offen, grob, verfeinert oder detailliert. Karten halten vereinbarte Komponenten fest. Ein leeres Feld ist ein unbeantworteter Entscheid und kein automatisch zu behebender Mangel. Überarbeitungen aktualisieren die vorhandene Karte. Sie können eine Karte bewusst leeren und Anmerkungen im Gespräch klären. Der Export erzeugt deterministisches Markdown aus dem aufgezeichneten Zustand; er ist ein Entwurfsdokument und kein Diagnoseprotokoll.

Der Canvas zeigt zehn Schritte, den aktuellen Fokus und Karten mit unterschiedlichen Tiefen.

CBE Maturity

Ihr Gesamtziel ist die angestrebte Ambition. Die erreichte Lesart leitet die App aus den aufgezeichneten Kriterien ab; sie ist kein Gesamtwert, den der Assistent direkt setzt. Die erste Lesart beginnt, sobald die Kohärenzprüfung nach Schritt 3 einen Gegenstand zum Bewerten hat. Dünne Evidenz ergibt eine provisorische, nicht eine aufgeblähte Lesart.

Die sieben aktuellen PIONEER-Kriterien sind:

1. Gesellschaftliche (reale) Herausforderung – Offenheit und Bezug zu einem realen Anliegen;
2. Einbezug von Stakeholdern – von punktuellem Input bis zur Mitgestaltung;
3. Inter-/Transdisziplinarität – strukturelle Verbindung von akademischem und nichtakademischem Wissen;
4. Studentische Agency und Rolle der Lehrperson – Entscheidungen der Studierenden und Facilitation;
5. Iterativer Lernprozess – Testen, Feedback, Reflexion und Anpassung;
6. Werteorientierung und Reflexion – Ethik und gesellschaftliche Wirkung;
7. Gesellschaftliche Wirkung und Übertragbarkeit – Ergebnisse für relevante Gemeinschaften oder Handlungen.

Jedes Kriterium kann aktuellen Stand und Ziel zeigen. Eine Lesart kann bei dünner Evidenz provisorisch, nach Entwurfsänderungen veraltet oder durch einen bewusst offen gelassenen Vorbehalt gedeckelt sein. Besprechen oder aktualisieren Sie sie im Gespräch; die Stufen im Panel sind schreibgeschützt und nicht manuell editierbar.

Das Panel zeigt Gesamtziel, erreichte Lesart und die sieben Kriterien.

Anhang oder Course Wiki?

Ein Anhang wird in den nächsten Gesprächs-Turn eingelesen. Er erscheint als entfernbarer Chip oberhalb des Nachrichtenfelds und wird mit dieser Nachricht gesendet. Er wird nicht automatisch atomisiert.

Das App-eigene Menü trennt den Anhang für einen Turn von der Gesprächshilfe.

Die schmale Ansicht zeigt dieselben Aktionen für Anhang und Hilfe.

Ein Wiki-Import erzeugt wiederverwendbare Atome für den aktiven Course. Nutzen Sie ihn, wenn Material in späteren Chats durchsuchbar und abrufbar bleiben soll. Beide Wege akzeptieren dieselbe aktuelle Menge: PDF, DOCX, PPTX, XLSX, TXT, MD und CSV. CSV bleibt Text. Bei XLSX bleiben Blattnamen, Rasterpositionen, leere Zellen, zwischengespeicherte Werte vor Formeln, ISO-Daten und verbundene Zellpositionen erhalten. Alte oder makrofähige Excel-Formate (.xls, .xlsb, .xlsm) werden namentlich abgelehnt; speichern Sie eine Kopie als .xlsx und versuchen Sie es erneut.

Material ins Wiki importieren

Starten Sie den Import im Wiki des aktiven Course. Jedes lokale Dokument erhält eine eigene Hintergrundzeile und ein eigenes Ergebnis. Die Verarbeitung ist isoliert und begrenzt; ein fehlgeschlagenes Dokument verwirft seine Geschwister nicht. Sie können abbrechen und erneut versuchen. Ein Course-Wechsel lenkt den Lauf nicht um: Er bleibt an den Start-Course gebunden, der beim erneuten Öffnen seinen Fortschritt zeigt. Nach Erfolg wird die Atomliste automatisch aktualisiert. Der Import akzeptiert nur lokale Dateien und ruft Webseiten, Feeds oder andere Netzwerkquellen nicht automatisch ab.

Das Wiki zeigt getrennte Fortschrittszeilen für ein abgeschlossenes und ein laufendes Dokument.

Wiki durchsuchen

Filtern Sie im Course Wiki die Atomliste nach Wörtern aus Überschrift, Metadaten oder Text; öffnen Sie ein Atom für Quelldetails und verwandte Links. Wechseln Sie zwischen Listen- und Wissensgraphdarstellung derselben Atome. Der Graph ist eine andere Ansicht der gespeicherten Links und kein zweiter Speicher.

Die Listenansicht zeigt durchsuchbare Wiki-Atome und ihre Vorschau.

Die Graphansicht zeigt die Verbindungen zwischen denselben Wiki-Atomen.

Quellen und Zitate

Der kuratierte Corpus enthält CBE-Methodik; das Course Wiki enthält Ihr wiederverwendbares Kursmaterial. Liegt dieselbe Quelle in beiden vor, hat das Wiki des aktiven Course Vorrang. Ein Zitat im Gespräch ist anklickbar: Öffnen Sie die Details, prüfen Sie den zitierten Abschnitt und die Quelle. Ein Corpus-Zitat wird gegen den Corpus geprüft; ein Wiki-Zitat wird über den Index dieses Course aufgelöst.

Die Quellenansicht zeigt die zitierte Passage und die Angaben zum Dokument.

Der Assistent kann einen Arbeitsvorschlag machen, wenn die verfügbaren Quellen eine Aussage nicht belegen. Der Vorschlag muss klar als ungeprüft gekennzeichnet sein.

Picker-Fragen

Ein Picker stellt eine echte geschlossene Wahl als Auswahlflächen dar. Er kann eine oder mehrere Antworten und Andere mit Freitext erlauben. Mit Tab/Shift+Tab bewegen Sie den Fokus, mit Leertaste oder Enter wählen Sie, mit Escape verlassen Sie die aktuelle Auswahlfläche. Eine einzelne gewöhnliche Option wird sofort gesendet; mehrere Optionen verwenden die Senden-Schaltfläche. Danach ist die Antwort eingefroren und kehrt als nächster Turn zurück.

Der Picker zeigt drei Antworten und die Option Andere für Freitext.

Die schmale Ansicht ordnet dieselben Antworten über dem Eingabefeld an.

Falls ein Picker nicht angezeigt werden kann, beantworten Sie die Frage im Text.

Settings und Versionen

Öffnen Sie das Overlay über das Zahnrad oben rechts.

Öffnen Sie Settings auf macOS mit Cmd+, und unter Windows/Linux mit Ctrl+,. F1 öffnet die Hilfe. Das Anwendungsmenü enthält auch die üblichen Aktionen für Bearbeiten, Zoom, Vollbild, Fenster und Beenden.

• Die Modellgruppe enthält Endpunkt, Modell-ID und Schlüssel, Verbindungstest, Kontextfenster und Reasoning-Steuerung.
• Darstellung enthält Theme, Akzent, Chat-Textgrösse und Oberflächensprache. Die Globus-Code-Auswahl im Kopfbereich ändert dieselbe Sprache sofort; sie bestimmt nicht die Sprache Ihrer Lehrinhalte.
  • Die Informationsgruppe zeigt installierte App- und Skill-Versionen, die lokale CBE-Toolbox-Identität, den Link zur offiziellen PIONEER-Alliance-Website im Systembrowser und die erneut lesbare Einführung.
• Die Corpus-Gruppe aktualisiert verfügbare Inhalte.

Die geöffnete Auswahl zeigt die verfügbaren Oberflächensprachen.

Der schmale Kopfbereich zeigt dieselbe Sprachauswahl.

Die Informationsgruppe zeigt die installierten Versionen von App und Skill.

Das schmale Overlay zeigt dieselben Versionsangaben.

Der Update-Hinweis erscheint über dem geöffneten Settings-Overlay.

Die schmale Ansicht zeigt den Update-Hinweis über den Settings.

App-Updates und Inhaltsaktualisierung verwenden getrennte Steuerelemente in Settings.

Häufige Symptome und sichere Wiederherstellung

Das Modell ist nicht konfiguriert oder der Verbindungstest scheitert

Ihre lokalen Course-Dateien bleiben sicher. Öffnen Sie über das Zahnrad oben rechts die Gruppe mit Endpunkt, Modell-ID und Schlüssel. Prüfen Sie versehentliche äussere Anführungszeichen, die exakte Basis-URL, Modell-ID, Schlüssel und unterstützte Kontext-/Reasoning-Werte. Speichern und testen Sie erneut. Ist der Endpunkt auch im Netzwerk nicht erreichbar oder institutionell blockiert, wenden Sie sich an die lokale IT; kopieren Sie den Schlüssel nie in ein Ticket.

Der Provider meldet Rate Limit oder Modellfehler

Lassen Sie den Chat offen. Warten Sie die vom Provider genannte Frist ab oder wählen Sie einen freigegebenen Endpunkt/ein freigegebenes Modell. Wiederholen Sie die Anfrage einmal. Viele Wiederholungen können ein Rate Limit verschärfen. Gibt der Provider eine Request-ID aus, teilen Sie diese – nicht Prompt oder Schlüssel – mit der autorisierten Provider-Administration.

Eine Antwort wirkt blockiert, wurde gestoppt oder abgeschnitten

Solange der Arbeitsstatus sichtbar ist, warten Sie oder verwenden das quadratische Stop-Steuerelement. Bereits empfangener Text bleibt erhalten. Bei ausdrücklich abgeschnittener Antwort wählen Sie Fortsetzen oder Wiederholen. Starten Sie nicht viele parallele Anfragen. Bleibt die App unansprechbar, warten Sie kurz auf die lokale Speicherung, schliessen Sie sie, öffnen Sie den Course erneut und prüfen Sie den letzten abgeschlossenen Turn.

Course oder gespeicherter Chat lässt sich nicht öffnen

Kehren Sie zur Kursliste zurück und wählen Sie den Course erneut. Ein fehlendes oder beschädigtes verlustfreies JSON-Sidecar kann Resume deaktivieren, während das lesbare Markdown-Archiv gelistet bleibt. Bewahren Sie den Course-Ordner und kontaktieren Sie Support, bevor Sie etwas löschen. War eine Course-Löschung beabsichtigt, stellen Sie dessen ganzen Ordner über den Papierkorb des Betriebssystems wieder her.

Ein Anhang lässt sich nicht extrahieren

Entfernen Sie den ausstehenden Anhang, bewahren Sie das Original und prüfen Sie, ob seine Endung zu PDF, DOCX, PPTX, XLSX, TXT, MD, CSV gehört und die Datei normal geöffnet werden kann. Reine Bildseiten oder geschützte/beschädigte Office-Dateien liefern möglicherweise keinen brauchbaren Text. Erstellen Sie eine zugängliche textbasierte Kopie, statt das Original zu überschreiben.

Excel-Material wird abgelehnt

.xls, .xlsb und .xlsm werden bewusst abgelehnt. Öffnen Sie das Original in einer vertrauenswürdigen Tabellenkalkulation, erstellen Sie mit Speichern unter eine separate .xlsx-Kopie, prüfen Sie diese und hängen/importieren Sie sie erneut. Benennen Sie nicht nur die Dateiendung um.

Ein Wiki-Import wird abgelehnt, scheitert oder wurde abgebrochen

Ein neuer Import kann nur für den aktiven Course und ohne bereits laufenden Import dieses Course starten. Aktivieren Sie den vorgesehenen Course und versuchen Sie das fehlgeschlagene Dokument erneut. Der Fehler eines Dokuments löscht erfolgreiche Geschwister nicht. Ein Lauf ohne Modellzugang endet sichtbar und bleibt wiederholbar. Haben Sie den Course gewechselt, öffnen Sie den Start-Course erneut, um seinen Lauf zu sehen oder abzubrechen.

CBE Maturity zeigt provisorisch oder veraltet

Das beschreibt den Zustand und keinen Datenverlust. Provisorisch bedeutet dünne Evidenz; veraltet bedeutet, dass der aufgezeichnete Entwurf nach der Lesart geändert wurde. Bitten Sie im Gespräch um Besprechung oder Aktualisierung. Kriterien-Stufen sind nicht manuell editierbar.

Ein Zitat lässt sich nicht öffnen oder verifizieren

Bewahren Sie die Antwort, behandeln Sie die Aussage aber als unbestätigt. Öffnen Sie das Zitat erneut und prüfen Sie die Details. Fehlt ein Abschnitt, bitten Sie um die genaue Quellpassage oder eine benannte Lücke. Prüfen Sie bei Wiki-Material, ob das Atom im aktiven Course noch existiert. Ein plausibel wirkender defekter Link ist keine Evidenz.

Ein Picker erscheint nicht oder meldet einen Fehler

Fahren Sie in Prosa fort: Wiederholen Sie die Frage kurz und nennen Sie Ihre Wahl. Der Assistent soll mit einer gewöhnlichen Frage weiterfahren und keine technischen Details zeigen. Frühere Course-Arbeit bleibt unberührt.

App-Update oder Inhaltsaktualisierung scheitert

Behalten Sie die installierte Version. Wiederholen Sie erst, nachdem lokale IT Netzwerkzugang und aktuelle Release-/Inhaltsquelle bestätigt hat. Deaktivieren Sie keine Zertifikatsprüfungen und ersetzen Sie keine Dateien im App-Paket. Beziehen Sie bei unsignierten macOS-Builds den nächsten Installer manuell; Inhaltsaktualisierung ist kein App-Update.

Was Sie dem Support mitteilen

Beginnen Sie mit App-/Skill-Version, Betriebssystem/-version, Zeitpunkt, sichtbarem Symptom, auslösenden Schritten und einem bereinigten Screenshot oder sichtbaren Fehlertext. Version 0.1.16 hat keinen Ein-Klick-Supportexport. Teilen Sie weder Provider-Schlüssel noch persönliche Studierendendaten. Senden Sie nicht standardmässig den ganzen App-Daten-/Course-Ordner. Benötigt autorisierter Support eine bestimmte Session-Markdown-Datei, ein JSON-Sidecar oder eine Diagnosedatei, vereinbaren Sie Datei und sicheren Kanal, behalten eine unveränderte Sicherung und entfernen vertrauliche Inhalte.

Kontaktieren Sie lokale IT bei Richtlinien, Zertifikaten, Proxy, Endpunkt-Erreichbarkeit, Installer-Vertrauen oder Speicherrechten. Melden Sie dem Produkt-/Release Owner einen reproduzierbaren App-Fehler mit exakter Version.

Was lokal gespeichert wird

Die Toolbox schreibt ihren Zustand in den App-Datenordner des Betriebssystems:

• macOS: ~/Library/Application Support/CBE Toolbox/
• Windows: %APPDATA%\CBE Toolbox\
• Linux: ~/.config/CBE Toolbox/

Darin besitzt jeder Course einen eigenen Ordner mit Kurskontext, Course-eigenen Sessions, Canvas-/Entwurfszustand, Wiki-Originalen/-Extraktionen/-Atomen und zugehörigem Material. Beim Löschen eines Course wandert dieser Ordner als Einheit in den Papierkorb des Betriebssystems.

Einige Einträge liegen absichtlich ausserhalb aller Courses: App-/Modelleinstellungen, dozierendenweite Profile-Schätzungen, Identität, dauerhafte Unterstützungspräferenz, Oberflächen-/Onboarding-Wahl und Arbeitsbereichszeiger. Der Provider-Schlüssel liegt bei der App-Konfiguration und wird, wo verfügbar, mit der Credential-Verschlüsselung des Betriebssystems geschützt. Er liegt nicht in einem Course.

Einen Course oder die ganze Installation sichern

1. Beenden Sie laufende Antworten und Wiki-Importe und schliessen Sie die App.
2. Bewahren Sie den Originalordner; kopieren statt verschieben.
3. Für einen Course kopieren Sie dessen vollständigen Ordner einschliesslich aller Session- und Wiki-Sidecars. Das erhält Course-eigene Arbeit, aber nicht dozierendenweites Profile/Support/Identität oder App-/Modellkonfiguration.
4. Für eine vollständige Sicherung kopieren Sie den ganzen CBE-Toolbox-App-Datenordner an ein institutionell freigegebenes, verschlüsseltes Ziel.
5. Stellen Sie nur in einer kompatiblen geprüften Installation wieder her und behalten Sie die Sicherung unverändert, bis der wiederhergestellte Zustand geprüft ist.

Ein vom Betriebssystem verschlüsselter Provider-Schlüssel lässt sich möglicherweise auf einem anderen Gerät oder Konto nicht entschlüsseln. Das Kopieren eines Course oder selbst des App-Datenordners garantiert keinen portablen brauchbaren Schlüssel; geben Sie ihn bei Berechtigung über die Einstellungsfläche neu ein.

Lokale Speicherung und Übermittlung an den Provider

Course-Arbeit wird auf Ihrem Gerät gespeichert. Beim Senden erhält das konfigurierte Modell, was es für die Antwort braucht: Ihre Nachrichten, relevantes Anhangs- oder Wiki-Material und abgerufene Corpus-Passagen. Die App sendet dies an den Endpunkt in der Modellgruppe des Einstellungs-Overlays und nicht an einen Inferenzdienst von CBE oder Bridge & Binary.

Ist dieser Endpunkt ein externer Dienst, verlässt das Material Ihr Gerät; dessen Regeln zu Aufbewahrung, Training, Region und Datenschutz gelten. Lesen Sie diese Bedingungen. Läuft der Endpunkt über Loopback auf Ihrem Gerät (zum Beispiel als lokal verwalteter kompatibler Server), bleibt der Modellaustausch lokal. Inhalts-/Versionsprüfungen sind getrennte Netzwerkvorgänge und ändern nicht, welches Modell eine Chat-Anfrage erhält.

Keine persönlichen Studierendendaten übermitteln

Persönliche Studierendendaten werden weder im Chat noch als Anhang oder Wiki-Import akzeptiert. Entfernen oder anonymisieren Sie Namen, Kennungen, Kontaktdaten, Noten, Freitext-Feedback und jede identifizierbare Kombination bevor Sie Material hinzufügen. Ein Provider-Vertrag macht identifizierbare Studierendendaten nicht zu zulässigem Input. Wenn Anonymisierung den wesentlichen Sinn entfernen würde, übermitteln Sie das Material nicht und wenden Sie sich an die Datenschutzstelle Ihrer Institution.

Bedienung mit der Tastatur

• Im Eingabefeld sendet Enter, Shift+Enter fügt eine neue Zeile ein. Cmd+Enter und Ctrl+Enter senden ebenfalls. Eingabemethoden werden berücksichtigt; das Bestätigen zusammengesetzten Texts sendet nicht versehentlich.
• Mit Tab/Shift+Tab bewegen Sie sich durch gewöhnliche Steuerelemente. Aktivieren erfolgt je nach Element mit Enter oder Leertaste.
• Das +-Menü am Eingabefeld, die Sprachauswahl im Kopfbereich, Panel-Offenlegungen, Settings-/Profile-Overlay und Picker sind per Tastatur bedienbar.
• Das native Anwendungsmenü folgt den Plattformkonventionen: Einstellungen verwenden auf macOS Cmd+, und unter Windows/Linux Ctrl+,, Hilfe verwendet F1; Bearbeiten/Ansicht/Fenster stellen native Bearbeitungs-, Zoom-, Vollbild- und Fensteraktionen bereit.
• Escape schliesst das aktuell offene Menü, die Sprachliste, Offenlegung, Panel-Ebene oder das Overlay, wenn diese Fläche Escape besitzt, und gibt den Fokus gegebenenfalls an den Auslöser zurück. Die Sprachliste unterstützt zusätzlich Pfeile, Home/End und Texteingabe zur Suche.
• Im Picker bewegt Tab/Shift+Tab zwischen Antworten, Leertaste oder Enter wählt, Escape verlässt die fokussierte Antwort. Die Freitextantwort nimmt Text und das Senden mit Enter an.
• Escape stoppt keine Antwort. Fokussieren und aktivieren Sie das quadratische Stop-Steuerelement. So zerstört ein globales Escape keine Arbeit, während Sie eine andere Fläche schliessen. Die App nennt keine globale Shortcut-Palette. Funktioniert ein Weg nicht, verwenden Sie das fokussierte sichtbare Steuerelement und melden den sichtbaren Fehler, statt eine nicht dokumentierte Taste zu erraten.

Fokus, Benennungen und Status ohne reine Farbe

Tastaturfokus ist sichtbar umrandet. Das Schliessen von Popup oder Overlay gibt den Fokus lokal passend zurück; beim Course-Wechsel gelangt er in den zugehörigen Arbeitsbereich und bleibt nicht auf einer versteckten Schaltfläche. Die Einführungs-Karte stiehlt keinen Fokus.

Der offizielle PIONEER-Alliance-Link in der Informationsgruppe ist per Tastatur fokussierbar; seine Beschreibung sagt, dass er den Systembrowser öffnet. Scheitert dies, bleiben Fokus und App für einen neuen Versuch erhalten.

Wichtige Symbolsteuerelemente haben zugängliche Namen. Laufende Arbeit wird als Textstatus ausgegeben, und das Eingabefeld wechselt zu einem separat benannten Stop-Steuerelement; Farbe ist nicht das einzige Signal. Unsicherheit/Veraltung der Maturity-Lesart, aktiver Course, gewählte Sprache, Picker-Antworten und offene Offenlegungen tragen zusätzlich Text, Zustand oder zugängliche Semantik. Chat-Rollen bleiben für Assistenztechnologie verfügbar, auch wenn die sichtbare Rollenbezeichnung ausgeblendet ist.

Textgrösse, schmale Breite, Zoom und native Dialoge

Die Darstellungseinstellungen bieten eine Chat-Textgrösse. Das App-eigene Layout bleibt für die unterstützte schmale Breite von 775 CSS-Pixeln und bei 200% browseräquivalentem Zoom nutzbar, einschliesslich Einführung, Transkript und Eingabefeld. Seitenpanels lassen sich einklappen, damit das Gespräch Platz behält.

Dateiauswahl, Installerfenster und Sicherheitsmeldungen folgen der Tastatur- und Screenreader-Bedienung Ihres Betriebssystems. Verwenden Sie die Accessibility-Hilfe des Betriebssystems.

Falls der Fokus hängen bleibt oder Inhalte bei Ihrer Text-/Zoom-Einstellung überlappen, bewahren Sie den Course, notieren OS/Version, Fenstergrösse, Texteinstellung und fokussiertes Element und folgen der Was Sie dem Support mitteilen.

Glossar

• Course: lokaler Arbeitsbereich für ein Modul mit Chats, Entwurfszustand und Course Wiki.
• Gespräch / Chat: Folge Ihrer Anfragen und der Antworten des Assistenten in einem Course.
• New Session: frischer Gesprächskontext, der aufgezeichneten Course-Entwurf und älteren gespeicherten Chat behält.
• CBE Process Canvas: Aufzeichnung vereinbarter Gestaltungselemente entlang zehn Schritten.
• Karte: eine aufgezeichnete Komponente im Canvas.
• Fokus: der gerade bearbeitete Gestaltungsschritt.
• Tiefe: wie weit ein Schritt bearbeitet ist: offen, grob, verfeinert oder detailliert.
• CBE Maturity: Arbeitslesart des aufgezeichneten Entwurfs am PIONEER-Kontinuum.
• Ziel: angestrebte Gesamtambition oder gewünschte Stufe eines Kriteriums.
• erreichte Lesart: von der App aus den aufgezeichneten aktuellen Kriterien abgeleitete Gesamtstufe.
• Kriterium: eine der sieben PIONEER-Dimensionen der Maturity-Lesart.
• Corpus: kuratierte, mit der Toolbox ausgelieferte CBE-Methodik.
• Course Wiki: wiederverwendbares, für einen Course importiertes Material.
• Atom: eine fokussierte durchsuchbare Notiz aus Wiki-Material mit Quelle und verwandten Links.
• Anhang: lokale Datei für den nächsten Gesprächs-Turn, die nicht automatisch ins Wiki gelangt.
• Zitat: anklickbarer Verweis auf ein Corpus-Dokument oder Course-Wiki-Atom.
• Unterstützungspräferenz: Ihre ausdrückliche dauerhafte Wahl für angeleitete, kollaborative oder knappe Unterstützung; weder Kompetenzeinschätzung noch Zustimmung zur Formulierung.
• Reasoning: Provider-/Modelleinstellung für die unterstützte Denkanstrengung; weder die sichtbare Begründung der Antwort noch ein CBE-Arbeitsmodus.

Häufige Fragen

Muss ich die zehn Schritte der Reihe nach abschliessen?

Nein. Beginnen Sie bei der relevanten Entscheidung; offene Felder bleiben sichtbar. Die Kohärenzprüfung nach Schritt 3 bleibt wichtig. Siehe CBE Process Canvas.

Soll ich eine Datei anhängen oder ins Wiki importieren?

Anhängen für den nächsten Turn, importieren für wiederverwendbares Course-Material. Siehe Anhang oder Course Wiki?.

Darf der Assistent bei angeleiteter Unterstützung mein Modul schreiben?

Nein. Die Präferenz steuert die Art der Hilfe und ist keine Zustimmung zur Autorschaft. Siehe Gewünschte Unterstützung wählen sowie Formulierungshilfe lässt die Entscheidung bei Ihnen.

Wo liegen meine Dateien, und was muss ich sichern?

Siehe Was lokal gespeichert wird und Einen Course oder die ganze Installation sichern.

Ist ein Vorschlag ohne Zitat geprüfte CBE-Methodik?

Nein. Er kann als Arbeitsmaterial nützlich sein, bleibt aber nicht autoritativ. Siehe Quellen und Zitate.

Darf ich persönliche Studierendendaten verwenden?

Nein. Entfernen oder anonymisieren Sie sie vor Chat, Anhang oder Wiki-Import. Siehe Keine persönlichen Studierendendaten übermitteln.

Wo erhalte ich den aktuellen Installer?

Laden Sie ihn unter Installation für Endnutzer:innen herunter.

Wie erhole ich mich von einem sichtbaren Fehler?

Bewahren Sie die Originalarbeit und verwenden Sie die symptomorientierte Häufige Symptome und sichere Wiederherstellung.