About DavidHLPL · RHINE LAB RSS ↗
FILE X-1003 / Site journal

Knowledge Base Index

SITE INFORMATION

Published / DavidHLPL

Knowledge Base Index

Start here to navigate the knowledge base, rather than a chronological blog archive. For a question, read this index first, then follow page sources and cross-links.

The canonical maintenance language is zh-cn. The knowledge base follows the The LLM-Wiki Pattern: Maintaining a Compounding Personal Knowledge Base; contracts are in root KB.md and the knowledge-base skill.

Convergence design: KB convergence v1 organizes presentation into six domains without changing series enums, with learning paths and a provisional graduation board. See docs/kb-convergence-design.md.

Six domains: A Knowledge/AI · B Java/concurrency · C Storage/cache · D Distributed/microservices · E Infrastructure/operations · F Engineering/architecture · Graduation · Archives · Raw

Learning paths by intent

  1. Path 1 — Beginner mental model:llm-wiki-pattern → kb-session-ingest-contract → java-concurrency-deepdive / redis-business-patterns → java-online-performance-debug → multi-service-readiness。Outcome: independently ingest one small topic.
  2. Path 2 — Distributed systems:microservice-data-ownership → database-schema-drift → dubbo-nacos-runtime → spring-cloud-and-boot → resicache-observer-nested-execution → plugin-lifecycle-management。Outcome: judge database separation, registration, and migration boundaries.
  3. Path 3 — Agent pipeline:omp-config-and-rules-guide → omp-hook-extension-guide → headroom-compress-retrieve-contract → mcp-codebase-memory-workflow → hindsight-local-deployment / hindsight-omp-codex-integration → omp-headroom-provider-proxy。Outcome: reproduce local OMP/Headroom/Codex memory and routing.

Graduation watch (12 provisional pages)

Page Verifiable checks needed for graduation
Headroom Single-Port Synthesis: Entry, Dynamic Upstreams, and Verification Boundaries Pinned Headroom contract tests for explicit /v1/messages and /v1/responses routing; model_cache rebuild; BindPaths rollback.
Headroom Route Persistence Synthesis: Named Profiles, model_cache, and Recovery Independent Named Profile isolation reproduction; derived model_cache deletion/rebuild; migration-only conditions for the old reconciler.
Headroom with cc-switch / Claude Code Coexistence: Single Synthesis and Security Boundaries Redacted logs/capture of 8787→15721; dual-write conflict counterexample; finalized BindPaths security boundary.
OMP Headroom Bridge: External Routing Controller and Native Codex/OMP Proxy Boundaries Coexisting loopback proxy, OMP provider route, and shared Codex provider smoke test; atomic restore/mode detection; repeatable rollback order.
UltiCode: Verifiable Boundaries for Online Judging and Agent Engineering Owner boundaries, outbox/Streams delivery, generation/attempt fences, Docker sandbox, traceable release gates.
Enhanced UISA: Owners, Boundaries, and Recovery for Heterogeneous-Node Sync Replace implicit scale/threshold promises with reproducible retry/idempotency constraints; owner → boundary → recovery decision tree; failure matrix.
Java Backend Interview Retrospective: Project Truth, Engineering Mechanisms, and Production Evidence One redacted production containment → diagnosis → recovery case; pinned cache/async evidence; separate capability model from evidence.
Database Written-Test Review: From SQL Semantics to Batch Data Processing Pinned Oracle/MySQL/Spark/PDI reproductions; NULL, year boundary, same-table read/write tests; Kettle/large-table partitioned extraction recovery and reconciliation.
ResiCache’s Cache Responsibility Chain: Control Flow, Nested Fragments, and Observer Lifecycles Current HandlerResult flow, snapshot/fragment boundaries, observer token pairing, exceptional cleanup.
Why Cache Stampedes Need a Future, a Distributed Lock, and a Double-Check Ten concurrent callers, leader/follower/reentrant, locked double-check, write-back failure, cross-instance boundaries.
Why Async Early Expiration Only Shortens TTL: Version CAS Makes Stale Jobs Harmless Real Redis version race, Lua TTL CAS, stale-task rejection, TTL shortening without direct source loading.
Replacing a Redis Serializer Is Not a One-Line Configuration Change: Object Trust and Rollback-Safe Migration Type whitelist, streaming preflight, shadow/dual/cutover/rollback, concurrent-write protection.

Retain provisional status until graduation, outside the main core-concepts view; quarterly review can mark unmet candidates deprecated.


A. Knowledge bases and AI engineering

B. Java and concurrency

C. Storage and caching

D. Distributed systems and microservices

E. Infrastructure and operations

F. Engineering and architecture

Entities

ResiCache design concepts

UltiCode design concepts

Syntheses and architecture patterns

G. Archived and deprecated


Raw sources

Of 53 raw sources, 10 are read-only Personal/Fuwari legacy-aggregate packages. New sources no longer use aggregate types.

