前言¶

用 DSH 做计算类研究时，常见做法是：对话在 Chat 里，代码和数据散落在本地目录，实验日志靠手工整理，论文草稿另开编辑器。阶段推进靠记忆，Scope、实验 Contract、Evidence 与 Claims 之间缺少可审计的绑定，也很难从一次对话直接恢复到完整项目状态。

下面介绍 dsh-scholar（GitHub：lzszq/dsh-scholar，维护者 lzszq）。它是 DSH 的科研工作区插件，把项目对话、研究材料、代码与数据、受控实验运行、Evidence 与 TeX 手稿放在同一可恢复项目里。你可以从新问题起步，也可以接续已有工作继续推进。

这是什么¶

dsh-scholar 在 SkillHub 分类为「联网工具」，当前 GitHub 星标 25。包名为 @dsh-scholar/research-plugin（版本 0.1.0，MIT 许可证），面向机器学习、数据科学、生物信息学等计算研究，不面向临床决策、人体试验或湿实验等高风险场景。

插件与独立工作区共用同一 Research Kernel（127.0.0.1:7412）和项目数据目录（~/.dsh/research-kernel）。在 DSH 中安装后，会新增 Scholar 工具、斜杠命令、Skills、设置项，以及紧凑的 dsh Scholar 标签页；未绑定的对话可关联已有项目或创建仅含名称的新项目，已绑定对话则显示当前阶段、下一步与执行摘要，完整界面通过「Open in new page」或快捷键打开。

核心功能¶

阶段感知的研究引导¶

Chat 支持自然语言、Grill Me 立项问答、文件上传、显式斜杠命令，以及针对当前研究阶段的权威 NextAction 提示。普通叙述会按项目当前阶段解释；显式命令则是确定性的高级入口。

可治理的研究流程¶

Scope、Idea、Contract、Evidence、Direction、Release 等决策保持显式、可修订、可审计。默认治理模式为 gate-only：Agent 不能冒充 Human 主体、伪造已接受的 Evidence，或绕过研究 Gate。full-auto 仅对注册 FixtureProfile 中白名单内的 Scope、Idea、Contract、Budget Gate 自动放行，且当前唯一规范动作执行器为 survey_run；Release、Direction、Intake、Evidence 等仍由 Human 控制。

受控执行环境¶

Runner Profile 描述本地、本地 Docker 或远程 SSH 环境，可固定容器镜像并声明 NVIDIA GPU 能力。正式 Job 在 Profile、目标、快照、Protocol 与预算就绪前不会执行；缺失 Runner、离线目标、SecretRef 不可用或 Contract 不完整时，界面会显示准备中或阻塞项，而非标记为可运行。

一体化工作区¶

项目级 Chat、可编辑文件、会话绑定 Web 终端、运行日志、产物、TeX 源码、编译诊断与 PDF 预览共享同一上下文。Protocol 修订、运行分类、综合请求、审阅结果、知识包激活，以及 Claim 与 Evidence 的链接都会持久化为研究状态。Trajectory 与 Topology 可查看子 Agent 的父子关系、状态、后续任务与输出。

安装与启用¶

本地工作区要求 Linux、Node.js 24、pnpm 11.20.0，以及用于受控实验、TeX 编译与洁净室复现的 Docker Engine。@dsh-scholar/* 包尚未发布到 npm，需从源码构建并以本地路径安装。

1. 构建独立工作区（可选但推荐）¶

克隆或下载仓库后，在仓库根目录执行：

pnpm install --frozen-lockfile
pnpm run build

启动独立 UI：

bash scripts/start-standalone-ui.sh

浏览器打开 http://127.0.0.1:18610，从以下文件读取 token 并粘贴：

~/.dsh-scholar-standalone/research-ui-standalone/standalone-token

2. 安装 DSH 预发布版¶

npm install -g @deepseek-ai/dsh@next
npm ls -g @deepseek-ai/dsh --depth=0

记录实际安装版本，便于排查兼容问题。

3. 将插件加入 DSH web profile¶

在仓库根目录完成构建后，用绝对路径注册插件：

cd /absolute/path/to/dsh-scholar
pnpm install --frozen-lockfile
pnpm run build
dsh plugin --profile web add /absolute/path/to/dsh-scholar
dsh plugin --profile web why @dsh-scholar/research-plugin
dsh web

更新时重建同一 checkout 并再次 add 同一路径。卸载：

dsh plugin --profile web remove @dsh-scholar/research-plugin

4. 配置执行环境与插件项¶

在独立工作区或 DSH 中打开 Settings → Execution environment，选择 Runner Profile（本机、本地 Docker 或远程 SSH）。在 DSH 中打开 Settings → Plugin config → dsh Scholar；保存后需重启 DSH 生效。

Standalone URL 不能包含凭证、查询参数或片段。访问 token 仅能从 loopback 上的 DSH 实例经显式点击复制，页面不展示 token，也不暴露 Kernel、Runner、Provider 或 SSH 密钥。

典型用法¶

三种入口¶

1. 新研究：只提供项目名，在 Chat 中回答 Grill Me 问题完成 Brief。
2. 打开已有项目：接续已持久化的阶段、对话、文件、任务、运行与方法学历史。
3. 上传 / 加入：把论文、代码、数据、图像或日志挂到已有阶段；上传材料先进入隔离的 Intake，不会自动成为 Evidence。

常见流程¶

Create or join → Grill Me → Scope → survey → Ideas → Baseline → Contract
→ controlled Runs → classification and synthesis → Evidence and Claims
→ TeX writing and review → private bundle → Human Release Gate

常用斜杠命令¶

/new  /status  /survey  /ideas  /ideas generate 3  /ideas select <idea_id>
/gates  /contract  /run  /evidence  /claims  /write  /review
/release-bundle  /release

/run 仅在快照、Protocol、Runner、目标与预算全部就绪时执行。正式实验须绑定不可变代码与数据快照、在需要时冻结的 Protocol，以及显式 Runner Profile；Chat 文本、普通 stdout 与交互式终端输出不会自动成为正式 Evidence。

适用场景与注意¶

适合谁：需要在 DSH 内做可审计、可复现计算研究的开发者或研究者；希望把立项、实验 Contract、运行、Evidence 与 TeX 写作串成一条可追溯链路，而不是把各阶段拆在多个工具里手工对齐。

边界：插件协助研究，不承担科学判断、审批、署名或发表责任；不适用于临床决策、人体研究、湿实验等场景。full-auto 有严格的 Fixture 与白名单边界，Release 始终由 Human 控制。

安全与权限：插件以当前 dsh 进程权限运行，可访问本机文件、调用已配置的执行环境与网络能力。安装前应阅读源码与 MIT 许可证，确认 Runner、SSH SecretRef 与远程目标配置符合你的安全策略。DSH 生态遵循「一切皆插件」；SkillHub（https://www.skillhub.cn/plugins/lzszq/dsh-scholar）是独立社区目录，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-scholar 把 DSH 对话层与可治理的研究工作流、受控执行和手稿产出接到同一项目数据目录，适合需要阶段清晰、证据可追溯的计算研究场景。目录页与源码分别见 SkillHub 与 GitHub：

• 目录页：https://www.skillhub.cn/plugins/lzszq/dsh-scholar
• GitHub：https://github.com/lzszq/dsh-scholar