Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

offline-divination-app

/offline-divination-app

Buduje w pełni offline aplikację do tarota, układów i zestawień BaZi oraz pakuje ją jako natywną aplikację iOS lub Android.

Repozytorium
agent-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
04.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
15
Skrypty
6
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 04.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 6 skryptów w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: assets/scaffold/assets/js/app.js, assets/scaffold/assets/js/data/spreads.js, assets/scaffold/assets/js/data/tarot.js, assets/scaffold/assets/js/engine/divination.js, scripts/check_offline.py, scripts/scaffold.py

Co robi i kiedy

Buduje w pełni offline aplikację do tarota, układów i zestawień BaZi oraz pakuje ją jako natywną aplikację iOS lub Android.

Oryginalny opis (EN)

从零搭建完全离线的占卜类应用(塔罗抽牌、牌阵解读、八字五行合参),并打包为可上架的 iOS/Android 原生 App。当用户说「做一个占卜 App」「开发塔罗占卜工具」「合作运势测算工具」「要能离线在手机上用」或需要在不联网环境下运行命理、占卜、合盘类应用时使用。

Jak działa

  1. 何时用这个 skill
  2. 五步工作流
  3. 三条不可妥协的红线
  4. 常见翻车点
  5. 参考文件
  6. 脚本
Sekcje z nagłówków SKILL.md, w oryginale · 110 linii, 315 słów
Podgląd SKILL.md
---
name: offline-divination-app
description: 从零搭建完全离线的占卜类应用(塔罗抽牌、牌阵解读、八字五行合参),并打包为可上架的 iOS/Android 原生 App。当用户说「做一个占卜 App」「开发塔罗占卜工具」「合作运势测算工具」「要能离线在手机上用」或需要在不联网环境下运行命理、占卜、合盘类应用时使用。
agent_created: true
---

# 离线占卜 App 构建

做一个**断网可用、数据不出手机、可商用闭源**的占卜类 App。核心不是"调用某个占卜 API",而是把占卜拆成两层:**可离线计算的确定性层**(抽牌、排盘、历法)与**可离线运行的解读层**(静态文案库 + 规则引擎)。云端 AI 只做可选的锦上添花,绝不能成为主链路依赖。

## 何时用这个 skill

触发场景:

- 「做一个塔罗占卜 App」「开发一个占卜工具」「合作/感情合盘工具」
- 「能不能离线运行」「飞行模式也要能用」「数据不要上传」
- 「帮我打包成手机上能装的 App」,且内容属占卜、命理、运势、合盘类

**不适用**:需要实时行情/联网数据的应用;纯占卜文案创作(不涉及工程实现);已有 App 只改一处 UI。

## 五步工作流

按顺序走,每一步都有明确的产出物。跳步会在后面付出更大代价。

### 第 1 步:先定形态与解读层,别急着写代码

必须与用户确认两件事,缺一不可:

| 决策 | 选项 | 建议默认 |
|---|---|---|
| 载体形态 | HTML5 单文件/浏览器 → PWA → 原生 App | **Capacitor 包装**:先纯 Web 跑通,再套壳上架,一套代码两端可用 |
| 解读方式 | 离线规则 / 离线为主+联网增强 / 端侧小模型 | **离线规则为主**,联网仅可选;端侧模型体积大、中文命理质量不可控 |

把这两条写进对话确认后再动手。用户若说"要真正的 AI 智能解读",要如实说明:**离线与"通用大模型级智能"不可兼得**,只能规则兜底 + 联网增强。

### 第 2 步:查依赖许可证(这一步能救整个产品)

在 `npm install` 之前,逐个核查:

```bash
npm view <包名> version license dependencies
```

**凡是 AGPL / GPL,一律不引入闭源分发的 App。** 详见 `references/licensing.md`(含真实踩坑案例与 MIT 白名单)。

### 第 3 步:搭四层结构

```
assets/
├── js/vendor/     第三方库本地化(复制进仓库,不用 CDN)
├── js/data/       静态数据层:牌库、牌阵、五行表
├── js/engine/     纯函数引擎:抽牌、解读、评分、动效
└── js/ai/         可选增强层(未配置时必须静默降级)
```

铁律:**vendor 里的库必须是本地文件**。任何 `https://cdn...` 引用都会让"离线"变成假离线。细节见 `references/architecture.md`。

### 第 4 步:写数据层与规则引擎

占卜的"智能"来自**数据颗粒度**,不是算法复杂度。牌库字段设计、牌阵定义、评分规则、文案组合逻辑,见:

- `references/tarot-engine.md` —— 78 张牌数据结构、正逆位、牌阵与评分规则
- `references/bazi-wuxing.md` —— 用 `lunar-javascript` 本地算日主五行与生克

