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/index.html ADDED Viewed

@@ -0,0 +1,228 @@
+<!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;
+      --amber: #b36b19;
+      --blue: #2f6286;
+      --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;
+    }
+    .shell {
+      min-height: 100vh;
+      display: grid;
+      grid-template-columns: 320px minmax(0, 1fr);
+    }
+    aside {
+      position: sticky;
+      top: 0;
+      height: 100vh;
+      padding: 28px 22px;
+      border-right: 2px solid var(--ink);
+      background: rgba(255, 253, 247, 0.86);
+      overflow: auto;
+    }
+    main {
+      min-width: 0;
+      padding: 22px;
+    }
+    .brand {
+      padding-bottom: 22px;
+      border-bottom: 2px solid var(--ink);
+    }
+    .kicker {
+      margin: 0 0 10px;
+      color: var(--green);
+      font-size: 12px;
+      font-weight: 900;
+      text-transform: uppercase;
+    }
+    h1 {
+      margin: 0;
+      font-family: Georgia, "Times New Roman", "Songti SC", serif;
+      font-size: 38px;
+      line-height: 1.02;
+      letter-spacing: 0;
+    }
+    .intro {
+      margin: 14px 0 0;
+      color: var(--muted);
+      font-size: 14px;
+      line-height: 1.7;
+    }
+    .nav-group {
+      margin-top: 24px;
+    }
+    .nav-title {
+      margin: 0 0 10px;
+      color: var(--muted);
+      font-size: 12px;
+      font-weight: 900;
+      text-transform: uppercase;
+    }
+    .nav {
+      display: grid;
+      gap: 9px;
+    }
+    .nav a {
+      display: block;
+      padding: 12px 13px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: var(--paper);
+      color: var(--ink);
+      text-decoration: none;
+      font-weight: 850;
+      line-height: 1.35;
+    }
+    .nav a span {
+      display: block;
+      margin-top: 5px;
+      color: var(--muted);
+      font-size: 12px;
+      font-weight: 500;
+      line-height: 1.45;
+    }
+    .nav a:hover,
+    .nav a:focus {
+      outline: none;
+      border-color: var(--green);
+      box-shadow: 0 0 0 3px rgba(40, 109, 74, 0.12);
+      background: var(--white);
+    }
+    .hint {
+      margin-top: 24px;
+      padding: 14px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: var(--paper-2);
+      color: var(--muted);
+      font-size: 13px;
+      line-height: 1.65;
+    }
+    .viewer-wrap {
+      height: calc(100vh - 44px);
+      border: 2px solid var(--ink);
+      border-radius: 8px;
+      background: var(--white);
+      box-shadow: var(--shadow);
+      overflow: hidden;
+    }
+    iframe {
+      width: 100%;
+      height: 100%;
+      border: 0;
+      background: var(--white);
+    }
+    code {
+      padding: 2px 5px;
+      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;
+    }
+    @media (max-width: 900px) {
+      .shell {
+        grid-template-columns: 1fr;
+      }
+      aside {
+        position: relative;
+        height: auto;
+        border-right: 0;
+        border-bottom: 2px solid var(--ink);
+      }
+      main {
+        padding: 14px;
+      }
+      .viewer-wrap {
+        height: 78vh;
+      }
+    }
+  </style>
+</head>
+<body>
+  <div class="shell">
+    <aside>
+      <div class="brand">
+        <p class="kicker">StarWork Docs</p>
+        <h1>文档中心</h1>
+        <p class="intro">所有正式 HTML 阅读稿统一从这里进入。左侧选择子页面，右侧阅读，不再零散打开多个文件。</p>
+      </div>
+      <section class="nav-group">
+        <p class="nav-title">正式阅读稿</p>
+        <nav class="nav" aria-label="正式 HTML 文档">
+          <a href="hub-management.html" target="reader">多项目中枢管理机制<span>用 Hub + Satellite 解释中枢、卫星项目、项目注册表、spawn 和回写边界。</span></a>
+          <a href="cli-capabilities.html" target="reader">CLI 能力说明<span>解释 init、spawn、doctor、adapt、pack install 的能力边界，并说明 spawn blueprint 定制生成能力。</span></a>
+          <a href="roadmap.html" target="reader">产品里程碑<span>M0 到 M8 的路线图，以及当前阶段定位。</span></a>
+          <a href="product-shape-business-model.html" target="reader">产品形态与商业模式<span>StarWork 是什么、四层产品结构和商业化判断。</span></a>
+        </nav>
+      </section>
+      <section class="nav-group">
+        <p class="nav-title">归档草稿</p>
+        <nav class="nav" aria-label="归档 HTML 文档">
+          <a href="../../matters/2026-05-09-starwork-core-v0.1-build/drafts/core-framework-and-file-boundaries.html" target="reader">Core 框架与文件边界<span>早期推敲稿，仅作历史参考；正式事实以 product/ 为准。</span></a>
+        </nav>
+      </section>
+      <div class="hint">
+        Markdown 事实源仍保留在 <code>product/docs/</code>、<code>product/cli/</code> 与 <code>product/skills/</code>。HTML 是阅读版，后续新增 HTML 都应挂到这个文档中心。
+      </div>
+    </aside>
+    <main>
+      <div class="viewer-wrap">
+        <iframe name="reader" title="StarWork 文档阅读区" src="hub-management.html"></iframe>
+      </div>
+    </main>
+  </div>
+</body>
+</html>

