@ran-sh/dsh-crew 0.5.1 → 0.5.3

package/docs/ui-surfaces.md

@@ -12,7 +12,7 @@ management:
 - Worker and Reviewer policy
 - model priority, fallback, review, and adaptive routing
 - runtime and activation-boundary information
-- Codex and Claude installation actions and structured readiness
+- Codex, Claude, and ZCode installation actions and structured readiness
 - task status and bounded model-invocation summaries
 - the link to the underlying 3210 Crew Harness
 
@@ -44,4 +44,3 @@ the full control plane and never becomes `READY`.
 
 The split changes presentation only. Crew state, credentials, routing policy,
 and model execution remain isolated under the Crew-owned home and profile.
-

package/lib/client.js

@@ -192,6 +192,7 @@ function bridgeState(surface) {
 function projectHostReadiness({ installStatus, runtime, surface } = {}) {
 	const codex = installStatus?.codex;
 	const claude = installStatus?.claude;
+	const zcode = installStatus?.zcode;
 	return [
 		{
 			id: "codex_mcp",
@@ -214,6 +215,18 @@ function projectHostReadiness({ installStatus, runtime, surface } = {}) {
 				"permissions"
 			])
 		},
+		{
+			id: "zcode_mcp",
+			state: componentState(zcode, [
+				"mcp",
+				"policy",
+				"worker_agent",
+				"reviewer_agent",
+				"config_prompt",
+				"status_prompt",
+				"ownership"
+			])
+		},
 		{
 			id: "crew_harness",
 			state: runtimeState(runtime),
@@ -354,7 +367,7 @@ const COPY = {
 		jobCount: (count) => `${count} 个任务`,
 		runningCount: (count) => `${count} 个运行中`,
 		sectionNames: {
-			integrations: "Codex / Claude 集成状态",
+			integrations: "Codex / Claude / ZCode 集成状态",
 			workflow: "Crew 工作流设置",
 			flash: "Worker / Flash",
 			pro: "Reviewer / Pro",
@@ -374,6 +387,7 @@ const COPY = {
 			ds_worker: "ds-worker",
 			ds_reviewer: "ds-reviewer",
 			claude_plugin: "Claude plugin",
+			zcode_mcp: "ZCode MCP",
 			crew_harness: "Crew Harness",
 			official_bridge: "Official bridge"
 		},
@@ -602,6 +616,11 @@ const COPY = {
 				install: "把 ds-flash / ds-pro 角色和 /dsh-config、/dsh-status 命令复制到 ~/.codex/（MCP 路径按本机自动渲染，含 approve 审批与超时配置）",
 				update: "重新渲染并覆盖角色文件与命令（插件路径或配置变更后用）；原文件先备份",
 				restore: "删除 ~/.codex/ 下的 ds-flash / ds-pro 角色与 dsh 命令文件（角色文件先备份）"
+			},
+			zcode: {
+				install: "安装 ZCode 全局规则、ds-worker / ds-reviewer 角色、命令和按来源选择的 MCP 配置到 ~/.zcode/",
+				update: "重新渲染 ZCode 角色、命令和 MCP 条目；保留个人文件与其他 MCP 服务",
+				restore: "仅移除 dsh-crew 管理的 ZCode 文件和 MCP 条目（保留备份）"
 			}
 		}
 	},
@@ -627,7 +646,7 @@ const COPY = {
 		jobCount: (count) => `${count} jobs`,
 		runningCount: (count) => `${count} running`,
 		sectionNames: {
-			integrations: "Codex / Claude integration status",
+			integrations: "Codex / Claude / ZCode integration status",
 			workflow: "Crew workflow settings",
 			flash: "Worker / Flash",
 			pro: "Reviewer / Pro",
@@ -647,6 +666,7 @@ const COPY = {
 			ds_worker: "ds-worker",
 			ds_reviewer: "ds-reviewer",
 			claude_plugin: "Claude plugin",
+			zcode_mcp: "ZCode MCP",
 			crew_harness: "Crew Harness",
 			official_bridge: "Official bridge"
 		},
@@ -875,6 +895,11 @@ const COPY = {
 				install: "Copy ds-flash / ds-pro roles and /dsh-config, /dsh-status prompts into ~/.codex/ (MCP paths rendered for this machine, approve mode + timeout included)",
 				update: "Re-render and overwrite role files and prompts (after path/config changes); originals backed up",
 				restore: "Delete ds-flash / ds-pro roles and dsh prompts from ~/.codex/ (roles backed up first)"
+			},
+			zcode: {
+				install: "Install the ZCode global policy, ds-worker / ds-reviewer agents, commands and source-aware MCP config under ~/.zcode/",
+				update: "Re-render ZCode agents, commands and MCP entry; user files and unrelated MCP servers are preserved",
+				restore: "Remove only dsh-crew-owned ZCode files and MCP entry (backups kept)"
 			}
 		}
 	}
@@ -1879,6 +1904,10 @@ function WorkersPanel({ ctx }) {
 									style: S.chip(!!status?.claude?.ready),
 									children: ["Claude ", status?.claude?.ready ? "READY" : "CHECK"]
 								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+									style: S.chip(!!status?.zcode?.ready),
+									children: ["ZCode ", status?.zcode?.ready ? "READY" : "CHECK"]
+								}),
 								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 									style: S.chip(jobs.some((job) => job.status === "running")),
 									children: [jobs.filter((job) => job.status === "running").length, " running"]
@@ -1954,7 +1983,7 @@ function WorkersPanel({ ctx }) {
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollapsibleSection, {
 				sectionId: "integrations",
 				title: copy.sectionNames.integrations,
-				summary: sectionSummary(status?.claude?.ready ? "Claude READY" : "Claude CHECK", status?.codex?.ready ? "Codex READY" : "Codex CHECK"),
+				summary: sectionSummary(status?.claude?.ready ? "Claude READY" : "Claude CHECK", `${status?.codex?.ready ? "Codex READY" : "Codex CHECK"} · ${status?.zcode?.ready ? "ZCode READY" : "ZCode CHECK"}`),
 				expanded: !!expandedSections.integrations,
 				onToggle: () => toggleSection("integrations"),
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -2023,7 +2052,15 @@ function WorkersPanel({ ctx }) {
 								opacity: .6
 							},
 							children: (status?.codex?.missing ?? []).join(" · ")
-						}), "codex", "codex-uninstall", copy.tips.codex)
+						}), "codex", "codex-uninstall", copy.tips.codex),
+						integrationRow("ZCode", !!status?.zcode?.installed, !!status?.zcode?.ready, status?.zcode?.ready ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							title: (status?.zcode?.missing ?? []).join(", "),
+							style: {
+								fontSize: 11,
+								opacity: .6
+							},
+							children: (status?.zcode?.missing ?? []).join(" · ")
+						}), "zcode", "zcode-uninstall", copy.tips.zcode)
 					]
 				})
 			}),

