dsh-quicknote 0.0.0-stage → 0.1.0

package/AGENTS.md

@@ -0,0 +1,28 @@
+# dsh-quicknote — agent notes
+
+Read this before changing code. User docs: [README.md](README.md).
+
+## Commands
+
+```bash
+pnpm install
+pnpm verify        # format → lint → typecheck → test → build → pack
+pnpm typecheck
+pnpm test
+pnpm build
+```
+
+## Layout
+
+- `src/host/` — Host half: services, tools, routes. No browser APIs.
+- `src/client/` — browser half: React 19 components (TSX), slots, styles. No Node APIs.
+- `src/shared/` — constants both halves import (`NAME`, `NS`, `PLUGIN_ID`).
+- `lib/` — generated. Never edit by hand.
+- `tests/` — one suite per half.
+
+## Invariants
+
+- `package.json` `name` === `src/shared/constants.ts` `NAME` === the client bundle id.
+- The `window.__ModuleLoader__.load` wrapper is generated by `tsdown.config.ts`; source must not contain it.
+- No network calls, no telemetry, no `console.log` in shipped code.
+- Any destructive action must be reversible and must state its consequence.

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.1.0
+
+First release.
+
+- Composer toolbar button with a capture card prefilled from the current draft
+- Save note, or save and explicitly clear the draft
+- Sidebar page: newest-first list, done/reopen, delete
+- Four Agent tools: add, list, done, delete
+- Local JSON store at `~/.dsh/quicknote/notes.json` (0600, atomic writes)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-kit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PUBLISHING.md

@@ -0,0 +1,11 @@
+# Publishing
+
+1. Run `pnpm verify` and make sure it is green.
+2. Bump `version` and add the matching `CHANGELOG.md` entry.
+3. Inspect the artifact: `npm pack --dry-run`.
+4. Publish with provenance: `npm publish --provenance`.
+5. Tag the release: `git tag v<version>` and push the tag.
+6. Install the published package into a fresh profile and check the client bundle is served.
+
+For local development, `dsh plugin --profile <profile> add link:$PWD` installs the working copy instead of a
+published version.

package/README.md

