human-standards

Human Standards

将人因研究转化为实用设计标准、实施指南，以及供 AI Agent 使用的只读上下文。

浏览在线知识库 · 连接 MCP 服务 · 阅读研究 001

Human Standards 对你有用吗？ 在 GitHub 上为项目点星，以便日后查阅，并帮助其他从业者发现它。你也可以关注代码仓库，了解后续发布，或加入公开的讨论。

研究 001 以探索性、由协调员审阅的试点形式发布。 定向 MCP 访问改善了自动化结果，但未能可靠地消除明显的可用性和无障碍问题。原计划的独立审查未能完成，缺失的人工结果也已明确报告。阅读案例研究和证据。

Human Standards 的存在意义

产品团队可以获取关于认知、人体工程学、无障碍、可用性和人机交互的大量研究。将这些证据转化为具体的设计决策仍然很困难，而 AI 辅助的产品工作让这一差距更加明显。

Human Standards 是一个开源参考知识库，旨在让这些知识更易于查阅和应用。人们可以直接浏览指南。兼容的 AI 工具可通过本地只读 MCP 服务检索相同内容。

本项目并不声称可以取代用户研究、无障碍测试、专业判断，或其引用的标准和研究。

包含内容

• 人因指南 — 认知、感知、情绪、决策、人体工程学、无障碍和社会背景
• 设计与实施指南 — 交互模式、实用手册、代码示例和设计令牌约束
• 研究方法 — 可用性测试、认知走查、指标和评估指南
• 证据与参考资料 — 指向指南所依据的标准、出版物和源材料的链接
• 机器可读访问 — 五种只读 MCP 工具，用于搜索、检索、启发式评估，以及以关系为先的空间节奏指南
• 开放评估 — 供独立审查和可复现分析使用的研究方案与证据

当前状态

Human Standards 正在积极开发中，应视为一个持续完善的参考知识库，而非已完成或经过普遍验证的标准。

• 文档知识库可在 humanstandards.org 查看。
• MCP 服务通过已发布的 npm 包在本地运行，使用内置指南，不会写入项目或外部服务。
• 研究 001 以探索性试点形式发布。其方案偏差、自动化证据、协调员观察、条件映射以及缺失的独立审查结果均已公开。
• 欢迎指出不足、提出更正、分享相互竞争的证据，以及提交范围明确的贡献。

使用文档知识库

从入门指南开始，或按主题浏览知识库。每个页面都旨在将原则与实际决策、实施指南，以及可获取的原始或权威来源联系起来。

若要在本地运行网站：

git clone https://github.com/aklodhi98/humanstandards.git
cd humanstandards
npm ci
npm run dev

打开 http://localhost:4321 查看本地网站。

使用 MCP 服务

MCP 服务通过五个只读工具向兼容的 AI 工具开放该库：

• search_standards
• get_standard
• get_heuristic
• get_all_heuristics
• get_spatial_rhythm

MCP 客户端运行 npm 包；它不是应用依赖，也不会成为正在构建的项目的一部分：

npx --yes @humanstandards/mcp-server

配置兼容的 MCP 客户端来运行该命令：

{
  "mcpServers": {
    "human-standards": {
      "command": "npx",
      "args": ["--yes", "@humanstandards/mcp-server"]
    }
  }
}

该服务通过标准输入/输出进行通信，不读取项目文件，不打开网络端口，并使用其软件包版本中捆绑的 Human Standards 快照。有关 Codex、Claude Desktop、Claude Code、源码构建和验证说明，请参阅 MCP 设置指南。

项目命令

命令	操作
npm ci	根据锁定文件安装文档站点依赖
npm run dev	在 localhost:4321 启动本地站点
npm run build	将生产站点构建到 ./dist/
npm run check	构建站点并验证内部链接
npm run preview	在本地预览生产构建
npm run build --prefix human-standards-mcp	编译 MCP 服务
npm test --prefix human-standards-mcp	MCP 服务构建后运行其测试

贡献

有帮助的贡献包括：

• 更正不准确、含糊或过时的指导；
• 添加更有力的一手来源或公认来源；
• 改进示例和实现细节；
• 指出缺失的使用场景、局限性或无障碍考量；
• 报告网站、标准索引或 MCP 服务中的缺陷。

请阅读 CONTRIBUTING.md，了解贡献流程、证据要求、内容结构和本地检查。问题和初步想法可以在 GitHub 讨论区中提出；具体缺陷请提交到 Issues。

许可与署名

• 原创文档和标准数据：CC0 1.0 Universal
• 软件和代码示例：MIT License
• **第三方材料：**保留其原始条款，并记录在 THIRD_PARTY_LICENSES.md 中

Human Standards 汇集了人因学、认知心理学、人机交互、用户体验和无障碍领域的研究成果。库中各处均附有来源引用；更全面的入门资料请参阅学术研究参考资料以及标准和指南。

使用 Astro 和 Starlight 构建。由 AK Lodhi 维护。