@xopcai/xopc 0.0.117 → 0.0.119

package/README.md

@@ -46,12 +46,22 @@
 
 ## Get started
 
-### Try in 3 minutes
+### Easiest start: PC desktop app
+
+For most users, the **PC desktop app** is the easiest way to start: install the app, finish model setup in the UI, then chat in the built-in console. It starts the local gateway for you.
+
+1. Download from **[GitHub Releases](https://github.com/xopcai/xopc/releases)** — macOS `.dmg`, Windows `.exe`, Linux `.AppImage` / `.deb`.
+2. Open xopc and complete model setup.
+3. Start chatting.
+
+See **[PC Desktop app](https://xopcai.github.io/xopc/desktop-app)** for install notes, build-from-source commands, and reserved screenshot/GIF/video file locations.
+
+### Fastest terminal path
 
 ```bash
 curl -fsSL https://xopc.ai/install.sh | bash
 xopc onboard --quick
-xopc tui --local
+xopc
 ```
 
 This path starts the embedded terminal UI: no gateway, desktop app, or messenger setup required.
@@ -82,12 +92,10 @@ The installer detects your OS, installs **Node.js ≥ 22** when needed, and inst
 
 ```bash
 xopc onboard          # faster: xopc onboard --quick
-xopc tui --local
+xopc                  # same as xopc tui; opens the local TUI
 ```
 
-> **New here?** Start with **`xopc tui --local`** (embedded agent, no gateway). Run **`xopc gateway`** when you want the **web console** or **messengers** (Telegram, WeChat, Feishu).
-
-If the first run works for you, please **[star the repo](https://github.com/xopcai/xopc)** so others can discover it.
+> **New here?** Use the **PC desktop app** for the easiest setup, or run **`xopc`** for the fastest terminal path. Run **`xopc gateway`** when you want the browser console or messengers without the desktop shell.
 
 ### npm (already have Node.js 22+)
 
@@ -135,7 +143,7 @@ Windows git install: `& ([scriptblock]::Create((irm https://xopc.ai/install.ps1)
 - 🔑 **Bring your own keys** — OpenAI, Anthropic, Google, DeepSeek, Ollama, LM Studio, vLLM, and **20+** providers. Mix cloud and local; switch catalog models in one config line. See **[Models](https://xopcai.github.io/xopc/models)**.
 - 📱 **One brain, every screen** — Same assistant in terminal, browser, desktop, [mobile app](https://github.com/xopcai/xopc-app), and IM. No sync layer — one system.
 - 🧩 **Grows with you** — **`xopc skills install`** · **`xopc extensions install`** for tools, channels, and UI panels; multi-agent routing per context.
-- ⏰ **Proactive** — **Cron** for scheduled summaries and reminders; **workflows** for fan-out subagent tasks; **multi-agent** routing with isolated workspaces, tools, and prompts.
+- ⏰ **Proactive** — **Automations** for scheduled summaries, reminders, and workflow runs; **workflows** for fan-out subagent tasks; **multi-agent** routing with isolated workspaces, tools, and prompts.
 
 ---
 
@@ -143,10 +151,10 @@ Windows git install: `& ([scriptblock]::Create((irm https://xopc.ai/install.ps1)
 
 | Surface | How | Best for |
 | --- | --- | --- |
-| **TUI** | `xopc tui --local` (or `xopc tui --url …`) | Full keyboard, streaming, lowest friction to try |
+| **PC Desktop** | [GitHub Releases](#desktop-app) | Easiest start: native app + embedded gateway console |
+| **TUI** | `xopc` or `xopc tui` (remote: `xopc tui --url …`) | Full keyboard, streaming, fastest terminal path |
 | **CLI** | `xopc agent -i` / `xopc agent -m "…"` | Scripts and minimal TTY |
 | **Web** | `xopc gateway` → open console URL | Chat, settings, logs in the browser |
-| **Desktop** | [GitHub Releases](#desktop-app) or `pnpm run electron:build` | Native app (macOS, Windows, Linux) |
 | **Mobile** | [xopc-app](https://github.com/xopcai/xopc-app) + gateway pairing ([mobile app](https://xopcai.github.io/xopc/mobile-app), [remote access](https://xopcai.github.io/xopc/remote-access)) | Continue your loop on iOS/Android |
 | **Messengers** | `channels.*` + gateway | Telegram, WeChat, Feishu/Lark |
 
@@ -195,7 +203,7 @@ Default: **`~/.xopc/xopc.json`**.
         "models": {
           "defaultRole": "deep",
           "roles": {
-            "deep": { "model": "deepseek/deepseek-chat" }
+            "deep": { "model": "deepseek/deepseek-v4-flash" }
           }
         },
         "tools": { "builtin": {} },
@@ -242,7 +250,7 @@ No. xopc runs on your machine. Config, workspace files, credentials, and local s
 No. Bring your own keys for cloud providers, or use local/model-server options such as Ollama, LM Studio, and vLLM.
 
 **What is the fastest way to try it?**  
-Use **`xopc onboard --quick`** and **`xopc tui --local`**. That path avoids gateway, desktop, and messenger setup.
+For most users, install the **PC desktop app** from GitHub Releases and complete model setup in the UI. For terminal users, use **`xopc onboard --quick`** and then run **`xopc`**.
 
 **How is this different from another chat UI?**  
 xopc is organized around goal loops: direction, next action, feedback, and recalibration across multiple surfaces.
@@ -250,20 +258,21 @@ xopc is organized around goal loops: direction, next action, feedback, and recal
 **Can I use it from my phone or messengers?**  
 Yes. Start with local TUI first; when ready, run the gateway and use [xopc-app](https://github.com/xopcai/xopc-app) on iOS/Android, or configure Telegram, WeChat, or Feishu/Lark.
 
-If this answers your concerns, please **[star xopc](https://github.com/xopcai/xopc)** so more developers can find it.
-
----
-
 <a id="desktop-app"></a>
 <a id="electron-desktop"></a>
 
 ## Desktop app
 
+The PC desktop app is the easiest way to start for most users: it launches an embedded local gateway and opens the gateway console in a native window.
+
 1. Download from **[GitHub Releases](https://github.com/xopcai/xopc/releases)** — macOS `.dmg`, Windows `xopc-<version>-x64.exe` or `xopc-<version>-arm64.exe`, Linux `.AppImage` / `.deb`.
-2. Or use **`xopc gateway`** + the npm CLI until a build exists for your OS.
+2. Open the app, complete model setup, and start chatting.
+3. Or use **`xopc gateway`** + the npm CLI until a build exists for your OS.
 
 **Build from source:** `pnpm install && pnpm run electron:build` → `dist/release/`
 
+Docs and media placeholders: **[PC Desktop app](https://xopcai.github.io/xopc/desktop-app)**.
+
 ---
 
 ## Security
@@ -276,6 +285,7 @@ Treat inbound IM messages as **untrusted**. Prefer **pairing** or **allowlist**
 
 ```bash
 pnpm install && pnpm run dev    # CLI via tsx
+pnpm run dev:gateway            # dev gateway uses ~/.xopc-dev + info logs
 pnpm run build && pnpm test && pnpm run lint
 ```
 
@@ -283,14 +293,6 @@ pnpm run build && pnpm test && pnpm run lint
 
 **Issues:** [bug](https://github.com/xopcai/xopc/issues/new?template=bug_report.yml) · [feature](https://github.com/xopcai/xopc/issues/new?template=feature_request.yml) · [Q&A Discussions](https://github.com/xopcai/xopc/discussions/categories/q-a) · [security advisory](https://github.com/xopcai/xopc/security/advisories/new) (not public issues)
 
----
-
-## Star history
-
-[![Star History Chart](https://api.star-history.com/svg?repos=xopcai/xopc&type=Date)](https://star-history.com/#xopcai/xopc&Date)
-
----
-
 ## Credits
 
 - LLM layer: [@earendil-works/pi-ai](https://github.com/earendil-works/pi-mono) · Agent runtime: [@earendil-works/pi-agent-core](https://github.com/earendil-works/pi-mono)

package/README.zh-CN.md

@@ -7,8 +7,8 @@
 
 <p align="center">
   <strong>把目标变成循环。</strong><br />
-  让真正重要的事情，持续向前。<br />
-  XOPC 是一个 Local-first AI 系统，持续记住上下文，协调 AI 推进下一步，让长期目标不断向前。
+  让真正重要的事情持续向前。<br />
+  XOPC 是一个本地优先的 AI 助手系统：记住上下文，协调 AI 推进下一步，让长期目标持续向前。
 </p>
 
 <p align="center">
@@ -35,9 +35,9 @@
 
 ## 适合谁
 
-- **长期项目** —— 把目标变成可持续的循环：上下文、下一步行动、反馈和重新校准始终连在一起。
-- **独立开发者 / One Person Company** —— 同一个助手覆盖 CLI、TUI、网页、桌面、Telegram、微信和飞书/Lark。
-- **本地优先 AI 工作流** —— 自带 API Key，云端/本地模型混用，支持 skills/extensions，数据默认在 **`~/.xopc/`**。
+- **长期项目** —— 把目标拆成可持续推进的循环：上下文、下一步行动、反馈和校准始终连在一起。
+- **独立开发者 / 一人公司** —— 同一个助手覆盖 CLI、TUI、网页、桌面、Telegram、微信和飞书/Lark。
+- **本地优先 AI 工作流** —— 使用你自己的 API Key，云端/本地模型混用，支持技能和扩展，数据默认保存在 **`~/.xopc/`**。
 
 ---
 
@@ -46,15 +46,25 @@
 
 ## 快速开始
 
-### 3 分钟试用
+### 最省心的开始方式：PC 桌面端
+
+对大多数用户来说，**PC 桌面端**是最容易上手的方式：安装应用，在界面里完成模型设置，然后直接在内置控制台聊天。它会自动启动本地 gateway。
+
+1. 从 **[GitHub Releases](https://github.com/xopcai/xopc/releases)** 下载 — macOS `.dmg`，Windows `.exe`，Linux `.AppImage` / `.deb`。
+2. 打开 xopc，完成模型设置。
+3. 开始聊天。
+
+详见 **[PC 桌面端](https://xopcai.github.io/xopc/zh/desktop-app)**：安装说明、源码打包命令，以及后续截图/GIF/视频素材的预留文件位置。
+
+### 最快终端路径
 
 ```bash
 curl -fsSL https://xopc.ai/install.sh | bash
 xopc onboard --quick
-xopc tui --local
+xopc
 ```
 
-这条路径会启动本地嵌入式 TUI，不需要先配置网关、桌面端或 IM。
+这条路径会启动本地嵌入式 TUI，不需要先配置网关、桌面端或即时通讯。
 
 ### 一键安装（推荐）
 
@@ -82,12 +92,10 @@ iex (irm https://xopc.ai/install.ps1)
 
 ```bash
 xopc onboard          # 更快：xopc onboard --quick
-xopc tui --local
+xopc                  # 等同于 xopc tui，打开本地 TUI
 ```
 
-> **第一次用？** 先跑 **`xopc tui --local`**（本地嵌入式对话，不用网关）。需要 **网页控制台** 或 **Telegram / 微信 / 飞书** 时再执行 **`xopc gateway`**。
-
-如果首次运行顺利，欢迎 **[给仓库点个 Star](https://github.com/xopcai/xopc)**，帮助更多人发现这个项目。
+> **第一次用？** 想少碰终端，优先用 **PC 桌面端**；习惯终端则直接运行 **`xopc`**。需要浏览器控制台或即时通讯时，再启动 **`xopc gateway`**。
 
 ### npm（已具备 Node.js 22+）
 
@@ -123,19 +131,19 @@ pnpm exec xopc onboard
 
 Windows 源码安装：`& ([scriptblock]::Create((irm https://xopc.ai/install.ps1))) -InstallMethod git`
 
-**环境：** Node.js **≥ 22**（一键脚本会自动处理）。在本仓库魔改请用 **pnpm**。更多安装方式见 **[xopc.ai](https://xopc.ai)** 与 **[快速开始](https://xopcai.github.io/xopc/zh/getting-started)**。
+**环境：** Node.js **≥ 22**（一键脚本会自动处理）。从源码开发本仓库时请使用 **pnpm**。更多安装方式见 **[xopc.ai](https://xopc.ai)** 与 **[快速开始](https://xopcai.github.io/xopc/zh/getting-started)**。
 
 ---
 
 ## 为什么选 xopc
 
-- 🔁 **循环驱动，而非一次性对话** — XOPC 持续记住上下文，协调 AI 推进下一步，让真正重要的事情不断向前。
+- 🔁 **循环驱动，而不是一次性对话** — XOPC 持续记住上下文，协调 AI 推进下一步，让真正重要的事情不断向前。
 
 - 🏠 **你的机器** — 配置与数据在 **`~/.xopc/`**，无强制云端、无意外账单。
-- 🔑 **自带钥匙** — OpenAI、Anthropic、Google、DeepSeek、Ollama、LM Studio、vLLM 等 **20+** 厂商；云端本地可混用，一行配置切换目录模型。详见 **[模型](https://xopcai.github.io/xopc/zh/models)**。
-- 📱 **一个大脑，处处可用** — 终端、浏览器、桌面、[移动端 app](https://github.com/xopcai/xopc-app)、IM 同一套助手，无需另做同步。
-- 🧩 **随你长大** — **`xopc skills install`** · **`xopc extensions install`** 扩展工具、频道与 UI；多 Agent 按场景隔离。
-- ⏰ **能主动干活** — **Cron** 定时摘要与提醒；**工作流**扇出多子 Agent 任务；**多 Agent** 各自工作区、工具与系统提示词。
+- 🔑 **使用自己的密钥** — OpenAI、Anthropic、Google、DeepSeek、Ollama、LM Studio、vLLM 等 **20+** 厂商；云端和本地模型可混用，一行配置即可切换模型。详见 **[模型](https://xopcai.github.io/xopc/zh/models)**。
+- 📱 **多个入口，同一个助手** — 终端、浏览器、桌面、[移动端 App](https://github.com/xopcai/xopc-app)、即时通讯共用同一套上下文，无需额外同步。
+- 🧩 **可按需扩展** — 通过 **`xopc skills install`** 和 **`xopc extensions install`** 扩展工具、频道与 UI；多 Agent 可按场景隔离。
+- ⏰ **支持主动任务** — 用 **自动化** 做定时摘要、提醒与工作流运行；用 **工作流**扇出多子 Agent 任务；用 **多 Agent** 管理不同工作区、工具与系统提示词。
 
 ---
 
@@ -143,18 +151,18 @@ Windows 源码安装：`& ([scriptblock]::Create((irm https://xopc.ai/install.ps
 
 | 方式 | 怎么用 | 适合 |
 | --- | --- | --- |
-| **TUI** | `xopc tui --local`（或 `xopc tui --url …`） | 全键盘、流式输出，上手最快 |
+| **PC 桌面端** | [GitHub Releases](#desktop-app) | 最省心的开始方式：原生应用 + 内嵌 gateway 控制台 |
+| **TUI** | `xopc` 或 `xopc tui`（远程：`xopc tui --url …`） | 全键盘、流式输出，最快终端路径 |
 | **CLI** | `xopc agent -i` / `xopc agent -m "…"` | 脚本、最小终端环境 |
 | **网页** | `xopc gateway` → 打开控制台地址 | 聊天、设置、日志 |
-| **桌面** | [GitHub Releases](#desktop-app) 或 `pnpm run electron:build` | 原生应用（macOS / Windows / Linux） |
-| **手机** | [xopc-app](https://github.com/xopcai/xopc-app) + 网关配对（[移动端 app](https://xopcai.github.io/xopc/zh/mobile-app)、[远程访问](https://xopcai.github.io/xopc/zh/remote-access)） | 在 iOS/Android 上继续推进循环 |
+| **手机** | [xopc-app](https://github.com/xopcai/xopc-app) + 网关配对（[移动端 App](https://xopcai.github.io/xopc/zh/mobile-app)、[远程访问](https://xopcai.github.io/xopc/zh/remote-access)） | 在 iOS/Android 上继续推进循环 |
 | **即时通讯** | 配置 `channels.*` 并启动网关 | Telegram、微信、飞书/Lark |
 
 ---
 
 ## 内置频道
 
-在 **`~/.xopc/xopc.json`** 里配置 **`channels.*`**。IM 需网关常驻；微信在**跑网关的机器**上扫码登录。
+在 **`~/.xopc/xopc.json`** 里配置 **`channels.*`**。即时通讯需要网关常驻；微信需要在**运行网关的机器**上扫码登录。
 
 | 频道 | 配置项 | 说明 |
 | --- | --- | --- |
@@ -189,13 +197,13 @@ xopc extensions dev ./my-extension
     "list": [
       {
         "id": "main",
-        "identity": { "name": "Main", "role": "通用助手", "language": "zh-CN" },
-        "responsibilities": { "primary": ["帮助用户完成任务"] },
+        "identity": { "name": "Main", "role": "General assistant" },
+        "responsibilities": { "primary": ["Help the user complete tasks"] },
         "workspace": { "root": "~/.xopc/workspace/main" },
         "models": {
           "defaultRole": "deep",
           "roles": {
-            "deep": { "model": "deepseek/deepseek-chat" }
+            "deep": { "model": "deepseek/deepseek-v4-flash" }
           }
         },
         "tools": { "builtin": {} },
@@ -212,7 +220,7 @@ xopc extensions dev ./my-extension
 }
 ```
 
-需要 IM 时再补 **`channels.telegram`**、**`channels.weixin`**、**`channels.feishu`** —— 见 **[配置](https://xopcai.github.io/xopc/zh/configuration)**。
+需要即时通讯时再补 **`channels.telegram`**、**`channels.weixin`**、**`channels.feishu`** —— 见 **[配置](https://xopcai.github.io/xopc/zh/configuration)**。
 
 可选工具（如浏览器）默认**关闭**，启用后按需安装 Playwright Chromium。
 
@@ -229,7 +237,7 @@ xopc extensions dev ./my-extension
 | [架构](https://xopcai.github.io/xopc/zh/architecture) | 整体结构 |
 | [工作流](https://xopcai.github.io/xopc/zh/workflows) | 扇出子 Agent、看板、脚本 |
 
-更多：[工具](https://xopcai.github.io/xopc/zh/tools) · [移动端 app](https://xopcai.github.io/xopc/zh/mobile-app) · [语音](https://xopcai.github.io/xopc/zh/voice) · [远程访问](https://xopcai.github.io/xopc/zh/remote-access)
+更多：[工具](https://xopcai.github.io/xopc/zh/tools) · [移动端 App](https://xopcai.github.io/xopc/zh/mobile-app) · [语音](https://xopcai.github.io/xopc/zh/voice) · [远程访问](https://xopcai.github.io/xopc/zh/remote-access)
 
 ---
 
@@ -242,16 +250,14 @@ xopc extensions dev ./my-extension
 不必须。你可以自带云厂商 API Key，也可以使用 Ollama、LM Studio、vLLM 等本地/自部署模型服务。
 
 **最快怎么试用？**  
-执行 **`xopc onboard --quick`** 和 **`xopc tui --local`**。这条路径不会先要求你配置网关、桌面端或 IM。
+对大多数用户，优先从 GitHub Releases 安装 **PC 桌面端**，在界面中完成模型设置。习惯终端的用户可以执行 **`xopc onboard --quick`**，然后运行 **`xopc`**。
 
 **它和普通聊天 UI 有什么区别？**  
 xopc 围绕目标循环组织：方向、下一步、反馈、重新校准，并且同一个助手可以跨多个入口继续工作。
 
-**能在手机或 IM 里用吗？**  
+**能在手机或即时通讯里用吗？**
 可以。建议先用本地 TUI 试用；确认方向后，再启动 gateway，用 [xopc-app](https://github.com/xopcai/xopc-app) 连接 iOS/Android，或配置 Telegram、微信、飞书/Lark。
 
-如果这些回答解决了你的顾虑，欢迎 **[给 xopc 点个 Star](https://github.com/xopcai/xopc)**，帮助更多开发者看到它。
-
 ---
 
 <a id="desktop-app"></a>
@@ -259,16 +265,21 @@ xopc 围绕目标循环组织：方向、下一步、反馈、重新校准，并
 
 ## 桌面版
 
+PC 桌面端是大多数用户最省心的开始方式：它会启动内置本地 gateway，并在原生窗口里打开 gateway 控制台。
+
 1. 从 **[GitHub Releases](https://github.com/xopcai/xopc/releases)** 下载 — macOS `.dmg`，Windows `xopc-<版本>-x64.exe` 或 `xopc-<版本>-arm64.exe`，Linux `.AppImage` / `.deb`。
-2. 暂无对应平台安装包时，先用 **`xopc gateway`** + npm 命令行版。
+2. 打开应用，完成模型设置，然后开始聊天。
+3. 暂无对应平台安装包时，先用 **`xopc gateway`** + npm 命令行版。
 
 **从源码打包：** `pnpm install && pnpm run electron:build` → `dist/release/`
 
+文档与素材预留：**[PC 桌面端](https://xopcai.github.io/xopc/zh/desktop-app)**。
+
 ---
 
 ## 安全
 
-来自 IM 的消息视为**不可信输入**。私聊建议 **pairing（配对）** 或 **allowlist（白名单）**。网关监听地址与 token 勿泄露 —— **[频道](https://xopcai.github.io/xopc/zh/channels)**。
+来自即时通讯的消息视为**不可信输入**。私聊建议 **pairing（配对）** 或 **allowlist（白名单）**。请勿泄露网关监听地址与 token —— **[频道](https://xopcai.github.io/xopc/zh/channels)**。
 
 ---
 
@@ -276,20 +287,13 @@ xopc 围绕目标循环组织：方向、下一步、反馈、重新校准，并
 
 ```bash
 pnpm install && pnpm run dev
+pnpm run dev:gateway            # 开发 gateway 使用 ~/.xopc-dev + info 日志
 pnpm run build && pnpm test && pnpm run lint
 ```
 
 **[AGENTS.md](./AGENTS.md)** · **[CONTRIBUTING.md](./CONTRIBUTING.md)**（英文）
 
-**反馈：** [Bug](https://github.com/xopcai/xopc/issues/new?template=bug_report.yml) · [功能建议](https://github.com/xopcai/xopc/issues/new?template=feature_request.yml) · [Discussions Q&A](https://github.com/xopcai/xopc/discussions/categories/q-a) · [安全 advisory](https://github.com/xopcai/xopc/security/advisories/new)（勿公开贴漏洞）
-
----
-
-## Star 历史
-
-[![Star History Chart](https://api.star-history.com/svg?repos=xopcai/xopc&type=Date)](https://star-history.com/#xopcai/xopc&Date)
-
----
+**反馈：** [Bug 反馈](https://github.com/xopcai/xopc/issues/new?template=bug_report.yml) · [功能建议](https://github.com/xopcai/xopc/issues/new?template=feature_request.yml) · [Q&A 讨论](https://github.com/xopcai/xopc/discussions/categories/q-a) · [安全漏洞反馈](https://github.com/xopcai/xopc/security/advisories/new)（请勿公开发布漏洞细节）
 
 ## 致谢
 

package/dist/browser-ext/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": 3,
   "name": "xopc Browser Bridge",
-  "version": "0.0.117",
+  "version": "0.0.119",
   "description": "Browser automation bridge for xopc — executes commands in Chrome via the local xopc daemon.",
   "permissions": [
     "debugger",

package/dist/extensions/telegram/xopc.extension.json

@@ -2,7 +2,7 @@
   "id": "telegram",
   "name": "Telegram Channel",
   "description": "Bundled Telegram Bot channel (private workspace sources; ships inside @xopcai/xopc dist/)",
-  "version": "0.0.117",
+  "version": "0.0.119",
   "kind": "channel",
   "main": "src/index.js",
   "channels": [