使用说明
YigYaps：开放式技能注册
🚀 现场试用： https://yigyaps.com
在代理经济中赋予人类权力。 YigYaps是一个独立的、由社区管理的注册机构 YAP（Yigbot增强插件） 技能，完全兼容 模型上下文协议（MCP）.
🧠 YAP哲学：增强智能
名字 YAP 代表 Yigbot增强插件它强调人工智能技能不仅仅是静态工具，而是模块化的认知扩展。 代理+技能=增强代理。 通过将人类的专业知识整合到YAP格式中，我们实现了人工智能代理由经过验证的专业人类智慧驱动的未来。
🌟 愿景：人对代理人评估
YigYaps建立在这样的信念之上 人类专业知识是人工智能时代最有价值的资产。我们正在超越“快速工程” “技能基础设施”.
- 智慧数字化将独特的专业方法论转化为模块化、可查询的MCP工具。
- 身份许可：安全地许可数字双胞胎（包括经过验证的声音和肖像）供授权代理人使用。
- 经济主权：一种可持续的经济，代理人向他们学习的人支付每次通话的版税。
🛠️ 卓越安全与工程
YigYaps专为 安全第一IP保护。我们通过严格的工程解决“知识盗窃”问题：
🛡️ 专家IP防御（信封加密）
- 静止数据：所有敏感的专业知识都受到保护 AES-256-GCM信封加密.
- Shamir密钥拆分：新的受保护上传仅存储平台共享；专家共享被返回给创建者，并且是安全检索/调用所必需的。
- 传统KMS支持：基于KEK的DEK恢复仅适用于Shamir密钥拆分之前的旧记录。
- 短暂解密：规则仅在活动工具执行期间在内存中解密，并立即清零。
💻 开发人员体验（高级CLI）
这 yigyaps CLI为技能创造者提供了世界级的工作流程：
- 交互式入职培训：使用现代、美观的终端提示进行引导设置。
- 验证套件：在发布之前，内置逻辑用于验证MCP合规性。
- 医生模式：自我诊断工具，以确保您的环境配置正确。
💻 技术栈
- 框架: 快速 API 反应 / 维特 （网络）
- 数据库: PostgreSQL + 淋ORM
- 沟通: 模型上下文协议
- 安全：AES-256-GCM、GitHub OAuth、JWT、分层速率限制。
- 运维：Docker多阶段构建，铁路CI/CD。
🚀 本地开发
先决条件
| 要求 | 版本 | 注释 |
|---|---|---|
| Node.js | 22+ | 使用 nvm use — .nvmrc 包括在内 |
| npm | 10+ | 与Node 22捆绑在一起 |
| PostgreSQL | 14+ | 本地安装 或 Docker编写 |
| Docker桌面 | 最新 | 必需 运行测试套件 |
| GitHub OAuth应用程序 | -- | 请参阅设置指南 |
选项A——本地PostgreSQL
# 1. Clone and install
git clone https://github.com/Henghenggao/yigyaps.git
cd yigyaps
nvm use # switches to Node 22 via .nvmrc
npm install
# 2. Create a local database
createdb yigyaps_dev
# 3. Configure environment
cp .env.example .env
# Edit .env: set DATABASE_URL, GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET
# 4. Run migrations and build
npm run db:migrate
npm run build
# 5. Start servers
npm run dev:api # API → http://localhost:3100
npm run dev --workspace=web # Web → http://localhost:5173
选项B——Docker编写
git clone https://github.com/Henghenggao/yigyaps.git
cd yigyaps
cp .env.example .env
# Edit .env: set GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET
docker compose up -d
# Web: http://localhost:5173 | API: http://localhost:3100 | Swagger: http://localhost:3100/docs
运行测试
npm test # fast unit/UI suite; does not require Docker
npm run test:integration # DB/API integration suite; requires Docker or TEST_DATABASE_URL
npm run test:api # API unit tests
npm run test:api:integration
npm test --workspace=web
npm run test:coverage
对于API集成测试，启动Docker/Podman For Testcontainers或 将套件指向一个隔离的PostgreSQL数据库：
$env:TEST_DATABASE_URL="postgres://user:pass@localhost:5432/yigyaps_test"
npm run test:api:integration
集成设置在它之前打印已发现的API规范的数量
启动PostgreSQL；如果容器运行时不可用，请修复Docker/Podman或
提供 TEST_DATABASE_URL 在将释放门视为完整之前。
释放准备就绪
- 安全和CI强化准备 总结了当前的发布决策、验证证据、剩余风险和下一个执行计划。
有用的脚本
npm run build # build all packages
npm run lint # ESLint across the monorepo
npm run db:migrate # apply pending migrations
npm run db:generate # generate new migration from schema changes
npm run db:studio # open Drizzle Studio (visual DB browser)
🔑 GitHub OAuth Setup
- 首选 GitHub开发人员设置 → 新建OAuth应用程序.
- 主页网址:
http://localhost:5173 - 授权回调URL:
http://localhost:3100/v1/auth/github/callback - 复制 客户端ID 并生成 客户端密钥，然后将两者粘贴到您的
.env.
🏗️ Monorepo架构
| 模块 | NPM范围 | 描述 |
|---|---|---|
| 类型 | @yigyaps/types |
共享Zod模式和接口 |
| 数据库 | @yigyaps/db |
Drizzle模式和数据访问层 |
| API | @yigyaps/api |
加速安全后端 |
| 命令行界面 | @yigyaps/cli |
开发人员工具包和发布者 |
| 网络 | web |
多步发布向导和市场 |
🤝 独立誓言
YigYaps是一个 独立注册处与平台绑定商店不同，我们优先考虑：
- 中立：特定型号供应商没有优惠排名。
- 可移植性：此处发布的技能适用于Claude、Cursor、Windsurf和任何未来的MCP客户。
- 社区治理：拒绝和删除决定是公开的，可审计的。
📄 许可和贡献
- 许可证: Apache 2.0
- 贡献: 贡献.md
- 行为准则: 代码_OF_CONDUCT.md
- 建筑: 建筑.md
Built with ❤️ for the future of Human-AI Collaboration.
