{"id":50118156,"url":"https://github.com/bingooyong/repo-wiki-agent","last_synced_at":"2026-05-23T16:46:42.785Z","repository":{"id":355389090,"uuid":"1227689938","full_name":"bingooyong/repo-wiki-agent","owner":"bingooyong","description":"repo-wiki-agent","archived":false,"fork":false,"pushed_at":"2026-05-19T23:30:00.000Z","size":9712,"stargazers_count":4,"open_issues_count":5,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T16:46:40.532Z","etag":null,"topics":["ai","ai-agents","ai-tools","qoder"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bingooyong.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-03T03:03:54.000Z","updated_at":"2026-05-19T12:50:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bingooyong/repo-wiki-agent","commit_stats":null,"previous_names":["bingooyong/repo-wiki-agent"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/bingooyong/repo-wiki-agent","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bingooyong%2Frepo-wiki-agent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bingooyong%2Frepo-wiki-agent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bingooyong%2Frepo-wiki-agent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bingooyong%2Frepo-wiki-agent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bingooyong","download_url":"https://codeload.github.com/bingooyong/repo-wiki-agent/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bingooyong%2Frepo-wiki-agent/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33404268,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","ai-tools","qoder"],"created_at":"2026-05-23T16:46:39.682Z","updated_at":"2026-05-23T16:46:42.776Z","avatar_url":"https://github.com/bingooyong.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# repo-wiki\n\n**Local-first repository wiki generator** — 无需 `.qoder` 目录即可为任意工程生成结构化 Wiki 文档。\n\n[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)\n[![CI](https://github.com/bingooyong/repo-wiki-agent/actions/workflows/ci.yml/badge.svg)](https://github.com/bingooyong/repo-wiki-agent/actions/workflows/ci.yml)\n[![codecov](https://codecov.io/gh/bingooyong/repo-wiki-agent/branch/main/graph/badge.svg)](https://codecov.io/gh/bingooyong/repo-wiki-agent)\n[![Strict Verify: PASS](https://img.shields.io/badge/Strict%20Verify-PASS-brightgreen)](#)\n[![Tests: 1200+](https://img.shields.io/badge/Tests-1200%2B-blue)](#)\n[![GO Decision: 2026-05-02](https://img.shields.io/badge/GO-2026--05--02-green)](#)\n\n## 核心能力\n\n- **Qoder 替代** — 在 AI_API_Atlas 上通过 strict verify（13/13 checks），达到与 Qoder Repo Wiki 相同质量标准\n- **Local-first** — 无需外部数据库，SQLite + ChromaDB 嵌入式运行\n- **隔离输出** — `--profile qoder-like` 输出到 `.repo-agent-eval/`，不污染目标仓库\n- **增量更新** — 基于 git diff 实现页面级失效和选择性重生成\n- **Strict Verify** — 13 项质量门禁（prose density、citations、Mermaid、stale commit 等）\n\n## 快速开始\n\n```bash\n# 安装\ngit clone https://github.com/bingooyong/repo-agent.git\ncd repo-agent\nuv venv .venv \u0026\u0026 source .venv/bin/activate\nuv pip install -e .\n\n# 配置 LLM（Minimax 或 OpenAI-compatible）\nexport MINIMAX_API_KEY=\"your_key_here\"\n\n# 进入目标仓库\ncd /path/to/your-repo\n\n# 生成 Wiki（qoder-like 模式，隔离输出）\nuv run repo-wiki generate --profile qoder-like --run-id my-run\n\n# 验证质量\nuv run repo-wiki verify --profile qoder-like --ci --output my-run\n```\n\n## CLI 命令\n\n| 命令 | 说明 |\n|------|------|\n| `repo-wiki init` | 初始化仓库索引 |\n| `repo-wiki index` | 构建搜索索引 |\n| `repo-wiki generate [--profile qoder-like]` | 生成 Wiki 文档 |\n| `repo-wiki update` | 增量更新（基于 git diff） |\n| `repo-wiki verify --ci --profile qoder-like` | 质量验证 |\n| `repo-wiki search \"\u003cquery\u003e\"` | 语义搜索 |\n| `repo-wiki graph` | 模块依赖图 |\n| `repo-wiki cost-estimate` | LLM 成本估算 |\n\n## 架构\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                        CLI Layer                            │\n│         init | index | generate | verify | search | ...     │\n└─────────────────────────────────────────────────────────────┘\n                              │\n┌─────────────────────────────────────────────────────────────┐\n│                    Orchestration Layer                      │\n│   Service │ GenerationStateMachine │ GenerationScheduler       │\n└─────────────────────────────────────────────────────────────┘\n                              │\n┌─────────────────────────────────────────────────────────────┐\n│                      Agent Layer                            │\n│  Scanner │ IndexGraph │ DocGen │ AdapterGovernance │ QA      │\n└─────────────────────────────────────────────────────────────┘\n                              │\n┌─────────────────────────────────────────────────────────────┐\n│                      Storage Layer                          │\n│     SQLite/FTS5      │      ChromaDB      │    Files       │\n└─────────────────────────────────────────────────────────────┘\n```\n\n## 输出模式\n\n| 模式 | 输出位置 | 特点 |\n|------|----------|------|\n| **qoder-like** | `.repo-agent-eval/\u003crun\u003e/content/` | 隔离输出，不碰目标工程 |\n| **standard** | `docs/`, `.repo-wiki/` | 直接写入目标工程 |\n\n## Strict Verify 门禁（qoder-like）\n\n| 检查项 | 说明 | 门禁 |\n|--------|------|------|\n| `qoder-page-dumps` | 无列表过重页面 | HARD |\n| `qoder-prose-density` | prose 密度 \u003e= 30% | HARD |\n| `qoder-stale-commit` | git commit 最新 | HARD |\n| `qoder-content-empty` | 内容非空 | HARD |\n| `qoder-toc` | 有目录 | SOFT |\n| `qoder-citations` | 有引用 | SOFT |\n| `qoder-mermaid` | 有图表 | SOFT |\n| `qoder-api-aggregation` | API 聚合质量 | HARD |\n| `qoder-dm-aggregation` | Data model 聚合质量 | HARD |\n| `qoder-citation-relevance` | 引用相关性 | HARD |\n| `qoder-dirty-worktree` | 工作树干净 | HARD |\n\n## 文档\n\n- [项目交付文档包](./docs/delivery/index.md) — 完整的 14+4 份交付文档\n- [用户手册](./docs/delivery/user-manual.md) — CLI 详细用法\n- [部署指南](./docs/delivery/deployment-guide.md) — 安装和 CI/CD 集成\n- [配置指南](./docs/delivery/configuration-guide.md) — YAML 配置详解\n- [GO/No-Go 决策](./docs/go-no-go-dossier.md) — Phase 35 决策文档\n\n## 项目状态\n\n| 指标 | 状态 |\n|------|------|\n| Strict Verify | ✅ PASS (13/13) |\n| GO Decision | ✅ GO (Atlas strict benchmark) |\n| Tests | 1200+ |\n| Phases | 35 Completed |\n\n## 技术栈\n\n- **Python 3.10+** with `uv` package manager\n- **SQLite/FTS5** — 本地状态和全文检索\n- **ChromaDB** — 语义向量存储\n- **LLM** — OpenAI-compatible / Minimax\n\n## License\n\nApache License 2.0 - see [LICENSE](LICENSE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbingooyong%2Frepo-wiki-agent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbingooyong%2Frepo-wiki-agent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbingooyong%2Frepo-wiki-agent/lists"}