Tham chiếu lệnh hồ sơ

Trang này bao gồm tất cả các lệnh liên quan đến Hermes profiles. Để biết các lệnh CLI chung, hãy xem CLI Commands Reference.
`Hermes profile
Hermes profile &lt;subcommand>

`
``Lệnh cấp cao nhất để quản lý hồ sơ. Chạy 
`Hermes profile
` mà không có lệnh phụ sẽ hiển thị trợ giúp.

| Tiểu ban | Mô tả |
|----------||-------------|
| 
`list
` | Liệt kê tất cả hồ sơ. |
| 
`use
` | Đặt cấu hình hoạt động (mặc định). |
| 
`create
` | Tạo một hồ sơ mới. |
| 
`delete
` | Xóa một hồ sơ. |
| 
`show
` | Hiển thị chi tiết về một hồ sơ. |
| 
`alias
` | Tạo lại bí danh shell cho một hồ sơ. |
| 
`rename
` | Đổi tên một hồ sơ. |
| 
`export
` | Xuất cấu hình sang kho lưu trữ tar.gz. |
| 
`import
` | Nhập hồ sơ từ kho lưu trữ tar.gz. |
| 
`install
` | Cài đặt bản phân phối hồ sơ từ URL git hoặc thư mục cục bộ. Xem [Profile Distributions](../user-guide/profile-distributions.md). |
| 
`update
` | Kéo lại hồ sơ được quản lý phân phối và áp dụng lại gói của nó. |
| 
`info
` | Hiển thị siêu dữ liệu phân phối cho một cấu hình (URL gốc, cam kết, cập nhật lần cuối). |

##
`Hermes profile list

`
`bash
Hermes profile list

`
``Liệt kê tất cả hồ sơ. Cấu hình hiện đang hoạt động được đánh dấu bằng 

`
*

.

**Ví dụ:**

``` bash
$ Hermes profile list
  default

* work
  dev
  personal

`
``Không có lựa chọn.

##
`Hermes profile use

`
``` bash
Hermes profile use &lt;name>

`
``Đặt 

&lt;name>
` làm cấu hình hoạt động. Tất cả các lệnh 
`Hermes
` tiếp theo (không có 

`
-p

) sẽ sử dụng cấu hình này.

| Lập luận | Mô tả |
|----------|-------------|
| 

&lt;name>
` | Tên hồ sơ để kích hoạt. Sử dụng 
`default
` để quay lại cấu hình cơ sở. |`**Ví dụ:**

``` bash
Hermes profile use work
Hermes profile use default

`

##
`Hermes profile create

`
`bash
Hermes profile create &lt;name> [options]

`
``Tạo một hồ sơ mới.

| Đối số / Lựa chọn | Mô tả |
|-------------------|-------------|
| 

&lt;name>
` | Tên cho hồ sơ mới. Phải là tên thư mục hợp lệ (chữ và số, dấu gạch ngang, dấu gạch dưới). |
| 

`
--clone
` | Sao chép 
`config.yaml

, 

.env
` và 
`SOUL.md
` từ cấu hình hiện tại. |
| 

--clone-all
` | Sao chép mọi thứ (cấu hình, ký ức, kỹ năng, phiên, trạng thái) từ hồ sơ hiện tại. |
| 

--clone-from &lt;profile>
` | Sao chép từ một hồ sơ cụ thể thay vì hồ sơ hiện tại. Được sử dụng với 

--clone
` hoặc 

--clone-all

. |
| 

--no-alias
` | Bỏ qua việc tạo tập lệnh bao bọc. |
| 

--description "&lt;text>"
` | Mô tả một hoặc hai câu về những gì hồ sơ này giỏi. Được sử dụng bởi bộ điều phối Kanban để định tuyến các nhiệm vụ dựa trên vai trò thay vì chỉ tên hồ sơ. Bỏ qua và thêm sau thông qua 
`Hermes profile describe

. Kiên trì trong 

&lt;profile_dir>/profile.YAML

. |
| 

--no-skills
` | Tạo một hồ sơ **trống** không kích hoạt gói kỹ năng nào. Ghi điểm đánh dấu 

.no-skills
` vào hồ sơ để các lần chạy 
`Hermes update
` trong tương lai sẽ không tạo lại bộ đã đóng gói và từ chối kết hợp với 

--clone
` / 

--clone-all
` (dù sao cũng sẽ sao chép các kỹ năng). Hữu ích cho hồ sơ người điều phối hẹp hoặc hồ sơ hộp cát không kế thừa danh mục kỹ năng đầy đủ. |

Việc tạo một hồ sơ **không** biến thư mục hồ sơ đó thành thư mục dự án/không gian làm việc mặc định cho các lệnh đầu cuối. Nếu bạn muốn một cấu hình bắt đầu trong một dự án cụ thể, hãy đặt 
`terminal.cwd
` trong 
`config.yaml
` của cấu hình đó.

**Ví dụ:**

``` bash

# Blank profile — needs full setup
Hermes profile create mybot

# Clone config only from current profile
Hermes profile create work --clone

# Clone everything from current profile
Hermes profile create backup --clone-all

# Clone config from a specific profile
Hermes profile create work2 --clone --clone-from work

`

##
`Hermes profile describe

`
``` bash
Hermes profile describe [&lt;name>] [options]

`
``Đọc hoặc đặt mô tả của hồ sơ. Mô tả được bộ điều phối kanban sử dụng để định tuyến các nhiệm vụ dựa trên những gì mỗi hồ sơ giỏi, thay vì chỉ đoán từ tên hồ sơ. Vẫn tồn tại trong 

&lt;profile_dir>/profile.YAML
` nên nó vẫn tồn tại sau khi khởi động lại và được chia sẻ với cổng.

Không có cờ, in mô tả hiện tại (hoặc 

(no description set for '&lt;name>')
` nếu trống).| Đối số / Lựa chọn | Mô tả |
|-------------------|-------------|
| 

&lt;name>
` | Hồ sơ để mô tả. Bắt buộc trừ khi sử dụng 

`
--all --auto

. |
| 

--text "&lt;text>"
` | Đặt mô tả cho văn bản chính xác này (do người dùng tạo). Ghi đè mọi mô tả hiện có. |
| 

--auto
` | Tự động tạo mô tả 1-2 câu thông qua LLM phụ trợ, dựa trên các kỹ năng đã cài đặt, mô hình được định cấu hình và tên của hồ sơ. Định cấu hình mô hình theo 
`auxiliary.profile_describer
` trong 
`config.yaml

. Các mô tả được tạo tự động được đánh dấu 
`description_auto: true
` để trang tổng quan có thể gắn cờ chúng để xem xét. |
| 

--overwrite
` | Với 

--auto

, cũng thay thế các mô tả do người dùng tạo (mặc định: bỏ qua các cấu hình có mô tả được đặt rõ ràng). |
| 

--all
` | Với 

--auto

, quét mọi hồ sơ thiếu mô tả. |`**Ví dụ:**

``` bash

# Read the current description
Hermes profile describe researcher

# Set it explicitly
Hermes profile describe researcher --text "Reads source code and writes findings."

# Let the LLM generate one
Hermes profile describe researcher --auto

# Fill in descriptions for every profile that doesn't have one
Hermes profile describe --all --auto

`

##
`Hermes profile delete

`
``` bash
Hermes profile delete &lt;name> [options]

`
``Xóa một cấu hình và loại bỏ bí danh shell của nó.

| Đối số / Lựa chọn | Mô tả |
|-------------------|-------------|
| 

&lt;name>
` | Hồ sơ cần xóa. |
| 

`
--yes

, 

-y
` | Bỏ qua lời nhắc xác nhận. |

**Ví dụ:**

``` bash
Hermes profile delete mybot
Hermes profile delete mybot --yes

`

:::warning
Thao tác này sẽ xóa vĩnh viễn toàn bộ thư mục của hồ sơ bao gồm tất cả cấu hình, ký ức, phiên và kỹ năng. Không thể xóa hồ sơ hiện đang hoạt động.

:::

##
`Hermes profile show

`
``` bash
Hermes profile show &lt;name>

`
``Hiển thị thông tin chi tiết về một hồ sơ bao gồm thư mục chính, mô hình được định cấu hình, trạng thái cổng, số lượng kỹ năng và trạng thái tệp cấu hình.

Điều này hiển thị thư mục chính Hermes của hồ sơ, không phải thư mục làm việc của terminal. Các lệnh đầu cuối bắt đầu từ 
`terminal.cwd
` (hoặc thư mục khởi chạy trên chương trình phụ trợ cục bộ khi 
`cwd: "."

).

| Lập luận | Mô tả |
|----------|-------------|
| 

&lt;name>
` | Hồ sơ để kiểm tra. |

**Ví dụ:**

`bash
$ Hermes profile show work
Profile: work
Path:    ~/.Hermes/profiles/work
Model:   Anthropic/Claude-sonnet-4 (Anthropic)
Gateway: stopped
Skills:  12
.env:    exists
SOUL.md: exists
Alias:   ~/.local/bin/work

