tdsh-emoji 0.1.0

package/lib/client.js

@@ -0,0 +1,540 @@
+/**
+ * tdsh-emoji Web client half.
+ *
+ * 在「设置 → 通用设置」注册一张 emoji 配置卡片（排在 dsh-kaomoji 卡片旁边），
+ * 通过同源路由 POST /tdsh-emoji-settings 读写 Host 的 ~/.dsh/tdsh-emoji.json。
+ *
+ * 采用 dsh Web 客户端的 ModuleLoader 格式（与 dsh-kaomoji / dsh-emoji 相同）。
+ */
+window.__ModuleLoader__.load({
+  id: "tdsh-emoji",
+  factory: (require) => {
+    const module = { exports: {} };
+    const exports = module.exports;
+    Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+
+    const react = require("react");
+    const { useState, useEffect } = react;
+    const h = react.createElement;
+
+    const NS = "tdsh-emoji";
+    const ROUTE = "/tdsh-emoji-settings";
+    const MODES = ["off", "auto", "frequent"];
+    const PLACEMENTS = ["inline", "end"];
+    const MAX_PER_TURN = 10;
+    const DEFAULT_SETTINGS = Object.freeze({
+      mode: "auto",
+      placement: "inline",
+      maxPerTurn: 3,
+      customPrompt: "",
+    });
+
+    function normalizeSettings(value) {
+      const mode = MODES.includes(value.mode) ? value.mode : DEFAULT_SETTINGS.mode;
+      const placement = PLACEMENTS.includes(value.placement)
+        ? value.placement
+        : DEFAULT_SETTINGS.placement;
+      const maxPerTurn =
+        Number.isInteger(value.maxPerTurn) &&
+        value.maxPerTurn >= 1 &&
+        value.maxPerTurn <= MAX_PER_TURN
+          ? value.maxPerTurn
+          : DEFAULT_SETTINGS.maxPerTurn;
+      const customPrompt =
+        typeof value.customPrompt === "string" && value.customPrompt.length <= 4000
+          ? value.customPrompt
+          : "";
+      return { mode, placement, maxPerTurn, customPrompt };
+    }
+
+    function cloneSettings(settings) {
+      return { ...settings, customPrompt: settings.customPrompt };
+    }
+
+    const zh = {
+      "row.title": "Emoji（tdsh-emoji）",
+      "row.description": "给对话回复自动加标准 emoji，贴合情绪放在句子后；与颜文字插件互不同句。",
+      "field.mode": "使用频率",
+      "mode.off": "关闭",
+      "mode.off.desc": "不使用 emoji",
+      "mode.auto": "智能",
+      "mode.auto.desc": "寒暄、闲聊、推荐建议、共情回复都会带",
+      "mode.frequent": "高频",
+      "mode.frequent.desc": "每条对话回复都带（纯代码/正式交付除外）",
+      "field.placement": "放置位置",
+      "placement.inline": "贴合句子",
+      "placement.end": "回复结尾",
+      "field.max": "每条上限",
+      "field.prompt": "附加提示词",
+      "prompt.placeholder": "例如：正式场景克制一点，优先用「鼓励/感谢」类 emoji",
+      "prompt.help": "只细化风格与场景，不能改变模式、白名单或数量上限。",
+      "action.reset": "恢复默认",
+      "status.loading": "正在读取设置…",
+      "status.saved": "已保存，下一次回复生效。",
+      "status.unsupported": "Host 未加载 emoji 插件或该来源不被信任，无法保存设置。",
+      "status.forbidden": "当前来源不在 Host 的信任列表里，无法保存设置。",
+      "status.error": "保存失败，请重试。",
+    };
+
+    const en = {
+      "row.title": "Emoji (tdsh-emoji)",
+      "row.description": "Adds standard emoji to replies, placed after the matching sentence; never shares a line with kaomoji.",
+      "field.mode": "Frequency",
+      "mode.off": "Off",
+      "mode.off.desc": "No emoji",
+      "mode.auto": "Smart",
+      "mode.auto.desc": "Greetings, casual chat, recommendations and empathetic replies get emoji",
+      "mode.frequent": "Frequent",
+      "mode.frequent.desc": "Emoji in every conversational reply (code-only/formal excluded)",
+      "field.placement": "Placement",
+      "placement.inline": "After best-matching sentence",
+      "placement.end": "End of reply",
+      "field.max": "Max per reply",
+      "field.prompt": "Extra guidance",
+      "prompt.placeholder": "e.g. Stay professional; prefer encourage/thanks emoji",
+      "prompt.help": "Refines tone/scenes only; cannot change mode, whitelist, or limits.",
+      "action.reset": "Reset to defaults",
+      "status.loading": "Loading settings…",
+      "status.saved": "Saved — applies to the next reply.",
+      "status.unsupported": "The Host did not load the emoji plugin, or this origin is not trusted.",
+      "status.forbidden": "This origin is not in the Host trust list, so settings cannot be saved.",
+      "status.error": "Save failed, please retry.",
+    };
+
+    const styles = {
+      card: {
+        display: "flex",
+        flexDirection: "column",
+        gap: 12,
+        padding: "14px 16px",
+        border: "1px solid var(--dsw-alias-border-l2)",
+        borderRadius: 12,
+        background: "var(--dsw-alias-bg-layer-3)",
+        color: "var(--dsw-alias-label-primary)",
+      },
+      header: { display: "flex", flexDirection: "column", gap: 4, minWidth: 0 },
+      title: { fontSize: 15, lineHeight: "21px", fontWeight: 600 },
+      description: {
+        fontSize: 13,
+        lineHeight: "19px",
+        color: "var(--dsw-alias-label-tertiary)",
+      },
+      grid: {
+        display: "grid",
+        gridTemplateColumns: "repeat(auto-fit, minmax(150px, 1fr))",
+        gap: 12,
+      },
+      field: { display: "flex", flexDirection: "column", gap: 6, minWidth: 0 },
+      label: { fontSize: 13, lineHeight: "18px", fontWeight: 600 },
+      modeRow: {
+        display: "grid",
+        gridTemplateColumns: "repeat(3, minmax(0, 1fr))",
+        gap: 8,
+      },
+      mode: {
+        minWidth: 0,
+        display: "flex",
+        flexDirection: "column",
+        gap: 4,
+        padding: "8px 6px",
+        border: "1px solid var(--dsw-alias-border-l2)",
+        borderRadius: 8,
+        background: "var(--dsw-alias-bg-module-platform)",
+        color: "inherit",
+        font: "inherit",
+        cursor: "pointer",
+      },
+      modeName: { fontSize: 12, lineHeight: "18px", fontWeight: 600 },
+      modeDesc: {
+        fontSize: 11,
+        lineHeight: "16px",
+        color: "var(--dsw-alias-label-tertiary)",
+      },
+      select: {
+        boxSizing: "border-box",
+        width: "100%",
+        padding: "7px 10px",
+        border: "1px solid var(--dsw-alias-border-l2)",
+        borderRadius: 8,
+        background: "var(--dsw-alias-bg-module-platform)",
+        color: "var(--dsw-alias-label-primary)",
+        font: "inherit",
+        fontSize: 13,
+      },
+      number: {
+        boxSizing: "border-box",
+        width: "100%",
+        padding: "7px 10px",
+        border: "1px solid var(--dsw-alias-border-l2)",
+        borderRadius: 8,
+        background: "var(--dsw-alias-bg-module-platform)",
+        color: "var(--dsw-alias-label-primary)",
+        font: "inherit",
+        fontSize: 13,
+      },
+      prompt: {
+        boxSizing: "border-box",
+        width: "100%",
+        minHeight: 72,
+        resize: "vertical",
+        padding: "8px 10px",
+        border: "1px solid var(--dsw-alias-border-l2)",
+        borderRadius: 8,
+        background: "var(--dsw-alias-bg-module-platform)",
+        color: "var(--dsw-alias-label-primary)",
+        font: "inherit",
+        fontSize: 13,
+        lineHeight: 1.55,
+      },
+      footer: {
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "space-between",
+        gap: 12,
+      },
+      status: { fontSize: 12, lineHeight: "18px", color: "var(--dsw-alias-label-tertiary)" },
+      reset: {
+        flex: "0 0 auto",
+        padding: "6px 10px",
+        border: "1px solid var(--dsw-alias-border-l2)",
+        borderRadius: 8,
+        background: "none",
+        color: "var(--dsw-alias-label-secondary)",
+        font: "inherit",
+        fontSize: 12,
+        cursor: "pointer",
+      },
+    };
+
+    /** 轻量快照 store；slot runtime 会包装成 useEmojiSettings(selector)。 */
+    function createSettingsStore(fetchImpl) {
+      const doFetch = typeof fetchImpl === "function" ? fetchImpl : (...args) => fetch(...args);
+      let snapshot = {
+        status: "loading",
+        settings: cloneSettings(DEFAULT_SETTINGS),
+        revision: undefined,
+        writable: true,
+        saveError: null,
+        saveErrorMessage: null,
+        justSaved: false,
+      };
+      const listeners = new Set();
+      let tail = Promise.resolve();
+
+      const emit = () => {
+        for (const listener of listeners) listener();
+      };
+
+      const publish = (patch) => {
+        snapshot = patch.saveError === null
+          ? { ...snapshot, ...patch, saveErrorMessage: null }
+          : { ...snapshot, ...patch };
+        emit();
+      };
+
+      const enqueue = (operation) => {
+        const task = tail.then(operation);
+        tail = task.catch(() => {});
+        return task;
+      };
+
+      const fail = (code, message) => {
+        publish({
+          status: "unavailable",
+          writable: false,
+          saveError: code,
+          saveErrorMessage: message || null,
+          justSaved: false,
+        });
+      };
+
+      const callRpc = async (endpoint, payload) => {
+        try {
+          const response = await doFetch(ROUTE, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ endpoint, payload }),
+          });
+          const status = Number((response && response.status) || 0);
+          let result;
+          try {
+            result = await response.json();
+          } catch {
+            result = undefined;
+          }
+          if (result && result.ok === true) return { value: result.value };
+          const error = (result && result.error) || {};
+          if (status === 403 || error.code === "forbidden") {
+            return { error: "forbidden", message: error.message || "forbidden" };
+          }
+          return {
+            error: "rejected",
+            message: typeof error.message === "string" ? error.message : `HTTP ${String(status)}`,
+          };
+        } catch (error) {
+          const message = String((error && error.message) || error || "");
+          return {
+            error: /403|forbidden/i.test(message) ? "forbidden" : "unreachable",
+            message,
+          };
+        }
+      };
+
+      return {
+        getSnapshot: () => snapshot,
+        subscribe(listener) {
+          listeners.add(listener);
+          return () => listeners.delete(listener);
+        },
+        async refresh() {
+          const result = await callRpc("get", {});
+          if (result.error !== undefined) {
+            fail(result.error === "forbidden" ? "forbidden" : "load", result.message);
+            return;
+          }
+          const value = result.value;
+          publish({
+            status: "ready",
+            settings: normalizeSettings(value.settings),
+            revision: value.revision,
+            writable: value.writable === true,
+            saveError: null,
+          });
+        },
+        patch(field) {
+          if (!snapshot.writable) return Promise.resolve();
+          const next = normalizeSettings({ ...snapshot.settings, ...field });
+          publish({
+            status: "ready",
+            settings: next,
+            saveError: null,
+            justSaved: false,
+          });
+          return enqueue(async () => {
+            const result = await callRpc("save", {
+              settings: next,
+              expectedRevision: snapshot.revision,
+            });
+            if (result.error !== undefined) {
+              fail(result.error === "forbidden" ? "forbidden" : "save", result.message);
+              return;
+            }
+            const value = result.value;
+            publish({
+              settings: normalizeSettings(value.settings),
+              revision: value.revision,
+              writable: value.writable === true,
+              status: "ready",
+              saveError: null,
+              justSaved: true,
+            });
+          });
+        },
+        async reset() {
+          if (!snapshot.writable) return;
+          publish({ saveError: null, justSaved: false });
+          const result = await callRpc("reset", { expectedRevision: snapshot.revision });
+          if (result.error !== undefined) {
+            fail(result.error === "forbidden" ? "forbidden" : "save", result.message);
+            return;
+          }
+          const value = result.value;
+          publish({
+            settings: normalizeSettings(value.settings),
+            revision: value.revision,
+            status: "ready",
+            saveError: null,
+            justSaved: true,
+          });
+        },
+      };
+    }
+
+    function EmojiSettingsRow(props) {
+      const { t, useEmojiSettings } = props;
+      const state = useEmojiSettings((value) => value);
+      const settings = state.settings;
+      const [promptDraft, setPromptDraft] = useState(settings.customPrompt);
+
+      useEffect(() => {
+        setPromptDraft(settings.customPrompt);
+      }, [settings.customPrompt]);
+
+      const statusText = state.saveError
+        ? state.saveError === "forbidden"
+          ? t("status.forbidden")
+          : state.saveErrorMessage
+            ? `${t("status.error")} ${state.saveErrorMessage}`
+            : t("status.error")
+        : state.status === "loading"
+          ? t("status.loading")
+          : !state.writable
+            ? t("status.unsupported")
+            : state.justSaved
+              ? t("status.saved")
+              : t("prompt.help");
+      const controlsDisabled = !state.writable || state.status === "loading";
+
+      return h(
+        "section",
+        { style: styles.card, "data-tdsh-emoji-settings": "true" },
+        h(
+          "div",
+          { style: styles.header },
+          h("div", { style: styles.title }, t("row.title")),
+          h("div", { style: styles.description }, t("row.description")),
+        ),
+        h(
+          "div",
+          { style: styles.grid },
+          h(
+            "div",
+            { style: styles.field },
+            h("div", { style: styles.label }, t("field.mode")),
+            h(
+              "div",
+              { style: styles.modeRow },
+              ["off", "auto", "frequent"].map((mode) =>
+                h(
+                  "button",
+                  {
+                    key: mode,
+                    type: "button",
+                    style: {
+                      ...styles.mode,
+                      borderColor:
+                        settings.mode === mode
+                          ? "var(--dsw-alias-label-primary)"
+                          : "var(--dsw-alias-border-l2)",
+                    },
+                    "aria-pressed": settings.mode === mode,
+                    disabled: controlsDisabled,
+                    onClick: () => props.setMode(mode),
+                  },
+                  h("span", { style: styles.modeName }, t(`mode.${mode}`)),
+                  h("span", { style: styles.modeDesc }, t(`mode.${mode}.desc`)),
+                ),
+              ),
+            ),
+          ),
+          h(
+            "div",
+            { style: styles.field },
+            h("label", { style: styles.label }, t("field.placement")),
+            h(
+              "select",
+              {
+                style: styles.select,
+                value: settings.placement,
+                disabled: controlsDisabled,
+                onChange: (event) => props.setPlacement(event.target.value),
+              },
+              h("option", { value: "inline" }, t("placement.inline")),
+              h("option", { value: "end" }, t("placement.end")),
+            ),
+          ),
+          h(
+            "div",
+            { style: styles.field },
+            h("label", { htmlFor: "tdsh-emoji-max", style: styles.label }, t("field.max")),
+            h("input", {
+              id: "tdsh-emoji-max",
+              type: "number",
+              min: 1,
+              max: MAX_PER_TURN,
+              step: 1,
+              style: styles.number,
+              value: String(settings.maxPerTurn),
+              disabled: controlsDisabled,
+              onChange: (event) => {
+                const parsed = Number(event.target.value);
+                if (!Number.isNaN(parsed) && parsed >= 1 && parsed <= MAX_PER_TURN) {
+                  props.setMaxPerTurn(parsed);
+                }
+              },
+            }),
+          ),
+        ),
+        h(
+          "div",
+          { style: styles.field },
+          h("label", { htmlFor: "tdsh-emoji-prompt", style: styles.label }, t("field.prompt")),
+          h("textarea", {
+            id: "tdsh-emoji-prompt",
+            style: styles.prompt,
+            placeholder: t("prompt.placeholder"),
+            value: promptDraft,
+            disabled: controlsDisabled,
+            onChange: (event) => setPromptDraft(event.target.value),
+            onBlur: () => {
+              if (promptDraft !== settings.customPrompt) {
+                props.setCustomPrompt(promptDraft);
+              }
+            },
+          }),
+        ),
+        h(
+          "div",
+          { style: styles.footer },
+          h("div", { style: styles.status }, statusText),
+          h(
+            "button",
+            {
+              type: "button",
+              style: styles.reset,
+              disabled: controlsDisabled,
+              onClick: () => void props.reset(),
+            },
+            t("action.reset"),
+          ),
+        ),
+      );
+    }
+
+    const inject = ["slots", "locale"];
+
+    function apply(ctx) {
+      ctx.effect(
+        () => ctx.locale.register(NS, { zh, en }),
+        "tdsh-emoji: dictionaries",
+      );
+      const controller = createSettingsStore();
+      void controller.refresh();
+
+      ctx.effect(() => {
+        const disposeReset = ctx.on("connection/reset", () => void controller.refresh());
+        return () => disposeReset();
+      }, "tdsh-emoji: settings invalidations");
+
+      ctx.slots.inject("settings.general.item", () =>
+        ctx.slots.register(
+          {
+            name: "settings.general.item",
+            // 排在 dsh-kaomoji（order 30）后面，两张卡片相邻。
+            id: "tdsh-emoji",
+            order: 31,
+            locale: NS,
+            inject: () => ({
+              hooks: { emojiSettings: controller },
+              setMode: (mode) => void controller.patch({ mode }),
+              setPlacement: (placement) => void controller.patch({ placement }),
+              setMaxPerTurn: (maxPerTurn) => void controller.patch({ maxPerTurn }),
+              setCustomPrompt: (customPrompt) => void controller.patch({ customPrompt }),
+              reset: () => controller.reset(),
+            }),
+          },
+          EmojiSettingsRow,
+        ),
+      );
+    }
+
+    exports.apply = apply;
+    exports.inject = inject;
+    exports.NS = NS;
+    exports.ROUTE = ROUTE;
+    exports.MAX_PER_TURN = MAX_PER_TURN;
+    exports.createSettingsStore = createSettingsStore;
+    exports.EmojiSettingsRow = EmojiSettingsRow;
+    return module.exports;
+  },
+});

