LamplitIsles/kepos-imagegen

Kepos 图像生成

用于 Kepos 桥接的原生图像生成与编辑适配器。该桥接
使用其托管的 OAuth，并始终选择 gpt-image-2；两个适配器都不会请求、
存储或转发 API 密钥、cookie、令牌或其他凭据。

为 DSH 安装

dsh plugin --profile  add @lamplitisles/dsh-imagegen

DSH 包针对确切的 0.1.2-rc.1 API 契约。

打开 DSH 设置并选择 Kepos Image Generation 以查看或更改
桥接地址。默认值为 http://codex-bridge.localhost:17480；
适配器会自行追加 /codex/images。

为 Pi 安装

pi install npm:@lamplitisles/pi-imagegen

在 Pi 中运行 /kepos-image-settings 以查看或更改全局桥接地址。
交互式 TUI 和 RPC 模式可以更改它；非交互模式会报告
当前地址并说明需要交互式 UI。Pi 仅将
bridgeUrl 存储在其全局 kepos-imagegen.json 代理配置文件中。

图像编辑

两个适配器都暴露 kepos_image_generate。省略 images 以生成 PNG。
对于编辑，传入一到五个相对于
活动 DSH 工作区或 Pi 当前工作目录的 PNG、JPEG、GIF 或 WebP 路径。该
目录之外的路径（包括符号链接逃逸）会被拒绝。DSH 还会将每个结果
保存为 .dsh/kepos-imagegen/ 下的 PNG，并在其原生附件旁返回该相对路径。
Pi 返回一个图像内容块，且不写入
输出文件。

维护者发布设置

GitHub 工作流会为这两个公共包发布匹配的带标签版本。
在首次 beta 发布之前，维护者必须：

1. 创建 @lamplitisles npm 作用域，并手动为
@lamplitisles/dsh-imagegen 和 @lamplitisles/pi-imagegen 发布初始 beta。
2. 为每个包身份、此仓库、
.github/workflows/release.yml 工作流以及受保护的 npm
环境配置 npm Trusted Publishing。
3. 创建具有所需发布
策略的受保护 GitHub npm 环境。

然后推送一个 v 标签。稳定标签以 npm 的 latest 标签发布，
预发布标签以 beta 发布。该工作流使用 OIDC 来源证明；此仓库中
不存储任何 npm 令牌。

开发

pnpm install --frozen-lockfile
pnpm format:check
pnpm typecheck
pnpm test
pnpm build
GITHUB_REF_NAME=v0.1.0 pnpm release:check
pnpm test:pack

这些检查使用伪造对象和测试自有的临时目录。它们从不调用
实时 Kepos 桥接或发布包。

要在发布前验证本地 rc.1 DSH 集成，请先构建并针对官方
0.1.2-rc.1 CLI 运行链接源冒烟测试。它会创建并
移除自己的 DSH_HOME；它不会启动 DSH Web 或修改 web
配置文件。

DSH_CLI=/absolute/path/to/dsh pnpm test:dsh-link