@hokan/hello 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 huyongle
+
+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/cordis.patch.yml

@@ -0,0 +1,9 @@
+# @hokan/hello 的 bundle patch —— 本功能包贡献的一行。
+# 单独安装本包（dsh plugin add @hokan/hello）或经伞形包 dsh-hokan 引用均可。
+
+- insert:
+    - id: hokan-hello
+      name: '@hokan/hello'
+      disabled: true
+      config:
+        greeting: 補完

package/lib/client.js

@@ -0,0 +1,59 @@
+"use strict";
+// 行 config 下发路由（与宿主侧 @hokan/core 的 ROUTE_PREFIX 对应，运行时隔离各自定义）。
+const CONFIG_ROUTE = '/dsh-hokan/hello/config.json';
+// 停靠位排序值：排在常规内容之后。
+const DOCK_ORDER = 960;
+// trace 开关：config 拉取后更新（拉取本身无法提前感知开关）。
+let traceEnabled = false;
+// 浏览器侧轨迹：与宿主同格式的 JSON 行，console.debug 输出（DevTools 过滤 hokan-trace）。
+function traceEvent(event, detail) {
+    if (!traceEnabled)
+        return;
+    console.debug('hokan-trace ' + JSON.stringify({ timestamp: new Date().toISOString(), scope: 'hokan:hello.client', event, detail }));
+}
+// 拉取本行 config；失败回退空配置。
+async function fetchConfig() {
+    const response = await fetch(CONFIG_ROUTE);
+    if (!response.ok)
+        return {};
+    const payload = (await response.json());
+    return payload.config ?? {};
+}
+// 问候文字元素。
+function renderGreeting(React, config) {
+    const greeting = config.greeting ?? '補完';
+    return React.createElement('span', { style: { color: '#8a8f98', fontSize: '11px', padding: '0 8px', userSelect: 'none' }, title: 'dsh-hokan · hello' }, greeting + ' · hokan');
+}
+window.__ModuleLoader__.load({
+    id: '@hokan/hello',
+    factory: (require) => {
+        const React = require('react');
+        return {
+            name: 'hokan-hello',
+            inject: ['slots'],
+            apply(context) {
+                context.effect(() => {
+                    let active = true;
+                    const startedAt = performance.now();
+                    fetchConfig()
+                        .then((config) => {
+                        if (!active)
+                            return;
+                        traceEnabled = config.trace?.enabled === true;
+                        traceEvent('config.fetched', { durationMs: Math.round((performance.now() - startedAt) * 100) / 100 });
+                        context.slots.inject('conversation.composer.dock', function* () {
+                            yield context.slots.register({ name: 'conversation.composer.dock', id: 'hokan-hello', order: DOCK_ORDER }, () => renderGreeting(React, config));
+                        });
+                        traceEvent('slots.registered', { slot: 'conversation.composer.dock' });
+                    })
+                        .catch((error) => {
+                        context.logger.error(error);
+                    });
+                    return () => {
+                        active = false;
+                    };
+                }, 'hokan-hello: client');
+            },
+        };
+    },
+});

package/lib/index.js

@@ -0,0 +1,30 @@
+import { createTracer, serveRowConfig } from '@hokan/core';
+// Cordis 插件名（行 id 与之对应：hokan-hello）。
+export const name = 'hokan-hello';
+// 需要宿主注入的服务：Web 路由注册。
+export const inject = ['webServer'];
+/**
+ * 从行 config 创建 tracer；logger 存在则进宿主日志，否则退回 console。
+ *
+ * @param context 宿主插件上下文
+ * @param config 行配置
+ * @returns Tracer
+ */
+function tracerFrom(context, config) {
+    return createTracer({
+        scope: 'hokan:hello',
+        enabled: config?.trace?.enabled === true,
+        slowMs: config?.trace?.slowMs,
+        sink: { write: (entry) => { context.logger?.debug?.('hokan-trace ' + JSON.stringify(entry)); } },
+    });
+}
+/**
+ * hello 功能行宿主半侧：注册 config 下发路由（带 trace 计时）。
+ *
+ * @param context 宿主插件上下文
+ * @param config 行配置
+ */
+export function apply(context, config) {
+    const tracer = tracerFrom(context, config);
+    context.effect(() => serveRowConfig(context, { featureId: 'hello', config, tracer }), 'hokan-hello: config route');
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@hokan/hello",
+  "version": "0.1.0",
+  "description": "dsh-hokan 示例功能行：输入区停靠位问候（安装自检用）",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "slots"
+      ]
+    }
+  },
+  "dependencies": {
+    "@hokan/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/YuluoY/dsh-hokan.git",
+    "directory": "packages/hello"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.client.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit",
+    "dev": "tsc -p tsconfig.json --watch & tsc -p tsconfig.client.json --watch"
+  }
+}