SOMA v1.1.2

Teaching AI Self-Awareness and Mental Balance

—— The Zhongdao Engine: Real-Time Cognitive Bias Correction ——

May 2026 · soma-wisdom Open Source Project

github.com/sunyan999999/soma

Zero. v1.1.1 → v1.1.2: From "Thinking Well" to "Thinking Without Bias"

If v1.1.1 taught SOMA to adapt its depth to question complexity and to collaborate across multiple expert agents, v1.1.2 tackles a subtler question: can AI get stuck in a mental rut?

The answer is yes — and it happens more easily than you might think. After answering five consecutive questions using "systems thinking," the AI will reflexively apply systems thinking to the sixth question as well — even when "first principles" or "inversion" would be a better fit. This is cognitive bias, reproduced in AI.

The core mission of v1.1.2: give SOMA the ability to notice when it is over-relying on a single thinking framework, and automatically rebalance its perspective in the next round.

This capability is called the Zhongdao Engine (中道引擎) — named after the Chinese philosophical concept of the "Middle Way": dynamic equilibrium without leaning to any extreme.

One. The Problem: Why Does AI Need a "Middle Way"?

A Real Scenario

Imagine you are analyzing a business strategy using SOMA:

RoundYour QuestionAI's Thinking Pattern
1"How do we analyze stagnating growth with systems thinking?"Systems Thinking ✓
2"Go deeper from a systems perspective."Systems Thinking ✓
3"What other systemic factors are at play?"Systems Thinking ✓
4"Use systems thinking to look at the talent problem."Systems Thinking ⚠️
5"How would systems thinking analyze cash flow?"Systems Thinking ⚠️
6"Help me dig deeper."Systems Thinking ❌ (inertia, single lens)

After six rounds, the AI has developed "systems thinking inertia." It no longer considers first principles, the Pareto principle, or inversion — it mechanically applies the same framework. This is Frame Anchoring: a thinking tool, once comfortably familiar, becomes a cognitive prison.

A striking statistic: in v1.1.1 tests, after 5 consecutive rounds using the same thinking law, the AI had over a 90% probability of using that law again on round 6 — regardless of whether it actually fit the question. It wasn't "choosing" a tool; it was "repeating a habit."

Humans Have the Same Problem

This is not unique to AI. Humans do it too.

Economists see everything through supply and demand. Programmers reflexively want to code every problem away. Therapists interpret all behavior through childhood experience. Specialization requires depth — but when a problem genuinely calls for a different lens, clinging to a single framework leads to misjudgment.

Great thinkers share one trait: they know when to switch perspectives. The Zhongdao Engine in v1.1.2 gives AI that same trait.

Two. How Does the Zhongdao Engine Work?

The engine's logic can be summarized in four words: Track, Detect, Penalize, Boost.

Step 1: Track

Every time the AI answers a question, the Zhongdao Engine quietly records: "Which thinking laws were used this round?" It only counts laws you directly triggered — auxiliary perspectives auto-added by the system are not counted, because those are balancing factors the AI actively introduced, not a sign of overuse.

Step 2: Detect

Once a session reaches 5 rounds, the engine begins checking: has any single thinking law accounted for more than 40% of usage across recent rounds?

40% is not arbitrary. It is the equilibrium point discovered through testing: below 40%, perspectives remain reasonably distributed; above 40%, one law has achieved "monopoly" status.

Example: across 6 rounds, systems thinking was used 3 times (50%), first principles once, contradiction analysis once, Pareto once. Usage ratio = 3/6 = 50% > 40% → correction triggered.

Step 3: Penalize (Reduce Overused Weight)

For any law flagged as overused, its weight in the current round is temporarily reduced by 20%.

What does "weight reduction" mean? Inside SOMA, each thinking law has a weight value (between 0 and 1) representing its influence on analysis. Systems thinking has a default weight of 0.90 (high, because it is broadly applicable). When the Zhongdao Engine detects overuse, its temporary weight for this round drops to 0.72 (0.90 × 0.80).

