Quesen Deterministic Agent Decision Layer

Quesen — 开发者门户

Quesen 是 Agent 操作的确定性决策与回执核心 — 输入经过类型化的安全上下文，输出 PASS / REVIEW / BLOCK / SKIP 判定，并提供 机器可读的原因代码，以及一份可逐字节重新运行并验证的回执。 评分路径中不包含模型推理，因此相同输入始终产生相同判定。它旨在位于注入检测之后、 Agent 身份之上，并按每次决策计费（ASP/402）。

与审计轨迹由日志驱动、记录内容“由其自行说了算”的治理层不同，Quesen 回执可由调用方独立验证 — 可重新计算，并且（启用引擎签名时）使用 Ed25519 签名。请参阅 docs/architecture-gap-closers.md 以及 quesen-sdk ≥ 0.5.0 中客户端侧的强制执行 + 回执验证。 生产环境引擎签名已上线 — 在 docs/verify-live-receipt.md 中自行验证真实的签名回执（无需信任 Senueren）。

本仓库是公开的开发者门户，仅包含 文档、集成指南、示例、注册清单和参考链接。这里不包含任何引擎源代码。 Quesen 的引擎 实现属于自主的非公开基础设施。

生产环境实时服务

接口	URL
REST API	https://api.senueren.co.za
MCP (Streamable HTTP)	https://api.senueren.co.za/mcp
OpenAPI 3.1	https://api.senueren.co.za/openapi.json
Swagger UI	https://api.senueren.co.za/docs
健康状态	https://api.senueren.co.za/health
版本	https://api.senueren.co.za/version

---

快速开始（30 秒）

最快方式 — 无需安装、注册或银行卡。 自助获取免费的沙盒密钥，并在生产环境中运行一次 真实的确定性决策。完整指南：docs/QUICKSTART.md · 在浏览器中试用：senueren.co.za/try。

# 1 · get a free sandbox key
curl -X POST https://api.senueren.co.za/sandbox/keys

# 2 · evaluate an action (use the api_key from step 1)
curl -X POST https://api.senueren.co.za/validate \
  -H "X-API-Key: sk_sandbox_..." \
  -H "Content-Type: application/json" \
  -d '{"domain_age_days": 1, "engagement_ratio": 0.95, "scam_keyword_count": 4}'
# -> {"decision":"SKIP","risk_score":1.0,"conflict_triggers":[...],"input_snapshot_hash":"..."}

SDK

已发布。 SDK 已在 PyPI 和 npm 上线（quesen-sdk 0.5.0 / npm 0.5.0； quesen-langchain、quesen-crewai、quesen-autogen 0.3.0）。所有 SDK 的 base_url + X-API-Key（包括上面的沙盒密钥）都相同。

Python

pip install quesen-sdk   # PyPI: https://pypi.org/project/quesen-sdk/

from quesen_sdk import QuesenClient

q = QuesenClient(base_url="https://api.senueren.co.za",
                 api_key="YOUR_KEY")   # a sandbox key from /sandbox/keys works here

verdict = q.validate(domain_age_days=1, engagement_ratio=0.95, scam_keyword_count=4)
if verdict.decision == "SKIP":
    return  # respect the deterministic answer

JavaScript / TypeScript

npm i quesen-sdk   # npm: https://www.npmjs.com/package/quesen-sdk

import { QuesenClient } from "quesen-sdk";

