dsh-message-rollback 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,51 @@
-# Temporary Holding Version
+# DeepSeek Harness 消息回滚插件
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+这个插件向每条已完成的助手消息的操作栏添加“↶ 回滚”按钮。点击后可以选择：
+
+- 只回滚消息：创建一个从该消息之前截断的新会话，原会话保留。
+- 同时回滚代码更改：调用 Host 提供的 `messageRollback.rollback()`，由 Host 在同一事务中恢复消息之后的工作区快照。
+
+插件使用 Harness 的公开 UI slot：`conversation.chat.assistant-actions`。它通过当前 Session 的事件窗口把消息 ID 映射到 durable event sequence，避免依赖 DOM 结构。
+
+## 安装
+
+把本目录作为本地插件包加入 Loader 配置：
+
+```yaml
+plugins:
+  - package: ./dsh-message-rollback
+    config: {}
+```
+
+构建：
+
+```bash
+pnpm install
+pnpm run bundle
+```
+
+## 代码更改回滚的 Host 适配
+
+Harness 当前公开的 `SessionFace` 提供 fork、队列和提示词控制，但不允许 UI 插件直接改写工作区。因此“同时回滚代码更改”需要 Host 注册 `ctx.messageRollback`，或者注册较小的 `ctx.workspaceRollback`：
+
+```ts
+ctx.workspaceRollback = {
+  async rollbackTurn({ sessionId, eventSeq }) {
+    // 在 Host 侧把工作区恢复到 eventSeq 对应 turn 开始时的快照。
+  },
+};
+```
+
+如果需要让 Host 同时负责恢复工作区、创建回滚 Session 并切换当前页面，可以注册完整服务：
+
+```ts
+ctx.messageRollback = {
+  async rollback({ sessionId, messageId, includeWorkspaceChanges }) {
+    // 在 Host 侧定位消息和 turn 的快照。
+    // includeWorkspaceChanges 为 true 时恢复 turn 开始时的工作区。
+    // 然后切出/切换到回滚后的 Session。
+  },
+};
+```
+
+未注册工作区回滚能力时，勾选代码更改会给出明确提示；未勾选时插件使用公开的 `ctx.sessions.fork()` 作为安全回退，原会话不会被删除。

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: message-rollback
+      name: dsh-message-rollback

package/lib/client.d.ts

@@ -0,0 +1,7 @@
+import { i as inject } from "./index-vsThIC1E.js";
+import { Context } from "@deepseek-ai/cordis";
+
+//#region src/client/index.d.ts
+declare function apply(ctx: Context): void;
+//#endregion
+export { apply, inject };

package/lib/client.js

@@ -0,0 +1,133 @@
+import { n as inject, r as name } from "./src-_KoxvZTI.js";
+import { createElement, useMemo, useState } from "react";
+
+//#region src/client/index.tsx
+const buttonStyle = {
+	alignItems: "center",
+	background: "transparent",
+	border: 0,
+	borderRadius: 6,
+	color: "var(--dsh-color-text-secondary, #777)",
+	cursor: "pointer",
+	display: "inline-flex",
+	fontSize: 12,
+	gap: 4,
+	padding: "4px 6px"
+};
+const panelStyle = {
+	background: "var(--dsh-color-surface, Canvas)",
+	border: "1px solid var(--dsh-color-border, #ddd)",
+	borderRadius: 8,
+	boxShadow: "0 8px 24px rgb(0 0 0 / 18%)",
+	display: "grid",
+	gap: 8,
+	minWidth: 240,
+	padding: 12,
+	position: "absolute",
+	right: 0,
+	top: "calc(100% + 4px)",
+	zIndex: 20
+};
+function messageEventEntries(ctx, sessionId) {
+	return ctx.sessions.binding(sessionId)?.eventSource.getSnapshot().entries ?? [];
+}
+function findMessageSeq(ctx, sessionId, messageId) {
+	for (const entry of messageEventEntries(ctx, sessionId)) {
+		if (entry.type !== "event") continue;
+		const event = entry.event;
+		if (event.data?.message?.id === messageId) return event.seq;
+	}
+}
+async function executeRollback(ctx, sessionId, messageId, includeWorkspaceChanges) {
+	const eventSeq = findMessageSeq(ctx, sessionId, messageId);
+	if (eventSeq === void 0) throw new Error("该消息尚未出现在当前历史窗口中，请先加载更多历史。");
+	if (ctx.messageRollback) {
+		await ctx.messageRollback.rollback({
+			sessionId,
+			messageId,
+			includeWorkspaceChanges
+		});
+		return;
+	}
+	if (includeWorkspaceChanges) {
+		if (!ctx.workspaceRollback) throw new Error("当前 Host 没有提供代码更改回滚能力；请取消“同时回滚代码更改”，或安装对应的 Host 端适配。");
+		await ctx.workspaceRollback.rollbackTurn({
+			sessionId,
+			eventSeq
+		});
+	}
+	await ctx.sessions.fork({
+		sessionId,
+		atSeq: Math.max(0, eventSeq - 1),
+		increaseTitle: true
+	});
+}
+function RollbackAction({ messageId, ctx, sessionId }) {
+	const [open, setOpen] = useState(false);
+	const [includeWorkspaceChanges, setIncludeWorkspaceChanges] = useState(false);
+	const [busy, setBusy] = useState(false);
+	const [error, setError] = useState();
+	const stableMessageId = useMemo(() => String(messageId), [messageId]);
+	const submit = async (event) => {
+		event.preventDefault();
+		setBusy(true);
+		setError(void 0);
+		try {
+			await executeRollback(ctx, sessionId, stableMessageId, includeWorkspaceChanges);
+		} catch (cause) {
+			setError(cause instanceof Error ? cause.message : "回滚失败，请稍后重试。");
+		} finally {
+			setBusy(false);
+		}
+	};
+	return createElement("span", { style: { position: "relative" } }, createElement("button", {
+		type: "button",
+		title: "回滚到此消息",
+		"aria-expanded": open,
+		style: buttonStyle,
+		onClick: () => {
+			setOpen((value) => !value);
+			setError(void 0);
+		},
+		disabled: busy
+	}, "↶ 回滚"), open && createElement("form", {
+		style: panelStyle,
+		onSubmit: submit
+	}, createElement("strong", null, "回滚到此消息？"), createElement("label", { style: {
+		alignItems: "flex-start",
+		display: "flex",
+		gap: 8
+	} }, createElement("input", {
+		type: "checkbox",
+		checked: includeWorkspaceChanges,
+		onChange: (event) => setIncludeWorkspaceChanges(event.target.checked)
+	}), createElement("span", null, "同时回滚这条消息之后的代码更改")), createElement("small", { style: { color: "var(--dsh-color-text-secondary, #777)" } }, "默认会创建一个回滚后的新会话，原会话保留。"), error && createElement("div", {
+		role: "alert",
+		style: { color: "var(--dsh-color-danger, #c33)" }
+	}, error), createElement("div", { style: {
+		display: "flex",
+		gap: 8,
+		justifyContent: "flex-end"
+	} }, createElement("button", {
+		type: "button",
+		onClick: () => setOpen(false)
+	}, "取消"), createElement("button", {
+		type: "submit",
+		disabled: busy
+	}, busy ? "回滚中…" : "确认回滚"))));
+}
+function apply(ctx) {
+	ctx.slots.register({
+		name: "conversation.chat.assistant-actions",
+		id: name,
+		order: 500,
+		registrant: name
+	}, (props) => props.sessionId ? createElement(RollbackAction, {
+		...props,
+		ctx,
+		sessionId: props.sessionId
+	}) : null);
+}
+
+//#endregion
+export { apply, inject };

