dsh-reference-anything 0.2.0 → 0.2.1

package/README.md

@@ -24,7 +24,7 @@ One `@` to reference them all.
 
 Within the unified `@` menu of DeepSeek Harness (DSH), reference commands, Skills, workspace files/folders, DSH sessions, and historical conversations from ChatGPT, Claude, Gemini, DeepSeek, Grok, and Kimi.
 
-This plugin reuses already-logged-in AI conversation windows via OpenCLI and only keeps conversation titles locally. The agent decides whether and when to fetch the remote conversation content on demand.
+This plugin uses OpenCLI to access historical conversations through AI chat sessions that are already logged in. Only conversation titles are stored locally; when the full content is needed, the agent fetches it from the remote platform on demand.
 
 ## News
 
@@ -35,24 +35,12 @@ This plugin reuses already-logged-in AI conversation windows via OpenCLI and onl
 ## Roadmap
 
 - [ ] Support referencing historical conversations from other local agents
-- [ ] Support more AI conversation platforms (ideas welcome!)
+- [ ] Support more keyword matching rules, including blacklists and whitelists, especially for file search
+- [ ] Support more AI conversation platforms
+- [ ] Provide a quieter AI conversation synchronization mechanism
 - [ ] Support referencing applications or browser windows currently open on the computer
 - [ ] More ideas are welcome in Issues
 
-## Architecture
-
-```text
-DSH Web @Conversations
-        ↕ Host Remote
-DSH Host + reference_anything local mirror
-        ↕ execFile(opencli, argv)
-opencli-plugin-dsh-chat-history
-        ↕ OpenCLI daemon + official Browser Bridge
-ChatGPT / Claude / Gemini / DeepSeek / Grok / Kimi
-```
-
-This does not include the legacy standalone DeepSeek CDP / `--remote-debugging-port` collector. All six platforms use the OpenCLI Provider adapter path, avoiding duplicate browser-reading implementations.
-
 ## Installation
 
 Prerequisites:
@@ -90,6 +78,9 @@ Browser extensions cannot be silently installed from a webpage; confirm the inst
 4. Type `@` in the input box and choose from the `Files and folders`, `DSH sessions`, or `External conversations` groups.
 5. Type a keyword to filter candidates, for example `@cache-design`.
 
+> [!WARNING]
+> To protect your account and conversation data, external conversations are imported and synchronized through OpenCLI using your existing logged-in browser session. A browser window may temporarily open during use or synchronization, and it may display OpenCLI debugging information. This is expected—please do not be alarmed or close the window manually; wait for the operation to finish.
+
 ### Search
 
 The `@` menu contains five groups: `Commands`, `Skills`, `Files and folders`, `DSH sessions`, and `External conversations`. The first two appear only when `@` is at the beginning of the draft. Each group shows up to five results when the query is empty, and up to eight after a query is entered.
@@ -151,7 +142,21 @@ Opening the source URL happens only in the UI; the URL is never injected into mo
 - Without a type prefix, all groups are searched at once.
 - For full browsing across groups: sessions are listed on the settings page, while commands and skills use the native `/` panel.
 
-## Model-facing Protocol
+## How External Conversation References Work
+
+```text
+DSH Web @Conversations
+        ↕ Host Remote
+DSH Host + reference_anything local mirror
+        ↕ execFile(opencli, argv)
+opencli-plugin-dsh-chat-history
+        ↕ OpenCLI daemon + official Browser Bridge
+ChatGPT / Claude / Gemini / DeepSeek / Grok / Kimi
+```
+
+This does not include the legacy standalone DeepSeek CDP / `--remote-debugging-port` collector. All six platforms use the OpenCLI Provider adapter path, avoiding duplicate browser-reading implementations.
+
+### Model-facing Protocol
 
 A reference produces an untrusted-data envelope alongside the current user request. The initial envelope contains only pointers and never the conversation body:
 
@@ -187,7 +192,7 @@ A reference produces an untrusted-data envelope alongside the current user reque
 - Sync stores attachment metadata and same-origin locators, not temporary signed URLs. Attachments are classified as `image` or `file`; empty URLs and site-root paths are not marked as available.
 - Unreadable attachments add a model-facing notice such as `[User attached 1 image; image contents were not included]` without altering the original conversation text.
 
-## Sync and Storage
+### Sync and Storage
 
 The `reference_anything` storage domain contains: