dsh-grove 0.1.2 → 0.2.0

package/README.en.md

@@ -22,9 +22,9 @@ AI can ask questions, compare explanations, surface counterexamples, and help yo
 
 ## How Grove puts the method into practice
 
-Grove connects DeepSeek Harness and Obsidian. The current version connects open-ended conversation, user-confirmed saves, and basic evidence tracking. Choose what to keep from a conversation, save it as Markdown in your own vault, and use versions and wikilinks to revisit relationships among questions, evidence, and claims. You can practice the guide’s learning, reflection, and full research methods by hand.
+Grove connects DeepSeek Harness and Obsidian. The current version connects the Grove panel in the left sidebar, open-ended conversation, user-confirmed saves, and basic evidence tracking. After installing, Grove appears in the sidebar: connect a vault and capture a first idea, then return to the conversation. Choose what to keep from a conversation, save it as Markdown in your own vault, and use versions and wikilinks to revisit relationships among questions, evidence, and claims. You can practice the guide’s learning, reflection, and full research methods by hand.
 
-## Install v0.1.1
+## Install v0.2.0
 
 You need Node.js 22 or later, an existing Obsidian vault, and DeepSeek Harness `>=0.2.2-rc.1 <0.3.0`. The `engines.dsh` range determines whether the host loads the bundle.
 
@@ -34,9 +34,10 @@ You need Node.js 22 or later, an existing Obsidian vault, and DeepSeek Harness `
 | --- | --- |
 | Desktop | Open **Plugins → Add plugin** and select this repository directory. The host installs a `link:` dependency. Restart the host after editing the source. |
 | In a session | Ask the agent to call `plugin_manager` with `install_bundle` and pass the directory’s absolute path as `target`. |
+| npm | `dsh plugin --profile <profile> add dsh-grove` (published to npm since 0.2.0). |
 | CLI | Run `dsh plugin --profile <profile> add <directory-or-tgz>`. The Desktop app manages its own profile. Packages installed into `profiles/web` do not appear there. |
 
-Check that Grove appears on the **Plugins** page, then ask the model to call `grove_role` in a new session to confirm the tool is registered.
+After installing, **Grove** appears in the left sidebar: open it, choose a vault, and capture a first idea. Check that Grove also appears on the **Plugins** page, then ask the model to call `grove_role` in a new session to confirm the tool is registered.
 
 ### Try a separate profile
 
@@ -54,12 +55,12 @@ A global installation puts the package’s `grove` executable on PATH. Installin
 
 ```sh
 npm pack --pack-destination /tmp
-npm install --global /tmp/dsh-grove-0.1.1.tgz
+npm install --global /tmp/dsh-grove-0.2.0.tgz
 ```
 
 ## Everyday use
 
-1. Run `grove capture --body 'Why might coordination costs increase as an organization grows?'` and open the `Grove` folder in Obsidian to see the Markdown note.
+1. Open **Grove** in the left sidebar, choose your Obsidian vault, and capture a first idea. You can also keep using the terminal: `grove capture --body 'Why might coordination costs increase as an organization grows?'`. Open the `Grove` folder in Obsidian to see the Markdown note.
 2. Explore in Harness. Use `grove_role` for a thinking partner, knowledge assistant, research assistant, critical reviewer, or creation assistant. Ask `grove_propose` to draft a note when you want to keep something, and supply the conversation reference you want to save. You can also end the exploration there.
 3. Run `grove preview DRAFT_ID` in your terminal. Use `grove accept DRAFT_ID` and type `SAVE`, or run `grove discard DRAFT_ID`. Pass `--file` when accepting to supply your edited body.
 4. Use `grove list` and `grove show ASSET_ID --version 1` to revisit your notes. To share selected notes with the model, set `GROVE_READABLE_IDS` to a comma-separated list of asset IDs before starting the host. Restart the host after revoking that access. Content already shared in a session follows the host’s history settings.

package/README.md

@@ -22,9 +22,9 @@ AI 可以追问、比较解释、查找反例和协助表达。你决定相信
 
 ## Grove 如何实践这套方法
 
-Grove 是连接 DeepSeek Harness 和 Obsidian 的插件。当前版本把自由对话、自主保存和基础证据研究接在一起。你可以从会话挑出值得保留的内容，把它保存成自己 vault 里的 Markdown，并用版本和双链回看问题、证据与判断的关联。指南里的学习、反思和完整研究方法可以手工实践。
+Grove 是连接 DeepSeek Harness 和 Obsidian 的插件。当前版本把左侧 Grove 面板、自由对话、自主保存和基础证据研究接在一起。安装后左侧菜单出现 Grove：连接 vault、写下第一条灵感；回到会话里让 AI 陪你追问。你可以从会话挑出值得保留的内容，把它保存成自己 vault 里的 Markdown，并用版本和双链回看问题、证据与判断的关联。指南里的学习、反思和完整研究方法可以手工实践。
 
-## 安装 v0.1.2
+## 安装 v0.2.0
 
 需要 Node.js 22 或更高版本、一个已有的 Obsidian vault，以及 DeepSeek Harness `>=0.2.2-rc.1 <0.3.0`。兼容范围由 `engines.dsh` 声明：它必须是范围而不是某一个精确版本，否则 dsh 会把整个 bundle 判为不兼容并跳过加载。
 
@@ -34,9 +34,10 @@ Grove 是连接 DeepSeek Harness 和 Obsidian 的插件。当前版本把自由
 | --- | --- |
 | Desktop | **Plugins → Add plugin**，选择本仓库目录；按目录安装会装成 `link:`，改完代码重启宿主即生效 |
 | 会话里 | 让 agent 调用 `plugin_manager` 的 `install_bundle`，`target` 传目录绝对路径 |
+| npm | `dsh plugin --profile <profile> add dsh-grove`（0.2.0 起已发布到 npm） |
 | CLI | `dsh plugin --profile <profile> add <目录或 tgz>`。Desktop 的 profile 由 App 管理，命令行装进 `profiles/web` 不会出现在 Desktop |
 
-装完在 **Plugins** 页确认 Grove 这一条出现，并在新会话里让模型调用 `grove_role`——工具真的注册上才算装好。
+装完左侧菜单出现 **Grove**：点开选择 vault，写下第一条灵感。再到 **Plugins** 页确认 Grove 这一条出现，并在新会话里让模型调用 `grove_role`——工具真的注册上才算装好。
 
 ### 独立 profile 试用（不碰日常配置）
 
@@ -54,12 +55,12 @@ npx --yes @deepseek-ai/dsh@0.2.2-rc.3 --profile grove
 
 ```sh
 npm pack --pack-destination /tmp
