@ deerdesign/ deertools (英语)

官方"鹿图"CLI:对"鹿图"产品API的安全,范围认证和AI代理访问.

从您的计算机登录一次, 并允许您的 AI 编码代理( Antigravity, Cursor, Claude Code, Loveable, CLI 代理) 访问 DeerTools APIS 代表您严格按照您的权限范围, 且在 URL 中不显示任何证书。 。 。 .

支持产品

(两个英文名字都像 catalog, (中文(简体) ), estimate, (中文(简体) ), deliveries, (中文(简体) ), skills 和留下的波兰名字,如 katalog, (中文(简体) ), kosztorys, (中文(简体) ), dostawy, (中文(简体) ), umiejetnosci 以互换方式支持.

安装

要求数 节点.js 18零运行时间依赖.

选项1:立即运行 npx (不需要安装)

npx -y @deerdesign/deertools@latest login catalog

备选方案2:在全球安装

npm install -g @deerdesign/deertools

安装两个 deertools 二进制和方便的短名 deer数字 :

deertools --help
# or
deer whoami

认证(OAuth 2.1 + PKCE S256)

鹿图斯 CLI 执行官方 OAuth 2.1 与PKCE的授权代码赠款(RFC 8252,RFC 8414)数字 :

# Log in to a single product with read-only access (default):
deertools login catalog

# Log in to other products (in English or Polish):
deertools login estimate         # or: deertools login kosztorys
deertools login deliveries       # or: deertools login dostawy
deertools login supplier
deertools login rendermind
deertools login skills           # or: deertools login hub

# Request read + write scopes:
deertools login catalog --write
deertools login skills --write

# Interactive login across all 6 products sequentially:
deertools login all

# Check current authentication status and expiration:
deertools whoami

# Check status in machine-readable JSON format:
deertools whoami --json

# Revoke local credentials:
deertools logout catalog

引擎盖下如何运作

1. RFC 8414 发现: CLI 查询 /.well-known/oauth-authorization-server 在产品主机上发现授权和符号端点.
2. 循环服务器: CLI 启动 ephemeral HTTP 服务器 127.0.0.1:<random-port> 并生成加密安全的PKCE代码验证器和S256挑战.
3. 浏览器同意:用户默认浏览器打开产品 /oauth/authorize 页 次 用户认证(Microsoft SSO / SSO / Magic Link)并批准所请求的范围.
4. 单一用途授权代码:浏览器以短寿命的授权代码(60秒TTL)重定向到回路服务器. 查询字符串中从未出现任何密钥或符号 .
5. 直接汇兑: CLI 直接发送 POST 至产品的符号终点(/oauth-token)与代码验证器.
6. 本地存储:产品发行了范围化的API密钥(Adeer_<product>_live_...有效期为90天。 CLI坚持在 ~/.deertools/credentials.json 带有严格的 POSIX 文件权限(0600) (中文(简体) ).

AI 代理集成和使用

1. 检查文件和规格

# Read high-level llms.txt (public overview and authentication instructions):
deertools docs catalog
deertools docs rendermind

# Fetch full OpenAPI 3.0 JSON specification:
deertools docs catalog openapi

# List all available endpoints with required scopes:
deertools endpoints catalog

2. Invoke产品 API

CLI 自动处理授权信头, 拒绝对非白名单主机的任何请求 :

# Call GET endpoint:
deertools api catalog GET /api/v1/products --query category=flooring

# Call POST endpoint with JSON payload:
deertools api rendermind POST /api/v1/visualizations --data '{"prompt":"Modern Scandinavian kitchen"}'

# Read payload from file:
deertools api rendermind POST /api/v1/visualizations --data-file request.json

3. 开发者与环境公用事业

DeerTools CLI严格注重认证,远程MCP管弦乐,和DeerSkills Hub管理. 域运算和商业逻辑直接由产品平台(Kosztorys, Katalog, Dostawy, Supper Hub, RenderMind)托管,并通过他们自己的REST API和远程MCP端点访问.

# 1. Environment & API Doctor:
deertools doctor
deertools doctor --json

# 2. Shell Autocompletion (Zsh, Bash, Fish):
deertools completion install      # automatically configures ~/.zshrc or ~/.bashrc

# 3. BaseLinker Hub & MCP Proxy:
deertools baselinker auth <X-BLToken>           # Save BaseLinker token to credentials.json
deertools baselinker test                       # Test authorization and list product catalogs
deertools baselinker serve --port 3456          # Launch local Web UI dashboard + MCP SSE server
deertools baselinker mcp                        # Stdio MCP bridge (Cursor / Claude Desktop)
deertools baselinker sync-schema                # Download and refresh 204 API methods from api.baselinker.com
deertools baselinker search "relations"         # Search BaseLinker methods and parameter schemas
deertools baselinker call getOrders             # Direct API method execution from terminal
deertools baselinker catalog search 105 "oak"   # Search products in BaseLinker catalog

# 4. Local Stdio MCP Bridge (for Claude Desktop, Ollama, local LLM tools):
deertools mcp serve

# 5. Audit Log:
deertools audit --limit 25
deertools audit --clear

# 6. Multi-Profile Management:
deertools profile list
deertools profile use staging

# 7. AI Agent Skills (DeerSkills Hub):
deertools skill list                         # View list of skills with installation status across agents
deertools skill sync                         # Pull and update skills from Hub (protects local changes)
deertools sync --push                        # Full two-way sync: pull updates + push newer local skills to Hub
deertools skill install --all                # Alias for skill sync (full team synchronization)
deertools skill install deer-kosztorys       # Install specific skill to detected AI agent environments
deertools skill install deer-kosztorys --version 1.0.0
deertools skill search "pricing"             # Search skills by keyword, tag, or description
deertools skill push ./my-skill              # Publish new version with automated secret scanning
deertools skill push ./my-skill --tags "pricing, margins, design" # Attach tags upon publish
deertools skill push ./my-skill --team architects # Publish directly to specific team space
deertools skill share my-skill --team architects   # Share private skill with team members
deertools skill share my-skill --private           # Revoke sharing (private to author only)
deertools skill update deer-kosztorys        # Update installed skill to latest Hub version
deertools skill update                       # Update all installed skills across agents
deertools skill promote my-skill             # Submit promotion request to company-wide global registry

# 8. Team Management:
deertools team list                          # List teams, member counts, and assigned skills
deertools team members architects            # List members and roles in the architects team
deertools team add architects [email protected]   # Add user to team (member role)
deertools team add architects [email protected] --role lead # Add team lead
deertools team remove architects [email protected] # Remove member from team
deertools team create "Interior Designers" --slug designers # Create new organization team

# 9. AI Agent MCP Registry & Configuration:
deertools mcp list                           # List available MCP servers across the ecosystem
deertools mcp config                         # Print JSON MCP configuration for manual pasting
deertools mcp install                        # Automatically write & update MCP config across ALL 7 agent targets
deertools doctor                             # Verify MCP connectivity, auth tokens and client config files

AI 代理 MCP 配置和工具化( Cursor, Antigravity, Claude)

@deerdesign/deertools 提供7个官方MCP服务器,覆盖完整的"鹿"设计生态系统:

1. deer-estimate:平面计划PDF分析,厨房检测,内部成本计算.
2. deer-catalog:17k+ 完成材料(Smart/Modern/High Life),技术规格,过滤.
3. deer-deliveries:站点交货跟踪,供应商发货,仓库WZ生成.
4. deer-supplier:供应商订单,购买折扣,销售加价,商业条件.
5. deer-rendermind: 内部渲染,pCon CAD可视化,产品相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相.
6. deer-baselinker:完整 BaseLinker目录 CRUD,定价批次更新,智能快取.
7. deer-skills: 鹿技能 枢纽登记、技能搜索、下载和审查管道.

1. 自动零配置设置(建议)

您不需要手动编辑 JSON 文件 。 仅登录或运行 :

deertools login all    # Automatically logs in and syncs MCP configs across all clients
# or at any time:
deertools mcp install  # Re-generates and writes configuration to all 7 targets

deertools mcp install 自动发现并写入所有7个支持的AI环境:

随时用 :

deertools doctor

2. 手工配置和克洛德整合细节

如果手动配置或添加到已有设置中 :

A. 项目一级 .mcp.json (为克洛德代码和同事推荐)

创建或编辑 .mcp.json 在您的工程根中 :

{
  "mcpServers": {
    "deer-rendermind": {
      "command": "/Users/<your-user>/.local/bin/deertools",
      "args": ["rendermind", "mcp"],
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Users/<your-user>/.local/bin"
      }
    },
    "deer-baselinker": {
      "command": "/Users/<your-user>/.local/bin/deertools",
      "args": ["baselinker", "mcp"],
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Users/<your-user>/.local/bin"
      }
    },
    "deer-catalog": {
      "url": "https://ftzaobeixglnssemugjf.supabase.co/functions/v1/catalog-mcp",
      "headers": {
        "x-api-key": "<your-catalog-key>",
        "Authorization": "Bearer <your-catalog-key>"
      }
    },
    "deer-estimate": {
      "url": "https://vlemuxlubrowuuxpgllk.supabase.co/functions/v1/estimate-mcp",
      "headers": {
        "x-api-key": "<your-estimate-key>",
        "Authorization": "Bearer <your-estimate-key>"
      }
    }
  }
}

