tju-llm-dsh 1.0.1 → 1.0.2

package/FAQ.md

@@ -2,6 +2,16 @@
 
 ## 配置写入
 
+### Q: 我完全没用过 dsh，怎么开始？
+
+先装 DeepSeek Harness（官方开源项目）：
+
+1. 装 Node.js ≥ 18（[nodejs.org](https://nodejs.org/) 下载 LTS，Windows 可 `winget install OpenJS.NodeJS.LTS`）；
+2. `npm install -g @deepseek-ai/dsh`；
+3. 终端跑 `dsh web`——首次运行自动初始化 profile 并生成 `~/.dsh/` 目录，按输出地址打开浏览器（一般是 `http://127.0.0.1:3080`）确认能访问。
+
+然后回来照 README「三步接入」走即可。用 DeepSeek 桌面版的话，`desktop` profile 同样被本工具支持。
+
 ### Q: 工具到底改了哪两个文件？
 
 1. `~/.dsh/profiles/<profile>/cordis.patch.yml` — 顶层补丁数组中加入/合并 `llm-pi-ai` 插件条目，provider 名为 `tju`。

package/README.md

@@ -14,10 +14,31 @@
 - **数据不出校**：请求直接发往校内网关，不经过第三方
 - **模型新**：DeepSeek / Qwen 系列最新模型，最高 512K 上下文
 
+## 从零开始：先装 DeepSeek Harness（没用过 dsh？看这里）
+
+dsh 是 DeepSeek 官方的开源 agent 入口（[deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness)）。从未接触过的话，三步装好：
+
+1. **装 Node.js ≥ 18**（还没有的话）：去 [nodejs.org](https://nodejs.org/) 下载 LTS 版安装，Windows 也可以在 PowerShell 里执行 `winget install OpenJS.NodeJS.LTS`。装完在终端跑 `node --version` 能看到版本号即可。
+2. **装 dsh**：
+
+   ```powershell
+   npm install -g @deepseek-ai/dsh
+   ```
+
+3. **跑一次**：
+
+   ```powershell
+   dsh web
+   ```
+
+   首次运行会自动初始化 Web profile 并生成 `~/.dsh/` 配置目录（Windows 即 `%USERPROFILE%\.dsh`）；按终端输出的本地地址打开浏览器即可使用（一般是 `http://127.0.0.1:3080`）。确认页面能打开后 Ctrl+C 停掉，回到下面的接入步骤。
+
+> 用 DeepSeek 桌面版的同学：它使用的 `desktop` profile 本工具同样支持，装好本工具直接配置即可。
+
 ## 前置条件
 
 1. **Node.js ≥ 18**（dsh 用户天然满足）
-2. **已安装并运行过一次 dsh**（`npm i -g @deepseek-ai/dsh`，跑一次让它生成 `~/.dsh/profiles/`）
+2. **已安装并运行过一次 dsh**（没装过？照上一节《从零开始》三步即可）
 3. **天大智算 API Key**（`tk-` 开头）——需要先申请开通服务，见[下一节](#如何获取-api-key)
 
 ## 如何获取 API Key（两步）

package/SKILL.md

@@ -23,9 +23,10 @@ cd <安装目录> && npm install --omit=dev
 # 之后用 node bin/tju-dsh.mjs 代替 tju-dsh
 ```
 
-前置检查：`node --version`（需 ≥ 18）；目录 `~/.dsh/profiles/` 是否存在
-（Windows 为 `%USERPROFILE%\.dsh\profiles`）。不存在就先让用户安装并运行一次
-`dsh`（`npm i -g @deepseek-ai/dsh`），没有 dsh 就没有配置目标。
+前置检查：`node --version`（需 ≥ 18，没有就去 nodejs.org 装 LTS 或 `winget install OpenJS.NodeJS.LTS`）；目录 `~/.dsh/profiles/` 是否存在
+（Windows 为 `%USERPROFILE%\.dsh\profiles`）。不存在就让用户装 dsh 并跑一次：
+`npm install -g @deepseek-ai/dsh` 然后 `dsh web`（首次运行自动生成 `~/.dsh/profiles/`，
+按输出地址打开浏览器确认能访问）。没有 dsh 就没有配置目标。
 
 ## 对话脚本（按顺序，不要跳步）
 

package/bin/tju-dsh.mjs

@@ -193,7 +193,7 @@ async function pickProfile(opts, p) {
     return opts.profile;
   }
   if (profiles.length === 0) {
-    die('没有找到任何 dsh profile。请先安装并运行一次 dsh（它会生成 ~/.dsh/profiles/），再运行本工具。');
+    die('没有找到任何 dsh profile。请先运行一次 dsh web（首次运行会自动生成 ~/.dsh/profiles/），再运行本工具。');
   }
   if (profiles.length === 1) {
     info(`使用唯一的 profile：${profiles[0]}`);
@@ -458,7 +458,7 @@ async function cmdSetup(opts) {
   console.log(c.cyan('\n== tju-dsh：把天津大学智算平台接入 DeepSeek Harness ==\n'));
 
   if (!existsSync(p.dshDir)) {
-    die(`未找到 ${p.dshDir}。请先安装并运行一次 dsh（npm i -g @deepseek-ai/dsh 后执行 dsh），再运行本工具。`);
+    die(`未找到 ${p.dshDir}。若从未用过 dsh：先装 Node.js ≥ 18（nodejs.org），再执行 npm install -g @deepseek-ai/dsh，然后运行一次 dsh web（自动生成配置目录），最后重新运行本工具。`);
   }
 
   const profile = await pickProfile(opts, p);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tju-llm-dsh",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "把天津大学智算平台（ai.tju.edu.cn）接入 DeepSeek Harness（dsh）——社区工具，非官方",
   "type": "module",
   "bin": {