LingJing

灵境 LingJing

バーチャル教室：人間が AI に授業をし、AI は鏡になります。 人が話す → AI が多角的に問いかける → 人が答える → 人が自分で判断する → 自分の思考、盲点、まとめを持ち帰る。

英語版 Web（インストール不要、BYO-key）： https://hongchenlingjing.com/lingjing-en/ — 3 つの個人利用：独学の理解度チェック、プライベートなナレッジライブラリ、自分の経験を検索可能にすること。登録不要です。API キーはブラウザー内にとどまり、サーバーには送信されません（BYO-key アプリ）。無料モデル（OpenRouter 無料ティア）でも動作します。

役割の契約：人間は体験者（そして教える側）、AI は気づきを促す側です。AI は学習も採点も判定もしません。判定権は常に人にあります。 これは製品としての姿勢ではなく、アーキテクチャ上の不変条件です。世界モデル World = ⟨S, R, M, T⟩ には、「学生 → スコア」という辺がそもそも存在しません。

	説明
該当するもの	ローカルで実行できるバーチャル教室。AI 学生 1 名（鏡・小明）が 7 種類の探査を通じて質問し続け、授業後には「AI が尋ねたこと／あなたが答えたこと」を一項目ずつ並べたリストを提供します
該当しないもの	質疑応答ボット（質問には答えません）、採点／評価ツール、ナレッジベース検索、感情的な寄り添いを提供する製品でも、インターネット上で利用可能なマルチテナントサービスでもありません

---

30 秒で使い始める

① 起動する（依存関係ゼロ、Node 22+）

git clone https://github.com/genesis-plan/lingjing.git
cd lingjing
node server.js          # → http://localhost:8080

ブラウザーで http://localhost:8080（2D 教室）または http://localhost:8080/classroom3d.html（3D 教室。Three.js はローカルに配置済みで、オフラインでも利用可能）を開きます。 次に / の入力欄をクリックし、よく知っていることを話してください。授業が始まります。

キーを設定しなくても実行できます：決定論的なフォールバック用コーパスを使用します。フローは完全に動作しますが、体験は簡易版となり、外部への送信は一切ありません。

② AI 学生に自然な話し方をさせたい場合（任意、キーを自分で用意してください）

# 默认硅基流动（国内，数据不出境）；须自带 key
LINGJING_LLM_PROVIDER=siliconflow LINGJING_SILICONFLOW_KEY=xxx node server.js

# 或换其他境内提供商
LINGJING_LLM_PROVIDER=zhipu LINGJING_ZHIPU_KEY=xxx node server.js

# 仅当你明确要用境外 OpenRouter 时才指定（课堂文本将出境，须自担合规）
LINGJING_LLM_PROVIDER=openrouter LINGJING_OR_KEY=sk-or-v1-xxx node server.js

# 或换境内提供商（数据不出境）
LINGJING_LLM_PROVIDER=zhipu       LINGJING_ZHIPU_KEY=xxx       node server.js
LINGJING_LLM_PROVIDER=siliconflow LINGJING_SILICONFLOW_KEY=xxx node server.js
LINGJING_LLM_PROVIDER=deepseek    LINGJING_DEEPSEEK_KEY=xxx    node server.js

③ 実際のテスト基準を確認する

node tools/test_questioning.mjs     # 提问引擎（确定性提问规格）
node tools/test_reflection.mjs      # 双稿制反思引擎
node tools/test_weakpoint.mjs       # 薄弱点定位层（跨场景必不同）
node tools/test_p0_wiring.mjs       # 盲区环端到端接线

23 件すべてのテストの分類、依存関係、実際の合格数については、02 · 使用ガイドを参照してください。

---

能力の範囲（率直な説明）

項目	説明
判定	行いません。「あなたは答えられたか／学生は理解したか」といった自動判定はすべて意図的に削除済みです（以前は実装していましたが、評価の結果、ノイズだと判明しました）
学生の「理解度」	そのような指標はありません。AI 学生に「悟り」があるかどうかは分かりません（脳がないため）。そのため、分かっていると主張することはありません
AI 学生の人数	1 名（鏡）。2026-09-18 に「役割別の学生 5 名」から 1 名へ変更しました。必要なのは、隙間を映し出す鏡であり、複数の役柄ではありません
質問を決めるのは誰か	決定論的なレイヤーが「何を尋ねるか、どの隙間を突くか」を決めます（弱点の特定＋質問の仕様）。LLM は「声」として、質問を言葉にする役割だけを担います
依存関係	サードパーティー依存関係ゼロ（Node の組み込みモジュールとブラウザー標準 API のみを使用）
データ	アカウントも電話番号も保存しません。授業のデータは sessions/ に保存されます（gitignore 済み）。LLM を設定した場合のみテキストを外部送信します。国内プロバイダーに切り替えることも、LLM をまったく設定しないこともできます
デプロイ	セルフホスト（ローカル／イントラネット）。アカウント、認証、公衆向けサービスはありません。インターネット上で運用する前に、コンプライアンスチェックリストを完了する必要があります（06を参照）
検証	tools/ 配下に自動テストが 23 件あります。CI はありません（変更を自動で保護する仕組みはありません。07を参照）

保証しないこと：AI 学生の質問が必ず要点を突くこと、およびあらゆる「教育効果」。研究の引用は設計の根拠であり、「その効果を達成した」証拠ではありません。

