@chunklib/agentic 1.1.0 → 1.1.1

package/README.md

@@ -4,7 +4,7 @@ Agentic 尽量保持 OpenCode 配置兼容。上游字段以 OpenCode schema 和
 
 ## 模型如何查询
 
-Agentic 产品行为、发布、Desktop、Flow、平台支持与可选记忆边界的公开权威入口为 <https://github.com/chunklib/agentic-releases#readme>。provider、plugin API、command、protocol、OAuth、Zen 与 Go 等上游兼容行为继续查询 <https://opencode.ai/docs>。
+Agentic 产品行为、发布、Desktop、Flow 与平台支持的公开权威入口为 <https://github.com/chunklib/agentic-releases#readme>。provider、plugin API、command、protocol、OAuth、Zen 与 Go 等上游兼容行为继续查询 <https://opencode.ai/docs>。
 
 ```bash
 # 本机 Agentic 版本
@@ -19,6 +19,18 @@ agentic debug config
 
 provider/model 可用性取决于当前 OpenCode catalog、本地凭据和用户配置。默认目录是 `https://models.opencode.ai`，可用 `AGENTIC_MODELS_URL` 覆盖；Agentic 不维护一张可能过期的固定模型列表，也不替用户选择 provider/model。目录是远程元数据输入，不应指向不受信任的服务。
 
+## npm 包名迁移
+
+独立仓基线从 `agency-agentic` 迁移到 `@chunklib/agentic`。旧的 `agency-agentic@1.0.10` 只查询旧包的 `latest`，不能通过 `agentic upgrade` 跨越 npm 包名；现有用户需要在同一个 npm 全局前缀完成一次手动迁移：
+
+```bash
+npm uninstall --global agency-agentic
+npm install --global @chunklib/agentic@1.1.1
+agentic --version
+```
+
+迁移到 1.1.0 或更高版本后，npm 渠道的后续 `agentic upgrade` 会查询并安装 `@chunklib/agentic`。CLI GitHub binary 是独立渠道，只有存在匹配 Release 资产时才跟随该渠道升级。
+
 ## 上游兼容配置总表
 
 | 范围 | 配置入口 | 说明 |
@@ -34,7 +46,7 @@ Agentic 保留 `AGENTIC_*` 产品运行时命名空间；`OPENCODE_VERSION`、`O
 
 ## 项目指令优先级
 
-Agentic 当前源码保持 OpenCode v1.18.11 上游的 `AGENTS.md` 发现与兼容行为，不引入品牌专属规则文件：
+Agentic 当前源码保持 OpenCode v1.18.13 上游的 `AGENTS.md` 发现与兼容行为，不引入品牌专属规则文件：
 
 1. 全局类别优先读取 `~/.config/agentic/AGENTS.md`；不存在时，才读取 `~/.claude/CLAUDE.md`。
 2. 项目类别从当前目录向项目根查找：只要存在 `AGENTS.md`，就加载沿途全部 `AGENTS.md`；完全不存在时，才回退查找 `CLAUDE.md`，随后是已弃用的 `CONTEXT.md`。
@@ -45,34 +57,6 @@ Agentic 当前源码保持 OpenCode v1.18.11 上游的 `AGENTS.md` 发现与兼
 
 `CLAUDE.md` 回退是 OpenCode v1 上游兼容行为，不是 Agentic 自定义能力。Agentic 的差异仅是全局目录使用 `~/.config/agentic`，并提供 `AGENTIC_DISABLE_CLAUDE_CODE_PROMPT`（或总开关 `AGENTIC_DISABLE_CLAUDE_CODE`）关闭该回退。预发布 V2 core 当前只聚合 `AGENTS.md`；Agentic 不为它另加兼容层，后续随上游正式迁移。`/init` 始终只创建或更新 `AGENTS.md`。
 
-## 可选记忆插件
-
-Agentic 1.0 不内嵌 Agentmemory，不定义 `agentmemory` schema，不在 core 中注册 `memory_*` tools，也不为 Desktop/CLI 维护专用 SQLite 或 viewer 生命周期。
-
-轻量选项可以通过标准插件数组安装：
-
-```json
-{
-  "plugin": ["opencode-working-memory"]
-}
-```
-
-安装前先查询实际发布版本与文档：
-
-```bash
-npm view opencode-working-memory version
-```
-
-该插件只是当前轻量示例，不是 Agentic 内置依赖或承诺的存储格式。插件自己负责：
-
-- Node/Bun 运行时兼容；
-- 记忆存储与权限；
-- session/tool hooks 和可见工具；
-- 网络、embedding 或 LLM 费用；
-- 升级和数据迁移。
-
-从 0.x 升级到 1.0 时，Agentic 不自动删除、转换或导入 `~/.agentmemory`。需要历史数据时，使用迁移前 tag 或 Agentmemory 自身工具显式导出。
-
 ## Flow 适配层
 
 Flow 是 `@chunklib/agentic-flow` 独立插件，配置属于 `agentic-flow.jsonc`，不应将 Flow 私有字段写入 OpenCode 核心 schema。启用仍通过标准 `plugin` 数组，路由、agent 和 tool gates 由插件管理。
@@ -83,7 +67,7 @@ Flow 是 `@chunklib/agentic-flow` 独立插件，配置属于 `agentic-flow.json
 
 ### Visual Studio Code
 
