# 增长获客

中文 | [English](./README.md)

`dsh-growth` 是一个本地优先的 DeepSeek Harness 插件，用于把 Markdown、CSV 和 JSONL 中的增长资料与业务数据，转化为可解释的增长诊断、落地方案和执行 SOP。

## 插件定位：营销阶段的增长经营与测量层

`dsh-growth` 负责营销阶段的获客、激活、留存和增长实验，同时把产品行为、营销效果和变现结果放进同一套测量框架。`dsh-business` 提供商业目标与经济边界，`dsh-sales` 提供成交与管道证据。

## 定位架构：商业策略层 + 四段主链路

```mermaid
flowchart TB
    S["dsh-business<br/>商业策略层<br/>价值 · 模式 · 定价 · 利润"]

    subgraph MAIN["四段主链路"]
        direction LR
        A["1. 需求<br/>dsh-idea"] --> B["2. 产品<br/>dsh-product"]
        B --> C["3. 营销<br/>dsh-geo + dsh-growth"]
        C --> D["4. 变现执行<br/>dsh-sales"]
    end

    S -. "定义商业方向与边界" .-> A
    D --> R["反馈<br/>成交 · 续费 · 收入 · 成本"]
    R -->|产品迭代| B
    R -->|新发现| A

    classDef strategy fill:#FFF4D6,stroke:#B7791F,color:#5C4500
    classDef stage fill:#E8F1FF,stroke:#3366CC,color:#173A7A
    classDef feedback fill:#E8F7EE,stroke:#2F855A,color:#1C4532
    class S strategy
    class A,B,C,D stage
    class R feedback
```

## 插件导航

| 插件 | 分工 | 直接跳转 |
|---|---|---|
| `dsh-idea` | 外部机会、需求信号、候选方案和最小验证 | [README](../dsh-idea/README.zh.md) |
| `dsh-product` | 产品定义、POC/MVP、发布门槛和 PMF | [README](../dsh-product/README.zh.md) |
| `dsh-business` | 横跨全链路的商业策略、价值、定价和盈利 | [README](../dsh-business/README.zh.md) |
| `dsh-sales` | 变现执行：资格判断、商机推进、成交、扩单和续约 | [README](../dsh-sales/README.zh.md) |
| `dsh-growth` | 获客、激活、留存、收入分析和增长实验 | [README](./README.zh.md) |
| `dsh-geo` | SEO/GEO/AEO、内容生产和搜索/答案引擎可发现性 | [README](../dsh-geo/README.zh.md) |

## 用户与公司的痛点需求

增长工作通常卡在“数据、决策、执行”之间：

| 痛点 | 需要的能力 |
| --- | --- |
| 增长数据散落在笔记、事件导出、收入表和团队文档中。 | 统一读取本地 Markdown、CSV、JSON 和 JSONL。 |
| 激活、留存、CAC、LTV、MRR 等指标口径不一致。 | 明确指标定义、字段、周期、来源和 caveats。 |
| 漏斗只能告诉团队用户在哪一步流失，不能说明下一步查什么。 | 找出瓶颈、分群差异、证据缺口和下一步检查。 |
| 想法容易变成没有假设、负责人和验证标准的待办列表。 | 生成带护栏指标的 HADI 实验，并用 RICE / ICE 排序。 |
| 周报、月报与实验复盘重复劳动，且难以追溯证据。 | 生成可复核的 WBR、MBR、QBR 和实验复盘 Markdown。 |
| 客户数据不应离开公司的知识边界。 | 本地优先分析，配合路径限制、警告和安全写入。 |

## 应用场景

| 场景 | 使用方式 |
| --- | --- |
| 新产品 / PMF 探索 | 审计 JTBD、ICP、PMF Survey、North Star 和证据准备度。 |
| 客户获客 | 按渠道和分群比较获客、激活和收入转化。 |
| 新手引导优化 | 定位激活瓶颈，生成可量化的 HADI 实验。 |
| 留存提升 | 构建日 / 周 / 月留存队列，分析生命周期和用户分群。 |
| SaaS / 订阅商业化 | 计算 MRR Bridge、ARR、NRR、CAC、LTV 和 Payback。 |
| 增长运营复盘 | 生成包含发现、决策、限制和下一步行动的周报 / 月报。 |

## 核心能力

