dsh-brainstorming

DeepSeek Harness Web UI 的 AI 头脑风暴插件：在无限画布上从一个想法出发，通过提问、意图分析、调研和人工编辑，把思路逐步展开成一棵可交互的思考树。

功能

• 无限画布：PixiJS 点阵背景，支持平移、缩放、节点拖拽和自动保存
• AI 提问：分析当前节点，生成 3–5 个能推进思考的高质量问题；问题节点可以直接输入回答
• 分析意图：从当前节点提炼多个不同意图，并分别生成子节点
• 调研流程：选择方向 → 生成可编辑调研大纲 → 确认后生成调研结果
• 节点编辑：双击节点编辑内容；选中后按 Delete / Backspace 删除
• 历史画布：每个画布独立保存，可新建、打开、删除
• 统一 UI：shadcn 风格组件 + Base UI 原语，详见 docs/UI_STANDARD.md

环境要求

• DeepSeek Harness Web UI
• 一个可用的 DSH 模型 provider（默认模型或插件配置）

安装

从 npm 安装（推荐）

在 DeepSeek Harness 的 Plugin Manager / 插件管理 中安装：

dsh-brainstorming

或指定版本：

dsh-brainstorming@0.0.1

安装后刷新页面，左侧栏会出现「头脑风暴」面板。

从源码安装

git clone https://github.com/m430/dsh-brainstorming.git
cd dsh-brainstorming
pnpm install
pnpm build

然后在 DSH Plugin Manager 中选择这个本地目录安装。

使用

1. 左侧栏点击「头脑风暴」。
2. 新建一个画布，点击「+ 添加点子」。
3. 选中节点后：
   • 点击「提问」：AI 生成问题子节点，可直接输入回答
   • 点击「分析意图」：AI 把节点拆成多个意图子节点
   • 点击「调研」：生成调研大纲，确认后继续调研
   • 点击「AI 修改」：根据你的指令改写当前节点
4. 双击任意节点编辑内容；拖动节点调整位置；滚轮缩放。

配置

默认使用 DSH 当前选择的模型。也可以在 profile 的 cordis.patch.yml 中为插件指定模型：

- id: dsh-brainstorming
  config:
    provider: magpie
    model: auto/deepseek-v4.1-flash
    timeoutMs: 120000
    maxOutputTokens: 1800

插件不需要也不读取 API Key。 Key 由 DSH 的 provider / credentials 层管理。

安全与隐私

• 插件不会把 API Key 打包进前端或提交到仓库。
• AI 请求通过 DSH 的 ctx.llm 服务发出，Key 留在 Host 的 credentials 层。
• 所有插件路由走 DSH /api 鉴权通道，未登录请求返回 401。
• 画布内容保存在浏览器 localStorage，属于本地数据。
• 节点内容和提示词会发送给当前配置的模型 provider；处理敏感内容时请使用本地模型。
• 安全问题请通过 SECURITY.md 报告。

开发

pnpm install --ignore-scripts
pnpm build
pnpm check

修改 src/client/** 后必须重新构建 client.js。pixi.js 与 Base UI 组件打包进 client.js，React / ReactDOM 由 Harness Client 模块表提供。

项目结构

index.js                     Host 入口
src/host/index.js            Host：提示词、模型调用、/api 路由
src/client/index.jsx         Client 入口：样式、locale、slot 注册
src/client/app.jsx           工作区根组件
src/client/ui/               shadcn 风格组件库
src/client/brainstorm/       画布、节点、历史画布、弹窗
scripts/build-client.mjs     esbuild 构建脚本
client.js                    构建产物

API

POST /api/dsh-brainstorming/brainstorm/expand
POST /api/dsh-brainstorming/brainstorm/questions
POST /api/dsh-brainstorming/brainstorm/intents
POST /api/dsh-brainstorming/brainstorm/outline
POST /api/dsh-brainstorming/brainstorm/research
POST /api/dsh-brainstorming/brainstorm/modify

许可证

项目代码使用 MIT License。打包的第三方依赖及图标许可证见 THIRD_PARTY_NOTICES.md。