codex-skill-analytics 0.1.0

package/DESIGN.md

@@ -0,0 +1,279 @@
+---
+name: Codex Skill Analytics
+description: 面向本地 Codex Skill 证据的工程运行审计台
+colors:
+  canvas: "#eef2f3"
+  surface: "#ffffff"
+  surface-muted: "#f6f8f9"
+  ink: "#17242a"
+  muted: "#66777f"
+  line: "#d4dde0"
+  line-strong: "#adbdc3"
+  rail: "#152228"
+  rail-active: "#203139"
+  signal: "#007b94"
+  signal-deep: "#005c70"
+  scope-amber: "#bd6728"
+  danger: "#a63f3f"
+  scope-green: "#17766d"
+  scope-violet: "#7057a4"
+  scope-repo: "#3f659b"
+  focus: "#00a2c4"
+typography:
+  headline:
+    fontFamily: '"DIN Alternate", "Avenir Next Condensed", sans-serif'
+    fontSize: "21px"
+    fontWeight: 600
+    lineHeight: 1.1
+    letterSpacing: ".01em"
+  title:
+    fontFamily: '"DIN Alternate", "Avenir Next Condensed", sans-serif'
+    fontSize: "14px"
+    fontWeight: 600
+    lineHeight: 1.2
+    letterSpacing: ".015em"
+  body:
+    fontFamily: '"Avenir Next", "PingFang SC", sans-serif'
+    fontSize: "13px"
+  label:
+    fontFamily: "ui-monospace, SFMono-Regular, monospace"
+    fontSize: "8px"
+    fontWeight: 600
+    letterSpacing: ".09em"
+  data:
+    fontFamily: "ui-monospace, SFMono-Regular, monospace"
+    fontSize: "23px"
+    fontWeight: 650
+    lineHeight: 1
+    letterSpacing: "-.03em"
+rounded:
+  quiet: "4px"
+  control: "5px"
+  nav: "6px"
+  round: "50%"
+spacing:
+  compact: "4px"
+  tight: "8px"
+  control: "10px"
+  panel: "14px"
+  section: "16px"
+  workspace: "20px"
+  rail: "24px"
+components:
+  action-button:
+    backgroundColor: "{colors.signal-deep}"
+    textColor: "{colors.surface}"
+    rounded: "{rounded.control}"
+    padding: "0 13px"
+    height: "34px"
+  action-button-hover:
+    backgroundColor: "{colors.signal}"
+    textColor: "{colors.surface}"
+    rounded: "{rounded.control}"
+    padding: "0 13px"
+    height: "34px"
+  quiet-button:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.signal-deep}"
+    rounded: "{rounded.quiet}"
+    padding: "5px 8px"
+  field:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.ink}"
+    rounded: "{rounded.control}"
+    padding: "0 9px"
+    height: "34px"
+  nav-item:
+    backgroundColor: "transparent"
+    textColor: "#aebdc3"
+    rounded: "{rounded.nav}"
+    padding: "0 10px"
+    height: "42px"
+  nav-item-active:
+    backgroundColor: "{colors.rail-active}"
+    textColor: "{colors.surface}"
+    rounded: "{rounded.nav}"
+    padding: "0 10px"
+    height: "42px"
+  panel:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.ink}"
+  selectable-data-row:
+    backgroundColor: "{colors.surface}"
+    textColor: "{colors.ink}"
+    padding: "0 11px"
+    height: "36px"
+  selectable-data-row-selected:
+    backgroundColor: "#e1f0f3"
+    textColor: "{colors.ink}"
+    padding: "0 11px"
+    height: "36px"
+---
+
+# Design System: Codex Skill Analytics
+
+## Overview
+
+**Creative North Star: "工程运行审计台"**
+
+Codex Skill Analytics 的界面像一张长期打开的工程审计工作台：深色工作区导航承担稳定方位，冷白高密度画布承载筛选、指标、图表、表格与证据。视觉权威来自清楚的结构、可比较的数据和可追溯的状态，而不是营销式叙事。
+
+系统以细边界、紧凑间距和等宽数字建立秩序，以克制青色标记主要动作、聚焦与选择。它明确拒绝营销 Hero、夸张装饰和玩具式卡片堆叠；数据关系只表达观察证据，不借视觉暗示夸大为源码依赖。
+
+**Key Characteristics:**
+
+- 深色固定工作区导航与冷白分析画布形成稳定分区。
+- 高密度排布、细结构线和紧凑控制优先服务快速扫描。
+- 青色是稀缺的操作与聚焦信号，作用域色只编码数据语义。
+- 数字、标识和状态采用等宽字形，文本标题采用窄体工程字体。
+- 表面默认扁平，层级主要由色调和边界建立。
+
+## Colors
+
+以冷灰白与深青黑构成工作区，青色只承担操作信号；紫、绿、橙、蓝等作用域色仅用于数据分类。
+
+### Primary
+
+- **审计信号青** (`signal`): 用于唯一主动作、选中边线、关系箭头和当前聚焦状态。
+- **深审计青** (`signal-deep`): 用于主动作静止态与低调的文字动作，保证青色不会泛滥。
+
+### Secondary
+
+- **作用域琥珀** (`scope-amber`): 标识插件作用域，并在关系图中强调当前活动边。
+- **作用域绿** (`scope-green`): 标识用户共享 Skill 与在线状态。
+- **作用域紫** (`scope-violet`): 标识系统 Skill。
+- **仓库蓝** (`scope-repo`): 标识项目仓库 Skill。
+
+### Tertiary
+
+- **危险红** (`danger`): 保留给失败或危险语义，不作为装饰色。
+- **焦点亮青** (`focus`): 仅用于键盘焦点环等无障碍反馈。
+
+### Neutral
+
+- **冷雾画布** (`canvas`): 包围所有分析面板的页面底色。
+- **冷白表面** (`surface`): 命令栏、面板、字段和数据行的主表面。
+- **次级冷白** (`surface-muted`): 表头和轻度分区，不制造卡片层叠。
+- **工程墨色** (`ink`): 标题、正文与关键数据的默认前景色。
+- **审计灰** (`muted`): 辅助说明、标签和元数据。
+- **细规则线** (`line`): 面板、分隔和表格结构。
+- **强规则线** (`line-strong`): 输入和低调动作的边界。
+- **工作区深青黑** (`rail`): 固定导航轨道。
+- **工作区激活面** (`rail-active`): 当前导航项的低对比度选中面。
+
+### Named Rules
+
+**The Signal Scarcity Rule.** 青色只标记操作、焦点和选择；不要用它填充普通容器或装饰大面积背景。
+
+**The Semantic Scope Rule.** 作用域色只编码 system、user、plugin、repo 等真实类别，绝不拿来制造无含义的视觉变化。
+
+## Typography
+
+**Display Font:** 不设营销展示字体；本系统没有 Hero 层级。
+**Body Font:** Avenir Next（中文回退 PingFang SC）
+**Label/Mono Font:** ui-monospace（回退 SFMono-Regular 与 monospace）
+
+**Character:** 窄体标题提供工程控制台的清晰骨架，正文保持 macOS 原生阅读感；等宽数据让数量、权重、索引、时间和状态可以纵向比较。
+
+### Hierarchy
+
+- **Headline** (600, `headline`): 只用于页面标题，保持紧凑而非宣传化。
+- **Title** (600, `title`): 用于面板标题和检查器标题。
+- **Body** (常规, `body`): 用于控件内容、行文本与简短说明。
+- **Data** (650, `data`): 用于指标值，启用表格数字并保持对齐。
+- **Label** (600, `label`, uppercase): 用于字段标签、表头、索引和状态元数据。
+
+### Named Rules
+
+**The Monospace Evidence Rule.** 数字、权重、时间、索引与状态使用等宽字；叙述文本不使用等宽字制造伪技术感。
+
+## Layout
+
+桌面使用 228px 深色导航轨与可伸缩工作区；工作区顶部是 72px 命令栏，主体以 20px 横向内边距和 14px 面板间距组织。数量页主分析区是内容区加 330px 图例栏，关系页是内容区加 340px 检查器栏；指标条为五列或四列的连续分段表面，而不是独立卡片。
+
+在 1100px 以下，数量页主图、图例和下方区域依次堆叠；在 1050px 以下，关系图与检查器分层，两个检查器并列。在 980px 以下，导航轨缩至 72px，隐藏辅助文字，五项指标改为三列折行。在 680px 以下，导航转为顶部横条，命令控件全宽单列，指标改为两列；关系图保留 960px 全尺寸 SVG 并允许内部横向滑动，避免把网络压缩到不可读。
+
+**The Data Before Decoration Rule.** 首屏顺序始终是方位、筛选、紧凑指标和主数据视图；不插入 Hero、口号区或装饰模块。
+
+## Elevation & Depth
+
+系统默认扁平。画布、命令栏、面板、表头和数据行通过冷白色调差与 1px 细边界分层；常规面板不使用阴影。阴影只出现在键盘焦点、在线状态点、选中行内嵌信号和关系节点等明确状态反馈中。
+
+### Shadow Vocabulary
+
+- **Reserved ambient** (`shadow`): 源码中保留的低幅环境阴影 token，当前常规面板未使用。
+- **Focus ring** (`0 0 0 3px rgba(0,162,196,.25)`): 键盘焦点反馈。
+- **Status halo** (`0 0 0 3px rgba(73,183,165,.13)`): 在线状态点的低幅光环。
+- **Selected inset** (`inset 3px 0 0 var(--signal)`): 聚焦 Skill 行的非颜色唯一选择标记。
+- **Graph node lift** (`drop-shadow(0 3px 4px rgba(23,36,42,.16))`): 仅让可拖动关系节点与图谱底面分离。
+
+**The Flat-by-Default Rule.** 静止表面依靠色调与边界分层；阴影必须对应焦点、选择、在线或可拖动状态。
+
+## Shapes
+
+主体面板和指标条保持直角，以强化连续审计画布；字段与主动作采用轻微圆角，导航项稍柔和，数据节点和作用域点使用圆形。所有边界保持细而克制，不使用胶囊按钮或夸张圆角卡片。
+
+**The Structural Corner Rule.** 容器保持直角；只有可交互控件、导航项和真实点状数据标记使用已定义圆角。
+
+## Components
+
+### Buttons
+
+- **Shape:** 主动作使用紧凑轻圆角 (`control`) 和 34px 高度；低调动作使用更小圆角 (`quiet`)。
+- **Primary:** 深审计青底、冷白文字与 13px 水平内边距；hover 转为审计信号青。
+- **Hover / Focus:** hover 只做色调变化；focus-visible 使用 3px 亮青透明焦点环；disabled 降至 55% 不透明度并显示等待光标。
+- **Quiet:** 冷白底、强规则线边框和深审计青文字；hover 使用极淡青白底。
+
+### Cards / Containers
+
+- **Corner Style:** 主面板无圆角。
+- **Background:** 冷白表面，表头可使用次级冷白。
+- **Shadow Strategy:** 常规状态无阴影。
+- **Border:** 1px 细规则线；面板标题栏以同样规则线分隔。
+- **Internal Padding:** 标题栏水平 16px；内容根据数据类型使用 8–16px 的紧凑节奏。
+
+### Inputs / Fields
+
+- **Style:** 34px 高度、冷白底、1px 强规则线和轻圆角 (`control`)，水平内边距 9px。
+- **Focus:** 使用统一亮青透明焦点环，保留原有边框以避免布局跳动。
+- **Responsive:** 680px 以下字段与主动作扩展为整行，不挤压输入内容。
+
+### Navigation
+
+- **Style:** 桌面为 228px 深色纵向工作区轨，项目高 42px、轻圆角 (`nav`)；索引和计数使用等宽字。
+- **States:** hover 使用更亮深青面；active 使用工作区激活面、可见边界和白色文字，索引变为浅青。
+- **Responsive:** 980px 以下缩成图标式窄轨；680px 以下变为顶部横向导航并保留文字标签。
+
+### Metrics Strip
+
+- **Style:** 多个指标共享一块冷白连续表面，用 1px 规则线分段；数值使用等宽 Data 层级。
+- **Responsive:** 五列或四列按断点折成三列、两列，不拆成悬浮卡片。
+
+### Selectable Data Rows
+
+- **Style:** 图例行和关系列使用全宽、无外框的紧凑按钮行，底部细线分隔。
+- **States:** hover 只改变冷白色调；选中 Skill 行同时使用浅青底和 3px 左侧内嵌信号，避免仅靠颜色表达选择。
+
+### Graph Nodes
+
+- **Style:** 圆形节点按调用量缩放，填色只来自作用域语义；名称使用正文粗体，作用域标签使用等宽小写标签。
+- **States:** hover、selected 与 keyboard focus 都以深色加粗描边确认交互状态；非匹配节点降低不透明度但保留网络上下文。
+- **Mobile:** 不缩小全图；在 680px 以下让 960px 图谱在容器内横向滑动。
+
+## Do's and Don'ts
+
+### Do:
+
+- **Do** 让导航、筛选和主数据视图在首屏形成连续操作路径。
+- **Do** 使用细边界、冷白色调差和紧凑间距表达层级。
+- **Do** 用等宽字呈现可比较的数字、时间、权重、索引和状态。
+- **Do** 为选择提供边线、描边或结构变化，不能只改变颜色。
+- **Do** 在窄屏保留图表的可读尺度，并让超宽数据视图内部滚动。
+
+### Don't:
+
+- **Don't** 添加营销 Hero、巨大口号、客户证明或与本地证据无关的品牌叙事。
+- **Don't** 把每项指标拆成带阴影、厚圆角的玩具式卡片。
+- **Don't** 大面积铺设青色或把作用域色用于非语义装饰。
+- **Don't** 用阴影代替结构线，也不要让静止面板悬浮。
+- **Don't** 把观察到的顺序、共现或相邻关系描述成声明式依赖。

