AOCI-CODE

AOCI-CODE

Một bản đồ liên tục, được quản lý phiên bản bằng Git, về toàn bộ cơ sở mã của bạn — do tác nhân lập trình của bạn viết, được điều hành bởi một máy chủ MCP cục bộ. Tác nhân chỉ cần đọc nó một lần là hiểu hệ thống, thay vì đọc lại kho mã ở mỗi tác vụ.

🇺🇸 English | 🇨🇳 简体中文

Nó làm gì

Xây dựng các hệ thống lớn mà không bị mất mạch. Trong Codex, Claude Code, Cursor, OpenCode và các tác nhân tương tự, tác nhân của bạn bắt đầu mỗi tác vụ khi đã biết toàn bộ hệ thống: mỗi tệp dùng để làm gì, nó phụ thuộc vào đâu, và điều gì không được phép hỏng. Nó ngừng việc tìm kiếm và đọc lại cơ sở mã cho mỗi yêu cầu. Những người không phải lập trình viên chuyên nghiệp có thể tiếp tục cải tiến hệ thống của riêng mình; lập trình viên chuyên nghiệp có thể giao toàn bộ hệ thống cho một tác nhân và giữ sự tập trung vào kiến trúc và thiết kế.

Tiếp quản một hệ thống đang có chỉ trong một bước. Chỉ tác nhân vào một cơ sở mã hiện hữu lên tới khoảng 500.000 dòng và yêu cầu nó xây dựng chỉ mục. Nó báo cáo mức độ hiểu biết của mình về từng khu vực, rồi tiếp tục phát triển từ đó. Giới hạn thực tế là kích thước của chỉ mục, không phải số dòng: một hệ thống thương mại 700.000 dòng hiện đang được phát triển theo cách này, với chỉ mục khoảng 300K token.

Thay đổi người, tác nhân hoặc cuộc hội thoại mà không phải bắt đầu lại. Chỉ mục nằm trong kho mã, cạnh mã nguồn, và được Git quản lý phiên bản. Khi một dự án đổi chủ, chuyển sang tác nhân khác, hoặc mở một cuộc hội thoại mới, chỉ cần đọc một lần chỉ mục là tiếp tục được từ chỗ đã dừng.

Sau chỉ mục đầu tiên, việc bảo trì diễn ra tự động. Máy chủ MCP phát hiện các thay đổi mã và phát ra những mục cần cập nhật. Tác nhân điền chúng vào khi hoàn thành mỗi tác vụ, nhờ đó chỉ mục luôn khớp với mã hiện tại và bạn không bao giờ phải dừng lại để bảo trì nó.

Nó trông như thế nào

Mỗi tệp một dòng, do mô hình viết từ mã nguồn thực tế. Đây là một mục thực tế từ chính chỉ mục của kho mã này:

atomic.go[CG9L]: F:Provides durable replace CAS, create CAS, atomic writes, and no-clobber recovery moves | R:code:internal/fs/atomic_exchange_linux.go,code:internal/fs/atomic_exchange_windows.go,code:internal/fs/lock.go | A:AtomicWrite,AtomicWriteCAS,AtomicCreateCAS,AtomicMoveCAS | S:Native publication never degrades to an overwriting rename; on a race, unsafe type, or unverifiable bytes, preserve third-party state

F là trách nhiệm của tệp, R là những gì bạn phải đọc cùng với nó, A là những gì bên gọi phụ thuộc vào, và S là những gì bạn không thể suy ra từ mã nhưng không được làm sai. Thẻ [CG9L] định vị tệp theo tầng, miền, mức quan trọng và kích thước. Vài trăm dòng như thế này bao quát cả một hệ thống, và tác nhân có thể đọc hết trong một lượt. Định dạng mục giải thích từng trường.

Điều này khác gì CodeGraph?

• CodeGraph phân tích mã của bạn thành một đồ thị các ký hiệu và lời gọi. Khi tác nhân đặt câu hỏi, nó trả về mã nguồn chính xác và các đường gọi. Đó là một công cụ tra cứu chính xác cho tác vụ trước mắt.
• AOCI-CODE để mô hình viết một dòng cho mỗi tệp và mỗi bảng: nó dùng để làm gì, nó kết nối với đâu, và điều gì không được phép hỏng. Tác nhân đọc toàn bộ chỉ mục trước, nên nó hiểu hệ thống trước khi tác vụ bắt đầu. Chỉ mục nằm trong Git và được giữ đồng bộ với mã.
• Dùng cả hai: chỉ mục để hiểu hệ thống, CodeGraph để lấy mã chính xác trong khi làm việc.

So sánh đầy đủ cũng bao gồm RAG, LSP và repo map.

Những gì cần lường trước

Chỉ mục đầu tiên mất một khoảng thời gian. Tác nhân đọc mọi tệp được quản lý và viết một mục cho mỗi tệp: khoảng một giờ cho mỗi 200.000 dòng mã, tùy thuộc vào mô hình và tốc độ của tác nhân. Nó chạy theo lô và tiếp tục từ chỗ đã dừng nếu bị gián đoạn.

Có cơ sở dữ liệu? Hãy lập chỉ mục cho nó luôn. MySQL và PostgreSQL được hỗ trợ, cùng với openGauss 6.0.5 có ràng buộc. MySQL nghĩa là 5.7.6 trở lên; MariaDB không được hỗ trợ. Hãy xây dựng chỉ mục mã trước, rồi đến chỉ mục cơ sở dữ liệu. Khi kiến thức về mã và về bảng được cung cấp cùng nhau, tác nhân hiểu hệ thống một cách đầy đủ hơn.

Chỉ cục bộ: chỉ đọc trên hệ thống của bạn, không Internet, không lưu thông tin xác thực. AOCI-CODE đọc mã nguồn và cấu trúc bảng cơ sở dữ liệu của bạn, không bao giờ đọc dữ liệu nghiệp vụ. Nó ghi các tệp chỉ mục và trạng thái riêng của nó bên trong thư mục dự án, cùng với việc đăng ký trang trạng thái trong thư mục bộ nhớ đệm người dùng của bạn. Nó không bao giờ truy cập Internet và không tải lên bất cứ thứ gì: các kết nối duy nhất nó mở là tới cơ sở dữ liệu bạn khai báo, để lấy siêu dữ liệu danh mục, và tới trang trạng thái loopback của chính nó. Thông tin xác thực cơ sở dữ liệu được tham chiếu bằng tên biến môi trường và không bao giờ được lưu trữ. Văn bản chỉ mục được chính tác nhân của bạn viết cục bộ thông qua kênh mô hình mà bạn đã dùng; AOCI-CODE không thêm bất kỳ lối thoát dữ liệu mới nào.

Bắt đầu nhanh

Hãy đưa cho tác nhân của bạn chỉ dẫn sau để tải AOCI-CODE và kết nối nó. Sau khi khởi động lại tác nhân, hãy gửi chỉ dẫn thứ hai để xây dựng chỉ mục.

AOCI-CODE project: https://github.com/aoci-spec/aoci-code

Download the latest release package for this operating system and CPU architecture from
https://github.com/aoci-spec/aoci-code/releases, and follow the installation instructions
on the Release page to verify it. If no compatible release package exists, or if I
explicitly request the latest source, build it from the official repository.

After extracting the package, place aoci (aoci.exe on Windows) at a stable absolute path.
Then use that absolute path to do the following for my project:

1. Run init to initialize AOCI and integrate MCP for the current host; if this host does
   not write project configuration (Cursor, for example), give me the configuration I
   need to paste myself
2. Run scan

   scan takes its file inventory from Git, so do not add the cognition assets
   init writes (aoci.txt, aoci.meta.txt, aoci.code.txt, AGENTS.md) to .gitignore
   or .git/info/exclude — an ignored asset is silently skipped and the index
   cannot be built. Leave the host-config ignore init writes for itself as it is.

3. Tell me to restart the agent so the newly written MCP server takes effect

Stop after those three steps and do not build the index yet — I will tell you to continue
after the restart.

Sau khi khởi động lại tác nhân, hãy gửi chỉ dẫn này:

First confirm the AOCI MCP server is connected, then build the AOCI index for this project. When it is complete, give me the AOCI panel link.

Tác nhân khởi động bảng điều khiển ở chế độ nền bằng aoci ui --detach --json và gửi cho bạn liên kết. Bảng điều khiển AOCI mô tả những gì nó hiển thị và các lệnh khác của nó.

Lý do cần khởi động lại: chỉ mục được ghi thông qua các công cụ MCP của AOCI, và phiên đã chạy init chưa tải máy chủ MCP mà init vừa ghi. Một máy chủ tải các máy chủ MCP một cách linh động có thể không cần khởi động lại; Tích hợp máy chủ giải thích cách nhận biết.

Nếu dự án của bạn có cơ sở dữ liệu (PostgreSQL và MySQL được hỗ trợ, cùng với openGauss 6.0.5 có ràng buộc), hãy lập chỉ mục cho nó luôn. Khai báo nguồn như mô tả trong Nhận thức cơ sở dữ liệu, cung cấp biến môi trường chuỗi kết nối trong môi trường máy chủ (AOCI không lưu thông tin xác thực), rồi gửi:

Build the AOCI database index for this project.

Nếu ngữ cảnh đã bị nén, hoặc bạn muốn tác nhân xây dựng lại hình ảnh của nó về hệ thống, hãy gửi:

Using only AOCI, establish whole-framework cognition of this project, tell me your mastery of each area as a percentage, and whether you can take over development.

Cách nó hoạt động

AOCI (AI-Oriented Cognition Infrastructure) là phương pháp và giao thức: một lớp giữa các tác nhân lập trình và các hệ thống phần mềm. Mô hình suy luận, tác nhân lập kế hoạch và thực thi, còn AOCI duy trì một mô tả cập nhật về hệ thống, bao gồm mã, cấu hình, kiểm thử và cấu trúc cơ sở dữ liệu, để tác nhân đọc trước khi hành động. AOCI-CODE là dự án này: CLI aoci, máy chủ MCP, và chỉ mục mà chúng duy trì.

