About · Usage · Maintenance
说明
这一页写清四件事:本站基于什么假设、怎么打开与维护、设计令牌怎么改、哪些内容必须自行核实。
01打开方式
本站是纯静态页面,不需要安装、服务器或联网。保持 index.html 与 assets/ 在 deepseek-harness/ 目录内同级,双击 index.html 即可。阅读手册可离线进行;安装软件、访问模型端点和打开外部文档需要联网。
首页会返回上次未完成的小节;该节完成后,推荐按阅读顺序排在最前的未完成小节。阅读位置与完成进度保存在当前浏览器;若存储失败,页面会持续提示「本次进度未保存」。不同浏览器、不同访问地址或直接打开文件时,记录可能不互通。
如果样式丢失,通常是把 HTML 单独移动了位置;页面引用的是 assets/style.css 相对路径。
02假设声明
| 输入项 | 采用的假设 | 影响 |
|---|---|---|
| 蓝本 | runoob DeepSeek Harness 教程的 34 个条目 | 不增删主题;章节顺序按学习路径重排,原文分组保留在「全部章节」 |
| 学习者 | 有编程经验、无 dsh 实战经验 | 不教 TypeScript 语法;插件 API 从最小示例讲起 |
| 规模与时长 | 33 节、6 章、约 15 小时 | 每节 20–50 分钟;动手任务控制在可一次完成的范围 |
| 运行环境 | 本地现代浏览器,离线优先 | 零外部字体/CDN;搜索索引本地加载 |
| 视觉 | 编辑式手册:纸白、墨色、黄铜;衬线标题 + 无衬线正文 | 首页导读与目录分栏,四条路线并列;正文以留白、细线组织层级 |
| 时效 | 审计时间 2026-10,产品处于 0.2.x 预览版 | 版本、模型名、benchmark 标「待核实」;以官方为准 |
03设计说明
| 令牌 | 值 | 用途 | 对比度 |
|---|---|---|---|
--ink | #14202B | 正文、标题 | 15.8:1(on #FBFAF6) |
--muted | #5D6A76 | 次要文字 | 5.3:1 |
--brass-deep | #6F5522 | 标签、强调文字 | 6.7:1 |
--teal | #0F5A5A | 链接、完成态 | 7.6:1 |
--navy | #0C1722 | 封面 | 白字 18.1:1 |
--rule | #D8DDE1 | 发丝线 | 非文字元素 |
版式与动效
- 标题用衬线(宋体 / Noto Serif SC),正文用无衬线;正文 16.5px / 行高 1.8。
- 无阴影、2px 圆角、1px 发丝线;层级靠字号、留白与黄铜细线,而不是颜色堆叠。
- 动效只有 160ms 的颜色/下划线变化;
prefers-reduced-motion下关闭。 - 首页在窄屏按导读、目录、路线依次排列;章节页提供折叠目录,表格在自身区域横向滚动。
04来源、许可与维护
- 蓝本:runoob · DeepSeek Harness 教程,版权归原站点/原作者。本站不复制原文全文,只做导读、任务与审计,每节保留原文链接。
- 许可:代码 MIT;本站原创文字(学习路径、要点、任务、审计、说明)采用 CC BY-NC-SA 4.0。详见 LICENSE 与 LICENSE-CONTENT.md;原文与第三方内容不在本站授权范围。
- 生成:页面与搜索索引由
tools/build.py生成;修改课程数据后重新运行即可。 - 维护:新增一节需要补五字段、更新
STAGE_LESSONS与前后篇;搜索索引会随构建自动重建。
05必须自行核实的清单
| 内容 | 核实什么 | 去哪查 |
|---|---|---|
| Node / Python 版本 | Node 24.9+ 是否仍是硬性要求;Python SDK 支持矩阵 | 官方安装页、npm/PyPI 元数据 |
| 模型与计费 | 视觉模型名、单图 token 上限、benchmark 数字 | DeepSeek 模型页与 API 文档 |
| 插件 API | defineTool、ctx.effect、ctx.llm 的当前签名 | 仓库类型定义与官方文档 |
| 沙箱与审批 | enforcement 平台差异、审批结果语义 | 官方安全文档 |
| 发布时间 | 「2026 年 8 月开源」等时间线 | 官方公告 / GitHub Releases |