🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
广告☁️ 云服务器特惠阿里云首购 8 折 · 腾讯云合作特惠
DeepSeek Harness Hub
← 返回列表

BlackPearl-AI/BlackPearl-CodingAgent

DeepSeek Harnessspec-screened扫描:低风险在 GitHub 查看 ↗
需源码安装

⚡ BlackPearl — 自主 AI 工程操作系统

暂不能直接安装(需源码编译或环境不满足):仓库缺少 package.json,无法用 dsh 插件安装命令安装。 · 最近上游提交 2026/8/30 · 已提供中文文档

BlackPearl — 由 DeepSeek 驱动的 AI 智能体框架与编排生态系统,拥有 286+ 项技能、273+ 个专家智能体、插件、安全、QA 与自动化。

综合分
36.7
GitHub 分
36.7
用户评分
—
★ Stars
8
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add BlackPearl-AI/BlackPearl-CodingAgent
仓库缺少 package.json,无法用 dsh 插件安装命令安装,改用 GitHub 源安装
信任档位:需留意静态安装检查未通过
是什么
dsh 原生插件 · chat
装得上吗
静态安装检查未通过,可能需要源码安装
安全吗
本站尚未对该插件做风险分级(暂未覆盖,不等同于无风险)
还在维护吗
活跃:最近一次提交在 26 天前

档位由下列信号合成:本站实装验证(真实安装,当前最高到 L4)· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →

数据截至 2026/9/20(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查需源码安装

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包BlackPearl-CodingAgent(未发布到 npm,仅可源码安装)
✓Node 引擎未声明 engines.node
✓dsh CLI 依赖未声明 dsh 版本约束
✗入口文件缺少入口声明

仓库缺少 package.json,无法用 dsh 插件安装命令安装

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/20 06:31:05

用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

由 DeepSeek 最新模型翻译生成
⚡ BlackPearl — 自主 AI 工程操作系统

编排。导航。验证。执行。
BlackPearl 是一个全面的、生产就绪的自主 AI 软件工程操作系统。它将 BlackPearl 控制平面(首席监督者与 26 条自主多智能体流水线)、BlackPearl 技能引擎(634+ 工作流技能、68 个子智能体、94 条命令)、BlackPearl 核心引擎(DeepSeek Harness 与 Cordis 多进程工作树快照隔离)以及 BlackPearl 事业部(18 个专业企业事业部 / 273+ 子智能体)统一到一个单一、完全可移植、零配置的 Git 仓库中。

Declaration
Setup Guide
License: MIT
Platforms: Windows | Linux | macOS
Organization

📜 生态系统宣言与起源

阅读完整宣言:📜 DECLARATION.md

BlackPearl 是一个标准化的元操作系统,通过综合全球开源 AI 社区中最高严谨度的架构、规则、执行框架和智能体角色而创建:

- 🎯 BlackPearl 控制平面:基于 Antigravity 与 Gemini CLI 全局监督者架构构建,拥有 657 项意图触发技能。
- ⚡ BlackPearl 核心执行引擎:由 DeepSeek Harness 与 Cordis 多进程工作树快照隔离提供支持。
- 🛠️ BlackPearl 技能引擎:标准化于 Everything Claude Code (ECC) 工程规则、TDD 工作流、子智能体和钩子。
- 🎭 BlackPearl 事业部:容纳全部 18 个企业专家事业部(273+ 角色),精选自 The Agency。

⚖️ 架构定义:控制平面(BlackPearl)与执行平面(DSH)

1. 核心架构论点:引擎与操作系统

一条根本性的架构原则将 BlackPearl 与 DeepSeek Harness (DSH) 等独立运行时区分开来:

“DeepSeek Harness 是引擎。BlackPearl 是操作系统。”

- DeepSeek Harness (DSH) 是可编程智能体运行时与执行基板:基于 Cordis 时空插件架构构建,它提供底层原语:智能体循环、沙箱、工具路由、会话日志和进程执行。
- BlackPearl 是 工程控制平面与 AI 软件组织:它在其基础执行层(frameworks/blackpearl-core/)嵌入了 DeepSeek Harness,并在其上构建了完整的多智能体治理层级——整合了主导监督、26 个可执行团队流水线、18 个专家部门(273+ 角色)、634+ 工作流技能、TDD 护栏以及通用架构约束。

┌──────────────────────────────────────────────┐
│                  用户目标                     │
└──────────────────────┬───────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                 BLACKPEARL 控制平面                                                              │
│  - 主导监督者(意图与领域路由器)                              - 通用硬性规则(5 级分解与文档优先门禁)                            │
│  - 18 个企业专家部门(273+ 角色)                             - 技能引擎(634+ 技能,68 个子智能体,94 个命令)                    │
└────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                       BLACKPEARL 多智能体团队编排                                                                 │
│  - dsh-team.js:26 个自主可执行流水线(STARTUP_MVP、ENTERPRISE_FEATURE、INCIDENT_RESPONSE、FULL_STACK_DEV 等)                     │
│  - 角色排序与有界智能体间交接契约(编排运行 ID)                                                                                   │
│  - 自动化审查者 ➔ 修复者自校正循环(硬性上限:最多 3 个循环)                                                                       │
└────────────────────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                   BLACKPEARL 核心 / 执行平面(DSH 与 CORDIS)                                                     │
│  - dsh-delegate.js 通用角色加载器                            - Cordis 时空插件引擎                                                │
│  - 沙箱化进程执行                              - 终端 / 文件系统 / 工具注册表                              │
└────────────────────────────────────────────┬─────────────────────────────────────────────────────────────────────┘
│
▼
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                            物理执行与地面真值                                                     │
│  - 每个子进程的隔离工作树 (.worktrees/dsh-)   - 基础快照隔离基线                                   │
│  - 确定性归因:RESULT - BASE SNAPSHOT        - 编译器、Linter、测试运行器、实时 Git HEAD                   │
└──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

2. 完整执行封装:BlackPearl 如何运作

与那些通过单一提示直接修改文件的非受限代理不同,BlackPearl 强制执行端到端、多阶段的工程生命周期:

[用户目标]
│
▼
[BLACKPEARL 监督器] ➔ [硬性规则门禁:5 级分解 + 文档优先扫描]
│
▼
[团队流水线选择器(26 个预配置工作流)]
│
▼
[角色解析与有界契约](生成唯一编排运行 ID)
│
▼
[基础快照捕获](记录干净/脏工作区状态基线)
│
▼
[隔离 Git 工作树创建] (.worktrees/dsh--)
│
▼
[DSH / CORDIS 执行进程](注入角色指令的沙箱化执行)
│
├─► [CORE_IMPLEMENTER](在工作树中写入更改)
│
├─► [CORE_CODE_REVIEWER / CORE_SECURITY_REVIEWER](独立的软只读差异审计)
│         │
│    [发现问题?]
│     ├── 是 ➔ [CORE_FIXER](在工作树中进行外科手术式修复,最多 3 个周期)
│     └── 否  ➔ [CORE_VERIFIER](测试套件、构建、Lint 验证)
│
▼
[基础差异归因](计算 RESULT - BASE SNAPSHOT 以隔离 AI 更改)
│
▼
[最终质量门禁 ➔ 向用户返回已验证结果]

3. 工作树快照与归因模型(RESULT - BASE SNAPSHOT)

BlackPearl 最大的工程突破之一是消除开发者工作区污染:

开发者工作区(宿主仓库)
├── 已提交的 HEAD
├── 未提交的本地编辑(用户先前的工作)
└── 未跟踪的临时文件
│
▼
[基础快照](隔离工作树中的冻结基线提交)
│
▼
[.worktrees/dsh-](DSH 代理执行)
│
▼
[结果状态](执行后的工作树状态)
│
▼
- 零意外覆盖:AI 代理绝不会覆盖或还原开发者未提交的更改。
- 准确的差异:只有真正的 AI 修改才会被归因、审查和合并。

4. 26 条预配置的自主团队流水线(dsh-team.js)

BlackPearl 开箱即配备 26 条自主多代理流水线:

| 流水线 | 角色序列 | 目标用例 |
|---|---|---|
| STARTUP_MVP | PLANNER ➔ ARCHITECT ➔ IMPLEMENTER ➔ TESTER ➔ CODE_REVIEWER ➔ REALITY_CHECKER ➔ VERIFIER | 完整的从 0 到 1 的 MVP 功能交付 |
| ENTERPRISE_FEATURE | PLANNER ➔ ARCHITECT ➔ IMPLEMENTER ➔ API_TESTER ➔ SECURITY_REVIEWER ➔ COMPLIANCE ➔ REALITY_CHECKER ➔ VERIFIER | 高合规性的企业功能 |
| INCIDENT_RESPONSE | PLANNER (Triage) ➔ FIXER (Emergency Patch) ➔ TESTER (Regression) ➔ SECURITY ➔ VERIFIER | 热修复与生产故障缓解 |
| FULL_STACK_DEV | PLANNER ➔ ARCHITECT ➔ BACKEND_DEV ➔ FRONTEND_DEV ➔ TDD_GUIDE ➔ CODE_REVIEWER ➔ VERIFIER | 端到端全栈实现 |
| COMPLIANCE_AUDIT | COMPLIANCE_CHECKER ➔ SECURITY_REVIEWER ➔ REALITY_CHECKER | FedRAMP、HIPAA、SOC2、GDPR 合规审计 |
| HARDCORE_SEC_AUDIT| SECURITY_REVIEWER ➔ APPSEC_ENGINEER ➔ PEN_TESTER ➔ SECRETS_AUDITOR ➔ REALITY_CHECKER | 深度渗透与漏洞测试 |
| AI_SECURITY_AUDIT | AI_CODE_AUDITOR ➔ OWASP_REVIEWER ➔ SECRETS_HYGIENE ➔ VERIFIER | AI 生成代码漏洞扫描器 |
| HEALTHCARE_EVAL | CLINICAL_SPECIALIST ➔ PHI_COMPLIANCE ➔ REALITY_CHECKER | 医疗指南与 HIPAA 安全验证 |
| GIS_PIPELINE | GIS_ANALYTICS ➔ SPATIAL_SCIENTIST ➔ CARTOGRAPHER ➔ QA_ENGINEER | PostGIS、GeoJSON、地图与空间索引 |
| GAME_DESIGN | GAME_DESIGNER ➔ ECONOMY_DESIGNER ➔ LEVEL_DESIGNER ➔ TECH_ARTIST | 游戏循环、机制与平衡审计 |
| MOBILE_APP | MOBILE_BUILDER ➔ UI_DESIGNER ➔ TDD_GUIDE ➔ A11Y_AUDITOR | iOS(SwiftUI)与 Android(Kotlin/Flutter)应用 |
| PAYMENTS_BILLING | PAYMENTS_ENGINEER ➔ SECURITY_REVIEWER ➔ FINOPS_ENGINEER ➔ VERIFIER | Stripe、订阅计费与财务隔离 |
| RAG_PIPELINE | RAG_ENGINEER ➔ SEARCH_RELEVANCE ➔ EVAL_HARNESS ➔ VERIFIER | 向量搜索、分块、重排序与检索 |
| UI_POLISH | UI_DESIGNER ➔ WHIMSY_INJECTOR ➔ MOTION_ENGINEER ➔ UI_FINISH_GATE | 反通用化 UI 打磨、设计令牌与动画 |
| MCP_SERVER | MCP_BUILDER ➔ API_TESTER ➔ SECURITY_REVIEWER ➔ VERIFIER | 模型上下文协议服务器与连接器 |
| CODE_ARCHAEOLOGY | CODEBASE_ARCHAEOLOGIST ➔ REFACTOR_CLEANER ➔ DOC_UPDATER | 遗留代码库探索与死代码移除 |
| SPATIAL_APP | VISIONOS_ENGINEER ➔ XR_INTERACTION ➔ TECH_ARTIST ➔ VERIFIER | visionOS、WebXR Three.js 与体积化 UI |
| INFRA_OPS | PLANNER ➔ INFRA_MAINTAINER ➔ SECURITY_REVIEWER ➔ VERIFIER | Docker、Kubernetes、CI/CD 流水线与 SRE |
| FULL_ASSURANCE | PLANNER ➔ IMPLEMENTER ➔ CODE_REVIEW ➔ SEC_REVIEW ➔ REALITY_CHECK ➔ VERIFIER | 关键任务发布质量门禁 |
| REALITY_CHECK | REALITY_CHECKER ➔ EVIDENCE_COLLECTOR ➔ QA_ENGINEER | 怀疑式证明与截图验证 |
| AUDIT | SECURITY_REVIEWER ➔ CODE_REVIEWER | 快速静态安全与代码审查 |
| HEAVY | PLANNER ➔ IMPLEMENTER (worktree) ➔ CODE_REVIEWER ➔ VERIFIER | 长时间自主重构与大型功能 |
| HIGH_RISK | PLANNER ➔ ARCHITECT ➔ IMPLEMENTER ➔ SECURITY_REVIEWER ➔ FIXER ➔ VERIFIER | 认证、迁移、支付与租户隔离 |
| COMPLEX | PLANNER ➔ IMPLEMENTER ➔ CODE_REVIEWER ➔ FIXER ➔ VERIFIER | 标准多文件功能开发 |
| GTM_LAUNCH | PRODUCT_MANAGER ➔ SEO_SPECIALIST ➔ GROWTH_HACKER ➔ COPYWRITER | 上市发布与启动策略 |
| DEEP_RESEARCH | RESEARCH_SYNTHESIST ➔ TREND_RESEARCHER ➔ EXECUTIVE_SUMMARY | 跨来源文献与市场情报 |

5. 架构评分卡:BlackPearl 对比 DeepSeek Harness(DSH)

| 评估维度 | 🏴‍☠️ BlackPearl(AI 工程操作系统) | 🧠 DeepSeek Harness(DSH 引擎) | 架构角色 |
|---|:---:|:---:|---|
| 主要架构角色 | AI 工程操作系统与控制平面 | 可编程智能体运行时引擎 | 互补技术栈* |
| “安装即开始工程” | ⭐⭐⭐⭐⭐ 10/10 | ⭐⭐⭐ 7/10 | 🏆 BlackPearl(开箱即用) |
| 预配置专家智能体 | ⭐⭐⭐⭐⭐ 10/10(273+ 角色) | ⭐⭐ 4/10(仅运行时) | 🏆 BlackPearl(18 个企业部门) |
| 预编写技能库 | ⭐⭐⭐⭐⭐ 10/10(634+ 技能) | ⭐⭐⭐ 5/10(仅技能服务) | 🏆 BlackPearl(ECC + 自定义技能) |
| 多智能体团队工作流 | ⭐⭐⭐⭐⭐ 10/10(26 条可执行流水线)| ⭐⭐⭐ 7/10(需要用户代码) | 🏆 BlackPearl(dsh-team.js 编排器) |
| 工程纪律与规则 | ⭐⭐⭐⭐⭐ 10/10(5 级分解)| ⭐⭐⭐ 6/10(观点中立) | 🏆 BlackPearl(严格硬性规则) |
| Worktree 快照归因 | ⭐⭐⭐⭐⭐ 10/10(RESULT - BASE) | ⭐⭐⭐⭐ 8/10(Git worktrees) | 🏆 BlackPearl(基线隔离) |
| 平台集成 | ⭐⭐⭐⭐⭐ 10/10(Gemini、OpenCode、VS Code)| ⭐⭐⭐⭐ 8/10(核心运行时) | 🏆 BlackPearl(通用可移植性) |
| 底层插件运行时(Cordis)| ⭐⭐⭐⭐ 8/10(内嵌于核心) | ⭐⭐⭐⭐⭐ 10/10(原生 Cordis) | 🧠 DSH(原始运行时基础) |
| 底层沙箱原语 | ⭐⭐⭐⭐ 8/10(使用 DSH 引擎) | ⭐⭐⭐⭐⭐ 10/10(故障关闭沙箱)| 🧠 DSH(底层隔离) |
| 动态运行时元编程| ⭐⭐⭐⭐ 8/10(预配置) | ⭐⭐⭐⭐⭐ 10/10(运行时包编辑)| 🧠 DSH(运行时可扩展性) |
| 整体工程操作系统评分 | 🥇 9.5 / 10 | 7.5 / 10 | 🏆 BlackPearl:软件工程领域胜出 |
| 整体运行时引擎得分 | 8.5 / 10 | 🥇 9.8 / 10 | 🧠 DSH:原始运行时基础之胜者 |
| 综合架构得分 | 👑 10.0 / 10(BlackPearl OS + DSH Core Engine) | — | 🌟 终极自主工程栈 |

🌟 什么是 BlackPearl?

BlackPearl 是一个企业级 AI 软件开发生态系统,旨在跨机器、操作系统和全新安装环境实现完全可移植。克隆此仓库并运行单个脚本即可立即配置:

1. BlackPearl 控制平面(首席监督者)(platforms/antigravity/ -> ~/.gemini/config/)
- 657 项专用技能,基于意图自动激活。
- 主指令文件(AGENTS.md、GEMINI.md),包含第 11 节部门路由。
- 通用硬性规则(5 级模块化分解与文档优先的顺序执行)。
2. BlackPearl 智能体层(platforms/opencode/ -> ~/.config/opencode/)
- 273+ 个专用 .md 规范人格,可在任意位置通过 @agent-name 提及。
- dsh-team.js 与 dsh-delegate.js 多智能体编排器,包含 26 条可执行流水线。
3. BlackPearl 核心引擎(frameworks/blackpearl-core/)
- 完整的 DeepSeek Harness 与 Cordis 执行框架,具备工作树快照隔离。
4. BlackPearl 技能引擎(frameworks/blackpearl-skills/)
- 634+ 项工作流技能、68 个子智能体、94 条命令以及自动化钩子。
5. BlackPearl 专家部门(frameworks/blackpearl-divisions/)
- 18 个企业部门,涵盖工程、测试、安全、设计、产品、医疗、金融、GIS、游戏开发等。

🏢 BlackPearl 部门 — 18 个专家部门(273+ 个子智能体)

| 部门 | 主要能力与重点 | 关键角色与人格 |
|---|---|---|
| 💻 工程(59) | 整洁架构 API、移动端(iOS/Android)、RAG、数据库优化、SRE | agency-backend-architect、agency-mobile-app-builder、agency-rag-pipeline-engineer、agency-sre |
| 🧪 测试与 QA(9) | 怀疑式 QA、WCAG 2.2 无障碍、API 契约模糊测试、Core Web Vitals | agency-reality-checker、agency-accessibility-auditor、agency-api-tester、agency-performance-benchmarker |
| 🛡️ 安全与 AppSec(12) | AI 代码漏洞扫描器、OWASP Top 10、密钥治理、渗透测试 | agency-security-ai-generated-code-auditor、agency-security-appsec-engineer、agency-security-penetration-tester |
| 🎨 设计与 UI(10) | 设计系统、CSS 令牌、反通用 UI 完成门禁、微动画 | agency-ui-designer、agency-ui-finish-gate-reviewer、agency-whimsy-injector、agency-ux-architect |
| 📦 产品(5) | PRD 规格、RICE 评分、用户旅程、行为助推引擎 | agency-product-manager、agency-sprint-prioritizer、agency-behavioral-nudge-engine |
| 📋 项目管理 (7) | 规格到任务转换、交付跟踪、会议纪要综合 | agency-senior-project-manager、agency-project-shepherd、agency-meeting-notes-specialist |
| 📊 战略与运行手册 (6) | 多智能体运行手册:初创 MVP、企业功能、事件响应 | agency-runbook-startup-mvp、agency-runbook-enterprise-feature、agency-runbook-incident-response |
| 🏥 医疗健康 (3) | 临床证据映射、医疗指南、患者安全与 HIPAA | agency-clinical-evidence-agent、agency-healthcare-innovation-strategist |
| 💰 金融与 FinOps (5) | 财务预测模型、SaaS 单位经济学、税务规划、FP&A | agency-financial-analyst、agency-tax-strategist、agency-fpa-analyst |
| 🗺️ GIS 与空间 (13) | Web GIS 地图、GeoJSON、PostGIS 查询、制图学、无人机实景 | agency-web-gis-developer、agency-spatial-data-scientist、agency-drone-reality-mapping |
| 🥽 空间计算 (6) | VisionOS SwiftUI 体三维 UI、Metal 90fps GPU、WebXR Three.js | agency-visionos-spatial-engineer、agency-macos-spatial-metal-engineer、agency-xr-immersive-developer |
| 🎮 游戏开发 (6) | 核心玩法循环、虚拟游戏内经济平衡、音频、机制 | agency-game-designer、agency-economy-designer、agency-game-audio-engineer |
| 📢 营销 (36) | SEO、AEO(AI 引擎优化)、病毒式增长循环、社交 | agency-seo-specialist、agency-growth-hacker、agency-aeo-foundations-architect |
| 🎯 付费媒体 (7) | Google/Meta PPC 广告活动、搜索查询分析、ROAS 优化 | agency-ppc-campaign-strategist、agency-paid-social-strategist、agency-paid-media-auditor |
| 💼 销售 (9) | B2B 外呼拓客、探索电话辅导、成交 | agency-outbound-strategist、agency-discovery-coach、agency-deal-strategist |
| 🎓 学术 (6) | 统计严谨性、心理学模型、民族志系统 | agency-statistician、agency-psychologist、agency-narratologist |
| 🔬 研究 (1) | 跨来源研究综合、文献地图、竞争矩阵 | agency-research-synthesist |
| 🧩 专业领域 (58) | MCP 服务器构建器、代码库考古、医疗编码、FedRAMP | agency-mcp-builder、agency-codebase-archaeologist、agency-medical-billing-coding-specialist |

🔒 主硬性规则

在 BlackPearl 内运行的每个智能体都严格执行两项通用架构要求:

1. 模块化架构(5 级分解)
Project ➔ Module/Domain ➔ Feature/Capability ➔ Use-case ➔ Responsibility ➔ File
- 一个业务操作 = 一个用例文件:严格禁止单体文件(通常 >400 行,最大 >800 行)。
- 功能所有权:私有领域逻辑保留在 module/feature/ 内。切勿将业务逻辑倾倒到 shared/ 或 utils/ 中。
- 公共契约:模块间通信仅通过 public/ 接口进行。internal/ 为私有。

2. 文档优先的顺序执行
目标 ➔ 停止并查阅文档 ➔ 验证实际代码现状 ➔ 规划 4 个层级 ➔ 一个活跃微任务
- 停止并查阅:在接触任何代码之前,阅读所有项目自编写的 .md 文件。
- 验证现状:区分历史文档与实时可执行的真实情况。
- 单轨聚焦:一次仅执行一个活跃微任务:实现 ➔ 测试 ➔ 差异审查 ➔ 达到质量门禁 ➔ 关闭。

💻 全新 PC / 全新 Windows 完整安装指南

专用迁移指南:💻 SETUP-NEW-PC.md

要将整个 BlackPearl 生态系统部署到任何全新的 Windows、macOS 或 Linux 机器上:

📍 第 1 步:安装前置依赖(在 PowerShell / 终端中运行)powershell
Windows (winget)
winget install Git.Git OpenJS.NodeJS.LTS

📍 第 2 步:克隆 BlackPearl 仓库powershell
git clone https://github.com/BlackPearl-AI/BlackPearl.git "G:\0000 PY PROGRAM\_AI_TOOLS\BlackPearl"
cd "G:\0000 PY PROGRAM\_AI_TOOLS\BlackPearl"

📍 第 3 步:运行一键主安装程序powershell
Windows PowerShell
.\install.ps1

Linux / macOS Bash
./install.sh

📍 第 4 步:验证系统健康状况powershell
.\verify.ps1
预期输出:ALL TESTS PASSED! BlackPearl Suite is 100% healthy, synchronized, and operational.

🔑 LLM API 密钥与提供商配置

BlackPearl 支持所有主流 AI 模型以及 100% 免费的离线本地模型:

1. Antigravity IDE 与 Gemini CLI(内置免费集成)
- 如果你在 Antigravity IDE 或 Gemini CLI 中运行,BlackPearl 会自动使用你当前活跃的 Google DeepMind 环境,无需任何 API 密钥!

2. 通过 Ollama 使用 100% 免费且离线的本地模型(零成本,无需互联网)powershell
Install Ollama
winget install Ollama.Ollama

Pull recommended coding models
ollama run qwen2.5-coder:14b
ollama run deepseek-r1:14b

3. 云端 LLM API 密钥(云端执行时可选)
在系统环境变量或 ~/.env 中设置密钥:powershell
[System.Environment]::SetEnvironmentVariable('DEEPSEEK_API_KEY', 'sk-your-key', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-your-key', 'User')
[System.Environment]::SetEnvironmentVariable('OPENAI_API_KEY', 'sk-your-key', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'AIza-your-key', 'User')

📁 仓库架构

BlackPearl/
├── assets/                          # Official brand assets (orb avatar, hero banner, infographic)
├── frameworks/
│   ├── blackpearl-core/             # DeepSeek Harness runtime, Cordis engine, process sandboxes
│   ├── blackpearl-skills/           # 634+ workflow skills, 68 subagents, 94 commands, hooks
│   └── blackpearl-divisions/        # 18 个专业企业部门(273+ 个角色)
├── platforms/
│   ├── antigravity/                 # 全局监督指令与 657 项技能池
│   └── opencode/                    # 273+ 个规范代理与 26 个团队流水线编排器
├── templates/                       # 项目入门脚手架与 AGENTS.md 模板
├── DECLARATION.md                   # 官方生态系统宣言与起源
├── SETUP-NEW-PC.md                  # 全面的新机器入门指南
├── install.ps1 / install.sh         # 一键零配置主安装程序
├── verify.ps1                       # 自动化生态系统健康审计器
└── scaffold.ps1                     # 即时新项目脚手架工具

🛡️ 许可证

根据 MIT 许可证分发。可免费用于个人和商业自主软件工程。

BlackPearl AI — 自主软件工程操作系统
编排。导航。验证。执行。

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入社群

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

DPharness QQ 群二维码,QQ 扫码进群
QQ 扫码进群
DPharness 飞书群二维码,飞书扫码进群
飞书扫码进群