dsh-workbench-host 0.0.0-stage → 0.6.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,65 @@
1
+ /**
2
+ * 工作台本地库 schema(平台级表)。
3
+ *
4
+ * 业务表(task / tag / site 等)不在这里:它们由子插件的 migrations 创建/演进,
5
+ * 壳本身不感知任何具体业务。这样「任务记录」才能真正装/卸。
6
+ */
7
+ export const SCHEMA_SQL = `
8
+ PRAGMA journal_mode=WAL;
9
+
10
+ CREATE TABLE IF NOT EXISTS meta (
11
+ k TEXT PRIMARY KEY, v TEXT NOT NULL
12
+ );
13
+
14
+ -- 通用变更日志:写事务内追加;未推送尾部即待同步队列
15
+ CREATE TABLE IF NOT EXISTS sync_change_log (
16
+ seq INTEGER PRIMARY KEY AUTOINCREMENT,
17
+ table_name TEXT NOT NULL,
18
+ row_id TEXT NOT NULL,
19
+ op TEXT NOT NULL,
20
+ payload TEXT,
21
+ origin TEXT NOT NULL,
22
+ updated_at INTEGER NOT NULL
23
+ );
24
+
25
+ -- 冲突展示(LWW 输方的版本留档,绝不静默吞数据)
26
+ CREATE TABLE IF NOT EXISTS conflict_shadow (
27
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
28
+ table_name TEXT NOT NULL,
29
+ row_id TEXT NOT NULL,
30
+ kind TEXT NOT NULL DEFAULT 'pull',
31
+ resolution TEXT NOT NULL DEFAULT 'server',
32
+ local_payload TEXT,
33
+ server_payload TEXT,
34
+ server_updated_at INTEGER,
35
+ local_updated_at INTEGER,
36
+ resolved_at INTEGER NOT NULL
37
+ );
38
+ CREATE INDEX IF NOT EXISTS idx_conflict_resolved ON conflict_shadow(resolved_at);
39
+
40
+ -- 单行/单表连续失败的死信;不阻塞其他表同步
41
+ CREATE TABLE IF NOT EXISTS sync_dead_letter (
42
+ id INTEGER PRIMARY KEY AUTOINCREMENT,
43
+ table_name TEXT NOT NULL,
44
+ row_id TEXT NOT NULL,
45
+ op TEXT NOT NULL,
46
+ payload TEXT,
47
+ error TEXT NOT NULL,
48
+ attempts INTEGER NOT NULL DEFAULT 1,
49
+ created_at INTEGER NOT NULL,
50
+ updated_at INTEGER NOT NULL
51
+ );
52
+ CREATE INDEX IF NOT EXISTS idx_dead_letter_table ON sync_dead_letter(table_name, row_id);
53
+
54
+ -- 同步水位/账号绑定/时钟/最后状态。v 用 TEXT 存储,兼容旧库的 INTEGER 亲和性。
55
+ CREATE TABLE IF NOT EXISTS sync_state (
56
+ k TEXT PRIMARY KEY, v TEXT NOT NULL
57
+ );
58
+
59
+ -- 会话级记录模式:只影响本机当前会话,不参与同步/备份。
60
+ CREATE TABLE IF NOT EXISTS session_mode (
61
+ session_id TEXT PRIMARY KEY,
62
+ enabled INTEGER NOT NULL DEFAULT 0,
63
+ updated_at INTEGER NOT NULL
64
+ );
65
+ `;
package/lib/index.js ADDED
@@ -0,0 +1,338 @@
1
+ /**
2
+ * dsh-workbench:个人工作台 DSH 宿主插件。
3
+ *
4
+ * 只负责平台能力:本地 SQLite、账号/同步、HTTP 桥、SSE、Workbench 工具、
5
+ * 业务域注册中心。任务/标签/站点是独立的 DSH 插件,通过 ctx.workbench
6
+ * 注册自己的 action 与视图,宿主不 import 它们。
7
+ *
8
+ * 契约要点(已验证):named export name/inject/apply;绝不 default export
9
+ * (cordis-plugin-loader unwrapExports 优先取 exports.default,裸函数会丢具名 inject)。
10
+ */
11
+ import { homedir } from "node:os";
12
+ import { readFileSync, writeFileSync, mkdirSync, existsSync, rmSync } from "node:fs";
13
+ import { join } from "node:path";
14
+ import { openDb, setSyncStateText } from "./core/index.js";
15
+ import { SyncClock, } from "./sync/sync.js";
16
+ import { AuditLog } from "./infra/audit.js";
17
+ import { createActions } from "./actions/actions.js";
18
+ import { installNetwork } from "./infra/network.js";
19
+ export const name = "dsh-workbench";
20
+ export const inject = ["webServer", "tools", "connection"];
21
+ /** 本地库与云端配置路径(05 文档约定目录)。 */
22
+ const WB_HOME = process.env.WB_HOME ?? join(homedir(), ".dsh", "workbench");
23
+ const CLOUD_DEFAULT = process.env.WB_CLOUD_URL ?? "http://127.0.0.1:8791";
24
+ /** 宿主 API 版本:业务插件用它做兼容判断。 */
25
+ export const SHELL_VERSION = "0.6.5";
26
+ const DOMAIN_ID_RE = /^[a-z][a-z0-9_-]{2,63}$/;
27
+ const ACTION_RE = /^[a-z][a-z0-9_-]*(?:\.[a-z][a-z0-9_-]*)+$/i;
28
+ function loadCreds() {
29
+ try {
30
+ return JSON.parse(readFileSync(join(WB_HOME, "cloud-creds.json"), "utf8"));
31
+ }
32
+ catch {
33
+ return null;
34
+ }
35
+ }
36
+ function saveCreds(creds) {
37
+ mkdirSync(WB_HOME, { recursive: true });
38
+ if (creds) {
39
+ writeFileSync(join(WB_HOME, "cloud-creds.json"), JSON.stringify(creds), { mode: 0o600 });
40
+ }
41
+ else if (existsSync(join(WB_HOME, "cloud-creds.json"))) {
42
+ rmSync(join(WB_HOME, "cloud-creds.json"));
43
+ }
44
+ }
45
+ /** 会话记录模式:只影响当前会话,不参与同步/备份。 */
46
+ function sessionModeOf(db, sessionId) {
47
+ try {
48
+ const row = db.prepare("SELECT enabled FROM session_mode WHERE session_id = ?").get(sessionId);
49
+ return !!row && Number(row.enabled) === 1;
50
+ }
51
+ catch {
52
+ return false;
53
+ }
54
+ }
55
+ function setSessionMode(db, sessionId, enabled, now) {
56
+ db.prepare("INSERT INTO session_mode(session_id, enabled, updated_at) VALUES(?, ?, ?) " +
57
+ "ON CONFLICT(session_id) DO UPDATE SET enabled = excluded.enabled, updated_at = excluded.updated_at").run(sessionId, enabled ? 1 : 0, now);
58
+ }
59
+ const RECORD_COMMAND_HELP = [
60
+ "用法:/record on|off|status",
61
+ "",
62
+ "/record on 开启本会话的记录模式",
63
+ "/record off 关闭本会话的记录模式",
64
+ "/record status 查看当前状态",
65
+ "",
66
+ "记录模式下,我只把完成的可交付内容记成任务、站点或标签;",
67
+ "不记录聊天、日志、临时笔记、密钥和本地地址。",
68
+ ].join("\n");
69
+ function recordPrompt(sessionId) {
70
+ return [
71
+ "## 个人工作台账:记录模式",
72
+ "",
73
+ "本会话已开启记录模式。完成本轮主要任务后,如果产生了可复用的交付物,请顺手记到个人工作台;这只是收尾动作,不能打断或改变主任务。",
74
+ "",
75
+ "记录流程:",
76
+ "1. 先调用 Workbench,action 为 capabilities.list;需要某个域的字段细节时用 capabilities.get,再按需 actions.help。",
77
+ "2. 只记录同时满足 when 且不满足 notFor 的内容;没有命中就不写,不要为了有记录而凑数。",
78
+ "3. 用对应 records[].primaryAction 写入,不要猜 action 名。任务创建前先 tasks.capabilities / tasks.resolveTable,明确选择 tableId 或 tablePath;capabilities.get 中的有效显式映射优先,不按第一项自动选。",
79
+ "4. 写入前查重:任务先 tasks.list(titleKey),站点先 sites.list,标签先 tags.list / tags.search。已存在就复用并补关联,不重复创建。",
80
+ "5. 只新增,不修改、不删除工作台已有数据。",
81
+ "6. 任务回执必须保留完整目录路径、表名和任务 id,并提示可纠正归属;多条可简洁合并,但不能省略归属。失败只提示一次,不得当成成功,不阻塞主任务。",
82
+ "7. plan mode 下不要写入。",
83
+ "",
84
+ "记录边界:",
85
+ "- 任务:已完成的可交付项,或明确的下一步;不记纯问答、一次性查询、模糊想法。",
86
+ "- 站点:以后还会访问的外部站点;排除 localhost、127.0.0.1、内网地址、临时页、搜索结果页。",
87
+ "- 标签:可复用的主题分类;不记一次性描述、状态词、日期。",
88
+ "- 不记录聊天内容、日志、临时笔记、token/密钥/密码,以及用户明确拒绝记录的内容。",
89
+ "- 模式只作用于当前会话,不自动传给子 agent。",
90
+ "",
91
+ "去重键:任务用 dsh-session:" + sessionId + ":<稳定 slug>,每个条目一个键,不要整个会话共用一个键。",
92
+ "当前会话:" + sessionId,
93
+ ].join("\n");
94
+ }
95
+ export function apply(ctx) {
96
+ const state = { db: openDb(join(WB_HOME, "workbench.db")), creds: loadCreds(), cloudUrl: CLOUD_DEFAULT };
97
+ const subscribers = new Set();
98
+ const domains = new Map();
99
+ const clock = new SyncClock();
100
+ const emit = (event, data) => {
101
+ for (const s of subscribers) {
102
+ try {
103
+ s(event, data);
104
+ }
105
+ catch {
106
+ /* 单个订阅者断开不影响其他订阅者 */
107
+ }
108
+ }
109
+ };
110
+ const log = (...args) => console.warn("[dsh-workbench]", ...args);
111
+ // 审计日志:本机行为账本;表初始化与过期清理失败都不应影响宿主启动。
112
+ const audit = new AuditLog(state.db, () => clock.now());
113
+ try {
114
+ audit.ensureSchema();
115
+ audit.prune();
116
+ }
117
+ catch (e) {
118
+ log("审计日志初始化失败", e);
119
+ }
120
+ function publicInfo(rec) {
121
+ return {
122
+ id: rec.def.id,
123
+ title: rec.def.title,
124
+ description: rec.def.description,
125
+ version: rec.def.version,
126
+ enabled: rec.error === null,
127
+ error: rec.error,
128
+ tables: rec.def.tables ?? [],
129
+ views: rec.def.views ?? [],
130
+ sync: {
131
+ tables: rec.def.sync?.tables?.map((t) => ({ name: t.name, mode: t.mode })) ??
132
+ (rec.def.tables ?? []).map((name) => ({ name, mode: "row" })),
133
+ },
134
+ backup: {
135
+ export: typeof rec.def.exportData === "function",
136
+ import: typeof rec.def.importData === "function",
137
+ },
138
+ };
139
+ }
140
+ function registerAction(rec, action, def) {
141
+ if (!ACTION_RE.test(action)) {
142
+ throw new Error("非法 action 名(应形如 tasks.list):" + action);
143
+ }
144
+ rec.actions.set(action, def);
145
+ }
146
+ function registerDomain(def) {
147
+ if (!def || !DOMAIN_ID_RE.test(String(def.id || ""))) {
148
+ log("registerDomain 非法 id", def && def.id);
149
+ return () => { };
150
+ }
151
+ if (domains.has(def.id)) {
152
+ log("业务域已注册,忽略重复注册", def.id);
153
+ return () => { };
154
+ }
155
+ const rec = { def, actions: new Map(), error: null, dispose: null };
156
+ domains.set(def.id, rec);
157
+ const setupApi = {
158
+ addon: { id: def.id, version: def.version, dir: "" },
159
+ db: state.db,
160
+ shellVersion: SHELL_VERSION,
161
+ hasDomain: (id) => domains.has(id),
162
+ hasAddon: (id) => domains.has(id),
163
+ action: (name, actionDef) => registerAction(rec, name, actionDef),
164
+ tool: (name, actionDef) => registerAction(rec, name, actionDef),
165
+ emit: (event, data) => emit("domain-event", { domainId: def.id, event, data: data ?? null }),
166
+ now: () => clock.now(),
167
+ markSyncDirty: (table) => {
168
+ if (table)
169
+ setSyncStateText(state.db, "dirty:" + def.id + ":" + table, String(clock.now()));
170
+ },
171
+ log: (...args) => log("[" + def.id + "]", ...args),
172
+ };
173
+ try {
174
+ const result = def.setup?.(setupApi);
175
+ if (result && typeof result.then === "function") {
176
+ void result
177
+ .then((dispose) => {
178
+ if (typeof dispose === "function")
179
+ rec.dispose = dispose;
180
+ emit("domains-changed", listDomains());
181
+ })
182
+ .catch((e) => {
183
+ rec.error = String((e && e.message) || e);
184
+ log("业务域异步初始化失败", def.id, e);
185
+ emit("domains-changed", listDomains());
186
+ });
187
+ }
188
+ else if (typeof result === "function") {
189
+ rec.dispose = result;
190
+ }
191
+ }
192
+ catch (e) {
193
+ rec.error = String((e && e.message) || e);
194
+ log("业务域初始化失败", def.id, e);
195
+ }
196
+ emit("domains-changed", listDomains());
197
+ return () => {
198
+ const live = domains.get(def.id);
199
+ if (live !== rec)
200
+ return;
201
+ try {
202
+ rec.dispose?.();
203
+ }
204
+ catch (e) {
205
+ log("业务域清理失败", def.id, e);
206
+ }
207
+ domains.delete(def.id);
208
+ emit("domains-changed", listDomains());
209
+ };
210
+ }
211
+ function listDomains() {
212
+ return [...domains.values()].map(publicInfo);
213
+ }
214
+ function backupDomains() {
215
+ return [...domains.values()].map((rec) => ({ def: rec.def, enabled: rec.error === null, error: rec.error }));
216
+ }
217
+ const { invoke, actionNames, installTool, schemaSnapshot } = createActions({ domains, SHELL_VERSION, publicInfo, audit, clock, emit, db: state.db });
218
+ const host = {
219
+ db: state.db,
220
+ shellVersion: SHELL_VERSION,
221
+ registerDomain,
222
+ hasDomain: (id) => domains.has(id),
223
+ listDomains,
224
+ invoke,
225
+ actionNames,
226
+ emit,
227
+ log,
228
+ };
229
+ ctx.provide?.("workbench", host);
230
+ // ── 会话记录模式:命令开关 + 动态 prompt section + 客户端 HTTP 状态 ──
231
+ const trackOn = (scope, dispose) => {
232
+ if (typeof dispose === "function" && typeof scope.effect === "function")
233
+ scope.effect(() => dispose);
234
+ };
235
+ const installService = (deps, fn) => {
236
+ if (typeof ctx.inject === "function") {
237
+ try {
238
+ ctx.inject(deps, fn);
239
+ return;
240
+ }
241
+ catch (e) {
242
+ log("注入服务失败", deps.join(","), e);
243
+ }
244
+ }
245
+ try {
246
+ fn(ctx);
247
+ }
248
+ catch (e) {
249
+ log("安装会话记录模式失败", deps.join(","), e);
250
+ }
251
+ };
252
+ installService(["systemPrompt"], (scope) => {
253
+ const sp = scope.systemPrompt;
254
+ if (!sp || typeof sp.section !== "function")
255
+ return;
256
+ let order = 510;
257
+ try {
258
+ order = sp.getSectionOrder("PLAN_POLICY") + 10;
259
+ }
260
+ catch {
261
+ /* 老版本没有命名 order 时退回 510 */
262
+ }
263
+ const dispose = sp.section({
264
+ name: "workbench:record-mode",
265
+ order,
266
+ text: (context) => {
267
+ const sid = String(context?.agent?.session?.id ?? context?.agent?.id ?? "");
268
+ return sid && sessionModeOf(state.db, sid) ? recordPrompt(sid) : "";
269
+ },
270
+ });
271
+ trackOn(scope, dispose);
272
+ });
273
+ installService(["commands"], (scope) => {
274
+ const commands = scope.commands;
275
+ if (!commands || typeof commands.register !== "function")
276
+ return;
277
+ const dispose = commands.register({
278
+ name: "record",
279
+ description: "开启或关闭本会话的个人工作台记录模式",
280
+ input: { hint: "[on|off|status]" },
281
+ handler: ({ agent, rawInput }) => {
282
+ const sid = String(agent?.session?.id ?? agent?.id ?? "");
283
+ if (!sid)
284
+ return { kind: "error", text: "无法确定当前会话,记录模式没有变化。" };
285
+ const arg = String(rawInput ?? "").trim().toLowerCase();
286
+ if (arg === "on" || arg === "off") {
287
+ const enabled = arg === "on";
288
+ setSessionMode(state.db, sid, enabled, clock.now());
289
+ emit("record-mode", { sessionId: sid, enabled });
290
+ return {
291
+ kind: "success",
292
+ text: enabled
293
+ ? "记录模式已开启(仅本会话)。后续我只把完成的可交付内容记到工作台,不记聊天、日志、密钥和本地地址。"
294
+ : "记录模式已关闭。之后只有你明确说“记一下”时,我才会写入工作台。",
295
+ };
296
+ }
297
+ if (arg === "status") {
298
+ const enabled = sessionModeOf(state.db, sid);
299
+ return {
300
+ kind: "success",
301
+ text: enabled
302
+ ? "记录模式:已开启(仅本会话)。\n只记录完成的可交付项;不记聊天、日志、临时笔记、密钥和本地地址。关闭用 /record off。"
303
+ : "记录模式:未开启。\n开启用 /record on;开启后我只记录完成的可交付内容。",
304
+ };
305
+ }
306
+ return { kind: "success", text: RECORD_COMMAND_HELP };
307
+ },
308
+ });
309
+ trackOn(scope, dispose);
310
+ });
311
+ const { runSync } = installNetwork({ ctx, state, saveCreds, clock, domains, emit, subscribers, listDomains, SHELL_VERSION, sessionModeOf, setSessionMode, audit, backupDomains, actionNames, invoke, log, schemaSnapshot });
312
+ installTool(ctx);
313
+ // ── 后台同步循环:30s 周期;登录后立即一轮;离线静默 ──
314
+ let timer;
315
+ const startLoop = () => {
316
+ if (timer)
317
+ clearInterval(timer);
318
+ timer = setInterval(() => {
319
+ if (!state.creds)
320
+ return;
321
+ void runSync().catch((e) => log("后台同步失败", String((e && e.message) || e)));
322
+ }, 30_000);
323
+ };
324
+ startLoop();
325
+ ctx.effect?.(() => () => {
326
+ if (timer)
327
+ clearInterval(timer);
328
+ for (const rec of domains.values()) {
329
+ try {
330
+ rec.dispose?.();
331
+ }
332
+ catch {
333
+ /* ignore */
334
+ }
335
+ }
336
+ domains.clear();
337
+ }, "wb-sync-loop");
338
+ }