@mingozhou/dsh-replay 0.3.3 → 0.4.1

package/README.md

@@ -56,54 +56,38 @@ Dark mode follows the harness theme. Loading and empty states are hosted by **Ji
 
 ## 🚀 Quick start
 
-### Try it first (zero install)
+### 1️⃣ Try it first — zero install
 
-**Online demo:** https://mingozhou.github.io/dsh-replay/ — or locally:
+**Online demo:** https://mingozhou.github.io/dsh-replay/ — three sample sessions, full UI, zero install.
 
-```sh
-git clone https://github.com/MingoZhou/dsh-replay.git
-cd dsh-replay
-npm install && npm run build
-npm run demo        # → http://localhost:4173
-```
+### 2️⃣ Install into DeepSeek Harness — one npm command
 
-### Install into DeepSeek Harness
-
-**Case A — you use the released CLI** (`npm i -g @deepseek-ai/dsh`):
+The npm package ships **prebuilt**: no cloning, no building, no `allowBuilds` approval.
 
 ```sh
-# build the plugin once
-cd <path-to>/dsh-replay && npm install && npm run build
+# released CLI (npm i -g @deepseek-ai/dsh); list your profiles with: ls ~/.dsh/profiles
+dsh plugin --profile <your-profile> add @mingozhou/dsh-replay
 
-# add it to the profile you actually use (list them: ls ~/.dsh/profiles)
-dsh plugin --profile <your-profile> add <absolute-path-to>/dsh-replay
-dsh --profile <your-profile> --dump-config     # expect a "# == dsh-replay" section
-dsh web --profile <your-profile>
+# harness running from a source checkout (`pnpm dsh web` uses the profile named "web"):
+#   run inside the harness repo directory
+pnpm dsh plugin --profile web add @mingozhou/dsh-replay
 ```
 
-**Case B — you run the harness from a source checkout** (`pnpm dsh web`):
-
-```sh
-# build the plugin once
-cd <path-to>/dsh-replay && npm install && npm run build
-
-# note: `pnpm dsh web` boots the profile named "web"
-cd <path-to>/deepseek-harness
-pnpm dsh plugin --profile web add <absolute-path-to>/dsh-replay
-pnpm dsh --profile web --dump-config           # expect a "# == dsh-replay" section
-pnpm dsh web
-```
-
-Open http://127.0.0.1:3080 — you now have **two entries**:
+Verify with `dsh --profile <your-profile> --dump-config` (expect a `# == @mingozhou/dsh-replay` section), then restart the harness (`dsh web --profile <your-profile>` / `pnpm dsh web`) and open http://127.0.0.1:3080. You now have **two entries**:
 
 1. the **Session Replay** button at the bottom-left of the sidebar (opens a full-screen modal with a session picker), and
+
 2. a **Replay** tab inside every open conversation.
 
-Installing from npm (`dsh plugin --profile <p> add dsh-replay`, once published) or from a git URL also works; git installs run the package's `prepare` build, which the harness requires you to allowlist in the profile's `pnpm-workspace.yaml`:
+### 3️⃣ Install from a cloned repo (development / unreleased changes)
+```sh
+git clone https://github.com/MingoZhou/dsh-replay.git
+cd dsh-replay
+npm install && npm run build      # lib/ is a build artifact — required after every fresh clone
+npm run demo                      # local demo → http://localhost:4173
 
-```yaml
-allowBuilds:
-  dsh-replay: true
+# then point your profile at the folder instead of npm:
+dsh plugin --profile <your-profile> add <absolute-path-to>/dsh-replay
 ```
 
 ## 🧹 Uninstall

package/README.zh.md

@@ -54,58 +54,48 @@ DeepSeek Harness 有一套优雅的 append-only 日志,官方承诺"到达模型
 
 深色模式跟随 Harness 主题。加载与空状态由原创鲸猫娘吉祥物 **鲸小深** 值班(不喜欢可一行 CSS 隐藏:`.dshr-mascot { display: none }`)。
 
-## 🚀 快速上手
-
-### 先试试(零安装)
-
-**在线 Demo:** https://mingozhou.github.io/dsh-replay/ ,或本地跑:
-
-```sh
-git clone https://github.com/MingoZhou/dsh-replay.git
-cd dsh-replay
-npm install && npm run build
-npm run demo        # → http://localhost:4173
-```
 
-### 装进 DeepSeek Harness
+## 🚀 快速上手
 
-**情况 A —— 你用的是发行版 CLI**(`npm i -g @deepseek-ai/dsh`):
+### 1️⃣ 先试试(零安装)
 
-```sh
-# 先构建插件(一次即可)
-cd <插件路径>/dsh-replay && npm install && npm run build
+**在线 Demo:** https://mingozhou.github.io/dsh-replay/ —— 三个示例会话、完整 UI、零安装。
 
