dsh-deeptutor 0.1.0 → 0.1.1

package/README.md

@@ -1,5 +1,7 @@
 # dsh-deeptutor
 
+**English** | [简体中文](README.zh.md)
+
 DeepTutor bridge **bundle** for **DeepSeek Harness (dsh)**, migrated from the
 pi coding-agent extension (`TecFancy/pi-extensions`, `extensions/deeptutor` +
 `skills/deeptutor`).
@@ -13,23 +15,30 @@ Registers three model-facing tools that drive the
 | `deeptutor_kb` | List / search / info the user's personal knowledge bases (RAG) |
 | `deeptutor_note` | Archive Markdown learning notes to a server notebook |
 
+The seven capabilities above are the fixed enum accepted by `deeptutor_run`.
+The underlying DeepTutor CLI may expose more — enumerate the full command set
+with `deeptutor --help` / `deeptutor <cmd> --help`. The `deeptutor` skill
+instructs the agent to discover commands this way and, when the tool's enum
+doesn't cover a capability, to drive the CLI directly (local binary or over
+SSH).
+
 Deployment auto-detects local vs. remote: local `serve` (or local CLI) on this
 machine, or a server reached through an auto-started SSH tunnel (with SSH CLI
 fallback).
 
 ## Install into a profile (bundle)
 
-Publish it (or point `dependencies` at a registry you control), then either:
+The package is published to npm as `dsh-deeptutor`. A bundle install has two
+parts: (1) install the npm package into the profile, and (2) make the loader
+mount it by listing it in the profile's `dsh.profile.bundles`.
 
 ```sh
-# one-shot: install the package into the profile and add it to the bundle list
+# 1. install the npm package into the profile (forwards to pnpm)
 dsh plugin --profile web add dsh-deeptutor
 ```
 
-or add it manually to the profile manifest
-(`~/.dsh/profiles/<name>/package.json`):
-
 ```json
+// 2. add the bundle to the profile manifest (~/.dsh/profiles/<name>/package.json)
 {
   "dependencies": { "dsh-deeptutor": "^0.1.0" },
   "dsh": {
@@ -38,6 +47,26 @@ or add it manually to the profile manifest
 }
 ```
 
+Both steps are required. With dsh CLI 0.1.0-rc.x, `dsh plugin add` is a plain
+pnpm forwarder — it installs the dependency but does **not** touch
+`dsh.profile.bundles`, so skipping step 2 leaves the package installed but
+never loaded. Restart dsh after installing; the bundle list is resolved at
+boot.
+
+Alternatively, keep the manifest untouched and mount the bundle through a user
+patch layer (the npm package still has to be installed first):
+
+```yaml
+# overlay.yml — insert the bundle row via a user patch layer
+- insert:
+    - id: dsh-deeptutor
+      name: 'dsh-deeptutor'
+```
+
+```sh
+dsh web --patch ./overlay.yml
+```
+
 The bundle manifest (`dsh.bundle.patch → cordis.patch.yml`) inserts the plugin
 row; later patch layers can override or disable it by id.
 

package/README.zh.md

@@ -1,5 +1,7 @@
 # dsh-deeptutor
 
+[English](README.md) | **简体中文**
+
 面向 **DeepSeek Harness (dsh)** 的 DeepTutor 桥接 **bundle**,从 pi 编码 agent 扩展迁移而来(`TecFancy/pi-extensions`,`extensions/deeptutor` + `skills/deeptutor`)。
 
 注册三个模型可见工具,驱动 [HKUDS/DeepTutor](https://github.com/HKUDS/DeepTutor) 辅导服务:
@@ -10,20 +12,21 @@
 | `deeptutor_kb` | 列出 / 搜索 / 查看个人知识库(RAG)信息 |
 | `deeptutor_note` | 将 Markdown 学习笔记归档到服务端 notebook |
 
+上表 7 个 capability 是 `deeptutor_run` 工具接受的固定枚举。底层 DeepTutor CLI 可能支持更多命令——用 `deeptutor --help` / `deeptutor <cmd> --help` 可枚举完整命令集。`deeptutor` skill 会指示 agent 用这种方式动态发现命令;当工具的枚举未覆盖某能力时,agent 可直接调用 CLI(本地二进制或经 SSH)来驱动。
+
 部署模式自动适配:本机本地 `serve`(或本地 CLI),或通过自动建立的 SSH 隧道访问服务器(含 SSH CLI 回退)。
 
 ## 安装到 profile(bundle 方式)
 
-发布后(或指向你控制的 registry),任选其一:
+包已发布到 npm(`dsh-deeptutor`)。bundle 安装分两步:(1) 将 npm 包装入 profile;(2) 将其列入 profile 的 `dsh.profile.bundles`,让加载器真正挂载它。
 
 ```sh
-# 一键:将包安装进 profile 并加入 bundle 列表
+# 1. 将 npm 包装入 profile(转发给 pnpm)
 dsh plugin --profile web add dsh-deeptutor
 ```
 
-或手动编辑 profile 清单(`~/.dsh/profiles/<name>/package.json`):
-
 ```json
+// 2. 在 profile 清单(~/.dsh/profiles/<name>/package.json)中加入 bundle
 {
   "dependencies": { "dsh-deeptutor": "^0.1.0" },
   "dsh": {
@@ -32,6 +35,21 @@ dsh plugin --profile web add dsh-deeptutor
 }
 ```
 
+两步缺一不可:在 dsh CLI 0.1.0-rc.x 中,`dsh plugin add` 只是 pnpm 转发器——它只安装依赖,**不会**修改 `dsh.profile.bundles`;跳过第 2 步会导致包已安装却从未被加载。安装后需重启 dsh(bundle 列表在启动时解析)。
+
+也可以不动清单,改用用户 patch 层挂载 bundle(仍需先安装 npm 包):
+
+```yaml
+# overlay.yml —— 通过用户 patch 层插入 bundle 行
+- insert:
+    - id: dsh-deeptutor
+      name: 'dsh-deeptutor'
+```
+
+```sh
+dsh web --patch ./overlay.yml
+```
+
 bundle 清单(`dsh.bundle.patch → cordis.patch.yml`)负责插入插件行;上层 patch 层可按 id 覆盖或禁用。
 
 ## 源码开发(无需发布)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-deeptutor",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "DeepTutor bridge bundle for DeepSeek Harness: learning capabilities, knowledge bases, and note archiving (HTTP/WS first, CLI fallback; auto-adapts local/remote deployment).",
   "keywords": [
     "dsh",
@@ -29,7 +29,8 @@
     "src",
     "scripts",
     "cordis.patch.yml",
-    "README.md"
+    "README.md",
+    "README.zh.md"
   ],
   "dsh": {
     "bundle": {