dsh-reference-anything 0.5.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -77,9 +77,9 @@ Type `@`, search across enabled sources, and insert the selected reference into
77
77
 
78
78
  ## 📰 News
79
79
 
80
- ### 0.5.0 Preview · Feature Demos
81
-
82
- This update also adds unified local pagination, resumable long-text reads and message/tool search, rechecks source switches on every read, and moves non-local tools to external_reference_list/read. See the [release and migration guide](./docs/release-v0.5.0.md). Version 0.5.0 is not yet published.
80
+ ### 0.5.0 Preview · Feature Demos
81
+
82
+ This update also adds unified local pagination, resumable long-text reads and message/tool search, rechecks source switches on every read, and moves non-local tools to external_reference_list/read. See the [release and migration guide](./docs/release-v0.5.0.md). See also the [v0.5.1 compatibility fixes](./docs/release-v0.5.1.md).
83
83
 
84
84
  #### Import Past Conversations into DSH and Pick Up Where You Left Off
85
85
 
@@ -158,10 +158,16 @@ You can now navigate folder hierarchies directly inside the `@` file menu:
158
158
 
159
159
  ## 📦 Installation
160
160
 
161
- The released version is **v0.5.0**, with a declared minimum DSH SDK version of **`0.2.0-rc.2`**.
161
+ The released version is **v0.5.1**, with a declared minimum DSH SDK version of **`0.2.0-rc.2`**.
162
162
 
163
163
  ### Official desktop app
164
164
 