All 53 raw sources (43 individual + 10 legacy-aggregate)
slug Type Source Summary Aggregate
karpathy-llm-wiki gist Original URL Incremental personal knowledge-base pattern using LLMs. —
legacy-java-atomic-boolean legacy-blog Historical file Original AtomicBoolean, volatile, CAS, and concurrent-state notes. —
legacy-java-auto-closeable legacy-blog Historical file Original AutoCloseable and try-with-resources. —
legacy-java-null-value legacy-blog Historical file Original Spring Cache NullValue and null caching. —
legacy-java-internship-interview-blog-polished legacy-blog Historical file Original Java backend internship interview review. —
legacy-java-online-performance-debug legacy-blog Historical file Original Java CPU, Arthas, and recovery decisions. —
legacy-containerd-tls-troubleshooting legacy-blog Historical file Original private-registry containerd TLS troubleshooting. —
legacy-intranet-penetration-ssh-guide legacy-blog Historical file Original Cloudflare Tunnel, Tailscale, FRP, and SSH. —
legacy-mysql-performance-troubleshooting legacy-blog Historical file Original MySQL performance SOP and diagnosis. —
legacy-headroom-single-port-evolution legacy-blog Historical file Original Headroom single-port architecture evolution. —
legacy-omp-config-and-rules-guide legacy-blog Historical file Original OMP configuration, rules, and model routing. —
legacy-omp-headroom-persistence legacy-blog Historical file Original Headroom persistence and route recovery. —
legacy-omp-hook-extension-guide legacy-blog Historical file Original OMP Hook, graph nudges, and status extensions. —
legacy-plugin-lifecycle-management legacy-note Historical file Original large-scale endpoint plugin lifecycles. —
legacy-uisa-architecture-design legacy-note Historical file Original UISA hybrid-cloud and heterogeneous-node architecture. —
headroom-0-34-compress-retrieve-contract upstream-source-and-contract-test Pinned source Headroom 0.34.0 compression/retrieval API contracts, modes, and real-endpoint checks. —
kb-ingest-pipeline-v19 repository Pinned commit Session identity/content hashes, redaction v19, control-plane filters, partial checkpoints, and raw manifests. —
mcp-codebase-memory-workflow upstream-spec-and-source Pinned version MCP 2026-07-28 and codebase-memory-mcp v0.10.2 graph-tool contracts. —
multi-service-readiness-contract upstream-spec-and-manpage Pinned specification Initial Compose/systemd startup, health, dependency, and propagation snapshot. —
multi-service-readiness-contract-correction upstream-spec-source-and-minimal-experiment Pinned specification Additional pinned Docker sources and disposable Redis/Alpine startup-gate experiment; initial raw remains intact. —
omp-17-2-15-runtime-contract upstream-source-fixed-tag Pinned tag Initial OMP 17.2.15 Hook, Compaction, statusline, and Headroom evidence boundaries. —
omp-17-2-15-runtime-contract-correction upstream-source-fixed-commit Pinned commit Additional ExtensionRunner, event-return contracts, and narrowed negative evidence; initial raw remains intact. —
redis-jackson-java-time-contract upstream-source-and-minimal-experiment Pinned tag Default Redisson/Spring Data Redis Jackson configuration and LocalDateTime encode/decode experiment. —
multi-service-readiness-safety-correction upstream-source-fixed-tag Pinned tag Corrects readiness commands’ -f/-p isolation and down deletion boundary. —
database-schema-drift-contract upstream-docs-and-minimal-experiment Flyway documentation Flyway 13.2.0/MySQL 8.4 history/schema/query drift diagnosis. —
database-written-test-review user-provided-local-markdown Project repository User-supplied database written-test review: SQL semantics, dialects, four-table practice, Kettle, huge-table boundaries. —
jjwt-013-security-api-contract upstream-source-fixed-tag JJWT 0.13.0 source signWith, verifyWith, audience builder, and key-type boundaries. —
testcontainers-docker-api-negotiation upstream-source-fixed-commits Testcontainers 1.20.6 Docker API 1.32 fallback, api.version, and daemon-version gates. —
dubbo-nacos-runtime-registration upstream-source-fixed-tag-and-docs Dubbo 3.3.6 Nacos interface/application registration, metadata, and smoke-test boundaries. —
resicache-observer-nested-execution-contract upstream-source-fixed-commit ResiCache public commit Observer tokens, locked fragments, ThreadLocal snapshots, and reentry boundaries. —
microservice-domain-data-ownership upstream-patterns-and-fixed-doc-snapshots microservices.io database-per-service Private service data, saga, outbox, and progressive migration ownership. —
jjwt-013-security-api-contract-correction upstream-source-fixed-tag-correction JJWT 0.13.0 source Corrects recommended algorithm key sizes, verifyWith overloads, and PrivateKey exceptions; initial raw intact. —
testcontainers-docker-api-negotiation-correction upstream-source-fixed-commits-correction Testcontainers 1.20.6 Corrects TestEnvironment path and 999.999 daemon-too-new matrix; initial raw intact. —
dubbo-nacos-runtime-registration-correction upstream-source-fixed-tag-correction Dubbo 3.3.6 Corrects Nacos registry URL parameter-reading boundaries; initial raw intact. —
microservice-domain-data-ownership-correction upstream-patterns-fixed-docs-correction Microsoft pinned data considerations Adds revision-pinned URLs; live pattern pages are used only as captured snapshots. —
headroom-cc-switch-coexistence-runtime repository-and-runtime-observation Source Redacted runtime evidence: Claude Code → Headroom → cc-switch, single compression responsibility, and BindPaths tradeoffs. —
omp-headroom-provider-proxy-codex-routing-runtime repository-and-runtime-observation Source Redacted CLI/Desktop evidence for loopback proxy, OMP/Codex routing controller, and Claude Code coexistence. —
ingest-docker-fundamentals personal-notes-and-fuwari Personal-markdown-notes bbb2126 Seven Docker originals: layers, volumes, networking, Compose. legacy-aggregate
ingest-hbase-foundation personal-notes-and-fuwari-overlap Personal bbb2126 + Fuwari 07cee2b Eighteen HBase originals: models, architecture, table design, Shell, Java API. legacy-aggregate
ingest-redis-business personal-notes-and-fuwari Personal bbb2126 + Fuwari 07cee2b Twenty Redis business originals: cache, distributed locks, queues, feeds, flash sales. legacy-aggregate
ingest-redis-persistence personal-notes-and-heima-course Personal bbb2126 + Fuwari 07cee2b Three Redis persistence/internal notes: RDB/AOF and underlying structures. legacy-aggregate
ingest-redis-heima personal-notes-and-heima-course Personal bbb2126 Six Heima Redis files (three exact duplicates): basics, practice, multilevel caches. legacy-aggregate
ingest-java-concurrency personal-notes-and-fuwari Fuwari 07cee2b Fifteen JUC/Java originals: CAS, atomics, locks, threading. legacy-aggregate
ingest-spring-cloud personal-notes-and-fuwari Fuwari 07cee2b Thirteen Spring Boot/Cloud originals: auto-configuration, transactions, gateway, observability. legacy-aggregate
ingest-spark-ecosystem personal-notes-and-fuwari Personal bbb2126 + Fuwari 07cee2b Seven Spark/big-data originals: engines, execution modes, cluster scripts. legacy-aggregate
ingest-mysql-storage personal-notes-and-fuwari Personal bbb2126 + Fuwari 07cee2b Three MySQL originals: storage engines and deadlocks. legacy-aggregate
ingest-frontend-essays personal-notes-and-fuwari Personal bbb2126 + Fuwari 07cee2b Ten miscellaneous Vue/MyBatis/UniApp/cache/environment notes, dissolved into an archive. legacy-aggregate
hindsight-local-deployment-and-agent-integration upstream-source-and-minimal-experiment Pinned source Redacted Hindsight v0.9.1 local deployment, Ollama ROCm LLM, CPU BGE-M3, FastMCP, OMP/Codex evidence. —
resicache-project-overview repository-readme-fixed-commit ResiCache public commit ResiCache v0.0.2 bilingual README snapshot: positioning, handler order, configuration boundaries, limitations. —
resicache-engineering-highlights-2954fff repository-source-and-test-selected-excerpts-fixed-commit Pinned ResiCache main Current source excerpts: value-version CAS, single-flight, serialization, observer, boundary tests. —
ulticode-project-context repository-readme-and-context-fixed-commit UltiCode pinned commit UltiCode README + CONTEXT domain glossary: owners, port/projection, invariants. —
ulticode-engineering-highlights-f801a1076 repository-source-and-document-selected-excerpts-fixed-commit Pinned UltiCode main Pinned main architecture, judge/sandbox code, boundary tests, CI: owners, outbox, fences, isolation, release gates. —
ulticode-reliability-core-f801a1076 repository-source-and-document-selected-excerpts-fixed-commit Pinned UltiCode main Audit outbox/consumer inbox, fenced leases, reconciliation, Core opt-in lifecycle: source, migrations, ADRs, tests. —

Raw files reside in src/content/raw/zh-cn/ for LLM reading, without public routes. Captured snapshots are immutable.

Capture inbox

  • Knowledge-base Ingest Inbox — Upcoming personal-project sources and questions. Historical articles, all 107 originals from Personal-markdown-notes/Fuwari, and ResiCache/UltiCode README/CONTEXT have been ingested. Phase 2 split Hindsight and dissolved miscellaneous frontend notes. Next: Phase 3 quarterly review of 12 provisional pages and incremental new topics.

Maintenance rules

  • Register every active/provisional wiki here with a one-sentence summary.
  • Trace every stable conclusion through sources to raw.
  • Append the Knowledge Base Operation Log for new sources/pages.
  • Fix evidence chains before wording when lint finds orphans, duplicates, broken links, or conflicts.
  • Six presentation domains aggregate views without changing series; review graduation quarterly and deprecate unmet candidates.

Research notes

  1. Original document: src/content/information/en/kb-index.md
  2. Source revision: f49953fb0d4bd52a39bf81167b0c4b7dd7d78a64

Original source ↗