agency-agentic

v1.0.10

Published

2 months ago

agentic — AI-powered terminal coding agent

0High
0Medium
0Low

Agentic 配置

Agentic 尽量保持 OpenCode 配置兼容。上游字段以 OpenCode schema 和官方文档为准；Agentic 特有的版本、发布、Flow 与外部插件指导维护在静态文档和对应插件中，不重新注入内置产品 skill。模型 Prompt 只保留 Agentic/OpenCode 文档路由，不复制产品知识正文。

模型如何查询

Agentic 产品行为、发布、Desktop、Flow、平台支持与可选记忆边界的公开权威入口为 https://github.com/jishenjason-cmd/agentic-releases#readme。provider、plugin API、command、protocol、OAuth、Zen 与 Go 等上游兼容行为继续查询 https://opencode.ai/docs。

# 本机 Agentic 版本
agentic --version

# npm 已发布版本
npm view agency-agentic version

# 当前合并后配置
agentic debug config

provider/model 可用性取决于当前 OpenCode catalog、本地凭据和用户配置。默认目录是 https://models.opencode.ai，可用 AGENTIC_MODELS_URL 覆盖；Agentic 不维护一张可能过期的固定模型列表，也不替用户选择 provider/model。目录是远程元数据输入，不应指向不受信任的服务。

上游兼容配置总表

| 范围 | 配置入口 | 说明 | |---|---|---| | provider/model/agent/permission/MCP | agentic.json / agentic.jsonc | 使用 OpenCode 兼容 schema | | 用户全局 | XDG config 下的 Agentic/OpenCode 兼容路径 | 具体合并结果用 agentic debug config 确认 | | 项目级 | 项目中的 agentic.json(c) | 项目配置与 AGENTS.md 分工 | | 外部插件 | plugin 数组 | npm 包名或受支持的本地插件路径 | | 项目指令 | AGENTS.md | AGENTIC.md 别名已退休 | | 外部 skill | 上游兼容 skill 路径 | 可由 Agentic 环境开关限制扫描 |

Agentic 保留 AGENTIC_* 产品运行时命名空间；OPENCODE_VERSION、OPENCODE_CHANNEL 等官方构建/协议常量在需要上游兼容时继续保留。不应为了表面品牌统一破坏插件、SDK 或官方服务边界。

项目指令优先级

Agentic 当前源码保持 OpenCode v1.18.11 上游的 AGENTS.md 发现与兼容行为，不引入品牌专属规则文件：

全局类别优先读取 ~/.config/agentic/AGENTS.md；不存在时，才读取 ~/.claude/CLAUDE.md。
项目类别从当前目录向项目根查找：只要存在 AGENTS.md，就加载沿途全部 AGENTS.md；完全不存在时，才回退查找 CLAUDE.md，随后是已弃用的 CONTEXT.md。
访问项目内文件时，沿文件所在目录向项目根补充尚未注入的子目录规则，同一消息内去重。
agentic.json(c) 的 instructions 是显式附加来源，与上述规则合并，不替换它们。

全局与项目类别分别选择首个可用文件类型，因此全局 AGENTS.md 可以与项目 CLAUDE.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 生命周期。

轻量选项可以通过标准插件数组安装：

{
  "plugin": ["opencode-working-memory"]
}

安装前先查询实际发布版本与文档：

npm view opencode-working-memory version

该插件只是当前轻量示例，不是 Agentic 内置依赖或承诺的存储格式。插件自己负责：

Node/Bun 运行时兼容；
记忆存储与权限；
session/tool hooks 和可见工具；
网络、embedding 或 LLM 费用；
升级和数据迁移。

从 0.x 升级到 1.0 时，Agentic 不自动删除、转换或导入 ~/.agentmemory。需要历史数据时，使用迁移前 tag 或 Agentmemory 自身工具显式导出。

Flow 适配层

Flow 是 @vector-workshop/agentic-flow 独立插件，配置属于 agentic-flow.jsonc，不应将 Flow 私有字段写入 OpenCode 核心 schema。启用仍通过标准 plugin 数组，路由、agent 和 tool gates 由插件管理。

使用前以 ../plugins/agentic-flow/README.md 为准。Flow 必须保持显式启用，不能给普通 Agentic 会话增加默认调度成本。

IDE 接入

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 可执行文件。

先安装同版本 CLI，再从相同版本的 Agentic GitHub Release 下载 agentic-vscode-<version>.vsix，用 VS Code 的 “Extensions: Install from VSIX...” 安装。Marketplace/Open VSX 需要独立的 Agentic publisher 凭据；GitHub VSIX 发布不表示这两个商店已经上架。

JetBrains IDE

支持 ACP 的 JetBrains IDE/AI Assistant 可在其 acp.json 中配置 Agentic：

{
  "agent_servers": {
    "Agentic": {
      "command": "agentic",
      "args": ["acp"]
    }
  }
}

JetBrains 通过标准输入输出管理 agentic acp 子进程，不复用 VS Code 扩展，也不需要 Agentic 自建 JetBrains 插件。协议、认证、会话、模型和权限能力由 Agentic ACP 实现及具体 JetBrains 客户端版本共同决定；若 IDE 尚未提供 ACP 设置入口，仅升级 Agentic 不能补出该入口。

Agentic 进程开关

这些开关是运行时或测试边界，不是可选功能的私有业务 schema。常见类别包括：

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 开发启动不再强制设置它；
模型目录：运行时 AGENTIC_MODELS_URL；构建兼容顺序为 AGENTIC_MODELS_URL、OPENCODE_MODELS_URL、官方目录；
构建兼容：OPENCODE_VERSION、OPENCODE_CHANNEL；浏览器产品版本由发行脚本注入 VITE_AGENTIC_VERSION。

新增开关前要先判断是否能通过现有配置、插件或适配层解决。

Modal 动态模型发现仅在存在对应凭据且 provider 被 allowlist 允许时运行。Agentic 只把 Modal bearer token 发往 HTTPS inference.<region>.modal.direct，拒绝目录提供的其他 host、非 HTTPS URL 和重定向；失败时该次动态模型集合为空，静态配置和其他 provider 不受影响。

发布与防漂移

配置以当前 schema 和 agentic debug config 为事实源，不从旧 decision 复制过期字段。
每次修改本文档时，同步 npm 分发文档和相关发布检查，不复制到 OpenCode 内置 skill。
应用新插件前，实际查询 npm 版本、许可、运行时支持与数据边界。
Desktop Node sidecar 的验收不默认安装任何外部记忆插件；插件应有独立兼容测试。
完整发布前运行 scripts/test-agentic-automation.sh 与无跳过 full 验收。