dsh-plugin-user-research
DeepSeek Harness 插件 · 把调研笔记变成产品决策
输入访谈记录、问卷开放题或用户反馈,输出用户画像、痛点原话、可验证的机会点。
简介
做用户研究最怕两件事:一是访谈/问卷记了一大堆,最后只能凭感觉总结;二是让 AI 直接总结,结果它替你"编"了好多原话里没有的结论。
这个插件做的是一个有方法论约束的用户研究合成工具:它不替你下判断,而是把原始素材按一套固定的研究框架拆成"画像—痛点—机会",让你能基于真实证据做决策。
它提供什么
- 一套主题分类口径(效率、易用性、成本、功能缺失、稳定性、服务支持),让散落在各处的用户原话自动归类。
- 一个反幻觉约束:痛点只引用用户原话,不扩写、不脑补。
- 一个机会评分口径:按"被多少人提到 + 是否明确表达痛苦"排序,帮你筛出值得先看的方向。
- 4 个可复用的研究技能(访谈分析、画像构建、机会地图、合成全流程)和 2 个模板(访谈提纲、合成画布)。
它能做什么
一个 agent 可调用的工具 + 一套方法论技能:
- 工具
research_synthesize:输入一份笔记文件,输出结构化合成结果
personas — 推断的用户画像(角色 / 诉求信号 / 主题)painPoints — 抽出的痛点原话(带主题与严重度,绝不替用户编造结论)opportunities — 按信号强度排序的机会点(含可解释的评分口径)
- 技能(按名加载):
/user-research-synthesis、/interview-analysis、/persona-build、/opportunity-map
- 模板:访谈提纲、合成画布(markdown)
使用过程
三步就能跑起来:
-
准备素材:把访谈录音转写、问卷开放题导出、客服聊天记录或用户反馈整理成一个 .txt、.md 或 .csv 文件。
-
调用工具:在 dsh 会话里说:
把 notes/interview-01.md 做一次用户研究合成,挑出前 3 个机会点。
agent 会调用 research_synthesize(filePath="notes/interview-01.md", maxOpportunities=3)。
-
看结果:你会拿到一份结构化输出,包含按主题归类的痛点原话、推断出的用户画像,以及按信号强度排序的机会点。
适合谁用 / 运用场景
| 角色 | 场景 |
|---|
| 产品经理 / 需求分析师 | 做完用户访谈后,把 10 份录音转写快速合成出"用户真正在抱怨什么" |
| UX 研究员 / 设计师 | 从可用性测试笔记中抓出高频痛点,支撑设计决策 |
| 创业者 / 市场人员 | 整理问卷开放题、竞品评论、售前咨询记录,找未被满足的需求 |
| 客服 / 用户成功 | 把用户投诉和反馈聚类,定位产品改进优先级 |
一句话:只要你手里有一堆用户的原话,想把它变成"谁有什么痛、值不值得做"的清晰结论,这个工具就适合你。
安装
# 装入 web profile(装完需重启 web 服务)
dsh plugin --profile web add dsh-plugin-user-research
或临时用绝对路径挂载(开发期,不改全局配置):
dsh web --patch ./cordis.patch.yml
# 本地开发请把 cordis.patch.yml 里的 name 改为 index.js 的绝对路径,见文件内注释
装好后,在会话里直接说:
把 notes/interview-01.md 做一次用户研究合成,挑出前 3 个机会点。
agent 会调用 research_synthesize(filePath="notes/interview-01.md", maxOpportunities=3)。
它是怎么分类和打分的
主题分类
素材会按 6 个常见维度自动归类:
- 性能 / 效率
- 易用性 / 上手
- 价格 / 成本
- 功能缺失
- 稳定性 / 信任
- 服务 / 支持
每个维度对应一组中文信号词。如果你对某个领域有特定口径(比如医疗、教育、B2B),可以在 synthesize.js 的 THEME_TAXONOMY 里自己增删。
机会点怎么排序
机会得分 = 信号条数 × 1 + 显式痛点条数 × 2
简单说:被越多人反复提到、越明确表达痛苦的需求,得分越高。但它只告诉你"这里值得多看一眼",要不要做、能不能做,仍然要你自己结合业务判断。
为什么不"编"结论
工具在输出痛点时,只引用用户原话,不会扩写成"用户认为……"。样本太少的时候,它也会直接提示"结论置信度低"。这样你拿到的东西才能拿去跟团队对质,而不是一段看起来很有道理但查无实据的漂亮话。
架构
dsh-plugin-user-research/
├── index.js # dsh 插件入口:把 synthesize 接成 research_synthesize 工具
├── synthesize.js # 纯逻辑合成引擎(与 Cordis 解耦,可独立单测)
├── cordis.patch.yml # bundle 挂载描述(insert 行)
├── skills/ # 4 个方法论技能包(SKILL.md)
├── templates/ # 访谈提纲 / 合成画布
└── test/synthesize.test.js
核心逻辑刻意不依赖任何 @deepseek-ai/* 运行时,因此可以脱离 DeepSeek Harness 单独测试。
测试
node --test
# 9 passed —— 覆盖语句切分、主题检测、痛点判定、画像推断、评分排序、计数截断、空输入
核心合成逻辑是脱离 dsh 框架写的纯函数,所以可以直接用 node --test 跑,不需要启动整个 agent 环境。这也是我们敢在预览期 dsh 上发布插件的底气——只要主题分类和评分逻辑不变,框架接口再怎么变,这部分都不会坏。
版本与兼容性
- 验证依据:
@deepseek-ai/dsh@0.1.0-rc.7(npm latest,2026-08-19),Node ^22.19 || >=24
- ⚠️ DeepSeek Harness 为开发者预览,官方明确会有破坏性变更。升级 dsh 后请重跑
node --test 并核对 defineTool 契约。
package.json 的 engines.dsh 已锁定 >=0.1.0-rc.7。
License
MIT
