Phân phối hồ sơ: Chia sẻ toàn bộ đại lý

Phân phối hồ sơ đóng gói một tác nhân Hermes hoàn chỉnh — tính cách, kỹ năng, công việc định kỳ, kết nối MCP, cấu hình — dưới dạng kho lưu trữ git. Bất kỳ ai có quyền truy cập vào kho lưu trữ đều có thể cài đặt toàn bộ tác nhân bằng một lệnh, cập nhật tại chỗ và giữ nguyên các ký ức, phiên và khóa API của riêng họ.

Nếu profile là một tác nhân cục bộ, thì bản phân phối là tác nhân đó có thể chia sẻ được.

Điều này có nghĩa là gì

Trước khi phân phối, chia sẻ đại lý Hermes có nghĩa là gửi cho ai đó:

SOUL.md của bạn
Danh sách các kỹ năng cần cài đặt
config.yaml của bạn, trừ đi những bí mật
Mô tả về máy chủ MCP nào bạn kết nối
Bất kỳ công việc định kỳ nào bạn đã lên lịch
Hướng dẫn cài đặt các biến env

…và hy vọng họ đã lắp ráp nó một cách chính xác. Mỗi phiên bản nâng cấp hoặc sửa lỗi đều có nghĩa là phải lặp lại quá trình chuyển giao.

Với các bản phân phối, tất cả những thứ đó đều nằm trong một repo git:

my-research-agent/
├── distribution.yaml    # manifest: name, version, env-var requirements
├── SOUL.md              # the agent's personality / system prompt
├── config.yaml          # model, temperature, reasoning, tool defaults
├── skills/              # bundled skills that come with the agent
├── cron/                # scheduled tasks the agent runs
└── mcp.json             # MCP servers the agent connects to

Người nhận chạy:

hermes profile install github.com/you/my-research-agent --alias

…và bây giờ họ có toàn bộ đại lý. Họ điền các khóa API của riêng mình (.env.EXAMPLE → .env) và họ có thể chạy trò chuyện đại lý nghiên cứu của tôi hoặc giải quyết nó thông qua Telegram / Discord / Slack / bất kỳ nền tảng cổng nào. Khi bạn đẩy một phiên bản mới, chúng sẽ chạy hermes profile update my-research-agent và lấy các thay đổi của bạn — các ký ức và phiên của chúng vẫn được giữ nguyên.

Tại sao lại là git?

Chúng tôi đã xem xét tarball, kho lưu trữ HTTP, một định dạng tùy chỉnh. Không ai trong số họ đánh bại git:

Không có bước xây dựng nào dành cho tác giả. Đẩy lên GitHub; người tiêu dùng cài đặt. Không có vòng lặp "gói cái này, tải cái kia lên, cập nhật chỉ mục".
Thẻ, nhánh và cam kết đã là hệ thống lập phiên bản. Việc đẩy thẻ giúp chúng tôi thực hiện chức năng "đóng gói + tải lên bản phát hành" đối với các công cụ khác.
Các bản cập nhật được tải xuống. Không phải tải xuống lại toàn bộ kho lưu trữ.
Minh bạch. Người dùng có thể duyệt repo, đọc sự khác biệt giữa các phiên bản, mở các vấn đề đối với nó, phân nhánh nó để tùy chỉnh.
Kho lưu trữ riêng tư hoạt động miễn phí. Khóa SSH, trình trợ giúp git credential, thông tin xác thực được lưu trữ GitHub CLI — bất kỳ xác thực nào mà thiết bị đầu cuối của bạn đã thiết lập đều được áp dụng một cách minh bạch.
Khả năng tái tạo là một SHA cam kết. Bản ghi pip và npm giống nhau.

Sự cân bằng: người nhận cần cài đặt git. Trên bất kỳ cỗ máy nào chạy Hermes vào năm 2026, điều đó đã đúng.

Khi nào bạn nên sử dụng bản phân phối?

Phù hợp tốt:

Bạn đang chia sẻ một đại diện chuyên môn — người giám sát tuân thủ, người đánh giá mã, trợ lý nghiên cứu, bot hỗ trợ khách hàng — với một nhóm hoặc với cộng đồng.
Bạn đang triển khai cùng một tác nhân cho nhiều máy và không muốn sao chép tệp theo cách thủ công mỗi lần.
Bạn đang lặp lại một tác nhân và muốn người nhận nhận phiên bản mới bằng một lệnh.
Bạn đang xây dựng một nhân viên hỗ trợ như một sản phẩm — các giá trị mặc định có quan điểm, kỹ năng được tuyển chọn, lời nhắc được điều chỉnh — mà người khác nên sử dụng làm điểm khởi đầu.

Không phù hợp:

Bạn chỉ muốn sao lưu hồ sơ trên máy của chính mình. Sử dụng hermes profile import / import — đó là mục đích của những thứ đó.
Bạn muốn chia sẻ khóa API cùng với tác nhân. auth.json và .env bị cố tình loại trừ khỏi bản phân phối. Mỗi trình cài đặt mang thông tin xác thực của riêng họ.
Bạn muốn chia sẻ kỷ niệm/phiên/lịch sử hội thoại. Đó là dữ liệu người dùng, không phải nội dung phân phối. Không bao giờ được vận chuyển.

Vòng đời: tác giả đến trình cài đặt để cập nhật

Dưới đây là toàn bộ quy trình từ đầu đến cuối. Chọn bên bạn quan tâm.

Dành cho tác giả: xuất bản một bản phân phối

Bước 1 — Bắt đầu từ hồ sơ đang hoạt động

Xây dựng và tinh chỉnh đại lý giống như bất kỳ hồ sơ nào khác:

hermes profile create research-bot
research-bot setup                    # configure model, API keys
# Edit ~/.hermes/profiles/research-bot/SOUL.md
# Install skills, wire up MCP servers, schedule cron jobs, etc.
research-bot chat                     # dogfood until it feels right

Bước 2 — Thêm `distribution.yaml`

Tạo ~/.hermes/profiles/research-bot/distribution.yaml:

name: research-bot
version: 1.0.0
description: "Autonomous research assistant with arXiv and web tools"
hermes_requires: ">=0.12.0"
author: "Your Name"
license: "MIT"

# Cho người cài đặt biết loại env mà tác nhân cần. Những điều này được kiểm tra chống lại
# shell của trình cài đặt và tệp .env hiện có để chúng không bị cằn nhằn
# về các khóa họ đã cấu hình.
env_requires:
  - tên: OPENAI_API_KEY
    mô tả: "Khóa API OpenAI (để truy cập mô hình)"
    bắt buộc: đúng
  - tên: SERPAPI_KEY
    mô tả: "Khóa SerpAPI cho tìm kiếm trên web"
    bắt buộc: sai
    mặc định: ""

Đó là toàn bộ bảng kê khai. Mọi trường ngoại trừ name đều có giá trị mặc định hợp lý.

Bước 3 - Đẩy tới repo git

cd ~/.hermes/profiles/research-bot
git init
git add .
git commit -m "v1.0.0"
git remote add origin git@github.com:you/research-bot.git
git tag v1.0.0
git push -u origin main --tags

Các repo bây giờ là một bản phân phối. Bất cứ ai có quyền truy cập đều có thể cài đặt nó.

:::lưu ý Kho lưu trữ git chứa mọi thứ trong thư mục hồ sơ ngoại trừ những thứ đã bị loại khỏi bản phân phối: auth.json, .env, memories/, sessions/, state.db*, logs/, workspace/, *_cache/, local/. Những thứ đó vẫn còn trên máy của bạn. Bạn cũng có thể thêm .gitignore nếu bạn muốn loại trừ các đường dẫn bổ sung. :::

Bước 4 - Gắn thẻ các bản phát hành theo phiên bản

Mỗi khi tác nhân đạt đến điểm ổn định, hãy thay đổi phiên bản và gắn thẻ:

# Edit distribution.yaml: version: 1.1.0
git add distribution.yaml SOUL.md skills/
git commit -m "v1.1.0: tighter research SOUL, add arxiv skill"
git tag v1.1.0
git push --tags

Những người nhận chạy bot nghiên cứu cập nhật hồ sơ Hermes sẽ lấy bản mới nhất.

Kho lưu trữ trông như thế nào

Một bản phân phối hoàn chỉnh có tác giả:

research-bot/
├── distribution.yaml            # required
├── SOUL.md                      # strongly recommended
├── config.yaml                  # model, provider, tool defaults
├── mcp.json                     # MCP server connections
├── skills/
│   ├── arxiv-search/SKILL.md
│   ├── paper-summarization/SKILL.md
│   └── citation-lookup/SKILL.md
├── cron/
│   └── weekly-digest.json       # scheduled tasks
└── README.md                    # human-facing description (optional)

Thuộc sở hữu của người phân phối và sở hữu của người dùng

Khi trình cài đặt cập nhật lên phiên bản mới, một số thứ sẽ được thay thế (miền của tác giả) và một số thứ vẫn được giữ nguyên (miền của trình cài đặt). Mặc định:

Category	Paths	On update
Distribution-owned	`SOUL.md`, `config.yaml`, `mcp.json`, `skills/`, `cron/`, `distribution.yaml`	Replaced from the new clone
Config override	`config.yaml`	Actually preserved by default — the installer may have tuned model or provider. Pass `--force-config` on update to reset.
User-owned	`memories/`, `sessions/`, `state.db`, `auth.json`, `.env`, `logs/`, `workspace/`, `plans/`, `home/`, `_cache/`, `local/`	Never touched

Bạn có thể ghi đè danh sách thuộc sở hữu phân phối trong bảng kê khai:

distribution_owned:
  - SOUL.md
  - skills/research/            # only my research skills; other installed skills stay
  - cron/digest.json

Khi bị bỏ qua, các giá trị mặc định ở trên sẽ được áp dụng — đây là điều mà hầu hết các bản phân phối đều mong muốn.

Dành cho người cài đặt: sử dụng bản phân phối

Cài đặt

hermes profile install github.com/you/research-bot --alias

Điều gì xảy ra:

Sao chép kho lưu trữ vào một thư mục tạm thời.
Đọc distribution.yaml, hiển thị cho bạn bảng kê khai (tên, phiên bản, mô tả, tác giả, các biến env bắt buộc).
Kiểm tra từng var env được yêu cầu dựa trên môi trường shell của bạn và .env hiện có của cấu hình đích. Đánh dấu mỗi mục là ✓ set hoặc cần cài đặt để bạn biết chính xác những gì cần định cấu hình.
Yêu cầu xác nhận. Truyền -y / --yes để bỏ qua.
Sao chép các tệp thuộc sở hữu của nhà phân phối vào ~/.hermes/profiles/research-bot/ (hoặc bất cứ nơi nào name của tệp kê khai phân giải).
Viết .env.EXAMPLE với các khóa bắt buộc được nhận xét — sao chép vào .env và điền vào.
Với --alias, tạo một trình bao bọc để bạn có thể chạy trực tiếp trò chuyện bot nghiên cứu.

Loại nguồn

Bất kỳ URL git nào cũng hoạt động:

# GitHub shorthand
hermes profile install github.com/you/research-bot

# Full HTTPS
hermes profile install https://github.com/you/research-bot.git

# SSH
hermes profile install git@github.com:you/research-bot.git

# Self-hosted, GitLab, Gitea, Forgejo — any Git host
hermes profile install https://git.example.com/team/research-bot.git

# Private repo using your configured git auth
hermes profile install git@github.com:your-org/internal-bot.git

# Thư mục cục bộ trong quá trình phát triển (không cần git push)
cài đặt hồ sơ Hermes ~/my-profile-in-progress/

Ghi đè tên hồ sơ

Hai người dùng muốn phân phối giống nhau dưới các tên hồ sơ khác nhau:

# Alice
hermes profile install github.com/acme/support-bot --name support-us --alias
# Bob (same distribution, different local name)
hermes profile install github.com/acme/support-bot --name support-eu --alias

Điền vào các biến env

Sau khi cài đặt, hồ sơ của tác nhân chứa .env.EXAMPLE:

# Environment variables required by this Hermes distribution.
# Copy to `.env` and fill in your own values before running.

# OpenAI API key (for model access)
# (required)
OPENAI_API_KEY=

# Khóa SerpAPI để tìm kiếm trên web
# (tùy chọn)
#SERPAPI_KEY=

Sao chép nó:

cp ~/.hermes/profiles/research-bot/.env.EXAMPLE ~/.hermes/profiles/research-bot/.env
# Edit .env, paste your real keys

