dsh-scholar 使用指南
DSH 内的纯计算科研工作台插件:用阶段化 Chat、Idea、Contract 与 TeX 手稿把研究项目存进同一可恢复项目里。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
dsh-scholar
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add --allow-build=@dsh-scholar/research-plugin github:lzszq/dsh-scholar
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- 按阶段引导研究:Chat 支持自由对话、Grill Me 信息收集、文件上传、显式 slash command,并依据当前研究阶段展示权威下一步。
- 可治理的研究流程:Scope、Idea、Contract、Evidence、Direction 和 Release 决策都有明确权限、revision 绑定和审计记录。
- 受控执行:Runner Profile 描述本机、本机 Docker 或远程 SSH 环境,包括固定容器镜像和声明式 NVIDIA GPU 能力。
- 一体化工作台:项目级 Chat、可编辑文件、session 绑定 Web 终端、运行日志、产物、TeX 源码、编译诊断和 PDF 预览共用同一上下文。
- 可追溯方法论:Protocol revision、运行分类、综合请求、Assurance、Reviewer finding、Knowledge Pack 激活和 Claim-Evidence 关系会成为持久研究状态。
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
这个插件是给谁用的?
做机器学习、数据科学、生物信息学等纯计算研究的研究者。它不用于临床决策、人体试验、湿实验或其他高风险场景。
跟 DSH 自带的 Chat / 工具有什么区别?
DSH 提供通用模型对话与工具运行时;本插件在 DSH 内注入一组研究专用工具(dsh_scholar、research_project、literature_search、idea_create 等)和一级 slash command(/new、/survey、/contract、/run、/evidence 等),并在 ~/.dsh/research-kernel 里维护一个独立的项目状态机做 phase、gate、run、evidence 追踪。
Agent 能自动批准 Gate 或 Release 吗?
不能。Gate-only 是默认模式;Agent 不能冒充 Human principal、伪造 accepted Evidence 或绕过研究 Gate。full-auto 只在已登记的 FixtureProfile 上对 allowlist 内的 Scope/Idea/Contract/Budget 自动批准,Release 始终由人决定。
在哪里能看到 Chat 之外的工作台?
通过 Alt+Shift+S(可在设置改键位或禁用)打开独立页面,或点击 dsh Scholar 页签里的"在新页面打开"。完整工作台(文件树、PTY、TeX PDF、Evidence、Trajectory、Topology 等)只在 standalone 页面提供;DSH 主区只显示当前阶段、下一步与执行摘要的紧凑视图。
数据存在哪里?可以跨设备同步吗?
项目数据落在本机 ~/.dsh/research-kernel 这个权威数据目录;DSH 浏览器与 standalone 工作台共享同一目录,所以切换入口不会丢项目。Standalone 浏览器侧只在 ~/.dsh-scholar-standalone/research-ui-standalone 存 token、显示偏好和会话,不保存业务数据。当前没有云同步。
跟哪些 DSH 版本兼容?
插件 manifest(dsh.client)声明同时注入 8 个 @deepseek-ai/dsh-* 与 @deepseek-ai/dsh-client-* 包,版本均要求 ^0.1.0-rc.8。cordis ^4.0.0、schemastery ^3.18 也在 peerDependencies 中。
怎么卸载?
运行 dsh plugin --profile web remove @dsh-scholar/research-plugin。同时可手动删 ~/.dsh/research-kernel 与 ~/.dsh-scholar-standalone/ 清掉本机数据。
跑正式实验一定要 Docker 吗?
Runner Profile 有三类(local / local Docker / remote SSH)。正式 Job 必须绑定不可变代码/数据快照、固定镜像和声明式 NVIDIA GPU 能力;本机进程模式只为受信开发与冒烟,不是正式实验路径。
— 源: plugin_wiki.faq_json
兼容性
- DSH: 0.1.0-rc.8+
- Node: >=24.0.0
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则