@zhin.js/command 1.0.4 → 1.0.6

package/lib/command-index.js

@@ -133,11 +133,18 @@ export function isCommandIndex(value) {
     return !!value && typeof value === 'object'
         && value.$projection === 'zhin.command-index/1';
 }
+/**
+ * 命令运行时名 = 插件树路径段（instanceKey，去掉 root）以 `.` 连接后，再与命令
+ * 文件路径首段以 `.` 连接；命令内部嵌套段仍为空格分隔。Root 插件无前缀。
+ * 例：`root/qq` + `endpoint/list` → `qq.endpoint list`；
+ * `root/b/a` + `foo` → `b.a.foo`；root + `foo` → `foo`。
+ */
 function runtimeSegments(owner, localName) {
-    const ownerSegments = owner === 'root'
-        ? []
-        : owner.slice('root/'.length).split('/');
-    return [...ownerSegments, ...localName.split('/')];
+    const localSegments = localName.split('/');
+    if (owner === 'root')
+        return localSegments;
+    const prefix = owner.slice('root/'.length).split('/').join('.');
+    return [`${prefix}.${localSegments[0]}`, ...localSegments.slice(1)];
 }
 function assertParameterSegment(segments, parameter, source) {
     const dynamicSegments = segments.filter((segment) => segment.startsWith('$'));

package/lib/definition.js

@@ -140,14 +140,19 @@ function parseTarget(target) {
     const parts = target.split(':').filter(Boolean);
     if (parts.length < 2)
         return undefined;
-    const kind = parts[0];
+    const [kind, ...rest] = parts;
+    if (!kind)
+        return undefined;
+    const lastPart = parts.at(-1);
+    if (!lastPart)
+        return undefined;
     if (kind === 'channel' && parts.length >= 3) {
-        return { type: 'channel', id: parts[parts.length - 1] };
+        return { type: 'channel', id: lastPart };
     }
     if (kind === 'temp' && parts.length >= 3) {
-        return { type: 'private', id: parts[parts.length - 1] };
+        return { type: 'private', id: lastPart };
     }
-    return { type: kind, id: parts.slice(1).join(':') };
+    return { type: kind, id: rest.join(':') };
 }
 function isCommandScene(value) {
     if (!value || typeof value !== 'object')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/command",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Convention-based Command Feature for Zhin Plugin Runtime",
   "type": "module",
   "main": "./lib/index.js",
@@ -18,11 +18,11 @@
   ],
   "dependencies": {
     "segment-matcher": "^1.0.5",
-    "@zhin.js/feature-kit": "1.0.4",
-    "@zhin.js/plugin-runtime": "1.1.1"
+    "@zhin.js/feature-kit": "1.0.5",
+    "@zhin.js/plugin-runtime": "1.1.2"
   },
   "devDependencies": {
-    "@types/node": "^26.1.0",
+    "@types/node": "^26.1.2",
     "typescript": "^6.0.3"
   },
   "zhin": {

package/src/command-index.ts

@@ -207,11 +207,17 @@ export function isCommandIndex(value: unknown): value is CommandIndex {
     && (value as { readonly $projection?: unknown }).$projection === 'zhin.command-index/1';
 }
 
+/**
+ * 命令运行时名 = 插件树路径段（instanceKey，去掉 root）以 `.` 连接后，再与命令
+ * 文件路径首段以 `.` 连接；命令内部嵌套段仍为空格分隔。Root 插件无前缀。
+ * 例：`root/qq` + `endpoint/list` → `qq.endpoint list`；
+ * `root/b/a` + `foo` → `b.a.foo`；root + `foo` → `foo`。
+ */
 function runtimeSegments(owner: string, localName: string): string[] {
-  const ownerSegments = owner === 'root'
-    ? []
-    : owner.slice('root/'.length).split('/');
-  return [...ownerSegments, ...localName.split('/')];
+  const localSegments = localName.split('/');
+  if (owner === 'root') return localSegments;
+  const prefix = owner.slice('root/'.length).split('/').join('.');
+  return [`${prefix}.${localSegments[0]}`, ...localSegments.slice(1)];
 }
 
 function assertParameterSegment(

package/src/definition.ts

@@ -312,14 +312,17 @@ function resolveRoles(
 function parseTarget(target: string): { readonly type: string; readonly id: string } | undefined {
   const parts = target.split(':').filter(Boolean);
   if (parts.length < 2) return undefined;
-  const kind = parts[0];
+  const [kind, ...rest] = parts;
+  if (!kind) return undefined;
+  const lastPart = parts.at(-1);
+  if (!lastPart) return undefined;
   if (kind === 'channel' && parts.length >= 3) {
-    return { type: 'channel', id: parts[parts.length - 1]! };
+    return { type: 'channel', id: lastPart };
   }
   if (kind === 'temp' && parts.length >= 3) {
-    return { type: 'private', id: parts[parts.length - 1]! };
+    return { type: 'private', id: lastPart };
   }
-  return { type: kind!, id: parts.slice(1).join(':') };
+  return { type: kind, id: rest.join(':') };
 }
 
 function isCommandScene(value: unknown): value is CommandScene {