-# 加进你实际在用的 profile(列出所有 profile:ls ~/.dsh/profiles)
-dsh plugin --profile <你的profile> add <插件绝对路径>/dsh-replay
-dsh --profile <你的profile> --dump-config     # 应出现 "# == dsh-replay" 一段
-dsh web --profile <你的profile>
-```
+### 2️⃣ 装进 DeepSeek Harness —— npm 一条命令
 
-**情况 B —— 你从源码仓库跑 Harness**(`pnpm dsh web`):
+npm 包是**预构建成品**:不用 clone、不用 build、不用 `allowBuilds` 放行。
 
 ```sh
-# 先构建插件(一次即可)
-cd <插件路径>/dsh-replay && npm install && npm run build
-
-# 注意:`pnpm dsh web` 实际挂载的是名为 "web" 的 profile
-cd <Harness源码路径>/deepseek-harness
-pnpm dsh plugin --profile web add <插件绝对路径>/dsh-replay
-pnpm dsh --profile web --dump-config          # 应出现 "# == dsh-replay" 一段
+# 发行版 CLI(npm i -g @deepseek-ai/dsh);查看已有 profile:ls ~/.dsh/profiles
+dsh plugin --profile <你的profile> add @mingozhou/dsh-replay
+
+# 从源码仓库跑的 Harness(`pnpm dsh web` 挂载的 profile 名是 "web"):
+#   在 harness 仓库目录里执行
+cd 'path_to_your_project/deepseel-harness'
+pnpm dsh plugin --profile web add @mingozhou/dsh-replay
+# 然后重启就可以使用了
 pnpm dsh web
 ```
 
-打开 http://127.0.0.1:3080 ,你会得到**两个入口**:
+用 `dsh --profile <你的profile> --dump-config` 验证(应出现 `# == @mingozhou/dsh-replay` 一段),然后重启 Harness(`dsh web --profile <你的profile>` / `pnpm dsh web`),打开 http://127.0.0.1:3080 。你会得到**两个入口**:
 
 1. 侧栏左下角的 **会话回放** 按钮(弹出带会话选择器的全屏弹窗);
+
 2. 每个会话视图里的 **Replay** 标签页。
 
-从 npm(发布后 `dsh plugin --profile <p> add dsh-replay`)或 git URL 安装也可以;git 安装会执行包的 `prepare` 构建,Harness 要求在 profile 的 `pnpm-workspace.yaml` 里显式放行:
+### 3️⃣ 克隆仓库安装(开发调试 / 试未发布的改动)
+
+```sh
+git clone https://github.com/MingoZhou/dsh-replay.git
+cd dsh-replay
+npm install && npm run build      # lib/ 是构建产物,每次重新 clone 后都要构建
+npm run demo                      # 本地 demo → http://localhost:4173
 
-```yaml
-allowBuilds:
-  dsh-replay: true
+# 然后让 profile 指向文件夹而不是 npm:
+dsh plugin --profile <你的profile> add <插件绝对路径>/dsh-replay
 ```
 
+
 ## 🧹 卸载
 
 官方姿势(**即使 Harness 启动不了也能用**,因为它只是在 profile 目录里跑 pnpm):

package/lib/client.js

@@ -2469,7 +2469,7 @@ function apply(ctx) {
     return module.exports;
   };
   if (typeof window !== 'undefined' && window.__ModuleLoader__) {
-    window.__ModuleLoader__.load({ id: 'dsh-replay', factory: factory });
+    window.__ModuleLoader__.load({ id: '@mingozhou/dsh-replay', factory: factory });
   } else if (typeof module !== 'undefined' && module.exports) {
     module.exports = factory(typeof require === 'function' ? require : function (id) {
       throw new Error('unresolvable external: ' + id);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mingozhou/dsh-replay",
-  "version": "0.3.3",
+  "version": "0.4.1",
   "description": "Session replay, fork-tree, audit & compare visualization for DeepSeek Harness — time machine for your agent sessions",
   "main": "lib/index.js",
   "directories": {

package/scripts/build.mjs

@@ -91,7 +91,7 @@ ${cjs}
     return module.exports;
   };
   if (typeof window !== 'undefined' && window.__ModuleLoader__) {
-    window.__ModuleLoader__.load({ id: 'dsh-replay', factory: factory });
+    window.__ModuleLoader__.load({ id: '@mingozhou/dsh-replay', factory: factory });
   } else if (typeof module !== 'undefined' && module.exports) {
     module.exports = factory(typeof require === 'function' ? require : function (id) {
       throw new Error('unresolvable external: ' + id);