内容
# 夸森 — 开发者门户
[](https://spec.modelcontextprotocol.io/)
[](docs/api-reference.md)
[](https://web-production-30ab5.up.railway.app/version)
[](./LICENSE)
> **夸森** 是用于 **A2A（代理到代理）** 风险评估的确定性 AI 决策引擎。它是位于自治代理和资本损失之间的信任过滤器。
>
> 该仓库是 **公共开发者门户**。它只包含文档、集成指南、示例、注册表清单和参考链接。**此处不包含引擎源代码**。夸森的引擎实现是独立的、非公开的基础设施。
**实时生产**
| 接口 | URL |
| :--- | :--- |
| REST API | `https://web-production-30ab5.up.railway.app` |
| MCP（可流式 HTTP） | `https://web-production-30ab5.up.railway.app/mcp` |
| OpenAPI 3.1 | `https://web-production-30ab5.up.railway.app/openapi.json` |
| Swagger UI | `https://web-production-30ab5.up.railway.app/docs` |
| 健康检查 | `https://web-production-30ab5.up.railway.app/health` |
| 版本 | `https://web-production-30ab5.up.railway.app/version` |
---
## 快速开始（30 秒）
### Python
```bash
pip install quesen-sdk
```
```python
from quesen_sdk import QuesenClient
q = QuesenClient(base_url="https://web-production-30ab5.up.railway.app",
api_key="YOUR_KEY")
verdict = q.validate(domain_age_days=1, engagement_ratio=0.95, scam_keyword_count=4)
if verdict.decision == "SKIP":
return # 尊重确定性答案
```
### JavaScript / TypeScript
```bash
npm i quesen-sdk
```
```ts
import { QuesenClient } from "quesen-sdk";
const q = new QuesenClient({
baseUrl: "https://web-production-30ab5.up.railway.app",
apiKey: process.env.QUESEN_API_KEY,
});
const verdict = await q.validate({
domain_age_days: 1,
engagement_ratio: 0.95,
scam_keyword_count: 4,
});
```
### 框架封装
| 框架 | 包 | 仓库 |
| --- | --- | --- |
| LangChain / LangGraph | `quesen-langchain` | [Shxnque/quesen-langchain](https://github.com/Shxnque/quesen-langchain) |
| CrewAI | `quesen-crewai` | [Shxnque/quesen-crewai](https://github.com/Shxnque/quesen-crewai) |
| AutoGen v0.4+ | `quesen-autogen` | [Shxnque/quesen-autogen](https://github.com/Shxnque/quesen-autogen) |
| Python（核心） | `quesen-sdk` | [Shxnque/quesen-sdk-py](https://github.com/Shxnque/quesen-sdk-py) |
| JavaScript / TypeScript | `quesen-sdk`（npm） | [Shxnque/quesen-sdk-js](https://github.com/Shxnque/quesen-sdk-js) |
### MCP（Claude Desktop, Cursor, Windsurf 等）
夸森通过生产环境端点暴露 **五个** MCP 工具。参见
[`docs/mcp.md`](docs/mcp.md) 获取客户端配置代码段。
---
## 为什么选择夸森？
自治代理每秒做出的决策比任何人类监督都多。当这些决策涉及资本时——启动代币、开仓、执行交易、批准智能合约部署——坏决策的边际成本是致命的。
**夸森只回答一个问题：**
> *调用代理是否应该继续执行此操作？*
输入是键入的。输出是 `PROCEED`, `REVIEW`, `SKIP` 之一，始终带有 `[0.0, 1.0]` 中的 `risk_score`, `[0.0, 1.0]` 中的 `confidence`, 以及触发的确切冲突规则。**相同的输入 → 相同的输出。每次都是如此**。每个响应都嵌入了 `engine_version`, `weights` 和 `thresholds`。完全可复制。完全可审计。
### 夸森不是什么
- **不是 LLM 包装器**。没有提示。没有概率。
- **不是聊天机器人**。它是 A2A 基础设施。
- **不是 KYC/身份系统**。它评估风险，而不是身份。
- **不是链锁 / 框架锁 / LLM 锁**。生态系统设计为中立。
---
## 文档
- [架构概述](docs/architecture.md)
- [集成指南](docs/integrations.md)
- [API 参考](docs/api-reference.md)
- [MCP 设置](docs/mcp.md)
- [定价层级](docs/pricing.md)
- [常见问题](docs/faq.md)
- [注册表状态](docs/registries.md)
### 教程
- [Moltbook 发布后守卫](docs/tutorials/moltbook-post-guard.md) — 用于自治社交代理的确定性前后安全门。
- [OpenClaw MCP 插件](docs/tutorials/openclaw-plugin.md) — 将夸森作为 MCP 原生护栏连接到 OpenClaw 风格的代理。
---
## 实时状态
- 生产环境：`https://web-production-30ab5.up.railway.app`
- 健康检查：`GET /health` 返回 `{"status":"ok","engine_version":"1.9.0"}`
- 版本快照：`GET /version` 返回完整的引擎 + 计费 +链上标志（ASP/1.0）
- [senueren.co.za/quesen](https://senueren.co.za/quesen) 上的正常运行时间和版本小部件
---
## 注册表存在
夸森可通过 Model Context Protocol 注册表和标准代理目录生态系统进行发现。有关每个提交的当前状态，请参见 [`docs/registries.md`](docs/registries.md)。 清单：
- [`smithery.yaml`](./smithery.yaml) — Smithery.ai（规范）
- [`mcp.json`](./mcp.json) — MCP.so / 通用 MCP 客户端（规范）
- [`.well-known/ai-plugin.json`](./.well-known/ai-plugin.json) — OpenAI 插件清单 / `.well-known/ai-plugin.json` 自动发现
- [`llms.txt`](./llms.txt) — LLM 爬虫的机器可读摘要
---
## 贡献
这是仅限文档的仓库。引擎 PR 不能在此处接受。如果您有特定于集成的反馈，请 [打开问题](https://github.com/Shxnque/quesen/issues) 或阅读 [`CONTRIBUTING.md`](CONTRIBUTING.md)。
SDK 贡献属于相应的公共 SDK 仓库：
- Python： [Shxnque/quesen-sdk-py](https://github.com/Shxnque/quesen-sdk-py)
- JavaScript： [Shxnque/quesen-sdk-js](https://github.com/Shxnque/quesen-sdk-js)
- LangChain： [Shxnque/quesen-langchain](https://github.com/Shxnque/quesen-langchain)
- CrewAI： [Shxnque/quesen-crewai](https://github.com/Shxnque/quesen-crewai)
- AutoGen： [Shxnque/quesen-autogen](https://github.com/Shxnque/quesen-autogen)
安全问题：请在公开上报前阅读 [`SECURITY.md`](SECURITY.md)。
---
## 许可证
MIT。参见 [`LICENSE`](LICENSE)。
