Bản gốc tiếng Anh: https://argusic.com/subject/kordoc

kordoc

Công cụ tài liệu AI để đọc, chỉnh sửa và viết mới tài liệu tiếng Hàn: chuyển HWP, HWPX, PDF, Office, bản quét (OCR) sang Markdown, so sánh đối chiếu bản cũ và mới, chỉnh sửa giữ nguyên định dạng, soạn Markdown→HWPX, chuyển đổi HWP→HWPX, điền biểu mẫu và kiểm duyệt công văn. Thư viện, CLI, MCP | Đọc, so sánh, chỉnh sửa, viết và chuyển đổi tài liệu tiếng Hàn (HWP, HWPX, PDF, Office, bản quét): thư viện, CLI và máy chủ MCP

Chạy đượcnguồn: GitHubtrang chủ dự ánTypeScriptMITcommit dd4a08b77784

TypeScript, giấy phép MIT. Dự án tự gắn nhãn: cli, document conversion, document parser, docx, hancom, hwp, hwp parser và hwpx.

kordoc chạy được. Trên một máy sạch không có GPU, một agent của Argusic đã cài đặt nó trong 0,6 phút, gặp 1 lỗi và tự sửa hết mà không cần trợ giúp, và toàn bộ phiên làm việc được ghi lại.

kordoc 4.13.1 builds, all 1691 automated tests pass, the CLI parses HWPX and XLS files to Markdown correctly, and the library API returns structured parse results with fileType, markdown, blocks, and metadata.

Kết quả agent đạt được trên máy sạch, bằng chính lời của nó. Cách đo

Argusic đo trên một máy mới mỗi lần. Mỗi con số đều link tới bằng chứng của nó. Điểm Argusic 100 trên 100 (trung bình điểm các lần chạy của dự án này).

Tóm tắt

kết luận
Chạy được
Điểm Argusic
100 / 100
chi phí của lần chạy kiểm chứng
0,15 USD (đo thực tế)
số lần chạy đã ghi
2
test gần nhất
lượt star
2.913
fork
516
issue đang mở
5
người theo dõi
15
dung lượng
23 MB
ngày tạo
push gần nhất

Dữ liệu dự án lấy từ GitHub, có link ở đầu trang, cập nhật . Dữ liệu test của Argusic (CC BY 4.0); mỗi con số đều link tới một trang run có đầy đủ log, bản ghi và mã sha256 của chúng.

Những gì đã đo

Lấy từ lần chạy quyết định kết luận này. Mỗi dòng là một giá trị được ghi lại, không phải ước tính.

Thời gian mất cho từng lỗi khi test kordoc, vẽ từ lần chạy được ghi lại
Mỗi cột là một lỗi agent đã ghi lại, kèm thời gian nó tốn. Vẽ từ lần chạy này, không lấy từ nguồn nào khác.

Những gì trục trặc, bằng chính lời của agent

Lời của chính agent, lỗi nặng nhất trước, không bao giờ viết lại thành lời khuyên.

  • sharp 0.35.x requires Node >=20.9.0 but container has Node 18.19.1 — 14 tests fail at load time10 phút
Thời gian cài đặt
dưới một phút
Từ máy sạch đến khi xong
28 phút
Lỗi gặp và đã sửa
gặp 1, tự sửa 1 mà không cần người giúp
Cách chứng minh kết quả
npm test exited 0: 1691 passed, 0 failed, 7 skipped. node dist/cli.js tests/fixtures/dummy.hwpx printed correct markdown. node -e "require('./dist/index.cjs').parse('tests/fixtures/dummy.hwpx').then(r=>console.log(r.fileType,r.success))" returned hwpx true
Số token model đã dùng
189.213
Commit chính xác đã test
dd4a08b77784
Container image
sha256:cdd920bce783

Những gì chưa đo

Nửa còn lại, để bạn thấy rõ bằng chứng này đi xa tới đâu. Chỗ trống được ghi là chỗ trống và không bao giờ được lấp vào.

Bộ nhớ GPU cao nhất
lần này chạy trên máy CPU, nên không có GPU để đo
Hoạt động khi chạy lâu
mỗi lần thử dùng cấu hình nhỏ nhất có trong tài liệu và một khoảng thời gian cố định, nên đây là đo xem nó có chạy hay không, không đo nó chịu tải ra sao

Đoạn cuối của bản ghi

Những dòng cuối của phiên terminal đã quyết định kết luận này, đúng như khi được ghi lại.