package/PRODUCT.md

@@ -0,0 +1,54 @@
+# Product
+
+<!-- impeccable:product-schema 1 -->
+
+## Platform
+
+web
+
+## Stack
+
+Existing implementation: Python 3.11 standard library HTTP server, SQLite, and dependency-free HTML/CSS/JavaScript. No framework migration is authorized by the current request.
+
+## Users
+
+Inferred from the explicit brief: the primary user is a local Codex power user or agent-infrastructure engineer who needs to inspect Skill behavior repeatedly, not a first-time visitor viewing a product demo.
+
+## Product Purpose
+
+Codex Skill Analytics is a read-only sidecar for local Codex history. It turns deterministic Skill invocation evidence into an operational view of invocation volume, time trends, recent events, and observed Skill-to-Skill relationships. Success means the user can compare all Skills quickly, isolate one Skill without losing context, and trace every result back to local event metadata.
+
+## Positioning
+
+The product derives reproducible analytics from local rollout evidence without semantic classification, model inference, or changes to Codex. It distinguishes per-turn Invocation counts from document/script Access evidence.
+
+## Operating Context
+
+The Web runs on localhost and reads an independent SQLite database populated incrementally from `~/.codex/sessions` and `~/.codex/archived_sessions`. It is used alongside Codex as an engineering observability surface. The two primary workflows are volume analysis and relationship analysis.
+
+## Capabilities and Constraints
+
+- Two separate pages are required: invocation quantity and invocation relationships.
+- The quantity page must show every Skill as its own time-series line and allow any Skill to be focused interactively.
+- The relationship page must support observed sequence, same-turn co-occurrence, and next-in-thread relationships.
+- The system must remain local-only, deterministic, and free of LLM or model API dependencies.
+- It must not store user messages, assistant messages, reasoning, complete commands, or tool output.
+- The local rollout schema is internal and may drift; unknown records are skipped rather than guessed.
+
+## Evidence on Hand
+
+- The current local database contains real Codex invocation, access, thread, turn, trend, and relationship records.
+- Source and tests live in this repository; generated screenshots under `reports/` are verification evidence, not brand assets.
+- No customer logos, testimonials, commercial claims, or external benchmark data exist and none may be fabricated.
+
+## Product Principles
+
+- Operational clarity before decoration.
+- Dense comparison with controlled focus, not isolated vanity metrics.
+- Observed evidence must never be presented as declared dependency.
+- Every filter and count must remain honest about its scope.
+- Local privacy and reproducibility are product behavior, not marketing copy.
+
+## Accessibility & Inclusion
+
+Keyboard focus, reduced-motion behavior, responsive layouts, readable contrast, and non-color-only selection states are required for both Web pages.

