@monkey-mini-app/dsh-mini-app 0.1.0 → 0.1.4

package/skills/monkey-mini-app/references/icons.md

@@ -1,83 +1,113 @@
 # Icons
 
-`import { Icon } from "@monkey-mini-app/ui"` — 一个 `Icon` 命名空间（来自 lucide）。`Icon.<Name>` 接受**任意 lucide React 组件名**（大驼峰）。下面是**常用推荐子集**，按用途分组、一句话告诉你什么时候用；没列到的按 lucide 命名规则也能用（如 `Icon.IconName`）。
+`import { Icon } from "@monkey-mini-app/ui"` — a single `Icon` namespace (lucide). `Icon.<Name>` accepts **any lucide React component name** (PascalCase). Below is a **curated subset**, grouped by purpose with a one-line note on when to reach for it; anything not listed still works by lucide's naming rule (`Icon.IconName`).
 
 ```tsx
 import { Icon } from "@monkey-mini-app/ui";
 <Icon.Search size={16} strokeWidth={2} />
 ```
 
-## 操作
-| 名字 | 何时用 |
+Icon-only buttons must carry an accessible name: `<Button size="icon" aria-label="Refresh"><Icon.RefreshCw /></Button>`.
+
+## Actions
+
+| Name | Use for |
 |---|---|
-| `Plus` / `Minus` | 添加 / 减少 |
-| `X` | 关闭、清除 |
-| `Check` / `CheckCircle2` | 完成、成功 |
-| `Trash2` | 删除 |
-| `Pencil` / `PenLine` | 编辑、重命名 |
-| `Copy` / `Clipboard` | 复制 |
-| `Download` / `Upload` | 下载 / 上传 |
-| `RefreshCw` | 刷新、重新拉取 |
-| `Send` | 提交、发送 |
-| `ExternalLink` | 打开新窗口 |
-| `Link` | 复制链接 |
-
-## 导航
-| 名字 | 何时用 |
+| `Plus` / `Minus` | Add / remove |
+| `X` | Close, clear |
+| `Check` / `CheckCircle2` | Done, success |
+| `Trash2` | Delete |
+| `Pencil` / `PenLine` | Edit, rename |
+| `Copy` / `Clipboard` | Copy |
+| `Download` / `Upload` | Download / upload |
+| `RefreshCw` | Refresh, re-fetch |
+| `Send` | Submit, send |
+| `ExternalLink` | Open in a new window |
+| `Link` | Copy link |
+
+## Navigation
+
+| Name | Use for |
 |---|---|
-| `ChevronRight` / `ChevronLeft` | 进入/展开 或 返回 |
-| `ChevronDown` / `ChevronUp` | 折叠/展开 |
-| `ChevronsUpDown` | 可排序 |
-| `ArrowUpRight` | 外链、跑分增长 |
-| `ArrowLeftRight` / `ArrowUpDown` | 切换、传输 |
-| `MoreHorizontal` | 更多菜单 |
-
-## 状态
-| 名字 | 何时用 |
+| `ChevronRight` / `ChevronLeft` | Enter / expand, or back |
+| `ChevronDown` / `ChevronUp` | Collapse / expand |
+| `ChevronsUpDown` | Sortable column |
+| `ArrowUpRight` | External link, score went up |
+| `ArrowLeftRight` / `ArrowUpDown` | Swap, transfer |
+| `MoreHorizontal` | Overflow menu |
+
+## Status
+
+| Name | Use for |
 |---|---|
-| `Bell` / `BellOff` | 通知 / 免打扰 |
-| `Eye` / `EyeOff` | 显示 / 隐藏敏感值 |
-| `Info` | 信息提示 |
-| `AlertCircle` / `TriangleAlert` | 警告 |
-| `Loader2` / `LoaderCircle` | 加载中（配 animate） |
-| `HelpCircle` | 帮助 |
-| `BadgeCheck` | 已验证、通过 |
-| `Star` / `Heart` | 收藏 / 喜欢 |
-
-## 内容 & 输入
-| 名字 | 何时用 |
+| `Bell` / `BellOff` | Notifications / muted |
+| `Eye` / `EyeOff` | Show / hide a secret |
+| `Info` | Informational hint |
+| `AlertCircle` / `TriangleAlert` | Warning |
+| `Loader2` / `LoaderCircle` | In progress (pair with an animate class) |
+| `HelpCircle` | Help |
+| `BadgeCheck` | Verified, passed |
+| `Star` / `Heart` | Favourite / like |
+
+## Content & input
+
+| Name | Use for |
 |---|---|