165
+ Reference Anything handles native references by default. If you explicitly enable the official `ui-reference` plugin in your profile, restart DSH and reload the page: the official plugin handles native references, and RA hides its duplicate file and DSH session candidates. Previously inserted RA file/session references still work; other RA sources are unaffected.
166
+
167
+ Official file and session sections follow RA's visibility switches and independent ordering, and retain its collapsed item counts and expand/collapse actions, including arrow-key, Enter, and Tab navigation. The official plugin still handles reference insertion, copying, and previews. Select “No collapse (native)” to show the full list; unsupported candidate formats also fall back to the full list.
168
+
169
+ After Tab enters a file directory, RA pauses searches in other sources and the menu shows only files. Returning to the root restores other sources. Expand/collapse actions use gray text.
170
+
165
171
  Download the official desktop app from the [DeepSeek Harness website](https://www.deepseek.com/en/harness/), open **Plugins → Add plugin**, enter `dsh-reference-anything`, and follow the prompts to install and enable it. Restart DSH if asked, then open **Settings → Reference Anything**.
166
172
 
167
173
  Desktop uses a separate plugin profile; plugins installed in the Web profile are not automatically enabled in Desktop. See the [official desktop documentation](https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/desktop/README.md).
@@ -180,7 +186,7 @@ dsh plugin --profile web add dshmarket
180
186
  dsh plugin --profile web add dsh-reference-anything
181
187
  ```
182
188
 
183
- The installed version depends on the selected channel; this README describes v0.5.0.
189
+ The installed version depends on the selected channel; this README describes v0.5.1.
184
190
 
185
191
  ### Optional: Connect web AI chats
186
192
 
package/cordis.patch.yml CHANGED
@@ -8,6 +8,8 @@
8
8
  # sources over the same official Remotes. Disabling only this Client source
9
9
  # keeps the official file/session services. RA also owns the native
10
10
  # "reference" codec and the newer Host's file/folder message renderers.
11
+ # If a profile explicitly enables ui-reference, RA defers those registrations
12
+ # and hides its duplicate file/session candidates (saved RA chips still work).
11
13
  disabled: true
12
14
 
13
15
  - insert:
package/lib/client.js CHANGED
@@ -1,4 +1,4 @@
1
1
  [diffend] Oversized file quarantined before diffing.
2
2
  name: package/lib/client.js
3
- size: 34814067 bytes
4
- sha256: e5a47a5f45b512ffe3cb49ad66f5a26fe48dbc41e27333c42cde1ffdca41405b
3
+ size: 34825059 bytes
4
+ sha256: e376d2ab132c59c32108a4b2690cac03f4b2e29eb0919b25925825add4ae3092
package/lib/host.js CHANGED
@@ -107,6 +107,7 @@ export class ReferenceAnythingRemote extends TypertRemoteService {
107
107
  const owner = agent.session.header.id;
108
108
  // Scope before scanning and deduplicate explicit roots repeated by settings.
109
109
  const scannedRequests = new Set();
110
+ const matchingRequests = new Set();
110
111
  for (const request of requests) {
111
112
  const kind = agentKind(request.format);
112
113
  if ((input.kind && kind !== input.kind) || !(settings.enabledAgents ?? ALL_LOCAL_AGENTS).includes(kind))
@@ -128,6 +129,7 @@ export class ReferenceAnythingRemote extends TypertRemoteService {
128
129
  if ((input.kind && agentKind(row.format) !== input.kind) || seen.has(key) || (policy.scope === 'workspace' && !inWorkspace(row.cwd ?? '', agent.session.header.cwd ?? process.cwd())))
129
130
  continue;
130
131
  seen.add(key);
132
+ matchingRequests.add(requestKey);
131
133
  discovered.push({ ...row });
132
134
  }
133
135
  }
@@ -138,7 +140,8 @@ export class ReferenceAnythingRemote extends TypertRemoteService {
138
140
  }
139
141
  if (importer?.scanDiscover) {
140
142
  const statuses = new Map();
141
- await Promise.all([...scannedRequests].map(async (key) => {
143
+ // Import status is only needed for matched references; avoid competing corpus scans on every keystroke.
144
+ await Promise.all([...matchingRequests].map(async (key) => {
142
145
  const [format, path] = JSON.parse(key);
143
146
  try {
144
147
  const result = await this.agentScans.read(importer, '', key, () => importer.scanDiscover({ format, ...(path ? { path } : {}) }, AbortSignal.timeout(2_000)), AbortSignal.any([signal, AbortSignal.timeout(2_000)]));
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-reference-anything",
3
- "version": "0.5.0",
3
+ "version": "0.5.1",
4
4
  "description": "Reference files, sessions, commands, skills, and historical external AI chats from the DSH @ menu.",
5
5
  "icon": "./images/logo-icon.png",
6
6
  "license": "MIT",
@@ -1,36 +1,36 @@
1
- [
2
- {
3
- "title": "引用,或导入后继续",
4
- "description": "找到本地 Agent 历史会话后,按 Enter 引用到当前对话;想继续之前的工作,按 Tab 打开操作菜单,确认导入完整历史后在 DSH 中继续。",
5
- "media": "demos/agent-import.gif",
6
- "alt": "引用,或导入后继续操作演示"
7
- },
8
- {
9
- "title": "升级 Chat Import,启用导入与交接",
10
- "description": "如果 Chat Import 版本缺少导入或摘要接口,菜单和设置会提示升级。点击升级按钮,安装完成后按提示重启 DSH。演示中的版本号与执行结果为示例。",
11
- "media": "demos/chat-import-upgrade.gif",
12
- "alt": "升级 Chat Import,启用导入与交接操作演示"
13
- },
14
- {
15
- "title": "本地插件,也能直接引用",
16
- "description": "输入 @plugin: 查看本地插件及其状态,继续输入名称筛选。按 Enter 将插件目录插入为引用,让 Agent 基于目录检查配置和实现。",
17
- "media": "demos/local-plugins.gif",
18
- "alt": "本地插件,也能直接引用操作演示"
19
- },
20
- {
21
- "title": "用自己的快捷词找到需要的来源",
22
- "description": "在设置中自定义快捷词,多个词用逗号分隔。多个来源使用同一个词时,可以一起搜索;用 codex 等具体来源快捷词,则能精确限定范围。",
23
- "media": "demos/shortcuts.gif",
24
- "alt": "用自己的快捷词找到需要的来源操作演示"
25
- },
26
- {
27
- "title": "Tab 浏览目录,Enter 引用目录",
28
- "description": "在 @ 文件菜单中,按 Tab 进入目录继续浏览,按 Enter 引用选中的目录。引用保留文件夹图标与目录路径,方便辨认交给 Agent 的内容。",
29
- "media": "demos/folders.gif",
30
- "alt": "Tab 浏览目录,Enter 引用目录操作演示"
31
- },
32
- {
33
- "title": "未来更新预告",
34
- "description": "未来计划带来:\n\n1. 不依赖 OpenCLI 的静默网页端对话同步\n2. 更强大的会话搜索\n3. 更实用的 @云盘权限\n4. @电脑窗口功能\n\n这个插件靠用爱发电持续维护。如果它对你有帮助,欢迎到 GitHub 点一颗 Star 支持!也欢迎有时间、有能力的朋友提交 Issue,反馈问题和建议,或通过 PR 一起完善插件。感谢每一份支持。\n\n[前往 GitHub · Star / Issue / PR](https://github.com/Chael-Chael/dsh-reference-anything)"
35
- }
1
+ [
2
+ {
3
+ "title": "引用,或导入后继续",
4
+ "description": "找到本地 Agent 历史会话后,按 Enter 引用到当前对话;想继续之前的工作,按 Tab 打开操作菜单,确认导入完整历史后在 DSH 中继续。",
5
+ "media": "demos/agent-import.gif",
6
+ "alt": "引用,或导入后继续操作演示"
7
+ },
8
+ {
9
+ "title": "升级 Chat Import,启用导入与交接",
10
+ "description": "如果 Chat Import 版本缺少导入或摘要接口,菜单和设置会提示升级。点击升级按钮,安装完成后按提示重启 DSH。演示中的版本号与执行结果为示例。",
11
+ "media": "demos/chat-import-upgrade.gif",
12
+ "alt": "升级 Chat Import,启用导入与交接操作演示"
13
+ },
14
+ {
15
+ "title": "本地插件,也能直接引用",
16
+ "description": "输入 @plugin: 查看本地插件及其状态,继续输入名称筛选。按 Enter 将插件目录插入为引用,让 Agent 基于目录检查配置和实现。",
17
+ "media": "demos/local-plugins.gif",
18
+ "alt": "本地插件,也能直接引用操作演示"
19
+ },
20
+ {
21
+ "title": "用自己的快捷词找到需要的来源",
22
+ "description": "在设置中自定义快捷词,多个词用逗号分隔。多个来源使用同一个词时,可以一起搜索;用 codex 等具体来源快捷词,则能精确限定范围。",
23
+ "media": "demos/shortcuts.gif",
24
+ "alt": "用自己的快捷词找到需要的来源操作演示"
25
+ },
26
+ {
27
+ "title": "Tab 浏览目录,Enter 引用目录",
28
+ "description": "在 @ 文件菜单中,按 Tab 进入目录继续浏览,按 Enter 引用选中的目录。引用保留文件夹图标与目录路径,方便辨认交给 Agent 的内容。",
29
+ "media": "demos/folders.gif",
30
+ "alt": "Tab 浏览目录,Enter 引用目录操作演示"
31
+ },
32
+ {
33
+ "title": "未来更新预告",
34
+ "description": "未来计划带来:\n\n1. 不依赖 OpenCLI 的静默网页端对话同步\n2. 更强大的会话搜索\n3. 更实用的 @云盘权限\n4. @电脑窗口功能\n\n这个插件靠用爱发电持续维护。如果它对你有帮助,欢迎到 GitHub 点一颗 Star 支持!也欢迎有时间、有能力的朋友提交 Issue,反馈问题和建议,或通过 PR 一起完善插件。感谢每一份支持。\n\n[前往 GitHub · Star / Issue / PR](https://github.com/Chael-Chael/dsh-reference-anything)"
35
+ }
36
36
  ]
@@ -1,65 +1,65 @@
1
- [
2
- {
3
- "title": "把历史对话直接“搬”进 DSH,无缝接着聊",
4
- "description": "以前想接着别的本地会话继续聊,要么得来回复制粘贴聊天记录,要么只能把旧对话当成静态背景资料。\n\n现在,在 **@** 菜单里找到本地历史会话,你有两种方式处理它:\n- **只当参考资料(按 **Enter**)**:直接引用该会话;\n- **接着往下聊(按 **Tab**)**:在弹出的菜单中选择**导入**并确认,就能把整段历史记录直接搬进 DSH,顺着之前的上下文继续对话!(如果觉得每次确认太麻烦,也可以在设置中关闭二次确认,一步到位)\n\n> 💡 **提示**:使用导入功能需安装并启用 **dsh-chat-import**(0.26.1 或更高兼容版本)。",
5
- "media": "demos/agent-import.gif",
6
- "alt": "Enter 引用会话,Tab 打开操作菜单,确认后展示模拟导入的历史;使用虚构数据。",
7
- "en": {
8
- "title": "Import Past Conversations into DSH and Pick Up Where You Left Off",
9
- "description": "Want to continue an existing local session without copying and pasting chat logs or treating old threads purely as static context?\n\nNow, when you find a local session in the **@** menu, you have two ways to use it:\n- **Reference as context (**Enter**)**: Insert the session directly as a reference;\n- **Import and continue chatting (**Tab**)**: Open the action menu, select **Import**, and confirm to bring the entire conversation history into DSH and keep chatting seamlessly! (Prefer a faster workflow? You can disable the confirmation prompt in Settings.)\n\n> 💡 **Note**: Importing requires **dsh-chat-import** v0.26.1 or a compatible newer version to be installed and enabled.",
10
- "alt": "Press Enter to reference a session, or Tab to open the action menu and import history; uses mock data."
11
- }
12
- },
13
- {
14
- "title": "菜单内一键升级配套插件,不用手动折腾",
15
- "description": "如果提示 **dsh-chat-import** 版本太旧、用不了“对话导入”或“交接摘要”,不用自己再去后台找安装包手动更新了。\n\n直接在菜单里点击**升级提示**,即可一键完成更新(需升级至 0.26.1 或更高兼容版本)。升级后如果弹出重启提示,重启一下 DSH 即可生效。",
16
- "media": "demos/chat-import-upgrade.gif",
17
- "alt": "在菜单中升级 dsh-chat-import,并在设置中查看模拟的重启提示。",
18
- "en": {
19
- "title": "One-Click Upgrade for dsh-chat-import Right from the Menu",
20
- "description": "If an outdated version of **dsh-chat-import** prevents you from using chat import or handoff summaries, you no longer need to update it manually.\n\nSimply click the **upgrade prompt** right inside the menu to update to v0.26.1 or later. If prompted after the upgrade, restart DSH to apply the changes.",
21
- "alt": "Upgrade dsh-chat-import from the menu and view the simulated restart prompt in settings."
22
- }
23
- },
24
- {
25
- "title": "输入 @plugin:,直接让 Agent 帮你检查本地插件",
26
- "description": "插件报错想让 Agent 帮忙排查,或者想研究某个插件的源码?以前还得自己去电脑深层目录里翻找插件的安装路径,非常劝退。\n\n现在只需输入 **@plugin:**,搜索插件名称并按 **Enter**,就能直接把该插件的本地目录喂给 Agent(支持当前 DSH 环境中已安装的所有插件)。",
27
- "media": "demos/local-plugins.gif",
28
- "alt": "在 @plugin: 菜单筛选本地插件,按 Enter 插入插件目录引用。",
29
- "en": {
30
- "title": "Type @plugin: to Reference Installed Plugins Directly",
31
- "description": "Want your Agent to troubleshoot a plugin issue or inspect its source code? Digging through deep system folders just to find the installation path is a hassle.\n\nNow you can simply type **@plugin:**, search for the plugin name, and press **Enter** to pass its installation directory straight to the Agent (supports all plugins currently installed in your DSH environment).",
32
- "alt": "Filter local plugins in the @plugin: menu and press Enter to insert the plugin directory reference."
33
- }
34
- },
35
- {
36
- "title": "自定义快捷词,直接缩小搜索范围,不用手动翻找",
37
- "description": "**@** 菜单里东西太多,想找历史对话时还得在一堆文件、目录和不同来源里手动翻找?\n\n现在你可以给各个对话来源设置**专属快捷词**(支持设置多个,用英文逗号分隔),输入时直接按类别过滤,快速锁定搜索范围:\n- **按分类合并搜**:比如忘了具体在哪聊过,可以给“本地 Agent”和“网页对话”都加上同一个快捷词(如 **chat**),输入 **@chat:** 就能把搜索范围直接缩小到这两类对话中;\n- **按来源精准搜**:明确只想找某一个来源时,直接输入它的专属快捷词(比如 **@codex:**),即可一步到位只搜 Codex。",
38
- "media": "demos/shortcuts.gif",
39
- "alt": "在设置中配置共享快捷词,再用共享词和具体来源词搜索会话。",
40
- "en": {
41
- "title": "Custom Shortcuts to Narrow Down Your Search Scope Instantly",
42
- "description": "Tired of scrolling through a cluttered **@** menu full of files, folders, and different sources just to find a past conversation?\n\nYou can now assign **custom shortcuts** to different chat sources in Settings (multiple shortcuts can be separated by commas), allowing you to filter by category and narrow down your search scope right as you type:\n- **Search across a combined group**: Not sure where a conversation happened? Assign the same shortcut (e.g., **chat**) to both Local Agents and Web Chats, then type **@chat:** to narrow your search exclusively to those sources;\n- **Target a specific source**: When you know exactly where to look, use a dedicated shortcut like **@codex:** to filter exclusively for Codex sessions.",
43
- "alt": "Configure shared shortcuts in settings, then search sessions using both shared and source-specific shortcuts."
44
- }
45
- },
46
- {
47
- "title": "不用死记路径,像逛文件夹一样找到目录并引用",
48
- "description": "想引用某个深层文件夹,但记不住完整路径、也不想手打?\n\n现在 **@** 文件菜单支持直接层层浏览了:\n- **进入子目录**:选中文件夹后按 **Tab** 键;\n- **返回上一级**:点击菜单顶部的导航栏;\n- **确认引用**:找到目标文件夹后按 **Enter**,一键插入到当前对话中。",
49
- "media": "demos/folders.gif",
50
- "alt": "在文件菜单按 Tab 进入子目录,再返回并按 Enter 引用目录。",
51
- "en": {
52
- "title": "Browse Folders Directly in the @ Menu — No Need to Type Full Paths",
53
- "description": "Want to reference a deeply nested folder without memorizing or typing out its full path?\n\nYou can now navigate folder hierarchies directly inside the **@** file menu:\n- **Open subfolder**: Select a folder and press **Tab** to step inside;\n- **Go back**: Use the breadcrumb navigation bar at the top of the menu;\n- **Insert reference**: Press **Enter** on your target folder to insert it directly into your chat.",
54
- "alt": "Press Tab in the file menu to enter subdirectories, navigate back, and press Enter to reference a folder."
55
- }
56
- },
57
- {
58
- "title": "未来更新预告",
59
- "description": "接下来我们还计划带来这些实用功能,敬请期待:\n\n1. **更省心的网页端对话同步**:后台静默同步网页聊天记录,不再需要额外安装和折腾 OpenCLI\n2. **更强大的会话搜索**:找历史记录更准、更快\n3. **更实用的 **@云盘** 权限支持**:打通更多云端文件引用场景\n4. **全新的 **@电脑窗口** 功能**:不用截图,直接让 AI 读取你当前打开的软件窗口\n\n---\n\n❤️ **写在最后**\n\n这个插件一直靠“用爱发电”持续维护。如果它对你有帮助,欢迎到 [GitHub](https://github.com/Chael-Chael/dsh-reference-anything) 点一颗 **Star ⭐** 支持!平时遇到任何问题或有新点子,随时欢迎提交 Issue 反馈;也特别欢迎有时间、有能力的朋友通过 PR 一起完善插件。感谢每一份支持!",
60
- "en": {
61
- "title": "What's Next",
62
- "description": "Here is what we are planning for upcoming releases:\n\n1. **Zero-Config Web Chat Sync**: Silent background syncing for web conversations — no OpenCLI setup required\n2. **More Powerful Session Search**: Faster and more accurate history lookup\n3. **Enhanced **@CloudDrive** Permissions**: Broader and more practical cloud file referencing\n4. ****@Window** Context**: Reference active desktop application windows directly without taking screenshots\n\n---\n\n❤️ **Support the Project**\n\nThis plugin is a labor of love maintained in our spare time. If it saves you time and makes your workflow smoother, please consider giving us a **Star ⭐ on [GitHub](https://github.com/Chael-Chael/dsh-reference-anything)**! Feel free to open an Issue if you run into bugs or have feature ideas, and PRs are always welcome if you'd like to help build and improve the plugin together. Thank you for all your support!"
63
- }
64
- }
65
- ]
1
+ [
2
+ {
3
+ "title": "把历史对话直接“搬”进 DSH,无缝接着聊",
4
+ "description": "以前想接着别的本地会话继续聊,要么得来回复制粘贴聊天记录,要么只能把旧对话当成静态背景资料。\n\n现在,在 **@** 菜单里找到本地历史会话,你有两种方式处理它:\n- **只当参考资料(按 **Enter**)**:直接引用该会话;\n- **接着往下聊(按 **Tab**)**:在弹出的菜单中选择**导入**并确认,就能把整段历史记录直接搬进 DSH,顺着之前的上下文继续对话!(如果觉得每次确认太麻烦,也可以在设置中关闭二次确认,一步到位)\n\n> 💡 **提示**:使用导入功能需安装并启用 **dsh-chat-import**(0.26.1 或更高兼容版本)。",
5
+ "media": "demos/agent-import.gif",
6
+ "alt": "Enter 引用会话,Tab 打开操作菜单,确认后展示模拟导入的历史;使用虚构数据。",
7
+ "en": {
8
+ "title": "Import Past Conversations into DSH and Pick Up Where You Left Off",
9
+ "description": "Want to continue an existing local session without copying and pasting chat logs or treating old threads purely as static context?\n\nNow, when you find a local session in the **@** menu, you have two ways to use it:\n- **Reference as context (**Enter**)**: Insert the session directly as a reference;\n- **Import and continue chatting (**Tab**)**: Open the action menu, select **Import**, and confirm to bring the entire conversation history into DSH and keep chatting seamlessly! (Prefer a faster workflow? You can disable the confirmation prompt in Settings.)\n\n> 💡 **Note**: Importing requires **dsh-chat-import** v0.26.1 or a compatible newer version to be installed and enabled.",
10
+ "alt": "Press Enter to reference a session, or Tab to open the action menu and import history; uses mock data."
11
+ }
12
+ },
13
+ {
14
+ "title": "菜单内一键升级配套插件,不用手动折腾",
15
+ "description": "如果提示 **dsh-chat-import** 版本太旧、用不了“对话导入”或“交接摘要”,不用自己再去后台找安装包手动更新了。\n\n直接在菜单里点击**升级提示**,即可一键完成更新(需升级至 0.26.1 或更高兼容版本)。升级后如果弹出重启提示,重启一下 DSH 即可生效。",
16
+ "media": "demos/chat-import-upgrade.gif",
17
+ "alt": "在菜单中升级 dsh-chat-import,并在设置中查看模拟的重启提示。",
18
+ "en": {
19
+ "title": "One-Click Upgrade for dsh-chat-import Right from the Menu",
20
+ "description": "If an outdated version of **dsh-chat-import** prevents you from using chat import or handoff summaries, you no longer need to update it manually.\n\nSimply click the **upgrade prompt** right inside the menu to update to v0.26.1 or later. If prompted after the upgrade, restart DSH to apply the changes.",
21
+ "alt": "Upgrade dsh-chat-import from the menu and view the simulated restart prompt in settings."
22
+ }
23
+ },
24
+ {
25
+ "title": "输入 @plugin:,直接让 Agent 帮你检查本地插件",
26
+ "description": "插件报错想让 Agent 帮忙排查,或者想研究某个插件的源码?以前还得自己去电脑深层目录里翻找插件的安装路径,非常劝退。\n\n现在只需输入 **@plugin:**,搜索插件名称并按 **Enter**,就能直接把该插件的本地目录喂给 Agent(支持当前 DSH 环境中已安装的所有插件)。",
27
+ "media": "demos/local-plugins.gif",
28
+ "alt": "在 @plugin: 菜单筛选本地插件,按 Enter 插入插件目录引用。",
29
+ "en": {
30
+ "title": "Type @plugin: to Reference Installed Plugins Directly",
31
+ "description": "Want your Agent to troubleshoot a plugin issue or inspect its source code? Digging through deep system folders just to find the installation path is a hassle.\n\nNow you can simply type **@plugin:**, search for the plugin name, and press **Enter** to pass its installation directory straight to the Agent (supports all plugins currently installed in your DSH environment).",
32
+ "alt": "Filter local plugins in the @plugin: menu and press Enter to insert the plugin directory reference."
33
+ }
34
+ },
35
+ {
36
+ "title": "自定义快捷词,直接缩小搜索范围,不用手动翻找",
37
+ "description": "**@** 菜单里东西太多,想找历史对话时还得在一堆文件、目录和不同来源里手动翻找?\n\n现在你可以给各个对话来源设置**专属快捷词**(支持设置多个,用英文逗号分隔),输入时直接按类别过滤,快速锁定搜索范围:\n- **按分类合并搜**:比如忘了具体在哪聊过,可以给“本地 Agent”和“网页对话”都加上同一个快捷词(如 **chat**),输入 **@chat:** 就能把搜索范围直接缩小到这两类对话中;\n- **按来源精准搜**:明确只想找某一个来源时,直接输入它的专属快捷词(比如 **@codex:**),即可一步到位只搜 Codex。",
38
+ "media": "demos/shortcuts.gif",
39
+ "alt": "在设置中配置共享快捷词,再用共享词和具体来源词搜索会话。",
40
+ "en": {
41
+ "title": "Custom Shortcuts to Narrow Down Your Search Scope Instantly",
42
+ "description": "Tired of scrolling through a cluttered **@** menu full of files, folders, and different sources just to find a past conversation?\n\nYou can now assign **custom shortcuts** to different chat sources in Settings (multiple shortcuts can be separated by commas), allowing you to filter by category and narrow down your search scope right as you type:\n- **Search across a combined group**: Not sure where a conversation happened? Assign the same shortcut (e.g., **chat**) to both Local Agents and Web Chats, then type **@chat:** to narrow your search exclusively to those sources;\n- **Target a specific source**: When you know exactly where to look, use a dedicated shortcut like **@codex:** to filter exclusively for Codex sessions.",
43
+ "alt": "Configure shared shortcuts in settings, then search sessions using both shared and source-specific shortcuts."
44
+ }
45
+ },
46
+ {
47
+ "title": "不用死记路径,像逛文件夹一样找到目录并引用",
48
+ "description": "想引用某个深层文件夹,但记不住完整路径、也不想手打?\n\n现在 **@** 文件菜单支持直接层层浏览了:\n- **进入子目录**:选中文件夹后按 **Tab** 键;\n- **返回上一级**:点击菜单顶部的导航栏;\n- **确认引用**:找到目标文件夹后按 **Enter**,一键插入到当前对话中。",
49
+ "media": "demos/folders.gif",
50
+ "alt": "在文件菜单按 Tab 进入子目录,再返回并按 Enter 引用目录。",
51
+ "en": {
52
+ "title": "Browse Folders Directly in the @ Menu — No Need to Type Full Paths",
53
+ "description": "Want to reference a deeply nested folder without memorizing or typing out its full path?\n\nYou can now navigate folder hierarchies directly inside the **@** file menu:\n- **Open subfolder**: Select a folder and press **Tab** to step inside;\n- **Go back**: Use the breadcrumb navigation bar at the top of the menu;\n- **Insert reference**: Press **Enter** on your target folder to insert it directly into your chat.",
54
+ "alt": "Press Tab in the file menu to enter subdirectories, navigate back, and press Enter to reference a folder."
55
+ }
56
+ },
57
+ {
58
+ "title": "未来更新预告",
59
+ "description": "接下来我们还计划带来这些实用功能,敬请期待:\n\n1. **更省心的网页端对话同步**:后台静默同步网页聊天记录,不再需要额外安装和折腾 OpenCLI\n2. **更强大的会话搜索**:找历史记录更准、更快\n3. **更实用的 **@云盘** 权限支持**:打通更多云端文件引用场景\n4. **全新的 **@电脑窗口** 功能**:不用截图,直接让 AI 读取你当前打开的软件窗口\n\n---\n\n❤️ **写在最后**\n\n这个插件一直靠“用爱发电”持续维护。如果它对你有帮助,欢迎到 [GitHub](https://github.com/Chael-Chael/dsh-reference-anything) 点一颗 **Star ⭐** 支持!平时遇到任何问题或有新点子,随时欢迎提交 Issue 反馈;也特别欢迎有时间、有能力的朋友通过 PR 一起完善插件。感谢每一份支持!",
60
+ "en": {
61
+ "title": "What's Next",
62
+ "description": "Here is what we are planning for upcoming releases:\n\n1. **Zero-Config Web Chat Sync**: Silent background syncing for web conversations — no OpenCLI setup required\n2. **More Powerful Session Search**: Faster and more accurate history lookup\n3. **Enhanced **@CloudDrive** Permissions**: Broader and more practical cloud file referencing\n4. ****@Window** Context**: Reference active desktop application windows directly without taking screenshots\n\n---\n\n❤️ **Support the Project**\n\nThis plugin is a labor of love maintained in our spare time. If it saves you time and makes your workflow smoother, please consider giving us a **Star ⭐ on [GitHub](https://github.com/Chael-Chael/dsh-reference-anything)**! Feel free to open an Issue if you run into bugs or have feature ideas, and PRs are always welcome if you'd like to help build and improve the plugin together. Thank you for all your support!"
63
+ }
64
+ }
65
+ ]
@@ -1,36 +1,38 @@
1
- # 新功能介绍卡片
2
-
3
- 每个版本使用一个与 `package.json` 版本号完全一致的目录(不带 `v`):
4
-
5
- ```text
6
- release-notes/
7
- 0.4.4/
8
- features.json
9
- files.png
10
- commands.png
11
- ```
12
-
13
- `features.json` 是按展示顺序排列的卡片数组。每张卡片包含:
14
-
15
- ```json
16
- [
17
- {
18
- "title": "新功能标题",
19
- "description": "介绍这个功能,以及用户如何使用它。",
20
- "media": "demo.gif",
21
- "alt": "动画中展示的操作"
22
- }
23
- ]
24
- ```
25
-
26
- 图片支持 PNG、JPEG、WebP 和 GIF;路径相对于该版本目录,不可指向目录外。介绍支持 Markdown 段落、列表和链接;链接在新窗口打开。标题和介绍必填;纯文字预告可以省略 media 和 alt,提供图片时必须填写 alt。将预告放在数组最后,即作为最后一页展示。
27
-
28
- 执行 `npm run build` 后,配置和素材会内嵌到插件客户端,离线也可查看;修改内容后需要重新构建并重载 DSH。请压缩大 GIF,避免增加客户端加载时间。新增版本只需新增目录和内容,不需要修改卡片组件。
29
-
30
- 卡片可增加 `en: { title, description, alt }` 保存英文原文,媒体共用。默认字段为中文;卡片跟随 DSH 语言设置即时切换,其他语言使用英文,旧版未配置英文的卡片保留原文。GIF 画面内的文字不会自动翻译。
31
-
32
- 点击菜单项打开介绍后,用右下角“上一个/下一个”切换;关闭弹窗不会隐藏菜单项,只有点击菜单行的叉号才会屏蔽该版本。没有本地卡片配置的版本回退到原来的更新日志。未安装的新版本若尚未包含在本地插件中,也使用远端日志。
33
-
34
- 每个已安装版本首次进入“引用万物(dsh-reference-anything)”插件的具体设置页面时,会自动展示一次本次更新介绍;仅打开设置窗口或其他设置页不会触发。展示记录单独保存在本地存储中,与菜单入口的叉号互不影响;检测到远端新版本不会触发,安装后版本变化才会再次展示。首次启用此机制时,当前版本也会展示一次。本地存储不可用时,只能保证本次运行内不重复展示。
35
-
36
- 0.4.4 的初始卡片复用了仓库已有的文件、命令菜单示意图,可直接替换为实际新功能截图或 GIF。
1
+ # 新功能介绍卡片
2
+
3
+ 每个版本使用一个与 `package.json` 版本号完全一致的目录(不带 `v`):
4
+
5
+ ```text
6
+ release-notes/
7
+ 0.4.4/
8
+ features.json
9
+ files.png
10
+ commands.png
11
+ ```
12
+
13
+ `features.json` 是按展示顺序排列的卡片数组。每张卡片包含:
14
+
15
+ ```json
16
+ [
17
+ {
18
+ "title": "新功能标题",
19
+ "description": "介绍这个功能,以及用户如何使用它。",
20
+ "media": "demo.gif",
21
+ "alt": "动画中展示的操作"
22
+ }
23
+ ]
24
+ ```
25
+
26
+ 图片支持 PNG、JPEG、WebP 和 GIF;路径相对于该版本目录,不可指向目录外。介绍支持 Markdown 段落、列表和链接;链接在新窗口打开。标题和介绍必填;纯文字预告可以省略 media 和 alt,提供图片时必须填写 alt。将预告放在数组最后,即作为最后一页展示。
27
+
28
+ 执行 `npm run build` 后,配置和素材会内嵌到插件客户端,离线也可查看;修改内容后需要重新构建并重载 DSH。请压缩大 GIF,避免增加客户端加载时间。新增版本只需新增目录和内容,不需要修改卡片组件。
29
+
30
+ 卡片可增加 `en: { title, description, alt }` 保存英文原文,媒体共用。默认字段为中文;卡片跟随 DSH 语言设置即时切换,其他语言使用英文,旧版未配置英文的卡片保留原文。GIF 画面内的文字不会自动翻译。
31
+
32
+ 点击菜单项打开介绍后,用右下角“上一个/下一个”切换;关闭弹窗不会隐藏菜单项,只有点击菜单行的叉号才会屏蔽该版本。没有本地卡片配置的版本回退到原来的更新日志。未安装的新版本若尚未包含在本地插件中,也使用远端日志。
33
+
34
+ 每个已安装版本首次进入“引用万物(dsh-reference-anything)”插件的具体设置页面时,会自动展示一次本次更新介绍;仅打开设置窗口或其他设置页不会触发。展示记录单独保存在本地存储中,与菜单入口的叉号互不影响;检测到远端新版本不会触发,安装后版本变化才会再次展示。首次启用此机制时,当前版本也会展示一次。本地存储不可用时,只能保证本次运行内不重复展示。
35
+
36
+ 0.4.4 的初始卡片复用了仓库已有的文件、命令菜单示意图,可直接替换为实际新功能截图或 GIF。
37
+
38
+ 0.5.1 是兼容性补丁,客户端直接复用 0.5.0 的中英文卡片与媒体,不复制素材。
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2020 Arjun Barrett
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
1
+ MIT License
2
+
3
+ Copyright (c) 2020 Arjun Barrett
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
21
  SOFTWARE.