- `growth_onboarding`：只读检查增长项目准备度，汇总策略笔记、数据基础、经典方法覆盖、当前 SOP 关卡和前两个缺口
- `growth_doctor`：分析前检查本地目录、数据文件和质量风险
- `growth_profile_dataset`：推断字段、覆盖率、日期范围和质量警告，不返回原始行
- `growth_review`：从业务目标出发，编排画像、分析、瓶颈和下一步行动；可以省略路径，自动发现本地数据
- 用户增长与客户获取分析
- JTBD、ICP、PMF 和 North Star 审计
- AARRR 漏斗分析
- 激活与留存队列分析
- 推荐循环和渠道质量分析
- MRR Bridge、CAC、LTV、NRR、Payback
- HADI 增长实验卡
- RICE / ICE 优先级排序
- WBR / MBR / QBR 增长复盘
- 预览后、安全写入 Obsidian Markdown

可选的 `growth-acquisition-execution` skill 还提供外部渠道资源和受质量门控制的目录提交规划 SOP；它只负责资源筛选、方案设计、授权清单和交接模板，不浏览网站、不创建账号、不填写表单、不执行外部提交。

可选的 `growth-ai-discoverability` skill 提供“AI 搜索 / 可发现性准备度”方法，用于判断可抓取性、结构化事实、内容可信度和商品 Feed 检查项是否适用于当前业务。它只输出准备度矩阵和落地方案，不扫描或修改网站，也不依赖 GEO-PRO。

可选的 `growth-strategy-planning` skill 统一路由 Value Proposition Canvas、Lean Canvas、Bullseye 渠道、Aha Moment、流失 / 召回、Opportunity Solution Tree、用户访谈、推荐循环、市场规模、定价研究、B2B 销售漏斗和 Growth Accounting 等经典方法，输出小而完整的证据驱动方案，不增加实时执行能力，也不替代确定性指标工具。已确认机会的销售沟通、报价、谈判、成交和扩单推进交给 `dsh-sales`。

## 默认配置

将插件安装到 DeepSeek Harness profile：

```bash
npx --yes @deepseek-ai/dsh plugin --profile growth add dsh-growth
npx --yes @deepseek-ai/dsh --profile growth --dump-config
```

如果 Harness 宿主还没有启动，先启动 Web UI：

```bash
npx --yes @deepseek-ai/dsh web
```

然后打开 `http://127.0.0.1:3080`，选择 `growth` profile 开始对话。DeepSeek Harness 官方仓库说明了这个 Web UI 入口；宿主目前仍在 developer preview，命令可能随版本调整。

如果 `dsh` 已经在系统 `PATH` 中，也可以使用简写：`dsh plugin --profile growth add dsh-growth`。

```yaml
defaultRoot: "<your-local-growth-root>"
reportDir: .dsh-growth/reports
defaultCurrency: CNY
defaultTimezone: Asia/Shanghai
```

插件默认只读本地文件，不上传知识库，不自动发消息，不修改 CRM，不自动投放广告。外部 API 连接只作为后续可选的只读能力。

## 零门槛使用（推荐）

第一次使用不需要记住工具名、AARRR 定义、字段映射，也不需要先判断哪个文件最重要。只需要三件事：

1. 一个业务问题，例如“为什么激活率下降？”或“哪个获客渠道值得扩大？”；
2. 已配置的本地增长目录；如果知道文件，也可以直接提供文件名；
3. 允许插件读取本地数据。插件不会上传知识库。

如果是新项目，建议先做一次准备度检查：

```text
检查我的增长项目准备度。
告诉我哪些已具备、部分具备、缺失或暂不支持，并且只给我接下来最应该补齐的两个缺口；不要写入文件。
```

它会只读检查增长笔记和本地 CSV、JSON、JSONL 数据，不返回原始用户行；同时告诉你哪些经典方法已经在项目中出现、哪些目前只有审计或模板能力、哪些需要外部系统支持。如果你已经明确目标并希望直接分析，可以直接使用 `growth_review`。

最短的第一句复盘请求是：

```text
以“提升激活率”为目标，使用配置目录中最合适的数据复盘。
告诉我选了哪些文件、缺什么、最大瓶颈和下一步检查；不要写入文件。
```

如果不提供路径，`growth_review` 会扫描配置目录中的 CSV、JSON、JSONL 文件，分析字段和质量，自动选择最适合做事件分析与 MRR 分析的数据，并解释选择理由。如果发现多个候选文件，应先确认文件，再做预算或产品决策。

### 新手推荐的六步对话

```text
1. 检查我的增长项目准备度，告诉我哪些已具备、部分具备、缺失或暂不支持。
2. 以“提升激活率”为目标复盘，先告诉我缺什么，再给结论。
3. 按渠道和分群拆解瓶颈，区分证据和假设。
4. 把最高杠杆的假设转成 HADI 实验，加入主指标和护栏指标。
5. 用 RICE 排序，并说明哪些输入是估计值而不是事实。
6. 生成本周 WBR，只预览，不写文件。
```

你只需要替换业务目标和文件名，不需要改变流程。高级用户可以直接指定工具和参数，但不是必需的。

### 标准 SOP：六道决策门

不要把工具名当成流程。每一关满足退出条件后再进入下一关：

| 决策门 | 未满足前不能继续 | 下一步 |
|---|---|---|
| 问题与价值 | 目标用户、JTBD、North Star、目标指标和周期不清楚 | 补齐增长上下文 |
| 数据与口径 | 来源、字段映射、质量警告和缺失字段不清楚 | 修复或确认数据 |
| 瓶颈诊断 | 瓶颈没有绑定指标和来源，事实与假设混在一起 | 按漏斗、队列、渠道或收入拆解 |
| HADI 实验 | 没有主指标、护栏、负责人和停止条件 | 准备实验 |
| 机会排序 | RICE / ICE 输入没有证据，或估计值未标明 | 选择下一项机会 |
| 复盘与回写 | 报告没有来源、限制、负责人和决策日期 | 先预览，再确认写入 |

任何一关失败，只追问最小缺口并停在当前关卡。不要编造指标、把相关性当因果，也不要在预览前写入报告。

实际分析工具由 DeepSeek Harness / Cordis 宿主注册。Codex 插件可能只加载 `growth-operator` 使用说明，并不代表 Cordis 工具已经可调用；必须先确认宿主的可调用工具列表中出现 `growth_onboarding`，才能认为安装真正可用。

## 典型用法

第一次使用时，建议先从目标导向入口开始：

```text
以“提升激活率”为目标，在配置目录中自动选择最合适的数据复盘；告诉我选了哪些文件、还缺什么。
以“提升激活率”为目标复盘 events.csv；先告诉我数据缺什么，再给出结论。
审计这份增长计划，找出最大的指标和证据缺口。
分析 events.csv 的 AARRR 漏斗，并比较不同获客渠道。
根据 customers.csv 计算 MRR Bridge、NRR、CAC 和 Payback。
把这个增长想法转成 HADI 实验卡，并用 RICE 排序。
生成本周增长复盘，先预览，不要直接写入文件。
```

事件值支持常见中英文写法，例如 `signup` / `注册`、`activated` / `激活`、`active` / `活跃`、`invited` / `邀请` 和 `paid` / `付费`。

## 使用步骤

1. 由宿主配置 `defaultRoot`、报告目录、默认币种和时区。
2. 准备事件数据或 MRR 数据。事件数据至少包含 `user_id`、`event`、`timestamp`；MRR 数据建议包含 `period`、`type`、`amount`、`customer_id`、`active_customers`、`spend`。
3. 在对话中直接描述目标，插件会选择对应工具。例如：

```text
分析 events.csv 的 AARRR 漏斗，按 channel 和 segment 对比，并指出最大瓶颈。
分析 mrr.csv，计算 MRR Bridge、NRR、CAC、LTV 和 Payback，毛利率使用 0.8。
把激活率下降的问题转成 HADI 实验，并用 RICE 排序。
```

4. 报告先以 Markdown 返回。需要写入已有笔记时，先调用 `growth_apply` 使用 `confirm=false` 预览，确认内容后再使用 `confirm=true` 写入。

第一次复盘可以省略 `eventPath` 和 `economicsPath`。`growth_review` 会扫描配置的本地目录，选择最适合做事件分析和 MRR 分析的文件，并把选择结果写入 `assumptions`、`warnings` 和 `lineage`。如果发现多个候选文件，应先确认选择，再据此做预算或产品决策。

工具结果统一包含 `ok`、`data`、`warnings`、`assumptions`、`lineage` 和 `nextActions`。使用数字做决策前，必须先阅读 `warnings` 和 `lineage`。

### 外部获客方案与提交 SOP

如果要筛选产品目录、AI 工具导航或其他发现渠道，可以这样开始：

```text
使用 $growth-acquisition-execution，为我们的目标市场筛选相关产品目录渠道。
先读取本地候选资源，列出当前入口和条款的核验清单，完成质量门；最多设计 10 个试点站点方案，
只输出逐站授权清单和人工交接步骤，不浏览网站、不执行提交。说明未来如何把推荐访问和激活结果接回增长复盘。
```

该 skill 区分质量试点方案和已审核批量方案；不会执行外部网站操作，不会绕过 CAPTCHA 或邮箱验证，不会编造产品资料，也不会把提交数量当成增长效果。

### AI 搜索可发现性方案

如果要判断产品是否适合 AI 搜索、AI 产品发现或 LLM 可理解性准备，可以这样开始：

```text
使用 $growth-ai-discoverability，评估我们的产品是否适合 AI 搜索和产品发现准备。
先判断业务类型和目标，再按可抓取性、机器可理解事实、内容可信度和商品 Feed 适用性建立准备度矩阵；
只输出缺口、负责人、验收标准和验证指标，不扫描网站、不修改代码。
```

它会区分通用搜索基础和平台专属建议；没有站点或工程证据时标记为 `needs-external-validation`，不会承诺排名、收录、AI 引用或转化。

### 经典增长方法方案

如果不知道当前问题应该使用哪套经典方法，可以这样开始：

```text
使用 $growth-strategy-planning 处理我们当前的增长问题。
选择最小而有用的经典方法，区分已观察证据和假设，输出方案材料，
绑定一个主指标和护栏指标，并把最高风险假设转成 HADI 实验；不要编造缺失输入。
```

它会按问题路由方法：价值主张 / Lean Canvas 用于上下文，Bullseye 用于渠道，Aha Moment 用于激活，流失 / 召回用于留存，Opportunity Solution Tree 用于从诊断到方案；定价、B2B 和 Growth Accounting 只在业务模型需要时使用。

### 如何阅读结果

| 字段 | 含义 | 用户应该怎么做 |
| --- | --- | --- |
| `ok` | 工具是否完成 | 为 false 时先修复错误 |
| `data` | 分析结果或 Markdown 报告 | 先读其他字段，再使用其中的数字 |
| `warnings` | 数据质量风险和限制 | 必须和结论一起阅读 |
| `assumptions` | 默认值或自动选择的数据源 | 做决策前确认是否合理 |
| `lineage` | 来源文件、字段和时间窗口 | 用来追溯重要数字 |
| `nextActions` | 下一步检查或行动 | 指定负责人和决策日期 |

`null` 表示“当前数据不足以可信计算”，不是零。例如缺少 spend 时 CAC 和 Payback 会保持不可用，缺少期初 MRR 时首期增长率和 NRR 会标记为部分可用。

### 数据字段示例

```csv
user_id,event,timestamp,channel,segment
u001,acquired,2026-08-01T09:00:00Z,content,team
u001,activated,2026-08-01T09:20:00Z,content,team
u001,retained,2026-08-08T09:20:00Z,content,team
```

分析结果中的 `warnings` 必须一并阅读：缺失金额、投放成本、活跃客户数或起始 MRR 不会被静默当作零，相关指标会保持不可用并明确说明原因。

### 常见数据准备方式

事件数据最少可以只有三个字段：

```csv
user_id,event,timestamp
u001,注册,2026-08-01T09:00:00Z
u001,激活,2026-08-01T09:20:00Z
u001,活跃,2026-08-08T09:20:00Z
```

需要 MRR 和获客成本时，再提供实际拥有的字段：

```csv
period,type,amount,customer_id,active_customers,spend,currency
2026-08,new,1000,c001,20,5000,CNY
2026-08,expansion,200,c002,20,,CNY
2026-08,churned,100,c003,20,,CNY
```

不要为了通过检查而编造缺失字段。插件会保留相关指标不可用，并告诉你需要补什么。

### 常见问题怎么处理

| 看到的情况 | 代表什么 | 下一句话怎么说 |
| --- | --- | --- |
| 找不到可用数据 | 配置目录没有支持的文件或字段无法识别 | `检查我的增长目录，告诉我缺少哪个文件或字段。` |
| 自动选了多个候选文件 | 找到了多个可能的数据源 | `事件使用 events-prod.csv，收入使用 mrr-2026.csv。` |
| 漏斗阶段少于两个 | 事件名未识别或事件数据不完整 | `分析 events.csv 的事件值，并按 signup=注册、activation=激活 指定阶段。` |
| CAC / LTV / Payback 是 `null` | 缺少 spend、活跃客户、毛利率或流失证据 | `告诉我计算 CAC、LTV、Payback 还需要哪些准确字段。` |
| NRR 或 MRR 增长是部分结果 | 缺少期初 MRR 或 movement 金额 | `告诉我哪些周期和 movement 行导致 MRR Bridge 不完整。` |
| 写入被拒绝 | 路径越界、不是 Markdown，或预览后文件被修改 | `重新预览报告，并给我一个增长目录下的安全写入路径。` |

如果可调用工具列表中没有 `growth_onboarding` 或 `growth_review`，不要把 skill 说明当成工具已加载。请重新安装插件并在 DeepSeek Harness / Cordis 中新建会话；如果目标是 Codex，则还需要 MCP 适配层才能暴露 Cordis 工具。

## 开发

```bash
pnpm install
pnpm run typecheck
pnpm run lint
pnpm test
pnpm run build
```

## 许可证

MIT，详见 [LICENSE](./LICENSE)。