@keyou007/agent-bot 0.1.15-alpha.5 → 0.1.15-alpha.6

package/docs/technical-reference.md

@@ -147,6 +147,10 @@ feishu:
   userOpenId: "${FEISHU_USER_OPEN_ID}"
   respondToOwnerOnly: true
   respondToAllGroupMessages: true
+  groupNameFormat:
+    project: "[{agent}] [{project}] {taskname}"
+    projectless: "[{agent}] {taskname}"
+    dateFormat: "MM-dd"
   thinkingCardLayout: "grouped"
 
 console:
@@ -185,6 +189,19 @@ logging:
 
 `/mute` and `/mute on` persist mention-only response mode for the current base group; `/mute off` disables it. The group timeline and every topic share this state. While muted, messages that do not mention the current bot are ignored before event claims, reactions, activity tracking, image downloads, command parsing, or Agent calls. The command that disables mute must itself mention the bot. Private chats do not support `/mute`.
 
+`feishu.groupNameFormat.project` and `projectless` control names created by NewGroup or ForkGroup for Project and Projectless tasks. Each template must contain exactly one `{taskname}` and may use these variables:
+
+| Variable | Value |
+| --- | --- |
+| `{os}` | Current system: `win` on Windows, `mac` on macOS, and `linux` on Linux |
+| `{agent}` | Configured Agent standard name, such as `codex` or `traex` |
+| `{project}` | At most the final two Project path levels, limited to 15 characters; normally omitted from the Projectless template |
+| `{taskname}` | New-task or fork-task title |
+| `{date}` | Local date and time rendered with `dateFormat` |
+| `{date:yyyy-MM-dd}` | A format override for this placeholder only |
+
+Date formats support `yyyy`/`yy` for year, `MM`/`M` for month, `dd`/`d` for day, `HH`/`H` for hour, `mm`/`m` for minute, and `ss`/`s` for second. Uppercase `YYYY`, `YY`, `DD`, and `D` are also accepted. Other characters are emitted literally. Feishu's 60-character group-name limit still applies; Agent Bot truncates `{taskname}` first so configured prefixes and suffixes remain visible. The defaults exactly preserve previous group names. Rerunning `agentbot init` adds this section to an existing config without replacing user settings.
+
 `feishu.thinkingCardLayout` defaults to `grouped`. The grouped renderer keeps Commentary and user steering messages visible, uses Commentary as the only execution-group boundary, uses only the latest native reasoning as each group title, and keeps every tool available inside the group. Command panels remove PowerShell launchers and POSIX command-string launchers such as `/bin/zsh -lc`, `/bin/bash -c`, and `/usr/bin/env sh -c` from both their titles and expanded command text without changing the command that is executed. Execution-group status is intentionally non-failing: while any child tool is running the group uses the running treatment, otherwise it settles to the neutral treatment; failed tools retain their own failure icon inside the group. Every execution panel is rendered with a collapsed default and a stable `element_id`; Agent Bot never changes the expanded flag based on tool status, user steering, or later Commentary, allowing the Feishu client to retain a user's manual expansion across full-card updates. Grouped pagination first renders complete tool panels, then fills pages from the newest end according to the rendered UTF-8 JSON size and component count. The activity area is limited to 24KB and 160 components, leaving headroom under Feishu's recommended 30KB card size and 200-component hard limit for the header, plan, files, and actions. Execution groups above eight tools are split into stable subpanels, but every tool keeps its expandable command, result, and image content. History pages are measured separately with complete native reasoning included. Set the option to `timeline` to use the unchanged original renderer and its 40-activity pages while the grouped layout is being refined.
 
 Feishu local commands beginning with `!` are persisted under `command-jobs/` beside the configured SQLite file and run in detached Runner processes. They have no execution timeout and release the conversation message queue immediately after submission, so multiple commands may run concurrently. Each Runner persists status and writes both stdout and stderr chunks to one `output.log` in observed arrival order; the log compacts its middle after reaching 8 MiB while retaining the beginning and end. The Worker only polls these files and updates the original card, then reattaches to unfinished jobs after restart. The running card's `Cancel` action persists a cancellation request that makes the Runner terminate the command process tree. This background mode applies only to Feishu `!` commands; the synchronous `agentbot task shell` CLI behavior is unchanged.

package/docs/technical-reference.zh.md

@@ -147,6 +147,10 @@ feishu:
   userOpenId: "${FEISHU_USER_OPEN_ID}"
   respondToOwnerOnly: true
   respondToAllGroupMessages: true
+  groupNameFormat:
+    project: "[{agent}] [{project}] {taskname}"
+    projectless: "[{agent}] {taskname}"
+    dateFormat: "MM-dd"
   thinkingCardLayout: "grouped"
 
 console:
@@ -185,6 +189,19 @@ logging:
 
 `/mute` 或 `/mute on` 会为当前基础群聊持久化仅 @ 响应模式，`/mute off` 会关闭。群正文及其所有话题共享该状态；静音期间未 @ 当前机器人的消息会在事件去重、reaction、活跃时间、图片下载、命令解析和 Agent 调用之前被忽略。关闭静音的命令本身也必须 @ 机器人。私聊不支持 `/mute`。
 
+`feishu.groupNameFormat.project` 和 `projectless` 分别控制 Project 与 Projectless 任务通过 NewGroup 或 ForkGroup 创建的群名。每个模板必须且只能包含一个 `{taskname}`，并可使用以下变量：
+
+| 变量 | 内容 |
+| --- | --- |
+| `{os}` | 当前系统：Windows 为 `win`、macOS 为 `mac`、Linux 为 `linux` |
+| `{agent}` | Agent 配置标准名，例如 `codex` 或 `traex` |
+| `{project}` | Project 目录末尾最多两级，最长 15 个字符；Projectless 模板通常不使用 |
+| `{taskname}` | 新任务或 Fork 任务的标题 |
+| `{date}` | 按 `dateFormat` 格式化的本地日期时间 |
+| `{date:yyyy-MM-dd}` | 只为当前位置指定日期格式，不修改全局 `dateFormat` |
+
+日期格式支持 `yyyy`/`yy` 年、`MM`/`M` 月、`dd`/`d` 日、`HH`/`H` 时、`mm`/`m` 分和 `ss`/`s` 秒，也兼容大写 `YYYY`、`YY`、`DD`、`D`。其他字符按原样输出。最终群名遵循飞书 60 字符限制；超长时优先截断 `{taskname}`，保留模板的前后固定部分。默认模板与旧版群名完全一致。重新运行 `agentbot init` 会为已有配置补齐这一配置段，不覆盖用户已有设置。
+
 `feishu.thinkingCardLayout` 默认为 `grouped`。分组渲染器保持 Commentary 和用户追加消息可见，只把 Commentary 作为执行组边界；每个执行组只用最新原生思考作为标题，展开后仍可查看组内全部工具。命令面板会从标题和展开后的命令正文中去掉 PowerShell 启动器，以及 `/bin/zsh -lc`、`/bin/bash -c`、`/usr/bin/env sh -c` 等 POSIX 命令字符串启动器，但不会修改实际执行的命令。执行组状态不会聚合为失败：存在运行中工具时使用运行中样式，否则回到中性样式；失败工具仍在组内保留自己的失败图标。所有执行面板都以折叠状态作为默认值，并使用稳定的 `element_id`；Agent Bot 不再根据工具状态、用户追加或后续 Commentary 改写展开属性，让飞书客户端能够在整卡更新时保留用户手动展开的状态。分组分页会先完整渲染工具面板，再根据生成内容的 UTF-8 JSON 大小和组件数量从最新端向前装页。活动区上限为 24KB 和 160 个组件，为飞书建议的 30KB 卡片大小及 200 个组件硬限制预留标题、计划、文件变更和操作按钮空间。超过 8 个工具的单个执行组会拆成标识稳定的子面板，但每个工具都继续保留可展开的命令、结果和图片内容。历史页会包含完整原生思考并独立测量。新版布局完善期间，可将该配置设为 `timeline` 使用保持不变的原版渲染器及其每页 40 条活动规则。
 
 以 `!` 开头的飞书本地命令会写入 SQLite 文件同级的 `command-jobs/` 目录，并由脱离 Worker 的独立 Runner 进程执行。命令没有运行超时，提交成功后立即释放当前会话消息队列；不同命令可以并发运行。Runner 将状态持久化到任务目录，并把 stdout 和 stderr 数据块按照观察到的到达顺序写入同一个 `output.log`；日志达到 8 MiB 后保留头尾并压缩中间内容。Worker 只轮询这些文件并更新原卡片，重启后通过未完成状态重新接管监控。运行卡片的 `Cancel` 操作写入持久化取消请求，由 Runner 终止命令进程树。该后台模式仅用于飞书 `!` 命令；CLI 的同步 `agentbot task shell` 行为保持不变。

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@keyou007/agent-bot",
-  "version": "0.1.15-alpha.5",
+  "version": "0.1.15-alpha.6",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@keyou007/agent-bot",
-      "version": "0.1.15-alpha.5",
+      "version": "0.1.15-alpha.6",
       "license": "GPL-3.0-only",
       "dependencies": {
         "@agentclientprotocol/sdk": "1.2.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keyou007/agent-bot",
-  "version": "0.1.15-alpha.5",
+  "version": "0.1.15-alpha.6",
   "type": "module",
   "description": "Use Codex, TraeX, and compatible coding agents from Lark/Feishu.",
   "license": "GPL-3.0-only",

package/src/config/loadConfig.ts

@@ -17,6 +17,10 @@ const DEFAULT_CONFIG = `feishu:
   userOpenId: "\${FEISHU_USER_OPEN_ID}"
   respondToOwnerOnly: true
   respondToAllGroupMessages: true
+  groupNameFormat:
+    project: "[{agent}] [{project}] {taskname}"
+    projectless: "[{agent}] {taskname}"
+    dateFormat: "MM-dd"
   thinkingCardLayout: "grouped"
 
 console:

package/src/config/schema.ts

@@ -3,6 +3,37 @@ import { DEFAULT_LOG_PATH, DEFAULT_SQLITE_PATH } from "./paths.js";
 
 const envRecordSchema = z.record(z.string(), z.string()).default({});
 
+export const DEFAULT_GROUP_NAME_FORMAT = {
+  project: "[{agent}] [{project}] {taskname}",
+  projectless: "[{agent}] {taskname}",
+  dateFormat: "MM-dd",
+} as const;
+
+const groupNameTemplateSchema = z.string().min(1).max(240).superRefine((template, context) => {
+  const tokens = [...template.matchAll(/\{([^{}]+)\}/gu)].map((match) => match[1]!);
+  const taskNameCount = tokens.filter((token) => token === "taskname").length;
+  if (taskNameCount !== 1) {
+    context.addIssue({
+      code: "custom",
+      message: "A group name format must contain exactly one {taskname} placeholder.",
+    });
+  }
+  for (const token of tokens) {
+    if (["os", "agent", "project", "taskname", "date"].includes(token)) continue;
+    if (token.startsWith("date:") && token.slice("date:".length).trim()) continue;
+    context.addIssue({
+      code: "custom",
+      message: `Unsupported group name placeholder: {${token}}.`,
+    });
+  }
+});
+
+const groupNameFormatSchema = z.object({
+  project: groupNameTemplateSchema.default(DEFAULT_GROUP_NAME_FORMAT.project),
+  projectless: groupNameTemplateSchema.default(DEFAULT_GROUP_NAME_FORMAT.projectless),
+  dateFormat: z.string().min(1).max(80).default(DEFAULT_GROUP_NAME_FORMAT.dateFormat),
+}).default(DEFAULT_GROUP_NAME_FORMAT);
+
 const agentKindSchema = z.union([
   z.literal("acp"),
   z.literal("app-server"),
@@ -30,6 +61,7 @@ export const appConfigSchema = z.object({
     userOpenId: z.string().optional(),
     respondToOwnerOnly: z.boolean().default(true),
     respondToAllGroupMessages: z.boolean().default(true),
+    groupNameFormat: groupNameFormatSchema,
     thinkingCardLayout: z.enum(["grouped", "timeline"]).default("grouped"),
     useConsoleWhenMissingCredentials: z.boolean().default(false),
   }),
@@ -53,4 +85,5 @@ export const appConfigSchema = z.object({
 });
 
 export type AgentConfig = z.infer<typeof agentConfigSchema>;
+export type GroupNameFormatConfig = z.infer<typeof groupNameFormatSchema>;
 export type AppConfig = z.infer<typeof appConfigSchema>;

package/src/feishu/FinalResponseBranding.ts

@@ -1,5 +1,5 @@
 export const FINAL_RESPONSE_BRANDING =
-  "> Powered by [AgentBot](https://bytedance.larkoffice.com/docx/UTukdYBopojSivxRVeUcCXTtnid)";
+  "> Powered by [AgentBot](https://keyou.github.io/agent-bot/)";
 export const FINAL_RESPONSE_BRANDING_BLOCK = `----\n\n${FINAL_RESPONSE_BRANDING}`;
 
 export function splitFinalResponseBranding(markdown: string): {

package/src/feishu/GroupNameFormatter.ts

@@ -0,0 +1,222 @@
+import os from "node:os";
+import path from "node:path";
+import {
+  DEFAULT_GROUP_NAME_FORMAT,
+  type GroupNameFormatConfig,
+} from "../config/schema.js";
+
+export const FEISHU_GROUP_NAME_MAX_LENGTH = 60;
+const GROUP_PROJECT_NAME_MAX_LENGTH = 15;
+const PLACEHOLDER_PATTERN = /\{([^{}]+)\}/gu;
+const TASK_NAME_PLACEHOLDER = "{taskname}";
+
+export interface GroupNameFormatInput {
+  agentName: string;
+  projectCwd?: string;
+  taskName: string;
+  date?: Date;
+  platform?: NodeJS.Platform;
+  format?: GroupNameFormatConfig;
+}
+
+export interface GroupNameParseInput {
+  agentName: string;
+  groupName: string;
+  projectCwd?: string;
+  platform?: NodeJS.Platform;
+  format?: GroupNameFormatConfig;
+}
+
+export function formatNewGroupName(input: GroupNameFormatInput): string {
+  const format = input.format ?? DEFAULT_GROUP_NAME_FORMAT;
+  const template = input.projectCwd ? format.project : format.projectless;
+  const taskNameIndex = template.indexOf(TASK_NAME_PLACEHOLDER);
+  const values = templateValues(input, format);
+  const prefix = renderTemplate(template.slice(0, taskNameIndex), values);
+  const suffix = renderTemplate(template.slice(taskNameIndex + TASK_NAME_PLACEHOLDER.length), values);
+  const availableTaskNameLength = FEISHU_GROUP_NAME_MAX_LENGTH
+    - Array.from(prefix).length
+    - Array.from(suffix).length;
+  const taskName = truncateTail(input.taskName, availableTaskNameLength);
+  return truncateTail(`${prefix}${taskName}${suffix}`.trim(), FEISHU_GROUP_NAME_MAX_LENGTH);
+}
+
+export function parseTaskNameFromGroupName(input: GroupNameParseInput): string | undefined {
+  const format = input.format ?? DEFAULT_GROUP_NAME_FORMAT;
+  const template = input.projectCwd ? format.project : format.projectless;
+  const values = templateValues(input, format);
+  let pattern = "^";
+  let cursor = 0;
+  let match: RegExpExecArray | null;
+  PLACEHOLDER_PATTERN.lastIndex = 0;
+  while ((match = PLACEHOLDER_PATTERN.exec(template)) !== null) {
+    pattern += escapeRegExp(template.slice(cursor, match.index));
+    const token = match[1]!;
+    if (token === "taskname") pattern += "(?<taskname>.+?)";
+    else if (token === "date" || token.startsWith("date:")) {
+      const dateFormat = token === "date" ? format.dateFormat : token.slice("date:".length);
+      pattern += dateFormatPattern(dateFormat);
+    } else {
+      pattern += escapeRegExp(placeholderValue(token, values));
+    }
+    cursor = match.index + match[0].length;
+  }
+  pattern += `${escapeRegExp(template.slice(cursor))}$`;
+  const parsed = new RegExp(pattern, "iu").exec(input.groupName.trim())?.groups?.taskname?.trim();
+  return parsed || undefined;
+}
+
+export function formatGroupNameDate(date: Date, format: string): string {
+  const year = date.getFullYear();
+  const month = date.getMonth() + 1;
+  const day = date.getDate();
+  const hour = date.getHours();
+  const minute = date.getMinutes();
+  const second = date.getSeconds();
+  const values = new Map<string, string>([
+    ["yyyy", String(year).padStart(4, "0")],
+    ["YYYY", String(year).padStart(4, "0")],
+    ["yy", String(year % 100).padStart(2, "0")],
+    ["YY", String(year % 100).padStart(2, "0")],
+    ["MM", String(month).padStart(2, "0")],
+    ["M", String(month)],
+    ["dd", String(day).padStart(2, "0")],
+    ["DD", String(day).padStart(2, "0")],
+    ["d", String(day)],
+    ["D", String(day)],
+    ["HH", String(hour).padStart(2, "0")],
+    ["H", String(hour)],
+    ["mm", String(minute).padStart(2, "0")],
+    ["m", String(minute)],
+    ["ss", String(second).padStart(2, "0")],
+    ["s", String(second)],
+  ]);
+  return replaceDateTokens(format, (token) => values.get(token)!);
+}
+
+export function groupNameOs(platform: NodeJS.Platform = process.platform): string {
+  if (platform === "win32") return "win";
+  if (platform === "darwin") return "mac";
+  if (platform === "linux") return "linux";
+  return platform;
+}
+
+export function formatGroupProjectName(projectCwd: string): string {
+  const value = abbreviateHomeDirectory(projectCwd);
+  const levels = value
+    .replace(/[\\/]+$/, "")
+    .split(/[\\/]+/)
+    .filter(Boolean)
+    .slice(-2);
+  const separator = value.includes("\\") ? path.win32.sep : path.posix.sep;
+  return fitTrailingPathLevels(levels, GROUP_PROJECT_NAME_MAX_LENGTH, separator);
+}
+
+interface TemplateValues {
+  agent: string;
+  project: string;
+  os: string;
+  date: Date;
+  dateFormat: string;
+}
+
+function templateValues(
+  input: Pick<GroupNameFormatInput, "agentName" | "projectCwd" | "date" | "platform">,
+  format: GroupNameFormatConfig,
+): TemplateValues {
+  return {
+    agent: input.agentName,
+    project: input.projectCwd ? formatGroupProjectName(input.projectCwd) : "",
+    os: groupNameOs(input.platform),
+    date: input.date ?? new Date(),
+    dateFormat: format.dateFormat,
+  };
+}
+
+function renderTemplate(template: string, values: TemplateValues): string {
+  PLACEHOLDER_PATTERN.lastIndex = 0;
+  return template.replace(PLACEHOLDER_PATTERN, (_placeholder, token: string) => {
+    if (token === "date") return formatGroupNameDate(values.date, values.dateFormat);
+    if (token.startsWith("date:")) {
+      return formatGroupNameDate(values.date, token.slice("date:".length));
+    }
+    return placeholderValue(token, values);
+  });
+}
+
+function placeholderValue(token: string, values: TemplateValues): string {
+  if (token === "agent") return values.agent;
+  if (token === "project") return values.project;
+  if (token === "os") return values.os;
+  return "";
+}
+
+function dateFormatPattern(format: string): string {
+  return replaceDateTokens(format, (token) => {
+    if (["yyyy", "YYYY"].includes(token)) return "\\d{4}";
+    if (["yy", "YY", "MM", "dd", "DD", "HH", "mm", "ss"].includes(token)) return "\\d{2}";
+    return "\\d{1,2}";
+  }, escapeRegExp);
+}
+
+const DATE_TOKENS = [
+  "yyyy", "YYYY", "yy", "YY", "MM", "dd", "DD", "HH", "mm", "ss", "M", "d", "D", "H", "m", "s",
+];
+
+function replaceDateTokens(
+  format: string,
+  replaceToken: (token: string) => string,
+  replaceLiteral: (literal: string) => string = (literal) => literal,
+): string {
+  let result = "";
+  for (let index = 0; index < format.length;) {
+    const token = DATE_TOKENS.find((candidate) => format.startsWith(candidate, index));
+    if (token) {
+      result += replaceToken(token);
+      index += token.length;
+    } else {
+      result += replaceLiteral(format[index]!);
+      index += 1;
+    }
+  }
+  return result;
+}
+
+function abbreviateHomeDirectory(value: string): string {
+  const homeDirectory = os.homedir();
+  const valueIsWindows = isWindowsAbsolutePath(value);
+  const homeIsWindows = isWindowsAbsolutePath(homeDirectory);
+  if (valueIsWindows !== homeIsWindows && (valueIsWindows || path.posix.isAbsolute(value))) return value;
+  const pathApi = valueIsWindows ? path.win32 : path;
+  const relative = pathApi.relative(homeDirectory, value);
+  if (relative === "") return "~";
+  if (pathApi.isAbsolute(relative) || relative === ".." || relative.startsWith(`..${pathApi.sep}`)) return value;
+  return `~${pathApi.sep}${relative}`;
+}
+
+function isWindowsAbsolutePath(value: string): boolean {
+  return /^[a-z]:[\\/]|^\\\\/iu.test(value);
+}
+
+function fitTrailingPathLevels(levels: string[], maxLength: number, separator: string): string {
+  if (levels.length === 0) return "";
+  if (levels.length === 1) return truncateTail(levels[0]!, maxLength);
+  const parent = levels[0]!;
+  const leaf = levels[1]!;
+  const joined = `${parent}${separator}${leaf}`;
+  if (Array.from(joined).length <= maxLength) return joined;
+  if (Array.from(leaf).length <= maxLength) return leaf;
+  return truncateTail(leaf, maxLength);
+}
+
+function truncateTail(value: string, maxLength: number): string {
+  const characters = Array.from(value);
+  if (characters.length <= maxLength) return value;
+  if (maxLength <= 0) return "";
+  if (maxLength <= 3) return ".".repeat(maxLength);
+  return `${characters.slice(0, maxLength - 3).join("")}...`;
+}
+
+function escapeRegExp(value: string): string {
+  return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+}

package/src/proxy/ProxySessionController.ts

@@ -5,7 +5,7 @@ import path from "node:path";
 import type { Logger } from "pino";
 import { createProjectlessWorkspace, detectProjectlessWorkspace } from "../codex/ProjectlessWorkspace.js";
 import { resolveUserPath } from "../config/paths.js";
-import type { AppConfig } from "../config/schema.js";
+import { DEFAULT_GROUP_NAME_FORMAT, type AppConfig } from "../config/schema.js";
 import { CommandRouter } from "../commands/CommandRouter.js";
 import type { Command } from "../commands/commandTypes.js";
 import { baseChatContextKey, isThreadContextKey } from "../feishu/contextKey.js";
@@ -30,6 +30,11 @@ import {
 } from "../feishu/CardRenderer.js";
 import { CardUpdateScheduler } from "../feishu/CardUpdateScheduler.js";
 import { generateGroupAvatarPng, resolveGroupAvatarProjectName } from "../feishu/GroupAvatarGenerator.js";
+import {
+  formatGroupNameDate,
+  formatNewGroupName,
+  parseTaskNameFromGroupName,
+} from "../feishu/GroupNameFormatter.js";
 import { normalizeFeishuPostText } from "../feishu/InboundText.js";
 import { allowsFeishuUser } from "../feishu/ownerAccess.js";
 import type { OutboundRouter } from "../presentation/OutboundRouter.js";
@@ -3222,7 +3227,10 @@ export class ProxySessionController {
     executionSettings: SessionExecutionSettings,
   ): Promise<CreatedFeishuTaskGroup> {
     const explicitTitle = normalizeTaskTitle(requestedTitle);
-    const taskTitle = explicitTitle ?? `新任务 (${formatGroupDateSuffix(new Date())})`;
+    const taskTitle = explicitTitle ?? `新任务 (${formatGroupNameDate(
+      new Date(),
+      this.config.feishu?.groupNameFormat?.dateFormat ?? DEFAULT_GROUP_NAME_FORMAT.dateFormat,
+    )})`;
     const group = await this.createFeishuGroupContext(
       sourceContextKey,
       agentName,
@@ -3230,7 +3238,6 @@ export class ProxySessionController {
       userId,
       boundProjectCwd,
       "/newgroup",
-      false,
     );
 
     let task: SessionRecord;
@@ -3331,7 +3338,6 @@ export class ProxySessionController {
       userId,
       boundProjectCwd,
       "/forkgroup",
-      false,
     );
 
     let forked: ForkSessionResult;
@@ -3374,12 +3380,17 @@ export class ProxySessionController {
     userId: string | undefined,
     boundProjectCwd: string | undefined,
     commandName: "/newgroup" | "/forkgroup",
-    includeTimestamp: boolean,
   ): Promise<CreatedFeishuGroupContext> {
     if (!userId?.startsWith("ou_")) {
       throw new Error(`${commandName} 只能由具有 open_id 的飞书用户消息触发。`);
     }
-    const groupName = formatNewGroupName(agentName, boundProjectCwd, taskTitle, new Date(), includeTimestamp);
+    const groupName = formatNewGroupName({
+      agentName,
+      projectCwd: boundProjectCwd,
+      taskName: taskTitle,
+      date: new Date(),
+      format: this.config.feishu?.groupNameFormat,
+    });
     const group = await this.outbound.createGroup(sourceContextKey, {
       name: groupName,
       userOpenId: userId,
@@ -4713,14 +4724,26 @@ export class ProxySessionController {
     contextKey: string,
     event: ChatUpdatedEvent,
   ): Promise<void> {
-    const parsed = parseAgentGroupName(event.afterName);
-    if (!parsed) return;
     const context = this.store.getUserContext(contextKey);
     if (!context?.currentSessionId) return;
     const record = this.store.getSessionForContext(context.currentSessionId, contextKey);
     if (!record || record.status === "closed") return;
-    if (record.agentName.toLowerCase() !== parsed.agentName.toLowerCase()) return;
-    const title = normalizeTaskTitle(parsed.title);
+    const nameFormat = this.config.feishu?.groupNameFormat ?? DEFAULT_GROUP_NAME_FORMAT;
+    const projectCwd = detectProjectlessWorkspace(record.cwd) ? undefined : record.cwd;
+    const templateTitle = parseTaskNameFromGroupName({
+      agentName: record.agentName,
+      groupName: event.afterName,
+      projectCwd,
+      format: nameFormat,
+    });
+    const legacy = parseAgentGroupName(event.afterName);
+    const legacyTitle = legacy && record.agentName.toLowerCase() === legacy.agentName.toLowerCase()
+      ? legacy.title
+      : undefined;
+    if (isDefaultGroupNameFormat(nameFormat) && isLegacyGroupPrefixOnly(event.afterName)) return;
+    const title = normalizeTaskTitle(isDefaultGroupNameFormat(nameFormat)
+      ? legacyTitle ?? templateTitle
+      : templateTitle ?? legacyTitle);
     if (!title || title === record.title) return;
 
     const loaded = await this.loadSession(record);
@@ -6978,44 +7001,6 @@ function isRecoveryAttemptRecent(attempt: TurnAttemptRecord, cutoff: number): bo
   return Number.isFinite(updatedAt) && updatedAt >= cutoff;
 }
 
-function formatGroupDateSuffix(date: Date): string {
-  const month = String(date.getMonth() + 1).padStart(2, "0");
-  const day = String(date.getDate()).padStart(2, "0");
-  return `${month}-${day}`;
-}
-
-function formatNewGroupName(
-  agentName: string,
-  projectCwd: string | undefined,
-  taskTitle: string,
-  date: Date,
-  includeTimestamp: boolean,
-): string {
-  const prefix = `[${agentName}] `;
-  const projectPrefix = projectCwd ? `${formatGroupProjectDirectory(projectCwd)} ` : "";
-  const titlePrefix = `${prefix}${projectPrefix}`;
-  const timestampSuffix = includeTimestamp ? ` (${formatGroupDateSuffix(date)})` : "";
-  const availableTitleLength = FEISHU_GROUP_NAME_MAX_LENGTH
-    - Array.from(titlePrefix).length
-    - Array.from(timestampSuffix).length;
-  const title = truncateTail(taskTitle, availableTitleLength);
-  return truncateTail(`${titlePrefix}${title}${timestampSuffix}`, FEISHU_GROUP_NAME_MAX_LENGTH);
-}
-
-const FEISHU_GROUP_NAME_MAX_LENGTH = 60;
-const GROUP_PROJECT_DIRECTORY_MAX_LENGTH = 15;
-
-function formatGroupProjectDirectory(projectCwd: string): string {
-  const value = abbreviateHomeDirectory(projectCwd);
-  const levels = value
-    .replace(/[\\/]+$/, "")
-    .split(/[\\/]+/)
-    .filter(Boolean)
-    .slice(-2);
-  const separator = value.includes("\\") ? path.win32.sep : path.posix.sep;
-  return `[${fitTrailingPathLevels(levels, GROUP_PROJECT_DIRECTORY_MAX_LENGTH, separator)}]`;
-}
-
 function abbreviateHomeDirectory(value: string): string {
   const homeDirectory = os.homedir();
   const valueIsWindows = isWindowsAbsolutePath(value);
@@ -7032,29 +7017,6 @@ function isWindowsAbsolutePath(value: string): boolean {
   return /^[a-z]:[\\/]|^\\\\/iu.test(value);
 }
 
-function fitTrailingPathLevels(levels: string[], maxLength: number, separator: string): string {
-  if (levels.length === 0) return "";
-  if (levels.length === 1) return truncatePathLevel(levels[0]!, maxLength);
-  const parent = levels[0]!;
-  const leaf = levels[1]!;
-  const joined = `${parent}${separator}${leaf}`;
-  if (Array.from(joined).length <= maxLength) return joined;
-  if (Array.from(leaf).length <= maxLength) return leaf;
-  return truncatePathLevel(leaf, maxLength);
-}
-
-function truncatePathLevel(value: string, maxLength: number): string {
-  return truncateTail(value, maxLength);
-}
-
-function truncateTail(value: string, maxLength: number): string {
-  const characters = Array.from(value);
-  if (characters.length <= maxLength) return value;
-  if (maxLength <= 0) return "";
-  if (maxLength <= 3) return ".".repeat(maxLength);
-  return `${characters.slice(0, maxLength - 3).join("")}...`;
-}
-
 function parseAgentGroupName(value: string): { agentName: string; title: string } | undefined {
   const match = /^\[([^[\]]+)\]\s+(.+)$/.exec(value.trim());
   const agentName = match?.[1]?.trim();
@@ -7065,6 +7027,15 @@ function parseAgentGroupName(value: string): { agentName: string; title: string
   return agentName && title ? { agentName, title } : undefined;
 }
 
+function isDefaultGroupNameFormat(format: AppConfig["feishu"]["groupNameFormat"]): boolean {
+  return format.project === DEFAULT_GROUP_NAME_FORMAT.project
+    && format.projectless === DEFAULT_GROUP_NAME_FORMAT.projectless;
+}
+
+function isLegacyGroupPrefixOnly(value: string): boolean {
+  return /^\[[^[\]]+\]\s+\[[^[\]]+\]\s*$/u.test(value.trim());
+}
+
 function validateGoalObjective(objective: string): void {
   const length = Array.from(objective.trim()).length;
   if (length === 0) throw new Error("Goal 不能为空。");