dsh-next-actions 0.1.0 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # 版本记录
 
+## 0.1.1 — 2026-11-11
+
+修复 DSH 升级后引导提示丢失：`AgentRegistry.roots()` 在 DSH 0.2.1-rc.3 起被移除，
+原来的根 agent 判定抛错后被静默忽略，常驻提示语因此从未注册，模型只看到单独的工具描述。
+
+- 改用会话 header 的 `origin: 'subagent'` 区分普通会话与子代理；子代理仍不注册工具与提示。
+- 静默降级改为可诊断：引导安装失败、既有 agent 列表不可读、会话 header 无法判定都写 Host 日志；
+  Host logger 缺失时回退 `console.warn`。
+- 引导语明确说明工程/代码工作同样适用：卡片在回答下方，不把回答变成 UI 回答。
+- 工具描述自述触发时机，即使提示语丢失也能说明用途。
+- 客户端光标插入被拒绝或抛错时回退为追加，并写 `console.warn` 说明降级。
+- 测试改用当前 `AgentRegistry.list()` 接口，并覆盖子代理排除、各静默降级的告警。
+
 ## 0.1.0 — 2026-11-11
 
 首个公开发布。

package/DESIGN.md

@@ -60,7 +60,7 @@
 
 | 部分 | 文件 | 职责 |
 | --- | --- | --- |
-| Host | `index.js` | 为根 agent 注册 `suggest_next_actions` 与一段常驻提示；子代理不注册；`enabled:false` 时什么都不注册 |
+| Host | `index.js` | 为根 agent 注册 `suggest_next_actions` 与一段常驻提示；子代理不注册（按会话 header 的 `origin` 区分）；安装与判定失败写日志；`enabled:false` 时什么都不注册 |
 | 规范化 | `lib/normalize.js` | 参数 → `{ shown, context, suggestions[≤3] }`：折叠空白、截断、按指令去重、推荐至多一条且置顶；危险标记来自模型字段或命令形状模式。结果作为 `tool/result.meta` 写入会话日志 |
 | Client | `client.js`（手写单文件，含 CSS） | 两个 Conversation Definition：`next-actions` 把本工具结果上的 meta（native 与 PTC `run_code` 两条通路）发布为该轮卡片；`next-actions-sent` 把用户在该轮发出的第一条 `user/message` 发布为 `sent` 文本。`conversation.chat.turnTail` 渲染卡片；`tool.call.toolview` 渲染过程行 |
 

package/README.md

@@ -3,7 +3,7 @@
 > Suggested next actions under DeepSeek Harness replies — clicking one fills the input, never sends.
 > DSH Web/Desktop 插件：在回复下方显示 1–3 条「下一步建议」，点击只填入输入框。
 
