dsh-lost-and-found 0.1.1 → 0.1.3

package/README.md

@@ -90,7 +90,9 @@ Requires DSH with the web profile and Node.js `^22` or `>=24`. Windows-focused
 
 ## 环境要求
 
-- DSH，使用 `web` profile
+- DSH **0.1.7 或更高**，使用 `web` profile
+  （设置页依赖 0.1.7 才有的 `configForms` 客户端服务与 `Config` 导出契约。更早的 0.1.x 上
+  **host 功能仍然可用** —— 扫描、检索、工具调用都不受影响 —— 但设置页不会出现）
 - Node.js `^22` 或 `>=24`（用到内置 `node:sqlite`）
 - 无需 API key、无需联网；扫描与检索全部在本机完成
 
@@ -122,7 +124,7 @@ dsh plugin --profile web add link:/path/to/dsh-lost-and-found
 | --- | --- | --- |
 | `enabled` | `true` | 关闭后不再自动扫描，也不再提供找文件工具 |
 | `roots` | `[]` | 要监视的目录，每个目录带自己的 `policy` |
-| `dbPath` | 空 | 索引库位置；留空用 `%LOCALAPPDATA%\dsh-lost-and-found\index.db` |
+| `dbPath` | 空 | 索引库位置；留空用 `%LOCALAPPDATA%\dsh-lost-and-found\index.db`。可以填**文件**路径，也可以直接填**文件夹**（会用该文件夹下的 `index.db`） |
 | `intervalDays` | `1` | 自动扫描间隔；`0` = 只手动 |
 | `firstScanMode` | `full` | 一个目录**第一次**被扫时收多久：`full` 全部历史 / `window` 最近 `firstRunWindowDays` 天 / `none` 只收今后新增 |
 | `firstRunWindowDays` | `7` | 仅当 `firstScanMode = window` 时生效 |
@@ -132,6 +134,18 @@ dsh plugin --profile web add link:/path/to/dsh-lost-and-found
 | `backupKeep` | `7` | 每日备份保留份数，`0` = 不备份 |
 | `extraExcludeDirs` / `extraExcludePatterns` | `[]` | 追加的排除目录名 / 路径片段（`re:` 前缀表示正则） |
 
+### 配置存在哪（DSH 0.1.7 起）
+
+DSH 0.1.7 起，设置服务**不再替插件另存一份配置** —— 它只把 Loader 里本插件条目的
+`Config` *投影*成表单，权威值始终在 profile 的补丁文件里：
+
+- 设置页里改的值会写进 `$DSH_HOME/profiles/web/cordis.patch.yml` 中 `id: dsh-lost-and-found` 那段
+- 想手改也行，直接编辑那个文件，效果与设置页完全一致
+- **改完立刻生效，不需要重启 DSH**：0.1.7 移除了旧版的 `watch`，插件改为在**每次用到配置之前**
+  重新读一遍投影（`settings.describe()`），所以面板里加完目录就能直接点「立即扫描」
+- 从 0.1.2 升级上来的话注意：0.1.2 只在插件加载那一刻读一次配置，会表现为
+  「面板里明明加了文件夹，点扫描却说还没设置」—— 0.1.3 修的就是这个
+
 ## 扫描目录的内容深度（每个目录可不同）
 
 - **完整**：记基本信息，并允许把图片交给模型看过之后写回描述（默认）

package/client.js