-| `Search` | 搜索框 |
-| `Filter` | 筛选 |
-| `SlidersHorizontal` | 高级筛选、设置参数 |
-| `CalendarDays` | 日期 |
-| `Clock` / `History` | 时间 / 历史 |
-| `Tag` | 标签、分类 |
-| `File` / `FileText` | 文件 / 文档 |
-| `Folder` / `FolderOpen` | 目录 |
-| `Image` | 图片 |
-| `List` / `ListOrdered` | 列表 / 有序列表 |
-| `Hash` | 编号、话题 |
-| `Code2` / `Terminal` | 代码 / 命令行 |
-
-## 系统 & 监控
-| 名字 | 何时用 |
+| `Search` | Search box |
+| `Filter` | Filter |
+| `SlidersHorizontal` | Advanced filter, tuning parameters |
+| `CalendarDays` | Date |
+| `Clock` / `History` | Time / history |
+| `Tag` | Label, category |
+| `File` / `FileText` | File / document |
+| `Folder` / `FolderOpen` | Directory |
+| `Image` | Image |
+| `List` / `ListOrdered` | List / ordered list |
+| `Hash` | Identifier, topic |
+| `Code2` / `Terminal` | Code / command line |
+
+## System & monitoring
+
+| Name | Use for |
 |---|---|
-| `Activity` / `Zap` | 实时活动、性能 |
-| `Gauge` / `BarChart3` | 指标、大盘 |
-| `Server` / `Database` | 服务、数据存储 |
-| `HardDrive` / `Cpu` / `MemoryStick` | 磁盘 / CPU / 内存 |
-| `Cloud` / `Network` / `Globe` / `Wifi` | 网络、云、外部服务 |
-| `TrendingUp` / `TrendingDown` | 涨 / 跌 |
-| `GitBranch` / `GitMerge` / `GitPullRequest` | git 分支、合并、PR |
-| `Rocket` | 发布、上线 |
-
-## 媒体 / 用户 / 设置
-| 名字 | 何时用 |
+| `Activity` / `Zap` | Live activity, performance |
+| `Gauge` / `BarChart3` | Metrics, overview |
+| `Server` / `Database` | Service, storage |
+| `HardDrive` / `Cpu` / `MemoryStick` | Disk / CPU / memory |
+| `Cloud` / `Network` / `Globe` / `Wifi` | Network, cloud, external services |
+| `TrendingUp` / `TrendingDown` | Up / down |
+| `GitBranch` / `GitMerge` / `GitPullRequest` | Git branch, merge, PR |
+| `Rocket` | Release, ship |
+
+## Media / user / settings
+
+| Name | Use for |
+|---|---|
+| `Play` / `Pause` | Play / pause |
+| `Music2` / `Video` / `Mic` / `Camera` | Audio, video |
+| `Settings` / `Settings2` | Settings |
+| `Mail` / `MessageSquare` | Mail / comment |
+| `Lock` / `Unlock` / `KeyRound` | Permission, secret |
+| `Home` | Home |
+
+## Empty-state illustrations (`Illu*`)
+
+**Exactly these 10 names** (unDraw sources, tokenised so they follow `--primary` / `--muted`). Unlike lucide, these cannot be guessed — if a name is not in this list, fall back to an `Icon` plus text.
+
+```tsx
+import { IlluEmpty } from "@monkey-mini-app/ui";
+<IlluEmpty className="mx-auto w-40" />
+```
+
+| Name | Use for |
 |---|---|
