dsh-deeptutor 0.1.0 → 0.1.2

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,21 +15,40 @@ 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`. Install it with a single
+command — `dsh plugin add` forwards to pnpm and then reconciles the profile's
+`dsh.profile.bundles` against the installed state, so a `dsh.bundle`-declaring
+package like this one is registered automatically (verified on dsh CLI
+0.1.0-rc.6):
 
 ```sh
-# one-shot: install the package into the profile and add it to the bundle list
 dsh plugin --profile web add dsh-deeptutor
 ```
 
-or add it manually to the profile manifest
-(`~/.dsh/profiles/<name>/package.json`):
+Verify the bundle is mounted, then restart dsh (the bundle list is resolved
+at boot):
+
+```sh
+dsh --profile web --dump-config | grep dsh-deeptutor
+```
+
+If your dsh CLI does not auto-register the bundle (older versions, or you
+installed the dependency manually), add it to the profile manifest
+(`~/.dsh/profiles/<name>/package.json`) and run `dsh plugin --profile web
+install`:
 
 ```json
 {
@@ -38,6 +59,20 @@ or add it manually to the profile manifest
 }
 ```
 
+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,18 +12,25 @@
 | `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`)。一条命令即可安装:`dsh plugin add` 会转发给 pnpm 安装依赖,并把 profile 的 `dsh.profile.bundles` 与已安装状态对账,因此声明了 `dsh.bundle` 的包(如本插件)会被自动登记(已在 dsh CLI 0.1.0-rc.6 上验证):
 
 ```sh
-# 一键:将包安装进 profile 并加入 bundle 列表
 dsh plugin --profile web add dsh-deeptutor
 ```
 
-或手动编辑 profile 清单(`~/.dsh/profiles/<name>/package.json`):
+验证挂载,然后重启 dsh(bundle 列表在启动时解析):
+
+```sh
+dsh --profile web --dump-config | grep dsh-deeptutor
+```
+
+如果你的 dsh CLI 不会自动登记 bundle(旧版本,或手动安装依赖),请在 profile 清单(`~/.dsh/profiles/<name>/package.json`)中手动加入,再运行 `dsh plugin --profile web install`:
 
 ```json
 {
@@ -32,6 +41,19 @@ dsh plugin --profile web add dsh-deeptutor
 }
 ```
 
+也可以不动清单,改用用户 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.2",
   "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": {
@@ -42,11 +43,13 @@
     "prepack": "npm run build && npm run typecheck",
     "pack:check": "npm pack --dry-run"
   },
-  "dependencies": {
+  "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-tools": "^0.1.0-rc.6"
   },
   "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
     "@types/node": "^24.0.0",
     "typescript": "^5.9.3"
   }