dsh-zotero 0.8.3 → 0.9.0

package/README.en.md

@@ -10,7 +10,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.1.5-rc.2"><img src="https://img.shields.io/badge/dsh-%3E%3D0.1.5--rc.2-blue" alt="minimum dsh version" style="max-width:100%;"></a>
+  <a href="https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.6-alpha.2"><img src="https://img.shields.io/badge/dsh-%3E%3D0.1.6--alpha.2-blue" alt="minimum 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>
@@ -69,7 +69,7 @@ The plugin provides a settings page under **Settings → Zotero** — a left-nav
 
 - Zotero ≥ 7 with local API enabled: **Settings → Advanced → "Allow other applications on this computer to communicate with Zotero"**
 - Node.js ≥ 22.19 (or ≥ 24)
-- dsh 0.1.5-rc.2 host (all `@deepseek-ai/dsh-*` peer dependencies are `^0.1.5-rc.2`, and the declared compatibility range is `engines.dsh`; only the latest pre-release line is supported until upstream stabilizes, with no backward compatibility)
+- dsh 0.1.6-alpha.2 host (all `@deepseek-ai/dsh-*` peer dependencies are `^0.1.6-alpha.2`, and the declared compatibility range is `engines.dsh`; only the latest pre-release line is supported until upstream stabilizes, with no backward compatibility)
 - Local API at `http://127.0.0.1:23119/api`, unauthenticated, read-only
 
 ## Usage example

package/README.md

@@ -10,7 +10,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.1.5-rc.2"><img src="https://img.shields.io/badge/dsh-%3E%3D0.1.5--rc.2-blue" alt="最低 dsh 版本" style="max-width:100%;"></a>
+  <a href="https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.6-alpha.2"><img src="https://img.shields.io/badge/dsh-%3E%3D0.1.6--alpha.2-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>
@@ -69,7 +69,7 @@ dsh plugin --profile <name> add ./dsh-zotero-*.tgz
 
 - Zotero ≥ 7 桌面版，启用本地 API：**设置 → 高级 → "允许其他应用程序与 Zotero 通信"**
 - Node.js ≥ 22.19（或 ≥ 24）
-- 宿主 dsh 0.1.5-rc.2（`@deepseek-ai/dsh-*` peer 依赖均为 `^0.1.5-rc.2`，兼容范围另见 `engines.dsh`；上游发布稳定版之前只跟最新预发布线，不向后兼容）
+- 宿主 dsh 0.1.6-alpha.2（`@deepseek-ai/dsh-*` peer 依赖均为 `^0.1.6-alpha.2`，兼容范围另见 `engines.dsh`；上游发布稳定版之前只跟最新预发布线，不向后兼容）
 - 本地 API 地址 `http://127.0.0.1:23119/api`，无认证，只读
 
 ## 使用示例

package/lib/ask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../src/ask.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AA0B1E,iEAAiE;AACjE,KAAK,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAA;AA2EnE;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAE7D;;;;;;;OAOG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAW5E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,oBAAoB,EAC9B,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAmCZ"}
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../src/ask.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AA2B1E,iEAAiE;AACjE,KAAK,mBAAmB,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAA;AA2EnE;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAE7D;;;;;;;OAOG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAW5E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,oBAAoB,EAC9B,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAmCZ"}

package/lib/ask.js

@@ -16,7 +16,7 @@
 import { HarnessError } from '@deepseek-ai/dsh-llm';
 import { TOOL_ABORTED } from '@deepseek-ai/dsh-tools';
 import { ZOTERO_LOCAL_API_VERSION } from './constants.js';
