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.
- Autor
- chinaretaildesign ↗
- Repozytorium
- agent-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 04.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 15
- Skrypty
- 6
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 1
Brak sygnałów. Repozytorium zmienione 04.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 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
- 何时用这个 skill
- 五步工作流
- 三条不可妥协的红线
- 常见翻车点
- 参考文件
- 脚本
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ę.