chore: snapshot current workspace changes

docs/architecture/c4/code/apps-linux_sim_shell/code.html

@@ -0,0 +1,227 @@
+<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="utf-8" /><title>代码锚点：apps/linux_sim_shell</title></head>
+<body>
+<main class="praxis-architecture-map" data-praxis-anchor="architecture:c4:code:apps-linux_sim_shell" data-praxis-kind="architecture_c4_code" data-praxis-status="candidate" data-praxis-confidence="medium" data-praxis-document-path="docs/architecture/c4/code/apps-linux_sim_shell/code.html" data-praxis-drilldowns="[]">
+  <header class="praxis-design-map-header">
+    <p>Praxis Architecture View</p>
+    <h1>代码锚点：apps/linux_sim_shell</h1>
+    <p>从 C4 Code 层解释 apps/linux_sim_shell 内少量关键代码锚点。Code 层不是代码浏览器，只在需要理解架构组件如何落到具体文件/符号时使用。</p>
+    <div class="meta-row">
+      <span>Code</span>
+      <span>candidate / medium</span>
+      <span>0.1.30-alpha · 34aad0bffa2f / main</span>
+    </div>
+  </header>
+  <section class="semantic-layer" data-praxis-anchor="architecture:c4:layer-path" data-praxis-kind="architecture_c4_list">
+    <h2>C4 层级路径</h2>
+    <ul>
+      <li>当前层：Code View，解释上层 Component 如何落到具体文件、函数、类、接口或组件锚点。</li>
+      <li>上层：Component，说明这些代码锚点共同服务的组件职责。</li>
+      <li>下层：无；继续理解细节时应回到 IDE、代码预览或软件结构模型，而不是把 Code View 当成完整源码浏览器。</li>
+    </ul>
+  </section>
+  <section class="semantic-layer" data-praxis-anchor="architecture:c4:responsibility" data-praxis-kind="architecture_c4_text">
+    <h2>责任</h2>
+    <p>把 apps/linux_sim_shell 的架构组件进一步落到具体文件、函数、类、接口或组件锚点，帮助用户理解实现入口和变更影响面。</p>
+  </section>
+  <section class="semantic-layer" data-praxis-anchor="architecture:c4:boundary" data-praxis-kind="architecture_c4_text">
+    <h2>边界</h2>
+    <p>Code View 只展示必要锚点，不列全量源码；完整结构解释、代码片段和复杂度候选点仍应回到软件结构模型或 IDE 查看。</p>
+  </section>
+  <section class="semantic-layer" data-praxis-anchor="architecture:c4:relationships" data-praxis-kind="architecture_c4_list">
+    <h2>关系</h2>
+    <ul>
+      <li>LinuxSimAppShellConfig -&gt; apps/linux_sim_shell/src/linux_sim_app_shell.h#L12</li>
+      <li>LinuxSimRuntimeSource::ScreenGraphAdoption -&gt; apps/linux_sim_shell/src/linux_sim_runtime_entry.h#L15</li>
+      <li>&amp; LinuxSimAppShell::config() const -&gt; apps/linux_sim_shell/src/linux_sim_app_shell.cpp#L20</li>
+      <li>LinuxSimRuntimeEntry::screenCount -&gt; apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L40</li>
+      <li>LinuxSimRuntimeEntry::usingPrimaryScreenGraph -&gt; apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L24</li>
+      <li>LinuxSimRuntimeEntryAdoptionProbe::screenCount -&gt; apps/linux_sim_shell/src/linux_sim_runtime_entry_adoption_probe.cpp#L41</li>
+      <li>LinuxSimRuntimeRenderer::usedPrimaryScreenGraph -&gt; apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L31</li>
+      <li>LinuxSimRuntimeRenderer::usingPrimaryScreenGraph -&gt; apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L26</li>
+    </ul>
+  </section>
+  <section class="semantic-layer" data-praxis-anchor="architecture:c4:business-relation" data-praxis-kind="architecture_c4_list">
+    <h2>与业务复杂度的关联</h2>
+    <ul>
+      <li>Code View 不是业务解释入口；它只在业务故事需要追溯到实现锚点时提供底层证据。</li>
+    </ul>
+  </section>
+  <section class="semantic-layer" data-praxis-anchor="architecture:c4:engineering-relation" data-praxis-kind="architecture_c4_list">
+    <h2>与技术复杂度的关联</h2>
+    <ul>
+      <li>软件结构模型负责继续解释复用迹象、外部协作迹象、Sequence、复杂度候选点和代码证据预览。</li>
+    </ul>
+  </section>
+  <section class="semantic-layer diagram-section" data-praxis-anchor="architecture:c4:diagram" data-praxis-kind="architecture_c4_diagram">
+    <h2>C4 Code View 图</h2>
+    <pre class="mermaid" data-praxis-anchor="architecture:c4:code:apps-linux_sim_shell:c4" data-praxis-c4-current-level="code" data-praxis-c4-layer-views="[{&quot;level&quot;:&quot;system_context&quot;,&quot;label&quot;:&quot;System Context&quot;,&quot;title&quot;:&quot;系统上下文：trail-mate&quot;,&quot;diagramTitle&quot;:&quot;C4 System Context 图&quot;,&quot;summary&quot;:&quot;System Context 只展示目标软件系统与外部人/系统的关系，不直接展开内部 Code；这里高亮的是“apps/linux_sim_shell”所属的软件系统边界。&quot;,&quot;docPath&quot;:&quot;docs/architecture/c4/system-context/system-context.md&quot;,&quot;htmlPath&quot;:&quot;docs/architecture/c4/system-context/system-context.html&quot;,&quot;mermaid&quot;:&quot;flowchart LR\n  actor[\&quot;未命名外部参与者\&quot;]\n  system[\&quot;trail-mate\&quot;]\n  external[\&quot;未命名外部系统\&quot;]\n  actor --&gt;|使用 / 调用| system\n  system -.-&gt;|候选集成| external&quot;,&quot;highlightLabels&quot;:[&quot;apps/linux_sim_shell&quot;,&quot;apps/linux_sim_shell Container&quot;,&quot;apps/linux_sim_shell（系统内部 Container）&quot;,&quot;linux_sim_shell&quot;,&quot;trail-mate&quot;],&quot;current&quot;:false,&quot;missing&quot;:false},{&quot;level&quot;:&quot;container&quot;,&quot;label&quot;:&quot;Container&quot;,&quot;title&quot;:&quot;容器边界：apps/linux_sim_shell&quot;,&quot;diagramTitle&quot;:&quot;C4 Container 图&quot;,&quot;summary&quot;:&quot;切到 Container 层时，高亮会标出“apps/linux_sim_shell”在该层正式文档中的对应位置。&quot;,&quot;docPath&quot;:&quot;docs/architecture/c4/containers/apps-linux_sim_shell/container.md&quot;,&quot;htmlPath&quot;:&quot;docs/architecture/c4/containers/apps-linux_sim_shell/container.html&quot;,&quot;mermaid&quot;:&quot;flowchart LR\n  container[\&quot;apps/linux_sim_shell\&quot;]\n  dependency_1[\&quot;apps/esp32_lvgl\&quot;]\n  container --&gt; dependency_1&quot;,&quot;highlightLabels&quot;:[&quot;apps/linux_sim_shell&quot;,&quot;apps/linux_sim_shell Container&quot;,&quot;apps/linux_sim_shell（系统内部 Container）&quot;,&quot;linux_sim_shell&quot;],&quot;current&quot;:false,&quot;missing&quot;:false},{&quot;level&quot;:&quot;component&quot;,&quot;label&quot;:&quot;Component&quot;,&quot;title&quot;:&quot;apps/linux_sim_shell · Component 未生成&quot;,&quot;diagramTitle&quot;:&quot;C4 Component 图&quot;,&quot;summary&quot;:&quot;当前对象没有单独的 Component 文档；生成流程不会把证据不足的层级画成正式 C4 图。&quot;,&quot;mermaid&quot;:&quot;flowchart LR\n  focus[\&quot;apps/linux_sim_shell\&quot;]\n  missing[\&quot;尚未生成 Component 投影\&quot;]\n  focus -.-&gt; missing&quot;,&quot;highlightLabels&quot;:[&quot;apps/linux_sim_shell&quot;,&quot;apps/linux_sim_shell Container&quot;,&quot;apps/linux_sim_shell（系统内部 Container）&quot;,&quot;linux_sim_shell&quot;],&quot;current&quot;:false,&quot;missing&quot;:true},{&quot;level&quot;:&quot;code&quot;,&quot;label&quot;:&quot;Code&quot;,&quot;title&quot;:&quot;代码锚点：apps/linux_sim_shell&quot;,&quot;diagramTitle&quot;:&quot;C4 Code View 图&quot;,&quot;summary&quot;:&quot;当前正在阅读 Code 层；下方正式图就是这一层的架构投影。&quot;,&quot;docPath&quot;:&quot;docs/architecture/c4/code/apps-linux_sim_shell/code.md&quot;,&quot;htmlPath&quot;:&quot;docs/architecture/c4/code/apps-linux_sim_shell/code.html&quot;,&quot;mermaid&quot;:&quot;flowchart TB\n  package[\&quot;apps/linux_sim_shell\&quot;]\n  file_1[\&quot;apps/linux_sim_shell/src/linux_sim_app_shell.h\&quot;]\n  code_1[\&quot;LinuxSimAppShellConfig\&quot;]\n  package --&gt; file_1\n  file_1 --&gt; code_1\n  file_2[\&quot;apps/linux_sim_shell/src/linux_sim_runtime_entry.h\&quot;]\n  code_2[\&quot;LinuxSimRuntimeSource::ScreenGraphAdoption\&quot;]\n  package --&gt; file_2\n  file_2 --&gt; code_2\n  file_3[\&quot;apps/linux_sim_shell/src/linux_sim_app_shell.cpp\&quot;]\n  code_3[\&quot;&amp; LinuxSimAppShell::config() const\&quot;]\n  package --&gt; file_3\n  file_3 --&gt; code_3\n  file_4[\&quot;apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp\&quot;]\n  code_4[\&quot;LinuxSimRuntimeEntry::screenCount\&quot;]\n  package --&gt; file_4\n  file_4 --&gt; code_4\n  file_5[\&quot;apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp\&quot;]\n  code_5[\&quot;LinuxSimRuntimeEntry::usingPrimaryScreenGraph\&quot;]\n  package --&gt; file_5\n  file_5 --&gt; code_5\n  file_6[\&quot;apps/linux_sim_shell/src/linux_sim_runtime_entry_adoption_probe.cpp\&quot;]\n  code_6[\&quot;LinuxSimRuntimeEntryAdoptionProbe::screenCount\&quot;]\n  package --&gt; file_6\n  file_6 --&gt; code_6\n  file_7[\&quot;apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp\&quot;]\n  code_7[\&quot;LinuxSimRuntimeRenderer::usedPrimaryScreenGraph\&quot;]\n  package --&gt; file_7\n  file_7 --&gt; code_7\n  file_8[\&quot;apps/linux_sim_shell/src/linux_sim_runtime_renderer.Line truncated
+  package[&quot;apps/linux_sim_shell&quot;]
+  file_1[&quot;apps/linux_sim_shell/src/linux_sim_app_shell.h&quot;]
+  code_1[&quot;LinuxSimAppShellConfig&quot;]
+  package --&gt; file_1
+  file_1 --&gt; code_1
+  file_2[&quot;apps/linux_sim_shell/src/linux_sim_runtime_entry.h&quot;]
+  code_2[&quot;LinuxSimRuntimeSource::ScreenGraphAdoption&quot;]
+  package --&gt; file_2
+  file_2 --&gt; code_2
+  file_3[&quot;apps/linux_sim_shell/src/linux_sim_app_shell.cpp&quot;]
+  code_3[&quot;&amp; LinuxSimAppShell::config() const&quot;]
+  package --&gt; file_3
+  file_3 --&gt; code_3
+  file_4[&quot;apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp&quot;]
+  code_4[&quot;LinuxSimRuntimeEntry::screenCount&quot;]
+  package --&gt; file_4
+  file_4 --&gt; code_4
+  file_5[&quot;apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp&quot;]
+  code_5[&quot;LinuxSimRuntimeEntry::usingPrimaryScreenGraph&quot;]
+  package --&gt; file_5
+  file_5 --&gt; code_5
+  file_6[&quot;apps/linux_sim_shell/src/linux_sim_runtime_entry_adoption_probe.cpp&quot;]
+  code_6[&quot;LinuxSimRuntimeEntryAdoptionProbe::screenCount&quot;]
+  package --&gt; file_6
+  file_6 --&gt; code_6
+  file_7[&quot;apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp&quot;]
+  code_7[&quot;LinuxSimRuntimeRenderer::usedPrimaryScreenGraph&quot;]
+  package --&gt; file_7
+  file_7 --&gt; code_7
+  file_8[&quot;apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp&quot;]
+  code_8[&quot;LinuxSimRuntimeRenderer::usingPrimaryScreenGraph&quot;]
+  package --&gt; file_8
+  file_8 --&gt; code_8</pre>
+  </section>
+  <section class="semantic-layer architecture-c4-elements" data-praxis-anchor="architecture:c4:code:apps-linux_sim_shell:elements" data-praxis-kind="architecture_c4_elements">
+    <h2>图内元素解释</h2>
+    <div class="layer-grid">
+      <article class="layer-card" data-praxis-anchor="architecture:c4:code-anchor:function:linuxsimappshellconfig:apps-linux_sim_shell-src-linux_sim_app_shell.h:12" data-praxis-kind="architecture_c4_element" data-praxis-confidence="medium" data-praxis-drilldowns="[]">
+        <h3>LinuxSimAppShellConfig</h3>
+        <p>Code · medium</p>
+        <p>LinuxSimAppShellConfig 是 apps/linux_sim_shell 的关键代码锚点，位置为 apps/linux_sim_shell/src/linux_sim_app_shell.h#L12；当前仓库证据显示它有 局部关系迹象，适合作为候选锚点而非完整结论。</p>
+        <dl>
+          <div><dt>责任</dt><dd>LinuxSimAppShellConfig 是一个局部实现锚点：它把上层组件职责落到 apps/linux_sim_shell/src/linux_sim_app_shell.h#L12，当前关系压力不高，但仍可作为理解实现入口的证据。</dd></div>
+          <div><dt>边界</dt><dd>该锚点只解释 apps/linux_sim_shell 的一处架构落点；它不是完整源码结构，也不能替代软件结构模型的代码证据预览。</dd></div>
+          <div><dt>关系意义</dt><dd>LinuxSimAppShellConfig 被放入 Code View，是因为它能把上层 Component 的职责追溯到具体文件/符号。当它被大量对象引用或调用时，应优先理解谁依赖它；当它向外依赖过多对象时，应优先理解它编排了哪些外部能力。</dd></div>
+          <div><dt>为什么属于该层</dt><dd>它有精确文件和行号证据 apps/linux_sim_shell/src/linux_sim_app_shell.h#L12，因此属于 C4 Code 层；如果只讨论职责边界，应回到 Component 或 Container。</dd></div>
+          <div><dt>下钻意图</dt><dd>下钻或切到软件结构模型时，应查看该锚点的直接协作、附近复杂度候选点和代码片段，判断改动是否会扩散。</dd></div>
+        </dl>
+      </article>
+      <article class="layer-card" data-praxis-anchor="architecture:c4:code-anchor:function:linuxsimruntimesource::screengraphadoption:apps-linux_sim_shell-src-linux_sim_runtime_entry.h:15" data-praxis-kind="architecture_c4_element" data-praxis-confidence="medium" data-praxis-drilldowns="[]">
+        <h3>LinuxSimRuntimeSource::ScreenGraphAdoption</h3>
+        <p>Code · medium</p>
+        <p>LinuxSimRuntimeSource::ScreenGraphAdoption 是 apps/linux_sim_shell 的关键代码锚点，位置为 apps/linux_sim_shell/src/linux_sim_runtime_entry.h#L15；当前仓库证据显示它有 局部关系迹象，适合作为候选锚点而非完整结论。</p>
+        <dl>
+          <div><dt>责任</dt><dd>LinuxSimRuntimeSource::ScreenGraphAdoption 是一个局部实现锚点：它把上层组件职责落到 apps/linux_sim_shell/src/linux_sim_runtime_entry.h#L15，当前关系压力不高，但仍可作为理解实现入口的证据。</dd></div>
+          <div><dt>边界</dt><dd>该锚点只解释 apps/linux_sim_shell 的一处架构落点；它不是完整源码结构，也不能替代软件结构模型的代码证据预览。</dd></div>
+          <div><dt>关系意义</dt><dd>LinuxSimRuntimeSource::ScreenGraphAdoption 被放入 Code View，是因为它能把上层 Component 的职责追溯到具体文件/符号。当它被大量对象引用或调用时，应优先理解谁依赖它；当它向外依赖过多对象时，应优先理解它编排了哪些外部能力。</dd></div>
+          <div><dt>为什么属于该层</dt><dd>它有精确文件和行号证据 apps/linux_sim_shell/src/linux_sim_runtime_entry.h#L15，因此属于 C4 Code 层；如果只讨论职责边界，应回到 Component 或 Container。</dd></div>
+          <div><dt>下钻意图</dt><dd>下钻或切到软件结构模型时，应查看该锚点的直接协作、附近复杂度候选点和代码片段，判断改动是否会扩散。</dd></div>
+        </dl>
+      </article>
+      <article class="layer-card" data-praxis-anchor="architecture:c4:code-anchor:function:-linuxsimappshell::config-const:apps-linux_sim_shell-src-linux_sim_app_shell.cpp:20" data-praxis-kind="architecture_c4_element" data-praxis-confidence="medium" data-praxis-drilldowns="[]">
+        <h3>&amp; LinuxSimAppShell::config() const</h3>
+        <p>Code · medium</p>
+        <p>&amp; LinuxSimAppShell::config() const 是 apps/linux_sim_shell 的关键代码锚点，位置为 apps/linux_sim_shell/src/linux_sim_app_shell.cpp#L20；当前仓库证据显示它有 局部关系迹象，适合作为候选锚点而非完整结论。</p>
+        <dl>
+          <div><dt>责任</dt><dd>&amp; LinuxSimAppShell::config() const 是一个局部实现锚点：它把上层组件职责落到 apps/linux_sim_shell/src/linux_sim_app_shell.cpp#L20，当前关系压力不高，但仍可作为理解实现入口的证据。</dd></div>
+          <div><dt>边界</dt><dd>该锚点只解释 apps/linux_sim_shell 的一处架构落点；它不是完整源码结构，也不能替代软件结构模型的代码证据预览。</dd></div>
+          <div><dt>关系意义</dt><dd>&amp; LinuxSimAppShell::config() const 被放入 Code View，是因为它能把上层 Component 的职责追溯到具体文件/符号。当它被大量对象引用或调用时，应优先理解谁依赖它；当它向外依赖过多对象时，应优先理解它编排了哪些外部能力。</dd></div>
+          <div><dt>为什么属于该层</dt><dd>它有精确文件和行号证据 apps/linux_sim_shell/src/linux_sim_app_shell.cpp#L20，因此属于 C4 Code 层；如果只讨论职责边界，应回到 Component 或 Container。</dd></div>
+          <div><dt>下钻意图</dt><dd>下钻或切到软件结构模型时，应查看该锚点的直接协作、附近复杂度候选点和代码片段，判断改动是否会扩散。</dd></div>
+        </dl>
+      </article>
+      <article class="layer-card" data-praxis-anchor="architecture:c4:code-anchor:function:linuxsimruntimeentry::screencount:apps-linux_sim_shell-src-linux_sim_runtime_entry.cpp:40" data-praxis-kind="architecture_c4_element" data-praxis-confidence="medium" data-praxis-drilldowns="[]">
+        <h3>LinuxSimRuntimeEntry::screenCount</h3>
+        <p>Code · medium</p>
+        <p>LinuxSimRuntimeEntry::screenCount 是 apps/linux_sim_shell 的关键代码锚点，位置为 apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L40；当前仓库证据显示它有 局部关系迹象，适合作为候选锚点而非完整结论。</p>
+        <dl>
+          <div><dt>责任</dt><dd>LinuxSimRuntimeEntry::screenCount 是一个局部实现锚点：它把上层组件职责落到 apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L40，当前关系压力不高，但仍可作为理解实现入口的证据。</dd></div>
+          <div><dt>边界</dt><dd>该锚点只解释 apps/linux_sim_shell 的一处架构落点；它不是完整源码结构，也不能替代软件结构模型的代码证据预览。</dd></div>
+          <div><dt>关系意义</dt><dd>LinuxSimRuntimeEntry::screenCount 被放入 Code View，是因为它能把上层 Component 的职责追溯到具体文件/符号。当它被大量对象引用或调用时，应优先理解谁依赖它；当它向外依赖过多对象时，应优先理解它编排了哪些外部能力。</dd></div>
+          <div><dt>为什么属于该层</dt><dd>它有精确文件和行号证据 apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L40，因此属于 C4 Code 层；如果只讨论职责边界，应回到 Component 或 Container。</dd></div>
+          <div><dt>下钻意图</dt><dd>下钻或切到软件结构模型时，应查看该锚点的直接协作、附近复杂度候选点和代码片段，判断改动是否会扩散。</dd></div>
+        </dl>
+      </article>
+      <article class="layer-card" data-praxis-anchor="architecture:c4:code-anchor:function:linuxsimruntimeentry::usingprimaryscreengraph:apps-linux_sim_shell-src-linux_sim_runtime_entry.cpp:24" data-praxis-kind="architecture_c4_element" data-praxis-confidence="medium" data-praxis-drilldowns="[]">
+        <h3>LinuxSimRuntimeEntry::usingPrimaryScreenGraph</h3>
+        <p>Code · medium</p>
+        <p>LinuxSimRuntimeEntry::usingPrimaryScreenGraph 是 apps/linux_sim_shell 的关键代码锚点，位置为 apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L24；当前仓库证据显示它有 局部关系迹象，适合作为候选锚点而非完整结论。</p>
+        <dl>
+          <div><dt>责任</dt><dd>LinuxSimRuntimeEntry::usingPrimaryScreenGraph 是一个局部实现锚点：它把上层组件职责落到 apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L24，当前关系压力不高，但仍可作为理解实现入口的证据。</dd></div>
+          <div><dt>边界</dt><dd>该锚点只解释 apps/linux_sim_shell 的一处架构落点；它不是完整源码结构，也不能替代软件结构模型的代码证据预览。</dd></div>
+          <div><dt>关系意义</dt><dd>LinuxSimRuntimeEntry::usingPrimaryScreenGraph 被放入 Code View，是因为它能把上层 Component 的职责追溯到具体文件/符号。当它被大量对象引用或调用时，应优先理解谁依赖它；当它向外依赖过多对象时，应优先理解它编排了哪些外部能力。</dd></div>
+          <div><dt>为什么属于该层</dt><dd>它有精确文件和行号证据 apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L24，因此属于 C4 Code 层；如果只讨论职责边界，应回到 Component 或 Container。</dd></div>
+          <div><dt>下钻意图</dt><dd>下钻或切到软件结构模型时，应查看该锚点的直接协作、附近复杂度候选点和代码片段，判断改动是否会扩散。</dd></div>
+        </dl>
+      </article>
+      <article class="layer-card" data-praxis-anchor="architecture:c4:code-anchor:function:linuxsimruntimeentryadoptionprobe::screencount:apps-linux_sim_shell-src-linux_sim_runtime_entry_adoption_probe.cpp:41" data-praxis-kind="architecture_c4_element" data-praxis-confidence="medium" data-praxis-drilldowns="[]">
+        <h3>LinuxSimRuntimeEntryAdoptionProbe::screenCount</h3>
+        <p>Code · medium</p>
+        <p>LinuxSimRuntimeEntryAdoptionProbe::screenCount 是 apps/linux_sim_shell 的关键代码锚点，位置为 apps/linux_sim_shell/src/linux_sim_runtime_entry_adoption_probe.cpp#L41；当前仓库证据显示它有 局部关系迹象，适合作为候选锚点而非完整结论。</p>
+        <dl>
+          <div><dt>责任</dt><dd>LinuxSimRuntimeEntryAdoptionProbe::screenCount 是一个局部实现锚点：它把上层组件职责落到 apps/linux_sim_shell/src/linux_sim_runtime_entry_adoption_probe.cpp#L41，当前关系压力不高，但仍可作为理解实现入口的证据。</dd></div>
+          <div><dt>边界</dt><dd>该锚点只解释 apps/linux_sim_shell 的一处架构落点；它不是完整源码结构，也不能替代软件结构模型的代码证据预览。</dd></div>
+          <div><dt>关系意义</dt><dd>LinuxSimRuntimeEntryAdoptionProbe::screenCount 被放入 Code View，是因为它能把上层 Component 的职责追溯到具体文件/符号。当它被大量对象引用或调用时，应优先理解谁依赖它；当它向外依赖过多对象时，应优先理解它编排了哪些外部能力。</dd></div>
+          <div><dt>为什么属于该层</dt><dd>它有精确文件和行号证据 apps/linux_sim_shell/src/linux_sim_runtime_entry_adoption_probe.cpp#L41，因此属于 C4 Code 层；如果只讨论职责边界，应回到 Component 或 Container。</dd></div>
+          <div><dt>下钻意图</dt><dd>下钻或切到软件结构模型时，应查看该锚点的直接协作、附近复杂度候选点和代码片段，判断改动是否会扩散。</dd></div>
+        </dl>
+      </article>
+      <article class="layer-card" data-praxis-anchor="architecture:c4:code-anchor:function:linuxsimruntimerenderer::usedprimaryscreengraph:apps-linux_sim_shell-src-linux_sim_runtime_renderer.cpp:31" data-praxis-kind="architecture_c4_element" data-praxis-confidence="medium" data-praxis-drilldowns="[]">
+        <h3>LinuxSimRuntimeRenderer::usedPrimaryScreenGraph</h3>
+        <p>Code · medium</p>
+        <p>LinuxSimRuntimeRenderer::usedPrimaryScreenGraph 是 apps/linux_sim_shell 的关键代码锚点，位置为 apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L31；当前仓库证据显示它有 局部关系迹象，适合作为候选锚点而非完整结论。</p>
+        <dl>
+          <div><dt>责任</dt><dd>LinuxSimRuntimeRenderer::usedPrimaryScreenGraph 是一个局部实现锚点：它把上层组件职责落到 apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L31，当前关系压力不高，但仍可作为理解实现入口的证据。</dd></div>
+          <div><dt>边界</dt><dd>该锚点只解释 apps/linux_sim_shell 的一处架构落点；它不是完整源码结构，也不能替代软件结构模型的代码证据预览。</dd></div>
+          <div><dt>关系意义</dt><dd>LinuxSimRuntimeRenderer::usedPrimaryScreenGraph 被放入 Code View，是因为它能把上层 Component 的职责追溯到具体文件/符号。当它被大量对象引用或调用时，应优先理解谁依赖它；当它向外依赖过多对象时，应优先理解它编排了哪些外部能力。</dd></div>
+          <div><dt>为什么属于该层</dt><dd>它有精确文件和行号证据 apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L31，因此属于 C4 Code 层；如果只讨论职责边界，应回到 Component 或 Container。</dd></div>
+          <div><dt>下钻意图</dt><dd>下钻或切到软件结构模型时，应查看该锚点的直接协作、附近复杂度候选点和代码片段，判断改动是否会扩散。</dd></div>
+        </dl>
+      </article>
+      <article class="layer-card" data-praxis-anchor="architecture:c4:code-anchor:function:linuxsimruntimerenderer::usingprimaryscreengraph:apps-linux_sim_shell-src-linux_sim_runtime_renderer.cpp:26" data-praxis-kind="architecture_c4_element" data-praxis-confidence="medium" data-praxis-drilldowns="[]">
+        <h3>LinuxSimRuntimeRenderer::usingPrimaryScreenGraph</h3>
+        <p>Code · medium</p>
+        <p>LinuxSimRuntimeRenderer::usingPrimaryScreenGraph 是 apps/linux_sim_shell 的关键代码锚点，位置为 apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L26；当前仓库证据显示它有 局部关系迹象，适合作为候选锚点而非完整结论。</p>
+        <dl>
+          <div><dt>责任</dt><dd>LinuxSimRuntimeRenderer::usingPrimaryScreenGraph 是一个局部实现锚点：它把上层组件职责落到 apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L26，当前关系压力不高，但仍可作为理解实现入口的证据。</dd></div>
+          <div><dt>边界</dt><dd>该锚点只解释 apps/linux_sim_shell 的一处架构落点；它不是完整源码结构，也不能替代软件结构模型的代码证据预览。</dd></div>
+          <div><dt>关系意义</dt><dd>LinuxSimRuntimeRenderer::usingPrimaryScreenGraph 被放入 Code View，是因为它能把上层 Component 的职责追溯到具体文件/符号。当它被大量对象引用或调用时，应优先理解谁依赖它；当它向外依赖过多对象时，应优先理解它编排了哪些外部能力。</dd></div>
+          <div><dt>为什么属于该层</dt><dd>它有精确文件和行号证据 apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L26，因此属于 C4 Code 层；如果只讨论职责边界，应回到 Component 或 Container。</dd></div>
+          <div><dt>下钻意图</dt><dd>下钻或切到软件结构模型时，应查看该锚点的直接协作、附近复杂度候选点和代码片段，判断改动是否会扩散。</dd></div>
+        </dl>
+      </article>
+    </div>
+  </section>
+  <section class="semantic-layer architecture-c4-links" data-praxis-anchor="architecture:c4:drilldowns" data-praxis-kind="architecture_c4_links">
+    <h2>可下钻 C4</h2>
+    <p>暂无。</p>
+
+  </section>
+  <section class="semantic-layer architecture-c4-links" data-praxis-anchor="architecture:c4:engineering-links" data-praxis-kind="architecture_c4_links">
+    <h2>关联软件结构模型</h2>
+    <p>暂无。</p>
+
+  </section>
+  <section class="semantic-layer" data-praxis-anchor="architecture:c4:evidence" data-praxis-kind="architecture_c4_list">
+    <h2>证据</h2>
+    <ul>
+      <li>apps/linux_sim_shell/src/linux_sim_app_shell.h#L12</li>
+      <li>apps/linux_sim_shell/src/linux_sim_runtime_entry.h#L15</li>
+      <li>apps/linux_sim_shell/src/linux_sim_app_shell.cpp#L20</li>
+      <li>apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L40</li>
+      <li>apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L24</li>
+      <li>apps/linux_sim_shell/src/linux_sim_runtime_entry_adoption_probe.cpp#L41</li>
+      <li>apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L31</li>
+      <li>apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L26</li>
+    </ul>
+  </section>
+  <section class="semantic-layer" data-praxis-anchor="architecture:c4:questions" data-praxis-kind="architecture_c4_list">
+    <h2>判定依据</h2>
+    <ul>
+      <li>Code View 只列少量能够追溯 Component 实现的文件/符号锚点；它不是源码浏览器，也不承载业务流程或完整类图。</li>
+    </ul>
+  </section>
+  <script type="application/json" id="praxis-architecture-c4-document">{"id":"architecture:c4:code:apps-linux_sim_shell","level":"code","title":"代码锚点：apps/linux_sim_shell","summary":"从 C4 Code 层解释 apps/linux_sim_shell 内少量关键代码锚点。Code 层不是代码浏览器，只在需要理解架构组件如何落到具体文件/符号时使用。","docPath":"docs/architecture/c4/code/apps-linux_sim_shell/code.md","htmlPath":"docs/architecture/c4/code/apps-linux_sim_shell/code.html","anchor":"architecture:c4:code:apps-linux_sim_shell","status":"candidate","confidence":"medium","mermaid":"flowchart TB\n  package[\"apps/linux_sim_shell\"]\n  file_1[\"apps/linux_sim_shell/src/linux_sim_app_shell.h\"]\n  code_1[\"LinuxSimAppShellConfig\"]\n  package --\u003e file_1\n  file_1 --\u003e code_1\n  file_2[\"apps/linux_sim_shell/src/linux_sim_runtime_entry.h\"]\n  code_2[\"LinuxSimRuntimeSource::ScreenGraphAdoption\"]\n  package --\u003e file_2\n  file_2 --\u003e code_2\n  file_3[\"apps/linux_sim_shell/src/linux_sim_app_shell.cpp\"]\n  code_3[\"\u0026 LinuxSimAppShell::config() const\"]\n  package --\u003e file_3\n  file_3 --\u003e code_3\n  file_4[\"apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp\"]\n  code_4[\"LinuxSimRuntimeEntry::screenCount\"]\n  package --\u003e file_4\n  file_4 --\u003e code_4\n  file_5[\"apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp\"]\n  code_5[\"LinuxSimRuntimeEntry::usingPrimaryScreenGraph\"]\n  package --\u003e file_5\n  file_5 --\u003e code_5\n  file_6[\"apps/linux_sim_shell/src/linux_sim_runtime_entry_adoption_probe.cpp\"]\n  code_6[\"LinuxSimRuntimeEntryAdoptionProbe::screenCount\"]\n  package --\u003e file_6\n  file_6 --\u003e code_6\n  file_7[\"apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp\"]\n  code_7[\"LinuxSimRuntimeRenderer::usedPrimaryScreenGraph\"]\n  package --\u003e file_7\n  file_7 --\u003e code_7\n  file_8[\"apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp\"]\n  code_8[\"LinuxSimRuntimeRenderer::usingPrimaryScreenGraph\"]\n  package --\u003e file_8\n  file_8 --\u003e code_8","responsibility":"把 apps/linux_sim_shell 的架构组件进一步落到具体文件、函数、类、接口或组件锚点，帮助用户理解实现入口和变更影响面。","boundary":"Code View 只展示必要锚点，不列全量源码；完整结构解释、代码片段和复杂度候选点仍应回到软件结构模型或 IDE 查看。","relationships":["LinuxSimAppShellConfig -\u003e apps/linux_sim_shell/src/linux_sim_app_shell.h#L12","LinuxSimRuntimeSource::ScreenGraphAdoption -\u003e apps/linux_sim_shell/src/linux_sim_runtime_entry.h#L15","\u0026 LinuxSimAppShell::config() const -\u003e apps/linux_sim_shell/src/linux_sim_app_shell.cpp#L20","LinuxSimRuntimeEntry::screenCount -\u003e apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L40","LinuxSimRuntimeEntry::usingPrimaryScreenGraph -\u003e apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L24","LinuxSimRuntimeEntryAdoptionProbe::screenCount -\u003e apps/linux_sim_shell/src/linux_sim_runtime_entry_adoption_probe.cpp#L41","LinuxSimRuntimeRenderer::usedPrimaryScreenGraph -\u003e apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L31","LinuxSimRuntimeRenderer::usingPrimaryScreenGraph -\u003e apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L26"],"businessRelation":["Code View 不是业务解释入口；它只在业务故事需要追溯到实现锚点时提供底层证据。"],"engineeringRelation":["软件结构模型负责继续解释复用迹象、外部协作迹象、Sequence、复杂度候选点和代码证据预览。"],"evidencePaths":["apps/linux_sim_shell/src/linux_sim_app_shell.h#L12","apps/linux_sim_shell/src/linux_sim_runtime_entry.h#L15","apps/linux_sim_shell/src/linux_sim_app_shell.cpp#L20","apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L40","apps/linux_sim_shell/src/linux_sim_runtime_entry.cpp#L24","apps/linux_sim_shell/src/linux_sim_runtime_entry_adoption_probe.cpp#L41","apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L31","apps/linux_sim_shell/src/linux_sim_runtime_renderer.cpp#L26"],"questions":["Code View 只列少量能够追溯 Component 实现的文件/符号锚点；它不是源码浏览器，也不承载业务流程或完整类图。"],"scope":{"packageId":"apps/linux_sim_shell","filePath":"apps/linux_sim_shell"},"elements":[{"id":"architecture:c4:code-anchor:function:linuxsimappshellconfig:apps-linux_sim_shell-src-linux_sim_app_shell.h:12","label":"LinuxSimAppShellConfig","level":"code","anchor":"architecture:c4:code-anchor:function:linuxsimappshellconfig:apps-linux_sim_shell-src-linux_sim_app_shell.h:12","summary":"LinuxSimAppShellConfig 是 apps/linux_sim_shell 的关键代码锚点，位置为 apps/linux_sim_shell/src/linux_sim_app_shell.h#L12；当前仓库证据显示它有 局部关系迹象，适合作为候选锚点而非完整结论。","responsibility":"LinuxSimAppShellConfig 是一个局部实现锚点：它把上层组件职Line truncated
+</main>
+</body>
+</html>