入门启动模板rita112025-cpu/dsh-starter

DeepSeek Harness 入门模板套件
基于 @deepseek-ai/dsh 0.1.5-rc.1（2026 年 9 月 npm 上的 latest 版本，仍为预发布版）。

完整图文说明网站：https://rita112025-cpu.github.io/dsh-starter/

先决条件
- Node.js 22.19 以上的 22.x 版，或 Node.js 24 以上版本（https://nodejs.org/）
- DeepSeek API 密钥
- 仅从 npm 或官方仓库 https://github.com/deepseek-ai/deepseek-harness 获取 dsh

快速开始
1. 获取模板，以下两种方式择一：
- 下载 dsh-starter.zip，解压缩后进入 dsh-starter 文件夹（Windows「全部解压缩」默认会多一层 dsh-starter\dsh-starter，请进到最里面那一层）
- 使用 Git 克隆仓库：git clone https://github.com/rita112025-cpu/dsh-starter.git，再执行 cd dsh-starter 进入文件夹
2. 第一次执行启动脚本，它会从 .env.example 创建 .env 并提示你填入密钥：
- Windows：鼠标双击 install.bat
- macOS / Linux：执行 bash install.sh
3. 把 .env 里的 sk-xxxxxxxx... 替换成你的真实密钥，然后保存文件
4. 再次执行启动脚本：若尚未安装 dsh，会先进行安装，接着执行 dsh web
5. 浏览器会自动打开；若未自动打开，请复制终端里以 dsh web: 开头那一行的完整网址

默认地址为 127.0.0.1:3080。若 3080 已被占用，dsh 会直接启动失败，不会自动更换端口。请改用 dsh web --port 8080 自行指定，或输入 dsh web --port 0 让系统自动挑选可用端口。
网址内含有一次性认证参数，只输入 127.0.0.1:端口 将无法进入系统。

试用示例技能
在网页界面输入：
使用 doc-summary 技能整理 workspace/note.md 的内容

目录说明
dsh-starter/
├── README.md
├── .env.example                      → 复制为 .env，填入 DEEPSEEK_API_KEY
├── .gitignore                        → 避免 .env 被提交至版本控制
├── install.bat / install.sh          → 环境检查 + 安装 + 启动 dsh web
├── .dsh/skills/doc-summary/SKILL.md  → 示例技能（项目层级技能目录）
└── workspace/note.md                 → 示例文档

常用命令（请务必在本文件夹内执行）
dsh web                                   # 启动网页界面
dsh web --port 8080                       # 指定端口（--port 0 = 由系统自动选用可用端口）
dsh web --no-open                         # 不自动打开浏览器
dsh --profile headless "使用 doc-summary 技能整理 workspace/note.md"   # 一次性执行：输出结果后即结束
dsh --help                                # 启动程序说明
dsh web --help                            # 网页界面参数说明
npx @deepseek-ai/dsh@0.1.5-rc.1 web       # 不安装至全局，直接执行（同样须在本文件夹内执行）

使用须知
- dsh 只会读取执行命令时所在目录的 .env（不会向上层寻找），另外也会读取 ~/.dsh/.env。启动脚本会自动切换到脚本所在的文件夹，建议通过启动脚本或先切换至本文件夹再执行命令。
- 密钥优先级：系统环境变量 → dsh 内已保存的密钥（~/.dsh/.credentials.yaml）→ 本机文件夹 .env → ~/.dsh/.env。若修改 .env 后仍无效，请优先检查前两项；即使环境变量被设成空值，也会优先于 .env 生效。
- 执行命令所在的文件夹即为默认工作目录；在网页界面中，每个对话阶段会使用你在界面中选定的项目文件夹。
- 技能文件会从「项目根目录」下的 .dsh/skills//SKILL.md 读取。项目根目录的认定方式：以最近上层含有 .git 的文件夹为准，若无则以当前所在目录为准。因此，若你将本文件夹放置在某个 Git 仓库的子目录中，请将 .dsh/skills 移至该仓库的最上层根目录。
- 新增或修改技能后无须重新启动系统；SKILL.md 开头的 name（仅限小写英文字母、数字及减号）及 description 为必填字段，whenToUse 则为选填。
- 个人专属技能可放置在 ~/.dsh/skills/；dsh 本身的配置文件位于 ~/.dsh/profiles/web/cordis.patch.yml，入门阶段建议无须调整。
- .env 含有机密信息：请不要提交至版本控制、不要发送给他人。通过生成器创建的压缩包仅包含模板文件，不含 .env 可安全分享；直接分享本文件夹前，请务必先自行检查内容。
- 升级 dsh 版本：执行 npm install -g @deepseek-ai/dsh@，并同步更新两个启动脚本中的 DSH_VERSION 版本号。请注意：版本号仅锁定 dsh 主程序本体，其依赖的 @deepseek-ai/dsh-* 子包采用 ^ 兼容范围，安装时会自动获取当时最新的预发布版（例如安装 rc.1 版主程序时，子包可能会安装到 rc.2 版）。