reasonix 0.41.0 → 0.44.0-rc.5

package/README.md

@@ -56,33 +56,93 @@
 
 ## Install
 
-```bash
+Requires Node ≥ 22. Works on macOS · Linux · Windows (PowerShell · Git Bash · Windows Terminal).
+
+Install Reasonix globally if you want the `reasonix` command available on your `PATH`:
+
+~~~bash
+npm install -g reasonix
+reasonix code my-project   # paste a DeepSeek API key on first run; persists after
+~~~
+
+Or run it once without installing globally:
+
+~~~bash
 cd my-project
-npx reasonix code   # paste a DeepSeek API key on first run; persists after
-```
+npx reasonix code          # always uses the latest package by default
+~~~
+
+Grab a [DeepSeek API key →](https://platform.deepseek.com/api_keys) · `reasonix code --help` for flags.
 
-Requires Node ≥ 22. Works on macOS · Linux · Windows (PowerShell · Git Bash · Windows Terminal). Grab a [DeepSeek API key →](https://platform.deepseek.com/api_keys) · `reasonix code --help` for flags.
+If you use Reasonix daily, global install is the simplest path. If you just want to try it, use `npx`.
 
-`npx` is the recommended path — no global install, always latest. If you use Reasonix daily and want it on `PATH`, run `reasonix update` once.
+Bare `reasonix` (no subcommand) launches `code` in the current directory — typing `reasonix` and `reasonix code` are equivalent.
 
 | Command | When |
 |---|---|
-| `reasonix code [dir]` | The coding agent. **Start here.** |
+| `reasonix` / `reasonix code [dir]` | The coding agent. **Start here.** |
 | `reasonix chat` | Plain chat — no filesystem or shell tools. |
 | `reasonix run "task"` | One-shot, streams to stdout. Good for pipes. |
 | `reasonix doctor` | Health check: Node, API key, MCP wiring. |
 | `reasonix update` | Upgrade Reasonix itself. |
 
+### Terminal renderer (Rust by default)
+
+Since 0.44.0, Reasonix ships a native ratatui renderer (`reasonix-render`) as the default TUI. `npm install` resolves one of five pre-built `@reasonix/render-{platform}-{arch}` sub-packages via `optionalDependencies` so install is zero-config on **win32-x64 · linux-x64 · linux-arm64 · darwin-x64 · darwin-arm64**. No cargo, no toolchain, nothing extra to fetch.
+
+- Want the old Ink/Node TUI back? Pass `--node` to any subcommand (`reasonix --node`, `reasonix code --node`, `reasonix chat --node`) or set `REASONIX_RENDERER=node` in your shell.
+- Running on a platform without a published sub-package (Linux musl, FreeBSD, ARM v7, etc.)? Reasonix prints a one-line warning and auto-falls-back to the Ink renderer — nothing breaks.
+- Building rust from source? `cargo build --release --bin reasonix-render` inside the repo; the dev flow (`npm run dev`) does this automatically. The resolver also accepts `REASONIX_RENDER_BIN=/path/to/binary` to pin a specific build for testing.
+
 Other subcommands (`replay` · `diff` · `events` · `stats` · `index` · `mcp` · `prune-sessions`) are in `reasonix --help` and the [CLI reference](https://esengine.github.io/DeepSeek-Reasonix/#cli).
 
+### QQ channel
+
+Reasonix can attach QQ as a remote communication channel for existing `chat` and `code` sessions. It is not a separate runtime mode.
+
+Start a session first:
+
+~~~bash
+reasonix code
+# or
+reasonix chat
+~~~
+
+Then connect QQ from inside the session:
+
+~~~text
+/qq connect
+~~~
+
+Available commands:
+
+- `/qq connect`
+- `/qq status`
+- `/qq disconnect`
+
+Once enabled, later `chat` / `code` sessions auto-start the QQ channel. Slash commands, confirmation prompts, and follow-up assistant replies can continue through QQ without terminal-side input.
+
+See [QQ channel setup](./docs/qq-connect.md) for setup details and QQ Open Platform bot registration.
+### Desktop client (prerelease)
+
+A native Tauri client for users who want a GUI over the same loop. Multi-tab, the right-panel shows files the agent has read or edited this session, the same cost / cache / token meters live at the bottom. Same DeepSeek API key, same `~/.reasonix` config — the desktop bundles its own Node runtime, no separate `npm install` step.
+
+Download platform installers from [GitHub Releases](https://github.com/esengine/DeepSeek-Reasonix/releases). The desktop ships as a **prerelease**: the loop and protocol are the same as the CLI, but the UI is still being polished and the installers aren't code-signed yet.
+
+- **macOS** — first launch hits Gatekeeper. One-time fix: `xattr -dr com.apple.quarantine /Applications/Reasonix.app` (or right-click → Open → confirm).
+- **Windows** — SmartScreen warns "Unknown publisher". Click **More info → Run anyway**.
+- **Linux** — `.deb` and `.AppImage` ship plain, no extra step.
+
+The CLI remains the canonical surface. Anything that lands in the CLI is also available from the desktop's composer.
+
 <details>
 <summary><strong>Working in another folder · chat vs. code · author a skill</strong></summary>
 
 **Working in a different folder.** Reasonix scopes filesystem tools to the launch directory; pass `--dir` to retarget. Mid-session switching isn't supported by design (memory paths would tangle with stale roots) — quit and relaunch.
 
-```bash
+~~~bash
 npx reasonix code --dir /path/to/project
-```
+~~~
 
 **Picking `chat` vs `code`.** `code` is the default and the only mode with filesystem / shell tools and SEARCH/REPLACE review. `chat` is the lighter, tools-off shell — reach for it when you want a thinking partner with MCP attached but no disk access.
 
@@ -99,10 +159,10 @@ npx reasonix code --dir /path/to/project
 
 **Author your first skill.** No remote registry — write them directly. Edit the file (`description:` frontmatter + body), then `/skill list`. Add `runAs: subagent` to spawn an isolated subagent loop instead of inlining the body.
 
-```bash
+~~~bash
 /skill new my-skill              # <project>/.reasonix/skills/my-skill.md
 /skill new my-skill --global     # ~/.reasonix/skills for cross-project use
-```
+~~~
 
 </details>
 
@@ -121,7 +181,7 @@ One JSON file at `~/.reasonix/config.json` plus per-project overrides under `<pr
 | [Memory](https://esengine.github.io/DeepSeek-Reasonix/configuration.html#memory) | User-private knowledge pinned into the prefix. `user` / `feedback` / `project` / `reference` types. |
 | [Hooks](https://esengine.github.io/DeepSeek-Reasonix/configuration.html#hooks) | Shell commands on lifecycle events. `PreToolUse` (gating) · `PostToolUse` · `UserPromptSubmit` · `Stop`. |
 | [Permissions](https://esengine.github.io/DeepSeek-Reasonix/configuration.html#permissions) | Per-workspace shell allowlist. Exact-prefix match. |
-| [Web search](https://esengine.github.io/DeepSeek-Reasonix/configuration.html#search) | Mojeek by default; switch to self-hosted SearXNG with `/search-engine`. |
+| [Web search](https://esengine.github.io/DeepSeek-Reasonix/configuration.html#search) | Mojeek by default; switch to self-hosted SearXNG or Metaso with `/search-engine`. |
 | [Semantic index](https://esengine.github.io/DeepSeek-Reasonix/configuration.html#index) | `reasonix index` — local Ollama or any OpenAI-compatible embedding endpoint. |
 
 <br/>
@@ -158,7 +218,7 @@ Click through to the full architecture writeup → [Pillar 1 — Cache-first loo
 | Configurable web search engine    | `/search-engine` | —             | —                   | —                  |
 | Persistent per-workspace sessions | yes              | partial           | n/a                 | —                  |
 | Plan mode · MCP · hooks · skills  | yes              | yes               | yes                 | partial            |
-| Web search (Mojeek + SearXNG)      | yes              | yes               | yes                 | yes                |
+| Web search (Mojeek + SearXNG + Metaso)   | yes              | yes               | yes                 | yes                |
 | Open community development        | yes              | —                 | —                   | yes                |
 
 For live cache-hit rates, costs, and methodology, see [`benchmarks/`](./benchmarks/) — the numbers move with model pricing, so they live with the harness, not in the README.
@@ -169,6 +229,7 @@ For live cache-hit rates, costs, and methodology, see [`benchmarks/`](./benchmar
 
 - [**Architecture**](./docs/ARCHITECTURE.md) — three pillars: cache-first loop, tool-call repair, cost control
 - [**CLI Reference**](./docs/CLI-REFERENCE.md) — every shell subcommand, every slash command, every keybinding
+- [**QQ channel setup**](./docs/qq-connect.md) — what it is, commands, setup flow, and QQ Open Platform credentials
 - [**Benchmarks**](./benchmarks/) — τ-bench-lite harness, transcripts, cost methodology
 - [**Website**](https://esengine.github.io/DeepSeek-Reasonix/) — getting started, dashboard mockup, TUI mockup
 - [**Contributing**](./CONTRIBUTING.md) — comment policy, error-handling rules, library-over-hand-rolled

package/README.zh-CN.md

@@ -53,10 +53,10 @@
 
 ## 安装
 
-```bash
+~~~bash
 cd my-project
 npx reasonix code   # 首次运行粘贴 DeepSeek API Key，之后会记住
-```
+~~~
 
 要求 Node ≥ 22。在 macOS · Linux · Windows（PowerShell · Git Bash · Windows Terminal）都跑得顺。[去拿 DeepSeek API Key →](https://platform.deepseek.com/api_keys) · 完整 flag 看 `reasonix code --help`。
 
@@ -72,14 +72,41 @@ npx reasonix code   # 首次运行粘贴 DeepSeek API Key，之后会记住
 
 其他子命令（`replay` · `diff` · `events` · `stats` · `index` · `mcp` · `prune-sessions`）在 `reasonix --help` 和 [CLI 参考](https://esengine.github.io/DeepSeek-Reasonix/#cli)。
 
+### QQ 通道
+
+Reasonix 可以把 QQ 挂到现有的 `chat` / `code` 会话上，作为远程通信通道使用。它不是一个独立的新模式。
+
+先启动一个会话：
+
+~~~bash
+reasonix code
+# 或
+reasonix chat
+~~~
+
+然后在会话里连接 QQ：
+
+~~~text
+/qq connect
+~~~
+
+可用命令：
+
+- `/qq connect`
+- `/qq status`
+- `/qq disconnect`
+
+启用后，后续的 `chat` / `code` 会话会自动启动 QQ 通道。斜杠命令、确认提示，以及后续助手回复都可以通过 QQ 继续完成，不需要回到终端交互。
+
+详细说明见 [QQ 连接指南](./docs/qq-connect.zh-CN.md)。
 <details>
 <summary><strong>切换工作区 · chat vs. code · 写第一个 Skill</strong></summary>
 
 **切换工作区。** Reasonix 把文件系统工具作用域绑定在启动目录，传 `--dir` 可以指别处。中途切换是有意不支持的（消息日志和 memory 路径会和旧根目录混在一起）—— 退出再启动。
 
-```bash
+~~~bash
 npx reasonix code --dir /path/to/project
-```
+~~~
 
 **`chat` 还是 `code`？** `code` 是默认入口、唯一带文件系统 / shell 工具和 SEARCH/REPLACE 审阅的模式。`chat` 是更轻量的纯对话壳——想要一个挂着 MCP 但没有磁盘权限的“思路助手”时用它。
 
@@ -96,10 +123,10 @@ npx reasonix code --dir /path/to/project
 
 **写第一个 Skill。** 暂无在线市场——自己写。编辑文件（`description:` frontmatter + 正文），然后 `/skill list` 就能看到。frontmatter 加 `runAs: subagent` 会以隔离 subagent 跑，而不是把正文内联进父 prompt。
 
-```bash
+~~~bash
 /skill new my-skill              # <project>/.reasonix/skills/my-skill.md
 /skill new my-skill --global     # ~/.reasonix/skills，跨项目共用
-```
+~~~
 
 </details>
 
@@ -118,7 +145,7 @@ npx reasonix code --dir /path/to/project
 | [Memory](https://esengine.github.io/DeepSeek-Reasonix/configuration.html?lang=zh#memory) | 用户私有的知识，钉进前缀。`user` / `feedback` / `project` / `reference` 四类。 |
 | [Hooks](https://esengine.github.io/DeepSeek-Reasonix/configuration.html?lang=zh#hooks) | 生命周期事件触发的 shell 命令。`PreToolUse`（拦截）· `PostToolUse` · `UserPromptSubmit` · `Stop`。 |
 | [权限](https://esengine.github.io/DeepSeek-Reasonix/configuration.html?lang=zh#permissions) | 按工作区的 shell 白名单，精确前缀匹配。 |
-| [Web 搜索](https://esengine.github.io/DeepSeek-Reasonix/configuration.html?lang=zh#search) | 默认 Mojeek；用 `/search-engine` 可切到自托管的 SearXNG。 |
+| [Web 搜索](https://esengine.github.io/DeepSeek-Reasonix/configuration.html?lang=zh#search) | 默认 Mojeek；用 `/search-engine` 可切到自托管的 SearXNG 或 Metaso。 |
 | [语义索引](https://esengine.github.io/DeepSeek-Reasonix/configuration.html?lang=zh#index) | `reasonix index` —— 本地 Ollama，或任何 OpenAI 兼容的 embedding 接口。 |
 
 <br/>
@@ -164,6 +191,7 @@ npx reasonix code --dir /path/to/project
 
 - [**架构**](./docs/ARCHITECTURE.md) —— 四大支柱、缓存优先循环、思维提取、脚手架
 - [**CLI 参考**](./docs/CLI-REFERENCE.md) —— 每个 shell 子命令、每个 slash 命令、每个快捷键
+- [**QQ 连接指南**](./docs/qq-connect.zh-CN.md) —— 通道定位、命令、配置流程和 QQ 开放平台凭据
 - [**基准测试**](./benchmarks/) —— τ-bench-lite harness、transcript、成本方法论
 - [**官方网站**](https://esengine.github.io/DeepSeek-Reasonix/) —— 入门、Dashboard 设计稿、TUI 设计稿
 - [**贡献指南**](./CONTRIBUTING.md) —— 注释规则、错误处理、用现成库不手写

package/dashboard/app.css

@@ -59,7 +59,14 @@
 
   /* Spacing / radius — tiny radius (2px) keeps web feel without going SaaS */
   --r:    2px;
+  --r-sm: 4px;
   --r-md: 4px;
+
+  /* Inline elevation step above --bg-elev-2 for nested cards/dropdowns. */
+  --bg-elev-3: #1d2230;
+
+  /* Brand sweep — used by .md hr and the mini status bar fill. */
+  --gradient-rule: linear-gradient(90deg, var(--c-brand), var(--c-accent));
 }
 
 * { box-sizing: border-box; }
@@ -1157,7 +1164,7 @@ input:focus, textarea:focus, select:focus { border-color: var(--c-brand); }
   font-size: 16px;
 }
 .md h3 {
-  background: var(--grad-8);
+  background: var(--s2);
   font-size: 14px;
 }
 
@@ -2064,7 +2071,7 @@ input:focus, textarea:focus, select:focus { border-color: var(--c-brand); }
 }
 
 .modal-picker-row.selected {
-  border-color: var(--accent, #fcd34d);
+  border-color: var(--c-accent);
   background: var(--bg-elev-3, var(--bg-elev-2));
 }
 
@@ -2079,7 +2086,7 @@ input:focus, textarea:focus, select:focus { border-color: var(--c-brand); }
   color: var(--fg-2);
   padding: 1px 6px;
   border-radius: 999px;
-  background: var(--bg-elev-1, var(--bg-elev-2));
+  background: var(--bg-elev);
 }
 
 .modal-picker-subtitle {
@@ -2669,7 +2676,7 @@ input:focus, textarea:focus, select:focus { border-color: var(--c-brand); }
   display: inline-flex;
   align-items: center;
   gap: 8px;
-  background: var(--bg-elev-1);
+  background: var(--bg-elev);
   border: 1px solid var(--bd);
   border-radius: 6px;
   padding: 6px 10px;
@@ -3010,4 +3017,218 @@ input:focus, textarea:focus, select:focus { border-color: var(--c-brand); }
   font-size: 12px;
 }
 
+/* ═══════════════════════════════════════════════════════════════════════════
+   Light theme — toggled via data-theme="light" on <html>
+
+   Palette inspired by Element Plus: clean white surfaces, dark body text,
+   and slightly deepened accent colours so they stay legible on light
+   backgrounds.  Every variable from the :root dark set is overridden here;
+   hardcoded-hex fixups follow in a second block.
+   ═══════════════════════════════════════════════════════════════════════════ */
+[data-theme="light"] {
+  /* Surfaces */
+  --bg:         #f5f7fa;
+  --bg-elev:    #ffffff;
+  --bg-elev-2:  #f0f2f5;
+  --bg-input:   #ffffff;
+  --bg-code:    #f5f7fa;
+  --bg-hover:   #ecf5ff;
+
+  /* Text */
+  --fg-0:       #303133;   /* primary   — headings, emphasis */
+  --fg-1:       #606266;   /* body      — paragraphs, default */
+  --fg-2:       #909399;   /* secondary — labels, meta */
+  --fg-3:       #a8abb2;   /* dim       — placeholders, hints */
+  --fg-4:       #c0c4cc;   /* very dim  — separators, disabled */
+
+  /* Accents — deepened ~15% so they hit ≥4.5:1 on white */
+  --c-brand:    #409eff;   /* primary blue (Element Plus) */
+  --c-accent:   #9b6bff;   /* purple */
+  --c-violet:   #8b5cf6;   /* violet */
+  --c-ok:       #67c23a;   /* success green */
+  --c-warn:     #e6a23c;   /* warning amber */
+  --c-err:      #f56c6c;   /* error red */
+  --c-info:     #409eff;
+
+  /* Chart spectrum */
+  --s1: #409eff;
+  --s2: #36cfc9;
+  --s3: #67c23a;
+  --s4: #e6a23c;
+  --s5: #f56c6c;
+  --s6: #9b6bff;
+
+  /* Borders */
+  --bd:         #e4e7ed;
+  --bd-strong:  #dcdfe6;
+
+  /* Elevation step above --bg-elev-2 in light mode — matches the surface scale. */
+  --bg-elev-3: #e4e7ed;
+}
+
+/* ── Light-theme fixups for hardcoded hex / rgba values ────────────────
+   These selectors use literal colours (not CSS variables) in the dark
+   theme and therefore need explicit overrides to look correct on a
+   white background.  Keep them scoped under [data-theme="light"] so
+   dark mode is never touched. ────────────────────────────────────────── */
+
+/* Hardcoded #14171e borders (dark-theme inner dividers) → var(--bd) */
+[data-theme="light"] .section,
+[data-theme="light"] .ssl-row,
+[data-theme="light"] .sr-card {
+  border-bottom-color: var(--bd);
+}
+[data-theme="light"] .overlay::before {
+  border-color: var(--bd);
+}
+[data-theme="light"] .composer-foot {
+  border-top-color: var(--bd);
+}
+[data-theme="light"] .scale-row {
+  border-bottom-color: var(--bd);
+}
+
+/* Primary button hover — lighten the brand colour instead of the
+   dark-theme hardcoded #94cdff. */
+[data-theme="light"] .btn.primary:hover,
+[data-theme="light"] button.primary:hover {
+  background: #66b1ff;
+  border-color: #66b1ff;
+  color: #fff;
+}
+
+/* Markdown headings — dark theme puts black text on coloured bg;
+   light theme uses white text for cleaner contrast. */
+[data-theme="light"] .md h1,
+[data-theme="light"] .md h2,
+[data-theme="light"] .md h3 {
+  color: #fff;
+}
+
+/* Chat banner — rgba tint references the brand colour so it must
+   switch to the light-mode brand hex. */
+[data-theme="light"] .chat-banner {
+  background: rgba(64,158,255,.06);
+  border-color: rgba(64,158,255,.18);
+}
+
+/* Pills — semi-transparent accent backgrounds must shift hue. */
+[data-theme="light"] .pill.ok   { background: rgba(103,194,58,.10); }
+[data-theme="light"] .pill.warn { background: rgba(230,162,60,.12); }
+[data-theme="light"] .pill.err  { background: rgba(245,108,108,.10); }
+[data-theme="light"] .pill.info { background: rgba(64,158,255,.10); }
+[data-theme="light"] .pill.acc  { background: rgba(155,107,255,.10); }
+[data-theme="light"] .pill-err  { background: rgba(245,108,108,.10); }
+[data-theme="light"] .pill-active { background: rgba(64,158,255,.10); }
+
+/* Step-dot glow — brand-colour box-shadow. */
+[data-theme="light"] .plan-step.active::before {
+  box-shadow: 0 0 0 3px rgba(64,158,255,.18);
+}
+
+/* Filter chips active state. */
+[data-theme="light"] .chip-f.active {
+  background: rgba(64,158,255,.08);
+}
+[data-theme="light"] .chip-f.static.active:hover {
+  background: rgba(64,158,255,.08);
+}
+
+/* Matrix cell on-state. */
+[data-theme="light"] .matrix .cell.on {
+  background: rgba(64,158,255,.05);
+}
+
+/* Editor line hover. */
+[data-theme="light"] .editor-line:hover {
+  background: rgba(64,158,255,.04);
+}
+[data-theme="light"] .editor-line.cur {
+  background: rgba(64,158,255,.06);
+}
+
+/* Markdown search-result highlight. */
+[data-theme="light"] .sr-card .sr-snip mark {
+  background: rgba(230,162,60,.18);
+}
+
+/* Why / notes callout. */
+[data-theme="light"] .why {
+  background: rgba(155,107,255,.04);
+}
+
+/* Diff-line insert / delete. */
+[data-theme="light"] .diff-line.ins {
+  background: rgba(103,194,58,0.10);
+  color: var(--c-ok);
+}
+[data-theme="light"] .diff-line.del {
+  background: rgba(245,108,108,0.10);
+  color: var(--c-err);
+}
+
+/* Diff-row add / remove backgrounds. */
+[data-theme="light"] .diff-row.add { background: rgba(103,194,58,.06); }
+[data-theme="light"] .diff-row.rem { background: rgba(245,108,108,.05); }
+[data-theme="light"] .diff-row .word-add { background: rgba(103,194,58,.22); }
+[data-theme="light"] .diff-row .word-rem { background: rgba(245,108,108,.20); }
+
+/* Edit-diff side-by-side markers and borders. */
+[data-theme="light"] .edit-diff-side-old .edit-diff-marker { color: var(--c-err); }
+[data-theme="light"] .edit-diff-side-new .edit-diff-marker { color: var(--c-ok); }
+[data-theme="light"] .edit-diff-row-del .edit-diff-cell-old,
+[data-theme="light"] .edit-diff-row-change .edit-diff-cell-old {
+  background: rgba(245,108,108,0.10);
+  border-left-color: var(--c-err);
+}
+[data-theme="light"] .edit-diff-row-ins .edit-diff-cell-new,
+[data-theme="light"] .edit-diff-row-change .edit-diff-cell-new {
+  background: rgba(103,194,58,0.10);
+  border-left-color: var(--c-ok);
+}
+
+/* Plan-revision modal border. */
+[data-theme="light"] .modal-revise-reason {
+  border-left-color: var(--c-accent);
+}
+
+/* Picker selected row. */
+[data-theme="light"] .modal-picker-row.selected {
+  border-color: var(--c-warn);
+}
+
+/* Modal viewer step-done mark. */
+[data-theme="light"] .modal-viewer-step-done .modal-viewer-step-mark {
+  color: var(--c-ok);
+}
+
+/* Top-bar status dot glow. */
+[data-theme="light"] .tui-status.online .dot {
+  box-shadow: 0 0 6px rgba(103,194,58,.5);
+}
+
+/* Dialog box-shadow — dark mode uses a deep black shadow; light mode
+   needs a softer grey one. */
+[data-theme="light"] .dialog {
+  box-shadow: 0 18px 48px rgba(0,0,0,.08), 0 0 0 1px rgba(0,0,0,.04);
+}
+[data-theme="light"] .cmd-palette {
+  box-shadow: 0 24px 64px rgba(0,0,0,.10);
+}
+[data-theme="light"] .popover {
+  box-shadow: 0 12px 32px rgba(0,0,0,.08);
+}
+
+/* Scrollbar — lighter thumb for light backgrounds. */
+[data-theme="light"] * {
+  scrollbar-color: var(--bd-strong) transparent;
+}
+[data-theme="light"] *::-webkit-scrollbar-thumb {
+  background: var(--bd);
+  border-color: var(--bg);
+}
+[data-theme="light"] *::-webkit-scrollbar-thumb:hover {
+  background: var(--fg-4);
+}
+