-import { ZOTERO_API_DISABLED, ZOTERO_API_VERSION, ZOTERO_NOT_RUNNING, ZOTERO_TIMEOUT, ZoteroError, } from './errors.js';
+import { TOOL_ABORTED_MESSAGE, ZOTERO_API_DISABLED, ZOTERO_API_VERSION, ZOTERO_NOT_RUNNING, ZOTERO_TIMEOUT, ZoteroError, } from './errors.js';
 /** The connectivity failure codes that warrant asking the user how to proceed. */
 const ASK_WORTHY_CODES = [
     ZOTERO_NOT_RUNNING,
@@ -164,7 +164,7 @@ export async function withConnectivityAsk(ctx, recovery, exec, run) {
             // A failed question (no provider, aborted ask, delegated caller) must
             // never mask the underlying connectivity failure.
             if (exec.signal?.aborted)
-                throw new HarnessError('tool call aborted', TOOL_ABORTED);
+                throw new HarnessError(TOOL_ABORTED_MESSAGE, TOOL_ABORTED);
             throw error;
         }
         if (!retry)

package/lib/ask.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask.js","sourceRoot":"","sources":["../src/ask.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../src/ask.ts"],"names":[],"mappings":"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"}

package/lib/client.js

@@ -30,17 +30,18 @@ module.exports = __toCommonJS(index_exports);
 var import_dsh_client_ui_primitives2 = require("@deepseek-ai/dsh-client-ui-primitives");
 
 // src/client/fields.tsx
+var import_react = require("react");
 var import_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 
 // src/client/fields.module.css
-var style = `.gONAZG_field{flex-direction:column;gap:6px;padding:12px 0;display:flex}.gONAZG_field+.gONAZG_field{border-top:.5px solid var(--dsw-alias-border-l2)}.gONAZG_head{align-items:center;gap:8px;display:flex}.gONAZG_label{min-width:0;color:var(--dsw-alias-label-primary);flex:1;font-size:13px;font-weight:500;line-height:1.5}.gONAZG_badges{align-items:center;gap:8px;display:inline-flex}.gONAZG_reset{font:inherit;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;padding:0;font-size:12px;line-height:1.5}.gONAZG_reset:hover:not(:disabled){color:var(--dsw-alias-label-primary)}.gONAZG_reset:disabled{cursor:default}.gONAZG_input{border:.5px solid var(--dsw-alias-border-l4);background:var(--dsw-alias-bg-layer-3);height:34px;font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 12px;font-size:13px;line-height:1.5}.gONAZG_input:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}.gONAZG_input:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}.gONAZG_inputInvalid{border-color:var(--dsw-alias-label-error,var(--dsw-alias-state-error-primary));}.gONAZG_invalid{color:var(--dsw-alias-label-error,var(--dsw-alias-state-error-primary));margin:0;font-size:12px;line-height:1.5}.gONAZG_hint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:1.5}.gONAZG_toggleRow{align-items:center;gap:8px;display:flex}.gONAZG_toggleLabel{min-width:0;color:var(--dsw-alias-label-primary);cursor:pointer;flex:1;font-size:13px;font-weight:500;line-height:1.5}.gONAZG_toggle{width:16px;height:16px;accent-color:var(--dsw-alias-state-business-primary);cursor:pointer;flex:none;margin:0}`;
+var style = `.gONAZG_field{flex-direction:column;gap:6px;padding:12px 0;display:flex}.gONAZG_field+.gONAZG_field{border-top:.5px solid var(--dsw-alias-border-l2)}.gONAZG_head{align-items:center;gap:8px;display:flex}.gONAZG_label{min-width:0;color:var(--dsw-alias-label-primary);flex:1;font-size:13px;font-weight:500;line-height:1.5}.gONAZG_labelGroup{flex:1;align-items:center;gap:4px;min-width:0;display:flex}.gONAZG_labelGroup>.gONAZG_label{flex:0 auto}.gONAZG_helpButton{width:24px;height:24px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:0;border-radius:6px;flex:none;justify-content:center;align-items:center;padding:0;display:inline-flex}.gONAZG_helpButton:hover,.gONAZG_helpButton[aria-expanded=true]{background:var(--dsw-alias-bg-layer-4);color:var(--dsw-alias-label-secondary)}.gONAZG_helpButton:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}.gONAZG_help{color:var(--dsw-alias-label-secondary);padding:10px 0 0;font-size:12px;line-height:1.6}.gONAZG_help>p{margin:0}.gONAZG_help>p+p{margin-top:8px}.gONAZG_badges{align-items:center;gap:8px;display:inline-flex}.gONAZG_reset{font:inherit;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;padding:0;font-size:12px;line-height:1.5}.gONAZG_reset:hover:not(:disabled){color:var(--dsw-alias-label-primary)}.gONAZG_reset:disabled{cursor:default}.gONAZG_input{border:.5px solid var(--dsw-alias-border-l4);background:var(--dsw-alias-bg-layer-3);height:34px;font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 12px;font-size:13px;line-height:1.5}.gONAZG_input:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}.gONAZG_input:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}.gONAZG_input[aria-invalid=true]{border-color:var(--dsw-alias-state-error-primary)}.gONAZG_invalid{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px;line-height:1.5}.gONAZG_hint{color:var(--dsw-alias-label-tertiary);margin:0;font-size:12px;line-height:1.5}.gONAZG_toggleRow{align-items:center;gap:8px;display:flex}.gONAZG_toggleLabel{min-width:0;color:var(--dsw-alias-label-primary);cursor:pointer;flex:1;font-size:13px;font-weight:500;line-height:1.5}.gONAZG_toggle{width:16px;height:16px;accent-color:var(--dsw-alias-state-business-primary);cursor:pointer;flex:none;margin:0}`;
 if (typeof document !== "undefined" && !document.querySelector('style[data-plugin-css="dsh-zotero/fields.module.css"]')) {
   const tag = document.createElement("style");
   tag.setAttribute("data-plugin-css", "dsh-zotero/fields.module.css");
   tag.textContent = style;
   document.head.appendChild(tag);
 }
-var fields_default = { "field": "gONAZG_field", "reset": "gONAZG_reset", "inputInvalid": "gONAZG_inputInvalid", "input": "gONAZG_input", "hint": "gONAZG_hint", "toggleLabel": "gONAZG_toggleLabel", "label": "gONAZG_label", "badges": "gONAZG_badges", "invalid": "gONAZG_invalid", "head": "gONAZG_head", "toggle": "gONAZG_toggle", "toggleRow": "gONAZG_toggleRow" };
+var fields_default = { "help": "gONAZG_help", "reset": "gONAZG_reset", "input": "gONAZG_input", "hint": "gONAZG_hint", "toggleRow": "gONAZG_toggleRow", "label": "gONAZG_label", "invalid": "gONAZG_invalid", "badges": "gONAZG_badges", "head": "gONAZG_head", "toggle": "gONAZG_toggle", "labelGroup": "gONAZG_labelGroup", "helpButton": "gONAZG_helpButton", "toggleLabel": "gONAZG_toggleLabel", "field": "gONAZG_field" };
 
 // src/client/fields.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
@@ -51,9 +52,30 @@ function OverrideControls(props) {
   ] });
 }
 function ValueField(props) {
+  const [helpOpen, setHelpOpen] = (0, import_react.useState)(false);
+  const helpId = `${props.id}-help`;
+  const messageId = `${props.id}-message`;
+  const hasMessage = props.invalid || Boolean(props.hint);
+  const description = [hasMessage ? messageId : "", helpOpen ? helpId : ""].filter(Boolean).join(" ");
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: fields_default.field, children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: fields_default.head, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("label", { className: fields_default.label, htmlFor: props.id, children: props.label }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: fields_default.labelGroup, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("label", { className: fields_default.label, htmlFor: props.id, children: props.label }),
+        props.help !== void 0 ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+          "button",
+          {
+            type: "button",
+            className: fields_default.helpButton,
+            "aria-label": props.help.label,
+            "aria-expanded": helpOpen,
+            "aria-controls": helpId,
+            onClick: () => {
+              setHelpOpen(!helpOpen);
+            },
+            children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.IconInfoOutline14, { size: 12 })
+          }
+        ) : null
+      ] }),
       props.overridden ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
         OverrideControls,
         {
@@ -68,10 +90,11 @@ function ValueField(props) {
       "input",
       {
         id: props.id,
-        className: props.invalid ? fields_default.inputInvalid : fields_default.input,
+        className: fields_default.input,
         type: "text",
         ...props.numeric === true ? { inputMode: "numeric" } : {},
         ...props.invalid ? { "aria-invalid": true } : {},
+        "aria-describedby": description || void 0,
         value: props.text,
         placeholder: props.placeholder ?? "",
         disabled: props.disabled,
@@ -80,7 +103,8 @@ function ValueField(props) {
         }
       }
     ),
-    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { className: props.invalid ? fields_default.invalid : fields_default.hint, children: props.invalid ? props.invalidLabel : props.hint })
+    hasMessage ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", { id: messageId, className: props.invalid ? fields_default.invalid : fields_default.hint, children: props.invalid ? props.invalidLabel : props.hint }) : null,
+    props.help !== void 0 && helpOpen ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { id: helpId, className: fields_default.help, role: "region", "aria-label": props.help.label, children: props.help.content }) : null
   ] });
 }
 function BooleanField(props) {
@@ -304,7 +328,7 @@ var CardForm = class {
   }
   spec(field2) {
     const spec = this.specs.get(field2);
-    if (spec === void 0) throw new Error(`plugin card has no field ${field2}`);
+    if (spec === void 0) throw new Error(`settings form has no field ${field2}`);
     return spec;
   }
   sectionValue(field2) {
@@ -348,7 +372,10 @@ var FIELD_SPECS = [
   { key: "maxBrowseResults", kind: "number", group: "groupOutput" },
   { key: "maxChangesResults", kind: "number", group: "groupOutput" },
   { key: "defaultStyle", kind: "text", group: "groupDefaults" },
-  { key: "defaultLocale", kind: "text", group: "groupDefaults" }
+  { key: "defaultLocale", kind: "text", group: "groupDefaults" },
+  { key: "writeEnabled", kind: "boolean", group: "groupWrite" },
+  { key: "writeConfirm", kind: "boolean", group: "groupWrite" },
+  { key: "writePersistKey", kind: "boolean", group: "groupWrite" }
 ];
 var FIELDS = FIELD_SPECS.map((spec) => {
   if (spec.kind === "number") return numberFieldSpec(spec.key);
@@ -410,7 +437,7 @@ if (typeof document !== "undefined" && !document.querySelector('style[data-plugi
   tag.textContent = style2;
   document.head.appendChild(tag);
 }
-var ZoteroSettingsForm_default = { "groupTitle": "iz3HHa_groupTitle", "group": "iz3HHa_group", "fields": "iz3HHa_fields" };
+var ZoteroSettingsForm_default = { "group": "iz3HHa_group", "groupTitle": "iz3HHa_groupTitle", "fields": "iz3HHa_fields" };
 
 // src/client/ZoteroSettingsForm.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
@@ -471,7 +498,7 @@ if (typeof document !== "undefined" && !document.querySelector('style[data-plugi
   tag.textContent = style3;
   document.head.appendChild(tag);
 }
-var ZoteroSettingsSection_default = { "status": "_33OGJa_status", "failed": "_33OGJa_failed", "page": "_33OGJa_page", "title": "_33OGJa_title", "pending": "_33OGJa_pending", "head": "_33OGJa_head", "description": "_33OGJa_description", "footer": "_33OGJa_footer", "discard": "_33OGJa_discard", "save": "_33OGJa_save" };
+var ZoteroSettingsSection_default = { "status": "_33OGJa_status", "failed": "_33OGJa_failed", "page": "_33OGJa_page", "pending": "_33OGJa_pending", "save": "_33OGJa_save", "head": "_33OGJa_head", "footer": "_33OGJa_footer", "discard": "_33OGJa_discard", "title": "_33OGJa_title", "description": "_33OGJa_description" };
 
 // src/client/ZoteroSettingsSection.tsx
 var import_jsx_runtime3 = require("react/jsx-runtime");
@@ -511,7 +538,7 @@ function ZoteroSettingsSection(props) {
 }
 
 // src/client/components/SourcesTab.tsx
-var import_react10 = require("react");
+var import_react11 = require("react");
 
 // src/ref-grammar.ts
 var REF_KEY_SOURCE = "[A-Z0-9]{8}";
@@ -1228,7 +1255,7 @@ function buildSourceWorkspace(blocks, options = {}) {
 }
 
 // src/client/components/workspace/ZoteroWorkspaceView.tsx
-var import_react9 = require("react");
+var import_react10 = require("react");
 
 // node_modules/clsx/dist/clsx.mjs
 function r(e) {
@@ -1439,15 +1466,15 @@ function exportedRefCountOf(exports) {
 }
 
 // src/client/components/workspace/WorkspaceToolbar.tsx
-var import_react = require("react");
+var import_react2 = require("react");
 var import_dsh_client_ui_primitives3 = require("@deepseek-ai/dsh-client-ui-primitives");
 
 // src/client/build-info.ts
 function buildVersion() {
-  return true ? "0.8.3" : "unknown";
+  return true ? "0.9.0" : "unknown";
 }
 function buildCommit() {
-  return true ? "a3ed7f6" : "unknown";
+  return true ? "88341d5" : "unknown";
 }
 function buildInfoOf() {
   return `${buildVersion()} \xB7 ${buildCommit()}`;
@@ -1471,18 +1498,25 @@ if (typeof document !== "undefined" && !document.querySelector('style[data-plugi
   tag.textContent = style4;
   document.head.appendChild(tag);
 }
-var workspace_default = { "filterArrow": "_o1AEW_filterArrow", "summaryLine": "_o1AEW_summaryLine", "lensTabCount": "_o1AEW_lensTabCount", "filterBar": "_o1AEW_filterBar", "listItemMeta": "_o1AEW_listItemMeta", "filterClear": "_o1AEW_filterClear", "passages": "_o1AEW_passages", "workspace": "_o1AEW_workspace", "detailTab": "_o1AEW_detailTab", "statusText": "_o1AEW_statusText", "sectionLabel": "_o1AEW_sectionLabel", "inspectorBody": "_o1AEW_inspectorBody", "detailTabCount": "_o1AEW_detailTabCount", "spacer": "_o1AEW_spacer", "filterArrowLeft": "_o1AEW_filterArrowLeft", "filterArrowRight": "_o1AEW_filterArrowRight", "warning": "_o1AEW_warning", "detailToggle": "_o1AEW_detailToggle", "action": "_o1AEW_action", "emptyWrap": "_o1AEW_emptyWrap", "empty": "_o1AEW_empty", "refresh": "_o1AEW_refresh", "note": "_o1AEW_note", "inspectorMeta": "_o1AEW_inspectorMeta", "diagnosis": "_o1AEW_diagnosis", "menuButton": "_o1AEW_menuButton", "listbox": "_o1AEW_listbox", "inspectorTitle": "_o1AEW_inspectorTitle", "sidebar": "_o1AEW_sidebar", "badge": "_o1AEW_badge", "lensTabActive": "_o1AEW_lensTabActive", "sourceTag": "_o1AEW_sourceTag", "lensTab": "_o1AEW_lensTab", "evidenceEntry": "_o1AEW_evidenceEntry", "inspectorTitleWrap": "_o1AEW_inspectorTitleWrap", "panel": "_o1AEW_panel", "listItemTitle": "_o1AEW_listItemTitle", "section": "_o1AEW_section", "inspectorHead": "_o1AEW_inspectorHead", "starterRow": "_o1AEW_starterRow", "actionRow": "_o1AEW_actionRow", "view": "_o1AEW_view", "availability": "_o1AEW_availability", "emptyNote": "_o1AEW_emptyNote", "passage": "_o1AEW_passage", "detailTabActive": "_o1AEW_detailTabActive", "listItem": "_o1AEW_listItem", "line": "_o1AEW_line", "emptyText": "_o1AEW_emptyText", "listItemSelected": "_o1AEW_listItemSelected", "inspectorTabs": "_o1AEW_inspectorTabs", "exportStack": "_o1AEW_exportStack", "toolbar": "_o1AEW_toolbar", "cardStack": "_o1AEW_cardStack", "passageHead": "_o1AEW_passageHead", "inspector": "_o1AEW_inspector", "backAction": "_o1AEW_backAction", "evidencePage": "_o1AEW_evidencePage", "badges": "_o1AEW_badges", "emptyIcon": "_o1AEW_emptyIcon", "exportsPage": "_o1AEW_exportsPage", "lensBar": "_o1AEW_lensBar" };
+var workspace_default = { "inspectorMeta": "_o1AEW_inspectorMeta", "warning": "_o1AEW_warning", "inspectorTabs": "_o1AEW_inspectorTabs", "section": "_o1AEW_section", "empty": "_o1AEW_empty", "exportsPage": "_o1AEW_exportsPage", "toolbar": "_o1AEW_toolbar", "sectionLabel": "_o1AEW_sectionLabel", "emptyNote": "_o1AEW_emptyNote", "starterRow": "_o1AEW_starterRow", "evidencePage": "_o1AEW_evidencePage", "summaryLine": "_o1AEW_summaryLine", "backAction": "_o1AEW_backAction", "actionRow": "_o1AEW_actionRow", "detailToggle": "_o1AEW_detailToggle", "listbox": "_o1AEW_listbox", "line": "_o1AEW_line", "badges": "_o1AEW_badges", "emptyWrap": "_o1AEW_emptyWrap", "inspector": "_o1AEW_inspector", "note": "_o1AEW_note", "passage": "_o1AEW_passage", "lensTabActive": "_o1AEW_lensTabActive", "inspectorBody": "_o1AEW_inspectorBody", "inspectorTitle": "_o1AEW_inspectorTitle", "availability": "_o1AEW_availability", "cardStack": "_o1AEW_cardStack", "filterBar": "_o1AEW_filterBar", "filterClear": "_o1AEW_filterClear", "badge": "_o1AEW_badge", "lensTab": "_o1AEW_lensTab", "filterArrowLeft": "_o1AEW_filterArrowLeft", "diagnosis": "_o1AEW_diagnosis", "inspectorHead": "_o1AEW_inspectorHead", "sourceTag": "_o1AEW_sourceTag", "menuButton": "_o1AEW_menuButton", "detailTabCount": "_o1AEW_detailTabCount", "evidenceEntry": "_o1AEW_evidenceEntry", "listItemTitle": "_o1AEW_listItemTitle", "filterArrowRight": "_o1AEW_filterArrowRight", "action": "_o1AEW_action", "listItemMeta": "_o1AEW_listItemMeta", "emptyIcon": "_o1AEW_emptyIcon", "spacer": "_o1AEW_spacer", "detailTabActive": "_o1AEW_detailTabActive", "refresh": "_o1AEW_refresh", "workspace": "_o1AEW_workspace", "panel": "_o1AEW_panel", "sidebar": "_o1AEW_sidebar", "inspectorTitleWrap": "_o1AEW_inspectorTitleWrap", "emptyText": "_o1AEW_emptyText", "passages": "_o1AEW_passages", "filterArrow": "_o1AEW_filterArrow", "passageHead": "_o1AEW_passageHead", "exportStack": "_o1AEW_exportStack", "statusText": "_o1AEW_statusText", "detailTab": "_o1AEW_detailTab", "lensBar": "_o1AEW_lensBar", "view": "_o1AEW_view", "listItem": "_o1AEW_listItem", "lensTabCount": "_o1AEW_lensTabCount", "listItemSelected": "_o1AEW_listItemSelected" };
 
 // src/client/components/workspace/WorkspaceToolbar.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
 function WorkspaceToolbar({ connection, onRefresh, t }) {
-  const [menuOpen, setMenuOpen] = (0, import_react.useState)(false);
+  const [menuOpen, setMenuOpen] = (0, import_react2.useState)(false);
   const failed = connection.kind === "unavailable" || connection.kind === "remote-error";
   const diagnosis = failed ? connectionDiagnosisOf(connection, t) : "";
   const checkedAt = connection.kind === "connected" || connection.kind === "unavailable" ? connection.checkedAt : void 0;
   const data = connection.kind === "connected" || connection.kind === "unavailable" ? connection.data : void 0;
   const menuItems = [
     ...data?.serverId !== void 0 ? [{ id: "serverId", label: `${t("serverIdLabel")} ${data.serverId}`, disabled: true }] : [],
+    ...data?.write !== void 0 ? [
+      {
+        id: "write",
+        label: `${t("writeLabel")} ${data.write.enabled ? data.write.authorized ? t("writeAuthorizedLabel") : t("writeUnauthorizedLabel") : t("writeDisabledLabel")}`,
+        disabled: true
+      }
+    ] : [],
     ...data?.zoteroVersion !== void 0 ? [
       {
         id: "zotero",
@@ -1566,7 +1600,7 @@ function WorkspaceToolbar({ connection, onRefresh, t }) {
 }
 
 // src/client/components/workspace/SourceSidebar.tsx
-var import_react2 = require("react");
+var import_react3 = require("react");
 var import_dsh_client_ui_primitives4 = require("@deepseek-ai/dsh-client-ui-primitives");
 
 // src/client/components/workspace/SourceListItem.tsx
@@ -1635,22 +1669,22 @@ function SourceSidebar({
   asideRef,
   t
 }) {
-  const optionRefs = (0, import_react2.useRef)([]);
+  const optionRefs = (0, import_react3.useRef)([]);
   optionRefs.current.length = visible.length;
   const asideRefLocal = asideRef;
-  const filterBarRef = (0, import_react2.useRef)(null);
-  const [filterEdges, setFilterEdges] = (0, import_react2.useState)({ left: false, right: false });
-  const updateFilterEdges = (0, import_react2.useCallback)(() => {
+  const filterBarRef = (0, import_react3.useRef)(null);
+  const [filterEdges, setFilterEdges] = (0, import_react3.useState)({ left: false, right: false });
+  const updateFilterEdges = (0, import_react3.useCallback)(() => {
     const el = filterBarRef.current;
     if (el === null) return;
     const left = el.scrollLeft > 1;
     const right = el.scrollLeft < el.scrollWidth - el.clientWidth - 1;
     setFilterEdges((prev) => prev.left === left && prev.right === right ? prev : { left, right });
   }, []);
-  (0, import_react2.useLayoutEffect)(() => {
+  (0, import_react3.useLayoutEffect)(() => {
     updateFilterEdges();
   }, [counts, filter, updateFilterEdges]);
-  (0, import_react2.useEffect)(() => {
+  (0, import_react3.useEffect)(() => {
     const el = filterBarRef.current;
     if (el === null) return;
     el.addEventListener("scroll", updateFilterEdges);
@@ -1798,10 +1832,10 @@ function SourceSidebar({
 }
 
 // src/client/components/workspace/SourceInspector.tsx
-var import_react8 = require("react");
+var import_react9 = require("react");
 
 // src/client/components/workspace/SourceOverview.tsx
-var import_react5 = require("react");
+var import_react6 = require("react");
 
 // src/client/actions/source-actions.ts
 function askDraftOf(ref, t) {
@@ -1812,7 +1846,7 @@ function exportDraftOf(ref, t) {
 }
 
 // src/client/components/CopyButton.tsx
-var import_react3 = require("react");
+var import_react4 = require("react");
 var import_dsh_client_ui_primitives5 = require("@deepseek-ai/dsh-client-ui-primitives");
 
 // src/client/components/cards.module.css
@@ -1823,14 +1857,14 @@ if (typeof document !== "undefined" && !document.querySelector('style[data-plugi
   tag.textContent = style5;
   document.head.appendChild(tag);
 }
-var cards_default = { "sourceTag": "_27yOoG_sourceTag", "passageHead": "_27yOoG_passageHead", "lineActions": "_27yOoG_lineActions", "exportCode": "_27yOoG_exportCode", "note": "_27yOoG_note", "passages": "_27yOoG_passages", "lineAction": "_27yOoG_lineAction", "exportSectionCount": "_27yOoG_exportSectionCount", "exportCodeLabel": "_27yOoG_exportCodeLabel", "chevron": "_27yOoG_chevron", "link": "_27yOoG_link", "exportSectionActions": "_27yOoG_exportSectionActions", "passage": "_27yOoG_passage", "exportPre": "_27yOoG_exportPre", "exportToggle": "_27yOoG_exportToggle", "exportKeys": "_27yOoG_exportKeys", "exportTitle": "_27yOoG_exportTitle", "exportRow": "_27yOoG_exportRow", "line": "_27yOoG_line", "documentKey": "_27yOoG_documentKey", "card": "_27yOoG_card", "availability": "_27yOoG_availability", "exportCodeHead": "_27yOoG_exportCodeHead", "cardHead": "_27yOoG_cardHead", "unresolvedItems": "_27yOoG_unresolvedItems", "exportSection": "_27yOoG_exportSection", "unresolvedItemsText": "_27yOoG_unresolvedItemsText", "documentTitle": "_27yOoG_documentTitle", "exportHead": "_27yOoG_exportHead", "exportSectionTitle": "_27yOoG_exportSectionTitle", "exportKeysText": "_27yOoG_exportKeysText", "cardTitle": "_27yOoG_cardTitle", "exportSectionHead": "_27yOoG_exportSectionHead", "exportFacts": "_27yOoG_exportFacts", "chevronOpen": "_27yOoG_chevronOpen", "exportBody": "_27yOoG_exportBody" };
+var cards_default = { "exportSectionTitle": "_27yOoG_exportSectionTitle", "exportFacts": "_27yOoG_exportFacts", "lineAction": "_27yOoG_lineAction", "cardTitle": "_27yOoG_cardTitle", "chevron": "_27yOoG_chevron", "unresolvedItemsText": "_27yOoG_unresolvedItemsText", "exportKeys": "_27yOoG_exportKeys", "line": "_27yOoG_line", "exportBody": "_27yOoG_exportBody", "exportKeysText": "_27yOoG_exportKeysText", "passages": "_27yOoG_passages", "chevronOpen": "_27yOoG_chevronOpen", "exportHead": "_27yOoG_exportHead", "exportTitle": "_27yOoG_exportTitle", "exportPre": "_27yOoG_exportPre", "note": "_27yOoG_note", "exportSectionActions": "_27yOoG_exportSectionActions", "exportSection": "_27yOoG_exportSection", "unresolvedItems": "_27yOoG_unresolvedItems", "passageHead": "_27yOoG_passageHead", "exportSectionCount": "_27yOoG_exportSectionCount", "lineActions": "_27yOoG_lineActions", "card": "_27yOoG_card", "exportSectionHead": "_27yOoG_exportSectionHead", "cardHead": "_27yOoG_cardHead", "exportCode": "_27yOoG_exportCode", "sourceTag": "_27yOoG_sourceTag", "link": "_27yOoG_link", "documentKey": "_27yOoG_documentKey", "exportRow": "_27yOoG_exportRow", "exportCodeLabel": "_27yOoG_exportCodeLabel", "documentTitle": "_27yOoG_documentTitle", "availability": "_27yOoG_availability", "passage": "_27yOoG_passage", "exportToggle": "_27yOoG_exportToggle", "exportCodeHead": "_27yOoG_exportCodeHead" };
 
 // src/client/components/CopyButton.tsx
 var import_jsx_runtime7 = require("react/jsx-runtime");
 function CopyButton({ value, label, copiedLabel, className }) {
-  const [copied, setCopied] = (0, import_react3.useState)(false);
-  const epoch = (0, import_react3.useRef)(0);
-  (0, import_react3.useEffect)(() => {
+  const [copied, setCopied] = (0, import_react4.useState)(false);
+  const epoch = (0, import_react4.useRef)(0);
+  (0, import_react4.useEffect)(() => {
     if (!copied) return;
     const timer = window.setTimeout(() => {
       setCopied(false);
@@ -1857,7 +1891,7 @@ function CopyButton({ value, label, copiedLabel, className }) {
 }
 
 // src/client/components/open/BlockedOpenAction.tsx
-var import_react4 = require("react");
+var import_react5 = require("react");
 var import_dsh_client_ui_primitives6 = require("@deepseek-ai/dsh-client-ui-primitives");
 
 // src/client/components/open/open.module.css
@@ -1868,13 +1902,13 @@ if (typeof document !== "undefined" && !document.querySelector('style[data-plugi
   tag.textContent = style6;
   document.head.appendChild(tag);
 }
-var open_default = { "srOnly": "_02bwZG_srOnly", "linkWrap": "_02bwZG_linkWrap", "linkIcon": "_02bwZG_linkIcon", "blocked": "_02bwZG_blocked", "link": "_02bwZG_link", "note": "_02bwZG_note", "button": "_02bwZG_button" };
+var open_default = { "linkWrap": "_02bwZG_linkWrap", "button": "_02bwZG_button", "note": "_02bwZG_note", "linkIcon": "_02bwZG_linkIcon", "blocked": "_02bwZG_blocked", "link": "_02bwZG_link", "srOnly": "_02bwZG_srOnly" };
 
 // src/client/components/open/BlockedOpenAction.tsx
 var import_jsx_runtime8 = require("react/jsx-runtime");
 function BlockedOpenAction({ label, t, className }) {
   const reason = t("provenanceMismatch");
-  const reasonId = (0, import_react4.useId)();
+  const reasonId = (0, import_react5.useId)();
   return /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(import_jsx_runtime8.Fragment, { children: [
     /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(import_dsh_client_ui_primitives6.Tooltip, { label: reason, children: /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
       "button",
@@ -1948,7 +1982,7 @@ function filterLineOf(itemTypes, tags, t) {
   return parts.length === 0 ? "" : parts.join(" \xB7 ");
 }
 function SourceOverview({ item, t, setDraft }) {
-  const [detailOpen, setDetailOpen] = (0, import_react5.useState)(false);
+  const [detailOpen, setDetailOpen] = (0, import_react6.useState)(false);
   const verdict = openVerdictOf(item);
   const selectUrl = selectUrlOf(item.ref);
   const pdfCapability = pdfCapabilityOf(item);
@@ -2129,7 +2163,7 @@ function downloadBlob(text, fileName, mime) {
 }
 
 // src/client/components/ExportDocumentRow.tsx
-var import_react7 = require("react");
+var import_react8 = require("react");
 var import_dsh_client_ui_primitives9 = require("@deepseek-ai/dsh-client-ui-primitives");
 
 // src/export-items.ts
@@ -2155,7 +2189,7 @@ function citeCommandOf(keys) {
 }
 
 // src/client/components/ExportCard.tsx
-var import_react6 = require("react");
+var import_react7 = require("react");
 var import_dsh_client_ui_primitives8 = require("@deepseek-ai/dsh-client-ui-primitives");
 var import_jsx_runtime12 = require("react/jsx-runtime");
 function formatLabelOf(format, t) {
@@ -2219,12 +2253,12 @@ function artifactTimeOf(artifact) {
   return `${pad(date5.getHours())}:${pad(date5.getMinutes())}`;
 }
 function ExportCard({ artifact, t }) {
-  const [open, setOpen] = (0, import_react6.useState)(false);
-  const keys = (0, import_react6.useMemo)(
+  const [open, setOpen] = (0, import_react7.useState)(false);
+  const keys = (0, import_react7.useMemo)(
     () => artifact.format === "bibtex" || artifact.format === "biblatex" ? bibTexKeysOf(artifact.text) : [],
     [artifact.format, artifact.text]
   );
-  const citeCommand = (0, import_react6.useMemo)(() => citeCommandOf(keys), [keys]);
+  const citeCommand = (0, import_react7.useMemo)(() => citeCommandOf(keys), [keys]);
   const timeLabel = artifactTimeOf(artifact);
   const download = () => {
     downloadBlob(artifact.text, fileNameOf(artifact), mimeOf(artifact.format));
@@ -2271,8 +2305,8 @@ function ExportCard({ artifact, t }) {
 // src/client/components/ExportDocumentRow.tsx
 var import_jsx_runtime13 = require("react/jsx-runtime");
 function ExportDocumentRow({ doc, t }) {
-  const [open, setOpen] = (0, import_react7.useState)(false);
-  const citeCommand = (0, import_react7.useMemo)(
+  const [open, setOpen] = (0, import_react8.useState)(false);
+  const citeCommand = (0, import_react8.useMemo)(
     () => doc.key === void 0 ? "" : citeCommandOf([doc.key]),
     [doc.key]
   );
@@ -2410,12 +2444,12 @@ function SourceInspector({
   setDraft,
   t
 }) {
-  const [panel, setPanel] = (0, import_react8.useState)("overview");
-  const selected = (0, import_react8.useMemo)(
+  const [panel, setPanel] = (0, import_react9.useState)("overview");
+  const selected = (0, import_react9.useMemo)(
     () => workspace.sources.find((item) => item.key === selectedKey),
     [workspace.sources, selectedKey]
   );
-  (0, import_react8.useEffect)(() => {
+  (0, import_react9.useEffect)(() => {
     setPanel("overview");
   }, [selectedKey]);
   if (selected === void 0) {
@@ -2691,22 +2725,22 @@ function ZoteroWorkspaceView({
   onRefresh,
   t
 }) {
-  const [lens, setLens] = (0, import_react9.useState)("sources");
-  const [filter, setFilter] = (0, import_react9.useState)("all");
-  const [selection, setSelection] = (0, import_react9.useState)({ key: void 0, focusIndex: 0 });
-  const [mobilePane, setMobilePane] = (0, import_react9.useState)("list");
-  const [evidenceOpen, setEvidenceOpen] = (0, import_react9.useState)(false);
-  const asideRef = (0, import_react9.useRef)(null);
-  const counts = (0, import_react9.useMemo)(() => filterCountsOf(workspace.sources), [workspace.sources]);
-  const visible = (0, import_react9.useMemo)(
+  const [lens, setLens] = (0, import_react10.useState)("sources");
+  const [filter, setFilter] = (0, import_react10.useState)("all");
+  const [selection, setSelection] = (0, import_react10.useState)({ key: void 0, focusIndex: 0 });
+  const [mobilePane, setMobilePane] = (0, import_react10.useState)("list");
+  const [evidenceOpen, setEvidenceOpen] = (0, import_react10.useState)(false);
+  const asideRef = (0, import_react10.useRef)(null);
+  const counts = (0, import_react10.useMemo)(() => filterCountsOf(workspace.sources), [workspace.sources]);
+  const visible = (0, import_react10.useMemo)(
     () => filterSources(workspace.sources, filter),
     [workspace.sources, filter]
   );
-  const selectedKey = (0, import_react9.useMemo)(
+  const selectedKey = (0, import_react10.useMemo)(
     () => effectiveSelectionOf(selection, workspace.sources, visible),
     [selection, workspace.sources, visible]
   );
-  const exportedCount = (0, import_react9.useMemo)(() => exportedRefCountOf(workspace.exports), [workspace.exports]);
+  const exportedCount = (0, import_react10.useMemo)(() => exportedRefCountOf(workspace.exports), [workspace.exports]);
   void sessionId;
   if (evidenceOpen) {
     return /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)("div", { className: workspace_default.view, "data-conversation-composer-overlay": true, children: [
@@ -2884,22 +2918,22 @@ function collectZoteroCalls(snapshot) {
   return out;
 }
 function useZoteroBlocks(chat) {
-  const signature = (0, import_react10.useMemo)(() => sessionSignatureOf(chat), [chat]);
-  return (0, import_react10.useMemo)(() => collectZoteroCalls(chat), [signature]);
+  const signature = (0, import_react11.useMemo)(() => sessionSignatureOf(chat), [chat]);
+  return (0, import_react11.useMemo)(() => collectZoteroCalls(chat), [signature]);
 }
 function SourcesTab({ status, t, useSession, useChat, inputActions }) {
   const sessionId = useSession((snapshot) => snapshot.sessionId);
   const chat = useChat((snapshot) => snapshot);
-  const [statusState, setStatusState] = (0, import_react10.useState)({ kind: "loading" });
-  const [requestId, setRequestId] = (0, import_react10.useState)(0);
-  const [serverId, setServerId] = (0, import_react10.useState)(void 0);
+  const [statusState, setStatusState] = (0, import_react11.useState)({ kind: "loading" });
+  const [requestId, setRequestId] = (0, import_react11.useState)(0);
+  const [serverId, setServerId] = (0, import_react11.useState)(void 0);
   const blocks = useZoteroBlocks(chat);
-  const workspace = (0, import_react10.useMemo)(
+  const workspace = (0, import_react11.useMemo)(
     () => buildSourceWorkspace(blocks, { currentServerId: serverId }),
     [blocks, serverId]
   );
   const setDraft = inputActions?.setDraft.bind(inputActions);
-  (0, import_react10.useEffect)(() => {
+  (0, import_react11.useEffect)(() => {
     if (status === void 0) return;
     const controller = new AbortController();
     setStatusState({ kind: "loading" });
@@ -17471,8 +17505,15 @@ var zoteroStatusSchema = external_exports.object({
   serverId: external_exports.string().optional(),
   schemaVersion: external_exports.string().optional(),
   zoteroVersion: external_exports.string().optional(),
+  write: external_exports.object({ enabled: external_exports.boolean(), authorized: external_exports.boolean() }).strict().optional(),
   diagnosis: external_exports.string()
 }).strict().readonly();
+var zoteroStatusCodec = {
+  mode: "strict",
+  typeSymbol: "dsh-zotero#ZoteroStatusView",
+  create: () => zoteroStatusSchema,
+  schema: zoteroStatusSchema
+};
 var ZOTERO_INVOCATIONS = [
   {
     id: "dsh-zotero#zotero/status",
@@ -17481,11 +17522,7 @@ var ZOTERO_INVOCATIONS = [
     method: "status",
     invocation: { kind: "direct" },
     parameters: [],
-    result: {
-      mode: "strict",
-      typeSymbol: "dsh-zotero#ZoteroStatusView",
-      schema: zoteroStatusSchema
-    }
+    result: zoteroStatusCodec
   }
 ];
 
@@ -17514,6 +17551,13 @@ var en = {
   groupSearch: "Search limits",
   groupOutput: "Output limits",
   groupDefaults: "Export defaults",
+  groupWrite: "Writing",
+  writeEnabled: "Enable write tools",
+  writeEnabledHint: "Registers zotero_create_note, zotero_add_tags, and zotero_add_to_collection, and lets the local provider serve writes. Zotero 10 still gates every write behind its own authorization dialog.",
+  writeConfirm: "Confirm each write",
+  writeConfirmHint: "Shows a plan card and waits for your approval before every write. The Zotero key gate stays in force either way.",
+  writePersistKey: "Store the Zotero write key",
+  writePersistKeyHint: 'Persists an "Always Allow" key from the Zotero dialog into the credentials store, bound to the Zotero instance that issued it. One-time keys are never stored.',
   baseUrl: "Local API base URL",
   baseUrlHint: "Must be a loopback HTTP address (127.0.0.1, localhost, or ::1).",
   provider: "Provider id",
@@ -17569,6 +17613,10 @@ var en = {
   schemaVersionLabel: "Schema version",
   zoteroVersionLabel: "Zotero version",
   serverIdLabel: "Server ID",
+  writeLabel: "Write",
+  writeAuthorizedLabel: "enabled, key stored",
+  writeUnauthorizedLabel: "enabled, no key yet",
+  writeDisabledLabel: "disabled",
   buildInfoLabel: "Build",
   diagnosisLabel: "Diagnosis",
   refresh: "Refresh",
@@ -17700,6 +17748,13 @@ var zh = {
   groupSearch: "\u68C0\u7D22\u9650\u5236",
   groupOutput: "\u8F93\u51FA\u9650\u5236",
   groupDefaults: "\u5BFC\u51FA\u9ED8\u8BA4",
+  groupWrite: "\u5199\u5165",
+  writeEnabled: "\u542F\u7528\u5199\u5165\u5DE5\u5177",
+  writeEnabledHint: "\u6CE8\u518C zotero_create_note\u3001zotero_add_tags\u3001zotero_add_to_collection\uFF0C\u5E76\u5141\u8BB8 local provider \u63D0\u4F9B\u5199\u5165\u80FD\u529B\u3002Zotero 10 \u4ECD\u4F1A\u7528\u5B83\u81EA\u5DF1\u7684\u6388\u6743\u5F39\u7A97\u628A\u5173\u6BCF\u4E00\u6B21\u5199\u5165\u3002",
+  writeConfirm: "\u6BCF\u6B21\u5199\u5165\u524D\u786E\u8BA4",
+  writeConfirmHint: "\u6BCF\u6B21\u5199\u5165\u524D\u5C55\u793A\u8BA1\u5212\u5361\u7247\u5E76\u7B49\u5F85\u4F60\u6279\u51C6\u3002\u65E0\u8BBA\u6B64\u9879\u5F00\u5173\u5982\u4F55\uFF0CZotero \u81EA\u5DF1\u7684 key \u5173\u5361\u59CB\u7EC8\u751F\u6548\u3002",
+  writePersistKey: "\u4FDD\u5B58 Zotero \u5199\u5165\u5BC6\u94A5",
+  writePersistKeyHint: '\u628A Zotero \u6388\u6743\u5F39\u7A97\u91CC"Always Allow"\u7B7E\u53D1\u7684\u5BC6\u94A5\u5B58\u5165\u5BBF\u4E3B\u51ED\u636E\u5E93\uFF0C\u5E76\u7ED1\u5B9A\u5230\u7B7E\u53D1\u5B83\u7684 Zotero \u5B9E\u4F8B\u3002\u4E00\u6B21\u6027\u5BC6\u94A5\u6C38\u4E0D\u843D\u76D8\u3002',
   baseUrl: "Local API \u5730\u5740",
   baseUrlHint: "\u4EC5\u5141\u8BB8\u672C\u673A\u56DE\u73AF HTTP \u5730\u5740\uFF08127.0.0.1\u3001localhost \u6216 ::1\uFF09\u3002",
   provider: "\u63D0\u4F9B\u65B9 ID",
@@ -17754,7 +17809,11 @@ var zh = {
   apiVersionLabel: "API \u7248\u672C",
   schemaVersionLabel: "Schema \u7248\u672C",
   zoteroVersionLabel: "Zotero \u7248\u672C",
-  serverIdLabel: "Server ID",
+  serverIdLabel: "\u670D\u52A1\u5668 ID",
+  writeLabel: "\u5199\u5165",
+  writeAuthorizedLabel: "\u5DF2\u542F\u7528\uFF0C\u5BC6\u94A5\u5DF2\u4FDD\u5B58",
+  writeUnauthorizedLabel: "\u5DF2\u542F\u7528\uFF0C\u5C1A\u672A\u6388\u6743",
+  writeDisabledLabel: "\u5DF2\u5173\u95ED",
   buildInfoLabel: "\u6784\u5EFA",
   diagnosisLabel: "\u8BCA\u65AD",
   refresh: "\u5237\u65B0",