From 04674fb41f0854b9aa82c203f21a58ea6102b64f Mon Sep 17 00:00:00 2001 From: hidb4ai Date: Mon, 12 Oct 2026 10:10:36 +0800 Subject: [PATCH 1/6] chore(release): prepare v1.3.0 --- README.md | 8 ++-- README_CN.md | 8 ++-- README_JP.md | 8 ++-- .../src-tauri/src/transport/operations.json | 2 +- desktop/ui/src/generated/operations.ts | 2 +- docs/en/docs/get-started/install-and-run.md | 27 +++++++------ docs/en/docs/get-started/quickstart.md | 8 ++-- docs/zh/docs/get-started/install-and-run.md | 24 ++++++------ docs/zh/docs/get-started/quickstart.md | 8 ++-- .../dsh/plugins/powercontext/README.md | 4 +- openapi/powercontext.yaml | 2 +- .../http/_generated/operations.py | 2 +- src/powercontext/http/_generated/schema.py | 2 +- tests/test_api_contract.py | 2 +- website/src/lib/releases.ts | 38 +++++++++++++++++++ 15 files changed, 94 insertions(+), 51 deletions(-) diff --git a/README.md b/README.md index 6e0bb1d97d..6bc34ec580 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ PowerContext keeps context with the work across conversations. When you return, [Website](https://powercontext.oceanbase.io/) · [Installation walkthrough](https://powercontext.oceanbase.io/en/docs/get-started/quickstart/) -PowerContext 1.2.0 includes the guided setup. The commands below install this version and connect +PowerContext 1.3.0 includes the guided setup. The commands below install this version and connect the matching Agent integration. ## Pick up where the work left off @@ -33,10 +33,10 @@ evaluation. See the [configuration reference](docs/en/docs/operate/configuration You need Git, [uv](https://docs.astral.sh/uv/getting-started/installation/), and your Agent's CLI. Python 3.11+ is required; uv can provision it. macOS and Linux are supported; Windows support is `experimental`. -Install 1.2.0 and open the interactive configuration wizard in a dedicated directory: +Install 1.3.0 and open the interactive configuration wizard in a dedicated directory: ```bash -uv tool install --force "powercontext[cli,server]==1.2.0" +uv tool install --force "powercontext[cli,server]==1.3.0" mkdir -p powercontext-config cd powercontext-config powercontext config init --language en --output .env @@ -74,7 +74,7 @@ covers Codex and Claude Code, Dashboard login, SSH forwarding, HTTPS prerequisit For example, the matching Codex installation is: ```bash -powercontext setup codex --ref powercontext-v1.2.0 +powercontext setup codex --ref powercontext-v1.3.0 powercontext doctor codex ``` diff --git a/README_CN.md b/README_CN.md index 476376acf9..21770c2e68 100644 --- a/README_CN.md +++ b/README_CN.md @@ -16,7 +16,7 @@ PowerContext 让上下文跟随工作，跨越不同的对话。你回来时， [网站](https://powercontext.oceanbase.io/zh/) · [完整安装流程](https://powercontext.oceanbase.io/zh/docs/get-started/quickstart/) -PowerContext 1.2.0 包含交互式配置向导。下面的命令安装这一版本，并接入相同版本的 Agent 集成。 +PowerContext 1.3.0 包含交互式配置向导。下面的命令安装这一版本，并接入相同版本的 Agent 集成。 ## 从当前进展继续 @@ -32,10 +32,10 @@ PowerContext 1.2.0 包含交互式配置向导。下面的命令安装这一版 准备 Git、[uv](https://docs.astral.sh/uv/getting-started/installation/) 和你使用的 Agent CLI。 需要 Python 3.11+，uv 可以按需安装。支持 macOS 和 Linux；Windows 支持为 `experimental`。 -安装 1.2.0，然后在独立目录里打开交互式配置向导： +安装 1.3.0，然后在独立目录里打开交互式配置向导： ```bash -uv tool install --force "powercontext[cli,server]==1.2.0" +uv tool install --force "powercontext[cli,server]==1.3.0" mkdir -p powercontext-config cd powercontext-config powercontext config init --language zh --output .env @@ -69,7 +69,7 @@ powercontext capabilities SSH 隧道、HTTPS 前提及逐项验收。例如，匹配本版本的 Codex 安装命令是： ```bash -powercontext setup codex --ref powercontext-v1.2.0 +powercontext setup codex --ref powercontext-v1.3.0 powercontext doctor codex ``` diff --git a/README_JP.md b/README_JP.md index d560fd9222..9d4416ec68 100644 --- a/README_JP.md +++ b/README_JP.md @@ -16,7 +16,7 @@ PowerContext は、会話をまたいでもコンテキストを作業ととも [Web サイト](https://powercontext.oceanbase.io/en/) · [インストール手順](https://powercontext.oceanbase.io/en/docs/get-started/quickstart/) -PowerContext 1.2.0 には対話式セットアップが含まれています。 +PowerContext 1.3.0 には対話式セットアップが含まれています。 以下のコマンドでこのバージョンの PowerContext と、対応する Agent 連携をインストールします。 ## 作業の続きをそのまま引き継ぐ @@ -27,10 +27,10 @@ PowerContext 1.2.0 には対話式セットアップが含まれています。 ## 利用中の Agent と接続する -Git、uv、Agent CLI を用意して、1.2.0 をインストールします： +Git、uv、Agent CLI を用意して、1.3.0 をインストールします： ```bash -uv tool install --force "powercontext[cli,server]==1.2.0" +uv tool install --force "powercontext[cli,server]==1.3.0" mkdir -p powercontext-config cd powercontext-config powercontext config init --language en --output .env @@ -50,7 +50,7 @@ Server を起動したまま、別のターミナルで同じ設定ディレク クライアント環境の読み込み、Scope の作成・紐付け、同じバージョンの Agent プラグインのインストールを行います。例： ```bash -powercontext setup codex --ref powercontext-v1.2.0 +powercontext setup codex --ref powercontext-v1.3.0 powercontext doctor codex ``` diff --git a/desktop/src-tauri/src/transport/operations.json b/desktop/src-tauri/src/transport/operations.json index 7599102bbf..82cee3a518 100644 --- a/desktop/src-tauri/src/transport/operations.json +++ b/desktop/src-tauri/src/transport/operations.json @@ -1,5 +1,5 @@ { - "contractSha256": "16eff718a6607ab6ff3d03c2a279ee92c26d8895ac804e7259fc11173ac8e3c8", + "contractSha256": "7aa91ae9af78300e7bdbcc2e8b2135da5749469290a1aee67bc255c3e9a07b0c", "operations": { "get_liveness": { "method": "GET", diff --git a/desktop/ui/src/generated/operations.ts b/desktop/ui/src/generated/operations.ts index 38ab224bdb..ea299aa267 100644 --- a/desktop/ui/src/generated/operations.ts +++ b/desktop/ui/src/generated/operations.ts @@ -15,7 +15,7 @@ */ // Generated from openapi/powercontext.yaml. Do not edit. -export const contractSha256 = "16eff718a6607ab6ff3d03c2a279ee92c26d8895ac804e7259fc11173ac8e3c8"; +export const contractSha256 = "7aa91ae9af78300e7bdbcc2e8b2135da5749469290a1aee67bc255c3e9a07b0c"; export const operations = { "get_liveness": { "method": "GET", diff --git a/docs/en/docs/get-started/install-and-run.md b/docs/en/docs/get-started/install-and-run.md index e806f7432a..8eee957519 100644 --- a/docs/en/docs/get-started/install-and-run.md +++ b/docs/en/docs/get-started/install-and-run.md @@ -1,6 +1,6 @@ --- title: Install and run -description: Install PowerContext 1.2.0 and run the local Server. +description: Install PowerContext 1.3.0 and run the local Server. --- # Install and run @@ -24,12 +24,12 @@ Embedded seekDB is unavailable on Windows. ## Choose a version -These instructions use PowerContext 1.2.0. Keep the package and Agent integration on -the same version: package `1.2.0` and Git tag `powercontext-v1.2.0`. +These instructions use PowerContext 1.3.0. Keep the package and Agent integration on +the same version: package `1.3.0` and Git tag `powercontext-v1.3.0`. ```bash -uv tool install --force "powercontext[cli,server]==1.2.0" -powercontext setup codex --ref powercontext-v1.2.0 +uv tool install --force "powercontext[cli,server]==1.3.0" +powercontext setup codex --ref powercontext-v1.3.0 ``` Check the [capability matrix](../integrations/capabilities.md) for host support and maintenance status. @@ -41,13 +41,13 @@ You need Python 3.11 or newer, Git, and [`uv`](https://docs.astral.sh/uv/) on ma PowerContext from PyPI: ```bash -uv tool install --force "powercontext[cli,server]==1.2.0" +uv tool install --force "powercontext[cli,server]==1.3.0" ``` For a source installation of the same version: ```bash -uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@powercontext-v1.2.0" +uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@powercontext-v1.3.0" ``` The Git command does not leave a repository checkout for you to manage. Git uses its normal credential configuration, @@ -122,7 +122,7 @@ Embedded seekDB is available on Linux and macOS when a compatible `pylibseekdb` support this embedded backend. Install or replace the tool with the optional seekDB extra: ```bash -uv tool install --force "powercontext[cli,server,seekdb]==1.2.0" +uv tool install --force "powercontext[cli,server,seekdb]==1.3.0" ``` When switching from SQLite, remove `POWERCONTEXT_SERVER_DATABASE_URL` from the Server process environment. An explicit @@ -174,15 +174,18 @@ Before upgrading an existing deployment, back up its database and configuration. tag-table constraints during Server startup to support Topic Memory tags. Stop the old Server instances and start one upgraded instance first so the schema upgrade completes before other instances connect. Databases from before 1.0.0 also need the [Artifact processing migration](../operate/artifact-processing-migration.md) if it has not already -been completed. Upgrade the Server, clients, and Agent integrations together. +been completed. Upgrading to 1.3.0 also requires the [offline Atomic Memory migration](../operate/atomic-memory-migration.md) +for existing collection databases. Complete any required Artifact processing migration first, stop all writers, then +apply and verify the Atomic Memory migration. Start the new service only after verification returns `ready: true`. +Upgrade the Server, clients, and Agent integrations together. The Dashboard must be explicitly enabled; static Bearer authentication is optional for local use. See [Deploy the Server](../operate/deploy-server.md). Remote plaintext HTTP connections require explicit client consent; see [Connect to a remote Server](../operate/connect-remote-server.md). -To upgrade to 1.2.0: +To upgrade to 1.3.0: ```bash -uv tool install --force "powercontext[cli,server]==1.2.0" +uv tool install --force "powercontext[cli,server]==1.3.0" ``` To replace the installed tool with another Git ref: @@ -200,7 +203,7 @@ changes. An application that imports the async Client SDK should add it to that application's environment: ```bash -uv add "powercontext[client]==1.2.0" +uv add "powercontext[client]==1.3.0" ``` Use `builtin` for in-process Python composition, `server` for the service, `client` for the Python SDK, or `cli` for diff --git a/docs/en/docs/get-started/quickstart.md b/docs/en/docs/get-started/quickstart.md index 50dc3453b4..e10d508f9e 100644 --- a/docs/en/docs/get-started/quickstart.md +++ b/docs/en/docs/get-started/quickstart.md @@ -6,8 +6,8 @@ description: Configure full memory, connect Codex, and verify Source capture, To # Quick Start Start with installation, discuss a project in Codex, watch its input become Source evidence and an evolving topic, -then recover the decisions in a new session. These instructions use PowerContext 1.2.0, -with the Agent plugin from the matching `powercontext-v1.2.0` tag. +then recover the decisions in a new session. These instructions use PowerContext 1.3.0, +with the Agent plugin from the matching `powercontext-v1.3.0` tag. You need macOS or Linux, Python 3.11+, Git, [uv](https://docs.astral.sh/uv/getting-started/installation/), and an installed Codex CLI. Full memory also needs working Generation and Embedding model APIs: @@ -18,7 +18,7 @@ and recall; that does not enable automatic Topic Memory. ## 1. Install and open the wizard ```bash -uv tool install --force "powercontext[cli,server]==1.2.0" +uv tool install --force "powercontext[cli,server]==1.3.0" mkdir -p ~/powercontext-demo cd ~/powercontext-demo powercontext config init --language en --output .env @@ -96,7 +96,7 @@ Reload the client settings and install the matching plugin: set -a . ./.env set +a -powercontext setup codex --ref powercontext-v1.2.0 +powercontext setup codex --ref powercontext-v1.3.0 powercontext doctor codex codex ``` diff --git a/docs/zh/docs/get-started/install-and-run.md b/docs/zh/docs/get-started/install-and-run.md index c7eedae837..ba6a0f8800 100644 --- a/docs/zh/docs/get-started/install-and-run.md +++ b/docs/zh/docs/get-started/install-and-run.md @@ -1,6 +1,6 @@ --- title: 安装和运行 -description: 安装 PowerContext 1.2.0，并运行本地 Server。 +description: 安装 PowerContext 1.3.0，并运行本地 Server。 --- # 安装和运行 @@ -22,12 +22,12 @@ Windows 的 CLI、Server 和个人服务支持为试验性；各 Agent Host 仍 ## 选择版本 -本页使用 PowerContext 1.2.0。包与 Agent 集成保持版本一致： -Python 包版本为 `1.2.0`，对应 Git tag 为 `powercontext-v1.2.0`。 +本页使用 PowerContext 1.3.0。包与 Agent 集成保持版本一致： +Python 包版本为 `1.3.0`，对应 Git tag 为 `powercontext-v1.3.0`。 ```bash -uv tool install --force "powercontext[cli,server]==1.2.0" -powercontext setup codex --ref powercontext-v1.2.0 +uv tool install --force "powercontext[cli,server]==1.3.0" +powercontext setup codex --ref powercontext-v1.3.0 ``` 宿主支持范围和维护状态见[能力矩阵](../integrations/capabilities.md)。 @@ -39,13 +39,13 @@ powercontext setup codex --ref powercontext-v1.2.0 [`uv`](https://docs.astral.sh/uv/)，然后从 PyPI 安装 PowerContext： ```bash -uv tool install --force "powercontext[cli,server]==1.2.0" +uv tool install --force "powercontext[cli,server]==1.3.0" ``` 如需从源码安装同一版本： ```bash -uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@powercontext-v1.2.0" +uv tool install --force "powercontext[cli,server] @ git+https://github.com/oceanbase/powercontext.git@powercontext-v1.3.0" ``` Git 安装命令不会留下需要自行管理的仓库工作副本。Git 会沿用本机的凭据配置，包括 credential helper 和 SSH 设置。 @@ -112,7 +112,7 @@ powercontext server run --env-file /path/to/powercontext.env 后端。安装或替换工具时加入可选的 seekDB extra： ```bash -uv tool install --force "powercontext[cli,server,seekdb]==1.2.0" +uv tool install --force "powercontext[cli,server,seekdb]==1.3.0" ``` 从 SQLite 切换时，需要从 Server 进程环境中删除 `POWERCONTEXT_SERVER_DATABASE_URL`；seekDB 不接受显式的 @@ -160,14 +160,16 @@ Agent 诊断见[各自的集成文档](../integrations/index.md)；Server 状态 升级已有部署前，先备份数据库和配置。1.1.0 会在 Server 启动时升级旧标签表约束，以支持 Topic Memory 标签。 先停止旧 Server 实例，再启动一个升级后的实例，待结构升级完成后再启动其他实例。对于 1.0.0 之前的数据库， 如果尚未完成[Artifact 处理迁移](../operate/artifact-processing-migration.md)，还需要先执行该迁移。 +升级到 1.3.0 时，已有集合式 Memory 数据库还需完成[Atomic Memory 离线迁移](../operate/atomic-memory-migration.md)。 +先完成所需的 Artifact 处理迁移，再停止所有写入进程，执行 Atomic Memory 迁移并验证 `ready: true` 后启动新服务。 Server、客户端和 Agent 集成需一起升级。Dashboard 需要显式启用，本地使用可选择静态 Bearer 认证， 见[部署 Server](../operate/deploy-server.md)；远程明文 HTTP 连接需要客户端明确同意， 见[连接远程 Server](../operate/connect-remote-server.md)。 -升级到 1.2.0： +升级到 1.3.0： ```bash -uv tool install --force "powercontext[cli,server]==1.2.0" +uv tool install --force "powercontext[cli,server]==1.3.0" ``` 使用其他 Git ref 替换现有工具： @@ -184,7 +186,7 @@ uv tool install --force "powercontext[cli,server] @ git+https://github.com/ocean 如果应用需要导入异步 Client SDK，应把它加入该应用自己的环境： ```bash -uv add "powercontext[client]==1.2.0" +uv add "powercontext[client]==1.3.0" ``` 进程内 Python 组合使用 `builtin`，服务使用 `server`，Python SDK 使用 `client`，基于 Server 的命令行使用 diff --git a/docs/zh/docs/get-started/quickstart.md b/docs/zh/docs/get-started/quickstart.md index 8cfd5add34..7d62b4c825 100644 --- a/docs/zh/docs/get-started/quickstart.md +++ b/docs/zh/docs/get-started/quickstart.md @@ -6,8 +6,8 @@ description: 通过配置向导安装完整记忆能力，接入 Codex，并验 # 快速开始 本页从安装开始，带你完成一次真实的记忆体验：在 Codex 中讨论项目，看到原始输入进入 Source、主题记忆生成并演进， -再在新会话中找回决策。以下命令使用 PowerContext 1.2.0，Agent 插件使用对应的 -`powercontext-v1.2.0` tag。 +再在新会话中找回决策。以下命令使用 PowerContext 1.3.0，Agent 插件使用对应的 +`powercontext-v1.3.0` tag。 需要 macOS 或 Linux、Python 3.11+、Git、[uv](https://docs.astral.sh/uv/getting-started/installation/) 和已安装的 Codex CLI。 完整记忆还需要可用的 Generation 和 Embedding 模型 API；准备好各自的地址、模型名和 API key。 @@ -17,7 +17,7 @@ Codex 或 Claude 的订阅登录不会自动为 PowerContext Server 提供这些 ## 1. 安装并进入配置向导 ```bash -uv tool install --force "powercontext[cli,server]==1.2.0" +uv tool install --force "powercontext[cli,server]==1.3.0" mkdir -p ~/powercontext-demo cd ~/powercontext-demo powercontext config init --language zh --output .env @@ -92,7 +92,7 @@ POWERCONTEXT_CODEX_SCOPE_ID=替换为返回的scope_id set -a . ./.env set +a -powercontext setup codex --ref powercontext-v1.2.0 +powercontext setup codex --ref powercontext-v1.3.0 powercontext doctor codex codex ``` diff --git a/integrations/dsh/plugins/powercontext/README.md b/integrations/dsh/plugins/powercontext/README.md index 3fe3c83de6..438dec3c86 100644 --- a/integrations/dsh/plugins/powercontext/README.md +++ b/integrations/dsh/plugins/powercontext/README.md @@ -5,8 +5,8 @@ This plugin is a thin DeepSeek Harness integration for a running PowerContext Se Install the released Server and plugin together: ```bash -uv tool install --force "powercontext[cli,server]==1.2.0" -powercontext setup dsh --source oceanbase/powercontext --ref powercontext-v1.2.0 +uv tool install --force "powercontext[cli,server]==1.3.0" +powercontext setup dsh --source oceanbase/powercontext --ref powercontext-v1.3.0 ``` `setup dsh` calls `dsh plugin --profile web add`. The plugin talks HTTP only. It does not use MCP. diff --git a/openapi/powercontext.yaml b/openapi/powercontext.yaml index 05df0473b4..f5ece75347 100644 --- a/openapi/powercontext.yaml +++ b/openapi/powercontext.yaml @@ -16,7 +16,7 @@ openapi: 3.0.3 info: title: PowerContext API description: Remote PowerContext transport. Runtime behavior is reported by /v1/capabilities. - version: 1.2.0 + version: 1.3.0 x-powercontext-feature-contracts: access.principal: {major: 1, minor: 0} scope.selection: {major: 1, minor: 0} diff --git a/src/powercontext/http/_generated/operations.py b/src/powercontext/http/_generated/operations.py index bfea1bf8f6..f095d0849c 100644 --- a/src/powercontext/http/_generated/operations.py +++ b/src/powercontext/http/_generated/operations.py @@ -195,7 +195,7 @@ OPENAPI_VERSION = "3.0.3" API_TITLE = "PowerContext API" API_DESCRIPTION = "Remote PowerContext transport. Runtime behavior is reported by /v1/capabilities." -API_VERSION = "1.2.0" +API_VERSION = "1.3.0" FEATURE_CONTRACTS: dict[str, dict[str, JsonValue]] = { "access.principal": {"version": {"major": 1, "minor": 0}, "operations": ["get_access_principal"]}, "scope.selection": { diff --git a/src/powercontext/http/_generated/schema.py b/src/powercontext/http/_generated/schema.py index 2763e5fa42..8976d14280 100644 --- a/src/powercontext/http/_generated/schema.py +++ b/src/powercontext/http/_generated/schema.py @@ -7,7 +7,7 @@ "info": { "title": "PowerContext API", "description": "Remote PowerContext transport. Runtime behavior is reported by /v1/capabilities.", - "version": "1.2.0", + "version": "1.3.0", }, "paths": { "/v1/atomic-memory/list": { diff --git a/tests/test_api_contract.py b/tests/test_api_contract.py index 301d2ced7f..73e0983053 100644 --- a/tests/test_api_contract.py +++ b/tests/test_api_contract.py @@ -188,7 +188,7 @@ def test_contract_uses_the_namespaced_request_id_header() -> None: def test_server_info_contract_is_observable_and_forward_compatible() -> None: contract = yaml.safe_load(CONTRACT_PATH.read_text()) - assert contract["info"]["version"] == "1.2.0" + assert contract["info"]["version"] == "1.3.0" operation = contract["paths"]["/v1/server-info"]["get"] assert operation["operationId"] == "get_server_info" assert operation["x-powercontext-access"] == { diff --git a/website/src/lib/releases.ts b/website/src/lib/releases.ts index 4304d80e6a..1f552fec63 100644 --- a/website/src/lib/releases.ts +++ b/website/src/lib/releases.ts @@ -28,6 +28,44 @@ export interface Release { // Only stable releases belong here; publish pre-release notes on GitHub Releases. export const releases: Release[] = [ + { + version: 'v1.3.0', + date: '2026-10-12', + title: { + en: 'Independent Atomic Memory · Artifact merge and restoration · Server discovery and diagnostics', + zh: '独立 Atomic Memory · Artifact 合并与恢复 · Server 发现与诊断', + }, + summary: { + en: 'PowerContext 1.3.0 stores individual memories as independent Artifacts, adds shared merge and restoration workflows and family-scoped search, and improves Server discovery, extraction diagnostics, Agent integrations, and paired evaluation.', + zh: 'PowerContext 1.3.0 将单条记忆保存为独立 Artifact，新增通用合并与恢复流程及按类型搜索，并完善 Server 发现、提取诊断、Agent 集成和对照评测。', + }, + changes: { + en: [ + 'Create, read, revise, search, forget, merge, and restore independent Atomic Memory Artifacts with immutable content history and explicit lifecycle state. Existing collection databases require the documented offline Atomic Memory migration before use.', + 'Share merge and restoration across Artifact families, preserving exact input revisions and historical evidence. Search Artifacts by family and expose Memory search modes and channels in the Dashboard.', + 'Discover Server protocols and capabilities and inspect persistent deployment identity. Expose read-only extraction diagnostics and optional daily RecallEffort metrics; MCP request counts do not establish successful tool execution.', + 'Import Codex sessions, refresh stale setup endpoints safely, bypass proxies for loopback Client transports, and improve DSH Desktop setup, native MCP catalog diagnostics, and handling of recoverable Server rejections.', + 'Extend the Dify integration with 19 HTTP-backed tools and provide Experience and Skill applicability examples. Add compact Handoff continuity hints and improve ZCode lifecycle workflows and runtime diagnostics.', + 'Persist smaller extraction windows after timeouts, stop redispatching exhausted Topic Memory windows, and classify deterministic rejections separately. Score recall sufficiency using vector relevance and keep SQLite vector searches within the supported result limit.', + 'Expand paired continuation evaluation to Claude Code and Pi, task-completion workloads, and MemoryCode dialogues; report intervals, latency, and usage. These evaluation workflows do not imply a universal quality improvement.', + 'Add decision policy governance types and a limited unified database migration bundle. The bundle covers four registered Artifact tables and explicitly reports server_ready=false; it is not a complete production Server upgrade path.', + 'Upgrade the Server, clients, and Agent integrations together and reopen Agent sessions. Back up existing databases and follow the Atomic Memory migration guide; do not use the limited unified migration bundle as a replacement for the required migration.', + ], + zh: [ + '以独立 Atomic Memory Artifact 创建、读取、修订、搜索、遗忘、合并和恢复单条记忆，保留不可变内容历史与显式生命周期状态。已有集合式 Memory 数据库需先按文档完成离线 Atomic Memory 迁移。', + '在各 Artifact 类型间共享合并与恢复流程，保留精确的输入 Revision 和历史证据；支持按类型搜索 Artifact，并在 Dashboard 展示 Memory 搜索模式与通道。', + '发现 Server 协议与能力，查看持久化部署身份；提供只读提取诊断和可选的每日 RecallEffort 指标。MCP 请求计数不代表工具执行成功。', + '导入 Codex 会话，安全刷新过期的 setup 入口，让 Client 本地回环连接绕过代理，并完善 DSH Desktop 配置、原生 MCP 工具目录诊断及可恢复 Server 拒绝的处理。', + '为 Dify 集成新增 19 个基于 HTTP 的工具，提供 Experience 与 Skill 适用性选择示例；增加精简 Handoff 续接提示，并完善 ZCode 生命周期工作流与运行诊断。', + '提取超时后持久化较小窗口，停止重复派发已耗尽的 Topic Memory 窗口，并单独记录确定性拒绝；根据向量相关性判断召回充分性，让 SQLite 向量检索遵守结果数量限制。', + '将续接对照评测扩展到 Claude Code、Pi、任务完成工作负载和 MemoryCode 对话，并报告区间、延迟与用量。这些评测流程不代表所有任务都能获得相同质量提升。', + '增加决策策略治理类型和范围有限的统一数据库迁移包。迁移包仅覆盖四张已注册 Artifact 表，并明确返回 server_ready=false，不能作为完整生产 Server 升级路径。', + 'Server、客户端和 Agent 集成需一起升级，并重新打开 Agent 会话。先备份已有数据库，再按 Atomic Memory 迁移指南操作；范围有限的统一迁移包不能替代所需迁移。', + ], + }, + installCommand: 'uv tool install --force "powercontext[cli,server]==1.3.0"', + githubUrl: 'https://github.com/oceanbase/powercontext/releases/tag/powercontext-v1.3.0', + }, { version: 'v1.2.0', date: '2026-09-29', From 78547830f216e5fd5ed3e0ff146f4fca7082e053 Mon Sep 17 00:00:00 2001 From: hidb4ai Date: Mon, 12 Oct 2026 10:14:53 +0800 Subject: [PATCH 2/6] docs(release): highlight decision-model write governance --- website/src/lib/releases.ts | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/website/src/lib/releases.ts b/website/src/lib/releases.ts index 1f552fec63..a294adcd7e 100644 --- a/website/src/lib/releases.ts +++ b/website/src/lib/releases.ts @@ -32,34 +32,36 @@ export const releases: Release[] = [ version: 'v1.3.0', date: '2026-10-12', title: { - en: 'Independent Atomic Memory · Artifact merge and restoration · Server discovery and diagnostics', - zh: '独立 Atomic Memory · Artifact 合并与恢复 · Server 发现与诊断', + en: 'Independent Atomic Memory · Govern decision-model writes · Artifact merge and restoration', + zh: '独立 Atomic Memory · 决策模型写入治理 · Artifact 合并与恢复', }, summary: { - en: 'PowerContext 1.3.0 stores individual memories as independent Artifacts, adds shared merge and restoration workflows and family-scoped search, and improves Server discovery, extraction diagnostics, Agent integrations, and paired evaluation.', - zh: 'PowerContext 1.3.0 将单条记忆保存为独立 Artifact，新增通用合并与恢复流程及按类型搜索，并完善 Server 发现、提取诊断、Agent 集成和对照评测。', + en: 'PowerContext 1.3.0 stores individual memories as independent Artifacts and brings explicit policy modes, privacy boundaries, and durable observations to decision-model Memory write assessment. It also adds shared Artifact merge and restoration, family-scoped search, and improved Server diagnostics and Agent integrations.', + zh: 'PowerContext 1.3.0 将单条记忆保存为独立 Artifact，为决策模型判断 Memory 写入引入显式策略模式、隐私边界和持久化观测记录，并新增通用 Artifact 合并与恢复、按类型搜索，完善 Server 诊断与 Agent 集成。', }, changes: { en: [ 'Create, read, revise, search, forget, merge, and restore independent Atomic Memory Artifacts with immutable content history and explicit lifecycle state. Existing collection databases require the documented offline Atomic Memory migration before use.', + 'Govern decision-model assessment of Memory write evidence with disabled, shadow, advisory, and enforcing modes. The gate remains opt-in; when enabled, it defaults to shadow and no_external_call, preserving writes without calling a model. Raw content evaluation requires explicit local_only configuration and a loopback backend. Scope-isolated durable observations retain policy versions, references, counts, and outcomes without candidate or evidence text; model failures preserve the write path. Enforcing promotion still requires calibration and evaluation; no public audit dashboard or hosted-redacted transport is included.', 'Share merge and restoration across Artifact families, preserving exact input revisions and historical evidence. Search Artifacts by family and expose Memory search modes and channels in the Dashboard.', 'Discover Server protocols and capabilities and inspect persistent deployment identity. Expose read-only extraction diagnostics and optional daily RecallEffort metrics; MCP request counts do not establish successful tool execution.', 'Import Codex sessions, refresh stale setup endpoints safely, bypass proxies for loopback Client transports, and improve DSH Desktop setup, native MCP catalog diagnostics, and handling of recoverable Server rejections.', 'Extend the Dify integration with 19 HTTP-backed tools and provide Experience and Skill applicability examples. Add compact Handoff continuity hints and improve ZCode lifecycle workflows and runtime diagnostics.', 'Persist smaller extraction windows after timeouts, stop redispatching exhausted Topic Memory windows, and classify deterministic rejections separately. Score recall sufficiency using vector relevance and keep SQLite vector searches within the supported result limit.', 'Expand paired continuation evaluation to Claude Code and Pi, task-completion workloads, and MemoryCode dialogues; report intervals, latency, and usage. These evaluation workflows do not imply a universal quality improvement.', - 'Add decision policy governance types and a limited unified database migration bundle. The bundle covers four registered Artifact tables and explicitly reports server_ready=false; it is not a complete production Server upgrade path.', + 'Add a limited unified database migration bundle. The bundle covers four registered Artifact tables and explicitly reports server_ready=false; it is not a complete production Server upgrade path.', 'Upgrade the Server, clients, and Agent integrations together and reopen Agent sessions. Back up existing databases and follow the Atomic Memory migration guide; do not use the limited unified migration bundle as a replacement for the required migration.', ], zh: [ '以独立 Atomic Memory Artifact 创建、读取、修订、搜索、遗忘、合并和恢复单条记忆，保留不可变内容历史与显式生命周期状态。已有集合式 Memory 数据库需先按文档完成离线 Atomic Memory 迁移。', + '为决策模型判断 Memory 写入证据提供 disabled、shadow、advisory、enforcing 四种策略模式。写入门控需显式启用；启用后默认采用 shadow 与 no_external_call，不调用模型、不阻断写入。评估原始内容需显式配置 local_only 和本地回环模型入口。按 Scope 隔离的持久化观测记录保存策略版本、引用、数量与处理结果，不保存候选或证据正文；模型故障时保留写入流程。进入 enforcing 前仍需校准与评测，本次未提供公开审计界面或托管脱敏调用。', '在各 Artifact 类型间共享合并与恢复流程，保留精确的输入 Revision 和历史证据；支持按类型搜索 Artifact，并在 Dashboard 展示 Memory 搜索模式与通道。', '发现 Server 协议与能力，查看持久化部署身份；提供只读提取诊断和可选的每日 RecallEffort 指标。MCP 请求计数不代表工具执行成功。', '导入 Codex 会话，安全刷新过期的 setup 入口，让 Client 本地回环连接绕过代理，并完善 DSH Desktop 配置、原生 MCP 工具目录诊断及可恢复 Server 拒绝的处理。', '为 Dify 集成新增 19 个基于 HTTP 的工具，提供 Experience 与 Skill 适用性选择示例；增加精简 Handoff 续接提示，并完善 ZCode 生命周期工作流与运行诊断。', '提取超时后持久化较小窗口，停止重复派发已耗尽的 Topic Memory 窗口，并单独记录确定性拒绝；根据向量相关性判断召回充分性，让 SQLite 向量检索遵守结果数量限制。', '将续接对照评测扩展到 Claude Code、Pi、任务完成工作负载和 MemoryCode 对话，并报告区间、延迟与用量。这些评测流程不代表所有任务都能获得相同质量提升。', - '增加决策策略治理类型和范围有限的统一数据库迁移包。迁移包仅覆盖四张已注册 Artifact 表，并明确返回 server_ready=false，不能作为完整生产 Server 升级路径。', + '增加范围有限的统一数据库迁移包。迁移包仅覆盖四张已注册 Artifact 表，并明确返回 server_ready=false，不能作为完整生产 Server 升级路径。', 'Server、客户端和 Agent 集成需一起升级，并重新打开 Agent 会话。先备份已有数据库，再按 Atomic Memory 迁移指南操作；范围有限的统一迁移包不能替代所需迁移。', ], }, From a571cd356e7eb4fbadf6112734b7835ee8607dec Mon Sep 17 00:00:00 2001 From: hidb4ai Date: Mon, 12 Oct 2026 10:18:23 +0800 Subject: [PATCH 3/6] docs(release): clarify v1.3.0 summary --- website/src/lib/releases.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/website/src/lib/releases.ts b/website/src/lib/releases.ts index a294adcd7e..7b0607fa44 100644 --- a/website/src/lib/releases.ts +++ b/website/src/lib/releases.ts @@ -36,8 +36,8 @@ export const releases: Release[] = [ zh: '独立 Atomic Memory · 决策模型写入治理 · Artifact 合并与恢复', }, summary: { - en: 'PowerContext 1.3.0 stores individual memories as independent Artifacts and brings explicit policy modes, privacy boundaries, and durable observations to decision-model Memory write assessment. It also adds shared Artifact merge and restoration, family-scoped search, and improved Server diagnostics and Agent integrations.', - zh: 'PowerContext 1.3.0 将单条记忆保存为独立 Artifact，为决策模型判断 Memory 写入引入显式策略模式、隐私边界和持久化观测记录，并新增通用 Artifact 合并与恢复、按类型搜索，完善 Server 诊断与 Agent 集成。', + en: 'PowerContext 1.3.0 lets users manage each memory independently and adds policy controls, privacy protection, and traceable records when decision models assess which information is worth remembering. Users can also merge duplicate content, restore historical versions, and more easily find memories, Experiences, and Skills, alongside improved Server diagnostics and Agent integrations.', + zh: 'PowerContext 1.3.0 让每条记忆都能独立管理，并为决策模型判断“哪些信息值得记住”加入策略控制、隐私保护和可追踪记录。同时支持合并重复内容、恢复历史版本，更方便地查找记忆、经验与技能，并完善 Server 诊断和 Agent 集成。', }, changes: { en: [ From 91a938c84fdabf649fcc1cee9412b068f5346ad5 Mon Sep 17 00:00:00 2001 From: hidb4ai Date: Mon, 12 Oct 2026 10:26:12 +0800 Subject: [PATCH 4/6] fix(release): regenerate Dify contract for v1.3.0 --- integrations/dify/plugin/powercontext_dify/contract.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/integrations/dify/plugin/powercontext_dify/contract.json b/integrations/dify/plugin/powercontext_dify/contract.json index d802feb364..6ff7a30035 100644 --- a/integrations/dify/plugin/powercontext_dify/contract.json +++ b/integrations/dify/plugin/powercontext_dify/contract.json @@ -1,5 +1,5 @@ { - "api_version": "1.2.0", + "api_version": "1.3.0", "operations": { "list_atomic_memories": { "method": "POST", From 7777793c8c57be823cccc7d2c94ba5140802d0a5 Mon Sep 17 00:00:00 2001 From: hidb4ai Date: Mon, 12 Oct 2026 10:30:35 +0800 Subject: [PATCH 5/6] docs(release): cover Desktop preview and Dashboard updates --- website/src/lib/releases.ts | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/website/src/lib/releases.ts b/website/src/lib/releases.ts index 7b0607fa44..9e0e502a3b 100644 --- a/website/src/lib/releases.ts +++ b/website/src/lib/releases.ts @@ -43,7 +43,9 @@ export const releases: Release[] = [ en: [ 'Create, read, revise, search, forget, merge, and restore independent Atomic Memory Artifacts with immutable content history and explicit lifecycle state. Existing collection databases require the documented offline Atomic Memory migration before use.', 'Govern decision-model assessment of Memory write evidence with disabled, shadow, advisory, and enforcing modes. The gate remains opt-in; when enabled, it defaults to shadow and no_external_call, preserving writes without calling a model. Raw content evaluation requires explicit local_only configuration and a loopback backend. Scope-isolated durable observations retain policy versions, references, counts, and outcomes without candidate or evidence text; model failures preserve the write path. Enforcing promotion still requires calibration and evaluation; no public audit dashboard or hosted-redacted transport is included.', - 'Share merge and restoration across Artifact families, preserving exact input revisions and historical evidence. Search Artifacts by family and expose Memory search modes and channels in the Dashboard.', + 'Share merge and restoration across Artifact families, preserving exact input revisions and historical evidence. Search Artifacts by family.', + 'Add an unsigned Windows Desktop preview for connecting to an existing Server, selecting a Scope, saving notes, full-text search, reading exact revisions, and copying content and references. The preview also supports English/Chinese, themes, and connection diagnostics; complete native interaction and formal release qualification remain unfinished.', + 'Choose automatic, full-text, semantic, or hybrid Memory search in the web Dashboard and inspect the executed mode, matching channels, and retrieval scores. Local Dashboard access can omit authentication; the Dashboard still requires explicit enablement.', 'Discover Server protocols and capabilities and inspect persistent deployment identity. Expose read-only extraction diagnostics and optional daily RecallEffort metrics; MCP request counts do not establish successful tool execution.', 'Import Codex sessions, refresh stale setup endpoints safely, bypass proxies for loopback Client transports, and improve DSH Desktop setup, native MCP catalog diagnostics, and handling of recoverable Server rejections.', 'Extend the Dify integration with 19 HTTP-backed tools and provide Experience and Skill applicability examples. Add compact Handoff continuity hints and improve ZCode lifecycle workflows and runtime diagnostics.', @@ -55,7 +57,9 @@ export const releases: Release[] = [ zh: [ '以独立 Atomic Memory Artifact 创建、读取、修订、搜索、遗忘、合并和恢复单条记忆，保留不可变内容历史与显式生命周期状态。已有集合式 Memory 数据库需先按文档完成离线 Atomic Memory 迁移。', '为决策模型判断 Memory 写入证据提供 disabled、shadow、advisory、enforcing 四种策略模式。写入门控需显式启用；启用后默认采用 shadow 与 no_external_call，不调用模型、不阻断写入。评估原始内容需显式配置 local_only 和本地回环模型入口。按 Scope 隔离的持久化观测记录保存策略版本、引用、数量与处理结果，不保存候选或证据正文；模型故障时保留写入流程。进入 enforcing 前仍需校准与评测，本次未提供公开审计界面或托管脱敏调用。', - '在各 Artifact 类型间共享合并与恢复流程，保留精确的输入 Revision 和历史证据；支持按类型搜索 Artifact，并在 Dashboard 展示 Memory 搜索模式与通道。', + '在各 Artifact 类型间共享合并与恢复流程，保留精确的输入 Revision 和历史证据；支持按类型搜索 Artifact。', + '新增未签名的 Windows 桌面预览，连接已有 Server 后可选择 Scope、保存笔记、全文搜索、读取精确历史版本，以及复制正文和引用；支持中英文、主题切换和连接诊断。完整原生交互与正式发行验收尚未完成。', + '网页 Dashboard 支持选择自动、全文、语义或混合搜索，查看实际执行模式、命中通道与检索得分；本地访问可不配置认证，Dashboard 仍需显式启用。', '发现 Server 协议与能力，查看持久化部署身份；提供只读提取诊断和可选的每日 RecallEffort 指标。MCP 请求计数不代表工具执行成功。', '导入 Codex 会话，安全刷新过期的 setup 入口，让 Client 本地回环连接绕过代理，并完善 DSH Desktop 配置、原生 MCP 工具目录诊断及可恢复 Server 拒绝的处理。', '为 Dify 集成新增 19 个基于 HTTP 的工具，提供 Experience 与 Skill 适用性选择示例；增加精简 Handoff 续接提示，并完善 ZCode 生命周期工作流与运行诊断。', From c1720080d1d2a8b3a53a326476299de1e30d7a38 Mon Sep 17 00:00:00 2001 From: hidb4ai Date: Mon, 12 Oct 2026 10:52:27 +0800 Subject: [PATCH 6/6] test(release): align Server identity contract with v1.3 --- tests/test_server.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tests/test_server.py b/tests/test_server.py index cc69ba046c..62cdf4d747 100644 --- a/tests/test_server.py +++ b/tests/test_server.py @@ -289,7 +289,7 @@ def test_server_info_uses_one_durable_identity_across_restarts(tmp_path) -> None assert first.status_code == second.status_code == 200 assert first.json() == second.json() assert first.json()["schema_version"] == {"major": 1, "minor": 0} - assert first.json()["api_contract_version"] == {"major": 1, "minor": 2} + assert first.json()["api_contract_version"] == {"major": 1, "minor": 3} def test_server_startup_fails_when_identity_initialization_fails(tmp_path, monkeypatch) -> None: