docs(git proxy skill): others.md 拆分为 git-proxy.md + misc.md(语义文件名)
This commit is contained in:
@@ -4,7 +4,7 @@ description: |
|
|||||||
个人 CLI 工具集 mytoolkit 的入口。涵盖:通用格式转换 (convert)、Markdown→PDF (Typst)、
|
个人 CLI 工具集 mytoolkit 的入口。涵盖:通用格式转换 (convert)、Markdown→PDF (Typst)、
|
||||||
PDF 处理、图片转换、LaTeX 编译、BibTeX 处理、视频转换、Docusaurus 网站构建、邮件管理等。
|
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
|
user-invocable: true
|
||||||
triggers:
|
triggers:
|
||||||
- mytoolkit
|
- mytoolkit
|
||||||
@@ -58,7 +58,7 @@ mytoolkit completion zsh # 打印 zsh 补全脚本
|
|||||||
| `video` | 视频格式转换 | `references/video.md` |
|
| `video` | 视频格式转换 | `references/video.md` |
|
||||||
| `webpage` | Docusaurus 网站构建、部署、server 管理 | `mytoolkit info docs webpage` |
|
| `webpage` | Docusaurus 网站构建、部署、server 管理 | `mytoolkit info docs webpage` |
|
||||||
| `mail` | 邮箱管理(inbox、read、draft) | `references/mail.md` |
|
| `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 <name>` 直接读取;技能内 `references/` 仅保留速查。
|
> 注:`convert`、`pdf`、`webpage` 的完整参考文档已随 mytoolkit 包安装,通过 `mytoolkit info docs <name>` 直接读取;技能内 `references/` 仅保留速查。
|
||||||
|
|
||||||
@@ -75,7 +75,7 @@ mytoolkit completion zsh # 打印 zsh 补全脚本
|
|||||||
| LaTeX 编译 | `mytoolkit latex compile paper.tex` |
|
| LaTeX 编译 | `mytoolkit latex compile paper.tex` |
|
||||||
| BibTeX 转 Markdown | `mytoolkit convert refs.bib -o refs.md` |
|
| BibTeX 转 Markdown | `mytoolkit convert refs.bib -o refs.md` |
|
||||||
| AVI 视频转 MP4 | `mytoolkit convert video.avi -o video.mp4` |
|
| 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 <xiaohe-agent>/packages/mytoolkit && make install` |
|
| 更新工具本身 | `cd <xiaohe-agent>/packages/mytoolkit && make install` |
|
||||||
|
|
||||||
## 安装与更新
|
## 安装与更新
|
||||||
|
|||||||
+2
-17
@@ -1,19 +1,4 @@
|
|||||||
# 其他命令
|
# git proxy(FastGitHub 等)
|
||||||
|
|
||||||
> 详细用法以 **mytoolkit 项目 README.md** 为准(可用 `mytoolkit info paths` 辅助定位)。
|
|
||||||
|
|
||||||
```bash
|
|
||||||
mytoolkit init paper <dir> # 初始化 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 等)
|
|
||||||
|
|
||||||
配置在 `~/.mytoolkit/config.json` → `connections.proxy.<name>`(例:`fastgithub` → `http://127.0.0.1:38457`)。
|
配置在 `~/.mytoolkit/config.json` → `connections.proxy.<name>`(例:`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)
|
- 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`
|
- Parallels guest 需 `brew install socat`;可选 `XIAOHE_CI_PARALLELS_HOST_IP`
|
||||||
|
|
||||||
### 新机器安装 FastGitHub
|
## 新机器安装 FastGitHub
|
||||||
|
|
||||||
> ⚠️ **人工线下安装,AI/脚本不得自动执行**:不要引导 AI 去 Releases 下载并运行该二进制
|
> ⚠️ **人工线下安装,AI/脚本不得自动执行**:不要引导 AI 去 Releases 下载并运行该二进制
|
||||||
> (否则“要下代理得先有代理”循环 + 供应链风险)。仅由用户在新机器上手动完成一次即可,
|
> (否则“要下代理得先有代理”循环 + 供应链风险)。仅由用户在新机器上手动完成一次即可,
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
# 其他命令
|
||||||
|
|
||||||
|
> 详细用法以 **mytoolkit 项目 README.md** 为准(可用 `mytoolkit info paths` 辅助定位)。
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mytoolkit init paper <dir> # 初始化 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)
|
||||||
|
```
|
||||||
@@ -527,7 +527,7 @@ def _start_daemon(name: str, *, set_git: bool) -> None:
|
|||||||
)
|
)
|
||||||
click.echo(
|
click.echo(
|
||||||
"Install FastGithub and ensure the binary is named/on PATH "
|
"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,
|
err=True,
|
||||||
)
|
)
|
||||||
sys.exit(1)
|
sys.exit(1)
|
||||||
|
|||||||
Reference in New Issue
Block a user