WanCoder

WanCoder 为 VS Code 提供项目模板初始化与更新入口，帮助团队将模板文件放入当前工作目录的 .crm-agents/ 中。

功能

• SSH 拉取并初始化：使用本机 Git/SSH 下载仓库 master 分支，导入 .crm-agents/，保留已有同名文件。
• 更新：通过 SSH 获取最新模板，覆盖同名模板文件、补齐新增文件，保留自建文件；不自动删除远端已删除的文件。
• 代码解释 Demo：选中代码后右键选择“WanCoder：解释选中代码（Demo）”，查看交互演示。

代码解释目前使用固定示例文案，尚未接入 AI 或 Codex。

使用方法

1. 打开一个 VS Code 工作文件夹。
2. 点击左侧活动栏的 WanCoder 图标。
3. 点击 SSH 拉取并初始化，在通知和任务终端中查看结果。
4. 需要更新模板时，点击 更新。

多根工作区会提示选择目标目录。初始化和更新不会自动安装依赖、运行模板脚本或修改当前项目的 Git 配置。

SSH 前提条件

• 安装 Git 和 SSH，并确认 VS Code 能访问它们。
• 将本机 SSH 公钥添加到 Codeup，并取得目标仓库的读取权限。
• 加密私钥需提前加载至 ssh-agent。
• 首次连接 Codeup 时，在终端执行 ssh -T git@codeup.aliyun.com，核对并信任主机指纹。

插件通过系统 Git/SSH 执行认证，不读取或保存私钥。SSH 连接使用非交互模式；认证失败时，请查看任务终端排查。拉取任务支持取消。

在 Remote SSH、容器等远程工作区中，使用扩展实际运行环境的 Git 和 SSH 配置。

文件行为

模板文件的导入目标为：

当前工作目录/
└── .crm-agents/

初始化保留同名文件；更新会覆盖对同名模板文件的本地修改。磁盘写入错误可能留下部分已导入文件，请根据页面和终端提示检查后重试。

隐私

插件不包含遥测和统计上报。使用 SSH 功能时，Git 会连接指定的 Codeup 仓库进行下载。现有代码解释 Demo 不发送选中的代码到 AI 服务。

公开版不包含私有仓库快照，不提供离线模板。SSH 功能需要用户自行具备模板仓库的访问权限。

系统要求

• VS Code 1.90 或更高版本。
• 运行 SSH 功能的环境中具备 Git、SSH 和仓库访问权限。

许可证

插件代码采用 MIT 许可证。