Linux 软件免费装
Banner图

Skyphusion AI for Cloudflare

开发者 skyphusion
更新时间 2026年11月9日 18:38
PHP版本: 8.0 及以上
WordPress版本: 7.1
版权: GPLv2 or later
版权网址: 版权信息

标签

woocommerce search ai cloudflare

下载

0.6.3

详情介绍:

This plugin connects your site to Cloudflare® AI Search. Open Settings, then Skyphusion AI. Paste your public endpoint address there. You can set the same options with wp skyphusion-ai. Why this plugin was written: other plugin solutions did not meet our needs. We wanted other people to be able to harness the capabilities of AI Search and agents on their WordPress and WooCommerce site without paying a fee to get the harness. So here you go. This plugin is free. It provides access to Cloudflare services only. It is not a funnel to any other service. Cloudflare free plans work. Past those plans, you pay Cloudflare. Visitors get a search box. They can also open the keyboard search with Ctrl+K or Command+K. You can turn on a chat button as well. WordPress and WooCommerce call Workers AI through the AI Client. The provider id is skyphusion-ai. Open Settings, then Connectors. Save the API token there. This plugin does not store the token. Set the account id on the Skyphusion AI screen. Add a gateway id only when calls should go through AI Gateway. The screen also links to Workers AI, AI Gateway, and AI Search. One switch prints an AI Search answer above WordPress and WooCommerce search results. The switch is off until you turn it on. Errors stay off the page. A single product page also prints its stock as text. Each variation names its attributes, its SKU, its price, and its stock. A simple product names its stock. The text sits in the page itself. A crawler that does not run JavaScript can index it. The same page adds the SKU, the stock status, and the managed stock count to the meta description. Rank Math and Yoast both receive that sentence. The AI Search dropdown quotes it. A product that does not manage stock gets the SKU and the status, and no count. You do not add a custom field for this sentence. You can also add a stock_quantity number field on the instance. That field is a filter. It is not what the dropdown prints. The steps, including Wrangler, are in the FAQ. This plugin does three jobs, and it does not charge a license for any of them. Search. The box is Cloudflare AI Search. The card shows the product image, the title, and the description. The image is the page image. You do not add a field for it. On a product page the description gains the SKU, the stock status, and the managed stock count. SearchWP, FiboSearch, Relevanssi, and YITH WooCommerce Ajax Search are keyword or instant search. They charge a license. They are not this search. Chat. You can turn on a chat button. It answers in a sentence. The site assistant streams its answer. A product answer shows the image, the SKU, the stock status, and the managed count, and it links to the product. It does not add the product to the cart. See docs/worker.md. It is not a staff inbox, and it has no seats. You can expand that button with Cloudflare Workers AI or with Cloudflare AI Gateway. Workers AI is the provider on the AI Client. It covers text, vision, JSON, tools, images, speech, and embeddings. Leave the gateway id blank to call api.cloudflare.com. Set a gateway id to send those calls through gateway.ai.cloudflare.com. If that host refuses a call, Workers AI uses api.cloudflare.com for one hour and the screen says so. An empty gateway id stays on api.cloudflare.com. Log prompts only on the gateway host. Embedding calls do not log prompts. The log includes the plugin version. An image failure on a saved dynamic route does not start the hour. Tidio is a help desk. Its Starter plan was $24.17 a month when read on 2026-10-25, and its AI agent, Lyro, starts at $32.50 a month. AIPCF is a free Cloudflare provider. Its site assistant answers from the site's pages and is off until you turn it on. It is not a help desk. Agents. WordPress and WooCommerce call Workers AI through the AI Client. The provider covers text, vision, JSON, tools, images, and speech. Embeddings are included. You can expand those calls the same way, with Workers AI or with AI Gateway. This plugin does not edit posts. AI Engine is free, and AI Engine Pro starts at $69 a year for one site. You still pay the model vendor there. AIPCF is free. It is a Cloudflare provider for the WordPress AI Client, and its readme also offers Qdrant and PostgreSQL for embeddings. Here the plugin fee is $0. You use a Cloudflare account. Cloudflare free plans work. Past those plans, you pay Cloudflare. Embeddings stay in Cloudflare Vectorize. The plugin does not send the site to another company. The tables, the renewal figures, and the page each price came from are in the Compared section of README.md. Every price was read on 2026-10-25 from that vendor's own page. Shortcode: [cloudflare_ai_search] Example: wp_ai_client_prompt( 'Write a product summary.' )->using_provider( 'skyphusion-ai' ); Other plugins can call cloudflare_ai_provider_embeddings() and skyphusion_ai_query(). cloudflare_ai_search_query() still calls the same helper. The search helper posts to the public chat/completions path. It does not send a token. Cloudflare, the Cloudflare logo, and Cloudflare Workers are trademarks and/or registered trademarks of Cloudflare, Inc. in the United States and other jurisdictions. This plugin is an independent work. Cloudflare, Inc. does not sponsor or endorse it.

