@nanmicoder/dsh-agent-teams 0.1.1 → 0.1.2

package/README.md

@@ -13,20 +13,54 @@ DeepSeek Harness 的 AgentTeams 插件：安装后，任何会话只需一句自
 
 ## 安装
 
-**前置要求**：Node.js `^22.19` 或 `>=24`；pnpm 11；已安装或可通过 `npx` 使用 DeepSeek Harness。
+**前置要求**：已安装 [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness)（`dsh` 命令可用）；Node.js `^22.19` 或 `>=24`；pnpm 11。
 
 插件已发布到 npm（`@nanmicoder` scope），一条命令装好：
 
 ```sh
-npx -p @deepseek-ai/dsh dsh plugin --profile web add @nanmicoder/dsh-agent-teams@0.1.1
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
 ```
 
 `dsh plugin` 会把插件加入 `web` profile，并根据包内的 `dsh.bundle` 声明自动启用它；工具、系统提示和 Web 客户端入口随该 profile 一起加载。
 
-建议带版本号安装：`latest` 的解析可能受 registry 缓存影响（国内镜像源同步新版本通常有延迟）。升级时把 `@0.1.1` 换成新版本号即可。
-
 > **重启生效**：安装完成后，重启正在运行的 DeepSeek Harness Web 服务并刷新页面。
 
+装好后可以用 `dsh plugin --profile web list` 确认插件在列表里。升级用同一条 add 命令即可。
+
+### 其他安装方式
+
+**指定版本**——`latest` 的解析可能受 registry 缓存影响（国内镜像源同步新版本通常有延迟），想钉死版本时：
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams@<version>
+```
+
+版本号见 [npm 发布页](https://www.npmjs.com/package/@nanmicoder/dsh-agent-teams?activeTab=versions)。
+
+**还没装 DSH，或不想全局安装**——用 `npx` 直接跑，无需预装：
+
+```sh
+npx -p @deepseek-ai/dsh dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+**从 GitHub 安装**——想用尚未发布到 npm 的最新提交：
+
+```sh
+dsh plugin --profile web add github:NanmiCoder/dsh-agent-teams
+```
+
+**从源码安装**——要改插件本身，或参与开发：
+
+```sh
+git clone https://github.com/NanmiCoder/dsh-agent-teams.git
+cd dsh-agent-teams
+pnpm install
+pnpm build
+dsh plugin --profile web add "link:$(pwd)"
+```
+
+`link:` 安装后，改完代码跑 `pnpm build` 即时生效，不必重装插件（客户端改动需刷新页面，host 侧改动需重启 dsh 服务）。提交前跑 `pnpm verify` 做离线校验。
+
 ## 使用
 
 安装并重启后，直接对助手说：

package/lib/client.js

