@liangjiehappy/dsh-calc-fx 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,17 @@
-# Temporary Holding Version
+# 汇率换算（手动）
 
-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.
+手动汇率换算。不联网，你给汇率我算。适合估算和记账。纯本地计算，不联网。
+
+## 安装
+
+```bash
+dsh plugin --profile web add @liangjiehappy/dsh-calc-fx
+```
+
+## 用法
+
+在会话里说「100 美元，汇率 7.2，换多少人民币」，或直接调用工具 `calc_fx`。
+
+## 许可
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# 汇率换算（手动）
+- insert:
+    - id: dsh-calc-fx
+      name: "@liangjiehappy/dsh-calc-fx"

package/lib/index.js

@@ -0,0 +1,101 @@
+/**
+ * 汇率换算（手动）
+ *
+ * 手动汇率换算。不联网，你给汇率我算。适合估算和记账。纯本地计算，不联网。
+ */
+
+export const name = "dsh-calc-fx";
+
+export const inject = ["tools"];
+
+const TEXT_OUTPUT = {
+  schema: {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+      text: { type: "string" },
+    },
+    required: ["text"],
+  },
+  render: (_args, value) => [
+    { type: "text", text: (value && value.text) || "" },
+  ],
+};
+
+// ══════════════════════════════════════════════════════════
+//  通用工具函数
+// ══════════════════════════════════════════════════════════
+
+const TITLE = "__CALC_TITLE__";
+
+function fmt(n, digits) {
+  if (!Number.isFinite(n)) return String(n);
+  const d = digits == null ? 2 : digits;
+  if (Math.abs(n) >= 1e12) return n.toExponential(6);
+  let s = n.toFixed(d);
+  if (d > 0) s = s.replace(/0+$/, "").replace(/\.$/, "");
+  return s;
+}
+
+function money(n) {
+  if (!Number.isFinite(n)) return String(n);
+  return n.toLocaleString("zh-CN", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+}
+
+function num(v, def) {
+  const n = Number(v);
+  return Number.isFinite(n) ? n : (def == null ? 0 : def);
+}
+
+function line(label, value, unit) {
+  const pad = "  ";
+  return pad + label + "：" + value + (unit ? " " + unit : "");
+}
+
+function head(title) {
+  return [title, "=".repeat(52)];
+}
+
+// ══════════════════════════════════════════════════════════
+//  工具
+// ══════════════════════════════════════════════════════════
+
+export function apply(ctx, config) {
+  void config;
+
+  ctx.tools.register({
+    name: "calc_fx",
+    description:
+      "手动汇率换算。输入金额、汇率、方向，返回换算结果。不联网，汇率由你自己提供。",
+    parameters: {
+      amount: { type: "number", required: true, description: "金额" },
+      rate: { type: "number", required: true, description: "汇率" },
+      direction: { type: "string", description: "方向：to_cny（外币→人民币，默认）或 from_cny（人民币→外币）", enum: ["to_cny", "from_cny"] },
+    },
+    output: TEXT_OUTPUT,
+    async execute(args) {
+      try {
+        const a = args || {};
+        const amt = num(a.amount), rate = num(a.rate);
+        if (rate <= 0) return { text: "汇率要大于 0" };
+        const dir = String(a.direction || "to_cny").toLowerCase();
+        const L = head("汇率换算");
+        if (dir === "from_cny") {
+          L.push(line("人民币", money(amt) + " 元"));
+          L.push(line("汇率", fmt(rate, 4)));
+          L.push(line("外币", money(amt / rate)));
+        } else {
+          L.push(line("外币", money(amt)));
+          L.push(line("汇率", fmt(rate, 4)));
+          L.push(line("人民币", money(amt * rate) + " 元"));
+        }
+        L.push("");
+        L.push("  汇率由你提供，不是实时价。");
+        L.push("  要实时汇率的话用 fx-rate 那个插件（联网）。");
+        return { text: L.join("\n") };
+      } catch (e) {
+        return { text: "计算失败: " + String((e && e.message) || e) };
+      }
+    },
+  });
+}

package/package.json

@@ -1,6 +1,16 @@
 {
   "name": "@liangjiehappy/dsh-calc-fx",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "手动汇率换算。不联网，你给汇率我算。适合估算和记账。纯本地计算，不联网。",
+  "type": "module",
+  "main": "lib/index.js",
+  "files": ["lib", "cordis.patch.yml", "README.md"],
+  "keywords": ["dsh", "dsh-plugin", "calc", "calculator", "fx", "计算器"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moldkey/dsh-calc-fx.git"
+  },
+  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } },
+  "engines": { "dsh": ">=0.2.0-rc.2" }
+}