Wenbu · 问卜

Wenbu · 问卜

免费排盘、抽牌与查阅资料，把结果变成可以继续思考的问题。

Free charts, tarot and source-based learning for a question you want to explore.

中文网站 · English website · 知识手册 · Documentation

Open source / 开源接入

MCP quickstart · CLI · Agent Skill · Releases · Contribute

Official MCP Registry record · app.wenbu/mcp. Domain ownership is verified; this directory record does not imply endorsement or an installation. 官方目录登记已完成，可核对远程地址、版本与源码。

Connect remote MCP at https://wenbu.app/mcp, use the dependency-free CLI, or install the Skill from skills/wenbu/. Read the integration guide to choose a connection and run a reproducible example. The full application and integrations are MIT licensed. This is a public repository, not an anonymous-data or feedback export.

第一次用，从这里开始

你想做什么	建议入口	需要准备什么
每天留一点新的视角	日签	不用填写资料；免费揭牌、记录和回看，不消耗对话回合
还不知道怎么问	Agent 对话	直接提问、选择一个开场，或先看不耗回合的完整示例
围绕眼前一件事思考	塔罗 / 易经	一个具体问题，不需要出生资料
看出生资料对应的传统命盘	八字 / 紫微	公历生日与当地时间；八字还需时区，紫微必须知道时刻
弄懂术语与计算规则	知识手册	可以从入门内容读起，再核对结果里的计算约定

传统符号适合学习和自我反思。历法计算能否复核，与解释能否预测现实是两件事；问卜不把排盘结果当作人生结论。

有哪些功能

• 日签：每天一张固定正位牌、一个小行动和一个回看问题，配原创牌面与克制揭签动效。无需资料或模型回合，可选云端保存、笔记和带原牌继续对话。Daily card in English.

• 八字：四柱、可见五行计数、未知时辰处理、午夜或子初换日选项，以及可选的近似真太阳时修正。五行数量不等于旺衰或喜用神。

• 易经：三钱法起卦，保留自下而上的六爻、动爻、本卦与之卦。

• 塔罗：完整 78 张牌，不放回抽取 1 张或 3 张，可选逆位；牌面为原创 AI 插画。

• 紫微：十二宫与星曜，公开 iztro 的排盘约定；目前宫位和星曜名称保留中文。

• Agent：调用实际工具、读取站内文章与精选外部资料、生成带来源的札记，并继续修改已有结果。研究范围限于资料目录。

• 保存与接入：可选邮箱账号与云端记录、浏览器试用手记、会话导出、MCP、CLI、Skill 与 REST API。

免费与资料处理

计算、抽取、学习内容、手记和 MCP 无需注册或付费。浏览器试用和登录账号每天最多 5 次 AI 解读、12 个 Agent 回合，上海时间零点重置；登录会归并当天试用用量，并受额外的网络防滥用和全站预算限制。外部匿名 API 仍按网络限额计数。AI 不可用时，独立工具仍可使用。详见免费额度。

未登录时，会话与手记暂存在当前浏览器。邮箱验证码登录后可开启云端记录、选择导入旧记录，并跨设备回看；不要求注册才能查看完整结果。计算请求会发送至问卜的 Cloudflare 服务；使用 AI 时，消息和所选上下文会经该服务发送给 DeepSeek。导出文件可能包含私人资料，下载不等于自动分享，也不等于匿名化。详见隐私说明。

从一个问题开始

如果想进行简短的日常练习，可以试试免费每日卡片：根据当地日期抽取一张固定的正位牌，附带原创行动提示和一个留待之后思考的问题。无需提供出生信息、注册账户或消耗 Agent 对话次数。可以记下笔记，也可以选择保存到账户，或明确将同一张牌带入对话。这是一种反思练习，并非个人星座运势。

如果想获得帮助来组织问题，可以使用 Wenbu Agent。直接提问、选择一条会发送所显示消息的入门提示，或预览完整示例而不消耗对话次数。选择入门提示不会覆盖你正在撰写的草稿。

如果想询问当下的问题，塔罗牌和易经都无需出生信息。八字和紫微斗数会根据出生信息排出传统命盘。手册介绍如何开始，以及如何理解结果。

工具负责计算或抽取符号；AI 可以帮助解读。这些是文化和反思实践，并非经科学证实的预测个人未来的方法。例如，可见的五行数量并不能确定五行强弱或喜用神。

本地运行 / 本地运行

需要 Node.js 22.12 或更高版本和 npm。在此代码库中：

npm ci
npm run verify
npm run preview

打开 localhost:8787。verify 会检查类型、运行测试、构建网站，并审计链接和卡牌资源。preview 会提供构建产物和 Worker API。更改静态页面后，请重新构建。npm run dev 可启动速度更快的 Astro UI 开发服务器，但不提供 Worker API 路由。

AI 为可选功能。若要在本地启用，请将仅供服务器使用的 DEEPSEEK_API_KEY 和 QUOTA_SALT 放入被忽略的 .dev.vars 文件中。不要在浏览器代码中放置密钥。有关设置、部署和回滚，请参阅运维文档。

接入自己的 Agent / 接入自己的 Agent

通过 https://wenbu.app/mcp 使用 Streamable HTTP。该服务提供七种工具：

工具	用途
calculate_bazi	根据时区和换日规则计算四柱
cast_iching	随机进行三枚铜钱起卦，或输入六爻（从下到上）
draw_tarot	从 78 张牌组中抽取一张或三张牌，不放回
calculate_ziwei	根据已知的当地出生时间和传统性别参数排出十二宫位
search_library	搜索 Wenbu 指南、符号说明和参考资料元数据
read_library	根据返回的 ID 阅读指南或符号条目
get_daily_card	公开的每日反思与练习；使用服务器日历，不涉及私人历史记录

MCP 不会调用 DeepSeek，也不需要你的模型密钥。由你的宿主提供解读。外部参考搜索结果仅包含链接和元数据；MCP 没有 read_reference 工具，因此宿主必须自行打开相关页面，才能引用其中的内容。请明确将 locale 设为 zh 或 en：MCP 默认使用英语，而 REST 和 CLI 计算默认使用中文。部分传统名称仍保留中文。

中文接入说明与可复制示例见 Agent 接入；英文说明见 Agent integrations。

api/v1/capabilities 中的能力清单介绍了工具约定和隐私说明。工具会公布经过验证的成功输出架构。资源包括 wenbu://methodology、wenbu://knowledge 和 wenbu://capabilities；可选提示词为 reflect_on_reading 和 research_with_sources。获取提示词不会调用模型。

试用 CLI

仓库中提供的 CLI 无依赖。以下可复现示例不使用个人信息，也不会调用模型：

node public/wenbu.mjs --help
node public/wenbu.mjs iching '{"lines":[7,7,7,7,7,7],"locale":"en"}'

它会返回 kind: "iching" JSON 结果，包含提供的六条爻，且没有变爻。要进行新的随机起卦：

node public/wenbu.mjs tarot '{"count":3,"reversals":true,"locale":"en"}'

请将个人输入保存在文件中或通过 stdin 提供，而不要留在 shell 历史记录中：node public/wenbu.mjs bazi --file birth.json。集成页面提供了完整的合成文件。WENBU_URL=http://127.0.0.1:8787 用于选择本地预览；WENBU_ANALYTICS=off 用于选择退出粗略服务分析。

将其添加到宿主前，请阅读技能。它不会因此获得访问其他对话或文件的权限。命盘的上下文导出与 Agent API 请求使用不同的架构；不要将导出内容直接传给 agent 命令。

内置 Agent

打开工作区或使用 node public/wenbu.mjs agent --file request.json。这是一个独立路由，会通过 Wenbu 的账户调用 DeepSeek，并且需要当事人选择分享所提供的消息和上下文。完整的请求与流式处理示例请参阅双语版 Agent 协议。

Agent 可以规划、计算、阅读精选资料库和可用的允许访问页面、询问缺失的详细信息，并撰写报告。它没有不受限制的网页搜索或后台执行能力。报告及其引文由模型撰写；成功读取来源并不代表所有解读都经过核实。后续交流会保留原有卡牌或爻，除非用户要求重新起卦。

访客对话和生成内容保留在浏览器中。通过电子邮件验证的账户可以启用私有云端历史记录；导入较早的浏览器记录需要明确选择。请求会通过 Cloudflare 将选定的上下文和有限的近期历史记录发送给 DeepSeek。清除浏览器存储会移除本地记录，但不会删除服务提供方的记录或重置配额。应用不承诺端到端加密；云端同步需要账户启用云端历史记录。

限额与架构

AI 配额	当前配置
单次解读	每个网络每天（按上海时间）5 次
Agent 对话	每个网络每天（按上海时间）12 轮
每轮 Agent 工作量	最多 5 次模型调用、12 次工具执行和 120 秒
全站模型预算	每天共 1,000 次尝试，由两条 AI 路由共享；Agent 使用量上限为 600 次

共享网络可能会共用同一配额。失败或取消的尝试也可能计入配额。计算器和 MCP 不使用模型预算，但仍受请求速率限制。访客无需付费；运营方承担上游服务和基础设施成本。

Cloudflare Workers 提供 Astro 静态资源和 API 路由。SQLite Durable Object 管理 AI 配额，D1 存储第一方产品事件和私有反馈，私有 R2 保存原始事件归档，速率限制绑定用于保护端点。界面使用 Astro 7 和 React 19；计算使用固定版本的 lunar-typescript 和 iztro。字体由本站托管。可选模型通过 DeepSeek 官方 API 运行，请求的模型为 deepseek-v4-flash；响应会记录服务提供方报告的模型名称。

每个公开页面以及解读和 Agent 结果页面都提供反馈入口。管理员可在 /insights/ 检查关联的使用历史、处理反馈并下载私有 NDJSON 归档。请参阅存储、导出和隐私详情。只有用户在反馈表单中明确选择后，才会分享个人摘录。

检查与贡献

部署后，公开页面的更改会自动提交到 IndexNow；作为后备方案，Cloudflare 每 15 分钟检查一次。提交回执和重试记录存储在 D1 中；收到回执并不代表内容已被索引。请参阅 IndexNow 操作说明。

请参阅审核证据、计算方法和分析定义。类型检查、自动化测试、浏览器检查、部署后的冒烟测试和实际搜索流量属于不同类型的证据。软件测试无法验证占卜预测。

报告问题时，请提供可复现的步骤、所选惯例和合成示例。请勿在公开议题中透露出生详情、私人问题和凭据。

采用 MIT 许可证。第三方软件包保留其各自的许可证。

电子邮件账户与云端历史记录

完整的访客试用始终免费。通过电子邮件验证，用户可以保存当前结果、同步对话和日志条目、选择较早的浏览器记录进行导入，以及导出或删除账户数据。无需访问私人历史记录，即可使用公开的 MCP 和 CLI。有关限制、可靠保存、配额关联和度量定义，请参阅账户架构、隐私与恢复。