@lemoncat7/dsh-partner 1.8.2 → 1.8.3

package/README.md

@@ -6,7 +6,15 @@
 
 ## 兼容性
 
-正式版 `1.8.2` 适配 DeepSeek Harness `0.1.2-rc.1`，需要 Node.js `22.19+` 或 `24+`。DSH 官方 Agent、Session、Settings、Tools 与客户端 UI 依赖均锁定到 `0.1.2-rc.1` 接口族。
+正式版 `1.8.3` 适配 DeepSeek Harness `0.1.2-rc.1`，需要 Node.js `22.19+` 或 `24+`。DSH 官方 Agent、Session、Settings、Tools 与客户端 UI 依赖均锁定到 `0.1.2-rc.1` 接口族。
+
+### 1.8.3 更新
+
+- 伙伴身份、能力、Skill 和协作配置保存后，在下一轮执行前统一注册到会话；覆盖已有浏览器会话和历史会话恢复，不在正在执行的轮次中重组工具，也不唤醒闲置会话。高权限管理工具继续在调用时检查当前授权。
+- 「应用能力组合」增加保存中、成功和失败反馈，成功显示「已保存，下一轮生效」；防止重复提交，失败保留草稿，区分保存失败与保存后刷新失败。
+- 新消息轻摆转向文字面，仅在文字面扫光两次；结束及阅读后不自动恢复图案面，不锁定用户手动翻面。
+- 挂点旁增加小数字未读标记，超过 99 显示 99+，全部已读后隐藏；支持深浅色与减少动态效果，不增加常驻动画或渲染循环。
+- 保留自定义图案、现有卡片材质、24/30/60 FPS 与休眠策略，不改 DSH 源码或伙伴数据。162 项自动化测试及隔离浏览器交互回归通过。
 
 ### 1.8.2 更新
 
@@ -97,7 +105,7 @@
 
 知识库挂载要求同时安装包含 `dshKnowledgeMountManagement` 接口的知识库插件；旧版或未安装时会明确提示，身份、能力等管理仍可用。挂载通过知识库当前选中的本地或远程后端执行，远程只读令牌不能修改挂载，不会绕过认证或退回本地写入。
 
-目标伙伴执行中拒绝修改，配置过期须重新读取。配置已保存但会话未能刷新时，工具会返回 `applied: true` 和 `runtime: reopen-required`，应重新打开目标伙伴会话后使用新配置，不要重复提交。此权限不自动开启任何伙伴的记忆、心跳或渠道。
+目标伙伴执行中拒绝管理工具修改，配置过期须重新读取。配置保存成功后，身份、能力、Skill 与协作关系在下一轮执行前注册，无需为了注入工具重开会话；Preset 和模型作为会话默认配置，不覆盖已有会话的选择。此权限不自动开启任何伙伴的记忆、心跳或渠道。
 
 ## 安装
 

package/docs/architecture.md

@@ -12,13 +12,19 @@ client -> HTTP feature routers -> application services -> repositories/store
 
 ## Module boundaries
 
-Capability saves recompose already-live companion sessions immediately after
-releasing the old composition. Browser-owned agents retain their session and
-receive fresh scoped identity/tools; inactive sessions are not eagerly opened.
-Busy companions reject configuration changes before teardown. Revocation removes
-the tool and management services also recheck live authorization on every call.
-Browser-owned preset/model changes still report that reopening is required;
-this is separate from refreshing scoped companion tools.
+Configuration saves only commit state. The awaited `agent/pre-step` hook compares
+the saved configuration with the installed revision before each new turn, covering
+native history resume as well as local, channel and task-board conversations.
+Unchanged configurations do not re-register tools or read Skill bodies again;
+mid-turn saves never dismantle a running composition. No polling or eager wakeup
+of inactive sessions is needed. Plugin-owned tools recheck capability revocations
+at execution even when an old schema remains in the current turn.
+The UI reports saved/next-turn, separately from request failures and refresh
+failures. Preset and model defaults remain subject to DSH session-selection rules;
+the plugin does not bypass restrictions on changing an existing session's preset.
+`companions/session-configuration.ts` indexes persisted routes and configuration
+revisions without transcript copies. `ui/capability-editor.tsx` owns the capability
+form and save feedback, using the shared companion draft and existing UI tokens.
 
 - `core/`: shared validation, identifiers and bounded collections. It contains
   no partner feature policy.