package/official-web-bridge/lib/client.js

@@ -192,6 +192,7 @@ function bridgeState(surface) {
 function projectHostReadiness({ installStatus, runtime, surface } = {}) {
 	const codex = installStatus?.codex;
 	const claude = installStatus?.claude;
+	const zcode = installStatus?.zcode;
 	return [
 		{
 			id: "codex_mcp",
@@ -214,6 +215,18 @@ function projectHostReadiness({ installStatus, runtime, surface } = {}) {
 				"permissions"
 			])
 		},
+		{
+			id: "zcode_mcp",
+			state: componentState(zcode, [
+				"mcp",
+				"policy",
+				"worker_agent",
+				"reviewer_agent",
+				"config_prompt",
+				"status_prompt",
+				"ownership"
+			])
+		},
 		{
 			id: "crew_harness",
 			state: runtimeState(runtime),
@@ -354,7 +367,7 @@ const COPY = {
 		jobCount: (count) => `${count} 个任务`,
 		runningCount: (count) => `${count} 个运行中`,
 		sectionNames: {
-			integrations: "Codex / Claude 集成状态",
+			integrations: "Codex / Claude / ZCode 集成状态",
 			workflow: "Crew 工作流设置",
 			flash: "Worker / Flash",
 			pro: "Reviewer / Pro",
@@ -374,6 +387,7 @@ const COPY = {
 			ds_worker: "ds-worker",
 			ds_reviewer: "ds-reviewer",
 			claude_plugin: "Claude plugin",
+			zcode_mcp: "ZCode MCP",
 			crew_harness: "Crew Harness",
 			official_bridge: "Official bridge"
 		},
@@ -602,6 +616,11 @@ const COPY = {
 				install: "把 ds-flash / ds-pro 角色和 /dsh-config、/dsh-status 命令复制到 ~/.codex/（MCP 路径按本机自动渲染，含 approve 审批与超时配置）",
 				update: "重新渲染并覆盖角色文件与命令（插件路径或配置变更后用）；原文件先备份",
 				restore: "删除 ~/.codex/ 下的 ds-flash / ds-pro 角色与 dsh 命令文件（角色文件先备份）"
+			},
+			zcode: {
+				install: "安装 ZCode 全局规则、ds-worker / ds-reviewer 角色、命令和按来源选择的 MCP 配置到 ~/.zcode/",
+				update: "重新渲染 ZCode 角色、命令和 MCP 条目；保留个人文件与其他 MCP 服务",
+				restore: "仅移除 dsh-crew 管理的 ZCode 文件和 MCP 条目（保留备份）"
 			}
 		}
 	},
@@ -627,7 +646,7 @@ const COPY = {
 		jobCount: (count) => `${count} jobs`,
 		runningCount: (count) => `${count} running`,
 		sectionNames: {
-			integrations: "Codex / Claude integration status",
+			integrations: "Codex / Claude / ZCode integration status",
 			workflow: "Crew workflow settings",
 			flash: "Worker / Flash",
 			pro: "Reviewer / Pro",
@@ -647,6 +666,7 @@ const COPY = {
 			ds_worker: "ds-worker",
 			ds_reviewer: "ds-reviewer",
 			claude_plugin: "Claude plugin",
+			zcode_mcp: "ZCode MCP",
 			crew_harness: "Crew Harness",
 			official_bridge: "Official bridge"
 		},
@@ -875,6 +895,11 @@ const COPY = {
 				install: "Copy ds-flash / ds-pro roles and /dsh-config, /dsh-status prompts into ~/.codex/ (MCP paths rendered for this machine, approve mode + timeout included)",
 				update: "Re-render and overwrite role files and prompts (after path/config changes); originals backed up",
 				restore: "Delete ds-flash / ds-pro roles and dsh prompts from ~/.codex/ (roles backed up first)"
+			},
+			zcode: {
+				install: "Install the ZCode global policy, ds-worker / ds-reviewer agents, commands and source-aware MCP config under ~/.zcode/",
+				update: "Re-render ZCode agents, commands and MCP entry; user files and unrelated MCP servers are preserved",
+				restore: "Remove only dsh-crew-owned ZCode files and MCP entry (backups kept)"
 			}
 		}
 	}
@@ -1879,6 +1904,10 @@ function WorkersPanel({ ctx }) {
 									style: S.chip(!!status?.claude?.ready),
 									children: ["Claude ", status?.claude?.ready ? "READY" : "CHECK"]
 								}),
+								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+									style: S.chip(!!status?.zcode?.ready),
+									children: ["ZCode ", status?.zcode?.ready ? "READY" : "CHECK"]
+								}),
 								/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 									style: S.chip(jobs.some((job) => job.status === "running")),
 									children: [jobs.filter((job) => job.status === "running").length, " running"]