package/docs/product-direction.md ADDED Viewed

@@ -0,0 +1,64 @@
+# StarWork 产品方向
+## 产品定位
+StarWork 是面向 Codex、Claude Code、Cursor、Trae、Claw Code 等 Agent 的 AI 工作系统套件，用于支持用户和 Agent 进行长期、连续、可审计的真实工作协作。
+StarWork 不是完整自研 Agent Runtime，也不是单纯开源文件夹模板。它的产品价值在于工作系统层：让 Agent 能稳定理解、继续、记录、复盘和改进用户的长期工作。
+## 产品四层
+StarWork 拆成四层：
+1. StarWork Core：开源 AI 工作区协议
+2. StarWork CLI：安装、检查、适配和 Pack 管理工具
+3. StarWork Packs：面向岗位和场景的工作流包
+4. StarWork Course：方法论课程与陪跑服务
+四层分工：
+- Core 负责可信度、标准和传播。
+- CLI 负责产品感、安装体验和降低门槛。
+- Packs 负责具体场景解决方案和商业化。
+- Course 负责教育、转化、高客单服务和方法论表达。
+Course 层继续由 `珍妮丁丁GFM` 承载。本项目承载产品本体：Core、CLI、Packs、Skills、Adapters、schemas、examples、正式产品文档和发布材料。
+## 方向约束
+- 不复用 `/Users/shuxinding/Project/StarWork` 作为产品基础，该目录只作为 `legacy runtime spike` 参考。
+- 不把自研完整 Agent Runtime 作为 v0.1 主线。
+- 不把 Claude Code SDK、Claude Agent SDK 或海外服务作为默认产品依赖。
+- 第一阶段不做 OpenClaw 式消息平台 gateway。
+- 不把 StarWork 讲成“文件夹模板”；文件结构只是 Core 协议的可见载体。
+- 不把课程材料直接搬进本产品项目，除非已经晋升为产品事实、正式文档、示例或 Pack 资产。
+## 首个产品闭环
+第一阶段产品闭环是：
+```text
+Core v0.1 协议
+        ↓
+CLI v0.1 安装与适配
+        ↓
+自媒体内容创作者 Pack v0.1
+        ↓
+Demo 工作区与产品文档
+```
+目标是证明：普通内容创作者可以安装 StarWork，加入自媒体内容创作者 Pack，并让 Agent 清楚知道灵感、选题、草稿、发布记录、复盘数据、用户反馈和下一步动作分别放在哪里。
+## v0.1 当前收敛
+截至 2026-05-18，Core 被定义为开源 AI 工作区协议；Kit 是协议的参考落地结构；CLI 负责稳定生成、检查、适配和安装 Pack；Skill 负责帮助 Agent 生成配置、理解流程和调用工具；Pack 负责场景定制。
+当前已经形成：
+- Core v0.1 协议入口与五类 Kit 结构。
+- `starwork init`、`starwork spawn`、`starwork doctor`、`starwork adapt`、`starwork pack install` 第一版。
+- `starwork spawn --blueprint` 第一版，可按工作台定制单生成定制化卫星项目。
+- `starworkSpawn` skill 第一版，用于帮助 Agent 设计 Spawn Blueprint。
+- Pack 源包结构：语言无关业务角色 + `languages/` 多语言落地配置。
+下一步重点不是继续扩张 Core，而是验证 CLI、Skill 和 Pack 能否在真实场景里稳定生成、检查、安装和解释这些结构。