渡 DU

我的浏览器端中文玄学工具集。没有后端、没有账号、没有埋点, 全部在浏览器里算,数据放在 localStorage。49 个小工具,Vue 3 + TypeScript。

取名 DU · 渡,寓意"渡己渡人"——以术数为舟,先渡己,再渡人。

49 个工具,一打小算法,一个静态站。打开页面,用,关掉页面。 下次再打开,数据还在 (你机器上),后台不知道你存在过。

包含:八字、奇门遁甲、大小六壬、紫微斗数、铁板神数、诸葛神数、 玄空飞星、塔罗、易经、二十四节气、风水、面相、冥想计时。

不是专业意见,只是好奇心的产物。算出来的结果请别用来下注。

• 不是后端。不接 API,不需要 key,不会打点。
• 不是商业产品。MIT 协议,代码随便用,算错了我也不负责。
• 不是论文。每个工具后面有一两行注释,说清楚用了什么经典和 什么简化;不会比维基百科更严谨。

git clone https://github.com/badhope/DU.git
cd DU
pnpm install
pnpm dev:h5    # http://localhost:5173

生产构建:

pnpm build:h5    # 单文件 SPA,丢到任何静态托管
pnpm test        # 单元测试

DU (渡, "to ferry across") is a fully client-side, privacy-first single-page application that brings together traditional Chinese metaphysics tools — Bazi, Qi Men Dun Jia, Liu Yao, I-Ching, Zi Wei Dou Shu, Tarot, physiognomy, feng shui, the 24 solar terms, meditation timers, and more — into one consistent, mobile-friendly web app. The name carries the wish 渡己渡人 — ferry yourself, then ferry others.

It is built with uni-app x + Vue 3 + TypeScript (strict) and ships as a single static bundle that runs on GitHub Pages. There is no backend, no API key, no analytics SDK, no third-party tracking — every calculation happens in your browser and your data stays in localStorage under the key du-state-v1.

• For cultural exploration. All outputs are heuristic and educational; they are not professional advice.
• For developers. The repository is a clean uni-app x + Vue 3 + Vite starter with strict TypeScript, ESLint, Prettier, Vitest, Lefthook, and a fully wired CI/CD pipeline (format → lint → test → audit → build → deploy).
• For tinkerers. The whole app is small enough to read in a weekend — 49 tools, ~24 chart components, ~44 utility modules.

The single source of truth is src/config/tools.ts. Adding or removing a tool means editing one entry there.

• Node.js ≥ 20
• pnpm ≥ 9

nvm use    # picks up .nvmrc → node 20
corepack enable && corepack prepare pnpm@9 --activate

pnpm install
pnpm run dev:h5          # start H5 dev server on http://localhost:5173

pnpm run type-check      # vue-tsc --noEmit
pnpm run build:h5        # emits to dist/build/h5/, copies robots.txt to root
pnpm run preview         # (optional) serve the built bundle locally

Other MP targets follow the same dev:mp-* / build:mp-* pattern (alipay, baidu, jd, kuaishou, lark, qq, toutiao, harmony, xhs, quickapp-*).

DU/
├── .github/
│   ├── workflows/
│   │   ├── ci.yml        # format / lint / test / audit / type-check / build
│   │   ├── deploy.yml    # build + GitHub Pages deploy
│   │   ├── gitleaks.yml  # secret scanning (daily + on push/PR)
│   │   └── codeql.yml    # JS/TS static security analysis
│   ├── ISSUE_TEMPLATE/   # bug / feature / config
│   ├── CODEOWNERS
│   ├── PULL_REQUEST_TEMPLATE.md
│   └── SECURITY.md
├── src/
│   ├── components/
│   │   ├── charts/       # 24 visualization components (BaziChart, ZiweiChart, …)
│   │   ├── effects/      # StarField, Particles, TaijiBg
│   │   └── ui/           # Reusable UI: ToolGuard, MysticScan, MagneticButton, …
│   ├── config/
│   │   └── tools.ts      # ⚙ single source of truth for all 49 tools
│   ├── designs/          # tokens.css (color, spacing) + animations.css
│   ├── pages/            # 49 tool pages
│   ├── static/           # logo.png, robots.txt
│   ├── stores/           # Pinia store
│   ├── utils/            # 44 algorithm modules (Bazi, Liu Yao, Tarot, …)
│   ├── App.vue
│   ├── env.d.ts
│   ├── main.ts
│   ├── manifest.json     # uni-app x app manifest
│   ├── pages.json        # uni-app x routes
│   ├── shims-uni.d.ts
│   └── uni.scss          # global SCSS variables
├── tests/                # vitest unit tests
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE               # MIT
├── README.md             # ← you are here
├── SECURITY.md
├── commitlint.config.js
├── lefthook.yml
├── vitest.config.ts
├── vite.config.ts
├── tsconfig.json
├── index.html            # H5 entry, OG / Twitter / favicon meta
├── .editorconfig
├── .gitattributes
├── .gitignore
├── .git-blame-ignore-revs
├── .node-version         # 20
├── .nvmrc
├── .npmrc
├── .prettierrc.json
├── .prettierignore
├── eslint.config.js
└── .vscode/              # recommended extensions + project settings