Two keywords: "this round" and "temporary." The penalty only applies to the current response. It does not persist to the database. It does not permanently change the original weight. The Zhongdao Engine performs real-time, gentle micro-adjustments — not permanent modifications.

Step 4: Boost and Inject (Amplify Neglected Perspectives)

Penalizing overuse is the "brake." More importantly, the engine must "steer" — helping the AI discover perspectives it has been ignoring.

Every thinking law has a "related laws" list (the relations field). For example:

Thinking LawRelated Laws
Systems ThinkingFirst Principles, Contradiction Analysis
First PrinciplesSystems Thinking
Contradiction AnalysisSystems Thinking, Inversion
Pareto PrincipleFirst Principles

When systems thinking is overused, the engine checks its related laws — first principles and contradiction analysis — to see if they have been neglected. If so, they are injected into the current analysis at 1.15× weight as new thinking angles. Injection is capped at 2 laws, preventing too many new perspectives from diluting the analysis.

What the user sees: after six consecutive rounds of systems-thinking questions, round seven automatically introduces "first principles" and "contradiction analysis" as supplementary lenses. The AI's response will include a note: "Zhongdao self-correction: 'First Principles' has been suppressed in this session; temporarily boosted by 15% to balance thinking dimensions."

Three. Design Philosophy

Zero LLM Dependency

The entire correction logic — from counting to detection to weight calculation — runs entirely on mathematical rules, without a single LLM call. This choice yields three benefits:

Off by Default, Gentle Intervention

The Zhongdao Engine is off by default in v1.1.2. This is intentional — not everyone needs it, not every scenario suits it. To enable it, add a single parameter when creating a SOMA instance:

SOMA(enable_zhongdao=True)

Without this parameter, SOMA's behavior is identical to v1.1.1. Fully backward compatible, zero disruption.

Complementary, Not Redundant

SOMA now has three layers of bias correction, each with a distinct role:

MechanismWhat It DetectsWhen It FiresPersisted?
Frame Anchoring DetectorUser-side frame lock-inEvery conversationNo (advisory only)
Zhongdao Engine (NEW)AI-side law usage biasWithin-session, real-timeNo (temporary correction)
Meta-EvolverCross-session weight trendsEvery 5 sessionsYes (written to database)

The Frame Anchoring Detector works at question time, reminding the user "you might be stuck in a fixed frame." The Zhongdao Engine works at response time, actively adjusting "I might be biased." The Meta-Evolver works across sessions, optimizing weight distribution from long-term trends. Together they form a complete "aware → correct → evolve" system.

Four. What This Means for Real-World AI Applications

From "Thinking Well" to "Thinking Without Bias"

v1.1.1 taught AI applications to think with structure. But "thinking well" and "thinking comprehensively" are not the same thing.

The Zhongdao Engine fills the gap. It acts as a built-in "thinking referee" — when a user keeps asking questions from the same angle, the AI no longer passively follows that inertia. It actively introduces neglected perspectives, breaking the thinking rut.

Scenario: a user is formulating corporate strategy, analyzing market, product, team, funding, and competition all through "systems thinking" for five consecutive rounds. On round six, the Zhongdao Engine automatically injects "first principles" — prompting the AI to ask: "Are you sure the bottleneck is really at the systems level? Could it be that the product's value delivery is fundamentally not meeting users' deepest expectations?"

This follow-up question was not requested by the user. The AI introduced it on its own — a qualitative leap.

Protecting Users from Their Own Cognitive Inertia

Interestingly, the Zhongdao Engine protects not only the AI's thinking balance but also, indirectly, the user's.

When you repeatedly use the same framework to ask questions, the AI's consistent compliance reinforces your own thinking inertia — you become increasingly convinced that "systems thinking is the answer." This mutual reinforcement is dangerous. The Zhongdao Engine breaks this cycle: the AI no longer unconditionally follows your frame, but gently introduces new perspectives, helping you see your own blind spots.

Progressive Adoption, Zero Risk

The Zhongdao Engine is off by default. Recommended adoption strategy:

Five. What This Means for Developers

