pack-Agent · Agent 打包工具

简体中文 | English

把任意 AI Agent 打包成可移植的 dsh 模式（preset）仓库。

打包结果是一个 GitHub 仓库，仓库本身就是 dsh preset：克隆到 ~/.dsh/.agent-presets/<id> 即可在 dsh 模式选择器中使用。

这是什么

pack_agent.py 把一个 AI Agent —— 来自 Claude Code、Codex、opencode、aider、Cursor、已安装的 dsh preset，或任意用 JSON/YAML manifest 描述的自定义 Agent —— 打包成可移植的 dsh preset 仓库：

路径	内容
`agent.cordis.yml`	dsh 组装文件（基础 preset + MCP + 工具 + skills 接线）
`preset.yml`	模式名称 / 描述（模式选择器显示）
`AGENTS.md`	合并后的 Agent 指令 + memory
`skills/`	收集到的 skills（每个 skill 一个目录）
`tools/`	打包的自定义工具插件
`assets/`	需要附带的其他文件
`.env.example`	MCP token 占位符（绝不包含真实密钥）
`install.sh`	一键安装脚本
`pack_agent.py`	打包器本身，方便以后重新打包

特性

多来源：dsh preset（--from-dsh）、Claude Code（~/.claude.json、skills、CLAUDE.md、项目 .mcp.json）、Codex（~/.codex/config.toml、memory、skills）、opencode / aider / Cursor（--source opencode|aider|cursor），或通用 manifest
MCP 脱敏：token/密钥自动替换为 process.env.AGENT_MCP_* 占位符并写入 .env.example，任何敏感信息都不会进仓库
memory 脱敏：--memory safe 既剔除赋值式密钥，也剔除行内形似凭据的 token（URL 和正常文本不受影响）
MCP 过滤：--mcp-include、--mcp-exclude、--exclude-local-mcp（剔除本机专用服务）
--dry-run 只预览不打任何文件；--verbose 打印详细发现过程
--push 自动 git init 并推送到 GitHub（有 gh 时直接建仓库）

环境要求

Python 3.9+
pip install pyyaml（Python < 3.11 解析 TOML 还需 pip install tomli）

快速开始

# 自动检测本机的 dsh / Claude Code / Codex / opencode / aider / Cursor，合并打包
python3 pack_agent.py --id my-agent --name "我的 Agent" --description "..." --out dist/my-agent

# 只打包某个已安装的 dsh preset
python3 pack_agent.py --from-dsh standard --id my-agent --out dist/my-agent

# 用 manifest 打包任意 Agent
python3 pack_agent.py --manifest agent.manifest.json --out dist/my-agent

# 先预览，不写任何文件
python3 pack_agent.py --manifest agent.manifest.json --out dist/my-agent --dry-run

# 只保留 github MCP、剔除本机服务
python3 pack_agent.py --id my-agent --mcp-include github --exclude-local-mcp --out dist/my-agent

# 打包并推送到 GitHub
python3 pack_agent.py --id my-agent --push --repo my-agent --public

命令行参考

参数	说明
`--id`	模式 id（kebab-case 目录名）。默认取 `--out` 或 `my-agent`
`--name`、`--description`	模式选择器里显示的名称 / 描述
`--out`	输出目录。默认 `./dist/<id>`
`--source`	`auto`（默认，合并所有检测到的来源）、`dsh`、`claude`、`codex`、`opencode`、`aider`、`cursor`、`generic`
`--from-dsh <id>`	以已安装的 dsh preset 为基底（隐含 `--source dsh`）
`--manifest <path>`	描述通用 Agent 的 JSON/YAML manifest
`--skills [名称...]`	要包含的 skill 名称/路径；不带值 = 一个都不包含。默认：全部发现的
`--mcp-config <path>`	额外的 MCP 配置文件（JSON/YAML/TOML，可重复）
`--mcp-include <name>`	只包含这些 MCP（可重复 / 逗号分隔）
`--mcp-exclude <name>`	排除这些 MCP（可重复 / 逗号分隔）
`--exclude-local-mcp`	剔除本机专用 MCP（home/本地路径、localhost URL）
`--agent-md <path>`	要包含的指令文件（可重复）
`--memory`	`auto`（默认）/ `full` / `safe` / `none`
`--memory-files <path>`	额外的 memory 文件（可重复）
`--extra-file <src:dst>`	把额外文件/目录复制到 `assets/<dst>`（可重复）
`--tool <path>`	把自定义工具插件打包进 `tools/`（可重复）
`--base-preset <id>`	非 dsh 来源时的基底 preset。默认 `standard`
`--dry-run`	只打印计划，不写任何文件
`--verbose`	详细发现 / 脱敏输出
`--push`、`--repo`、`--public`、`--private`	git init 并推送到 GitHub
`--yes`	跳过所有确认提示

Manifest 格式

{
  "id": "my-agent",
  "name": "My Agent",
  "description": "A packaged agent",
  "skills": ["/path/to/skill-dir", "skill-name-from-common-roots"],
  "mcp": {
    "github": {
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "ghp_xxx" }
    }
  },
  "agent_md": ["/path/to/AGENTS.md"],
  "memory": {
    "mode": "safe",
    "files": ["/path/to/memory.md"]
  },
  "tools": [
    "/path/to/tool.mjs",
    {"path": "/path/to/tool-dir", "id": "my-tool", "name": "./tools/tool-dir/index.mjs", "config": {}}
  ],
  "extra_files": [
    {"src": "/path/to/file", "dst": "notes/guide.md"}
  ]
}

安装打包结果

在目标机器上：

git clone --depth 1 https://github.com/you/my-agent ~/.dsh/.agent-presets/my-agent

或进入仓库运行：

./install.sh https://github.com/you/my-agent my-agent

然后重启 dsh，在模式选择器中选择新模式。MCP 需要的环境变量见 .env.example。

安全说明

MCP 的 token/密钥不会写入仓库，只生成 process.env.AGENT_MCP_* 占位符和 .env.example。
memory 默认 safe 模式，行内形似凭据的 token 也会被剔除；确实需要全量保留时用 --memory full。
发布前建议检查 AGENTS.md、skills/、assets/ 里没有意外包含的敏感信息。

pack-Agent