增长获客
中文 | English
dsh-growth 是一个本地优先的 DeepSeek Harness 插件,用于把 Markdown、CSV 和 JSONL 中的增长资料与业务数据,转化为可解释的增长诊断、落地方案和执行 SOP。
六插件公开协作契约:SUITE.md。
growth_artifact_review 校验增长工件;growth_attribution_review 只比较具备 baseline 的观测,不自动宣称因果。
插件定位:营销阶段的增长经营与测量层
dsh-growth 负责营销阶段的获客、激活、留存和增长实验,同时把产品行为、营销效果和变现结果放进同一套测量框架。dsh-business 提供商业目标与经济边界,dsh-sales 提供成交与管道证据。
定位架构:商业策略层 + 四段主链路
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 |
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:
npx --yes @deepseek-ai/dsh plugin --profile growth add dsh-growth
npx --yes @deepseek-ai/dsh --profile growth --dump-config如果 Harness 宿主还没有启动,先启动 Web UI:
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。
defaultRoot: "<your-local-growth-root>"
reportDir: .dsh-growth/reports
defaultCurrency: CNY
defaultTimezone: Asia/Shanghai插件默认只读本地文件,不上传知识库,不自动发消息,不修改 CRM,不自动投放广告。外部 API 连接只作为后续可选的只读能力。
零门槛使用(推荐)
第一次使用不需要记住工具名、AARRR 定义、字段映射,也不需要先判断哪个文件最重要。只需要三件事:
1. 一个业务问题,例如“为什么激活率下降?”或“哪个获客渠道值得扩大?”; 2. 已配置的本地增长目录;如果知道文件,也可以直接提供文件名; 3. 允许插件读取本地数据。插件不会上传知识库。
如果是新项目,建议先做一次准备度检查:
检查我的增长项目准备度。
告诉我哪些已具备、部分具备、缺失或暂不支持,并且只给我接下来最应该补齐的两个缺口;不要写入文件。它会只读检查增长笔记和本地 CSV、JSON、JSONL 数据,不返回原始用户行;同时告诉你哪些经典方法已经在项目中出现、哪些目前只有审计或模板能力、哪些需要外部系统支持。如果你已经明确目标并希望直接分析,可以直接使用 growth_review。
最短的第一句复盘请求是:
以“提升激活率”为目标,使用配置目录中最合适的数据复盘。
告诉我选了哪些文件、缺什么、最大瓶颈和下一步检查;不要写入文件。如果不提供路径,growth_review 会扫描配置目录中的 CSV、JSON、JSONL 文件,分析字段和质量,自动选择最适合做事件分析与 MRR 分析的数据,并解释选择理由。如果发现多个候选文件,应先确认文件,再做预算或产品决策。
新手推荐的六步对话
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,才能认为安装真正可用。
典型用法
第一次使用时,建议先从目标导向入口开始:
以“提升激活率”为目标,在配置目录中自动选择最合适的数据复盘;告诉我选了哪些文件、还缺什么。
以“提升激活率”为目标复盘 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. 在对话中直接描述目标,插件会选择对应工具。例如:
分析 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 工具导航或其他发现渠道,可以这样开始:
使用 $growth-acquisition-execution,为我们的目标市场筛选相关产品目录渠道。
先读取本地候选资源,列出当前入口和条款的核验清单,完成质量门;最多设计 10 个试点站点方案,
只输出逐站授权清单和人工交接步骤,不浏览网站、不执行提交。说明未来如何把推荐访问和激活结果接回增长复盘。该 skill 区分质量试点方案和已审核批量方案;不会执行外部网站操作,不会绕过 CAPTCHA 或邮箱验证,不会编造产品资料,也不会把提交数量当成增长效果。
AI 搜索可发现性方案
如果要判断产品是否适合 AI 搜索、AI 产品发现或 LLM 可理解性准备,可以这样开始:
使用 $growth-ai-discoverability,评估我们的产品是否适合 AI 搜索和产品发现准备。
先判断业务类型和目标,再按可抓取性、机器可理解事实、内容可信度和商品 Feed 适用性建立准备度矩阵;
只输出缺口、负责人、验收标准和验证指标,不扫描网站、不修改代码。它会区分通用搜索基础和平台专属建议;没有站点或工程证据时标记为 needs-external-validation,不会承诺排名、收录、AI 引用或转化。
经典增长方法方案
如果不知道当前问题应该使用哪套经典方法,可以这样开始:
使用 $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 会标记为部分可用。
数据字段示例
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 不会被静默当作零,相关指标会保持不可用并明确说明原因。
常见数据准备方式
事件数据最少可以只有三个字段:
user_id,event,timestamp
u001,注册,2026-08-01T09:00:00Z
u001,激活,2026-08-01T09:20:00Z
u001,活跃,2026-08-08T09:20:00Z需要 MRR 和获客成本时,再提供实际拥有的字段:
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 工具。
开发
pnpm install
pnpm run typecheck
pnpm run lint
pnpm test
pnpm run build许可证
MIT,详见 [LICENSE](./LICENSE)。