package/lib/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * tdsh-emoji — 给 DeepSeek Harness (dsh) 回复自动添加标准 emoji 的提示词插件。
+ */
+
+export type EmojiMode = "off" | "auto" | "frequent";
+export type EmojiPlacement = "inline" | "end";
+
+export interface EmojiConfig {
+  mode?: EmojiMode;
+  placement?: EmojiPlacement;
+  maxPerTurn?: number;
+  customPrompt?: string;
+}
+
+export interface EmojiGroup {
+  id: string;
+  label: string;
+  examples: string[];
+}
+
+export const name: string;
+export const inject: string[];
+export const SECTION_NAME: string;
+export const SECTION_ORDER: number;
+export const SETTINGS_NAMESPACE: string;
+export const SETTINGS_ROUTE: string;
+export const SETTINGS_FILE_NAME: string;
+export const SETTINGS_FILE_SCHEMA_VERSION: number;
+export const MODES: EmojiMode[];
+export const PLACEMENTS: EmojiPlacement[];
+export const MAX_EMOJI_PER_TURN: number;
+export const DEFAULT_CONFIG: Required<EmojiConfig>;
+export const CATALOG: readonly EmojiGroup[];
+
+export function normalizeConfig(config?: EmojiConfig): Required<EmojiConfig>;
+
+/** mode=off 时返回空字符串（不会注入任何内容）。 */
+export function buildGuidance(config?: EmojiConfig): string;
+
+/** Cordis 插件入口。 */
+export function apply(ctx: any, config?: EmojiConfig): void;
+
+declare const plugin: { name: string; inject: string[]; apply: typeof apply };
+export default plugin;