dsh-obsidian-memo 0.16.3

package/lib/shared.js

@@ -0,0 +1,309 @@
+/**
+ * dsh-obsidian-memo —— Host/Client 共享常量。
+ *
+ * 这里只放纯数据（无 Node 依赖），方便单独测试，也方便与浏览器半对齐。
+ * @module dsh-obsidian-memo/shared
+ */
+
+/** 包内 RPC 通道名（/^\/[A-Za-z0-9._~-]+$/）。 */
+export const CHANNEL = '/sticky-notes'
+
+/** 客户端 locale 命名空间。 */
+export const NS = 'sticky-notes'
+
+export const DEFAULT_IMAGE_COMPRESSION = { enabled: true, quality: 70, maxDimension: 2048 }
+
+export function normalizeImageCompression(raw) {
+  const source = raw && typeof raw === 'object' ? raw : {}
+  const number = (value, fallback, min, max) => typeof value !== 'number' || !Number.isFinite(value)
+    ? fallback : Math.min(max, Math.max(min, Math.round(value)))
+  return {
+    enabled: source.enabled !== false,
+    quality: number(source.quality, 70, 1, 100),
+    maxDimension: number(source.maxDimension, 2048, 256, 8192),
+  }
+}
+
+/**
+ * 卡片淡色板：索引 0 是"无 tag"的纸白，其余按 tag 稳定分配。
+ * 0.13：日间纸色整体往白里调（用户反馈"日间卡片颜色更淡/更偏白"）；深色纸不变。
+ */
+export const CARD_PALETTE = [
+  { name: '纸白', color: '#FDFAF4', dark: '#2C2721' },
+  { name: '苔绿', color: '#F5F9F4', dark: '#232B24' },
+  { name: '杏', color: '#FDF7F3', dark: '#2E2622' },
+  { name: '雾蓝', color: '#F4F8FC', dark: '#222A33' },
+  { name: '藕荷', color: '#FAF5FA', dark: '#2A242C' },
+  { name: '米', color: '#FAF8F2', dark: '#2B2822' },
+  { name: '胭脂', color: '#FDF5F6', dark: '#2E2426' },
+  { name: '青瓷', color: '#F5F9F7', dark: '#222C29' },
+]
+
+/** 允许的 callout 类型（Obsidian 内置）。 */
+export const CALLOUT_TYPES = [
+  'note', 'abstract', 'info', 'todo', 'tip', 'success', 'question',
+  'warning', 'failure', 'danger', 'bug', 'example', 'quote',
+]
+
+/**
+ * 0.13 的四个默认 AI 评论人格（设置里可改、可增删）。
+ * 设计目标：四枚要有鲜明差异，而不是四种"正确答案"。
+ *  - 😈 毒舌：尖锐黑色幽默，好笑、像金句，但不为刻薄而刻薄；
+ *  - ✨ 另一面：从没想过的角度切入 + 人文关怀，让人被看见；
+ *  - 🧭 落地：务实判断，证据链 + 最省力下一步，惜字如金；
+ *  - 😇 真心话：贴心伙伴，给回信心与一个轻起手。
+ */
+export const DEFAULT_EMOJIS = [
+  {
+    id: 'devil',
+    emoji: '😈',
+    label: '毒舌',
+    callout: 'quote',
+    prompt: `你是一个嘴毒但心热的老朋友。读这张便签，先挑出它最荒诞、最值得被调侃的那一点，用一句真正好笑的黑色幽默点破——要妙、要像金句，不要为了刻薄而硬造段子。笑完，再用一两句说出真正该看清的事。
+
+规则：
+- 如果这是专业问题（医疗、法律、财务、工程、安全等），玩笑之后必须提醒对方去找专业人士，不要给结论性建议；
+- 如果这是写作或创作，收起毒舌，换成"大哥"的口吻：直接讲一句对他写作真正有用的话；
+- 不堆表情、不人身攻击、不说教。中文，120 字以内。`,
+  },
+  {
+    id: 'another',
+    emoji: '✨',
+    label: '另一面',
+    callout: 'abstract',
+    prompt: `先放下便签作者自己的视角，从一件他完全没提过的东西切入——另一个人的处境、十年后的自己、一个看似无关的领域——给出一个他大概率没想过的角度。
+
+然后回到人本身：这句话背后可能藏着的情绪、在意或疲惫，用一两句轻轻说中，让他觉得被看见、被理解。
+
+要求：
+- 角度必须具体、能接着往下想，不要说"换个角度想"这种空话；
+- 不空洞共情（不要"我理解你""抱抱"），不喊口号，不强行升华；
+- 中文，130 字以内。`,
+  },
+  {
+    id: 'grounded',
+    emoji: '🧭',
+    label: '落地',
+    callout: 'info',
+    prompt: `你是一个干练、务实的落地顾问，惜字如金。读这张便签，只给能直接影响行动的判断：
+
+1）一句话结论：这事该不该做、值不值得推进；
+2）证据链：2–3 条最有分量的事实或高置信推测，明确标出哪些是推测、以及推断依据；
+3）最省力的下一步：一个具体动作，加一个能判断是否走通的验证信号。
+
+禁止：罗列"我分析了/我查了"式的工作量，把常识当洞察，说"要重视/要规划"这类空话，列超过 3 个并列点。信息不足就直说缺哪一条关键信息，不要猜。中文，120 字以内。`,
+  },
+  {
+    id: 'truth',
+    emoji: '😇',
+    label: '真心话',
+    callout: 'success',
+    prompt: `你是那个会说真话、也永远站在他这边的伙伴。读这张便签：
+- 先接住他此刻的状态，要具体，不要套话；
+- 再指出这件事里他已经做对的一个小地方，要真、要具体；
+- 最后给一句不带压力的鼓励，和一个几乎不费力的起手动作，让他愿意继续。
+
+语气舒服、松弛，像深夜聊天；可以幽默，但不要鸡汤，不夸张，不替他承诺结果。中文，100 字以内。`,
+  },
+]
+
+/**
+ * 0.11 及更早的默认四枚评论 emoji（原样保留，供设置迁移判断）。
+ * 只有当用户的 emojis 与这份默认值**完全一致**时才自动换成 0.13 默认值，
+ * 用户改过的预设一律不碰。
+ */
+export const LEGACY_EMOJIS = [
+  {
+    id: 'insight',
+    emoji: '🔍',
+    label: '洞察',
+    callout: 'quote',
+    prompt: '你在读一张 Obsidian 便签。找出这条想法里 2–3 个最值得继续追的具体线索、隐含前提或盲点，不要复述原文，不要客套。中文，120 字以内。',
+  },
+  {
+    id: 'extend',
+    emoji: '💡',
+    label: '延伸',
+    callout: 'tip',
+    prompt: '给一个能把这想法往前推一步的具体做法、变体或例子，必须具体到能动手，不要泛泛而谈。中文，120 字以内。',
+  },
+  {
+    id: 'risk',
+    emoji: '⚠️',
+    label: '风险',
+    callout: 'warning',
+    prompt: '指出这条想法最大的风险、隐藏假设或最容易失败的地方，并给一句判断依据。中文，120 字以内。',
+  },
+  {
+    id: 'next',
+    emoji: '✅',
+    label: '下一步',
+    callout: 'success',
+    prompt: '给出一个今天就能动手的最小下一步，必须是具体动作。中文，80 字以内。',
+  },
+]
+
+/** 旧默认预设是否为原样未改（id / emoji / label / callout / prompt 全一致）。 */
+export function isLegacyDefaultEmojis(emojis) {
+  if (!Array.isArray(emojis) || emojis.length !== LEGACY_EMOJIS.length) return false
+  return emojis.every((item, index) => {
+    if (!isPlainObject(item)) return false
+    const legacy = LEGACY_EMOJIS[index]
+    return item.id === legacy.id
+      && item.emoji === legacy.emoji
+      && item.label === legacy.label
+      && item.callout === legacy.callout
+      && item.prompt === legacy.prompt
+  })
+}
+
+/** 默认"开档"建档提示词：只输出 Markdown 正文。 */
+export const DEFAULT_PROJECT_PROMPT = `你在帮我把一张「进行时」便签开档成可持续推进的项目文档。
+只输出 Markdown 正文，不要输出 YAML frontmatter，不要包在代码围栏里。结构固定：
+
+# 项目名（从便签里提炼，不超过 20 字）
+> [!abstract] 一句话定位
+
+## 诉求
+## 现状与已知
+## 调查与线索
+## 下一步（3 条以内）
+## 待确认的问题
+
+要求：信息只能来自便签内容；不确定的东西写进「待确认的问题」，不要编造；用简洁中文；每个小节 1–3 句或 1–3 条，不要空话。`
+
+const MAX_FILE_BYTES = 2 * 1024 * 1024
+const CAPTURE_TOTAL_BYTES = 16 * 1024 * 1024
+// JSON 的控制字符最坏扩展为六字节（\u0001）；另留路径与信封空间。
+const NOTE_REQUEST_BYTES = MAX_FILE_BYTES * 6 + 64 * 1024
+
+/** Host 侧读取/写入上限。 */
+export const LIMITS = {
+  maxFileBytes: MAX_FILE_BYTES,
+  noteNameBytes: 240, // 新建 / 编辑改名共用的文件名上限（UTF-8 字节）
+  captureImages: 8,
+  captureImageBytes: 8 * 1024 * 1024,
+  captureTotalBytes: CAPTURE_TOTAL_BYTES,
+  // 压缩开启时允许的原始图片上限（客户端在压缩前校验，避免超大图解码爆内存）。
+  captureSourceImageBytes: 32 * 1024 * 1024,
+  captureSourceTotalBytes: 64 * 1024 * 1024,
+  noteRequestBytes: NOTE_REQUEST_BYTES,
+  captureRequestBytes: Math.ceil(CAPTURE_TOTAL_BYTES / 3) * 4 + NOTE_REQUEST_BYTES,
+  maxDepth: 5,
+  summaryComments: 6,
+  fullComments: 30,
+  scanComments: 200, // 扫描时为 commentKinds 解析的评论条数上限（覆盖"全部评论"的典型场景）
+  commentText: 2000,
+  excerpt: 360,
+  blocks: 200,
+  blockText: 2000,
+  llmCommentChars: 4000,
+  llmProjectChars: 24_000,
+  llmInputChars: 12_000,
+  projectNameChars: 60,
+  emojis: 12,
+  cardImages: 3, // 卡片缩略图最多下发几张（第 4 张起只给数量）
+  cardImageMaxBytes: 1_500_000, // 卡片缩略图读取上限，超过就不加载（阅读模式仍可看原图）
+  jobsTtlMs: 2 * 60 * 1000,
+  undoTtlMs: 10 * 60 * 1000,
+}
+
+/** 把字节数渲染成人类可读的上限文案；Host 的 readImage / capture 错误共用。 */
+export function formatBytes(bytes) {
+  if (bytes >= 1024 * 1024) return `${Math.round((bytes / (1024 * 1024)) * 10) / 10} MB`
+  if (bytes >= 1024) return `${Math.round((bytes / 1024) * 10) / 10} KB`
+  return `${bytes} 字节`
+}
+
+/**
+ * AI 预算（0.13 新增）：每枚评论 emoji 一份，开档另有一份。
+ *
+ * DeepSeek 的 `max_tokens` 是「总输出预算」，思考 token 也算在里面；所以 high 档要给足，
+ * 否则会出现「思考把预算用完、正文一个字没写」的失败（见 `lib/ai.js` 的 llm-token-budget）。
+ *
+ * - `preset`：低 / 中 / 高 / 自定义；前 3 档固定映射到 `AI_PRESETS` 的 effort + maxTokens；
+ * - 自定义档才使用 `reasoningEffort` / `maxTokens` 两个自定义字段。
+ */
+export const REASONING_EFFORTS = ['off', 'low', 'high', 'max']
+
+export const AI_PRESETS = {
+  low: { reasoningEffort: 'off', maxTokens: 2048 },
+  medium: { reasoningEffort: 'low', maxTokens: 4096 },
+  high: { reasoningEffort: 'high', maxTokens: 8192 },
+}
+
+export const AI_PRESET_IDS = ['low', 'medium', 'high', 'custom']
+
+export const AI_MAX_TOKENS_MIN = 256
+export const AI_MAX_TOKENS_MAX = 65536
+
+/** 默认档：高（用户要求默认一直用 high）。 */
+export const DEFAULT_AI = { preset: 'high', ...AI_PRESETS.high }
+
+/**
+ * 把任意来源的 AI 预算规范化成 `{ preset, reasoningEffort, maxTokens }`。
+ * 非自定义档一律以预设映射为准（界面上选哪档，实际请求就是哪档）；
+ * 自定义档的 effort 非法时回退 high，maxTokens 夹在 [min, max] 并取整。
+ * @param {unknown} raw
+ * @returns {{ preset: string, reasoningEffort: string, maxTokens: number }}
+ */
+export function normalizeAi(raw) {
+  const source = isPlainObject(raw) ? raw : {}
+  const preset = AI_PRESET_IDS.includes(source.preset) ? source.preset : DEFAULT_AI.preset
+  const base = preset === 'custom' ? source : AI_PRESETS[preset]
+  const fallback = preset === 'custom' ? DEFAULT_AI : AI_PRESETS[preset]
+  const reasoningEffort = REASONING_EFFORTS.includes(base.reasoningEffort)
+    ? base.reasoningEffort
+    : fallback.reasoningEffort
+  const rawTokens = Number(base.maxTokens)
+  const maxTokens = Number.isFinite(rawTokens)
+    ? Math.min(AI_MAX_TOKENS_MAX, Math.max(AI_MAX_TOKENS_MIN, Math.round(rawTokens)))
+    : fallback.maxTokens
+  return { preset, reasoningEffort, maxTokens }
+}
+
+/** 允许的评论 callout 兜底。 */
+export const FALLBACK_CALLOUT = 'note'
+
+/** 判断一个值是否是普通对象。 */
+export function isPlainObject(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+/** 把 tag 稳定映射到淡色板（空 tag = 纸白）。 */
+export function colorForTag(tag) {
+  return paletteForTag(tag).color
+}
+
+/** 同一 tag 的暗色模式卡片底色（深色底、同一色相）。 */
+export function darkColorForTag(tag) {
+  return paletteForTag(tag).dark
+}
+
+function paletteForTag(tag) {
+  if (!tag) return CARD_PALETTE[0]
+  let hash = 0
+  for (let i = 0; i < tag.length; i += 1) hash = (hash * 31 + tag.codePointAt(i)) >>> 0
+  return CARD_PALETTE[1 + (hash % (CARD_PALETTE.length - 1))]
+}
+
+/**
+ * 0.13.8：把便签绝对路径转成 Obsidian 打开 URI。
+ *
+ * 用 `path` 参数（绝对路径）而不是 `vault` + `file`：Obsidian 的 `path` 直接接受文件
+ * 绝对路径，不需要猜仓库的显示名，也不会因为仓库改名/同名仓库而打不开。
+ * Host 把这条 URI 交给系统打开方式（macOS `open` / Windows `start` / Linux `xdg-open`）。
+ * @param {string} absPath 便签的绝对路径（建议先 resolve）。
+ * @returns {string} `obsidian://open?path=...`；空路径返回 ''。
+ */
+export function buildObsidianUri(absPath) {
+  const path = typeof absPath === 'string' ? absPath.trim() : ''
+  if (path === '') return ''
+  return `obsidian://open?path=${encodeURIComponent(path)}`
+}
+
+/** 本地时间戳：`YYYY-MM-DD HH:mm`。 */
+export function localStamp(date = new Date()) {
+  const pad = (n) => String(n).padStart(2, '0')
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`
+}

package/lib/trash.js

@@ -0,0 +1,205 @@
+/** 库内 .trash 与可撤回的文件组；不依赖系统垃圾桶权限，不自动清空。 */
+import { randomUUID } from 'node:crypto'
+import { execFile } from 'node:child_process'
+import { lstat, mkdir, readFile, readdir, rename, rmdir, unlink, writeFile } from 'node:fs/promises'
+import { basename, dirname, extname, join, resolve } from 'node:path'
+import { assertPathWithin, failure, isHiddenVaultPath, isInside, moveFileExclusive as restoreFile } from './files.js'
+
+export const DELETE_UNDO_MS = 5000
+let systemTrashOverride = null
+export function setSystemTrashForTests(fn) { systemTrashOverride = fn }
+
+export function systemTrashCommand(path, platform = process.platform) {
+  if (platform === 'darwin') return { command: '/usr/bin/osascript', args: ['-l', 'JavaScript', '-e',
+    "ObjC.import('Foundation'); function run(argv) { const error = Ref(); if (!$.NSFileManager.defaultManager.trashItemAtURLResultingItemURLError($.NSURL.fileURLWithPath(argv[0]), null, error)) throw Error(ObjC.unwrap(error[0].localizedDescription)); }", '--', path] }
+  if (platform === 'win32') {
+    const encodedPath = Buffer.from(path, 'utf8').toString('base64')
+    const script = `Add-Type -AssemblyName Microsoft.VisualBasic; $target=[Text.Encoding]::UTF8.GetString([Convert]::FromBase64String('${encodedPath}')); [Microsoft.VisualBasic.FileIO.FileSystem]::DeleteDirectory($target, [Microsoft.VisualBasic.FileIO.UIOption]::OnlyErrorDialogs, [Microsoft.VisualBasic.FileIO.RecycleOption]::SendToRecycleBin, [Microsoft.VisualBasic.FileIO.UICancelOption]::ThrowException)`
+    return { command: 'powershell.exe', args: ['-NoProfile', '-NonInteractive', '-EncodedCommand', Buffer.from(script, 'utf16le').toString('base64')] }
+  }
+  return { command: 'gio', args: ['trash', '--', path] }
+}
+
+export async function vaultTrashInfo(vault) {
+  const path = await assertTrashRoot(vault, true)
+  const items = await readdir(path).catch((error) => { if (error.code === 'ENOENT') return null; throw error })
+  return { path, exists: items !== null, count: items?.length || 0 }
+}
+
+/** 整个仓库回收站交给系统回收 API，不用 unlink/rm 模拟清空，也不碰系统原有垃圾。 */
+export async function moveVaultTrashToSystem(vault) {
+  const info = await vaultTrashInfo(vault)
+  if (!info.count) return { moved: 0 }
+  try {
+    if (systemTrashOverride) await systemTrashOverride(info.path)
+    else {
+      const { command, args } = systemTrashCommand(info.path)
+      await new Promise((resolve, reject) => execFile(command, args, { timeout: 60000, windowsHide: true }, (error) => error ? reject(error) : resolve()))
+    }
+  } catch (error) { throw failure('trash-failed', `移至系统垃圾桶失败，仓库回收文件仍保留在 ${info.path}：${error.message}`, error) }
+  return { moved: info.count }
+}
+
+const IMAGE_EXT = /\.(?:png|jpe?g|gif|webp|svg|avif|bmp|heic|tiff?)$/i
+/** 包含评论与 frontmatter 内的图片；代码块内的图片示例不作为附件。 */
+export function imageSources(text) {
+  const source = String(text).replace(/^\s*(`{3,}|~{3,})[^\n]*\n[\s\S]*?^\s*\1[^\n]*$/gm, '').replace(/`[^`\n]*`/g, '')
+  const images = []
+  const pattern = /!\[\[([^\]|]+)(?:\|[^\]]*)?\]\]|!\[[^\]]*\]\(\s*(<[^>]+>|(?:\\.|[^()\s]|\([^()]*\))+)(?:\s+["'][^"']*["'])?\s*\)/g
+  for (const match of source.matchAll(pattern)) {
+    let path = (match[1] || match[2]).replace(/^<|>$/g, '').trim()
+    try { path = decodeURIComponent(path) } catch { continue }
+    path = path.replace(/\\([ ()])/g, '$1')
+    if (path.startsWith('//') || /^[a-z][a-z\d+.-]*:/i.test(path) || !IMAGE_EXT.test(path)) continue
+    images.push({ source: path, wiki: Boolean(match[1]) })
+  }
+  return images
+}
+
+/** 全库索引用于裸附件名解析与共享图片保护；超限中止删除，避免遗漏引用。 */
+export async function collectNoteFiles(vault) {
+  const files = [], notes = []
+  let count = 0
+  async function walk(dir) {
+    for (const item of await readdir(dir, { withFileTypes: true })) {
+      if (++count > 100000) throw failure('bad-request', '仓库过大，无法安全确认图片引用')
+      if (item.name.startsWith('.') || item.name === 'node_modules' || item.isSymbolicLink()) continue
+      const path = join(dir, item.name)
+      if (item.isDirectory()) await walk(path)
+      else if (item.isFile()) { files.push(path); if (extname(path).toLowerCase() === '.md') notes.push(path) }
+    }
+  }
+  await walk(vault)
+  return { files, notes }
+}
+
+export async function resolveImage(vault, note, image, files) {
+  const candidates = [resolve(dirname(note), image.source), resolve(vault, image.source)]
+  if (image.wiki && !image.source.includes('/')) candidates.push(...files.filter((path) => basename(path) === image.source))
+  for (const path of [...new Set(candidates)]) {
+    if (!isInside(vault, path) || isHiddenVaultPath(vault, path)) continue
+    const info = await lstat(path).catch((error) => { if (error.code !== 'ENOENT') throw error; return null })
+    if (!info?.isFile() || info.isSymbolicLink()) continue
+    const actual = await assertPathWithin(vault, path)
+    // 同名裸附件无法唯一定位时保留，不删除猜测的文件。
+    if (image.wiki && !image.source.includes('/') && files.filter((file) => basename(file) === image.source).length > 1) return null
+    return actual
+  }
+  return null
+}
+
+export async function noteAttachments(vault, note, text) {
+  const sources = imageSources(text)
+  // 纯文字便签没有待回收图片，不必扫描全库和解析其他笔记。
+  if (!sources.length) return { images: [], shared: 0 }
+  const index = await collectNoteFiles(vault), images = new Set()
+  for (const image of sources) {
+    const path = await resolveImage(vault, note, image, index.files)
+    if (path) images.add(path)
+  }
+  const shared = new Set()
+  if (images.size) for (const other of index.notes) {
+    if (other === note) continue
+    const content = await readFile(other, 'utf8')
+    // 普通链接和嵌入都算引用；共享附件仍留在仓库中。
+    for (const image of imageSources(content.replace(/(?<!!)\[\[/g, '![[').replace(/(?<!!)\[([^\]]*)\]\(/g, '![$1]('))) {
+      const path = await resolveImage(vault, other, image, index.files)
+      if (images.has(path)) shared.add(path)
+    }
+  }
+  return { images: [...images].filter((path) => !shared.has(path)), shared: shared.size }
+}
+
+/** 回收入口只使用库内真实的 .trash 目录；不接受指向其他位置的链接。 */
+async function assertTrashRoot(vault, allowMissing = false) {
+  const root = join(vault, '.trash')
+  await assertPathWithin(vault, root, { allowMissing })
+  const info = await lstat(root).catch((error) => { if (error.code !== 'ENOENT') throw error; return null })
+  if (info && (!info.isDirectory() || info.isSymbolicLink())) throw failure('bad-request', '仓库 .trash 必须是真实文件夹，不能是符号链接')
+  return root
+}
+
+async function assertTrashFolder(vault, folder) {
+  const root = await assertTrashRoot(vault)
+  if (dirname(resolve(folder)) !== resolve(root)) throw failure('bad-request', '回收文件必须在仓库 .trash 内')
+  await assertPathWithin(root, folder)
+  if (!(await lstat(folder)).isDirectory()) throw failure('bad-request', '回收文件夹不能是符号链接')
+}
+
+/** 仅清理本次创建的空目录及清单，保留回收目录中后来添加的文件。 */
+async function cleanTrashFolder(folder, entries) {
+  for (const item of entries) await rmdir(dirname(join(folder, item.name))).catch(() => {})
+  await unlink(join(folder, 'restore.json')).catch(() => {})
+  await rmdir(folder).catch(() => {})
+}
+
+/** 每组文件保存在 .trash/MEMO-…，清单记录原路径；失败时原路回滚。 */
+export async function trashNote(vault, note, images) {
+  const root = join(vault, '.trash')
+  const folder = join(root, `MEMO-${basename(note, extname(note)).slice(0, 40)}-${randomUUID()}`)
+  const entries = [...new Set([note, ...images])].map((from, i) => ({ from, name: join(String(i), basename(from)) }))
+  const moved = []
+  let created = false
+  try {
+    // 全组预检在移动前完成；隐藏目录仅作为回收位置，不可作为删除来源。
+    for (const entry of entries) {
+      await assertPathWithin(vault, entry.from)
+      if (isHiddenVaultPath(vault, entry.from) || !(await lstat(entry.from)).isFile()) throw failure('bad-request', '只能回收仓库内的普通便签和图片文件')
+    }
+    await assertTrashRoot(vault, true)
+    await mkdir(root, { recursive: true, mode: 0o700 })
+    await assertTrashRoot(vault)
+    await mkdir(folder, { mode: 0o700 })
+    created = true
+    await writeFile(join(folder, 'restore.json'), JSON.stringify(entries, null, 2), { flag: 'wx', mode: 0o600 })
+    for (const entry of entries) {
+      await assertPathWithin(vault, entry.from)
+      await assertTrashFolder(vault, folder)
+      await mkdir(dirname(join(folder, entry.name)))
+      await rename(entry.from, join(folder, entry.name)); moved.push(entry)
+    }
+    return { path: folder, entries, vault }
+  } catch (error) {
+    const rollbackErrors = []
+    for (const entry of moved.reverse()) {
+      try {
+        await assertTrashFolder(vault, folder)
+        await assertPathWithin(vault, entry.from, { allowMissing: true })
+        await restoreFile(join(folder, entry.name), entry.from)
+      } catch (cause) { rollbackErrors.push(cause) }
+    }
+    if (rollbackErrors.length) throw failure('trash-failed', `删除中断，部分文件保留在 ${folder}，请按 restore.json 找回；${error.message}`, error)
+    if (created) await cleanTrashFolder(folder, entries)
+    if (error.code === 'bad-request') throw error
+    throw failure('trash-failed', `移到仓库 .trash 失败，请检查目录读写权限：${error.message}`, error)
+  }
+}
+
+export async function restoreTrashedNote(entry) {
+  await assertTrashFolder(entry.vault, entry.path)
+  for (const item of entry.entries) {
+    await assertPathWithin(entry.vault, item.from, { allowMissing: true })
+    if (isHiddenVaultPath(entry.vault, item.from)) throw failure('bad-request', '不能恢复到仓库隐藏目录')
+    if (await lstat(item.from).catch((error) => { if (error.code !== 'ENOENT') throw error; return null })) throw failure('exists', '原位置已有同名文件，无法恢复')
+    const source = join(entry.path, item.name)
+    await assertPathWithin(entry.path, source)
+    if (!(await lstat(source)).isFile()) throw failure('bad-request', '回收文件不能是符号链接')
+  }
+  const restored = []
+  try {
+    for (const item of entry.entries) {
+      await mkdir(dirname(item.from), { recursive: true })
+      await assertPathWithin(entry.vault, item.from, { allowMissing: true })
+      await restoreFile(join(entry.path, item.name), item.from)
+      restored.push(item)
+    }
+  } catch (error) {
+    const rollbackErrors = []
+    for (const item of restored.reverse()) {
+      try { await restoreFile(item.from, join(entry.path, item.name)) } catch (cause) { rollbackErrors.push(cause) }
+    }
+    if (rollbackErrors.length) throw failure('restore-failed', `撤回中断，部分文件已回到原位，其余保留在 ${entry.path}；请按 restore.json 找回`, error)
+    throw error
+  }
+  await cleanTrashFolder(entry.path, entry.entries)
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Obsidian MEMO",
+    "description": "Obsidian MEMO: a pastel note wall for DSH with quick capture, images and WebP compression, reading/editing, AI comments, drag-to-trash with undo, copying, archiving, project documents and opening in Obsidian."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Obsidian MEMO",
+    "description": "Obsidian MEMO：把「进行时」文件夹变成 DSH 淡色便签墙，支持快速新建、多图粘贴与 WebP 压缩、阅读/编辑、AI 评论、拖拽删除与撤回、复制、归档、到项目与在 Obsidian 打开。"
+  }
+}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "dsh-obsidian-memo",
+  "version": "0.16.3",
+  "type": "module",
+  "description": "dsh-obsidian-memo：DeepSeek Harness 的 Obsidian 便签插件。把 Obsidian 进行时文件夹变成淡色便签墙，支持快速新建、多图与 WebP 压缩、阅读/编辑、AI 评论、归档、开档与在 Obsidian 打开。",
+  "main": "lib/index.js",
+  "icon": "icon.svg",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "src",
+    "scripts",
+    "AGENTS.md",
+    "docs/*.md",
+    "locale",
+    "cordis.patch.yml",
+    "icon.svg",
+    "README.md",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ]
+    }
+  },
+  "engines": {
+    "dsh": ">=0.2.2-rc.1 <0.3.0"
+  },
+  "scripts": {
+    "build": "node scripts/build-client.mjs",
+    "build:check": "node scripts/build-client.mjs --check",
+    "dev": "node scripts/build-client.mjs --watch",
+    "test": "pnpm build:check && node --test",
+    "prepack": "pnpm build",
+    "bench": "node --expose-gc scripts/benchmark.mjs"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "obsidian",
+    "markdown",
+    "notes",
+    "sticky-notes",
+    "productivity"
+  ],
+  "author": "cavenzhong",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cavenzhong/dsh-obsidian-memo.git"
+  },
+  "homepage": "https://github.com/cavenzhong/dsh-obsidian-memo#readme",
+  "bugs": {
+    "url": "https://github.com/cavenzhong/dsh-obsidian-memo/issues"
+  },
+  "devDependencies": {
+    "esbuild": "0.25.12"
+  }
+}

package/scripts/benchmark.mjs

@@ -0,0 +1,58 @@
+/** 合成临时仓库；只测 Host 扫描/缓存和排序计算，不写真实配置或仓库。 */
+import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const source = resolve(process.argv[2] || join(dirname(fileURLToPath(import.meta.url)), '..'))
+const { NotesScanner } = await import(pathToFileURL(join(source, 'lib/scan.js')))
+if (!global.gc) throw new Error('请使用 pnpm bench，或 node --expose-gc scripts/benchmark.mjs')
+
+const root = await mkdtemp(join(tmpdir(), 'memo-benchmark-'))
+try {
+  const notesDir = join(root, 'notes'), paragraph = '便签性能测试 abcdefghijklmnop\n\n'.repeat(2000)
+  await mkdir(notesDir)
+  for (let i = 0; i < 1000; i++) await writeFile(join(notesDir, `${i}.md`), `${i}\n\n${paragraph}`)
+  global.gc()
+  const beforeHeap = process.memoryUsage().heapUsed
+  const scanner = new NotesScanner(), settings = { vaultPath: root, notesDir }
+  let started = performance.now()
+  const first = await scanner.scan(settings)
+  const coldMs = performance.now() - started
+  global.gc()
+  const retainedHeapMiB = (process.memoryUsage().heapUsed - beforeHeap) / 1024 / 1024
+  started = performance.now()
+  await scanner.scan(settings)
+  const warmMs = performance.now() - started
+  const edited = join(notesDir, '0.md')
+  await writeFile(edited, '一个已更新的便签\n')
+  scanner.invalidate(edited)
+  started = performance.now()
+  const next = await scanner.scan(settings)
+  const editMs = performance.now() - started
+  const originals = new Set(first.notes)
+  const reusedSummariesAfterEdit = next.notes.filter((note) => originals.has(note)).length
+
+  // 使用与行为测试相同的 bundle 加载方式；无需浏览器或 React 依赖。
+  let registration
+  const window = { __ModuleLoader__: { load(value) { registration = value } } }
+  new Function('window', await readFile(join(source, 'lib/client.js'), 'utf8'))(window)
+  const react = { createElement() {}, memo(fn) { return fn }, Fragment: Symbol() }
+  const api = registration.factory((name) => name === 'react' ? react : {}).__test
+  const names = Array.from({ length: 5000 }, (_, i) => ({ name: `便签 ${(i * 3271) % 5000}`, created: 1, mtime: 1 }))
+  started = performance.now()
+  api.sortNotes(names, 'name-asc')
+  const nameSortMs = performance.now() - started
+
+  const round = (value) => Math.round(value * 100) / 100
+  console.log(JSON.stringify({
+    node: process.version,
+    notes: first.notes.length,
+    approximateNoteKiB: round(Buffer.byteLength(paragraph) / 1024),
+    coldMs: round(coldMs), warmMs: round(warmMs), editMs: round(editMs),
+    retainedHeapMiB: round(retainedHeapMiB), reusedSummariesAfterEdit,
+    sortNotes: names.length, nameSortMs: round(nameSortMs),
+  }, null, 2))
+} finally {
+  await rm(root, { recursive: true, force: true })
+}