`

##
`Hermes profile alias

`
`bash
Hermes profile alias &lt;name> [options]

`
``Tạo lại tập lệnh bí danh shell tại 

~/.local/bin/&lt;name

. Hữu ích nếu bí danh vô tình bị xóa hoặc nếu bạn cần cập nhật nó sau khi di chuyển cài đặt Hermes của mình.

| Đối số / Lựa chọn | Mô tả |
|-------------------|-------------|
| 

&lt;name>
` | Hồ sơ để tạo/cập nhật bí danh cho. |
| 

`
--remove
` | Hãy xóa tập lệnh bao bọc thay vì tạo tập lệnh đó. |
| 

--name &lt;alias>
` | Tên bí danh tùy chỉnh (mặc định: tên hồ sơ). |

**Ví dụ:**

``` bash
Hermes profile alias work

# Creates/updates ~/.local/bin/work

Hermes profile alias work --name mywork
# Creates ~/.local/bin/mywork

Hermes profile alias work --remove
# Removes the wrapper script

`

##
`Hermes profile rename

`
``` bash
Hermes profile rename &lt;old-name> &lt;new-name>

`
``Đổi tên một hồ sơ. Cập nhật bí danh thư mục và shell.

| Lập luận | Mô tả |
|----------|-------------|
| 

&lt;old-name>
` | Tên hồ sơ hiện tại. |
| 

&lt;new-name>
` | Tên hồ sơ mới. |

**Ví dụ:**

`bash
Hermes profile rename mybot assistant

# ~/.Hermes/profiles/mybot → ~/.Hermes/profiles/assistant
# ~/.local/bin/mybot → ~/.local/bin/assistant

`

##
`Hermes profile export

`
``` bash
Hermes profile export &lt;name> [options]

`
``Xuất cấu hình dưới dạng kho lưu trữ tar.gz nén.

| Đối số / Lựa chọn | Mô tả |
|-------------------|-------------|
| 

&lt;name>
` | Hồ sơ để xuất. |
| 

`
-o

, 

--output &lt;path>
` | Đường dẫn tệp đầu ra (mặc định: 

&lt;name>.tar.gz

). |`**Ví dụ:**

``` bash
Hermes profile export work

# Creates work.tar.gz in the current directory

Hermes profile export work -o ./work-2026-03-29.tar.gz

`

##
`Hermes profile import

`
``` bash
Hermes profile import &lt;archive> [options]

`
``Nhập cấu hình từ kho lưu trữ tar.gz.

| Đối số / Lựa chọn | Mô tả |
|-------------------|-------------|
| 

&lt;archive>
` | Đường dẫn đến kho lưu trữ tar.gz để nhập. |
| 

`
--name &lt;name>
` | Tên của hồ sơ đã nhập (mặc định: được suy ra từ kho lưu trữ). |

**Ví dụ:**

``` bash
Hermes profile import ./work-2026-03-29.tar.gz

# Infers profile name from the archive

Hermes profile import ./work-2026-03-29.tar.gz --name work-restored

`

## Lệnh phân phối

:::tip
**Mới đối với các bản phân phối?** Bắt đầu với [Profile Distributions user guide](../user-guide/profile-distributions.md) - nó đề cập đến lý do, thời điểm và cách thức với các ví dụ đầy đủ. Các phần bên dưới là tài liệu tham khảo CLI khô khan khi bạn biết mình muốn gì.
:::

Các bản phân phối biến hồ sơ thành một tạo phẩm có phiên bản, có thể chia sẻ được xuất bản
dưới dạng **kho git**. Người nhận cài đặt bản phân phối bằng một
lệnh và có thể cập nhật nó tại chỗ sau mà không cần chạm vào địa phương của họ
ký ức, phiên hoặc thông tin xác thực.

auth.JSON
` và 

.env
` không bao giờ là một phần của phân phối — chúng nằm trên
cài đặt máy của người dùng.

