ololand-dd

OloLand 插件

面向买方尽调的验证器栈，以可安装的 Agent 插件形式提供。

此仓库是 OloLand 面向 Claude Cowork（Claude Desktop）、Claude Code（CLI）、Codex 和 Cursor / Grok Bot 的插件市场。这里托管的 OloLand 插件可增强 Anthropic 的第一方金融插件系列（private-equity、financial-analysis、investment-banking、equity-research、wealth-management），并在 Cursor 格式的宿主上提供同一个 OloLand MCP 服务。

Anthropic 提供广度。OloLand 提供深度。 同一个 Cowork 会话。确定性计算。可辩护的记录。

---

此市场中的插件

插件	状态	功能
ololand-dd	v1.27.0	机构级尽职调查：确定性金融引擎、包含 67 个尽调类别的 311 因子风险分类体系、分析工作台工具、已验证的法证筛查工作流、战争游戏 RL 策略模拟，以及从分析师修正中重新训练的飞轮。
ololand-forensic-qoe	v0.6.6	明确呈现证据和数据缺口的法证收益工作流。单个 MCP 工具和自助式 PDF 报告的覆盖范围不同；Pro 及以上套餐包含报告。OpenAI 提交导出和草稿审查案例详见提交指南。
ololand-compliance-hooks	v0.2.4	适用于 Anthropic Claude Cowork 金融插件的即插即用合规、引用和来源追溯钩子。PreToolUse MNPI 防护、PostToolUse 引用校验、审计日志回写。填充 Anthropic 各垂直领域插件自带的空 hooks/ 脚手架。
cim-generator	v1.1.1	带来源追溯的 14 节 CIM 生成器——根据已对账的交易数据（财务快照、风险洞察、市场研究）构建卖方备忘录，而非由大模型生成文本。可在交易工作区查看、编辑并导出最终 CIM（PDF、DOCX、PPTX）。

这些插件可以彼此叠加使用，也可与 Anthropic 的第一方金融插件组合使用。

---

维护者工作流