-| `Play` / `Pause` | 播放 / 暂停 |
-| `Music2` / `Video` / `Mic` / `Camera` | 音视频 |
-| `Settings` / `Settings2` | 设置 |
-| `Mail` / `MessageSquare` | 邮箱 / 评论 |
-| `Lock` / `Unlock` / `KeyRound` | 权限、密钥 |
-| `Home` | 首页 |
+| `IlluEmpty` | Generic empty list / first run with no data |
+| `IlluNoData` | A filter is applied and the result is empty |
+| `IlluSearch` | Search returned nothing |
+| `IlluLoading` | First load / placeholder |
+| `IlluServerStatus` | Service unavailable, fetch failed |
+| `IlluAccessDenied` | No permission / secret missing |
+| `IlluPageNotFound` | Target missing, stale id |
+| `IlluDataProcessing` | Background job running (pair with `scanStatus`) |
+| `IlluBugFixing` | Error state, empty failure detail |
+| `IlluCodeReview` | Diff / review empty state |

package/skills/monkey-mini-app/references/llm-json.md

@@ -1,21 +1,21 @@
-# 结构化 JSON（`ctx.llm` / `ctx.agent` + `opts.schema`）
+# Structured JSON (`ctx.llm` / `ctx.agent` + `opts.schema`)
 
-需要对象/数组时走这条，不要自己试各种「请只输出 JSON」。
+When you need an object or an array, use this path — do not experiment with "please output JSON only" phrasings.
 
-## 契约（llm 与 agent 对齐）
+## Contract (identical for llm and agent)
 
-| | 说明 |
-|--|------|
-| 入口 | `ctx.llm(prompt, { schema })` **或** `ctx.agent(goal, { schema })` |
-| 返回 | **始终是 string**；给了 `schema` 时宿主会要求模型只回 JSON，并尽量剥掉 markdown/前言 |
-| App 侧 | `JSON.parse(raw)`；失败就 throw，不要当业务文案展示 |
-| 不是什么 | **不是**默认每次结构化；**不是** provider 原生 JSON mode / schema 校验重试（二期可加强） |
+| | |
+|--|--|
+| Entry | `ctx.llm(prompt, { schema })` **or** `ctx.agent(goal, { schema })` |
+| Returns | **Always a string that `JSON.parse` accepts** — the host asks for JSON only, strips fences/preambles, retries what a retry can fix, and raises if nothing parses |
+| In your app | `JSON.parse(raw)`; it is not a question of *whether* the text is JSON, only of whether the fields match — validate those yourself |
+| It is not | Provider-native JSON mode, and **not** full schema validation: the host checks that the answer *parses*, plus nothing about your `required` / `type` / enum shape |
 
-`schema` 用普通 JSON Schema 对象（至少 `type` + `properties` / `items`）。提示宜短：任务说清楚 + 把约束交给 `schema`，不必再堆「不要解释」。
+`schema` is a plain JSON Schema object (at least `type` + `properties` / `items`). Keep the prompt short: state the task, put the constraints in `schema` instead of stacking "no explanation" lines.
 
-## `ctx.llm` 例子
+## `ctx.llm` example
 
-完整 RSS + `./lib` + schema 见 `templates/insights/`。
+Full RSS + `./lib` + schema in `templates/radar/`.
 
 ```ts
 const SCHEMA = {
@@ -27,15 +27,15 @@ const SCHEMA = {
   required: ["headline", "bullets"],
 };
 
-const raw = await ctx.llm("写一条中文 headline，以及恰好 3 条中文 bullets。不要前言。", {
+const raw = await ctx.llm("One headline and exactly 3 bullets, in the user's language. No preamble.", {
   schema: SCHEMA,
 });
 const digest = JSON.parse(raw);
 ```
 
-## `ctx.agent` 例子
+## `ctx.agent` example
 
-适合「多步工具/推理后再收成结构化结果」。仍返回 string。若还要过程时间线，同一调用加 `onEvent`（形状见 [ctx.md](ctx.md)）。
+For "reason / use tools over several steps, then return a structured result". Still a string. Need the process timeline too? Add `onEvent` to the same call (shapes in [ctx.md](ctx.md)).
 
 ```ts
 const INSIGHT_SCHEMA = {
@@ -49,7 +49,7 @@ const INSIGHT_SCHEMA = {
 };
 
 const raw = await ctx.agent(
-  "根据下面材料给出对独立开发者的洞察：风险列表 + 下一步建议。\n" + materials,
+  "From the material below, give insights for an independent developer: risks + a next step.\n" + materials,
   { schema: INSIGHT_SCHEMA },
 );
 const insight = JSON.parse(raw);
@@ -57,13 +57,26 @@ await ctx.storage.set("insight", insight);
 return insight;
 ```
 