-Agentic 1.0.9 起提供与 CLI 同版本的独立 VSIX；当前源码版本为 1.0.10。扩展启动 `agentic --port <port>`，通过 `AGENTIC_CALLER=vscode` 或 `vscode-insiders` 激活 IDE 行为，并使用 `_EXTENSION_AGENTIC_PORT` 隔离终端会话。它不再使用上游 `opencode.*` command ID、`OPENCODE_CALLER` 或 `opencode` 可执行文件。
+Agentic 1.0.9 起提供与 CLI 同版本的独立 VSIX；当前源码版本为 1.1.1。扩展启动 `agentic --port <port>`，通过 `AGENTIC_CALLER=vscode` 或 `vscode-insiders` 激活 IDE 行为，并使用 `_EXTENSION_AGENTIC_PORT` 隔离终端会话。它不再使用上游 `opencode.*` command ID、`OPENCODE_CALLER` 或 `opencode` 可执行文件。
 
 先安装同版本 CLI，再从相同版本的 Agentic GitHub Release 下载 `agentic-vscode-<version>.vsix`，用 VS Code 的 “Extensions: Install from VSIX...” 安装。Marketplace/Open VSX 需要独立的 Agentic publisher 凭据；GitHub VSIX 发布不表示这两个商店已经上架。
 
@@ -110,7 +94,7 @@ JetBrains 通过标准输入输出管理 `agentic acp` 子进程，不复用 VS
 
 - server/auth：`AGENTIC_SERVER_USERNAME`、`AGENTIC_SERVER_PASSWORD`、`AGENTIC_API_KEY`；
 - 测试隔离：`AGENTIC_DISABLE_PROJECT_CONFIG`、`AGENTIC_DISABLE_EXTERNAL_SKILLS`、`AGENTIC_DISABLE_CLAUDE_CODE`；
-- Desktop/runtime：`AGENTIC_CLIENT`；`AGENTIC_DISABLE_CHANNEL_DB` 仍是 Core 显式诊断开关，但 Desktop 开发启动不再强制设置它；
+- Desktop/runtime：`AGENTIC_CLIENT`；`AGENTIC_SIDECAR_V2=1` 与上游相同仅显式启用 v2 daemon，默认仍为 v1；`AGENTIC_DISABLE_CHANNEL_DB` 仍是 Core 显式诊断开关，但 Desktop 开发启动不再强制设置它；
 - 模型目录：运行时 `AGENTIC_MODELS_URL`；构建兼容顺序为 `AGENTIC_MODELS_URL`、`OPENCODE_MODELS_URL`、官方目录；
 - 构建兼容：`OPENCODE_VERSION`、`OPENCODE_CHANNEL`；浏览器产品版本由发行脚本注入 `VITE_AGENTIC_VERSION`。