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à 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
`my-research-agent chat
` 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à terminal 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 [XPROTECTX34XPROTECTX / XPROTECTX35XPROTECTX](../reference/profile-commands.md#Hermes-profile-export) — đó là mục đích của những thứ đó.
- **Bạn muốn chia sẻ khóa API cùng với đại lý.**
`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:
``` bash
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
:
``` 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"
# Tell installers which env vars the agent needs. These are checked against
# the installer's shell and existing .env file so they don't get nagged
# about keys they already have configured.
env_requires:
- name: OpenAI_API_KEY
description: "OpenAI API key (for model access)"
required: true
- name: SERPAPI_KEY
description: "SerpAPI key for web search"
required: false
default: ""
`
``Đó 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
``` bash
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ó.
:::note
Git repo 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ẻ:
``` bash
# 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
`
``Người nhận chạy
`Hermes profile update research-bot
` 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:
| Danh mục | Đường dẫn | Đang cập nhật |
|---|---|---|
| **Thuộc sở hữu của nhà phân phối** |
SOUL.md
,
`config.yaml
,
`MCP.JSON
,
`skills/
,
`cron/
,
`distribution.YAML
` | Được thay thế từ bản sao mới |
| **Ghi đè cấu hình** |
config.yaml
` | Trên thực tế được giữ nguyên theo mặc định — trình cài đặt có thể đã điều chỉnh kiểu máy hoặc nhà cung cấp. Vượt qua
--force-config
` khi cập nhật để đặt lại. |
| **Do người dùng sở hữu** |
memories/
,
`sessions/
,
`state.db*
,
`auth.JSON
,
.env
,
`logs/
,
`workspace/
,
`plans/
,
`home/
,
*_cache/
,
`local/
` | Chưa bao giờ chạm vào |
Bạn có thể ghi đè danh sách thuộc sở hữu phân phối trong bảng kê khai:
``` yaml
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
``` bash
Hermes profile install GitHub.com/you/research-bot --alias
`
``Điều gì xảy ra:
1. Sao chép kho lưu trữ vào một thư mục tạm thời.
2. Đọc
`distribution.YAML
, hiển thị cho bạn tệp kê khai (tên, phiên bản, mô tả, tác giả, các biến env bắt buộc).
3. Kiểm tra từng var env bắt buộc đối với môi trường shell của bạn và
.env
` hiện có của cấu hình đích. Đánh dấu từng cái là
✓ set
` hoặc
`needs setting
` để bạn biết chính xác những gì cần định cấu hình.
4. Yêu cầu xác nhận. Vượt qua
-y
` /
--yes
` để bỏ qua.
5. Sao chép các tệp thuộc sở hữu của bản 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 được).
6. 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.
7. Với
--alias
, tạo một trình bao bọc để bạn có thể chạy trực tiếp
`research-bot chat
.
### Loại nguồn
Bất kỳ URL git nào cũng hoạt động:
``` bash
# 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
# Local directory during development (no git push needed)
Hermes profile install ~/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:
``` bash
# 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=
# SerpAPI key for web search
# (optional)
# SERPAPI_KEY=
`
``Sao chép nó:
``` bash
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 là
✓ 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
``` bash
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
Environment variables:
OpenAI_API_KEY (required) — OpenAI API key (for model access)
SERPAPI_KEY (optional) — SerpAPI key for web search
`
```Hermes profile list
` cũng hiển thị cột
`Distribution
` để 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
`bash
Hermes profile update research-bot
`
``Điều gì xảy ra:
1. Sao chép lại repo từ URL nguồn đã ghi.
2. Thay thế các tệp thuộc sở hữu của nhà phân phối (SOUL, Skills, cron, MCP.JSON).
3. **Bảo quản**
`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. Vượt qua
--force-config
` để ghi đè.
4. **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.
### Xóa
``` bash
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)
Type 'research-bot' to confirm:
`
``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.
`bash
# 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
# Workstation
Hermes profile install GitHub.com/you/research-bot --alias
# Fill in .env. Done.
`
``Bất kỳ lần lặp nào trên máy tính xách tay (
`git commit && push
) sẽ kéo vào máy trạm bằng
`Hermes profile update research-bot
. 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 SOUL 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ó.
``` bash
# 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
# Each engineer
Hermes profile install git@GitHub.com:your-org/pr-reviewer.git --alias
# Fill in .env with their own API key (billed to them), .env.EXAMPLE points at what's required
pr-reviewer chat
`
``Khi người dẫn đầu xuất bản v1.1 (SOUL tốt hơn, kỹ năng mới), các kỹ sư chạy
`Hermes profile update pr-reviewer
` 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ộngBạ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ó.
``` bash
# 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
# Anyone
Hermes profile install 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.
``` yaml
# 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:
- name: ACME_API_KEY
description: "Your Acme Compliance license key (email support@acme.com)"
required: true
- name: OpenAI_API_KEY
description: "OpenAI API key for model access"
required: true
- name: GRAPHITI_MCP_URL
description: "URL for your Graphiti knowledge graph instance"
required: false
default: "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ọ (
`memories/
,
`sessions/
) 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.
``` bash
# 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
# Incident resolved — tear it down
Hermes profile delete incident-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ể
:::note
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
`Hermes profile info <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
``` bash
# 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:
``` yaml
# ~/.Hermes/profiles/research-bot/local/my-overrides.YAML
# (distribution never touches local/)
`
``…và tham khảo nó từ
`config.yaml
` hoặc SOUL của bạn nếu cần.
### Buộc cài đặt lại sạch sẽ
``` bash
# 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
# Update to current main but reset config.yaml to the distribution's default
Hermes profile update research-bot --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ữ:
``` bash
# Fork the repo on GitHub, then install your fork
Hermes profile install GitHub.com/yourname/forked-research-bot --alias
# Iterate locally in ~/.Hermes/profiles/forked-research-bot/
# Edit SOUL.md, commit, push to your fork
# Upstream changes: pull them into your fork the usual way
`
### Kiểm tra bản phân phối trước khi đẩy
Từ máy của tác giả:
``` bash
# Install from a local directory (no git push needed)
Hermes profile install ~/.Hermes/profiles/research-bot --name research-bot-test --alias
# Tweak, delete, re-install until it's right
Hermes profile delete research-bot-test --yes
Hermes profile install ~/.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
-
`memories/
- bộ nhớ hội thoại
-
`sessions/
- 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 cào
-
`home/
` — giá đỡ tại nhà 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 SOUL, kỹ năng hoặc công việc định kỳ độc hại.
Các công việc định kỳ 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 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 [Profile Commands reference](../reference/profile-commands.md#distribution-commands).
Phiên bản ngắn:-
`install
,
`update
,
`info
` nằm bên trong
`Hermes profile
` — không phải là cây lệnh song song.
- Định dạng tệp kê khai là YAML với lược đồ bắt buộc rất nhỏ (chỉ
`name
).
- 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 đó, mọi xác thực mà trình bao 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 "ô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 tại thời điểm cài đặt để tránh xung đột với các tệp nhị phân thông thường.
## Xem thêm
- [Profiles: Running Multiple Agents](./profiles.md) — khái niệm cơ bản
- [Profile Commands reference](../reference/profile-commands.md) — mọi cờ, mọi tùy chọn
- [XPROTECTX131XPROTECTX / XPROTECTX132XPROTECTX](../reference/profile-commands.md#Hermes-profile-export) — sao lưu / khôi phục cục bộ (không phân phối)
- [Using SOUL with Hermes](../guides/use-soul-with-Hermes.md) — cá nhân tác giả
- [Personality & SOUL](./features/personality.md) — cách SOUL phù hợp với tác nhân
- [Skills catalog](../reference/skills-catalog.md) — các kỹ năng bạn có thể gói