Dữ liệu người dùng của người nhận (bộ nhớ, phiên, xác thực, các chỉnh sửa của chính họ đối với

.env

) luôn được bảo toàn trong suốt quá trình cài đặt ban đầu và các lần tiếp theo
cập nhật.:::info
`Hermes profile export
` / 
`import
` vẫn là những lệnh phù hợp cho
**sao lưu và khôi phục cục bộ** cấu hình trên máy của chính bạn. Phân phối
(
`install
` / 
`update
` / 
`info

) là một khái niệm riêng biệt: gửi hồ sơ qua
git để người khác có thể cài đặt nó.
:::

###
`Hermes profile install

`
``` bash
Hermes profile install &lt;source> [--name &lt;name>] [--alias] [--force] [--yes]

`
``Cài đặt bản phân phối hồ sơ từ URL git hoặc thư mục cục bộ.

| Tùy chọn | Mô tả |
|--------|-------------|
| 

&lt;source>
` | URL Git (
`GitHub.com/user/repo

, 
`https://...

, 
`git@...

, 
`SSH://

, 
`git://

) hoặc thư mục cục bộ chứa 
`distribution.YAML
` ở gốc. |
| 

`
--name NAME
` | Ghi đè tên hồ sơ từ bảng kê khai. |
| 

--alias
` | Đồng thời tạo trình bao bọc shell (ví dụ 
`telemetry
` → 
`Hermes -p telemetry

). |
| 

--force
` | Ghi đè hồ sơ hiện có cùng tên. Dữ liệu người dùng vẫn được bảo tồn. |
| 

-y

, 

--yes
` | Bỏ qua lời nhắc xác nhận xem trước tệp kê khai. |

Trình cài đặt hiển thị bảng kê khai, liệt kê các biến env cần thiết và cảnh báo về
cron jobs trước khi yêu cầu xác nhận. Các vars env bắt buộc đi vào một
File 

.env.EXAMPLE
` bạn copy vào 

.env
` và điền vào.

**Ví dụ:**

``` bash

# Install from a GitHub repo (shorthand)
Hermes profile install GitHub.com/kyle/telemetry-distribution --alias

# Install from a full HTTPS git URL
Hermes profile install https://GitHub.com/kyle/telemetry-distribution.git

# Install from SSH
Hermes profile install git@GitHub.com:kyle/telemetry-distribution.git

# Install from a local directory during development
Hermes profile install ./telemetry/

`

###
`Hermes profile update

`
``` bash
Hermes profile update &lt;name> [--force-config] [--yes]

`
``Sao chép lại bản phân phối từ nguồn được ghi lại và áp dụng các bản cập nhật.
Các tệp thuộc sở hữu của nhà phân phối (SOUL.md, Skills/, cron/, MCP.JSON) là
ghi đè; dữ liệu người dùng (bộ nhớ, phiên, auth, .env) không bao giờ được chạm vào.

config.yaml
` được giữ nguyên theo mặc định để giữ các phần ghi đè cục bộ của bạn.
Vượt qua 

`
--force-config
` để đặt lại về cấu hình được phân phối.

###
`Hermes profile info

`
``` bash
Hermes profile info &lt;name>

`
``In bảng kê khai phân phối của hồ sơ — tên, phiên bản, bắt buộc
Phiên bản Hermes, tác giả, yêu cầu về env var, URL/đường dẫn nguồn và
dấu thời gian 
`Installed:
` được ghi lại khi lần phân phối cuối cùng
`install

`
-ed hoặc 
`update

-d. Hữu ích cho việc kiểm tra hồ sơ được chia sẻ là gì
cần trước khi cài đặt nó và để phát hiện "hồ sơ này đã được cài đặt
6 tháng trước và chưa được cập nhật."``Hermes profile list
` cũng hiển thị tên và phiên bản phân phối trong một
Cột 
`Distribution
` và 
`Hermes profile show &lt;name>
` / 
`delete &lt;name>

hiển thị URL nguồn để bạn có thể nhanh chóng biết được hồ sơ nào đến
từ một repo git so với được tạo cục bộ.

### Phân phối riêng tư

Kho lưu trữ git riêng hoạt động như một nguồn phân phối không cần thêm
cấu hình - quá trình cài đặt sẽ chuyển sang dạng nhị phân 
`git
` bình thường của bạn, vì vậy
bất kỳ xác thực nào mà shell của bạn đã được thiết lập (khóa SSH,
Áp dụng trình trợ giúp 
`git credential

, thông tin xác thực HTTPS được lưu trữ của GitHub CLI)
một cách minh bạch.

``` bash

# Uses your SSH key, the same as any other 
`git clone

Hermes profile install git@GitHub.com:your-org/internal-assistant.git

# Uses your git credential helper
Hermes profile install https://GitHub.com/your-org/internal-assistant.git

`
``Nếu một bản sao nhắc nhở thông tin đăng nhập một cách tương tác trong terminal của bạn trong
cài đặt, lời nhắc đó sẽ chạy qua. Thiết lập xác thực của bạn theo cách bạn muốn
thường sử dụng 
`git clone
` với cùng một repo trước, sau đó cài đặt.

### Bản kê khai phân phối (
`distribution.YAML

)

Mọi bản phân phối đều có 
`distribution.YAML
` ở thư mục gốc của kho lưu trữ:

``` yaml
name: telemetry
version: 0.1.0
description: "Compliance monitoring harness"
Hermes_requires: ">=0.12.0"
author: "Your Name"
license: "MIT"
env_requires:

  - name: OpenAI_API_KEY
    description: "OpenAI API key"
    required: true
  - name: GRAPHITI_MCP_URL
    description: "Memory graph URL"
    required: false
    default: "http://127.0.0.1:8000/sse"
distribution_owned:   # optional; defaults to SOUL.md, config.yaml,
                      #   MCP.JSON, skills/, cron/, distribution.YAML
  - SOUL.md
  - skills/compliance/
  - cron/

`
```Hermes_requires
` hỗ trợ 

>=

, 

&lt;=

, 

==

, 

!=

, 

>

, 

&lt;
` hoặc trần
phiên bản (được coi là 

>=

). Cài đặt không thành công với lỗi rõ ràng nếu cài đặt hiện tại
Phiên bản Hermes không đáp ứng được thông số kỹ thuật.

distribution_owned
` là tùy chọn. Nếu được đặt, chỉ những đường dẫn đó được thay thế trên
cập nhật; mọi thứ khác trong hồ sơ vẫn thuộc sở hữu của người dùng. Nếu bỏ qua,
áp dụng mặc định ở trên.

### Xuất bản bản phân phối

Việc tạo một bản phân phối chỉ là một cú đẩy git:
1. Trong thư mục hồ sơ của bạn, hãy tạo 
`distribution.YAML
` với ít nhất 
`name

   và 
`version

.
2. Khởi tạo repo git (hoặc sử dụng repo git hiện có) và đẩy tới GitHub /
   GitLab/bất kỳ máy chủ nào Hermes có thể sao chép từ đó.
3. Yêu cầu người nhận chạy 
`Hermes profile install &lt;your-repo-url>

.

Sử dụng thẻ git cho các bản phát hành được phiên bản — người nhận sao chép 
`HEAD
` sẽ nhận được
trạng thái mới nhất và bạn luôn có thể đưa 
`version:
` vào tệp kê khai.

##
`Hermes -p
` / 
`Hermes --profile

`
``` bash
Hermes -p &lt;name> &lt;command> [options]
Hermes --profile &lt;name> &lt;command> [options]

`
`Cờ toàn cầu để chạy bất kỳ lệnh Hermes nào trong một cấu hình cụ thể mà không thay đổi mặc định cố định. Điều này sẽ ghi đè hồ sơ hoạt động trong suốt thời gian của lệnh.

| Tùy chọn | Mô tả |
|--------|-------------|
| 

`
-p &lt;name

, 

--profile &lt;name
` | Hồ sơ để sử dụng cho lệnh này. |

**Ví dụ:**

``` bash
Hermes -p work chat -q "Check the server status"
Hermes --profile dev gateway start
Hermes -p personal skills list
Hermes -p work config edit

`

##
`Hermes completion

`
`bash
Hermes completion &lt;shell

`
``Tạo tập lệnh hoàn thành shell. Bao gồm các phần hoàn thành cho tên hồ sơ và các lệnh phụ hồ sơ.

| Lập luận | Mô tả |
|----------|-------------|
| 

&lt;shell
` | Shell để tạo các phần hoàn thành cho: 
`bash

, 
`zsh
` hoặc 
`fish

. |`**Ví dụ:**

`bash

# Install completions
Hermes completion bash >> ~/.bashrc
Hermes completion zsh >> ~/.zshrc
Hermes completion fish > ~/.config/fish/completions/Hermes.fish

# Reload shell
source ~/.bashrc

`
``Sau khi cài đặt, tính năng hoàn tất tab có tác dụng đối với:
- 
`Hermes profile &lt;TAB
` — các lệnh phụ (liệt kê, sử dụng, tạo, v.v.)
- 
`Hermes profile use &lt;TAB
` — tên hồ sơ
- 
`Hermes -p &lt;TAB
` — tên hồ sơ

## Xem thêm
- [Profiles User Guide](../user-guide/profiles.md)
- [CLI Commands Reference](./CLI-commands.md)
- [FAQ — Profiles section](./faq.md#profiles)