[大 Claude 桌面和 Claude 代码的关键规则 :

1. 在macOS上选择继承: 桌面图形用户界面应用程序( 如 Claude 桌面) 不继承您的终端外壳 $PATH (单位:千美元)~/.local/bin, (中文(简体) ), /usr/local/bin) (中文(简体) ). 总是指定绝对二进制路径(例如. ~/.local/bin/deertools并包括 env.PATH 如上所示的块 node 并且儿童过程可以不犯错误地产生.
2. 项目信任对话框: 在项目一级打开工作空间时 .mcp.json,克洛德显示安全同意的提示("所有MCP服务器 从.mcp.json?") (中文(简体) ). 您必须点击 允许/ 总是允许 以激活工具.
3. 需要恢复会话: MCP 服务器工具在对话会话初始化时严格注册. 如果您在会话已激活时配置 MCP, 请启动 新建聊天( N)Cmd + N(中文(简体) ) 或重新启动 Claude 应用程序(Cmd + Q) MCP 工具不能被热重装入持续的对话中.

BaseLinker MCP 代理和目录管理

@deerdesign/deertools 包括内置、本地 碱克 MCP 代理控件( H) 提供深层目录管理:

1. 产品目录和变量数字 :
   • bl_catalog_get_product: 有描述,特征,频道特有介质,捆绑和关系的详细产品数据.
   • bl_catalog_create_or_update_product: 使用 SKU, EAN, 税率, 尺寸, 重量, 制造商, 类别创建或更新产品.
   • bl_catalog_search_products:按名称、SKU、EAN、类别或制造商过滤产品.
2. 关系和交叉销售数字 :
   • bl_catalog_set_relations:建立产品关系(related, (中文(简体) ), substitution, (中文(简体) ), upsell, (中文(简体) ), downsell, (中文(简体) ), crosssell) (中文(简体) ).
3. 产品特性自定义文本字段( C)数字 :
   • bl_catalog_set_descriptions_and_features: 更新描述和密钥值参数地图(features每个语言.
4. 媒体和图像收藏数字 :
   • bl_catalog_manage_images: 在0–15位置上添加图像 URL / Base64,替换相片,或清晰位置.
5. 类别、制造商和标签数字 :
   • bl_catalog_categories, (中文(简体) ), bl_catalog_manufacturers, (中文(简体) ), bl_catalog_tags: 全 CRUD 用于组织分类.
6. 大宗价格和股票更新数字 :
   • bl_catalog_update_prices_batch 打开 bl_catalog_update_stock_batch:每个呼叫最多可更新1000个项目.
7. 费率限制和安全性数字 :
   • 内置活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活性活.
8. 现场网络盘数字 :
   • 运行 deertools baselinker serve 打开本地网络用户界面 http://localhost:3456 和代理审计流.

鹿技能枢纽和MCP生态系统

鹿技能枢纽 (单位:千美元)https://skills.deergroup.pl)是跨"鹿"设计生态系统分布,版本,管理AI Agent Swills和MCP服务器的中心平台:

1. 三Tier 范围与权限模型数字 :
   • 公司技能global(中文(简体) ):经验证的全组织性工具,所有员工可见,代理初始化期间默认安装.
   • 团队范围技能(team(中文(简体) ):专为特定功能团队(如:建筑师,销售顾问,估算师,物流,IT-Dev). 可见和可安装 严格 由该团队的成员。 团队和角色完全可以通过 deertools team 和网络门户.
   • 个人技能user(中文(简体) ):每个雇员都可以在个人姓名空间发表 @username/skill-slug在提交人明确与他们的团队分享之前,这些保留是100%的私人保留(第3条)deertools skill share --team <slug>)或将其提交全球推广(deertools skill promote) (中文(简体) ).
2. 自动秘密扫描仪数字 :
   • 每个 deertools skill push 运行一个全程的regex扫描仪,用于活符和API密钥(deer_*_live_, (中文(简体) ), ghp_, (中文(简体) ), sk-, (中文(简体) ), X-BLToken,密码).
   • 任何未删减的秘密都会引发直接的安全中止,并带有特定的线条引用,防止上传前的证书泄漏.
3. SemVer 版本和视觉 Diff数字 :
   • 所有修订都遵循语义版(1.0.0 - > (中文) 1.0.1 - > (中文) 1.1.0) (中文(简体) ).
   • 网页门户有一个交互的相邻视觉 diff 比较文件树和 SKILL.md 内容介于发布之间.
   • CLI 支持 --bump patch|minor|major 或明确的版本旗帜.
4. 跟踪.deertools-lock.json(中文(简体) )数字 :
   • 安装后的技能在当地跟踪 .deertools-lock.json 并安装了时间戳.
   • deertools doctor 财务报告和审定财务报表 deertools skill check 检测过时的技能,并及时自动更新.
5. 促销管道 ("提名全球")数字 :
   • 作者可以通过下列方式向官方公司目录宣传个人或团队技能: deertools skill promote <slug>。 。 。 .
   • 管理员在管理仪表板上审查同行请求,并一击批准.
6. AI 代理工具集成(课程/反重力/克洛德)数字 :
   • DeerSkills Hub 曝光专用远程MCP服务器(https://skills.deergroup.pl/functions/v1/skills-mcp)符合MCP 2024-11-05标准.
   • 工具包括: hub_search_skills, (中文(简体) ), hub_get_skill, (中文(简体) ), hub_publish_skill_version, (中文(简体) ), hub_list_mcp_servers, (中文(简体) ), hub_get_ecosystem_products。 。 。 .

无头 & CI/CD 环境

在没有浏览器交互的CI管道或容器化剂中,通过环境变量提供API密钥:

export DEERTOOLS_CATALOG_KEY="deer_catalog_live_..."       # or DEERTOOLS_KATALOG_KEY
export DEERTOOLS_ESTIMATE_KEY="deer_kosztorys_live_..."    # or DEERTOOLS_KOSZTORYS_KEY
export DEERTOOLS_DELIVERIES_KEY="deer_dostawy_live_..."    # or DEERTOOLS_DOSTAWY_KEY
export DEERTOOLS_SUPPLIER_KEY="deer_supplier_live_..."
export DEERTOOLS_RENDERMIND_KEY="deer_rendermind_live_..."

# Custom credentials directory:
export DEERTOOLS_HOME="/custom/path/.deertools"

退出代码

开发和测试

DeerTools CLI是用纯,无依赖的现代节点来写成的.js使用内置模块(node:crypto, (中文(简体) ), node:http, (中文(简体) ), node:fs, (中文(简体) ), node:test) (中文(简体) ).

# Run test suite:
npm test

许可证

麻省理工学院鹿设计AI团队