中文入门教程 cloudyview/dsh-tutorial

DeepSeek Harness 教程（dsh-tutorial）

一套面向中文用户的 DeepSeek Harness（dsh） 完整教程网站：开篇对比、原理、概念、使用技巧、实战案例、应用场景、最佳实践、插件开发，末尾附 20 道自测题。

🌐 在线站点：（https://cloudyview.github.io/dsh-tutorial/ 会自动重定向过来）

本教程由运行在 DeepSeek Harness 上的智能体撰写——它就是用它自己写的：并行子代理调研（仓库深读 + 竞品调研 + 公开资料）+ 主代理撰写整合。

技术栈

- VitePress（DSH 官方文档站同款）
- GitHub Actions + GitHub Pages 自动部署

本地开发

npm install
npm run docs:dev # 本地预览 http://localhost:5173
npm run docs:build # 构建到 docs/.vitepress/dist
npm run docs:preview # 预览构建产物

访问统计（Umami Cloud）

本站访问统计使用 Umami Cloud（隐私友好、开源、免费额度）。接入步骤：

1. 注册 umami.is → 登录后 Settings → Websites → Add website（Domain 填 daijun.info，Path 填 /dsh-tutorial）。
2. 复制 Tracking 脚本，把其中的 data-website-id 发给我（或在 docs/.vitepress/config.mts 中找到标注 访问统计（Umami Cloud） 的位置，取消注释并替换 ID）。
3. 推送 main 即自动部署生效。
4. 想要随时看数据：在 Umami 里给网站开启 Share URL（公开只读面板），存书签即可，无需每次登录。

SEO 现状

- 每页 description frontmatter + 自动 meta description
- 每页 canonical / og: / twitter:（transformHead 生成）
- WebSite + Article 双 JSON-LD 结构化数据
- robots.txt + sitemap.xml（15 个 URL，位于 docs/public/）
- OG 分享图 og-image.png（1200×630）

⚠️ 目前站点为 HTTP。要启用 HTTPS：把 daijun.info 的 DNS 改为 CNAME 到 cloudyview.github.io（或 A 记录到 GitHub Pages 的 185.199.108.153 等四个 IP），然后在仓库 Settings → Pages → Enforce HTTPS 开启；开启后把 config.mts 顶部 SITE_URL 改为 https://... 再推送一次（sitemap/robots/canonical 会随之更新）。

目录结构

docs/
├── index.md # 首页 ├── quiz.md # 自测题（Vue 组件） ├── 00-开篇…07-插件开发入门.md # 正文章节 ├── 附录A/B/C.md # 附录 ├── 调研底稿/ # 溯源研究笔记 └── .vitepress/ ├── config.mts # 站点配置（导航/侧边栏/搜索） └── components/Quiz.vue # 自测题组件 .github/workflows/deploy.yml # Pages 自动部署

内容更新

改 docs/ 下的 Markdown 后推送 main 分支，GitHub Actions 会自动构建并部署。

许可

MIT License。内容以 deepseek-ai/deepseek-harness 官方仓库为准，DSH 处于 developer preview，功能与配置可能变化。