@@ -109,9 +115,9 @@ this is separate from refreshing scoped companion tools.
   Identity, enabled Skill IDs and outgoing grants commit together. Unknown
   fields, stale revisions, cancellation, missing resources and busy targets
   fail closed. Authority is checked again inside the serialized store write.
-  A reload error after commit is reported as saved/reopen-required, not a failed
-  write; browser-owned Agent handles are not forcibly destroyed or reported as
-  hot-reloaded. Unspecified settings, including automation, remain unchanged.
+  A runtime confirmation error after commit is reported as saved/next-turn with
+  a warning, not a failed write. Browser-owned Agent handles are not destroyed.
+  Unspecified settings, including automation, remain unchanged.
 - Knowledge mount management is a separate provider-backed operation. The
   adapter derives the target's default project and existing session scopes on
   the server, never from model-supplied paths. It calls the optional
@@ -148,7 +154,7 @@ this is separate from refreshing scoped companion tools.
 - 点击层不绘制材质或装饰边框，鼠标拖动不触发键盘聚焦，键盘操作保留可见焦点。卸载时一并清理小画布、绳带节点和物理资源。
 - `pendant/use-placement.ts` 只负责挂点位置：拖动顶部挂点或用方向键移动整件挂饰，与卡牌拉伸手势分离。位置按可用视口比例保存在本地浏览器，刷新恢复，窄屏及旋转时约束到可见范围；逐帧移动不触发 React 状态更新，完成时才写存储，不查询宿主私有 DOM。
 - 卡牌正面只负责图案，消息更新不会重绘或覆盖正面纹理；内侧单独绘制未读数量、伙伴名和简短状态。图案与消息使用独立纹理，不自动弹出消息或额外角标。
-- `pendant/notice-motion.ts` 统一处理新消息提醒：等待被握持或快速甩动的卡牌空闲，轻摆并以短暂的物理角速度辅助转回正面，再由 `pendant/sheen.ts` 在正面轻扫光两次。提醒不修改卡牌的自由拖拽物理结构，多条到达合并一次动作，抓取可中断；后台、全部已读及减少动态效果时取消。效果共用卡面圆角几何，不使用全屏后处理、独立计时器或逐帧纹理重绘。
+- `pendant/notice-motion.ts` 统一处理新消息提醒：等待被握持或快速甩动的卡牌空闲，轻摆并以短暂的物理角速度辅助转向文字面（背面，Y 轴半周），再由 `pendant/sheen.ts` 仅在文字面轻扫光两次。结束或阅读后不自动恢复图案面，也不持续锁定朝向；抓取可中断，用户仍能自由翻面。多条到达合并一次动作；后台、全部已读及减少动态效果时取消。效果共用卡面圆角几何，不使用全屏后处理、独立计时器或逐帧纹理重绘。挂点旁保留静态小数字未读标记（超过 99 显示 99+，全部已读后隐藏），翻面及减少动态效果时仍可见，不拦截拖动、不唤醒渲染循环；读屏复用消息按钮和现有单一播报区。
 - `pendant/reader.tsx` 点击打开最新未读正文（无未读时展示列表），保留可见、可玩的挂饰；桌面优先放在卡牌旁边，窄屏选择卡牌上方或下方的可用空间。正文独立滚动，来源操作留在底部；使用独立冷灰纸面材质，支持 Escape 关闭、键盘焦点返回、卡牌再次点击关闭和来源导航。静止挂卡即使在阅读时也会自然休眠。
 - `notifications/service.ts` 从已提交的任务/定时执行变化和完整伙伴回复生成终态通知；不改变任务执行，不暴露内部验收交接。普通回复按会话和轮次去重，任务按 ID/修订/终态去重。
 - `notifications/store.ts` 在主状态文件同目录保存 `partner-inbox.sqlite`，权限 0600，最多 200 条摘要（每条最多 2000 字符）及已读状态。它不是新的会话历史；完整内容仍在原任务/会话中。