package/lib/index-vsThIC1E.d.ts

@@ -0,0 +1,32 @@
+import { Context } from "@deepseek-ai/cordis";
+
+//#region src/index.d.ts
+/** Host-side mutation capability consumed by the browser surface. */
+interface MessageRollbackService {
+  rollback(input: {
+    sessionId: string;
+    messageId: string;
+    includeWorkspaceChanges: boolean;
+  }): Promise<{
+    sessionId?: string;
+  }>;
+}
+/** Optional Host capability for restoring the workspace snapshot for a turn. */
+interface WorkspaceRollbackService {
+  rollbackTurn(input: {
+    sessionId: string;
+    eventSeq: number;
+  }): Promise<void>;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    messageRollback?: MessageRollbackService;
+    workspaceRollback?: WorkspaceRollbackService;
+  }
+}
+declare const name = "message-rollback";
+declare const inject: string[];
+/** The node half is intentionally small; rollback is a browser action. */
+declare function apply(_ctx: Context): void;
+//#endregion
+export { name as a, inject as i, WorkspaceRollbackService as n, apply as r, MessageRollbackService as t };

package/lib/index.d.ts

@@ -0,0 +1,2 @@
+import { a as name, i as inject, n as WorkspaceRollbackService, r as apply, t as MessageRollbackService } from "./index-vsThIC1E.js";
+export { MessageRollbackService, WorkspaceRollbackService, apply, inject, name };

package/lib/index.js

@@ -0,0 +1,3 @@
+import { n as inject, r as name, t as apply } from "./src-_KoxvZTI.js";
+
+export { apply, inject, name };

package/lib/src-_KoxvZTI.js

@@ -0,0 +1,8 @@
+//#region src/index.ts
+const name = "message-rollback";
+const inject = ["@deepseek-ai/dsh-client-ui-renderer", "@deepseek-ai/dsh-api-session-controller"];
+/** The node half is intentionally small; rollback is a browser action. */
+function apply(_ctx) {}
+
+//#endregion
+export { inject as n, name as r, apply as t };

package/package.json

@@ -1,6 +1,58 @@
 {
   "name": "dsh-message-rollback",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "DeepSeek Harness plugin that adds per-message rollback controls.",
+  "keywords": ["dsh", "dsh-plugin", "deepseek-harness", "rollback"],
+  "license": "MIT",
+  "engines": {
+    "node": ">=22",
+    "dsh": ">=0.2.0-rc.2 <0.3.0"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": { "types": "./lib/index.d.ts", "default": "./lib/index.js" },
+    "./client": { "types": "./lib/client.d.ts", "default": "./lib/client.js" }
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-api-session-controller",
+        "@deepseek-ai/dsh-client-ui-chat",
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-session"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.0.4",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "~4.0.4",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-chat": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "tsdown": "^0.15.0",
+    "typescript": "^5.6.0"
+  },
+  "files": ["lib/*.js", "lib/*.d.ts", "lib/types/**/*.d.ts", "cordis.patch.yml", "README.md"],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}