Các khóa bắt buộc đã có trong môi trường shell của bạn (ví dụ: OPENAI_API_KEY được xuất trong ~/.zshrc của bạn) được đánh dấu ✓ set trong khi cài đặt — bạn không cần sao chép chúng trong .env.

Kiểm tra những gì bạn đã cài đặt

hermes profile info research-bot

Chương trình:

Distribution: research-bot
Version:      1.0.0
Description:  Autonomous research assistant with arXiv and web tools
Author:       Your Name
Requires:     Hermes >=0.12.0
Source:       https://github.com/you/research-bot
Installed:    2026-05-08T17:04:32+00:00

Biến môi trường:
  OPENAI_API_KEY (bắt buộc) - Khóa API OpenAI (để truy cập mô hình)
  SERPAPI_KEY (tùy chọn) - Khóa SerpAPI để tìm kiếm trên web

danh sách hồ sơ hermes cũng hiển thị cột Phân phối để bạn có thể xem nhanh hồ sơ nào của mình đến từ kho lưu trữ và hồ sơ nào bạn tạo thủ công:

 Profile          Model                        Gateway      Alias        Distribution
 ───────────────    ───────────────────────────    ───────────    ───────────    ────────────────────
 ◆default         claude-sonnet-4              stopped      —            —
  coder           gpt-5                        stopped      coder        —
  research-bot    claude-opus-4                stopped      research-bot research-bot@1.0.0
  telemetry       claude-sonnet-4              running      telemetry    telemetry@2.3.1

Cập nhật

hermes profile update research-bot

Điều gì xảy ra:

Sao chép lại repo từ URL nguồn đã ghi.
Thay thế các tệp thuộc sở hữu của nhà phân phối (SOUL, Skills, cron, mcp.json).
Giữ config.yaml của bạn — bạn có thể đã điều chỉnh kiểu máy, nhiệt độ hoặc các cài đặt khác. Truyền --force-config để ghi đè.
Không bao giờ chạm vào dữ liệu người dùng: kỷ niệm, phiên, xác thực, .env, nhật ký, trạng thái.

Không tải xuống lại toàn bộ kho lưu trữ. Không thực hiện các thay đổi cục bộ của bạn đối với config. Không xóa lịch sử trò chuyện của bạn.

Di dời

hermes profile delete research-bot

Thông tin phân phối hiển thị lời nhắc xóa trước khi yêu cầu bạn xác nhận:

Profile: research-bot
Path:    ~/.hermes/profiles/research-bot
Model:   claude-opus-4 (anthropic)
Skills:  12
Distribution: research-bot@1.0.0
Installed from: https://github.com/you/research-bot

This will permanently delete:
  • All config, API keys, memories, sessions, skills, cron jobs
  • Command alias (~/.local/bin/research-bot)

Nhập 'bot nghiên cứu' để xác nhận:

Vì vậy, bạn không bao giờ vô tình xóa một tác nhân mà không biết nó đến từ đâu hoặc không thể cài đặt lại nó.

Trường hợp sử dụng và mẫu

Cá nhân: đồng bộ một tác nhân trên các máy

Bạn đã xây dựng một trợ lý nghiên cứu trên máy tính xách tay của mình. Bạn muốn cùng một tác nhân trên máy trạm của bạn.

# Laptop
cd ~/.hermes/profiles/research-bot
git init && git add . && git commit -m "initial"
git remote add origin git@github.com:you/research-bot.git
git push -u origin main

# máy trạm
hồ sơ Hermes cài đặt github.com/you/research-bot --alias
# Điền vào .env. Xong.

Bất kỳ lần lặp lại nào trên máy tính xách tay (git commit && push) sẽ được kéo vào máy trạm với bot nghiên cứu cập nhật hồ sơ hermes. Ký ức lưu lại trên mỗi máy - máy tính xách tay ghi nhớ các cuộc hội thoại của chính nó, máy trạm ghi nhớ các cuộc hội thoại của chính nó, chúng không xung đột.

Nhóm: gửi một đại lý nội bộ đã được đánh giá

Nhóm kỹ thuật của bạn muốn có một bot đánh giá PR được chia sẻ với LINH HỒN cụ thể, các kỹ năng cụ thể và một cron chạy mọi hoạt động PR thông qua nó.

# Engineering lead
cd ~/.hermes/profiles/pr-reviewer
# ... build and tune ...
git init && git add . && git commit -m "v1.0 PR reviewer"
git tag v1.0.0
git push -u origin main --tags    # push to your company's internal Git host

