Skip to content

docs: Enhance README.zh-CN.md with badges and instructions#1291

Merged
affaan-m merged 4 commits intoaffaan-m:mainfrom
Alex-Yanggg:patch-1
Apr 6, 2026
Merged

docs: Enhance README.zh-CN.md with badges and instructions#1291
affaan-m merged 4 commits intoaffaan-m:mainfrom
Alex-Yanggg:patch-1

Conversation

@Alex-Yanggg
Copy link
Copy Markdown
Contributor

@Alex-Yanggg Alex-Yanggg commented Apr 6, 2026

Updated README.zh-CN.md to include additional badges, improved descriptions, and added new sections for installation and usage instructions.

What Changed

Only the Simplified Chinese version of the Readme file has been modified.

Added:

  • Security Guide
  • AgentShield — Security Auditor
  • Requirements
  • Installation
  • Community Projects
  • Sponsors

Updated:

  • Quick Start commands
  • What's Inside
  • Ideas for Contributions

Why This Change

I kept running into issues while trying to install this GitHub repository using my agent, and eventually found that the Simplified Chinese installation commands were outdated. To help more Chinese developers get started quickly, I updated them.

I also noticed that some of the latest changes hadn’t been synced, and important sections like Community Projects and Sponsors — which can significantly boost the project’s community visibility — were missing. I’ve updated those as well to help maintain the project’s presence. All updated content has been proofread word for word.

Testing Done

  • Manual testing completed
  • [no need] Automated tests pass locally (node tests/run-all.js)
  • [no need] Edge cases considered and tested

Type of Change

  • fix: Bug fix
  • feat: New feature
  • refactor: Code refactoring
  • docs: Documentation
  • test: Tests
  • chore: Maintenance/tooling
  • ci: CI/CD changes

Security & Quality Checklist

  • No secrets or API keys committed (ghp_, sk-, AKIA, xoxb, xoxp patterns checked)
  • JSON files validate cleanly
  • Shell scripts pass shellcheck (if applicable)
  • Pre-commit hooks pass locally (if configured)
  • No sensitive data exposed in logs or output
  • Follows conventional commits format

Documentation

  • Updated relevant documentation
  • Added comments for complex logic
  • README updated (if needed)

Summary by cubic

Updates the Simplified Chinese README with cross‑platform installers, multi‑IDE targets, stronger security docs/tools, and clearer setup. Also updates the Security Guide link and fixes outdated commands.

  • New Features

    • Added badges for forks/contributors, npm (ecc-universal, ecc-agentshield), and GitHub App installs; Security Guide now links to ./the-security-guide.md.
    • New installers: ./install.sh and ./install.ps1 with --profile/--target, plus npx ecc-install for Windows/macOS/Linux.
    • Security tooling: ecc-agentshield scan/--fix/--opus, init, and CI/GitHub Action integration; runtime controls ECC_HOOK_PROFILE, ECC_DISABLED_HOOKS, and MCP opt‑out ECC_DISABLED_MCPS.
    • Expanded content and IDEs: more agents/skills/commands, added languages/frameworks (Swift, PHP, Django, Laravel, Spring Boot), and support for Cursor/OpenCode/Antigravity/Gemini; added Community Projects and Sponsors.
  • Migration

    • Requires Claude Code CLI v2.1+.
    • Do not add "hooks" to .claude-plugin/plugin.json (hooks auto‑load); remove if present.
    • When installing rules manually, copy entire language directories (not individual files).

Written for commit 21be9f8. Summary will update on new commits.

Summary by CodeRabbit

  • Documentation
    • Expanded badges and added repo stats line; updated guide links and renamed quickstart/longform/security guides.
    • Restructured “指南” to three columns and added a 安全指南 entry with header image.
    • Revised 快速开始 with OS-specific installers, npx path, and clearer install guidance favoring whole language/skills directories.
    • Added hook runtime controls, environment/CLI minimums, AgentShield usage/CI notes, MCP configuration tips, and 社区/赞助者 sections.

Updated README.zh-CN.md to include additional badges, improved descriptions, and added new sections for installation and usage instructions.
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Apr 6, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 978aa70a-d330-4078-b792-000b3042f8b3

📥 Commits

Reviewing files that changed from the base of the PR and between 122615a and 21be9f8.

📒 Files selected for processing (1)
  • README.zh-CN.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.zh-CN.md

📝 Walkthrough

Walkthrough

README.zh-CN.md updated with expanded badges and stats, revised install flows (OS-specific scripts and npx path), manual install and MCP guidance, new hook/runtime env vars, Claude Code CLI requirement, AgentShield docs, a rewritten repository tree, added community/sponsor sections, and updated links and guides.

Changes

Cohort / File(s) Summary
Chinese README
README.zh-CN.md
Large content addition and restructure: added badges/stats; changed “指南” layout; expanded “快速开始” with OS-specific install.sh/install.ps1 and npx ecc-install; altered manual rule/skill install guidance to prefer copying whole language/skill directories and updated MCP config (ECC_DISABLED_MCPS); added hook runtime controls (ECC_HOOK_PROFILE, ECC_DISABLED_HOOKS) and Claude Code CLI minimum version (v2.1.0+); added AgentShield CLI docs (scan/fix/opus-stream/init, CI behavior); rewrote repository tree and skill/command listings; appended community/赞助者 sections and updated links (removed/renamed some external entries).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Suggested reviewers

  • affaan-m

Poem

🐰
Badges sparkle, scripts take flight,
Hooks align in morning light.
AgentShield hums a careful song,
Docs grow dense and clear and strong—
A rabbit hops, delighted, light. 🥕

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main changes: documentation enhancement to README.zh-CN.md by adding badges and installation instructions.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (2)
README.zh-CN.md (2)

87-87: 中文 README 中出现英文 NOTE,建议本地化统一

Line 87 使用英文提示,和全文中文语境不一致。建议改为中文,降低阅读跳变。

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.zh-CN.md` at line 87, Replace the English NOTE string "NOTE: The
plugin is convenient, but the OSS installer below is still the most reliable
path if your Claude Code build has trouble resolving self-hosted marketplace
entries." with a natural Chinese localization that matches the document tone
(e.g., "注意:该插件使用方便,但如果 Claude Code 构建在解析自托管市场条目时出现问题,下面的 OSS 安装器仍是最可靠的方案。") so
the README.zh-CN.md content remains consistently Chinese.

18-18: 顶部手写统计数据容易过期,建议避免与徽章双轨维护

Line 18 的固定数字后续容易与真实数据偏离,且上方已经有动态 badge。可以考虑删除该行或改为不含具体数值的描述。

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.zh-CN.md` at line 18, Remove or replace the hard-coded stats line ">
**140K+ stars** | **21K+ forks** | **170+ 贡献者** | **12+ 语言系统** |
**Anthropic黑客松获胜者**" with a non-numeric, evergreen description (e.g.
"活跃的开源项目,拥有广泛的社区贡献与多语言支持") or simply delete the line and rely on the existing
dynamic badges so the README.zh-CN.md no longer contains time-sensitive fixed
numbers.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.zh-CN.md`:
- Line 793: The link text "[安全指南]()" is an empty/ broken link; locate the
markdown token "[安全指南]()" and replace the empty target with the correct
documentation URL (or if no doc exists, remove the link and keep plain text
"安全指南" or add a valid placeholder URL like "#" and a TODO comment), ensuring the
link points to the intended security guide page rather than an image or empty
href.
- Around line 604-606: The documented copy commands reference a wrong path:
replace the first occurrence of "everything-claude-code/.agents/skills/*" with
the actual "everything-claude-code/skills/*" so both cp commands target the same
existing skills directory; update the README lines that contain those cp
commands to use "everything-claude-code/skills/*" and verify the second command
("everything-claude-code/skills/search-first") remains correct.

---

Nitpick comments:
In `@README.zh-CN.md`:
- Line 87: Replace the English NOTE string "NOTE: The plugin is convenient, but
the OSS installer below is still the most reliable path if your Claude Code
build has trouble resolving self-hosted marketplace entries." with a natural
Chinese localization that matches the document tone (e.g., "注意:该插件使用方便,但如果
Claude Code 构建在解析自托管市场条目时出现问题,下面的 OSS 安装器仍是最可靠的方案。") so the README.zh-CN.md
content remains consistently Chinese.
- Line 18: Remove or replace the hard-coded stats line "> **140K+ stars** |
**21K+ forks** | **170+ 贡献者** | **12+ 语言系统** | **Anthropic黑客松获胜者**" with a
non-numeric, evergreen description (e.g. "活跃的开源项目,拥有广泛的社区贡献与多语言支持") or simply
delete the line and rely on the existing dynamic badges so the README.zh-CN.md
no longer contains time-sensitive fixed numbers.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 46258a59-b00a-4d3e-b2c1-63aef90f3422

📥 Commits

Reviewing files that changed from the base of the PR and between 7dfdbe0 and 4fe5019.

📒 Files selected for processing (1)
  • README.zh-CN.md

Comment on lines +604 to 606
cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/
cp -r everything-claude-code/skills/search-first ~/.claude/skills/

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

skills 复制路径疑似写错,当前命令可能直接失败

Line 604 使用了 everything-claude-code/.agents/skills/*,但同一文档的目录结构写的是 skills/(非 .agents/skills)。这会导致用户按文档执行时报错。

建议修复
- cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/
+ cp -r everything-claude-code/skills/* ~/.claude/skills/
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
cp -r everything-claude-code/.agents/skills/* ~/.claude/skills/
cp -r everything-claude-code/skills/search-first ~/.claude/skills/
cp -r everything-claude-code/skills/* ~/.claude/skills/
cp -r everything-claude-code/skills/search-first ~/.claude/skills/
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.zh-CN.md` around lines 604 - 606, The documented copy commands
reference a wrong path: replace the first occurrence of
"everything-claude-code/.agents/skills/*" with the actual
"everything-claude-code/skills/*" so both cp commands target the same existing
skills directory; update the README lines that contain those cp commands to use
"everything-claude-code/skills/*" and verify the second command
("everything-claude-code/skills/search-first") remains correct.

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps bot commented Apr 6, 2026

