Sakura1345/dsh-research-studio

Harness Research Studio

Harness Research Studio

会话地图 × 数学实验室 × 液态玻璃

将分支思考、交互实验与清晰的研究界面，带进 DeepSeek Harness。

下载与安装 · 功能 · 从独立插件迁移 · 源码构建

Harness Research Studio 是面向 DeepSeek Harness Web 0.1.5-rc.2 的社区插件。一次安装，即可使用树状对话、数学与数据可视化、轻量模型实验，以及适配浅深色的液态玻璃主题。

首个整合版本 0.1.0 包含会话地图 0.2.2、数学实验室 0.2.0、玻璃主题 0.2.0。它是一个可直接安装的插件包，运行时无需分别安装三个组件。

功能

会话地图：以树状对话，构建清晰的研究脉络

从任意已完成节点独立追问，将不同假设、推导路径与研究方向组织为可交互的会话树。每个分支继承到所选节点的上下文；侧栏按同一家族归集，便于回溯和比较。

- 树状分支、折叠、平移缩放与自动整理。
- 地图内上传附件、选择模型、查看思考与工具记录、处理权限申请。
- 数学公式与表格排版，选中轮次直接显示对应图表。
- 会话归档与恢复、工作区管理、原生与归集列表双向切换。
- 阅读区域、字号和正文／图表比例可调。

共同问题
├─ 方向 A：验证一个假设
│  └─ 继续分析与实验
└─ 方向 B：尝试另一种解释

数学实验室：让公式、数据与模型成为可探索的交互实验

按需将公式和数据转化为可缩放、可调参、可逐步观察的图表与实验。支持通用科研探索，并提供面向量化研究的图表类型。

| 能力 | 支持内容 |
| --- | --- |
| 函数与动画 | 二维函数、多曲线、参数曲线、三维曲面；滑块调参、播放、暂停、单步、时间轴回看 |
| 数据图表 | 时序、散点、直方图、热力图、相关性、箱线、QQ、等高线、三维散点等 |
| 量化研究 | K 线、盘口深度、收益分布、回撤、滚动统计、自相关、markout |
| 模型实验 | 线性／岭／逻辑回归、K-means、基础 boosting、浅层神经网络、AR 时序模型 |
| 随机模拟 | GBM、OU、随机游走与蒙特卡洛；逐步、连续与快速完成 |

图表支持拖动平移、滚轮缩放、独立高度调整、PNG 导出，以及适用图型的 SVG 导出。驻点标注按需开启；三维视角使用固定参考网格。训练和模拟由用户主动启动，适用于小数据教学与探索。

AI 在用户明确要求绘图、可视化或演示，或确认上一轮建议后调用工具。普通数学问题正常回答，不因出现公式而自动生成图表。

液态玻璃：清晰、通透，并关注性能

浮动侧栏、输入区与工具栏采用半透明材质、背景模糊和柔和的反光边缘。主题跟随 Harness 的浅色、深色或系统设置，也可切回经典界面。

设置位置：设置 → 通用设置 → 界面风格。

- 通透：少量界面区域的背景模糊与局部高光。
- 轻量：关闭模糊与指针跟随，保留圆角、亮边和层次。
- 轻动效：可独立关闭；指针静止时无持续动画循环。

正文、公式与图表保持独立阅读层，主题不创建额外 WebGL 画布，也不会启动模型训练。

安装

需要已安装的 DeepSeek Harness Web 0.1.5-rc.2，以及 Node.js 22.19 或更新版本。其他 Harness 版本尚未验证；Desktop 不在本版本的验证范围内。

1. 在 Releases 下载 dsh-research-studio-0.1.0.tgz，或解压完整 ZIP 得到该文件。
2. 在文件所在目录执行：

dsh plugin --profile web add "./dsh-research-studio-0.1.0.tgz" --offline --ignore-scripts

3. 自行重启 Harness，刷新浏览器。侧栏会出现 会话地图 和 数学实验室，设置中出现 界面风格。

自定义 profile 请把 web 换成实际名称。安装不会自动重启已有服务。Release 安装包包含绘图库、数学组件、字体和计算线程，无额外运行依赖或安装脚本。无需安装 Codex skill。

从独立插件迁移

已装过 dsh-local-map、dsh-math-lab 或 dsh-glass-theme 时，请先将这几个旧插件从同一 profile 中移除，再安装整合包，避免重复注册。只移除实际已安装的插件名：

dsh plugin --profile web remove dsh-local-map dsh-math-lab dsh-glass-theme --offline --ignore-scripts
dsh plugin --profile web add "./dsh-research-studio-0.1.0.tgz" --offline --ignore-scripts

完成两步后再重启。插件包的移除不会删除 Harness 会话；整合版保留既有事件、实验结果和浏览器偏好的标识，已有会话、地图模式与图表可继续使用。不同时运行独立版与整合版。

卸载整合版：

dsh plugin --profile web remove dsh-research-studio --offline --ignore-scripts

示例指令

从这个结论分成两个方向：分析适用条件，再尝试构造反例。

画出 x²−y²，允许我开启鞍点标记并旋转观察。

做一个割线趋近切线的交互动画，让我暂停、单步和回看。

用这份数据绘制收益分布、回撤和自相关，并注明时间单位与样本范围。

创建一个逻辑回归实验，让我单步查看损失、梯度与参数变化。

本地运行与边界

- 图表组件、公式字体和轻量计算在本机运行，无 CDN、遥测或插件自建外部服务。
- 实验室直接导入的 CSV／JSON 只在当前页面读取，不会自动发送给模型。对话附件与在线模型仍遵循 Harness 原有的数据发送规则，“本地插件”不等于“模型完全离线”。
- 实验工具只接受经过校验的结构化数据与数学表达式，不执行工具输入中的任意 HTML、JavaScript、Python 或 SQL。
- 示例明确标为合成数据。数值驻点搜索不保证找全；动画不是解析证明；轻量训练与模拟不能替代完整科研验证。
- 地图模式是会话家族的一次性选择，启用后不提供切回普通对话的开关。旧版曾生成的重复分支不会被自动删除或改写。
- 目标 Harness 为预发布版本。少量 UI 类名和恢复归档适配与 rc.2 有关，升级 Harness 后应先确认兼容性。

完整能力和限制见 会话地图、数学实验室、主题 的模块说明。

源码构建

源代码按三个组件维护，通过根构建脚本生成一个客户端入口和一个宿主插件入口。修改逻辑后仍只分发一个 TGZ。

npm run setup
npm run build
npm test
npm run package

setup 按各模块的锁文件安装开发依赖，并禁用安装脚本。构建还需要官方 Harness 0.1.5-rc.2 的接口文件；Windows 默认读取 npm 全局安装目录，其他位置请将 DSH_PACKAGE_JSON 指向官方包的 package.json。

$env:DSH_PACKAGE_JSON = "$(npm root -g)/@deepseek-ai/dsh/package.json"

TGZ 可跨平台生成；附带完整源码的 ZIP 使用 Windows PowerShell 打包。发布文件位于 dist/，附 SHA-256 校验清单。仓库不包含开发机目录、会话记录、模型配置或凭据。

许可证与致谢

项目以 MIT 许可证发布。第三方组件及字体遵循各自许可证，完整声明见 THIRD_PARTY_NOTICES.md 与模块目录中的许可证。

感谢 DeepSeek Harness，以及 Plotly.js、mathjs、KaTeX、Papa Parse 等开源项目。玻璃风格参考 Apple Liquid Glass 的材质理念，Web 实现使用背景模糊与渐变高光，并非 Apple 原生渲染器。

本项目是独立的社区插件，与 DeepSeek 或 Apple 无官方隶属关系。