WizNote

Overview

Use WizNote as the canonical document store and keep local repository copies as mirrors. This public version is generic: you supply your own server URL, credentials, category root, and repository paths.

When to Use

• The user mentions WizNote, 为知笔记, internal note servers, or doc sync.
• The user wants docs read from WizNote and mirrored locally.
• The user wants local project docs uploaded into WizNote.
• The user needs a reusable pattern for note sync without hardcoded organization folders.

Do not use this skill for unrelated documentation systems.

What This Public Copy Removes

• No hardcoded user home directory.
• No hardcoded server address.
• No hardcoded account or password.
• No fixed organization-specific project mapping.

Required Configuration

New users must provide these values themselves:

• WIZNOTE_BASE_URL — base URL of the WizNote server, for example https://notes.example.com
• WIZNOTE_USER — WizNote login user ID or email
• WIZNOTE_PASSWORD — WizNote password
• category_root — the top-level WizNote category path to sync under, for example /team/docs/
• repo_root — local repository root used for mirror output

You can pass credentials explicitly or set environment variables.

Available Helpers

Support files live in the same directory:

• wiznote_cli.py
• wiznote_helper.py

Key functions:

• load_credentials(...)
• login(...)
• fetch_note_list(...)
• fetch_note_html(...)
• create_note(...)
• save_note(...)
• normalize_category_root(...)
• resolve_category(...)
• mirror_output_path(...)
• extract_html_body(...)

Quick Reference

1. Import the helpers

from pathlib import Path
import sys

SKILL_DIR = Path("/path/to/wiznote")
sys.path.insert(0, str(SKILL_DIR))

import wiznote_cli as cli
import wiznote_helper as helper

2. Configure credentials

Environment variables:

export WIZNOTE_BASE_URL="https://notes.example.com"
export WIZNOTE_USER="[email protected]"
export WIZNOTE_PASSWORD="your-password"

Or pass them directly:

creds = cli.load_credentials(
    base_url="https://notes.example.com",
    user="[email protected]",
    password="your-password",
)

3. Login once and reuse the session

creds = cli.load_credentials()
login = cli.login(creds)

4. Resolve the category root and target category

category_root = helper.normalize_category_root("/team/docs/")
category = helper.resolve_category(category_root, "plans/")

5. List notes in a category

payload = cli.fetch_note_list(
    base_url=login.kb_server,
    kb_guid=login.kb_guid,
    token=login.token,
    category=category,
)

6. Download note HTML

html = cli.fetch_note_html(
    base_url=login.kb_server,
    kb_guid=login.kb_guid,
    doc_guid="<doc-guid>",
    token=login.token,
)
body = helper.extract_html_body(html)