dsh-prompt-star 0.1.0 → 0.1.3

package/lib/client.js

@@ -4,20 +4,26 @@ window.__ModuleLoader__.load({
 		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");
-		//#region src/client/StarButton.tsx
+		let react = require("react");
+		//#region lib/types/client/StarButton.js
 		/**
-		* The ⭐ button rendered beside the conversation input. On click it reads the
-		* current draft (from the session input snapshot), asks the host to generate a
-		* fuller prompt, and writes it back with `inputActions.setDraft` — the user
-		* presses Ctrl/Cmd+Z if they want the original draft back.
+		* The ⭐ button rendered beside the conversation input.
+		*
+		* On click it reads the current draft (session input snapshot), asks the host
+		* (over the `/dsh-prompt-star` Connection RPC channel) to read a few project
+		* doc files as context, assembles a fuller, more efficient prompt on the client,
+		* then writes it back with `inputActions.setDraft`. Press Ctrl/Cmd+Z to restore
+		* the original draft.
 		*
 		* The slot framework composes this component's props: the session standard seat
-		* (`useInput`, `inputActions`, `useConversation`) plus the register-time
-		* `generate` face the client plugin injects. The interface below is the minimal
-		* structural shape this component needs; it matches the composed slot props.
+		* (`useInput`, `inputActions`) plus the register-time `context` face this client
+		* plugin injects. The interfaces below are the minimal structural shapes this
+		* component needs; they match the composed slot props without importing the
+		* harness client types.
 		*/
+		/** Common project-doc filenames are probed on the HOST; the client never
+		*  enumerates them (it just asks the host for the read context). */
 		const buttonStyle = {
 			all: "unset",
 			display: "inline-flex",
@@ -32,7 +38,25 @@ window.__ModuleLoader__.load({
 			opacity: .9,
 			userSelect: "none"
 		};
-		function StarButton({ generate, useInput, inputActions, useActiveRoot }) {
+		/** Build a fuller, structured prompt from the draft + any project context. */
+		function assemblePrompt(draft, context) {
+			return [
+				"请把下面的【我的草稿】整理成一段完整、清晰、高效的提示词，直接输出整理后的提示词本身。",
+				"",
+				"整理要求：",
+				"1. 明确任务目标、所需上下文、约束条件与期望输出形式。",
+				"2. 若【项目文档】提供了相关规范、术语或背景，请吸收进去，使提示词更贴合项目。",
+				"3. 语气中立专业，结构清晰（可用编号、小节或列表），忠于草稿原意，不虚构。",
+				"4. 长度以覆盖草稿要点为准，不要过度扩写。",
+				"",
+				"# 项目文档",
+				context.docs.length === 0 ? "（未读取到项目文档）" : context.docs.map((doc) => `## ${doc.name}\n${doc.text}`).join("\n\n"),
+				"",
+				"# 我的草稿",
+				draft
+			].join("\n");
+		}
+		function StarButton({ context, useInput, inputActions }) {
 			const input = useInput();
 			const [busy, setBusy] = (0, react.useState)(false);
 			const [error, setError] = (0, react.useState)(void 0);
@@ -45,49 +69,82 @@ window.__ModuleLoader__.load({
 				setBusy(true);
 				setError(void 0);
 				try {
-					const result = await generate({
-						draft,
-						workspaceRoot: useActiveRoot?.(),
-						intent: void 0
-					});
-					if (result.prompt && result.prompt !== draft) {
-						inputActions.setDraft(result.prompt);
-						if (result.degraded) setError("模型调用失败，已保留原草稿");
-					} else setError(result.degraded ? "模型调用失败，未生成新内容" : "生成结果与原草稿相同，未替换");
+					const res = await context();
+					if (!res.ok) {
+						setError(`读取项目文档失败: ${res.error?.message ?? "未知错误"}`);
+						return;
+					}
+					const value = res.value;
+					const full = assemblePrompt(draft, value);
+					if (full && full !== draft) {
+						inputActions.setDraft(full);
+						setError(value.docs.length === 0 ? "已按草稿整理（未读取到项目文档）" : `已整理并读取 ${value.docs.length} 个项目文档`);
+					} else setError("未生成新内容");
 				} catch (cause) {
-					const message = cause instanceof Error ? cause.message : String(cause);
-					setError(`生成失败: ${message}`);
+					setError(`生成失败: ${cause instanceof Error ? cause.message : String(cause)}`);
 				} finally {
 					setBusy(false);
 				}
 			}
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+			return (0, react_jsx_runtime.jsx)("button", {
 				type: "button",
 				style: buttonStyle,
-				title: error ?? "prompt-star: 生成更完整的提示词",
+				title: error ?? "prompt-star: 整理成更完整的提示词",
 				disabled: busy,
 				onClick,
 				children: busy ? "…" : "⭐"
 			});
 		}
 		//#endregion
-		//#region src/client/index.ts
-		/** Cordis services this client plugin needs. */
-		const inject = ["slots", "remote"];
+		//#region lib/types/types.js
+		/**
+		* dsh-prompt-star — host↔client RPC protocol (shared vocabulary).
+		*
+		* Transport: the generic Connection RPC channel `/dsh-prompt-star`
+		* (the host registers it with `ctx.connection.rpc.handle`, the browser calls
+		* `ctx.connection.rpc.call('/dsh-prompt-star', endpoint, payload)`).
+		*
+		* The host sells exactly one capability: reading a few project documentation
+		* files for the current workspace (it CAN read file contents natively; the
+		* browser client cannot). Everything else — assembling the fuller prompt from
+		* the draft + that context — stays on the client.
+		*/
+		/** Absolute logical Connection RPC channel owned by this plugin. */
+		const RPC_CHANNEL = "/dsh-prompt-star";
+		/** Channel-relative endpoint that reads project doc files on the host. */
+		const EP_CONTEXT = "context";
+		//#endregion
+		//#region lib/types/client/index.js
+		/**
+		* Client plugin: mounts the ⭐ button into the composer input tool row
+		* (`conversation.input.right`, a session-scoped list slot) and wires it to the
+		* host's `/dsh-prompt-star` Connection RPC channel.
+		*
+		* This client half only needs the slot registry and the `connection` service.
+		* On click the button asks the host for project doc context (the browser cannot
+		* read file contents itself), then assembles the fuller prompt on the client and
+		* writes it back with `inputActions.setDraft`.
+		*/
+		/** Cordis services this client plugin needs: the slot registry and the
+		*  Connection service (both provided by the stock web-app composition). */
+		const inject = ["slots", "connection"];
 		/**
 		* Client plugin body: register the ⭐ button once the slot registry and the
-		* remote face are up.
+		* Connection service are up.
 		* @param ctx - client root context.
 		*/
 		function apply(ctx) {
-			ctx.inject(["slots", "remote"], (scope) => {
-				const promptStar = scope.remote.promptStar;
-				scope.slots.inject("conversation.input.right", () => scope.slots.register({
-					name: "conversation.input.right",
-					id: "prompt-star",
-					order: 0,
-					inject: () => ({ generate: promptStar.generate })
-				}, StarButton));
+			ctx.inject(["slots", "connection"], (scope) => {
+				const root = scope;
+				const rpc = root.connection.rpc;
+				root.slots.inject("conversation.input.right", () => {
+					root.slots.register({
+						name: "conversation.input.right",
+						id: "prompt-star",
+						order: 0,
+						inject: () => ({ context: () => rpc.call(RPC_CHANNEL, EP_CONTEXT, {}) })
+					}, StarButton);
+				});
 			});
 		}
 		//#endregion

package/lib/index.js

@@ -1,283 +1,99 @@
-import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
-import { readFile } from "node:fs/promises";
-import { isAbsolute, join } from "node:path";
-import { BlockAssembler, createUserMessage } from "@deepseek-ai/dsh-llm";
-import { deadline } from "@deepseek-ai/dsh-timeout";
-import { deepFreeze } from "@deepseek-ai/dsh-util-values";
-//#region \0@oxc-project+runtime@0.148.0/helpers/esm/usingCtx.js
-function _usingCtx() {
-	var r = "function" == typeof SuppressedError ? SuppressedError : function(r, e) {
-		var n = Error();
-		return n.name = "SuppressedError", n.error = r, n.suppressed = e, n;
-	}, e = {}, n = [];
-	function using(r, e) {
-		if (null != e) {
-			if (Object(e) !== e) throw new TypeError("using declarations can only be used with objects, functions, null, or undefined.");
-			if (r) var o = e[Symbol.asyncDispose || Symbol["for"]("Symbol.asyncDispose")];
-			if (void 0 === o && (o = e[Symbol.dispose || Symbol["for"]("Symbol.dispose")], r)) var t = o;
-			if ("function" != typeof o) throw new TypeError("Object is not disposable.");
-			t && (o = function o() {
-				try {
-					t.call(e);
-				} catch (r) {
-					return Promise.reject(r);
-				}
-			}), n.push({
-				v: e,
-				d: o,
-				a: r
-			});
-		} else r && n.push({
-			d: e,
-			a: r
-		});
-		return e;
-	}
-	return {
-		e,
-		u: using.bind(null, !1),
-		a: using.bind(null, !0),
-		d: function d() {
-			var o, t = this.e, s = 0;
-			function next() {
-				for (; o = n.pop();) try {
-					if (!o.a && 1 === s) return s = 0, n.push(o), Promise.resolve().then(next);
-					if (o.d) {
-						var r = o.d.call(o.v);
-						if (o.a) return s |= 2, Promise.resolve(r).then(next, err);
-					} else s |= 1;
-				} catch (r) {
-					return err(r);
-				}
-				if (1 === s) return t !== e ? Promise.reject(t) : Promise.resolve();
-				if (t !== e) throw t;
-			}
-			function err(n) {
-				return t = t !== e ? new r(n, t) : n, next();
-			}
-			return next();
-		}
-	};
-}
+//#region lib/types/types.js
+/**
+* dsh-prompt-star — host↔client RPC protocol (shared vocabulary).
+*
+* Transport: the generic Connection RPC channel `/dsh-prompt-star`
+* (the host registers it with `ctx.connection.rpc.handle`, the browser calls
+* `ctx.connection.rpc.call('/dsh-prompt-star', endpoint, payload)`).
+*
+* The host sells exactly one capability: reading a few project documentation
+* files for the current workspace (it CAN read file contents natively; the
+* browser client cannot). Everything else — assembling the fuller prompt from
+* the draft + that context — stays on the client.
+*/
+/** Absolute logical Connection RPC channel owned by this plugin. */
+const RPC_CHANNEL = "/dsh-prompt-star";
 //#endregion
-//#region src/host/generate.ts
+//#region lib/types/index.js
 /**
-* Host implementation of one prompt-star generate: probe the project's doc
-* files for context, then call the configured default LLM to turn the draft +
-* context into a fuller prompt. Returns a best-effort result (never throws) so
-* a model failure degrades to a copy rather than failing the click.
+* Host entry for dsh-prompt-star.
+*
+* The ⭐ button lives in the client half; this host half registers ONE generic
+* Connection RPC channel (`/dsh-prompt-star`) that reads a few project
+* documentation files for the current workspace. The browser client CANNOT read
+* file contents (the stock web app exposes no content-reading remote), so the
+* read happens here and is shipped to the browser over the Connection channel.
+*
+* This entry follows the standard DSH plugin export contract `apply(ctx)`.
+*
+* The host-side services (`ctx.connection.rpc`, `ctx.fs`) are consumed through
+* small local structural types instead of importing the harness packages, so the
+* plugin's `tsc` stays inside its own `rootDir` and never drags harness source
+* files into its program.
 */
-/** Doc files we probe (first match by priority wins as main context; all read). */
-const DOC_FILE_NAMES = [
-	"CLAUDE.md",
+/** Project doc files probed, in priority order. Reads are best-effort. */
+const DOC_CANDIDATES = [
+	"README.md",
+	"README",
 	"AGENTS.md",
-	".cursorrules",
-	"README.md"
+	"CLAUDE.md",
+	"CONTRIBUTING.md",
+	"docs/README.md",
+	"docs/index.md",
+	".cursorrules"
 ];
-/** Per-file read cap; keeps a huge README from eating the model input budget. */
-const MAX_DOC_BYTES = 8e3;
-/** Output-token cap for the generated prompt. */
-const MAX_OUTPUT_TOKENS = 1200;
-/** End-to-end generate deadline. */
-const TIMEOUT_MS = 2e4;
-/** Timeout code registered for the capability. */
-const PROMPT_STAR_TIMEOUT_CODE = "PROMPT_STAR_TIMEOUT";
+/** Per-doc content cap so a huge README cannot flood the input. */
+const MAX_DOC_CHARS = 4e3;
 /**
-* Model-visible purpose. `dsh-llm` types this as the union
-* `'compaction' | 'session-title'`; this plugin's own purpose requires a
-* one-line addition to that union (see README "Patch dsh-llm"). The cast keeps
-* this package compiling before the patch lands.
+* Minimal host plugin body: mount the `/dsh-prompt-star` RPC channel.
+* @param ctx - host root context.
 */
-const PURPOSE = "prompt-star";
-/** Inline template skeletons the model reuses as a shape, not a strict form. */
-const SKELETONS = [
-	{
-		id: "request",
-		title: "提需求",
-		hint: "目标 / 用户 / 验收标准 / 边界 / 依赖"
-	},
-	{
-		id: "bug",
-		title: "改 bug",
-		hint: "现象 / 复现步骤 / 期望 vs 实际 / 触发条件 / 环境"
-	},
-	{
-		id: "letter",
-		title: "写信",
-		hint: "称呼 / 目的 / 语气 / 落款"
-	},
-	{
-		id: "generic",
-		title: "通用",
-		hint: "目标 / 输入 / 期望输出 / 约束"
-	}
-];
-/** Default workspace root used when the caller cannot supply one. */
-function defaultRoot(ctx) {
-	return process.cwd();
-}
-/** Cap a path at the workspace root (defence-in-depth: refuses abs paths outside root). */
-function keepInside(root, path) {
-	if (isAbsolute(path)) return path.startsWith(root) ? path : void 0;
-	return join(root, path);
-}
-/** Probe the doc files, reading the first `MAX_DOC_BYTES` bytes of each hit. */
-async function readDocFiles(root) {
-	const sources = [];
-	for (const name of DOC_FILE_NAMES) {
-		const path = keepInside(root, name);
-		if (path === void 0) continue;
-		try {
-			const buf = await readFile(path);
-			sources.push({
-				path,
-				name,
-				read: true,
-				bytes: Math.min(buf.byteLength, MAX_DOC_BYTES)
-			});
-		} catch {
-			sources.push({
-				path,
-				name,
-				read: false,
-				bytes: 0
-			});
-		}
-	}
-	return sources;
-}
-/** Frame the doc context into the system prompt (references, not whole files). */
-function frameContext(sources) {
-	const hits = sources.filter((source) => source.read);
-	if (hits.length === 0) return "当前项目没有可读的说明文件（未找到 CLAUDE.md / AGENTS.md / .cursorrules / README.md）。";
-	return hits.map((source) => `--- ${source.name} (${source.bytes} 字节) ---\n<probe-only: use this file as project context>`).join("\n");
-}
-/** Compose the system instruction that turns a draft into a fuller prompt. */
-function buildSystem(sources) {
-	return [
-		"你是提示词优化器。用户会给一段随手写的草稿，你把它扩写成一版更完整、更省 token、意图清晰的提示词。",
-		"阅读下面用到的项目说明文件（若有）作为上下文，不要照抄，只借用其术语、技术栈与约定。",
-		"可参考的模板骨架（选择与该草稿最贴切的一个作为形状，按需补充）：",
-		SKELETONS.map((skeleton) => `- ${skeleton.title}（${skeleton.id}）：${skeleton.hint}`).join("\n"),
-		"输出要求：",
-		"- 只输出优化后的提示词正文，不要解释、不要 Markdown 包裹、不要前缀。",
-		"- 保留用户草稿的原意，补全缺失的上下文与验收标准。",
-		"- 用草稿同语言输出。",
-		"",
-		frameContext(sources)
-	].join("\n");
-}
-/** Map the LLM finish reason to an error, mirroring session-title-llm. */
-function finishError(finish) {
-	switch (finish.kind) {
-		case "stop": return;
-		case "error":
-		case "aborted": {
-			const error = new Error(finish.failure.message);
-			error.code = finish.failure.code;
-			return error;
-		}
-		case "max-tokens": return /* @__PURE__ */ new Error("prompt-star: output reached maxTokens");
-		case "tool-calls": return /* @__PURE__ */ new Error("prompt-star: model unexpectedly requested a tool");
-		default: return /* @__PURE__ */ new Error(`prompt-star: unsupported finish reason "${String(finish.kind)}"`);
-	}
-}
-/** Read the plain text of one assembled LLM reply. */
-function blocksToText(blocks) {
-	return blocks.filter((block) => block.type === "text").map((block) => block.text).join(" ");
-}
-/**
-* Generate the optimized prompt.
-* @param ctx - Host context carrying the `llm` service.
-* @param request - draft + optional workspace root / intent.
-* @returns a settled result; degraded=true when the model call failed.
-*/
-async function generatePrompt(ctx, request) {
-	const sources = await readDocFiles(request.workspaceRoot ?? defaultRoot(ctx));
-	const system = buildSystem(sources);
-	const userText = request.intent?.trim() ? `草稿：\n${request.draft}\n\n请侧重「${request.intent}」模板。` : `草稿：\n${request.draft}`;
-	try {
+function apply(ctx) {
+	const host = ctx;
+	host.connection.rpc.handle(RPC_CHANNEL, async (endpoint, payload) => {
+		if (endpoint !== "context") return {
+			ok: false,
+			error: {
+				code: "unknown_endpoint",
+				message: `unknown endpoint '${endpoint}'`,
+				details: {}
+			}
+		};
 		try {
-			var _usingCtx$1 = _usingCtx();
-			const messages = [createUserMessage({
-				content: [{
-					type: "text",
-					text: userText
-				}],
-				source: {
-					kind: "plugin",
-					plugin: "dsh-prompt-star"
+			const root = (payload ?? {}).cwd?.trim() || process.cwd();
+			const docs = [];
+			const seen = /* @__PURE__ */ new Set();
+			let filesRead = 0;
+			for (const name of DOC_CANDIDATES) try {
+				const target = host.fs.resolve(name, { cwd: root });
+				const trimmed = (await host.fs.readText(target))?.trim();
+				if (trimmed && !seen.has(name)) {
+					seen.add(name);
+					docs.push({
+						name,
+						text: trimmed.slice(0, MAX_DOC_CHARS)
+					});
+					filesRead += 1;
 				}
-			})];
-			const callDeadline = _usingCtx$1.u(deadline(request.signal ?? new AbortController().signal, TIMEOUT_MS, PROMPT_STAR_TIMEOUT_CODE));
-			const options = deepFreeze({
-				provider: void 0,
-				model: void 0,
-				messages,
-				system,
-				maxTokens: MAX_OUTPUT_TOKENS,
-				purpose: PURPOSE,
-				signal: callDeadline.signal
-			});
-			callDeadline.signal.throwIfAborted();
-			const assembler = new BlockAssembler();
-			for await (const chunk of ctx.llm.stream(options)) {
-				callDeadline.signal.throwIfAborted();
-				assembler.push(chunk);
-			}
-			callDeadline.signal.throwIfAborted();
-			const terminalError = finishError(assembler.finish);
-			if (terminalError !== void 0) throw terminalError;
-			const blocks = assembler.blocks();
-			if (blocks.some((block) => block.type === "tool-call")) throw new Error("prompt-star: output must contain text only");
-			const prompt = blocksToText(blocks).trim();
-			if (prompt.length === 0) throw new Error("prompt-star: model produced no text");
+			} catch {}
+			return {
+				ok: true,
+				value: {
+					docs,
+					filesRead
+				}
+			};
+		} catch (err) {
 			return {
-				prompt,
-				intent: request.intent ?? inferIntent(prompt, system),
-				sources,
-				model: void 0,
-				degraded: false
+				ok: false,
+				error: {
+					code: "internal",
+					message: err instanceof Error ? err.message : String(err),
+					details: {}
+				}
 			};
-		} catch (_) {
-			_usingCtx$1.e = _;
-		} finally {
-			_usingCtx$1.d();
 		}
-	} catch (error) {
-		return {
-			prompt: request.draft,
-			intent: request.intent ?? "generic",
-			sources,
-			model: void 0,
-			degraded: true
-		};
-	}
+	});
 }
-/** Cheap intent label: prefer the supplied one, else the first skeleton hit. */
-function inferIntent(prompt, _system) {
-	prompt.toLowerCase();
-	return SKELETONS.find((skeleton) => skeleton.id === "request" || skeleton.id === "bug" || skeleton.id === "letter")?.id ?? "generic";
-}
-//#endregion
-//#region src/index.ts
-/** Host service backing the generated `ctx.remote.promptStar` namespace. */
-var PromptStarService = class extends TypertRemoteService {
-	static inject = ["typert"];
-	ctx;
-	/** @param ctx - Host context exposing the LLM and workspace services. */
-	constructor(ctx) {
-		super(ctx, "promptStar", { namespace: "promptStar" });
-		this.ctx = ctx;
-	}
-	/**
-	* Turn a draft + project context into a fuller prompt.
-	* @param request - draft and optional workspace root / intent / signal.
-	* @returns generated prompt and the doc files probed for context.
-	*/
-	@Remote("generate") async generate(request) {
-		return generatePrompt(this.ctx, request);
-	}
-};
 //#endregion
-export { PromptStarService, PromptStarService as default };
+export { apply };

package/lib/types/client/StarButton.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The ⭐ button rendered beside the conversation input.
+ *
+ * On click it reads the current draft (session input snapshot), asks the host
+ * (over the `/dsh-prompt-star` Connection RPC channel) to read a few project
+ * doc files as context, assembles a fuller, more efficient prompt on the client,
+ * then writes it back with `inputActions.setDraft`. Press Ctrl/Cmd+Z to restore
+ * the original draft.
+ *
+ * The slot framework composes this component's props: the session standard seat
+ * (`useInput`, `inputActions`) plus the register-time `context` face this client
+ * plugin injects. The interfaces below are the minimal structural shapes this
+ * component needs; they match the composed slot props without importing the
+ * harness client types.
+ */
+import { type ReactElement } from 'react';
+import type { ContextRpcResult } from '../types';
+export interface StarButtonProps {
+    /** Host RPC caller that returns the project doc context. */
+    context(): Promise<ContextRpcResult>;
+    /** Session input snapshot hook (returns the current draft). */
+    useInput(): {
+        draft: string;
+    };
+    /** Session public input actions (write the whole draft). */
+    inputActions: {
+        setDraft(text: string): void;
+    };
+}
+export declare function StarButton({ context, useInput, inputActions }: StarButtonProps): ReactElement;
+//# sourceMappingURL=StarButton.d.ts.map

package/lib/types/client/StarButton.js

@@ -0,0 +1,95 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The ⭐ button rendered beside the conversation input.
+ *
+ * On click it reads the current draft (session input snapshot), asks the host
+ * (over the `/dsh-prompt-star` Connection RPC channel) to read a few project
+ * doc files as context, assembles a fuller, more efficient prompt on the client,
+ * then writes it back with `inputActions.setDraft`. Press Ctrl/Cmd+Z to restore
+ * the original draft.
+ *
+ * The slot framework composes this component's props: the session standard seat
+ * (`useInput`, `inputActions`) plus the register-time `context` face this client
+ * plugin injects. The interfaces below are the minimal structural shapes this
+ * component needs; they match the composed slot props without importing the
+ * harness client types.
+ */
+import { useState } from 'react';
+/** Common project-doc filenames are probed on the HOST; the client never
+ *  enumerates them (it just asks the host for the read context). */
+const buttonStyle = {
+    all: 'unset',
+    display: 'inline-flex',
+    alignItems: 'center',
+    justifyContent: 'center',
+    width: '30px',
+    height: '30px',
+    cursor: 'pointer',
+    borderRadius: '6px',
+    fontSize: '16px',
+    lineHeight: 1,
+    opacity: 0.9,
+    userSelect: 'none',
+};
+/** Build a fuller, structured prompt from the draft + any project context. */
+function assemblePrompt(draft, context) {
+    const projectContext = context.docs.length === 0
+        ? '（未读取到项目文档）'
+        : context.docs.map((doc) => `## ${doc.name}\n${doc.text}`).join('\n\n');
+    return [
+        '请把下面的【我的草稿】整理成一段完整、清晰、高效的提示词，直接输出整理后的提示词本身。',
+        '',
+        '整理要求：',
+        '1. 明确任务目标、所需上下文、约束条件与期望输出形式。',
+        '2. 若【项目文档】提供了相关规范、术语或背景，请吸收进去，使提示词更贴合项目。',
+        '3. 语气中立专业，结构清晰（可用编号、小节或列表），忠于草稿原意，不虚构。',
+        '4. 长度以覆盖草稿要点为准，不要过度扩写。',
+        '',
+        '# 项目文档',
+        projectContext,
+        '',
+        '# 我的草稿',
+        draft,
+    ].join('\n');
+}
+export function StarButton({ context, useInput, inputActions }) {
+    const input = useInput();
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(undefined);
+    async function onClick() {
+        const draft = input.draft.trim();
+        if (draft.length === 0) {
+            setError('草稿为空，先写点什么再点 ⭐');
+            return;
+        }
+        setBusy(true);
+        setError(undefined);
+        try {
+            const res = await context();
+            if (!res.ok) {
+                setError(`读取项目文档失败: ${res.error?.message ?? '未知错误'}`);
+                return;
+            }
+            const value = res.value;
+            const full = assemblePrompt(draft, value);
+            if (full && full !== draft) {
+                inputActions.setDraft(full);
+                setError(value.docs.length === 0
+                    ? '已按草稿整理（未读取到项目文档）'
+                    : `已整理并读取 ${value.docs.length} 个项目文档`);
+            }
+            else {
+                setError('未生成新内容');
+            }
+        }
+        catch (cause) {
+            const message = cause instanceof Error ? cause.message : String(cause);
+            setError(`生成失败: ${message}`);
+        }
+        finally {
+            setBusy(false);
+        }
+    }
+    return (_jsx("button", { type: "button", style: buttonStyle, title: error ?? 'prompt-star: 整理成更完整的提示词', disabled: busy, onClick: onClick, children: busy ? '…' : '⭐' }));
+}
+//# sourceMappingURL=StarButton.js.map

package/lib/types/client/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Client plugin: mounts the ⭐ button into the composer input tool row
+ * (`conversation.input.right`, a session-scoped list slot) and wires it to the
+ * host's `/dsh-prompt-star` Connection RPC channel.
+ *
+ * This client half only needs the slot registry and the `connection` service.
+ * On click the button asks the host for project doc context (the browser cannot
+ * read file contents itself), then assembles the fuller prompt on the client and
+ * writes it back with `inputActions.setDraft`.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis services this client plugin needs: the slot registry and the
+ *  Connection service (both provided by the stock web-app composition). */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the ⭐ button once the slot registry and the
+ * Connection service are up.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.js

@@ -0,0 +1,37 @@
+/**
+ * Client plugin: mounts the ⭐ button into the composer input tool row
+ * (`conversation.input.right`, a session-scoped list slot) and wires it to the
+ * host's `/dsh-prompt-star` Connection RPC channel.
+ *
+ * This client half only needs the slot registry and the `connection` service.
+ * On click the button asks the host for project doc context (the browser cannot
+ * read file contents itself), then assembles the fuller prompt on the client and
+ * writes it back with `inputActions.setDraft`.
+ */
+import { StarButton } from "./StarButton.js";
+import { RPC_CHANNEL, EP_CONTEXT } from '../types';
+/** Cordis services this client plugin needs: the slot registry and the
+ *  Connection service (both provided by the stock web-app composition). */
+export const inject = ['slots', 'connection'];
+/**
+ * Client plugin body: register the ⭐ button once the slot registry and the
+ * Connection service are up.
+ * @param ctx - client root context.
+ */
+export function apply(ctx) {
+    ctx.inject(['slots', 'connection'], (scope) => {
+        const root = scope;
+        const rpc = root.connection.rpc;
+        root.slots.inject('conversation.input.right', () => {
+            root.slots.register({
+                name: 'conversation.input.right',
+                id: 'prompt-star',
+                order: 0,
+                inject: () => ({
+                    context: () => rpc.call(RPC_CHANNEL, EP_CONTEXT, {}),
+                }),
+            }, StarButton);
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

package/lib/types/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Host entry for dsh-prompt-star.
+ *
+ * The ⭐ button lives in the client half; this host half registers ONE generic
+ * Connection RPC channel (`/dsh-prompt-star`) that reads a few project
+ * documentation files for the current workspace. The browser client CANNOT read
+ * file contents (the stock web app exposes no content-reading remote), so the
+ * read happens here and is shipped to the browser over the Connection channel.
+ *
+ * This entry follows the standard DSH plugin export contract `apply(ctx)`.
+ *
+ * The host-side services (`ctx.connection.rpc`, `ctx.fs`) are consumed through
+ * small local structural types instead of importing the harness packages, so the
+ * plugin's `tsc` stays inside its own `rootDir` and never drags harness source
+ * files into its program.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/**
+ * Minimal host plugin body: mount the `/dsh-prompt-star` RPC channel.
+ * @param ctx - host root context.
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.js

@@ -0,0 +1,81 @@
+/**
+ * Host entry for dsh-prompt-star.
+ *
+ * The ⭐ button lives in the client half; this host half registers ONE generic
+ * Connection RPC channel (`/dsh-prompt-star`) that reads a few project
+ * documentation files for the current workspace. The browser client CANNOT read
+ * file contents (the stock web app exposes no content-reading remote), so the
+ * read happens here and is shipped to the browser over the Connection channel.
+ *
+ * This entry follows the standard DSH plugin export contract `apply(ctx)`.
+ *
+ * The host-side services (`ctx.connection.rpc`, `ctx.fs`) are consumed through
+ * small local structural types instead of importing the harness packages, so the
+ * plugin's `tsc` stays inside its own `rootDir` and never drags harness source
+ * files into its program.
+ */
+import { RPC_CHANNEL, EP_CONTEXT } from './types';
+/** Project doc files probed, in priority order. Reads are best-effort. */
+const DOC_CANDIDATES = [
+    'README.md',
+    'README',
+    'AGENTS.md',
+    'CLAUDE.md',
+    'CONTRIBUTING.md',
+    'docs/README.md',
+    'docs/index.md',
+    '.cursorrules',
+];
+/** Per-doc content cap so a huge README cannot flood the input. */
+const MAX_DOC_CHARS = 4000;
+/**
+ * Minimal host plugin body: mount the `/dsh-prompt-star` RPC channel.
+ * @param ctx - host root context.
+ */
+export function apply(ctx) {
+    const host = ctx;
+    // Registrations on `ctx.connection.rpc` belong to this plugin's Cordis fiber,
+    // so they are removed automatically when the plugin is torn down.
+    host.connection.rpc.handle(RPC_CHANNEL, async (endpoint, payload) => {
+        if (endpoint !== EP_CONTEXT) {
+            return {
+                ok: false,
+                error: { code: 'unknown_endpoint', message: `unknown endpoint '${endpoint}'`, details: {} },
+            };
+        }
+        try {
+            const req = (payload ?? {});
+            const root = req.cwd?.trim() || process.cwd();
+            const docs = [];
+            const seen = new Set();
+            let filesRead = 0;
+            for (const name of DOC_CANDIDATES) {
+                try {
+                    const target = host.fs.resolve(name, { cwd: root });
+                    const text = await host.fs.readText(target);
+                    const trimmed = text?.trim();
+                    if (trimmed && !seen.has(name)) {
+                        seen.add(name);
+                        docs.push({ name, text: trimmed.slice(0, MAX_DOC_CHARS) });
+                        filesRead += 1;
+                    }
+                }
+                catch {
+                    // Absent / unreadable / outside the workspace: leave it out.
+                }
+            }
+            return { ok: true, value: { docs, filesRead } };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                error: {
+                    code: 'internal',
+                    message: err instanceof Error ? err.message : String(err),
+                    details: {},
+                },
+            };
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/lib/types/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * dsh-prompt-star — host↔client RPC protocol (shared vocabulary).
+ *
+ * Transport: the generic Connection RPC channel `/dsh-prompt-star`
+ * (the host registers it with `ctx.connection.rpc.handle`, the browser calls
+ * `ctx.connection.rpc.call('/dsh-prompt-star', endpoint, payload)`).
+ *
+ * The host sells exactly one capability: reading a few project documentation
+ * files for the current workspace (it CAN read file contents natively; the
+ * browser client cannot). Everything else — assembling the fuller prompt from
+ * the draft + that context — stays on the client.
+ */
+/** Absolute logical Connection RPC channel owned by this plugin. */
+export declare const RPC_CHANNEL = "/dsh-prompt-star";
+/** Channel-relative endpoint that reads project doc files on the host. */
+export declare const EP_CONTEXT = "context";
+export interface GenerateContextRequest {
+    /**
+     * Optional workspace directory to probe for doc files. When absent the host
+     * falls back to the DSH process working directory.
+     */
+    cwd?: string;
+}
+export interface DocContext {
+    /** One entry per successfully read project-doc file. */
+    docs: Array<{
+        name: string;
+        text: string;
+    }>;
+    /** Number of doc files read. */
+    filesRead: number;
+}
+/** The `context` endpoint's success/error envelope (Connection RPC result). */
+export type ContextRpcResult = {
+    ok: true;
+    value: DocContext;
+} | {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        details: object;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/types/types.js

@@ -0,0 +1,17 @@
+/**
+ * dsh-prompt-star — host↔client RPC protocol (shared vocabulary).
+ *
+ * Transport: the generic Connection RPC channel `/dsh-prompt-star`
+ * (the host registers it with `ctx.connection.rpc.handle`, the browser calls
+ * `ctx.connection.rpc.call('/dsh-prompt-star', endpoint, payload)`).
+ *
+ * The host sells exactly one capability: reading a few project documentation
+ * files for the current workspace (it CAN read file contents natively; the
+ * browser client cannot). Everything else — assembling the fuller prompt from
+ * the draft + that context — stays on the client.
+ */
+/** Absolute logical Connection RPC channel owned by this plugin. */
+export const RPC_CHANNEL = '/dsh-prompt-star';
+/** Channel-relative endpoint that reads project doc files on the host. */
+export const EP_CONTEXT = 'context';
+//# sourceMappingURL=types.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-prompt-star",
-  "version": "0.1.0",
-  "description": "DSH plugin: a ⭐ button beside the conversation input that reads your draft + the project's doc files and generates a fuller, more efficient prompt, filling the input directly (Ctrl/Cmd+Z to undo).",
+  "version": "0.1.3",
+  "description": "DSH plugin: a ⭐ button beside the conversation input that reads your draft + the project's doc files and turns them into a fuller, more efficient prompt, filling the input directly (Ctrl/Cmd+Z to undo).",
   "publishConfig": {
     "access": "public"
   },
@@ -29,13 +29,8 @@
       "patch": "./cordis.patch.yml"
     },
     "client": {
-      "external": [
-        "@deepseek-ai/dsh-api-gateway/client"
-      ],
       "inject": [
-        "@deepseek-ai/dsh-api-gateway",
-        "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-locale"
+        "@deepseek-ai/dsh-client-connection"
       ],
       "platform": "web"
     }
@@ -49,21 +44,21 @@
   ],
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-fs": "^0.1.2-rc.1",
     "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-rc.1",
     "react": "^18.3.1"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.3.1",
-    "tsdown": "^0.14.0",
+    "tsdown": "^0.22.2",
     "typescript": "^5.5.0"
   },
   "scripts": {
     "bundle": "tsdown",
+    "bundle:host": "tsdown --env.DSH_BUILD_FACE host",
+    "bundle:client": "tsdown --env.DSH_BUILD_FACE client",
     "watch": "tsdown --watch"
   },
   "license": "MIT"