dsh-whalewing 0.2.1-rc.5.3 → 0.2.2-rc.1.1

package/COMPATIBILITY.md

@@ -1,6 +1,6 @@
 # 兼容与升级
 
-鲸翼支持的 DSH 版本以 [package.json](package.json) 的 `engines.dsh` 为准，当前是 `0.2.1-rc.5`。旧客户端请继续用最后兼容的固定版本，不要强行安装新版：DSH `0.2.1-rc.3` 用 `0.2.1-rc.3.3`，DSH `0.2.1-rc.2` 用 `0.2.1-rc.2.2`。DSH 只认插件声明的版本，升级 DSH 后旧版鲸翼不会加载，要换装适配新 DSH 的鲸翼。
+鲸翼支持的 DSH 版本以 [package.json](package.json) 的 `engines.dsh` 为准，当前是 `0.2.2-rc.1`。旧客户端请继续用最后兼容的固定版本，不要强行安装新版：DSH `0.2.1-rc.5` 用 `0.2.1-rc.5.4`，DSH `0.2.1-rc.3` 用 `0.2.1-rc.3.3`，DSH `0.2.1-rc.2` 用 `0.2.1-rc.2.2`。DSH 只认插件声明的版本，升级 DSH 后旧版鲸翼不会加载，要换装适配新 DSH 的鲸翼。
 
 ## 定时任务
 
@@ -17,11 +17,10 @@ DSH 已内置定时服务，鲸翼的定时任务和每日资讯直接使用它
 | 专家绑定 MCP | 不能单独绑定，专家使用 DSH 里启用的全部 MCP |
 | AI 网页 | 在名为「AI 网页」的会话右侧内置浏览器里打开，不铺满工作台；回到 AI 网页页签时同样标“正在用”，“继续使用”回到那个会话里的网页。这个会话不发消息，DSH 侧栏把没发过消息的会话一律显示为“新会话”，切走后也不在侧栏列出 |
 | 小鲸助手 | 照常对话，引用资料不在侧栏预览 |
-| 定时任务 | 不能暂停或恢复（可以取消后重建） |
 
 ## 升级说明
 
