Title: gmss-agent
Author: gmsspress
Published: <strong>2026 年 6 月 13 日</strong>
Last modified: 2026 年 6 月 13 日

---

搜索插件

![](https://s.w.org/plugins/geopattern-icon/gmss-agent.svg)

# gmss-agent

 作者：[gmsspress](https://profiles.wordpress.org/gmsspress/)

[下载](https://downloads.wordpress.org/plugin/gmss-agent.zip)

 * [详情](https://cn.wordpress.org/plugins/gmss-agent/#description)
 * [评价](https://cn.wordpress.org/plugins/gmss-agent/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/gmss-agent/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/gmss-agent/#developers)

 [支持](https://wordpress.org/support/plugin/gmss-agent/)

## 描述

gmss-agent adds a customizable floating chat widget to every page of your WordPress
site. Visitor questions are answered by matching them against a JSON knowledge-base
file you provide. Everything runs locally on your server — no API key, no third-
party service, no visitor data sent anywhere.

The plugin is designed for support, FAQ, and lightweight pre-sales conversations
where you want answers limited to information you have written and approved.

**Features**

 * Floating chat widget with configurable title, welcome message, primary color,
   and corner position (bottom-right or bottom-left).
 * Local matcher with weighted token-overlap scoring: title hits and explicit keyword
   hits are ranked above body hits, with a phrase bonus when the visitor’s full 
   query appears in an entry.
 * Optional `keywords` array on each entry to handle synonyms the body text does
   not contain.
 * Configurable fallback reply when no entry matches the visitor question.
 * JSON knowledge base loaded from a single `knowledgebase.json` file at the root
   of your WordPress install.
 * Ships with a sample knowledge base so the widget answers something out of the
   box.
 * REST endpoint protected by a WordPress nonce.
 * Translation-ready (text domain: `gmss-agent`).

**Requirements**

 * WordPress 5.8 or newer and PHP 7.4 or newer.

### Privacy

The plugin does not set cookies, does not write to any custom database tables, does
not contact any external service, and does not log visitor messages on your server.
Settings are stored in the standard WordPress `wp_options` table and are removed
when the plugin is uninstalled via the Plugins screen. The knowledge base file you
create is read from disk on each request and is never transmitted off your server.

## 安装

 1. Upload the `gmss-agent` folder to `/wp-content/plugins/` (or install through the
    Plugins screen in WordPress).
 2. Activate the plugin through the **Plugins** screen.
 3. Go to **Settings > gmss-agent** and customize the widget title, welcome message,
    fallback message, primary color, and position.
 4. Create a file named `knowledgebase.json` at the root of your WordPress install (
    the same folder as `wp-config.php`). The Settings page shows the exact expected
    path and a format example. A sample file ships with the plugin at `wp-content/plugins/
    gmss-agent/knowledgebase-sample.json` — until you create your own, the widget will
    answer using the sample.
 5. Visit your site front-end; the chat widget will appear in the configured corner.

## 常见问题

### Does this plugin send anything to a third party?

No. Visitor questions are matched against your local `knowledgebase.json` file on
your own server. No external service is contacted, no API key is required, and no
visitor data leaves your site.

### How does the matching work?

For each question, the plugin scores every entry in your knowledge base. A point
is awarded each time a query word matches the entry’s body, three points when it
matches the entry’s title, and five points when it matches one of the entry’s optional`
keywords`. The entry with the highest non-zero score wins; if nothing scores above
zero, the visitor sees your configurable fallback message.

### What is the knowledge base file format?

A JSON array of objects, each with a `content` string and an optional `title` and`
keywords` array. The Settings page shows a complete example, and a sample file is
bundled with the plugin.

### Can I use synonyms or alternate phrasings?

Yes — add a `keywords` array to any entry. For example, an entry titled “Pricing
and Quotes” might list `["price", "cost", "quote", "discount"]` so the widget answers
regardless of which word the visitor types.

### What happens when no entry matches?

The visitor sees the fallback message you configured on the Settings page. The default
is “I’m not sure how to answer that. Please contact our team for help.”

### Does it work on multisite?

Yes. Each site stores its own settings. The uninstall routine cleans options across
the entire network.

### Where is the knowledge base file expected?

In the root of your WordPress installation — the same folder as `wp-config.php`.
The Settings page shows the exact filesystem path on your server.

## 评价

此插件暂无评价。

## 贡献者及开发者

「gmss-agent」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ gmsspress ](https://profiles.wordpress.org/gmsspress/)

[帮助将「gmss-agent」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/gmss-agent)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/gmss-agent/)，查看[SVN仓库](https://plugins.svn.wordpress.org/gmss-agent/)，
或通过[RSS](https://plugins.trac.wordpress.org/log/gmss-agent/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/gmss-agent/)。

## 更新日志

#### 1.1.0

 * Removed all external API dependencies. Replies are now generated locally by matching
   visitor questions against the knowledge base file.
 * Renamed `knowledgebase.js` to `knowledgebase.json` and dropped the JS-wrapper
   parser in favor of pure JSON.
 * Added optional `keywords` array on each entry for synonym matching.
 * Added a configurable fallback message setting for unmatched queries.
 * Removed the Anthropic API key and AI model settings.

#### 1.0.0

 * Initial release.

## 额外信息

 *  版本 **1.1.0**
 *  最后更新：**2 周前**
 *  活跃安装数量 **不到10**
 *  WordPress 版本 ** 5.8 或更高版本 **
 *  已测试的最高版本为 **7.0**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/gmss-agent/)
 * 标签
 * [chat](https://cn.wordpress.org/plugins/tags/chat/)[chatbot](https://cn.wordpress.org/plugins/tags/chatbot/)
   [faq](https://cn.wordpress.org/plugins/tags/faq/)[knowledge base](https://cn.wordpress.org/plugins/tags/knowledge-base/)
   [support](https://cn.wordpress.org/plugins/tags/support/)
 *  [高级视图](https://cn.wordpress.org/plugins/gmss-agent/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/gmss-agent/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/gmss-agent/reviews/)

## 贡献者

 *   [ gmsspress ](https://profiles.wordpress.org/gmsspress/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/gmss-agent/)