package/README.md

@@ -0,0 +1,128 @@
+# Codex Skill Analytics
+
+一个完全本地、纯工程实现的 Codex Skill 旁路分析器。它只读扫描 Codex rollout JSONL，
+确定性识别 Skill 文档读取、Skill 脚本运行和可识别的显式 Skill 注入，然后增量写入独立
+SQLite 数据库。运行时不调用任何模型，也不修改或拦截 Codex。
+
+## 统计口径
+
+- **Invocation**：同一轮中同一 Skill 只计一次，与 Codex 当前源码的去重口径一致。
+- **Access**：每次可验证的 `SKILL.md` 读取或 `scripts/` 脚本执行均计一次。
+- **Same turn**：两个 Skill 在同一轮共同调用。
+- **Sequence**：同一轮中相邻的 Skill 调用方向。
+- **Next in thread**：同一线程中相邻的 Skill 调用方向，关系弱于同轮序列。
+
+仅有名称提及、系统 Skill 清单、代码示例和搜索结果不会被算作调用。
+
+## 一条命令启动 Web
+
+需要 Python 3.11 或更高版本，以及本机 Codex 产生的 `~/.codex/sessions` 或
+`~/.codex/archived_sessions` 历史。
+
+拿到仓库后直接运行：
+
+```bash
+./run.sh
+```
+
+脚本不安装第三方依赖，会自动增量同步本机 Codex 历史、启动本地服务，并在默认浏览器打开：
+
+```text
+http://127.0.0.1:8765/
+```
+
+首次从 GitHub 获取私有仓库时，可使用一行命令：
+
+```bash
+gh repo clone NauJson/codex-skill-analytics && cd codex-skill-analytics && ./run.sh
+```
+
+停止服务按 `Ctrl-C`。再次运行仍是增量同步，不会重复计数。如果机器上没有 Codex 历史，Web
+仍能打开，但统计结果为空。
+
+## NPM / NPX CLI
+
+安装发布包后，可直接启动并打开 Web：
+
+```bash
+npx codex-skill-analytics
+```
+
+或全局安装，两个命令名都可用：
+
+```bash
+npm install --global codex-skill-analytics
+codex-skill-analytics
+# 简写
+csa
+```
+
+不带参数时，CLI 会先增量同步本机历史，然后打开 Web。原有子命令可以直接透传：
+
+```bash
+csa sync
+csa summary --days 30
+csa events --days 30 --limit 100
+csa relations --days 30 --type sequence
+csa graph --days 30 --type sequence --output skill-graph.html
+csa serve --open
+```
+
+NPM 包不携带、不上传用户的 Codex 历史或 SQLite 数据。它包含 Node 启动器和纯标准库 Python
+分析内核；运行机器仍需安装 Python 3.11 或更高版本。可通过
+`CSA_PYTHON=/path/to/python csa` 显式指定解释器。
+
+## 开发安装与命令行使用
+
+```bash
+git clone https://github.com/NauJson/codex-skill-analytics.git
+cd codex-skill-analytics
+python3 -m venv .venv
+.venv/bin/pip install -e .
+
+.venv/bin/codex-skill-analytics sync
+.venv/bin/codex-skill-analytics summary --days 30
+.venv/bin/codex-skill-analytics events --days 30 --limit 100
+.venv/bin/codex-skill-analytics trend --days 30
+.venv/bin/codex-skill-analytics relations --days 30 --type same-turn
+.venv/bin/codex-skill-analytics relations --days 30 --type sequence
+.venv/bin/codex-skill-analytics graph --days 30 --type sequence \
+  --min-weight 2 --output skill-dependency-graph.html
+.venv/bin/codex-skill-analytics serve --open
+```
+
+默认数据库位于：
+
+```text
+~/.local/share/codex-skill-analytics/analytics.sqlite3
+```
+
+可用 `--db /path/to/file.sqlite3` 指定其他位置。
+
+`graph` 会生成不依赖网络的单文件交互式 HTML。默认的 `sequence` 图中，`A → B` 表示同一轮
+内 A 后紧接着调用了 B；这是一种从历史观察到的应用依赖，不代表 Skill 源码声明了硬依赖。
+也可用 `--type same-turn` 查看无方向共现，或用 `--type next-in-thread` 查看线程内跨轮衔接。
+
+`serve` 默认只监听 `127.0.0.1:8765`，提供两个独立页面：
+
+- `/`：调用数量、每日趋势、Skill 排名、作用域分布和最近调用；
+- `/relations`：调用顺序、同轮共现和线程内相邻调用图谱。
+
+页面只通过本机 API 查询同一个 SQLite；“同步最新历史”仍然只读 Codex rollout，并把新增事件
+写入旁路数据库。
+
+## 隐私边界
+
+数据库不保存用户消息、助手消息、推理内容、完整 shell 命令或工具输出。只保存：
+
+- Skill 名称、规范化路径和作用域；
+- 线程 ID、轮次 ID、时间戳和当时的工作目录；
+- 证据类型、源 JSONL 路径和行号；
+- 增量读取的文件偏移量。
+
+rollout 是 Codex 的本地内部格式，不是公开稳定 API。解析器对未知事件采取跳过策略，并通过
+源文件偏移量和稳定事件 ID 保证重复同步不会重复计数。
+
+为保证处理超大历史文件时内存有明确上限，单条 JSONL 记录最多读取 16 MiB；超过上限的记录
+会跳过并单独计入 `oversized_lines`，不会混入 `malformed_lines`。Skill 工具调用记录通常远小于
+该上限，但被跳过的记录不会声称已经覆盖。

