npm - @jennie-shawn/starwork - Versions diffs - 0.1.0-alpha.0 - Mend

@jennie-shawn/starwork 0.1.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (228) hide show

package/docs/hub-management.html ADDED Viewed

@@ -0,0 +1,750 @@
+<!doctype html>
+<html lang="zh-CN">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>StarWork 多项目中枢管理机制</title>
+  <style>
+    :root {
+      --paper: #f7f4ec;
+      --paper-2: #ebe5d7;
+      --ink: #1d211d;
+      --muted: #62675f;
+      --line: #cfc7b7;
+      --white: #fffdf7;
+      --green: #286d4a;
+      --green-soft: #d8eadc;
+      --amber: #b36b19;
+      --amber-soft: #f3dfbd;
+      --blue: #2f6286;
+      --blue-soft: #d7e4ea;
+      --red: #9b3d2c;
+      --shadow: 0 18px 50px rgba(47, 43, 34, 0.12);
+    }
+    * {
+      box-sizing: border-box;
+    }
+    body {
+      margin: 0;
+      color: var(--ink);
+      background:
+        linear-gradient(90deg, rgba(62, 71, 62, 0.052) 1px, transparent 1px),
+        linear-gradient(0deg, rgba(62, 71, 62, 0.045) 1px, transparent 1px),
+        var(--paper);
+      background-size: 34px 34px;
+      font-family: "Avenir Next", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
+      letter-spacing: 0;
+    }
+    a {
+      color: inherit;
+      text-underline-offset: 3px;
+    }
+    code {
+      padding: 2px 6px;
+      border: 1px solid var(--line);
+      border-radius: 6px;
+      background: rgba(29, 33, 29, 0.05);
+      font-family: "SFMono-Regular", "Menlo", "Consolas", monospace;
+      font-size: 0.92em;
+    }
+    pre {
+      margin: 14px 0 0;
+      padding: 16px;
+      overflow: auto;
+      border: 1px solid rgba(29, 33, 29, 0.24);
+      border-radius: 8px;
+      background: #1d211d;
+      color: #fffdf7;
+      font-size: 13px;
+      line-height: 1.65;
+    }
+    .page {
+      width: min(1180px, calc(100% - 40px));
+      margin: 0 auto;
+      padding: 42px 0 70px;
+    }
+    .home-link {
+      display: inline-flex;
+      align-items: center;
+      min-height: 34px;
+      margin-bottom: 18px;
+      padding: 6px 11px;
+      border: 1px solid var(--line);
+      border-radius: 999px;
+      background: rgba(255, 253, 247, 0.75);
+      color: var(--muted);
+      font-size: 14px;
+      font-weight: 800;
+      text-decoration: none;
+    }
+    .hero {
+      display: grid;
+      grid-template-columns: minmax(0, 1fr) minmax(360px, 0.9fr);
+      gap: 28px;
+      align-items: stretch;
+      min-height: 540px;
+    }
+    .hero-copy {
+      display: flex;
+      flex-direction: column;
+      justify-content: space-between;
+      padding: 34px 0 30px;
+      border-top: 2px solid var(--ink);
+      border-bottom: 2px solid var(--ink);
+    }
+    .kicker {
+      margin: 0 0 20px;
+      color: var(--green);
+      font-size: 13px;
+      font-weight: 900;
+      text-transform: uppercase;
+    }
+    h1,
+    h2,
+    h3 {
+      font-family: Georgia, "Times New Roman", "Songti SC", serif;
+      letter-spacing: 0;
+    }
+    h1 {
+      margin: 0;
+      max-width: 820px;
+      font-size: clamp(42px, 7vw, 82px);
+      line-height: 0.98;
+    }
+    .subtitle {
+      max-width: 760px;
+      margin: 28px 0 0;
+      color: var(--muted);
+      font-size: 19px;
+      line-height: 1.78;
+    }
+    .quick-row {
+      display: grid;
+      grid-template-columns: repeat(4, minmax(0, 1fr));
+      gap: 10px;
+      margin-top: 34px;
+    }
+    .quick {
+      min-height: 116px;
+      padding: 14px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: rgba(255, 253, 247, 0.75);
+    }
+    .quick b {
+      display: block;
+      margin-bottom: 8px;
+      color: var(--green);
+      font-size: 13px;
+    }
+    .quick span {
+      color: var(--ink);
+      font-size: 14px;
+      line-height: 1.52;
+    }
+    .hero-board {
+      padding: 18px;
+      display: flex;
+      align-items: center;
+      background: var(--white);
+      border: 2px solid var(--ink);
+      border-radius: 8px;
+      box-shadow: var(--shadow);
+    }
+    svg {
+      display: block;
+      width: 100%;
+      height: auto;
+    }
+    .section {
+      margin-top: 70px;
+    }
+    .section-header {
+      display: flex;
+      justify-content: space-between;
+      align-items: end;
+      gap: 24px;
+      margin-bottom: 24px;
+      padding-bottom: 14px;
+      border-bottom: 2px solid var(--ink);
+    }
+    h2 {
+      margin: 0;
+      font-size: clamp(29px, 4vw, 52px);
+      line-height: 1.05;
+    }
+    h3 {
+      margin: 0 0 12px;
+      font-size: 26px;
+      line-height: 1.15;
+    }
+    .section-note {
+      max-width: 540px;
+      margin: 0;
+      color: var(--muted);
+      font-size: 15px;
+      line-height: 1.75;
+    }
+    .grid-2,
+    .grid-3 {
+      display: grid;
+      gap: 16px;
+    }
+    .grid-2 {
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+    }
+    .grid-3 {
+      grid-template-columns: repeat(3, minmax(0, 1fr));
+    }
+    .panel {
+      padding: 20px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: rgba(255, 253, 247, 0.78);
+      box-shadow: 0 10px 28px rgba(47, 43, 34, 0.07);
+    }
+    .panel.green {
+      background: var(--green-soft);
+      border-color: rgba(40, 109, 74, 0.45);
+    }
+    .panel.amber {
+      background: var(--amber-soft);
+      border-color: rgba(179, 107, 25, 0.45);
+    }
+    .panel.blue {
+      background: var(--blue-soft);
+      border-color: rgba(47, 98, 134, 0.45);
+    }
+    .panel p,
+    .panel li {
+      color: var(--muted);
+      font-size: 15px;
+      line-height: 1.75;
+    }
+    .panel p {
+      margin: 0;
+    }
+    .panel ul,
+    .panel ol {
+      margin: 10px 0 0;
+      padding-left: 20px;
+    }
+    .tag {
+      display: inline-block;
+      margin-bottom: 12px;
+      padding: 5px 9px;
+      border: 1px solid rgba(29, 33, 29, 0.18);
+      border-radius: 999px;
+      background: rgba(255, 253, 247, 0.66);
+      color: var(--green);
+      font-size: 12px;
+      font-weight: 900;
+    }
+    .flow {
+      display: grid;
+      grid-template-columns: 1fr 48px 1fr 48px 1fr;
+      align-items: stretch;
+      gap: 10px;
+    }
+    .flow-step {
+      min-height: 170px;
+      padding: 18px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: rgba(255, 253, 247, 0.82);
+    }
+    .arrow {
+      display: grid;
+      place-items: center;
+      color: var(--green);
+      font-size: 30px;
+      font-weight: 900;
+    }
+    .table-wrap {
+      overflow: auto;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: rgba(255, 253, 247, 0.78);
+    }
+    table {
+      width: 100%;
+      border-collapse: collapse;
+      min-width: 780px;
+    }
+    th,
+    td {
+      padding: 14px 16px;
+      border-bottom: 1px solid var(--line);
+      text-align: left;
+      vertical-align: top;
+      font-size: 15px;
+      line-height: 1.65;
+    }
+    th {
+      color: var(--green);
+      background: rgba(216, 234, 220, 0.72);
+      font-weight: 900;
+    }
+    tr:last-child td {
+      border-bottom: 0;
+    }
+    .callout {
+      margin-top: 18px;
+      padding: 18px 20px;
+      border: 2px solid var(--ink);
+      border-radius: 8px;
+      background: var(--white);
+      box-shadow: var(--shadow);
+    }
+    .callout p {
+      margin: 0;
+      font-size: 18px;
+      line-height: 1.75;
+    }
+    @media (max-width: 900px) {
+      .page {
+        width: min(100% - 28px, 1180px);
+        padding-top: 24px;
+      }
+      .hero,
+      .grid-2,
+      .grid-3,
+      .quick-row,
+      .flow {
+        grid-template-columns: 1fr;
+      }
+      .hero {
+        min-height: 0;
+      }
+      .arrow {
+        min-height: 34px;
+        transform: rotate(90deg);
+      }
+      .section-header {
+        display: block;
+      }
+      .section-note {
+        margin-top: 12px;
+      }
+    }
+  </style>
+</head>
+<body>
+  <main class="page">
+    <a class="home-link" href="index.html">返回文档中心</a>
+    <section class="hero">
+      <div class="hero-copy">
+        <div>
+          <p class="kicker">Hub + Satellite</p>
+          <h1>多项目中枢管理机制</h1>
+          <p class="subtitle">这页给第一次听 StarWork 多项目机制的人看：中枢不是一个巨大的项目文件夹，而是共享规则、知识、身份、技能和项目登记的管理层；真正的项目执行留在各自的卫星项目里。</p>
+        </div>
+        <div class="quick-row">
+          <div class="quick"><b>Hub 管共享</b><span>统一维护身份、教训、知识、skills、项目注册和跨项目联络。</span></div>
+          <div class="quick"><b>Satellite 管执行</b><span>每个具体项目维护自己的状态、事项、过程材料和正式成果。</span></div>
+          <div class="quick"><b>Registry 管发现</b><span>中枢只登记项目在哪里、是否活跃，不吞掉项目进度正文。</span></div>
+          <div class="quick"><b>联络单管通信</b><span>项目之间的请求、同步、依赖和交接，用联络单留痕。</span></div>
+        </div>
+      </div>
+      <div class="hero-board" aria-label="Hub 与 Satellite 关系图">
+        <svg viewBox="0 0 640 620" role="img" aria-labelledby="diagram-title diagram-desc">
+          <title id="diagram-title">StarWork Hub 和 Satellite 关系</title>
+          <desc id="diagram-desc">Hub 位于上方，维护共享资源和项目注册表，通过 spawn 生成多个项目；项目之间通过联络单通信，候选公共内容回写到 incoming，但项目事实留在本地。</desc>
+          <defs>
+            <marker id="arrow" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
+              <path d="M 0 0 L 10 5 L 0 10 z" fill="#286d4a"></path>
+            </marker>
+            <marker id="arrow-blue" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="6" markerHeight="6" orient="auto-start-reverse">
+              <path d="M 0 0 L 10 5 L 0 10 z" fill="#2f6286"></path>
+            </marker>
+            <marker id="arrow-amber" viewBox="0 0 10 10" refX="8" refY="5" markerWidth="6" markerHeight="6" orient="auto">
+              <path d="M 0 0 L 10 5 L 0 10 z" fill="#b36b19"></path>
+            </marker>
+          </defs>
+          <rect x="42" y="26" width="556" height="176" rx="16" fill="#d8eadc" stroke="#1d211d" stroke-width="3"></rect>
+          <text x="320" y="70" text-anchor="middle" font-size="28" font-weight="900" fill="#1d211d">Hub 多项目中枢</text>
+          <text x="320" y="104" text-anchor="middle" font-size="15" fill="#62675f">共享机制和项目发现层</text>
+          <g font-size="14" fill="#1d211d">
+            <rect x="74" y="130" width="104" height="38" rx="8" fill="#fffdf7" stroke="#cfc7b7"></rect>
+            <text x="126" y="154" text-anchor="middle">identity</text>
+            <rect x="192" y="130" width="104" height="38" rx="8" fill="#fffdf7" stroke="#cfc7b7"></rect>
+            <text x="244" y="154" text-anchor="middle">lessons</text>
+            <rect x="310" y="130" width="104" height="38" rx="8" fill="#fffdf7" stroke="#cfc7b7"></rect>
+            <text x="362" y="154" text-anchor="middle">knowledge</text>
+            <rect x="428" y="130" width="104" height="38" rx="8" fill="#fffdf7" stroke="#cfc7b7"></rect>
+            <text x="480" y="154" text-anchor="middle">skills</text>
+          </g>
+          <rect x="210" y="242" width="220" height="74" rx="14" fill="#f3dfbd" stroke="#1d211d" stroke-width="2"></rect>
+          <text x="320" y="272" text-anchor="middle" font-size="20" font-weight="900" fill="#1d211d">项目 registry</text>
+          <text x="320" y="298" text-anchor="middle" font-size="14" fill="#62675f">只记录项目元数据</text>
+          <path d="M320 202 C320 218 320 225 320 242" fill="none" stroke="#286d4a" stroke-width="4" marker-end="url(#arrow)"></path>
+          <text x="352" y="228" font-size="13" fill="#286d4a">登记和发现</text>
+          <g>
+            <rect x="32" y="396" width="168" height="158" rx="14" fill="#d7e4ea" stroke="#1d211d" stroke-width="2"></rect>
+            <text x="116" y="430" text-anchor="middle" font-size="21" font-weight="900" fill="#1d211d">项目 A</text>
+            <text x="116" y="459" text-anchor="middle" font-size="14" fill="#62675f">具体项目执行</text>
+            <text x="116" y="494" text-anchor="middle" font-size="13" fill="#1d211d">项目状态 / 事项</text>
+            <text x="116" y="522" text-anchor="middle" font-size="13" fill="#1d211d">过程材料 / 成果</text>
+          </g>
+          <g>
+            <rect x="236" y="396" width="168" height="158" rx="14" fill="#d7e4ea" stroke="#1d211d" stroke-width="2"></rect>
+            <text x="320" y="430" text-anchor="middle" font-size="21" font-weight="900" fill="#1d211d">项目 B</text>
+            <text x="320" y="459" text-anchor="middle" font-size="14" fill="#62675f">具体项目执行</text>
+            <text x="320" y="494" text-anchor="middle" font-size="13" fill="#1d211d">项目状态 / 事项</text>
+            <text x="320" y="522" text-anchor="middle" font-size="13" fill="#1d211d">过程材料 / 成果</text>
+          </g>
+          <g>
+            <rect x="440" y="396" width="168" height="158" rx="14" fill="#d7e4ea" stroke="#1d211d" stroke-width="2"></rect>
+            <text x="524" y="430" text-anchor="middle" font-size="21" font-weight="900" fill="#1d211d">项目 C</text>
+            <text x="524" y="459" text-anchor="middle" font-size="14" fill="#62675f">具体项目执行</text>
+            <text x="524" y="494" text-anchor="middle" font-size="13" fill="#1d211d">项目状态 / 事项</text>
+            <text x="524" y="522" text-anchor="middle" font-size="13" fill="#1d211d">过程材料 / 成果</text>
+          </g>
+          <path d="M242 316 C194 340 154 361 116 396" fill="none" stroke="#286d4a" stroke-width="4" marker-end="url(#arrow)"></path>
+          <path d="M320 316 C320 345 320 365 320 396" fill="none" stroke="#286d4a" stroke-width="4" marker-end="url(#arrow)"></path>
+          <path d="M398 316 C446 340 486 361 524 396" fill="none" stroke="#286d4a" stroke-width="4" marker-end="url(#arrow)"></path>
+          <text x="432" y="358" font-size="13" fill="#286d4a">spawn 创建并登记</text>
+          <path d="M520 396 C548 318 536 236 480 176" fill="none" stroke="#2f6286" stroke-width="3" stroke-dasharray="8 8" marker-end="url(#arrow-blue)"></path>
+          <text x="500" y="286" font-size="13" fill="#2f6286">候选回写到 .incoming</text>
+          <path d="M200 476 C214 456 222 456 236 476" fill="none" stroke="#b36b19" stroke-width="3" marker-end="url(#arrow-amber)"></path>
+          <text x="218" y="448" text-anchor="middle" font-size="13" font-weight="900" fill="#b36b19">联络单沟通</text>
+        </svg>
+      </div>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>一句话讲清楚</h2>
+        <p class="section-note">给不了解 StarWork 的人，可以先用这个版本解释，不需要一上来讲 Core、Pack、Preset。</p>
+      </div>
+      <div class="callout">
+        <p><strong>多项目中枢</strong>就是一个“项目控制塔”：它不替每个项目干活，而是统一维护跨项目可复用的身份、经验、知识、skills 和项目登记；每个具体项目仍然在自己的工作台里独立推进。</p>
+      </div>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>三个角色</h2>
+        <p class="section-note">理解这套机制，只要先分清 Hub、Satellite、Registry 三件事。</p>
+      </div>
+      <div class="grid-3">
+        <article class="panel green">
+          <span class="tag">01 / Hub</span>
+          <h3>多项目中枢</h3>
+          <p>维护跨项目共享的东西：身份、教训、知识、skills、项目注册表、跨项目联络和回写审核。它是共享机制层，不是某个业务项目本身。</p>
+        </article>
+        <article class="panel blue">
+          <span class="tag">02 / Satellite</span>
+          <h3>卫星项目</h3>
+          <p>每个具体项目自己的工作台。项目状态、当前工作、事项、资料、过程材料、正式成果，都留在这里独立维护。</p>
+        </article>
+        <article class="panel amber">
+          <span class="tag">03 / Registry</span>
+          <h3>项目注册表</h3>
+          <p>Hub 里的项目清单。它记录项目 ID、名称、路径、状态、Core 版本和同步元数据，但不保存项目进度正文。</p>
+        </article>
+      </div>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>为什么要分开</h2>
+        <p class="section-note">如果所有项目都塞进一个大目录，短期看方便，长期会让事实源和责任边界混在一起。</p>
+      </div>
+      <div class="grid-2">
+        <article class="panel">
+          <h3>不分开会怎样</h3>
+          <ul>
+            <li>每个项目都会复制一份身份、教训和规则，越来越不一致。</li>
+            <li>共享知识和项目草稿混在一起，不知道哪里才是事实源。</li>
+            <li>中枢会变成巨大的进度数据库，项目越多越难读。</li>
+            <li>一个项目的临时判断容易污染所有项目的公共规则。</li>
+          </ul>
+        </article>
+        <article class="panel">
+          <h3>分开以后</h3>
+          <ul>
+            <li>Hub 只维护可复用、可审计、跨项目共享的内容。</li>
+            <li>Satellite 只维护项目自己的执行事实和产出。</li>
+            <li>项目发现靠 registry，项目进度仍然留在项目里。</li>
+            <li>可复用经验先进入回写审核，确认后再进入 Hub。</li>
+          </ul>
+        </article>
+      </div>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>实际怎么工作</h2>
+        <p class="section-note">用户感知上是“先建中枢，再从中枢创建项目”。CLI 内部负责检查、生成、登记和同步元数据。</p>
+      </div>
+      <div class="flow">
+        <div class="flow-step">
+          <span class="tag">Step 1</span>
+          <h3>创建 Hub</h3>
+          <p>用 <code>starwork init --type hub</code> 建立多项目中枢。这里放共享身份、教训、知识、skills 和项目注册表。</p>
+        </div>
+        <div class="arrow">→</div>
+        <div class="flow-step">
+          <span class="tag">Step 2</span>
+          <h3>生成项目</h3>
+          <p>用 <code>starwork spawn</code> 从 Hub 创建 Satellite。CLI 会复制快照、挂载共享资源，并写入同步元数据。</p>
+        </div>
+        <div class="arrow">→</div>
+        <div class="flow-step">
+          <span class="tag">Step 3</span>
+          <h3>项目内推进</h3>
+          <p>Agent 在 Satellite 内维护项目状态、事项、资料和成果。Hub 只知道项目在哪里、是否活跃、如何同步。</p>
+        </div>
+      </div>
+      <pre>starwork init --type hub --target ~/my-hub --yes
+starwork spawn \
+  --hub ~/my-hub \
+  --name "内容产品官网" \
+  --target ~/projects/content-site \
+  --mode matter \
+  --yes
+starwork doctor --target ~/projects/content-site</pre>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>哪些内容放哪里</h2>
+        <p class="section-note">这张表是解释边界最有用的部分：Hub 不是所有内容的收纳箱，Satellite 也不是孤岛。</p>
+      </div>
+      <div class="table-wrap">
+        <table>
+          <thead>
+            <tr>
+              <th>内容</th>
+              <th>放在 Hub</th>
+              <th>放在 Satellite</th>
+              <th>原因</th>
+            </tr>
+          </thead>
+          <tbody>
+            <tr>
+              <td>长期身份、偏好、工作方式</td>
+              <td><code>identity/</code></td>
+              <td>初始化快照或只读参考</td>
+              <td>这是跨项目稳定资源，应由中枢统一维护。</td>
+            </tr>
+            <tr>
+              <td>跨项目教训</td>
+              <td><code>lessons/</code></td>
+              <td>本项目候选教训</td>
+              <td>项目里先沉淀，确认可复用后再回写到 Hub。</td>
+            </tr>
+            <tr>
+              <td>共享知识库</td>
+              <td><code>知识/</code> 或 <code>knowledge/</code></td>
+              <td>只读链接</td>
+              <td>避免多个项目各自修改同一份公共知识。</td>
+            </tr>
+            <tr>
+              <td>共享 skills</td>
+              <td><code>skills/</code></td>
+              <td>软链接或挂载入口</td>
+              <td>让多个项目使用同一套能力，而不是复制出很多分叉。</td>
+            </tr>
+            <tr>
+              <td>项目状态和当前工作</td>
+              <td>只登记元数据</td>
+              <td><code>_系统/上下文/当前项目.md</code>、<code>_系统/任务/当前工作.md</code></td>
+              <td>项目事实必须留在项目工作台内。</td>
+            </tr>
+            <tr>
+              <td>项目产物、资料、事项</td>
+              <td>不存正文</td>
+              <td><code>输出/</code>、<code>参考资料/</code>、<code>事项/</code></td>
+              <td>这些是具体项目的执行内容，不属于中枢公共层。</td>
+            </tr>
+            <tr>
+              <td>可复用更新建议</td>
+              <td><code>.incoming/</code> 审核后合并</td>
+              <td>发起候选回写</td>
+              <td>先审核再进入 Hub，避免项目临时经验污染公共资源。</td>
+            </tr>
+            <tr>
+              <td>项目之间的请求、同步和交接</td>
+              <td><code>项目/联络/</code> 或中枢联络入口</td>
+              <td><code>_系统/跨项目/</code></td>
+              <td>联络单负责“项目和项目怎么说话”，不替代项目状态，也不直接改变 Hub 正式知识。</td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>联络单机制</h2>
+        <p class="section-note">联络单是多项目协作里的“可追踪消息”。它解决项目之间怎么提请求、交接、同步和回复的问题。</p>
+      </div>
+      <div class="grid-2">
+        <article class="panel green">
+          <span class="tag">它是什么</span>
+          <h3>项目之间的正式留言</h3>
+          <p>当项目 A 需要项目 B 提供信息、同步进展、确认边界、交接材料，或者向 Hub 说明一个跨项目事项时，就写联络单。它应该有明确发送方、接收方、背景、请求、截止时间和期望回复。</p>
+        </article>
+        <article class="panel amber">
+          <span class="tag">它不是什么</span>
+          <h3>不是项目进度，也不是知识回写</h3>
+          <p>联络单不存项目完整进度，项目进度仍在项目自己的状态和事项里；它也不直接把内容合并进 Hub 的身份、教训或知识。可复用内容仍应走 <code>.incoming/</code> 审核。</p>
+        </article>
+      </div>
+      <div class="flow" style="margin-top: 16px;">
+        <div class="flow-step">
+          <span class="tag">发送</span>
+          <h3>项目 A 写联络单</h3>
+          <p>在本项目 <code>_系统/跨项目/</code> 留一份发送记录，说明要找谁、为什么找、希望对方做什么。</p>
+        </div>
+        <div class="arrow">→</div>
+        <div class="flow-step">
+          <span class="tag">路由</span>
+          <h3>Hub 留痕和分发</h3>
+          <p>Hub 的联络入口记录这次跨项目通信，帮助未来查到“哪个项目找过哪个项目”。</p>
+        </div>
+        <div class="arrow">→</div>
+        <div class="flow-step">
+          <span class="tag">回复</span>
+          <h3>项目 B 处理并回复</h3>
+          <p>项目 B 在自己的工作台处理请求，并通过联络单回复。需要沉淀为公共知识时，再另走回写审核。</p>
+        </div>
+      </div>
+      <div class="callout">
+        <p>可以把 registry 理解成“通讯录”，把联络单理解成“正式邮件”，把 <code>.incoming</code> 理解成“投稿审核箱”。三者都和中枢有关，但职责完全不同。</p>
+      </div>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>容易误解的点</h2>
+        <p class="section-note">这几个边界要讲清楚，别人就不容易把 Hub 理解成“更大的项目文件夹”。</p>
+      </div>
+      <div class="grid-2">
+        <article class="panel">
+          <h3>Hub 不是项目进度数据库</h3>
+          <p>Hub 的 <code>项目/registry.json</code> 只回答“有哪些项目、在哪里、什么状态”。具体进度、事项、判断和产物仍在各自 Satellite。</p>
+        </article>
+        <article class="panel">
+          <h3>Satellite 不是 Hub 的子目录</h3>
+          <p>Satellite 是独立工作台，可以在任意路径。它通过 <code>.core-sync.json</code> 记录来源 Hub、共享资源和同步关系。</p>
+        </article>
+        <article class="panel">
+          <h3>共享资源不是随便改</h3>
+          <p>知识和 skills 默认来自 Hub。项目内如果产生可复用内容，应先走候选回写和审核，而不是直接改 Hub 正式内容。</p>
+        </article>
+        <article class="panel">
+          <h3>spawn 不是 init 的替代品</h3>
+          <p><code>init</code> 创建当前工作台，<code>spawn</code> 从已有 Hub 创建并登记一个新项目。它们处理的是不同层级的问题。</p>
+        </article>
+        <article class="panel">
+          <h3>联络单不是 registry</h3>
+          <p>registry 记录项目元数据，联络单记录项目之间的一次正式沟通。不要把跨项目请求塞进项目注册表。</p>
+        </article>
+        <article class="panel">
+          <h3>联络单不是 .incoming</h3>
+          <p><code>.incoming</code> 用来审核候选公共内容；联络单用来请求、同步、交接和回复。一次联络可能产生回写候选，但它们不是同一件事。</p>
+        </article>
+      </div>
+    </section>
+    <section class="section">
+      <div class="section-header">
+        <h2>一句话版本</h2>
+        <p class="section-note">如果你要在会议里快速解释，可以直接用下面这段。</p>
+      </div>
+      <div class="callout">
+        <p>StarWork 的多项目机制采用 Hub + Satellite：Hub 是中枢，负责共享身份、教训、知识、skills、项目注册和联络入口；Satellite 是具体项目，负责自己的状态、事项、资料和成果。Hub 通过 registry 找到项目，通过 spawn 创建项目，通过联络单协调项目之间的请求和交接，通过 .incoming 接收候选回写，但不会把项目进度正文吞进中枢。</p>
+      </div>
+    </section>
+  </main>
+</body>
+</html>