semvec/pypi-packages huggingface dataset:
agent-md-manager 0.1.0
Render agent guideline markdown files across platforms
License: MIT
Requires Python: >=3.11

Agent MD Manager
=================

一个用来批量渲染 AGENT 操作规约的简单构建脚本。通过外部 TOML 配置文件定义多套 CLI、目标平台和输出路径，脚本会把 `template.j2` 渲染成对应的 Markdown 文档。

快速开始
--------

1. 安装依赖：`uv sync` 或使用你偏好的方式安装 `jinja2`。
2. 复制并调整 `config.toml`，把 `windows_base`、`wsl_base` 和 `tools` 列表改成自己的路径。
3. 运行 `uv run build.py`（默认真实写入文件）。如果只想预览结果，带上 `-s/--stdout`。

作为 uvx 工具
-------------

项目已提供 `project.scripts` 入口 `agent-md-manager`，发布到 PyPI（或使用 `--from <repo-url>`）后即可直接运行：

```
uvx --from isyuah/agent-md-manager agent-md-manager -c config.toml
```

常用参数保持一致，可搭配 `-s`、`-l` 等选项。若你通过 `pip install agent-md-manager` 安装，也可以直接执行 `agent-md-manager ...`。

配置文件说明
--------------

`config.toml` 字段：
- `windows_base` / `wsl_base`：各平台的家目录根路径，可为空（为空时跳过该平台）。
- `template_file`：模板文件路径，默认 `template.j2`。
- `tools`：数组，每个元素包含 `id`（命令行参数用）、`name`（模板中的 `cli_name`）、`folder`、`file_name`、`platforms`（如 `["win", "wsl"]`）。

使用命令
--------

- `uv run build.py` 或 `agent-md-manager`：按照配置写入所有工具。
- `agent-md-manager codex qwen`：仅同步指定工具。
- `agent-md-manager -s`：Dry-run，只在终端输出预览。
- `agent-md-manager -l`：列出所有工具及平台。
- `agent-md-manager -c other.toml`：使用其他配置文件。

约定
----

- 默认执行真实写入，Dry-run 需要显式传入 `-s`。
- 渲染模板时会自动注入 `cli_name`、`platform`、`is_win`、`is_wsl` 等上下文。
- 当前项目不包含单元测试，后续可按需补充。