Cách cài đặt và sử dụng Academic DeAI để biên tập học thuật tiếng Trung và tiếng Anh

Academic DeAI làm gì

Academic DeAI là một kỹ năng dùng để biên tập văn phong học thuật bằng tiếng Trung và tiếng Anh. Công cụ loại bỏ phần dẫn nhập sáo rỗng, cấu trúc lặp lại và ngôn ngữ mang tính khuôn mẫu, đồng thời bảo toàn dữ kiện, trích dẫn, thuật ngữ, câu phủ định, mức độ chắc chắn của bằng chứng, các điều kiện giới hạn về quan hệ nhân quả và giọng văn của tác giả trong bản thảo.

Dự án hỗ trợ hiệu đính, trau chuốt ngôn ngữ, dịch thuật học thuật và chỉnh sửa cấu trúc theo yêu cầu của người dùng. Phạm vi chính của dự án không bao gồm email thông thường, bài blog hoặc nội dung tiếp thị.

Academic DeAI không lựa chọn mô hình AI, gọi API mô hình hay tự động kết nối chuỗi các trình biên tập khác. Đây là một kỹ năng biên tập chạy trong một máy chủ tương thích. Phiên bản 3.0.0 tuân theo hướng dẫn hiện hành về kỹ năng GPT-6 và vận dụng các ý tưởng biên tập theo ngữ cảnh từ Humanizer 3.1.0, nhưng không tuyên bố có hiệu suất giống hệt trên mọi điểm kiểm tra GPT-6.

Vì sao biên tập học thuật theo ngữ cảnh quan trọng

Văn phong học thuật thường chứa những cụm từ chỉ tạo thêm sự nhấn mạnh mà không bổ sung bằng chứng. Academic DeAI hướng đến việc loại bỏ những phần dẫn nhập như vậy chỉ khi ngữ cảnh xung quanh ủng hộ thay đổi đó. Công cụ đánh giá cấu trúc và ý nghĩa trước khi xem các từ riêng lẻ là những mẫu không mong muốn.

Ví dụ, hãy xem đoạn văn hư cấu bằng tiếng Trung sau:

Đáng chú ý là nghiên cứu này đã tiến hành phân tích cắt ngang trên 126 bệnh nhân, kết quả cho thấy điểm chất lượng giấc ngủ có tương quan với điểm mức độ nghiêm trọng của ngứa (r=0.32，P=0.01). Phát hiện này không chỉ cho thấy mối liên hệ phức tạp giữa hai yếu tố mà còn mang lại những gợi ý quan trọng cho các nghiên cứu trong tương lai.

Một bản chỉnh sửa khả dĩ là:

Nghiên cứu này tiến hành phân tích cắt ngang trên 126 bệnh nhân và phát hiện điểm chất lượng giấc ngủ có tương quan với điểm mức độ nghiêm trọng của ngứa (r=0.32，P=0.01).

Bản chỉnh sửa loại bỏ phần dẫn nhập chung chung nhưng giữ lại thiết kế nghiên cứu, cỡ mẫu, các biến số, hệ số tương quan và giá trị P. Ví dụ ngắn này minh họa phương pháp biên tập; đây không phải là phép so sánh chuẩn.

Tính năng chính

• Biên tập tiếng Trung và tiếng Anh: Chỉnh sửa văn bản học thuật bằng một trong hai ngôn ngữ ở mức độ người dùng yêu cầu.
• Dịch thuật học thuật: Dịch bản thảo theo thuật ngữ, mẫu văn bản, yêu cầu về cấu trúc và giới hạn độ dài được cung cấp.
• Bảo toàn luận điểm: Kiểm tra chủ thể, đối tượng, chiều tác động, thời gian, điều kiện và mối liên kết với trích dẫn ở cấp độ luận điểm nguồn.
• Chỉnh sửa có nhận thức về bằng chứng: Bảo toàn tính không chắc chắn, câu phủ định, các điều kiện giới hạn về quan hệ nhân quả, khoảng giá trị, kết quả âm tính và những so sánh cần thiết.
• Biên tập có nhận thức về cấu trúc: Xem xét cách tổ chức bản thảo trước khi chỉnh sửa cách diễn đạt cục bộ.
• Hướng dẫn phong cách: Sử dụng các mẫu văn bản của tác giả để định hướng cách diễn đạt mà không đưa dữ kiện mới từ những mẫu đó vào.
• Thực thi linh hoạt: Tránh bắt buộc số lần viết lại hoặc báo cáo bắt buộc khi yêu cầu đã đủ cụ thể.
• Nạp tài nguyên có chọn lọc: Chỉ nạp tài liệu tham khảo và công cụ khi chúng liên quan đến tác vụ.