Greptile Summary

This PR substantially updates README.zh-CN.md to bring the Simplified Chinese documentation in sync with the English README. The author corrects outdated installation commands and adds several sections that were missing — including the installer scripts (install.sh/install.ps1/npx ecc-install), the AgentShield security tool section, requirements (Claude Code CLI v2.1+ minimum), community projects, and sponsors.

  • New badges for forks, contributors, npm packages (ecc-universal, ecc-agentshield), and GitHub App installs are added and mirror the English README correctly.
  • The expanded file-tree map, skills listing, commands listing, and examples listing accurately reflect the current repository state.
  • The three issues flagged in the previous review round (untranslated NOTE block, malformed blockquote closing fence, empty security-guide link) appear to have been addressed in the current version: 注意: replaces the raw NOTE:, no >\``pattern remains, and安全指南now resolves to./the-security-guide.md`.
  • All new install commands (./install.sh, .\install.ps1, npx ecc-install) reference scripts that actually exist in the repository and match the English README exactly.
  • The .agents/skills/ path used in the manual install block is a valid hidden directory in the repository.
  • Two pre-existing English-language > WARNING: blockquotes and the ## WARNING: 重要说明 heading were not modified by this PR; they mirror the same stylistic pattern in the English source (## WARNING: Important Notes).

Confidence Score: 5/5

Documentation-only PR that is safe to merge; no code or configuration logic is changed.

All changes are confined to README.zh-CN.md. The new content is accurate, mirrors the English README, references real scripts and files that exist in the repo, and the previously flagged issues appear resolved. No logic, security, or functional concerns remain.

No files require special attention.

Important Files Changed

Filename Overview
README.zh-CN.md Comprehensive update aligning the Simplified Chinese README with the English version — adds badges, installer script examples, AgentShield section, requirements, community projects, and sponsors; translation quality is high and all new content is verifiably consistent with the English README and current repository structure.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[用户开始安装] --> B{使用插件系统?}
    B -- 是 --> C["/plugin marketplace add\n/plugin install ecc@ecc"]
    B -- 否 --> D[git clone 仓库]
    C --> E[手动安装 rules/]
    D --> F{操作系统?}
    F -- macOS/Linux --> G["./install.sh --profile full"]
    F -- Windows --> H[".\\install.ps1 --profile full"]
    F -- 全平台 --> I[npx ecc-install typescript]
    G --> J[完成: 47 代理 / 181 技能 / 79 命令]
    H --> J
    I --> J
    E --> J
Loading

Reviews (3): Last reviewed commit: "Update security guide link in README.zh-..." | Re-trigger Greptile

Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 issue found across 1 file

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="README.zh-CN.md">

<violation number="1" location="README.zh-CN.md:793">
P3: The “安全指南” link has an empty URL, so it renders as a broken link in the README. Provide a valid target or remove the link markup.</violation>
</file>

Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review, or fix all with cubic.

Alex-Yanggg and others added 3 commits April 6, 2026 16:58
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
@affaan-m affaan-m merged commit c7f68a7 into affaan-m:main Apr 6, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants