#skillpress

写给 AI 看的 skill，印成给人看的站点。

⚠️ 它今天最明显的短板：整站客户端渲染，#root 里是空壳 —— 无 JS 打不开， 搜索引擎看不到正文。预渲染还没做（PLAN.md 里记着）。另外行内图片（不独占一行的 ）会被当成一条链接，整行一条才收成图片。

#1. 我们自己的理念

#2. 快速上手

#2.1 一个 skills/ 文件夹（最常见）

# ① 在你的工程里加上 skillpress，并编一次 CLI（包里不带构建产物，所以要编这一次）
moon add XiLaiTL/skillpress
moon -C .mooncakes/XiLaiTL/skillpress build cmd/skillpress --target js

# ② 生成站点工程（写进 <内容根>/skillpress/scripts/.skillpress/）
node .mooncakes/XiLaiTL/skillpress/launcher/skillpress.mjs attach --repo . --skills ./skills

# ③ 装依赖、印内容、打包、起服务
cd skills/skillpress/scripts/.skillpress
npm install && npm run press && npm run build && npm run serve   # → http://127.0.0.1:8123/

#2.2 只有一份 skill（最小语料）

<!-- skills/alpha/SKILL.md -->
---
name: alpha
description: 一句话说清这份 skill 干什么（会出现在书架上那一行）
whenToUse: 什么时候该用它
---

# alpha

正文。标题、列表、表格、引用、围栏代码块都认；
`![图](x.png)` 要**独占一行**才会被收成图片。

<!-- skills/skillpress/WEBSITE.md —— 站点首页的源：H1 = 站名，第一个 ## 之前 = 首屏 -->
# 我的站

一句话说明这堆 skill 是干什么的。

## [从哪一份开始](../alpha/SKILL.md)

点这一栏会**直接渲染**目标那一页（纯链接节）。

#2.3 看一眼站点 + 日常改内容

npm run serve            # http://127.0.0.1:8123/
npm run press:check      # 门：产物与现跑逐字节一致吗（改了内容忘了 press，它会红并指出第一处差异）
npm run build            # 默认 **prod 档**（minify）；开发用 `npm run build:dev`
node verify.mjs          # 站点判据：真 Chrome 无头 + 自起服务，23 条（要一次 native 编译）

#3. 项目实例

#4. 基本原理

   你的内容源（普通 markdown）       skills/<name>/SKILL.md + references/*.md
        │                            + 可选的首页源 skillpress/WEBSITE.md
        │  press：一次解析
        ▼
   三件产物   content/content.generated.mbt（站点的内容值）
        │     llms.txt（给 agent 的整站索引）
        │     md/**（每页原文，逐字节拷贝）+ img/**（内容里的图）
        │
        │  构建期：语法高亮（tree-sitter）已经算好，色号跟着一起进内容包
        ▼
   站点（一个 moobile 应用：TEA 的 Model/Msg/update/view）
        │  顶栏 / 书架树 / 文档页 / 右栏目录 / 搜索浮层 / 主题 / hash 路由
        ▼
   React 元素（react-native-web）──► 浏览器 DOM ──► dist/（静态站点）

1. 只做投影，不做 CMS —— 内容源是唯一真源，站点是产物，删了能重印。
2. 构建期能算的就不放到运行期 —— 高亮、目录锚点、页序、搜索词表都在 press/build 里算完。
3. 一个事实一个副本 —— 三件产物同源；同一件事要是有两份实现，迟早分叉（本仓为此删过不少"顺手再来一遍"）。
4. 判据是进程边界，不是仓库内外 —— 纯文本变换写成 .mbtx，碰进程的（起服务、开 Chrome）留 .mjs。
5. 不静默 —— 认不出的构造点名、产物不一致指出第一处差异、找不到程序根直接报错不猜。

#5. 能力边界与诚实清单

#6. 例子、文档与贡献

仓库里若见到 lib/xxx.mjs / bin/skillpress.mjs，那是历史坐标（迁移记录里的出处）， 活实现已在 engine/** / cmd/**；迁移的完整账在 PLAN.md 的 D40–D46。

#7. 许可证与第三方