@@ -1954,7 +1983,7 @@ function WorkersPanel({ ctx }) {
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollapsibleSection, {
 				sectionId: "integrations",
 				title: copy.sectionNames.integrations,
-				summary: sectionSummary(status?.claude?.ready ? "Claude READY" : "Claude CHECK", status?.codex?.ready ? "Codex READY" : "Codex CHECK"),
+				summary: sectionSummary(status?.claude?.ready ? "Claude READY" : "Claude CHECK", `${status?.codex?.ready ? "Codex READY" : "Codex CHECK"} · ${status?.zcode?.ready ? "ZCode READY" : "ZCode CHECK"}`),
 				expanded: !!expandedSections.integrations,
 				onToggle: () => toggleSection("integrations"),
 				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -2023,7 +2052,15 @@ function WorkersPanel({ ctx }) {
 								opacity: .6
 							},
 							children: (status?.codex?.missing ?? []).join(" · ")
-						}), "codex", "codex-uninstall", copy.tips.codex)
+						}), "codex", "codex-uninstall", copy.tips.codex),
+						integrationRow("ZCode", !!status?.zcode?.installed, !!status?.zcode?.ready, status?.zcode?.ready ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							title: (status?.zcode?.missing ?? []).join(", "),
+							style: {
+								fontSize: 11,
+								opacity: .6
+							},
+							children: (status?.zcode?.missing ?? []).join(" · ")
+						}), "zcode", "zcode-uninstall", copy.tips.zcode)
 					]
 				})
 			}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ran-sh/dsh-crew",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "type": "module",
   "main": "./src/hub/entry.mjs",
   "bin": {
@@ -126,6 +126,8 @@
     "deepseek",
     "claude-code",
     "codex",
+    "zcode",
+    "windows",
     "subagent",
     "worker",
     "multimodal",
@@ -140,8 +142,10 @@
     "agents",
     "commands",
     "codex",
+    "zcode",
     "statusline",
     "official-web-bridge",
+    "windows",
     "cordis.patch.yml",
     "worker.cordis.yml",
     ".claude-plugin",
@@ -152,6 +156,7 @@
     "docs/readiness-matrix.md",
     "docs/gpt-relay-extension.md",
     "docs/ui-surfaces.md",
+    "docs/installation.md",
     "docs/images/dsh-crew-logo.png",
     "docs/images/dsh-crew-overview.png",
     "docs/images/dsh-crew-host.png",

package/scripts/setup.mjs

@@ -23,20 +23,57 @@ import {
 
 const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 
-function commandExists(name) {
-  const r = spawnSync(/^win/.test(process.platform) ? 'where' : 'which', [name], {
+function commandExists(name) {
+  const r = spawnSync(/^win/.test(process.platform) ? 'where' : 'which', [name], {
     encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'],
   });
-  return r.status === 0;
-}
-
-function run(cmd, args, opts = {}) {
-  const r = spawnSync(cmd, args, {
-    encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], shell: opts.shell === true, cwd: opts.cwd ?? ROOT,
-    env: opts.env ?? process.env,
-  });
-  return { ok: r.status === 0, status: r.status ?? -1, stdout: r.stdout ?? '', stderr: r.stderr ?? '' };
-}
+  return r.status === 0;
+}
+
+const PACKAGE_MANAGER_COMMAND = /^(?:npm|npx|pnpm|yarn|yarnpkg|bun|bunx)$/i;
+
+export function spawnCommand(command, platform = process.platform) {
+  if (platform === 'win32' && PACKAGE_MANAGER_COMMAND.test(command)) {
+    return `${command}.cmd`;
+  }
+  return command;
+}
+
+export function spawnNeedsShell(command, platform = process.platform) {
+  return platform === 'win32' && PACKAGE_MANAGER_COMMAND.test(command);
+}
+
+export function spawnInvocation(command, args = [], platform = process.platform, environment = process.env) {
+  const executable = spawnCommand(command, platform);
+  if (!spawnNeedsShell(command, platform)) return { command: executable, args };
+  const unsafe = args.find((arg) => !/^[A-Za-z0-9@._:+/=\-]+$/.test(String(arg)));
+  if (unsafe !== undefined) throw new Error(`unsafe package-manager argument: ${unsafe}`);
+  return {
+    command: environment.ComSpec || 'cmd.exe',
+    args: ['/d', '/s', '/c', [executable, ...args].join(' ')],
+  };
+}
+
+function run(cmd, args, opts = {}) {
+  let invocation;
+  try {
+    invocation = spawnInvocation(cmd, args);
+  } catch (error) {
+    return { ok: false, status: -1, stdout: '', stderr: String(error?.message ?? error), error };
+  }
+  const r = spawnSync(invocation.command, invocation.args, {
+    encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], shell: opts.shell === true, cwd: opts.cwd ?? ROOT,
+    env: opts.env ?? process.env,
+  });
+  const processError = r.error ? `${r.error.name}: ${r.error.message}` : '';
+  return {
+    ok: r.status === 0,
+    status: r.status ?? -1,
+    stdout: r.stdout ?? '',
+    stderr: r.stderr || processError,
+    error: r.error ?? null,
+  };
+}
 
 /**
  * Detect the DSH CLI. `allowDownload` is intentionally opt-in: installation
@@ -106,18 +143,18 @@ export async function setupInstall({
   installer = realInstaller,
   depRunner = null,
 } = {}) {
-  log('DSH Crew installer');
-  if (!checkRoot(root)) return { ok: false, error: `not a dsh-crew checkout: ${root}` };
-
-  if (depRunner) {
+  log('DSH Crew installer');
+  if (!checkRoot(root)) return { ok: false, error: `not a dsh-crew checkout: ${root}` };
+  const pnpmOk = commandExists('pnpm');
+
+  if (depRunner) {
     const r = depRunner(root);
     if (!r.ok) { mark(log, false, r.text); return { ok: false, error: r.text }; }
     mark(log, true, r.text);
-  } else if (!dryRun) {
-    const pnpmOk = commandExists('pnpm');
-    const cmd = pnpmOk ? 'pnpm' : 'npx';
+  } else if (!dryRun) {
+    const cmd = pnpmOk ? 'pnpm' : 'npx';
     const baseArgs = pnpmOk ? [] : ['-y', 'pnpm'];
-    const d = run(cmd, [...baseArgs, 'install', '--frozen-lockfile']);
+    const d = run(cmd, [...baseArgs, 'install', '--frozen-lockfile'], { cwd: root });
     if (!d.ok) {
       if (depsPresent(root)) mark(log, true, `dependencies (already present; install skipped — ${(d.stderr || d.stdout || '').trim().split('\n')[0]})`);
       else {
@@ -126,9 +163,11 @@ export async function setupInstall({
       }
     } else mark(log, true, 'dependencies');
   } else mark(log, true, 'dependencies (dry-run)');
-
-  if (!dryRun) {
-    const b = run('npx --no-install tsdown src/client/index.tsx --format cjs --platform browser --target es2022 --tsconfig tsconfig.client.json --deps.never-bundle react --deps.never-bundle react/jsx-runtime --deps.never-bundle react-dom --deps.never-bundle react-dom/client --out-dir .client-build --clean --logLevel warn && node scripts/build-client.mjs', [], { shell: true });
+
+  if (!dryRun) {
+    const b = pnpmOk
+      ? run('pnpm', ['run', 'build:client'], { cwd: root })
+      : run('npx', ['-y', 'pnpm', 'run', 'build:client'], { cwd: root });
     if (!b.ok) {
       log(`✗ client build failed:\n${(b.stderr || b.stdout || '').slice(0, 600)}`);
       return { ok: false, error: 'client build failed' };
@@ -167,12 +206,36 @@ export async function setupInstall({
     mark(log, true, `DSH crew profile linked offline (dedicated Crew DSH_HOME, profile dsh-crew; ${registration.changed ? 'updated' : 'already current'})`);
   }
 
-  if (dryRun) mark(log, true, 'Codex Desktop integration (dry-run)');
-  else {
+  if (dryRun) mark(log, true, 'Codex Desktop integration (dry-run)');
+  else {
     const r = installer.installCodex ? installer.installCodex({ home }) : realInstaller.installCodex({ home });
     mark(log, r.ok !== false, r.ok === false ? `Codex Desktop integration failed: ${(r.actions ?? []).join('; ')}` : 'Codex Desktop integration');
-    if (r.ok === false) return { ok: false, error: 'Codex integration failed' };
-  }
+    if (r.ok === false) return { ok: false, error: 'Codex integration failed' };
+  }
+
+  if (dryRun) mark(log, true, 'ZCode integration (dry-run)');
+  else {
+    const r = installer.installZCode
+      ? installer.installZCode({ home, root })
+      : realInstaller.installZCode({ home, root });
+    if (r.ok === false) {
+      mark(log, false, `ZCode integration failed (${r.code ?? 'unknown'})`);
+      return { ok: false, error: 'ZCode integration failed' };
+    }
+    mark(log, true, 'ZCode integration');
+  }
+
+  if (dryRun) mark(log, true, 'Windows login startup (dry-run)');
+  else {
+    const r = installer.installWindowsStartup
+      ? installer.installWindowsStartup({ home, root })
+      : realInstaller.installWindowsStartup({ home, root });
+    if (r.ok === false) {
+      mark(log, false, `Windows login startup failed (${r.code ?? 'unknown'})`);
+      return { ok: false, error: 'Windows login startup failed' };
+    }
+    if (r.supported) mark(log, true, 'Windows login startup');
+  }
 
   if (commandExists('claude')) {
     if (dryRun) mark(log, true, 'Claude Code integration (dry-run)');
@@ -203,17 +266,31 @@ export async function setupUninstall({
   const fail = (name, text) => { mark(log, false, text || `${name} failed`); failures.push(name); };
 
   if (dryRun) {
-    mark(log, true, 'Codex Desktop integration would be removed');
-    mark(log, true, 'Claude Code integration would be removed');
-    mark(log, true, 'DSH crew profile would be removed');
+    mark(log, true, 'Codex Desktop integration would be removed');
+    mark(log, true, 'ZCode integration would be removed');
+    mark(log, true, 'Claude Code integration would be removed');
+    mark(log, true, 'Windows login startup would be removed');
+    mark(log, true, 'DSH crew profile would be removed');
   } else {
     const cx = installer.uninstallCodex ? installer.uninstallCodex({ home }) : realInstaller.uninstallCodex({ home });
-    if (cx.ok !== false) mark(log, true, 'Codex Desktop integration removed');
-    else fail('codex', 'Codex Desktop integration removal failed');
+    if (cx.ok !== false) mark(log, true, 'Codex Desktop integration removed');
+    else fail('codex', 'Codex Desktop integration removal failed');
+
+    const zc = installer.uninstallZCode
+      ? installer.uninstallZCode({ home, root })
+      : realInstaller.uninstallZCode({ home, root });
+    if (zc.ok !== false) mark(log, true, 'ZCode integration removed');
+    else fail('zcode', 'ZCode integration removal failed');
 
-    const cl = installer.uninstallClaudeCode ? installer.uninstallClaudeCode({ home }) : realInstaller.uninstallClaudeCode({ home });
-    if (cl.ok !== false) mark(log, true, 'Claude Code integration removed');
-    else fail('claude', 'Claude Code integration removal failed');
+    const cl = installer.uninstallClaudeCode ? installer.uninstallClaudeCode({ home }) : realInstaller.uninstallClaudeCode({ home });
+    if (cl.ok !== false) mark(log, true, 'Claude Code integration removed');
+    else fail('claude', 'Claude Code integration removal failed');
+
+    const startup = installer.uninstallWindowsStartup
+      ? installer.uninstallWindowsStartup({ home })
+      : realInstaller.uninstallWindowsStartup({ home });
+    if (startup.ok === false) fail('startup', 'Windows login startup removal failed');
+    else if (startup.supported) mark(log, true, 'Windows login startup removed');
 
     const name = readPackageName(root);
     if (!name) fail('dsh', 'DSH plugin removal failed: package name missing');
@@ -243,9 +320,15 @@ export async function setupUninstall({
 }
 
 export async function setupStatus({ log = console.log, root = ROOT, home = homedir(), installer = realInstaller } = {}) {
-  const st = installer.installStatus ? installer.installStatus({ home }) : realInstaller.installStatus({ home });
-  const claude = st?.claude?.installed ? 'installed' : 'not installed';
-  const codex = st?.codex?.installed ? 'installed' : 'not installed';
+  const st = installer.installStatus ? installer.installStatus({ home, root }) : realInstaller.installStatus({ home, root });
+  const claude = st?.claude?.installed ? 'installed' : 'not installed';
+  const codex = st?.codex?.installed ? 'installed' : 'not installed';
+  const zcode = st?.zcode?.installed ? 'installed' : 'not installed';
+  const startupState = installer.windowsStartupStatus
+    ? installer.windowsStartupStatus({ home })
+    : realInstaller.windowsStartupStatus({ home });
+  const windowsStartup = !startupState.supported ? 'not supported'
+    : startupState.ready ? 'installed' : startupState.installed ? 'needs repair' : 'not installed';
   // Crew status reads ONLY the dedicated Crew profile under the Crew DSH_HOME;
   // the official web profile layout under the default DSH home is intentionally
   // never inspected.
@@ -260,10 +343,12 @@ export async function setupStatus({ log = console.log, root = ROOT, home = homed
     } catch { dshPlugin = 'unknown'; }
   }
   log(`DSH plugin: ${dshPlugin} (dedicated dsh-crew profile; official web profile ignored)`);
-  log(`Codex Desktop integration: ${codex}`);
-  log(`Claude Code integration: ${claude}`);
-  return { ok: true, dshPlugin, codex, claude };
-}
+  log(`Codex Desktop integration: ${codex}`);
+  log(`ZCode integration: ${zcode}`);
+  log(`Claude Code integration: ${claude}`);
+  log(`Windows login startup: ${windowsStartup}`);
+  return { ok: true, dshPlugin, codex, zcode, claude, windowsStartup };
+}
 
 export async function runSetupCli({ argv = process.argv.slice(2), run: actions = {}, log = console.log } = {}) {
   const action = argv[0];

package/src/client/host-readiness.mjs

@@ -33,13 +33,14 @@ function bridgeState(surface) {
 export function projectHostReadiness({ installStatus, runtime, surface } = {}) {
   const codex = installStatus?.codex;
   const claude = installStatus?.claude;
+  const zcode = installStatus?.zcode;
   return [
     { id: 'codex_mcp', state: componentState(codex, ['mcp'], { aligned: true }) },
     { id: 'ds_worker', state: componentState(codex, ['worker_role'], { aligned: true }) },
     { id: 'ds_reviewer', state: componentState(codex, ['reviewer_role'], { aligned: true }) },
     { id: 'claude_plugin', state: componentState(claude, ['enabled', 'marketplace', 'snapshot', 'permissions']) },
+    { id: 'zcode_mcp', state: componentState(zcode, ['mcp', 'policy', 'worker_agent', 'reviewer_agent', 'config_prompt', 'status_prompt', 'ownership']) },
     { id: 'crew_harness', state: runtimeState(runtime), detail: runtime?.runtime_version ?? null },
     { id: 'official_bridge', state: bridgeState(surface) },
   ];
 }
-

package/src/client/index.tsx

@@ -52,11 +52,11 @@ const COPY = {
     expandAll: '全部展开', collapseAll: '全部折叠',
     modelCount: (count: number) => `${count} 个模型`, providerCount: (count: number) => `${count} 个 Provider`,
     jobCount: (count: number) => `${count} 个任务`, runningCount: (count: number) => `${count} 个运行中`,
-    sectionNames: { integrations: 'Codex / Claude 集成状态', workflow: 'Crew 工作流设置', flash: 'Worker / Flash', pro: 'Reviewer / Pro', dispatch: '模型优先级与派发', adaptive: '自适应路由', runtime: '运行 / 生效边界', multimodal: '视觉与生图', providers: '自定义 Provider', jobs: '任务状态' },
+    sectionNames: { integrations: 'Codex / Claude / ZCode 集成状态', workflow: 'Crew 工作流设置', flash: 'Worker / Flash', pro: 'Reviewer / Pro', dispatch: '模型优先级与派发', adaptive: '自适应路由', runtime: '运行 / 生效边界', multimodal: '视觉与生图', providers: '自定义 Provider', jobs: '任务状态' },
     openHarness: '打开 3210 Crew Harness →',
     harnessHint: '底层 Provider、Harness Models 与运行时配置',
     hostReadiness: '宿主集成就绪度', hostReadinessHint: '只使用结构化安装与运行时证据；缺少证据不会显示 READY。',
-    readinessLabels: { codex_mcp: 'Codex MCP', ds_worker: 'ds-worker', ds_reviewer: 'ds-reviewer', claude_plugin: 'Claude plugin', crew_harness: 'Crew Harness', official_bridge: 'Official bridge' },
+    readinessLabels: { codex_mcp: 'Codex MCP', ds_worker: 'ds-worker', ds_reviewer: 'ds-reviewer', claude_plugin: 'Claude plugin', zcode_mcp: 'ZCode MCP', crew_harness: 'Crew Harness', official_bridge: 'Official bridge' },
     readinessStates: { READY: 'READY', DEGRADED: 'DEGRADED', UNAVAILABLE: 'UNAVAILABLE', UNKNOWN: 'UNKNOWN' },
     globalHint: '修改即时保存到 ~/.config/dsh-crew/config.json；CC / Codex 的新会话自动读取为默认值（会话内可用 /dsh-crew:config 临时覆盖）。',
     orchestration: 'Agent 编排',
@@ -154,11 +154,16 @@ const COPY = {
         update: '重跑安装流程：刷新注册与权限、迁移旧格式配置、更新 HUD 接线；幂等，可放心点',
         restore: '从 Claude Code 移除集成：清除 marketplace 注册、插件启用项与权限规则（settings 先备份）；不删除插件源码与已跑任务',
       },
-      codex: {
-        install: '把 ds-flash / ds-pro 角色和 /dsh-config、/dsh-status 命令复制到 ~/.codex/（MCP 路径按本机自动渲染，含 approve 审批与超时配置）',
-        update: '重新渲染并覆盖角色文件与命令（插件路径或配置变更后用）；原文件先备份',
-        restore: '删除 ~/.codex/ 下的 ds-flash / ds-pro 角色与 dsh 命令文件（角色文件先备份）',
-      },
+      codex: {
+        install: '把 ds-flash / ds-pro 角色和 /dsh-config、/dsh-status 命令复制到 ~/.codex/（MCP 路径按本机自动渲染，含 approve 审批与超时配置）',
+        update: '重新渲染并覆盖角色文件与命令（插件路径或配置变更后用）；原文件先备份',
+        restore: '删除 ~/.codex/ 下的 ds-flash / ds-pro 角色与 dsh 命令文件（角色文件先备份）',
+      },
+      zcode: {
+        install: '安装 ZCode 全局规则、ds-worker / ds-reviewer 角色、命令和按来源选择的 MCP 配置到 ~/.zcode/',
+        update: '重新渲染 ZCode 角色、命令和 MCP 条目；保留个人文件与其他 MCP 服务',
+        restore: '仅移除 dsh-crew 管理的 ZCode 文件和 MCP 条目（保留备份）',
+      },
     },
   },
   en: {
@@ -173,11 +178,11 @@ const COPY = {
     expandAll: 'Expand all', collapseAll: 'Collapse all',
     modelCount: (count: number) => `${count} models`, providerCount: (count: number) => `${count} providers`,
     jobCount: (count: number) => `${count} jobs`, runningCount: (count: number) => `${count} running`,
-    sectionNames: { integrations: 'Codex / Claude integration status', workflow: 'Crew workflow settings', flash: 'Worker / Flash', pro: 'Reviewer / Pro', dispatch: 'Model priority & dispatch', adaptive: 'Adaptive routing', runtime: 'Runtime / activation boundaries', multimodal: 'Vision & image generation', providers: 'Custom providers', jobs: 'Task status' },
+    sectionNames: { integrations: 'Codex / Claude / ZCode integration status', workflow: 'Crew workflow settings', flash: 'Worker / Flash', pro: 'Reviewer / Pro', dispatch: 'Model priority & dispatch', adaptive: 'Adaptive routing', runtime: 'Runtime / activation boundaries', multimodal: 'Vision & image generation', providers: 'Custom providers', jobs: 'Task status' },
     openHarness: 'Open 3210 Crew Harness →',
     harnessHint: 'Low-level providers, Harness Models, and runtime configuration',
     hostReadiness: 'Host integration readiness', hostReadinessHint: 'Uses structured installer and runtime evidence only; missing evidence is never READY.',
-    readinessLabels: { codex_mcp: 'Codex MCP', ds_worker: 'ds-worker', ds_reviewer: 'ds-reviewer', claude_plugin: 'Claude plugin', crew_harness: 'Crew Harness', official_bridge: 'Official bridge' },
+    readinessLabels: { codex_mcp: 'Codex MCP', ds_worker: 'ds-worker', ds_reviewer: 'ds-reviewer', claude_plugin: 'Claude plugin', zcode_mcp: 'ZCode MCP', crew_harness: 'Crew Harness', official_bridge: 'Official bridge' },
     readinessStates: { READY: 'READY', DEGRADED: 'DEGRADED', UNAVAILABLE: 'UNAVAILABLE', UNKNOWN: 'UNKNOWN' },
     globalHint: 'Changes save instantly to ~/.config/dsh-crew/config.json; new CC / Codex sessions pick them up as defaults (override per session with /dsh-crew:config).',
     orchestration: 'Agent orchestration',
@@ -275,11 +280,16 @@ const COPY = {
         update: 'Re-run the installer: refresh registration & permissions, migrate legacy config, update HUD wiring; idempotent',
         restore: 'Remove the integration from Claude Code: marketplace registration, plugin enablement and permission rules (settings backed up); plugin source and past jobs untouched',
       },
-      codex: {
-        install: 'Copy ds-flash / ds-pro roles and /dsh-config, /dsh-status prompts into ~/.codex/ (MCP paths rendered for this machine, approve mode + timeout included)',
-        update: 'Re-render and overwrite role files and prompts (after path/config changes); originals backed up',
-        restore: 'Delete ds-flash / ds-pro roles and dsh prompts from ~/.codex/ (roles backed up first)',
-      },
+      codex: {
+        install: 'Copy ds-flash / ds-pro roles and /dsh-config, /dsh-status prompts into ~/.codex/ (MCP paths rendered for this machine, approve mode + timeout included)',
+        update: 'Re-render and overwrite role files and prompts (after path/config changes); originals backed up',
+        restore: 'Delete ds-flash / ds-pro roles and dsh prompts from ~/.codex/ (roles backed up first)',
+      },
+      zcode: {
+        install: 'Install the ZCode global policy, ds-worker / ds-reviewer agents, commands and source-aware MCP config under ~/.zcode/',
+        update: 'Re-render ZCode agents, commands and MCP entry; user files and unrelated MCP servers are preserved',
+        restore: 'Remove only dsh-crew-owned ZCode files and MCP entry (backups kept)',
+      },
     },
   },
 };
@@ -817,6 +827,7 @@ function WorkersPanel({ ctx }: { ctx: any }) {
           <div style={{ display: 'flex', gap: 6, marginTop: 8, flexWrap: 'wrap' }}>
             <span style={S.chip(!!status?.codex?.ready)}>Codex {status?.codex?.ready ? 'READY' : 'CHECK'}</span>
             <span style={S.chip(!!status?.claude?.ready)}>Claude {status?.claude?.ready ? 'READY' : 'CHECK'}</span>
+            <span style={S.chip(!!status?.zcode?.ready)}>ZCode {status?.zcode?.ready ? 'READY' : 'CHECK'}</span>
             <span style={S.chip(jobs.some((job) => job.status === 'running'))}>{jobs.filter((job) => job.status === 'running').length} running</span>
           </div>
         </div>
@@ -836,7 +847,7 @@ function WorkersPanel({ ctx }: { ctx: any }) {
       </div>
 
       <CollapsibleSection sectionId="integrations" title={copy.sectionNames.integrations}
-        summary={sectionSummary(status?.claude?.ready ? 'Claude READY' : 'Claude CHECK', status?.codex?.ready ? 'Codex READY' : 'Codex CHECK')}
+        summary={sectionSummary(status?.claude?.ready ? 'Claude READY' : 'Claude CHECK', `${status?.codex?.ready ? 'Codex READY' : 'Codex CHECK'} · ${status?.zcode?.ready ? 'ZCode READY' : 'ZCode CHECK'}`)}
         expanded={!!expandedSections.integrations} onToggle={() => toggleSection('integrations')}>
         <div style={{ display: 'flex', flexDirection: 'column', gap: 8 }}>
           <div style={S.block}>
@@ -860,6 +871,9 @@ function WorkersPanel({ ctx }: { ctx: any }) {
           {integrationRow('Codex', !!status?.codex?.installed, !!status?.codex?.ready,
             status?.codex?.ready ? null : <span title={(status?.codex?.missing ?? []).join(', ')} style={{ fontSize: 11, opacity: 0.6 }}>{(status?.codex?.missing ?? []).join(' · ')}</span>,
             'codex', 'codex-uninstall', (copy as any).tips.codex)}
+          {integrationRow('ZCode', !!status?.zcode?.installed, !!status?.zcode?.ready,
+            status?.zcode?.ready ? null : <span title={(status?.zcode?.missing ?? []).join(', ')} style={{ fontSize: 11, opacity: 0.6 }}>{(status?.zcode?.missing ?? []).join(' · ')}</span>,
+            'zcode', 'zcode-uninstall', (copy as any).tips.zcode)}
         </div>
       </CollapsibleSection>