-已经装了鲸翼的，升级时先在 DSH「插件」页卸载旧版鲸翼，再按[安装](README.md#安装)装新版。不卸载直接安装新版会失败，DSH 对其他插件也是这样要求的。
+已经装了鲸翼的：`0.2.1-rc.5.4` 起在 DSH「插件」→ 鲸翼详情页点“检查更新”原地更新；更早的版本在「添加插件」里填新版本的安装包地址（`https://registry.npmmirror.com/dsh-whalewing/-/dsh-whalewing-<版本>.tgz`），同样是原地更新、不用卸载，装好后重启 DSH。只填包名（`dsh-whalewing@<版本>`）会被 DSH 拦下、要求先卸载，DSH 对其他插件也是这样。升级 DSH 后旧版鲸翼显示“异常”、它的检查更新用不了时，同样在「添加插件」里填适配新 DSH 的鲸翼安装包地址，原地换新版，不用卸载；也可以先在「插件」页卸载，再按[安装](README.md#安装)装新版。
 
 旧版的 `whalewing-tools`、`whalewing-experts` 两个插件行已经合并进鲸翼，profile 里针对它们的设置不再生效，四项可选功能默认开启。
 

package/EXTENDING.md

@@ -121,6 +121,29 @@ const dispose = ctx.whalewing.knowledge.registerSource(ctx, {
 | `EXTENSION_SOURCE_INPUT` | 登记参数、专家列表、搜索或阅读结果不符合上面的字段要求 |
 | `FEATURE_CLOSED` | 来源撤销后还调 `set` |
 
+## Host：助手名称
+
+扩展可以给小鲸助手起自己的叫法，比如企业版让管理员在管理端统一改名。和来源一样，要在 `features.register` 之后用同一个 `ctx`（或其子插件）调用：
+
+```js
+const name = ctx.whalewing.assistant.registerName(ctx, '小司助手');
+name.set('小航助手'); // 名字变了再调；和现在一样时不推送
+name.dispose();      // 可选：提前撤销；扩展关闭、卸载或鲸翼总开关关闭时自动撤销
+```
+
+- **名字**：字符串，去掉首尾空白后 1–16 个字，一行，不带换行和控制字符。名字不分语言，也没有简称：原来写“小鲸”的地方也用这个全名。
+- **同一时间只认一个扩展**：别的扩展已经起了名，再登记报 `ASSISTANT_NAME_CONFLICT`（错误信息里写着是谁起的）；同一个扩展重复登记也报这个错，改名用 `set`。撤销后恢复“小鲸助手”，别的扩展才能再起名。
+- **员工看到的**：界面上写着小鲸的地方（助手气泡和面板、技能页按钮、专家团队里小鲸的卡片、新会话页的专家选择、交接说明开头）都换成这个名字；编辑小鲸时名字框只读，写明由哪个扩展设定（有来源名用来源名，没有用包名）。员工自己改过的名字不丢，扩展撤销后回来。DSH「插件」页里鲸翼的介绍是安装包里的固定文字，不跟着换。
+- **模型看到的**：每轮专家说明里写明现在的叫法；随包说明和技能文件里的“小鲸助手”“小鲸”照旧，由这句说明告诉模型指的是谁。专家列表、`whalewing_experts` 工具读到的小鲸也叫这个名字。
+- **不影响功能**：鲸翼按小鲸的内部标识 `manager` 判断身份，不认名字。
+
+| 错误码 | 什么时候 |
+| --- | --- |
+| `FEATURE_CALLER` | 还没用这个 `ctx` 登记功能就起名 |
+| `ASSISTANT_NAME_CONFLICT` | 已经有扩展（包括自己）起了名 |
+| `ASSISTANT_NAME_INPUT` | 名字为空、超过 16 个字、带换行或控制字符、不是字符串 |
+| `FEATURE_CLOSED` | 撤销后还调 `set` |
+
 ## 浏览器：登记页签
 
 客户端通过 DSH 模块工厂加载，React 从工厂的 `require('react')` 取得，构建时标为 external，不打入另一份 React。模板已给出完整构建入口。

package/README.md

@@ -38,22 +38,24 @@ AI 网页、办公工坊、知识卡片、模型世界是可选功能，默认
 
 ## 安装
 
-当前版本 0.2.1-rc.5.3（预发布，还在打磨，适配 DSH `0.2.1-rc.5`）。版本号去掉最后一段就是适配的 DSH 版本，最后一段是鲸翼自己的更新序号：`0.2.1-rc.5.1` 就是适配 DSH `0.2.1-rc.5` 的第 1 版；换 DSH 版本时从 1 重新数，所以最后一段是 1 的版本，都是适配官方最新 DSH 的那一版。
+当前版本 0.2.2-rc.1.1（预发布，还在打磨，适配 DSH `0.2.2-rc.1`）。版本号去掉最后一段就是适配的 DSH 版本，最后一段是鲸翼自己的更新序号：`0.2.1-rc.5.1` 就是适配 DSH `0.2.1-rc.5` 的第 1 版；换 DSH 版本时从 1 重新数，所以最后一段是 1 的版本，都是适配官方最新 DSH 的那一版。
 
 在 DSH 里打开「插件 → 添加插件」，填：
 
 ```text
-dsh-whalewing@0.2.1-rc.5.3
+dsh-whalewing@0.2.2-rc.1.1
 ```
 
 DSH 从 npm 下载安装，不用连 GitHub；官方源连不上会自动换国内镜像，也可以在安装窗口里选“中国大陆镜像源”。安装窗口右侧的「安装源」如果显示的是公司或学校的内网源，DSH 只问这一个源、不会自动换；内网源没有同步鲸翼时会报“无法连接插件源”，把「安装源」改成“中国大陆镜像源”或“npm 官方源”再装。`@` 后面的版本号要带上：只填 `dsh-whalewing` 时，新版本发布满一天才会被选中。
 
 装不上时有两个备用办法，装上的插件完全一样：
 
-- **安装包**：从 [Releases](https://github.com/gwen-liu/whalewing/releases) 下载 `dsh-whalewing-0.2.1-rc.5.3.tgz`，在「添加插件」里填这个文件在本机的绝对路径。
-- **GitHub 地址**：填 `github:gwen-liu/whalewing#v0.2.1-rc.5.3`，`#` 后面是版本标签，换成别的标签或提交即可装对应版本；不带 `#` 会装开发主线上的最新代码，不保证稳定。这种方式要先连上 GitHub、再下载整个源码包，DSH 连 GitHub 超过 5 秒就判失败，国内网络下常常装不上。
+- **安装包**：从 [Releases](https://github.com/gwen-liu/whalewing/releases) 下载 `dsh-whalewing-0.2.2-rc.1.1.tgz`，在「添加插件」里填这个文件在本机的绝对路径。
+- **GitHub 地址**：填 `github:gwen-liu/whalewing#v0.2.2-rc.1.1`，`#` 后面是版本标签，换成别的标签或提交即可装对应版本；不带 `#` 会装开发主线上的最新代码，不保证稳定。这种方式要先连上 GitHub、再下载整个源码包，DSH 连 GitHub 超过 5 秒就判失败，国内网络下常常装不上。
 
-`0.2.1-rc.5.3` 需要 DSH `0.2.1-rc.5`；用别的 DSH 版本的，到 [Releases](https://github.com/gwen-liu/whalewing/releases) 选版本号以那个 DSH 版本开头的最新一版（`0.2.1-rc.3.2` 之前的版本没有发到 npm，用安装包或 GitHub 地址安装）。DSH 只认插件声明的版本，升级 DSH 后旧版鲸翼不会加载，在「插件」页显示为 `dsh-whalewing`、标着“异常”。已经装了鲸翼的，要先在「插件」页卸载旧版，再装新版。原版 DSH 即可使用，与定制版的个别体验差异和从旧版升级的方法见[兼容与升级](COMPATIBILITY.md)。
+`0.2.2-rc.1.1` 需要 DSH `0.2.2-rc.1`；用别的 DSH 版本的，到 [Releases](https://github.com/gwen-liu/whalewing/releases) 选版本号以那个 DSH 版本开头的最新一版（`0.2.1-rc.3.2` 之前的版本没有发到 npm，用安装包或 GitHub 地址安装）。DSH 只认插件声明的版本，升级 DSH 后旧版鲸翼不会加载，在「插件」页显示为 `dsh-whalewing`、标着“异常”，旧版的检查更新也用不了。已经装了鲸翼的，在「添加插件」里填新版本的安装包地址（如 `https://registry.npmmirror.com/dsh-whalewing/-/dsh-whalewing-0.2.2-rc.1.1.tgz`）原地换新版，不用卸载，数据和设置都在，重启 DSH 后生效。原版 DSH 即可使用，与定制版的个别体验差异和从旧版升级的方法见[兼容与升级](COMPATIBILITY.md)。
+
+**更新**：`0.2.1-rc.5.4` 起，在 DSH「插件」→ 鲸翼的详情页（或鲸翼页头的“…”）点“检查更新”：已是最新就什么都不改；有新版本会弹出确认，点“更新”原地装好，不用卸载，数据和设置都在，重启 DSH 后生效。DSH 0.2.2 起，按包名装的鲸翼在详情页上方还有 DSH 自己的「版本」区块，它只把正式版当作可更新，鲸翼的版本都算预发布，不会提示鲸翼有新版本，请用鲸翼的“检查更新”。更早的版本可以在「添加插件」里填新版本的安装包地址（如 `https://registry.npmmirror.com/dsh-whalewing/-/dsh-whalewing-0.2.2-rc.1.1.tgz`）原地更新；只填包名会被 DSH 拦下、要求先卸载。
 
 ## 扩展