fengming 0.3.10 → 0.3.11

package/docs/.i18n/zh-Hans-navigation.json

@@ -1,552 +0,0 @@
-{
-  "language": "zh-Hans",
-  "tabs": [
-    {
-      "tab": "快速开始",
-      "groups": [
-        {
-          "group": "首页",
-          "pages": ["zh-CN/index"]
-        },
-        {
-          "group": "概览",
-          "pages": ["zh-CN/start/showcase"]
-        },
-        {
-          "group": "核心概念",
-          "pages": ["zh-CN/concepts/features"]
-        },
-        {
-          "group": "第一步",
-          "pages": ["zh-CN/start/getting-started", "zh-CN/start/wizard", "zh-CN/start/onboarding"]
-        },
-        {
-          "group": "指南",
-          "pages": ["zh-CN/start/fengming"]
-        }
-      ]
-    },
-    {
-      "tab": "安装",
-      "groups": [
-        {
-          "group": "安装概览",
-          "pages": ["zh-CN/install/index", "zh-CN/install/installer"]
-        },
-        {
-          "group": "安装方式",
-          "pages": [
-            "zh-CN/install/docker",
-            "zh-CN/install/nix",
-            "zh-CN/install/ansible",
-            "zh-CN/install/bun"
-          ]
-        },
-        {
-          "group": "维护",
-          "pages": ["zh-CN/install/updating", "zh-CN/install/migrating", "zh-CN/install/uninstall"]
-        },
-        {
-          "group": "托管与部署",
-          "pages": [
-            "zh-CN/vps",
-            "zh-CN/install/fly",
-            "zh-CN/install/hetzner",
-            "zh-CN/install/gcp",
-            "zh-CN/install/macos-vm",
-            "zh-CN/install/exe-dev",
-            "zh-CN/install/railway",
-            "zh-CN/install/render",
-            "zh-CN/install/northflank"
-          ]
-        },
-        {
-          "group": "高级",
-          "pages": ["zh-CN/install/development-channels"]
-        }
-      ]
-    },
-    {
-      "tab": "消息渠道",
-      "groups": [
-        {
-          "group": "概览",
-          "pages": ["zh-CN/channels/index"]
-        },
-        {
-          "group": "消息平台",
-          "pages": [
-            "zh-CN/channels/discord",
-            "zh-CN/channels/feishu",
-            "zh-CN/channels/grammy",
-            "zh-CN/channels/googlechat",
-            "zh-CN/channels/imessage",
-            "zh-CN/channels/line",
-            "zh-CN/channels/matrix",
-            "zh-CN/channels/mattermost",
-            "zh-CN/channels/msteams",
-            "zh-CN/channels/nextcloud-talk",
-            "zh-CN/channels/nostr",
-            "zh-CN/channels/signal",
-            "zh-CN/channels/slack",
-            "zh-CN/channels/telegram",
-            "zh-CN/channels/tlon",
-            "zh-CN/channels/twitch",
-            "zh-CN/channels/whatsapp",
-            "zh-CN/channels/zalo",
-            "zh-CN/channels/zalouser"
-          ]
-        },
-        {
-          "group": "配置",
-          "pages": [
-            "zh-CN/channels/pairing",
-            "zh-CN/channels/group-messages",
-            "zh-CN/channels/groups",
-            "zh-CN/channels/broadcast-groups",
-            "zh-CN/channels/channel-routing",
-            "zh-CN/channels/location",
-            "zh-CN/channels/troubleshooting"
-          ]
-        }
-      ]
-    },
-    {
-      "tab": "代理",
-      "groups": [
-        {
-          "group": "基础",
-          "pages": [
-            "zh-CN/pi",
-            "zh-CN/concepts/architecture",
-            "zh-CN/concepts/agent",
-            "zh-CN/concepts/agent-loop",
-            "zh-CN/concepts/system-prompt",
-            "zh-CN/concepts/context",
-            "zh-CN/concepts/agent-workspace",
-            "zh-CN/concepts/oauth"
-          ]
-        },
-        {
-          "group": "引导",
-          "pages": ["zh-CN/start/bootstrapping"]
-        },
-        {
-          "group": "会话与记忆",
-          "pages": [
-            "zh-CN/concepts/session",
-            "zh-CN/concepts/session-pruning",
-            "zh-CN/concepts/session-tool",
-            {
-              "group": "记忆",
-              "pages": [
-                "zh-CN/concepts/memory",
-                "zh-CN/concepts/memory-builtin",
-                "zh-CN/concepts/memory-qmd",
-                "zh-CN/concepts/memory-honcho",
-                "zh-CN/concepts/memory-search",
-                "zh-CN/concepts/active-memory",
-                "zh-CN/concepts/dreaming"
-              ]
-            },
-            "zh-CN/concepts/compaction"
-          ]
-        },
-        {
-          "group": "多代理",
-          "pages": ["zh-CN/concepts/multi-agent", "zh-CN/concepts/presence"]
-        },
-        {
-          "group": "消息与投递",
-          "pages": [
-            "zh-CN/concepts/messages",
-            "zh-CN/concepts/streaming",
-            "zh-CN/concepts/retry",
-            "zh-CN/concepts/queue"
-          ]
-        }
-      ]
-    },
-    {
-      "tab": "工具",
-      "groups": [
-        {
-          "group": "概览",
-          "pages": ["zh-CN/tools/index"]
-        },
-        {
-          "group": "内置工具",
-          "pages": [
-            "zh-CN/tools/apply-patch",
-            "zh-CN/brave-search",
-            "zh-CN/tools/elevated",
-            "zh-CN/tools/exec",
-            "zh-CN/tools/exec-approvals",
-            "zh-CN/tools/firecrawl",
-            "zh-CN/tools/llm-task",
-            "zh-CN/tools/lobster",
-            "zh-CN/perplexity",
-            "zh-CN/tools/reactions",
-            "zh-CN/tools/thinking",
-            "zh-CN/tools/web"
-          ]
-        },
-        {
-          "group": "浏览器",
-          "pages": [
-            "zh-CN/tools/browser",
-            "zh-CN/tools/browser-login",
-            "zh-CN/tools/browser-linux-troubleshooting"
-          ]
-        },
-        {
-          "group": "代理协作",
-          "pages": [
-            "zh-CN/tools/agent-send",
-            "zh-CN/tools/subagents",
-            "zh-CN/tools/multi-agent-sandbox-tools"
-          ]
-        },
-        {
-          "group": "技能",
-          "pages": [
-            "zh-CN/tools/creating-skills",
-            "zh-CN/tools/slash-commands",
-            "zh-CN/tools/skills",
-            "zh-CN/tools/skills-config",
-            "zh-CN/tools/plugin"
-          ]
-        },
-        {
-          "group": "扩展",
-          "pages": [
-            "zh-CN/plugins/voice-call",
-            "zh-CN/plugins/zalouser",
-            "zh-CN/plugins/manifest",
-            "zh-CN/plugins/agent-tools",
-            "zh-CN/prose"
-          ]
-        },
-        {
-          "group": "自动化与任务",
-          "pages": ["zh-CN/automation/hooks", "zh-CN/automation/cron-jobs"]
-        },
-        {
-          "group": "媒体与设备",
-          "pages": [
-            "zh-CN/nodes/index",
-            "zh-CN/nodes/troubleshooting",
-            "zh-CN/nodes/media-understanding",
-            "zh-CN/nodes/images",
-            "zh-CN/nodes/audio",
-            "zh-CN/nodes/camera",
-            "zh-CN/nodes/talk",
-            "zh-CN/nodes/voicewake",
-            "zh-CN/nodes/location-command",
-            "zh-CN/tts"
-          ]
-        }
-      ]
-    },
-    {
-      "tab": "模型",
-      "groups": [
-        {
-          "group": "概览",
-          "pages": ["zh-CN/providers/index", "zh-CN/providers/models"]
-        },
-        {
-          "group": "模型概念",
-          "pages": ["zh-CN/concepts/models"]
-        },
-        {
-          "group": "配置",
-          "pages": ["zh-CN/concepts/model-providers", "zh-CN/concepts/model-failover"]
-        },
-        {
-          "group": "提供商",
-          "pages": [
-            "zh-CN/providers/anthropic",
-            "zh-CN/providers/bedrock",
-            "zh-CN/providers/claude-max-api-proxy",
-            "zh-CN/providers/deepgram",
-            "zh-CN/providers/github-copilot",
-            "zh-CN/providers/moonshot",
-            "zh-CN/providers/minimax",
-            "zh-CN/providers/opencode",
-            "zh-CN/providers/ollama",
-            "zh-CN/providers/openai",
-            "zh-CN/providers/openrouter",
-            "zh-CN/providers/qianfan",
-            "zh-CN/providers/qwen",
-            "zh-CN/providers/synthetic",
-            "zh-CN/providers/venice",
-            "zh-CN/providers/vercel-ai-gateway",
-            "zh-CN/providers/xiaomi",
-            "zh-CN/providers/zai"
-          ]
-        }
-      ]
-    },
-    {
-      "tab": "平台",
-      "groups": [
-        {
-          "group": "平台概览",
-          "pages": [
-            "zh-CN/platforms/index",
-            "zh-CN/platforms/macos",
-            "zh-CN/platforms/linux",
-            "zh-CN/platforms/windows",
-            "zh-CN/platforms/android",
-            "zh-CN/platforms/ios",
-            "zh-CN/platforms/digitalocean",
-            "zh-CN/platforms/oracle",
-            "zh-CN/platforms/raspberry-pi"
-          ]
-        },
-        {
-          "group": "macOS 配套应用",
-          "pages": [
-            "zh-CN/platforms/mac/dev-setup",
-            "zh-CN/platforms/mac/menu-bar",
-            "zh-CN/platforms/mac/voicewake",
-            "zh-CN/platforms/mac/voice-overlay",
-            "zh-CN/platforms/mac/webchat",
-            "zh-CN/platforms/mac/canvas",
-            "zh-CN/platforms/mac/child-process",
-            "zh-CN/platforms/mac/health",
-            "zh-CN/platforms/mac/icon",
-            "zh-CN/platforms/mac/logging",
-            "zh-CN/platforms/mac/permissions",
-            "zh-CN/platforms/mac/remote",
-            "zh-CN/platforms/mac/signing",
-            "zh-CN/platforms/mac/bundled-gateway",
-            "zh-CN/platforms/mac/xpc",
-            "zh-CN/platforms/mac/skills",
-            "zh-CN/platforms/mac/peekaboo"
-          ]
-        }
-      ]
-    },
-    {
-      "tab": "网关与运维",
-      "groups": [
-        {
-          "group": "网关",
-          "pages": [
-            "zh-CN/gateway/index",
-            {
-              "group": "配置与运维",
-              "pages": [
-                "zh-CN/gateway/configuration",
-                "zh-CN/gateway/configuration-examples",
-                "zh-CN/gateway/authentication",
-                "zh-CN/gateway/health",
-                "zh-CN/gateway/heartbeat",
-                "zh-CN/gateway/doctor",
-                "zh-CN/gateway/logging",
-                "zh-CN/gateway/gateway-lock",
-                "zh-CN/gateway/background-process",
-                "zh-CN/gateway/multiple-gateways",
-                "zh-CN/gateway/troubleshooting"
-              ]
-            },
-            {
-              "group": "安全与沙箱",
-              "pages": [
-                "zh-CN/gateway/security/index",
-                "zh-CN/gateway/sandboxing",
-                "zh-CN/gateway/sandbox-vs-tool-policy-vs-elevated"
-              ]
-            },
-            {
-              "group": "协议与 API",
-              "pages": [
-                "zh-CN/gateway/protocol",
-                "zh-CN/gateway/bridge-protocol",
-                "zh-CN/gateway/openai-http-api",
-                "zh-CN/gateway/openresponses-http-api",
-                "zh-CN/gateway/tools-invoke-http-api",
-                "zh-CN/gateway/cli-backends",
-                "zh-CN/gateway/local-models"
-              ]
-            },
-            {
-              "group": "网络与发现",
-              "pages": [
-                "zh-CN/gateway/network-model",
-                "zh-CN/gateway/pairing",
-                "zh-CN/gateway/discovery",
-                "zh-CN/gateway/bonjour"
-              ]
-            }
-          ]
-        },
-        {
-          "group": "远程访问",
-          "pages": [
-            "zh-CN/gateway/remote",
-            "zh-CN/gateway/remote-gateway-readme",
-            "zh-CN/gateway/tailscale"
-          ]
-        },
-        {
-          "group": "运维专题",
-          "pages": ["zh-CN/network", "zh-CN/logging"]
-        },
-        {
-          "group": "安全",
-          "pages": ["zh-CN/security/formal-verification"]
-        },
-        {
-          "group": "Web 界面",
-          "pages": [
-            "zh-CN/web/index",
-            "zh-CN/web/control-ui",
-            "zh-CN/web/dashboard",
-            "zh-CN/web/webchat",
-            "zh-CN/web/tui"
-          ]
-        }
-      ]
-    },
-    {
-      "tab": "参考",
-      "groups": [
-        {
-          "group": "CLI 命令",
-          "pages": [
-            "zh-CN/cli/index",
-            "zh-CN/cli/acp",
-            "zh-CN/cli/agent",
-            "zh-CN/cli/agents",
-            "zh-CN/cli/approvals",
-            "zh-CN/cli/browser",
-            "zh-CN/cli/channels",
-            "zh-CN/cli/config",
-            "zh-CN/cli/configure",
-            "zh-CN/cli/cron",
-            "zh-CN/cli/dashboard",
-            "zh-CN/cli/devices",
-            "zh-CN/cli/directory",
-            "zh-CN/cli/dns",
-            "zh-CN/cli/docs",
-            "zh-CN/cli/doctor",
-            "zh-CN/cli/gateway",
-            "zh-CN/cli/health",
-            "zh-CN/cli/hooks",
-            "zh-CN/cli/logs",
-            "zh-CN/cli/memory",
-            "zh-CN/cli/message",
-            "zh-CN/cli/models",
-            "zh-CN/cli/node",
-            "zh-CN/cli/nodes",
-            "zh-CN/cli/onboard",
-            "zh-CN/cli/pairing",
-            "zh-CN/cli/plugins",
-            "zh-CN/cli/reset",
-            "zh-CN/cli/sandbox",
-            "zh-CN/cli/security",
-            "zh-CN/cli/sessions",
-            "zh-CN/cli/setup",
-            "zh-CN/cli/skills",
-            "zh-CN/cli/status",
-            "zh-CN/cli/system",
-            "zh-CN/cli/tui",
-            "zh-CN/cli/uninstall",
-            "zh-CN/cli/update",
-            "zh-CN/cli/voicecall",
-            "zh-CN/cli/webhooks"
-          ]
-        },
-        {
-          "group": "RPC 与 API",
-          "pages": ["zh-CN/reference/rpc", "zh-CN/reference/device-models"]
-        },
-        {
-          "group": "模板",
-          "pages": [
-            "zh-CN/reference/AGENTS.default",
-            "zh-CN/reference/templates/AGENTS",
-            "zh-CN/reference/templates/BOOT",
-            "zh-CN/reference/templates/BOOTSTRAP",
-            "zh-CN/reference/templates/HEARTBEAT",
-            "zh-CN/reference/templates/IDENTITY",
-            "zh-CN/reference/templates/SOUL",
-            "zh-CN/reference/templates/TOOLS",
-            "zh-CN/reference/templates/USER"
-          ]
-        },
-        {
-          "group": "技术参考",
-          "pages": [
-            "zh-CN/reference/wizard",
-            "zh-CN/reference/token-use",
-            "zh-CN/reference/api-usage-costs",
-            "zh-CN/reference/transcript-hygiene",
-            "zh-CN/date-time"
-          ]
-        },
-        {
-          "group": "概念内部机制",
-          "pages": [
-            "zh-CN/concepts/typebox",
-            "zh-CN/concepts/markdown-formatting",
-            "zh-CN/concepts/typing-indicators",
-            "zh-CN/concepts/usage-tracking",
-            "zh-CN/concepts/timezone"
-          ]
-        },
-        {
-          "group": "项目",
-          "pages": ["zh-CN/reference/credits"]
-        },
-        {
-          "group": "发布策略",
-          "pages": ["zh-CN/reference/RELEASING", "zh-CN/reference/test"]
-        }
-      ]
-    },
-    {
-      "tab": "帮助",
-      "groups": [
-        {
-          "group": "帮助",
-          "pages": ["zh-CN/help/index", "zh-CN/help/troubleshooting", "zh-CN/help/faq"]
-        },
-        {
-          "group": "社区",
-          "pages": ["zh-CN/start/lore"]
-        },
-        {
-          "group": "环境与调试",
-          "pages": [
-            "zh-CN/help/environment",
-            "zh-CN/help/debugging",
-            "zh-CN/help/testing",
-            "zh-CN/help/scripts",
-            "zh-CN/debug/node-issue",
-            "zh-CN/diagnostics/flags"
-          ]
-        },
-        {
-          "group": "Node 运行时",
-          "pages": ["zh-CN/install/node"]
-        },
-        {
-          "group": "压缩机制内部参考",
-          "pages": ["zh-CN/reference/session-management-compaction"]
-        },
-        {
-          "group": "开发者设置",
-          "pages": ["zh-CN/start/setup", "zh-CN/pi-dev"]
-        },
-        {
-          "group": "文档元信息",
-          "pages": ["zh-CN/start/hubs", "zh-CN/start/docs-directory", "zh-CN/AGENTS"]
-        }
-      ]
-    }
-  ]
-}