关键设计原则:**每张牌的合作/关系场景含义单独一个字段**。只写通用牌义,解读会像百度百科;写了场景含义,才会像"懂这段关系"。

### 第 5 步:离线体检 + 打包

先用脚本体检,再打包:

```bash
python scripts/check_offline.py <项目目录>          # 离线合规体检,必须全绿
python scripts/scaffold.py <目标目录> --title 我的占卜  # 需要骨架时才用
```

体检会拦:外部 URL / CDN 引用、`node_modules` 混入产物、AGPL 依赖、缺失的本地 vendor、隐私风险写法。

打包 Capacitor 流程、构建脚本坑位,见 `references/packaging.md`。

## 三条不可妥协的红线

1. **许可证**:AGPL 不进闭源 App。宁可自己写算法,也不引入传染性许可证。
2. **零外链**:产物目录里不允许出现任何远程 URL。构建脚本应主动扫描并拦截。
3. **离线优先降级**:联网模块未配置、断网、接口报错时,必须静默走本地规则,**绝不阻塞主流程、绝不弹错误**。

## 常见翻车点

| 症状 | 原因 | 处理 |
|---|---|---|
| 打包后白屏 | 资源用了绝对路径或 CDN | 全改相对路径,`check_offline.py` 会报 |
| 页面上填生日就崩 | DOM id 两端不同步 | 改 id 时同步 `index.html` 与 `app.js` 的绑定表 |
| 构建脚本静默失败 | 复制 API 在部分环境不可用 | 改手动递归复制,别用 `cpSync` 之类 |
| 用户投诉"解读太泛" | 牌义只有通用含义 | 补场景字段(合作/感情/事业各一份) |
| App 被指侵权 | 引了 AGPL 库 | 换 MIT 库或自研 |

## 参考文件

| 文件 | 内容 |
|---|---|
| `references/licensing.md` | 许可证核查法与避坑案例 |
| `references/architecture.md` | 四层结构与离线约束 |
| `references/tarot-engine.md` | 牌库结构、牌阵、评分规则 |
| `references/bazi-wuxing.md` | 本地历法与五行合参 |
| `references/packaging.md` | Capacitor 打包与构建坑位 |
| `references/ui-motion.md` | 克制、可中断的移动端动效 |

## 脚本

| 脚本 | 用途 | 是否改动文件 |
|---|---|---|
| `scripts/check_offline.py` | 离线合规体检,输出问题清单 | 只读 |
| `scripts/scaffold.py` | 生成最小可运行骨架 | 新建目录,不覆盖已有文件 |

两个脚本都支持 `--help`,纯标准库,无需安装依赖。
Pliki w paczce (15)
  • SKILL.md 6 KB
  • assets/scaffold/index.html 2 KB
  • assets/scaffold/assets/css/style.css 6 KB
  • assets/scaffold/assets/js/app.js 4 KB
  • assets/scaffold/assets/js/data/spreads.js 2 KB
  • assets/scaffold/assets/js/data/tarot.js 6 KB
  • assets/scaffold/assets/js/engine/divination.js 3 KB
  • references/architecture.md 5 KB
  • references/bazi-wuxing.md 4 KB
  • references/licensing.md 3 KB
  • references/packaging.md 3 KB
  • references/tarot-engine.md 7 KB
  • references/ui-motion.md 4 KB
  • scripts/check_offline.py 10 KB
  • scripts/scaffold.py 3 KB

Wersje

W bazie nie ma innych skilli o nazwie offline-divination-app.

Migawka bazy z 13.11.2026 · wersja paczki 7f3e1681e27a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100uniapp-native-app
    Pakuje aplikację uni-app jako natywną aplikację Android i iOS: podpisywanie, ustawienia i pakowanie offline.
  • 100capacitor
    Pakuje aplikację webową jako natywną aplikację na iOS i Androida z dostępem do natywnych API przez Capacitor: system wtyczek, most web-native i publikacja w sklepach.
  • 85mobile-engineering
    Projektuje, wdraża i przegląda aplikacje mobilne Flutter, React Native, iOS i Android, z trybem offline, wydajnością i publikacją w sklepach.
  • 100hk-mobile-app-ui-validation
    Prowadzi natywną aplikację iOS lub Android przez symulator, wykonuje zrzuty każdego ekranu i mierzy obszary dotyku, zapisując wyniki na stronie.
  • 100mobile-app-design
    Projektuje natywną aplikację iOS i Android w całości: architekturę informacji, nawigację, tożsamość wizualną, ekrany, stany i dostępność.
  • 100mobile-development
    Buduje, testuje, podpisuje i publikuje aplikacje mobilne na iOS, Androida, Flutter i React Native: szkielet projektu, build, testy na urządzeniach, zgłoszenia do sklepów, cykl życia, offline i synchronizację.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.