bill9109/dsh-101 预览 preview

bill9109/dsh-101

Plugin插件 Native原生 ⭐ 6 BSD-3-Clause Docs & Writing文档与写作Prompts & Skills提示词与技能

Install: bash <(curl -fsSL https://raw.githubusercontent.com/bill9109/dsh-101/main/scripts/install.sh) github:bill9109/dsh-101#v0.1.7

catalog descriptioncatalog 简介 / catalog description:DSH 文档阅读模式

Project Overview项目介绍

dsh-101 is a native DSH plugin and ready-to-use profile that provides a document-first reading interface for DSH’s built-in documentation. It is built on top of DSH’s core dsh-base and dsh-web-app layers, and organizes DSH’s scattered raw documentation into an ordered, searchable, translatable reading experience. The recommended installation method is a one-liner curl script that places the profile into your ~/.dsh/profiles directory and installs the plugin bundle automatically, and it can also be installed manually by copying profile files and running the DSH plugin add command. By default it runs on port 3081, which coexists peacefully with the default DSH web GUI running on port 3080.

DSH’s built-in documentation is originally scattered across its source tree with no ordering, navigation, or search, which makes learning DSH much harder than it needs to be. dsh-101 fixes this by curating the documentation into topic-ordered entries with a sliding hidden table of contents for easy navigation, full-text search to find what you need, and built-in translation support to switch between reading languages. It keeps the familiar DSH conversation panel on the right side of the reader, so you can ask DSH questions about any document you are reading without switching interfaces. This tool is designed primarily for new DSH users who want to learn the platform systematically, and it also works well for experienced users.

dsh-101 is released under the permissive BSD-3-Clause open source license, and pre-built artifacts are committed to the repository so end users do not need to build anything locally to use it. If you want to develop the plugin or regenerate the documentation corpus from an updated DSH source tree, you will need Node.js version 20 or newer, and a local checkout of the DSH source code. A critical caveat is that you should never install dsh-101 into the default web profile, as it disables the default UI layout and will break the entire web interface; always use it as a separate standalone profile. The install script explicitly rejects installing to the web profile to prevent this common mistake.

dsh-101 是一个专为 DeepSeek Harness (DSH) 打造的原生文档阅读插件包,同时提供开箱即用的独立配置profile,基于 dsh-base 和 dsh-web-app 构建,核心作用是将DSH原生分散在源码树中的官方文档整理为有序、可搜索、支持多语言翻译的结构化阅读界面。用户可通过官方一键脚本或手动步骤完成安装,它默认运行在3081端口,可与运行在3080端口的DSH官方Web GUI共存。

对于DSH新手和想要系统学习DSH使用方法的开发者来说,dsh-101解决了原生DSH文档零散无序、无法检索、阅读体验差的问题。用户安装完成后启动配置,打开对应本地端口即可访问整理好的文档库,侧边滑动导航可切换不同主题,搜索功能可快速定位目标内容,翻译功能可切换阅读语言,右侧还保留原有的DSH对话面板,阅读文档时可随时提问互动。

该项目采用BSD-3-Clause许可证开源,默认已提交编译好的构建产物,用户无需本地构建即可直接安装使用。开发时需要Node.js 20及以上版本,依赖DSH源码树来重新生成文档语料和重新构建,注意不要将该插件安装到默认的web配置文件中,否则会导致web界面无法正常加载。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 6 stars - very few users, little community feedback星标只有 6,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile dsh-101 add github:bill9109/dsh-101#v0.1.7

把 bill9109/dsh-101 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-101 — A document-first reader profile bundle for DSH

Release v0.1.7 License: BSD-3-Clause Node.js DSH profiles

Install: bash <(curl -fsSL https://raw.githubusercontent.com/bill9109/dsh-101/main/scripts/install.sh) github:bill9109/dsh-101#v0.1.7

DSH 101 is a document-first reading interface built on top of dsh-base + dsh-web-app: it organizes DSH's own documentation into an ordered, searchable, translatable reader.

English | 中文

Why this exists

DSH ships a large body of built-in documentation, but in its raw form it is a file dump: scattered across the source tree, with no order, no search, and no comfortable way to read it. dsh-101 makes that documentation a first-class part of the DSH experience — a curated, ordered, searchable, translatable reader instead of raw files, with the conversation panel alongside so you can ask questions while you read.

Features

  • DSH's built-in documentation, curated and ordered by topic
  • Built-in document translation
  • A sliding hidden table of contents
  • Conversation panel on the right

Usage

Boot the profile (default port 3081, coexists with the web GUI on 3080):

dsh --profile dsh-101

Open http://127.0.0.1:3081 (or the port you chose): the reader shows the curated corpus with the sliding table of contents, search filters the documents, translation switches the reading language, and the right-hand panel is the DSH conversation you already know.

Install

This repository ships both a bundle (@bill9109/dsh-101, installable via dsh plugin add) and a profile/ directory (a ready-to-use dsh-101 profile composing dsh-base + dsh-web-app + this bundle). DSH's official distribution model is "distribute bundles, compose profiles" — there is no official command to distribute a profile, but a profile is just a directory under $DSH_HOME/profiles/<name>/, so the repository's profile/ is directly usable.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-task-control 下一个 Next vncode →