-与 llm 一样：`schema` 可选；自然语言最终句不必传 `schema`。
-
-## 宿主实际做了什么（实现提示）
-
-1. `withJsonInstruction`：把 schema 写进约束（llm → stream 的 `system`；agent → one-shot followup 文本）  
-2. 模型生成  
-3. `coerceSchemaJson`：去掉 \`\`\`json 围栏 / 前言，尽量抽出 `{…}` / `[…]`  
-4. App `JSON.parse`
-
-校验失败时 **不会**自动重试；该 throw 就 throw，让 UI 显示错误。
+Same as llm: `schema` is optional, and for a natural-language final answer you do not pass one.
+
+## What the host actually does
+
+1. `withJsonInstruction`: writes the schema into the constraints (llm → the stream's `system`; agent → the one-shot follow-up text)
+2. The model generates
+3. `coerceSchemaJson`: drops ```` ```json ```` fences / preambles and extracts `{…}` / `[…]` as well as it can
+4. Your app calls `JSON.parse`
+
+## What the host guarantees, and what it costs
+
+- `ctx.llm` tries up to **`retryTimes`** times (default 3 total). A retry happens only for
+  something retrying can fix: the call failed / answered nothing, or the answer did not parse.
+- From the second try on, the model is shown *why* the previous answer was rejected, including the
+  start of it — a blind re-roll just reproduces the same truncated object.
+- If nothing parses, you get `HostError` `code: "LLM_JSON_INVALID"` (or `LLM_RETRY_EXHAUSTED` if
+  the model never answered at all). Its message lists every attempt; `err.attempts` carries them
+  structured (`kind`, `error`, `bytes`, `head`). Nothing about the model's output is hidden — the
+  rejected samples are in there, which is what lets you fix the prompt instead of guessing.
+- Output is capped at **`maxTokens` (default 4096)**. A schema asking for many items can still be
+  truncated at the ceiling, so for wide arrays set it yourself rather than widening the schema.
+- `ctx.agent` defaults to **1 attempt**, because a turn may already have posted a comment or pushed
+  a build — replaying it repeats that. Pass `retryTimes` only when your steps are idempotent.

package/skills/monkey-mini-app/references/loader.md

@@ -1,30 +1,57 @@
 # Loader
 
-Host 在服务端即时编译：**后端**用 sucrase 编译 `main.api.ts` / `lib/*.ts`；**前端 UI** 用 esbuild-wasm 把 `ui.tsx` 连同用到的组件打包成单个 ESM bundle（tree-shake，按 app 裁剪组件库）。
+The host compiles on the fly, server side: the **backend** (`main.api.ts` + its relative imports) goes through sucrase; the **UI** (`ui.tsx` + its relative imports) is bundled to a single ESM file with esbuild (tree-shaken, so only the components you use are included).
 
-## 后端（main.api.ts / lib/*.ts）
+## Layout
 
-- `import { defineDashboard } from "@monkeyagent/dashboard"`
-- `import { foo } from "./lib/foo"`（也可 `./components/...`）
-- TypeScript 随意（sucrase：参数类型、`{ title: string }`、`catch (e: any)` 都可以）
-- `export default defineDashboard(...)`
-- `lib/` 里 `export function` / `export const` / `export async function`
+```
+manifest.json
+ui.tsx              UI entry
+main.api.ts         backend entry
+ui/                 components / hooks / view helpers — UI only
+api/                backend helpers — backend only
+shared/             pure isomorphic code — both sides
+```
 
-## 前端（ui.tsx）
+The three folders are the convention that keeps the two runtimes from reaching into each
+other's code; a trivial app with no helpers needs none of them. **`ui/` and `api/` are
+enforced at compile time**, not style advice:
 