Điều kiện tiên quyết

Bạn cần một máy chủ hỗ trợ kỹ năng và một vị trí kỹ năng hợp lệ được cấu hình cho máy chủ đó. Tài liệu Codex hiện tại liệt kê ~/.agents/skills cho kỹ năng cấp người dùng và .agents/skills cho kỹ năng cấp kho lưu trữ. Các môi trường hiện có thể sử dụng một vị trí đã cấu hình khác, vì vậy hãy làm theo tài liệu của máy chủ bạn đang dùng.

Chỉ cần Python 3.10 trở lên cho các tiện ích văn bản và lệnh xác thực đi kèm. Những tiện ích này kiểm tra nội dung và hoạt động của gói; chúng không tạo hoặc viết lại văn bản.

Cài đặt Academic DeAI

Cài đặt mới cho người dùng

Từ thư mục nơi bạn muốn tải kho lưu trữ xuống, hãy chạy:

git clone https://github.com/heise3/academic-deai.git
mkdir -p ~/.agents/skills
cp -R academic-deai ~/.agents/skills/academic-deai

Sao chép toàn bộ thư mục kho lưu trữ. Không chỉ sao chép SKILL.md, vì gói sử dụng các tham chiếu tương đối và bao gồm các tập lệnh tùy chọn.

Chỉ sử dụng lệnh sao chép khi đích chưa tồn tại. Sau khi cài đặt, hãy mở lại danh sách kỹ năng của máy chủ. Nếu Academic DeAI không xuất hiện, hãy khởi động lại Codex hoặc máy chủ liên quan.

Cài đặt ở cấp kho lưu trữ

Nếu máy chủ của bạn hỗ trợ kỹ năng cấp kho lưu trữ, hãy đặt toàn bộ gói vào thư mục kỹ năng đã cấu hình của kho lưu trữ, thường là .agents/skills. Xác nhận đường dẫn được hỗ trợ chính xác trước khi sao chép tệp.

Nâng cấp bản cài đặt hiện có

Sao lưu thư mục Academic DeAI đã cài đặt trước khi nâng cấp. Thay thế thư mục hiện có một cách có chủ đích thay vì hợp nhất các tệp chưa rõ nguồn gốc từ bản phát hành cũ. Cách này giúp ngăn các tham chiếu, tập lệnh hoặc tệp cấu hình lỗi thời còn sót lại trong gói.

Tham khảo tài liệu kỹ năng chính thức để xem hướng dẫn cài đặt dành riêng cho máy chủ hiện tại.

Cách sử dụng cơ bản

Chỉnh sửa một phần học thuật bằng tiếng Trung

Xác định kỹ năng, nêu rõ phần và ngôn ngữ, liệt kê nội dung phải giữ nguyên và chỉ rõ định dạng đầu ra mong muốn:

Use $academic-deai to revise this Chinese discussion section.
Keep every substantive claim, citation, number, and causal qualification.
Return only the edited text.

Dán phần thảo luận sau hướng dẫn. Câu cuối giúp ngăn phần bình luận bổ sung khi bạn cần văn bản có thể chèn trực tiếp vào bản thảo.

Dịch bản thảo sang tiếng Anh

Đối với bản dịch, hãy cung cấp thuật ngữ và tài liệu tham khảo về phong cách cùng với các ràng buộc rõ ràng về cấu trúc:

Use $academic-deai to translate this manuscript into English.
Use the terminology list and my writing sample below.
Preserve the requested section structure and minimum length.

Danh sách thuật ngữ có thể thiết lập cách dịch nhất quán cho các thuật ngữ chuyên ngành. Mẫu văn bản có thể định hướng phong cách, nhưng không nên được xem là nguồn cung cấp dữ kiện mới.

Yêu cầu chỉnh sửa cấu trúc có kiểm soát

Academic DeAI có thể thực hiện việc chỉnh sửa cấu trúc khi bạn cho phép. Hãy xác định những gì được phép thay đổi và những gì phải giữ nguyên. Ví dụ:

Sử dụng $academic-deai để chỉnh sửa phần kết quả bằng tiếng Anh này.
Cải thiện thứ tự các đoạn văn và câu chuyển tiếp, nhưng giữ nguyên tất cả tiêu đề,
thống kê, phép so sánh, kết quả phủ định, trích dẫn và các điều kiện giới hạn.
Chỉ trả về phần đã chỉnh sửa.

Chỉ dẫn này phân biệt những thay đổi về tổ chức được phép với nội dung thực chất được bảo vệ. Các tiêu đề bắt buộc và những cấu trúc phương pháp luận có ý nghĩa, bao gồm cả thể bị động cần thiết trong phần phương pháp, nên được giữ lại khi được yêu cầu.

Kiểm tra gói

Chạy trình xác thực gói từ thư mục gốc của kho lưu trữ:

PYTHONDONTWRITEBYTECODE=1 python3 scripts/validate_package.py .

Trình xác thực kiểm tra cấu trúc gói, các tham chiếu, thông tin phiên bản và các tệp có tính di động.

Chạy các bài kiểm thử đơn vị bằng lệnh:

PYTHONDONTWRITEBYTECODE=1 python3 -m unittest discover -s tests -v

Các bài kiểm thử bao quát hành vi có thể quan sát của những công cụ đi kèm. Việc vượt qua bước xác thực và các bài kiểm thử không chứng minh chất lượng chỉnh sửa, tính tương đương về ngữ nghĩa, quyền tác giả hoặc hiệu suất của trình phát hiện.

Kiểm tra hai tệp văn bản với khóa nội dung

Tiện ích khóa nội dung có thể so sánh một tài liệu gốc với một bản chỉnh sửa:

python3 scripts/content_lock.py original.md revised.md --strict

Tiện ích này là một phần của quy trình xác thực, không phải công cụ tạo văn bản. Hãy xem kết quả của nó như một hỗ trợ, chứ không phải bằng chứng rằng mọi ý nghĩa và luận điểm đều đã được giữ nguyên.

Làm việc với nguồn PDF và DOCX

Việc trích xuất văn bản PDF cũng yêu cầu Poppler’s pdftotext. Hãy đảm bảo lệnh đó đã được cài đặt và có thể truy cập trong môi trường của bạn trước khi dựa vào việc trích xuất PDF.

Việc trích xuất DOCX đọc XML phần nội dung, nhưng không giữ lại mọi kiểu định dạng, nhận xét, thay đổi được theo dõi, chú thích cuối trang hoặc hộp văn bản. Nếu những tính năng tài liệu đó quan trọng, hãy sử dụng công cụ hỗ trợ tài liệu và kiểm tra trực tiếp tệp Word có thể chỉnh sửa.

Mẹo nâng cao để chỉnh sửa đáng tin cậy

Xác định rõ nội dung được bảo vệ

Đừng chỉ dựa vào yêu cầu chung như làm cho văn bản này hay hơn. Hãy nêu rõ những yếu tố không được thay đổi, bao gồm luận điểm, số liệu, trích dẫn, thuật ngữ, phủ định, mức độ không chắc chắn, khung thời gian, điều kiện và mức độ nhân quả.

Nêu rõ mức độ chỉnh sửa được phép

