fuli-context 0.5.0 → 0.7.2

package/skills/capturing-session-knowledge/SKILL.md

@@ -12,14 +12,17 @@ Accumulate reusable knowledge without interrupting the user's normal work. Keep
 At the start of every user task, first use the lifecycle context supplied by the host when one
 exists. A Claude Code `UserPromptSubmit` hook calls `begin_task_context`, which already loads
 collaboration preferences and resolves the exact local personal project from the current working
-directory. Apply that returned context and retain its opaque task token for the final checkpoint;
+directory. It also uses the submitted prompt transiently for bounded automatic project-memory
+recall and never stores or returns that prompt. Apply the returned `task_knowledge_recall` and
+preferences, then retain the opaque task token for the final checkpoint;
 do not redundantly call `get_collaboration_preferences`.
 
 When the host has not supplied lifecycle context, call exactly
 `get_collaboration_preferences` before any other tool or answer. Pass `projectPath` as the current
-working directory. This is the prompt-only fallback for Agents without an equivalent lifecycle
-hook. Fuli uses the path only for this local MCP call, never stores or returns it, and resolves the
-exact local personal project itself. Do not infer or guess `personalProjectId` in the Agent.
+working directory and `taskPrompt` as the current user request. This is the prompt-only fallback
+for Agents without an equivalent lifecycle hook. Fuli uses both only for this local MCP call,
+never stores or returns them, and resolves the exact local personal project itself. Do not infer
+or guess `personalProjectId` in the Agent.
 
 Apply only `effective_preferences`. Personal-global preferences apply in every user task;
 project-scoped preferences layer on only for the exact selected project. Do not apply items
@@ -42,6 +45,9 @@ current working directory. It resolves the exact active project without requirin
 copy an ID, searches that child project first, and then includes only inheritable knowledge from
 authorized parents or shared-source projects. Use `search_knowledge_graph` for personal-global
 context, explicitly named extra projects, subscribed public projects, or advanced scoped queries.
+Use `search_connected_knowledge` for a project-bound third-party source or explicitly selected
+public project. Keep its source sets separate and obey the project's conflict policy;
+`agent_decide` affects only the current response and never mutates or confirms a source.
 
 Search when prior durable context can materially improve the task.
 Before saying that a stable fact is unknown or asking the user to provide it again, search
@@ -50,6 +56,15 @@ requirements, terminology, architecture, prior decisions, runbooks, rationale, a
 personal preferences. Do not search for a fully self-contained task or use Fuli as proof of live
 external state.
 
+First inspect `task_knowledge_recall` returned by the lifecycle or preference tool. Its automatic
+query plan is deliberately bounded and based on implementation trigger categories, not on a
+claim that every returned candidate supports the task. If it misses or its candidates are
+irrelevant while durable context may still matter, call `search_current_project_knowledge`
+yourself. Derive one to four focused queries from the action, artifact, target system, distinctive
+identifier, and likely runbook category. Never pass the full conversational request as the sole
+query. For example, a version-release request should search release/publish and push/commit
+runbook concepts separately instead of searching the entire sentence.
+
 Pending knowledge is eligible for on-demand retrieval and must remain visibly marked.
 `agent_confirmed` knowledge is usable but ranks below user or authoritative-source
 confirmation.
@@ -156,6 +171,11 @@ Capture confirmed, stable information:
 - Personal: the user's enduring preferences, boundaries, habits, and working methods. Project-specific personal rules must explicitly link to that project instead of becoming global defaults.
 - Project: PRD facts, requirements, terminology, decisions, constraints, architecture, routes, APIs, metrics, and document-derived knowledge.
 
+For a runbook, decision, route, or other item likely to be recalled from shorthand, add a bounded
+`attributes.searchTerms` string array containing only neutral retrieval phrases supported by the
+item and observed task vocabulary. Search terms are retrieval metadata, not new factual claims;
+do not add speculative synonyms, credentials, or unrelated product names.
+
 Do not capture credentials, tokens, cookies, private keys, raw transcripts, temporary logs, command output, speculative conclusions, or disposable implementation details. Treat a correction as a replacement, not an additional conflicting fact.
 
 For a confirmed project decision, prefer `record_decision_trace` over a flat note. Preserve the

