drscrewdriver/dsh-docs-deliverables

Name: drscrewdriver/dsh-docs-deliverables
Author: drscrewdriver

Plugin插件 ⭐ 4 Docs & Writing文档与写作

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This repository is a community-curated comprehensive knowledge base for the DeepSeek Harness (DSH) project. It organizes content into four core sections that cover official documentation, community discussions, source code analysis, and plugin development framework guidance. It mirrors the full set of 85 official documentation files across 12 subdirectories, summarizes 6321 public posts from DSH’s GitHub Discussions, and provides in-depth source code analysis for multiple major DSH releases. It also includes additional reference materials like version change matrices, cross-plugin migration guides, and categorized troubleshooting documents broken out by open-source DSH subsystem.

This knowledge base serves different groups of DSH users with varied use cases. Regular end users who encounter errors or unexpected behavior can navigate to the troubleshooting section, where issues are sorted by subsystem to help them find relevant community discussions and solutions quickly. New plugin developers can follow the plugin development framework guides to learn about file structure standards, versioning strategies, compatibility best practices, and submission requirements for the DSH plugin marketplace. Experienced developers who want to understand DSH’s internal architecture can cross-reference the official documentation with the community-produced in-depth source code analysis.

All content in this knowledge base is collected and aggregated by the community for reference only. The maintainers of this repository do not have pull request permissions for the main DSH repository, so any updates or corrections need to be contributed via separate channels. Content is aggregated from multiple open-source contributors and the official DSH repository, and no explicit license is specified for the aggregated content in this repository. It also notes that older keyword-based bug categorization has a 30.3% false positive rate and is kept only for method comparison, so users should rely on the newer LLM-based classification for accurate results.

本仓库是面向 DeepSeek Harness（DSH）的综合文档知识库，整合了官方文档镜像、社区讨论汇总、源码深度解析和插件开发框架四大板块内容。它完整镜像了官方仓库的全部文档，共 85 个文件分布在 12 个子目录中，同时汇总整理了 GitHub Discussions 下 6321 篇社区讨论帖子，还提供了多个 DSH 版本的源码解析内容。

本知识库面向不同需求的 DSH 使用者：普通用户遇到故障时可按子系统查找对应的故障排查文档，对照社区讨论结论解决问题；插件开发者可以参考插件框架的开发规范、迁移指南和投稿要求；想要深入理解 DSH 架构的开发者可以对照官方文档阅读源码解析内容。

本知识库内容为社区收集整理的参考资料，仓库本身没有 DSH 主仓库的 PR 提交权限，所有内容仅作独立参考使用。文档内容聚合了多位社区贡献者的公开产出，包括源码解析文章、开发实战经验、官方文档镜像等，未指定明确的开源许可协议。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-docs-deliverables（drscrewdriver/dsh-docs-deliverables）
仓库：https://github.com/drscrewdriver/dsh-docs-deliverables
本站详情页：https://www.yhbd.top/plugins/drscrewdriver-dsh-docs-deliverables/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证未声明 · ⭐ 4 · 最近提交 2026-10-01 · 主语言 JavaScript · 未检测到 DSH 插件清单

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 3 warnings3 项注意

No license declared - all rights reserved by default; ask the author before commercial use or redistribution未声明开源许可证 —— 默认「保留所有权利」，商用或再分发前先问作者
Only 4 stars - very few users, little community feedback星标只有 4，几乎没人在用，遇到问题缺少社区反馈
No DSH plugin manifest detected - it may only carry the dsh-plugin topic, so the install method must be confirmed on the spot未检测到 DSH 插件清单：可能只是打了 dsh-plugin 话题，安装方式要现场确认

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 web add github:drscrewdriver/dsh-docs-deliverables

把 drscrewdriver/dsh-docs-deliverables 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

12.8 KB · 缓存于 2026-09-17 19:38:16 · 12.8 KB

DeepSeek Harness 文档知识库

本目录是 DSH（DeepSeek Harness）的综合文档知识库，整合官方文档、社区讨论、源码解析、插件框架四大板块。

注意：这些产物是为独立参考目的而收集的。本仓库没有 deepseek-ai/DeepSeek-Harness 的 PR 提交权限。

四大板块

板块	目录	来源	内容
官方文档	`official-repo/`	GitHub 官方仓库	docs/ 完整镜像（85 文件 / 12 子目录）
社区讨论	`dsh-discussion-summary/`	GitHub Discussions 6321 篇	高质量帖子、bug 分析、插件仓库归类、增量批次
源码解析	`source-analysis/`	StudyDocs + 各版本 CHANGELOG	架构总览 + 模块深度解析（v0.1.0-rc.5 首版 / v0.1.5-rc.2 最新）
插件框架	`plugin-framework/`	开发实践文档	文件结构、版本策略、兼容性、投稿指南、插件骨架模板

此外还有：

website-reference-en/ / website-reference-zh/ — 网站 reference 侧边栏导航索引
discussion-issues/ — 按子系统分解的 Discussion 故障排查文档（9 个子系统）
dsh-015-notes.md — DSH 版本变更矩阵（0.1.1→0.1.5），含插件侧模块可用性矩阵（28模块×3版本档 + 8项能力接口变更），源码解析版本规划的导航伴侣
dsh-version-migration-guide.md — 跨插件版本迁移统一指南（7+5插件适配经验 + 决策树 + 专项报告索引 + 生态插件依赖迁移明细 + 类型优化workaround）

本文件是目录结构介绍的唯一权威源。新增/移除目录后必须同步更新：四大板块表、目录结构树、「增量批次记录」表、推荐阅读路径。

目录结构

dsh-docs-deliverables/
├── README.md                           ← 本文件（总导航）
├── dsh-015-notes.md                    ← 版本变更矩阵（0.1.1→0.1.5）+ 插件侧模块可用性矩阵
├── dsh-version-migration-guide.md      ← 跨插件版本迁移统一指南
│
├── official-repo/                      ← 官方仓库 docs/ 完整镜像
│   └── docs/                           ← 85 文件 / 12 子目录
│       ├── architecture.md + .zh.md    ← 架构文档
│       ├── subsystems/                 ← 53 子系统文档（中英对）
│       ├── cordis-api/                 ← 6 个 API 文档
│       ├── cordis-tutorial/            ← Cordis 框架教程 7 篇
│       ├── cookbook/                   ← 开发手册 12 篇
│       ├── postmortem/                 ← 事故复盘 4 篇
│       ├── i18n/                       ← 翻译规则与术语
│       └── user/                       ← 用户指南文档
│
├── dsh-discussion-summary/             ← 社区讨论分析
│   ├── discussion-high-q/              ← 高质量深度帖子
│   ├── discussion-low-q/               ← 自动生成帖子
│   ├── bug-discussion/                 ← Bug 相关讨论
│   ├── type-plugins/                   ← 插件仓库归类（三档）
│   ├── dsh-discussion-comn/            ← 元讨论 / RFC 现状分析
│   ├── meta-chunks/                    ← 分块元数据（chunk-001..011）
│   └── incremental-2026-09-12/         ← 【增量批次】#5886–#6442 分析
│       ├── 增量分析报告.md              ← 14 个新增问题族 + 版本压力 + 高质量帖
│       ├── 插件展示增量.md              ← 67 篇插件展示 + 75 个仓库
│       └── bug讨论增量.md               ← 136 篇 Bug 类讨论
│
├── discussion-issues/                  ← Discussion → 子系统故障排查
│   ├── README.md                       ← 子系统索引 + 关键词趋势（已标注被 LLM 取代）
│   ├── 趋势报告-LLM.md                  ← 【权威】Bug 归类趋势（LLM 语义分类 6321 篇）
│   ├── _tools/                         ← 分类链路脚本（families / llm-classify / canon / 两个报告生成器）
│   ├── session-migration/              ← 【新】会话格式迁移失败 v0→v1→v2→v3
│   ├── session-fork/                   ← 【新】Fork 继承父会话队列
│   ├── llm-streaming/                  ← Developer role 不兼容
│   ├── session-projection/             ← 长会话加载失败
│   ├── web-server/                     ← 远程访问 403
│   ├── filesystem/                     ← Windows 中文路径截断
│   ├── subagent/                       ← 子代理模型继承
│   ├── code-runtime/                   ← Picker 工作器崩溃
│   └── token-meter/                    ← 性能退化
│
├── source-analysis/                    ← 源码深度解析
│   ├── README.md                       ← 版本矩阵索引 + 阅读路径
│   ├── v0.1.0-rc.5/                    ← 首版模块详解（14 篇）
│   │   ├── architecture-overview.md    ← 架构总览
│   │   ├── 01-vendor-cordis.md         ← Cordis 框架层
│   │   ├── 02-core-product.md          ← Core 产品主干
│   │   ├── 03-shell-capabilities.md    ← Shell 能力缝
│   │   ├── 04-llm-typer.md             ← LLM 与 Typer
│   │   ├── 05-execution-world.md       ← 执行世界
│   │   ├── 06-memory.md                ← 记忆系统
│   │   ├── 07-multi-agent.md           ← 多智能体
│   │   ├── 08-human-agent-governance.md← 人机协作与治理
│   │   ├── 09-cli-boot.md              ← CLI 与 Boot
│   │   ├── 10-gui-frontend-backend.md  ← GUI 前后端
│   │   ├── 11-protocol-sdk.md          ← 协议与 SDK
│   │   ├── 12-engineering.md           ← 工程体系
│   │   └── module-template.md          ← 模块详解模板
│   ├── v0.1.5-rc.2/                    ← 【最新】模块详解（13 篇）
│   │   ├── architecture-overview.md    ← 架构总览
│   │   ├── 01-cordis-framework.md      ← Cordis 框架层
│   │   ├── 02..08, 10..12-*.md         ← 各模块详解
│   │   ├── changelog-rc1-rc2.md        ← rc.1 → rc.2 变更
│   │   └── plugin-migration-guide.md   ← 插件侧迁移指引
│   ├── v0.1.5-rc.1/changelog-alpha1-rc1.md  ← alpha.1 → rc.1 变更
│   ├── v0.1.5-alpha.1/CHANGELOG.md
│   ├── v0.1.3-alpha.2/CHANGELOG.md
│   ├── v0.1.2-rc.1/                    ← CHANGELOG + permission-picker-icons.md
│   ├── v0.1.1-rc.2/CHANGELOG.md
│   └── v0.1.0-rc.7/CHANGELOG.md
│
├── plugin-framework/                   ← 插件开发框架
│   ├── README.md                       ← Plugin 开发总览导航
│   ├── file-structure.md               ← 标准插件文件结构
│   ├── distribution-strategy.md        ← 版本分发策略
│   ├── compatibility-guide.md          ← 兼容性指南
│   ├── submission-guide.md             ← awesome-dsh-plugin 投稿步骤
│   ├── v0.1.5-migration.md             ← 0.1.5 插件迁移专项
│   └── dsh-plugin-template/            ← 可直接复制的插件骨架（含 client 半包）
│
├── website-reference-en/               ← 英文网站 reference 索引
│   └── README.md                       ← 65 页面分类导航表
│
└── website-reference-zh/               ← 中文网站 reference 索引
    └── README.md                       ← 65 页面中文分类导航表

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

渲染基于仓库 drscrewdriver/dsh-docs-deliverables 的 README.md。在 GitHub 查看原文 →