-npm install --global /tmp/dsh-grove-0.1.2.tgz
+npm install --global /tmp/dsh-grove-0.2.0.tgz
 ```
 
 ## 日常使用
 
-1. 终端执行 `grove capture --body '为什么组织扩大后协调成本会上升？'`。在 Obsidian 中打开 vault 的 `Grove` 文件夹可看到 Markdown 笔记。
+1. 点开左侧菜单的 **Grove**，选择你的 Obsidian vault，写下第一条灵感。也可以继续用终端：`grove capture --body '为什么组织扩大后协调成本会上升？'`。在 Obsidian 中打开 vault 的 `Grove` 文件夹可看到 Markdown 笔记。
 2. 在 Harness 中自由对话。可要求使用 `grove_role` 作为思想伙伴、知识助手、研究助手、批判性审查者或创造助手。想保留一段讨论时，请求 `grove_propose` 起草，并提供你愿意保存的会话引用。探索可以直接结束。
 3. 在自己的终端执行 `grove preview 草稿ID`。用 `grove accept 草稿ID` 查看并输入 `SAVE`，或执行 `grove discard 草稿ID`。确认时也可用 `--file` 提供你编辑过的正文。
 4. 用 `grove list` 查询资产，用 `grove show 资产ID --version 1` 回看具体版本。默认 Grove 不向模型提供资产正文。若希望分享指定笔记，启动宿主前将 `GROVE_READABLE_IDS` 设为逗号分隔的资产 ID。取消分享后重新启动宿主。已进入宿主会话的内容仍受宿主历史设置约束。

package/client.js

@@ -0,0 +1,639 @@
+/**
+ * Grove client half: the left-sidebar panel and its cold-start page.
+ *
+ * Single file, plain JavaScript, no build step. Only `require('react')` plus browser APIs.
+ * All data comes from the host half's same-origin routes:
+ *   GET  /api/grove/status
+ *   POST /api/grove/config
+ *   POST /api/grove/capture
+ * Styles use `--dsw-alias-*` tokens only.
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-grove',
+  factory: function (require) {
+    var React = require('react')
+    var h = React.createElement
+    var useState = React.useState
+    var useEffect = React.useEffect
+    var useRef = React.useRef
+
+    var NS = 'grove'
+    var STATUS = '/api/grove/status'
+    var CONFIG = '/api/grove/config'
+    var CAPTURE = '/api/grove/capture'
+
+    var ZH = {
+      panel: 'Grove',
+      menu: '知林',
+      subtitle: '把探索留在自己的 vault 里。',
+      'status.connected': '已连接',
+      'status.disconnected': '未连接',
+      'status.readonly': '只读',
+      'status.checking': '正在读取…',
+      's0.title': '先连接你的 Obsidian vault',
+      's0.body': 'Grove 只读写 vault 里的 Grove/ 文件夹，不读其他笔记。连接后，Harness 里的对话就能落成可回看、可修订的 Markdown。',
+      's0.step1': '连接 vault',
+      's0.step2': '写下第一条灵感',
+      's0.step3': '回到会话继续探索',
+      's0.pick': '选择文件夹',
+      's0.manual': '手动输入路径',
+      's0.placeholder': '/Users/你/Obsidian Vault',
+      's0.connect': '连接',
+      's0.cancel': '取消',
+      's0.hint': '路径会保存到当前 profile 的插件配置；之后可在插件页里修改。',
+      's0.stale': '原来的 vault 已不可用：{path}。请重新选择，或把它移回原位。',
+      's0.noVault': '这个文件夹里没有 .obsidian。如果它不是 vault 根目录，仍可继续连接。',
+      's1.connectedTo': '已连接',
+      's1.change': '更换 vault',
+      's1.title': '写下第一条灵感',
+      's1.body': '一个观察、一个困惑、一句还没想清楚的话都可以。保存后它会出现在 vault 的 Grove/ 文件夹里。',
+      's1.placeholder': '比如：为什么组织扩大后，协调成本会上升？',
+      's1.save': '保存到 vault',
+      's1.saving': '正在保存…',
+      's1.saved': '已保存',
+      's1.savedBody': '已写入 vault。用 Obsidian 打开 Grove/ 文件夹就能看到。回到会话里，让 AI 用 grove_role 陪你继续想。',
+      's1.view': '查看概览',
+      's1.another': '另一种开始',
+      's1.prompt': '用 grove_role 当我的思想伙伴，先帮我拆开这个问题：<你的问题>',
+      's1.copy': '复制提示词',
+      's1.copied': '已复制',
+      's2.title': '你的知识库',
+      's2.total': '条资产',
+      's2.recent': '最近更新',
+      's2.empty': '还没有笔记。',
+      's2.continue': '在会话里继续探索',
+      's2.prompt': '用 grove_role 当我的思想伙伴，接着上次的问题继续。',
+      's2.count.inspiration': '灵感',
+      's2.count.question': '问题',
+      's2.count.research': '研究',
+      's2.count.claim': '判断',
+      's2.count.evidence': '证据',
+      'type.inspiration': '灵感',
+      'type.question': '问题',
+      'type.concept': '概念',
+      'type.theory': '理论',
+      'type.claim': '判断',
+      'type.evidence': '证据',
+      'type.method': '方法',
+      'type.output': '成果',
+      'type.exploration': '探索',
+      'type.research': '研究',
+      'foot.privacy': 'Grove 只读写 vault 的 Grove/ 文件夹，不读其他笔记。',
+      'foot.confirm': 'AI 起草的草稿要你在终端确认后才落盘。',
+      'foot.data': '数据是你的 Markdown，随时可以备份或迁移。',
+      'err.invalid-path': '路径无效，请填写绝对路径。',
+      'err.not-directory': '这个路径不是文件夹。',
+      'err.symlink': '这个路径是符号链接，请选择真实目录。',
+      'err.save-unavailable': '当前 profile 无法保存插件配置，请手动设置 GROVE_VAULT。',
+      'err.not-configured': '还没有连接 vault。',
+      'err.invalid-body': '内容不能为空。',
+      'err.too-large': '内容太长了，请控制在 128 KiB 以内。',
+      'err.network': '连不上面板服务，请重启 DSH 后重试。',
+      'err.timeout': '配置已提交，但还没生效。请重启 DSH 后再看。',
+      'err.internal': '操作失败，请重试。',
+      'err.retry': '重试',
+      'err.clipboard': '复制被拦截，请手动选择文本。',
+      'loading': '正在读取 vault…',
+    }
+
+    var EN = {
+      panel: 'Grove',
+      menu: 'Grove',
+      subtitle: 'Keep what you explore in your own vault.',
+      'status.connected': 'Connected',
+      'status.disconnected': 'Not connected',
+      'status.readonly': 'Read only',
+      'status.checking': 'Reading…',
+      's0.title': 'Connect your Obsidian vault',
+      's0.body': 'Grove reads and writes only the Grove/ folder inside your vault, never other notes. Once connected, conversations in Harness can become Markdown you can revisit and revise.',
+      's0.step1': 'Connect a vault',
+      's0.step2': 'Capture a first idea',
+      's0.step3': 'Go back to the conversation',
+      's0.pick': 'Choose folder',
+      's0.manual': 'Enter a path',
+      's0.placeholder': '/Users/you/Obsidian Vault',
+      's0.connect': 'Connect',
+      's0.cancel': 'Cancel',
+      's0.hint': 'The path is saved in this profile’s plugin configuration and can be changed later from the Plugins page.',
+      's0.stale': 'The previous vault is no longer usable: {path}. Choose it again, or move it back.',
+      's0.noVault': 'This folder has no .obsidian. You can still connect if it is a vault root.',
+      's1.connectedTo': 'Connected',
+      's1.change': 'Change vault',
+      's1.title': 'Capture a first idea',
+      's1.body': 'An observation, a question, or a thought you have not worked out yet. Saving puts it in the vault’s Grove/ folder.',
+      's1.placeholder': 'For example: why do coordination costs rise as an organization grows?',
+      's1.save': 'Save to vault',
+      's1.saving': 'Saving…',
+      's1.saved': 'Saved',
+      's1.savedBody': 'Written to the vault. Open the Grove/ folder in Obsidian to see it. Back in the conversation, ask AI to use grove_role and keep thinking.',
+      's1.view': 'View overview',
+      's1.another': 'Another way to start',
+      's1.prompt': 'Use grove_role as my thinking partner and help me unpack this question: <your question>',
+      's1.copy': 'Copy prompt',
+      's1.copied': 'Copied',
+      's2.title': 'Your knowledge base',
+      's2.total': 'assets',
+      's2.recent': 'Recently updated',
+      's2.empty': 'No notes yet.',
+      's2.continue': 'Continue in the conversation',
+      's2.prompt': 'Use grove_role as my thinking partner and continue from the last question.',
+      's2.count.inspiration': 'Inspirations',
+      's2.count.question': 'Questions',
+      's2.count.research': 'Research',
+      's2.count.claim': 'Claims',
+      's2.count.evidence': 'Evidence',
+      'type.inspiration': 'Inspiration',
+      'type.question': 'Question',
+      'type.concept': 'Concept',
+      'type.theory': 'Theory',
+      'type.claim': 'Claim',
+      'type.evidence': 'Evidence',
+      'type.method': 'Method',
+      'type.output': 'Output',
+      'type.exploration': 'Exploration',
+      'type.research': 'Research',
+      'foot.privacy': 'Grove reads and writes only the vault’s Grove/ folder, never other notes.',
+      'foot.confirm': 'Content drafted by AI is saved only after you confirm it in the terminal.',
+      'foot.data': 'Your data is Markdown you can back up or move at any time.',
+      'err.invalid-path': 'That path is not valid. Use an absolute path.',
+      'err.not-directory': 'That path is not a folder.',
+      'err.symlink': 'That path is a symlink. Choose a real directory.',
+      'err.save-unavailable': 'This profile cannot save plugin configuration. Set GROVE_VAULT manually.',
+      'err.not-configured': 'No vault is connected yet.',
+      'err.invalid-body': 'Write something first.',
+      'err.too-large': 'That is too long. Keep it under 128 KiB.',
+      'err.network': 'The panel service is unreachable. Restart DSH and try again.',
+      'err.timeout': 'The configuration was submitted but has not taken effect. Restart DSH and check again.',
+      'err.internal': 'That did not work. Try again.',
+      'err.retry': 'Retry',
+      'err.clipboard': 'Copy was blocked. Select the text manually.',
+      'loading': 'Reading the vault…',
+    }
+
+    var boundT = null
+    var services = { workspace: null }
+
+    function T(key, vars) {
+      if (boundT) {
+        try {
+          var resolved = boundT(key, vars)
+          if (resolved !== undefined && resolved !== null && resolved !== key) return resolved
+        } catch (error) { /* fall through to the bundled dictionary */ }
+      }
+      var value = ZH[key] !== undefined ? ZH[key] : EN[key]
+      if (value === undefined) return key
+      if (vars) {
+        value = value.replace(/\{(\w+)\}/g, function (match, name) {
+          return vars[name] === undefined ? match : String(vars[name])
+        })
+      }
+      return value
+    }
+
+    function api(path, body) {
+      var request = body === undefined
+        ? { headers: { accept: 'application/json' } }
+        : { method: 'POST', headers: { 'content-type': 'application/json', accept: 'application/json' }, body: JSON.stringify(body) }
+      return fetch(path, request).then(function (response) {
+        return response.json().catch(function () { return {} }).then(function (data) {
+          if (response.ok) return data
+          var error = new Error((data.error && data.error.message) || ('HTTP ' + response.status))
+          error.code = data.error && data.error.code
+          throw error
+        })
+      }, function () {
+        var error = new Error('network')
+        error.code = 'network'
+        throw error
+      })
+    }
+
+    function messageOf(error) {
+      if (error && error.code && ZH['err.' + error.code] !== undefined) return T('err.' + error.code)
+      if (error && error.code === 'network') return T('err.network')
+      return (error && error.message) || T('err.internal')
+    }
+
+    function when(iso) {
+      if (!iso) return ''
+      var date = new Date(iso)
+      if (isNaN(date.getTime())) return ''
+      return date.getFullYear() + '-' + String(date.getMonth() + 1).padStart(2, '0') + '-' + String(date.getDate()).padStart(2, '0')
+    }
+
+    function copyText(text) {
+      if (navigator.clipboard && navigator.clipboard.writeText) return navigator.clipboard.writeText(text)
+      return Promise.reject(new Error('clipboard'))
+    }
+
+    function waitForVault(expected, tries) {
+      return api(STATUS).catch(function () { return null }).then(function (status) {
+        if (status && status.configured && status.usable && (expected === undefined || status.vault === expected)) return status
+        if (tries <= 0) {
+          var error = new Error('timeout')
+          error.code = 'timeout'
+          throw error
+        }
+        return new Promise(function (resolve) { setTimeout(resolve, 700) }).then(function () {
+          return waitForVault(expected, tries - 1)
+        })
+      })
+    }
+
+    // ────────────────────────────────────────────────────── the page
+    function GrovePage() {
+      var [status, setStatus] = useState(null)
+      var [loading, setLoading] = useState(true)
+      var [error, setError] = useState(null)
+      var [busy, setBusy] = useState('')
+      var [manual, setManual] = useState(false)
+      var [draft, setDraft] = useState('')
+      var [pathDraft, setPathDraft] = useState('')
+      var [firstNote, setFirstNote] = useState(null)
+      var [copied, setCopied] = useState(false)
+      var [changing, setChanging] = useState(false)
+      var mounted = useRef(true)
+
+      useEffect(function () {
+        mounted.current = true
+        load()
+        return function () { mounted.current = false }
+      }, [])
+
+      function load() {
+        setLoading(true)
+        return api(STATUS).then(function (next) {
+          if (!mounted.current) return
+          setStatus(next)
+          setError(null)
+        }, function (problem) {
+          if (!mounted.current) return
+          setError(problem)
+        }).then(function () {
+          if (mounted.current) setLoading(false)
+        })
+      }
+
+      function connect(path) {
+        setBusy('connect')
+        setError(null)
+        return api(CONFIG, { path: path }).then(function () {
+          return waitForVault(path, 12)
+        }).then(function (next) {
+          if (!mounted.current) return
+          setStatus(next)
+          setManual(false)
+          setChanging(false)
+        }, function (problem) {
+          if (!mounted.current) return
+          setError(problem)
+        }).then(function () {
+          if (mounted.current) setBusy('')
+        })
+      }
+
+      function pickFolder() {
+        var workspace = services.workspace
+        if (!workspace || typeof workspace.pickDirectory !== 'function') {
+          setManual(true)
+          return
+        }
+        setBusy('pick')
+        Promise.resolve(workspace.pickDirectory()).then(function (path) {
+          if (!path) {
+            if (mounted.current) setBusy('')
+            return
+          }
+          if (mounted.current) setBusy('')
+          connect(path)
+        }, function () {
+          if (!mounted.current) return
+          setBusy('')
+          setManual(true)
+        })
+      }
+
+      function submitManual() {
+        var path = pathDraft.trim()
+        if (path === '') return
+        connect(path)
+      }
+
+      function saveFirst() {
+        var body = draft.trim()
+        if (body === '') return
+        setBusy('capture')
+        setError(null)
+        api(CAPTURE, { body: body }).then(function (note) {
+          if (!mounted.current) return
+          setFirstNote(note)
+          setDraft('')
+          return api(STATUS).then(function (next) {
+            if (mounted.current) setStatus(next)
+          })
+        }, function (problem) {
+          if (mounted.current) setError(problem)
+        }).then(function () {
+          if (mounted.current) setBusy('')
+        })
+      }
+
+      function copyPrompt(text) {
+        copyText(text).then(function () {
+          if (!mounted.current) return
+          setCopied(true)
+          setTimeout(function () { if (mounted.current) setCopied(false) }, 1600)
+        }, function (problem) {
+          if (mounted.current) setError(problem)
+        })
+      }
+
+      var connected = !!(status && status.configured && status.usable)
+      var total = status && status.counts ? Number(status.counts.total) || 0 : 0
+      var connectView = h(Connect, {
+        busy: busy, manual: manual, error: error, pathDraft: pathDraft,
+        stale: !changing && status && status.configured && !status.usable ? status.vault : null,
+        onPath: setPathDraft, onPick: pickFolder, onSubmit: submitManual,
+        onManual: function () { setManual(true) },
+        onManualCancel: function () { setManual(false) },
+        onCancel: changing || connected ? function () { setChanging(false); setManual(false) } : null,
+      })
+
+      return h('div', { className: 'gr-root' },
+        h('style', null, CSS),
+        h('div', { className: 'gr-scroll' },
+          h('div', { className: 'gr-inner' },
+            h(Header, {
+              status: status, loading: loading, error: error,
+              onChange: connected ? function () {
+                setPathDraft(status.vault || '')
+                setManual(false)
+                setChanging(true)
+              } : null,
+            }),
+            error ? h(ErrorNote, { error: error, onRetry: load }) : null,
+            loading && status === null
+              ? h('div', { className: 'gr-card' }, h('div', { className: 'gr-body' }, T('loading')))
+              : changing || !connected
+                ? connectView
+                : total > 0 && firstNote === null
+                  ? h(Overview, { status: status, onCopy: copyPrompt })
+                  : h(FirstNote, {
+                    status: status, draft: draft, busy: busy, note: firstNote,
+                    onDraft: setDraft, onSave: saveFirst, onCopy: copyPrompt,
+                    onOverview: function () { setFirstNote(null) },
+                  }),
+            h(Footer, null),
+          ),
+        ),
+      )
+    }
+
+    function Header(props) {
+      var status = props.status
+      var connected = !!(status && status.configured && status.usable)
+      var label = props.loading && !status ? T('status.checking') : connected ? T('status.connected') : T('status.disconnected')
+      return h('div', { className: 'gr-head' },
+        h('div', { className: 'gr-mark' }, h(GroveMark, { size: 26 })),
+        h('div', { className: 'gr-headtext' },
+          h('div', { className: 'gr-title' }, T('panel')),
+          h('div', { className: 'gr-sub' }, status && status.vault ? status.vault : T('subtitle')),
+        ),
+        h('div', { className: 'gr-head-actions' },
+          props.onChange
+            ? h('button', { className: 'gr-btn gr-btn-ghost gr-btn-sm', onClick: props.onChange }, T('s1.change'))
+            : null,
+          h('span', { className: 'gr-pill', 'aria-live': 'polite' },
+            h('span', { className: 'gr-dot ' + (connected ? 'gr-dot-ok' : '') }),
+            label,
+            connected && status.writable === false ? h('span', null, ' · ' + T('status.readonly')) : null,
+          ),
+        ),
+      )
+    }
+
+    function Connect(props) {
+      return h('div', { className: 'gr-card' },
+        props.stale ? h('div', { className: 'gr-err' }, T('s0.stale', { path: props.stale })) : null,
+        h('div', { className: 'gr-h2' }, T('s0.title')),
+        h('div', { className: 'gr-body' }, T('s0.body')),
+        h('div', { className: 'gr-steps' },
+          h('div', { className: 'gr-step' }, h('b', null, '1'), T('s0.step1')),
+          h('div', { className: 'gr-step' }, h('b', null, '2'), T('s0.step2')),
+          h('div', { className: 'gr-step' }, h('b', null, '3'), T('s0.step3')),
+        ),
+        props.manual
+          ? h('div', { className: 'gr-row' },
+            h('input', {
+              className: 'gr-input', value: props.pathDraft, spellCheck: false,
+              placeholder: T('s0.placeholder'), 'aria-label': T('s0.placeholder'),
+              onChange: function (event) { props.onPath(event.target.value) },
+              onKeyDown: function (event) { if (event.key === 'Enter') props.onSubmit() },
+            }),
+            h('button', { className: 'gr-btn gr-btn-sm', disabled: props.busy !== '', onClick: props.onSubmit }, T('s0.connect')),
+            h('button', { className: 'gr-btn gr-btn-ghost gr-btn-sm', disabled: props.busy !== '', onClick: props.onManualCancel }, T('s0.cancel')),
+          )
+          : h('div', { className: 'gr-row' },
+            h('button', { className: 'gr-btn', disabled: props.busy !== '', onClick: props.onPick }, props.busy === 'pick' ? T('status.checking') : T('s0.pick')),
+            h('button', { className: 'gr-btn gr-btn-ghost gr-btn-sm', disabled: props.busy !== '', onClick: props.onManual }, T('s0.manual')),
+            props.onCancel
+              ? h('button', { className: 'gr-btn gr-btn-ghost gr-btn-sm', disabled: props.busy !== '', onClick: props.onCancel }, T('s0.cancel'))
+              : null,
+          ),
+        h('div', { className: 'gr-meta' }, T('s0.hint')),
+      )
+    }
+
+    function FirstNote(props) {
+      var status = props.status
+      if (props.note) {
+        return h('div', { className: 'gr-card' },
+          h('div', { className: 'gr-h2 gr-ok' }, '✓ ' + T('s1.saved')),
+          h('div', { className: 'gr-body' }, T('s1.savedBody')),
+          h('div', { className: 'gr-row' }, h('span', { className: 'gr-path' }, props.note.path)),
+          h('div', { className: 'gr-row' }, h('button', { className: 'gr-btn gr-btn-sm', onClick: props.onOverview }, T('s1.view'))),
+        )
+      }
+      return h(React.Fragment, null,
+        h('div', { className: 'gr-card' },
+          h('div', { className: 'gr-meta' }, T('s1.connectedTo') + ' · ' + (status.vault || '')),
+          h('div', { className: 'gr-h2' }, T('s1.title')),
+          h('div', { className: 'gr-body' }, T('s1.body')),
+          h('textarea', {
+            className: 'gr-textarea', value: props.draft, placeholder: T('s1.placeholder'),
+            'aria-label': T('s1.title'),
+            onChange: function (event) { props.onDraft(event.target.value) },
+            onKeyDown: function (event) {
+              if ((event.metaKey || event.ctrlKey) && event.key === 'Enter') props.onSave()
+            },
+          }),
+          h('div', { className: 'gr-row' },
+            h('button', { className: 'gr-btn', disabled: props.busy !== '' || props.draft.trim() === '', onClick: props.onSave },
+              props.busy === 'capture' ? T('s1.saving') : T('s1.save')),
+            h('span', { className: 'gr-meta' }, '⌘↵'),
+          ),
+        ),
+        h('div', { className: 'gr-card' },
+          h('div', { className: 'gr-h2' }, T('s1.another')),
+          h('pre', { className: 'gr-code' }, T('s1.prompt')),
+          h('button', { className: 'gr-btn gr-btn-ghost gr-btn-sm', onClick: function () { props.onCopy(T('s1.prompt')) } }, T('s1.copy')),
+        ),
+      )
+    }
+
+    function Overview(props) {
+      var status = props.status
+      var counts = status.counts || {}
+      var stats = ['inspiration', 'question', 'research', 'claim', 'evidence'].map(function (type) {
+        return h('div', { className: 'gr-stat', key: type },
+          h('b', null, String(counts[type] || 0)),
+          h('span', null, T('s2.count.' + type)),
+        )
+      })
+      var recent = status.recent || []
+      return h(React.Fragment, null,
+        h('div', { className: 'gr-card' },
+          h('div', { className: 'gr-row', style: { justifyContent: 'space-between' } },
+            h('div', { className: 'gr-h2' }, T('s2.title')),
+            h('div', { className: 'gr-meta' }, String(counts.total || 0) + ' ' + T('s2.total')),
+          ),
+          h('div', { className: 'gr-stats' }, stats),
+        ),
+        h('div', { className: 'gr-card' },
+          h('div', { className: 'gr-h2' }, T('s2.recent')),
+          recent.length === 0
+            ? h('div', { className: 'gr-body' }, T('s2.empty'))
+            : h('div', { className: 'gr-recent' }, recent.map(function (item) {
+              return h('div', { className: 'gr-item', key: item.id + ':' + item.version },
+                h('span', { className: 'gr-type' }, T('type.' + item.type)),
+                h('span', { className: 'gr-itemtitle', title: item.title || '' }, item.title || item.id),
+                h('span', { className: 'gr-meta' }, 'v' + item.version + (item.at ? ' · ' + when(item.at) : '')),
+              )
+            })),
+        ),
+        h('div', { className: 'gr-card' },
+          h('div', { className: 'gr-h2' }, T('s2.continue')),
+          h('pre', { className: 'gr-code' }, T('s2.prompt')),
+          h('button', { className: 'gr-btn gr-btn-ghost gr-btn-sm', onClick: function () { props.onCopy(T('s2.prompt')) } }, T('s1.copy')),
+        ),
+      )
+    }
+
+    function ErrorNote(props) {
+      return h('div', { className: 'gr-card', role: 'alert' },
+        h('div', { className: 'gr-err' }, messageOf(props.error)),
+        h('button', { className: 'gr-btn gr-btn-ghost gr-btn-sm', onClick: props.onRetry }, T('err.retry')),
+      )
+    }
+
+    function Footer() {
+      return h('div', { className: 'gr-foot' },
+        h('div', null, T('foot.privacy')),
+        h('div', null, T('foot.confirm')),
+        h('div', null, T('foot.data')),
+      )
+    }
+
+    function GroveMark(props) {
+      var size = Number(props && props.size) || 36
+      return h('svg', {
+        xmlns: 'http://www.w3.org/2000/svg', width: size, height: size, viewBox: '0 0 36 36',
+        'aria-hidden': true, focusable: 'false',
+      },
+      h('g', { transform: 'translate(18 18) scale(1.12) translate(-18.6 -20.9)' },
+        h('path', { d: 'M16.9 30.4h2.2l-.65-12.3h-.9z', fill: '#1B3A2E' }),
+        h('path', { d: 'M18.4 19c2.2-6.5 8.3-9.4 10.5-8.15-1 5.3-4.9 8.45-10.5 8.15Z', fill: '#2F7D5B' }),
+        h('path', { d: 'M17.6 23c-2.2-5.1-6.5-7.3-8.5-6.3.7 4.1 4.3 6.3 8.5 6.3Z', fill: '#5FA37E' }),
+        h('path', { d: 'M15.4 31.5h5.2', stroke: '#C98A3B', 'stroke-width': 2.2, 'stroke-linecap': 'round', fill: 'none' }),
+      ))
+    }
+
+    function GroveIcon(props) {
+      var size = Number(props && props.size) || 16
+      return h(GroveMark, { size: size })
+    }
+
+    var CSS = [
+      '.gr-root{height:100%;min-height:0;display:flex;flex-direction:column;background:var(--dsw-alias-bg-base);color:var(--dsw-alias-label-primary);font-family:inherit;font-size:13px;line-height:1.6;box-sizing:border-box;padding-top:min(var(--dsh-frame-top-clearance,0px),28px)}',
+      '.gr-scroll{flex:1 1 auto;min-height:0;overflow:auto}',
+      '.gr-inner{max-width:760px;margin:0 auto;padding:28px 24px 40px;display:flex;flex-direction:column;gap:18px;box-sizing:border-box}',
+      '.gr-head{display:flex;align-items:flex-start;gap:14px;flex-wrap:wrap}',
+      '.gr-mark{flex:none;width:44px;height:44px;border-radius:12px;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);display:grid;place-items:center}',
+      '.gr-headtext{min-width:0;flex:1 1 220px}',
+      '.gr-title{font-size:20px;font-weight:600;line-height:1.3}',
+      '.gr-sub{color:var(--dsw-alias-label-secondary);font-size:13px;margin-top:2px;word-break:break-all}',
+      '.gr-head-actions{display:flex;align-items:center;gap:8px;margin-left:auto;flex:none}',
+      '.gr-pill{display:inline-flex;align-items:center;gap:6px;font-size:12px;color:var(--dsw-alias-label-secondary);border:1px solid var(--dsw-alias-border-l1);border-radius:999px;padding:3px 10px;white-space:nowrap;background:var(--dsw-alias-bg-layer-1)}',
+      '.gr-dot{width:6px;height:6px;border-radius:50%;background:var(--dsw-alias-state-idle-primary)}',
+      '.gr-dot-ok{background:var(--dsw-alias-state-success-primary)}',
+      '.gr-card{background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:12px;padding:20px;display:flex;flex-direction:column;gap:12px;box-sizing:border-box}',
+      '.gr-h2{font-size:15px;font-weight:600;line-height:1.4}',
+      '.gr-body{color:var(--dsw-alias-label-secondary);font-size:13px}',
+      '.gr-meta{font-size:12px;color:var(--dsw-alias-label-secondary)}',
+      '.gr-btn{appearance:none;border:0;border-radius:8px;background:var(--dsw-alias-brand-primary);color:#fff;font:inherit;font-size:13px;font-weight:600;padding:8px 14px;cursor:pointer;display:inline-flex;align-items:center;gap:8px;align-self:flex-start}',
+      '.gr-btn:hover{opacity:.92}',
+      '.gr-btn:disabled{opacity:.5;cursor:default}',
+      '.gr-btn-ghost{background:transparent;color:var(--dsw-alias-label-primary);border:1px solid var(--dsw-alias-border-l2)}',
+      '.gr-btn-sm{padding:5px 10px;font-size:12px;font-weight:500}',
+      '.gr-input,.gr-textarea{width:100%;box-sizing:border-box;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;color:var(--dsw-alias-label-primary);font:inherit;font-size:13px;padding:9px 11px;outline:none}',
+      '.gr-textarea{min-height:96px;resize:vertical;line-height:1.6}',
+      '.gr-input:focus-visible,.gr-textarea:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}',
+      '.gr-row{display:flex;gap:8px;align-items:center;flex-wrap:wrap;min-width:0}',
+      '.gr-err{color:var(--dsw-alias-state-error-primary);font-size:12px;white-space:pre-wrap}',
+      '.gr-ok{color:var(--dsw-alias-state-success-primary)}',
+      '.gr-path{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-radius:6px;padding:2px 6px;word-break:break-all}',
+      '.gr-steps{display:grid;grid-template-columns:repeat(3,1fr);gap:10px}',
+      '.gr-step{border:1px solid var(--dsw-alias-border-l1);border-radius:10px;padding:12px;font-size:12px;color:var(--dsw-alias-label-secondary);background:var(--dsw-alias-bg-base)}',
+      '.gr-step b{display:block;color:var(--dsw-alias-label-primary);font-size:12px;margin-bottom:2px}',
+      '.gr-stats{display:grid;grid-template-columns:repeat(auto-fit,minmax(112px,1fr));gap:10px}',
+      '.gr-stat{border:1px solid var(--dsw-alias-border-l1);border-radius:10px;padding:12px;background:var(--dsw-alias-bg-base);min-width:0}',
+      '.gr-stat b{display:block;font-size:20px;font-weight:600;line-height:1.2}',
+      '.gr-stat span{font-size:12px;color:var(--dsw-alias-label-secondary)}',
+      '.gr-recent{display:flex;flex-direction:column;min-width:0}',
+      '.gr-item{display:flex;align-items:baseline;gap:10px;padding:9px 0;border-bottom:1px solid var(--dsw-alias-border-l1);min-width:0}',
+      '.gr-item:last-child{border-bottom:0}',
+      '.gr-type{flex:none;font-size:11px;color:var(--dsw-alias-label-secondary);border:1px solid var(--dsw-alias-border-l1);border-radius:999px;padding:1px 8px}',
+      '.gr-itemtitle{flex:1 1 auto;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+      '.gr-code{white-space:pre-wrap;word-break:break-word;background:var(--dsw-alias-bg-layer-2);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:10px 12px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px;line-height:1.6;margin:0}',
+      '.gr-foot{border-top:1px solid var(--dsw-alias-border-l1);padding-top:12px;color:var(--dsw-alias-label-secondary);font-size:12px;display:flex;flex-direction:column;gap:4px}',
+      '@media (max-width:560px){.gr-inner{padding:18px 14px 32px}.gr-head{flex-wrap:wrap}.gr-steps{grid-template-columns:1fr}.gr-stats{grid-template-columns:repeat(2,1fr)}.gr-stat:last-child:nth-child(odd){grid-column:1/-1}.gr-btn{align-self:stretch;justify-content:center}}',
+      '@media (prefers-reduced-motion:reduce){.gr-btn{transition:none}}',
+    ].join('\n')
+
+    // ────────────────────────────────────────────────────── registration
+    function apply(ctx) {
+      var locale = ctx.locale
+      if (locale) {
+        try {
+          if (typeof ctx.effect === 'function') {
+            ctx.effect(function () { return locale.register(NS, { zh: ZH, en: EN }) }, 'grove: dictionaries')
+          }
+          if (typeof locale.bind === 'function') boundT = locale.bind(NS)
+        } catch (error) {
+          console.warn('[grove] locale registration failed', error)
+        }
+      }
+      try {
+        services.workspace = ctx.get('uiWorkspace')
+      } catch (error) {
+        services.workspace = null
+      }
+      var slots = ctx.slots
+      if (!slots || typeof slots.inject !== 'function' || typeof slots.register !== 'function') {
+        console.warn('[grove] slots service unavailable; the panel is not mounted')
+        return
+      }
+      slots.inject('main', function () {
+        return slots.register({ name: 'main', key: 'grove', locale: NS }, GrovePage)
+      })
+      slots.inject('sidebar.panellist', function () {
+        return slots.register({
+          name: 'sidebar.panellist', id: 'grove', order: 40,
+          label: function () { return T('menu') }, locale: NS,
+        }, GroveIcon)
+      })
+    }
+
+    return { inject: ['slots', 'locale'], apply: apply }
+  },
+})

package/docs/DETAIL.en.md

@@ -1,41 +1,3 @@
-# Grove
+![The Grove panel between DeepSeek Harness and an Obsidian vault](preview.svg)
 
-Grove connects DeepSeek Harness and Obsidian to help you build knowledge you can revisit and revise, and develop your own judgment over time. The current plugin supports open-ended exploration, user-confirmed saves, and basic research.
-
-- **Explore freely and pursue research when it serves you.** Start with a passing idea and stop whenever you like. Keep an open question for later and decide whether to develop it into a project or a finished work.
-- **Keep the evidence and the history of your thinking.** Record where evidence came from and link it to the version of a claim it supports, challenges, or qualifies. Revisit that record when your judgment changes.
-- **Think with AI and stay in control of your knowledge.** AI can ask questions, offer other explanations, and draft notes. You decide what to adopt, save, and share. Your saved knowledge lives in your own Obsidian vault as Markdown.
-
-## What it provides
-
-Three model tools, registered inside the host:
-
-| Tool | Purpose | Boundary |
-| --- | --- | --- |
-| `grove_role` | Returns the collaboration guidance for a role you named explicitly (`thinking` / `knowledge` / `research` / `critical` / `creation`) | Read-only text; never touches the vault |
-| `grove_propose` | Drafts one proposal from your request and writes it as `.proposal.json` | Does not create an asset; only `grove accept` in your terminal saves it |
-| `grove_read` | Reads one asset you explicitly shared | Only IDs listed in `GROVE_READABLE_IDS` |
-
-There are ten asset types: inspiration, question, concept, theory, claim, evidence, method, output, exploration and research. Research projects and evidence are recorded through the terminal commands; the model may only draft the other types.
-
-## How to use it
-
-1. Configure the vault: the plugin config field `vault`, or the `GROVE_VAULT` environment variable. It must be an **absolute path to a real directory**; symlinks in the path are rejected.
-2. Talk to the agent; ask it to call `grove_role` when you want a different way of collaborating.
-3. To keep part of a discussion, ask it to call `grove_propose`, passing the conversation reference you want saved as `origin`.
-4. In your terminal, `grove preview <draft-id>` to review, `grove accept <draft-id>` and type `SAVE` to save, or `grove discard <draft-id>`.
-5. `grove list` / `grove show <asset-id> --version <N>` to look back; `grove update` writes a new version and leaves the old version's evidence links on it.
-
-## Where the data lives
-
-Everything is under `<vault>/Grove/`: one file per asset, `<id>.v<version>.md`, with YAML frontmatter, a Markdown body and Obsidian wikilinks; dot-prefixed `.proposal.json` files beside them are drafts. There is no database — copying the whole `Grove/` folder is the backup and the migration.
-
-## Known limitations
-
-- Evidence records only the source identifier and locator you type (`--source` / `--locator`). No attachment management, no automatic session locating.
-- No dedicated Web UI: the surface is the in-session tools plus the terminal CLI.
-- Saving must happen in an interactive terminal (`grove accept` asks you to type `SAVE`); the model cannot save on your behalf.
-- Asset bodies are not given to the model by default; sharing requires `GROVE_READABLE_IDS` in advance, and turning sharing off needs a host restart.
-- One note is capped at 1 MiB and a draft body at 128 KiB; `grove_read` refuses assets outside the sharing list and archived assets.
-- The `grove` command comes from the package's `bin` and needs a global install; installing the plugin into a profile does not put it on `PATH`.
-- Compatible with dsh `>=0.2.2-rc.1 <0.3.0`.
+Open Grove from the left sidebar, connect your own Obsidian vault, and keep what you explore as Markdown notes you can revisit and revise.

package/docs/DETAIL.zh.md

@@ -1,41 +1,3 @@
-# Grove（知林）
+![DeepSeek Harness 与 Obsidian vault 之间的 Grove 面板](preview.svg)
 
-Grove 是连接 DeepSeek Harness 与 Obsidian 的个人知识成长插件，帮助你积累可回看、可修正的知识，在长期探索中形成自己的判断。当前版本支持自由探索、自主保存和基础研究。
-
-- **自由探索，按需研究。** 从一个念头开始，随时停下。你可以留下开放问题，等值得深究时再开展研究，成果由你决定。
-- **保留依据和修订过程。** 记录证据出处，把支持、反驳或限定的证据连到具体版本，以便重查和修正判断。
-- **AI 协助思考，你掌握判断和知识。** AI 可以追问、提出不同解释和起草。你决定采纳、保存和分享什么，留下的知识以 Markdown 保存在自己的 Obsidian vault 中。
-
-## 提供什么
-
-三个模型工具，注册在宿主内：
-
-| 工具 | 作用 | 边界 |
-| --- | --- | --- |
-| `grove_role` | 返回你明确点名的协作角色指引（`thinking` / `knowledge` / `research` / `critical` / `creation`） | 只读文本，不碰 vault |
-| `grove_propose` | 按你的要求起草一条草稿，写成 `.proposal.json` | 不创建资产；要你在终端执行 `grove accept` 才落盘 |
-| `grove_read` | 读取一条你显式分享的资产 | 只认 `GROVE_READABLE_IDS` 白名单里的 ID |
-
-资产类型共十种：灵感、问题、概念、理论、判断、证据、方法、成果、探索、研究。研究与证据走终端命令，模型只能起草其余类型。
-
-## 怎么用
-
-1. 配置 vault：插件配置里的 `vault`，或环境变量 `GROVE_VAULT`。必须是**绝对路径的真实目录**；路径里的 symlink 会被拒绝。
-2. 在会话里对话，需要时让模型调用 `grove_role` 切换协作方式。
-3. 想留下讨论时，让模型调用 `grove_propose` 起草，并把你要保存的会话引用作为 `origin` 传入。
-4. 在终端 `grove preview <草稿ID>` 看内容，`grove accept <草稿ID>` 并输入 `SAVE` 落盘，或用 `grove discard` 丢弃。
-5. `grove list` / `grove show <资产ID> --version <N>` 回看；`grove update` 写入新版本，旧版本的证据关系留在旧版本上。
-
-## 数据放在哪
-
-全在 `<vault>/Grove/`：一条资产一个文件 `<id>.v<版本>.md`，YAML frontmatter + Markdown 正文 + Obsidian 双链；点号开头的 `.proposal.json` 是同目录的草稿。没有数据库，复制整个 `Grove/` 就是备份和迁移。
-
-## 已知限制
-
-- 证据只记录你填写的来源标识与定位（`--source` / `--locator`），没有附件管理，也不自动定位会话。
-- 没有专用 Web 界面：交互面是会话里的工具加终端 CLI。
-- 保存必须在交互式终端完成（`grove accept` 要手输 `SAVE`），模型不能代你落盘。
-- 默认不把资产正文交给模型；分享要预先设置 `GROVE_READABLE_IDS`，取消分享后需重启宿主。
-- 单条笔记上限 1 MiB，草稿正文上限 128 KiB；`grove_read` 拒绝白名单外和已归档的资产。
-- `grove` 命令来自 npm 全局安装的 `bin`；把插件装进某个 profile 不会把它加进 PATH。
-- 兼容 dsh `>=0.2.2-rc.1 <0.3.0`。
+安装后从左侧菜单的 Grove 打开面板，连接自己的 Obsidian vault，把探索留下的笔记保存在可回看、可修订的 Markdown 里。

package/docs/preview.svg

@@ -0,0 +1,46 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="640" height="300" viewBox="0 0 640 300" role="img" aria-label="Grove panel between DeepSeek Harness and an Obsidian vault">
+  <rect width="640" height="300" rx="20" fill="#F7F4EC"/>
+  <rect x="20" y="20" width="600" height="260" rx="16" fill="#FBF9F3" stroke="#E4DCCC" stroke-width="1.5"/>
+
+  <!-- DeepSeek Harness window -->
+  <g>
+    <rect x="44" y="70" width="164" height="160" rx="12" fill="#FFFFFF" stroke="#C3D3C9" stroke-width="2"/>
+    <path d="M44 82a12 12 0 0 1 12-12h140a12 12 0 0 1 12 12v8H44z" fill="#E8EFEA"/>
+    <circle cx="60" cy="80" r="3" fill="#5FA37E"/>
+    <circle cx="72" cy="80" r="3" fill="#C98A3B"/>
+    <circle cx="84" cy="80" r="3" fill="#C3D3C9"/>
+    <rect x="60" y="112" width="98" height="16" rx="8" fill="#E8EFEA"/>
+    <rect x="60" y="144" width="126" height="16" rx="8" fill="#DCEAE1"/>
+    <rect x="60" y="180" width="72" height="14" rx="7" fill="#2F7D5B" opacity="0.85"/>
+  </g>
+
+  <!-- arrows -->
+  <g stroke="#C98A3B" stroke-width="3" stroke-linecap="round" stroke-dasharray="7 7" fill="none">
+    <path d="M218 150h54"/>
+    <path d="M368 150h54"/>
+  </g>
+  <path d="M276 143l10 7-10 7z" fill="#C98A3B"/>
+  <path d="M426 143l10 7-10 7z" fill="#C98A3B"/>
+
+  <!-- Grove mark -->
+  <g transform="translate(282 100) scale(1.9)">
+    <path d="M16.9 30.4h2.2l-.65-12.3h-.9z" fill="#1B3A2E"/>
+    <path d="M18.4 19c2.2-6.5 8.3-9.4 10.5-8.15-1 5.3-4.9 8.45-10.5 8.15Z" fill="#2F7D5B"/>
+    <path d="M17.6 23c-2.2-5.1-6.5-7.3-8.5-6.3.7 4.1 4.3 6.3 8.5 6.3Z" fill="#5FA37E"/>
+    <path d="M15.4 31.5h5.2" stroke="#C98A3B" stroke-width="2.2" stroke-linecap="round" fill="none"/>
+  </g>
+
+  <!-- Obsidian vault window -->
+  <g>
+    <rect x="432" y="70" width="164" height="160" rx="12" fill="#FFFFFF" stroke="#C3D3C9" stroke-width="2"/>
+    <path d="M432 82a12 12 0 0 1 12-12h60a12 12 0 0 1 12 12v6h-84z" fill="#E8EFEA"/>
+    <rect x="448" y="104" width="52" height="34" rx="5" fill="#E8EFEA"/>
+    <rect x="508" y="104" width="52" height="34" rx="5" fill="#DCEAE1"/>
+    <rect x="448" y="146" width="52" height="34" rx="5" fill="#DCEAE1"/>
+    <rect x="508" y="146" width="52" height="34" rx="5" fill="#E8EFEA"/>
+    <rect x="448" y="188" width="112" height="24" rx="5" fill="#F1EEE4" stroke="#E4DCCC"/>
+  </g>
+
+  <!-- amber baseline -->
+  <path d="M300 214h40" stroke="#C98A3B" stroke-width="4" stroke-linecap="round"/>
+</svg>

package/locale/en.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "title": "Grove",
-    "description": "Explore with AI in DeepSeek Harness and pursue research with traceable evidence. You choose what to save and share. Keep knowledge you can revisit and revise in your own Obsidian vault.",
+    "description": "Open Grove from the left sidebar after installing: connect your Obsidian vault, capture a first idea, then return to the conversation and let AI question it, compare explanations, and look for counterexamples. Notes stay as Markdown in the vault's Grove/ folder, ready to revisit, revise, and share; content drafted by AI is saved only after you confirm it in the terminal. Grove reads and writes only that subfolder.",
     "detail": "docs/DETAIL.en.md"
   }
 }

package/locale/zh.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "title": "Grove（知林）",
-    "description": "在 DeepSeek Harness 中与 AI 自由探索，按需开展有据可查的研究。你决定保存和分享什么，知识以可回看、可修正的 Markdown 笔记留在自己的 Obsidian vault。",
+    "description": "安装后从左侧菜单的 Grove 打开面板：连接你的 Obsidian vault，写下第一条灵感，再回到会话里让 AI 陪你追问、比较解释、查找反例。笔记以 Markdown 留在 vault 的 Grove/ 文件夹，可回看、修订和分享；AI 起草的内容需要你在终端确认后才落盘。Grove 只读写这个子文件夹。",
     "detail": "docs/DETAIL.zh.md"
   }
 }

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "dsh-grove",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Explore with AI in DeepSeek Harness and grow knowledge you can revisit and revise in your own Obsidian vault",
   "license": "MIT",
   "type": "module",
   "main": "./src/plugin.js",
   "exports": {
     ".": "./src/plugin.js",
+    "./client": "./client.js",
     "./package.json": "./package.json",
     "./locale/*.json": "./locale/*.json",
     "./icon": "./icon.svg"
@@ -17,11 +18,13 @@
   },
   "files": [
     "src",
+    "client.js",
     "cordis.patch.yml",
     "locale/*.json",
     "icon.svg",
     "docs/DETAIL.en.md",
-    "docs/DETAIL.zh.md"
+    "docs/DETAIL.zh.md",
+    "docs/preview.svg"
   ],
   "engines": {
     "node": ">=22",
@@ -40,6 +43,14 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-layout"
+      ]
     }
   },
   "peerDependencies": {

package/src/plugin.js

@@ -1,6 +1,7 @@
 import { defineTool } from '@deepseek-ai/dsh-tools'
 import { Vault, types } from './vault.js'
 import { propose, roles } from './proposals.js'
+import { registerRoutes } from './server.js'
 
 export const name = 'grove'
 export const inject = ['tools']
@@ -10,10 +11,30 @@ const output = {
   render: (_args, value) => [{ type: 'text', text: value }],
 }
 
+/** The vault a row configured, else GROVE_VAULT. The panel reports which one is in use. */
+function configuredVault(config) {
+  const fromConfig = typeof config.vault === 'string' ? config.vault.trim() : ''
+  const fromEnv = (process.env.GROVE_VAULT ?? '').trim()
+  if (fromConfig !== '') return { path: fromConfig, source: 'config' }
+  if (fromEnv !== '') return { path: fromEnv, source: 'env' }
+  return { path: undefined, source: null }
+}
+
 export function apply(ctx, config = {}) {
-  const path = config.vault ?? process.env.GROVE_VAULT
-  if (!path) return
-  const vault = new Vault(path)
+  const { path, source } = configuredVault(config)
+
+  // The panel routes stay registered without a vault so the cold start can pick one.
+  if (typeof ctx.inject === 'function') registerRoutes(ctx, { current: () => configuredVault(config) })
+
+  if (path === undefined) return
+  let vault
+  try {
+    vault = new Vault(path)
+  } catch (error) {
+    // An unusable path must not take the whole plugin down: the panel shows the problem instead.
+    console.warn(`[grove] ${error.message}`)
+    return
+  }
   const allowed = new Set(config.readableIds ?? (process.env.GROVE_READABLE_IDS ?? '').split(',').map(id => id.trim()).filter(Boolean))
 
   ctx.tools.register(defineTool({

package/src/server.js

@@ -0,0 +1,180 @@
+/** Same-origin routes and vault operations for the Grove panel. */
+import { constants } from 'node:fs'
+import { access, realpath, stat } from 'node:fs/promises'
+import { isAbsolute, join, resolve } from 'node:path'
+import { Vault } from './vault.js'
+
+export const routes = {
+  status: '/api/grove/status',
+  config: '/api/grove/config',
+  capture: '/api/grove/capture',
+}
+
+/** Largest body the panel may post, matching the proposal limit. */
+const maxBody = 128 * 1024
+
+function coded(code, message) {
+  return Object.assign(new Error(message), { code })
+}
+
+export function json(body, status = 200) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' },
+  })
+}
+
+function statusOf(error) {
+  switch (error.code) {
+    case 'invalid-path':
+    case 'not-directory':
+    case 'symlink':
+    case 'invalid-body':
+      return 400
+    case 'not-configured':
+      return 409
+    case 'too-large':
+      return 413
+    default:
+      return 500
+  }
+}
+
+function failure(error) {
+  const code = typeof error?.code === 'string' ? error.code : 'internal'
+  return json({ error: { code, message: error instanceof Error ? error.message : String(error) } }, statusOf({ code }))
+}
+
+/** Validate a folder a person chose for the vault. Rejects relative paths and symlinked directories. */
+export async function inspectVault(value) {
+  if (typeof value !== 'string' || value.trim() === '') throw coded('invalid-path', 'Choose a folder')
+  if (!isAbsolute(value.trim())) throw coded('invalid-path', 'The vault path must be absolute')
+  const path = resolve(value.trim())
+  const info = await stat(path).catch(() => null)
+  if (info === null || !info.isDirectory()) throw coded('not-directory', 'The vault path is not a directory')
+  if (await realpath(path) !== path) throw coded('symlink', 'The vault path must be a real directory, not a symlink')
+  const looksLikeVault = await stat(join(path, '.obsidian')).then(entry => entry.isDirectory(), () => false)
+  return { path, looksLikeVault }
+}
+
+/** Metadata the panel needs to choose between the cold-start and overview states. Never returns note bodies. */
+export async function vaultStatus(path, source) {
+  const empty = {
+    configured: false, source: null, vault: null, usable: false, writable: false,
+    looksLikeVault: false, counts: { total: 0 }, recent: [],
+  }
+  if (!path) return empty
+  let usable = false
+  try {
+    usable = (await stat(path)).isDirectory() && await realpath(path) === path
+  } catch {
+    usable = false
+  }
+  if (!usable) return { ...empty, configured: true, source, vault: path }
+  const writable = await access(path, constants.W_OK).then(() => true, () => false)
+  const looksLikeVault = await stat(join(path, '.obsidian')).then(entry => entry.isDirectory(), () => false)
+  const vault = new Vault(path)
+  const inventory = await vault.inventory().catch(() => new Map())
+  const latest = [...inventory].map(([id, versions]) => [id, Math.max(...versions)])
+  const notes = []
+  for (const [id, version] of latest.slice(0, 300)) {
+    try {
+      notes.push((await vault.get(id, version)).meta)
+    } catch {
+      // A note that no longer parses is skipped; the overview still opens.
+    }
+  }
+  const counts = { total: latest.length }
+  for (const meta of notes) counts[meta.type] = (counts[meta.type] ?? 0) + 1
+  const recent = notes
+    .sort((a, b) => String(b.modified ?? b.created ?? '').localeCompare(String(a.modified ?? a.created ?? '')))
+    .slice(0, 6)
+    .map(({ id, title, type, version, status, modified, created }) => ({
+      id, title, type, version, ...(status === undefined ? {} : { status }), at: modified ?? created ?? null,
+    }))
+  return {
+    configured: true, source, vault: path, usable, writable, looksLikeVault,
+    counts, recent, sampled: latest.length > notes.length,
+  }
+}
+
+/** Create the first note from the panel. Only inspirations: research and evidence stay in the terminal. */
+export async function capture(vaultPath, input) {
+  if (!vaultPath) throw coded('not-configured', 'Grove has no vault yet')
+  const body = input?.body
+  if (typeof body !== 'string' || body.trim() === '') throw coded('invalid-body', 'Write something first')
+  if (Buffer.byteLength(body) > maxBody) throw coded('too-large', 'The note is too large')
+  const vault = new Vault(vaultPath)
+  const note = await vault.create({ type: 'inspiration', body, title: input?.title })
+  const folder = await vault.folder()
+  return {
+    id: note.meta.id, type: note.meta.type, title: note.meta.title, version: 1,
+    path: join(folder, `${note.meta.id}.v1.md`),
+  }
+}
+
+/** Persist the chosen vault into this plugin row's configuration. */
+export function saveVault(ctx, path) {
+  const entry = ctx.fiber?.entry
+  const editor = ctx.get?.('configEditor')
+  if (!entry || !editor || typeof editor.edit !== 'function') {
+    return Promise.reject(coded('save-unavailable', 'This profile cannot save plugin configuration'))
+  }
+  return editor.edit(entry, current => ({ ...current, vault: path }))
+}
+
+async function readJson(request) {
+  try {
+    return await request.json()
+  } catch {
+    throw coded('invalid-body', 'Expected a JSON body')
+  }
+}
+
+/**
+ * Register the panel's same-origin routes. They stay available before a vault is configured,
+ * so the page can run its cold start.
+ * @param ctx - the plugin context.
+ * @param options - current vault path/source getter.
+ */
+export function registerRoutes(ctx, options) {
+  const delay = Number.isFinite(options.saveDelay) ? options.saveDelay : 100
+  ctx.inject(['connection'], (scoped) => {
+    const connection = scoped.get('connection')
+    if (!connection?.fetch || typeof connection.fetch.register !== 'function') return
+    const route = (path, methods, fetch) => {
+      scoped.effect(
+        () => connection.fetch.register({ path, methods, requestBody: 'buffered', fetch }),
+        `grove: ${path}`,
+      )
+    }
+    route(routes.status, ['GET'], async () => {
+      const { path, source } = options.current()
+      return json(await vaultStatus(path, source))
+    })
+    route(routes.capture, ['POST'], async request => {
+      try {
+        const body = await readJson(request)
+        return json(await capture(options.current().path, body))
+      } catch (error) {
+        return failure(error)
+      }
+    })
+    route(routes.config, ['POST'], async request => {
+      let path
+      try {
+        path = (await inspectVault((await readJson(request))?.path)).path
+      } catch (error) {
+        return failure(error)
+      }
+      // Answer before the configuration reload replaces this plugin instance, otherwise the
+      // response can be cut halfway. The page polls status until the new vault is live.
+      setTimeout(() => {
+        saveVault(ctx, path).catch(error => {
+          console.warn(`[grove] could not save the vault path: ${error.message}`)
+        })
+      }, delay)
+      return json({ ok: true, pending: true, vault: path })
+    })
+  })
+}