package/skills/flreview/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: flreview
+description: Use when the user explicitly enters /flreview or explicitly asks to run the Fuli personal knowledge review command.
+---
+
+# Fuli Knowledge Review
+
+Review personal preferences and local personal-project knowledge with the user as the authority. Never silently rewrite, invalidate, promote, or globalize knowledge.
+
+## Select Scope
+
+For every `/flreview`, first offer exactly these top-level choices:
+
+1. **全部** — review personal-global preferences plus every local personal project. Each project includes its project knowledge and project-scoped personal preferences.
+2. **个人偏好** — then choose **全局偏好** or the preferences for **某一个本地个人项目**.
+3. **个人项目** — then choose **一个本地个人项目** or **全部本地个人项目**. Each selected project includes both project knowledge and project-scoped personal preferences.
+
+Use `list_personal_projects` only when a branch needs a project choice. Never include subscribed or public projects. Do not infer the current directory as the selected project and do not invent another command variant.
+
+## Calibrate Depth
+
+After scope selection, first ask how much patience the user has for this review.
+
+交互硬规则：先询问用户有没有耐心；如果用户表示完全没耐心，不要再询问心情、时间或 token，只问少量最高优先级的关键问题。
+
+- If the user says they are **完全没耐心**, immediately take the short path. Do not ask about mood, available time, or token budget. Ask only a small number of the highest-priority critical questions, one at a time, and make stopping easy.
+- Otherwise ask, concisely, about current mood, available time, and whether token budget is comfortable. Use the answers plus explicit requests such as “少问一点”, “多问一点”, or “直接开始” to choose page size and explanation depth.
+- Do not impose a fixed total-question cap. A tool page limit controls only one retrieval batch, not the length of the review.
+
+## Start Or Resume
+
+Call `start_knowledge_review` with the exact selected scope and project ID when required. Reuse a returned active or paused run. Then call `list_knowledge_review_candidates` in bounded pages.
+
+If there is no previous completed review for that exact scope, review all historical in-scope knowledge. Otherwise present candidates in this order:
+
+没有上次完成记录时扫描全部历史。
+
+1. Knowledge created or changed since the last completed review.
+2. Current or older conflicts, negative evidence, or items marked `requires_attention`.
+3. Low-weight knowledge, using the Provider's returned utility/confidence reasons.
+4. The same durable pattern repeated across multiple sessions that may deserve a personal-global attribute.
+
+Treat ranking thresholds as Provider policy, not user requirements. Do not calculate a second conflicting score in the Agent.
+
+## Review One Candidate
+
+Show the content, scope, confirmation state, relevant evidence summary, weights, and why the item was selected. Ask for one outcome:
+
+- **确认保留** — keep it; if it is pending and the user explicitly confirms the content and classification, use the normal Fuli confirmation operation first.
+- **修改** — obtain the exact replacement text, apply `revise_personal_knowledge`, then record progress.
+- **失效** — reconfirm the exact target, apply `revise_personal_knowledge` with `invalidate`, then record progress.
+- **跳过** — do not ask again in this run; it may return in a later review.
+- **稍后处理** — do not ask again in this run; intentionally return it in the next review.
+
+After a successful mutation—or immediately for keep, skip, or later—call `record_knowledge_review_progress`. Never record a mutation outcome before its write succeeds.
+
+For repeated cross-session patterns, ask whether the user wants a personal-global attribute, a project-scoped preference, or no promotion. Never auto-promote. Use `set_personal_preference_scope` only after explicit confirmation and only for an actual preference item.
+
+## Pause Or Complete
+
+If the user stops before the selected queue is exhausted, call `finish_knowledge_review` with `paused`. Resume that run next time. Only call it with `completed` after the user explicitly finishes the selected scope or no candidates remain.
+
+Only a completed run advances the last-completed review time. Paused runs do not. A “稍后处理” item returns in the next run; a “跳过” item stays out only for the current run.
+
+只有完成回顾才推进上次回顾时间；暂停不能推进。
+
+## Guardrails
+
+- Keep the user authoritative. Explain conflicts; do not resolve them silently.
+- Preserve original evidence and revision history.
+- Never include raw transcripts, credentials, secrets, temporary logs, or unsupported inference.
+- Do not turn repeated project facts into global personal attributes without explicit approval.
+- If a required Fuli review tool is unavailable, state that the installed integration needs updating; do not simulate persistence in prose.

package/skills/flreview/agents/openai.yaml

@@ -0,0 +1,6 @@
+interface:
+  display_name: "Fuli Knowledge Review"
+  short_description: "Review personal preferences and local project knowledge"
+  default_prompt: "Use $flreview to review my Fuli knowledge."
+policy:
+  allow_implicit_invocation: true

package/src/agent-tools/graph-definitions.js

@@ -21,6 +21,13 @@ const sourceUri = {
   pattern: '^[Hh][Tt][Tt][Pp][Ss]?://\\S+$'
 };
 const attributes = { type: 'object', additionalProperties: true };
+const entityAttributes = {
+  type: 'object',
+  properties: {
+    searchTerms: arraySchema(boundedString(256), { minItems: 1, maxItems: 32 })
+  },
+  additionalProperties: true
+};
 const epistemicQuadrant = enumSchema([
   'known_known', 'known_unknown', 'unknown_known', 'unknown_unknown'
 ]);
@@ -48,6 +55,9 @@ const confirmationBasis = objectSchema({
   agentPolicyVersion: nullableStringSchema()
 }, ['existenceReason', 'quadrantReason', 'proposedBy']);
 const knowledgeItemKind = enumSchema(['entity', 'relationship']);
+const knowledgeReviewScope = enumSchema([
+  'all', 'preferences_global', 'preferences_project', 'projects_all', 'project'
+]);
 const humanChangeStatus = enumSchema([
   'all', 'human_changed', 'unseen', 'viewed', 'reviewed'
 ]);