package/npm/cli.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const localPython = process.platform === "win32"
+  ? path.join(packageRoot, ".venv", "Scripts", "python.exe")
+  : path.join(packageRoot, ".venv", "bin", "python");
+
+const candidates = [];
+if (process.env.CSA_PYTHON) {
+  candidates.push({ command: process.env.CSA_PYTHON, prefix: [] });
+}
+if (existsSync(localPython)) {
+  candidates.push({ command: localPython, prefix: [] });
+}
+for (const command of ["python3.13", "python3.12", "python3.11", "python3"]) {
+  candidates.push({ command, prefix: [] });
+}
+if (process.platform === "win32") {
+  for (const version of ["-3.13", "-3.12", "-3.11"]) {
+    candidates.push({ command: "py", prefix: [version] });
+  }
+  candidates.push({ command: "python", prefix: [] });
+}
+
+const versionCheck = "import sys; raise SystemExit(sys.version_info < (3, 11))";
+const python = candidates.find(({ command, prefix }) => {
+  const result = spawnSync(command, [...prefix, "-c", versionCheck], { stdio: "ignore" });
+  return result.status === 0;
+});
+
+if (!python) {
+  console.error("Codex Skill Analytics 需要 Python 3.11 或更高版本。");
+  console.error("安装新版 Python，或设置 CSA_PYTHON=/path/to/python 后重试。");
+  process.exit(1);
+}
+
+const environment = {
+  ...process.env,
+  PYTHONPATH: [path.join(packageRoot, "src"), process.env.PYTHONPATH]
+    .filter(Boolean)
+    .join(path.delimiter),
+};
+
+function pythonArgs(cliArgs) {
+  return [...python.prefix, "-m", "codex_skill_analytics.cli", ...cliArgs];
+}
+
+function runSync(cliArgs) {
+  return spawnSync(python.command, pythonArgs(cliArgs), {
+    env: environment,
+    stdio: "inherit",
+  });
+}
+
+function runInteractive(cliArgs) {
+  const child = spawn(python.command, pythonArgs(cliArgs), {
+    env: environment,
+    stdio: "inherit",
+  });
+  child.on("error", (error) => {
+    console.error(`启动失败：${error.message}`);
+    process.exitCode = 1;
+  });
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exitCode = code ?? 1;
+  });
+}
+
+const args = process.argv.slice(2);
+if (args.length === 0) {
+  console.log("正在增量同步本机 Codex Skill 调用历史…");
+  const syncResult = runSync(["sync"]);
+  if (syncResult.status !== 0) {
+    process.exit(syncResult.status ?? 1);
+  }
+  console.log("正在打开 Codex Skill Analytics…");
+  runInteractive(["serve", "--open"]);
+} else {
+  runInteractive(args);
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "codex-skill-analytics",
+  "version": "0.1.0",
+  "description": "Local, deterministic CLI and Web analytics for Codex Skill usage",
+  "type": "module",
+  "bin": {
+    "codex-skill-analytics": "npm/cli.mjs",
+    "csa": "npm/cli.mjs"
+  },
+  "files": [
+    "npm/",
+    "src/codex_skill_analytics/*.py",
+    "README.md",
+    "DESIGN.md",
+    "PRODUCT.md"
+  ],
+  "scripts": {
+    "test": "node --check npm/cli.mjs",
+    "prepack": "npm test"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NauJson/codex-skill-analytics.git"
+  },
+  "bugs": {
+    "url": "https://github.com/NauJson/codex-skill-analytics/issues"
+  },
+  "homepage": "https://github.com/NauJson/codex-skill-analytics#readme",
+  "keywords": [
+    "codex",
+    "skills",
+    "analytics",
+    "sqlite",
+    "cli"
+  ],
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/codex_skill_analytics/__init__.py

@@ -0,0 +1,4 @@
+"""Local, deterministic Codex Skill analytics."""
+
+__version__ = "0.1.0"
+