此仓库根据规范 YAML 元数据生成 Claude、Codex 和 Cursor / Grok Bot 插件产物。 编辑 marketplace.yaml 和 plugins/*/plugin.yaml，然后运行：

python3 -m pip install -r scripts/requirements.txt
python3 scripts/generate-plugin-artifacts.py
./scripts/check-plugin-artifacts.sh

完整发布流程请参阅 docs/plugin-publishing.md。

---

前置条件

你只需要一个免费的 OloLand 账户。**无需设置环境变量，也无需手动创建 API 密钥。**安装插件时，它们会通过 OAuth 自动完成身份验证。

两种账户类型

类型	费用	权限
开发者（免费）	在 https://app.ololand.ai/signup 注册	仅限沙盒——可使用全部 MCP 工具处理附带的示例交易（Paragon Flight School (Sample)）。调用次数不限。无需付款或信用卡。
平台（付费）	Pro $199/月，Team $499/月（含 2 个席位，每增加 1 个席位 +$199），Enterprise（定制）（参见价格）	可访问自有交易 + 跨交易记忆 + 结果飞轮 + 生产级用量

你可以在免费的开发者账户上安装插件，针对示例交易体验所有功能——DCF、LBO、Monte Carlo、法证 QoE、风险分类体系、战争游戏等。准备好使用自己的数据时，再升级到付费套餐。

首次安装时会发生什么（无需设置环境变量）

1. 添加市场并安装插件（请按照下方“安装”部分中的步骤操作）
2. 插件会定义一个指向 OloLand 后端的 ololand MCP 连接器
3. 首次调用时，Cowork / Claude Code 会提示你通过 OAuth 授权连接器
4. 点击“授权”——浏览器会打开 OloLand 的身份验证页面，你登录后接受所需权限范围
5. OloLand 后端会自动配置一个与 OAuth 客户端绑定、权限范围受限的 Agent 密钥。Cowork / Claude Code 会为你保存该密钥
6. 后续调用会使用已保存的凭据。无需环境变量，也无需手动设置。

就是这样。OAuth 流程只需进行一次，连接器便会在本次会话及之后的会话中完成身份验证。从此市场安装 Cursor 格式的插件后，Grok Bot 和 Cursor 授权的也是同一个连接器。

高级用户 / 无头环境设置（可选）

如果你在无头环境中运行插件（CI、服务端自动化，或无法运行 OAuth 的自定义 MCP 客户端），可以绕过 OAuth，改用手动创建的 Agent 密钥：

1. 登录 https://app.ololand.ai
2. Settings → Agent keys → Create new key
3. 设置环境变量：export OLOLAND_AGENT_KEY=olo_agent_sk_...

已发布的 .mcp.json 文件原生支持 OAuth，不会发送 Authorization 标头。如需在无头环境中使用，请自行添加带有 Authorization: Bearer ${OLOLAND_AGENT_KEY} 的 MCP 服务配置。如果客户端同时配置了 OAuth 和自定义标头，应将 OAuth 视为交互式默认方式。

---

安装 — Grok Bot 和 Cursor

Grok Bot 会安装 Cursor 格式的插件。本仓库提供了一个多插件市场，位于 .cursor-plugin/marketplace.json。每个插件都会复用现有的 skills/、commands/、agents/、资源和原生支持 OAuth 的 .mcp.json — 仓库中不包含 API 密钥。

Grok Bot

1. 打开 Bot 的插件设置，或询问：Install the OloLand plugins from ololand-ai/ololand-plugins
2. 添加 GitHub 市场 ololand-ai/ololand-plugins
3. 安装 ololand-dd，以使用交易、尽职调查和估值 MCP 工具（get_deal、run_due_diligence、run_lbo_model、generate_ic_package，以及 OloLand 服务中的其他工具）。也可选择安装 ololand-forensic-qoe、cim-generator 和 ololand-compliance-hooks
4. 出现提示时，通过 OAuth 授权 ololand MCP 连接器。无需环境变量或粘贴令牌

Cursor

1. Settings → Plugins → 从 GitHub 添加市场：ololand-ai/ololand-plugins
2. 从 OloLand 市场安装所需插件
3. 首次使用时授权 ololand 连接器

安装后，插件详情视图应显示共享技能以及 ololand 连接器。如果连接器显示已安装，但始终未提供登录选项，请移除并重新添加插件，然后再次授权。

无法完成 OAuth 的无头 Cursor / CI 主机可以自行添加带有 Authorization: Bearer ${OLOLAND_AGENT_KEY} 的 MCP 配置。已发布的 .mcp.json 文件仍原生支持 OAuth，不会嵌入该标头。

---

安装 — Claude Cowork（Claude Desktop）

建议通过 Cowork 界面运行交易的分析师采用此方式。

步骤 1 — 打开插件管理器

1. 打开 Claude Desktop
2. 切换到 Cowork 选项卡（窗口顶部）
3. 点击左侧边栏中的 Customize
4. 点击 Customize 子菜单中的 Plugins

步骤 2 — 添加 OloLand 市场

1. 点击“Personal plugins”旁边的 + 按钮（或 Plugins 面板标题栏中的相应按钮）
2. 选择 Create plugin → Add marketplace
3. 在 URL 字段中输入：

   ololand-ai/ololand-plugins
   

4. 点击 Sync
5. 等待约 5–10 秒后，会出现一个新的标签 ololand-plugins，其中包含三张插件卡片：Ololand dd、Ololand forensic qoe、Ololand compliance hooks。

第 3 步 — 安装插件

点击每张卡片上的 + 按钮进行安装。全部三个插件安装完成后，“个人插件”侧边栏中应列出：

• Ololand dd
• Ololand compliance hooks
• Ololand forensic qoe

第 4 步 — 验证

点击侧边栏中的 Ololand dd。详情视图应显示：

字段	预期值
来源	Marketplace（ololand-plugins）
版本	1.20.4 或更高
作者	OloLand
Skills 选项卡	约 18 个技能，包括 /playbook-recall、/calibrate-vs-history
Agents 选项卡	3 个 Agent：dd-analyst、forensic-screener、war-game-strategist
Connectors 选项卡	1 个名为 ololand 的连接器

如果 Agents 显示 1 个而不是 3 个，说明你使用的是较旧版本。移除该 Marketplace，然后按照第 2 步重新添加。

第 5 步 — 授权 OloLand 连接器

首次调用会访问 OloLand 后端的命令时（例如 /ololand-dd:dd-analyze），Cowork 会提示你授权 ololand MCP 连接器。点击 Authorize → 登录 OloLand（如果尚未登录）→ 接受授权范围。连接器会保存凭据，供后续调用使用。无需设置环境变量。

如果你是 OloLand 新用户，在此登录也会立即为你创建免费的 Developer 账户——无需另外访问 app.ololand.ai/signup。

---

安装 — Claude Code（CLI）

适用于开发者、IT 团队以及所有在本地运行 Claude Code 的用户。

第 1 步 — 添加 Marketplace

在任意 Claude Code 聊天会话中：

/plugin marketplace add ololand-ai/ololand-plugins

第 2 步 — 安装插件

/plugin install ololand-dd@ololand-plugins
/plugin install ololand-forensic-qoe@ololand-plugins
/plugin install ololand-compliance-hooks@ololand-plugins

第 3 步 — 重新加载以激活

/reload-plugins

第 4 步 — 验证

/plugin

这会打开插件管理器 TUI。切换到 Installed 选项卡，确认列出的三个 OloLand 插件均已启用。打开 ololand-dd 详情，确认版本为 1.20.4，且包含三个 Agent。

第 5 步 — 授权 OloLand 连接器

首次调用会访问 OloLand 后端的命令时（例如 /ololand-dd:dd-analyze），Claude Code 会为 ololand MCP 连接器启动 OAuth 流程。浏览器会打开 OloLand 授权页面 → 登录 → 接受授权范围。Claude Code 会保存凭据。后续调用将自动完成身份验证。

如果你是 OloLand 新用户，可以直接在授权页面注册——无需另行访问 app.ololand.ai/signup。

仅适用于无头模式 / CI：在环境中设置 OLOLAND_AGENT_KEY=olo_agent_sk_...，即可绕过 OAuth 流程。前往 app.ololand.ai → Settings → Agent keys → Create new key 获取密钥。如果两种方式都已配置，则优先使用 OAuth。

---

用法 — ololand-dd

这是旗舰尽职调查插件。相关技能会在适用时自动触发；命令则需要显式调用。

命令

在任意聊天中输入 /，即可查看自动补全。插件命令使用命名空间 /ololand-dd:<command>。

命令	功能
/dd-analyze <deal_id>	运行交易提取和风险分析流程；估值读取或创建新的模型候选项需单独显式执行 /valuation 操作
/new-deal <ticker_or_name>	根据股票代码（自动获取 10-K）或公司名称创建新交易
/risk-matrix <deal_id>	将风险分类体系（67 个类别 / 311 个风险因素）呈现为交互式图块
/risk-report <deal_id>	结构化风险报告——按严重程度 × 可能性 × 速度分析，并列出美元影响
/valuation <deal_id> read [method]	读取受治理的 DCF / LBO 和有来源支持的可比公司数据。若要创建新的模型候选项，请显式使用 /valuation <deal_id> run <method> 或 /valuation <deal_id> refresh <method>；不带参数以及旧版仅含方法的调用均为只读。
`/qoe-analysis <deal_id> [latest	run]`
/verify <deal_id>	核实每个数字：根据源文档和引擎运行结果验证 OloLand 成果，或逐项依据交易语料库评估外部起草的备忘录（例如来自 Claude Cowork 的备忘录）
`/compliance-analysis <deal_id> [ofac	hsr
`/scenario-analysis <deal_id> [stress	market
/earnings-analysis <deal_id>	分析财报电话会议文字稿片段，提取尽职调查信号
`/verification-marketplace <deal_id> [status	list
`/ic-package <deal_id> [status	generate
`/value-impact <deal_id	company
`/deal-health <deal_id> [actions	create-action]`
`/workbook [list	get
/company-discovery <query>	根据自然语言或结构化条件搜索公司发现界面
`/watchlist [list	create
`/advisory <deal_id> [list	request]`
`/financing <deal_id> [status	analyze
/managed-context-agent <deal_id> <agent_key>	在启用时启动已配置的托管上下文 Agent
/okf-export <deal_id>	导出机器可读的 OKF 交易数据包
/war-game <deal_id> [scenarios]	在多个情景下进行 16 个季度的 MaskablePPO 竞争模拟
/similar-deals <deal_id>	跨交易记忆：查找相似的过往交易、准确度模式和估值区间
/playbook-recall <deal_id>	回顾贵公司过往类似交易中哪些做法有效、哪些无效、哪些有所遗漏
/calibrate-vs-history <deal_id>	应用贵公司的历史预测偏差，重新校准交易的核心数字
/talk-to-deal <deal_id>	对话式会话：询问有关交易的任何问题，输出针对语音优化
/deal-search <deal_id>	对交易资料室进行全文和语义搜索
/unit-economics <deal_id>	SaaS 客户群留存率（NDR/GRR）、LTV/CAC、回本周期、魔力数字、40 法则
/source <criteria>	根据条件寻找新的 M&A / PE 交易；补充联系人数据；与 CRM 去重

子代理

在 Cowork 中，点击 Agents 选项卡中的一个 Agent，它就会作为对话的主 Agent 加载。在 Claude Code CLI 中，Agent 会根据上下文自动触发，也可以使用 /agents 显式调用并选择一个。

Agent	使用场景
dd-analyst	完整的 DD 工作流、准备 IC 备忘录、深入调查交易。通用型专家。
forensic-screener	LOI 前的法证深度调查。运行全部 7 项法证基础分析，根据来源层级核对调查结果，并生成可供 IC 辩护的排除项清单，其中包含严重程度、美元影响和引文。
war-game-strategist	针对竞争对手的应对措施，对交易论点进行压力测试。运行 4 种情景的 MaskablePPO 模拟，根据类似交易结果校准，在确定性 DCF 上叠加分析，并建议调整报价。

示例工作流 — 完整的 LOI 前 DD

在 Cowork（或 Claude Code）中，使用 OloLand 账户中的一笔交易：

/ololand-dd:new-deal ACME-Manufacturing

↓ 创建交易

/ololand-dd:dd-analyze deal_acme_2026

↓ 运行完整的多 Agent DD

然后进行深入法证分析：

/ololand-dd:risk-matrix deal_acme_2026

↓ 呈现风险分类图块

@forensic-screener run a Pre-LOI screen on deal_acme_2026

↓ 委派给法证专家子代理

进行论点压力测试：

@war-game-strategist test the buyout thesis on deal_acme_2026 across all 4 scenarios

---

用法 — ololand-forensic-qoe

独立的 LOI 前法证筛查组件。若想深入进行法证分析，但不需要完整的 DD 插件，请使用此组件。

命令

命令	功能
/forensic-screen <deal_id>	完整分析套件：Beneish + Benford + EBITDA 桥接 + 日记账分录 + 挪用回款 + 营运资本 + 收入质量。返回按严重程度评分的排除项清单。
/beneish <deal_id>	Beneish M-Score（针对私营公司调整）。包含 8 个变量的盈余操纵概率分析。
/benford <deal_id>	对总账交易进行 Benford 定律首位数字测试。χ² + MAD。
/ebitda-bridge <deal_id>	在 OpenAI 上执行明确提供的输入桥接计算，并提供启发式标记；来源核验和经接受的标准化收益仍需单独处理。
/journal-test <deal_id>	日记账分录异常测试。期末集中度、整数金额、记账权限、周末分录。
/lapping-check <deal_id>	应收账款挪用回款欺诈检测。客户至现金追踪、核销间隔检测。
/conflicts <deal_id>	跨文档冲突检测，查找不匹配的数字、日期、所有权、条款和义务。
/verify <deal_id>	根据已摄取的交易资料库，核验外部起草的文档。

必需输入

• Beneish：2 年以上的损益表和资产负债表数据
• Benford：包含 ≥1,000 个明细项的总账导出文件
• EBITDA 桥接：在 OpenAI 上，需提供明确的数值基数和调整明细表；接受标准化收益仍需独立来源和人工审核
• 日记账分录测试：包含时间戳和记账用户 ID 的总账
• 挪用回款：应收账款账龄表和包含客户级明细的现金收款日记账
• 完整筛查：跳过并报告——运行输入齐备的所有基础分析，并报告跳过了哪些分析及原因

示例工作流 — EBITDA 为 $50M 的目标公司筛查

/ololand-forensic-qoe:forensic-screen deal_target_2026

在 60-90 秒内返回可供 IC 辩护的排除项清单，其中包含：

• 报告 EBITDA $X.XM → 可辩护 EBITDA $Y.YM（差额 $Z.ZM）
• 每项法证基础分析的结论（通过 / 警告 / 失败）
• 包含美元影响和来源引文的调整表
• 按严重程度评分的调查结果（低 / 中 / 高 / 严重）
• 建议：继续 / 谨慎继续 / 终止

---

用法 — ololand-compliance-hooks

即插即用的钩子插件。大多数用户无需直接调用它——安装后会自动运行。

它的作用（被动）

钩子	触发条件	操作
PreToolUse：MNPI 防护	Bash、Write、Edit、MultiEdit	阻止引用重大非公开信息模式（“material non-public”、“insider trading window”等）的工具调用，除非输入中包含 # mnpi:cleared 标记
PostToolUse：引文检查器	生成 CIM / IC 备忘录 / 尽调档案后	扫描没有来源引文的金额（$）、百分比（%）和倍数。默认发出警告。
PostToolUse：溯源写回	每次生成输出后	将 NDJSON 追加到 ~/.ololand/provenance/YYYY-MM-DD.ndjson，并可选择镜像到 API
Pre + PostToolUse：审计日志	每次 mcp__ololand__* 调用	将调用记录镜像到 ~/.ololand/audit/YYYY-MM-DD.ndjson
SessionStart：横幅	新会话	确认钩子已启用

通过环境变量配置

变量	默认值	用途
OLOLAND_CITATION_BLOCK	0	设为 1，将引文检查器从警告升级为拒绝
OLOLAND_AGENT_KEY	未设置	将溯源记录和审计日志行镜像到 OloLand 的 API
OLOLAND_API_URL	https://app.ololand.ai	覆盖可自托管 OloLand 部署的地址

本地日志

随时查看溯源和审计记录：

jq -c '.' ~/.ololand/provenance/$(date -u +%Y-%m-%d).ndjson
jq -c '.' ~/.ololand/audit/$(date -u +%Y-%m-%d).ndjson

这些记录为仅追加的 NDJSON。可根据需要按天轮换或压缩。

---

故障排除

Cowork：“Marketplace sync failed. Check the repository URL and try again.”

最常见的原因是缓存了之前安装尝试时的市场。点击失败项旁边的 ... → Remove。然后重新添加。

如果仍然失败，请改用 Upload plugin 方式（上传 zip）。根据 Cowork issue #38429，source: "manual" 插件不会受到影响 source: "github" 插件的自动移除错误影响。

Cowork：插件重启后消失

这是已知的 issue #38429 和 #39274。RemotePluginManager 会在重启时移除第三方的 GitHub 来源插件。解决方法：

• 使用“Upload plugin”（zip 方式）重新安装，而不是“Add marketplace”
• 或等待 Anthropic 发布修复

Cowork：聊天提示“Unknown skill: plugin”

Cowork 聊天不支持 /plugin 斜杠命令。插件管理只能通过 UI 操作：

• Customize → Plugins → Browse / Add marketplace / Upload plugin

/plugin 命令集仅适用于 Claude Code CLI。

Cowork：显示旧版本（1.4.x）而不是 1.5.x

可能是市场更名之前缓存的安装（原名为 ololand-dd-plugin，现为 ololand-plugins）。移除旧的市场项，重新添加 ololand-ai/ololand-plugins 并安装。

点击插件，确认 v1.20.4：Agents 选项卡应显示 3 个 Agent（dd-analyst、forensic-screener、war-game-strategist）。

CLI：/plugin install 失败并提示“marketplace not found”

/plugin marketplace update ololand-plugins

如果仍然失败：

/plugin marketplace remove ololand-plugins
/plugin marketplace add ololand-ai/ololand-plugins

工具因身份验证错误而失败（“OLOLAND_AGENT_KEY not set”、“401 Unauthorized”等）

最常见的原因是首次调用时跳过或取消了 OAuth 流程。

在 Cowork 中修复：Customize → Connectors → 点击 ololand 连接器 → 点击 Reconnect（或点击 Disconnect，再点击该连接器以重新触发 OAuth）。登录 OloLand 并接受授权范围。

在 Claude Code CLI 中修复：运行任意 /ololand-dd: 命令——Claude Code 检测到连接器未经身份验证时会重新触发 OAuth 流程。出现提示时，在浏览器中登录。

无头模式 / CI 备用方案：如果无法使用 OAuth（CI、脚本），请前往 app.ololand.ai → Settings → Agent keys 生成 Agent 密钥，然后在环境中运行 export OLOLAND_AGENT_KEY=olo_agent_sk_...。

安装后未显示插件技能

运行：

/reload-plugins

如果仍然缺失，请清除插件缓存：

rm -rf ~/.claude/plugins/cache

然后重新安装。清除缓存后，重启 Claude Code / Claude Desktop。

---

为什么要做这个项目

OloLand 的理念是：Anthropic 的金融插件是*“参考模板——根据贵公司的工作方式进行调整后，它们会更好用”*（摘自其 README）。这正是我们的定位：为机构量身打造。

Anthropic 提供广度——五个垂直领域插件、十个具名 Agent、十一个只读数据连接器。我们提供深度——确定性计算、结构化分类体系、持久化记忆，以及 Anthropic 第一方插件尚未实现的合规钩子。

如需了解完整定位，请参阅比较页面。

---

贡献

每个插件都位于 plugins/<name>/ 下，其中包含 Claude、Codex 和 Cursor 清单，这些清单共用相同的技能、命令和 MCP 配置。Claude 市场目录 .claude-plugin/marketplace.json 和 Cursor 市场目录 .cursor-plugin/marketplace.json 由 marketplace.yaml 生成，必须与每个插件的 plugin.yaml 保持版本同步。

从 origin/main 创建分支，向 main 提交 PR（维护者裁定，2026-07-14：本仓库仅使用 main 分支——它没有预发布环境，因此与 ololand-ai/olo5 不同，流程中没有预发布分支；旧的 staging 分支已停用且过时）。本仓库仅允许合并提交（已禁用变基和压缩合并）。

要更新插件版本，请同时更新插件的 plugin.json 和 marketplace.json 条目——若两者版本不一致，scripts/check-version-sync.sh（在提交前运行）会阻止提交。

支持

• 电子邮件：[email protected]
• 问题反馈：https://github.com/ololand-ai/ololand-plugins/issues
• 文档：https://ololand.ai

许可证

Apache-2.0。请参阅 LICENSE。