Contributions are welcome! Please read CONTRIBUTING.md first.

• Branch naming: feat/<scope> / fix/<scope> / docs/<scope> / chore/<scope>
• Commit messages: Conventional Commits (enforced by commitlint via lefthook)
• PRs: must pass format:check + lint + test + type-check + build:h5 + pnpm audit
• Adding a new tool? Edit one entry in src/config/tools.ts + add a page in src/pages/<key>/ + add an algorithm in src/utils/ + register the route in src/pages.json.

See .github/PULL_REQUEST_TEMPLATE.md for the full checklist.

TL;DR: There is no server. There is no analytics. Your data never leaves the browser.

• No fetch / XMLHttpRequest / uni.request calls — verified via grep. Every computation is local.
• No v-html / innerHTML / eval / new Function — uni-app x renders text safely.
• No third-party SDKs — no Google Analytics, no Sentry, no Umeng, no Baidu Tongji, no AdSense.
• No .env / API keys — .gitignore blocks .env*, test-*.cjs, and screenshots.
• localStorage holds your profile + divination history under du-state-v1. Clear it any time from Settings → Privacy.
• CI runs gitleaks (push, PR, daily) + CodeQL (javascript-typescript) + pnpm audit --prod --audit-level=high.
• Dependency overrides force jpeg-js@^0.4.4 and @intlify/{core-base,message-resolver}@^9.1.11 to neutralize transitive CVEs from uni-app's bundle.

Report vulnerabilities privately via GitHub Security Advisories — see SECURITY.md.

main is the only long-lived branch. Every push to main triggers:

1. CI — format:check → lint → test → audit → type-check → build:h5
2. Deploy — type-check → build:h5 → actions/deploy-pages@v4 → GitHub Pages

Live at https://badhope.github.io/DU/

To deploy your own fork: enable GitHub Pages in repo settings (Source: GitHub Actions), then push to main.

Q: Is this a religious or divinatory app? A: No. It's a cultural / educational tool that implements traditional Chinese algorithms. Outputs are heuristic, not authoritative, and should not be used for medical, legal, or financial decisions.

Q: Why is everything Chinese-first? A: The tradition is Chinese. All UI labels are bilingual, the code is in English, and English speakers can use every tool.

Q: Can I run this offline? A: After the first load the bundle is fully offline-capable (no network calls). Add the site as a PWA and it will work as a standalone app.

Q: Why uni-app x instead of Nuxt / Next / SvelteKit? A: The original goal was to ship to WeChat Mini Program as well as the web. uni-app x is the only framework that compiles Vue 3 to both with a single codebase.

Q: Why the name DU / 渡? A: 渡 means "to ferry across." The wish is 渡己渡人 — first ferry yourself to understanding, then help ferry others. The tools are the boat.

• Code: MIT — Copyright © 2026 DU contributors
• Brand & copy: 渡 / DU
• Maintainer: @badhope

Cultural reference data is drawn from public-domain traditional sources. No proprietary oracle data is bundled.

渡 DU 是一款纯客户端的中国传统文化工具集，基于 uni-app x + Vue 3 + TypeScript 构建，共 49 个工具，覆盖 命理、占卜、古物、健康、修心、生活 六大类。

取名"渡"，寓意渡己渡人——以术数为舟，先渡己，再渡人。

• 零后端：所有计算在浏览器内完成，无任何 fetch / uni.request 外发。
• 零追踪：不集成任何第三方分析 SDK，不上传任何数据。
• 零账户：开箱即用，所有数据存于 localStorage（key: du-state-v1）。
• 多端：一份代码同时输出 H5（GitHub Pages）、微信小程序、支付宝小程序、抖音小程序、鸿蒙、百度智能小程序等。
• CI 全绿：format → lint → test → audit → type-check → build → deploy，全部接入分支保护。

项目内容仅供文化研究与个人体验，不构成任何决策建议。欢迎以 MIT 协议 自由使用。