Dùng chung giữa các tài khoản

Mỗi tài khoản có thư mục riêng, nhưng phần lớn nội dung trong đó không cần tách riêng. ccam share bật hoặc tắt dùng chung cho một tài khoản và một mục mỗi lần: tệp hoặc thư mục của tài khoản được chuyển vào một thư mục nhóm và được thay bằng một liên kết tượng trưng, nên mọi tài khoản trong nhóm đọc và ghi cùng một bản. Hãy dùng nó sau ccam add để thay đổi những gì một tài khoản dùng chung, hoặc để đưa một vài tài khoản vào một nhóm riêng.

Cách dùng

ccam share work                       # show what work shares, and with which group
ccam share work --history on          # share conversation history with the default group
ccam share side --history team        # share it with the group team instead
ccam share work --settings off        # give work its own copy of settings.json again
ccam share work --memory off --fresh  # stop sharing CLAUDE.md and start with no file
ccam share work --settings on --yes --prefer merge   # no questions; merge JSON on conflicts
ccam --dry-run share work --history on               # print the plan, change nothing

Không có tùy chọn chọn mục, ccam share in ra trạng thái hiện tại:

$ ccam share work
Sharing for work
  MCP servers                        shared (group default)  --mcp
  settings.json                      shared (group default)  --settings
  global CLAUDE.md                   shared (group default)  --memory
  agents, commands, skills, plugins  shared (group default)  --extensions
  conversation history               local                   --history

Khi có tùy chọn, ccam in ra một kế hoạch, hỏi về từng tệp khác với bản của nhóm, và hỏi Proceed? [y/N] trước khi thay đổi bất cứ thứ gì. Tài khoản mới dùng chung mọi thứ trừ lịch sử hội thoại; Dùng chung máy chủ MCP, cài đặt và lịch sử mô tả từng mục từ góc nhìn người dùng.

Tùy chọn

Giá trị on nghĩa là nhóm default, off nghĩa là riêng (không dùng chung), và mọi giá trị khác là tên nhóm. Tên nhóm trở thành tên thư mục trong ~/.local/share/ccam/groups/, nên ccam share side --history ../x thất bại với invalid group name: "../x". Tài khoản được chỉ định bằng tên hoặc số, và chỉ những mục bạn nêu mới thay đổi.

Cách hoạt động

Các tệp liên quan:

• ~/.config/ccam/config.toml: bảng [profile.share] của từng tài khoản, mỗi mục một giá trị.
• ~/.local/share/ccam/profiles/<name>/: CLAUDE_CONFIG_DIR của tài khoản.
• ~/.local/share/ccam/groups/<group>/: các bản dùng chung.

1. internal/cli/share.go đọc cấu hình, áp dụng từng giá trị --<item> lên một bản sao thiết lập của tài khoản bằng config.Share.Set, và từ chối nếu tài khoản đang chạy.
2. share.Build so sánh thiết lập hiện tại với thiết lập đích và liệt kê các bước. Nó chỉ đọc đĩa: os.Lstat và os.Readlink cho mọi đường dẫn trong share.Layout. Kế hoạch là một danh sách thao tác: chuyển vào một vị trí còn trống trong nhóm (adopt), chuyển các tệp nhóm còn thiếu (merge dir), ghi một xung đột đã giải quyết vào nhóm, sao lưu, gỡ liên kết, liên kết, sao chép trở lại, ghi lại đường dẫn plugin và gộp tệp đăng ký plugin.
3. Các xung đột được quyết định, qua câu hỏi hoặc qua --prefer.
4. Plan.Describe in ra kế hoạch, và ccam hỏi.
5. Thiết lập đích được ghi vào config.toml trước khi bất cứ thứ gì được di chuyển. Nếu Plan.Apply dừng giữa chừng, ccam doctor --fix và một lần chạy lại sẽ dựng kế hoạch hướng tới đích đã lưu và hoàn tất thay đổi.
6. Plan.Apply chạy các bước theo thứ tự. Mọi bước đều chuyển dữ liệu vào nhóm hoặc vào thư mục sao lưu; không có gì bị xóa.

share.Layout là một danh sách cho phép gồm các đường dẫn mà mỗi mục bao gồm. Bất cứ thứ gì không có trong đó đều không bao giờ đến được nhóm. share.Never nêu tên .credentials.json và .claude.json, và Build dừng với lỗi nội bộ nếu một trong hai xuất hiện trong cấu trúc. Mục mcp không có đường dẫn: danh sách máy chủ nằm bên trong .claude.json, nên dùng chung MCP hoạt động qua mcp.json của nhóm thay vào đó, và --mcp chỉ thay đổi thiết lập.

Đây là điều xảy ra với một thư mục, projects/, khi side bật dùng chung lịch sử và nhóm đã có nội dung:

Nếu nhóm chưa có gì ở đường dẫn đó, tài khoản là tài khoản đầu tiên dùng chung nó và thư mục của nó được chuyển nguyên vào đó, không sao lưu. Ngược lại, mergeDir chuyển từng tệp nhóm còn thiếu vào nhóm, còn các tệp có ở cả hai phía vẫn nằm trong thư mục của tài khoản, nên phiên bản của nhóm được giữ. Sau đó thư mục của tài khoản được chuyển vào .ccam-backup/<time>/ bên trong thư mục tài khoản, và os.Symlink đặt một liên kết vào chỗ của nó. Các tệp hội thoại được đặt tên theo ID phiên, nên lịch sử từ nhiều tài khoản được gộp lại mà không xung đột.