package/lib/agent-runtime.d.ts

@@ -1,4 +1,5 @@
 import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
 import type { AgentDefaultModelConfig } from '@deepseek-ai/dsh-agent-default-model';
 import type { AgentPresets } from '@deepseek-ai/dsh-agent-presets';
 import type { SessionId } from '@deepseek-ai/dsh-session';
@@ -66,6 +67,10 @@ export declare class PartnerAgentRuntime {
     private readonly restoredCompositions;
     private readonly restoredCompositionJobs;
     private readonly disposeAgentListener;
+    private readonly disposeConfigurationListener;
+    private readonly configurations;
+    private readonly preparedTurns;
+    private closed;
     private questionAnswerer;
     constructor(ctx: RuntimeContext, store: PartnerStore, defaultCwd: string, memory?: PartnerMemoryStore | undefined, reflection?: MemoryReflectionService | undefined, concerns?: PartnerConcernStore | undefined, composer?: PartnerAgentComposer | undefined);
     setQuestionAnswerer(answerer: PartnerQuestionAnswerer): void;
@@ -100,7 +105,8 @@ export declare class PartnerAgentRuntime {
     recordHeartbeatActivity(companion: Companion, route: ChannelSession, execution: HeartbeatExecution, outcome: HeartbeatOutcome, deliveryError?: string): Promise<void>;
     resetCompanion(companionId: string): Promise<void>;
     reloadCompanion(companionId: string): Promise<void>;
-    reloadManagedCompanion(companionId: string): Promise<void>;
+    /** Awaited by the host before prompt/tool assembly, never from a running tool. */
+    prepareAgentTurn(agent: Agent, turn: number, signal: AbortSignal): Promise<void>;
     isCompanionBusy(companionId: string): boolean;
     private releaseCompanion;
     resetChannel(channelId: string): Promise<void>;
@@ -110,7 +116,6 @@ export declare class PartnerAgentRuntime {
     private persistInbound;
     private ensureSession;
     private ensureAgent;
-    private ensureRestoredComposition;
     private composeRestoredAgent;
     private injectProfileUpdate;
     private attachSession;

package/lib/agent-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../src/agent-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-runtime.d.ts","sourceRoot":"","sources":["../src/agent-runtime.ts"],"names":[],"mappings":"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"}

package/lib/agent-runtime.js

@@ -3,6 +3,7 @@ import { mkdir, realpath, stat, writeFile } from 'node:fs/promises';
 import { basename, extname, isAbsolute, join, relative, resolve, sep } from 'node:path';
 import { BlockAssembler, createToolResultMessage, createUserMessage } from '@deepseek-ai/dsh-llm';
 import { createScope, scopeOf, scopeParentOf } from '@deepseek-ai/dsh-scope';
+import { SessionConfigurationIndex } from './companions/session-configuration.js';
 import { concernObservationPrompt } from './autonomy.js';
 import { boundedConcernCheckMinutes } from './concern-domain.js';
 import { PARTNER_MEDIA_MAX_BYTES, safeMediaName } from './channel-message.js';
@@ -54,6 +55,10 @@ export class PartnerAgentRuntime {
     restoredCompositions = new Map();
     restoredCompositionJobs = new Map();
     disposeAgentListener;
+    disposeConfigurationListener;
+    configurations;
+    preparedTurns = new WeakMap();
+    closed = false;
     questionAnswerer;
     constructor(ctx, store, defaultCwd, memory, reflection, concerns, composer) {
         this.ctx = ctx;
@@ -63,8 +68,15 @@ export class PartnerAgentRuntime {
         this.reflection = reflection;
         this.concerns = concerns;
         this.composer = composer;
+        this.configurations = new SessionConfigurationIndex(store);
+        this.disposeConfigurationListener = typeof this.ctx.on === 'function'
+            ? this.ctx.on('agent/pre-step', async ({ agent, turn, signal }, next) => {
+                await this.prepareAgentTurn(agent, turn, signal);
+                return next();
+            }) : () => { };
         this.disposeAgentListener = typeof this.ctx.on === 'function'
             ? this.ctx.on('agent/disposed', ({ agent }) => {
+                this.preparedTurns.delete(agent);
                 const restored = this.restoredCompositions.get(agent.session.id);
                 if (restored?.agent !== agent)
                     return;
@@ -477,31 +489,38 @@ export class PartnerAgentRuntime {
         await this.store.update(state => { state.sessions = state.sessions.filter(item => item.companionId !== companionId); });
     }
     async reloadCompanion(companionId) {
-        if (this.isCompanionBusy(companionId))
-            throw new Error('伙伴正在执行，请等待当前回复结束后再修改能力');
-        const activeRoutes = this.store.snapshot().sessions.filter(route => route.companionId === companionId
-            && (this.handles.has(route.sessionId) || this.ctx.agents.get(route.sessionId) !== undefined));
-        await this.releaseCompanion(companionId);
-        // Releasing a restored composition does not close the browser-owned Agent.
-        // Recompose it now: staying in the same conversation must not leave it with
-        // no partner tools until the user happens to click "open session" again.
-        for (const route of activeRoutes) {
-            const state = this.store.snapshot();
-            const companion = state.companions.find(item => item.id === companionId);
-            const currentRoute = state.sessions.find(item => item.id === route.id && item.companionId === companionId);
-            if (companion && currentRoute)
-                await this.ensureAgent(companion, currentRoute);
-        }
+        // Compatibility for callers that saved a configuration. The index already
+        // observes committed writes; do not tear down or wake any Agent here.
+        if (!this.configurations.companion(companionId))
+            throw new Error('伙伴不存在');
     }
-    async reloadManagedCompanion(companionId) {
-        const externallyOwned = this.store.snapshot().sessions.some(route => route.companionId === companionId
-            && !this.handles.has(route.sessionId) && this.ctx.agents.get(route.sessionId) !== undefined);
-        await this.reloadCompanion(companionId);
-        // Browser-owned handles cannot be disposed by this plugin. In particular,
-        // their preset/model must not be reported as hot-reloaded successfully.
-        if (externallyOwned) {
-            throw new Error('目标伙伴还有由 DSH 管理的活动会话，请重新打开会话使配置生效');
+    /** Awaited by the host before prompt/tool assembly, never from a running tool. */
+    async prepareAgentTurn(agent, turn, signal) {
+        if (this.closed)
+            throw new Error('伙伴运行时已关闭');
+        if (this.preparedTurns.get(agent) === turn)
+            return;
+        const configuration = this.configurations.forSession(agent.session.id);
+        if (!configuration)
+            return;
+        signal.throwIfAborted();
+        const installed = this.restoredCompositions.get(agent.session.id);
+        if (installed?.agent !== agent || installed.revision !== configuration.revision) {
+            const profile = await this.memory?.profileSnapshot(configuration.companion.id, memoryScope(configuration.route.channelId, configuration.route.userId)).catch(() => undefined);
+            signal.throwIfAborted();
+            if (this.closed)
+                throw new Error('伙伴运行时已关闭');
+            const job = this.composeRestoredAgent(agent, configuration.companion, configuration.route, configuration.revision, profile, signal);
+            this.restoredCompositionJobs.set(agent.session.id, job);
+            try {
+                await job;
+            }
+            finally {
+                if (this.restoredCompositionJobs.get(agent.session.id) === job)
+                    this.restoredCompositionJobs.delete(agent.session.id);
+            }
         }
+        this.preparedTurns.set(agent, turn);
     }
     isCompanionBusy(companionId) {
         return this.store.snapshot().sessions.some(route => route.companionId === companionId
@@ -529,7 +548,10 @@ export class PartnerAgentRuntime {
         await this.store.update(state => { state.sessions = state.sessions.filter(item => item.channelId !== channelId); });
     }
     async close() {
+        this.closed = true;
+        this.disposeConfigurationListener();
         this.disposeAgentListener();
+        this.configurations.close();
         await Promise.allSettled(this.restoredCompositionJobs.values());
         for (const restored of this.restoredCompositions.values())
             restored.dispose();
@@ -545,6 +567,8 @@ export class PartnerAgentRuntime {
     async releaseRestoredComposition(sessionId) {
         await this.restoredCompositionJobs.get(sessionId)?.catch(() => { });
         const restored = this.restoredCompositions.get(sessionId);
+        if (restored)
+            this.preparedTurns.delete(restored.agent);
         restored?.dispose();
         this.restoredCompositions.delete(sessionId);
     }
@@ -647,7 +671,6 @@ export class PartnerAgentRuntime {
         }
         const live = this.ctx.agents.get(route.sessionId);
         if (live !== undefined) {
-            await this.ensureRestoredComposition(live, companion, route, profile);
             await this.attachSession(companion, route);
             if (profile)
                 this.injectProfileUpdate(live, route.sessionId, profile);
@@ -659,24 +682,8 @@ export class PartnerAgentRuntime {
             if (presets === undefined)
                 throw new Error('伙伴会话缺少 Agent Presets 服务');
             await presets.mount(agentCtx, companion.presetId);
-            agentCtx.systemPrompt.section({
-                name: 'partner-identity',
-                order: -10,
-                text: renderPartnerPersona(companion, route.kind === 'local' ? 'local' : 'conversation'),
-            });
-            agentCtx.systemPrompt.section({
-                name: 'partner-tool-routing',
-                order: -9,
-                text: renderToolProtocol(),
-            });
-            if (profile && profile.entries.length > 0)
-                agentCtx.systemPrompt.section({
-                    name: 'partner-user-profile',
-                    order: -8,
-                    text: renderProfile(profile),
-                });
-            this.questionAnswerer?.(agentCtx, route);
-            await this.composer?.compose(agentCtx, companion);
+            // Partner composition is installed at the same awaited pre-step boundary
+            // for factory-created and native browser-resumed Agents alike.
         };
         let handle;
         try {
@@ -703,69 +710,53 @@ export class PartnerAgentRuntime {
         await this.attachSession(companion, route);
         return handle.agent;
     }
-    async ensureRestoredComposition(agent, companion, route, profile) {
-        const installed = this.restoredCompositions.get(route.sessionId);
-        if (installed?.agent === agent)
-            return;
-        const pending = this.restoredCompositionJobs.get(route.sessionId);
-        if (pending !== undefined)
-            return pending;
-        const job = this.composeRestoredAgent(agent, companion, route, profile);
-        this.restoredCompositionJobs.set(route.sessionId, job);
-        try {
-            await job;
-        }
-        finally {
-            if (this.restoredCompositionJobs.get(route.sessionId) === job)
-                this.restoredCompositionJobs.delete(route.sessionId);
+    async composeRestoredAgent(agent, companion, route, revision, profile, signal) {
+        // Already inside the driver's awaited pre-step hook. Waiting for idle or
+        // runMaintenance here would deadlock the very turn we are preparing.
+        signal.throwIfAborted();
+        const agentCtx = agent.ctx;
+        const key = scopeOf(agentCtx);
+        if (key === undefined)
+            throw new Error('伙伴会话缺少 Agent 作用域');
+        if (scopeParentOf(key) === undefined) {
+            const presets = agentCtx.get('agentPresets');
+            if (presets === undefined)
+                throw new Error('伙伴会话缺少 Agent Presets 服务');
+            await presets.mount(agentCtx, companion.presetId);
         }
-    }
-    async composeRestoredAgent(agent, companion, route, profile) {
-        await agent.whenIdle();
-        let dispose;
-        await agent.runMaintenance(async (signal) => {
-            if (signal.aborted)
-                throw signal.reason;
-            const agentCtx = agent.ctx;
-            const key = scopeOf(agentCtx);
-            if (key === undefined)
-                throw new Error('伙伴会话缺少 Agent 作用域');
-            if (scopeParentOf(key) === undefined) {
-                const presets = agentCtx.get('agentPresets');
-                if (presets === undefined)
-                    throw new Error('伙伴会话缺少 Agent Presets 服务');
-                await presets.mount(agentCtx, companion.presetId);
-            }
-            const disposers = [];
-            try {
-                disposers.push(agentCtx.systemPrompt.section({ name: 'partner-identity', order: -10, text: renderPartnerPersona(companion, route.kind === 'local' ? 'local' : 'conversation') }));
-                disposers.push(agentCtx.systemPrompt.section({ name: 'partner-tool-routing', order: -9, text: renderToolProtocol() }));
-                if (profile && profile.entries.length > 0)
-                    disposers.push(agentCtx.systemPrompt.section({ name: 'partner-user-profile', order: -8, text: renderProfile(profile) }));
-                if (this.questionAnswerer)
-                    disposers.push(this.questionAnswerer(agentCtx, route));
-                if (this.composer)
-                    disposers.push(await this.composer.compose(agentCtx, companion));
-            }
-            catch (error) {
-                for (let index = disposers.length - 1; index >= 0; index -= 1)
-                    disposers[index]?.();
-                throw error;
-            }
-            let disposed = false;
-            dispose = () => {
-                if (disposed)
-                    return;
-                disposed = true;
-                for (let index = disposers.length - 1; index >= 0; index -= 1)
-                    disposers[index]?.();
-            };
-        });
-        if (dispose === undefined)
-            throw new Error('伙伴会话恢复组合未完成');
         const previous = this.restoredCompositions.get(route.sessionId);
         previous?.dispose();
-        this.restoredCompositions.set(route.sessionId, { agent, dispose });
+        this.restoredCompositions.delete(route.sessionId);
+        const disposers = [];
+        try {
+            disposers.push(agentCtx.systemPrompt.section({ name: 'partner-identity', order: -10, text: renderPartnerPersona(companion, route.kind === 'local' ? 'local' : 'conversation') }));
+            disposers.push(agentCtx.systemPrompt.section({ name: 'partner-tool-routing', order: -9, text: renderToolProtocol() }));
+            if (profile && profile.entries.length > 0)
+                disposers.push(agentCtx.systemPrompt.section({ name: 'partner-user-profile', order: -8, text: renderProfile(profile) }));
+            if (this.questionAnswerer)
+                disposers.push(this.questionAnswerer(agentCtx, route));
+            if (this.composer)
+                disposers.push(await this.composer.compose(agentCtx, companion));
+            signal.throwIfAborted();
+            if (this.closed)
+                throw new Error('伙伴运行时已关闭');
+        }
+        catch (error) {
+            for (let index = disposers.length - 1; index >= 0; index -= 1)
+                disposers[index]?.();
+            throw error;
+        }
+        let disposed = false;
+        const dispose = () => {
+            if (disposed)
+                return;
+            disposed = true;
+            for (let index = disposers.length - 1; index >= 0; index -= 1)
+                disposers[index]?.();
+        };
+        // Keep the captured revision: a concurrent save must be applied next turn,
+        // never incorrectly recorded as already installed by this composition.
+        this.restoredCompositions.set(route.sessionId, { agent, dispose, revision });
     }
     injectProfileUpdate(agent, sessionId, profile) {
         const previous = this.profileVersions.get(sessionId);