Skip to content

CC Port v0.5.4 Public Beta

Pre-release
Pre-release

Choose a tag to compare

View all tags
@Ling-ye Ling-ye released this 30 Jul 08:04
v0.5.4
This tag was signed with the committer’s verified signature.
Ling-ye Lingye
SSH Key Fingerprint: MGUvZZ3Pqs5/nT60nQF+gK6phKzBFFHoy7gB0eFVNTY
Verified
Learn about vigilant mode.
21d750e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

CC Port v0.5.4 Public Beta

English release notes

CC Port v0.5.4 修复批量上传使用旧扫描结果判断冲突的问题，并为 Windows
原生符号链接、目录联接和 Claude Code 的 WSL 配置目录增加安全的资源发现与上传支持。

下载

  • cc-port_0.5.4_windows_x64_setup.exe
  • SHA256SUMS.txt

下载后请先核对 SHA-256，再运行安装器。不要下载或单独运行需要 sidecar 的原始桌面 EXE。

主要变化

  • 打开“上传到仓库”对话框时会刷新远端快照并重新扫描本地实例。检查完成前只显示
    进度和取消入口，随后展示的本地、远端和整体状态全部来自本次计划。
  • 本地存在而远端不存在的资源现在明确视为新增；只有两端都存在且内容或元数据不同时，
    才显示覆盖或重命名等冲突处理。
  • 根级 Windows 原生符号链接和目录联接可以作为本地资源来源。CC Port 保留逻辑安装
    路径用于识别资源，解引用后生成普通文件快照，不会把链接或 reparse point 写入仓库。
  • 下载目标是根级 Windows 原生悬空符号链接时，明确确认覆盖未接管目标后，CC Port
    只删除链接本身并写入普通内容，不会跟随或修改链接指向的位置。
  • 上传计划及执行阶段都会校验链接类型、原始目标、reparse tag 和内容指纹；链接在确认后
    被重定向时，旧计划会失效。
  • 所有已启用平台配置的 skills_dir、mcp_json 和 plugins_dir 都会参与本地扫描。
    将 Claude Code 配置指向 \\wsl.localhost\<发行版>\home\<用户>\... 后，普通 WSL
    路径中的 Skill、MCP 配置和内容型 Plugin 可以被发现、下载并进入上传计划。
  • 资源内部的嵌套链接、悬空链接、循环链接、不可读取或未知重解析点会按单个资源阻断，
    不再让一个异常条目中断整次扫描。

Public Beta 限制

  • 安装器尚未做 Authenticode 签名。Windows SmartScreen 可能显示“未知发布者”；请核对
    下载域名和 SHA256SUMS.txt 后，通过“更多信息”继续。
  • 当前没有自动更新，仅正式提供 Windows 10/11 x64 桌面安装器。
  • WSL 创建的 LX 符号链接无法由 Windows 桌面服务安全跟随，会阻断对应资源。请改用
    Windows 原生链接，或用复制模式安装资源。
  • 下载到 WSL 目录的内容型 Claude Code Plugin 只完成文件同步，不会替 Claude Code
    注册或启用插件；仍需使用 Claude Code 自身的插件安装机制。
  • Windsurf 和 OpenCode 平台预设仍标记为实验性。

升级

关闭正在执行的写操作后，直接运行 v0.5.4 安装器覆盖升级。保留本机状态目录可以继续
使用操作历史、所有权信息和备份。

反馈与安全问题

  • 一般 Bug 和功能建议：GitHub Issues
  • 安装与同步问题：故障排查
  • 安全漏洞：使用仓库 Security 页面的私密漏洞报告，不要创建公开 Issue

CC Port v0.5.4 Public Beta

中文发布说明

CC Port v0.5.4 fixes stale local-state conflict decisions in batch uploads and
adds safe resource discovery and upload support for native Windows symbolic
links, directory junctions, and configured Claude Code directories in WSL.

Downloads

  • cc-port_0.5.4_windows_x64_setup.exe
  • SHA256SUMS.txt

Verify the SHA-256 before running the installer. Do not download or run the raw
desktop executable separately because it requires its packaged sidecar.

Changes

  • Opening Upload to repository now refreshes the remote snapshot and rescans
    local instances. Until the check finishes, the dialog shows only progress and
    cancellation; all displayed local, remote, and overall states then come from
    that plan.
  • A resource that exists locally but not remotely is now treated as an addition.
    Conflict choices such as overwrite or rename appear only when both sides exist
    and their content or metadata differs.
  • A root-level native Windows symbolic link or directory junction can be a local
    resource source. CC Port retains the logical install path for identity, resolves
    the content, and writes only a regular-file snapshot to the repository.
  • When a download target is a root-level dangling native Windows symlink, CC Port
    removes only that link and writes regular content after explicit unmanaged-target
    confirmation. It never follows or modifies the link target.
  • The upload plan and apply stages both verify the link type, original target,
    reparse tag, and content fingerprint. Redirecting a link after confirmation
    invalidates the old plan.
  • Local discovery now covers skills_dir, mcp_json, and plugins_dir for every
    enabled platform. After configuring Claude Code with
    \\wsl.localhost\<distribution>\home\<user>\... paths, regular WSL Skills, MCP
    configurations, and content Plugins can be discovered, downloaded, and added
    to an upload plan.
  • Nested, dangling, cyclic, unreadable, and unknown reparse points block only the
    affected resource instead of aborting the entire local scan.

Public Beta limitations

  • The installer is not Authenticode-signed. Windows SmartScreen may show an
    unknown-publisher warning; verify the download domain and SHA256SUMS.txt,
    then use More info to continue.
  • Automatic updates are unavailable. Windows 10/11 x64 is the only officially
    distributed desktop platform.
  • WSL-created LX symbolic links cannot be followed safely by the Windows desktop
    service and block the affected resource. Use a native Windows link or install
    the resource in copy mode.
  • Syncing a content-style Claude Code Plugin into a WSL directory transfers its
    files but does not register or enable it in Claude Code. Use Claude Code's own
    plugin installation mechanism for activation.
  • Windsurf and OpenCode presets remain experimental.

Upgrade

Finish any active write operation, then run the v0.5.4 installer over the
current installation. Keep the local state directory to preserve operation
history, ownership data, and backups.

Feedback and security

  • General bugs and feature requests: GitHub Issues
  • Installation and sync help: Troubleshooting
  • Security vulnerabilities: use private vulnerability reporting on the
    repository's Security page; do not open a public issue.
Assets 4
Loading