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

readmeX

Trình tạo README và Wiki tương tác hỗ trợ AI cho mọi dự án. Công cụ tạo README và Wiki tương tác hỗ trợ AI, mã nguồn mở DeepWiki dành cho tiếng Trung.

Chạy đượcnguồn: GitHubPythonMITcommit 782fc3f54b6c

Python, giấy phép MIT. Dự án tự gắn nhãn: ai tools, cli, documentation, gpt, llm, markdown, python và readme.

readmeX 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 26 phút, gặp 4 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.

The readmex skill is installed in the user's Codex skills directory and its scanner runs; a live codex run on a mock repo generated README.md, images/logo.svg, and 9 MkDocs pages, and the emitted site builds successfully with mkdocs 1.6.1 + material 9.7.7 from a local venv.

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,02 USD (đo thực tế)
số lần chạy đã ghi
1
test gần nhất
lượt star
654
fork
26
issue đang mở
10
người theo dõi
2
dung lượng
2 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 readmeX, 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.

  • Initial `codex exec` run timed out at 150s without writing files (model generated an invalid apply_patch hunk and stalled)8 phút
  • System Python is PEP 668 externally-managed, so `pip install --user mkdocs` failed3 phút
  • README's `gh skill install` command cannot run here: `gh` binary is not installed in this container2 phút
  • MkDocs build emitted a warning: docs/index.md links `../../images/logo.svg` which is not a documentation file1 phút
Thời gian cài đặt
26 phút
Từ máy sạch đến khi xong
8 phút
Lỗi gặp và đã sửa
gặp 4, tự sửa 4 mà không cần người giúp
Cách chứng minh kết quả
`python3 /home/runner/.codex/skills/readmex/scripts/scan.py /work/repo` emitted a valid JSON scan (primary_language python, git readmeX) with exit 0; `codex exec resume --last` completed with exit 0 and wrote README.md + images/logo.svg + website/; `/tmp/mkdocs-venv/bin/mkdocs build -f website/mkdocs.yml` exited 0 (9 HTML pages, INFO Documentation built in 0.28s); `python3 -c ET.parse('images/logo.svg')` parsed OK
Số token model đã dùng
186.420
Commit chính xác đã test
782fc3f54b6c
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.

- **Install**: copied the readmex skill to `~/.codex/skills/readmex`; scanner compiles and runs; in…
- **Gap recorded**: README's `gh skill install` path can't run here (`gh` binary absent) — performe…
- **Full end-to-end verification (tier1_real)**: ran the `codex` CLI harness with the readmex skill…
- Note: `website/site/` build output is not ignored by the skill's scanner config, so a built site …
tokens used
186,420
Everything checks out. Let me compile the final ARGUSIC_RESULT line.
Key findings from the run:
- **Install**: copied the readmex skill to `~/.codex/skills/readmex`; scanner compiles and runs; in…
- **Gap recorded**: README's `gh skill install` path can't run here (`gh` binary absent) — performe…
- **Full end-to-end verification (tier1_real)**: ran the `codex` CLI harness with the readmex skill…
- Note: `website/site/` build output is not ignored by the skill's scanner config, so a built site …

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.
  • Tự khắc phục cả 4 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.

Những gì không suôn sẻ, hoặc chưa biết

  • Mất 26 phút để cài đặt, chậm hơn trung vị của 26 dự án tương đương mà Argusic đã đo.
  • Mới đo một lần. Một lần thử cho thấy nó có thể chạy, chưa cho thấy nó chạy ổn định.

Trong 27 dự án ai-tools mà Argusic đã cài đặt và bấm giờ, readmeX đứng thứ 26 về tốc độ đạt trạng thái chạy được, và 17 trên 27 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.

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.

Lịch sử chạy

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

Chủ đề (từ GitHub)

ai-toolsclidocumentationgptllmmarkdownpythonreadme

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/readmeX.svg)](https://argusic.com/subject/readmex)

Câu hỏi

readmeX có chạy được không?
Có. readmeX chạy được. Argusic đã cài đặt và khởi chạy nó trên một máy sạch trong 26 phút, gặp 4 lỗi trên đường đi, và ghi lại phiên làm việc.
Argusic đã test readmeX 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 782fc3f54b6c. Có một lần thử được ghi lại, và toàn bộ phương pháp nằm ở trang phương pháp.
Test readmeX tốn bao nhiêu?
Lần chạy đưa ra kết luận này tốn 0,02 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 readmeX mất bao lâu?
26 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.
readmeX 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 readmeX thì gặp lỗi gì?
4 lỗi xảy ra trong lần chạy được ghi lại, và 4 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.
readmeX so với các lựa chọn khác thế nào?
Trong 27 dự án ai-tools mà Argusic đã cài đặt và bấm giờ, readmeX đứng thứ 26 về tốc độ đạt trạng thái chạy được, và 17 trên 27 dự án đạt được trạng thái đó.
Bằng chứng cho readmeX ở đâu?
Lần chạy được ghi lại 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