安装:

  1. Upload the plugin and activate it.
  2. In Cloudflare, turn on the public endpoint for your AI Search instance.
  3. In WordPress, open Settings, then Skyphusion AI. Paste that address.
  4. Paste the account id.
  5. Open Settings, then Connectors. Save the Workers AI API token for Cloudflare.

常见问题:

Where do I get the endpoint address?

Open the Cloudflare dashboard. Go to AI Search, then your instance, then Settings, then Public endpoint. Copy the address that ends in search.ai.cloudflare.com. The Skyphusion AI screen links there.

Where does the API token go?

Save it in Settings, then Connectors. WordPress passes that token to the skyphusion-ai provider through the AI Client. WordPress also reads the SKYPHUSION_AI_API_KEY environment variable or constant for that provider. The plugin does not read the saved option itself. The plugin reads the CLOUDFLARE_API_KEY environment variable or constant first. You can put the account id in front of the token as account-id:api-token. This plugin's own option never stores the token. The Skyphusion AI screen says which source is in use. It says when the saved token is not being used. It does not show the token.

Does the plugin stop at a neuron budget?

Yes. The default is 10,000 neurons a day. Cloudflare free plans include that allowance. Past it, you pay Cloudflare. The plugin does not add a fee, and it does not send the site to another company. You can raise it under Settings, then Skyphusion AI. At that number, the next Workers AI call stays on the site until 00:00 UTC. You can instead send a plain text call to the cheapest priced model on the account. Backfill, embeddings, the site assistant, translation, vision, images, and speech still pause. Each tool can have its own daily limit. Zero means that tool has no limit of its own. Embeddings start at 3,000 neurons. The site assistant starts at 1,000 neurons, and that limit counts only while the assistant is on. A tool at its limit stops. The other tools continue. The screen shows today's use for each tool. It warns when those limits, including the backfill limit while that job is on, add up to more than the daily budget. The totals do not store an IP address. The public search box and the chat button are not in the total and they are not in the tool limits. The plugin mails the site admin at 80% and at 100%. On a later UTC month it mails the previous month's neurons and calls, once. That mail is the stored totals. It has no prompt and no IP address. A month with no stored use sends nothing. A repeated prompt is answered from memory for 10 minutes and costs no neurons. A regenerate asks again. The public search box is not cached. The cache key has no IP address. The AI Search rate limit is their cap. The admin bar says free next to 10000 when no budget is saved. After a call, an editor can see the feature, the model, the neurons, and the time. The receipt does not store an IP address.

Does AI Gateway see which feature ran?

Yes, when a gateway id is saved. Each Workers AI call sends the site, the feature, the model, and the user id. A visitor sends an empty user id. The prompt is not in that tag. A direct Workers AI call does not send the tag.

Does the search answer show its sources?

Yes. The search results page lists the pages under the sentence. A page with an address is a link. A page with no address stays as text. A failed search shows no sentence and no list.

Does a saved post get an embedding?

The settings screen shows passages, neurons, days, and stored dimensions before the first run. Run the sync there, or run wp skyphusion-ai embed run when embeddings are on. A published post is stored in Cloudflare Vectorize. A post that did not change is not sent again. A password-protected post is left out. An editor can leave one post out. The embeddings daily limit does not stop the other tools. Deleting the plugin leaves the index in the Cloudflare account.

Can a member search the stored pages?

Yes. Place [skyphusion_ai_member_search] on a page. A signed-in member in a chosen role gets a list of pages. There is no generated answer. A logged-out visitor keeps the normal search and spends nothing. A repeated search is remembered for one hour. The same list can sit above the normal search for those members.

Do single posts show related pages?

The list uses the stored vectors. A page view does not call the model. The settings screen has a switch. You can also place [skyphusion_ai_related].

Does the site record searches?

The settings screen lists searches that found no page. The words stay in this site's database. An IP address is not stored. A repeat from the same visitor within one hour is skipped. Rows older than 90 days are removed. An admin can ask once for a topic to write.

Can the site answer from its own pages?

The site assistant is off until you turn it on. You can deploy an assistant Worker from this screen, or with wp skyphusion-ai worker deploy. A blank address keeps the PHP call and streams the answer. The page does not show the token. A saved address streams from the Worker. The Worker finds the pages in one step. It asks the site each hour for the next empty text. The site writes that text. It answers from the stored pages and lists those pages. Signed-in people with one capability can ask. You can open it to every visitor instead. The chat button stays as it is. A saved chat needs the visitor to agree. An IP address is not stored. The assistant stops when the daily neuron budget is spent. It can also stop at its own daily limit. That limit does not stop the other tools. Zero means this job has no limit of its own. Place [skyphusion_ai_assistant] on a page.

Can empty alt text be filled?

