bill9109/dsh-101
30最近提交 2026年8月14日
dsh-101 DSH 插件
dsh-101 是一个基于 dsh-base 和 dsh-web-app 构建的文档优先阅读界面。它把 DSH 内置文档按主题编排成有序、可搜索、可翻译的阅读器，带有可滑动的隐藏目录和右侧对话面板。作为独立 profile 运行在 3081 端口，与 3080 端口的 Web GUI 共存。
如何安装 dsh-101 DSH 插件
dsh plugin --profile dsh-101 add github:bill9109/dsh-101#v0.1.7复制不会执行命令。安装 dsh-101 DSH 插件前请核对仓库和版本。
dsh-101 DSH 插件数据来源
dsh-101 DSH 插件快照日期：2026年8月16日
discovered
dsh-101 DSH 插件能做什么
- 按主题编排的 DSH 内置文档
- 内置文档翻译功能
- 可滑动的隐藏目录
- 右侧对话面板，可在阅读时提问
- 搜索过滤文档
dsh-101 DSH 插件适合哪些场景
- 以结构化方式阅读和浏览 DSH 官方文档
- 在阅读文档时通过对话面板提问
- 实时翻译文档到其他语言
- 作为独立文档阅读器与主 DSH Web GUI 同时使用
dsh-101 DSH 插件适合谁
- 需要舒适阅读和导航 DSH 文档的 DSH 用户
- 希望获得可搜索、可翻译文档查看器并与 DSH 对话系统集成的开发者
dsh-101 DSH 插件的限制
- 不得安装到 `web` profile，否则会禁用默认浏览器外壳导致 Web GUI 挂起
- 默认端口 3081 可能与其他服务冲突，可通过启动参数或 profile 配置更改
- 安装需要有效的 DSH 环境（dsh-base 和 dsh-web-app）
- Bundle 针对特定 DSH 快照构建，升级 DSH 可能需要通过 `upgrade.mjs` 同步源码
dsh-101 DSH 插件的仓库 README 摘录
以下文字摘自 dsh-101 DSH 插件的上游仓库 bill9109/dsh-101 的 README，版权归原作者，仅作引用。
**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](README.md) | [中文](README.zh.md) ## 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): ```sh 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
阅读完整 README仓库许可: BSD-3-Clause
dsh-101 DSH 插件常见问题
如何安装 dsh-101？
运行一键脚本：`bash <(curl -fsSL https://raw.githubusercontent.com/bill9109/dsh-101/main/scripts/install.sh) github:bill9109/dsh-101#v0.1.7`。该脚本会将 profile 放到 `~/.dsh/profiles/dsh-101/` 并安装 bundle。然后使用 `dsh --profile dsh-101` 启动。你也可以手动安装：复制 profile 文件后运行 `dsh plugin --profile dsh-101 add github:bill9109/dsh-101#v0.1.7`。
如何更改默认端口？
你可以在启动时使用 `--port <port>` 参数：`dsh --profile dsh-101 --port 8080`。如果要持久化更改，编辑 profile 目录下的 `cordis.patch.yml` 文件，在 webserver 配置中设置 `port` 值。启动参数始终优先于配置文件。
如果我把 dsh-101 安装到 web profile 会怎样？
将 dsh-101 安装到 `web` profile 会禁用 `ui-layout`（默认浏览器外壳），导致侧边栏、对话和应用程序外壳都等待布局服务，从而使 Web GUI 挂起。请始终使用 `dsh --profile dsh-101` 作为独立 profile。安装脚本现在会直接拒绝 `--profile web`。
如何卸载 dsh-101？
运行 `dsh plugin --profile dsh-101 remove @bill9109/dsh-101` 移除 bundle。如果不再需要独立 profile，删除 `~/.dsh/profiles/dsh-101/` 目录。第一个命令会执行 `pnpm remove` 并更新 bundle 列表；第二个命令删除 profile 目录。
如何升级 dsh-101 到新版本？
使用新的版本标签重新运行一键脚本，例如 `bash <(curl -fsSL https://raw.githubusercontent.com/bill9109/dsh-101/main/scripts/install.sh) github:bill9109/dsh-101#v0.2.0`。对于本地检出的版本，在更新后的检出目录中重新运行 `./scripts/install.sh .`。这只会补充缺失的层，保留你的 profile 状态。如果 DSH 本身发布了新快照，使用 `node scripts/upgrade.mjs` 同步源码。