-**状态：v0.1.0，已发布到 npm。** 设计与理念见 [`DESIGN.md`](DESIGN.md)，版本记录见 [`CHANGELOG.md`](CHANGELOG.md)。
+**状态：v0.1.1（npm 包：[dsh-next-actions](https://www.npmjs.com/package/dsh-next-actions)）。** 设计与理念见 [`DESIGN.md`](DESIGN.md)，版本记录见 [`CHANGELOG.md`](CHANGELOG.md)。
 
 ## 安装
 
@@ -38,6 +38,7 @@ lib/normalize.js    参数规范化，结果写入 tool/result.meta
 client.js           Client（手写单文件）：Definition、卡片、过程行与 CSS
 cordis.patch.yml    插件行 patch
 test/               node --test
+assets/promo/       宣传短片：源文件、封面与渲染脚本（成片不入库，不随 npm 发布）
 ```
 
 ## 开发
@@ -50,6 +51,21 @@ npm pack --dry-run  # 打包检查
 安装/卸载用 `plugin_manager` 的 `install_bundle` / `remove_bundle`；验证使用假 `DSH_HOME`。
 Host 改动需重启 DSH，Client 改动需刷新页面。
 
+## 发布
+
+改 `package.json` 版本与 `CHANGELOG.md` 后：
+
+```sh
+node --test
+npm pack --dry-run
+git tag -a v<version> -m "v<version>"
+git push origin main --tags
+npm publish --access public
+npm view dsh-next-actions version   # 确认 latest 指向新版本
+```
+
+发布后用假 `DSH_HOME` 从 registry 装一次；本机 `link:` 安装不需要切换。
+
 关闭功能：在 profile 的 `cordis.patch.yml` 写
 
 ```yaml

package/client.js

@@ -277,8 +277,12 @@ window.__ModuleLoader__.load({
         next = null
         try {
           // One editor edit at the caret: keeps @ references, undoable with ⌘Z.
-          if (actions.insertText(`\n\n${prompt}`, actions.captureInsertion()) !== true) next = `${draft.trimEnd()}\n\n${prompt}`
-        } catch {
+          if (actions.insertText(`\n\n${prompt}`, actions.captureInsertion()) !== true) {
+            console.warn('[dsh-next-actions] insertText declined; appending the action instead')
+            next = `${draft.trimEnd()}\n\n${prompt}`
+          }
+        } catch (error) {
+          console.warn('[dsh-next-actions] insert at caret failed; appending the action instead', error)
           next = `${draft.trimEnd()}\n\n${prompt}`
         }
       }

package/index.js

@@ -18,6 +18,7 @@ const GUIDANCE = [
   'Before your final answer, call suggest_next_actions once when this turn leaves real follow-up work:',
   'a task finished or advanced, tools ran, files changed, review or approval is due,',
   'or you were about to end with a list of next actions.',
+  'Use it for code and engineering work too; the card sits under the reply and the reply keeps its normal plain-text format.',
   'Put those actions only in the card; the reply gets at most one lead-in sentence and never numbers or bullets them.',
   'Skip greetings, acknowledgements, pure knowledge answers, repeated cards, and turns that already asked a structured question.',
 ].join(' ')
@@ -28,7 +29,8 @@ const TOOL = {
   name: TOOL_NAME,
   description: [
     'Show 1–3 clickable next actions as a card under your reply; clicking one fills the message input, never sends.',
-    "Write them in the user's language and never repeat them in your prose.",
+    'Call it once before the final answer when this turn leaves real follow-up work.',
+    "Write the actions in the user's language and never repeat them in your prose.",
   ].join(' '),
   parameters: {
     type: 'object',
@@ -83,12 +85,18 @@ export function normalizeConfig(raw) {
   return { enabled: !(raw !== null && typeof raw === 'object' && raw.enabled === false) }
 }
 
-/** Root agents only; fail open so a Harness change never silently hides the tool. */
-function isRoot(ctx, agent) {
+/**
+ * Ordinary session agents only. Delegated agents carry the durable
+ * `origin: 'subagent'` header; `AgentRegistry.roots()` no longer exists since
+ * DSH 0.2.1-rc.3, so the header is the supported discriminator. Fail open so a
+ * Harness change never silently hides the tool, and report the drift once.
+ */
+function isRoot(agent, onUnreadable) {
   if (agent === undefined || agent === null) return true
   try {
-    return ctx.agents.roots().includes(agent)
-  } catch {
+    return agent.session.header.origin !== 'subagent'
+  } catch (error) {
+    onUnreadable?.(error)
     return true
   }
 }
@@ -96,17 +104,38 @@ function isRoot(ctx, agent) {
 export function apply(ctx, config) {
   if (!normalizeConfig(config).enabled) return
 
+  /** Host log, with a console fallback so a missing logger cannot hide the report. */
+  const warn = (message) => {
+    const line = `dsh-next-actions: ${message}`
+    try {
+      if (typeof ctx.logger?.warn === 'function') {
+        ctx.logger.warn(line)
+        return
+      }
+    } catch {
+      // Fall through: the warning must not depend on a working logger.
+    }
+    console.warn(line)
+  }
+
+  /** Report a header-shape change once; `when` runs on every tool resolution. */
+  let headerFailureReported = false
+  const isRootAgent = (agent) => isRoot(agent, (error) => {
+    if (headerFailureReported) return
+    headerFailureReported = true
+    warn(`agent session header unreadable; treating the agent as a root: ${String(error)}`)
+  })
+
   ctx.effect(
-    () => ctx.tools.register(TOOL, { when: ({ agent }) => isRoot(ctx, agent) }),
+    () => ctx.tools.register(TOOL, { when: ({ agent }) => isRootAgent(agent) }),
     'dsh-next-actions: tool',
   )
 
   /** agent → disposer of its prompt section. */
   const installed = new Map()
   const install = (agent) => {
-    if (installed.has(agent)) return
+    if (installed.has(agent) || !isRootAgent(agent)) return
     try {
-      if (!ctx.agents.roots().includes(agent)) return
       const prompt = agent.ctx.systemPrompt
       const base = prompt.getSectionOrder?.('TOOL_REPORT')
       installed.set(agent, agent.ctx.effect(() => prompt.section({
@@ -114,8 +143,10 @@ export function apply(ctx, config) {
         order: typeof base === 'number' ? base + 50 : 2950,
         text: GUIDANCE,
       }), 'dsh-next-actions: guidance'))
-    } catch {
-      // The guidance is an enhancement; the tool stays registered.
+    } catch (error) {
+      // The tool still works without the guidance; surface the degradation
+      // instead of silently losing the standing instruction.
+      warn(`guidance not installed: ${String(error)}`)
     }
   }
 
@@ -123,9 +154,11 @@ export function apply(ctx, config) {
     const offCreated = ctx.on('agent/created', ({ agent }) => install(agent))
     const offDisposed = ctx.on('agent/disposed', ({ agent }) => installed.delete(agent))
     try {
-      for (const agent of ctx.agents.roots()) install(agent)
-    } catch {
-      // Agents created later still arrive through agent/created.
+      for (const agent of ctx.agents.list()) install(agent)
+    } catch (error) {
+      // Agents created later still arrive through agent/created, but agents
+      // that were already live at apply time keep missing the guidance.
+      warn(`could not install guidance on existing agents: ${String(error)}`)
     }
     return () => {
       offCreated()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-next-actions",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "license": "MIT",
   "description": "Shows 1–3 clickable next actions under replies; clicking one fills the input draft, never sends.",
   "icon": "./icon.svg",