Skip to content

v0.1.5

Choose a tag to compare

View all tags
@MarvekG MarvekG released this 24 Aug 19:45
· 9 commits to main since this release
v0.1.5
d5e2971
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Release Notes

来源：v0.1.4..HEAD（即 0.1.4 到当前 fab143e）的 merged PR，commit 用于补充核对。

概览

  • 本次包含 2 个 merged PR，核心是将 StickyProxy 的资源模型从“代理端点（endpoint）”统一重命名为“代理（proxy）”。
  • 存在破坏性变更：管理 API、前端数据字段和插件状态文件格式均已切换到 proxy 术语；旧状态文件会被明确拒绝，升级后必须重新添加代理并重新应用给账号。
  • 同时将 CPA RPC schema 版本维持为 3，避免因资源模型调整而失去与当前 CPA 宿主的兼容性。

PR 详情

#8 Update registry to v0.1.4

  • 链接：#8
  • 作者：MarvekG；合并时间：2026-08-24 17:02:31 UTC
  • 类型：发布维护
  • 变更内容：更新插件商店的 registry.json 条目，使其指向 StickyProxy v0.1.4 发布版本。
  • 影响说明：通过项目自带插件注册表安装或更新的用户，将获取到对应的 v0.1.4 构建产物及元数据。此 PR 本身不改变代理配置或运行时功能。

#9 refactor: rename proxy resources

  • 链接：#9
  • 作者：MarvekG；合并时间：2026-08-24 19:43:09 UTC
  • 类型：重构 / 破坏性变更
  • 变更内容：
    • 将领域模型、状态文件、管理 API、Web UI、错误消息、测试与文档中的 endpoint 统一更名为 proxy。代理 ID 前缀从 ep_ 改为 px_。
    • 管理 API 路由由 /stickyproxy/endpoints* 改为 /stickyproxy/proxies*；请求、响应及筛选字段从 endpoint_id、proxy_endpoint_id 切换为 proxy_id；状态接口返回字段从 endpoints 切换为 proxies。
    • 状态文件改为保存 proxies 与 account_proxy_mappings。映射以 CPA 的 auth_index 关联 proxy_id，用于明确记录账号最后成功应用的 StickyProxy 代理。
    • 账号列表识别“已应用代理”时，不再通过生成并比对预期最终代理 URL 来反查归属；改为直接查持久化映射。未映射但存在 proxy_url 的账号会显示为“其他账号代理”。
    • 前端的“当前应用代理”筛选新增“继承系统代理”选项；页面不再展示派生的预期最终 URL，只显示实际代理 URL 的脱敏结果。
    • 文档与中英文界面文案同步使用“代理（proxy）”术语，并新增账号代理映射设计说明。
  • 兼容性与迁移：
    • 旧插件状态格式不兼容。 新版本会拒绝旧字段，例如 endpoints 和 account_endpoint_mappings，不会静默读取或自动迁移。
    • 升级前应备份 StickyProxy 状态文件；升级后需重新添加所需代理，并将其重新应用到账号。
    • CPA 认证文件中既有的 proxy_url 不会被自动修改或清空；但由于没有新的映射记录，它们将显示为“其他账号代理”，直到操作员重新应用或明确清除。
    • 对接管理 API 的调用方需要同步更新路由、JSON 字段以及 ep_ 形式的旧代理 ID。
    • 状态文件路径： StickyProxy 将状态固定保存在 CPA 工作目录下的 plugins/stickyproxy-state，即相对于 CPA 进程工作目录的路径：<CPA 工作目录>/plugins/stickyproxy-state。
    • 升级前请备份该文件；新版本不会读取旧格式状态。升级后保留在 CPA 账号文件中的既有 proxy_url 不会自动清除，但需重新添加代理并重新应用，才能建立新的账号代理映射。
  • 验证：
    • PR 记录显示已执行 Go 测试、前端类型检查与测试，并构建 Linux 插件产物；同时验证插件可加载且 dashboard 返回 HTTP 200。

分类摘要

重点更新

  • StickyProxy 现在以明确持久化的“账号 → 代理”映射管理应用关系，避免通过遍历代理并比对最终 URL 来猜测账号属于哪一条代理。账号与代理数量增加时，按代理筛选与识别逻辑更直接、可预测。

破坏性变更

  • 管理接口从 endpoints 全面切换至 proxies，例如：
    • /stickyproxy/endpoints → /stickyproxy/proxies
    • endpoint_id → proxy_id
    • proxy_endpoint_id → proxy_id
    • 状态响应 endpoints → proxies
  • 持久化状态字段切换至 proxies 和 account_proxy_mappings，且不兼容读取旧状态；升级需备份、重新录入代理并重新应用。
  • 代理 ID 从 ep_ 前缀变为 px_ 前缀，外部保存或引用旧 ID 的自动化需更新。
Assets 8
Loading