diff --git a/.agents/skills/mytoolkit/SKILL.md b/.agents/skills/mytoolkit/SKILL.md index 83f372c..2827371 100644 --- a/.agents/skills/mytoolkit/SKILL.md +++ b/.agents/skills/mytoolkit/SKILL.md @@ -4,7 +4,7 @@ description: | 个人 CLI 工具集 mytoolkit 的入口。涵盖:通用格式转换 (convert)、Markdown→PDF (Typst)、 PDF 处理、图片转换、LaTeX 编译、BibTeX 处理、视频转换、Docusaurus 网站构建、邮件管理等。 用于:文件格式转换、批量处理、压缩优化、文档生成。 - 详情见 references/ 子目录(convert.md / pdf.md / image.md / latex.md / bib.md / video.md / webpage.md / mail.md / others.md)。 + 详情见 references/ 子目录(convert.md / pdf.md / image.md / latex.md / bib.md / video.md / webpage.md / mail.md / git-proxy.md / misc.md)。 user-invocable: true triggers: - mytoolkit @@ -58,7 +58,7 @@ mytoolkit completion zsh # 打印 zsh 补全脚本 | `video` | 视频格式转换 | `references/video.md` | | `webpage` | Docusaurus 网站构建、部署、server 管理 | `mytoolkit info docs webpage` | | `mail` | 邮箱管理(inbox、read、draft) | `references/mail.md` | -| `env/git/ssh/server/update/uninstall/completion` | 其他辅助命令 | `references/others.md` | +| `env/git/ssh/server/update/uninstall/completion` | 其他辅助命令 | `references/misc.md` | > 注:`convert`、`pdf`、`webpage` 的完整参考文档已随 mytoolkit 包安装,通过 `mytoolkit info docs ` 直接读取;技能内 `references/` 仅保留速查。 @@ -75,7 +75,7 @@ mytoolkit completion zsh # 打印 zsh 补全脚本 | LaTeX 编译 | `mytoolkit latex compile paper.tex` | | BibTeX 转 Markdown | `mytoolkit convert refs.bib -o refs.md` | | AVI 视频转 MP4 | `mytoolkit convert video.avi -o video.mp4` | -| FastGitHub / git 代理守护 | `mytoolkit git proxy start fastgithub`(安装见 `references/others.md`) | +| FastGitHub / git 代理守护 | `mytoolkit git proxy start fastgithub`(安装见 `references/git-proxy.md`) | | 更新工具本身 | `cd /packages/mytoolkit && make install` | ## 安装与更新 diff --git a/.agents/skills/mytoolkit/references/others.md b/.agents/skills/mytoolkit/references/git-proxy.md similarity index 76% rename from .agents/skills/mytoolkit/references/others.md rename to .agents/skills/mytoolkit/references/git-proxy.md index 7f78bde..0a824c7 100644 --- a/.agents/skills/mytoolkit/references/others.md +++ b/.agents/skills/mytoolkit/references/git-proxy.md @@ -1,19 +1,4 @@ -# 其他命令 - -> 详细用法以 **mytoolkit 项目 README.md** 为准(可用 `mytoolkit info paths` 辅助定位)。 - -```bash -mytoolkit init paper # 初始化 LaTeX 论文项目 -mytoolkit env # 环境变量管理 -mytoolkit git # Git 辅助(含 proxy 守护进程) -mytoolkit ssh # SSH 快捷连接 -mytoolkit server # 开发服务器管理(webpage,非 git proxy) -mytoolkit update # 从本地仓库更新 -mytoolkit uninstall # 卸载 -mytoolkit completion # 安装/查看/卸载 shell 补全(install / uninstall / doctor / zsh / bash) -``` - -## git proxy(FastGitHub 等) +# git proxy(FastGitHub 等) 配置在 `~/.mytoolkit/config.json` → `connections.proxy.`(例:`fastgithub` → `http://127.0.0.1:38457`)。 @@ -33,7 +18,7 @@ mytoolkit git proxy run fastgithub # 旧前台模式(设 git + Ctrl-C - CI:主机 `start fastgithub`;job 用 `HEYUE_CI_GIT_PROXY=1` / `XIAOHE_CI_GIT_PROXY=1`(勿依赖全局 git proxy) - Parallels guest 需 `brew install socat`;可选 `XIAOHE_CI_PARALLELS_HOST_IP` -### 新机器安装 FastGitHub +## 新机器安装 FastGitHub > ⚠️ **人工线下安装,AI/脚本不得自动执行**:不要引导 AI 去 Releases 下载并运行该二进制 > (否则“要下代理得先有代理”循环 + 供应链风险)。仅由用户在新机器上手动完成一次即可, diff --git a/.agents/skills/mytoolkit/references/misc.md b/.agents/skills/mytoolkit/references/misc.md new file mode 100644 index 0000000..52b2c2e --- /dev/null +++ b/.agents/skills/mytoolkit/references/misc.md @@ -0,0 +1,14 @@ +# 其他命令 + +> 详细用法以 **mytoolkit 项目 README.md** 为准(可用 `mytoolkit info paths` 辅助定位)。 + +```bash +mytoolkit init paper # 初始化 LaTeX 论文项目 +mytoolkit env # 环境变量管理 +mytoolkit git # Git 辅助(含 proxy 守护进程) +mytoolkit ssh # SSH 快捷连接 +mytoolkit server # 开发服务器管理(webpage,非 git proxy) +mytoolkit update # 从本地仓库更新 +mytoolkit uninstall # 卸载 +mytoolkit completion # 安装/查看/卸载 shell 补全(install / uninstall / doctor / zsh / bash) +``` diff --git a/mytoolkit/commands/git.py b/mytoolkit/commands/git.py index 3c354cc..df26934 100644 --- a/mytoolkit/commands/git.py +++ b/mytoolkit/commands/git.py @@ -527,7 +527,7 @@ def _start_daemon(name: str, *, set_git: bool) -> None: ) click.echo( "Install FastGithub and ensure the binary is named/on PATH " - "as the proxy name (see skill references/others.md).", + "as the proxy name (see skill references/git-proxy.md).", err=True, ) sys.exit(1)