# EndlessCheng/mahjong-helper

日本麻将助手：牌效+防守+记牌（支持雀魂、天凤）

Repository: https://github.com/EndlessCheng/mahjong-helper
Canonical: https://ross.abutalabs.com/products/mahjong-helper
Language: Go
License: MIT
License Family: permissive
Topics: tenhou, majsoul, mahjong, mahjong-algorithm, golang, mahjongsoul, riichi-mahjong
Last push: 2022-06-23T01:11:42+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 2900, "days_push": 1533, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2343, forks 301 (observed 2026-08-28T04:06:39.149373+00:00)

## What it is
A Riichi (Japanese) mahjong assistant written in Go that analyzes hands in real time for the online platforms Majsoul and Tenhou. It recommends discards based on tile efficiency and expected value, shows tile danger levels when opponents call riichi, tracks opponents' discards, and can review game logs suggesting attack/defense choices.

## Use cases
- get discard recommendations for riichi mahjong hands
- analyze tile efficiency and shanten in majsoul
- see which tiles are safe when an opponent calls riichi
- review tenhou game logs move by move
- track opponents' tsumogiri and tedashi discards
- play three-player mahjong with assistant support

## When to choose
- you play riichi mahjong on Majsoul or Tenhou in a browser and want real-time hand analysis
- you want combined tile-efficiency, expected-value, and safety guidance rather than just tile counting
- you want a self-hosted local helper that works with both 4-player and 3-player mahjong

## When to avoid
- you play other mahjong variants or platforms not supported by the tool
- you need a mobile app or standalone game rather than a browser-integrated assistant
- you are unwilling to install a browser extension and enable localhost certificate flags
- you need actively maintained software - the latest release dates to 2022

## Facets
- artifact type: application
- maturity: maintenance
- function: game, developer-tools, cli, gui
- domain: gaming-tools, cross-platform
- platform: cross-platform, browser, cli, go
- tags: riichi-mahjong, majsoul, tenhou, tile-efficiency, defense-assistant, game-assistant, browser-extension-integration

## Member repositories
- EndlessCheng/mahjong-helper (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:39.149373+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:37:13.677786+00:00, confidence not recorded.
  - readme: https://github.com/EndlessCheng/mahjong-helper (fetched 2026-08-28T04:06:39.149373+00:00, sha eb5277cbdade)
- Data as of 2026-08-30T08:39:29.467469+00:00.