dsh-advisor-plugin 0.2.4 → 0.2.6

package/README.md

@@ -175,6 +175,49 @@ agent/request ──每 N 步──▶ 快照 ──▶ 审查模型
 
 ## 兼容性
 
+- **目标 DSH**：`0.1.5-rc.1` / `0.1.5-rc.2`；不承诺更早的 rc / alpha 版本。
+- **Node.js**：`^22.19` 或 `>=24`。
+- **安装方式**：请使用 `dsh plugin --profile web add dsh-advisor-plugin`；裸 `npm install` 会撞 DSH 官方包的 peer 依赖，这不是插件本身的问题。
+
+## 两条通道
+
+### 显式咨询
+
+```text
+执行模型 ──advisor()──▶ 上下文组装 ──▶ 审查模型
+   ▲                                      │
+   └──── plan / correction / stop ◀───────┘
+```
+
+适用时机：
+
+- 实质性工作开始前；
+- 反复卡住、方向不收敛时；
+- 证据与建议矛盾时；
+- 宣告完成前。
+
+### 自动巡逻
+
+```text
+agent/request ──每 N 步──▶ 快照 ──▶ 审查模型
+                                      │
+                ON-TRACK / CORRECTION / STOP
+                                      ▼
+                    会话事件卡片 + agent.inject() 注入下一请求
+```
+
+巡逻不会打断在飞 turn，干预最早落在下一个模型请求。
+
+---
+
+## 依赖要求
+
+- Node.js `^22.19` 或 `>=24`
+- DeepSeek Harness（web profile）
+- 已配置至少一个可用的 provider / model 作为审查模型
+
+## 兼容性
+
 - **DSH 版本**：peer 范围覆盖 `0.1.0-rc.6`、`0.1.1-rc.2`、`0.1.2-rc.1`、`0.1.3-alpha.1`；已在 `0.1.1-rc.2` 上实机验证。
 - **配置向后兼容**：旧配置没有 `enabled` 字段时默认 `true`，不影响升级。
 - **关闭总开关**：`enabled: false` 时保留已保存的模型配置，但不注册工具与升级守则。
@@ -215,6 +258,34 @@ npm run build
 - [oh-my-pi advisor/watchdog](https://github.com/can1357/oh-my-pi/blob/main/docs/advisor-watchdog.md)
 - [rpiv-advisor](https://github.com/juicesharp/rpiv-mono/tree/main/packages/rpiv-advisor)
 
+## 常见问题
+
+### DSH Desktop 报 `cannot resolve package "dsh-advisor"`
+
+这是 `0.2.1` 的旧 bundle patch 导致的：那个版本的 `cordis.patch.yml` 仍然引用旧包名 `dsh-advisor`。`0.2.2+` 已经改成 `dsh-advisor-plugin`。
+
+1. 先从对应 profile 移除旧安装（DSH Desktop 通常是 `desktop` profile）：
+   ```bash
+   dsh plugin --profile desktop remove dsh-advisor
+   dsh plugin --profile desktop remove dsh-advisor-plugin
+   ```
+2. 安装最新版本：
+   ```bash
+   dsh plugin --profile desktop add dsh-advisor-plugin@latest --registry=https://registry.npmjs.org
+   ```
+3. 验证 profile 组合结果：
+   ```bash
+   dsh --profile desktop --dump-config | grep -A3 dsh-advisor
+   ```
+   期望看到：
+   ```text
+   # == dsh-advisor-plugin
+   - id: dsh-advisor-plugin
+     name: dsh-advisor-plugin
+   ```
+4. 如果 profile 的 `cordis.patch.yml` 里还残留 `- id: dsh-advisor` / `name: dsh-advisor` 行，删掉那一行再重启。
+
+
 ## License
 
 [MIT](LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-advisor-plugin",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "DeepSeek Harness advisor plugin: pair a fast executor with a stronger reviewer model for plan / correction / stop guidance.",
   "type": "module",
   "license": "MIT",
@@ -63,15 +63,15 @@
     "coding-agent"
   ],
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
-    "@deepseek-ai/dsh-commands": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6 || ^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.3-alpha.1",
-    "@deepseek-ai/schemastery": "^3.18.1"
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-agent": "^0.1.5-rc.1 || ^0.1.5-rc.2",
+    "@deepseek-ai/dsh-commands": "^0.1.5-rc.1 || ^0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1 || ^0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.1 || ^0.1.5-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1 || ^0.1.5-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.5-rc.1 || ^0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.1.5-rc.1 || ^0.1.5-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.2"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",