auto-save 2026-05-15 11:18 (+1, ~4)

docs/source-analysis.html

@@ -523,6 +523,16 @@
             <tr><th>项目</th><th>命令 / 入口</th><th>说明</th></tr>
           </thead>
           <tbody>
+            <tr>
+              <td>本地后台启动</td>
+              <td><code>./scripts/start-dev-background.sh</code></td>
+              <td>不弹出 macOS Terminal 窗口；自动检查 4290 / 4291，缺哪个启动哪个，日志写入 <code>.logs/</code>，PID 写入 <code>.pids/</code>。</td>
+            </tr>
+            <tr>
+              <td>本地后台停止</td>
+              <td><code>./scripts/stop-dev-background.sh</code></td>
+              <td>按 <code>.pids/</code> 里的 PID 停止后台前端 / 后端进程。</td>
+            </tr>
             <tr>
               <td>前端开发服务</td>
               <td><code>cd web && pnpm dev</code></td>
@@ -919,6 +929,17 @@ SubjectAsset {
         <h2>变更记录</h2>
         <p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
         <div class="changelog">
+          <article class="change">
+            <header>
+              <h3>2026-05-15 · 本地启动改为后台不弹 Terminal</h3>
+              <span class="tag gray">Runtime</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>通过 macOS Terminal 启动后端会每次弹出一个终端窗口，打开页面时干扰使用。</p>
+              <p><strong>改动：</strong>新增 <code>scripts/start-dev-background.sh</code> 和 <code>scripts/stop-dev-background.sh</code>。启动脚本自动检查前端 4290 和后端 4291，缺哪个后台启动哪个，日志写入 <code>.logs/</code>，PID 写入 <code>.pids/</code>，以后无需通过 <code>osascript</code> 打开 Terminal。</p>
+              <p><strong>影响：</strong><code>scripts/start-dev-background.sh</code>、<code>scripts/stop-dev-background.sh</code>、<code>.gitignore</code>、<code>RULES.md</code>、<code>docs/source-analysis.html</code>。</p>
+            </div>
+          </article>
           <article class="change">
             <header>
               <h3>2026-05-14 · 产品融合按真实产品外置合成</h3>