@foxden-app/foxclaw 0.2.7 → 0.3.0

package/README.md

@@ -30,6 +30,7 @@ FoxClaw（狸爪）的目标很直接：让你用手机控制本机的 Codex，
 
 - 手头有 Codex、OpenClaw、QwenPaw、Hermes、OpenCode、Kimi CLI 之类能跑 shell 的 agent？推荐走 [Agent 辅助安装](./docs/zh/agent-assisted-install.md)。
 - 对 Node、Telegram 机器人、Codex CLI 不太熟？看 [新手安装指南](./docs/zh/install-for-beginners.md)。
+- 已经装好，想系统了解 `/help`、`/setup`、`/threads`、`/watch`、`/auth` 和账号轮转？看 [用户手册](./docs/zh/user-manual.md)。
 - Git、Node、`.env` 都玩得转？直接往下看快速设置。
 - 卡住了？看 [故障排查](./docs/zh/troubleshooting.md)。
 

package/README_EN.md

@@ -30,6 +30,7 @@ No public server required. FoxClaw runs on your own computer, talks to `codex ap
 
 - Already have a shell-capable agent such as Codex, OpenClaw, QwenPaw, Hermes, OpenCode, or Kimi CLI? Use the [Agent-Assisted Install](./docs/agent-assisted-install.md) first. This is the recommended path.
 - New to Node, Telegram bots, or Codex CLI? Use the [Beginner Install Guide](./docs/install-for-beginners.md).
+- Already installed and want the full command guide for `/help`, `/setup`, `/threads`, `/watch`, `/auth`, and auth rotation? Read the [User Manual](./docs/user-manual.md).
 - Already comfortable with Git, Node, and `.env` files? Use the quick setup below.
 - Something failed? Check [Troubleshooting](./docs/troubleshooting.md).
 

package/dist/controller/controller.d.ts

@@ -260,6 +260,7 @@ export declare class BridgeSessionCore {
     private handleThreadOpenCallback;
     private handleThreadActionCallback;
     private handleThreadNewCallback;
+    private handleThreadNewFromThreadCallback;
     private handleThreadNewCwdCallback;
     private handleThreadNewCwdTextReply;
     private startNewThreadForRequestedCwd;

package/dist/controller/controller.js

@@ -893,6 +893,11 @@ export class BridgeSessionCore {
             await this.handleThreadNewCallback(event, locale);
             return;
         }
+        const threadNewMatch = /^thread:new:(.+)$/.exec(event.data);
+        if (threadNewMatch) {
+            await this.handleThreadNewFromThreadCallback(event, threadNewMatch[1], locale);
+            return;
+        }
         const newCwdMatch = /^thread:newcwd:(create|cancel)$/.exec(event.data);
         if (newCwdMatch) {
             await this.handleThreadNewCwdCallback(event, newCwdMatch[1], locale);
@@ -4683,6 +4688,18 @@ export class BridgeSessionCore {
         await this.messaging.answerCallback(event.callbackQueryId, t(locale, 'thread_new_prompt_short'));
         await this.sendMessage(event.scopeId, t(locale, 'thread_new_prompt', { cwd: this.config.defaultCwd }));
     }
+    async handleThreadNewFromThreadCallback(event, threadId, locale) {
+        const scopeId = event.scopeId;
+        const cached = this.store.listCachedThreads(scopeId).find(thread => thread.threadId === threadId);
+        if (!cached) {
+            await this.messaging.answerCallback(event.callbackQueryId, t(locale, 'cached_thread_unavailable'));
+            return;
+        }
+        this.pendingThreadRenames.delete(scopeId);
+        this.pendingThreadNewCwds.delete(scopeId);
+        await this.messaging.answerCallback(event.callbackQueryId, t(locale, 'thread_new_started_short'));
+        await this.startNewThreadForRequestedCwd(scopeId, locale, cached.cwd || this.config.defaultCwd, event.messageId);
+    }
     async handleThreadNewCwdCallback(event, action, locale) {
         const pending = this.pendingThreadNewCwds.get(event.scopeId);
         if (!pending || !pending.cwdToCreate) {
@@ -6984,7 +7001,7 @@ function authChoiceKeyboard(locale, record) {
             callback_data: `auth:${record.localId}:${index}`,
         },
         {
-            text: t(locale, candidate.disabled ? 'button_auth_enable' : 'button_auth_disable'),
+            text: t(locale, candidate.disabled ? 'button_auth_disable' : 'button_auth_enable'),
             callback_data: `auth:${record.localId}:toggle:${index}`,
         },
     ]);

package/dist/controller/presentation.js

@@ -47,6 +47,7 @@ export function buildThreadsKeyboard(locale, threads) {
                 { text: t(locale, 'button_thread_rename'), callback_data: `thread:rename:${thread.threadId}` },
                 { text: t(locale, 'button_thread_watch'), callback_data: `thread:watch:${thread.threadId}` },
                 { text: t(locale, 'button_thread_archive'), callback_data: `thread:archive:${thread.threadId}` },
+                { text: t(locale, 'button_thread_new'), callback_data: `thread:new:${thread.threadId}` },
             ];
         return [openRow, actionRow];
     });
@@ -250,23 +251,24 @@ export function buildSetupPanelKeyboard(locale, ctx) {
     const currentMode = resolveCollaborationMode(ctx.settings?.collaborationMode ?? null);
     const activeTurnMessageMode = resolveActiveTurnMessageMode(ctx.settings?.activeTurnMessageMode ?? null);
     const rows = [];
+    const autoLabel = setupAutoButtonLabel(locale);
     rows.push(...chunkButtons([
         {
-            text: currentModel === null ? `• ${t(locale, 'button_auto')}` : t(locale, 'button_auto'),
+            text: currentModel === null ? `• ${autoLabel}` : autoLabel,
             callback_data: 'setup:model:default',
         },
         ...ctx.models.map((model) => ({
-            text: selectedButtonText(currentModel === model.model, `🤖 ${truncate(model.model, 14)}`),
+            text: selectedButtonText(currentModel === model.model, truncate(model.model, 14)),
             callback_data: `setup:model:${encodeURIComponent(model.model)}`,
         })),
     ], 2));
     rows.push(...chunkButtons([
         {
-            text: (ctx.settings?.reasoningEffort ?? null) === null ? `• ${t(locale, 'button_auto')}` : t(locale, 'button_auto'),
+            text: (ctx.settings?.reasoningEffort ?? null) === null ? `• ${autoLabel}` : autoLabel,
             callback_data: 'setup:effort:default',
         },
         ...efforts.map((effort) => ({
-            text: selectedButtonText(ctx.settings?.reasoningEffort === effort, `🧠 ${effort}`),
+            text: selectedButtonText(ctx.settings?.reasoningEffort === effort, effort),
             callback_data: `setup:effort:${effort}`,
         })),
     ], 3));
@@ -301,7 +303,7 @@ export function buildSetupPanelKeyboard(locale, ctx) {
     ]);
     rows.push([
         {
-            text: selectedButtonText(currentMode === 'default', `🤖 ${t(locale, 'collaboration_mode_default')}`),
+            text: selectedButtonText(currentMode === 'default', t(locale, 'collaboration_mode_default')),
             callback_data: 'setup:mode:default',
         },
         {
@@ -311,11 +313,11 @@ export function buildSetupPanelKeyboard(locale, ctx) {
     ]);
     rows.push([
         {
-            text: selectedButtonText(activeTurnMessageMode === 'steer', `🎯 ${t(locale, 'active_turn_message_mode_steer')}`),
+            text: selectedButtonText(activeTurnMessageMode === 'steer', t(locale, 'active_turn_message_mode_steer')),
             callback_data: 'setup:active:steer',
         },
         {
-            text: selectedButtonText(activeTurnMessageMode === 'queue', `📥 ${t(locale, 'active_turn_message_mode_queue')}`),
+            text: selectedButtonText(activeTurnMessageMode === 'queue', t(locale, 'active_turn_message_mode_queue')),
             callback_data: 'setup:active:queue',
         },
     ]);
@@ -392,6 +394,9 @@ function accessPresetButtonLabel(locale, preset) {
         return `🔓 ${formatAccessPresetLabel(locale, preset)}`;
     return `🛡️ ${formatAccessPresetLabel(locale, preset)}`;
 }
+function setupAutoButtonLabel(locale) {
+    return locale === 'zh' ? '自动' : 'Auto';
+}
 export function formatModelSettingsMessage(locale, models, settings) {
     const selectedModel = resolveCurrentModel(models, settings?.model ?? null);
     const selectedModelLabel = settings?.model ?? t(locale, 'server_default');

package/dist/i18n.d.ts

@@ -150,8 +150,8 @@ declare const MESSAGES: {
         readonly auth_add_missing_file: "Login completed, but the new auth file was not created: {value}";
         readonly button_login_device: "🔑 Login";
         readonly button_auth_reload: "🔄 Reload auth";
-        readonly button_auth_enable: "✅ Enable";
-        readonly button_auth_disable: "⏸️ Disable";
+        readonly button_auth_enable: "✅";
+        readonly button_auth_disable: "⏸️";
         readonly another_turn_running: "Another turn is already running. Use /interrupt, /takeover, /queue, or wait.";
         readonly working: "Working...";
         readonly usage_open: "Usage: /open <n>";
@@ -175,6 +175,7 @@ declare const MESSAGES: {
         readonly codex_sync_failed: "Codex.app sync failed: {error}";
         readonly opened_in_codex: "Opened in Codex.app.";
         readonly started_new_thread: "Started new thread {threadId}";
+        readonly thread_new_started_short: "Starting new thread";
         readonly thread_new_prompt_short: "Send PWD";
         readonly thread_new_prompt: "Send the PWD for the new thread. Send \".\" to use the default:\n{cwd}";
         readonly thread_new_cwd_missing: "PWD does not exist:\n{cwd}\nCreate it and start the new thread there?";
@@ -305,6 +306,7 @@ declare const MESSAGES: {
         readonly button_reveal: "↗️ Reveal";
         readonly button_auto: "⚙️ Auto";
         readonly button_new_thread: "➕ New";
+        readonly button_thread_new: "➕";
         readonly threads_no_matches: "<b>No threads matched</b>\n<code>{searchTerm}</code>";
         readonly threads_no_recent: "<b>No recent threads.</b>";
         readonly threads_recent_title: "<b>Recent threads</b>";
@@ -318,9 +320,9 @@ declare const MESSAGES: {
         readonly button_clear_filter: "🧹 Clear";
         readonly button_recent_threads: "🕘 Recent";
         readonly button_archived_threads: "🗄️ Archived";
-        readonly button_thread_rename: "✏️ Rename";
-        readonly button_thread_watch: "👀 Watch";
-        readonly button_thread_archive: "🗑️ Archive/Delete";
+        readonly button_thread_rename: "✏️";
+        readonly button_thread_watch: "👀";
+        readonly button_thread_archive: "🗑️";
         readonly button_thread_unarchive: "♻️ Unarchive";
         readonly threads_current: "Current: <b>{title}</b>";
         readonly where_no_thread_bound: "No thread is currently bound.";
@@ -370,8 +372,8 @@ declare const MESSAGES: {
         readonly active_turn_message_mode_steer: "Steer current turn";
         readonly active_turn_message_mode_queue: "Queue next turn";
         readonly button_fast_on: "⚡ Fast: on";
-        readonly button_fast_off: "⚪ Fast: off";
-        readonly button_fast_unsupported: "⛔ Fast unsupported";
+        readonly button_fast_off: "Fast: off";
+        readonly button_fast_unsupported: "Fast unsupported";
         readonly access_preset_read_only: "Read-only";
         readonly access_preset_default: "Default";
         readonly access_preset_full_access: "Full access";
@@ -698,8 +700,8 @@ declare const MESSAGES: {
         readonly auth_add_missing_file: "登录已完成，但没有创建新的 auth 文件：{value}";
         readonly button_login_device: "🔑 设备登录";
         readonly button_auth_reload: "🔄 重载 auth";
-        readonly button_auth_enable: "✅ 启用";
-        readonly button_auth_disable: "⏸️ 禁用";
+        readonly button_auth_enable: "✅";
+        readonly button_auth_disable: "⏸️";
         readonly another_turn_running: "已经有一个回复在进行中。请先等待，或使用 /interrupt、/takeover、/queue。";
         readonly working: "处理中...";
         readonly usage_open: "用法：/open <编号>";
@@ -723,6 +725,7 @@ declare const MESSAGES: {
         readonly codex_sync_failed: "同步到 Codex.app 失败：{error}";
         readonly opened_in_codex: "已在 Codex.app 中打开。";
         readonly started_new_thread: "已新建线程 {threadId}";
+        readonly thread_new_started_short: "正在新建线程";
         readonly thread_new_prompt_short: "发送 PWD";
         readonly thread_new_prompt: "请发送新线程的 PWD。发送 \".\" 使用默认目录：\n{cwd}";
         readonly thread_new_cwd_missing: "PWD 不存在：\n{cwd}\n是否新建这个目录，并在其中启动新线程？";
@@ -853,6 +856,7 @@ declare const MESSAGES: {
         readonly button_reveal: "↗️ 打开";
         readonly button_auto: "⚙️ 自动";
         readonly button_new_thread: "➕ 新建";
+        readonly button_thread_new: "➕";
         readonly threads_no_matches: "<b>没有匹配的线程</b>\n<code>{searchTerm}</code>";
         readonly threads_no_recent: "<b>暂无最近线程。</b>";
         readonly threads_recent_title: "<b>最近线程</b>";
@@ -866,9 +870,9 @@ declare const MESSAGES: {
         readonly button_clear_filter: "🧹 清除";
         readonly button_recent_threads: "🕘 最近线程";
         readonly button_archived_threads: "🗄️ 已归档";
-        readonly button_thread_rename: "✏️ 重命名";
-        readonly button_thread_watch: "👀 观察";
-        readonly button_thread_archive: "🗑️ 归档/删除";
+        readonly button_thread_rename: "✏️";
+        readonly button_thread_watch: "👀";
+        readonly button_thread_archive: "🗑️";
         readonly button_thread_unarchive: "♻️ 取消归档";
         readonly threads_current: "当前：<b>{title}</b>";
         readonly where_no_thread_bound: "当前没有绑定线程。";
@@ -918,8 +922,8 @@ declare const MESSAGES: {
         readonly active_turn_message_mode_steer: "引导当前回复";
         readonly active_turn_message_mode_queue: "排队到下一轮";
         readonly button_fast_on: "⚡ Fast：开";
-        readonly button_fast_off: "⚪ Fast：关";
-        readonly button_fast_unsupported: "⛔ Fast 不支持";
+        readonly button_fast_off: "Fast：关";
+        readonly button_fast_unsupported: "Fast 不支持";
         readonly access_preset_read_only: "只读";
         readonly access_preset_default: "默认";
         readonly access_preset_full_access: "完全访问";

package/dist/i18n.js

@@ -148,8 +148,8 @@ const MESSAGES = {
         auth_add_missing_file: 'Login completed, but the new auth file was not created: {value}',
         button_login_device: '🔑 Login',
         button_auth_reload: '🔄 Reload auth',
-        button_auth_enable: '✅ Enable',
-        button_auth_disable: '⏸️ Disable',
+        button_auth_enable: '✅',
+        button_auth_disable: '⏸️',
         another_turn_running: 'Another turn is already running. Use /interrupt, /takeover, /queue, or wait.',
         working: 'Working...',
         usage_open: 'Usage: /open <n>',
@@ -173,6 +173,7 @@ const MESSAGES = {
         codex_sync_failed: 'Codex.app sync failed: {error}',
         opened_in_codex: 'Opened in Codex.app.',
         started_new_thread: 'Started new thread {threadId}',
+        thread_new_started_short: 'Starting new thread',
         thread_new_prompt_short: 'Send PWD',
         thread_new_prompt: 'Send the PWD for the new thread. Send "." to use the default:\n{cwd}',
         thread_new_cwd_missing: 'PWD does not exist:\n{cwd}\nCreate it and start the new thread there?',
@@ -303,6 +304,7 @@ const MESSAGES = {
         button_reveal: '↗️ Reveal',
         button_auto: '⚙️ Auto',
         button_new_thread: '➕ New',
+        button_thread_new: '➕',
         threads_no_matches: '<b>No threads matched</b>\n<code>{searchTerm}</code>',
         threads_no_recent: '<b>No recent threads.</b>',
         threads_recent_title: '<b>Recent threads</b>',
@@ -316,9 +318,9 @@ const MESSAGES = {
         button_clear_filter: '🧹 Clear',
         button_recent_threads: '🕘 Recent',
         button_archived_threads: '🗄️ Archived',
-        button_thread_rename: '✏️ Rename',
-        button_thread_watch: '👀 Watch',
-        button_thread_archive: '🗑️ Archive/Delete',
+        button_thread_rename: '✏️',
+        button_thread_watch: '👀',
+        button_thread_archive: '🗑️',
         button_thread_unarchive: '♻️ Unarchive',
         threads_current: 'Current: <b>{title}</b>',
         where_no_thread_bound: 'No thread is currently bound.',
@@ -368,8 +370,8 @@ const MESSAGES = {
         active_turn_message_mode_steer: 'Steer current turn',
         active_turn_message_mode_queue: 'Queue next turn',
         button_fast_on: '⚡ Fast: on',
-        button_fast_off: '⚪ Fast: off',
-        button_fast_unsupported: '⛔ Fast unsupported',
+        button_fast_off: 'Fast: off',
+        button_fast_unsupported: 'Fast unsupported',
         access_preset_read_only: 'Read-only',
         access_preset_default: 'Default',
         access_preset_full_access: 'Full access',
@@ -696,8 +698,8 @@ const MESSAGES = {
         auth_add_missing_file: '登录已完成，但没有创建新的 auth 文件：{value}',
         button_login_device: '🔑 设备登录',
         button_auth_reload: '🔄 重载 auth',
-        button_auth_enable: '✅ 启用',
-        button_auth_disable: '⏸️ 禁用',
+        button_auth_enable: '✅',
+        button_auth_disable: '⏸️',
         another_turn_running: '已经有一个回复在进行中。请先等待，或使用 /interrupt、/takeover、/queue。',
         working: '处理中...',
         usage_open: '用法：/open <编号>',
@@ -721,6 +723,7 @@ const MESSAGES = {
         codex_sync_failed: '同步到 Codex.app 失败：{error}',
         opened_in_codex: '已在 Codex.app 中打开。',
         started_new_thread: '已新建线程 {threadId}',
+        thread_new_started_short: '正在新建线程',
         thread_new_prompt_short: '发送 PWD',
         thread_new_prompt: '请发送新线程的 PWD。发送 "." 使用默认目录：\n{cwd}',
         thread_new_cwd_missing: 'PWD 不存在：\n{cwd}\n是否新建这个目录，并在其中启动新线程？',
@@ -851,6 +854,7 @@ const MESSAGES = {
         button_reveal: '↗️ 打开',
         button_auto: '⚙️ 自动',
         button_new_thread: '➕ 新建',
+        button_thread_new: '➕',
         threads_no_matches: '<b>没有匹配的线程</b>\n<code>{searchTerm}</code>',
         threads_no_recent: '<b>暂无最近线程。</b>',
         threads_recent_title: '<b>最近线程</b>',
@@ -864,9 +868,9 @@ const MESSAGES = {
         button_clear_filter: '🧹 清除',
         button_recent_threads: '🕘 最近线程',
         button_archived_threads: '🗄️ 已归档',
-        button_thread_rename: '✏️ 重命名',
-        button_thread_watch: '👀 观察',
-        button_thread_archive: '🗑️ 归档/删除',
+        button_thread_rename: '✏️',
+        button_thread_watch: '👀',
+        button_thread_archive: '🗑️',
         button_thread_unarchive: '♻️ 取消归档',
         threads_current: '当前：<b>{title}</b>',
         where_no_thread_bound: '当前没有绑定线程。',
@@ -916,8 +920,8 @@ const MESSAGES = {
         active_turn_message_mode_steer: '引导当前回复',
         active_turn_message_mode_queue: '排队到下一轮',
         button_fast_on: '⚡ Fast：开',
-        button_fast_off: '⚪ Fast：关',
-        button_fast_unsupported: '⛔ Fast 不支持',
+        button_fast_off: 'Fast：关',
+        button_fast_unsupported: 'Fast 不支持',
         access_preset_read_only: '只读',
         access_preset_default: '默认',
         access_preset_full_access: '完全访问',

package/docs/install-for-beginners.md

@@ -280,3 +280,7 @@ Update FoxClaw later:
 npm install -g @foxden-app/foxclaw@latest
 foxclaw start
 ```
+
+## Next Step
+
+After the first install works, read the [User Manual](./user-manual.md) for `/help`, `/setup`, `/threads`, `/watch`, `/auth`, Codex login, and multi-account auth rotation.