Hãy phân biệt hiệu đính với chỉnh sửa sâu hơn. Đối với hiệu đính, giới hạn thay đổi ở ngữ pháp và cách diễn đạt. Đối với chỉnh sửa cấu trúc, hãy cho phép rõ ràng việc sắp xếp lại đoạn văn, thay đổi câu chuyển tiếp hoặc loại bỏ phần dẫn nhập dư thừa.

Bảo vệ mức độ vững chắc của bằng chứng

Yêu cầu kỹ năng này giữ lại những phân biệt như mối liên hệ so với quan hệ nhân quả, khả năng so với tính chắc chắn, và sự thiếu vắng bằng chứng so với bằng chứng về sự thiếu vắng. Các phát hiện phủ định và kết luận có điều kiện có thể trông yếu về mặt văn phong nhưng lại thiết yếu về mặt khoa học.

Gắn trích dẫn với đúng luận điểm

Khi chỉnh sửa ranh giới câu hoặc cấu trúc đoạn văn, hãy đảm bảo mỗi trích dẫn vẫn gắn với mệnh đề mà nó hỗ trợ. Điều này đặc biệt quan trọng khi một câu dài được chia thành nhiều câu ngắn hơn.

Cung cấp danh sách thuật ngữ

Đối với các bản thảo đa ngôn ngữ hoặc chuyên ngành, hãy cung cấp bản dịch ưu tiên, chữ viết tắt, cách viết hoa và những thuật ngữ phải giữ nguyên. Điều này làm giảm sự không nhất quán mà không yêu cầu biên tập viên phải suy đoán quy ước của lĩnh vực.

Sử dụng mẫu văn của tác giả một cách thận trọng

Một mẫu văn đại diện có thể định hướng độ dài câu, mức độ trang trọng và cách diễn đạt ưa thích. Hãy nêu rõ rằng mẫu chỉ dùng làm tham chiếu phong cách và không được bổ sung sự kiện, trích dẫn hoặc lập luận vào bản thảo đã chỉnh sửa.

Giữ nguyên hình thức bắt buộc

Nếu tạp chí, cơ sở giáo dục hoặc người hướng dẫn yêu cầu tiêu đề, độ dài tối thiểu, thứ tự phần hoặc ngôn ngữ báo cáo, hãy đưa những ràng buộc đó vào lời nhắc. Academic DeAI được thiết kế để giữ lại các tiêu đề và cấu trúc bắt buộc khi được hướng dẫn.

Rà soát kết quả thủ công

Sau khi chỉnh sửa, hãy so sánh bản chỉnh sửa với nguồn ở cấp độ luận điểm. Kiểm tra ai thực hiện mỗi hành động, điều gì được đo lường, hướng của từng kết quả, các khoảng thời gian và điều kiện áp dụng, cách diễn đạt quan hệ nhân quả, giá trị số và vị trí trích dẫn.

Những hạn chế quan trọng

• Academic DeAI không lựa chọn mô hình và không thực hiện lệnh gọi API mô hình.
• Các công cụ đi kèm không viết hoặc viết lại văn bản.
• Việc xác thực không chứng minh tính tương đương về ngữ nghĩa hoặc chất lượng chỉnh sửa.
• Việc trích xuất DOCX không thể giữ lại mọi tính năng của tài liệu.
• Hướng dẫn thiết kế của dự án không đảm bảo hiệu năng chuẩn đối với mọi checkpoint GPT-6.
• Việc cài đặt kỹ năng không tạo hoặc sửa đổi kho lưu trữ Git từ xa.

Kết luận

Academic DeAI cung cấp một cách có cấu trúc để trau chuốt và dịch văn viết học thuật tiếng Trung và tiếng Anh mà không cố ý làm suy yếu bằng chứng hoặc thay đổi các luận điểm thực chất. Hãy cài đặt gói hoàn chỉnh, đưa ra ranh giới chỉnh sửa chính xác, giữ nguyên thuật ngữ chuyên ngành và so sánh thủ công từng bản chỉnh sửa với nguồn. Dự án được cung cấp theo giấy phép MIT.