AOCI-CODE chưng cất những gì thực sự quan trọng để hiểu và thay đổi một hệ thống thành một chỉ mục văn bản thuần dày đặc, kết hợp các ký hiệu và ý nghĩa. Khi ngữ cảnh của mô hình bị giới hạn, tác nhân đọc chỉ mục trước, nắm được phần lớn thông tin then chốt của dự án trong một lượt, rồi mới bắt đầu tác vụ. Điều đó cắt giảm việc tìm kiếm và học lại lặp đi lặp lại, và nó mang sự hiểu biết xuyên suốt các tác vụ và phiên làm việc.

• Không phải một bản tóm tắt một lần. Chỉ mục tiến hóa cùng hệ thống và nằm lại trong dự án, nơi bạn có thể diff, xem xét, quản lý phiên bản và khôi phục bằng Git.
• Không chỉ là "các tệp nằm ở đâu." Nó ghi lại trách nhiệm, các mối quan hệ mạnh, hợp đồng công khai, ranh giới giao dịch, các ràng buộc tương thích, và những thứ khác khó suy ra từ cấu trúc mã.
• Có thể di chuyển. Chỉ mục được lưu cùng dự án, không gắn với một mô hình, một tác nhân hay một phiên làm việc. Khi nó còn khớp với mã, bất kỳ tác nhân nào và bất kỳ phiên nào sau này đều có thể dùng lại mà không phải xây dựng lại sự hiểu biết từ đầu.
• Mã và cơ sở dữ liệu cùng nhau. Mô hình có thể xây dựng một chỉ mục riêng ở mức bảng cho các bảng cơ sở dữ liệu. Khi được cung cấp cùng nhau, cả hai cho tác nhân một bức tranh đầy đủ hơn về hệ thống.

Chỉ mục là một tập các tệp văn bản thuần được quản trị, lưu cùng dự án:

• Root (aoci.txt) khai báo những gì tạo nên chỉ mục hiện tại và là điểm vào kích hoạt của nó.
• Meta (aoci.meta.txt) chứa từ điển thẻ, các quy tắc FRAS, và các ràng buộc soạn thảo.
• Code (aoci.code.txt) chứa các mục do mô hình soạn cho mã và các tài sản khác của kho mã.
• Database (aoci.database.txt) chứa các mục tùy chọn ở mức bảng khi Nhận thức cơ sở dữ liệu được bật.

Root, Meta và các Volume đối tượng tham gia cùng nhau tạo thành Whole-Index. Quy trình làm việc trên chúng có ba giai đoạn:

1. Xây dựng chỉ mục dưới sự quản trị. Mô hình đọc mã nguồn và bằng chứng được chấp nhận. AOCI-CODE quản trị Managed Scope và các mục mà mô hình viết cho mọi đối tượng được quản lý với vai trò index.
2. Đọc trước khi hành động. Tác nhân đọc các quy tắc dự án, hướng dẫn trực tiếp, và Whole-Index hiện tại, rồi kiểm tra mã nguồn và bằng chứng khác cho tác vụ trước mắt.
3. Bảo trì sau thay đổi đã được xác minh. Khi mã và kiểm thử đã ổn định, các quy tắc dự án và quy trình MCP yêu cầu tác nhân cập nhật các mục bị ảnh hưởng và đưa chỉ mục trở lại trạng thái aligned.

Vì các tệp này là văn bản thuần trong kho mã, Git quản lý phiên bản chúng. Khi chỉ mục còn khớp với phiên bản hệ thống hiện tại, bất kỳ tác nhân nào và bất kỳ phiên nào sau này đều có thể đọc và dùng lại cùng một Whole-Index.

Tích hợp thủ công

Lấy AOCI-CODE từ nguồn chính thức hoặc dùng một gói đã ký từ GitHub Releases. Trước khi dùng một tệp nhị phân dựng sẵn, hãy làm theo mức xác minh cơ bản, khuyến nghị hoặc đầy đủ trong hướng dẫn cài đặt, và báo cáo mức nào đã hoàn thành. Hãy đưa README này và đường dẫn tuyệt đối ổn định của tệp nhị phân đã xác minh cho một tác nhân lập trình mà bạn tin tưởng, chẳng hạn Codex, Claude Code, Cursor hoặc OpenCode. Tác nhân có thể làm theo các hướng dẫn trong dự án để khởi tạo AOCI, tích hợp MCP và xây dựng chỉ mục đầu tiên.

Thời gian cho chỉ mục đầu tiên phụ thuộc vào kích thước kho mã. Một lần tích hợp bình thường gồm bốn bước: chuẩn bị tệp nhị phân, để tác nhân hoặc chính bạn khởi tạo kho mã đích, yêu cầu máy chủ "xây dựng chỉ mục", và xác minh sự khớp. Sau đó bạn không cần kết thúc mỗi yêu cầu bằng "bảo trì chỉ mục." Các quy tắc dự án và quy trình MCP yêu cầu tác nhân bảo trì chỉ mục một cách tăng dần mỗi khi các đối tượng được quản lý thay đổi.

Yêu cầu

• Một gói phát hành đã xác minh hoặc một bản checkout của kho mã nguồn chính thức AOCI-CODE.
• Chỉ dành cho bản dựng từ mã nguồn: bộ công cụ Go được khai báo bởi go.mod, make, và các công cụ khác mà kho mã yêu cầu.
• Một máy chủ MCP được hỗ trợ, chẳng hạn Codex, Claude Code, Cursor hoặc OpenCode.
• Quyền đọc và ghi thông thường đối với kho mã đích.

AOCI-CODE tích hợp với máy chủ MCP, không phải với API của nhà cung cấp mô hình. DeepSeek và các mô hình khác có thể dùng AOCI-CODE khi tác nhân hoặc máy chủ chạy chúng hỗ trợ MCP stdio chuẩn và có thể tuân theo hợp đồng công cụ; chỉ tên mô hình thì không đủ để xác lập tính tương thích.

Cách dùng gói đã ký và các lệnh xác minh tệp thực thi nằm trong hướng dẫn cài đặt. Cách dựng từ mã nguồn ở bên dưới.

RC hiện tại: dùng gói đã xác minh hoặc dựng từ mã nguồn

[!IMPORTANT] AOCI-CODE v0.1.0-rc22 là bản ứng viên phát hành hiện tại. Đây là phần mềm Fair Source/source-available theo FSL-1.1-MIT; xem LICENSE. Hãy dựng từ nguồn chính thức hoặc dùng một gói đã ký từ GitHub Release v0.1.0-rc22 sau khi làm theo quy trình xác minh bản phát hành.

Tệp nhị phân Release đã ký tự nhận diện là aoci version 0.1.0-rc22. Một bản dựng từ mã nguồn thay vào đó nhận diện chính xác bản checkout và có thể báo cáo một phiên bản phát triển như v0.1.0-rc22-1-g<short-commit> (cộng với -dirty khi áp dụng), cùng với commit Git của nó. Đây là các đầu vào dựng khác nhau, không phải một xung đột phiên bản.

Để tải bằng GitHub CLI, hãy xác thực trước, rồi tải các tài sản Release được gắn thẻ:

gh auth login
gh release download v0.1.0-rc22 --repo aoci-spec/aoci-code

Để tải ẩn danh, hãy mở trang Release v0.1.0-rc22 trong trình duyệt và tải các tài sản lưu trữ và xác minh mà bạn cần.

Để dựng từ mã nguồn, hãy clone kho mã chính thức, dựng tệp nhị phân, và giữ đường dẫn kết quả ổn định:

git clone https://github.com/aoci-spec/aoci-code.git
cd aoci-code
mkdir -p build
make build
./build/aoci --version

Trên Windows, hãy dựng cùng mã nguồn đó trong PowerShell:

git clone https://github.com/aoci-spec/aoci-code.git
Set-Location .\aoci-code
New-Item -ItemType Directory -Force .\build | Out-Null
make build
.\build\aoci.exe --version

Sau đó đưa README này cho một tác nhân mà bạn đã tin tưởng với dự án và yêu cầu:

Read this AOCI-CODE README and use the built aoci binary at its stable absolute path
to initialize AOCI for the current project, integrate MCP, and run scan. Stop there and
tell me to restart the agent; I will ask you to build the index afterwards.

Tác nhân nên xác định thư mục gốc của dự án, dùng một đường dẫn tuyệt đối ổn định trỏ tới tệp nhị phân đã biên dịch, chạy quá trình khởi tạo phù hợp với máy chủ hiện tại, và cho bạn biết rõ ràng khi cần khởi động lại máy chủ hoặc cần sự phê duyệt thực sự của con người. Tệp nhị phân có thể nằm trong bản checkout AOCI-CODE hoặc được chuyển tới một thư mục công cụ dùng chung, miễn là cấu hình MCP trỏ tới đúng đường dẫn tuyệt đối.

Khởi tạo thủ công

Để tự khởi tạo AOCI, hãy chạy lệnh sau từ thư mục gốc của kho lưu trữ đích, hoặc truyền một đường dẫn tường minh qua --repo:

AOCI=/absolute/path/to/aoci-code/build/aoci
"$AOCI" --repo . init --locale en-US --agent codex
"$AOCI" --repo . scan

init ghi cấu hình locale, khối quy tắc AGENTS.md được quản lý, các ranh giới Git, và một khung chỉ mục rỗng. Cấu hình và cách nhắc nhở khác nhau tùy theo máy chủ; xem Tích hợp máy chủ. Nó không tự suy ra ý nghĩa nghiệp vụ từ tên tệp, thư mục hay AST.

