DeepSeek Harness 新手教程

用大白话讲清楚 DSH 是什么、和网页版 DeepSeek 有什么区别、能帮你干什么，以及插件 / Profile / 工作区这几个绕不开的名词。

从安装 Node.js 到一行命令启动，再到选择工作区——十分钟从零跑起 DSH，附数据目录位置与彻底卸载方法。

API Key 是什么、去哪申请、怎么填进 DSH，以及接入 OpenAI / Anthropic 等其他模型的方法和常见报错速查。

像装 App 一样给 AI 加能力：读懂安装命令的每一段，实战安装最火的 open-design，绕开 GitHub 安装的构建授权坑。

查看已装插件、单个/全部升级、干净卸载、升级 DSH 本体，以及重置 profile 与完全卸载的大扫除指南。

从使用者变成贡献者：一个插件就是一个导出 apply(ctx) 的模块。写最小插件、注册模型可调用的工具、打包成 bundle 发布到 npm 或 GitHub。

新手最常踩的坑集中营：npx 卡住、端口占用、MISSING_CREDENTIAL、插件装完没反应、数据迁移……按类速查。

三种发布渠道怎么选、bundle 自检 6 项、发布前必查与失败模式——把插件送到用户手里的完整路径。

dsh.bundle 与 ~/.dsh/profiles/*.json 双 manifest 各管什么、如何隔离 web/tui/headless 三套工作区、profile 切换的边界。

三种沙箱模式怎么选、审批卡的结构、fail-closed 设计原理、与权限边界的关系——安全策略不是「信任模型」而是「可恢复的失败」。

Browser-only / Host-side / Agent-facing 三类风险源 + 结构化结果 + Cordis 资源清理 + 凭据三不原则，写出用户敢装的插件。

何时用 Python SDK 而不是 TS、Python 包结构、@tool 装饰器、类型 → JSON Schema 映射、asyncio 异步陷阱与 pydantic v2 限制。

为什么 DSH 生态需要 postmortem、5 段式结构（摘要/时间线/根因/处置防御/教训）、blameless 原则、衍生任务沉淀到 issue。

不靠 Star 盲选：用目标、证据、维护度和最小组合四步，挑出真正适合自己的插件，并形成可回滚的安装清单。

系统排查命令找不到、网络失败、构建授权、装错 profile 和装完不生效；先收集证据，再做最小修复，避免把环境越修越乱。

按第 1 天到第 7 天安排模型配置、首个插件、场景组合、备份与复盘；每一步都有完成标准，避免一开始装一堆插件。

用十分钟检查来源、命令、权限、凭据和回滚路径；学会区分“信息不足”和“明确风险”，再决定是否把插件交给本机与 Agent。