[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-1604":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":13,"stars7d":13,"stars30d":14,"stars90d":13,"forks30d":13,"starsTrendScore":13,"compositeScore":15,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":16,"fork":16,"defaultBranch":17,"hasWiki":18,"hasPages":16,"topics":19,"createdAt":8,"pushedAt":8,"updatedAt":20,"readmeContent":21,"aiSummary":22,"trendingCount":13,"starSnapshotCount":13,"syncStatus":23,"lastSyncTime":24,"discoverSource":25},1604,"fatecat","tukuaiai\u002Ffatecat","tukuaiai",null,"Python",194,41,1,0,6,4.87,false,"main",true,[],"2026-06-12 02:00:30","# FateCat\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\".\u002Fscripts\u002Fproject\u002Fassets\u002Fdocs\u002Ffatecat-readme-banner.svg\" alt=\"FateCat Banner\" width=\"100%\">\n\u003C\u002Fp>\n\n\u003Cdiv align=\"center\">\n\n**把专业命理排盘结果变成 AI 可稳定消费的结构化输入**\n\n**外部成熟算法 × 纯命理分析内核 × CLI \u002F Web \u002F Telegram \u002F FastAPI \u002F Agent 统一交付层**\n\n\u003Cp>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Ffatecat\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002Ftukuaiai\u002Ffatecat?style=for-the-badge&label=Stars\" alt=\"GitHub Stars\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Ffatecat\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flanguages\u002Ftop\u002Ftukuaiai\u002Ffatecat?style=for-the-badge&label=Top%20Language\" alt=\"Top Language\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Ffatecat\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flanguages\u002Fcode-size\u002Ftukuaiai\u002Ffatecat?style=for-the-badge&label=Code%20Size\" alt=\"Code Size\">\u003C\u002Fa>\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-2EA44F?style=for-the-badge\" alt=\"MIT License\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3.12+-3776AB?style=for-the-badge&logo=python&logoColor=white\" alt=\"Python 3.12+\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSkill-Codex%20Ready-111827?style=for-the-badge\" alt=\"Codex Skill Ready\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDelivery-Web%20%2F%20Telegram%20%2F%20FastAPI-26A5E4?style=for-the-badge\" alt=\"Web Telegram FastAPI\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSponsor-TradeCat-FF6A00?style=for-the-badge\" alt=\"Sponsor TradeCat\">\n\u003C\u002Fp>\n\n\u003Cp>\n  \u003Ca href=\"#overview\">项目总览\u003C\u002Fa> ·\n  \u003Ca href=\"#skill-repo\">Skill 仓库\u003C\u002Fa> ·\n  \u003Ca href=\"#modes\">模式选择\u003C\u002Fa> ·\n  \u003Ca href=\"#architecture\">架构\u003C\u002Fa> ·\n  \u003Ca href=\"#quick-start\">快速开始\u003C\u002Fa> ·\n  \u003Ca href=\"#web\">Web HTML\u003C\u002Fa> ·\n  \u003Ca href=\"#report-structure\">报告结构\u003C\u002Fa> ·\n  \u003Ca href=\"#commands\">常用命令\u003C\u002Fa> ·\n  \u003Ca href=\"#layout\">目录结构\u003C\u002Fa> ·\n  \u003Ca href=\"#hygiene\">仓库卫生\u003C\u002Fa> ·\n  \u003Ca href=\"#docs\">文档地图\u003C\u002Fa> ·\n  \u003Ca href=\"#disclaimer\">免责声明\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003C\u002Fdiv>\n\n> [!WARNING]\n> 本项目及 AI 分析结果仅供传统文化研究、算法测试与娱乐参考。命理学非精密科学，命运掌握在自己手中。使用者因轻信或误读本程序结果而产生的任何心理、财务及生活决策后果，本开源项目及开发者概不负责。\n\n> [!TIP]\n> `交易猫 TradeCat` 赞助与支持本项目。推荐工作流：先用交易猫完成专业排盘，再把结构化命盘交给 AI 深度分析，尽量减少模型乱编。\n>\n> - TradeCat Repo: `https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Ftradecat`\n> - FateCat Repo: `https:\u002F\u002Fgithub.com\u002Ftukuaiai\u002Ffatecat`\n> - CA: `0x8a99b8d53eff6bc331af529af74ad267f3167777`\n\n\u003Ca id=\"overview\">\u003C\u002Fa>\n\n## 项目总览\n\nFateCat 不是让 AI 直接“脑补排盘”，而是把“排盘”和“解释”拆开：\n\n1. 成熟排盘系统或外部算法负责结构化计算。\n2. FateCat 负责统一字段、统一输出、统一交付入口。\n3. AI \u002F Agent 只基于稳定 JSON 或标准 Markdown 做解释、总结与后续任务。\n\n| 维度 | 说明 |\n|------|------|\n| 项目角色 | 专业排盘结果到 AI 分析结果之间的结构化中间层 |\n| 当前形态 | 标准单-skill 仓库；根目录是 skill 外壳，`scripts\u002Fproject\u002F` 是真实源码 |\n| 推荐链路 | `TradeCat \u002F 专业排盘` -> `FateCat pure-analysis` -> `AI \u002F Web \u002F Telegram \u002F API \u002F Agent` |\n| 核心真相源 | `scripts\u002Fproject\u002Fassets\u002Ffate\u002F` 定义字段 profile，`scripts\u002Fproject\u002Fassets\u002Fvendor\u002F` 保留成熟算法快照 |\n| 明确边界 | 不让 AI 直接口算排盘，不在 `scripts\u002Fproject\u002Fassets\u002Fvendor\u002F` 魔改外部源码 |\n\n\u003Ca id=\"skill-repo\">\u003C\u002Fa>\n\n## Skill 仓库\n\n当前根仓库承担 4 个职责：\n\n- 单-skill 仓库入口：`SKILL.md` 定义 agent 如何接手、安装、检查、执行。\n- 生命周期治理层：`scripts\u002Fproject\u002Fassets\u002Fdocs\u002Flifecycle\u002F`、`references\u002F`、根脚本负责需求到运维的标准化闭环。\n- 统一执行包装层：根 `scripts\u002F` 把源码仓库常用动作封成稳定入口。\n- 可导出 bundle 源：可把当前 skill 连同运行时骨架导出为独立交付包。\n\n真实业务源码与运行时真相源在：\n\n- `scripts\u002Fproject\u002Fmodules\u002Ffate_core\u002F`：纯命理分析内核。\n- `scripts\u002Fproject\u002Fmodules\u002Ftelegram\u002F`：Web HTML、Telegram、FastAPI、报告生成与 legacy 适配。\n- `scripts\u002Fproject\u002Fassets\u002F`：配置、schema、字段 profile、外部成熟算法与数据资产。\n- `scripts\u002Fproject\u002Fruntime\u002F`：数据库与运行态产物。\n\n\u003Ca id=\"modes\">\u003C\u002Fa>\n\n## 模式选择\n\n| 场景 | 推荐入口 | 输出形态 | 是否要求 `FATE_BOT_TOKEN` | 说明 |\n|------|----------|----------|---------------------------|------|\n| 本地调试、脚本串联、先排盘再喂 AI | `bash scripts\u002Fpure-analysis.sh` | `stdout JSON` \u002F 文件 JSON | 否 | 最稳定、最适合结构化输出 |\n| 人类在浏览器中录入并复制报告 | `bash scripts\u002Fserve-api.sh` -> `\u002Fweb` | HTML 表单 + Markdown | 否 | 直接输入出生信息，输出可复制 Markdown |\n| 要接服务、工作流、上层系统 | `bash scripts\u002Fserve-api.sh` | HTTP JSON | 否 | 适合 Webhook、自动化平台、自建前端 |\n| 想直接聊天式使用 | `bash scripts\u002Fserve-bot.sh` | Telegram 消息 \u002F 报告文件 | 是 | 人工交互最直接 |\n| OpenClaw \u002F Harness \u002F 自动化 Agent | `project` 内自举入口 | 非交互 CLI \u002F 健康检查 | 纯分析否，Bot 是 | 适合批处理与自动部署 |\n\n\u003Ca id=\"architecture\">\u003C\u002Fa>\n\n## 架构\n\n```mermaid\nflowchart LR\n    A[TradeCat \u002F 专业排盘] --> B[外部成熟算法 scripts\u002Fproject\u002Fassets\u002Fvendor]\n    B --> C[fate_core 纯分析内核 scripts\u002Fproject\u002Fmodules\u002Ffate_core]\n    F[字段 profile scripts\u002Fproject\u002Fassets\u002Ffate] --> C\n    G[配置 \u002F 数据 \u002F schema scripts\u002Fproject\u002Fassets] --> C\n    C --> D[稳定 JSON + branding + disclaimer]\n    D --> E1[CLI]\n    D --> E2[Web HTML \u002Fweb]\n    D --> E3[FastAPI JSON]\n    D --> E4[Telegram Bot]\n    D --> E5[Agent \u002F Skill]\n    H[runtime 数据库 \u002F 日志] --> E3\n    H --> E4\n```\n\n推荐工作流：\n\n```text\nTradeCat \u002F 专业排盘\n        ↓\nFateCat pure-analysis 输出稳定 JSON\n        ↓\nAI 基于结构化字段做命理解读\n        ↓\nWeb \u002F Telegram \u002F API \u002F Agent 继续交付\n```\n\n\u003Ca id=\"quick-start\">\u003C\u002Fa>\n\n## 快速开始\n\n### 1. 首次准备运行时\n\n```bash\nbash scripts\u002Fbootstrap.sh --with-dev\n```\n\n只需要最小运行时：\n\n```bash\nbash scripts\u002Fbootstrap.sh\n```\n\n### 2. 先做标准预检\n\n```bash\nbash scripts\u002Fpreflight.sh --mode pure --bootstrap --pretty\n```\n\n交付层检查：\n\n```bash\nbash scripts\u002Fpreflight.sh --mode delivery --bootstrap --pretty\n```\n\n### 3. 执行一次命理排盘并输出文件\n\n```bash\nmkdir -p output\nbash scripts\u002Fpure-analysis.sh \\\n  --input-json '{\"birthDateTime\":\"1990-01-01 08:00:00\",\"gender\":\"男\",\"longitude\":116.4074,\"latitude\":39.9042,\"birthPlace\":\"北京市\",\"name\":\"测试样本\"}' \\\n  --output-file output\u002Fbazi-result.json \\\n  --pretty\n```\n\n### 4. 做完整验收\n\n```bash\nbash scripts\u002Facceptance.sh --with-dev\n```\n\n完整验收覆盖 shell 语法、strict skill 校验、纯分析 smoke、vendor health、全量 pytest、ruff、format、`fate_core` mypy、API\u002FBot dry-run、导出包卫生检查与导出包 smoke。\n\n\u003Ca id=\"web\">\u003C\u002Fa>\n\n## Web HTML\n\nWeb 版遵循零美化语义界面：原生 HTML 表单、服务端直出、psql ASCII 字段表、Markdown 原文 `\u003Cpre>\u003Ccode>` 展示、复制按钮只做渐进增强。\n\n启动 API：\n\n```bash\nbash scripts\u002Fpreflight.sh --mode delivery --bootstrap --pretty\nbash scripts\u002Fdelivery-smoke.sh --target api\nbash scripts\u002Fserve-api.sh\n```\n\n访问：\n\n```text\nhttp:\u002F\u002F127.0.0.1:8001\u002Fweb\n```\n\n字段契约：\n\n| 字段 | 必填 | 说明 |\n|------|------|------|\n| 出生日期 | 是 | `YYYY-MM-DD` |\n| 出生时间 | 是 | `HH:MM` 或 `HH:MM:SS` |\n| 出生地区 | 是 | 中文地点或 `lng,lat`，如 `北京` \u002F `116.4074,39.9042` |\n| 性别 | 是 | `male` \u002F `female`；现有排盘逻辑必需，不能默认猜测 |\n| 输出体系 | 否 | 当前可用：`bazi` \u002F `ziwei`；默认 `bazi`，每次只输出一个已实现体系 |\n| 姓名 | 否 | 为空时报告标题使用“命主” |\n\n前端展示规则：非北京类出生地区只用于经纬度解析和真太阳时计算，Web\u002FBot\u002FMarkdown 展示层会统一显示为“已填写（非北京地区已隐藏）”。\n\n\u003Ca id=\"report-structure\">\u003C\u002Fa>\n\n## 标准 Markdown 报告结构\n\n默认 Markdown 输出综合八字体系，包含八字主线和袁天罡称骨民俗辅助。紫微斗数作为独立体系保留，必须通过 Web HTML 的“输出体系”控件、Telegram 确认页按钮，或 API `options.reportSystem` 单独选择，不再和综合八字一起输出。黄历\u002F择日、六爻、梅花、奇门、大六壬、风水九星、姓名合婚等已经进入预测体系注册表，但状态仍是未来功能；未实现前只展示为独立待实现体系，不允许混入综合八字默认报告。\n\n可选体系：\n\n| 值 | 输出体系 | 状态 | 是否与八字混排 |\n|----|----------|------|----------------|\n| `bazi` | 综合八字 | 当前可用 | 否；默认输出八字主线与袁天罡称骨 |\n| `ziwei` | 紫微斗数 | 当前可用 | 否；独立输出紫微斗数、紫微基础、紫微运限四化 |\n| `huangli` | 黄历\u002F择日 | 未来功能 | 否；包含建除十二神与择日推荐，需独立契约 |\n| `liuyao` | 六爻占卜 | 未来功能 | 否；事件型起卦 |\n| `meihua` | 梅花易数 | 未来功能 | 否；时间\u002F数字\u002F象意起卦 |\n| `qimen` | 奇门遁甲 | 未来功能 | 否；独立排盘 |\n| `liuren` | 大六壬 | 未来功能 | 否；独立排盘 |\n| `fengshui` | 风水九星 | 未来功能 | 否；方位\u002F山向\u002F门向输入 |\n| `name_marriage` | 姓名合婚 | 未来功能 | 否；姓名学与合婚输入 |\n| `yijing` | 易经系统 | 未来功能 | 否；卦辞与起卦体系 |\n\nAPI 生成 Markdown 的入口：\n\n```text\nPOST \u002Fapi\u002Fv1\u002Freport\u002Fmarkdown\n```\n\n请求体沿用 `BaziRequest`，在 `options.reportSystem` 中传入当前已实现的 `bazi` 或 `ziwei`。体系清单入口：\n\n```text\nGET \u002Fapi\u002Fv1\u002Freport\u002Fsystems\n```\n\n默认 `bazi` 输出块顺序固定如下：\n\n```text\n免责声明（纯文本，无 # 标题）\n\n## 赞助支持\n\n# 命理排盘报告：{姓名}\n\n## 第一卷：先天命格（静态分析）\n  ## 基本资料（含真太阳时、节气）\n    ### 基本资料\n  ## 八字排盘详情\n    ### 五行分数\n    ### 天干分数\n    ### 温湿度与拱神\n    ### 干支合克与入库\n      #### 干支相合（依据）\n      #### 天干相克（依据）\n      #### 地支入库（依据）\n    ### 地支关系\n  ## 神煞断语\n    ### 简表神煞（字段展开）\n  ## 日主概览\n  ## 五行喜忌（调候与平衡）\n    ### 五行比例\n    ### 五行分数\n    ### 天干分数\n  ## 五行停匀与寒湿燥热（调候依据）\n  ## 干支取象（原文）\n  ## 命造格局（格局用神）\n  ## 节气司令\n  ## 干支关系\n\n## 第二卷：后天运路（动态趋势）\n  ## 运势分析\n    ### 大运分析\n    ### 流年\n    ### 流月运势\n    ### 小运\n\n## 第三卷：民俗与建议（生活应用）\n  ## 袁天罡称骨\n```\n\n体系归属：\n\n| 输出块 | 体系归属 | 说明 |\n|--------|----------|------|\n| 基本资料（含真太阳时、节气） | 八字排盘前置 | 出生时空、真太阳时、节气是八字排盘与月令判断的基础；若展示星座、星宿，只作历法\u002F民俗辅助 |\n| 八字排盘详情 | 八字主线 | 四柱、五行、天干地支、合克、入库、地支关系 |\n| 神煞断语 | 八字辅助体系 | 属传统命理常见辅助，不等同于格局用神主线 |\n| 日主概览 | 八字主线 | 日主、阴阳五行、强弱与坐支 |\n| 五行喜忌（调候与平衡） | 八字主线 | 五行比例、分数、调候与平衡 |\n| 五行停匀与寒湿燥热（调候依据） | 八字主线 | 月令气候、寒暖燥湿、调候依据 |\n| 干支取象（原文） | 八字经典辅助 | 干支象义，服务八字解释 |\n| 命造格局（格局用神） | 八字主线 | 格局、用神、调候取用 |\n| 节气司令 | 八字主线 | 月令、人元司令与节气分野 |\n| 干支关系 | 八字主线 | 干支合冲刑害破等结构关系 |\n| 运势分析：大运、流年、流月、小运 | 八字动态主线 | 八字后天运路与应期分析 |\n| 建除十二神 | 已退役为未来功能 | 属黄历\u002F择日辅助，不再作为当前命理报告体系输出 |\n| 紫微斗数 \u002F 紫微基础 | 其他独立体系 | 紫微斗数独立于八字，需选择 `ziwei` 单独输出 |\n| 紫微运限四化 | 其他体系 | 紫微大限、流年、流月、流日、流时 |\n| 袁天罡称骨 | 综合八字民俗辅助 | 称骨法随默认 `bazi` 报告输出，不再单独作为体系选择 |\n\n\u003Ca id=\"commands\">\u003C\u002Fa>\n\n## 常用命令\n\n```bash\nbash scripts\u002Fbootstrap.sh --with-dev\nbash scripts\u002Fpreflight.sh --mode pure --bootstrap --pretty\nbash scripts\u002Fpreflight.sh --mode pure --bootstrap --smoke --output-file output\u002Fpreflight-sample.json --pretty\nbash scripts\u002Fpreflight.sh --mode delivery --bootstrap --pretty\nbash scripts\u002Fpure-analysis.sh --input-file input.json --output-file output\u002Fresult.json --pretty\nbash scripts\u002Facceptance.sh --with-dev\nbash scripts\u002Fdelivery-smoke.sh --target api\nbash scripts\u002Fserve-api.sh\nbash scripts\u002Fdelivery-smoke.sh --target bot --startup-timeout 8\nbash scripts\u002Fproduction-readiness.sh --api-url https:\u002F\u002Fyour-domain.example --require-live-bot\nbash scripts\u002Fclean-runtime.sh --dry-run\nbash scripts\u002Fexport-runtime.sh --output-parent \u002Ftmp\u002Ffatecat-export --mode lite\nbash scripts\u002Fcheck-export-hygiene.sh \u002Ftmp\u002Ffatecat-export\u002Ffatecat\n```\n\n\u003Ca id=\"layout\">\u003C\u002Fa>\n\n## 目录结构\n\n```text\nfatecat\u002F\n├── AGENTS.md\n├── README.md\n├── SKILL.md\n├── references\u002F\n│   ├── commands.md\n│   ├── execution-playbook.md\n│   └── troubleshooting.md\n├── scripts\u002F\n│   ├── acceptance.sh\n│   ├── check-export-hygiene.sh\n│   ├── clean-runtime.sh\n│   ├── delivery-smoke.sh\n│   ├── export-runtime.sh\n│   └── preflight.sh\n└── scripts\u002Fproject\u002F\n    ├── AGENTS.md\n    ├── README.md\n    ├── assets\u002F\n    │   └── docs\u002F\n    │       └── lifecycle\u002F\n    ├── modules\u002F\n    │   ├── fate_core\u002F\n    │   └── telegram\u002F\n    ├── runtime\u002F\n    └── tests\u002F\n```\n\n根目录与 `scripts\u002Fproject\u002F` 的边界：\n\n- 根目录：skill 入口、预检、验收、导出、生命周期包装。\n- `scripts\u002Fproject\u002F`：真实业务源码、运行时骨架、项目级文档真相源。\n- `scripts\u002Fproject\u002Fassets\u002Fvendor\u002F`：外部成熟仓库快照，默认只读。\n- `scripts\u002Fproject\u002Fruntime\u002F`：运行态数据，不回灌静态资产目录。\n\n\u003Ca id=\"hygiene\">\u003C\u002Fa>\n\n## 仓库卫生\n\n默认卫生规则：\n\n- 不提交 `scripts\u002Fproject\u002Fassets\u002Fconfig\u002F.env`。\n- 不提交 `.venv`、`.pytest_cache`、`.ruff_cache`、`.mypy_cache`。\n- 不提交或分发本地编辑器历史 `.history\u002F`。\n- 不分发 `node_modules\u002F`。\n- 不分发 `__pycache__`、`*.pyc`、`*.pyo`。\n- 不把 `scripts\u002Fproject\u002Fmodules\u002Ftelegram\u002Foutput\u002F`、运行态 `.db` \u002F `.sqlite` 或本地 `.env` 放进导出包。\n- 导出后必须运行 `scripts\u002Fcheck-export-hygiene.sh`。\n- 旧部署包 `scripts\u002Fproject\u002Fassets\u002Fdeploy\u002Fpack.sh` 也会清理 `.env`、私钥、证书、SQLite、日志和常见凭证 JSON，避免把本地运行态打进 tarball。\n- `scripts\u002Fproject\u002Fassets\u002Fvendor\u002F` 保存完整外部快照，体积偏大属于当前复用完整源码能力的明确取舍；如需瘦身，必须先改成 manifest \u002F Git LFS \u002F 按需下载方案，不能直接删除运行依赖。\n\nAPI 安全开关：\n\n- `FATE_CORS_ALLOW_ORIGINS`：逗号分隔 CORS allowlist；默认空列表，不再默认 `*`。\n- `FATE_API_TOKEN` \u002F `FATE_API_ADMIN_TOKEN`：记录接口 admin token；admin 可访问全部记录。\n- `FATE_API_USER_TOKENS`：用户级 token，格式为 `user_id:token,user_id2:token2`；用户 token 只能写入、读取、列出、删除自己的记录。\n- 未配置任何 API token 时，记录接口返回“记录接口未启用”，避免公网误暴露。\n- 公网生产前运行 `bash scripts\u002Fproduction-readiness.sh --api-url \u003Curl> --require-live-bot`，缺少真实外部环境时不得宣称 live 验收通过。\n\n清理本地运行态：\n\n```bash\nbash scripts\u002Fclean-runtime.sh\n```\n\n导出并检查：\n\n```bash\nrm -rf \u002Ftmp\u002Ffatecat-export\nbash scripts\u002Fexport-runtime.sh --output-parent \u002Ftmp\u002Ffatecat-export --mode lite\nbash scripts\u002Fcheck-export-hygiene.sh \u002Ftmp\u002Ffatecat-export\u002Ffatecat\n```\n\n\u003Ca id=\"docs\">\u003C\u002Fa>\n\n## 文档地图\n\n- [SKILL.md](SKILL.md)：agent 如何接手、预检、执行、验收。\n- [references\u002Findex.md](references\u002Findex.md)：参考文档导航。\n- [references\u002Fexecution-playbook.md](references\u002Fexecution-playbook.md)：标准执行链路。\n- [references\u002Fcommands.md](references\u002Fcommands.md)：命令速查。\n- [references\u002Fops-pack.md](references\u002Fops-pack.md)：运维与加固。\n- [scripts\u002Fproject\u002FREADME.md](scripts\u002Fproject\u002FREADME.md)：项目级产品说明与业务背景。\n- [scripts\u002Fproject\u002Fassets\u002Fdocs\u002Freference\u002F功能状态.md](scripts\u002Fproject\u002Fassets\u002Fdocs\u002Freference\u002F功能状态.md)：标准报告与未来功能边界。\n\n\u003Ca id=\"disclaimer\">\u003C\u002Fa>\n\n## 免责声明\n\n本项目及 AI 分析结果仅供传统文化研究、算法测试与娱乐参考。命理学非精密科学，命运掌握在自己手中。使用者因轻信或误读本程序结果而产生的任何心理、财务及生活决策后果，本开源项目及开发者概不负责。\n","FateCat 是一个将专业命理排盘结果转换为AI可稳定消费的结构化输入的工具。该项目通过成熟算法进行结构化计算，然后统一字段、输出和交付入口，使得AI\u002FAgent能够基于稳定的JSON或标准Markdown格式进行解释和总结。其核心特点包括使用Python 3.12+开发，支持多种交付方式如CLI、Web、Telegram、FastAPI及Agent接口，并且与TradeCat项目紧密合作以确保数据来源的专业性和准确性。适合用于传统文化研究、算法测试以及娱乐参考等场景，但需注意其结果仅供参考而非决策依据。",2,"2026-05-29 02:46:29","CREATED_QUERY"]