Though small in size (170 lines of code), the Zhongdao Engine represents an important shift in SOMA's development philosophy: from "giving AI more capabilities" to "helping AI use its existing capabilities better."

Over the previous five versions (v0.8 → v1.1.1), SOMA kept adding: knowledge graphs, multi-agent collaboration, three-tier memory, evolution loops. v1.1.2 begins subtracting — not subtracting features, but subtracting bias, inertia, and single-perspective overuse.

The significance of this shift: when an AI's thinking ability reaches a certain level, the bottleneck is no longer "not smart enough" — it's "not balanced enough."

The Wisdom of Design Constraints

The Zhongdao Engine is a case study in disciplined design:

Good architecture isn't "add whatever you want." It's "add new capabilities without changing old code."

Six. By the Numbers

Metricv1.1.1v1.1.2Change
Test cases618639+21 (Zhongdao-specific)
Bias correction layers2 (Frame Detect + Meta-Evolve)3 (+ Real-Time Zhongdao)Fills real-time within-session gap
LLM calls per response11Unchanged (zero LLM dependency)
Package size192KB196KB+4KB
New lines of code~280170-line engine + 21 tests
Overuse penaltyNoneWeight × 0.80Temporary, current round only
Neglect boostNoneWeight × 1.15Max 2 laws injected
Minimum samples5 roundsNo correction below this

Seven. The Three-Layer Correction Architecture

Viewed in isolation, the Zhongdao Engine is a lightweight rule engine. But placed within SOMA's full architecture, a complete three-layer bias correction system becomes visible:

Layer 1: Frame Anchoring Detector (v0.9.1) — works at question time. Detects whether the user is locked into a fixed thinking frame. If found, provides a gentle reminder. This is "external awareness."

Layer 2: Zhongdao Engine (v1.1.2) — works at response time. Detects whether the AI itself has developed usage bias in its thinking laws. If found, actively penalizes overuse and boosts neglected perspectives. This is "internal awareness."

Layer 3: Meta-Evolver (v0.8.0) — works across sessions. Every 5 sessions, evaluates the long-term performance trends of each thinking law and adjusts persistent weights. This is "long-term evolution."

Three layers working in concert — from "reminding the user" to "correcting itself" to "optimizing long-term" — form a complete thinking quality assurance system.

Eight. Industry Context

In the first half of 2026, the AI industry is undergoing an interesting pivot: from "scale is all you need" to "reasoning is all you need."

OpenAI's o-series, Anthropic's extended thinking, DeepSeek's R1 — every major lab is chasing stronger reasoning capabilities. But all these efforts focus inside the model: bigger training runs, longer inference times, more compute to improve thinking quality.

SOMA takes a different path. It doesn't change the model — it wraps a "thinking operating system" around it. The Zhongdao Engine is the "process scheduler" in this OS — it doesn't decide what the model thinks about, but ensures the model doesn't hog a single "thinking CPU" indefinitely.

This approach has its limitations (it doesn't change the model's underlying capability) and its advantages (universal, lightweight, explainable, zero training cost). In future versions, when the external thinking framework layer and the internal model reasoning layer begin to work together, the true "AI sage" will emerge.

Nine. Get Started

Install (one line):

pip install soma-wisdom

Enable the Zhongdao Engine:

soma = SOMA(enable_zhongdao=True)

GitHub: github.com/sunyan999999/soma

One-line summary: v1.1.2 gives SOMA a "self-awareness" nerve — it notices its own thinking bias and actively rebalances in the next round, maintaining depth without sacrificing breadth.

Ten. Acknowledgments

SOMA is a community-driven open source project. Thank you to every contributor of code, every reporter of issues, and every user who shares their experience. Special thanks to the early adopters who provide real-world feedback and continuous motivation for improvement.

The Zhongdao Engine in v1.1.2 came from a simple observation: even the smartest minds get stuck in mental ruts, and even the best thinking tools, when overused, become thinking habits. Everything in this version serves one goal — teaching AI to pause mid-thought and ask itself: "Should I try a different angle?"