agent-workbench-connector 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,45 @@
1
+ # Agent Workbench 开发机连接器
2
+
3
+ 独立连接 Agent 工作台,支持远端任务执行、历史会话同步、原会话续聊、上下文交接和 Git 分支管理。开发机无需下载工作台项目源码,也无需安装 PostgreSQL、React、Vite 或 tsx。
4
+
5
+ 需要 Node.js 22.16+,并在开发机安装、登录所需 Agent。Git 分支管理需要 Git。
6
+
7
+ ## 安装与启动
8
+
9
+ 发布到 npm 后安装:
10
+
11
+ ```bash
12
+ npm install -g agent-workbench-connector
13
+ ```
14
+
15
+ 尚未发布到 registry 时,可直接安装维护者提供的安装包:
16
+
17
+ ```bash
18
+ npm install -g ./agent-workbench-connector-0.3.0.tgz
19
+ ```
20
+
21
+ 在工作台“设备与 Agent → 连接本机 Agent”复制登录配置,保存到任意目录的 `agent.env`,填写密码。在 macOS/Linux 上运行 `chmod 600 agent.env`,Windows 上将文件权限限制为当前用户可读,然后启动:
22
+
23
+ ```bash
24
+ agent-workbench-connector --env-file ./agent.env
25
+ ```
26
+
27
+ 也可以把配置保存为 `~/.bugflow/agent.env`,然后直接运行 `agent-workbench-connector`。已有环境变量优先于文件;不自动加载当前目录的 `.env`。令牌登录仍支持 `WORKBENCH_TOKEN`。不要把密码或令牌放入命令行参数。
28
+
29
+ 进程需要保持运行,按 Ctrl+C 正常退出。仅同步模式配置 `WORKBENCH_EXECUTE_CODEX=false` 后,可以使用 `agent-workbench-connector --env-file ./agent.env --once` 单次同步。`agent-workbench-connector --help` 查看参数,`agent-workbench-connector --version` 查看版本。
30
+
31
+ ## 状态与迁移
32
+
33
+ 包名与命令名统一为 `agent-workbench-connector`。为兼容已有安装,默认配置目录仍保留 `~/.bugflow/agent.env`,设备状态目录也不变;无需迁移凭据或重建设备。若安装过旧命令,先停止旧进程,再使用新命令启动,避免两个连接器同时工作。
34
+
35
+ 默认工作目录是当前用户主目录,可通过 `CODEX_WORKSPACE_DIR` 设置代码仓库。默认设备状态位于 `~/.workflow-data/devices/<连接标识>/`,按工作台地址、租户和账号隔离,从不同目录启动仍使用同一设备身份。安装目录不保存密码、会话或执行日志,升级 npm 包不会清除设备状态。
36
+
37
+ 从源码版连接器迁移时,先正常停止旧进程,在配置中将 `WORKBENCH_DEVICE_DIR` 设置为旧状态目录的**绝对路径**,再启动新命令。保留该目录才能继续核对旧执行,不要同时运行两个连接器处理同一设备。显式相对状态目录仍相对于启动目录解析。
38
+
39
+ 其他配置沿用源码版:`WORKBENCH_DEVICE_NAME` 设置设备名,`WORKBENCH_SYNC_EXCERPTS=false` 关闭摘要同步,`ACP_*`、`CODEX_EXECUTABLE` 和 `IDE_HISTORY_*` 配置本机 Agent 及历史来源。连接器只负责连接和调度,不包含 Codex / Claude 可执行程序,也不复制用户业务仓库。
40
+
41
+ ## 维护者打包
42
+
43
+ 在工作台仓库运行 `pnpm agent:pack`,生成 `dist/device-agent/agent-workbench-connector-0.3.0.tgz`。包内只包含编译后的连接器、说明、许可证和包元数据;上下文工作区代码已打包,无 `workspace:*` 运行时依赖,ACP SDK 由包管理器安装。源码改动后必须重新打包。
44
+
45
+ CI / CD 在 `agent-vX.Y.Z` 标签推送后执行完整检查,再发布同一次构建的 tgz。标签版本必须与本包版本一致,提交必须已合入 main;PR 和普通 main 提交只打包不发布。发布使用独立的 GitHub `npm` Environment 和 npm Trusted Publisher(`Gausons/auto-workflow`、`ci-cd.yml`、Environment `npm`),首次发布也可配置临时 `NPM_TOKEN` Secret。具体初始化步骤见仓库 README 的“连接器 npm 发布”。本机 npm 登录状态不会传递给 CI;包版本一旦发布不能覆盖。安装或构建本身不会自动发布,也不会要求用户在安装机器上构建。
package/dist/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Gausons
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.