yuanshen

name

yuanshen

description

在中国大陆或网络受限 Linux 服务器上诊断并修复开发工具镜像源问题时使用。触发场景包括 apt update 慢或超时、pip/npm/cargo/go/conda install 卡住、docker pull 或 containerd 拉镜像失败、Hugging Face 下载慢、GitHub/PyPI/npmjs/crates.io/golang.org/huggingface.co 连接超时。覆盖 apt、pip、npm/yarn/pnpm、Cargo、Go、Docker、containerd、conda、apk、Hugging Face。Always use for China mainland server mirror/source configuration, package manager registry switching, timeout diagnosis, backup, rollback, and validation.

源神

工作原则

源神用于帮助 agent 在国内服务器上处理网络、镜像源和包管理器超时问题。默认采取保守模式：先诊断、列计划、说明会改哪些文件；只有用户确认，或明确要求修复时，才运行带 --apply 的脚本。

优先级：

1. 先运行 scripts/detect.sh 识别系统、云厂商、架构和已安装工具。
2. 只配置已安装或任务明确需要的工具。
3. 修改前确认脚本会备份，备份默认在 ~/.yuanshen-backup/<timestamp>/。
4. 修改后运行对应验证命令，例如 apt-get update、pip config list、npm ping、docker info。
5. 遇到生产环境、CI runner、公司内网源或私有 registry 时，先保留现有配置，只添加必要补丁。

快速流程

bash yuanshen.skill/scripts/detect.sh
bash yuanshen.skill/scripts/speedtest.sh

按需应用：

bash yuanshen.skill/scripts/mirrors/apt.sh --apply
bash yuanshen.skill/scripts/mirrors/pip.sh --apply
bash yuanshen.skill/scripts/mirrors/npm.sh --apply
bash yuanshen.skill/scripts/mirrors/docker.sh --apply
bash yuanshen.skill/scripts/mirrors/hf.sh --apply

回滚：

bash yuanshen.skill/scripts/rollback.sh --list
bash yuanshen.skill/scripts/rollback.sh --restore ~/.yuanshen-backup/<timestamp>

决策规则

• 默认镜像：通用场景优先清华 TUNA、npmmirror、RsProxy、goproxy.cn、hf-mirror。
• 云厂商内网：如果 detect.sh 识别出阿里云、腾讯云、华为云，优先考虑该云厂商内网镜像；改动前说明原因。
• 测速：默认不强制测速。用户提到“最快”“选源”“很慢但不确定”时运行 scripts/speedtest.sh。
• GitHub 代理：只在解释方案时提及，不默认配置全局 git rewrite，避免污染私有仓库和 token 域名。
• Windows/macOS：本 skill v1 只面向 Linux 服务器；其他系统只给建议，不运行 Linux 脚本。

资源索引

• apt 与 Ubuntu 24.04+ deb822 格式：读 references/ubuntu-2404-deb822.md。
• Docker 与 containerd 差异：读 references/containerd-vs-docker.md。
• 镜像地址和替代源：读 references/mirrors-table.md。
• 常见错误：读 references/troubleshooting.md。
• 生产环境安全策略：读 references/safety.md。