@cxxl/dsh-sqlite 0.2.0 → 0.3.0

package/README.md

@@ -45,6 +45,20 @@ dsh plugin --profile web add @cxxl/dsh-sqlite
 - `to` / `from` 建议使用绝对路径
 - 部分导出时注意表间外键引用关系
 
+## 稳定触发（v1.2）
+
+插件向每个会话注入一段常驻提示词规则（约 40 token/回合）：用户要求"记住/记录/跟踪/保存"或表达"以后查/对比/统计"意图时，使用 sqlite 工具而非文本文件。规则不覆盖模型判断，最终决策权在模型。
+
+## 跨会话协作（v2）
+
+多会话并行同一任务时的对齐机制（设计见 DESIGN.md 第 15 节）：
+
+- 协作数据放**命名库**（任务名，kebab-case），同一任务的会话共用同一个命名库
+- 会话开工时自动收到**协作库清单**（含各库 meta 描述与表说明）
+- 其他会话对命名库的写入会**自动提醒**相关会话（直到你查询确认）；**新库出现会广播**
+- 库表带描述：新建协作库后先建 meta 表（label / description / table:<名>）
+- 默认库 agent.db 是个人数据区，不参与协作提醒
+
 ## 引擎
 
 Node 内置 `node:sqlite`（实验性，Node ≥ 22.5），零原生依赖；所有引擎调用隔离在 `lib/engine.js`，可整体替换为 better-sqlite3 而不动其余代码。

package/lib/engine.js

@@ -382,3 +382,19 @@ export function tablePreview(dbName, table, limit, signal) {
   })
   return { table: name, columns, rows: clean, truncated: rows.length >= cap }
 }
+
+// 读取库内 meta 约定表（label/description/table:<名> 键值对）；无表/读失败返回空对象。
+export function readDbMeta(dbName, signal) {
+  assertNotAborted(signal)
+  const { file } = dbFile(dbName)
+  if (!existsSync(file)) return {}
+  const { db } = openDb(dbName)
+  const out = {}
+  try {
+    const rows = db.prepare('SELECT key, value FROM meta').all()
+    for (const r of rows) {
+      if (r.key !== undefined && r.value !== undefined) out[String(r.key)] = String(r.value)
+    }
+  } catch { /* 无 meta 表：返回空 */ }
+  return out
+}

package/lib/index.js

@@ -1,14 +1,15 @@
 // index.js — 插件入口：注册五个工具 + 可选挂载自测。
 import { defineTool } from '@deepseek-ai/dsh-tools'
-import { CallId } from '@deepseek-ai/dsh-llm'
+import { CallId, createUserMessage } from '@deepseek-ai/dsh-llm'
 import { mkdtempSync, rmSync } from 'node:fs'
 import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 import { toolDefs } from './tools.js'
 import * as engine from './engine.js'
+import { COLLAB_RULE, createCoordination, frame, onPostExecute, preStepTexts } from './coordination.js'
 
 export const name = '@cxxl/dsh-sqlite'
-export const inject = ['tools', 'webServer']
+export const inject = ['tools', 'webServer', 'systemPrompt']
 
 function sendJson(res, code, payload) {
   const body = JSON.stringify(payload)
@@ -67,12 +68,59 @@ function registerPanelRoutes(ctx) {
   }, 'dsh-sqlite panel routes')
 }
 
+// v1.2：常驻短规则注入——把"持久化场景 → sqlite 工具"的触发率推向接近确定。
+// 机制依据：官方 dsh-plan-mode 的 systemPrompt.section 先例（DESIGN.md 第 14 节）。
+function registerPersistenceRule(ctx) {
+  const dispose = ctx.systemPrompt.section({
+    name: 'dsh-sqlite:persistence-rule',
+    order: 1000,
+    text: '持久化规则：当用户要求记住、记录、跟踪、保存结构化数据，或表达"以后还要查/对比/统计"的意图时，使用 sqlite_exec（写）与 sqlite_query（读）工具，不要用普通文本文件替代数据库；不确定库里有什么时先调 sqlite_tables。' + COLLAB_RULE,
+  })
+  console.log('[dsh-sqlite] persistence rule section registered (order 1000)')
+  ctx.effect(() => dispose, 'dsh-sqlite persistence rule')
+}
+
+// v2：跨会话协作感知（DESIGN.md 第 15 节）。观察者语义：绝不修改执行链路。
+function registerCoordination(ctx) {
+  const coord = createCoordination()
+  const names = new Set()
+  try {
+    for (const f of engine.listDbFiles()) {
+      if (f.name !== 'agent.db') names.add(f.name.replace(/\.db$/, ''))
+    }
+  } catch { /* 启动快照失败则按空处理 */ }
+  coord.knownDbs = names
+
+  ctx.on('tools/post-execute', (exec, result, next) => {
+    try { onPostExecute(coord, exec, result) } catch { /* 观察者绝不抛 */ }
+    return next()
+  })
+
+  ctx.on('agent/pre-step', async (payload, next) => {
+    const decision = await next()
+    if (decision === undefined || decision.kind === 'reject') return decision
+    try {
+      const texts = preStepTexts(coord, payload.agent, engine)
+      if (texts.length === 0) return decision
+      const msgs = texts.map((text) => createUserMessage({
+        content: [{ type: 'text', text: frame(text) }],
+        source: { kind: 'plugin', plugin: 'dsh-sqlite' },
+      }))
+      return { ...decision, messages: [...msgs, ...decision.messages] }
+    } catch {
+      return decision
+    }
+  })
+}
+
 export function apply(ctx) {
   for (const key of Object.keys(toolDefs)) {
     ctx.tools.register(defineTool(toolDefs[key]))
   }
   ctx.effect(() => () => engine.closeAll())
   registerPanelRoutes(ctx)
+  registerPersistenceRule(ctx)
+  registerCoordination(ctx)
 
   // 挂载自测：DSH_PLUGIN_SELFTEST=1 时在临时数据目录跑一遍真实执行管线。
   if (process.env.DSH_PLUGIN_SELFTEST === '1') void selfTest(ctx)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cxxl/dsh-sqlite",
-  "version": "0.2.0",
-  "description": "DSH plugin: persistent SQLite tools for the agent (sqlite_query / sqlite_exec / sqlite_tables / sqlite_export / sqlite_import) plus a read-only table browser settings page — zero runtime deps beyond Node 22 node:sqlite.",
+  "version": "0.3.0",
+  "description": "DSH plugin: persistent SQLite tools for the agent (sqlite_query / sqlite_exec / sqlite_tables / sqlite_export / sqlite_import), a read-only table browser settings page, and a persistence-usage prompt rule — zero runtime deps beyond Node 22 node:sqlite.",
   "type": "module",
   "main": "lib/index.js",
   "exports": {