Preface

In DeepSeek Harness (DSH), when conducting fortune-telling dialogues, the common practice is to have the model “calculate” the Four Pillars or Purple Star positions based on training data. Once the model self-calculates facts like Heavenly Stems and Earthly Branches, Hidden Stems, Ten Gods, and Major Cycles, the results are often irreproducible and difficult to validate at the Tool layer. If the birth time is unknown or falls on a day-change boundary, arbitrarily guessing a precise time also subtly erases the uncertainty.

dsh-fate-spectrum transforms the chart calculation for Bazi (Four Pillars) and Purple Star Astrology into a DSH plugin: chart facts are computed offline locally and delivered to the Agent as structured data, rather than having the model substitute for a calendar engine.

What is This

dsh-fate-spectrum is a DeepSeek Harness plugin released by maintainer EchoUser005, categorized under model inference. It converts the charting steps in traditional fortune-telling into Tool capabilities directly callable by an Agent, supporting Bazi (Four Pillars), Purple Star Astrology, or both chart sets by default.

The project is open source on GitHub (MIT License), with the current latest version being v0.1.0. SkillHub directory page: https://www.skillhub.cn/plugins/EchoUser005/dsh-fate-spectrum; Source code and documentation: https://github.com/EchoUser005/dsh-fate-spectrum.

Core Features

The following introduces the verified capabilities of v0.1.0.

Bazi (Four Pillars) Charting

The plugin can calculate foundational chart facts such as Four Pillars, Hidden Stems, Ten Gods, Nayin, Empty Cycles, Twelve Life Stages, Luck Pillar Initiation, and Major Luck Pillars, preventing the model from self-calculating Heavenly Stems and Earthly Branches.

Purple Star Astrology Charting

Independently calculates the Twelve Palaces, Life and Body Palaces, Life and Body Lords, Five Elements Bureau, Star Brightness, Four Transformations, and Major Cycles. Supports both common star placement methods and the Zhongzhou school, recording the adopted school and leap month rules in the results.

Dual Chart Viewing

When no specific system is specified, one task outputs both Bazi and Purple Star charts simultaneously; it can also focus on just one system. The two systems share a single charting task but have independent calculation implementations.

Preserving Time Uncertainty

When the birth time is unknown or falls near a day-change boundary, the plugin does not arbitrarily fill in a definite time. For Bazi, it preserves candidates that genuinely change the natal chart and major luck cycles; for Purple Star, it retains the thirteen time slots from early Zi to late Zi, marking the time range applicable for each scenario. The Agent can first analyze common facts and then explain which conclusions change under different time conditions.

Ask for What’s Missing

When birth date, gender, time status, or timezone information is insufficient, DSH will first ask for clarification, rather than guessing key information to quickly generate a chart. When one system encounters a safely identifiable issue, the trustworthy results already calculated by the other system are still retained.

Offline Calculation and Tool Layering

Charts are calculated offline within the plugin, without relying on third-party charting websites or sending birth information to external charting services. The program side returns a verifiable engineering response, while the Agent side receives it as an Observation organized for reasoning; chart facts, failure reasons, and next actions are kept separate.

Installation and Activation

With DSH already installed, add dsh-fate-spectrum to the Profile you regularly use. Below is an example using the web Profile.

dsh plugin --profile web add dsh-fate-spectrum@0.1.0
dsh --profile web --dump-config
dsh web

If dsh-fate-spectrum and fate-spectrum appear in the --dump-config output, the Bundle has been added to the current Profile. Then, open DSH normally to request charting or fortune-telling analysis in the dialogue.

To upgrade to the latest compatible version:

dsh plugin --profile web up dsh-fate-spectrum

If you have a locally packaged .tgz file, you can install it directly without going through the npm registry:

dsh plugin --profile web add ./dsh-fate-spectrum-0.1.0.tgz
dsh --profile web --dump-config

For local development and --patch debugging methods, see the repository documentation DSH Local Test SOP.

Typical Usage

After installation and activation, simply state your needs in the dialogue; there’s no need to remember additional commands.

  1. Just say “Help me chart” — the Agent will ask for missing information such as birth date, gender, time, or timezone.
  2. When Bazi or Purple Star is not specified, both chart sets are calculated by default.
  3. If the time is uncertain, you can describe it truthfully, such as “close to 11 PM, but unsure of the exact minute” or “time unknown.” The plugin will return candidate charts with applicable time ranges, so there’s no need to guess the time.

The current version is most suitable for understanding the chart from the natal chart, luck pillar initiation, major luck cycles, twelve palaces, and major cycles. README explains that future weekly, monthly, and continuous analysis for specific date ranges will be supplemented by an independent Heavenly Stems and Earthly Branches calendar capability.

Applicable Scenarios and Notes

Who is it for

  • Developers and users who need to perform Bazi or Purple Star charting within DSH dialogues and require reproducible and verifiable results.
  • Harness users who want the Agent to analyze based on structured chart facts rather than having the model “calculate” Heavenly Stems and Earthly Branches on its own.

Runtime Environment and Permissions

The plugin runs with the permissions of the current DSH process. Birth information will enter the current DSH dialogue and Tool calls; whether session records are retained depends on the individual’s DSH Profile and Session settings. The plugin itself does not create separate user databases, chart caches, or birth information logs. Before installation, you should read the source code and MIT license to ensure it aligns with your usage boundaries.

Privacy and Boundaries

  • Fortune-telling provides observations, references, and possibilities, not judgments on one’s life.
  • For high-risk issues such as medical, legal, financial, and psychological matters, you should still seek help from corresponding professionals.
  • Only information explicitly authorized by the individual can be used in the future personalized memory capability mentioned in the README.

Long-term Planning (Not Yet Implemented)

The README lists future directions including Heavenly Stems and Earthly Branches calendar and cycle context, true solar time calibration, weekly reports and analytical Skills, pattern Knowledge, mental world model Memory, and chart A2UI. These are future prospects and should not be confused with the current capabilities of v0.1.0.

Conclusion

dsh-fate-spectrum first calculates chart facts clearly, providing a trustworthy base map for the Agent’s fortune-telling analysis: offline, deterministic, structured, and preserving the necessary uncertainty regarding time and time boundaries. To integrate Bazi and Purple Star charting into DSH, you can start by trying the installation commands from v0.1.0.

  • SkillHub Directory: https://www.skillhub.cn/plugins/EchoUser005/dsh-fate-spectrum
  • GitHub Repository: https://github.com/EchoUser005/dsh-fate-spectrum