**Fix applied:** `sharp@^0.35.0` requires Node ≥20.9.0 — container has Node 18.19.1. Downgraded to …
**Tests:** 1691 passed, 0 failed, 7 skipped (benign — missing OCR models and optional large corpus …
**CLI verified:** `node dist/cli.js --version` → `4.13.1`; `node dist/cli.js tests/fixtures/dummy.h…
**API verified:** `parse('tests/fixtures/dummy.hwpx')` → `fileType: hwpx, success: true, pageCount:…
tokens used
189,213
All systems verified. Here's the final report:
**Install:** `npm install` and `npm run build` both succeed.
**Fix applied:** `sharp@^0.35.0` requires Node ≥20.9.0 — container has Node 18.19.1. Downgraded to …
**Tests:** 1691 passed, 0 failed, 7 skipped (benign — missing OCR models and optional large corpus …
**CLI verified:** `node dist/cli.js --version` → `4.13.1`; `node dist/cli.js tests/fixtures/dummy.h…
**API verified:** `parse('tests/fixtures/dummy.hwpx')` → `fileType: hwpx, success: true, pageCount:…

Xem lại toàn bộ phiên, mọi lệnh từ máy sạch tới thời điểm này.

Cách test

Một agent, một container, không có người giúp. Agent cài dự án theo đúng cách tài liệu của dự án hướng dẫn, chạy nó, và sửa những gì bị hỏng. Mọi thứ bên dưới được ghi lại đúng như đã diễn ra: phiên terminal, log và commit chính xác. Toàn bộ phương pháp.

Điểm mạnh và giới hạn

Dữ kiện đo được, không phải ý kiến. Cách viết nội dung.

Những gì suôn sẻ

  • Đạt trạng thái chạy được trên máy sạch, có ghi lại phiên làm việc.
  • Cài đặt trong 0,6 phút, nhanh hơn trung vị của 121 dự án tương đương mà Argusic đã đo.
  • Tự khắc phục cả 1 lỗi mà không cần người can thiệp, cho thấy các lỗi được ghi trong tài liệu đủ rõ để giải quyết.
  • Chạy được không cần GPU, nên không cần GPU để khởi động.
  • Giấy phép MIT, theo thông tin từ nơi lưu trữ dự án.
  • Đã đo 2 lần, nên kết quả không phải của một lần duy nhất.

Trong 122 dự án cli mà Argusic đã cài đặt và bấm giờ, kordoc đứng thứ 8 về tốc độ đạt trạng thái chạy được, và 109 trên 122 dự án đạt được trạng thái đó.

Phù hợp để dùng cho

  • Thử trên laptop hoặc máy chủ nhỏ: nó đạt trạng thái chạy được mà không cần GPU.
  • Đánh giá nhanh: nó đã chạy 0,6 phút sau khi clone.

Cũng đã test, cùng lĩnh vực

Mỗi dự án ở đây đều được Argusic cài đặt và chạy trên máy sạch. Không có dự án nào chưa test xuất hiện ở đây.

  • anymd đã kiểm chứng chạy được · Rust · 11 chủ đề chung
  • docling đã kiểm chứng chạy được · Python · 5 chủ đề chung
  • uteke đã kiểm chứng chạy được · Rust · 5 chủ đề chung
  • crawl4ai đã kiểm chứng chạy được · Python · 4 chủ đề chung
  • JeecgBoot đã kiểm chứng chạy được · Java · 4 chủ đề chung
  • xerj đã kiểm chứng chạy được · Rust · 4 chủ đề chung

Lịch sử chạy

test bởilần thửkết quảđiểmchi phí USDthời điểm
Argusic Runner2/3Chạy được100,000,15
Argusic Runner1/3Chạy được100,000,06

Chủ đề (từ GitHub)

clidocument-conversiondocument-parserdocxhancomhwphwp-parserhwpxkoreanllmmarkdownmcpmcp-serverocrofficeparserpdfpdf-to-markdownragxlsx

Nhúng badge

Markdown cho README của dự án. Badge link về trang này; điều khoản ở trang điều khoản.

[![Tested by Argusic](https://argusic.com/badge/kordoc.svg)](https://argusic.com/subject/kordoc)

Câu hỏi

kordoc có chạy được không?
Có. kordoc chạy được. Argusic đã cài đặt và khởi chạy nó trên một máy sạch trong 1 phút, gặp 1 lỗi trên đường đi, và ghi lại phiên làm việc.
Argusic đã test kordoc như thế nào?
Trên một máy mới, dùng một lần, mọi lệnh đều được ghi lại và repo được ghim ở commit dd4a08b77784. Có 2 lần thử được ghi lại, và toàn bộ phương pháp nằm ở trang phương pháp.
Test kordoc tốn bao nhiêu?
Lần chạy đưa ra kết luận này tốn 0,15 USD: chi phí máy và model thật, không phải giá niêm yết theo triệu token. Con số được ghi trên trang của lần chạy đó.
Cài đặt kordoc mất bao lâu?
0,6 phút trong lần chạy quyết định kết luận này, từ máy sạch đến trạng thái chạy được. Đó là một lần thử đo được, không phải số trung bình.
kordoc có cần GPU không?
Không cần để khởi động. Argusic đã đạt trạng thái chạy được trên một máy không có GPU.
Cài đặt kordoc thì gặp lỗi gì?
1 lỗi xảy ra trong lần chạy được ghi lại, và 1 lỗi đã được sửa mà không cần người giúp. Từng lỗi, cùng thời gian nó tốn, được liệt kê trên trang này.
kordoc so với các lựa chọn khác thế nào?
Trong 122 dự án cli mà Argusic đã cài đặt và bấm giờ, kordoc đứng thứ 8 về tốc độ đạt trạng thái chạy được, và 109 trên 122 dự án đạt được trạng thái đó.
Bằng chứng cho kordoc ở đâu?
Cả 2 lần chạy được ghi lại đều nằm trên trang này, mỗi lần link tới log đầy đủ và terminal recording, được lưu kèm dấu vân tay sha256 để không thể bị sửa lén.

Discussion