dingtalk-dsh-assistant 0.5.3 → 0.5.4

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 本文件记录 `dingtalk-dsh-assistant` 每个正式版本的用户可见变化。版本号遵循[语义化版本](https://semver.org/lang/zh-CN/)，日期使用 `YYYY-MM-DD`。
 
+## [0.5.4] - 2026-08-28
+
+### 修复
+
+- 修复 Windows CRLF 源文件导致 Web client 构建后产生空行尾随空格、发布工作流误判 bundle 未提交的问题。
+- 修复根发行包仍固定依赖 0.5.0 内部 Runtime/Observer、安装新版本时可能带入旧实现的问题；根包现与两个内部包保持同版本。
+
+### 变更
+
+- 运行看板各页面移除重复的页面标题和子标题，任务状态桶使用剩余视口高度并消除底部补白与页面级纵向滚动。
+- 收信箱、发信箱和授权审批统一表头、行高、内边距与交替底色；状态列固定在最左侧，长内容最多显示两行。
+- 活动任务卡片中的检查点区域以“任务”面板展示并默认收起，只保留完成数/总数和进度，展开后显示阶段任务、状态和耗时。
+- 安装手册补充收敛式上下文压缩插件的独立下载、SHA-256 校验、官方 provider 替换、运行态验证、回滚和历史 Session 修复边界。
+
+## [0.5.3] - 2026-08-27
+
+### 修复
+
+- Resident、叶会话和故障替换 Session 统一使用配置的 Agent 预设，修复自定义预设下叶会话无法启动的问题。
+- 切换预设时沿用既有 Resident Session，保留原 Session 的事件上下文。
+
+### 变更
+
+- 运行看板 Header 的高度、内边距和字体规格与 Session 页面保持一致。
+- 移除四个任务状态桶的容器阴影；检查点改为默认收起的带边框浅灰面板，完成态使用圆圈对勾图标。
+
+## [0.5.2] - 2026-08-27
+
+### 新增
+
+- 叶会话支持提交结构化任务检查点，运行看板展示检查点进度、执行状态和耗时。
+- 群决策支持 `task-proposal`；未明确指名但可能需要处理的事项会先询问是否需要处理。
+- 主会话可根据持久化检查点确认或纠偏叶会话，并负责消息撤回决策和回读确认。
+
+### 变更
+
+- Resident Inbox 与主会话向叶会话补充上下文改为及时插话，减少长步骤中的排队等待。
+- 运行看板统一群聊、审批、归档和告警页面布局，任务卡片支持展开或折叠检查点。
+
+## [0.5.1] - 2026-08-27
+
+### 修复
+
+- 修复运行看板在侧栏折叠动画期间短暂露出底层 Session 页面的问题。
+- 优化授权审批状态标签，并为刷新按钮补充图标提示。
+
+### 变更
+
+- 正式版本发布支持对已存在且指向 `main` 历史的 Tag 进行手工重试。
+
 ## [0.5.0] - 2026-08-27
 
 ### 新增
@@ -34,5 +84,9 @@
 - assistant、observer 与发行包统一使用同一个产品版本号。
 - Node.js 最低版本与实际 zstd Runtime 要求一致，调整为 24。
 
+[0.5.4]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.4
+[0.5.3]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.3
+[0.5.2]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.2
+[0.5.1]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.1
 [0.5.0]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.5.0
 [0.4.0]: https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases/tag/v0.4.0

package/README.md

@@ -68,23 +68,31 @@ DSH 根据 Session 的 Agent 工作目录发现项目级 Skill，同时加载用
 
 推荐让 Web、resident Runtime 和看板运行在同一个 DSH Web 进程中，避免两个进程同时写同一份 Session JSONL 和 storage domain。
 
-正式版本发布后，可用 DSH 原生插件命令一次安装发行包：
+正式版本发布后，使用 DSH 原生插件命令安装根发行包；它会把 Assistant Runtime、Observer 看板和对应 bundle patch 一并装入 `web` profile。生产或验收环境建议固定版本：
 
 ```powershell
-dsh plugin --profile web add dingtalk-dsh-assistant
+dsh plugin --profile web add dingtalk-dsh-assistant@0.5.4
 ```
 
-版本历史见 [CHANGELOG](CHANGELOG.md)。设置页会通过 GitHub Release 检查新版本；检查失败会明确显示错误，不会误报为最新版本。升级使用：
+需要跟随 npm 最新版本时可省略 `@0.5.4`。安装完成后必须重启 `dsh web`，仅看到依赖安装成功不代表插件 Runtime 已加载。
+
+版本历史见 [CHANGELOG](CHANGELOG.md)，发行资产见 [GitHub Releases](https://github.com/HiQ-AI/dingtalk-dsh-assistant/releases)。设置页会通过 GitHub Release 检查新版本；“设置 → 插件 → 钉钉个人助理”的“版本与更新”卡片显示版本状态，并提供手动检查与更新命令复制入口。检查失败会明确显示错误，不会误报为最新版本。升级使用：
 
 ```powershell
 dsh plugin --profile web update dingtalk-dsh-assistant
 ```
 
-尚未发布到 npm 时，继续使用下面的源码安装方式。
+升级后重启 DSH Web，并依次确认：profile 中的包版本、`GET http://127.0.0.1:18998/health`、设置页/运行看板、真实群消息收发。四层证据不能互相替代。
+
+若 DSH 官方默认上下文压缩在长 Session 中出现摘要范围过小、反复压缩仍无法回到阈值的问题，可选装收敛式替换插件；安装、provider 互斥、验证和回滚步骤见[安装手册的上下文压缩接入章节](docs/manual/install-and-configure-dsh-web.md#可选接入收敛式上下文压缩插件)。该插件不随本发行包自动安装。
+
+以下源码安装方式只用于开发未发布代码；普通安装和升级不需要克隆仓库，也不需要手工添加两个内部包。
 
 维护者发布新版本时，先将根包、assistant 和 observer 的版本号及 `CHANGELOG.md` 更新为同一版本并合并到 `main`，再推送对应的 `v<version>` Tag。GitHub Actions 会在 Node.js 24.19.0 下重新构建、测试和打包，按 observer → assistant → 根发行包的顺序发布 npm；三个包回读一致后才创建 GitHub Release。发布 job 绑定 GitHub Environment `NPM_PUBLISH`，优先使用其中的 `NPM_PUBLISH_TOKEN`，未配置时回退到 `NPM_TOKEN`。
 
-### 1. 获取源码并验证
+### 源码开发安装
+
+#### 1. 获取源码并验证
 
 ```powershell
 git clone https://github.com/HiQ-AI/dingtalk-dsh-assistant.git
@@ -93,7 +101,7 @@ pnpm install
 pnpm test
 ```
 
-### 2. 将插件加入 DSH Web profile
+#### 2. 将插件加入 DSH Web profile
 
 在 `%USERPROFILE%\.dsh\profiles\web\package.json` 中加入两个本地依赖。路径应替换为仓库的真实绝对目录：
 
@@ -120,7 +128,7 @@ pnpm test
 
 若使用 ChatGPT/Codex 订阅，再把 `dsh-codex-connect` 同时加入 `dependencies` 和 `bundles`；使用其他模型来源时保留对应 provider，不需要安装 `dsh-codex-connect`。
 
-### 3. 装配 resident Runtime
+#### 3. 装配 resident Runtime
 
 把 [`.dsh/profiles/resident/cordis.patch.yml`](.dsh/profiles/resident/cordis.patch.yml) 中的 resident 配置按需合并到实际使用的 Web profile patch。Web 基础 bundle 已包含 storage 相关插件，只覆盖 `storage-json` 配置并插入 `dingtalk-dsh-assistant/resident`，不要重复插入同名 storage 项。
 
@@ -135,14 +143,14 @@ dws:
 
 不要把个人群 ID、DWS profile、Agent 名称、工作目录或职责写入仓库模板；这些内容应保存在本机 DSH 配置和插件 storage 中。
 
-### 4. 安装 profile 依赖
+#### 4. 安装 profile 依赖
 
 ```powershell
 Set-Location "$env:USERPROFILE\.dsh\profiles\web"
 pnpm install
 ```
 
-### 5. 启动 DSH Web
+#### 5. 启动 DSH Web
 
 ```powershell
 Set-Location D:\path\to\dingtalk-dsh-assistant
@@ -188,7 +196,7 @@ dws:
 
 Task 可设置独立的简短标题用于看板展示；标题与 objective 分离，重命名不会改变任务授权范围、Goal 或验收标准。运行看板通过 DSH 官方 `sidebar.footer.action` 提供左侧菜单入口，并由 `shell.overlay` 承载右侧完整内容区域；点击运行看板时切换到看板并清除 Session 选中状态，点击任意 Session 时关闭看板、恢复该 Session 的选中状态与对话/轨迹。运行看板复用 Session 的实际选中背景色，不额外显示焦点边框。
 
-运行看板顶部固定为 76px；各页按剩余视口高度计算内容区，任务列扣除顶部、主内容内边距和标题后使用可视高度，卡片在列内独立滚动，不再强制至少 1000px 高。
+运行看板 Header 的高度和字体规格与 Session 页面一致。各页不再重复显示页面标题和子标题；任务列按 Header 与主内容实际占用计算剩余视口高度，卡片在列内独立滚动，页面本身不会因状态桶高度产生额外补白或纵向滚动。
 
 Runtime 使用 DSH 原生 subagent 和 Goal 创建叶子 Session。主会话不执行具体工作。Task 将简短任务名、当前有效目标和叶子执行用的来源证据信封分开持久化；任务看板和原生子会话展示任务名，叶子 Goal 同时接收当前目标与完整来源证据。来源信封包含消息 ID、发送者、时间、引用 ID、原始正文和附件异常，并明确要求结合当前代码、运行态和工具证据独立核验。Task 正式执行状态为 `running`、`waiting`、`completed`，超过并行上限时进入产品层 `queued`。归档只影响看板展示，不删除 Task、Session、Goal 或历史上下文；已完成或已归档 Task 收到关联上下文时会重新打开原 Task，并复用同一个叶子 Session，但创建独立的新执行轮次和全新 Goal。新轮次会覆盖当前目标、来源消息与发送人、验收标准、阶段任务、开始时间、阻塞和结果；上一轮的 Session、目标、来源、验收、阶段和结果快照进入 `runHistory`，只作为历史参考。后续消息明确扩大或收窄动作范围时，Runtime 在同一 Task 中修订当前有效目标并保留旧目标历史；普通事实补充不会修改目标。每轮重开会把新的群消息与发送人记录为当前触发来源，同时保留历次触发历史；该轮完成通知引用并 @当前触发人。
 
@@ -215,10 +223,10 @@ Runtime 使用 DSH 原生 subagent 和 Goal 创建叶子 Session。主会话不
 
 ![钉钉个人助理任务看板](docs/manual/images/dsh-web-task-board-annotated.png)
 
-- 群聊会话：查看不同 resident Session 的分页消息和 Agent 投递状态。
-- 任务看板：按待执行、执行中、等待中、已完成展示 Task，并打开 DSH 原生叶子对话和轨迹。
+- 群聊会话：查看不同 resident Session 的分页收信箱和发信箱；状态固定在最左列，长内容最多显示两行，完整内容可通过悬停标题或详情查看。
+- 任务看板：按待执行、执行中、等待中、已完成展示 Task，并打开 DSH 原生叶子对话和轨迹。活动任务卡片中的“任务”面板默认收起，只显示完成数/总数和进度；展开后显示各阶段任务、状态和耗时。
 - 归档任务：查看已归档 Task，相关群消息仍可重新打开原任务。
-- 授权审批：分页查看完整申请单，并在页面批准或拒绝。
+- 授权审批：以与消息表格一致的状态列、行高和内容密度分页查看申请单，并在页面批准或拒绝。
 - 告警：按类型查看当前异常和分页的已恢复历史。
 
 看板不读取或重建 DSH Session JSONL，只通过插件状态接口展示业务投影；对话与轨迹仍由 DSH 原生页面负责。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dingtalk-dsh-assistant",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "在 DeepSeek Harness 中运行的钉钉群聊个人助理与任务看板",
   "license": "UNLICENSED",
   "type": "module",
@@ -41,8 +41,8 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@zzusp/dingtalk-dsh-assistant": "0.5.0",
-    "@zzusp/dingtalk-dsh-observer": "0.5.0"
+    "@zzusp/dingtalk-dsh-assistant": "0.5.4",
+    "@zzusp/dingtalk-dsh-observer": "0.5.4"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-agent": "0.1.1-rc.2",