Với một kho lưu trữ mới, lần scan đầu tiên thiết lập Baseline được quản lý. Với một dự án đã có Baseline được quản trị, việc thêm, bớt hoặc thay đổi phạm vi được quản lý phải đi qua quy trình Thay đổi Phạm vi chính thức; scan --force không phải là lối tắt để định nghĩa lại các sự kiện quản trị. --force cũng không thể xóa bỏ drift chưa được giải quyết, các biên nhận, hay các ranh giới phục hồi.

$Aoci = (Resolve-Path "C:\path\to\aoci-code\build\aoci.exe").Path
& $Aoci --repo . init --locale en-US --agent codex
& $Aoci --repo . scan

Để tác nhân xây dựng chỉ mục đầu tiên (quan trọng)

Sau khi quá trình khởi tạo và scan hoàn tất, hãy kiểm tra xem phiên tác nhân đã hiển thị các công cụ AOCI chưa; nếu chưa, hãy làm mới hoặc khởi động lại phiên. Sau đó nhập nội dung sau vào tác nhân cho dự án đích:

First confirm the AOCI MCP server is connected, then build the AOCI index for this project. When it is complete, give me the AOCI panel link.

Tác nhân khởi động bảng điều khiển ở chế độ nền bằng aoci ui --detach --json và gửi cho bạn liên kết. Bảng điều khiển AOCI mô tả những gì nó hiển thị và các lệnh khác của nó.

Máy chủ đọc các quy tắc AOCI và hướng dẫn trực tiếp của dự án, kiểm tra mã nguồn, kiểm thử, cấu hình và bằng chứng liên quan, rồi ghi các ứng viên FRAS cho mọi đối tượng được quản lý có vai trò là index. Bạn không cần tự điều phối Plan, Stage, Check, Diff, CAS hay Apply.

Khi chỉ mục đầu tiên hoàn tất, hãy gửi các yêu cầu phát triển thông thường như bình thường, ví dụ:

Add priorities to tasks, including the frontend, backend, database, and test changes.

Bạn không cần thêm câu "duy trì chỉ mục AOCI ở cuối." Các quy tắc dự án và MCP khiến tác nhân kiểm tra các thay đổi chỉ mục khi mã và kiểm thử đã ổn định, rồi cập nhật các mục bị ảnh hưởng thông qua quy trình chính thức. Khi dự án dùng automation.mode=auto, AOCI-CODE chỉ ngắt bạn khi cần sự phê duyệt thực sự của con người, cần thực hiện một hành động bên ngoài, không thể chứng minh việc phục hồi, một kiểm tra an toàn thất bại, hoặc phát hiện xung đột đồng thời từ bên thứ ba. Các chế độ tự động hóa khác tuân theo hợp đồng thời gian chạy riêng của chúng.

Xác minh tính nhất quán

Sau khi quá trình onboarding hoàn tất, hãy chạy:

"$AOCI" --repo . verify
"$AOCI" --repo . check

Chỉ mục và mã nguồn được quản lý hiện tại nên hội tụ trở lại về aligned. Nếu không, hãy tham khảo hướng dẫn trực tiếp trước; đừng sao chép máy trạng thái nội bộ vào một script bao ngoài:

"$AOCI" --repo . index agent guide --agent codex --json

Chạy chẩn đoán cơ bản

"$AOCI" --repo . capabilities
"$AOCI" --repo . doctor

Để xác nhận máy chủ thực sự đang kết nối tới AOCI nào, hãy đọc những gì máy chủ báo cáo về chính nó thay vì những gì có trên đĩa. Trong bất kỳ phản hồi aoci_overview check_only nào hoặc bất kỳ phản hồi aoci_maintain nào, cognition_receipt.mcp_service_version là phiên bản đang chạy và runtime_repository_root là kho lưu trữ mà nó quản trị. Đường dẫn tệp nhị phân tương ứng là command trong .mcp.json của dự án hoặc cấu hình máy chủ tương đương: .codex/config.toml, opencode.json, hoặc .cursor/mcp.json. Việc thay thế các byte trên đĩa không làm thay đổi một tiến trình MCP đang chạy, vì vậy hãy kiểm tra lại dựa trên những dữ kiện đó sau khi nâng cấp hoặc khôi phục.

Để có một hướng dẫn từng bước dùng một lần, hãy dùng examples/minimal-repository trong kho lưu trữ.

make fast

make full
./build/aoci --version

mkdir -p build
CGO_ENABLED=0 go build -o build/aoci ./cmd/aoci

Những gì xuất hiện sau khi khởi tạo

Một kho lưu trữ điển hình chứa các tệp chỉ mục sau:

aoci.txt                    Root: declares the current CognitionSet and participating Volumes
aoci.meta.txt               Meta: tag dictionary, FRAS rules, and authoring constraints
aoci.code.txt               Code: model-authored entries for code and repository assets
aoci.database.txt           Database: optional table-level entries; absent by default
.aoci/
├── config.json             Team policy, Locale, Scope, and budgets
├── baseline.json           Governed Baseline for source, index, and database bindings
├── curation.json           Optional file-level include/exclude decisions
└── ...                     Drafts, Ledger, transactions, and recovery evidence; normally not committed to Git

Khởi tạo một dự án mới sẽ tạo Root, Meta và một Code Volume rỗng; Database mặc định không có. AOCI-CODE không tự tạo ra ý nghĩa nghiệp vụ cho kho lưu trữ hay cơ sở dữ liệu.

aoci init --agent <name> còn ghi cấu hình tích hợp máy chủ (.mcp.json, .claude/settings.json, .codex/config.toml, hoặc opencode.json) mà đường dẫn lệnh và đường dẫn kho lưu trữ của nó là các đường dẫn tuyệt đối gắn với máy cụ thể. Hãy thêm những tệp đó vào .gitignore của kho lưu trữ và không commit chúng: một bản sao đã commit sẽ hỏng trên mọi máy khác, và vì các trình cài đặt phát hiện một mục đã tồn tại dựa trên sự hiện diện của khóa, việc chạy lại init ở đó sẽ âm thầm giữ lại các đường dẫn bị hỏng.

Cách một tác vụ phát triển diễn ra

Hai sơ đồ dưới đây mô tả quy trình theo cách bạn trải nghiệm, không phải cách triển khai nội bộ của AOCI.

Dự án mới: xây dựng một hệ thống đơn giản trước, rồi đưa AOCI vào

flowchart TD
    I["The user proposes a product idea and requirements"] --> S["Use the agent's existing capabilities to build a simple new system"]
    S --> Q["Integrate AOCI MCP"]
    Q --> V["The agent builds the Whole-Index and verifies aligned"]
    V --> N["The user continues with ordinary development requests"]
    N --> M["The agent completes code, tests, and incremental index maintenance"]
    M --> N

Một hệ thống mới không cần AOCI-CODE ngay từ dòng mã đầu tiên. Hãy xây dựng một nguyên mẫu bằng các khả năng sẵn có của tác nhân trước; khoảng 10.000–30.000 dòng là thời điểm tốt để đưa nó vào (không phải ngưỡng cứng). Các nhóm muốn có tính liên tục giữa các phiên sớm hơn có thể tích hợp sớm hơn.

Dự án hiện có: lập chỉ mục kho lưu trữ, rồi lặp lại

flowchart TD
    R["Existing repository, tests, configuration, and optional Schema"] --> B["Build AOCI-CODE from canonical source<br/>Request index generation"]
    B --> E["The agent inspects the existing system and writes the first index"]
    E --> V["Verify, Check, and Guide converge to aligned"]
    V --> T["The user submits an ordinary development task"]
    T --> C["The agent modifies code and runs quality checks"]
    C --> U["MCP guides the agent through index maintenance"]
    U --> G["The index and the current system return to aligned"]
    G --> T

Sau khi chỉ mục đầu tiên hoàn tất, cả hai luồng đều vận hành giống nhau trong công việc hằng ngày: bạn mô tả yêu cầu nghiệp vụ hoặc kỹ thuật; tác nhân kết hợp Whole-Index với bằng chứng hiện tại, thực hiện phát triển và xác minh, rồi cập nhật các đối tượng đã thay đổi thông qua MCP khi kết thúc tác vụ. Bạn không cần học các lệnh nội bộ Plan, Stage, Diff, CAS hay Baseline, cũng không cần lặp lại yêu cầu bảo trì trong mỗi lời nhắc.

Nếu một lô hoàn chỉnh bị từ chối trước khi bất kỳ ghi chính thức nào bắt đầu, chỉ mục không thay đổi. Nếu quy trình bị gián đoạn sau khi ghi chính thức bắt đầu, hệ thống giữ lại ý định bất biến, bằng chứng ghi, và trạng thái phục hồi, rồi hoặc tiếp tục từ một postimage có thể chứng minh được hoặc khôi phục về đúng preimage. Xung đột byte từ bên thứ ba sẽ thất bại theo hướng an toàn; AOCI-CODE không bao giờ ghi đè một sửa đổi bên ngoài để "hoàn tất việc ghi."

Trạng thái cuối cùng luôn là một trong applied, repair_required, hoặc stopped. stopped không phải là thành công, và nó không nhất thiết có nghĩa là không có gì được ghi; hãy kiểm tra failed_step, bằng chứng ghi chính thức, và hành động phục hồi mà hướng dẫn trả về.

Ai làm gì: mô hình và AOCI-CODE

Mô hình sở hữu ý nghĩa

Mô hình máy chủ đọc mã nguồn, kiểm thử, cấu hình, tài liệu và bất kỳ bằng chứng nào nó cần, rồi quyết định:

• một đối tượng thực sự chịu trách nhiệm về điều gì;
• những tệp, mô-đun hay đối tượng cơ sở dữ liệu nào là các mối quan hệ mạnh cần được xem xét để thay đổi nó một cách an toàn;
• những API, lệnh, định dạng hay hợp đồng có thể quan sát nào mà nó phơi bày;
• những ràng buộc về giao dịch, phân quyền, đồng thời, bộ nhớ đệm, triển khai, tương thích hay lịch sử nào không thể suy ra chỉ từ cấu trúc thông thường.

