A small forum works when everyone keeps it useful and kind. A few things worth knowing.一个小论坛，靠大家保持有用与友善才能运转。几点值得先了解。
-
-
Be kind & on-topic友善、切题
Assume good faith, search before asking, and keep threads focused. Format code in fenced ``` blocks.与人为善、提问前先搜索、保持话题聚焦。代码请放进 ``` 围栏块。
-
Trust levels信任等级
Everyone signs in with their Reasonix account. New accounts start limited — no links, a small daily post cap — and unlock more as they read and contribute. It keeps the forum spam-free without getting in real members' way.所有人用 Reasonix 账号登录。新账号有限制——不能发链接、每日发帖上限较低——随着阅读与贡献逐步解锁。既挡住广告，又不妨碍真实成员。
-
Moderation审核
Flag anything off — a few flags auto-hide a post for review. Moderators can restrict accounts that abuse the forum. All moderator actions are logged.发现不妥就举报——几次举报会自动隐藏帖子待审。版主可限制滥用论坛的账号。所有版主操作都有记录。
-
-
diff --git a/site/src/pages/community/index.astro b/site/src/pages/community/index.astro
deleted file mode 100644
index 813af44734..0000000000
--- a/site/src/pages/community/index.astro
+++ /dev/null
@@ -1,58 +0,0 @@
----
-import Community from "../../layouts/Community.astro";
----
-
-
-
-
-
-
Reasonix CommunityReasonix 社区
-
Discussions讨论区
-
Ask questions, share skills, and shape a DeepSeek-native agent — with the makers and other builders.提问、分享技能、一起打磨这个 DeepSeek 原生 Agent —— 和作者及其他构建者。
Please search before posting, keep it on-topic, and format code in fenced blocks. New accounts can't post links until they've participated a little.发帖前请先搜索、保持切题、代码放进围栏块。新账号需参与一段时间后才能发链接。
-
-
-
diff --git a/site/src/pages/community/topic.astro b/site/src/pages/community/topic.astro
deleted file mode 100644
index b5818f23b5..0000000000
--- a/site/src/pages/community/topic.astro
+++ /dev/null
@@ -1,42 +0,0 @@
----
-import Community from "../../layouts/Community.astro";
----
-
-
Install, configure, and run coding work locally.安装、配置，并在本地运行编码任务。
-
This page is the concise website guide. It covers the normal path first, then links out to the full repo docs when you need every field or internal contract.这是官网上的精简使用说明：先讲最常用路径，再把完整字段和工程契约链接到仓库文档。
Install the terminal app with one command on macOS, Linux, Windows, or WSL. reasonix opens the interactive TUI; reasonix run is the headless automation entry.一条命令安装终端应用,支持 macOS、Linux、Windows 或 WSL。reasonix 打开交互式 TUI；reasonix run 用于无界面自动执行。
You live in the terminal, want fast repo work, or need scriptable reasonix run automation.你主要在终端工作、需要快速处理仓库任务，或要用 reasonix run 做自动化。
-
-
- Use the desktop app when适合用桌面端
-
You want visual sessions, settings, MCP status, checkpoints, approvals, and bot connections in one place.你希望在一个界面里管理会话、设置、MCP 状态、checkpoint、审批和 Bot 连接。
-
-
-
- Terminal-first workflow终端优先工作流
-
-
Interactive TUI with Plan, Ask, Auto, YOLO, transcript scrolling, and tool approval prompts.交互式 TUI 支持 Plan、Ask、Auto、YOLO、对话滚动与工具审批提示。
-
Drag-select transcript text to copy through the verified local system clipboard; SSH uses a clearly labelled OSC 52 fallback. Run /mouse to use your terminal's native selection instead.拖选对话文本会通过可验证的本地系统剪贴板复制；SSH 使用明确标记的 OSC 52 回退。也可用 /mouse 切回终端原生选择。
-
Text paste stays terminal-native. Image paste is explicit: Ctrl+V on macOS/Linux, Alt+V on Windows, or /paste-image, with a live Pasting image… footer state.文本粘贴保持终端原生；图片粘贴使用独立入口：macOS/Linux 按 Ctrl+V，Windows 按 Alt+V，或运行 /paste-image，读取时底栏显示“正在粘贴图片…”。
-
Scriptable runs through reasonix run, including piped input and explicit model selection.可脚本化的 reasonix run,支持管道输入和显式模型选择。
-
-
-
!To install the legacy 0.x version, pin it explicitly with npm i -g reasonix@0.53.2. The commands above, Homebrew, and desktop/release downloads install Reasonix 1.x; the current desktop download build is {goVer}.如需安装 legacy 0.x 版本,请显式 pin: npm i -g reasonix@0.53.2。上方命令、Homebrew 与桌面端/Release 下载对应 Reasonix 1.x；当前桌面端下载构建为 {goVer}。
-
-
Desktop app桌面端
-
-
- Native app · {goVer}原生桌面端 · {goVer}
-
Use Reasonix with a full desktop workspace用完整桌面工作区运行 Reasonix
-
The desktop app runs the same local Reasonix engine as the CLI, with visual sessions, settings, MCP status, memory, checkpoints, tool approvals, and IM bot connections in one place.桌面端运行与 CLI 相同的本地 Reasonix 引擎,并把可视化会话、设置、MCP 状态、记忆、检查点、工具审批和 IM Bot 连接集中到一个工作区。
Open and resume project sessions from a visual sidebar.从可视化侧边栏打开和恢复项目会话。
-
Approve tools, review checkpoints, and rewind code or conversation without leaving the app.在应用内审批工具、查看 checkpoint,并回退代码或对话。
-
Connect Feishu, Lark, or WeChat bots from Settings and handle remote approvals locally.在设置中连接飞书、Lark 或微信 Bot,并在本地处理远程审批。
-
-
-
macOS quarantine warningmacOS 隔离属性提示
-
Use this only when Reasonix was downloaded from the official site or GitHub release, moved to /Applications, and macOS still says the app cannot be opened, cannot be verified, or is damaged. This removes the quarantine flag that macOS attaches to downloaded apps.仅在 Reasonix 来自官网或 GitHub Release、已经放入 /Applications,但 macOS 仍提示“无法打开”“无法验证开发者”或“应用已损坏”时使用。它会移除 macOS 给下载应用附加的隔离属性。
-
# Quit Reasonix first, then run in Terminal.
-sudo xattr -rd com.apple.quarantine /Applications/Reasonix.app
-
!Only run this for an official Reasonix app you trust. If the app is installed somewhere else, replace /Applications/Reasonix.app with that exact app path, then reopen Reasonix.只对可信的官方 Reasonix 应用执行这条命令。如果安装在其他位置,请把 /Applications/Reasonix.app 替换为实际 app 路径,然后重新打开 Reasonix。
-
-
Quick start快速上手
-
First run is minimal — reasonix setup walks you through picking a provider and key, then saves it under Reasonix home. Then point Reasonix at a repo and start a session:首次运行很简单——reasonix setup 引导你选择 provider 并填写密钥,然后保存到 Reasonix home。接着指向仓库、开始会话:
-
cd your-project
-reasonix
-
Then just describe the task:然后直接描述任务:
-
› add retry with backoff to the http client
-› refactor the auth flow, keep the public API stable
-› why is the worker leaking memory?
-
Run /init when you want project memory, then leave the session running — context is append-only, so every new turn starts from a cache hit instead of a cold start.需要项目记忆时运行 /init,然后让会话持续运行——上下文只追加,每一轮都从缓存命中开始,而不是冷启动。
-
-
Web frontendWeb 前端
-
reasonix web starts the same local Reasonix engine and opens its browser UI. Inside the CLI, /web hands the current session to that UI. Keep reasonix serve for supervisors, tunnels, reverse proxies, and remote development boxes.reasonix web 会启动同一个本地 Reasonix 引擎并打开浏览器 UI；在 CLI 中执行 /web 可把当前会话交接到该界面。进程托管、tunnel、反向代理和远程开发机继续使用 reasonix serve。
-
cd your-project
-reasonix web
-
- Browser UI浏览器界面
-
Chat, approvals, goals, todos, and balance聊天、审批、Goal、Todo 与余额
-
-
Use chat, tool approvals, session history, rewind, fork, summarize, model switching, and reasoning-effort controls from the browser.在浏览器里使用聊天、工具审批、会话历史、rewind、fork、summarize、模型切换与 reasoning effort 控件。
-
Start or inspect Goal work, and follow the live todo panel fed by the todo_write tool.启动或查看 Goal,并跟随由 todo_write 工具驱动的实时 Todo 面板。
-
Show provider balance when configured; pass --model, --max-steps, or --resume for one-off launches.已配置 provider 时显示余额；临时启动可传 --model、--max-steps 或 --resume。
-
-
-
reasonix web starts at 127.0.0.1:8787, walks upward when the port is busy, and defaults to an automatically generated token. reasonix serve keeps its config-driven auth_mode = "none" default; enable auth before making Serve reachable from another machine.reasonix web 从 127.0.0.1:8787 开始监听，端口占用时自动递增，并默认生成 Token。reasonix serve 保持由配置决定的 auth_mode = "none" 默认值；如果其他机器可以访问 Serve，请先开启认证。
-
# token auth prints a share URL with #token=...
-reasonix serve --auth token
-reasonix serve --addr 0.0.0.0:8787 --auth token
-
-# password auth can use a startup password or a stored bcrypt hash
-reasonix serve --auth password --password 'temporary-password'
-reasonix serve --hash-password --password 'strong-password'
Reasonix talks directly to configured OpenAI-compatible providers such as DeepSeek or MiMo with your own API keys. Provider config stores only the key name in api_key_env; the actual secret saved by reasonix setup or desktop Settings lives in the global <Reasonix home>/.env.Reasonix 使用你自己的 API Key 直连配置好的 OpenAI-compatible provider,例如 DeepSeek 或 MiMo。Provider 配置只在 api_key_env 里记录密钥名称；通过 reasonix setup 或桌面端设置保存的真实密钥会写入全局 <Reasonix home>/.env。
-
reasonix setup
-# saves provider keys to <Reasonix home>/.env, for example:
-DEEPSEEK_API_KEY=sk-...
-
Project .env files are not provider-key fallbacks. They are only used for workspace-scoped variable expansion in MCP/plugin settings. Persistent options live in the config file.项目 .env 不是 provider key 的 fallback。它只用于 MCP/plugin 配置里的工作区级变量展开。持久化选项见配置文件。
-
-
Global secret file全局密钥文件<Reasonix home>/.env
-
Project config项目配置./reasonix.toml
-
User config用户配置~/.reasonix/config.toml
-
-
-
Prefix cache前缀缓存
-
DeepSeek bills cached prefix tokens at a fraction of fresh computation. Most agents waste this: they reorder messages, rewrite summaries mid-session, or inject volatile timestamps — every change invalidates the cache from that point on.DeepSeek 对缓存前缀 token 的计费远低于新计算。多数智能体浪费了这一点:重排消息、会话中改写摘要、注入易变的时间戳——任何改动都会让其后的缓存全部失效。
-
Reasonix serializes context deterministically and only ever appends. The practical effect: hours-long sessions where 90%+ of every request replays from cache, and input-token cost collapses to ~1/5.Reasonix 以确定性方式序列化上下文,并且永远只追加。实际效果:数小时的会话中每次请求 90% 以上从缓存重放,输入 token 成本降到约 1/5。
-
Automatic compaction starts at 80% of the model context by default. Desktop Settings and reasonix config compact-ratio share the user-level value; choose 65–85%, or use --local for a project override. Lower values compact earlier and can reduce prefix-cache reuse.自动压缩默认在模型上下文达到 80% 时启动。桌面端设置与 reasonix config compact-ratio 共用用户级设置；可在 65–85% 之间选择，也可用 --local 添加项目覆盖。阈值越低越早压缩，也可能降低前缀缓存复用率。
-
-
Permissions & sandbox权限与沙箱
-
Permissions gate each tool call: deny > ask > allow > fallback. Read-only tools generally pass; writers fall back to [permissions] mode. Ask is not read-only: an approved writer can still run. The sandbox is the enforced capability boundary. Headless reasonix run defaults to Ask and fails closed when a writer needs approval; use -y, --auto, or --permission-mode auto for intentional unattended writes. [permissions] allow_dynamic_bash = true is an advanced opt-in that lets an Allow fallback cover nested or indirect Bash. Explicit ask and deny rules still apply.权限逐个把关工具调用:deny > ask > allow > 兜底。只读工具通常放行；写工具回退到 [permissions] mode。Ask 不是只读：writer 获得批准后仍会执行；沙箱才是强制能力边界。无界面的 reasonix run 默认使用 Ask，写操作需要审批时会安全拒绝；要显式启用无人值守写入，请使用 -y、--auto 或 --permission-mode auto。高级用户可设置 [permissions] allow_dynamic_bash = true，让 Allow fallback 覆盖嵌套或间接 Bash。显式 ask 与 deny 规则仍然生效。
-
The sandbox is enforcement: file-writers refuse any path outside [sandbox] workspace_root (default: the current dir), resolving symlinks and .. so a link cannot tunnel out. bash = "enforce" jails shell commands when an OS sandbox backend is available (Seatbelt on macOS, bubblewrap on Linux); without one, bash is refused instead of running unconfined. Install the backend or set bash = "off" to explicitly restore the pre-1.16 unconfined behavior.沙箱负责强制执行:写文件工具拒绝 [sandbox] workspace_root(默认当前目录)之外的任何路径,并解析符号链接与 ..,防止借链接逃逸。bash = "enforce" 会在存在 OS 沙箱后端时隔离 shell 命令（macOS Seatbelt、Linux bubblewrap）；没有后端时会拒绝执行 bash，而不是非隔离运行。安装对应后端，或显式设置 bash = "off" 来恢复 1.16 之前的非隔离行为。
-
-
Extensions & sidecars扩展与 Sidecar
-
Plugin packages have two layers. Declarative contributions ship skills, agents, commands, prompts, hooks, MCP servers, and themes. A Manifest v2 runtime adds an out-of-process Sidecar speaking the stable Extension Protocol v1; it can intercept runtime events, own replacement strategies, contribute streaming model Providers, and publish structured UI. Native Manifest v2 is an explicit capability boundary: Reasonix loads only resources declared in reasonix-plugin.json and does not implicitly import host-specific companion files such as a root CLAUDE.md or .mcp.json. Codex and Claude compatibility manifests keep their own mappings; Claude manifests do not load a plugin-root CLAUDE.md as project context.插件包分为两层：声明式贡献可以分发 skills、agents、commands、prompts、hooks、MCP server 与主题；Manifest v2 的 runtime 则启动独立 Sidecar，通过稳定的 Extension Protocol v1 拦截运行时事件、持有替换策略、提供流式模型 Provider，并发布结构化 UI。原生 Manifest v2 是显式能力边界：Reasonix 只加载 reasonix-plugin.json 中声明的资源，不会隐式导入根 CLAUDE.md、.mcp.json 等宿主专用伴随文件。Codex 与 Claude 兼容 manifest 继续采用各自映射；Claude manifest 不会把插件根 CLAUDE.md 当作项目上下文。
-
-
- MCP or Extension Protocol?MCP 还是 Extension Protocol？
-
Use MCP for portable tools, prompts, and resources. Use a code extension when the feature must participate in the Agent lifecycle, replace host behavior, provide models, or render native surfaces.可移植的工具、提示词与资源优先使用 MCP；需要进入 Agent 生命周期、替换宿主行为、提供模型或原生界面时，才使用代码型扩展。
-
-
- Stable and cache-aware稳定且缓存友好
-
Each turn pins one runtime generation. Sidecars initialize with four-way concurrency inside one shared 30-second startup budget. No-op reloads keep the prompt prefix byte-identical; stable replacements remain cacheable, while per-turn timestamps or random values in prompts and schemas destroy reuse.每个回合固定使用一个 runtime generation；Sidecar 最多 4 路并行初始化，并共享 30 秒总启动预算。空操作重载保持提示词前缀字节不变；稳定替换仍可缓存，把时间戳或随机值逐回合写入提示词与 Schema 则会破坏复用。
-
-
-
The repository includes a complete starter with its manifest, Go Sidecar, build commands, linked installation, reload loop, and visible input rewrite:仓库提供了完整 starter，包含 Manifest、Go Sidecar、构建命令、链接安装、重载循环与可观察的输入改写：
On Windows PowerShell, set $pluginRoot = (Resolve-Path .).Path and pass $pluginRoot to both install commands. Then send starter: explain sidecars to verify the intercept. The first public Go SDK release is sdk/go/v1.0.0; before that immutable tag exists, use the starter from a source checkout.Windows PowerShell 请先设置 $pluginRoot = (Resolve-Path .).Path，再把 $pluginRoot 传给两条安装命令。随后发送 starter: 解释 Sidecar 验证拦截。Go SDK 的首个公开版本是 sdk/go/v1.0.0；该不可变标签发布前，请直接从源码 checkout 使用 starter。
-
!Full trust: a code Sidecar runs outside the Reasonix sandbox with the inherited environment and can override permission decisions. Dry-run the install, review the runtime command and declared capabilities, and install only code you trust completely.完全信任：代码型 Sidecar 运行在 Reasonix Sandbox 之外，继承宿主环境并可覆盖权限决定。请先 dry-run，检查 Runtime 命令与声明能力，只安装完全信任的代码。
Reasonix is an MCP client. A [[plugins]] entry's type selects the transport: stdio launches a local subprocess, while http connects to a Streamable HTTP server with optional headers expanded from the environment. Tools surface to the model as mcp__<server>__<tool>.Reasonix 是一个 MCP 客户端。[[plugins]] 条目的 type 选择传输方式：stdio 启动本地子进程；http 连接 Streamable HTTP server,可从环境变量展开静态 headers。工具以 mcp__<server>__<tool> 呈现给模型。
-
# reasonix.toml
-[[plugins]] # local stdio server
-name = "example"
-command = "reasonix-plugin-example"
-
-[[plugins]] # remote server over Streamable HTTP
-name = "stripe"
-type = "http"
-url = "https://mcp.stripe.com"
-headers = { Authorization = "Bearer ${STRIPE_KEY}" }
-
Installing an MCP server is the authorization decision, so its tools are directly usable without server-level, per-tool, writer, or destructive approval settings. Repository-declared servers require one exact identity confirmation before startup and ask again only when that identity changes. Explicit global deny rules still win. readOnlyHint and destructiveHint remain internal facts for parallel dispatch, Plan restrictions, strict read-only children, and cached-to-live safety reclassification; schema-only changes refresh the next-session cache without interrupting an authorized call. Plan hard-blocks MCP writer/destructive targets and unauthorized readers; read_only_task / read_only_skill never expose writers.安装 MCP server 本身就是授权决定，安装后工具直接可用，不再需要 server、逐工具、writer 或 destructive 审批设置。仓库声明的 server 只在启动前确认一次精确身份，身份变化时才重新确认；显式全局 deny 仍然优先。readOnlyHint 与 destructiveHint 只作为并行调度、Plan 限制、严格只读子会话和缓存到实时安全分类复核的内部事实；仅 schema 变化会刷新下一会话缓存，不再中断已授权调用。Plan 会硬阻断 MCP writer/destructive 目标和未授权 reader；read_only_task / read_only_skill 完全不暴露 writer。
-
MCP prompts also become slash commands such as /mcp__server__prompt, and MCP resources can be referenced with @server:uri. Enabled servers connect in the background after a session starts; use /mcp or the desktop MCP panel to inspect, refresh, reconnect, or disable servers. Already have an .mcp.json? Put it in the project root; Reasonix reads the Claude Code mcpServers schema as-is and lets reasonix.toml win on name collisions.MCP prompts 也会变成 /mcp__server__prompt 这样的斜杠命令,MCP resources 可通过 @server:uri 引用。启用的 server 会在会话开始后后台连接；用 /mcp 或桌面端 MCP 面板查看、刷新、重连或临时禁用。已有 .mcp.json?放到项目根目录即可；Reasonix 会原样读取 Claude Code 的 mcpServers schema,同名时 reasonix.toml 优先。
-
-
Editor integration (ACP)编辑器接入（ACP）
-
Reasonix implements Agent Client Protocol (ACP) v1 as an NDJSON JSON-RPC 2.0 agent over stdio. An ACP-compatible editor or host starts reasonix acp, opens workspace-scoped sessions, and receives streamed messages, tool activity, plans, permission requests, and configuration updates.Reasonix 实现了 Agent Client Protocol（ACP）v1，通过 stdio 提供 NDJSON JSON-RPC 2.0 agent。兼容 ACP 的编辑器或 host 启动 reasonix acp、打开工作区会话，并接收流式消息、工具活动、计划、权限请求和配置更新。
-
reasonix acp # use the configured default model
-reasonix acp --model <name> # choose the startup model
-reasonix acp --profile delivery # economy | balanced | delivery
-
-
- Independent sessions独立会话
-
Each session owns its workspace, history, model, reasoning effort, execution setting, collaboration mode, approval posture, and host-supplied MCP servers.每个会话独立持有工作区、历史、模型、推理强度、执行设定、协作模式、审批策略和 host 提供的 MCP server。
-
-
- Editor-owned capabilities编辑器持有的能力
-
When advertised by the client, file operations use unsaved editor buffers and foreground commands run in a client-owned terminal.客户端声明相关能力后，文件操作会经过编辑器未保存的 buffer，前台命令则在客户端持有的 terminal 中运行。
-
-
-
Reasonix also advertises the vendor method _reasonix.io/session/steer through agentCapabilities._meta. A host may call it while session/prompt is active to queue user guidance for the next safe model boundary without cancelling the turn. Clients must discover the method first and treat InvalidRequest as not queued.Reasonix 还会通过 agentCapabilities._meta 声明厂商方法 _reasonix.io/session/steer。Host 可在 session/prompt 活动期间调用它，把用户引导排入下一个安全模型边界，而无需取消当前回合。客户端必须先发现该方法，并把 InvalidRequest 视为“未入队”。
-
iACP steering is a namespaced ACP v1 extension, not a core session/steer method and not the unreleased ACP v2 session/inject proposal. See the complete ACP integration guide for lifecycle methods, capability negotiation, MCP transport shapes, compatibility, errors, and a client checklist.ACP 回合中引导是带命名空间的 ACP v1 扩展，不是核心 session/steer 方法，也不是尚未发布的 ACP v2 session/inject 提案。生命周期方法、能力协商、MCP transport 结构、兼容性、错误处理和客户端检查清单见完整 ACP 接入文档。
-
-
Memory & rewind记忆与回退
-
Reasonix keeps project memory in REASONIX.md or AGENTS.md, and stores approved auto-memory facts under Reasonix home. During turns, read-only history and memory tools retrieve prior sessions, compacted archives, and saved facts on demand instead of injecting noisy dynamic state into the stable prompt prefix.Reasonix 将项目记忆放在 REASONIX.md 或 AGENTS.md,并把经过批准的 auto-memory fact 存在 Reasonix home 下。运行时,只读 history 与 memory 工具按需检索历史会话、压缩归档和已保存事实,而不是把易变状态塞进稳定 prompt 前缀。
-
Agent-initiated remember and forget always ask for fresh approval, even in YOLO. /memory shows active and archived facts; /forget archives rather than permanently erasing a fact from traceability.模型主动调用 remember 与 forget 时,即使在 YOLO 下也会重新请求批准。/memory 可查看 active 与 archived facts；/forget 会归档而不是永久抹掉可追溯记录。
-
Rewind is snapshot-based, not git-based. Press double Esc in the CLI, use /rewind, or use the desktop hover control to restore code, conversation, or both from an earlier turn without touching .git.回退基于文件快照,不是 git。CLI 中双击 Esc、使用 /rewind,或在桌面端用户消息上使用 hover 控件,即可从较早 turn 恢复代码、对话或两者,不会触碰 .git。
-
-
CLI & slash commands命令行与斜杠命令
-
reasonix setup # first-run: pick provider + keys
-reasonix # interactive session, prompts before writes
-reasonix run "<task>" # headless Ask; writers fail closed
-reasonix run -y "<task>" # opt into unattended ordinary writes
-reasonix web # open the local browser UI
-reasonix serve # supervised or remote HTTP+SSE frontend
-reasonix bot doctor # check saved IM bot connections
Run reasonix upgrade to install the latest official release. Legacy channel arguments and saved channel settings remain accepted during the 1.x compatibility period, but they resolve to the same official release and are removed when configuration is saved.运行 reasonix upgrade 安装最新正式版。1.x 兼容期内仍接受旧渠道参数与已保存设置，但它们都会解析为同一正式版，并在下次保存配置时移除。
-
reasonix upgrade
-reasonix upgrade
-
Inside a session, slash commands run locally — /help lists them all:会话中,斜杠命令在本地运行——/help 列出全部:
Shift+Tab cycles Ask → Auto → Plan, while Ctrl+Y toggles YOLO independently. Use /theme auto|light|dark for the terminal background mode or choose a named accent from bare /theme. Long drafts grow and then scroll inside the composer; wheel events over the transcript continue to scroll the conversation.Shift+Tab 按 Ask → Auto → Plan 循环，Ctrl+Y 独立切换 YOLO。用 /theme auto|light|dark 选择终端背景模式，也可从不带参数的 /theme 中选择命名强调色。长草稿会先增长，超过上限后在输入框内滚动；鼠标位于 transcript 时仍滚动对话。
-
The responsive footer shows the active permission posture and interaction state first. Wide terminals keep model, effort, and execution setting together on the right, with available Git, cache, context, compaction, job, and balance telemetry below. ready means the composer is idle; pickers, approvals, image paste, shell mode, and other interactions replace it. Narrow terminals move or compact complete groups, and visible labels follow /language.响应式底栏优先显示当前权限姿态和交互状态；终端较宽时，模型、推理强度和执行设定在右侧成组显示，下方按可用性显示 Git、缓存、上下文、压缩余量、任务和余额。“就绪”表示输入框空闲；选择器、审批、图片粘贴、shell 模式等活动会替换它。窄终端会移动或压缩完整信息组，可见标签跟随 /language。
-
Mouse capture is on by default so Reasonix can handle transcript selection, wheel scroll, and the scrollbar. Turn it off with /mouse, or start with REASONIX_DISABLE_MOUSE=1, when you prefer the terminal's own selection behavior.默认会开启鼠标接管，用于对话选中、滚轮滚动和滚动条。需要终端自己的选中行为时，用 /mouse 关闭；也可以用 REASONIX_DISABLE_MOUSE=1 默认关闭。
-
In a local session, releasing an in-app text selection copies through the native system clipboard and shows success only after the write completes. SSH falls back to a clearly labelled OSC 52 request. Text paste remains your terminal's bracketed-paste shortcut, such as Cmd+V on macOS. Image paste is separate: use Ctrl+V on macOS/Linux, Alt+V on Windows, or /paste-image; the footer shows Pasting image… while the attachment is prepared.本地会话中，应用内文本选区会写入系统剪贴板，只有写入完成后才提示成功；SSH 会回退到明确标记的 OSC 52 请求。文本继续使用终端原生 bracketed-paste 快捷键，例如 macOS 的 Cmd+V。图片粘贴使用独立入口：macOS/Linux 按 Ctrl+V，Windows 按 Alt+V，或运行 /paste-image；附件准备期间底栏显示“正在粘贴图片…”。
-
/branch [name] forks the current conversation tip, /switch <id|name> loads another branch, and /clear confirms before discarding unsaved context. Custom commands are Markdown files under .reasonix/commands/ or ~/.reasonix/commands/./branch [name] 从当前会话尖端分叉,/switch <id|name> 加载另一条分支,/clear 会确认后丢弃未保存上下文。自定义命令是 .reasonix/commands/ 或 ~/.reasonix/commands/ 下的 Markdown 文件。
-
/goal is for long-running objectives. Ordinary chat never changes mode automatically. Goal selects a simple (10), write (20), or research (40) turn budget and pauses after four turns without host-verifiable progress. /goal status shows the runtime, /goal pause suspends, and /goal resume continues. Every class uses the same Goal state machine, structured update_goal reports, host receipts, Delivery readiness, and bounded evaluator. Legacy research archives are read-only and new Goals never create them./goal 用于长目标。普通聊天不会自动切换模式。Goal 自动选择简单（10）、写入（20）或研究（40）轮预算，连续 4 轮无宿主可验证进展会暂停。/goal status 显示运行摘要，/goal pause 暂停，/goal resume 继续。所有预算类别共用同一个 Goal 状态机、结构化 update_goal、宿主 receipt、Delivery readiness 与有界 evaluator。旧研究归档保持只读，新 Goal 不再创建这些目录。
-
Use @path to inject files or directories, and @server:uri for MCP resources. Plan Mode is an explicit user choice: select it in the desktop collaboration control or cycle to it with Shift+Tab in the CLI. reasonix config reasoning-language auto|zh|en updates the user default from scripts; --local remains available for settings that support project-local overrides.用 @path 注入文件或目录,用 @server:uri 引入 MCP resource。计划模式始终由用户显式选择：桌面端在协作方式中选择，CLI 用 Shift+Tab 切换。脚本中可用 reasonix config reasoning-language auto|zh|en 更新用户级默认值；--local 仍可用于支持项目级覆盖的设置。
-
-
Built-in documentation search内置文档检索
-
Every CLI and Desktop release bundles the reviewed Markdown guides and release-note catalog from that exact source revision. Search is local and offline, and every result identifies the product version, source revision, and corpus digest. Release CI rejects a build when its embedded corpus does not match the release candidate, so an installed version keeps version-matched guidance instead of silently switching to newer website content.每个 CLI 与桌面端版本都会内置该源码 revision 对应的、经过审查的 Markdown 指南和更新日志目录。检索完全在本地离线完成，每条结果都会标明产品版本、源码 revision 与语料 digest。发布 CI 会拒绝内置语料与候选版本不匹配的构建，因此已安装版本始终使用与自身版本匹配的说明，不会静默切换到更新的官网内容。
-
/docs # corpus version, revision, digest, and examples
-/docs 1.19.5 changelog # search locally, then answer with the configured AI
-/docs 1.19.5 更新日志 # 中文问题会优先返回中文证据
-
Bare /docs only displays local corpus information and does not call a model. With a question, Reasonix retrieves version-matched evidence first, then asks the AI configured for the current session to produce a sourced answer. Ordinary natural-language questions can also trigger the read-only docs tool automatically, but the slash command guarantees retrieval before the answer instead of relying on the model to choose the tool.直接输入 /docs 只显示本地语料信息，不调用模型。带问题时，Reasonix 会先检索与版本匹配的证据，再交给当前会话配置的 AI 生成带来源的回答。普通自然语言问题也可能自动触发只读 docs 工具；斜杠命令则保证先检索再回答，不依赖模型自行决定是否调用工具。
-
iCustom commands and compatible plugin or skill aliases keep ownership of /docs. If it is already taken, choose the built-in entry shown in the slash menu—normally /reasonix:docs, or the next free reasonix:-qualified name. Reasonix never overwrites the existing command. CLI and Desktop use the same rule; a remote Desktop displays the command catalog resolved by its host.自定义命令以及兼容插件或 Skill 别名会继续拥有 /docs。如果该名称已被占用，请使用斜杠菜单中显示的内置入口——通常是 /reasonix:docs，或下一个空闲的 reasonix: 限定名。Reasonix 不会覆盖已有命令。CLI 与桌面端遵循同一规则；远程桌面端显示由主机解析后的命令目录。
-
For the complete retrieval contract, corpus filters, tool schema, and maintainer release checks, see the full guide and tool contract.完整检索约定、语料筛选、工具 schema 与维护者发版检查见完整指南和工具契约。
-
-
Config file配置文件
-
Resolution order: flags > ./reasonix.toml > global config.toml under Reasonix home > compatible legacy config > built-in defaults. Starting with v1.8.1, Reasonix home is ~/.reasonix on macOS/Linux and %APPDATA%\reasonix on Windows; set REASONIX_HOME only for tests, CI, or portable installs.解析顺序:flags > ./reasonix.toml > Reasonix home 下的全局 config.toml > 兼容 legacy config > 内置默认值。从 v1.8.1 起,Reasonix home 在 macOS/Linux 为 ~/.reasonix,Windows 为 %APPDATA%\reasonix；只有测试、CI 或便携安装才需要设置 REASONIX_HOME。
Legacy config, credentials, memory, and sessions are migrated non-destructively when v1.8.1+ starts. If Reasonix was opened before old paths were available, run /migrate from the CLI TUI or desktop composer. For the full schema and every field's contract, see SPEC.md §5.v1.8.1+ 启动时会非破坏性迁移 legacy config、credentials、memory 与 sessions。如果旧路径尚不可用时已经打开过 Reasonix,可在 CLI TUI 或桌面端 composer 中运行 /migrate。完整 schema 与每个字段的契约见 SPEC.md §5。
-
-
Desktop & bots桌面端与 Bot
-
The desktop app shares the same config, global provider-key file, controller, permissions, sandbox, MCP lifecycle, memory, and checkpoint model as the CLI. Desktop-only settings such as shortcuts and bot connections are stored under Reasonix home.桌面端与 CLI 共用同一套 config、全局 provider 密钥文件、controller、权限、沙箱、MCP 生命周期、记忆与 checkpoint 模型。快捷键、Bot 连接等桌面端设置存储在 Reasonix home 下。
-
From Settings -> Bots, connect Feishu, Lark, or WeChat, then send Reasonix messages from IM. The local desktop runtime handles model calls, tools, approvals, and sandboxing, while IM receives progress, approval cards or text commands, and final results. Headless gateways can be started with reasonix bot start --channels feishu,lark,weixin --dir /path/to/project.在 Settings -> Bots 中连接飞书、Lark 或微信后,即可从 IM 给 Reasonix 发消息。本地桌面运行时负责模型调用、工具、审批和沙箱,IM 侧接收进度、审批卡片或文本命令以及最终结果。也可以用 reasonix bot start --channels feishu,lark,weixin --dir /path/to/project 启动 headless gateway。
-
diff --git a/site/src/pages/index.astro b/site/src/pages/index.astro
deleted file mode 100644
index d63ce5b6da..0000000000
--- a/site/src/pages/index.astro
+++ /dev/null
@@ -1,494 +0,0 @@
----
-import Base from '../layouts/Base.astro';
-import SiteHeader from '../components/SiteHeader.astro';
-import community from '../data/community.json';
-
-const base = import.meta.env.BASE_URL.replace(/\/$/, '');
-const repo = 'https://github.com/esengine/DeepSeek-Reasonix';
-const repoReleases = `${repo}/releases`;
-const desktopStableFallback = repoReleases;
-const vscodeMarketplace = 'https://marketplace.visualstudio.com/items?itemName=SivanLiu.reasonix-agent';
-const openVsx = 'https://open-vsx.org/extension/SivanLiu/reasonix-agent';
-const vscodeExtensionRepo = 'https://github.com/SivanCola/reasonix-vscode';
-
-const goVer = 'latest';
-
-const fmtN = (n) => Number(n).toLocaleString('en-US');
-const avClass = (i) => 'av' + (i % 5 === 2 ? ' sm' : i % 7 === 3 ? ' lg' : '');
-const half = Math.ceil(community.list.length / 2);
-const rowA = community.list.slice(0, half);
-const rowB = community.list.slice(half);
-
-const desc = "Open-source AI coding agent you can leave running. One local engine, four ways in — terminal, desktop app, browser, or your editor over ACP. Plan mode, permissions, a workspace sandbox and checkpoints keep long autonomous runs reviewable. A single Go binary, no runtime to install. MIT.";
-const ld = {
- '@context': 'https://schema.org',
- '@type': 'SoftwareApplication',
- name: 'Reasonix',
- description: desc,
- url: 'https://reasonix.io/',
- applicationCategory: 'DeveloperApplication',
- operatingSystem: 'macOS, Windows, Linux',
- license: `${repo}/blob/main-v2/LICENSE`,
- downloadUrl: `${repo}/releases`,
- offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
-};
----
-
-
-
-
-
-
-
-
-
-
Open source · MIT · a single Go binary开源 · MIT · 单个 Go 二进制
-
- A coding agent you can leave running.
- 可以一直开着跑的 编码 Agent。
-
-
- One local engine, four ways in — terminal, desktop app, browser, or your editor over ACP. Plan mode, permissions, a workspace sandbox and per-turn checkpoints keep a long autonomous run something you can still read and undo.
- 一套本地引擎,四个入口——终端、桌面端、浏览器,或通过 ACP 接入你的编辑器。计划模式、权限、工作区沙箱与逐轮 checkpoint,让长时间自治运行始终可读、可撤销。
-
-
-
-
- Desktop app桌面端
- Visual workspace for sessions, settings, approvals, and updates.可视化管理会话、设置、审批与自动更新。
- Download desktop下载桌面版
-
-
-
- CLI / TUICLI / TUI
- Terminal-native agent with the same local Reasonix engine.终端原生入口,使用同一套本地 Reasonix 引擎。
- $npm i -g reasonix
-
-
-
-
-
-
fig. 01 — one task, start to finish图 01 —— 一个任务,从开始到结束
-
-
~/app — reasonix
-
◆ reasonix {goVer} · deepseek-v4-flash · ~/app› add retry with backoff to the http client◇ plan 3 steps · 2 files · 1 test run● allow edit internal/net/client.goyes✓ edit internal/net/client.go+24 −3✓ edit internal/net/client_test.go+41 −0✓ run go test ./internal/net/ok(0.21s)◆ checkpoint #14 — revert this turn anytime›
-
surface clitools 9 callssession 18mcost $0.043
-
-
-
-
-
-
-
-
- Features特性
-
Autonomy you can actually audit.可以真正审阅的自治。
-
Letting an agent run for hours is only useful if you can see what it did and undo the parts you don't want. Every layer here exists for that: plan first, gate each tool call, checkpoint every turn.让 agent 跑上几个小时,前提是你能看清它做了什么、并撤销你不想要的部分。这里的每一层都为此存在:先规划、逐次工具调用受控、逐轮 checkpoint。
-
-
-
- 01 / permissions
-
Every tool call is gated每次工具调用都受控
-
Reads, writes, and shell commands each ask separately, and the workspace sandbox bounds what a command can touch even after you say yes.读取、写入、shell 命令分别询问；即便你放行,工作区沙箱仍限定命令能触碰的范围。
Each turn writes a checkpoint outside git, so a six-hour run rewinds to any point without touching your commit history.每轮在 git 之外写入 checkpoint,六小时的运行可回退到任意一点,且不污染你的提交历史。
-
-
- 03 / plan mode
-
Plan before it touches anything动手前先给出计划
-
/plan holds every write until you've read the plan and approved it./plan 会先给出计划,在你读过并批准前不写入任何东西。
-
-
- 04 / mcp + skills
-
Extend it without forking it不用 fork 就能扩展
-
MCP over stdio, SSE, and streamable HTTP merges external tools into one registry. Markdown skills and subagents — explore, research, review, security-review — run with their own isolated tool sets.MCP 支持 stdio、SSE 与 streamable HTTP,把外部工具合并进同一 registry。Markdown 技能与子智能体(explore / research / review / security-review)各自持有隔离的工具集。
- $ reasonix mcp add · ~/.reasonix/skills/
-
-
- 05 / single binary
-
One file, no runtime一个文件,零运行时
-
CGO-free Go, cross-compiled for darwin/linux/windows × amd64/arm64. Nothing to install underneath it.无 CGO 的 Go,交叉编译覆盖 darwin/linux/windows × amd64/arm64。底下不需要装任何东西。
-
-
- 06 / local-first
-
Your key, your machine你的 Key,你的机器
-
Bring your own DeepSeek key. The engine runs locally — your code goes to the model you configured and nowhere else. MIT licensed, developed in public.使用你自己的 DeepSeek Key。引擎在本地运行——代码只发往你配置的模型,不去别处。MIT 许可,公开开发。
-
-
-
-
-
-
-
-
-
-
- Surfaces使用形态
-
One engine. Four ways in.同一个引擎。四个入口。
-
Not four products — one local engine behind four front ends. Sessions, permissions, skills and MCP servers are shared, so a task you start in the terminal is waiting for you in the desktop app.不是四个产品,而是一个本地引擎配四个前端。会话、权限、技能与 MCP 服务器都共享——在终端起的任务,打开桌面端就在那儿等着。
Sessions side by side, settings, approvals, auto-update.多会话并列、设置、审批与自动更新。
- macOS · Windows · LinuxmacOS · Windows · Linux
-
-
-
-
-
-
-
-
-
Browser浏览器
-
A local web UI on your own machine. Add auth before you expose it.跑在你自己机器上的本地 Web UI。对外暴露前先开认证。
- reasonix serve
-
-
-
-
-
-
-
-
-
Your editor你的编辑器
-
VS Code and VSCodium via the extension; anything else that speaks ACP.通过扩展接入 VS Code 与 VSCodium；其他支持 ACP 的编辑器同样可用。
- reasonix acp
-
-
-
-
-
-
-
-
-
-
-
- 01
-
Install安装
-
One command. macOS, Linux, Windows, and WSL.一条命令,支持 macOS、Linux、Windows 与 WSL。
- npm i -g reasonix
-
-
- 02
-
Point it at a repo指向你的仓库
-
It maps the codebase once and keeps that map for the rest of the session.只做一次代码库测绘,这份地图在整场会话里一直有效。
- cd your-project && reasonix
-
-
- 03
-
Open the web UI打开 Web UI
-
Keep it local, or add token/password auth before sharing a tunnel or remote port.本机使用保持默认；通过 tunnel 或远程端口分享前,先启用 token/password 认证。
- reasonix serve --auth token
-
-
- 04
-
Leave it running让它一直跑着
-
Queue tasks, review diffs, resume anytime. The session never goes cold.排任务、看 diff、随时恢复。会话永不冷却。
- › refactor the auth flow
-
-
-
-
-
-
-
-
-
-
- Community社区共建
-
Built in the open, with {community.contributors} contributors.开源共建,感谢 {community.contributors} 位贡献者。
-
Reasonix is MIT-licensed and developed in public. Every issue, every PR, every late-night review made it what it is — thank you.Reasonix 采用 MIT 许可,开放开发。每一个 issue、每一条 PR、每一次深夜 review,成就了今天的它——谢谢你们。
{fmtN(community.stars)} stars · {fmtN(community.mergedPrs)} merged PRs · every avatar above is a real contributor{fmtN(community.stars)} stars · {fmtN(community.mergedPrs)} 个已合并 PR · 上面每个头像都是一位真实贡献者
-
-
-
-
-
Start a session that lasts.开启一场不会中断的会话。
-
Open source under MIT. Bring your own DeepSeek API key — your code never leaves your machine and the model.MIT 开源。使用你自己的 DeepSeek API Key——代码不会离开你的机器与模型。
- macOS opens with a quarantine warning?macOS 提示无法打开或已损坏?
- If the app was installed from the official download and placed in /Applications, quit Reasonix, then run:如果来自官网下载并已放入 /Applications,先退出 Reasonix,再运行:
- sudo xattr -rd com.apple.quarantine /Applications/Reasonix.app
-
- When to use this →查看适用场景 →
-
Extension ID SivanLiu.reasonix-agent · requires Reasonix 1.0+ installed and configured locally · the extension connects to reasonix acp and does not bundle the CLI · source code →扩展 ID SivanLiu.reasonix-agent · 需要先在本机安装并配置 Reasonix 1.0+ · 扩展连接 reasonix acp，不内置 CLI · 查看源码 →
-
-
-
- $npm i -g reasonix
-
-
- npm i -g reasonix{goVer}
- Reasonix 1.x · one binary · no Node · actively developedReasonix 1.x · 单二进制 · 无需 Node · 主力开发中
- recommended推荐
-
-
- npm i -g reasonix@0.53.2v0.53.2
- deprecated 0.x line · no longer maintained已废弃的 0.x 线 · 不再维护
- deprecated已废弃
-
-
-
macOS / Linux / Windows / WSL · npm latest tracks the current official release · {goVer} release notes →macOS / Linux / Windows / WSL · npm latest 指向当前正式版 · {goVer} 更新说明 →
-
-
-
- $brew install esengine/reasonix/reasonix
-
{goVer} (Go rewrite) · macOS & Linux · update with brew upgrade{goVer}(Go 重写)· macOS 与 Linux · 通过 brew upgrade 更新
-
diff --git a/site/src/pages/skills.astro b/site/src/pages/skills.astro
deleted file mode 100644
index 77b2b8a097..0000000000
--- a/site/src/pages/skills.astro
+++ /dev/null
@@ -1,563 +0,0 @@
----
-import Base from '../layouts/Base.astro';
-import SiteHeader from '../components/SiteHeader.astro';
-
-const base = import.meta.env.BASE_URL.replace(/\/$/, '');
-const repo = 'https://github.com/esengine/DeepSeek-Reasonix';
-const desc = "Browse, publish, and install community skills, plugins, and MCP servers for Reasonix. One command to add any capability to your agent — install_source does the rest, SSRF-guarded and risk-rated.";
----
-
-
-
-
-
-
-
-
- Registry技能市场
-
Every skill, one install away.每个能力,一条 install 就到手。
-
Community skills, plugins, and MCP servers for your agent. The registry only stores metadata and a source pointer — installs run client-side through install_source, SSRF-guarded and risk-rated. Nothing executes here.社区贡献的技能、插件与 MCP 服务器。市场只存元数据与来源指针——安装在你本机经 install_source 执行(带 SSRF 防护与风险分级),这里不运行任何代码。
The registry service isn't reachable yet. Sign in to get a handle ready — your packages will be namespaced to it.市场服务暂时还连不上。先登录占好你的 handle——你的包会以它作命名空间。
Verified accounts only. Submissions are reviewed before they go live; your package is namespaced to your handle (@you/name).仅已验证邮箱的账号可提交。提交后经管理员审核才会公开;包以你的 handle 命名(@you/name)。
- 