一、csp 简介

csp-(cpp shi pan，C++式盘)，一个cmd命令行奇门遁甲起盘工具。

特点

• 单机本地、使用过程中无需联网。
• 跨平台（即本项目编译成二进制可执行文件仅需要一个支持C++17标准的编译器）。
• 支持时间范围广（9998年跨度）。
• 支持手机移动端。

本项目会长期维护，欢迎您的PR。

拉取项目请使用：

git clone https://github.com/taynpg/csp

如果您还需要制作python包

同时使用-DCSP_PYTHON_EXPORT=ON开启。

git clone --recursive https://github.com/taynpg/csp

二、用法

2.1 使用

请使用--help查看帮助信息。

下面是一个示例排盘：

关于Python的使用，本项目支持导出为whl模块供python使用，不过仅仅是导出了排盘接口。设定好参数（参数与csp命令行所需参数一致）打印排盘结果与 使用csp类似，没有开放更多内部接口的使用，鉴于Python版本众多，本项目仅提供一版的whl安装包。

import csp_qm  # 导入安装的包

def test_qimen_pan():
    
    print("\n=== 测试 csp-qm 包 ===")
    
    # 1. 创建排盘参数
    param = csp_qm.CmdParam()
    param.year = 2023
    param.mon = 10
    param.day = 7
    param.hour = 15
    param.type = 1
    
    print("\n执行排盘...")
    qm = csp_qm.CQimenUse()

    # 这里打印结果
    qm.run(param)
    
    # 4. 检查结果
    print("\n排盘完成！")
    print("自动计算 is_auto:", param.is_auto)
    print("局数 ju:", param.ju)

if __name__ == "__main__":
    test_qimen_pan()

2.2 支持时间范围

公元0002-01-01至9998-12-31。

三、已实现功能

• 时家，转盘，超接置润法
• 时家，转盘，阴盘
• 时家，转盘，拆补
• 时家，转盘，茅山

记录

• 2025-09-04，已完成v1.5.0版本，该版本为预览版。

• 2025-09-03, tyme4cpp日历库已出，csp的v1.5大版本开始开发。

以下是v1.5前的声明：

截止到目前v1.4.6版本，不少用户反馈有月干支错误的BUG，经查实确实存在，属于日历库的问题。现在在等 tyme日历库出cpp版本，后续将使用tyme库替换现有的2个日历库进行修正。

csp在未来使用tyme日历库替换现有日历库以后将发布1.5版本并恢复使用cmake构建，csp计划将永久停留在v1.5版本，也就是说，csp将不再新增更多的排盘方式（除非有pull request合并请求），但csp仍然会保持永久性维护，仅限于处理后续可能遇到的BUG或者排盘错误的问题，尽可能保持高度的稳定和准确，并会伴有v1.5.x无限制的小版本更新发布。

四、构建

4.1 依赖：

• 支持C++17语法编译器

4.2 构建方法：

拉取项目请保证网络畅通（可访问github）。

$ git clone https://github.com/taynpg/csp
$ cd csp
$ cmake -Bbuild -DCMAKE_BUILG_TYPE=Release
$ cmake --build build --config Release

4.3 手机端构建

由于软件排版格式上几乎完全一致，Git页面图片展示效果不一定是最新的，避免频繁更新图片导致仓库大占用。

（1）安卓端可以使用termux（亲测可用）

（2）iPhone端可以使用iSh（亲测可用）

五、最后

如果您发现了BUG或者有好的建议可以提issue或致邮件[email protected]（欢迎您的任何想法和咨询）。