AOCI-CODE không lắp ghép FRAS từ tên tệp, đường dẫn, phần mở rộng, AST hay mẫu, và nó không âm thầm viết lại những gì mô hình đã viết.

AOCI-CODE sở hữu việc quản trị

AOCI-CODE chịu trách nhiệm về:

1. thiết lập Safe Inventory, Managed Scope và Baseline hiện tại;
2. cung cấp Whole-Index hiện tại và xác nhận danh tính của nó;
3. tạo một kế hoạch tất định, tập mục tiêu, và các giá trị SHA-256 của mã nguồn;
4. xác thực cấu trúc ứng viên, từ điển thẻ, danh tính quan hệ, phạm vi, quyền sở hữu, ngân sách, và phạm vi bị ảnh hưởng;
5. bảo toàn sự ràng buộc giữa nội dung kiểm tra, diff và đánh giá;
6. commit một lô hoàn chỉnh với khóa liên tiến trình, CAS và ghi nguyên tử;
7. nâng Baseline, ghi nối sổ cái, và bảo toàn bằng chứng phục hồi sau một lỗi sau khi ghi;
8. chứng minh lại trạng thái quản trị hiện tại thông qua Verify, Check và hướng dẫn;
9. suy ra các quan sát Lineage, Relations, Impact, Snapshot và Evolution từ các tài sản có thẩm quyền mà không tạo ra nguồn sự thật thứ hai.

Kết quả máy móc toàn xanh chỉ có nghĩa là các hợp đồng cấu trúc và quản trị đã được mã hóa đều thỏa mãn; chúng không có nghĩa là mọi phát biểu mà mô hình đã viết đều đúng.

Cách chỉ mục được tổ chức

Một chỉ mục AOCI có hai lớp: các quy tắc chỉ mục và các mục chỉ mục. Sản phẩm hỗ trợ hai bố cục vật lý, và chúng không phải là một định dạng tệp duy nhất.

Bố cục Volumes v1

Một dự án Volumes tách biệt các trách nhiệm:

• aoci.txt chỉ là Root. Nó khai báo các Volume tham gia vào CognitionSet hiện tại.
• aoci.meta.txt chứa Meta: từ điển thẻ, các quy tắc FRAS, ngân sách, và hợp đồng soạn thảo.
• aoci.code.txt chứa các mục cho đối tượng mã.
• aoci.database.txt chứa các mục cho đối tượng cơ sở dữ liệu khi Database Cognition được bật.

Code Volume và Database Volume chia sẻ cùng cấu trúc dòng FRAS, nhưng chúng có danh tính đối tượng, ràng buộc bằng chứng, quyền sở hữu và vòng đời độc lập. Root, Meta và các Volume đối tượng cùng nhau tạo thành Whole-Index; chỉ đọc aoci.txt Root là không đủ để tuyên bố rằng bạn đã đọc toàn bộ hệ thống.

Hãy nghĩ về nó như một bản đồ:

• Các quy tắc chỉ mục là chú giải và hệ tọa độ của bản đồ.
• Các mục chỉ mục là các điểm đánh dấu mô tả từng vị trí.
• Root là điểm vào danh mục và phiên bản cho tập bản đồ hiện tại.
• Một Volume là một tờ riêng được quản lý bởi cùng giao thức nhưng có nguồn bằng chứng và vòng đời riêng.

Phần đầu chỉ mục trông như thế nào

Root và Meta mỗi cái mở đầu bằng các dòng tiêu đề được máy đọc. Đây là những gì aoci init ghi cho một dự án en-US mới có tên my-service, bắt đầu với Root, là điểm vào kích hoạt:

#AOCI-ROOT-MANIFEST: 1
#Format-Version: cognition-volumes/v1
#Locale: en-US
#Project: my-service
#Global-Invariants: -
#Volume: id=meta kind=meta path=aoci.meta.txt format=meta-v1 depends=- state=enabled
#Volume: id=code kind=code path=aoci.code.txt format=object-fras-v2 depends=meta state=enabled

Mỗi dòng #Volume: khai báo một Volume tham gia với danh tính, loại, đường dẫn, định dạng, phụ thuộc và trạng thái kích hoạt của nó. Một Volume không được khai báo ở đây không thuộc CognitionSet hiện tại, bất kể cây làm việc còn chứa gì khác. Bật Database Cognition sẽ thêm một dòng nữa, #Volume: id=database kind=database path=aoci.database.txt format=table-fras-v2 depends=meta state=enabled.

Sau đó Meta mở đầu bằng các quy tắc chi phối mọi mục:

#AOCI-META-VOLUME: 1
#Object-Protocol: repository-cognition-object/v2
#FRAS-Discipline: 2
#FRAS-v2-Limits-Authority: machine-contract
#S-Admission: non-inferable-and-error-preventing
#S quota: C9-8≤600 C7-4≤200 C3-1≤50
#Object-Kinds: code=file database=table

#FRAS-v2-Limits-Authority: machine-contract là dòng chịu lực: các giới hạn trường thuộc về tệp nhị phân, không thuộc về văn bản này, nên một dự án không thể nới rộng chúng bằng cách sửa Meta của chính nó. #S-Admission và #S quota chi phối riêng trường S: những gì có thể được ghi ở đó, và mỗi dải tầm quan trọng được phép dùng bao nhiêu ký tự. Từ điển thẻ theo ngay sau các dòng này; nó được hiển thị đầy đủ ở phần dưới.

Code Volume mở đầu bằng một dòng duy nhất, #AOCI-CODE-VOLUME: 1, và mọi thứ sau đó là các phần thư mục và các mục.

Đây là các giá trị mà một dự án mới bắt đầu từ, không phải các hằng số giao thức cố định. Root và Meta riêng của mỗi kho lưu trữ là có thẩm quyền sau đó: một dự án cũ hơn có thể mang một từ điển thẻ tùy chỉnh, và một dự án được khởi tạo với --locale zh-CN sẽ ghi #Locale: zh-CN và bản địa hóa khóa #S quota: cho phù hợp.

Các quy tắc chỉ mục định nghĩa những gì

Trong Volumes v1, Meta Volume của dự án lưu các quy tắc này; trong bố cục Legacy, chúng nằm trong phần header nguyên khối. Các dự án có thể dùng từ điển thẻ khác nhau, trong khi cấu trúc FRAS cơ bản giữ nguyên.

README này chỉ giải thích cách đọc các quy tắc này. Đối với quy tắc cụ thể, có thể thực thi, hãy tham chiếu Meta hoặc header Legacy của dự án hiện tại, hướng dẫn AOCI và đặc tả chính thức.

Một mục ghi lại những gì (FRAS)

Khi các quy tắc đã sẵn sàng, mô hình viết một mục cho mỗi đối tượng được quản lý với vai trò index. Vai trò observe chỉ tham gia vào việc quan sát thay đổi, và vai trò exclude đánh dấu những gì được cố ý bỏ ra ngoài; cả hai đều không sở hữu mục chính thức. AOCI dùng FRAS để tổ chức bốn loại thông tin quan trọng nhất trong một mục:

• F — Function (Chức năng): đối tượng chịu trách nhiệm về điều gì.
• R — Relations (Quan hệ): những đối tượng nào khác bạn phải xem xét cùng để hiểu hoặc thay đổi nó một cách an toàn.
• A — API: những giao diện, lệnh, định dạng hoặc hợp đồng quan sát được mà nó phơi ra.
• S — Ràng buộc không hiển nhiên: thông tin quan trọng mà F, R và A không bao quát nhưng bạn cần để hiểu hoặc thay đổi đối tượng một cách an toàn, chẳng hạn ràng buộc chính, ngoại lệ, ranh giới và ngữ nghĩa đặc biệt. S không nên lặp lại ba trường đầu.

Ví dụ, trong phần thư mục ===.../internal/fs/===, một mục dùng tên cơ sở:

atomic.go[CG9L]: F:Provides durable replace CAS, create CAS, atomic writes, and no-clobber recovery moves | R:code:internal/fs/atomic_exchange_linux.go,code:internal/fs/atomic_exchange_windows.go,code:internal/fs/lock.go | A:AtomicWrite,AtomicWriteCAS,AtomicCreateCAS,AtomicMoveCAS | S:Native publication never degrades to an overwriting rename; on a race, unsafe type, or unverifiable bytes, preserve third-party state 

Phần thư mục và tên cơ sở phân giải thành một danh tính đối tượng mã. Đối với các phép chiếu xuyên Volume hoặc toàn hệ thống, nó mở rộng thành danh tính chuẩn tắc như code:internal/fs/atomic.go. Một đối tượng cơ sở dữ liệu dùng danh tính chuẩn tắc riêng, chẳng hạn database://primary/public/orders.

Mục có hai phần:

atomic.go [CG9L]
└─ object ─┘ └ tags ┘

F: Core responsibility
R: Strong relationships that must be understood together
A: External interface or contract
S: Important additional information beyond F, R, and A

Thẻ rút gọn cung cấp cho mỗi đối tượng tọa độ về tầng kiến trúc, miền chức năng, mức quan trọng, đặc điểm kỹ thuật tùy chọn và kích thước. Từ điển thẻ được định nghĩa bởi Meta Volume hoặc header Legacy của dự án. Chương trình xác thực từ điển và cấu trúc; nó không quyết định ý nghĩa nghiệp vụ.

S không phải là bản tóm lược, bản tóm tắt thông thường hay sự lặp lại của F, R và A. Nó bổ sung thông tin quan trọng mà ba trường đầu không bao quát và ảnh hưởng đến việc hiểu hoặc tính đúng đắn kỹ thuật, ví dụ:

• lỗi truy cập Redis phải dự phòng về cơ sở dữ liệu;
• một bảng cụ thể không được vào AutoMigrate;
• một nhánh tương thích kế thừa không được xóa bởi việc dọn dẹp thông thường;
• tệp gốc phải được bảo toàn sau khi ghi thất bại.

Mô hình viết điều này từ mã nguồn thực tế và bằng chứng. AOCI-CODE xác thực cấu trúc của mục, gắn nó với tệp nguồn và quản trị cách nó vào chỉ mục chính thức.

Đọc từ điển thẻ khởi đầu

Đoạn trích sau được sao chép nguyên văn từ mẫu Meta Volume en-US hiện tại (textassets/en-US/templates/volume-meta.txt.tmpl). Đây là từ điển khởi đầu, không phải từ vựng phổ quát: Meta chính thức của mỗi kho vẫn là nguồn có thẩm quyền. Bản khởi đầu không khai báo từ điển D; D vẫn là trục tùy chọn và chỉ có thể được dùng khi Meta chính thức hiện tại khai báo nó.

#Canonical-Tag-Authoring: compact A+B+C+[D]+E; dotted form is read compatibility only
#Code canonical identity example: code:path/to/file.go
#Code Entry example: file.go[EG7T]: F:Runs the example application | R:code:config/load.go | A:main | S:Exits non-zero when the config file is missing; it never falls back to built-in defaults
#[Tag dictionary: code]
#A Layer: C-SharedFoundation E-EntryBoundary A-ApplicationOrchestration D-DomainLogic K-AlgorithmComputation M-Middleware P-Persistence I-IntegrationAdapter R-RuntimeFoundation L-LibrarySDK F-DeclarativeConfiguration O-OperationsDelivery T-TestValidation S-DocumentationSpecification X-DevelopmentTooling Z-Other
#B Module: G-CrossDomain U-UserInteraction B-CoreBusiness D-DataState I-IdentityAccess N-NetworkProtocol M-MessageEvent S-SecurityPrivacy C-ConfigurationPolicy O-Observability R-ReliabilityRecovery P-PerformanceResource W-WorkflowScheduling A-AnalyticsIntelligence H-HardwareDevice L-Localization V-BuildRelease Q-QualityAssurance E-ExtensionPlugin Z-Other
#C Importance: 9-highest 8-very-high 7-high 6-above-average 5-medium 4-below-average 3-low 2-very-low 1-lowest
#E Scale: L-large>400 M-medium200-400 S-small100-200 T-tiny<100
#[Tag dictionary: database]
#A Layer: E-EntityMaster T-TransactionFact R-RelationMapping M-DetailDependent C-ReferenceDictionary S-StateStorage H-HistoryVersion L-LogAudit Q-QueueOutbox A-AggregateProjection K-KeyValueConfiguration B-DocumentLargeObject Z-Other
#B Module: G-CrossDomain B-CoreBusiness I-IdentityAccess T-OrganizationTenant U-UserExperience F-FinanceBilling K-ContentKnowledge C-ConfigurationPolicy W-WorkflowTask M-MessageEvent N-ExternalIntegration S-SecurityPrivacy O-ObservabilityAudit R-ReliabilityRecovery P-PerformanceResource A-AnalyticsIntelligence H-HardwareDevice L-Localization V-BuildRelease Q-QualityTesting E-ExtensionPlugin Z-Other
#C Importance: 9-highest 8-very-high 7-high 6-above-average 5-medium 4-below-average 3-low 2-very-low 1-lowest
#E Scale: L-large>400 M-medium200-400 S-small100-200 T-tiny<100

Theo từ điển mã khởi đầu, [CG9L] nghĩa là C SharedFoundation, G CrossDomain, 9 mức quan trọng cao nhất, và L quy mô lớn; không có giá trị D nào. Điều này giải thích cách đọc mục hiện có, không phải cách mô hình nên gán thẻ. Mô hình vẫn chọn thẻ từ Meta của dự án hiện tại, dựa trên mã nguồn và bằng chứng được chấp nhận.

Cognition Volumes

AOCI-CODE duy trì một Whole-Index logic, trong khi mỗi loại chỉ mục có tệp, quyền sở hữu và vòng đời riêng.

Mỗi đối tượng có đúng một chủ sở hữu hợp lệ. Đặt một đối tượng vào sai Volume tạo ra xung đột quyền sở hữu. AOCI-CODE chỉ sửa nó khi máy có thể chứng minh chủ sở hữu sai, chủ sở hữu đúng và sự kiện đối tượng hiện tại; nó không đoán quyền sở hữu từ các tên tương tự.

Code Volume, Database Volume và phạm vi có thể tiến hóa cùng nhau, nhưng chúng chia sẻ một ranh giới commit được quản trị. Áp dụng một miền không được loại bỏ phép chiếu Baseline hiện có của miền khác. Việc áp dụng Volume, cập nhật Baseline và các phép chiếu phạm vi liên quan được công bố như một kết quả giao dịch nhất quán hoặc bước vào phục hồi có thể chứng minh. Chúng không bao giờ để lại trạng thái nửa hoàn chỉnh, trong đó "tệp thành công nhưng Volume khác không có baseline."

Tích hợp máy chủ

aoci init luôn ghi các quy tắc agent được quản lý, nhưng tích hợp máy chủ khác nhau:

• Codex nhận cấu hình MCP cấp dự án và, với --hooks, một prompt nén ngữ cảnh cùng SessionStart(compact). Nó vẫn không cài đặt hook chỉnh sửa tệp.
• Claude Code có thể cài đặt hook PreToolUse.
• OpenCode V1 nhận một opencode.json cấp dự án nghiêm ngặt.
• Cursor chỉ trả về một đoạn cấu hình tham chiếu; không có gì được ghi vào dự án.

Sau khi cấu hình, hãy kiểm tra xem phiên máy chủ hiện tại đã phơi ra các công cụ AOCI chưa. Chỉ làm mới hoặc mở lại phiên dự án đó nếu nó chưa tải máy chủ mới. Một phiên mới thường đọc các quy tắc và Whole-Index một lần. Trong khi danh tính chỉ mục vẫn hợp lệ và không có nén máy chủ đã biết nào xảy ra, các tác vụ sau tái sử dụng những gì mô hình đã có; toàn bộ chỉ mục không được tiêm lại một cách máy móc.

aoci --repo /absolute/path/to/repository init --agent codex
aoci --repo /absolute/path/to/repository init --agent codex --hooks
aoci --repo /absolute/path/to/repository init --agent claude --hooks
aoci --repo /absolute/path/to/repository init --agent opencode
aoci --repo /absolute/path/to/repository init --agent cursor

Codex --hooks giới hạn bàn giao nén trong danh tính biên nhận, trạng thái ghi hoặc phục hồi chưa hoàn tất, và chỉ dẫn tải lại ngay lập tức; nó không được giữ lại hoặc tóm tắt nội dung Whole-Index hay Overview/Attestation. Một hook PreCompact không thể tiêm vào, hoặc xóa lịch sử khỏi, đầu vào nén của máy chủ, nên nó không thể tự thực thi điều này. Hãy xem xét và tin cậy hook dự án đã cài qua Codex /hooks trước khi dựa vào nó.

Đầu ra Legacy giữ lại Levels 0–4 để tương thích với các máy chủ và báo cáo hiện có. cognition-state/v2 hiện tại diễn đạt mức độ hữu dụng của bức tranh hệ thống mà mô hình có thành Levels 0–3, và tách các sự kiện chứng minh nghiêm ngặt và quản trị thành các chiều độc lập:

Các chiều này không thay thế lẫn nhau. Attestation chỉ chứng minh độ phủ giao hàng và tính nhất quán danh tính cho tài liệu hiện tại; nó không có nghĩa là agent đã hiểu đầy đủ mọi tác vụ tương lai có thể có. Chỉ current_system_cognition_reliable=true cho phép tuyên bố không điều kiện về hiểu biết toàn bộ hệ thống hiện tại.

Bảng điều khiển AOCI

aoci ui phục vụ một bảng điều khiển chỉ đọc trên máy này, để bạn có thể xem trạng thái của chỉ mục mà không cần hỏi agent:

• header chỉ mục và các Code / Database Volume nguyên văn (các dòng phần === giữ nguyên, có thể lọc, sao chép toàn bộ); tab "All" là chỉ mục hoàn chỉnh đúng như agent nhận qua Overview
• token chỉ mục so với ngân sách, và kế hoạch chunk Overview
• lượng mã mà chỉ mục bao phủ: tệp, dòng, token và tỷ lệ nén; bao nhiêu bảng cơ sở dữ liệu
• trạng thái quản trị và drift, Managed Scope, tích hợp máy chủ và các tiến trình aoci mcp đang chạy
• các lệnh và prompt để đưa cho agent tiếp theo, với nút sao chép

Trang chuyển đổi giữa tiếng Trung và tiếng Anh; khoảng làm mới có thể chọn (mặc định 30 giây).

Nhiều máy chủ aoci mcp trong một WSL? Trên Linux và WSL, bảng điều khiển phát hiện mọi tiến trình aoci mcp của người dùng hiện tại và kho của nó, chuyển đổi giữa chúng bằng các tab ở trên cùng, và đánh dấu máy chủ có binary đã bị thay thế trên đĩa. Ranh giới: nó chỉ liên kết các địa chỉ loopback (mọi liên kết khác đều bị từ chối), chỉ trả lời GET và HEAD, không lấy khóa, không ghi thêm gì vào sổ cái, và không thay đổi một byte nào của kho lưu trữ. Đây là một tiến trình riêng biệt, không liên quan đến aoci mcp; máy chủ MCP vẫn không mở bất kỳ socket nào. Đăng ký của một bảng nền nằm trong thư mục bộ nhớ đệm của người dùng, không bao giờ nằm trong kho lưu trữ.

Các lệnh CLI thông dụng

Các kết hợp thông dụng:

# Initialization and first Baseline
aoci --repo . init --locale en-US --agent codex
aoci --repo . scan