Việc di chuyển dùng rename(2) và quay về sao chép rồi xóa khi đi qua các hệ thống tệp khác nhau. Một liên kết tương đối bên trong cây được di chuyển mà trỏ ra ngoài cây sẽ được ghi lại thành liên kết tuyệt đối (fsutil.PortableLink), để nó vẫn trỏ đúng từ vị trí mới. Các tệp đăng ký trong plugins/ (installed_plugins.json, known_marketplaces.json) lưu đường dẫn tuyệt đối đi qua thư mục tài khoản; ccam trỏ chúng tới thư mục của nhóm và, khi nhóm đã có tệp đăng ký, gộp các mục của tài khoản vào đó.

Tắt một mục sẽ đảo ngược liên kết:

ccam chỉ gỡ liên kết nếu nó trỏ vào thư mục groups, rồi sao chép nội dung hiện tại của nhóm vào tài khoản bằng CopyTree. Với --fresh, bước sao chép bị bỏ qua và tài khoản bắt đầu với không có gì ở đường dẫn đó. Nhóm vẫn giữ nội dung của nó cho các tài khoản khác. Chuyển một mục từ nhóm này sang nhóm khác sẽ gỡ liên kết rồi liên kết nó tới nhóm mới, giữ nguyên nhóm cũ; kế hoạch ghi điều này trong một dòng Note:.

Một tệp đơn lẻ có ở cả hai phía với nội dung khác nhau là một xung đột:

share.NewConflict liệt kê các lựa chọn phù hợp với tệp. history.jsonl có merge by line, keep group và use mine, với gộp đứng đầu. Các tệp .json khác có keep group, use mine và merge JSON. Mọi tệp khác có keep group và use mine. Lựa chọn đầu tiên là mặc định:

history.jsonl differs from the group's copy.
  mine:  ~/.local/share/ccam/profiles/side/history.jsonl
  group: ~/.local/share/ccam/groups/default/history.jsonl
  1) merge by line
  2) keep group
  3) use mine
Choice [1]:

merge JSON (MergeJSONBytes) gộp các đối tượng một cách đệ quy, nối các mảng mà không trùng lặp, và giữ giá trị của nhóm khi hai phía đặt cùng một khóa khác nhau, nên các tài khoản khác không thấy thay đổi gì về hành vi. merge by line giữ các dòng của nhóm, rồi thêm các dòng của bạn mà nhóm còn thiếu. Mọi lựa chọn trừ keep group trước tiên lưu bản của nhóm vào .ccam-backup/<time>/group/ trong thư mục tài khoản, rồi ghi kết quả bằng fsutil.AtomicWrite. Tệp của riêng bạn luôn được đưa vào bản sao lưu.

--prefer group, mine hoặc merge quyết định mọi xung đột mà không hỏi; merge nghĩa là merge JSON hoặc merge by line, tùy tệp có lựa chọn nào, và tệp không có lựa chọn nào trong hai thì giữ mặc định. Chỉ --yes thì lấy mặc định của từng tệp.

Ở mỗi lần khởi động, share.Check so sánh từng đường dẫn trong cấu trúc với thiết lập, chỉ dùng lstat và readlink, nhờ đó đủ nhẹ cho đường khởi động. Liên kết còn thiếu được tạo ngay lập tức, vì không có gì để mất. Một tệp thật ở nơi lẽ ra là liên kết, một liên kết trỏ sai chỗ, hoặc một liên kết lỗi thời sẽ dừng việc khởi động:

ccam: stopped because of share link problems:
  ~/.local/share/ccam/profiles/work/CLAUDE.md: set to shared but is a real file, not a link
Repair them with `ccam doctor --fix`, then run again

ccam doctor --fix chạy share.Build với thiết lập đã lưu ở cả hai phía, suy ra mọi bước từ những gì có trên đĩa, giữ nội dung của nhóm khi xung đột và sao lưu mọi thứ nó thay thế.

An toàn và các trường hợp đặc biệt

• Tài khoản đang chạy. ccam từ chối thay đổi việc dùng chung khi Claude Code đang chạy bằng tài khoản đó (account work is running; quit it first, then change its sharing), vì phiên vẫn tiếp tục ghi vào các tệp đang được di chuyển và các dòng nó ghi thêm trong lúc đó sẽ bị mất. --dry-run vẫn in ra kế hoạch.
• Bản sao lưu. Mỗi kế hoạch có thư mục .ccam-backup/<time>/ riêng trong thư mục tài khoản, với hậu tố đánh số khi hai kế hoạch bắt đầu trong cùng một giây. ccam không bao giờ xóa chúng.
• Thất bại giữa chừng. Nếu một bước thất bại, ccam in ra lỗi và nơi chứa các bản gốc, và nhắc bạn hoàn tất bằng ccam doctor --fix. Đích đã được lưu, nên việc sửa tiếp tục hướng tới đích đó.
• Liên kết của riêng bạn. Nếu một đường dẫn đã là liên kết do bạn tạo, chẳng hạn tới một kho dotfiles, và nhóm còn trống, ccam sao chép đích của liên kết vào nhóm và chuyển chính liên kết vào bản sao lưu. Đích không bị động đến.
• Tệp đăng nhập. .credentials.json và .claude.json không bao giờ được liên kết, di chuyển hay sao chép vào nhóm.
• Hai tài khoản trong một thư mục. Các tài khoản dùng chung lịch sử ghi vào cùng các tệp. Khi một tài khoản thứ hai của cùng nhóm lịch sử khởi động trong một thư mục nơi đã có một tài khoản đang chạy, ccam cảnh báo và hỏi trước khi tiếp tục.

Liên quan

• Dùng chung máy chủ MCP, cài đặt và lịch sử
• Máy chủ MCP dùng chung
• Sao chép thiết lập hiện có
• Tất cả các lệnh