package/docs/AGENTS.md

@@ -1,36 +0,0 @@
-# Docs Guide
-
-This directory owns docs authoring, Mintlify link rules, and docs i18n policy.
-
-## Mintlify Rules
-
-- Docs are hosted on Mintlify (`https://docs.fengming.ai`).
-- Internal doc links in `docs/**/*.md` must stay root-relative with no `.md` or `.mdx` suffix (example: `[Config](/gateway/configuration)`).
-- Section cross-references should use anchors on root-relative paths (example: `[Hooks](/gateway/configuration-reference#hooks)`).
-- Doc headings should avoid em dashes and apostrophes because Mintlify anchor generation is brittle there.
-- README and other GitHub-rendered docs should keep absolute docs URLs so links work outside Mintlify.
-- Docs content must stay generic: no personal device names, hostnames, or local paths; use placeholders like `user@gateway-host`.
-
-## Docs Content Rules
-
-- For docs, UI copy, and picker lists, order services/providers alphabetically unless the section is explicitly describing runtime order or auto-detection order.
-- Keep bundled plugin naming consistent with the repo-wide plugin terminology rules in the root `AGENTS.md`.
-
-## Internal Docs
-
-- Long-lived private operator docs belong in `~/Projects/manager/docs/`.
-- Repo-local internal scratch/mirror docs may live under ignored `docs/internal/`.
-- Never add `docs/internal/**` pages to `docs/docs.json` navigation or link them from public docs.
-- `scripts/docs-sync-publish.mjs` excludes and prunes `docs/internal/**` from the public `fengming/docs` publish repo if a page is force-added later.
-- Internal docs may mention repo paths, private app names, 1Password item names, and runbooks, but never include secret values.
-
-## Docs i18n
-
-- Foreign-language docs are not maintained in this repo. The generated publish output lives in the separate `fengming/docs` repo (often cloned locally as `../fengming-docs`).
-- Do not add or edit localized docs under `docs/<locale>/**` here.
-- Treat English docs in this repo plus glossary files as the source of truth.
-- Pipeline: update English docs here, update `docs/.i18n/glossary.<locale>.json` as needed, then let the publish-repo sync and `scripts/docs-i18n` run in `fengming/docs`.
-- Before rerunning `scripts/docs-i18n`, add glossary entries for any new technical terms, page titles, or short nav labels that must stay in English or use a fixed translation.
-- `pnpm docs:check-i18n-glossary` is the guard for changed English doc titles and short internal doc labels.
-- Translation memory lives in generated `docs/.i18n/*.tm.jsonl` files in the publish repo.
-- See `docs/.i18n/README.md`.

