Agent MD Manager
一个用来批量渲染 AGENT 操作规约的简单构建脚本。通过外部 TOML 配置文件定义多套 CLI、目标平台和输出路径,脚本会把 template.j2 渲染成对应的 Markdown 文档。
快速开始
- 安装依赖:
uv sync或使用你偏好的方式安装jinja2。 - 复制并调整
config.toml,把windows_base、wsl_base和tools列表改成自己的路径。 - 运行
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等上下文。 - 当前项目不包含单元测试,后续可按需补充。
Metadata
Release files for agent-md-manager 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| agent_md_manager-0.1.0.tar.gz | 4.6 kB | Without provenance | Details for agent_md_manager-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| agent_md_manager-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for agent_md_manager-0.1.0-py3-none-any.whl |
Total release size: 10.3 kB
Release files / agent_md_manager-0.1.0.tar.gz
| Download URL | agent_md_manager-0.1.0.tar.gz |
|---|---|
| Size | 4.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d8919da8f3027f76e167b93838f1665bc6fdbcd615a50ec17dec135ea670b2f0
|
|
BLAKE2b-256 checksum How to use checksums |
a3854b88e626a9e9d1d3b38cdffa01fffabdfa758cb799e0ade3d673a7d7cc4e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.14
|
Release files / agent_md_manager-0.1.0-py3-none-any.whl
| Download URL | agent_md_manager-0.1.0-py3-none-any.whl |
|---|---|
| Size | 5.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5f0c426a87cf65434500a7be11ca040fefb64ca2248323c0660523e7b02f7b69
|
|
BLAKE2b-256 checksum How to use checksums |
92fd89b135e30418cf8184cf584d3c00d4955413bfc12fc39fb1081b8f595bf5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.14
|
Security for agent-md-manager 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.