@@ -1,3 +1,63 @@
-# Temporary Holding Version
+# dsh-quicknote
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Capture a note from the composer, keep it out of the way, and find it again on one page.
+
+- **From the composer**: click **Note** in the composer toolbar. The card opens with the current draft; save it
+  as a note, or save and explicitly clear the draft.
+- **From the sidebar**: the Quick Note page lists everything newest-first, with done/reopen and delete.
+- **From an agent**: `quicknote_add`, `quicknote_list`, `quicknote_done`, `quicknote_delete`.
+- **Storage**: `~/.dsh/quicknote/notes.json` — local, mode `0600`, atomic writes. No telemetry.
+
+## Documentation
+
+<https://dsh-kit.github.io/dsh-quicknote/>
+
+## Install
+
+For development, link the working copy:
+
+```bash
+dsh plugin --profile <profile> add link:$PWD
+```
+
+A published release installs by package name:
+
+```bash
+dsh plugin --profile <profile> add dsh-quicknote
+```
+
+Desktop profiles are managed by the app: add `dsh-quicknote` to `dsh.profile.bundles` and the dependency, run
+`pnpm install` in the profile, then restart DSH.
+
+## Verify
+
+```bash
+dsh --profile <profile> --dump-config | grep -A2 "id: dsh-quicknote"
+```
+
+## Develop
+
+```bash
+pnpm install
+pnpm verify   # format → lint → typecheck → tests → build → pack
+```
+
+npm works too: `npm install && npm run verify`.
+
+- `src/host/` — store, four JSON routes and four Agent tools.
+- `src/client/` — composer button, capture card, sidebar page.
+- `lib/` — generated, committed (a `link:` install never builds).
+- `tests/` — store and client registration.
+- `AGENTS.md` / `llms.txt` — agent context.
+- `PUBLISHING.md` — release checklist.
+
+## Data and API
+
+- `GET /api/quicknote/notes`
+- `POST /api/quicknote/notes/create` `{ text }`
+- `POST /api/quicknote/notes/update` `{ id, done }`
+- `POST /api/quicknote/notes/delete` `{ id }`
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,61 @@
+# dsh-quicknote
+
+从输入框随手记下一条，不打断当前对话，之后在一页里找回。
+
+- **从输入框**：点击工具栏的 **记一下**；卡片会带上当前草稿。可以只保存笔记，也可以显式选择“保存并清空输入框”。
+- **从侧栏**：随手记页面按时间倒序列出全部笔记，可完成、重新打开、删除。
+- **从 Agent**：`quicknote_add`、`quicknote_list`、`quicknote_done`、`quicknote_delete`。
+- **存储**：`~/.dsh/quicknote/notes.json`，本地、权限 `0600`、原子写入，无遥测。
+
+## 文档
+
+<https://dsh-kit.github.io/dsh-quicknote/zh/>
+
+## 安装
+
+开发时链接工作副本：
+
+```bash
+dsh plugin --profile <profile> add link:$PWD
+```
+
+发布后按包名安装：
+
+```bash
+dsh plugin --profile <profile> add dsh-quicknote
+```
+
+桌面 profile 由应用托管：把 `dsh-quicknote` 加进 `dsh.profile.bundles` 与依赖，在 profile 里执行 `pnpm install`，重启 DSH。
+
+## 验证
+
+```bash
+dsh --profile <profile> --dump-config | grep -A2 "id: dsh-quicknote"
+```
+
+## 开发
+
+```bash
+pnpm install
+pnpm verify   # 格式 → lint → 类型 → 测试 → 构建 → 打包
+```
+
+npm 也可用：`npm install && npm run verify`。
+
+- `src/host/`：存储、四个 JSON 路由、四个 Agent 工具；
+- `src/client/`：输入框按钮、记录卡片、侧栏页面；
+- `lib/`：构建产物，提交进仓库（`link:` 安装不会构建）；
+- `tests/`：存储与客户端注册测试；
+- `AGENTS.md` / `llms.txt`：agent 上下文；
+- `PUBLISHING.md`：发布清单。
+
+## 数据与 API
+
+- `GET /api/quicknote/notes`
+- `POST /api/quicknote/notes/create` `{ text }`
+- `POST /api/quicknote/notes/update` `{ id, done }`
+- `POST /api/quicknote/notes/delete` `{ id }`
+
+## 许可
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# DSH composes a profile from patch layers. Every bundle contributes one; this
+# layer inserts the plugin's own row. It does not patch another plugin.
+- insert:
+    - id: dsh-quicknote
+      name: dsh-quicknote

package/icon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24" fill="none">
+  <rect x="4" y="4" width="16" height="16" rx="4" stroke="currentColor" stroke-width="1.6"/>
+  <path d="M8 12h8" stroke="currentColor" stroke-width="1.6" stroke-linecap="round"/>
+</svg>

package/lib/client.js