# Verification and governance gates for Cognition Volumes
aoci --repo . verify --json
aoci --repo . check --json

# Live Guide; do not duplicate the state machine in a wrapper
aoci --repo . index agent guide --agent codex --json

# Capabilities and diagnostics
aoci --repo . capabilities
aoci --repo . doctor

# Database Evidence, Access, and Cognition lifecycle
aoci --repo . database --help
aoci --repo . database source access --source primary --json
aoci --repo . database cognition status
aoci --repo . cognition plan --help

# Derived System Cognition observations
aoci --repo . cognition system lineage
aoci --repo . cognition system relations

# MCP stdio Server
aoci --repo . mcp

Các lệnh Plan, Stage, Check, Diff, Apply, Curation, Scope Change, Bootstrap, Migration và phục hồi vẫn tồn tại. Hãy làm theo hướng dẫn mà binary đang chạy trả về; đừng sao chép máy trạng thái nội bộ vào các script.

Về các lệnh "chỉ đọc"

Đối với verify, check, index score và index inventory, "chỉ đọc" có nghĩa là chỉ mục hình thức và Baseline không bị sửa đổi; nó không có nghĩa là tuyệt đối không ghi gì vào hệ thống tệp. Khi Ledger được bật, cả bốn lệnh đều có thể ghi thêm vào Ledger cục bộ, và verify cũng cố gắng ghi Verify History. Việc ghi kiểm toán thất bại không thay đổi mã thoát hiện có hay tiêu chí quản trị.

Nếu cần một thao tác tuyệt đối không ghi tệp nào, hãy dùng một bản sao cô lập; CLI công khai hiện tại không cung cấp một công tắc tổng quát để tắt mọi ghi Ledger và Verify History. Các lệnh System Cognition không tạo ra trạng thái hình thức thứ hai, nhưng các lệnh CLI thông thường vẫn tuân theo hợp đồng thời gian chạy của phiên bản hiện tại đối với Ledger và các bản ghi lịch sử cục bộ.

Máy chủ MCP

aoci mcp không cần daemon thường trú và cung cấp đúng chín công cụ qua stdio:

Ở chế độ MCP, stdout được dành riêng cho JSON-RPC; nhật ký và chẩn đoán đi tới stderr. Mô tả công cụ, lược đồ JSON và các giá trị trạng thái máy mà binary đang chạy cung cấp là nguồn có thẩm quyền; README này chỉ là điểm khởi đầu.

Bản phát hành hiện tại cung cấp các khả năng System Cognition thông qua CLI và nhân quản trị hiện có. Chúng không thêm công cụ MCP thứ mười hay thay đổi tên, mục đích, hoặc hợp đồng stdio của chín công cụ hiện có.

Các phiên chạy dài và phân phối Whole-Index

Khi bắt đầu một cuộc hội thoại mới, tác nhân thường tải một Overview hoàn chỉnh để có được bức tranh về hệ thống khớp với kho lưu trữ, phiên bản chỉ mục và danh tính dịch vụ AOCI hiện tại. Chừng nào mô hình còn có thể dựa vào bức tranh đó, nó không cần tải lại trước mỗi tác vụ hay lệnh gọi công cụ.

Trong cùng một cuộc hội thoại, mô hình tự quyết định có tải lại hay không dựa trên trạng thái của chính nó, ngoại trừ sau một lần nén ngữ cảnh máy chủ đã biết. Một bàn giao đã nén có thể chỉ giữ lại danh tính biên nhận, trạng thái ghi hoặc phục hồi chưa hoàn tất, và chỉ dẫn tải lại ngay lập tức; nó không được giữ lại hay tóm tắt phần đầu, mục, chunk, thử thách hoặc phần thân chứng thực của Whole-Index hay Overview. Nội dung chỉ mục hoặc một biên nhận được sao chép vào bàn giao đó không thể chứng minh rằng bức tranh hiện tại của mô hình là đáng tin cậy.

Trước khi tiếp tục công việc nghiệp vụ sau một lần nén đã biết, tác nhân tải lại các quy tắc nếu chúng không còn hiện diện một cách đáng tin cậy, khai báo context_compaction với một ID sự kiện mới, và hoàn thành một chuỗi con trỏ, xác nhận và chứng thực Overview đầy đủ thông thường. check_only và phép dò cognition không phải là thứ thay thế. Sau khi truyền tải hoàn chỉnh mới, quy tắc chứng thực một phần hoặc thất bại hiện có vẫn cho phép tiếp tục gắn với nguồn mà không cần Overview tự động thứ hai. Đối với một thay đổi ngữ nghĩa hoặc một ranh giới giai đoạn lớn mà không có nén đã biết, AOCI cung cấp các ngưỡng làm mới, điểm kiểm tra và sự kiện danh tính, và mô hình quyết định xem nó có cần khôi phục bức tranh cấp hệ thống cho tác vụ hay không.

Phần thân của mỗi Overview hoàn chỉnh bao gồm một dấu bắt đầu, nội dung chính xác của chỉ mục hình thức hiện tại, và một dấu kết thúc.

Khi một Overview vượt quá ngân sách chunk của dự án:

1. việc phân phối bắt đầu ngay với chunk 1;
2. tác nhân phải tự động theo next_cursor cho đến chunk cuối cùng;
3. tác nhân gửi một chứng thực bằng Whole-Index đã được phân phối;
4. tìm kiếm cục bộ, bộ nhớ cũ, đọc nguồn bổ sung, hoặc đọc tệp trực tiếp không được trình bày như là phân phối hoàn chỉnh;
5. phục hồi đang chờ hoặc ảnh chụp không nhất quán sẽ thất bại theo hướng đóng mà không trộn lẫn nội dung.

overview_delivery.chunk_tokens là thiết lập kích thước phân phối duy nhất. Mặc định của nó là 7000, với phạm vi hợp lệ từ 4000 đến 24000. check_only=true là một điểm kiểm tra gọn nhẹ không có chuỗi chunk.

AOCI khai báo một hạn mức kích thước kết quả cho từng công cụ trên aoci_overview. Một máy chủ mà nếu không sẽ lưu một kết quả công cụ lớn xuống đĩa, chỉ đặt một bản xem trước vào ngữ cảnh của mô hình (đối với phân phối chỉ mục, đây là một thất bại âm thầm), sẽ nâng ngưỡng đó chỉ cho công cụ này. Trên Claude Code, điều này làm cho 24000 đầy đủ trở nên khả dụng, phân phối một chỉ mục 480 đối tượng trong ba chunk thay vì năm. Không có gì được dò: khai báo là tĩnh, và một máy chủ không nhận ra nó sẽ bỏ qua nó, đúng như đặc tả MCP yêu cầu.

Ngưỡng làm mới mặc định là 30 đường dẫn ngữ nghĩa khác biệt và cũng có thể được cấu hình theo từng dự án. Đối với quy tắc đếm chính xác, hãy tham khảo tài liệu Cognition Refresh và hợp đồng thời gian chạy.

Database Cognition

AOCI-CODE có thể đưa cấu trúc cơ sở dữ liệu vào cùng một chỉ mục và cùng một cơ chế quản trị, với một ranh giới truy cập tường minh và hẹp:

Explicit database command
  → Read-only PostgreSQL/MySQL/openGauss system catalogs
  → Canonical schema evidence
  → Human acceptance of the evidence hash
  → The host model writes table-level FRAS from complete evidence
  → Entries are bound to the evidence and enter governed apply

• Không có truy cập mạng tới cơ sở dữ liệu nào xảy ra khi không có cơ sở dữ liệu nào được cấu hình hoặc không có lệnh cơ sở dữ liệu tường minh nào được chạy.
• Chỉ siêu dữ liệu lược đồ của các bảng cơ sở được đọc, không đọc các hàng nghiệp vụ; view, routine và comment nằm ngoài phạm vi thu thập hiện tại.
• Không có DDL hay DML nào được thực thi.
• Tên máy chủ, tên người dùng, DSN và giá trị thông tin xác thực không bao giờ được ghi vào các tệp chỉ mục.
• Việc áp dụng Database Cognition chạy ngoại tuyến và không kết nối lại với cơ sở dữ liệu trong khi ghi.
• Chương trình bảo toàn và so sánh bằng chứng cấu trúc, nhưng mô hình vẫn viết trách nhiệm của bảng, các quan hệ và các ràng buộc có giá trị cao.

Hỗ trợ MySQL bao gồm 5.7.6 trở lên. Bộ thu thập đọc phiên bản máy chủ và chỉ chạy các truy vấn catalog mà bản phát hành đó có thể trả lời: ràng buộc CHECK từ 8.0.16, biểu thức chỉ mục từ 8.0.13, khả năng hiển thị chỉ mục từ 8.0.0. Một máy chủ 5.7 ghi lại một danh sách check rỗng, vì 5.7 phân tích cú pháp CHECK và không lưu gì; bằng chứng có cùng hình dạng trên mọi bản phát hành được hỗ trợ. MariaDB không được hỗ trợ và bị từ chối thay vì được đọc như MySQL.

Hồ sơ openGauss ban đầu được cố ý giới hạn ở openGauss 6.0.5 LTS ở chế độ tương thích A/PG và các bảng cơ sở thông thường không phân vùng. Các tính năng catalog không được hỗ trợ sẽ thất bại theo hướng đóng thay vì bị âm thầm rút gọn thành các sự kiện PostgreSQL; điều này không tuyên bố hỗ trợ cho MogDB, GaussDB, chế độ Dolphin/B/MySQL, phân vùng hoặc phân vùng con, column-store, MOT, bảng ngoại lai hoặc tạm thời, view, routine hoặc trigger.

Ở đây, phát hiện thất bại theo hướng đóng áp dụng cho các đối tượng giống bảng hiển thị được chọn với ngữ nghĩa không được hỗ trợ. Routine và trigger vẫn nằm ngoài miền đối tượng bảng v1 và không bao giờ được biểu diễn như các sự kiện bảng.