An hourly job can fill empty alt text and an empty SEO description. It is off until you turn it on. It does not replace text you wrote. It writes the field used by Yoast, Rank Math, All in One SEO, or SEOPress. It stops when the daily neuron budget is spent. Each hour continues until the empty fields are done or today's backfill limit is reached. That limit does not stop the other tools. The screen shows a skipped item and a retry. The SEO job sends the title and the page text. It skips a page with fewer than 40 characters of text. It cuts the text at 6000 characters. The alt text job reads the image. A decorative image is marked and the alt field stays empty.

Can a theme translate a string?

Yes. Call skyphusion_ai_translate() with the text and a language code. See docs/translate.md. The call stops when the daily neuron budget is spent. The error text does not include the API token.

Can the editor suggest internal links?

Yes. The post editor lists a page when its title is already in the post. It also lists a return link when this title is already a whole word in another published post or page. Neither page is changed. The same screen lists published posts and pages that nothing links to. Outbound suggestions use the stored vectors. The editor does not call the model.

Can I edit the prompts?

Yes. Settings, then Skyphusion AI, lists each prompt this plugin sends. Reset restores one prompt. A test runs one call and shows the neuron cost. The empty text job, the site assistant, the link chat, and the search list use the saved text. The translation helper does not send its instruction.

Can I choose the model?

Yes. Settings, then Skyphusion AI, has a picker for writing, vision, image, speech, and embeddings. The plugin reads the models on your Cloudflare account and keeps that list for 12 hours. If the list cannot be read, the built-in models stay. An empty picker uses the built-in model for that job. A light model is optional. Titles, excerpts, meta descriptions, moderation, and alt wording use it when it is set. Leave it empty and the writing model stays in use. A model the editor already picked stays that model. The field does not fill in a model on its own.

Does the chat button cost extra?

This plugin does not charge a subscription. Cloudflare bills the account that owns the AI Search instance. The search box only lists pages. The chat button answers in a sentence and uses more of that allowance. You can leave the chat button off. You can expand that button with Cloudflare Workers AI or with Cloudflare AI Gateway. The prices are in the Cost section of README.md.

Does search show how many are in stock?

Yes. The dropdown card shows the product image, the title, and the meta description. The image is the page image. You do not add a field for it. On a single product page the plugin adds the SKU, the stock status, and the managed stock count to that description. The card quotes the new description after the next crawl. A browser refresh does not start that crawl. The search results page also prints the managed count under each product, for example "4 available." A product that does not manage stock prints the status and no count. A variable product prints a count only when the parent manages stock. Variation counts are not added together. A negative count is not printed. Zero is printed.

How do I give AI Search the stock count?

The dropdown does not need a new field. It already quotes the meta description. Install this plugin. Turn on stock management in WooCommerce and save a quantity when you want a number. Then crawl the site again. In the Cloudflare dashboard, open the instance and choose Sync index. With Wrangler, in the account that owns the instance: npx wrangler ai-search jobs create your-instance Replace your-instance with the instance name. The namespace defaults to default. Then list the job: npx wrangler ai-search jobs list your-instance The job is not instant. A new job can be started every 30 seconds. The stock_quantity meta tag is a separate filter. AI Search ignores that tag until you add the field. You add it in the Cloudflare account that owns the instance. The plugin cannot add it. You do not add it for the dropdown.

  1. In WooCommerce, open the product. Turn on stock management. Enter the quantity. Save the product.
  2. In the Cloudflare dashboard, go to AI, then AI Search, then your instance.
  3. Open Parser options, then Custom metadata. These controls are in the instance settings.
  4. Add a field. Set the name to stock_quantity. Set the type to number. Keep every field you already have.
  5. Save. Cloudflare indexes the site again. This is not instant.
An instance allows five custom fields. This field uses one of them. npx wrangler ai-search update does not set custom metadata. Do not use it to add this field. The create command does, and only for a new instance. Repeat every field you want to keep: npx wrangler ai-search create your-instance --custom-metadata title:text --custom-metadata description:text --custom-metadata image:text --custom-metadata stock_quantity:number Do not create a second instance to add this one field. On an instance you already have, use the dashboard or the API. If you use the API, add {"field_name": "stock_quantity", "data_type": "number"} to custom_metadata with the fields you already have. Do not send that object as the only field. That removes the other fields. The Wrangler commands are documented at https://developers.cloudflare.com/ai-search/wrangler-commands/ . That page was updated on 2026-07-08.

Does this replace another AI provider?

No. A caller that wants this provider uses using_provider('skyphusion-ai'). You can expand those calls with Workers AI or with AI Gateway. The four agent tools sit next to WooCommerce in docs/agent-tools.md. The plugin registers one read-only search ability, skyphusion-ai/search, and the steps are in docs/search-ability.md.

更新日志:

0.6.3 0.6.2 0.6.1 0.6.0 0.5.3 0.5.2 0.5.1 0.5.0 0.4.1 0.4.0 0.3.3 0.3.2 0.3.1 0.3.0 0.2.2 0.2.1 0.2.0 0.1.0