@@ -0,0 +1,534 @@
+window.__ModuleLoader__.load({
+	id: "dsh-quicknote",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react = require("react");
+		let react_jsx_runtime = require("react/jsx-runtime");
+		// src/shared/constants.ts
+		/** Package name; must equal package.json `name` (the client bundle id). */
+		const NAME = "dsh-quicknote";
+		/** Locale namespace owned by this plugin. */
+		const NS = "dsh-quicknote";
+		/** Host JSON API used by the page. */
+		const API = "/api/quicknote";
+		// src/client/session.ts
+		/** Access to the per-Session composer owned by the conversation service. */
+		let clientCtx = null;
+		function setClientContext(ctx) {
+			clientCtx = ctx;
+		}
+		function sessionIdNear(node) {
+			try {
+				const id = (typeof node?.closest === "function" ? node.closest("[data-conversation-session]") : null)?.getAttribute("data-conversation-session");
+				return typeof id === "string" && id !== "" ? id : void 0;
+			} catch {
+				return;
+			}
+		}
+		function composerOf(sessionId) {
+			if (sessionId === void 0) return void 0;
+			try {
+				const input = clientCtx?.get("conversation")?.input;
+				if (typeof input?.shell !== "function") return void 0;
+				const shell = input.shell(sessionId);
+				if (!shell?.state || !shell?.actions) return void 0;
+				return shell;
+			} catch {
+				return;
+			}
+		}
+		function draftOf(sessionId) {
+			try {
+				return String(composerOf(sessionId)?.state.getSnapshot().draft ?? "");
+			} catch {
+				return "";
+			}
+		}
+		// src/client/ComposerButton.tsx
+		/** A labelled button in the composer toolbar. No icon-only destructive control. */
+		function ComposerButton({ t }) {
+			function open(event) {
+				const sessionId = sessionIdNear(event.currentTarget);
+				window.dispatchEvent(new CustomEvent("dsh-quicknote:open", { detail: {
+					sessionId,
+					text: draftOf(sessionId)
+				} }));
+			}
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+				type: "button",
+				onClick: open,
+				"data-testid": "quicknote-composer",
+				style: {
+					display: "inline-flex",
+					alignItems: "center",
+					gap: 6,
+					padding: "5px 9px",
+					borderRadius: 8,
+					border: "1px solid var(--dsw-alias-line, #d9dce1)",
+					background: "transparent",
+					color: "inherit",
+					font: "inherit",
+					cursor: "pointer"
+				},
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+					viewBox: "0 0 16 16",
+					width: "16",
+					height: "16",
+					fill: "none",
+					"aria-hidden": "true",
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("rect", {
+						x: "2.75",
+						y: "2.75",
+						width: "10.5",
+						height: "10.5",
+						rx: "2",
+						stroke: "currentColor"
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+						d: "M5.5 8h5",
+						stroke: "currentColor",
+						strokeLinecap: "round"
+					})]
+				}), t("toolbar.capture")]
+			});
+		}
+		// src/client/Overlay.tsx
+		/** Capture card in the shell overlay; saves a note and optionally clears the draft. */
+		function Overlay({ t }) {
+			const [open, setOpen] = (0, react.useState)(false);
+			const [text, setText] = (0, react.useState)("");
+			const [sessionId, setSessionId] = (0, react.useState)(void 0);
+			const [error, setError] = (0, react.useState)("");
+			const [saving, setSaving] = (0, react.useState)(false);
+			(0, react.useEffect)(() => {
+				const onOpen = (event) => {
+					const detail = event.detail;
+					setText(detail?.text ?? "");
+					setSessionId(detail?.sessionId);
+					setError("");
+					setOpen(true);
+				};
+				window.addEventListener("dsh-quicknote:open", onOpen);
+				return () => window.removeEventListener("dsh-quicknote:open", onOpen);
+			}, []);
+			(0, react.useEffect)(() => {
+				if (!open) return;
+				const onKey = (event) => {
+					if (event.key === "Escape") setOpen(false);
+				};
+				window.addEventListener("keydown", onKey);
+				return () => window.removeEventListener("keydown", onKey);
+			}, [open]);
+			async function save(clearDraft) {
+				if (text.trim() === "" || saving) return;
+				setSaving(true);
+				setError("");
+				try {
+					const response = await fetch(`${API}/notes/create`, {
+						method: "POST",
+						headers: { "content-type": "application/json" },
+						body: JSON.stringify({ text })
+					});
+					const result = await response.json();
+					if (!response.ok || !result.ok) throw new Error(result.error ?? "save-failed");
+					if (clearDraft && sessionId !== void 0) try {
+						composerOf(sessionId)?.actions.setDraft("");
+					} catch {}
+					setOpen(false);
+					window.dispatchEvent(new Event("dsh-quicknote:changed"));
+				} catch (cause) {
+					setError(String(cause.message));
+				} finally {
+					setSaving(false);
+				}
+			}
+			if (!open) return null;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				style: {
+					position: "fixed",
+					inset: 0,
+					zIndex: 50,
+					display: "flex",
+					alignItems: "center",
+					justifyContent: "center",
+					background: "rgba(15,17,21,.45)",
+					padding: 24
+				},
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					role: "dialog",
+					"aria-modal": "true",
+					"aria-label": t("overlay.title"),
+					style: {
+						width: "min(560px, 100%)",
+						padding: 20,
+						borderRadius: 14,
+						background: "var(--dsw-alias-bg, #fff)",
+						boxShadow: "0 24px 70px rgba(0,0,0,.3)"
+					},
+					children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
+							style: {
+								margin: 0,
+								fontSize: 18
+							},
+							children: t("overlay.title")
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
+							"data-testid": "quicknote-overlay-input",
+							autoFocus: true,
+							value: text,
+							onChange: (event) => setText(event.target.value),
+							rows: 5,
+							style: {
+								width: "100%",
+								boxSizing: "border-box",
+								marginTop: 12,
+								padding: 10,
+								borderRadius: 8,
+								border: "1px solid var(--dsw-alias-line, #d9dce1)",
+								font: "inherit",
+								resize: "vertical"
+							}
+						}),
+						error === "" ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+							role: "alert",
+							style: {
+								color: "var(--dsw-alias-danger, #c0392b)",
+								margin: "8px 0 0"
+							},
+							children: error
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							style: {
+								display: "flex",
+								justifyContent: "flex-end",
+								gap: 8,
+								marginTop: 14,
+								flexWrap: "wrap"
+							},
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									onClick: () => setOpen(false),
+									style: {
+										padding: "7px 12px",
+										borderRadius: 8
+									},
+									children: t("overlay.cancel")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									disabled: saving,
+									onClick: () => void save(false),
+									style: {
+										padding: "7px 12px",
+										borderRadius: 8
+									},
+									children: t("overlay.save")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									disabled: saving || sessionId === void 0,
+									onClick: () => void save(true),
+									style: {
+										padding: "7px 12px",
+										borderRadius: 8
+									},
+									children: t("overlay.saveClear")
+								})
+							]
+						})
+					]
+				})
+			});
+		}
+		// src/client/index.tsx
+		/**
+		* Browser half of the Quick Note example. React is provided by DSH at runtime.
+		*
+		* @module dsh-quicknote/client
+		*/
+		async function request(path, init) {
+			const response = await fetch(`${API}${path}`, {
+				headers: { "content-type": "application/json" },
+				...init
+			});
+			const data = await response.json();
+			if (!response.ok || !data.ok) throw new Error(data.error ?? `request-failed-${response.status}`);
+			return data;
+		}
+		function Icon({ size = 18 }) {
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+				viewBox: "0 0 16 16",
+				width: size,
+				height: size,
+				fill: "none",
+				"aria-hidden": "true",
+				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("rect", {
+					x: "2.75",
+					y: "2.75",
+					width: "10.5",
+					height: "10.5",
+					rx: "2",
+					stroke: "currentColor"
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+					d: "M5.5 8h5",
+					stroke: "currentColor",
+					strokeLinecap: "round"
+				})]
+			});
+		}
+		function Page({ t }) {
+			const [notes, setNotes] = (0, react.useState)([]);
+			const [text, setText] = (0, react.useState)("");
+			const [error, setError] = (0, react.useState)("");
+			const [undo, setUndo] = (0, react.useState)(null);
+			async function load() {
+				try {
+					const data = await request("/notes");
+					setNotes(data.notes);
+				} catch (cause) {
+					setError(String(cause.message));
+				}
+			}
+			(0, react.useEffect)(() => {
+				load();
+				const changed = () => void load();
+				window.addEventListener("dsh-quicknote:changed", changed);
+				return () => window.removeEventListener("dsh-quicknote:changed", changed);
+			}, []);
+			(0, react.useEffect)(() => {
+				if (!undo) return;
+				const timer = window.setTimeout(() => setUndo(null), 8e3);
+				return () => window.clearTimeout(timer);
+			}, [undo]);
+			async function add(event) {
+				event.preventDefault();
+				if (text.trim() === "") return;
+				try {
+					await request("/notes/create", {
+						method: "POST",
+						body: JSON.stringify({ text })
+					});
+					setText("");
+					setError("");
+					await load();
+				} catch (cause) {
+					setError(String(cause.message));
+				}
+			}
+			async function toggle(note) {
+				try {
+					await request("/notes/update", {
+						method: "POST",
+						body: JSON.stringify({
+							id: note.id,
+							done: !note.done
+						})
+					});
+					await load();
+				} catch (cause) {
+					setError(String(cause.message));
+				}
+			}
+			async function remove(note) {
+				try {
+					await request("/notes/delete", {
+						method: "POST",
+						body: JSON.stringify({ id: note.id })
+					});
+					await load();
+				} catch (cause) {
+					setError(String(cause.message));
+				}
+			}
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				style: {
+					padding: "24px 28px",
+					maxWidth: 760,
+					font: "inherit"
+				},
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
+						style: {
+							fontSize: 22,
+							margin: 0
+						},
+						children: t("panel.title")
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						style: {
+							margin: "6px 0 18px",
+							color: "var(--dsw-alias-label-secondary)"
+						},
+						children: t("panel.body")
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("form", {
+						onSubmit: add,
+						style: {
+							display: "flex",
+							gap: 8,
+							alignItems: "flex-start"
+						},
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("textarea", {
+							"data-testid": "note-input",
+							value: text,
+							onChange: (event) => setText(event.target.value),
+							placeholder: t("panel.placeholder"),
+							rows: 3,
+							style: {
+								flex: 1,
+								resize: "vertical",
+								padding: 10,
+								borderRadius: 8,
+								border: "1px solid var(--dsw-alias-line, #d9dce1)"
+							}
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+							"data-testid": "note-add",
+							type: "submit",
+							disabled: text.trim() === "",
+							style: {
+								padding: "9px 14px",
+								borderRadius: 8
+							},
+							children: t("panel.add")
+						})]
+					}),
+					error === "" ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						role: "alert",
+						style: { color: "var(--dsw-alias-danger, #c0392b)" },
+						children: error
+					}),
+					notes.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						style: {
+							marginTop: 24,
+							color: "var(--dsw-alias-label-secondary)"
+						},
+						children: t("panel.empty")
+					}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
+						style: {
+							listStyle: "none",
+							padding: 0,
+							margin: "24px 0 0",
+							display: "grid",
+							gap: 8
+						},
+						children: notes.map((note) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
+							"data-testid": "note-item",
+							style: {
+								display: "flex",
+								gap: 8,
+								alignItems: "center",
+								padding: 12,
+								border: "1px solid var(--dsw-alias-line, #d9dce1)",
+								borderRadius: 10
+							},
+							children: [
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+									style: {
+										flex: 1,
+										textDecoration: note.done ? "line-through" : "none",
+										opacity: note.done ? .6 : 1
+									},
+									children: note.text
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									onClick: () => void toggle(note),
+									style: {
+										padding: "5px 9px",
+										borderRadius: 7
+									},
+									children: note.done ? t("panel.reopen") : t("panel.done")
+								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									onClick: () => void remove(note),
+									style: {
+										padding: "5px 9px",
+										borderRadius: 7
+									},
+									children: t("panel.delete")
+								})
+							]
+						}, note.id))
+					})
+				]
+			});
+		}
+		const name = NAME;
+		const inject = ["slots", "locale"];
+		function apply(ctx) {
+			setClientContext(ctx);
+			ctx.effect(() => ctx.locale.register(NS, {
+				en: {
+					"panel.title": "Quick Note",
+					"panel.body": "Capture a note, mark it done, keep the list on one page.",
+					"panel.placeholder": "Write a note…",
+					"panel.add": "Add note",
+					"panel.empty": "No notes yet.",
+					"panel.done": "Done",
+					"panel.reopen": "Reopen",
+					"panel.delete": "Delete",
+					"panel.deleted": "Note deleted.",
+					"panel.completed": "Note updated.",
+					"panel.undo": "Undo",
+					"toolbar.capture": "Note",
+					"overlay.title": "Save a quick note",
+					"overlay.cancel": "Cancel",
+					"overlay.save": "Save note",
+					"overlay.saveClear": "Save and clear draft",
+					"overlay.empty": "Nothing to save."
+				},
+				zh: {
+					"panel.title": "随手记",
+					"panel.body": "记下一条笔记，标记完成，在一页里管理。",
+					"panel.placeholder": "写一条笔记…",
+					"panel.add": "添加",
+					"panel.empty": "还没有笔记。",
+					"panel.done": "完成",
+					"panel.reopen": "重新打开",
+					"panel.delete": "删除",
+					"panel.deleted": "笔记已删除。",
+					"panel.completed": "笔记已更新。",
+					"panel.undo": "撤销",
+					"toolbar.capture": "记一下",
+					"overlay.title": "保存随手记",
+					"overlay.cancel": "取消",
+					"overlay.save": "保存笔记",
+					"overlay.saveClear": "保存并清空输入框",
+					"overlay.empty": "没有可保存的内容。"
+				}
+			}), `${NAME}: dictionaries`);
+			ctx.slots.inject("sidebar.panellist", () => ctx.slots.register({
+				name: "sidebar.panellist",
+				id: NAME,
+				order: 60,
+				label: () => ctx.locale.bind(NS)("panel.title"),
+				locale: NS
+			}, Icon));
+			ctx.slots.inject("main", () => ctx.slots.register({
+				name: "main",
+				key: NAME,
+				locale: NS
+			}, Page));
+			ctx.slots.inject("conversation.input.left", () => ctx.slots.register({
+				name: "conversation.input.left",
+				id: "quicknote.toolbar",
+				order: 10,
+				locale: NS
+			}, ComposerButton));
+			ctx.slots.inject("shell.overlay", () => ctx.slots.register({
+				name: "shell.overlay",
+				id: "quicknote.overlay",
+				order: 40,
+				locale: NS
+			}, Overlay));
+		}
+		exports.apply = apply;
+		exports.inject = inject;
+		exports.name = name;
+		return module.exports;
+	}
+});