# Mỗi kỹ sư
hồ sơ Hermes cài đặt git@github.com:your-org/pr-reviewer.git --alias
# Điền vào .env bằng khóa API của riêng họ (được tính phí cho họ), .env.EXAMPLE chỉ ra những gì được yêu cầu
trò chuyện với người đánh giá trước

Khi người dẫn đầu xuất bản phiên bản 1.1 (TÂM LINH tốt hơn, kỹ năng mới), các kỹ sư chạy người đánh giá trước cập nhật hồ sơ Hermes và mọi người sẽ có phiên bản mới trong vòng vài phút.

Cộng đồng: xuất bản một đại lý công cộng

Bạn đã xây dựng một thứ gì đó mới lạ - có thể là "Nhà giao dịch đa thị trường" hoặc "người tóm tắt bài báo học thuật" hoặc "Trợ lý vận hành máy chủ Minecraft". Bạn muốn chia sẻ nó.

# You
cd ~/.hermes/profiles/polymarket-trader
# Write a solid README.md at the repo root — GitHub shows it on the repo page
git init && git add . && git commit -m "v1.0"
git tag v1.0.0
# Publish to a public GitHub repo
git remote add origin https://github.com/you/hermes-polymarket-trader.git
git push -u origin main --tags

# Bất cứ ai
hồ sơ Hermes cài đặt github.com/you/hermes-polymarket-trader --alias

Tweet lệnh cài đặt. Những người thử nó sẽ gửi cho bạn các vấn đề và PR. Nếu ai đó muốn tùy chỉnh, họ sẽ rẽ nhánh - cùng một quy trình làm việc git mà mọi người đều đã biết.

###Sản phẩm: gửi đại lý uy tín

Bạn đã xây dựng Hermes-on-top - có thể là một hệ thống khai thác giám sát tuân thủ, một hệ thống hỗ trợ khách hàng, một nền tảng nghiên cứu theo miền cụ thể. Bạn muốn phân phối nó như một sản phẩm.

# distribution.yaml
name: telemetry-harness
version: 2.3.1
description: "Compliance telemetry harness — monitors and reviews regulated workflows"
hermes_requires: ">=0.13.0"
author: "Acme Compliance Inc."
license: "Commercial"

env_requires:
  - tên: ACME_API_KEY
    mô tả: "Mã cấp phép Tuân thủ Acme của bạn (email support@acme.com)"
    bắt buộc: đúng
  - tên: OPENAI_API_KEY
    mô tả: "Khóa API OpenAI để truy cập mô hình"
    bắt buộc: đúng
  - tên: GRAPHITI_MCP_URL
    description: "URL cho phiên bản biểu đồ tri thức Graphiti của bạn"
    bắt buộc: sai
    mặc định: "http://127.0.0.1:8000/sse"

Khách hàng của bạn cài đặt thông qua một lệnh duy nhất; bản xem trước cài đặt cho họ biết chính xác những phím nào cần sẵn sàng; các bản cập nhật sẽ ra mắt vào thời điểm bạn gắn thẻ một bản phát hành mới; dữ liệu tuân thủ của họ (bộ nhớ/, phiên/) không bao giờ rời khỏi máy của họ.

Phù du: tập lệnh một lần trên cơ sở hạ tầng dùng chung

Bạn là người chỉ huy hoạt động. Bạn muốn một tác nhân tạm thời chẩn đoán sự cố sản xuất — một SOUL đóng hộp với các công cụ và kết nối MCP phù hợp — và chạy trên ba máy tính xách tay của kỹ sư đang làm việc trong tuần tới.

# You
# Build the profile, commit, push a private repo
git push -u origin main

# Each on-call
hermes profile install git@github.com:your-org/incident-2026-q2.git --alias

# Sự cố đã được giải quyết — phá bỏ nó đi
hồ sơ Hermes xóa sự cố-2026-q2

Chu trình cài đặt-xóa đủ rẻ để có thể dùng một lần.

Công thức nấu ăn

Ghim vào một phiên bản cụ thể

:::lưu ý Ghim ref Git (#v1.2.0) đã được lên kế hoạch nhưng không có trong bản phát hành đầu tiên - cài đặt hiện đang theo dõi nhánh mặc định. Theo dõi phiên bản đã cài đặt của bạn thông qua thông tin hồ sơ hermes <name> và tạm dừng cập nhật cho đến khi bạn sẵn sàng. :::

Kiểm tra xem bạn đang dùng phiên bản nào so với phiên bản mới nhất

# Your installed version
hermes profile info research-bot | grep Version

# Latest upstream (without installing)
git ls-remote --tags https://github.com/you/research-bot | tail -5

Giữ các tùy chỉnh cấu hình cục bộ thông qua các bản cập nhật

Hành vi cập nhật mặc định đã thực hiện điều này: config.yaml được giữ nguyên. Để an toàn, hãy ghi các chỉnh sửa cục bộ của bạn vào một tệp mà bản phân phối không sở hữu:

# ~/.hermes/profiles/research-bot/local/my-overrides.yaml
# (distribution never touches local/)

…và tham chiếu nó từ config.yaml hoặc LINH HỒN của bạn nếu cần.

Buộc cài đặt lại sạch sẽ

# Nuke and re-install from scratch (loses memories/sessions too)
hermes profile delete research-bot --yes
hermes profile install github.com/you/research-bot --alias

# Cập nhật lên main hiện tại nhưng đặt lại config.yaml về mặc định của bản phân phối
nghiên cứu cập nhật hồ sơ Hermes --force-config --yes

Phân nhánh và tùy chỉnh

Quy trình làm việc git tiêu chuẩn - bản phân phối chỉ là kho lưu trữ:

# Fork the repo on GitHub, then install your fork
hermes profile install github.com/yourname/forked-research-bot --alias

# Lặp lại cục bộ trong ~/.hermes/profiles/forked-research-bot/
# Chỉnh sửa SOUL.md, cam kết, đẩy tới ngã ba của bạn
# Thay đổi ngược dòng: kéo chúng vào fork của bạn theo cách thông thường

Kiểm tra bản phân phối trước khi đẩy

Từ máy của tác giả:

# Install from a local directory (no git push needed)
hermes profile install ~/.hermes/profiles/research-bot --name research-bot-test --alias

# Tinh chỉnh, xóa, cài đặt lại cho đến khi đúng
hồ sơ Hermes xóa nghiên cứu-bot-test --yes
cài đặt hồ sơ Hermes ~/.hermes/profiles/research-bot --name Research-bot-test

Những gì KHÔNG có trong bản phân phối (chưa từng có)

Trình cài đặt loại trừ cứng các đường dẫn này ngay cả khi tác giả vô tình gửi chúng. Không có tùy chọn cấu hình nào cho phép bạn ghi đè điều này - trình bảo vệ an toàn là một bất biến đã được kiểm tra hồi quy:

auth.json — Mã thông báo OAuth, thông tin xác thực nền tảng
.env — Khóa API, bí mật
ký ức/ — ký ức hội thoại
session/ — lịch sử hội thoại
state.db, state.db-shm, state.db-wal — siêu dữ liệu phiên
logs/ — nhật ký tác nhân và lỗi
workspace/ — tạo ra các tập tin làm việc
plans/ — kế hoạch sơ sài
home/ — home mount của người dùng trong phần phụ trợ Docker
*_cache/ — bộ nhớ đệm hình ảnh/âm thanh/tài liệu
local/ — không gian tên tùy chỉnh do người dùng dành riêng

Khi bạn sao chép một bản phân phối, những thứ này đơn giản là không có ở đó. Khi bạn cập nhật, họ vẫn giữ nguyên. Nếu bạn đã cài đặt cùng một bản phân phối trên năm máy, bạn có năm bộ dữ liệu này riêng biệt — mỗi bộ một máy.

Bảo mật và tin cậy

Theo mặc định, các bản phân phối hồ sơ không được ký. Bạn đang tin tưởng:

Máy chủ git (GitHub / GitLab / mọi nơi) để phục vụ các byte mà tác giả đã đẩy.
Tác giả không gửi LINH HỒN, kỹ năng hoặc công việc định kỳ độc hại.

Các lệnh cron từ một bản phân phối không được lên lịch tự động — trình cài đặt in hermes -p <name> cron list và bạn kích hoạt chúng một cách rõ ràng. SOUL.md và các kỹ năng ĐƯỢC kích hoạt ngay khi bạn bắt đầu trò chuyện với hồ sơ, vì vậy hãy đọc chúng trước lần chạy đầu tiên nếu bạn cài đặt từ một người mà bạn không biết.

Tương tự đại khái: cài đặt một bản phân phối cũng giống như cài đặt tiện ích mở rộng trình duyệt hoặc tiện ích mở rộng VS Code. Ma sát thấp, công suất cao, tin cậy vào nguồn gốc. Đối với các bản phân phối nội bộ của công ty, hãy sử dụng kho lưu trữ riêng và git auth thông thường của bạn — không có gì mới để định cấu hình.

Các phiên bản trong tương lai có thể thêm chữ ký, tệp khóa (.distribution-lock.yaml) với SHA cam kết đã được giải quyết và cờ --dry-run in phần khác biệt trước khi áp dụng bản cập nhật. Không ai trong số đó đang được vận chuyển.

Dưới mui xe

Để biết chi tiết triển khai, hành vi CLI chính xác và tất cả các cờ, hãy xem tham chiếu Lệnh hồ sơ.

Phiên bản ngắn:

install, update, info sống bên trong hermes profile — không phải cây lệnh song song.
Định dạng tệp kê khai là YAML với một lược đồ bắt buộc nhỏ (chỉ tên).
Trình cài đặt sử dụng tệp nhị phân git cục bộ của bạn để sao chép, do đó, bất kỳ xác thực nào mà shell của bạn đã xử lý (khóa SSH, trình trợ giúp thông tin xác thực) đều hoạt động một cách minh bạch.
Sau khi sao chép, .git/ bị loại bỏ — bản thân cấu hình đã cài đặt không phải là kiểm tra git, tránh bẫy "ôi chao, tôi đã vô tình đưa .env của mình vào bẫy lịch sử git của bản phân phối".
Tên hồ sơ dành riêng (hermes, test, tmp, root, sudo) bị từ chối khi cài đặt để tránh xung đột với các tệp nhị phân thông thường.

Xem thêm

Hồ sơ: Chạy nhiều tác nhân — khái niệm cơ bản
Tham chiếu lệnh hồ sơ — mọi cờ, mọi tùy chọn
hermes profileexport / import — sao lưu / khôi phục cục bộ (không phải phân phối)
Sử dụng LINH HỒN với Hermes — tác giả các nhân cách
Personality & SOUL — LINH HỒN phù hợp như thế nào với tác nhân
Danh mục kỹ năng — kỹ năng bạn có thể gộp lại

Điều này có nghĩa là gì​

Tại sao lại là git?​

Khi nào bạn nên sử dụng bản phân phối?​

Vòng đời: tác giả đến trình cài đặt để cập nhật​

Dành cho tác giả: xuất bản một bản phân phối​

Bước 1 — Bắt đầu từ hồ sơ đang hoạt động​

Bước 2 — Thêm distribution.yaml​

Bước 3 - Đẩy tới repo git​

Bước 4 - Gắn thẻ các bản phát hành theo phiên bản​

Kho lưu trữ trông như thế nào​

Thuộc sở hữu của người phân phối và sở hữu của người dùng​

Dành cho người cài đặt: sử dụng bản phân phối​

Cài đặt​

Loại nguồn​

Ghi đè tên hồ sơ​

Điền vào các biến env​

Kiểm tra những gì bạn đã cài đặt​

Cập nhật​

Di dời​

Trường hợp sử dụng và mẫu​

Cá nhân: đồng bộ một tác nhân trên các máy​

Nhóm: gửi một đại lý nội bộ đã được đánh giá​

Cộng đồng: xuất bản một đại lý công cộng​

Phù du: tập lệnh một lần trên cơ sở hạ tầng dùng chung​

Công thức nấu ăn​

Ghim vào một phiên bản cụ thể​

Kiểm tra xem bạn đang dùng phiên bản nào so với phiên bản mới nhất​

Giữ các tùy chỉnh cấu hình cục bộ thông qua các bản cập nhật​

Buộc cài đặt lại sạch sẽ​

Phân nhánh và tùy chỉnh​

Kiểm tra bản phân phối trước khi đẩy​

Những gì KHÔNG có trong bản phân phối (chưa từng có)​

Bảo mật và tin cậy​

Dưới mui xe​

Xem thêm​