@@ -45,7 +45,7 @@ window.__ModuleLoader__.load({
       policyMeta: "只记基本信息",
       storageTitle: "记录存放在哪",
       dbPath: "记忆库文件位置",
-      dbPathHint: "留空使用默认位置（在系统盘的 AppData\\Local\\dsh-lost-and-found\\index.db）。想放到别的盘就填完整路径，例如 D:\\file-index\\index.db。",
+      dbPathHint: "留空使用默认位置（在系统盘的 AppData\\Local\\dsh-lost-and-found\\index.db）。想换地方可以填文件路径，例如 D:\\file-index\\index.db；填一个文件夹也行，会用该文件夹下的 index.db。",
       freqTitle: "多久看一次",
       interval: "自动扫描间隔",
       freqHint: "打开 DSH 时会检查：距离上次扫描超过这个间隔，就自动补扫一次。",
@@ -97,7 +97,7 @@ window.__ModuleLoader__.load({
       policyMeta: "Metadata only",
       storageTitle: "Where records are stored",
       dbPath: "Database file",
-      dbPathHint: "Leave empty for the default location under AppData\\Local\\dsh-lost-and-found\\. Or give a full path such as D:\\file-index\\index.db.",
+      dbPathHint: "Leave empty for the default location under AppData\\Local\\dsh-lost-and-found\\. You can also give a file path such as D:\\file-index\\index.db, or just a folder \u2014 the index.db inside it will be used.",
       freqTitle: "How often to look",
       interval: "Automatic scan interval",
       freqHint: "When you open DSH it checks whether this interval has passed, and catches up if needed.",
@@ -323,7 +323,10 @@ window.__ModuleLoader__.load({
       ctx.effect(() => ctx.locale.register(NS, { zh, en }), "dsh-lost-and-found: dictionaries");
 
       const t = ctx.locale.bind(NS);
-      const scope = ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE });
+      // 0.1.7：`ctx.settingsScope` 已被整个移除，改为 `ctx.configForms.get(条目 id)`。
+      // 新 API 与旧 API 同名同义（getSnapshot / subscribe / set / unset / mutate），
+      // 快照结构 `{status,value,base,user,revision,writable,mode}` 也没变，所以组件体无需改动。
+      const scope = ctx.configForms.get(SETTINGS_NAMESPACE);
       // 客户端远程命名空间挂在 `remote.<namespace>` 服务上（DSH 0.1.5-rc.1 起；
       // 旧的 connection.api.* 已不存在，写它会报 reading 'sessions'）。
       // 触发斜杠命令必须走 remote.commands.execute：往会话里塞一条 "/cmd" 文本
@@ -399,7 +402,7 @@ window.__ModuleLoader__.load({
 
     module.exports = {
       name: "dsh-lost-and-found",
-      inject: ["slots", "locale", "settingsScope", "remote", "remote.commands", "sessions"],
+      inject: ["slots", "locale", "configForms", "remote", "remote.commands", "sessions"],
       apply,
     };
     return module.exports;

package/config.mjs

@@ -7,9 +7,9 @@
  *    会把一份「运行快照」写到 ~/.dsh-lost-and-found/run.json。
  *  - 用户数据目录只放运行快照/日志，索引库默认在 %LOCALAPPDATA%\dsh-lost-and-found\。
  */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { basename, join } from "node:path";
 
 /** 每个扫描目录的内容深度策略 */
 export const POLICY = Object.freeze({
@@ -120,9 +120,28 @@ export function defaultDbPath() {
   return join(base, "dsh-lost-and-found", "index.db");
 }
 
+/**
+ * 用户填的「记忆库位置」是不是一个**目录**（而不是库文件本身）？
+ * 实测坑（v0.1.3）：那一格要的是文件路径，但很自然会填成文件夹（如 `D:\findtext`），
+ * 而 `new DatabaseSync("D:\findtext")` 会直接抛 `unable to open database file` —— 扫描整个失败。
+ */
+export function isDirDbPath(p) {
+  if (/[\\/]$/.test(p)) return true;
+  try {
+    if (existsSync(p) && statSync(p).isDirectory()) return true;
+  } catch { /* 读不到就按文件名处理 */ }
+  const base = basename(p);
+  return base !== "" && !base.includes(".");
+}
+
+/**
+ * 把「记忆库位置」规整成一个**文件**路径：
+ * 空 → 默认位置；看着像目录（已存在的目录 / 以分隔符结尾 / 没有扩展名）→ 用该目录下的 index.db。
+ */
 export function resolveDbPath(config) {
   const p = (config && config.dbPath ? String(config.dbPath) : "").trim();
-  return p || defaultDbPath();
+  if (!p) return defaultDbPath();
+  return isDirDbPath(p) ? join(p.replace(/[\\/]+$/, ""), "index.db") : p;
 }
 
 /** 规整扫描目录列表：去空、去重、补默认策略 */

package/index.mjs

@@ -41,20 +41,30 @@ export const inject = ["tools", "commands"];
 const SETTINGS_NS = "dsh-lost-and-found";
 const AUTO_CHECK_THROTTLE_MS = 15 * 60 * 1000;
 
-const settingsSchema = z.object({
-  enabled: z.boolean().default(true),
-  dbPath: z.string().default(""),
-  intervalDays: z.number().min(0).max(365).default(1),
-  firstRunWindowDays: z.number().min(0).max(365).default(7),
+/**
+ * 0.1.7 设置契约：插件用**纯具名导出**的 `Config` 声明可配置项，settings 服务照着它投影出表单。
+ * 两条硬要求：
+ *   ① 不能有 `export default` —— 剥壳后会把 `Config` 一起丢掉，条目被静默过滤；
+ *   ② 每个可写字段都要标 `.volatile()`（= 「能现场改、改完不用重挂载」），否则 `volatileForm()`
+ *      返回 undefined，整个条目被 `describe()` **静默过滤**（面板消失，且不报任何错）。
+ * `.volatile()` 需要 schemastery >= 3.18.4；下面降级包装保证在老版本上仍能正常加载。
+ */
+const vol = (schema) => (typeof schema.volatile === "function" ? schema.volatile() : schema);
+
+export const Config = z.object({
+  enabled: vol(z.boolean().default(true)),
+  dbPath: vol(z.string().default("")),
+  intervalDays: vol(z.number().min(0).max(365).default(1)),
+  firstRunWindowDays: vol(z.number().min(0).max(365).default(7)),
   /** 目录首次扫描收多久：full=全部历史（默认）/ window=最近 N 天 / none=只收今后新增 */
-  firstScanMode: z.string().default("full"),
-  maxFileMB: z.number().min(0).max(10240).default(50),
-  patrolEnabled: z.boolean().default(true),
-  imageQuotaPerRun: z.number().min(0).max(500).default(20),
-  backupKeep: z.number().min(0).max(60).default(7),
-  roots: z.array(z.object({ path: z.string(), policy: z.string().default("full") })).default([]),
-  extraExcludeDirs: z.array(z.string()).default([]),
-  extraExcludePatterns: z.array(z.string()).default([]),
+  firstScanMode: vol(z.string().default("full")),
+  maxFileMB: vol(z.number().min(0).max(10240).default(50)),
+  patrolEnabled: vol(z.boolean().default(true)),
+  imageQuotaPerRun: vol(z.number().min(0).max(500).default(20)),
+  backupKeep: vol(z.number().min(0).max(60).default(7)),
+  roots: vol(z.array(z.object({ path: z.string(), policy: z.string().default("full") })).default([])),
+  extraExcludeDirs: vol(z.array(z.string()).default([])),
+  extraExcludePatterns: vol(z.array(z.string()).default([])),
 });
 
 function textTool(definition) {
@@ -105,23 +115,48 @@ export function apply(ctx, input = {}) {
   let lastAutoCheck = 0;
   let childRunning = false;
 
-  // ---------- 设置命名空间（Web 设置页读写；用户配置的唯一真相来源） ----------
-  ctx.inject(["settings"], (settingsCtx) => {
+  // ---------- 设置读取（0.1.7 契约） ----------
+  // 旧写法 `settings.register(ns, schema, {base})` + `scope.get()` + `scope.watch()` 在 0.1.7 已废：
+  // settings 服务改为**投影** Loader 里本插件条目的 `Config`（命名空间 = patch 条目的 id，即
+  // `SETTINGS_NS`），不再维护独立的值，也不再提供 watch。所以读改走 `describe()`。
+  //
+  // ⚠️ 0.1.7 实测更正（v0.1.3）：面板写入**不会**让宿主重新 apply 本插件 —— 写进去的值只落在
+  // profile 的 `cordis.patch.yml` 上，本进程内存里的 `liveConfig` 一直是加载那一刻的旧值。
+  // 后果不是「显示没跟上」这种小事，而是功能级故障：面板里刚加的扫描目录，点「立即扫描」会报
+  // 「还没设置要扫描的文件夹」；改了库位置也仍然读写旧库。所以下面所有**入口**都先过 `freshConfig()`。
+  let settingsService = null;
+
+  function syncFromSettings() {
+    if (!settingsService) return false;
     try {
-      const scope = settingsCtx.settings.register(SETTINGS_NS, settingsSchema, { base: liveConfig });
-      const resolved = scope.get();
-      if (resolved) liveConfig = { ...liveConfig, ...resolved, roots: normalizeRoots(resolved.roots) };
-      scope.watch((next) => {
-        if (!next) return;
-        liveConfig = { ...liveConfig, ...next, roots: normalizeRoots(next.roots) };
-      });
+      const row = settingsService.describe().find((it) => it && it.ns === SETTINGS_NS);
+      if (!row || row.value === undefined || row.value === null) return false;
+      liveConfig = { ...liveConfig, ...row.value, roots: normalizeRoots(row.value.roots) };
+      return true;
     } catch (err) {
-      ctx.logger.warn(`dsh-lost-and-found: 设置命名空间注册失败:${err.message}`);
+      ctx.logger.warn(`dsh-lost-and-found: 读取设置失败(继续用传入配置) - ${err.message}`);
+      return false;
     }
+  }
+
+  /**
+   * 取「当前最新」的配置：每次调用都重读一遍设置投影。
+   * 面板改完立刻生效，不需要重启 DSH（`describe()` 读的就是刚写入的权威值，纯内存操作，成本可忽略）。
+   * 所有对外入口（工具 / 斜杠命令 / 自动扫描检查）都必须先走这里，不要直接读 `liveConfig` 的闭包快照。
+   */
+  function freshConfig() {
+    syncFromSettings();
+    return liveConfig;
+  }
+
+  ctx.inject(["settings"], (settingsCtx) => {
+    settingsService = settingsCtx.settings;
+    freshConfig();
   });
 
   // ---------- 派生扫描子进程 ----------
   async function spawnScan({ trigger = "manual", wait = false, forceFull = false } = {}) {
+    freshConfig();
     if (childRunning && wait) throw new Error("已有扫描在进行中");
     if (!liveConfig.enabled) throw new Error("插件已关闭（可在设置页打开）");
     const roots = normalizeRoots(liveConfig.roots);
@@ -192,6 +227,7 @@ export function apply(ctx, input = {}) {
   // ---------- 到期自动扫描：会话一开就检查（用户选了「每天」） ----------
   function maybeAutoScan(reason) {
     try {
+      freshConfig();
       if (!liveConfig.enabled) return;
       const days = Number(liveConfig.intervalDays);
       if (!days || days <= 0) return;
@@ -241,7 +277,7 @@ export function apply(ctx, input = {}) {
       fallback: { type: "boolean", description: "索引没命中时是否实时扫描扫描目录兜底，默认 true" },
     },
     async execute(args = {}) {
-      const cfg = liveConfig;
+      const cfg = freshConfig();
       const roots = normalizeRoots(cfg.roots);
       const opts = {
         keywords: args.keywords,
@@ -318,7 +354,7 @@ export function apply(ctx, input = {}) {
       full: { type: "boolean", description: "强制全量重扫（忽略已有锚点），默认 false" },
     },
     async execute(args = {}) {
-      const cfg = liveConfig;
+      const cfg = freshConfig();
       if (!normalizeRoots(cfg.roots).length) {
         return "还没设置要扫描的文件夹。请在插件设置页点「一键扫描」或手动添加目录后再试。";
       }
@@ -351,7 +387,7 @@ export function apply(ctx, input = {}) {
     description: "查看「文件快速寻回」的概况：上次扫描时间、库内文件数、扫描目录、待处理项、野文件提示、库位置与错误。",
     parameters: {},
     async execute() {
-      const cfg = liveConfig;
+      const cfg = freshConfig();
       const dbPath = resolveDbPath(cfg);
       const { db } = openLiveDb(cfg);
       try {
@@ -429,7 +465,8 @@ export function apply(ctx, input = {}) {
     async execute(args = {}) {
       const paths = (args.paths || []).map((x) => (typeof x === "string" ? x : x && x.path)).filter(Boolean);
       if (!paths.length) return "请提供要忘掉的路径";
-      const { db } = openLiveDb(liveConfig);
+      const cfg = freshConfig();
+      const { db } = openLiveDb(cfg);
       try {
         const n = forgetPaths(db, paths);
         return `已从记忆库删除 ${n} 条记录（用户文件未被改动）。`;
@@ -445,7 +482,8 @@ export function apply(ctx, input = {}) {
     description: "手动检查一批已记录文件是否还在原处（用于清理「已经不在了」的记录）。",
     parameters: { limit: { type: "number", description: "本批检查条数，默认 500" } },
     async execute(args = {}) {
-      const { db } = openLiveDb(liveConfig);
+      const cfg = freshConfig();
+      const { db } = openLiveDb(cfg);
       try {
         const r = verifyBatch(db, Number(args.limit) || 500);
         return `检查了 ${r.checked} 个文件，其中 ${r.missing} 个已不在原处（连续两次确认后才会标记）。`;
@@ -462,8 +500,9 @@ export function apply(ctx, input = {}) {
       "取出「还没看过内容」的图片清单（供模型用 read_image 逐张看图并写描述）。返回路径+名字+时间。",
     parameters: { limit: { type: "number", description: "本次取几张，默认用配置里的看图配额" } },
     async execute(args = {}) {
-      const limit = Number(args.limit) || Number(liveConfig.imageQuotaPerRun) || 20;
-      const { db } = openLiveDb(liveConfig);
+      const cfg = freshConfig();
+      const limit = Number(args.limit) || Number(cfg.imageQuotaPerRun) || 20;
+      const { db } = openLiveDb(cfg);
       try {
         const rows = db.prepare(`
           SELECT path, name, ext, size, appeared_ms, origin FROM files
@@ -495,7 +534,8 @@ export function apply(ctx, input = {}) {
     async execute(args = {}) {
       const p = String(args.path || "").trim();
       if (!p) return "请提供图片路径";
-      const { db } = openLiveDb(liveConfig);
+      const cfg = freshConfig();
+      const { db } = openLiveDb(cfg);
       try {
         const r = db.prepare("UPDATE files SET image_desc = ?, tags = ?, enrich = 'described', last_seen_ms = ? WHERE path = ?")
           .run(String(args.description || ""), String(args.tags || ""), Date.now(), p);
@@ -514,7 +554,7 @@ export function apply(ctx, input = {}) {
       input: { hint: "扫描一次：新目录首次扫描会回填其历史文件，其余只收新增。", images: false },
       handler: async () => {
         try {
-          const roots = normalizeRoots(liveConfig.roots);
+          const roots = normalizeRoots(freshConfig().roots);
           if (!roots.length) return { kind: "error", text: "还没设置要扫描的文件夹：请在插件设置页点「一键扫描」或手动添加目录。" };
           const r = await spawnScan({ trigger: "settings", wait: true });
           if (!r.result || r.result.ok === false) {
@@ -544,7 +584,7 @@ export function apply(ctx, input = {}) {
       input: { hint: "查看上次扫描时间、库内文件数、扫描目录。", images: false },
       handler: async () => {
         try {
-          const cfg = liveConfig;
+          const cfg = freshConfig();
           const dbPath = resolveDbPath(cfg);
           const { db } = openLiveDb(cfg);
           try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-lost-and-found",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Local file recall for DeepSeek Harness: it watches the folders you choose and keeps a SQLite index of what appeared — name, type, size, appeared-at, location and origin — so \"where did I put that file?\" becomes a single question. Every folder carries its own incremental anchor, and a folder added later is backfilled in full on its first scan. Search is SQL hard filtering plus multi-keyword hit weighting, with a live fallback scan when the index has no hit. Read-only: it never modifies, moves or deletes your files. 文件快速寻回:定期扫描你指定的文件夹,把新出现的文件(名字/类型/大小/出现时间/位置/来源)记进本地 SQLite 索引,忘了东西放哪问一句就能找回。每个文件夹各有自己的增量锚点,新加入的文件夹第一次会回填全部历史;检索用 SQL 硬过滤加多关键词加权,索引没命中时当场兜底实时扫描一遍。只读,绝不修改、移动或删除你的文件。",
   "type": "module",
   "main": "index.mjs",
@@ -27,7 +27,6 @@
     "client": {
       "inject": [
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-settings"
       ],
       "platform": "web"
@@ -48,7 +47,7 @@
   },
   "devDependencies": {
     "@deepseek-ai/dsh-tools": "0.1.5-rc.1",
-    "@deepseek-ai/schemastery": "^3.18.1"
+    "@deepseek-ai/schemastery": "^3.18.4"
   },
   "engines": {
     "node": "^22.0.0 || >=24"