package/lib/index.js

@@ -0,0 +1,275 @@
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+// src/shared/constants.ts
+/** Package name; must equal package.json `name` (the client bundle id). */
+const NAME = "dsh-quicknote";
+/** Host JSON API used by the page. */
+const API = "/api/quicknote";
+// src/host/paths.ts
+/** Keep the example's data separate from other plugins. */
+function resolveNotesFile(ctx) {
+	try {
+		const dshHomePath = typeof ctx.get === "function" ? ctx.get("dshHomePath") : void 0;
+		if (typeof dshHomePath === "function") {
+			const dir = dshHomePath("quicknote");
+			if (typeof dir === "string" && dir !== "") return join(dir, "notes.json");
+		}
+	} catch {}
+	const home = (process.env.DSH_HOME ?? "").trim() || join(homedir(), ".dsh");
+	return join(home, "quicknote", "notes.json");
+}
+// src/host/routes.ts
+var HttpError = class extends Error {
+	status;
+	constructor(status, message) {
+		super(message);
+		this.status = status;
+	}
+};
+function json(status, body) {
+	return new Response(`${JSON.stringify(body)}\n`, {
+		status,
+		headers: {
+			"content-type": "application/json; charset=utf-8",
+			"cache-control": "no-store"
+		}
+	});
+}
+async function body(request) {
+	try {
+		const value = await request.json();
+		return value && typeof value === "object" ? value : {};
+	} catch {
+		throw new HttpError(400, "invalid-json");
+	}
+}
+function registerRoutes(ctx, store) {
+	ctx.inject(["connection"], (scope) => {
+		const registry = scope.get("connection")?.fetch;
+		if (typeof registry?.register !== "function") {
+			ctx.logger?.warn?.("dsh-quicknote: no fetch registry; the page will not load notes");
+			return;
+		}
+		const wrap = (handler) => async (request) => {
+			try {
+				return await handler(request);
+			} catch (error) {
+				return json(error instanceof HttpError ? error.status : 500, {
+					ok: false,
+					error: error instanceof HttpError ? error.message : String(error?.message ?? error)
+				});
+			}
+		};
+		const routes = [
+			{
+				path: `${API}/notes`,
+				methods: ["GET"],
+				fetch: wrap(async () => json(200, {
+					ok: true,
+					notes: await store.list()
+				}))
+			},
+			{
+				path: `${API}/notes/create`,
+				methods: ["POST"],
+				fetch: wrap(async (request) => json(200, {
+					ok: true,
+					note: await store.add((await body(request)).text)
+				}))
+			},
+			{
+				path: `${API}/notes/update`,
+				methods: ["POST"],
+				fetch: wrap(async (request) => {
+					const input = await body(request);
+					const note = await store.update(input.id, input.done === true);
+					return note ? json(200, {
+						ok: true,
+						note
+					}) : json(404, {
+						ok: false,
+						error: "unknown-note"
+					});
+				})
+			},
+			{
+				path: `${API}/notes/delete`,
+				methods: ["POST"],
+				fetch: wrap(async (request) => json(200, {
+					ok: true,
+					removed: await store.remove((await body(request)).id)
+				}))
+			}
+		];
+		for (const route of routes) scope.effect(() => registry.register({
+			path: route.path,
+			methods: route.methods,
+			requestBody: "buffered",
+			fetch: route.fetch
+		}), `dsh-quicknote: ${route.path}`);
+	});
+}
+// src/host/store.ts
+const MAX_TEXT = 2e4;
+/** A small durable store: one JSON file, atomic whole-file writes, newest first. */
+function createStore(file) {
+	let cache = null;
+	async function load() {
+		if (cache) return cache;
+		try {
+			const parsed = JSON.parse(await readFile(file, "utf8"));
+			cache = Array.isArray(parsed.notes) ? parsed.notes.filter((note) => typeof note === "object" && note !== null && typeof note.id === "string" && typeof note.text === "string" && note.text.trim() !== "") : [];
+		} catch {
+			cache = [];
+		}
+		return cache;
+	}
+	async function save(notes) {
+		await mkdir(dirname(file), { recursive: true });
+		const temporary = `${file}.${process.pid}.tmp`;
+		await writeFile(temporary, `${JSON.stringify({ notes }, null, 2)}\n`, { mode: 384 });
+		await rename(temporary, file);
+		cache = notes;
+	}
+	return {
+		file,
+		async list() {
+			return [...await load()];
+		},
+		async add(text) {
+			const value = String(text ?? "").trim();
+			if (value === "") throw new Error("empty-note");
+			if (value.length > MAX_TEXT) throw new Error("note-too-long");
+			const note = {
+				id: randomUUID(),
+				text: value,
+				done: false,
+				createdAt: Date.now()
+			};
+			await save([note, ...await load()]);
+			return note;
+		},
+		async update(id, done) {
+			const notes = await load();
+			const current = notes.find((note) => note.id === id);
+			if (!current) return null;
+			const updated = {
+				...current,
+				done
+			};
+			await save(notes.map((note) => note.id === id ? updated : note));
+			return updated;
+		},
+		async remove(id) {
+			const notes = await load();
+			const next = notes.filter((note) => note.id !== id);
+			if (next.length === notes.length) return false;
+			await save(next);
+			return true;
+		}
+	};
+}
+// src/host/tools.ts
+function textOutput() {
+	return {
+		schema: { type: "string" },
+		render: (_args, value) => [{
+			type: "text",
+			text: String(value)
+		}]
+	};
+}
+function describe(note) {
+	const text = note.text.length > 200 ? `${note.text.slice(0, 200)}…` : note.text;
+	return `- ${note.id} (${note.done ? "done" : "open"}): ${text}`;
+}
+function createTools(store) {
+	return [
+		{
+			name: "quicknote_add",
+			description: "Save one note in the user's Quick Note list. Use it when the user asks to remember or park something for later.",
+			parameters: {
+				type: "object",
+				additionalProperties: false,
+				required: ["text"],
+				properties: { text: {
+					type: "string",
+					description: "The note body."
+				} }
+			},
+			output: textOutput(),
+			async execute(args) {
+				const note = await store.add(args?.text);
+				return `Saved as ${note.id}.\n${describe(note)}`;
+			}
+		},
+		{
+			name: "quicknote_list",
+			description: "List notes in the user's Quick Note list, newest first.",
+			parameters: {
+				type: "object",
+				additionalProperties: false,
+				properties: {}
+			},
+			output: textOutput(),
+			async execute() {
+				const notes = await store.list();
+				return notes.length === 0 ? "The Quick Note list is empty." : `${notes.length} note${notes.length === 1 ? "" : "s"}:\n${notes.map(describe).join("\n")}`;
+			}
+		},
+		{
+			name: "quicknote_done",
+			description: "Mark one Quick Note as done, or reopen it with done=false.",
+			parameters: {
+				type: "object",
+				additionalProperties: false,
+				required: ["id"],
+				properties: {
+					id: { type: "string" },
+					done: { type: "boolean" }
+				}
+			},
+			output: textOutput(),
+			async execute(args) {
+				const note = await store.update(args?.id, args?.done === false ? false : true);
+				return note ? `Note ${note.id} is ${note.done ? "done" : "open"}.` : `No note with id "${args?.id}".`;
+			}
+		},
+		{
+			name: "quicknote_delete",
+			description: "Delete one Quick Note permanently. Only when the user explicitly asks.",
+			parameters: {
+				type: "object",
+				additionalProperties: false,
+				required: ["id"],
+				properties: { id: { type: "string" } }
+			},
+			output: textOutput(),
+			async execute(args) {
+				return await store.remove(args?.id) ? `Deleted ${args?.id}.` : `No note with id "${args?.id}".`;
+			}
+		}
+	];
+}
+// src/host/index.ts
+/**
+* Host half of the Quick Note example: one JSON file, four routes, four tools.
+*
+* @module dsh-quicknote/host
+*/
+const name = NAME;
+function apply(ctx) {
+	const store = createStore(resolveNotesFile(ctx));
+	ctx.effect(() => {
+		store.list().catch((error) => {
+			ctx.logger?.warn?.(`${NAME}: could not read notes: ${String(error)}`);
+		});
+	}, `${NAME}: warm the note store`);
+	registerRoutes(ctx, store);
+	ctx.inject(["tools"], (scope) => {
+		for (const definition of createTools(store)) scope.effect(() => scope.tools.register(definition), `${NAME}: tool ${definition.name}`);
+	});
+}
+export { apply, createStore, name, resolveNotesFile };

package/llms.txt

@@ -0,0 +1,30 @@
+# dsh-quicknote
+
+> Capture a note from the DSH composer, keep it out of the way, and manage the list on one page.
+
+## Install
+
+    dsh plugin --profile <profile> add dsh-quicknote
+
+## Verify
+
+    dsh --profile <profile> --dump-config | grep -A2 "id: dsh-quicknote"
+
+## Develop
+
+    pnpm install
+    pnpm verify
+
+## Read next
+
+- README.md — user guide
+- AGENTS.md — repository rules and invariants
+- src/host/ — Host half
+- src/client/ — browser half
+- tests/ — both suites
+
+## Contracts
+
+- Package: dsh-quicknote
+- Patch row: `dsh-quicknote`
+- Client module id: `dsh-quicknote`

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Quick Note (dsh-quicknote)",
+    "description": "Capture a note, mark it done, keep the list on one page."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "随手记 (dsh-quicknote)",
+    "description": "记下一条笔记，标记完成，在一页里管理。"
+  }
+}

package/package.json

@@ -1,6 +1,78 @@
 {
   "name": "dsh-quicknote",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Capture a note from the DSH composer, keep it out of the way, and manage the list on one page.",
+  "license": "MIT",
+  "author": "dsh-kit contributors",
+  "type": "module",
+  "icon": "./icon.svg",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/",
+    "cordis.patch.yml",
+    "icon.svg",
+    "locale/*.json",
+    "README.md",
+    "README.zh.md",
+    "AGENTS.md",
+    "llms.txt",
+    "LICENSE",
+    "CHANGELOG.md",
+    "PUBLISHING.md"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint src tests scripts",
+    "format": "oxfmt --check src tests scripts",
+    "format:write": "oxfmt src tests scripts",
+    "test": "vitest run",
+    "verify": "oxfmt --check src tests scripts && oxlint src tests scripts && tsc --noEmit && vitest run && tsdown && node scripts/check.mjs && npm pack --dry-run",
+    "prepack": "tsdown"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    },
+    "engines": {
+      "dsh": ">=0.2.1-rc.5"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.6",
+    "@types/react": "^19.3.0",
+    "jsdom": "^30.1.3",
+    "oxfmt": "^0.75.0",
+    "oxlint": "^1.90.0",
+    "react": "^19.3.1",
+    "tsdown": "^0.23.4",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "quicknote",
+    "notes"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dsh-kit/dsh-quicknote.git"
+  },
+  "homepage": "https://github.com/dsh-kit/dsh-quicknote",
+  "bugs": {
+    "url": "https://github.com/dsh-kit/dsh-quicknote/issues"
+  }
+}