@@ -123,13 +123,13 @@ window.__ModuleLoader__.load({
 		var AgentTeamsCard_module_css_default = {
 			"head": "_6Ci0pW_head",
 			"leadAvatar": "_6Ci0pW_leadAvatar",
-			"members": "_6Ci0pW_members",
-			"memberInitial": "_6Ci0pW_memberInitial",
 			"member": "_6Ci0pW_member",
 			"memberArt": "_6Ci0pW_memberArt",
-			"panelButton": "_6Ci0pW_panelButton",
 			"memberCount": "_6Ci0pW_memberCount",
+			"memberInitial": "_6Ci0pW_memberInitial",
 			"memberName": "_6Ci0pW_memberName",
+			"members": "_6Ci0pW_members",
+			"panelButton": "_6Ci0pW_panelButton",
 			"root": "_6Ci0pW_root",
 			"teamName": "_6Ci0pW_teamName"
 		};
@@ -271,86 +271,86 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var ActivityPanel_module_css_default = {
+			"agentTeamsBreathe": "qZToFW_agentTeamsBreathe",
+			"agentTeamsFloat": "qZToFW_agentTeamsFloat",
+			"agentTeamsPanelIn": "qZToFW_agentTeamsPanelIn",
+			"agentTeamsPulse": "qZToFW_agentTeamsPulse",
+			"agentTeamsRing": "qZToFW_agentTeamsRing",
+			"agentTeamsThink": "qZToFW_agentTeamsThink",
+			"archivedWrap": "qZToFW_archivedWrap",
+			"assignmentChip": "qZToFW_assignmentChip",
+			"assignmentLabel": "qZToFW_assignmentLabel",
+			"assignmentLine": "qZToFW_assignmentLine",
 			"assignmentTasks": "qZToFW_assignmentTasks",
-			"taskNodeHead": "qZToFW_taskNodeHead",
-			"captainSummary": "qZToFW_captainSummary",
-			"unclaimedTitle": "qZToFW_unclaimedTitle",
+			"badge": "qZToFW_badge",
+			"badgeCount": "qZToFW_badgeCount",
+			"badgeDot": "qZToFW_badgeDot",
 			"captainAvatar": "qZToFW_captainAvatar",
-			"captainRole": "qZToFW_captainRole",
-			"unreadPill": "qZToFW_unreadPill",
-			"stageColumn": "qZToFW_stageColumn",
-			"memberInfo": "qZToFW_memberInfo",
-			"memberCount": "qZToFW_memberCount",
-			"sectionTitle": "qZToFW_sectionTitle",
-			"captainLine": "qZToFW_captainLine",
-			"assignmentLine": "qZToFW_assignmentLine",
-			"teamStats": "qZToFW_teamStats",
 			"captainInfo": "qZToFW_captainInfo",
-			"panelHead": "qZToFW_panelHead",
-			"agentTeamsFloat": "qZToFW_agentTeamsFloat",
-			"taskEmpty": "qZToFW_taskEmpty",
-			"archivedWrap": "qZToFW_archivedWrap",
-			"memberState": "qZToFW_memberState",
-			"inboxRoute": "qZToFW_inboxRoute",
-			"memberName": "qZToFW_memberName",
-			"taskSubject": "qZToFW_taskSubject",
-			"stageLine": "qZToFW_stageLine",
-			"unclaimed": "qZToFW_unclaimed",
-			"memberBranch": "qZToFW_memberBranch",
-			"memberLine": "qZToFW_memberLine",
+			"captainLine": "qZToFW_captainLine",
+			"captainName": "qZToFW_captainName",
+			"captainNode": "qZToFW_captainNode",
+			"captainRole": "qZToFW_captainRole",
+			"captainState": "qZToFW_captainState",
+			"captainSummary": "qZToFW_captainSummary",
+			"closeButton": "qZToFW_closeButton",
 			"delegationSection": "qZToFW_delegationSection",
-			"leadAvatar": "qZToFW_leadAvatar",
-			"dependencySection": "qZToFW_dependencySection",
-			"taskOwner": "qZToFW_taskOwner",
-			"badge": "qZToFW_badge",
 			"delegationTree": "qZToFW_delegationTree",
-			"agentTeamsBreathe": "qZToFW_agentTeamsBreathe",
-			"taskId": "qZToFW_taskId",
-			"taskNode": "qZToFW_taskNode",
-			"stageLabel": "qZToFW_stageLabel",
-			"badgeCount": "qZToFW_badgeCount",
-			"inbox": "qZToFW_inbox",
+			"dependencySection": "qZToFW_dependencySection",
 			"emptyHint": "qZToFW_emptyHint",
-			"team": "qZToFW_team",
-			"teams": "qZToFW_teams",
+			"historicPill": "qZToFW_historicPill",
+			"inbox": "qZToFW_inbox",
+			"inboxContent": "qZToFW_inboxContent",
+			"inboxRoute": "qZToFW_inboxRoute",
 			"inboxRow": "qZToFW_inboxRow",
-			"agentTeamsRing": "qZToFW_agentTeamsRing",
-			"taskDeps": "qZToFW_taskDeps",
-			"closeButton": "qZToFW_closeButton",
-			"members": "qZToFW_members",
-			"teamHead": "qZToFW_teamHead",
-			"sectionHead": "qZToFW_sectionHead",
-			"captainNode": "qZToFW_captainNode",
-			"memberStatusLine": "qZToFW_memberStatusLine",
+			"leadAvatar": "qZToFW_leadAvatar",
 			"memberArt": "qZToFW_memberArt",
-			"teamName": "qZToFW_teamName",
-			"stateArt": "qZToFW_stateArt",
-			"assignmentLabel": "qZToFW_assignmentLabel",
-			"stageFlow": "qZToFW_stageFlow",
-			"agentTeamsPanelIn": "qZToFW_agentTeamsPanelIn",
-			"captainName": "qZToFW_captainName",
-			"memberRow": "qZToFW_memberRow",
-			"taskRoute": "qZToFW_taskRoute",
-			"agentTeamsPulse": "qZToFW_agentTeamsPulse",
 			"memberAvatar": "qZToFW_memberAvatar",
-			"taskBadge": "qZToFW_taskBadge",
-			"stageTasks": "qZToFW_stageTasks",
-			"badgeDot": "qZToFW_badgeDot",
-			"panelTitle": "qZToFW_panelTitle",
+			"memberBlock": "qZToFW_memberBlock",
+			"memberBranch": "qZToFW_memberBranch",
+			"memberCount": "qZToFW_memberCount",
+			"memberInfo": "qZToFW_memberInfo",
 			"memberInitial": "qZToFW_memberInitial",
-			"stageConnector": "qZToFW_stageConnector",
+			"memberLine": "qZToFW_memberLine",
+			"memberName": "qZToFW_memberName",
+			"memberRole": "qZToFW_memberRole",
+			"memberRow": "qZToFW_memberRow",
+			"memberState": "qZToFW_memberState",
+			"memberStatusLine": "qZToFW_memberStatusLine",
+			"members": "qZToFW_members",
+			"panel": "qZToFW_panel",
 			"panelDot": "qZToFW_panelDot",
-			"captainState": "qZToFW_captainState",
-			"taskStart": "qZToFW_taskStart",
-			"assignmentChip": "qZToFW_assignmentChip",
+			"panelHead": "qZToFW_panelHead",
+			"panelTitle": "qZToFW_panelTitle",
+			"sectionHead": "qZToFW_sectionHead",
 			"sectionHint": "qZToFW_sectionHint",
-			"memberRole": "qZToFW_memberRole",
-			"memberBlock": "qZToFW_memberBlock",
-			"agentTeamsThink": "qZToFW_agentTeamsThink",
-			"historicPill": "qZToFW_historicPill",
+			"sectionTitle": "qZToFW_sectionTitle",
+			"stageColumn": "qZToFW_stageColumn",
+			"stageConnector": "qZToFW_stageConnector",
+			"stageFlow": "qZToFW_stageFlow",
 			"stageGroup": "qZToFW_stageGroup",
-			"panel": "qZToFW_panel",
-			"inboxContent": "qZToFW_inboxContent"
+			"stageLabel": "qZToFW_stageLabel",
+			"stageLine": "qZToFW_stageLine",
+			"stageTasks": "qZToFW_stageTasks",
+			"stateArt": "qZToFW_stateArt",
+			"taskBadge": "qZToFW_taskBadge",
+			"taskDeps": "qZToFW_taskDeps",
+			"taskEmpty": "qZToFW_taskEmpty",
+			"taskId": "qZToFW_taskId",
+			"taskNode": "qZToFW_taskNode",
+			"taskNodeHead": "qZToFW_taskNodeHead",
+			"taskOwner": "qZToFW_taskOwner",
+			"taskRoute": "qZToFW_taskRoute",
+			"taskStart": "qZToFW_taskStart",
+			"taskSubject": "qZToFW_taskSubject",
+			"team": "qZToFW_team",
+			"teamHead": "qZToFW_teamHead",
+			"teamName": "qZToFW_teamName",
+			"teamStats": "qZToFW_teamStats",
+			"teams": "qZToFW_teams",
+			"unclaimed": "qZToFW_unclaimed",
+			"unclaimedTitle": "qZToFW_unclaimedTitle",
+			"unreadPill": "qZToFW_unreadPill"
 		};
 		//#endregion
 		//#region lib/client/ActivityPanel.js

package/lib/state.js

@@ -12,7 +12,7 @@
  * `fs` service offers no directory deletion.
  * @module dsh-agent-teams/state
  */
-import { randomUUID } from 'node:crypto';
+import { createHash, randomUUID } from 'node:crypto';
 import { mkdir, readFile, readdir, rename, rm, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 /** Mailbox key of the captain. */
@@ -38,14 +38,41 @@ export async function withTeamLock(key, fn) {
         release();
     }
 }
+/** Longest key emitted before truncating and appending a digest. */
+const MAX_KEY_LENGTH = 48;
+/** Short stable digest, used to keep otherwise-colliding keys distinct. */
+function keyDigest(name) {
+    return createHash('sha256').update(name).digest('hex').slice(0, 8);
+}
 /**
  * Fold a free-form name into a safe path/key segment.
+ *
+ * Unicode letters and digits survive, so CJK/Cyrillic/Greek names stay
+ * distinct and readable; everything else — spaces, punctuation, path
+ * separators, control characters — folds to `-`. An ASCII-only whitelist
+ * mapped *every* non-Latin name onto one shared fallback, which silently
+ * merged their mailboxes and rejected the second such member as a duplicate.
+ *
+ * A name with no letters or digits at all (pure emoji or punctuation) cannot
+ * yield a readable key, so it gets a digest rather than a shared constant.
+ * Over-long names are truncated with a digest appended, so names sharing a
+ * long prefix stay distinct and the result stays within filesystem limits
+ * (CJK costs 3 bytes per character in UTF-8).
+ *
  * @param name - any user-supplied name.
- * @returns lowercase `[a-z0-9-]` key, never empty.
+ * @returns a non-empty key safe as a single path segment.
  */
 export function sanitizeKey(name) {
-    const cleaned = name.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
-    return cleaned === '' ? 'team' : cleaned;
+    const cleaned = name.normalize('NFC').trim().toLowerCase()
+        .replace(/[^\p{L}\p{N}]+/gu, '-')
+        .replace(/^-+|-+$/g, '');
+    if (cleaned === '')
+        return `k-${keyDigest(name)}`;
+    const points = [...cleaned];
+    if (points.length > MAX_KEY_LENGTH) {
+        return `${points.slice(0, MAX_KEY_LENGTH).join('')}-${keyDigest(name)}`;
+    }
+    return cleaned;
 }
 /**
  * Whether `dependencies` are all satisfied (every named task exists and

package/lib/types/state.d.ts

@@ -24,8 +24,21 @@ export declare const CAPTAIN_KEY = "captain";
 export declare function withTeamLock<T>(key: string, fn: () => Promise<T>): Promise<T>;
 /**
  * Fold a free-form name into a safe path/key segment.
+ *
+ * Unicode letters and digits survive, so CJK/Cyrillic/Greek names stay
+ * distinct and readable; everything else — spaces, punctuation, path
+ * separators, control characters — folds to `-`. An ASCII-only whitelist
+ * mapped *every* non-Latin name onto one shared fallback, which silently
+ * merged their mailboxes and rejected the second such member as a duplicate.
+ *
+ * A name with no letters or digits at all (pure emoji or punctuation) cannot
+ * yield a readable key, so it gets a digest rather than a shared constant.
+ * Over-long names are truncated with a digest appended, so names sharing a
+ * long prefix stay distinct and the result stays within filesystem limits
+ * (CJK costs 3 bytes per character in UTF-8).
+ *
  * @param name - any user-supplied name.
- * @returns lowercase `[a-z0-9-]` key, never empty.
+ * @returns a non-empty key safe as a single path segment.
  */
 export declare function sanitizeKey(name: string): string;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanmicoder/dsh-agent-teams",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "AgentTeams for DeepSeek Harness: multi-agent team collaboration (captain, members, tasks with dependencies, messaging) driven by natural language, with a tree monitor in the web GUI",
   "type": "module",
   "main": "lib/index.js",