Ký ức Honcho`Honcho là một chương trình phụ trợ bộ nhớ gốc AI bổ sung lý luận biện chứng và mô hình hóa người dùng chuyên sâu trên hệ thống bộ nhớ tích hợp của Hermes. Thay vì lưu trữ khóa-giá trị đơn giản, Honcho duy trì một mô hình đang hoạt động về ai là người dùng — sở thích, phong cách giao tiếp, mục tiêu và kiểu mẫu của họ — bằng cách suy luận về các cuộc hội thoại sau khi chúng diễn ra.

Honcho is a Memory Provider Plugin

Honcho được tích hợp vào hệ thống Memory Providers. Tất cả các tính năng dưới đây đều có sẵn thông qua giao diện nhà cung cấp bộ nhớ hợp nhất.

Honcho bổ sung thêm những gì

Năng lực	Bộ nhớ tích hợp	Honcho
Kiên trì giữa các phiên	✔ MEMORY.md/USER.md dựa trên tệp	✔ Phía máy chủ có API
Hồ sơ người dùng	✔ Giám tuyển đại lý thủ công	✔ Suy luận biện chứng tự động
Tóm tắt phiên	—	✔ Chèn ngữ cảnh theo phạm vi phiên
Cách ly đa tác nhân	—	✔ Tách hồ sơ theo từng người
Chế độ quan sát	—	✔ Quan sát thống nhất hoặc định hướng
Kết luận (những hiểu biết sâu sắc rút ra)	—	✔ Lý luận phía máy chủ về các mẫu
Tìm kiếm trong lịch sử	✔ Tìm kiếm phiên FTS5	✔ Tìm kiếm ngữ nghĩa qua kết luận

Lý luận biện chứng: Sau mỗi lượt trò chuyện (được xác định bởi `dialecticCadence

), Honcho sẽ phân tích trao đổi và rút ra những hiểu biết sâu sắc về sở thích, thói quen và mục tiêu của người dùng. Những điều này tích lũy theo thời gian, mang lại cho nhân viên sự hiểu biết sâu sắc hơn những gì người dùng đã nêu rõ ràng. Phép biện chứng hỗ trợ độ sâu nhiều lượt (1–3 lượt) với lựa chọn dấu nhắc nguội/ấm tự động — truy vấn bắt đầu nguội tập trung vào thông tin chung của người dùng trong khi truy vấn ấm áp ưu tiên bối cảnh trong phạm vi phiên.

Ngữ cảnh trong phạm vi phiên: Ngữ cảnh cơ sở hiện bao gồm bản tóm tắt phiên cùng với phần trình bày của người dùng và thẻ ngang hàng. Điều này mang lại cho tổng đài viên nhận thức về những gì đã được thảo luận trong phiên hiện tại, giảm sự lặp lại và cho phép tính liên tục.

Hồ sơ đa tác nhân: Khi nhiều phiên bản Hermes nói chuyện với cùng một người dùng (ví dụ: trợ lý mã hóa và trợ lý cá nhân), Honcho sẽ duy trì các hồ sơ "ngang hàng" riêng biệt. Mỗi đồng nghiệp chỉ nhìn thấy những quan sát và kết luận của riêng mình, ngăn chặn sự lây nhiễm chéo bối cảnh.

Thiết lập

Hermes memory setup    # select "Honcho" from the provider list

`
``Hoặc cấu hình thủ công:

`YAML

# ~/.Hermes/config.yaml
memory:
  provider: Honcho

`

`
``` bash
echo 'Honcho_API_KEY=***' >> ~/.Hermes/.env

`
``Nhận khóa API tại [Honcho.dev](https://Honcho.dev).

## Kiến trúc

### Chèn bối cảnh hai lớp

Mỗi lượt (ở chế độ 
`hybrid
` hoặc 
`context

), Honcho tập hợp hai lớp ngữ cảnh được đưa vào lời nhắc hệ thống:
1. **Bối cảnh cơ bản** — tóm tắt phiên, đại diện người dùng, thẻ ngang hàng của người dùng, tự đại diện AI và thẻ nhận dạng AI. Đã làm mới trên 
`contextCadence

. Đây là lớp "người dùng này là ai".

2. **Bổ sung biện chứng** — Lý luận tổng hợp của LLM về trạng thái và nhu cầu hiện tại của người dùng. Được làm mới trên 
`dialecticCadence

. Đây là lớp "điều quan trọng ngay bây giờ".

Cả hai lớp đều được nối và cắt bớt theo ngân sách 
`contextTokens
` (nếu được đặt).

### Lựa chọn nhắc nhở lạnh/ấm

Phép biện chứng tự động lựa chọn giữa hai chiến lược kịp thời:
- **Khởi động nguội** (chưa có bối cảnh cơ bản): Truy vấn chung — "Người này là ai? Sở thích, mục tiêu và phong cách làm việc của họ là gì?"
- **Phiên ấm áp** (tồn tại ngữ cảnh cơ sở): Truy vấn trong phạm vi phiên — "Với những gì đã được thảo luận trong phiên này cho đến nay, ngữ cảnh nào về người dùng này là phù hợp nhất?"

Điều này xảy ra tự động dựa trên việc bối cảnh cơ sở đã được điền hay chưa.

### Ba núm cấu hình trực giao

Chi phí và độ sâu được kiểm soát bởi ba nút độc lập:

| Núm | Điều khiển | Mặc định |
|------|----------|----------|
| 
`contextCadence
` | Chuyển đổi giữa các lệnh gọi API 
`context()
` (làm mới lớp cơ sở) | 
`1
` |
| 
`dialecticCadence
` | Chuyển đổi giữa các lệnh gọi 
`peer.chat()
` LLM (làm mới lớp biện chứng) | 
`2
` (được khuyến nghị 1–5) |
| 
`dialecticDepth
` | Số lần vượt qua 

.chat()
` cho mỗi lệnh gọi biện chứng (1–3) | 
`1
` |

Đây là những phương pháp trực giao - bạn có thể thường xuyên làm mới ngữ cảnh với phép biện chứng không thường xuyên hoặc phép biện chứng nhiều lượt sâu ở tần suất thấp. Ví dụ: 
`contextCadence: 1, dialecticCadence: 5, dialecticDepth: 2
` làm mới bối cảnh cơ bản mỗi lượt, chạy biện chứng cứ sau 5 lượt và mỗi lần chạy biện chứng thực hiện 2 lượt.

### Độ sâu biện chứng (Multi-Pass)

Khi 
`dialecticDepth
` > 1, mỗi lệnh gọi biện chứng sẽ chạy nhiều lần chuyển 

.chat()

:- **Đạt 0**: Lời nhắc lạnh hoặc ấm (xem bên trên)
- **Đạt 1**: Tự kiểm tra — xác định những thiếu sót trong đánh giá ban đầu và tổng hợp bằng chứng từ các phiên gần đây
- **Đoạn 2**: Đối chiếu — kiểm tra sự mâu thuẫn giữa các bước trước và tạo ra kết quả tổng hợp cuối cùng

Mỗi đường chuyền sử dụng một mức độ suy luận theo tỷ lệ (các đường chuyền đầu nhẹ hơn, mức cơ sở cho đường chuyền chính). Ghi đè các cấp độ mỗi lần vượt qua bằng 
`dialecticDepthLevels

 - ví dụ: 

["minimal", "medium", "high"]
` để chạy ở độ sâu 3.

Chuyển bảo lãnh sớm nếu lần chuyển trước trả lại tín hiệu mạnh (đầu ra dài, có cấu trúc), do đó độ sâu 3 không phải lúc nào cũng có nghĩa là 3 lệnh gọi LLM.

### Khởi động trước phiên bắt đầu

Khi bắt đầu phiên, Honcho thực hiện một cuộc gọi biện chứng ở chế độ nền ở 
`dialecticDepth
` được cấu hình đầy đủ và chuyển kết quả trực tiếp đến tập hợp ngữ cảnh của 1. Quá trình làm ấm trước một lượt trên thiết bị ngang hàng lạnh thường trả về kết quả đầu ra mỏng — độ sâu nhiều lượt chạy chu trình kiểm tra/đối chiếu trước khi người dùng nói. Nếu chế độ làm ấm trước chưa hạ cánh ở lượt 1, thì lượt 1 sẽ quay lại cuộc gọi đồng bộ với thời gian chờ giới hạn.

### Cấp độ suy luận thích ứng truy vấn

Thang đo biện chứng được chèn tự động 
`dialecticReasoningLevel
` theo độ dài truy vấn: +1 cấp ở ≥120 ký tự, +2 ở ≥400, được kẹp ở 
`reasoningLevelCap
` (

"high"
` mặc định). Tắt bằng 
`reasoningHeuristic: false
` để ghim mọi cuộc gọi tự động vào 
`dialecticReasoningLevel

. Các cấp độ hiện có: 
`minimal

, 
`low

, 
`medium

, 
`high

, 
`max

.

## Tùy chọn cấu hình

Honcho được cấu hình trong 

~/.Honcho/config.JSON
` (toàn cầu) hoặc 

$Hermes_HOME/Honcho.JSON
` (cục bộ). Trình hướng dẫn thiết lập sẽ xử lý việc này cho bạn.

### Tham khảo cấu hình đầy đủ

| Chìa khóa | Mặc định | Mô tả |
|------|----------|-------------|
| 
`contextTokens
` | 
`null
` (chưa khai thác) | Ngân sách mã thông báo cho bối cảnh được chèn tự động mỗi lượt. Đặt thành số nguyên (ví dụ: 1200) thành giới hạn. Cắt ngắn ở ranh giới từ |
| 
`contextCadence
` | 
`1
` | Số lượt tối thiểu giữa các lệnh gọi API 
`context()
` (làm mới lớp cơ sở) |
| 
`dialecticCadence
` | 
`2
` | Số lượt tối thiểu giữa các lệnh gọi 
`peer.chat()
` LLM (lớp biện chứng). Khuyến nghị 1–5. Trong chế độ 
`tools

, không liên quan — lệnh gọi mô hình rõ ràng |
| 
`dialecticDepth
` | 
`1
` | Số lần vượt qua 

.chat()
` cho mỗi lệnh gọi biện chứng. Bị kẹp ở mức 1–3 |
| 
`dialecticDepthLevels
` | 
`null
` | Mảng tùy chọn của các cấp độ lý luận cho mỗi lần vượt qua, ví dụ: 

["minimal", "low", "medium"]

. Ghi đè mặc định theo tỷ lệ |
| 
`dialecticReasoningLevel
` | 

'low'
` | Mức lý luận cơ bản: 
`minimal

, 
`low

, 
`medium

, 
`high

, 
`max
` |
| 
`dialecticDynamic
` | 
`true
` | Khi 
`true

, mô hình có thể ghi đè mức lý luận cho mỗi cuộc gọi thông qua thông số công cụ |
| 
`dialecticMaxChars
` | 
`600
` | Ký tự tối đa của kết quả biện chứng được đưa vào dấu nhắc hệ thống |
| 
`recaLLMode
` | 

'hybrid'
` | 
`hybrid
` (tự động tiêm + công cụ), 
`context
` (chỉ tiêm), 
`tools
` (chỉ công cụ) |
| 
`writeFrequency
` | 

'async'
` | Thời điểm xóa tin nhắn: 
`async
` (chuỗi nền), 
`turn
` (đồng bộ hóa), 
`session
` (lô ở cuối) hoặc số nguyên N |
| 
`saveMessages
` | 
`true
` | Có lưu giữ tin nhắn tới Honcho API hay không |
| 
`observationMode
` | 

'directional'
` | 
`directional
` (bật tất cả) hoặc 
`unified
` (nhóm dùng chung). Ghi đè bằng đối tượng 
`observation
` để kiểm soát chi tiết |
| 
`messageMaxChars
` | 
`25000
` | Ký tự tối đa trên mỗi tin nhắn được gửi qua 
`add_messages()

. Chunk nếu vượt quá |
| 
`dialecticMaxInputChars
` | 
`10000
` | Ký tự tối đa cho đầu vào truy vấn biện chứng vào 
`peer.chat()
` |
| 
`sessionStrategy
` | 

'per-directory'
` | 
`per-directory

, 
`per-repo

, 
`per-session
` hoặc 
`global
` |`**Chiến lược phiên** kiểm soát cách phiên Honcho ánh xạ tới công việc của bạn:
- 
`per-session
` — mỗi lần chạy 
`Hermes
` sẽ có một phiên mới. Khởi động sạch, bộ nhớ thông qua các công cụ. Đề xuất cho người dùng mới.
- 
`per-directory
` — một phiên Honcho trên mỗi thư mục làm việc. Bối cảnh tích lũy qua các lần chạy.
- 
`per-repo

 - một phiên trên mỗi kho git.
- 
`global
` — phiên duy nhất trên tất cả các thư mục.**Chế độ gọi lại** kiểm soát cách bộ nhớ chuyển vào các cuộc trò chuyện:
- 
`hybrid
` — ngữ cảnh được tự động đưa vào lời nhắc hệ thống VÀ có sẵn các công cụ (mô hình quyết định thời điểm truy vấn).
- 
`context
` — chỉ tự động tiêm, ẩn công cụ.
- 
`tools
` — chỉ dành cho công cụ, không có tính năng tự động tiêm. Đại lý phải gọi rõ ràng 
`Honcho_reasoning

, 
`Honcho_search

, v.v.

**Cài đặt cho mỗi chế độ thu hồi:**

| Cài đặt |

hybrid
` | 
`context
` | 
`tools
` |
|----------|----------|-------------|--------|
| 
`writeFrequency
` | xóa tin nhắn | xóa tin nhắn | xóa tin nhắn |
| 
`contextCadence
` | làm mới bối cảnh cơ sở cổng | làm mới bối cảnh cơ sở cổng | không liên quan — không tiêm |
| 
`dialecticCadence
` | cổng gọi LLM tự động | cổng gọi LLM tự động | không liên quan — gọi mô hình một cách rõ ràng |
| 
`dialecticDepth
` | nhiều lượt cho mỗi lần gọi | nhiều lượt cho mỗi lần gọi | không liên quan — gọi mô hình một cách rõ ràng |
| 
`contextTokens
` | mũ tiêm | mũ tiêm | không liên quan — không tiêm |
| 
`dialecticDynamic
` | ghi đè mô hình cổng | Không áp dụng (không có công cụ) | ghi đè mô hình cổng |

Ở chế độ 
`tools

, mô hình có toàn quyền kiểm soát — nó gọi 
`Honcho_reasoning
` khi nó muốn, ở bất kỳ 
`reasoning_level
` nào nó chọn. Cài đặt nhịp và ngân sách chỉ áp dụng cho các chế độ có tính năng tự động chèn (
`hybrid
` và 
`context

).

## Quan sát (Định hướng và Thống nhất)

Honcho mô hình hóa cuộc trò chuyện khi các đồng nghiệp trao đổi tin nhắn. Mỗi máy ngang hàng có hai nút chuyển đổi quan sát ánh xạ 1:1 tới 
`SessionPeerConfig
` của Honcho:

| Chuyển đổi | Hiệu ứng |
|--------|--------|
| 
`observeMe
` | Honcho xây dựng hình ảnh đại diện của thiết bị ngang hàng này từ các thông điệp của chính nó |
| 
`observeOthers
` | Thiết bị ngang hàng này quan sát tin nhắn của thiết bị ngang hàng khác (cung cấp lý luận giữa các thiết bị ngang hàng) |

Hai đồng nghiệp × hai nút bật tắt = bốn cờ. 
`observationMode
` là cài đặt trước tốc ký:

| Đặt trước | Cờ người dùng | Cờ AI | Ngữ nghĩa |
|--------|----------|----------|----------|
| 

"directional"
` (mặc định) | tôi: bật, người khác: bật | tôi: bật, người khác: bật | Quan sát lẫn nhau đầy đủ. Cho phép biện chứng ngang hàng - "AI biết gì về người dùng, dựa trên những gì người dùng nói và AI trả lời." |
| 

"unified"
` | tôi: bật, người khác: tắt | tôi: tắt, người khác: bật | Ngữ nghĩa của nhóm chia sẻ - AI chỉ quan sát tin nhắn của người dùng, người dùng chỉ tự mô hình hóa. Nhóm người quan sát đơn. |

Ghi đè giá trị đặt trước bằng khối 
`observation
` rõ ràng để kiểm soát từng thiết bị ngang hàng:

``` json
"observation": {
  "user": { "observeMe": true,  "observeOthers": true },
  "ai":   { "observeMe": true,  "observeOthers": false }
}

`
``Các mẫu phổ biến:

| Ý định | Cấu hình |
|--------|--------|
| Quan sát đầy đủ (hầu hết người dùng) |

"observationMode": "directional"
` |
| AI không nên mô hình lại người dùng từ các câu trả lời của chính nó |

"ai": \{"observeMe": true, "observeOthers": false}
` |
| Tính cách mạnh mẽ mà đồng nghiệp AI không nên cập nhật từ việc tự quan sát |

"ai": \{"observeMe": false, "observeOthers": true}
` |

Các nút bật tắt phía máy chủ được thiết lập thông qua [Honcho dashboard](https://app.Honcho.dev) sẽ vượt qua các giá trị mặc định cục bộ — Hermes đồng bộ hóa chúng trở lại vào lúc bắt đầu phiên.

## Công cụ

Khi Honcho hoạt động với tư cách là nhà cung cấp bộ nhớ, sẽ có năm công cụ:

| Công cụ | Mục đích |
|------|----------|
| 
`Honcho_profile
` | Đọc hoặc cập nhật thẻ ngang hàng — chuyển 
`card
` (danh sách dữ kiện) để cập nhật, bỏ qua để đọc |
| 
`Honcho_search
` | Tìm kiếm ngữ nghĩa theo ngữ cảnh - trích đoạn thô, không tổng hợp LLM |
| 
`Honcho_context
` | Bối cảnh phiên đầy đủ — tóm tắt, trình bày, thẻ, tin nhắn gần đây |
| 
`Honcho_reasoning
` | Câu trả lời tổng hợp từ LLM của Honcho — vượt qua 
`reasoning_level
` (tối thiểu/thấp/trung bình/cao/tối đa) để kiểm soát độ sâu |
| 
`Honcho_conclude
` | Tạo hoặc xóa kết luận - chuyển 
`conclusion
` để tạo, 
`delete_id
` để xóa (chỉ PII) |

## Lệnh CLI

Lệnh phụ 
`Hermes Honcho
` **chỉ được đăng ký khi Honcho là nhà cung cấp bộ nhớ hoạt động** (
`memory.provider: Honcho
` trong 
`config.yaml

). Chạy 
`Hermes memory setup
` và chọn Honcho trước; lệnh con xuất hiện trong lệnh gọi tiếp theo.

`bash
Hermes Honcho status          # Connection status, config, and key settings
Hermes Honcho setup           # Redirects to 
`Hermes memory setup

Hermes Honcho strategy        # Show or set session strategy (per-session/per-directory/per-repo/global)
Hermes Honcho peer            # Show or update peer names + dialectic reasoning level
Hermes Honcho mode            # Show or set recall mode (hybrid/context/tools)
Hermes Honcho tokens          # Show or set token budget for context and dialectic
Hermes Honcho identity        # Seed or show the AI peer's Honcho identity
Hermes Honcho sync            # Sync Honcho config to all existing profiles
Hermes Honcho peers           # Show peer identities across all profiles
Hermes Honcho sessions        # List known Honcho session mappings
Hermes Honcho map             # Map current directory to a Honcho session name
Hermes Honcho enable          # Enable Honcho for the active profile
Hermes Honcho disable         # Disable Honcho for the active profile
Hermes Honcho migrate         # Step-by-step migration guide from OpenClaw-Honcho

`

## Di chuyển từ 
`Hermes Honcho
``Nếu trước đây bạn đã sử dụng 
`Hermes Honcho setup
` độc lập:
1. Cấu hình hiện tại của bạn (
`Honcho.JSON
` hoặc 

~/.Honcho/config.JSON

) được giữ nguyên

2. Dữ liệu phía máy chủ của bạn (ký ức, kết luận, hồ sơ người dùng) vẫn nguyên vẹn
3. Đặt 
`memory.provider: Honcho
` trong config.yaml để kích hoạt lại

Không cần đăng nhập lại hoặc thiết lập lại. Chạy 
`Hermes memory setup
` và chọn "Honcho" — trình hướng dẫn sẽ phát hiện cấu hình hiện có của bạn.

## Tài liệu đầy đủ

Xem [Memory Providers — Honcho](./memory-providers.md#Honcho) để tham khảo đầy đủ.