dsh-whalewing 0.2.1-rc.5.2 → 0.2.1-rc.5.4

package/COMPATIBILITY.md

@@ -21,7 +21,7 @@ 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 后旧版鲸翼显示“异常”时，先在「插件」页卸载，再按[安装](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/NOTICE

@@ -28,7 +28,7 @@ CC BY-NC-SA 4.0 单独授权，不适用 Apache License 2.0；商用须先取得
 ----------
 随插件分发的第三方代码、数据和内容保留各自的许可：
 
-- 工具台内联的第三方代码（其中 MP3 编码库为 LGPL-3.0）：
+- 办公工坊内联的第三方代码：
   content/utilities/THIRD_PARTY_NOTICES.txt
 - 中文字体 Noto Sans SC（SIL Open Font License 1.1）：
   content/utilities/NotoSansSC-LICENSE.txt

package/README.md

@@ -26,7 +26,7 @@ DSH 超级个体工作台：选专家直接干活，经验沉淀到个人知识
 | 小鲸助手 | 停靠在页面右侧或悬浮，随时对话；事情该交给专家时，小鲸为那位专家新建任务并把交接说明放进输入框，你看过再发；也能帮你管理鲸翼的功能和扩展 |
 | 个人知识 | 你自己的第二大脑，存在本机 Markdown 知识库里：首次使用自动建好目录、规则、笔记模板、关于我等三篇关于自己的笔记和 Obsidian 视图；支持阅读编辑、关系图谱和文风检查，笔记可引用到对话 |
 | 技能成长 | 管理系统技能与个人技能，可按来源筛选和查找；和小鲸一起从知识里提炼新技能，来源笔记变了会标“待复核”，技能照常可用 |
-| 定时任务 | 每日记忆（每天把对话写成日记和任务记录）、每周思考（每周写周记和“待你决定”）、每日资讯和自建任务，到点自动执行 |
+| 定时任务 | 每日记忆（每天把对话写成日记和任务记录）、每周思考（每周写周记和“待你决定”）这两个默认打开，还有每日资讯和自建任务，到点自动执行；运行用你在 DSH 配的模型 |
 | AI 网页 | 在 DSH 内置浏览器里打开 DeepSeek、豆包、Kimi、ChatGPT 等官方网页，按国内、海外分组，可自行添加；回到鲸翼时标出正在用的那个 |
 | 办公工坊 | 44 项本地文件处理：格式转换、PDF、表格、图片（含打码、去水印）、文字、音视频、二维码，文件可以直接拖进来，不上传 |
 | 知识卡片 | 本地书架（EPUB、TXT、PDF、MOBI、AZW3、DOCX 等），首页接着读最多两本常看书；每日 AI 使用技巧（可按年月日翻看历史）和每天 08:00 的资讯简报 |
@@ -38,22 +38,24 @@ AI 网页、办公工坊、知识卡片、模型世界是可选功能，默认
 
 ## 安装
 
-当前版本 0.2.1-rc.5.2（预发布，还在打磨，适配 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.1-rc.5.4（预发布，还在打磨，适配 DSH `0.2.1-rc.5`）。版本号去掉最后一段就是适配的 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.2
+dsh-whalewing@0.2.1-rc.5.4
 ```
 
 DSH 从 npm 下载安装，不用连 GitHub；官方源连不上会自动换国内镜像，也可以在安装窗口里选“中国大陆镜像源”。安装窗口右侧的「安装源」如果显示的是公司或学校的内网源，DSH 只问这一个源、不会自动换；内网源没有同步鲸翼时会报“无法连接插件源”，把「安装源」改成“中国大陆镜像源”或“npm 官方源”再装。`@` 后面的版本号要带上：只填 `dsh-whalewing` 时，新版本发布满一天才会被选中。
 
 装不上时有两个备用办法，装上的插件完全一样：
 
-- **安装包**：从 [Releases](https://github.com/gwen-liu/whalewing/releases) 下载 `dsh-whalewing-0.2.1-rc.5.2.tgz`，在「添加插件」里填这个文件在本机的绝对路径。
-- **GitHub 地址**：填 `github:gwen-liu/whalewing#v0.2.1-rc.5.2`，`#` 后面是版本标签，换成别的标签或提交即可装对应版本；不带 `#` 会装开发主线上的最新代码，不保证稳定。这种方式要先连上 GitHub、再下载整个源码包，DSH 连 GitHub 超过 5 秒就判失败，国内网络下常常装不上。
+- **安装包**：从 [Releases](https://github.com/gwen-liu/whalewing/releases) 下载 `dsh-whalewing-0.2.1-rc.5.4.tgz`，在「添加插件」里填这个文件在本机的绝对路径。
+- **GitHub 地址**：填 `github:gwen-liu/whalewing#v0.2.1-rc.5.4`，`#` 后面是版本标签，换成别的标签或提交即可装对应版本；不带 `#` 会装开发主线上的最新代码，不保证稳定。这种方式要先连上 GitHub、再下载整个源码包，DSH 连 GitHub 超过 5 秒就判失败，国内网络下常常装不上。
 
-`0.2.1-rc.5.2` 需要 DSH `0.2.1-rc.5`；DSH 还是 `0.2.1-rc.3` 的，用 `0.2.1-rc.3.3`（填 `dsh-whalewing@0.2.1-rc.3.3`）；还是 `0.2.1-rc.2` 的，用 `0.2.1-rc.2.2`（标签 `v0.2.1-rc.2.2`，只有安装包和 GitHub 地址两种装法）。DSH 只认插件声明的版本，升级 DSH 后旧版鲸翼不会加载，在「插件」页显示为 `dsh-whalewing`、标着“异常”。已经装了鲸翼的，要先在「插件」页卸载旧版，再装新版。原版 DSH 即可使用，与定制版的个别体验差异和从旧版升级的方法见[兼容与升级](COMPATIBILITY.md)。
+`0.2.1-rc.5.4` 需要 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.1-rc.5.4` 起，在 DSH「插件」→ 鲸翼的详情页（或鲸翼页头的“…”）点“检查更新”：已是最新就什么都不改；有新版本会弹出确认，点“更新”原地装好，不用卸载，数据和设置都在，重启 DSH 后生效。更早的版本可以在「添加插件」里填新版本的安装包地址（如 `https://registry.npmmirror.com/dsh-whalewing/-/dsh-whalewing-0.2.1-rc.5.4.tgz`）原地更新；只填包名会被 DSH 拦下、要求先卸载。
 
 ## 扩展