package/docs/CLAUDE.md

@@ -1 +0,0 @@
-AGENTS.md

package/docs/agent-runtime-architecture.md

@@ -1,48 +0,0 @@
----
-title: "Agent runtime architecture"
-summary: "How FengMing runs the built-in agent runtime, providers, sessions, tools, and extensions."
----
-
-FengMing owns the built-in agent runtime directly. The runtime code lives under `src/agents/`, model/provider helpers live under `src/llm/`, and plugin-facing contracts are exposed through `fengming/plugin-sdk/*` barrels.
-
-## Runtime Layout
-
-- `src/agents/embedded-agent-runner/`: built-in agent attempt loop, provider stream adapters, compaction, model selection, and session wiring.
-- `src/agents/sessions/`: session persistence, extension loading, resource discovery, skills, prompts, themes, and TUI-backed tool renderers.
-- `packages/agent-core/`: reusable agent core, lower-level harness types, messages, compaction helpers, prompt templates, and tool/session contracts.
-- `src/agents/runtime/`: FengMing facade for `@fengming/agent-core` plus local proxy utilities.
-- `src/agents/agent-tools*.ts`: FengMing-owned tool definitions, schemas, policy, before/after hook adapters, and host edit support.
-- `src/agents/agent-hooks/`: built-in runtime hooks such as compaction safeguards and context pruning.
-- `src/llm/`: model/provider registry, transport helpers, and provider-specific stream implementations.
-
-## Boundaries
-
-Core code calls the built-in runtime through FengMing modules and SDK barrels, not through old external agent packages. Plugins use documented `fengming/plugin-sdk/*` entrypoints and do not import `src/**` internals.
-
-`@earendil-works/pi-tui` remains a third-party TUI dependency. It is used as a terminal component toolkit by the local TUI and session renderers; internalizing it would be a separate vendoring effort.
-
-## Manifests
-
-Resource packages declare FengMing resources in package metadata:
-
-```json
-{
-  "fengming": {
-    "extensions": ["extensions/index.ts"],
-    "skills": ["skills/*.md"],
-    "prompts": ["prompts/*.md"],
-    "themes": ["themes/*.json"]
-  }
-}
-```
-
-The package manager also discovers conventional `extensions/`, `skills/`, `prompts/`, and `themes/` directories.
-
-## Runtime Selection
-
-The default built-in runtime id is `fengming`. Plugin harnesses can register additional runtime ids. `auto` selects a supporting plugin harness when one exists and otherwise uses the built-in FengMing runtime.
-
-## Related
-
-- [FengMing agent runtime workflow](/fengming-agent-runtime)
-- [Agent runtimes](/concepts/agent-runtimes)