dsh-neocortex

Zhinao (Neocortex) — a Markdown-authoritative second brain for DeepSeek Harness, with a local recall ledger, lifecycle engine, weekly review and a Web panel.

Features

• Layered memory (L1/L2/L3): L1 long-term model (background, collaboration preferences, task standards) gated by user confirmation; L2 knowledge written automatically with mandatory sources; L3 recent status written directly under daily quotas.
• Local ledger with recall explanations: a crash-conscious local ledger accounts for every recall and write; the Web panel explains why a memory was injected.
• Lifecycle & weekly review: scenes and entries sleep, wake, revive and get promoted by bounded rules; a resumable weekly review queues L1 candidates and sleeping entries for the user.
• Web panel: state, recall explanations, L1-only confirmation, review actions, read-only L2 audit, undo, and six bounded settings sliders.
• Blank template initialization / takeover: first run initializes your brain from a generic, personal-info-free Markdown skeleton, or adopts an existing Zhinao directory without touching its files.

Requirements

• DeepSeek Harness (DSH) >= 0.2.1-rc.5.
• Verified on Windows.

Install

dsh plugin --profile web add dsh-neocortex

or install dsh-neocortex from a DSH plugin market in the GUI.

First run

Open Settings → Plugins → Zhinao / Neocortex and run the setup wizard. You choose the directory yourself in every mode:

• New brain: pick an empty directory; the wizard copies the blank template into it. Any conflicting file aborts the initialization — nothing is overwritten.
• Use existing: point to an existing Zhinao directory; the wizard only verifies it and never modifies existing files.
• Upgrade skeleton: point to an existing but incomplete Zhinao directory; the wizard creates only the missing skeleton files and skips every file that already exists.

Usage

Agents get three tools:

• neocortex_remember — write one atomic fact to L1/L2/L3 with quota or queue feedback.
• neocortex_recall — recall general and sleeping personal history; routes external-knowledge questions to web search.
• neocortex_panel — panel state, review preview, undo, review execution/retry, and bounded settings updates. L1 confirmation and weekly-review accept/reject stay user-only.

You can also steer it in natural language: "skip the brain this time" (no read/write), "don't remember this" (don't save), "remember this" (save it).

Uninstall

Removing the plugin does not delete your brain data: the Markdown files, the local ledger and settings stay on disk.

Development

node --test tests/*.test.mjs

For learning purposes.