const q = new QuesenClient({
  baseUrl: "https://api.senueren.co.za",
  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
CrewAI	quesen-crewai	Shxnque/quesen-crewai
AutoGen v0.4+	quesen-autogen	Shxnque/quesen-autogen
Python（核心）	quesen-sdk	Shxnque/quesen-sdk-py
JavaScript / TypeScript	quesen-sdk (npm)	Shxnque/quesen-sdk-js

MCP（Claude Desktop、Cursor、Windsurf 等）

Quesen 通过生产端点提供 五个 MCP 工具。客户端配置代码片段请参阅 docs/mcp.md。

---

为什么选择 Quesen？

自主 Agent 每秒做出的决策，比任何人工监督所能审计的数量都多。当这些决策涉及资金——发行代币、开仓、执行交易、批准智能合约部署——一次错误决策的边际成本就可能是致命的。

Quesen 只回答一个问题：

调用它的 Agent 是否应该继续执行此操作？

输入有明确类型。输出为 PROCEED、REVIEW、SKIP 之一，且始终包含 [0.0, 1.0] 范围内的 risk_score、[0.0, 1.0] 范围内的 confidence，以及触发的确切冲突规则。相同输入 → 相同输出。每次都如此。 每个响应都包含 engine_version、weights 和 thresholds。完全可复现。完全可审计。

Quesen 不是什么

• 不是 LLM 封装器。 没有提示词。没有概率。
• 不是聊天机器人。 它是 A2A 基础设施。
• 不是 KYC/身份系统。 它评估的是风险，而不是身份。
• 不受链 / 框架 / LLM 限定。 它在设计上与生态系统无关。

---

文档

• 快速入门 — 不到 10 分钟即可完成首次决策（免费沙盒密钥）。
• 架构概览
• 集成指南
• API 参考
• MCP 设置
• 定价档位
• 常见问题
• 注册表状态
• 证据与案例研究 — 已验证的上游合并记录，以及可实时逐字节重放的回执。仅提供工程 / 标准证据；不声称已有客户使用成果。

独立验证

仅凭本仓库即可独立复现已发布的回执——无需托管服务或私有引擎：

python3 verify/verify_receipts.py          # offline, stdlib-only
python3 verify/verify_receipts.py --live   # also cross-check the live engine

所有六个 UCP #724 向量均显示，已发布的测试夹具、公开参考实现和在线引擎三方逐字节完全匹配 （verify/README.md、verify/three_way_match.json）。 该文档也如实说明了当前独立验证的局限（生产规则集的 commit_sha 无法公开解析；回执尚未由签发方进行密码学签名）。

出口 / 权限决策子集——安全集成方设置门禁时关注的部分——现在也可在离线环境中独立重放判定结果，且完全不需要联网：

python3 evaluation/conformance/verify_conformance.py   # offline; recomputes decision+reasons+hash

六个案例（OWASP-agentic + LoopX prepared-Effect PASS/REVIEW/BLOCK）可通过公开参考评估器逐字节重新计算，另有 prod-1→prod-2 完整性翻转检查——无需注册、密钥或托管调用 （evaluation/conformance/README.md）。

教程

• Moltbook 帖子发布前防护 — 面向自主社交 Agent 的确定性发布前安全门禁。
• OpenClaw MCP 插件 — 将 Quesen 接入 OpenClaw 风格的 Agent，作为原生 MCP 防护机制。

---

Live status

• Production: https://api.senueren.co.za
• Health check: GET /health returns {"status":"ok","engine_version":"1.10.0"}
• Version snapshot: GET /version returns full engine + billing + on-chain flags (ASP/1.0)
• Uptime and version widget on senueren.co.za/quesen

---

Registry presence

Quesen is discoverable via Model Context Protocol registries and the standard agent-directory ecosystem. See docs/registries.md for the current state of each submission. Manifests:

• smithery.yaml — Smithery.ai (canonical)
• mcp.json — MCP.so / generic MCP client (canonical)
• .well-known/ai-plugin.json — OpenAI plugin manifest / .well-known/ai-plugin.json autodiscovery
• llms.txt — machine-readable summary for LLM crawlers

---

Contributing

This is a documentation-only repository. Engine PRs cannot be accepted here. If you have integration-specific feedback, please open an issue or read CONTRIBUTING.md.

SDK contributions belong in the corresponding public SDK repository:

• Python: Shxnque/quesen-sdk-py
• JavaScript: Shxnque/quesen-sdk-js
• LangChain: Shxnque/quesen-langchain
• CrewAI: Shxnque/quesen-crewai
• AutoGen: Shxnque/quesen-autogen

Security issues: please read SECURITY.md before filing publicly.

---

Community

Follow build updates, agent-governance notes, and Quesen releases on X: @SenuerenGroup · web: senueren.co.za · senueren.co.za/quesen.

If a Quesen integration or a merged contribution helped your project, a follow or a note at @SenuerenGroup is always appreciated.

---

License

MIT. See LICENSE.