@@ -84,7 +94,7 @@ const entity = objectSchema({
   type: { ...boundedString(64), pattern: '^[A-Za-z][A-Za-z0-9_]*$' },
   summary: boundedString(4096),
   ...epistemicFields,
-  attributes
+  attributes: entityAttributes
 }, [
   'key', 'name', 'type', 'originQuadrant',
   'confirmationStatus', 'confirmationBasis'
@@ -202,10 +212,11 @@ export const GRAPH_TOOL_DEFINITIONS = [
   {
     name: 'begin_task_context',
     title: 'LIFECYCLE · Begin a Fuli-aware task',
-    description: 'Lifecycle entry used by supported Agent hooks before the model processes a user prompt. It resolves the exact local project from projectPath, loads effective collaboration preferences, and returns an opaque taskContextToken. It never stores projectPath. Claude Code setup installs this as a deterministic UserPromptSubmit hook; manual Agent calls are a fallback.',
+    description: 'Lifecycle entry used by supported Agent hooks before the model processes a user prompt. It resolves the exact local project from projectPath, loads effective collaboration preferences, and uses taskPrompt transiently for bounded automatic recall when the request signals a stable prior fact, runbook, URL, decision, release, deployment, or authentication method. It never stores or returns projectPath or taskPrompt. Inspect task_knowledge_recall before asking the user to repeat stable context. Returns an opaque taskContextToken. Claude Code setup installs this as a deterministic UserPromptSubmit hook; manual Agent calls are a fallback.',
     inputSchema: objectSchema({
       sessionId: id,
-      projectPath: boundedString(4096)
+      projectPath: boundedString(4096),
+      taskPrompt: boundedString(8192)
     }, ['sessionId', 'projectPath'])
   },
   {
@@ -228,9 +239,10 @@ export const GRAPH_TOOL_DEFINITIONS = [
   {
     name: 'get_collaboration_preferences',
     title: 'READ FIRST · Load task collaboration preferences',
-    description: 'Fallback for Agents or tasks without begin_task_context hook context. When no hook context was supplied, call this exact tool name at the start of every user task before any other tool or answer; never substitute a project action tool. Do not call it redundantly when the entry hook already supplied preferences. Pass projectPath as the current working directory; Fuli uses it transiently, never stores or returns it, and layers preferences only for one exact registered local project match. Returns effective_preferences plus deferred_conflicts intentionally queued for AI. Apply effective_preferences before answering or constructing tool arguments. Human-confirmed preferences outrank explicitly marked agent-confirmed preferences. If the current task would use a deferred conflict, call resolve_deferred_preference_conflict before applying either side; ignore unrelated deferred conflicts. For write tools, enforce preferences in the actual payload; mentioning them only in the final answer is not compliance. Personal-global preferences always apply; other conflicted, pending, invalid, ambiguous-project, and unrelated-project items never auto-apply. Automatic injection does not count as usage evidence. personalProjectId remains an explicit compatibility override.',
+    description: 'Fallback for Agents or tasks without begin_task_context hook context. When no hook context was supplied, call this exact tool name at the start of every user task before any other tool or answer; never substitute a project action tool. Do not call it redundantly when the entry hook already supplied preferences. Pass projectPath as the current working directory and taskPrompt as the current user request. Fuli uses both transiently, never stores or returns them, resolves one exact registered local project, and performs bounded automatic recall only when the request signals stable prior context. Inspect task_knowledge_recall before asking the user to repeat a project fact or method. On a miss, search_current_project_knowledge with one to four focused action, artifact, target-system, or identifier queries; never use the full conversational request as the only query. Apply effective_preferences before answering or constructing tool arguments. Resolve only relevant deferred_conflicts first. For write tools, enforce preferences in the actual payload; the final answer is not compliance. Personal-global preferences always apply; conflicted, pending, invalid, ambiguous-project, and unrelated-project items never auto-apply. Automatic injection does not count as usage evidence. personalProjectId remains an explicit compatibility override.',
     inputSchema: objectSchema({
       projectPath: boundedString(4096),
+      taskPrompt: boundedString(8192),
       personalProjectId: nullableStringSchema(),
       limit: integerSchema({ minimum: 1, maximum: 200 })
     }, ['projectPath'])
@@ -323,6 +335,22 @@ export const GRAPH_TOOL_DEFINITIONS = [
       includePending: booleanSchema()
     }, ['personalSpaceId', 'query'])
   },
+  {
+    name: 'search_connected_knowledge',
+    title: 'READ · Search personal, public, and third-party knowledge',
+    description: 'Search the exact personal project, explicitly selected subscribed public projects, and live read-only third-party bindings in one request. Use all_local_confirmed only after explicit user confirmation. Results remain separated by source and preserve provenance; public-space integration is Beta. The response includes the project conflict policy. Under ask_human, surface a material conflict in the Agent conversation and ask the user before selecting durable truth. Under agent_decide, the Agent may choose for the current response only, but must explain its basis and sources. This tool never rewrites, confirms, invalidates, or publishes underlying knowledge.',
+    inputSchema: objectSchema({
+      personalSpaceId: id,
+      personalProjectId: id,
+      query: shortText,
+      contextPersonalProjectIds: arraySchema(id, { maxItems: 15 }),
+      personalProjectScope: enumSchema(['bounded', 'all_local_confirmed']),
+      projectIds: arraySchema(id, { maxItems: 32 }),
+      limit: integerSchema({ minimum: 1, maximum: 100 }),
+      includeHistorical: booleanSchema(),
+      includePending: booleanSchema()
+    }, ['personalSpaceId', 'personalProjectId', 'query'])
+  },
   {
     name: 'record_knowledge_usage',
     description: 'Record that personal knowledge materially affected the Agent final answer or completed action. Call only after the use actually occurs: cited means the answer explicitly relies on the item; applied means the item changed an implementation or decision. Retrieval, inspection, automatic preference injection, and merely appearing in context do not qualify. taskId must be the caller-stable identifier for the current user task and must be reused on retries; do not generate a fresh ID to recount the same task. Events are idempotent per knowledge item, task, use kind, and content generation. Repeated qualified use may promote pending knowledge to agent_confirmed, never to human-confirmed or public-eligible.',
@@ -463,6 +491,53 @@ export const GRAPH_TOOL_DEFINITIONS = [
     description: 'List local personal project profiles and their current evidence-backed coverage summaries.',
     inputSchema: objectSchema({ personalSpaceId: id })
   },
+  {
+    name: 'start_knowledge_review',
+    title: 'REVIEW · Start or resume personal knowledge review',
+    description: 'Start or resume the exact selected /flreview scope. A first review has no watermark and scans all in-scope history. A later review uses only the last completed run as its watermark; paused runs never advance it. Project scopes accept only local personal project IDs.',
+    inputSchema: objectSchema({
+      personalSpaceId: id,
+      scope: knowledgeReviewScope,
+      personalProjectId: nullableStringSchema()
+    }, ['personalSpaceId', 'scope'])
+  },
+  {
+    name: 'list_knowledge_review_candidates',
+    title: 'REVIEW · List ranked personal knowledge candidates',
+    description: 'List one bounded page for an active or paused review. Provider policy ranks new/changed knowledge, conflicts or attention, low-weight knowledge, then repeated cross-session patterns. Already decided items stay out of the current run. The page limit is not a total-question cap.',
+    inputSchema: objectSchema({
+      personalSpaceId: id,
+      reviewId: id,
+      limit: integerSchema({ minimum: 1, maximum: 50 })
+    }, ['personalSpaceId', 'reviewId'])
+  },
+  {
+    name: 'record_knowledge_review_progress',
+    title: 'WRITE · Record one review outcome',
+    description: 'Record one user-authorized candidate outcome after any required knowledge mutation succeeds. confirmed keeps the item, updated/invalidated follow successful writes, skipped suppresses it only in this run, and deferred intentionally returns it in the next run.',
+    inputSchema: objectSchema({
+      personalSpaceId: id,
+      reviewId: id,
+      candidateKey: {
+        ...boundedString(520),
+        pattern: '^(entity|relationship):.+'
+      },
+      outcome: enumSchema([
+        'confirmed', 'updated', 'invalidated', 'skipped', 'deferred'
+      ]),
+      note: nullableStringSchema()
+    }, ['personalSpaceId', 'reviewId', 'candidateKey', 'outcome'])
+  },
+  {
+    name: 'finish_knowledge_review',
+    title: 'WRITE · Pause or complete knowledge review',
+    description: 'Pause a review without moving its watermark, or complete it and establish the next run watermark. Use completed only when the selected scope is exhausted or the user explicitly finishes it.',
+    inputSchema: objectSchema({
+      personalSpaceId: id,
+      reviewId: id,
+      disposition: enumSchema(['paused', 'completed'])
+    }, ['personalSpaceId', 'reviewId', 'disposition'])
+  },
   {
     name: 'revise_personal_knowledge',
     description: 'Correct, invalidate, or restore one personal entity or relationship while preserving revision history and original evidence. This is the same personal-only operation used by the management UI.',

package/src/agent-tools/graph-handlers.js

@@ -22,6 +22,12 @@ const HANDLERS = Object.freeze({
     agentInvocation: true,
     agentToolName: 'search_knowledge_graph'
   }),
+  search_connected_knowledge: (app, input) => {
+    if (!app.connectedKnowledge) {
+      throw new Error('Connected knowledge runtime is unavailable');
+    }
+    return app.connectedKnowledge.query(input);
+  },
   record_knowledge_usage: (app, input) => app.recordKnowledgeUsage(input),
   record_knowledge_feedback: (app, input) => app.recordKnowledgeFeedback(input),
   search_current_project_knowledge: (app, input) =>
@@ -53,6 +59,12 @@ const HANDLERS = Object.freeze({
     app.upsertPersonalProject(input)
   ),
   list_personal_projects: (app, input) => app.listPersonalProjects(input),
+  start_knowledge_review: (app, input) => app.startKnowledgeReview(input),
+  list_knowledge_review_candidates: (app, input) =>
+    app.listKnowledgeReviewCandidates(input),
+  record_knowledge_review_progress: (app, input) =>
+    app.recordKnowledgeReviewProgress(input),
+  finish_knowledge_review: (app, input) => app.finishKnowledgeReview(input),
   revise_personal_knowledge: (app, input) => app.reviseKnowledgeItem({
     ...input,
     operationActor: 'agent'

package/src/cli/command-registry.js

@@ -12,10 +12,10 @@ General:
   --version, -v
 
 Local service:
-  start [--port 2727] [--open] [--lan] [--rebuild] [--data-dir DIR] [--personal-space NAME]
+  start [--port PORT] [--open] [--lan|--no-lan] [--rebuild] [--data-dir DIR] [--personal-space NAME]
   stop [--data-dir DIR]
-  restart [--port 2727] [--open] [--lan] [--rebuild] [--data-dir DIR] [--personal-space NAME]
-  status [--json] [--data-dir DIR]
+  restart [--port PORT] [--open] [--lan|--no-lan] [--rebuild] [--data-dir DIR] [--personal-space NAME]
+  status [--json] [--data-dir DIR] [--port PORT]
   open [--data-dir DIR]
 
 Install and Agent connection:

package/src/cli/local-runtime-command.js

@@ -6,6 +6,11 @@ import {
   stopLocalRuntime
 } from '../local-runtime/lifecycle.js';
 import { resolveSetupPaths } from '../setup/paths.js';
+import {
+  DEFAULT_RUNTIME_SETTINGS,
+  readRuntimeSettings,
+  runtimeSettingsWithOverrides
+} from '../system/runtime-settings.js';
 import { parseLocalRuntimeOptions } from './local-runtime-options.js';
 
 export async function runLocalRuntimeCommand(command, args, dependencies = {}) {
@@ -13,8 +18,24 @@ export async function runLocalRuntimeCommand(command, args, dependencies = {}) {
   const resolvePaths = dependencies.resolvePaths ?? resolveSetupPaths;
   const env = dependencies.env ?? process.env;
   const paths = resolvePaths({ dataDir: options.dataDir, env });
+  const readSettings = dependencies.readSettings ?? readRuntimeSettings;
+  const savedSettings = paths.runtimeSettingsPath
+    ? readSettings(paths.runtimeSettingsPath)
+    : DEFAULT_RUNTIME_SETTINGS;
+  const runtimeSettings = runtimeSettingsWithOverrides(savedSettings, {
+    consolePort: options.port,
+    lanAccess: options.lan
+  });
   const write = dependencies.write ?? writeLine;
-  const input = { ...options, paths, env, onProgress: write };
+  const input = {
+    ...options,
+    port: runtimeSettings.ports.console,
+    lan: runtimeSettings.lanAccess,
+    runtimeSettings,
+    paths,
+    env,
+    onProgress: write
+  };
   const handlers = {
     start: dependencies.start ?? startLocalRuntime,
     stop: dependencies.stop ?? stopLocalRuntime,
@@ -39,37 +60,39 @@ export async function runLocalRuntimeCommand(command, args, dependencies = {}) {
 
 export function formatLocalRuntimeResult(command, result) {
   if (command === 'start') {
-    const verb = result.status === 'running' ? '已经在运行' : '已启动';
-    return formatStartedRuntime(`Fuli 本地服务${verb}。`, result);
+    const title = result.status === 'running'
+      ? 'Fuli local services are already running.'
+      : 'Fuli local services started.';
+    return formatStartedRuntime(title, result);
   }
   if (command === 'restart') {
-    return formatStartedRuntime('Fuli 本地服务已重启。', result);
+    return formatStartedRuntime('Fuli local services restarted.', result);
   }
   if (command === 'stop') {
     if (result.status === 'partial') {
       return [
-        'Fuli 本地 Provider 已停止，但没有终止无法验证身份的界面进程。',
-        '请执行 fl status 检查，避免误停其他进程。'
+        'The local Fuli Provider stopped, but the unverified UI process was left running.',
+        'Run fl status to inspect it without risking another process.'
       ].join('\n');
     }
     return result.console === 'not_running' && result.providers === 'not_initialized'
-      ? 'Fuli 本地服务尚未初始化。'
-      : 'Fuli 本地服务已停止，图谱数据已保留。';
+      ? 'Fuli local services have not been initialized.'
+      : 'Fuli local services stopped. Graph data was preserved.';
   }
-  if (command === 'open') return `已打开：${result.url}`;
+  if (command === 'open') return `Opened: ${result.url}`;
   if (command === 'status') return formatStatus(result);
   throw new TypeError(`Unknown local runtime command: ${command}`);
 }
 
 function formatStartedRuntime(title, result) {
-  const lines = [title, `管理界面：${result.url}`];
+  const lines = [title, `Management UI: ${result.url}`];
   if (result.lan === true) {
     lines.push(
-      '局域网界面：',
+      'LAN URLs:',
       ...result.lanUrls.map((url) => `  ${url}`),
-      `访问用户名：${result.lanAccess.username}`,
-      `临时访问口令：${result.lanAccess.accessCode}`,
-      '仅在可信 Wi-Fi 中使用；重新启动局域网模式会更换口令。'
+      `Username: ${result.lanAccess.username}`,
+      `Temporary access code: ${result.lanAccess.accessCode}`,
+      'Use only on trusted Wi-Fi. Restarting LAN mode rotates the access code.'
     );
   }
   return lines.join('\n');
@@ -77,24 +100,24 @@ function formatStartedRuntime(title, result) {
 
 function formatStatus(result) {
   const labels = {
-    running: '运行中',
-    degraded: '部分可用',
-    stopped: '已停止',
-    not_configured: '未初始化',
-    ready: '可用',
-    unavailable: '不可用',
-    not_connected: '未连接',
-    not_configured_provider: '未配置',
-    unverified: '身份未验证'
+    running: 'running',
+    degraded: 'degraded',
+    stopped: 'stopped',
+    not_configured: 'not initialized',
+    ready: 'ready',
+    unavailable: 'unavailable',
+    not_connected: 'not connected',
+    not_configured_provider: 'not configured',
+    unverified: 'identity unverified'
   };
   const publicSummary = result.public.configured
-    ? `${labels[result.public.status] ?? result.public.status}（${result.public.providers.length} 个 Provider）`
+    ? `${labels[result.public.status] ?? result.public.status} (${result.public.providers.length} Providers)`
     : labels.not_connected;
   return [
-    `Fuli 本地状态：${labels[result.status] ?? result.status}`,
-    `管理界面：${labels[result.console.status] ?? result.console.status} · ${result.console.url}`,
-    `个人图谱：${providerLabel(result.personal.status, labels)}`,
-    `公共服务：${publicSummary}`
+    `Fuli local status: ${labels[result.status] ?? result.status}`,
+    `Management UI: ${labels[result.console.status] ?? result.console.status} · ${result.console.url}`,
+    `Personal graph: ${providerLabel(result.personal.status, labels)}`,
+    `Shared services: ${publicSummary}`
   ].join('\n');
 }
 

package/src/cli/local-runtime-options.js

@@ -1,5 +1,3 @@
-import { DEFAULT_FULI_PORT } from '../defaults.js';
-
 const VALUE_OPTIONS = Object.freeze({
   '--data-dir': 'dataDir',
   '--personal-space': 'personalSpaceName',
@@ -9,15 +7,16 @@ const VALUE_OPTIONS = Object.freeze({
 const BOOLEAN_OPTIONS = Object.freeze({
   '--open': 'open',
   '--rebuild': 'rebuild',
-  '--lan': 'lan',
   '--json': 'json'
 });
 
 const ALLOWED_BY_COMMAND = Object.freeze({
-  start: new Set(['--data-dir', '--personal-space', '--port', '--open', '--rebuild', '--lan']),
+  start: new Set([
+    '--data-dir', '--personal-space', '--port', '--open', '--rebuild', '--lan', '--no-lan'
+  ]),
   stop: new Set(['--data-dir']),
   restart: new Set([
-    '--data-dir', '--personal-space', '--port', '--open', '--rebuild', '--lan'
+    '--data-dir', '--personal-space', '--port', '--open', '--rebuild', '--lan', '--no-lan'
   ]),
   status: new Set(['--data-dir', '--port', '--json']),
   open: new Set(['--data-dir'])
@@ -28,11 +27,11 @@ export function parseLocalRuntimeOptions(command, args = []) {
   if (!allowed) throw new TypeError(`Unknown local runtime command: ${command}`);
   const result = {
     dataDir: null,
-    personalSpaceName: '我',
-    port: DEFAULT_FULI_PORT,
+    personalSpaceName: 'Personal',
+    port: null,
     open: false,
     rebuild: false,
-    lan: false,
+    lan: null,
     json: false
   };
   const seen = new Set();
@@ -43,6 +42,13 @@ export function parseLocalRuntimeOptions(command, args = []) {
     if (seen.has(flag)) throw new TypeError(`Duplicate ${flag}`);
     seen.add(flag);
 
+    if (flag === '--lan' || flag === '--no-lan') {
+      const conflicting = flag === '--lan' ? '--no-lan' : '--lan';
+      if (seen.has(conflicting)) throw new TypeError('--lan and --no-lan cannot be combined');
+      result.lan = flag === '--lan';
+      continue;
+    }
+
     const booleanKey = BOOLEAN_OPTIONS[flag];
     if (booleanKey) {
       result[booleanKey] = true;

package/src/cli/setup-agent-selection.js

@@ -27,15 +27,15 @@ export function parseAgentSelection(value, agents) {
 
   const tokens = answer.split(/[\s,，]+/).filter(Boolean);
   if (tokens.includes('0')) {
-    throw new TypeError('0 不能与其他编号同时使用');
+    throw new TypeError('0 cannot be combined with another number');
   }
   if (tokens.some((token) => !/^\d+$/.test(token))) {
-    throw new TypeError('请输入编号，不要输入 Agent 名称');
+    throw new TypeError('Enter numbers, not Agent names');
   }
 
   const positions = new Set(tokens.map(Number));
   if ([...positions].some((position) => position < 1 || position > agents.length)) {
-    throw new RangeError(`可选范围是 1-${agents.length}`);
+    throw new RangeError(`Choose a number from 1-${agents.length}`);
   }
   return agents
     .filter((_, index) => positions.has(index + 1))
@@ -86,21 +86,21 @@ export function selectedAgentIds(agents, state) {
 
 export function formatAgentCheckboxSelection(agents, state) {
   return [
-    '检测到多个可接入的 Agent：',
+    'Multiple supported Agents were detected:',
     ...agents.map((agent, index) => {
       const pointer = index === state.activeIndex ? '❯' : ' ';
       const checkbox = state.selected[index] ? '[x]' : '[ ]';
       const status = integrationStatusLabel(agent.integrationStatus);
       return `${pointer} ${checkbox} ${agent.label}${status ? `  ${status}` : ''}`;
     }),
-    '↑/↓ 移动 · 空格切换 · A 全选/清空 · 回车确认'
+    '↑/↓ Move · Space Toggle · A Select/Clear all · Enter Confirm'
   ].join('\n');
 }
 
 function integrationStatusLabel(status) {
-  if (status === 'connected') return '已接入';
-  if (status === 'update_available') return '需更新';
-  if (status === 'not_connected') return '未接入';
+  if (status === 'connected') return 'connected';
+  if (status === 'update_available') return 'update available';
+  if (status === 'not_connected') return 'not connected';
   return '';
 }
 
@@ -147,7 +147,7 @@ async function promptCheckboxAgentSelection(agents, { input, output }) {
         return;
       }
       if (result.action === 'cancel') {
-        finish(() => reject(new Error('Setup 已取消')));
+        finish(() => reject(new Error('Setup cancelled')));
         return;
       }
       if (result.action === 'update') {
@@ -161,7 +161,7 @@ async function promptCheckboxAgentSelection(agents, { input, output }) {
 
 async function promptTextAgentSelection(agents, { input, output }) {
   const terminal = createInterface({ input, output });
-  output.write('检测到多个可接入的 Agent：\n');
+  output.write('Multiple supported Agents were detected:\n');
   for (const [index, agent] of agents.entries()) {
     output.write(`  ${index + 1}. ${agent.label}\n`);
   }
@@ -169,12 +169,12 @@ async function promptTextAgentSelection(agents, { input, output }) {
   try {
     while (true) {
       const answer = await terminal.question(
-        '选择要接入的 Agent（编号以逗号分隔，回车全选，0 跳过）[全部] '
+        'Select Agents (comma-separated numbers, Enter for all, 0 to skip) [all] '
       );
       try {
         return parseAgentSelection(answer, agents);
       } catch (error) {
-        output.write(`选择无效：${error.message}\n`);
+        output.write(`Invalid selection: ${error.message}\n`);
       }
     }
   } finally {