diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 157bd88..311d1c0 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -69,6 +69,16 @@ This keeps links stable across locales and rewordings. - Every destructive action notes what it does **not** undo. Example: "Deleting a session removes its message history permanently; it does not delete memories already extracted from it." - Example prompts end with a safety constraint. Example: "Summarize this thread and draft a reply, and ask me before sending anything." +## Announce Releases in What's New, Not a Changelog + +`docs/whats-new.md` (mirrored in every locale) is a curated digest of changes that alter how someone uses Memoh. The exhaustive per-version record is the [GitHub release notes](https://github.com/felinics/Memoh/releases); the docs keep no changelog page of their own. + +- **Belongs in What's new:** new agents and capabilities, user-visible workflow changes, notable performance wins, and Memoh Cloud notices such as plan or billing changes. Release announcements (for example, posts on X) map here. +- **Stays in the release notes only:** refactors, error-code plumbing, test fixes, dependency bumps, and other changes nobody would notice while using the product. +- **One section per announcement**, newest first, headed by its date with an explicit anchor: `## October 19, 2026 {#2026-10-19}`. Entries are `###` headings that lead with a verb and carry `{#YYYY-MM-DD-short-slug}`, so deep links match across locales. +- **Each entry** is one to three short paragraphs that link to the docs page for the feature. End the section with a link to that version's GitHub release. +- **Update the feature docs first.** An entry must never link to a page that contradicts it. + ## Run the Parity Check Before Opening a PR ```sh @@ -148,6 +158,16 @@ FAQ 条目和所有要被深链的标题带显式 ASCII `{#id}`,**所有语言 - 每个破坏性操作都写明它**不会**撤销什么。例:「删除会话会永久移除消息历史;已经从中抽取的记忆不会随之删除。」 - 示例提示词以安全约束收尾。例:「总结这个帖子并起草回复,发送任何内容前先问我。」 +## 版本更新写进最新动态,不另建 changelog + +`docs/whats-new.md`(每种语言都有镜像)是精选的更新速览,只收录会改变使用方式的变化。按版本穷举的完整记录是 [GitHub Release](https://github.com/felinics/Memoh/releases),文档站不再单独维护 changelog 页面。 + +- **写进最新动态:** 新的 Agent 和能力、用户能感知到的流程变化、明显的性能提升,以及 Memoh Cloud 的套餐、计费等通知。发版公告(例如 X 上的推文)就对应这里。 +- **只留在 Release 里:** 重构、错误码梳理、测试修复、依赖升级等使用时察觉不到的改动。 +- **每次公告一节**,最新的在最上面,标题写日期并带显式锚点:`## 2026 年 10 月 19 日 {#2026-10-19}`。条目用 `###` 标题、以动词开头,并带 `{#YYYY-MM-DD-short-slug}`,保证各语言深链一致。 +- **每个条目**一到三段短文,链接到该功能的文档页。这一节最后链接到对应版本的 GitHub Release。 +- **先更新功能文档。** 条目链接过去的页面不能和条目内容矛盾。 + ## 发 PR 前跑一致性检查 ```sh diff --git a/README.md b/README.md index 5b85536..ee957f7 100644 --- a/README.md +++ b/README.md @@ -26,6 +26,7 @@ The product source code lives in [`felinics/Memoh`](https://github.com/felinics/ - **Integrations** for channels and providers, including messaging platforms, LLMs, memory providers, TTS, and web search. - **Self-hosted** docs for Desktop, Server Deploy, workspace backends, Kata, and SQLite. - **English, Chinese, Japanese, and Russian docs** under `docs/`, `docs/zh/`, `docs/ja/`, and `docs/ru/`. +- **What's new** in `docs/whats-new.md`: a curated digest of release highlights. The full per-version changelog lives in [GitHub Releases](https://github.com/felinics/Memoh/releases). - **Static assets** under `docs/public/`, including screenshots and logos. - **VitePress config** under `docs/.vitepress/`. @@ -101,6 +102,7 @@ pnpm preview │ ├── zh/ # Simplified Chinese documentation and redirects │ ├── ja/ # Japanese documentation and redirects │ ├── ru/ # Russian documentation and redirects +│ ├── whats-new.md # Release highlights digest │ └── *.md # Landing and compatibility pages ├── package.json └── pnpm-lock.yaml @@ -110,6 +112,7 @@ pnpm preview ### 2026-10 +- **What's new page**: a curated digest of release highlights in every locale, linked from the top nav; GitHub Releases remains the full changelog. First entry: the October 19 update (Grok Build, cloud desktop copy and paste, scheduled-task sessions, prompt-cache fixes). Agents / ACP now documents Grok Build. - **Client-first corrections round**: top nav is now Guides / Help Center (Integrations and About removed); the Deployment sidebar group is back (Server Deploy, Workspace Backends, Connectors). - **Apps model**: Supermarket and Skills pages rewritten around the unified App concept (an App bundles Skills, dependencies, and connectors); Skills now documents workspace directories instead of a removed management UI; Connectors moved to the Deployment section. - **Cloud-baseline Workspace page**: open-source backend configuration and CDI/GPU passthrough moved to Workspace Backends; Preferences page removed; Memory provider entries consolidated into one; TTS: Edge removed. diff --git a/README_CN.md b/README_CN.md index 900efcc..a92c693 100644 --- a/README_CN.md +++ b/README_CN.md @@ -26,6 +26,7 @@ - **集成**:渠道和提供方,包括消息平台、LLM、记忆提供方、TTS 和网页搜索。 - **自托管**:Desktop、Server Deploy、workspace backend、Kata 和 SQLite 等开源部署文档。 - 英文、中文、日文和俄文文档,分别位于 `docs/`、`docs/zh/`、`docs/ja/` 和 `docs/ru/`。 +- 最新动态,位于 `docs/whats-new.md`:精选的版本更新速览。按版本的完整更新日志见 [GitHub Releases](https://github.com/felinics/Memoh/releases)。 - 截图、logo 等静态资源,位于 `docs/public/`。 - VitePress 配置,位于 `docs/.vitepress/`。 @@ -101,6 +102,7 @@ pnpm preview │ ├── zh/ # 中文文档和重定向页面 │ ├── ja/ # 日文文档和重定向页面 │ ├── ru/ # 俄文文档和重定向页面 +│ ├── whats-new.md # 版本更新速览 │ └── *.md # 入口和兼容页面 ├── package.json └── pnpm-lock.yaml @@ -110,6 +112,7 @@ pnpm preview ### 2026-10 +- **最新动态页面**:各语言新增精选的版本更新速览,顶栏可直达;GitHub Releases 仍是完整的更新日志。第一条为 10 月 19 日更新(Grok Build、云桌面复制粘贴、定时任务会话、Prompt 缓存修复)。Agents / ACP 页补充 Grok Build。 - **客户端优先修正**:顶栏改为 教程 / 帮助中心(移除 集成 与 关于);侧边栏恢复自部署分组(Server Deploy、Workspace 后端、连接器)。 - **应用(App)模型**:应用市场与技能页面按统一的 App 概念重写(一个 App 打包 Skills、依赖和连接器);技能页改为说明工作区目录,不再描述已移除的管理界面;连接器移入自部署章节。 - **工作区页面以 Cloud 为基准**:开源后端配置与 CDI/GPU 透传移至 Workspace 后端;移除用户偏好页;记忆提供方条目合并为一个;移除 TTS: Edge。 diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts index 9f54162..eba2da4 100644 --- a/docs/.vitepress/config.ts +++ b/docs/.vitepress/config.ts @@ -23,6 +23,7 @@ export default defineConfig({ themeConfig: { nav: [ { text: 'Guides', link: '/guides/' }, + { text: "What's new", link: '/whats-new' }, { text: 'Help Center', link: 'https://memoh.ai/help' }, ], }, @@ -33,6 +34,7 @@ export default defineConfig({ themeConfig: { nav: [ { text: '教程', link: '/zh/guides/' }, + { text: '最新动态', link: '/zh/whats-new' }, { text: '帮助中心', link: 'https://memoh.ai/help' }, ], }, @@ -43,6 +45,7 @@ export default defineConfig({ themeConfig: { nav: [ { text: 'ガイド', link: '/ja/guides/' }, + { text: '新着情報', link: '/ja/whats-new' }, { text: 'ヘルプセンター', link: 'https://memoh.ai/help' }, ], }, @@ -53,6 +56,7 @@ export default defineConfig({ themeConfig: { nav: [ { text: 'Руководства', link: '/ru/guides/' }, + { text: 'Что нового', link: '/ru/whats-new' }, { text: 'Центр помощи', link: 'https://memoh.ai/help' }, ], }, diff --git a/docs/.vitepress/en.ts b/docs/.vitepress/en.ts index 90770f5..80fa960 100644 --- a/docs/.vitepress/en.ts +++ b/docs/.vitepress/en.ts @@ -3,6 +3,7 @@ const references = [ text: 'References', items: [ { text: 'Overview', link: '/guides/' }, + { text: "What's new", link: '/whats-new.md' }, ], }, { @@ -70,4 +71,5 @@ export const en = { '/guides/': references, '/integrations/': references, '/self-hosted/': references, + '/whats-new': references, } diff --git a/docs/.vitepress/ja.ts b/docs/.vitepress/ja.ts index 3522ded..9a777c2 100644 --- a/docs/.vitepress/ja.ts +++ b/docs/.vitepress/ja.ts @@ -3,6 +3,7 @@ const references = [ text: 'リファレンス', items: [ { text: '総覧', link: '/ja/guides/' }, + { text: '新着情報', link: '/ja/whats-new.md' }, ], }, { @@ -70,4 +71,5 @@ export const ja = { '/ja/guides/': references, '/ja/integrations/': references, '/ja/self-hosted/': references, + '/ja/whats-new': references, } diff --git a/docs/.vitepress/ru.ts b/docs/.vitepress/ru.ts index 01c12af..53df95b 100644 --- a/docs/.vitepress/ru.ts +++ b/docs/.vitepress/ru.ts @@ -3,6 +3,7 @@ const references = [ text: 'Справочник', items: [ { text: 'Обзор', link: '/ru/guides/' }, + { text: 'Что нового', link: '/ru/whats-new.md' }, ], }, { @@ -70,4 +71,5 @@ export const ru = { '/ru/guides/': references, '/ru/integrations/': references, '/ru/self-hosted/': references, + '/ru/whats-new': references, } diff --git a/docs/.vitepress/zh.ts b/docs/.vitepress/zh.ts index 4194f19..2c8cbf6 100644 --- a/docs/.vitepress/zh.ts +++ b/docs/.vitepress/zh.ts @@ -3,6 +3,7 @@ const references = [ text: '参考文档', items: [ { text: '总览', link: '/zh/guides/' }, + { text: '最新动态', link: '/zh/whats-new.md' }, ], }, { @@ -70,4 +71,5 @@ export const zh = { '/zh/guides/': references, '/zh/integrations/': references, '/zh/self-hosted/': references, + '/zh/whats-new': references, } diff --git a/docs/guides/acp.md b/docs/guides/acp.md index 8d6209a..5009527 100644 --- a/docs/guides/acp.md +++ b/docs/guides/acp.md @@ -2,7 +2,7 @@ Memoh can connect a bot to ACP-compatible coding agents. ACP agents are external coding workflows that work from the bot's chat workspace while keeping their sessions separate from normal chat and discuss conversations. -Two agent profiles ship with Memoh: **Codex** and **Claude Code**. Treat them as supported setup paths, not as the only possible ACP-compatible agents over time. +Three agent profiles ship with Memoh: **Codex**, **Claude Code**, and **Grok Build**. Treat them as supported setup paths, not as the only possible ACP-compatible agents over time. ACP agents run inside the bot's container workspace, so the bot must use a container-backed workspace backend. @@ -23,6 +23,7 @@ A row shows one of three states: **Needs setup** (enabled but missing credential |-------|---------|-------|--------------| | **Codex** | ✅ | ✅ ChatGPT sign-in with device code | ✅ | | **Claude Code** | ✅ | ✅ paste a token from `claude setup-token` | ✅ | +| **Grok Build** | ✅ xAI API key | ✅ Grok account sign-in with device code | — | **Self-managed** means Memoh launches the agent against configuration you maintain yourself inside the workspace. @@ -32,9 +33,23 @@ In the Codex settings, click **Use Device Code**. Memoh shows a verification URL > Only enter the code on the displayed OpenAI verification URL — device codes can be used for phishing. +### Grok Build {#grok-build} + +Grok Build authenticates with an xAI API key or your Grok account. While creating a bot you can only provide an API key; Grok account sign-in is available in the agent's settings once the bot exists. Memoh shows a verification page and a one-time code — confirm it only on the accounts.x.ai address shown there — and finishes authorization automatically. Memoh encrypts the agent's Grok credentials and provides them to Grok Build only at runtime. + +Grok Build applies its own permission mode to its built-in tools: + +| Mode | Behavior | +|------|----------| +| **Ask** (default) | Ask before each operation that has side effects. | +| **Auto** | Let Grok decide which operations are safe to run without asking. | +| **Always approve** | Approve every operation without asking. Memoh's own tool permissions still apply. | + +The bot's **Tool Approval** rules govern only the tools Memoh provides. When Grok Build asks for approval, Memoh shows the request as a card for a user with the matching workspace permission to decide. Grok Build can fork a conversation only from its latest turn. + ## Adapter Updates -The Codex and Claude Code adapters are npm-backed. Memoh resolves the adapter's latest published version once per server run (per bot) and launches that version, so adapter fixes arrive without upgrading Memoh itself. If the lookup or launch fails, Memoh falls back to the adapter version bundled in the workspace image until the next server restart. +The Codex and Claude Code adapters are npm-backed. Memoh resolves the adapter's latest published version once per server run (per bot) and launches that version, so adapter fixes arrive without upgrading Memoh itself. If the lookup or launch fails, Memoh falls back to the adapter version bundled in the workspace image until the next server restart. Grok Build needs no adapter: it speaks ACP natively, and Memoh runs the `grok` CLI provided as a managed workspace dependency. --- diff --git a/docs/ja/guides/acp.md b/docs/ja/guides/acp.md index dc20c19..56cbc71 100644 --- a/docs/ja/guides/acp.md +++ b/docs/ja/guides/acp.md @@ -2,7 +2,7 @@ Memoh は Bot を ACP 互換のコーディングエージェントに接続できます。ACP エージェントは外部のコーディングワークフローで、Bot のチャットワークスペースから作業しつつ、自分のセッションを通常の chat / discuss とは分けて保ちます。 -組み込みの agent profile は **Codex** と **Claude Code** の 2 つです。これらは現時点でサポートされているセットアップ経路であって、今後接続できる ACP 互換エージェントがこれだけに限られるという意味ではありません。 +組み込みの agent profile は **Codex**、**Claude Code**、**Grok Build** の 3 つです。これらは現時点でサポートされているセットアップ経路であって、今後接続できる ACP 互換エージェントがこれだけに限られるという意味ではありません。 ACP エージェントは Bot のコンテナワークスペース内で動くため、Bot はコンテナベースの Workspace バックエンドを使っている必要があります。 @@ -23,6 +23,7 @@ ACP エージェントは Bot のコンテナワークスペース内で動く |--------|---------|-------|--------------| | **Codex** | ✅ | ✅ ChatGPT ログイン(デバイスコード) | ✅ | | **Claude Code** | ✅ | ✅ `claude setup-token` で生成した token を貼り付け | ✅ | +| **Grok Build** | ✅ xAI API Key | ✅ Grok アカウントでサインイン(デバイスコード) | — | **Self-managed** は、あなたがワークスペース内で自分で管理している設定をそのまま使って、Memoh がエージェントを起動することを意味します。 @@ -32,9 +33,23 @@ Codex の設定で **Use Device Code** をクリックすると、Memoh が検 > ワンタイムコードは、表示された OpenAI の検証用 URL でだけ入力してください——デバイスコードはフィッシングに悪用されることがあります。 +### Grok Build {#grok-build} + +Grok Build は xAI API Key または Grok アカウントで認証します。Bot の作成時に入力できるのは API Key だけで、Grok アカウントでのサインインは Bot を作成したあとにエージェントの設定から行います。Memoh が認証ページとワンタイムコードを表示するので、表示された accounts.x.ai のページでだけ確認してください。認証は自動で完了します。Memoh はこのエージェントの Grok 認証情報を暗号化して保存し、実行時にのみ Grok Build に渡します。 + +Grok Build は組み込みツールに独自の権限モードを適用します: + +| モード | 動作 | +|--------|------| +| **毎回確認**(既定) | 副作用のある操作を実行する前に確認します。 | +| **自動判断** | 安全に実行できる操作を Grok が判断し、確認を省きます。 | +| **すべて承認** | すべての操作を確認なしで承認します。Memoh ツールの権限は引き続き適用されます。 | + +Bot の **Toolの承認** ルールが適用されるのは、Memoh が提供するツールだけです。Grok Build からの確認の要求はカードとして表示され、該当する Workspace 権限を持つユーザーが判断します。Grok Build が会話をフォークできるのは、最新のターンからだけです。 + ## Adapter の自動更新 -Codex と Claude Code の adapter は npm パッケージです。Memoh はサービスプロセスの起動後に(Bot ごとに)1 回だけ npm 上の最新バージョンを解決してそれを起動するため、adapter の修正は Memoh 自体をアップグレードしなくても手に入ります。解決や起動に失敗した場合は、次のサービス再起動まで、ワークスペースイメージに同梱されたバージョンにフォールバックします。 +Codex と Claude Code の adapter は npm パッケージです。Memoh はサービスプロセスの起動後に(Bot ごとに)1 回だけ npm 上の最新バージョンを解決してそれを起動するため、adapter の修正は Memoh 自体をアップグレードしなくても手に入ります。解決や起動に失敗した場合は、次のサービス再起動まで、ワークスペースイメージに同梱されたバージョンにフォールバックします。Grok Build には adapter は不要です。ACP にネイティブ対応しており、Memoh はマネージドなワークスペース依存関係として提供される `grok` CLI を実行します。 --- diff --git a/docs/ja/whats-new.md b/docs/ja/whats-new.md new file mode 100644 index 0000000..6b11ce2 --- /dev/null +++ b/docs/ja/whats-new.md @@ -0,0 +1,48 @@ +--- +title: 新着情報 +description: 使い方を変える Memoh の新機能ダイジェスト。 +outline: [2, 3] +--- + +# 新着情報 + +使い方を変える Memoh の新機能をまとめたダイジェストです。バージョンごとのすべての変更とバグ修正は、[GitHub のリリースノート](https://github.com/felinics/Memoh/releases)を参照してください。 + +## 2026 年 10 月 19 日 {#2026-10-19} + +![Memoh アップデート:Grok Build がファーストパーティのエージェントに、クラウドデスクトップでコピー&ペースト、すっきりしたスケジュールタスクのセッション、キャッシュヒットの大幅改善](/images/whats-new/2026-10-19.png) + +::: info 9 月にご契約の方へ +9 月にご契約いただいた方には、追加の 1 か月分をアカウントに付与しました。 +::: + +### Grok Build を組み込みエージェントとして使う {#2026-10-19-grok-build} + +Grok Build が、Codex・Claude Code と並ぶファーストパーティのエージェントとして Memoh に同梱されました。Bot の **エージェント** タブで追加し、Grok アカウントでサインインするか、xAI API Key を入力してください。 + +Grok Build は組み込みツールに独自の権限モードを適用します:**毎回確認**(既定。副作用のある操作の前に確認)、**自動判断**(安全に実行できる操作を Grok が判断)、**すべて承認** のいずれかです。Grok アカウントでのサインインは、Bot を作成したあとにエージェントの設定から行えます。詳しくは [Agents / ACP](./guides/acp.md#grok-build) を参照してください。 + +### クラウドデスクトップでコピー&ペーストし、自分の言語で入力する {#2026-10-19-desktop-input} + +テキストを、手元のコンピューターと Bot のデスクトップの間で双方向にコピー&ペーストできるようになりました。ローカルの入力方式(IME)も使えます:自分のキーボードで日本語や中国語などを入力して確定すると、その文字がデスクトップに入力されます。macOS の編集ショートカットもデスクトップ上でそのまま使えます。 + +詳しくは [Browser / Computer Use](./guides/browser-computer-use.md) を参照してください。 + +### スケジュールタスクのセッションをすっきり保つ {#2026-10-19-schedule-sessions} + +実行のたびに新しいセッションを作るタスクが、**最近** を埋め尽くすことはなくなりました。**スケジュール** パネルでタスクのカードをクリックすると、各実行で作られたセッションが一覧され(失敗した実行には印が付きます)、どれでも開けます。**編集** はカードの **…** メニューに移りました。 + +片付けも速くなりました:セッションのメニュー(右クリック、モバイルでは長押しでも可)から **選択** を選び、好きなだけセッションにチェックを入れて、まとめて削除できます。 + +詳しくは [スケジュールタスク](./guides/schedule.md) と [セッション](./guides/sessions.md) を参照してください。 + +### プロンプトキャッシュのヒット率を大幅改善 {#2026-10-19-cache-hits} + +長い会話でプロンプトキャッシュがヒットしなかった、2 つの設計上の欠陥を修正しました: + +- **履歴は追記のみに。** 会話が 10 メッセージを超えると、以前のターンのツール呼び出し・結果・推論が取り除かれ、プロンプトの先頭が書き換わっていました。今後はそれらが残るため、エージェントは以前に読んだファイルや実行したコマンドを把握したまま、作業をやり直さずに済みます。 +- **メモリがキャッシュを壊さないように。** メモリの概要はプロンプト内で会話履歴より前にあり、毎ターン書き換えられていました。メモリは引き続きすぐに保存されますが、概要の更新はキャッシュが冷えたタイミングに行い、30 分以上遅れた場合は強制的に更新します。 + +その結果、キャッシュヒット率が大きく向上しました。 + +[v0.22.0 の完全なリリースノートを読む →](https://github.com/felinics/Memoh/releases/tag/v0.22.0) diff --git a/docs/public/images/whats-new/2026-10-19.png b/docs/public/images/whats-new/2026-10-19.png new file mode 100644 index 0000000..80c7f5c Binary files /dev/null and b/docs/public/images/whats-new/2026-10-19.png differ diff --git a/docs/ru/guides/acp.md b/docs/ru/guides/acp.md index 2980e3f..c89a2ae 100644 --- a/docs/ru/guides/acp.md +++ b/docs/ru/guides/acp.md @@ -2,7 +2,7 @@ Memoh может подключить Bot к ACP-совместимым агентам для программирования. ACP-агенты — это внешние рабочие процессы написания кода: они работают из чат-пространства Bot, но держат свои сессии отдельно от обычных разговоров chat и discuss. -В комплекте с Memoh идут два профиля агентов: **Codex** и **Claude Code**. Считайте их поддерживаемыми путями настройки, а не единственными возможными ACP-совместимыми агентами на будущее. +В комплекте с Memoh идут три профиля агентов: **Codex**, **Claude Code** и **Grok Build**. Считайте их поддерживаемыми путями настройки, а не единственными возможными ACP-совместимыми агентами на будущее. ACP-агенты выполняются внутри контейнерного рабочего пространства Bot, поэтому Bot должен использовать контейнерный бэкенд рабочего пространства. @@ -23,6 +23,7 @@ ACP-агенты выполняются внутри контейнерного |-------|---------|-------|--------------| | **Codex** | ✅ | ✅ вход через ChatGPT по коду устройства | ✅ | | **Claude Code** | ✅ | ✅ вставьте токен из `claude setup-token` | ✅ | +| **Grok Build** | ✅ API-ключ xAI | ✅ вход через аккаунт Grok по коду устройства | — | **Self-managed** означает, что Memoh запускает агента с конфигурацией, которую вы поддерживаете сами внутри рабочего пространства. @@ -32,9 +33,23 @@ ACP-агенты выполняются внутри контейнерного > Вводите код только на показанном URL подтверждения OpenAI — коды устройств могут использоваться для фишинга. +### Grok Build {#grok-build} + +Grok Build проходит аутентификацию по API-ключу xAI или через аккаунт Grok. При создании Bot можно указать только API-ключ; войти через аккаунт Grok можно в настройках агента, когда Bot уже создан. Memoh покажет страницу подтверждения и одноразовый код — подтверждайте его только на показанном адресе accounts.x.ai, — после чего авторизация завершится автоматически. Memoh хранит учётные данные Grok этого агента в зашифрованном виде и передаёт их Grok Build только во время выполнения. + +Для своих встроенных инструментов Grok Build применяет собственный режим разрешений: + +| Режим | Поведение | +|-------|-----------| +| **Ask** (по умолчанию) | Спрашивать перед каждой операцией с побочными эффектами. | +| **Auto** | Grok сам решает, какие операции безопасно выполнять без вопроса. | +| **Always approve** | Одобрять все операции без вопросов. Разрешения инструментов Memoh по-прежнему действуют. | + +Правила **Tool Approval** у Bot распространяются только на инструменты, которые предоставляет Memoh. Когда Grok Build запрашивает подтверждение, Memoh показывает запрос карточкой, и решение принимает пользователь с соответствующими правами на рабочее пространство. Grok Build может ответвить разговор только от последнего хода. + ## Обновления адаптеров -Адаптеры Codex и Claude Code распространяются через npm. Memoh определяет последнюю опубликованную версию адаптера один раз за запуск сервера (для каждого Bot) и запускает именно её, поэтому исправления адаптеров приходят без обновления самого Memoh. Если поиск версии или запуск не удаётся, Memoh откатывается на версию адаптера из образа рабочего пространства — до следующего перезапуска сервера. +Адаптеры Codex и Claude Code распространяются через npm. Memoh определяет последнюю опубликованную версию адаптера один раз за запуск сервера (для каждого Bot) и запускает именно её, поэтому исправления адаптеров приходят без обновления самого Memoh. Если поиск версии или запуск не удаётся, Memoh откатывается на версию адаптера из образа рабочего пространства — до следующего перезапуска сервера. Grok Build адаптер не нужен: он изначально поддерживает ACP, и Memoh запускает CLI `grok`, который поставляется как управляемая зависимость рабочего пространства. --- diff --git a/docs/ru/whats-new.md b/docs/ru/whats-new.md new file mode 100644 index 0000000..330b161 --- /dev/null +++ b/docs/ru/whats-new.md @@ -0,0 +1,48 @@ +--- +title: Что нового +description: Дайджест возможностей Memoh, которые меняют то, как вы работаете. +outline: [2, 3] +--- + +# Что нового + +Дайджест возможностей Memoh, которые могут изменить то, как вы работаете. Все изменения и исправления по версиям — в [заметках о выпусках на GitHub](https://github.com/felinics/Memoh/releases). + +## 19 октября 2026 г. {#2026-10-19} + +![Обновление Memoh: Grok Build как собственный агент, копирование и вставка на облачном рабочем столе, аккуратные сессии задач по расписанию, намного больше попаданий в кэш](/images/whats-new/2026-10-19.png) + +::: info Подписчикам сентября +Если вы оформили подписку в сентябре, дополнительный месяц уже добавлен к вашему аккаунту. +::: + +### Используйте Grok Build как встроенного агента {#2026-10-19-grok-build} + +Grok Build теперь поставляется вместе с Memoh как собственный агент — наравне с Codex и Claude Code. Добавьте его на вкладке **Agents** нужного Bot, затем войдите через аккаунт Grok или укажите API-ключ xAI. + +Для своих встроенных инструментов Grok Build применяет собственный режим разрешений: **Ask** — спрашивать перед каждой операцией с побочными эффектами (по умолчанию), **Auto** — Grok сам решает, что безопасно выполнять, или **Always approve** — одобрять всё. Вход через аккаунт Grok доступен в настройках агента после создания Bot. Подробнее — в разделе [Agents / ACP](./guides/acp.md#grok-build). + +### Копируйте, вставляйте и печатайте на своём языке на облачном рабочем столе {#2026-10-19-desktop-input} + +Текст теперь копируется и вставляется в обе стороны между вашим компьютером и рабочим столом Bot. Работает и ваш локальный метод ввода: набирайте текст на любом языке со своей клавиатуры, и подтверждённый текст будет введён на рабочем столе. Сочетания клавиш редактирования macOS там тоже работают. + +Подробнее — в разделе [Browser / Computer Use](./guides/browser-computer-use.md). + +### Порядок в сессиях задач по расписанию {#2026-10-19-schedule-sessions} + +Задачи, которые создают новую сессию при каждом запуске, больше не засоряют список **Recents**. В панели **Schedule** нажмите на карточку задачи, чтобы увидеть сессию каждого запуска (неудачные запуски отмечены), и откройте любую из них. Пункт **Edit** переехал в меню **…** на карточке. + +Наводить порядок стало быстрее: выберите **Select** в меню сессии (или щёлкните по ней правой кнопкой мыши; на телефоне — долгое нажатие), отметьте сколько угодно сессий и удалите их за один раз. + +Подробнее — в разделах [Задачи по расписанию](./guides/schedule.md) и [Сессии](./guides/sessions.md). + +### Намного больше попаданий в кэш промптов {#2026-10-19-cache-hits} + +Мы исправили два конструктивных недостатка, из-за которых длинные разговоры не попадали в кэш промптов: + +- **История только дополняется.** Когда разговор превышал 10 сообщений, вызовы инструментов, их результаты и рассуждения из прошлых ходов удалялись, и начало промпта переписывалось. Теперь они сохраняются: агент по-прежнему видит, какие файлы читал и какие команды запускал, и не переделывает работу заново. +- **Память больше не сбивает кэш.** Обзор памяти стоит в промпте перед историей разговора и раньше переписывался после каждого хода. Воспоминания по-прежнему сохраняются сразу, а обзор теперь обновляется, когда кэш уже остыл, или принудительно, если отстал больше чем на 30 минут. + +В результате доля попаданий в кэш заметно выросла. + +[Полные заметки о выпуске v0.22.0 →](https://github.com/felinics/Memoh/releases/tag/v0.22.0) diff --git a/docs/whats-new.md b/docs/whats-new.md new file mode 100644 index 0000000..89c708a --- /dev/null +++ b/docs/whats-new.md @@ -0,0 +1,48 @@ +--- +title: What's new +description: A digest of Memoh features that change how you work. +outline: [2, 3] +--- + +# What's new + +A digest of Memoh features that can change how you work. For every versioned change and bug fix, see the [release notes on GitHub](https://github.com/felinics/Memoh/releases). + +## October 19, 2026 {#2026-10-19} + +![Memoh update: Grok Build as a first-party agent, copy and paste on the cloud desktop, cleaner scheduled-task sessions, far more cache hits](/images/whats-new/2026-10-19.png) + +::: info September subscribers +If you subscribed in September, your extra month has been added to your account. +::: + +### Use Grok Build as a built-in agent {#2026-10-19-grok-build} + +Grok Build now ships with Memoh as a first-party agent, next to Codex and Claude Code. Add it on a bot's **Agents** tab, then sign in with your Grok account or paste an xAI API key. + +Grok Build applies its own permission mode to its built-in tools: **Ask** before each operation that has side effects (the default), **Auto** to let Grok decide what is safe to run, or **Always approve**. Grok account sign-in is available in the agent's settings once the bot exists. See [Agents / ACP](./guides/acp.md#grok-build). + +### Copy, paste, and type in your own language on the cloud desktop {#2026-10-19-desktop-input} + +Text now copies and pastes both ways between your computer and the bot's desktop. Your local input method works there too: compose Chinese, Japanese, or any other language on your own keyboard, and the confirmed text is typed on the desktop. macOS editing shortcuts work there as well. + +See [Browser / Computer Use](./guides/browser-computer-use.md). + +### Keep scheduled-task sessions tidy {#2026-10-19-schedule-sessions} + +Tasks that start a new session on every run no longer crowd **Recents**. In the **Schedule** panel, click a task's card to list the session from each run — failed runs are marked — and open any of them. **Edit** now lives in the card's **…** menu. + +Cleaning up is quicker too: choose **Select** from a session's menu (or right-click it; long-press on mobile), tick as many sessions as you like, and delete them in one go. + +See [Scheduled Tasks](./guides/schedule.md) and [Sessions](./guides/sessions.md). + +### Hit the prompt cache far more often {#2026-10-19-cache-hits} + +We fixed two design flaws that kept long conversations from hitting the prompt cache: + +- **History is append-only.** Once a conversation passed 10 messages, earlier turns' tool calls, results, and reasoning were stripped out, which rewrote the start of the prompt. They now stay, so the agent still sees the files it read and the commands it ran instead of redoing the work. +- **Memory no longer breaks the cache.** The memory overview sits ahead of the conversation history in the prompt, and it was rewritten after every turn. Memories are still saved right away; the overview now refreshes when the cache is cold, or once it has fallen 30 minutes behind. + +Cache hit rates are way up as a result. + +[Read the full v0.22.0 release notes →](https://github.com/felinics/Memoh/releases/tag/v0.22.0) diff --git a/docs/zh/guides/acp.md b/docs/zh/guides/acp.md index 7694f0c..2b769ac 100644 --- a/docs/zh/guides/acp.md +++ b/docs/zh/guides/acp.md @@ -2,7 +2,7 @@ Memoh 可以把 Bot 连接到 ACP 兼容的编码智能体。ACP 智能体是外部编码工作流,可以从 Bot 的聊天 workspace 里工作,同时把自己的会话和普通 chat / discuss 分开。 -内置两个 agent profile:**Codex**、**Claude Code**。它们是当前支持的配置路径,不代表未来只能接这两种。 +内置三个 agent profile:**Codex**、**Claude Code**、**Grok Build**。它们是当前支持的配置路径,不代表未来只能接这三种。 ACP 智能体在 Bot 的容器 workspace 里运行,所以 Bot 必须使用容器类 workspace backend。 @@ -23,6 +23,7 @@ ACP 智能体在 Bot 的容器 workspace 里运行,所以 Bot 必须使用容 |--------|---------|-------|--------------| | **Codex** | ✅ | ✅ ChatGPT 登录(设备码) | ✅ | | **Claude Code** | ✅ | ✅ 粘贴 `claude setup-token` 生成的 token | ✅ | +| **Grok Build** | ✅ xAI API Key | ✅ Grok 账号登录(设备码) | — | **Self-managed** 表示 Memoh 直接用你在 workspace 里自己维护的配置来启动智能体。 @@ -32,9 +33,23 @@ ACP 智能体在 Bot 的容器 workspace 里运行,所以 Bot 必须使用容 > 一次性代码只在显示的 OpenAI 验证 URL 上输入——设备码可能被用于钓鱼。 +### Grok Build {#grok-build} + +Grok Build 用 xAI API Key 或 Grok 账号认证。创建 Bot 时只能先填 API Key;Grok 账号要等 Bot 创建之后,在该智能体的设置里登录。Memoh 会显示验证页面和一次性代码,你在页面显示的 accounts.x.ai 地址上确认后,授权自动完成。不要在其他地址上确认这个代码。Memoh 会加密保存这个智能体的 Grok 凭据,并且只在运行时提供给 Grok Build。 + +Grok Build 的内置工具遵循它自己的权限模式: + +| 模式 | 行为 | +|------|------| +| **每次询问**(默认) | 执行有副作用的操作前先由你确认。 | +| **自动判断** | 由 Grok 判断哪些操作可以安全执行,不再逐一询问。 | +| **全部批准** | 所有操作直接批准,不再询问;Memoh 工具权限仍然生效。 | + +Bot 的 **工具审核** 规则只约束 Memoh 提供的工具。Grok Build 发来的询问会以卡片展示,由持有对应工作区权限的用户决定。Grok Build 只能从最新一轮分叉对话。 + ## Adapter 自动升级 -Codex 和 Claude Code 的 adapter 是 npm 包。Memoh 每次服务进程启动后(按 bot)解析一次 npm 上的最新版本并启动它,adapter 的修复不需要升级 Memoh 就能拿到。解析或启动失败时回退到 workspace 镜像里内置的版本,直到下次服务重启。 +Codex 和 Claude Code 的 adapter 是 npm 包。Memoh 每次服务进程启动后(按 bot)解析一次 npm 上的最新版本并启动它,adapter 的修复不需要升级 Memoh 就能拿到。解析或启动失败时回退到 workspace 镜像里内置的版本,直到下次服务重启。Grok Build 不需要 adapter:它原生支持 ACP,Memoh 运行的是作为受管工作区依赖提供的 `grok` CLI。 --- diff --git a/docs/zh/whats-new.md b/docs/zh/whats-new.md new file mode 100644 index 0000000..bd957de --- /dev/null +++ b/docs/zh/whats-new.md @@ -0,0 +1,48 @@ +--- +title: 最新动态 +description: Memoh 新功能速览:会改变你使用方式的更新。 +outline: [2, 3] +--- + +# 最新动态 + +Memoh 新功能速览,只收录会改变你使用方式的更新。每个版本的完整改动和 Bug 修复,见 [GitHub 上的更新日志](https://github.com/felinics/Memoh/releases)。 + +## 2026 年 10 月 19 日 {#2026-10-19} + +![Memoh 更新:Grok Build 成为一方 Agent、云桌面复制粘贴、更清爽的定时任务会话、缓存命中大幅提升](/images/whats-new/2026-10-19.png) + +::: info 9 月订阅用户 +如果你在 9 月订阅,额外的一个月已经加到你的账户中。 +::: + +### 把 Grok Build 用作内置 Agent {#2026-10-19-grok-build} + +Grok Build 现在作为一方 Agent 随 Memoh 提供,与 Codex、Claude Code 并列。在 Bot 的 **Agent** 标签页添加它,然后用 Grok 账号登录,或者填入 xAI API Key。 + +Grok Build 的内置工具遵循它自己的权限模式:**每次询问**(默认,执行有副作用的操作前先确认)、**自动判断**(由 Grok 判断哪些操作可以安全执行),或 **全部批准**。Grok 账号登录要在 Bot 创建之后、到该 Agent 的设置里进行。详见 [Agents / ACP](./guides/acp.md#grok-build)。 + +### 在云桌面里复制粘贴、用自己的输入法打字 {#2026-10-19-desktop-input} + +文本现在可以在你的电脑和 Bot 的桌面之间双向复制粘贴。本机输入法也能用了:在自己的键盘上用中文、日文或其他语言输入,确认后的文字会直接打到桌面上。macOS 的编辑快捷键在桌面里同样可用。 + +详见 [Browser / Computer Use](./guides/browser-computer-use.md)。 + +### 定时任务的会话更清爽 {#2026-10-19-schedule-sessions} + +每次运行都新建会话的定时任务,不会再把 **最近** 塞满。在 **日程** 面板里点开任务卡片,就能看到每次运行创建的会话(失败的运行会标出来),点任意一条即可打开。**编辑** 移到了卡片的 **…** 菜单里。 + +清理也更快了:在会话的菜单里选择 **多选**(也可以右键,手机上长按),勾选任意多个会话,一次删除。 + +详见 [定时任务](./guides/schedule.md) 和 [会话](./guides/sessions.md)。 + +### Prompt 缓存命中率大幅提升 {#2026-10-19-cache-hits} + +我们修复了两个让长对话命中不了 prompt 缓存的设计缺陷: + +- **历史只追加。** 对话超过 10 条消息后,以前各轮的工具调用、工具结果和推理会被剥离,等于改写了 prompt 的开头。现在它们都会保留,Agent 仍能看到之前读过的文件、跑过的命令,不必再重做一遍。 +- **记忆不再打断缓存。** 记忆概览在 prompt 里位于整段对话历史之前,以前每轮结束都会重写。现在记忆仍然立即保存,概览则改到缓存冷的时候刷新,落后超过 30 分钟时强制刷新。 + +缓存命中率因此大幅提升。 + +[查看 v0.22.0 完整更新日志 →](https://github.com/felinics/Memoh/releases/tag/v0.22.0)