dsh-zotero 0.13.0 → 0.13.1

package/README.en.md

@@ -11,7 +11,7 @@
   <a href="https://www.npmjs.com/package/dsh-zotero"><img src="https://img.shields.io/npm/v/dsh-zotero" alt="npm version" style="max-width:100%;"></a>
   <a href="https://www.npmjs.com/package/dsh-zotero"><img src="https://img.shields.io/npm/dm/dsh-zotero" alt="npm downloads" style="max-width:100%;"></a>
   <a href="https://www.npmjs.com/package/dsh-zotero"><img src="https://img.shields.io/npm/l/dsh-zotero" alt="license" style="max-width:100%;"></a>
-  <a href="https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-rc.2"><img src="https://img.shields.io/badge/dsh-0.2.1--rc.2-blue" alt="dsh version" style="max-width:100%;"></a>
+  <a href="https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-rc.3"><img src="https://img.shields.io/badge/dsh-0.2.1--rc.3-blue" alt="dsh version" style="max-width:100%;"></a>
   <a href="https://awesome-dsh-plugin.com"><img src="https://awesome-dsh-plugin.com/badge.svg" alt="Awesome DSH Plugin"></a>
 </p>
 </div>
@@ -84,7 +84,7 @@ Agent → zotero_export(refs: ["zotero://user/0/item/ABCD1234",
 
 ## Tools
 
-The plugin includes 8 read tools and 8 write tools. Write tools are disabled by default until `writeEnabled` is turned on in settings.
+The plugin includes 8 read tools and 15 write tools. Write tools are disabled by default until `writeEnabled` is turned on in settings.
 
 | Tool                | Purpose                                                                                   |
 | ------------------- | ----------------------------------------------------------------------------------------- |
@@ -97,7 +97,27 @@ The plugin includes 8 read tools and 8 write tools. Write tools are disabled by
 | `zotero_attachment` | Resolve an item to its local PDF file path                                                |
 | `zotero_export`     | Generate formatted citations or export BibTeX, RIS, and CSL JSON                          |
 
-See [Tool reference](docs/tools.en.md) for complete parameter definitions of all 16 tools.
+Write tools (disabled by default; they write to the personal library only):
+
+| Tool                             | Purpose                                                                                        |
+| -------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `zotero_create_note`             | Create a standalone note or a child note, with tags, collections, and sources                  |
+| `zotero_update_note`             | Replace an existing note body under a version precondition, same character ceiling as creation |
+| `zotero_update_item_tags`        | Add and remove an item's tags in one call, preserving existing tag types                       |
+| `zotero_update_item_collections` | Add and remove an item's collection membership in one call                                     |
+| `zotero_create_collection`       | Create a top-level or nested collection; same-name siblings are refused                        |
+| `zotero_update_collection`       | Rename a collection or move it under a different parent                                        |
+| `zotero_delete_collection`       | Delete a collection (irreversible); the plan card reports item and child counts                |
+| `zotero_create_item`             | Create an item from a closed field set                                                         |
+| `zotero_update_item`             | Correct an item's scalar metadata, validated against its type                                  |
+| `zotero_restore_items`           | Restore items from the Trash, reporting each entry separately                                  |
+| `zotero_create_saved_search`     | Create a saved search, which needs at least one condition                                      |
+| `zotero_update_saved_search`     | Update a saved search name or its conditions                                                   |
+| `zotero_delete_saved_search`     | Delete a saved search                                                                          |
+| `zotero_delete_library_tags`     | Delete tags library-wide by name (irreversible); missed names are safe to retry                |
+| `zotero_batch_items`             | Create, retag, recollection, or trash items in one call, under one plan card                   |
+
+See [Tool reference](docs/tools.en.md) for complete parameter definitions of all 23 host tools. The scholarly literature tools belong to the `dsh-zotero/scholarly` component, which is off by default.
 
 ## Security and privacy
 
@@ -111,8 +131,8 @@ See [Tool reference](docs/tools.en.md) for complete parameter definitions of all
 | --------------------------------------------------- | ------------------------------------------------------------- |
 | [Getting started](docs/getting-started.en.md)       | Installation, prerequisites, and connection verification      |
 | [Features](docs/features.en.md)                     | Sources panel, chat integration, and export workflows         |
-| [Tool reference](docs/tools.en.md)                  | Parameters, return values, and error codes for all 16 tools   |
-| [Configuration reference](docs/configuration.en.md) | 35 configuration fields and default values                    |
+| [Tool reference](docs/tools.en.md)                  | Parameters, return values, and error codes for all 17 tools   |
+| [Configuration reference](docs/configuration.en.md) | 37 configuration fields and default values                    |
 | [Architecture](docs/architecture.en.md)             | Data flow, layer responsibilities, and design boundaries      |
 | [Development guide](docs/development.en.md)         | Build, test, local development, and release workflow          |
 | [Scenarios](docs/scenarios.en.md)                   | Real-conversation acceptance cases and everyday usage prompts |

package/README.md

@@ -11,7 +11,7 @@
   <a href="https://www.npmjs.com/package/dsh-zotero"><img src="https://img.shields.io/npm/v/dsh-zotero" alt="npm version" style="max-width:100%;"></a>
   <a href="https://www.npmjs.com/package/dsh-zotero"><img src="https://img.shields.io/npm/dm/dsh-zotero" alt="npm downloads" style="max-width:100%;"></a>
   <a href="https://www.npmjs.com/package/dsh-zotero"><img src="https://img.shields.io/npm/l/dsh-zotero" alt="license" style="max-width:100%;"></a>
-  <a href="https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-rc.2"><img src="https://img.shields.io/badge/dsh-0.2.1--rc.2-blue" alt="dsh 版本" style="max-width:100%;"></a>
+  <a href="https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.1-rc.3"><img src="https://img.shields.io/badge/dsh-0.2.1--rc.3-blue" alt="dsh 版本" style="max-width:100%;"></a>
   <a href="https://awesome-dsh-plugin.com"><img src="https://awesome-dsh-plugin.com/badge.svg" alt="Awesome DSH Plugin"></a>
 </p>
 </div>
@@ -84,7 +84,7 @@ Agent → zotero_export(refs: ["zotero://user/0/item/ABCD1234",
 
 ## 工具一览
 
-插件提供 8 个读取工具与 8 个写入工具。写入工具默认关闭，可在配置中开启 `writeEnabled`。
+插件提供 8 个读取工具与 15 个写入工具。写入工具默认关闭，可在配置中开启 `writeEnabled`。
 
 | 工具                | 用途                                                       |
 | ------------------- | ---------------------------------------------------------- |
@@ -97,7 +97,27 @@ Agent → zotero_export(refs: ["zotero://user/0/item/ABCD1234",
 | `zotero_attachment` | 获取文献关联的本地 PDF 文件路径                            |
 | `zotero_export`     | 生成格式化引用、参考文献列表，或导出 BibTeX、RIS、CSL JSON |
 
-全部 16 个工具的参数定义见 [工具参考](docs/tools.md)。
+写入工具（默认关闭，开启后仅写入个人库）：
+
+| 工具                             | 用途                                                   |
+| -------------------------------- | ------------------------------------------------------ |
+| `zotero_create_note`             | 创建独立笔记或条目子笔记，支持标签、合集与来源关联     |
+| `zotero_update_note`             | 按版本前置替换已有笔记正文，创建与更新共用同一字符上限 |
+| `zotero_update_item_tags`        | 在一次调用中增删条目标签，保留既有标签类型             |
+| `zotero_update_item_collections` | 在一次调用中增删条目的合集归属                         |
+| `zotero_create_collection`       | 创建顶层或子合集，同级同名拒绝                         |
+| `zotero_update_collection`       | 重命名合集或移动其父合集                               |
+| `zotero_delete_collection`       | 删除合集（不可逆），计划卡先给出条目数与子合集数       |
+| `zotero_create_item`             | 从闭合字段集创建文献条目                               |
+| `zotero_update_item`             | 订正条目标量元数据，字段合法性按条目类型校验           |
+| `zotero_restore_items`           | 将回收站条目恢复为活动状态，逐项返回回执               |
+| `zotero_create_saved_search`     | 创建保存搜索，至少需要一个条件                         |
+| `zotero_update_saved_search`     | 更新保存搜索的名称或条件                               |
+| `zotero_delete_saved_search`     | 删除保存搜索                                           |
+| `zotero_delete_library_tags`     | 按名称全库删除标签（不可逆），未命中的名称可安全重试   |
+| `zotero_batch_items`             | 批量创建文献、更新标签与合集归属、移入回收站，合并确认 |
+
+全部 23 个宿主工具的参数定义见 [工具参考](docs/tools.md)。学术文献检索另属 `dsh-zotero/scholarly` 组件，默认关闭。
 
 ## 安全与隐私
 
@@ -107,16 +127,16 @@ Agent → zotero_export(refs: ["zotero://user/0/item/ABCD1234",
 
 ## 说明文档
 
-| 文档                                | 内容                                   |
-| ----------------------------------- | -------------------------------------- |
-| [快速入门](docs/getting-started.md) | 安装步骤、前置条件与连接验证           |
-| [功能概览](docs/features.md)        | Sources 来源面板、对话集成与导出工作流 |
-| [工具参考](docs/tools.md)           | 全部 16 个工具的参数、返回值与错误码   |
-| [配置参考](docs/configuration.md)   | 35 个配置项说明与默认值                |
-| [系统架构](docs/architecture.md)    | 数据流、分层职责与设计边界             |
-| [开发指南](docs/development.md)     | 构建、测试、调试与发布流程             |
-| [使用场景](docs/scenarios.md)       | 典型对话用例与使用示例                 |
-| [故障排查](docs/troubleshooting.md) | 常见连接问题诊断与处理方法             |
+| 文档                                | 内容                                     |
+| ----------------------------------- | ---------------------------------------- |
+| [快速入门](docs/getting-started.md) | 安装步骤、前置条件与连接验证             |
+| [功能概览](docs/features.md)        | Sources 来源面板、对话集成与导出工作流   |
+| [工具参考](docs/tools.md)           | 全部 23 个宿主工具的参数、返回值与错误码 |
+| [配置参考](docs/configuration.md)   | 37 个配置项说明与默认值                  |
+| [系统架构](docs/architecture.md)    | 数据流、分层职责与设计边界               |
+| [开发指南](docs/development.md)     | 构建、测试、调试与发布流程               |
+| [使用场景](docs/scenarios.md)       | 典型对话用例与使用示例                   |
+| [故障排查](docs/troubleshooting.md) | 常见连接问题诊断与处理方法               |
 
 ## 许可证
 

package/cordis.patch.yml

@@ -8,4 +8,5 @@
     # (arXiv, OpenAlex, Crossref, Semantic Scholar, PubMed).
     - id: scholarly
       name: dsh-zotero/scholarly
-      config: {}
+      config:
+        enabled: false