-- `import { Button, DataGrid, ... } from "@monkey-mini-app/ui"` —— 组件库（已内置图标/图表/编辑器依赖，不要额外 import npm 包）
-- `import { useDashboardApi } from "@monkeyagent/host"` —— host 注入的 hook，只返回 `{ call }`
-- `import { useState } from "react"` —— React 19（host 注入）
-- `import { foo } from "./lib/foo"` —— 相对 app 内文件，随 bundle 一起打包
-- 布局用 Tailwind classes（`flex flex-col gap-3` 等）
+- UI importing `./api/**` → compile error
+- backend importing `./ui/**` → load error
+- either side importing outside the app dir (`../…`) → error
 
-## 禁止（编译即报错，不要绕）
+Anything that both sides need belongs in `shared/` — which means pure code: no React, no
+DOM, no `ctx`, no Node builtins.
 
-- npm 包：`recharts`、`lucide-react`、`rss-parser`、`openai`、`node-fetch`…（组件库已内置）
-- Node 内置：`fs`、`http`、`path`…
-- 逃出 app 目录的 `../` 出界（前端 `./lib` 同理）
-- UI `import main.api.ts`（要数据走 `call`）
+## Backend (`main.api.ts`, `api/**`, `shared/**`)
 
-抓网页用 `ctx.http("https://…", { timeout: 8000 })`，看 `r.ok` / `r.text` / `r.json`；解析写在 `./lib`。本机命令才 `ctx.bash`。
+- `import { defineApp } from "@monkey-mini-app/api"`; the host injects the runtime `defineApp` when it loads the file, so nothing React-ish is pulled into the backend
+- `import { groupBy, debounce } from "lodash"` (or `lodash-es`) — full lodash, host-injected; same module as the UI vendor bundle
+- A Node library this app genuinely needs: `mini_app_install({ appId, packages: [{ name: "exceljs" }] })` first, then `import ExcelJS from "exceljs"`. It lands in **this app's** `node_modules` (`--ignore-scripts`, lockfile committed, `node_modules` not). `package.json` in the app dir is owned by that tool — do not hand-write it. Anything outside the app's own `node_modules` (the plugin's, the repo's) is refused.
+- `import { parseFeed } from "./api/feed"`, `import { SAMPLE } from "./shared/sample"` — any relative path inside the app dir; subfolder names beyond the convention above are up to you
+- TypeScript freely (sucrase: parameter types, `{ title: string }`, `catch (e: any)` all fine)
+- `export default defineApp(...)`
+- In helper modules: `export function` / `export const` / `export async function`
 
-改 `ui.tsx` / `main.api.ts` / `lib/*.ts` 会按 mtime 重新编译。RSS + lib 完整例子见 `templates/insights/`。
+## Frontend (`ui.tsx`, `ui/**`, `shared/**`)
+
+- `import { useApp, Button, DataGrid, cn, ... } from "@monkey-mini-app/ui"` — components, `useApp`, `cn`, `Icon`, `Illu*` all come from here (icon/chart/editor dependencies are already inside; never add an npm import)
+- `import { useState } from "react"` — React 19, injected by the host (`/mma/runtime.js`)
+- `import { groupBy, debounce } from "lodash"` — platform vendor (`/mma/vendors/lodash.js`); not a kit re-export
+- `import { fmt } from "./shared/format"` — app-relative, bundled with the UI
+- Layout via Tailwind classes (`flex flex-col gap-3`, …)
+
+UI: `@monkey-mini-app/ui` + `react` + `lodash`. Backend: `@monkey-mini-app/api` + `lodash` + packages installed by `mini_app_install`. Nothing else resolves — pre-unification names fail to compile. Rewrite them; do not work around them.
+
+## Forbidden (compile error — do not work around it)
+
+- npm packages: `recharts`, `lucide-react`, `rss-parser`, `openai`, `node-fetch`, `axios`, `ramda`, `dayjs`, … in `ui.tsx` (`lodash` is the exception — platform vendor, full API; backend-only libs go through `mini_app_install`)
+- Node builtins: `fs`, `http`, `path`, …
+- `../` escaping the app directory (both sides)
+- UI ↔ `api/**`, backend ↔ `ui/**` (see Layout)
+- UI importing `main.api.ts` (fetch data with `call`)
+
+Fetch web content with `ctx.http("https://…", { timeout: 8000 })` and inspect `r.ok` / `r.text` / `r.json`; keep parsing in `api/`. Local machine commands use `ctx.bash`.
+
+Editing `ui.tsx` / `main.api.ts` or any helper module under the app dir triggers a recompile by mtime. A full RSS + `shared/` example lives in `templates/radar/`.

package/skills/monkey-mini-app/references/looks/aurora-bento.md

@@ -0,0 +1,88 @@
+<!-- generated by scripts/gen/skill — do not edit -->
+
+# Aurora Bento
+
+Also known as `极光便当` (sample product copy).
+
+id: `aurora-bento` · grammar: `tessellation`
+
+**When:** Launcher / overview. The page is a 6×3 tessellation, every cell a destination.
+
+**Not:** A lock-screen home. No sky, no poster layer.
+
+**How to copy it:** A flat `bg-muted` ground turns this into an admin dashboard — the aurora IS the look. Three hue pools mixed out of the palette's own primary (toward --foreground for depth, toward --destructive for a warm drift) so no colour literal appears in ui.tsx, and they stay TIGHT (40-50% radii) so they read as light sources rather than a wallpaper wash. Cap the grid (`max-w-5xl mx-auto`) and gap it: an edge-to-edge tile wall hides the field, and the field is the look. Write spans out (`col-span-2`), never `sm:col-span-*` — the panel width is user-dragged. Tiles are OPAQUE and raised (contact + lift shadow): translucent tiles would collide with glass-island. The hero tile inverts to `bg-foreground text-background`. Every tile is a destination, never a stat readout. Light and dark may carry different hue families — this look's palette is indigo-violet by day, aurora green by night.
+
+## Style (inline — Tailwind drops multi-layer shadows)
+
+```tsx
+const GLASS = {
+  "ground": "tight radial pools: --primary 92% (top-left), --primary mixed --foreground (top-right), --primary mixed --destructive (bottom) — token-derived, no literals",
+  "RAISED": {
+    "boxShadow": "0 1px 2px color-mix(in oklch, var(--foreground) 14%, transparent), 0 14px 30px -14px var(--shadow)"
+  }
+} as const;
+```
+
+## Classes (copy literals)
+
+- `root`: `mx-auto grid w-full max-w-5xl grid-cols-6 gap-2.5 (spans written out, no sm:)`
+- `tile`: `bg-card relative rounded-2xl p-3 overflow-hidden + style={RAISED}`
+- `hero`: `bg-foreground text-background col-span-2 row-span-2 rounded-2xl p-4`
+
+## Palette (optional `theme.css` in the app dir)
+
+This look's identity depends on hue, so it ships a palette. Writing it to `theme.css`
+makes the app use it by default (ThemePop lists it as the row tagged **`本应用`**); the user can still
+pick a host palette. Omit the file to follow the host palette instead.
+
+```css
+/* name: 极光便当 */
+/* Look-owned palette: the ground is an aurora, so the hue IS the identity. Light is the
+   indigo-violet field (A1), dark the graphite aurora-green (A2) — the lab picked the best
+   side of each; a palette file has two blocks, so that is legal and reads intentional. */
+:root[data-mode="light"] {
+  --bg: #c9cdf1;
+  --fg: #20213a;
+  --surface: #ffffff;
+  --surface-fg: #20213a;
+  --border: #c2c6e8;
+  --muted: #dfe2f5;
+  --muted-fg: #565a7e;
+  --primary: #6d5ae0;
+  --primary-fg: #ffffff;
+  --secondary: #e2e4f6;
+  --secondary-fg: #20213a;
+  --accent: #e9e3fb;
+  --accent-fg: #20213a;
+  --destructive: #c0392b;
+  --destructive-fg: #ffffff;
+  --ring: #6d5ae0;
+  --input: #c2c6e8;
+  --radius: 16px;
+  --shadow: rgba(35, 30, 90, 0.35);
+}
+:root[data-mode="dark"] {
+  --bg: #0e1512;
+  --fg: #dff2e8;
+  --surface: #141d19;
+  --surface-fg: #dff2e8;
+  --border: #1e2c25;
+  --muted: #101f19;
+  --muted-fg: #6f9784;
+  --primary: #3ee39a;
+  --primary-fg: #06140d;
+  --secondary: #16241d;
+  --secondary-fg: #dff2e8;
+  --accent: #13281f;
+  --accent-fg: #dff2e8;
+  --destructive: #ff6b5e;
+  --destructive-fg: #14060a;
+  --ring: #3ee39a;
+  --input: #1e2c25;
+  --radius: 16px;
+  --shadow: rgba(0, 0, 0, 0.55);
+}
+```
+
+
+Tokens only — no hex in `ui.tsx`. Light and dark must both read. Optional `data-look` on a root is a recipe, not a platform attribute.

package/skills/monkey-mini-app/references/looks/desk-split.md

@@ -0,0 +1,89 @@
+<!-- generated by scripts/gen/skill — do not edit -->
+
+# Desk Split
+
+Also known as `精致分栏` (sample product copy).
+
+id: `desk-split` · grammar: `list-detail`
+
+**When:** CRUD, tickets, contacts, ledgers. Two panes, hairline, dense toolbar.
+
+**Not:** Marketing pages, lock-screen homes.
+
+**How to copy it:** The desk IS the palette: walnut `bg-background`, cream papers (`bg-card`) in BOTH modes — lamp-lit paper on a dark desk is the look; dark papers on wood read as mud. All ink (`foreground`) is dark in both modes and only ever lands on paper: chrome text (headers, captions) goes inside a paper strip, never directly on the wood. Wood grain = repeating stripe bands; one warm lamp pool from `--primary`; titles in ui-serif for the desk feel.
+
+## Style (inline — Tailwind drops multi-layer shadows)
+
+```tsx
+const GLASS = {
+  "backgroundImage": "repeating-linear-gradient(90deg, fg 5% 2px stripes / 96px bands), radial lamp pool from --primary at top-left, vignette at bottom",
+  "paper": {
+    "backgroundColor": "var(--card)",
+    "boxShadow": "0 1px 2px fg/24, 0 18px 44px -18px var(--shadow), inset 0 1px 0 card/72",
+    "borderColor": "fg/12"
+  }
+} as const;
+```
+
+## Classes (copy literals)
+
+- `root`: `relative h-full min-h-0 bg-background (walnut wood, DESK wash overlay)`
+- `pane`: `cream paper: bg-card, hairline edge, contact + lift shadow, top highlight (PAPER)`
+
+## Palette (optional `theme.css` in the app dir)
+
+This look's identity depends on hue, so it ships a palette. Writing it to `theme.css`
+makes the app use it by default (ThemePop lists it as the row tagged **`本应用`**); the user can still
+pick a host palette. Omit the file to follow the host palette instead.
+
+```css
+/* name: 桌面分栏 */
+/* Look-owned palette: walnut desk + amber desk-lamp. The papers are cream in BOTH modes —
+   a dark desk with lamp-lit paper is the desk; dark papers would read as mud. All ink is
+   dark in both modes for the same reason, so `--foreground` is never painted on the wood. */
+:root[data-mode="light"] {
+  --bg: #8a6845;
+  --fg: #33260f;
+  --surface: #faf5ea;
+  --surface-fg: #33260f;
+  --border: #6b4f2c;
+  --muted: #ebdfc6;
+  --muted-fg: #74603f;
+  --primary: #a8741c;
+  --primary-fg: #fdf6e7;
+  --secondary: #efe3c8;
+  --secondary-fg: #33260f;
+  --accent: #e9d9b4;
+  --accent-fg: #33260f;
+  --destructive: #a13d2d;
+  --destructive-fg: #fff8ee;
+  --ring: #c98f2e;
+  --input: #c7ab7d;
+  --radius: 12px;
+  --shadow: rgba(48, 32, 12, 0.42);
+}
+:root[data-mode="dark"] {
+  --bg: #2f2311;
+  --fg: #2e2113;
+  --surface: #f0e6cf;
+  --surface-fg: #2e2113;
+  --border: #7a5a30;
+  --muted: #e2d5b8;
+  --muted-fg: #5f4d30;
+  --primary: #a8741c;
+  --primary-fg: #fdf6e7;
+  --secondary: #e6d9b6;
+  --secondary-fg: #2e2113;
+  --accent: #dfcf9f;
+  --accent-fg: #2e2113;
+  --destructive: #b04938;
+  --destructive-fg: #fff3ec;
+  --ring: #d9a643;
+  --input: #e2d3ae;
+  --radius: 12px;
+  --shadow: rgba(8, 5, 1, 0.6);
+}
+```
+
+
+Tokens only — no hex in `ui.tsx`. Light and dark must both read. Optional `data-look` on a root is a recipe, not a platform attribute.

package/skills/monkey-mini-app/references/looks/editorial.md

@@ -0,0 +1,78 @@
+<!-- generated by scripts/gen/skill — do not edit -->
+
+# Editorial
+
+Also known as `编辑排版` (sample product copy).
+
+id: `editorial` · grammar: `prose-measure`
+
+**When:** Weekly digest, insights, runbook, help. Type hierarchy, hairline rules, almost no cards.
+
+**Not:** Monitor walls, dense tables.
+
+**How to copy it:** Paper and ink are the identity: under the default palette this look is just text on white and reads unfinished, so it ships a theme.css (newsprint + vermilion by day, cool night-reading stock + ultramarine by night). Keep the measure near 65ch, use hairlines (`border` / `Separator`) instead of cards, one accent only for links and emphasis, `font-serif` for display, and `first-letter:` for a drop cap. Radius stays small — this look is type and rules, not tiles.
+
+## Classes (copy literals)
+
+- `root`: `mx-auto max-w-2xl px-6 py-8`
+- `kicker`: `text-xs tracking-[0.2em] uppercase text-muted-foreground`
+- `display`: `font-serif text-3xl font-bold tracking-tight`
+
+## Palette (optional `theme.css` in the app dir)
+
+This look's identity depends on hue, so it ships a palette. Writing it to `theme.css`
+makes the app use it by default (ThemePop lists it as the row tagged **`本应用`**); the user can still
+pick a host palette. Omit the file to follow the host palette instead.
+
+```css
+/* name: 编辑排版 */
+/* Look-owned palette: paper and ink are the identity — under the default kit palette the
+   page is just text and reads as "unfinished". Light is newsprint with vermilion (E1),
+   dark is cool night-reading stock with ultramarine (E2). Radius is small: this look is
+   rules and type, not cards. */
+:root[data-mode="light"] {
+  --bg: #f6f2e9;
+  --fg: #1c1a16;
+  --surface: #fffdf7;
+  --surface-fg: #1c1a16;
+  --border: #e0d9c9;
+  --muted: #ece5d6;
+  --muted-fg: #6d675c;
+  --primary: #c0402a;
+  --primary-fg: #fff8f5;
+  --secondary: #efe8da;
+  --secondary-fg: #1c1a16;
+  --accent: #f1e9d9;
+  --accent-fg: #1c1a16;
+  --destructive: #8f2d22;
+  --destructive-fg: #fff4f1;
+  --ring: #c0402a;
+  --input: #d9d2c2;
+  --radius: 6px;
+  --shadow: rgba(60, 50, 30, 0.18);
+}
+:root[data-mode="dark"] {
+  --bg: #14161a;
+  --fg: #e8eaee;
+  --surface: #191c22;
+  --surface-fg: #e8eaee;
+  --border: #262a31;
+  --muted: #1d2128;
+  --muted-fg: #9aa0aa;
+  --primary: #7f95f5;
+  --primary-fg: #0f1216;
+  --secondary: #1d2128;
+  --secondary-fg: #e8eaee;
+  --accent: #1a2030;
+  --accent-fg: #e8eaee;
+  --destructive: #ff6b63;
+  --destructive-fg: #14060a;
+  --ring: #7f95f5;
+  --input: #2a2d31;
+  --radius: 6px;
+  --shadow: rgba(0, 0, 0, 0.5);
+}
+```
+
+
+Tokens only — no hex in `ui.tsx`. Light and dark must both read. Optional `data-look` on a root is a recipe, not a platform attribute.