让「知微」陪你读懂命盘里的线索。
紫微知道系列中的开源紫微斗数 Agent：围绕可追溯的命盘事实，以自然对谈帮助普通用户追问真正关心的问题。
紫微知道（Ziwei Knows）由三款平级、互补的开源产品组成。它们服务不同的探索方式，不要求账号、命盘或数据互通。
| 产品 | 适合什么需求 | 访问 |
|---|---|---|
| Ziwei Chart | 想准确排盘、浏览十二宫、流年、合盘和长期趋势。 | 在线体验 · GitHub |
Ziwei Chat 当前产品 |
已有命盘，想围绕事业、关系、财富或近况继续追问。 | 在线体验 · GitHub |
| ZATI | 不想先填写出生信息，想通过行为选择探索人格原型。 | 在线体验 · GitHub |
想先看完整盘面和趋势，可以使用 Ziwei Chart；想从行为倾向开始认识自己，可以探索 ZATI 东方人格原型。Ziwei Chat 不要求它们作为前置条件，但会在个人盘面问题上使用确定性排盘事实。
Ziwei Chat 是一个消费级紫微斗数对话产品。你可以创建自己的命盘，和「知微」聊事业、关系、财富、近况，也可以从任何你真正关心的问题开始。
它不要求注册、登录、支付或使用托管账号。没有数据库时，依然可以排盘、使用本地知识检索，并在浏览器中保存匿名命盘与对话；接入 Postgres 与 pgvector 后，可获得持久化和增强检索能力。
「知微」不是用固定报告模板回答问题。她会自然地和你对谈，但涉及个人命盘时，只会把确定性排盘工具给出的信息当作你的盘面事实。
| 能力 | 说明 |
|---|---|
| 确定性排盘 | 使用 iztro 生成命盘，不让模型自行计算星曜或宫位。 |
| 知微对谈 | 温柔、细腻、坚定的对话人格；按语境组织回答，而不是强制五段式报告。 |
| 事实可追溯 | 每次严肃分析都可查看工具调用、命盘事实、知识来源与 critic 状态。 |
| 按需宫位解读 | 命盘页只在你点击后生成当前宫位的 AI 解读，避免自动消耗 Token。 |
| 流式回答体验 | 回答渐进呈现，支持 Markdown、证据面板和回答过程状态。 |
| 连续对话记录 | 匿名对话可从记录页恢复；无数据库时，浏览器本地保留最近的完整会话。 |
| 本地优先检索 | 默认使用 Markdown / 关键词知识检索；Embedding 与 pgvector 都是可选增强。 |
| 隐私优先 | 模型 API Key 仅保存在当前浏览器本地；匿名数据可从设置页清除。 |
| 对话与证据 | 命盘与宫位解读 |
|---|---|
 |
 |
- Node.js 22+
- npm 10+
- 可选：Docker Desktop / Postgres 16（用于持久化与 pgvector）
git clone https://github.com/ziweiknows/ziwei-chat.git
cd ziwei-chat
npm install
npm run dev打开 http://localhost:3000。首次进入后：
- 在「命盘」页填写出生信息并生成命盘。
- 回到对话页，直接说出你关心的事。
- 需要 AI 正文时，在「设置」页配置模型。
- 在回答旁打开证据面板，查看本次分析实际使用了什么。
排盘、命盘展示、本地知识检索、工具链准备和证据状态仍可运行。涉及个性化长回答时，产品会提示你完成模型设置，而不会伪造一段看似可靠的分析。
在 /settings 的模型设置中填写 OpenAI 兼容服务的：
- Provider
- Base URL
- API Key
- Model
模型 Key 只保存在当前浏览器的 localStorage，请求时发送给 /api/chat，不会写入项目数据库。你可以随时在设置页清除。
| 模式 | 需要什么 | 可获得什么 |
|---|---|---|
| 本地基础模式 | Node.js | 排盘、匿名浏览器数据、本地 Markdown / 关键词检索、模型对话。 |
| 本地语义检索 | Embedding Provider | 构建本地 JSON Embedding 索引，增强无数据库检索。 |
| Postgres / pgvector | Postgres、DATABASE_URL、Embedding Provider |
对话与命盘持久化、知识向量检索、跨请求的数据恢复。 |
docker compose up -d postgres
npx drizzle-kit migrate环境变量参考 .env.example。数据库是可选的：不配置时，产品仍能以本地模式启动。
EMBEDDING_BASE_URL="https://api.openai.com/v1" \
EMBEDDING_API_KEY="sk-..." \
EMBEDDING_MODEL="text-embedding-3-small" \
npm run build:knowledge-embeddings这会读取 content/knowledge/**/*.md 并生成本地索引。未配置时，系统自动回退到 Markdown / 关键词检索。
出生信息
-> iztro 确定性命盘
-> 命盘事实与问题路由
-> 主题工作流 + 本地 / 向量知识检索
-> 知微生成自然回答
-> critic 审核与证据输出
核心原则：
- 只有确定性工具返回的信息可以被描述为用户的命盘事实。
- 知识库用于解释，不用于补造盘面信息。
- 对话应当自然、有温度，但不把倾向说成确定命运。
- 医疗、法律、投资、紧急决策等高风险问题只提供反思性、非替代性的建议。
不会。命盘中的星曜、宫位和其他个人盘面事实只来自 iztro 的确定性工具输出；模型负责组织语言、调用工作流和解释已经取得的事实与知识来源。
Ziwei Chart 用于完整排盘与可视化浏览趋势、合盘和人生 K 线；Ziwei Chat 用于在事实基础上继续问“这对我当前的选择意味着什么”，并提供证据面板。
可以生成命盘、查看盘面、本地保存匿名资料、使用本地知识检索与查看工具状态。涉及个性化长回答时，产品会提示完成模型设置，而不会伪造看似可靠的分析。
当前首版不要求产品账号。模型 API Key 仅保存在当前浏览器的 localStorage，请求时才发送给 /api/chat；匿名命盘与会话可在本地模式下保存在浏览器，并能在设置页清除。部署方可选择接入 Postgres 以获得增强持久化与检索。
不是。ZATI 是紫微知道系列中独立的东方人格探索工具，不需要出生信息。它适合希望先从行为选择理解自己的人。
src/
app/ Next.js 路由与 API
components/ 对话、命盘、记录、洞见、设置界面
lib/ Agent、命盘、数据库、检索与领域契约
content/ 运行时主题工作流与本地知识
drizzle/ 数据库迁移
scripts/ 知识导入、Embedding 构建、Provider 诊断
tests/ 单元、集成与 Agent 评估测试
docs/ 产品、架构、提示词、知识与部署文档
npm run lint
npm run typecheck
npm run test
npm run eval:agent
npm run build- Fork 或推送此仓库到 GitHub。
- 在 Vercel 导入 Next.js 项目。
- 设置
NEXT_PUBLIC_APP_URL为部署地址。 - 若要启用持久化，额外配置
DATABASE_URL并先执行迁移。 - 部署。
详细部署、数据库和知识导入说明见 部署文档。
紫微知道提供的是基于命盘事实的倾向性解读和现实反思，不替代医疗、法律、心理、投资或职业专业建议，也不承诺确定结果。
欢迎提交 Issue 和 PR。对产品使用、Agent 协议、知识来源或界面体验的改进，请先阅读：
除明确标注为第三方来源的知识内容外，本项目按 Apache License 2.0 发布；第三方知识来源及其保留的许可证声明见 NOTICE。
如果紫微知道对你有帮助，欢迎点亮 Star，让更多人以更清楚的方式认识自己的命盘。