ai-worklens-agent 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-worklens-agent",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Employee-side collector agent for AI WorkLens.",
   "type": "module",
   "bin": {

package/src/config.mjs

@@ -2,10 +2,10 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import crypto from "node:crypto";
-import { normalizeCollectionSettings } from "../../collector-protocol/src/collection-settings.mjs";
-import { normalizeClientUpdatePolicy } from "../../collector-protocol/src/client-update-policy.mjs";
-import { normalizeModelInfo } from "../../collector-protocol/src/model-info.mjs";
-import { normalizeToolId } from "../../collector-protocol/src/tool-profiles.mjs";
+import { normalizeCollectionSettings } from "./protocol/collection-settings.mjs";
+import { normalizeClientUpdatePolicy } from "./protocol/client-update-policy.mjs";
+import { normalizeModelInfo } from "./protocol/model-info.mjs";
+import { normalizeToolId } from "./protocol/tool-profiles.mjs";
 
 const DEFAULT_CONFIG_DIR = ".ai-worklens";
 

package/src/event-builder.mjs

@@ -1,5 +1,5 @@
 import path from "node:path";
-import { normalizeCollectorEvent, stableHash } from "../../collector-protocol/src/event-schema.mjs";
+import { normalizeCollectorEvent, stableHash } from "./protocol/event-schema.mjs";
 
 function parseList(value) {
   if (!value) return [];

package/src/hook-smoke.mjs

@@ -3,7 +3,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { loadClientConfig } from "./config.mjs";
 import { normalizeHookPayload } from "./hook-adapter.mjs";
-import { normalizeToolId } from "../../collector-protocol/src/tool-profiles.mjs";
+import { normalizeToolId } from "./protocol/tool-profiles.mjs";
 
 const SAMPLE_PAYLOADS = {
   codex: {

package/src/install.mjs

@@ -4,10 +4,10 @@ import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { writeClientConfig } from "./config.mjs";
-import { getToolProfile, listToolProfiles, normalizeToolId } from "../../collector-protocol/src/tool-profiles.mjs";
+import { getToolProfile, listToolProfiles, normalizeToolId } from "./protocol/tool-profiles.mjs";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const projectRoot = path.resolve(__dirname, "../../..");
+const agentSrcDir = __dirname;
 
 function parseArgs(argv) {
   const result = {};
@@ -32,9 +32,9 @@ export function buildInstallManifest(targetDir, options = {}) {
   const displayTargetDir = displayPath(targetDir);
   const configFile = path.join(displayTargetDir, "client.json");
   const mcpCommand = node;
-  const mcpArgs = [path.join(projectRoot, "packages/client-agent/src/mcp-server.mjs")];
+  const mcpArgs = [path.join(agentSrcDir, "mcp-server.mjs")];
   const hookCommand = node;
-  const hookArgs = [path.join(projectRoot, "packages/client-agent/src/hook-adapter.mjs"), "--config", configFile, "--tool", selectedTool];
+  const hookArgs = [path.join(agentSrcDir, "hook-adapter.mjs"), "--config", configFile, "--tool", selectedTool];
   const artifacts = buildToolArtifacts({
     targetDir,
     displayTargetDir,
@@ -64,7 +64,7 @@ export function buildInstallManifest(targetDir, options = {}) {
     },
     eventCli: {
       command: node,
-      args: [path.join(projectRoot, "packages/client-agent/src/cli.mjs"), "--config", configFile]
+      args: [path.join(agentSrcDir, "cli.mjs"), "--config", configFile]
     },
     generatedFiles: {
       clientConfig: configFile,
@@ -202,7 +202,7 @@ function upperFirst(value) {
 
 function buildToolArtifacts({ targetDir, displayTargetDir, configFile, mcpCommand, mcpArgs }) {
   return Object.fromEntries(listToolProfiles().map((profile) => {
-    const hookArgs = [path.join(projectRoot, "packages/client-agent/src/hook-adapter.mjs"), "--config", configFile, "--tool", profile.id];
+    const hookArgs = [path.join(agentSrcDir, "hook-adapter.mjs"), "--config", configFile, "--tool", profile.id];
     const artifact = {
       profile,
       configFile: path.join(targetDir, profile.configFileName),
@@ -580,7 +580,16 @@ function buildReadme(manifest) {
   ].join("\n") + "\n";
 }
 
-if (fileURLToPath(import.meta.url) === path.resolve(process.argv[1] || "")) {
+function isMainModule() {
+  if (!process.argv[1]) return false;
+  try {
+    return fileURLToPath(import.meta.url) === fs.realpathSync(process.argv[1]);
+  } catch {
+    return fileURLToPath(import.meta.url) === path.resolve(process.argv[1] || "");
+  }
+}
+
+if (isMainModule()) {
   const args = parseArgs(process.argv.slice(2));
   const result = installClient({
     targetDir: args["target-dir"],

package/src/protocol/client-update-policy.mjs

@@ -0,0 +1,49 @@
+export const CLIENT_AGENT_VERSION = "0.1.0";
+
+export const DEFAULT_CLIENT_UPDATE_POLICY = {
+  enabled: true,
+  autoUpdate: true,
+  clientVersion: CLIENT_AGENT_VERSION,
+  artifactRevision: "0.1.0",
+  checkIntervalMinutes: 360,
+  registerBackgroundTask: true,
+  refreshArtifacts: true
+};
+
+export function normalizeClientUpdatePolicy(input = {}, fallback = DEFAULT_CLIENT_UPDATE_POLICY) {
+  const current = { ...DEFAULT_CLIENT_UPDATE_POLICY, ...(fallback || {}) };
+  const version = String(input.clientVersion || input.desiredClientVersion || current.clientVersion || CLIENT_AGENT_VERSION).trim();
+  const revision = String(input.artifactRevision || current.artifactRevision || version).trim();
+  return {
+    ...current,
+    enabled: input.enabled !== undefined ? normalizeBoolean(input.enabled) : current.enabled,
+    autoUpdate: input.autoUpdate !== undefined ? normalizeBoolean(input.autoUpdate) : current.autoUpdate,
+    clientVersion: version || CLIENT_AGENT_VERSION,
+    artifactRevision: revision || version || CLIENT_AGENT_VERSION,
+    checkIntervalMinutes: clampNumber(input.checkIntervalMinutes, 15, 10080, current.checkIntervalMinutes),
+    registerBackgroundTask: input.registerBackgroundTask !== undefined ? normalizeBoolean(input.registerBackgroundTask) : current.registerBackgroundTask,
+    refreshArtifacts: input.refreshArtifacts !== undefined ? normalizeBoolean(input.refreshArtifacts) : current.refreshArtifacts,
+    appliedRevision: input.appliedRevision ? String(input.appliedRevision) : current.appliedRevision || "",
+    lastUpdatedAt: input.lastUpdatedAt ? String(input.lastUpdatedAt) : current.lastUpdatedAt || ""
+  };
+}
+
+export function updateNeeded(configVersion, configUpdate = {}, policy = DEFAULT_CLIENT_UPDATE_POLICY) {
+  const normalized = normalizeClientUpdatePolicy(policy);
+  if (!normalized.enabled || !normalized.autoUpdate) return false;
+  if (String(configVersion || "") !== normalized.clientVersion) return true;
+  if (normalized.refreshArtifacts && String(configUpdate.appliedRevision || "") !== normalized.artifactRevision) return true;
+  return false;
+}
+
+function normalizeBoolean(value) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "string") return !["false", "0", "off", "no"].includes(value.trim().toLowerCase());
+  return Boolean(value);
+}
+
+function clampNumber(value, min, max, fallback) {
+  const number = Number(value);
+  if (!Number.isFinite(number)) return fallback;
+  return Math.min(max, Math.max(min, Math.round(number)));
+}

package/src/protocol/collection-settings.mjs

@@ -0,0 +1,41 @@
+export const DEFAULT_COLLECTION_SETTINGS = {
+  enabled: true,
+  idleCloseMinutes: 30,
+  uploadBatchSize: 50,
+  queueWarnThreshold: 10,
+  storeRawPrompts: false,
+  storeFullReplies: false,
+  commandCaptureMode: "summary_only",
+  filePathMode: "relative",
+  weeklyReportDay: "Monday",
+  retentionDays: 180
+};
+
+export function normalizeCollectionSettings(input = {}, fallback = DEFAULT_COLLECTION_SETTINGS) {
+  const current = { ...DEFAULT_COLLECTION_SETTINGS, ...(fallback || {}) };
+  return {
+    ...current,
+    enabled: input.enabled !== undefined ? normalizeBoolean(input.enabled) : current.enabled,
+    idleCloseMinutes: clampNumber(input.idleCloseMinutes, 5, 240, current.idleCloseMinutes),
+    uploadBatchSize: clampNumber(input.uploadBatchSize, 1, 500, current.uploadBatchSize),
+    queueWarnThreshold: clampNumber(input.queueWarnThreshold, 1, 10000, current.queueWarnThreshold),
+    storeRawPrompts: input.storeRawPrompts !== undefined ? normalizeBoolean(input.storeRawPrompts) : current.storeRawPrompts,
+    storeFullReplies: input.storeFullReplies !== undefined ? normalizeBoolean(input.storeFullReplies) : current.storeFullReplies,
+    commandCaptureMode: ["summary_only", "command_only", "disabled"].includes(input.commandCaptureMode) ? input.commandCaptureMode : current.commandCaptureMode,
+    filePathMode: ["relative", "hash", "disabled"].includes(input.filePathMode) ? input.filePathMode : current.filePathMode,
+    weeklyReportDay: ["Monday", "Friday", "Sunday"].includes(input.weeklyReportDay) ? input.weeklyReportDay : current.weeklyReportDay,
+    retentionDays: clampNumber(input.retentionDays, 7, 3650, current.retentionDays)
+  };
+}
+
+function normalizeBoolean(value) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "string") return !["false", "0", "off", "no"].includes(value.trim().toLowerCase());
+  return Boolean(value);
+}
+
+function clampNumber(value, min, max, fallback) {
+  const number = Number(value);
+  if (!Number.isFinite(number)) return fallback;
+  return Math.min(max, Math.max(min, Math.round(number)));
+}

package/src/protocol/event-schema.mjs

@@ -0,0 +1,177 @@
+import crypto from "node:crypto";
+import { normalizeModelInfo } from "./model-info.mjs";
+import { EVENT_TYPES } from "./event-types.mjs";
+
+const SECRET_PATTERNS = [
+  /\b(?:sk|ak|pk)_[A-Za-z0-9_-]{16,}\b/g,
+  /\b(?:Bearer\s+)[A-Za-z0-9._-]{16,}\b/gi,
+  /\b(?:password|passwd|secret|token|accesskey|cookie)\s*[:=]\s*['"]?[^'"\s]+/gi,
+  /\b1[3-9]\d{9}\b/g,
+  /\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b/gi
+];
+
+export function stableHash(value) {
+  return crypto.createHash("sha256").update(String(value ?? "")).digest("hex").slice(0, 16);
+}
+
+export function redactText(value) {
+  const input = String(value ?? "");
+  let hitCount = 0;
+  let output = input;
+  for (const pattern of SECRET_PATTERNS) {
+    output = output.replace(pattern, () => {
+      hitCount += 1;
+      return "[REDACTED]";
+    });
+  }
+  return { text: output, hitCount };
+}
+
+export function scorePromptQuality(text, hints = {}) {
+  const source = String(text ?? "").trim();
+  const lower = source.toLowerCase();
+  let score = 30;
+  const tags = [];
+
+  if (source.length >= 20) score += 10;
+  else tags.push("描述过短");
+  if (source.length >= 80) score += 10;
+  if (/[。；;,.，\n]/.test(source)) score += 5;
+  if (/目标|希望|需要|实现|修复|分析|输出|生成|整理/.test(source)) score += 15;
+  else tags.push("目标不明确");
+  if (/不要|只|必须|边界|范围|限制|保留|不需要/.test(source)) score += 10;
+  else tags.push("缺少边界");
+  if (/验收|测试|验证|运行|通过|检查|对比|截图/.test(source)) score += 10;
+  else tags.push("缺少验收标准");
+  if (hints.hasFiles || /文件|路径|目录|页面|接口|模块|项目/.test(source)) score += 10;
+  else tags.push("缺少上下文对象");
+  if (lower.includes("随便") || lower.includes("看着办")) {
+    score -= 10;
+    tags.push("约束过弱");
+  }
+
+  return {
+    score: Math.max(0, Math.min(100, score)),
+    tags
+  };
+}
+
+function stringValue(...values) {
+  for (const value of values) {
+    if (value === undefined || value === null || value === "") continue;
+    return String(value);
+  }
+  return "";
+}
+
+function numberValue(...values) {
+  for (const value of values) {
+    if (value === undefined || value === null || value === "") continue;
+    const number = Number(value);
+    if (Number.isFinite(number)) return number;
+  }
+  return 0;
+}
+
+function normalizeProcess(input, eventType) {
+  const metadata = input.metadata && typeof input.metadata === "object" ? input.metadata : {};
+  const process = input.process && typeof input.process === "object" ? input.process : {};
+  const mode = stringValue(
+    process.codexMode,
+    process.mode,
+    input.codexMode,
+    input.codex_mode,
+    input.mode,
+    metadata.codexMode,
+    metadata.mode
+  );
+  const nextMode = stringValue(
+    process.nextMode,
+    process.modeTo,
+    input.nextMode,
+    input.next_mode,
+    input.toMode,
+    input.to_mode,
+    input.modeTo,
+    input.mode_to
+  );
+  return {
+    interactionType: stringValue(process.interactionType, input.interactionType, input.interaction_type, metadata.interactionType, eventType),
+    codexMode: nextMode || mode,
+    previousMode: stringValue(process.previousMode, process.modeFrom, input.previousMode, input.previous_mode, input.fromMode, input.from_mode, input.modeFrom, input.mode_from),
+    nextMode,
+    phase: stringValue(process.phase, input.phase, metadata.phase),
+    roundIndex: numberValue(process.roundIndex, input.roundIndex, input.round_index, metadata.roundIndex),
+    toolName: stringValue(process.toolName, input.toolName, input.tool_name, metadata.toolName),
+    toolStatus: stringValue(process.toolStatus, input.toolStatus, input.tool_status, input.status, metadata.toolStatus, metadata.status),
+    exitCode: numberValue(process.exitCode, input.exitCode, input.exit_code, metadata.exitCode),
+    permissionDecision: stringValue(process.permissionDecision, input.permissionDecision, input.permission_decision, input.decision, metadata.permissionDecision),
+    retryAttempt: numberValue(process.retryAttempt, input.retryAttempt, input.retry_attempt, metadata.retryAttempt),
+    failureKind: stringValue(process.failureKind, input.failureKind, input.failure_kind, input.errorCode, input.error_code, metadata.failureKind)
+  };
+}
+
+export function normalizeCollectorEvent(input = {}) {
+  const occurredAt = input.occurredAt ? new Date(input.occurredAt) : new Date();
+  if (Number.isNaN(occurredAt.getTime())) {
+    throw new Error("occurredAt is invalid");
+  }
+  const eventType = EVENT_TYPES.has(input.eventType) ? input.eventType : "tool_call";
+  const summaryTitle = input.summary?.title || input.title || eventType;
+  const summaryContent = input.summary?.content || input.summary || "";
+  const redactedSummary = redactText(summaryContent);
+  const redactedTitle = redactText(summaryTitle);
+  const promptMetrics = eventType === "user_prompt"
+    ? scorePromptQuality(redactedSummary.text || redactedTitle.text, {
+        hasFiles: Boolean(input.refs?.files?.length)
+      })
+    : null;
+
+  const process = normalizeProcess(input, eventType);
+
+  return {
+    schemaVersion: input.schemaVersion || "0.1",
+    eventId: input.eventId || `evt_${crypto.randomUUID()}`,
+    employeeId: String(input.employeeId || "unknown"),
+    employeeName: input.employeeName || "",
+    department: input.department || "",
+    role: input.role || "",
+    clientId: input.clientId || "unknown-client",
+    tool: input.tool || "codex",
+    source: input.source || "client_agent",
+    model: normalizeModelInfo(input),
+    eventType,
+    occurredAt: occurredAt.toISOString(),
+    workspace: {
+      rootHash: input.workspace?.rootHash || stableHash(input.workspace?.root || input.workspace?.repoName || "unknown"),
+      repoName: input.workspace?.repoName || "unknown",
+      branch: input.workspace?.branch || ""
+    },
+    session: {
+      localSessionId: input.session?.localSessionId || input.localSessionId || `auto_${stableHash(`${input.employeeId}:${input.workspace?.repoName}:${occurredAt.toISOString().slice(0, 13)}`)}`,
+      turnIndex: Number(input.session?.turnIndex || input.turnIndex || 0),
+      idleClosed: Boolean(input.session?.idleClosed)
+    },
+    summary: {
+      title: redactedTitle.text,
+      content: redactedSummary.text
+    },
+    metrics: {
+      durationSeconds: Math.max(0, Number(input.metrics?.durationSeconds ?? input.durationSeconds ?? 0)),
+      inputChars: Number(input.metrics?.inputChars ?? redactedSummary.text.length),
+      promptQualityScore: Number(input.metrics?.promptQualityScore ?? promptMetrics?.score ?? 0)
+    },
+    process,
+    promptQuality: promptMetrics,
+    refs: {
+      files: Array.isArray(input.refs?.files) ? input.refs.files.slice(0, 20).map(String) : [],
+      commands: Array.isArray(input.refs?.commands) ? input.refs.commands.slice(0, 10).map(String) : []
+    },
+    safety: {
+      redactionApplied: redactedSummary.hitCount + redactedTitle.hitCount > 0 || Boolean(input.safety?.redactionApplied),
+      redactionHitCount: redactedSummary.hitCount + redactedTitle.hitCount + Number(input.safety?.redactionHitCount || 0),
+      rawContentUploaded: false
+    },
+    metadata: input.metadata && typeof input.metadata === "object" ? input.metadata : {}
+  };
+}

package/src/protocol/event-types.mjs

@@ -0,0 +1,61 @@
+export const EVENT_TYPE_DEFINITIONS = [
+  { type: "session_start", label: "会话开始", category: "会话", description: "AI 工具会话被创建或恢复。", order: 10 },
+  { type: "session_end", label: "会话结束", category: "会话", description: "AI 工具会话结束或被空闲关闭。", order: 20 },
+  { type: "user_prompt", label: "用户提示", category: "对话", description: "员工向 AI 输入问题、需求或补充上下文。", order: 30 },
+  { type: "assistant_response", label: "AI 回复", category: "对话", description: "AI 返回回答、方案、代码或解释。", order: 40 },
+  { type: "planning", label: "任务规划", category: "过程", description: "进入计划、拆解、评估或方案设计阶段。", order: 50 },
+  { type: "research", label: "资料调研", category: "过程", description: "检索、阅读、对比资料或代码上下文。", order: 60 },
+  { type: "implementation", label: "实现修改", category: "过程", description: "生成、修改、重构代码或配置。", order: 70 },
+  { type: "document", label: "文档材料", category: "过程", description: "生成或修改文档、报告、周报、方案材料。", order: 80 },
+  { type: "tool_call", label: "工具调用", category: "工具", description: "AI 调用本地工具、读写文件、运行辅助能力。", order: 90 },
+  { type: "tool_result", label: "工具结果", category: "工具", description: "工具调用完成并返回结果。", order: 100 },
+  { type: "mcp_tool_call", label: "MCP 调用", category: "工具", description: "通过 MCP 调用外部能力或内部系统。", order: 110 },
+  { type: "skill_use", label: "Skill 使用", category: "能力", description: "使用 Codex/Claude/OpenCode 的 Skill 工作流。", order: 120 },
+  { type: "plugin_use", label: "插件使用", category: "能力", description: "使用 Figma、Browser、表格、邮件等插件能力。", order: 130 },
+  { type: "command", label: "命令执行", category: "工具", description: "执行终端命令、脚本或构建任务。", order: 140 },
+  { type: "mode_change", label: "模式切换", category: "过程", description: "AI 工具在聊天、规划、实现、审查等模式间切换。", order: 150 },
+  { type: "permission", label: "权限决策", category: "治理", description: "员工确认、拒绝或授权执行高风险操作。", order: 160 },
+  { type: "verification", label: "验证检查", category: "质量", description: "运行测试、构建、截图、人工验收或其它验证动作。", order: 170 },
+  { type: "retry", label: "重试", category: "风险", description: "因失败、超时或结果不佳触发重试。", order: 180 },
+  { type: "rework", label: "返工", category: "风险", description: "输出偏差、需求理解错误或质量问题导致返工。", order: 190 },
+  { type: "error", label: "错误异常", category: "风险", description: "工具、脚本、模型或流程产生错误。", order: 200 }
+];
+
+export const EVENT_TYPES = new Set(EVENT_TYPE_DEFINITIONS.map((item) => item.type));
+
+export function eventTypeDefinition(type) {
+  return EVENT_TYPE_DEFINITIONS.find((item) => item.type === type) || EVENT_TYPE_DEFINITIONS.find((item) => item.type === "tool_call");
+}
+
+export function eventTypeLabel(type) {
+  return eventTypeDefinition(type)?.label || "工具调用";
+}
+
+export function eventTypeDistribution(events = [], { includeZero = false, limit = EVENT_TYPE_DEFINITIONS.length } = {}) {
+  const buckets = new Map(EVENT_TYPE_DEFINITIONS.map((item) => [
+    item.type,
+    {
+      type: item.type,
+      name: item.label,
+      category: item.category,
+      description: item.description,
+      order: item.order,
+      events: 0,
+      minutes: 0
+    }
+  ]));
+  for (const event of events) {
+    const type = EVENT_TYPES.has(event.eventType) ? event.eventType : "tool_call";
+    const bucket = buckets.get(type);
+    bucket.events += 1;
+    bucket.minutes += Math.round(Number(event.metrics?.durationSeconds || 0) / 60);
+  }
+  return [...buckets.values()]
+    .filter((item) => includeZero || item.events > 0)
+    .sort((a, b) => {
+      if (b.events !== a.events) return b.events - a.events;
+      return a.order - b.order;
+    })
+    .slice(0, limit)
+    .map(({ order, ...item }) => item);
+}

package/src/protocol/model-info.mjs

@@ -0,0 +1,85 @@
+const PROVIDER_HINTS = [
+  { pattern: /gpt|o\d|codex/i, provider: "openai" },
+  { pattern: /claude/i, provider: "anthropic" },
+  { pattern: /gemini/i, provider: "google" },
+  { pattern: /qwen|通义/i, provider: "alibaba" },
+  { pattern: /deepseek/i, provider: "deepseek" },
+  { pattern: /doubao|豆包/i, provider: "bytedance" }
+];
+
+export function normalizeModelInfo(input = {}) {
+  const source = input.model && typeof input.model === "object" ? input.model : input;
+  const name = stringValue(
+    source.name ||
+    source.model ||
+    source.modelName ||
+    source.model_name ||
+    source.id ||
+    input.modelName ||
+    input.model_name ||
+    input.metadata?.modelName ||
+    input.metadata?.model ||
+    ""
+  );
+  const provider = stringValue(
+    source.provider ||
+    source.vendor ||
+    input.modelProvider ||
+    input.model_provider ||
+    input.metadata?.modelProvider ||
+    inferProvider(name)
+  );
+  const version = stringValue(
+    source.version ||
+    source.modelVersion ||
+    source.model_version ||
+    input.modelVersion ||
+    input.model_version ||
+    input.metadata?.modelVersion ||
+    inferVersion(name)
+  );
+  const family = stringValue(
+    source.family ||
+    input.modelFamily ||
+    input.model_family ||
+    input.metadata?.modelFamily ||
+    inferFamily(name)
+  );
+  return {
+    provider,
+    name,
+    version,
+    family,
+    label: [provider, name, version].filter(Boolean).join("/") || "unknown"
+  };
+}
+
+function stringValue(value) {
+  return String(value || "").trim();
+}
+
+function inferProvider(name) {
+  for (const hint of PROVIDER_HINTS) {
+    if (hint.pattern.test(name)) return hint.provider;
+  }
+  return "";
+}
+
+function inferFamily(name) {
+  const source = String(name || "").toLowerCase();
+  if (!source) return "";
+  if (source.includes("codex")) return "codex";
+  if (source.includes("gpt")) return "gpt";
+  if (source.includes("claude")) return "claude";
+  if (source.includes("gemini")) return "gemini";
+  if (source.includes("qwen")) return "qwen";
+  if (source.includes("deepseek")) return "deepseek";
+  if (source.includes("doubao")) return "doubao";
+  return source.split(/[-_:./\s]/).filter(Boolean)[0] || "";
+}
+
+function inferVersion(name) {
+  const source = String(name || "");
+  const match = source.match(/(?:gpt-|claude-|gemini-|qwen-|deepseek-|doubao-|o)([0-9][A-Za-z0-9.-]*)/i);
+  return match?.[1] || "";
+}

package/src/protocol/pinyin.mjs

@@ -0,0 +1,181 @@
+const COMMON_PINYIN = {
+  张: "zhang",
+  王: "wang",
+  李: "li",
+  赵: "zhao",
+  刘: "liu",
+  陈: "chen",
+  杨: "yang",
+  黄: "huang",
+  周: "zhou",
+  吴: "wu",
+  徐: "xu",
+  孙: "sun",
+  胡: "hu",
+  朱: "zhu",
+  高: "gao",
+  林: "lin",
+  何: "he",
+  郭: "guo",
+  马: "ma",
+  罗: "luo",
+  梁: "liang",
+  宋: "song",
+  郑: "zheng",
+  谢: "xie",
+  韩: "han",
+  唐: "tang",
+  冯: "feng",
+  于: "yu",
+  董: "dong",
+  萧: "xiao",
+  程: "cheng",
+  曹: "cao",
+  袁: "yuan",
+  邓: "deng",
+  许: "xu",
+  傅: "fu",
+  沈: "shen",
+  曾: "zeng",
+  彭: "peng",
+  吕: "lv",
+  苏: "su",
+  卢: "lu",
+  蒋: "jiang",
+  蔡: "cai",
+  贾: "jia",
+  丁: "ding",
+  魏: "wei",
+  薛: "xue",
+  叶: "ye",
+  阎: "yan",
+  余: "yu",
+  潘: "pan",
+  杜: "du",
+  戴: "dai",
+  夏: "xia",
+  钟: "zhong",
+  汪: "wang",
+  田: "tian",
+  任: "ren",
+  姜: "jiang",
+  范: "fan",
+  方: "fang",
+  石: "shi",
+  姚: "yao",
+  谭: "tan",
+  廖: "liao",
+  邹: "zou",
+  熊: "xiong",
+  金: "jin",
+  陆: "lu",
+  郝: "hao",
+  孔: "kong",
+  白: "bai",
+  崔: "cui",
+  康: "kang",
+  毛: "mao",
+  邱: "qiu",
+  秦: "qin",
+  江: "jiang",
+  史: "shi",
+  顾: "gu",
+  侯: "hou",
+  邵: "shao",
+  孟: "meng",
+  龙: "long",
+  万: "wan",
+  段: "duan",
+  雷: "lei",
+  钱: "qian",
+  汤: "tang",
+  尹: "yin",
+  易: "yi",
+  常: "chang",
+  武: "wu",
+  乔: "qiao",
+  贺: "he",
+  赖: "lai",
+  龚: "gong",
+  文: "wen",
+  三: "san",
+  四: "si",
+  五: "wu",
+  六: "liu",
+  七: "qi",
+  八: "ba",
+  九: "jiu",
+  十: "shi",
+  一: "yi",
+  二: "er",
+  小: "xiao",
+  明: "ming",
+  华: "hua",
+  强: "qiang",
+  磊: "lei",
+  军: "jun",
+  洋: "yang",
+  勇: "yong",
+  艳: "yan",
+  杰: "jie",
+  娟: "juan",
+  敏: "min",
+  静: "jing",
+  丽: "li",
+  超: "chao",
+  平: "ping",
+  刚: "gang",
+  芳: "fang",
+  霞: "xia",
+  秀: "xiu",
+  测: "ce",
+  试: "shi",
+  写: "xie",
+  入: "ru",
+  员: "yuan",
+  工: "gong",
+  前: "qian",
+  端: "duan",
+  后: "hou",
+  台: "tai",
+  平: "ping",
+  产: "chan",
+  品: "pin",
+  研: "yan",
+  发: "fa",
+  解: "jie",
+  决: "jue",
+  方: "fang",
+  案: "an",
+  售: "shou",
+  顾: "gu",
+  问: "wen"
+};
+
+export function toPinyinSlug(value, fallback = "unknown") {
+  const input = String(value || "").trim();
+  if (!input) return fallback;
+  const output = [];
+  for (const char of input) {
+    if (/[a-zA-Z0-9]/.test(char)) {
+      output.push(char.toLowerCase());
+      continue;
+    }
+    if (/[\s._-]/.test(char)) {
+      if (output.at(-1) !== "-") output.push("-");
+      continue;
+    }
+    if (COMMON_PINYIN[char]) {
+      output.push(COMMON_PINYIN[char]);
+      continue;
+    }
+    const code = char.codePointAt(0).toString(16);
+    output.push(`u${code}`);
+  }
+  return output.join("").replace(/-+/g, "-").replace(/^-|-$/g, "") || fallback;
+}
+
+export function employeeRegistrationName(employee = {}) {
+  return String(employee.pinyinName || employee.registrationName || "").trim()
+    || toPinyinSlug(employee.name || employee.employeeName || "", String(employee.employeeId || employee.id || "unknown"));
+}

package/src/protocol/tool-profiles.mjs

@@ -0,0 +1,62 @@
+const TOOL_ALIASES = new Map([
+  ["codex", "codex"],
+  ["openai-codex", "codex"],
+  ["claude", "claude-code"],
+  ["claude-code", "claude-code"],
+  ["calude-code", "claude-code"],
+  ["calude code", "claude-code"],
+  ["claude code", "claude-code"],
+  ["opencode", "opencode"],
+  ["open-code", "opencode"],
+  ["open code", "opencode"]
+]);
+
+export const TOOL_PROFILES = [
+  {
+    id: "codex",
+    label: "Codex",
+    vendor: "OpenAI",
+    configKind: "toml",
+    mcpServerName: "ai_worklens",
+    hookName: "ai-worklens-codex-hook",
+    configFileName: "codex-mcp-snippet.toml",
+    hookFileName: "codex-hook.sh",
+    installNote: "合并到 ~/.codex/config.toml，并配置 hook 脚本即可采集 Codex 事件。"
+  },
+  {
+    id: "claude-code",
+    label: "Claude Code",
+    vendor: "Anthropic",
+    configKind: "mcp-json",
+    mcpServerName: "ai-worklens",
+    hookName: "ai-worklens-claude-hook",
+    configFileName: "claude-code-mcp.json",
+    hookFileName: "claude-code-hook.sh",
+    installNote: "可放入项目 .mcp.json，或用 claude mcp add-json 导入 stdio MCP server。"
+  },
+  {
+    id: "opencode",
+    label: "OpenCode",
+    vendor: "OpenCode",
+    configKind: "opencode-json",
+    mcpServerName: "ai_worklens",
+    hookName: "ai-worklens-opencode-hook",
+    configFileName: "opencode-mcp.jsonc",
+    hookFileName: "opencode-hook.sh",
+    installNote: "合并到 opencode.json / opencode.jsonc 的 mcp 配置下。"
+  }
+];
+
+export function normalizeToolId(value = "codex") {
+  const key = String(value || "codex").trim().toLowerCase();
+  return TOOL_ALIASES.get(key) || "codex";
+}
+
+export function getToolProfile(value = "codex") {
+  const id = normalizeToolId(value);
+  return TOOL_PROFILES.find((profile) => profile.id === id) || TOOL_PROFILES[0];
+}
+
+export function listToolProfiles() {
+  return TOOL_PROFILES.map((profile) => ({ ...profile }));
+}

package/src/team-rollout.mjs

@@ -3,10 +3,10 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { normalizeToolId } from "../../collector-protocol/src/tool-profiles.mjs";
+import { normalizeToolId } from "./protocol/tool-profiles.mjs";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const projectRoot = path.resolve(__dirname, "../../..");
+const agentSrcDir = __dirname;
 
 function parseArgs(argv) {
   const result = {};
@@ -90,7 +90,7 @@ function buildRunnerScript() {
     "import fs from \"node:fs\";",
     "import os from \"node:os\";",
     "import path from \"node:path\";",
-    `import { installClient } from ${JSON.stringify(path.join(projectRoot, "packages/client-agent/src/install.mjs"))};`,
+    `import { installClient } from ${JSON.stringify(path.join(agentSrcDir, "install.mjs"))};`,
     "",
     "const packageDir = path.dirname(new URL(import.meta.url).pathname);",
     "const manifest = JSON.parse(fs.readFileSync(path.join(packageDir, \"rollout-manifest.json\"), \"utf8\"));",

package/src/uploader.mjs

@@ -1,8 +1,8 @@
 import path from "node:path";
 import { EventQueue } from "./queue.mjs";
 import { writeClientConfig } from "./config.mjs";
-import { normalizeCollectionSettings } from "../../collector-protocol/src/collection-settings.mjs";
-import { normalizeClientUpdatePolicy, updateNeeded } from "../../collector-protocol/src/client-update-policy.mjs";
+import { normalizeCollectionSettings } from "./protocol/collection-settings.mjs";
+import { normalizeClientUpdatePolicy, updateNeeded } from "./protocol/client-update-policy.mjs";
 import { installClient } from "./install.mjs";
 
 async function requestJson(url, config, options = {}) {