Đường dẫn openGauss sử dụng bản vá cục bộ đã được AOCI xem xét trên mã nguồn Connector v1.0.8 chính thức. Bộ phân tích cú pháp nghiêm ngặt của nó chỉ chấp nhận các tham số kết nối đã được xem xét và không tiêu thụ cấu hình PG*, service, tệp mật khẩu, thư mục home hoặc logger từ môi trường xung quanh. Một kết nối TCP ngoài một địa chỉ loopback dạng số phải sử dụng tường minh sslmode=verify-full (và một đường dẫn gốc tin cậy tuyệt đối trong sslrootcert khi được cung cấp), với TLS 1.2 là mức tối thiểu; các chế độ hạ cấp TLS bị từ chối. sslmode=disable chỉ được chấp nhận cho một Unix socket tường minh hoặc địa chỉ loopback dạng số được dùng làm ranh giới cục bộ/kiểm thử. Quản trị viên cơ sở dữ liệu vẫn chịu trách nhiệm cung cấp DSN đó bên ngoài cuộc hội thoại và cấp phát tài khoản có đặc quyền tối thiểu.

Database Volume mặc định vắng mặt. Nó chỉ đi vào Whole-Index sau khi dự án bật tường minh Database Cognition và hoàn thành việc quản trị bằng chứng, liên kết và vòng đời.

Khởi tạo truy cập cơ sở dữ liệu: bạn không cần hiểu chi tiết DSN

Bạn chỉ cần khai báo một danh tính không nhạy cảm cho một nguồn cơ sở dữ liệu. Nếu --credential-env bị bỏ qua, AOCI suy ra một tham chiếu biến môi trường ổn định từ ID nguồn; ví dụ: primary ánh xạ tới AOCI_DB_PRIMARY_DSN:

aoci --repo . database source add \
  --source-id primary \
  --engine postgresql \
  --database-name app \
  --namespace public

Sau đó dùng bước kiểm tra trước truy cập chỉ đọc để xem môi trường bên ngoài đã cung cấp tham chiếu đó hay chưa:

aoci --repo . database source access --source primary --json

Lệnh này không kết nối tới cơ sở dữ liệu, không trả về giá trị thông tin xác thực, và không yêu cầu bạn dán DSN vào cuộc hội thoại. Quản trị viên cơ sở dữ liệu hoặc hạ tầng cung cấp biến môi trường bên ngoài tiến trình AOCI và cấp quyền truy cập chỉ đọc, đặc quyền tối thiểu vào các catalog hệ thống. Cấu hình nguồn chỉ lưu tên tham chiếu thông tin xác thực, không lưu bí mật.

Bản ứng viên phát hành hiện tại chỉ cung cấp nhà cung cấp thông tin xác thực từ biến môi trường. Các trình quản lý bí mật đám mây như Vault, Kubernetes Secret và AWS/GCP/Azure có thể được tích hợp thông qua cùng ranh giới nhà cung cấp trong các phiên bản sau; chúng chưa khả dụng hôm nay, và README này không ngụ ý điều ngược lại. Cách tách này giữ định dạng tài khoản, mã hóa DSN và quản lý vòng đời bí mật tránh xa người dùng thông thường, đồng thời giữ quyền ủy quyền minh bạch: AOCI không tự động phát hiện thông tin xác thực, quét .env, đọc tệp bí mật hay vượt qua ranh giới ủy quyền của quản trị viên cơ sở dữ liệu.

Nền tảng Nhận thức Hệ thống

Trên nền mã nguồn và các chỉ mục cơ sở dữ liệu, AOCI-CODE cung cấp một tập các quan sát Nhận thức Hệ thống phái sinh. Chúng trả lời những câu hỏi như "đối tượng này đến từ đâu?", "thay đổi cơ sở dữ liệu có thể ảnh hưởng đến những đối tượng mã nào?", và "điều gì đã thay đổi giữa một quan sát lịch sử và hiện tại?" Chúng không tạo ra một tầng sự thật có thẩm quyền mới.

# Where an index object came from, with its evidence and receipt bindings
aoci --repo . cognition system lineage

# Volume containment and dependencies plus resolved model-authored R relationships
aoci --repo . cognition system relations

# Find code impact from a database object along formal R relationships
aoci --repo . cognition system impact \
  --object database://primary/public/orders

# Save a historical observation on the caller side
aoci --repo . cognition system snapshot --json > previous.json

# Compare a caller-supplied historical observation with the current derived projection
aoci --repo . cognition system evolution \
  --snapshot-file previous.json

Ranh giới thẩm quyền

Mọi kết quả Nhận thức Hệ thống đều báo cáo derived=true; phép chiếu quan hệ báo cáo thêm authoritative=false. Cognition Volumes, các ràng buộc bằng chứng lược đồ, dấu vân tay Baseline và danh tính gắn với biên nhận vẫn là các thẩm quyền nền tảng. Các quan hệ R chưa phân giải tạo ra kết quả không đầy đủ hoặc chẩn đoán; chương trình không đoán và điền vào chúng.

AOCI-CODE không phải là một hệ thống đồ thị tri thức. Phép chiếu quan hệ hẹp là một góc nhìn quan hệ tiện lợi, nhưng nó không sở hữu hệ thống quản lý trạng thái thứ hai, không có đường ghi độc lập và không có kho sự thật mới. Đầu ra phái sinh có thể bị xóa và tính toán lại từ các tài sản có thẩm quyền hiện tại. Nếu một phép chiếu xung đột với các tài sản có thẩm quyền, các tài sản sẽ thắng.

Chế độ thực thi, quyền riêng tư và ranh giới dữ liệu

• AOCI-CODE ưu tiên cục bộ theo mặc định, không có endpoint đám mây mặc định, không có dịch vụ tải nguồn lên được lưu trữ và không yêu cầu máy chủ nền.
• Việc xử lý dữ liệu ở chế độ Agent-native phụ thuộc vào máy chủ bạn chọn và các chính sách sản phẩm của nó; AOCI-CODE không tải dữ liệu lên thay cho máy chủ.
• Truy cập mạng cơ sở dữ liệu phải được kích hoạt rõ ràng và chỉ giới hạn ở siêu dữ liệu lược đồ chỉ đọc.
• Sổ cái, bản nháp, giao dịch và bằng chứng khôi phục được lưu dưới .aoci/ theo mặc định và thường bị Git bỏ qua; các tệp chỉ mục và tài sản quản trị nhóm có thể được commit vào Git.
• Các phép chiếu Nhận thức Hệ thống được tính cục bộ từ các tài sản có thẩm quyền hiện có và không cần cơ sở dữ liệu đồ thị, cơ sở dữ liệu vector hay dịch vụ đồ thị từ xa.

Khác biệt so với bản đồ repo, RAG, LSP hay đồ thị mã

Tìm kiếm, AST, LSP, đồ thị mã và RAG đều giỏi các câu hỏi về cấu trúc và truy xuất. AOCI-CODE làm một công việc khác: nó duy trì một mô tả có phiên bản của hệ thống bao phủ phạm vi được quản lý và tiến hóa tăng dần cùng phần mềm. Những gì bạn nhận được:

• Một Whole-Index. Một bản đồ hệ thống bao phủ phạm vi được quản lý hiện tại, không phải các mảnh ghép được lắp ráp tức thời cho từng tác vụ.
• Các mục FRAS. Trách nhiệm, quan hệ mạnh, hợp đồng công khai và các ràng buộc giá trị cao cho mọi đối tượng có vai trò index.
• Duy trì qua các phiên. Các tệp chỉ mục sống cùng kho lưu trữ, nên các phiên sau và các agent khác tái sử dụng cùng một phiên bản.
• Phạm vi được quản lý. Một bản ghi rõ ràng về những đối tượng nào vào chỉ mục, những đối tượng nào chỉ được quan sát để phát hiện thay đổi và những đối tượng nào cố ý bị loại ra.
• Phát hiện lệch. Phân biệt Missing, Orphan, Stale, Unbaselined, thay đổi ký tự xuống dòng, khác biệt biên tập và các nguồn bị loại khỏi việc soạn thảo (rỗng, nhị phân, quá lớn).
• Cập nhật có quản trị. Ứng viên vào các tệp chính thức thông qua ràng buộc nguồn, kế hoạch, xác thực, đánh giá, CAS, ghi nguyên tử, Baseline và quy trình khôi phục.
• Chứng thực phân phối. Chunk, con trỏ, biên nhận và thử thách chứng minh Whole-Index đã được phân phối đầy đủ.
• Nhận thức Cơ sở dữ liệu. Các mục cấp bảng được xây dựng và quản trị từ bằng chứng lược đồ PostgreSQL/MySQL/openGauss được chấp nhận rõ ràng.
• Các phép chiếu hệ thống. Các quan sát Lineage, Relations hẹp, Impact từ cơ sở dữ liệu sang mã, Snapshot và Evolution được phái sinh từ chỉ mục có thẩm quyền và các ràng buộc của nó mà không nhân bản trạng thái có thẩm quyền; Impact chỉ duyệt các quan hệ R rõ ràng do mô hình soạn thảo.

AOCI-CODE bổ sung cho các công cụ hiện có thay vì thay thế chúng.

Kết hợp được khuyến nghị: AOCI-CODE cung cấp tiên nghiệm ngữ nghĩa toàn cục; đồ thị mã, LSP, tìm kiếm và mã nguồn cung cấp bằng chứng chính xác; kiểm thử và kết quả thời gian chạy cung cấp sự chấp nhận cuối cùng. Phép chiếu Relations của AOCI không thay thế một đồ thị gọi chính xác: nó phơi bày các cạnh chứa đựng cấu trúc của Volume và phụ thuộc của Root, trong khi các cạnh ngữ nghĩa của nó chỉ giới hạn ở các quan hệ mạnh mà mô hình đã soạn thảo rõ ràng.

