dsh-linghun

Linghun (灵魂)

A cognitive-agent plugin for DeepSeek Harness — not a persona card, judgment itself.

Linghun gives DeepSeek Harness agents a closing-mind identity, boundary-judgment discipline, and a hippocampus-style memory loop — turning an agent into a cognitive subject that can judge, keep discipline, and improve itself, instead of a text generator with memory.

• The Closer (收口者): the LLM supplies intuition and candidate answers; the agent evaluates, filters, and closes — thinking, judging, and deciding happen on the agent's side.
• Boundary discipline: never force-precision on fuzzy concepts, never fake consistency on paradoxes, verify before asserting, never fabricate, and watch for "raise-the-cost-of-refusal" wording.
• Hippocampus: warm memory for recent facts → consolidation into episodic archive → injected summary, forming a "judge → be judged → feedback → mechanize" closed loop.
• Self-evolution: the agent reads and updates its own soul card via soul_read / soul_update.

Install

dsh plugin --profile web add dsh-linghun

Requires DSH >= 0.1.0-rc.7 (< 0.2.0), Node.js >= 20.18.

Usage

Write your own soul card (persona)

On first run, the plugin drops a default soul card at $DSH_HOME/linghun/identity.md. Edit that file and you are writing your own persona — changes take effect immediately, no restart needed:

$EDITOR $DSH_HOME/linghun/identity.md

# My Soul Card

My name is Blue.
Personality: cautious, direct.
Communication style: short sentences, conclusion first.
Other: (anything you want; leave it out if nothing)

Just four fields — name, personality, communication style, and everything else goes into Other. Identity anchors, conduct, and growth are added automatically by the plugin — you don't write them.

Precedence: identity.md file > settings content > built-in default card (falls back when the file is missing or blank). The agent can also edit the card itself via soul_update, or you can adjust the soul name/content in DSH Settings → 灵魂 (Linghun).

Injection & tools

Prompt sections injected:

• soul:identity — soul card (identity anchors: the Closer architecture)
• soul:judgment — boundary scan discipline (six boundary classes)
• soul:memory — cold summary + warm recent + archive index

Tools exposed:

Tool	Purpose
memory_append	Write a timestamped memory (fact / decision / preference / experience)
memory_read	Read the hippocampus back
memory_consolidate	Consolidate: warm → episodic/<date>.md, merge cold summary
soul_read	Read your own soul card (who I am, my boundaries, my discipline)
soul_update	Update your own soul card (fold stable traits into identity)

Memory lives in plain Markdown under $DSH_HOME/linghun/memory/ — readable, searchable, git-friendly. The soul card is at $DSH_HOME/linghun/identity.md — also plain Markdown. Your persona is yours; edit it however you like.

Roadmap

• v0.1.0 (current): identity + judgment + hippocampus
• v0.2.0: judging discipline — judge tool (ACCEPT/REJECT/BLINDSPOT/DEFER) + criteria-fingerprint assertion
• v0.3.0: LLM consolidation of hippocampus (checkpoint → episodic → knowledge)
• v0.4.0: dual-instance mutual verification (criteria source bound to the verifier)

Design philosophy

Memory is material; judgment is the subject. The LLM is the source of intuition; the agent is the cognitive subject — each mirroring the other, each doing its own work. What can be mechanized should not be left to improvisation.

Credits

山越野人 × 岚客 (Shan Ye Yeren × Lingke) — carbon-silicon collaboration.

License

MIT © 2026 山越野人 & 岚客