---

灵境 MCP · AI エージェントのための教室

灵境はローカルの Web 教室に加え、MCP stdio サーバー（lingjing-classroom-mcp）としてもパッケージ化されています。これにより、MCP に対応するあらゆる AI エージェント／オーケストレーターから、この「教室」を直接呼び出せます。人（またはエージェント）が教え、灵境が学生として質問し、盲点とまとめを返します。

特長：決定論的なエンジンで、LLM もネット接続も不要、オフラインで再現可能です。fail-closed（無効なセッションは即座にエラーになります）。Web 教室と同じ「7 種類の認知的盲点」の判定ロジックを共有していますが、LLM の音声レイヤーを経由しないため、完全にローカルで再現できます。

ワンステップで接続（エージェントは npx ですぐに利用可能）

npx lingjing-classroom-mcp

ゲートウェイツール lingjing は 1 つです。action は start_session（授業開始）→ teach（授業＋ソクラテス式の質問）→ reflect（7 次元の盲点＋まとめ＋カード）→ close_session（終了してクリーンアップ）を指定します。詳しい使い方は mcp/README.md を参照してください。

検出／配布

チャネル	状態
公式 MCP Registry	io.github.genesis-plan/lingjing v1.0.2（active · isLatest）
npm	lingjing-classroom-mcp @1.0.2
Glama / HiMCP / LobeHub	自動登録待ち（このリポジトリには server.json が含まれており、ディレクトリがクロールすれば表示されます）

パッケージのソースコードは mcp/ にあります。Registry のエントリーと npm パッケージのバージョンは一致しています。ライセンスはこのリポジトリと同じ UNLICENSED です（商用利用には書面による許諾が必要です）。

---

ドキュメント

ドキュメント	内容
01 · 製品の役割	これは何か、誰が使うのか、採点しない理由、能力と範囲、対外説明で避けるべき表現
02 · 使用ガイド	セルフホストでの利用開始、HTTP インターフェース、環境変数、LLM 設定、実際のテスト基準、よくある質問
03 · 設計思想	役割の契約、盲点を映し出す振り返りのループ、理論的根拠、試して削除したもの、設計から逸脱しないための原則
04 · 技術リファレンス	モジュール一覧、弱点特定レイヤー、質問エンジン、二稿制の振り返り、世界モデル、LLM 接続、テスト体系、既知の問題
05 · 利用シナリオ	7 種類のシナリオ（経験の抽出／ファインマン式の自己テスト／チーム内の引き継ぎ／教育訓練／専門家インタビュー／研究比較／デプロイ形態）と誤用チェックリスト
06 · ライセンスとコンプライアンス	ライセンスの現状（UNLICENSED）、データの取り扱いと国外移転に関する注意、公衆向け運用の前に補うべきチェックリスト
07 · バージョン管理	現在バージョン番号の体系がない理由、推奨する規約、リリースの整合性チェックリスト、互換性の保証
08 · プロジェクトの歴史	物理法則の学習からバーチャル教室までの全経緯。覆された方向性や削除された機能も含みます
09 · 数学的フレームワーク	設計時に統一した数学的フレームワーク（灵境の照見代数）。アーカイブ文書であり、実装については 04 が正です
10 · 方法論の基盤	盲点を映し出す振り返りのループに関する方法論の詳細とエビデンスの基盤。アーカイブ文書であり、実装については 04 が正です

---

構成

server.js            极简 HTTP 服务（SSE 流式课堂 + 静态资源 + 安全护栏）
teacher.js           课堂编排：探针调度（薄弱点定向优先 + 轮转兜底）、纪要、finalize
teaching.js          纯数学模型：薄弱点定位层 detectWeakPoints + 七类探测策略库
questioning.js       TCMQ 确定性提问引擎（只产出"问句规格"，不产出文字）
llm.js               LLM 连接器：多提供商 + 降级链 + 按功能组合管线
world.js             世界模型 ⟨S,R,M,T⟩（公理3：人类＝外部输入；无"学生→分数"边）
retention.js         匿名留存埋点（只给离线脚本读，绝不进用户屏幕）
public/              课室前端（2D/3D）、双稿制反思、课后总结、跨课知识库、课前生产性失败
tools/               23 个自动化测试 + 辅助脚本
docs/                主题文档（本表）
mcp/                 灵境 MCP stdio 包源码（给 AI Agent 的课室，见上）
server.json          官方 MCP Registry 清单（目录/Glama/HiMCP 自动发现用）

---

许可（摘要）

UNLICENSED —— 保留所有权利。 仓库公开可见 ≠ 授权使用： 未经版权人明确书面许可，不得复制、修改、分发、再许可或用于商业 / 非商业目的。 若希望以具体开源协议（MIT / Apache-2.0 或开源 + 商用双轨）使用，请与版权人另行联系。

⚠️ 已知张力：LICENSE 字面禁止复制，而本文档的"30 秒上手"写着 clone 自跑 —— 二者尚未对齐，属版权人待拍板的法律决策，工程侧不代决。详见 06 · 许可与合规。

---

联系

• 授权 / 反馈：[email protected]（亦可用仓库 Issues）
• 版权方：广州红尘灵境（太白 / 邓其聪）