Ngăn xếp công nghệ

AOCI-CODE không yêu cầu Neo4j, cơ sở dữ liệu vector, daemon chạy dài hạn hay dịch vụ đám mây AOCI. Khi Nhận thức Cơ sở dữ liệu được bật, cơ sở dữ liệu đích chỉ là một nguồn bằng chứng lược đồ chỉ đọc, rõ ràng, chứ không phải kho trạng thái riêng của AOCI.

Câu hỏi thường gặp

Tại sao status --deep Legacy vẫn hiển thị lệch?

status --deep, index score và index agent plan chỉ dành cho Legacy. Đối với một kho Cognition Volumes, hãy chạy hướng dẫn trực tiếp và để máy chủ dùng aoci_maintain không đối số thông thường, gửi toàn bộ lô hiện tại qua aoci_update_entry, và kết thúc bằng Verify, Check và hướng dẫn. Không sửa Baseline trực tiếp hay bỏ qua các bước ràng buộc nguồn và khôi phục.

Bản thân bố cục Legacy đã bị ngừng khuyến nghị. Volumes v1 là con đường được hỗ trợ cho các kho mới và đã di chuyển, và các lệnh chỉ dành cho Legacy được lên lịch loại bỏ trong v0.2.0; hãy di chuyển một kho Legacy bằng aoci cognition migration trước thời điểm đó.

aoci --repo . index agent guide --agent codex --json

Tại sao máy chủ khởi động nhầm AOCI?

Kiểm tra đường dẫn tệp thực thi trong cấu hình MCP cấp dự án và đảm bảo đó là một đường dẫn tuyệt đối ổn định, sau đó chạy:

/absolute/path/to/aoci --version
/absolute/path/to/aoci --repo . doctor

Để xác minh máy chủ stdio đã tải thay vì chỉ tệp trên đĩa, hãy kiểm tra thêm tệp thực thi thực tế của tiến trình máy chủ, --repo dòng lệnh của nó và danh tính tiến trình sau khi khởi động lại.

Tôi có phải tự tạo tài khoản cơ sở dữ liệu và cung cấp DSN không?

Bạn không cần hiểu cú pháp DSN, và bạn không nên gửi bí mật trong trò chuyện. Sau khi bạn khai báo một danh tính nguồn không nhạy cảm, AOCI cung cấp một tham chiếu biến môi trường ổn định. Quản trị viên cơ sở dữ liệu vẫn phải tạo một tài khoản bên ngoài với đặc quyền tối thiểu, chỉ có quyền đọc danh mục hệ thống, và cung cấp tham chiếu đó cho môi trường thời gian chạy. Phiên bản hiện tại không tạo tài khoản cơ sở dữ liệu thay cho tổ chức hay tự động đọc kho bí mật.

Nó có thể chạy trong CI không?

Có. Quét, xác minh, cổng quản trị và kiểm tra tất định chạy mà không ghi các mục mới. Đối với lệnh chính xác, ghi kiểm toán và mã thoát, hãy tham khảo --help của tệp thực thi hiện tại, các lược đồ JSON và tài liệu CI của dự án.

Kết quả AOCI toàn xanh có chứng minh ngữ nghĩa là đúng không?

Không. Kết quả xanh chứng minh rằng các điều kiện cấu trúc và quản trị đã mã hóa đều thỏa mãn. Những gì mô hình đã viết vẫn phải được kiểm tra đối chiếu với mã nguồn, lược đồ, kiểm thử, kết quả thời gian chạy và đánh giá của con người.

Đồ thị Nhận thức Hệ thống có phải là nguồn sự thật mới không?

Không. Năng lực hiện tại là một phép chiếu quan hệ hẹp, không phải một nền tảng đồ thị độc lập. Nó chỉ tính kết quả từ chỉ mục chính thức, bằng chứng, biên nhận và Baseline, và không lưu giữ sự thật có thẩm quyền mới. Chương trình cũng không tự động sinh quan hệ ngữ nghĩa từ import, SQL, tên tệp hay độ tương đồng.

Tài liệu

Các liên kết tài liệu và hợp đồng công khai được ghim vào v0.1.0-rc22 để chúng vẫn hợp lệ khi README này được đọc từ một kho lưu trữ Release dạng nhị phân, vốn không bao gồm các thư mục docs/ hoặc spec/public/ của kho lưu trữ.

Bộ kiểm thử xác minh hộp đen

Kho lưu trữ cung cấp bốn bộ kiểm thử hộp đen độc lập dưới scripts/blackbox/ để kiểm tra một tệp nhị phân aoci đã được xây dựng hoàn toàn từ bên ngoài tiến trình, chỉ thông qua giao thức MCP stdio công khai và CLI:

• Tuân thủ giao thức — 53 kiểm tra chỉ đọc trên bề mặt giao thức MCP, với các câu phụ thuộc ngôn ngữ được lặp lại dưới zh-CN;
• Kịch bản tiêm lỗi — 75 kịch bản bao gồm giả mạo con trỏ, phục hồi sau sự cố, tranh chấp giữa các trình ghi, và hook trước khi ghi trên các kho lưu trữ mẫu dùng một lần;
• Vòng đời trên các dự án thực đã đóng băng — ba dự án mẫu đã cam kết: repo-a (TypeScript) và repo-b (Python + MySQL) chạy toàn bộ vòng đời từ init đến tái căn chỉnh, và repo-c (một dịch vụ phân lớp gồm 453 tệp) còn điều khiển việc soạn thảo đa lô ở giới hạn lô của máy. Một nhánh mô hình tùy chọn đưa một tác nhân AI thực — bất kỳ mô hình nào mà bản cài OpenCode của bạn cung cấp — đi qua hai kho lưu trữ nhỏ và chấm điểm trạng thái cuối từ các bề mặt công khai.
• Trục nâng cấp — 80 kiểm tra cho mỗi phiên bản đã phát hành, trên mười hình dạng kho lưu trữ: mỗi bản phát hành đã công bố xây dựng và soạn thảo một kho lưu trữ bằng tệp nhị phân riêng của nó, sau đó tệp nhị phân đang được kiểm tra phải quản lý nó mà không di chuyển một danh tính, không yêu cầu Thay đổi phạm vi, hay viết lại một tài sản chính thức, và những gì nó sau đó soạn thảo phải giữ cho một bản checkout ở đường dẫn khác được căn chỉnh; ở hình dạng thứ mười, vai trò đảo ngược, và mỗi bản phát hành đã công bố phải đọc một kho lưu trữ mà tệp nhị phân đang được kiểm tra đã viết mà không bị sập hay viết lại nó. Ba bộ còn lại tạo mọi mẫu bằng tệp nhị phân đang được kiểm tra, nên một ảnh gốc đã thay đổi giữa các phiên bản là vô hình đối với chúng theo cách xây dựng.

Chúng chỉ cần Python 3 và git bên cạnh một tệp nhị phân đã xây dựng (Docker cho bộ MySQL; OpenCode cùng gói đăng ký mô hình của riêng bạn cho nhánh mô hình), nên một bản sao kho lưu trữ có thể xác minh bản dựng của chính nó, một bản chuyển cổng nền tảng, hoặc một bản fork — và AOCI_BIN có thể trỏ các bộ tuân thủ và kịch bản vào bất kỳ tệp nhị phân thay thế nào tuyên bố các hợp đồng công khai trong spec/public/. Các bộ này nằm trong bản sao kho lưu trữ; các kho lưu trữ Release dạng nhị phân không bao gồm chúng. Xem scripts/blackbox/README.md để biết các lệnh và cách diễn giải kết quả.

Nghiên cứu, sở hữu trí tuệ và giấy phép

Các bài báo và tài liệu nghiên cứu của AOCI-CODE có thể mô tả công khai các phương pháp đã phát hành, giao thức thử nghiệm và kết quả. Đơn xin cấp bằng sáng chế, phạm vi được cấp, tình trạng pháp lý, chủ sở hữu và hiệu lực lãnh thổ là các sự kiện pháp lý, và chúng không nên được thêm vào mô tả sản phẩm dựa trên một README nội bộ, một số phiên bản lịch sử, hay một lời kể lại chưa được xác minh.

Nếu một số bằng sáng chế cụ thể, ngày cấp bằng, hoặc phạm vi phải được công bố trong tương lai, chủ sở hữu quyền và cố vấn pháp lý nên xác minh nó dựa trên hồ sơ công khai chính thức và đặt nó trong một tài liệu IP, NOTICE, hoặc tài liệu pháp lý chuyên dụng. README này chỉ nên liên kết đến tệp có thẩm quyền đó; nó không nên tự mở rộng phạm vi bằng sáng chế cũng không trình bày tình trạng bằng sáng chế như một giấy phép phần mềm.

Cộng đồng

Quét mã bằng WeChat hoặc WeCom (企业微信) để tham gia nhóm dự án AOCI và trao đổi với những người duy trì và người dùng khác. Gửi báo cáo lỗi và yêu cầu tính năng dưới dạng GitHub issues để chúng vẫn có thể tìm kiếm được, và báo cáo các lỗ hổng nghi ngờ một cách riêng tư như SECURITY.md mô tả, không bao giờ trong nhóm.

AOCI-CODE không phải là về việc làm cho một tác nhân thấy nhiều mã hơn. Nó cung cấp cho tác nhân một sự hiểu biết hiện tại, có cấu trúc, có thể truy vết và được quản lý về hệ thống trước mỗi hành động. Git đánh phiên bản mã của bạn, các migration cơ sở dữ liệu đánh phiên bản cấu trúc dữ liệu của bạn, và AOCI-CODE đánh phiên bản những gì các tác nhân biết về hệ thống, cùng với khả năng truy vết, tính nhất quán trong quản trị và các ranh giới phục hồi của cách kiến thức đó tiến hóa.