npm - @mcptoolshop/housekeeping - Versions diffs - 1.4.0 → 1.5.0 - Mend

@mcptoolshop/housekeeping 1.4.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/CHANGELOG.md +30 -0
package/README.es.md +125 -78
package/README.fr.md +119 -114
package/README.hi.md +74 -78
package/README.it.md +117 -75
package/README.ja.md +82 -79
package/README.md +2 -0
package/README.pt-BR.md +87 -69
package/README.zh.md +72 -89
package/housekeeping.config.example.json +2 -1
package/package.json +1 -1
package/src/cli.mjs +85 -2
package/src/collect.mjs +74 -4
package/src/config.mjs +13 -4
package/src/load.mjs +55 -3
package/src/schema.sql +26 -0
package/src/workflow-risks.mjs +35 -2

package/README.pt-BR.md CHANGED Viewed

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.md">English</a>
+  <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
 </p>
 <p align="center">
@@ -21,20 +21,20 @@
   <a href="https://mcp-tool-shop-org.github.io/housekeeping/handbook/"><img src="https://img.shields.io/badge/Handbook-read-blue" alt="Handbook" /></a>
 </p>
-Uma única análise coleta o status de CI de cada repositório, problemas abertos e solicitações de pull,
-lançamentos, tags de versão, arquivos de fluxo de trabalho, proteção de branch, alertas de segurança,
+Uma única execução coleta o status de CI de cada repositório, problemas abertos e solicitações de pull,
+lançamentos, tags de versão, arquivos de fluxo de trabalho, proteção de ramificação, alertas de segurança,
 arquivos de bloqueio e faturamento do Actions em SQLite, e, em seguida, verifica tudo em relação às regras definidas.
 Ele responde, para toda a organização de uma só vez:
-- Quais branches padrão estão com problemas e isso indica uma branch principal com defeito ou um histórico desatualizado?
-- Quais solicitações de pull nunca podem ser mescladas, porque uma verificação obrigatória não está sendo executada e as está bloqueando?
-- Quais implantações as configurações do próprio repositório rejeitam?
+- Quais são os ramos padrão que estão com problemas e isso indica uma linha principal com defeito ou um histórico desatualizado?
+- Quais solicitações de pull nunca podem ser mescladas, porque uma verificação obrigatória não está sendo executada e está bloqueando-as?
+- Quais implantações são rejeitadas pelas próprias configurações do repositório?
 - Onde `package.json`, as tags Git e o registro npm divergiram?
-- Quais fluxos de trabalho violam as regras de custo do Actions, quanto custaram e quais tarefas gastaram esse valor?
-- Quais repositórios contêm avisos que o próprio contador de alertas do GitHub não detecta?
+- Quais fluxos de trabalho violam as regras de custo do Actions, quanto custaram e quais tarefas consumiram esses recursos?
+- Quais repositórios contêm avisos que o número de alertas do GitHub não detecta?
-É um instrumento de auditoria, não um corretor. Ele lê o GitHub e não altera nada.
+É um instrumento de auditoria, não um corretor. Ele lê GitHub e não altera nada.
 ## Um agente em cada repositório
@@ -43,35 +43,35 @@ estado é armazenado. housekeeping é esse local, e seu servidor MCP, `hk-mcp`,
 a um agente de IA. Com ele, um único agente pode atuar como o coordenador para toda
 a organização:
-1. **Análise.** `hk refresh` coleta um instantâneo de cada repositório.
+1. **Execução.** `hk refresh` captura um instantâneo de cada repositório.
 2. **Triagem.** O agente pergunta o que está com problemas, o que está bloqueado e o que piorou,
-e obtém respostas que já distinguem uma branch principal com defeito de um histórico desatualizado, e
+e obtém respostas que já distinguem uma linha principal com defeito de um histórico desatualizado e
 uma solicitação de pull travada de uma com conflitos.
 3. **Planejar uma onda.** Uma consulta `hk_sql` encontra todos os repositórios com a mesma
 estrutura, para que uma correção se torne uma única solicitação de pull por repositório, em vez de uma busca.
 4. **Realizar o trabalho.** housekeeping nunca grava. O agente abre solicitações de pull
 com suas próprias ferramentas, sob suas próprias permissões e com sua revisão.
-5. **Verificar.** Analisar novamente. O problema desapareceu ou não, e a mudança
+5. **Verificar.** Executar novamente. A descoberta desapareceu ou não, e a mudança
 entre dois instantâneos é uma consulta.
 Perguntas que um agente responde em uma ou duas interações:
-- Quais branches padrão estão com problemas e qual tarefa e etapa causaram o problema?
+- Quais são os ramos padrão que estão com problemas e qual tarefa e etapa causaram o problema?
 - Quais solicitações de pull nunca podem ser mescladas e o gatilho ou um conflito são os culpados?
-- Quais repositórios contêm um aviso de produção para o qual o GitHub não exibe nenhum alerta?
+- Quais repositórios contêm um aviso de produção para o qual GitHub não mostra nenhum alerta?
 - Quais fluxos de trabalho agendados violam as regras para agendamentos e como?
-- Quanto o Actions custou e qual tarefa gastou esse valor?
-- O que mudou desde a última análise?
+- Quanto o Actions custou e qual tarefa consumiu esses recursos?
+- O que mudou desde a última execução?
 | Ferramenta | O que ela responde |
 |---|---|
-| `hk_summary` | Totais da análise mais recente: repositórios, problemas, solicitações de pull, fluxos de trabalho, descobertas. |
-| `hk_findings` | Descobertas por código, gravidade, categoria ou repositório; contagens por código quando não filtrado. A descoberta de uma branch principal com problemas indica a tarefa e a etapa que causaram o problema. |
-| `hk_ci` | Repositórios cuja branch padrão está com problemas e os fluxos de trabalho que falharam; também, agendamentos com falha, branches de solicitação de pull com falha e repositórios sem CI. |
+| `hk_summary` | Totais da execução mais recente: repositórios, problemas, solicitações de pull, fluxos de trabalho, descobertas. |
+| `hk_findings` | Descobertas por código, gravidade, categoria ou repositório; contagens por código quando não filtrado. A descoberta de uma linha principal com problemas indica a tarefa e a etapa que causaram o problema. |
+| `hk_ci` | Repositórios cujo ramo padrão está com problemas e os fluxos de trabalho que falharam; também, agendamentos com falha, ramos de solicitação de pull com falha e repositórios sem CI. |
 | `hk_repo` | Um repositório completo: descobertas, fluxos de trabalho, solicitações de pull e problemas abertos. |
 | `hk_backlog` | Solicitações de pull ou problemas abertos em toda a organização, da mais antiga para a mais recente. |
 | `hk_health` | Uma pontuação de saúde por repositório, da pior para a melhor. |
-| `hk_cost` | Gastos do Actions por repositório, fluxo de trabalho ou tarefa, bruto e líquido, separados. |
+| `hk_cost` | Gastos do Actions por repositório, fluxo de trabalho ou tarefa, separados em valores brutos e líquidos. |
 | `hk_sql` | Uma única instrução `SELECT` ou `WITH` somente leitura contra o armazém. |
 | `hk_schema` | As tabelas e colunas para gravar consultas `hk_sql`. |
@@ -89,7 +89,7 @@ retorna um erro estruturado, nunca um rastreamento de pilha.
 }
 ```
-`HK_HOME` é o diretório do qual você realiza a análise. A partir de um clone, use
+`HK_HOME` é o diretório do qual você executa. De um clone, use
 `"command": "node", "args": ["/path/to/housekeeping/src/mcp.mjs"]`. O segundo
 servidor é [Atlas](https://github.com/dogfood-lab/testing-os/tree/main/packages/atlas),
 que responde ao mesmo agente sobre um repositório por vez (veja abaixo). No
@@ -103,20 +103,20 @@ cada fluxo de trabalho com o que ele executa, publica e implanta. O mapa é conf
 como `atlas/` e verificado no CI. housekeeping é a visão da organização. Os dois
 são construídos para funcionar juntos.
-- **Cada mapa, analisado.** Uma análise lê o mapa confirmado de cada repositório, juntamente com
-tudo o mais, e relata quais repositórios não têm um, quais nunca
+- **Cada mapa, executado.** Uma execução lê o mapa confirmado de cada repositório, juntamente
+com tudo o mais, e relata quais repositórios não têm um, quais nunca
 executam `atlas check` e quais contêm um mecanismo diferente do que o restante da
 organização usa.
-- **Onde uma execução com problemas falhou.** Quando uma branch padrão está com problemas, a descoberta indica
+- **Onde uma execução com problemas falhou.** Quando um ramo padrão está com problemas, a descoberta indica
 a tarefa e a etapa que falharam e, por meio do mapa, o comando que essa etapa
 executa, para que a correção comece no arquivo correto.
 - **Fatos de implantação do mapa.** O ambiente para o qual uma tarefa é implantada é obtido
-do mapa onde ele é registrado, para que ambas as ferramentas leiam um fluxo de trabalho da mesma forma.
+do mapa, onde ele registra um, para que ambas as ferramentas leiam um fluxo de trabalho da mesma forma.
 - **Avisos em toda a frota.** Atlas sinaliza uma etapa do fluxo de trabalho que falhará
 antes de ser executada, como uma ferramenta que precisa de uma versão mais recente do tempo de execução do que a tarefa
 instala. O relatório lista esses avisos para cada repositório de uma só vez.
-Um agente com ambos os servidores passa de "estes doze repositórios estão bloqueados"
+Um agente com ambos os servidores passa de "esses doze repositórios estão bloqueados"
 (housekeeping) para "este é o fluxo de trabalho, a tarefa e os arquivos que uma alteração alcançará" (Atlas), sem abrir cada repositório manualmente.
 ## Por que ele tem essa estrutura
@@ -126,23 +126,23 @@ Um agente com ambos os servidores passa de "estes doze repositórios estão bloq
 | Transporte | a CLI `gh` | Ela já contém seu token. A ferramenta nunca armazena ou solicita uma credencial. |
 | Coleta | GitHub GraphQL, paginado | Uma consulta retorna metadados, problemas abertos, solicitações de pull abertas, lançamentos e árvores de arquivos para uma página de repositórios. Uma página que continua a atingir o tempo limite é dividida ao meio e solicitada novamente a partir do mesmo cursor. |
 | Execuções do Actions | REST | GraphQL não tem uma superfície do Actions. |
-| As ações têm um custo. | API de faturamento mais duração por tarefa. | A fatura indica qual repositório; apenas as tarefas indicam qual fluxo de trabalho. Os endpoints `/timing` do GitHub retornam zeros, portanto, o total por tarefa é recalculado e, em seguida, conciliado com a fatura. |
-| Tarifas de execução. | Lidas da fatura. | Uma tarifa faturada pode ser diferente do preço de tabela, e uma constante na origem distorceria todos os números. |
-| Armazenamento. | SQLite por meio do `node:sqlite` integrado. | Não há etapa de construção nativa. |
-| Fonte da verdade. | `data/snapshots/*.json` | Bruto, comparável e apenas para anexar. O banco de dados é derivado: `npm run rebuild` o reconstrói offline. |
-| Registro de varredura. | `data/sweeps.jsonl` | Uma linha por varredura, incluindo varreduras que falharam e varreduras que não encontraram nada de novo. |
+| Custo do Actions | API de faturamento mais durações por tarefa | A fatura indica qual repositório; apenas os trabalhos indicam qual fluxo de trabalho. Os pontos finais de GitHub's `/timing` retornam zeros, portanto, a soma por trabalho é reconstruída e, em seguida, reconciliada com a fatura. |
+| Taxas de execução | lidas da fatura | Uma taxa cobrada pode diferir do preço de tabela, e uma constante na fonte distorceria todos os números. |
+| Armazenamento | SQLite através do `node:sqlite` integrado | Sem etapa de construção nativa. |
+| Fonte da verdade | `data/snapshots/*.json` | Bruta, comparável e apenas para anexar. O banco de dados é derivado: `npm run rebuild` o reconstrói offline. |
+| Registro de varredura | `data/sweeps.jsonl` | Uma linha por varredura, incluindo varreduras que falharam e varreduras que não encontraram nada de novo. |
 Os instantâneos são imutáveis e aditivos, portanto, a diferença entre duas datas é um `JOIN`.
 ## Requisitos
 - Node.js 22.5 ou posterior.
-- O [GitHub CLI](https://cli.github.com/), com sessão iniciada (`gh auth status`) como uma
-conta que pode ler a organização. A leitura do faturamento e dos alertas de segurança
+- A [CLI GitHub](https://cli.github.com/), conectado (`gh auth status`) como uma
+conta que pode ler a organização. A leitura de faturas e alertas de segurança
 requer o acesso correspondente; uma varredura sem ele registra "não medido" e
 continua. Nunca registra uma permissão ausente como um resultado válido.
 - Windows ou Linux. É desenvolvido no Windows e seus testes são executados no Linux em
-CI. O macOS deve funcionar e não é testado.
+CI. macOS deve funcionar e não é testado.
 ## Uso
@@ -175,6 +175,8 @@ hk findings              # findings grouped by severity and code
 hk health                # per-repository health score, worst first
 hk repo <name>           # one repository in full
 hk prs                   # every open pull request by age
+hk branches              # branches by state: merged, moved after merge, no PR
+hk watch                 # open PRs, alerts and branches for a short watch list
 hk versions              # package.json against git tag against npm
 hk actions               # every workflow and its rule flags
 hk cost                  # Actions cost, gross and net side by side
@@ -194,7 +196,7 @@ erro imprime um código e uma dica. Códigos de saída: 0 ok, 1 erro do usuário
 ## Configuração
-`housekeeping.config.json`, no diretório em que a ferramenta de organização funciona (veja abaixo):
+`housekeeping.config.json`, no diretório em que a ferramenta de limpeza funciona (veja abaixo):
 ```json
 {
@@ -203,75 +205,88 @@ erro imprime um código e uma dica. Códigos de saída: 0 ok, 1 erro do usuário
 }
 ```
-- `org` é a organização a ser verificada. `hk refresh <org>` o substitui. Sem
+- `org` é a organização a ser varrida. `hk refresh <org>` o substitui. Sem
 nenhum dos dois, uma varredura se recusará a iniciar.
-- `metaRepos` são os repositórios que contêm os padrões, ativos ou
-ferramentas da organização, e não um produto lançado. Eles estão isentos das descobertas que só
-fazem sentido para um produto: ausência de README, LICENSE e arquivos semelhantes, ausência
-de fluxos de trabalho e ausência de lançamentos.
+- `metaRepos` são repositórios que contêm configurações, ativos ou
+ferramentas padrão da organização, não um produto lançado. Eles estão isentos das descobertas que só
+fazem sentido para um produto: ausência de arquivos README, LICENSE e semelhantes, ausência de
+fluxos de trabalho e ausência de lançamentos.
-Um arquivo malformado é um erro, nunca um padrão silencioso: uma chave desconhecida, um
-tipo incorreto ou um JSON corrompido interrompem a execução.
+Um arquivo malformado é um erro, nunca um padrão silencioso: uma chave desconhecida, um tipo incorreto ou um JSON corrompido interrompe a execução.
-Execute a partir de um clone, a ferramenta de organização mantém `data/`, `reports/` e o arquivo de configuração
+Execute a partir de um clone, a ferramenta de limpeza mantém `data/`, `reports/` e o arquivo de configuração
 no clone. Execute como um pacote instalado, ele os mantém no diretório de onde
 você o executa ou em `HK_HOME` quando isso for definido.
 Ambiente: `HK_HOME` (onde os dados, relatórios e a configuração estão localizados),
 `HK_CONFIG` (caminho da configuração), `HK_DB` (caminho do banco de dados), `HK_LOG`
 (`silent`, `normal`, `verbose` ou `debug`), `HK_COST_REPOS` e
-`HK_COST_BUDGET` (limites para o custo por tarefa), `GH_PATH` (caminho para `gh`).
+`HK_COST_BUDGET` (limites da passagem de custo por trabalho), `GH_PATH` (caminho para `gh`).
 ## Mantenha os dados privados
-**O que uma varredura grava é confidencial. Não inclua `data/` ou `reports/` em um
+**O que uma varredura grava é confidencial. Não envie `data/` ou `reports/` para um
 repositório público.**
-Um instantâneo registra os nomes e as descrições dos repositórios privados, todos os
-alertas de segurança abertos com o pacote que ele nomeia, arquivos de fluxo de trabalho e faturamento do Actions. O GitHub oculta deliberadamente os alertas de segurança de um repositório público de
+Um instantâneo registra os nomes e as descrições de repositórios privados, todos os
+alertas de segurança abertos com o pacote que ele nomeia, arquivos de fluxo de trabalho e faturamento do Actions. GitHub oculta deliberadamente os alertas de segurança de um repositório público de
 todos, exceto seus mantenedores; um instantâneo publicado entregaria essa lista.
 O `.gitignore` deste repositório exclui `data/`, `reports/` e
 `housekeeping.config.json`. Para manter o histórico, que é o objetivo dos instantâneos,
-execute a ferramenta a partir de um **repositório privado** e inclua-os lá.
+execute a ferramenta a partir de um **repositório privado** de sua propriedade e envie-os para lá.
 ## Descobertas
 As regras estão em `src/analyze.mjs`. Cada uma cita a regra escrita que ela aplica,
-portanto, uma descoberta pode ser contestada em relação a um padrão e não em relação ao gosto pessoal. As regras
+portanto, uma descoberta pode ser contestada em relação a um padrão e não em relação ao gosto. As regras
 que este repositório envia estão em [`rules/`](rules/):
 - [`rules/github-actions.md`](rules/github-actions.md): filtros de caminho, executores, tamanho da matriz, limite do arquivo de fluxo de trabalho, concorrência.
-- [`rules/shipcheck-product-standards.md`](rules/shipcheck-product-standards.md): o CI deve ser aprovado, os portões de lançamento, versões.
+- [`rules/shipcheck-product-standards.md`](rules/shipcheck-product-standards.md): o CI deve ser aprovado, os portões de envio, versões.
 - [`rules/repo-first.md`](rules/repo-first.md): o branch padrão.
 - [`rules/atlas-map.md`](rules/atlas-map.md): um mapa comprometido de cada repositório, verificado no CI.
 São os padrões de uma organização. Se os seus forem diferentes, altere o arquivo de regra
 e a regra juntos.
-As regras têm o cuidado de manter separados os itens que parecem semelhantes, porque combiná-los
-produz ruído:
-- **Um ramo padrão vermelho não é um ramo de pedido de alteração vermelho.** Um ramo do Dependabot que falhou é um item pendente; uma execução `push` que falhou no ramo padrão é um problema. A execução determina qual é o caso.
-- **O histórico não é um problema.** Um fluxo de trabalho movido para apenas gatilhos de lançamento mantém sua última falha no ramo padrão para sempre. Um fluxo de trabalho excluído mantém suas execuções. Nenhum dos dois é um defeito ativo.
-- **Uma verificação obrigatória que nada pode emitir não é uma verificação que não foi executada aqui.** Uma diz para remover o requisito; a outra diz para corrigir o gatilho. As correções contradizem-se.
-- **Um pedido de alteração que o gatilho ignorou não é um pedido de alteração com conflitos.** O GitHub não executa nenhum fluxo de trabalho de pedido de alteração em um pedido de alteração com conflitos, portanto, sua verificação ausente não diz nada sobre o gatilho. Esse precisa de uma nova base.
-- **Uma execução com falha não é uma execução cancelada.** `cancel-in-progress` existe para interromper execuções substituídas, portanto, os minutos cancelados geralmente são a regra de concorrência em funcionamento.
-- **O custo bruto não é o custo líquido.** O GitHub calcula os custos de repositórios públicos com o preço total e os reduz a zero. O custo bruto é o poder de computação real; o custo líquido é o dinheiro real. Eles nunca são somados.
-- **O que não é medido não é limpo.** Um repositório que o GitHub não está verificando relata zero alertas. Um repositório em que a verificação de custo não foi alcançada não tem linha de custo. Ambos são relatados como desconhecidos.
-A gravidade impulsiona uma pontuação de saúde: crítico 40, alto 15, médio 6, baixo 2, informativo 0, deduzido de 100. A pontuação classifica a atenção, não a qualidade.
-O [manual](https://mcp-tool-shop-org.github.io/housekeeping/handbook/) lista cada descoberta, comando, código de erro e tabela.
+As regras têm o cuidado de manter separados os itens que parecem semelhantes, porque combiná-los produz ruído:
+- **Um branch padrão vermelho não é um branch de solicitação de pull vermelho.** Um branch Dependabot com falha é um backlog; uma execução `push` com falha no branch padrão é
+uma falha. O evento da execução decide qual é.
+- **O histórico não é uma falha.** Um fluxo de trabalho movido para gatilhos apenas de lançamento mantém
+sua última falha no branch padrão para sempre. Um fluxo de trabalho excluído mantém suas execuções.
+Nenhum deles é um defeito ativo.
+- **Uma verificação obrigatória que nada pode emitir não é uma verificação que não foi executada aqui.**
+Uma diz para remover o requisito; a outra diz para corrigir o gatilho. As correções
+se contradizem.
+- **Uma solicitação de pull que o gatilho ignorou não é uma solicitação de pull com conflitos.** GitHub não executa
+nenhum fluxo de trabalho de solicitação de pull em uma solicitação de pull com conflitos, portanto, sua verificação ausente não diz nada sobre o gatilho. Essa precisa de uma rebase.
+- **Uma execução com falha não é uma execução cancelada.** `cancel-in-progress` existe para matar
+execuções substituídas, portanto, os minutos cancelados geralmente são a regra de concorrência em funcionamento.
+- **O custo bruto não é o custo líquido.** GitHub mede repositórios públicos com o preço total
+e os desconta para zero. O bruto é a computação real; o líquido é o dinheiro real.
+Eles nunca são somados.
+- **Não medido não é limpo.** Um repositório GitHub não está digitalizando relatórios
+zero alertas. Um repositório que a passagem de custo não alcançou não tem linha de custo. Ambos
+são relatados como desconhecidos.
+A gravidade impulsiona uma pontuação de integridade: crítico 40, alto 15, médio 6, baixo 2, informativo 0,
+deduzido de 100. A pontuação classifica a atenção, não a qualidade.
+O [manual](https://mcp-tool-shop-org.github.io/housekeeping/handbook/) lista todos os resultados, comandos, códigos de erro e tabelas.
 ## Segurança
-- **Somente leitura.** O coletor emite consultas GraphQL e solicitações REST `GET`. Ele nunca mescla, envia, lança, publica ou edita uma configuração.
-- **Sem credenciais.** A autenticação é o que `gh` já possui. Nada é gravado em disco sobre isso.
-- **Sem telemetria.** Os únicos hosts contatados são a API do GitHub, por meio de `gh`, e o registro npm, para pesquisa de versão e avisos.
+- **Apenas leitura.** O coletor emite GraphQL consultas e solicitações REST `GET`. Ele nunca
+combina, envia, lança, publica ou edita uma configuração.
+- **Sem credenciais.** A autenticação é o que `gh` já possui. Nada é
+gravado em disco a respeito.
+- **Sem telemetria.** Os únicos servidores contactados são a API GitHub, através de `gh`,
+e o registo npm, para verificar versões e avisos.
 - **O que ele armazena** é a parte sensível: veja "Mantenha os dados privados".
-Relate uma vulnerabilidade conforme descrito em [SECURITY.md](SECURITY.md).
+Reporte uma vulnerabilidade conforme descrito em [SECURITY.md](SECURITY.md).
 ## Testes
@@ -279,7 +294,10 @@ Relate uma vulnerabilidade conforme descrito em [SECURITY.md](SECURITY.md).
 npm test
 ```
-Cada regra é testada em ambas as direções: a forma que deve ser acionada e a forma vizinha que não deve ser. Um verificador separado deriva novamente uma amostra de descobertas do GitHub ativo por meio de seu próprio transporte e ignora, de forma sonora, quando não há banco de dados ou rede.
+Cada regra é testada em ambas as direções: a forma que deve ser ativada e a
+forma vizinha que não deve ser. Um verificador separado deriva novamente uma amostra de
+resultados a partir de GitHub em tempo real, através do seu próprio transporte, e ignora, de forma evidente, quando
+não há banco de dados ou rede.
 ## Licença

package/README.zh.md CHANGED Viewed

@@ -1,5 +1,5 @@
 <p align="center">
-  <a href="README.ja.md">日本語</a> | <a href="README.md">English</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
+  <a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh.md">中文</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.hi.md">हिन्दी</a> | <a href="README.it.md">Italiano</a> | <a href="README.pt-BR.md">Português (BR)</a>
 </p>
 <p align="center">
@@ -21,51 +21,51 @@
   <a href="https://mcp-tool-shop-org.github.io/housekeeping/handbook/"><img src="https://img.shields.io/badge/Handbook-read-blue" alt="Handbook" /></a>
 </p>
-一次扫描收集每个仓库的 CI 状态、未解决的问题和拉取请求、发布、版本标签、工作流文件、分支保护、安全警报、锁文件和 Actions 账单，并将所有内容存储到 SQLite 中，然后根据编写的规则对所有内容进行审核。
+一次扫描收集每个仓库的 CI 状态、未解决的问题和拉取请求、发布版本、版本标签、工作流文件、分支保护、安全警报、锁文件和 Actions 账单，并将所有这些信息汇总到 SQLite 中，然后根据编写的规则对其进行审核。
 它一次性回答整个组织的问题：
-- 哪些默认分支显示为红色，这是否表示主线已损坏或历史记录已过时？
+- 哪些默认分支显示为红色，这是否表示主线出现问题或历史记录已过时？
 - 哪些拉取请求永远无法合并，因为一个必需的检查未发出，从而阻止了它们？
 - 哪些部署被仓库自身的设置拒绝？
 - `package.json`、Git 标签和 npm 注册表之间的差异在哪里？
 - 哪些工作流违反了 Actions 成本规则，它们花费了多少，哪些任务花费了这些成本？
 - 哪些仓库包含 GitHub 自身的警报计数未识别的建议？
-它是一种审计工具，而不是修复工具。它读取 GitHub 数据，但不进行任何更改。
+它是一个审计工具，而不是一个修复工具。它读取 GitHub，但不进行任何更改。
 ## 每个仓库都有一个代理
 拥有数十个仓库的组织没有一个统一的地方来存储其状态。housekeeping 就是这个地方，它的 MCP 服务器 `hk-mcp` 将数据提供给一个 AI 代理。通过它，一个代理可以充当整个组织的协调器：
-1. **扫描。** `hk refresh` 提取每个仓库的快照。
-2. **分类。** 代理询问哪些内容显示为红色、哪些内容被阻止以及哪些内容变得更糟，并获得答案，这些答案可以区分已损坏的主线和过时的历史记录，以及区分停滞的拉取请求和冲突的拉取请求。
-3. **规划一个批次。** 一个 `hk_sql` 查询找到具有相同结构的每个仓库，因此修复变成每个仓库一个拉取请求，而不是一次性查找。
+1. **扫描。** `hk refresh` 对每个仓库进行一次快照。
+2. **分类。** 代理询问哪些内容显示为红色、哪些内容被阻止以及哪些内容变得更糟，并获得答案，这些答案可以区分出现问题的主线和过时的历史记录，以及区分停滞的拉取请求和冲突的拉取请求。
+3. **规划一个批次。** 一个 `hk_sql` 查询找到所有具有相同特征的仓库，因此修复可以变成每个仓库的一个拉取请求，而不是进行搜索。
 4. **执行工作。** housekeeping 从不进行写入。代理使用自己的工具，在自己的权限下打开拉取请求，并由您进行审核。
-5. **验证。** 再次扫描。如果发现的问题已解决，或者未解决，那么两次快照之间的差异就是一个查询。
+5. **验证。** 再次扫描。如果发现的问题已解决，或者没有解决，那么两次快照之间的差异就是一个查询。
 代理在一次或两次调用中回答的问题：
-- 哪些默认分支显示为红色，以及哪个任务和步骤导致了错误？
+- 哪些默认分支显示为红色，以及哪个任务和步骤导致了问题？
 - 哪些拉取请求永远无法合并，是触发器还是冲突导致了问题？
-- 哪些仓库包含生产建议，而 GitHub 没有显示任何警报？
-- 哪些计划工作流违反了计划规则，以及如何违反？
-- Actions 花费了多少，哪些任务花费了这些成本？
+- 哪些仓库包含一个生产建议，而 GitHub 没有显示任何警报？
+- 哪些计划的工作流违反了计划规则，以及如何违反？
+- Actions 花费了多少，哪个任务花费了这些成本？
 - 自上次扫描以来，发生了哪些变化？
 | 工具 | 它回答的问题 |
 |---|---|
 | `hk_summary` | 最新扫描的总计：仓库、问题、拉取请求、工作流、发现。 |
-| `hk_findings` | 按代码、严重程度、类别或仓库分类的发现；未筛选时，按代码计数。红色主线的发现会命名导致错误的作业和步骤。 |
+| `hk_findings` | 按代码、严重程度、类别或仓库分类的发现；未筛选时，按代码进行计数。红色主线的发现会显示导致问题的任务和步骤。 |
 | `hk_ci` | 默认分支显示为红色的仓库以及失败的工作流；还包括失败的计划、失败的拉取请求分支以及没有 CI 的仓库。 |
 | `hk_repo` | 完整的单个仓库：发现、工作流、未解决的拉取请求和问题。 |
 | `hk_backlog` | 整个组织中未解决的拉取请求或问题，按时间顺序排列。 |
 | `hk_health` | 每个仓库的健康评分，按从好到坏的顺序排列。 |
-| `hk_cost` | Actions 按仓库、工作流或作业花费的成本，分别显示总成本和净成本。 |
-| `hk_sql` | 针对仓库执行的单个只读 `SELECT` 或 `WITH` 语句。 |
-| `hk_schema` | 表和列，用于编写 `hk_sql` 查询。 |
+| `hk_cost` | 按仓库、工作流或任务分类的 Actions 支出，区分总支出和净支出。 |
+| `hk_sql` | 一个只读 `SELECT` 或 `WITH` 语句，用于查询仓库。 |
+| `hk_schema` | 用于编写 `hk_sql` 查询的表和列。 |
-每个答案都来自最新的快照，并且以只读方式打开。如果调用失败，则返回结构化的错误，而不是堆栈跟踪。
+每个答案都来自最新的快照，并且以只读方式打开。如果调用失败，则返回一个结构化的错误，而不是堆栈跟踪。
 ### 连接它
@@ -78,43 +78,43 @@
 }
 ```
-`HK_HOME` 是您从中进行扫描的目录。从克隆版本开始，使用 `"command": "node", "args": ["/path/to/housekeeping/src/mcp.mjs"]`。第二个服务器是 [Atlas](https://github.com/dogfood-lab/testing-os/tree/main/packages/atlas)，它回答关于单个仓库的相同代理的问题（参见下文）。在 Windows 上，通过 `cmd /c` 启动全局安装的命令。
+`HK_HOME` 是您从中进行扫描的目录。从克隆副本开始，使用 `"command": "node", "args": ["/path/to/housekeeping/src/mcp.mjs"]`。第二个服务器是 [Atlas](https://github.com/dogfood-lab/testing-os/tree/main/packages/atlas)，它回答关于单个仓库的相同代理的问题（请参见下文）。在 Windows 上，通过 `cmd /c` 启动全局安装的命令。
 ## housekeeping 和 Atlas
-[Atlas](https://github.com/dogfood-lab/testing-os/tree/main/packages/atlas) (`@dogfood-lab/atlas`) 映射一个仓库：它的各个部分以及它的入口，这意味着每个工作流及其运行、发布和部署的内容。该映射作为 `atlas/` 提交并检查到 CI 中。housekeeping 是组织视图。这两个工具是为协同工作而设计的。
+[Atlas](https://github.com/dogfood-lab/testing-os/tree/main/packages/atlas)
+(`@dogfood-lab/atlas`) 将一个仓库（包括其组成部分和入口）映射出来，即
+映射每个工作流程以及它所运行、发布和部署的内容。该映射会被提交
+为 `atlas/`，并在 CI 中进行检查。组织视图即为“家务管理”。两者
+的设计目的是协同工作。
-- **每个映射，都进行扫描。** 扫描读取每个仓库的已提交映射以及所有其他内容，并报告哪些仓库没有映射，哪些仓库从未运行 `atlas check`，以及哪些仓库包含与组织中其他仓库使用的引擎不同的引擎。
-- **红色运行失败的位置。** 当默认分支显示为红色时，该发现会命名失败的作业和步骤，并通过映射，命名该步骤运行的命令，因此修复从正确的文件开始。
-- **从映射中获取部署事实。** 作业部署到的环境是从映射中获取的，映射中记录了该环境，因此这两个工具以相同的方式读取工作流。
-- **整个组织中的警告。** Atlas 标记一个工作流步骤，该步骤将在运行之前失败，例如需要比作业安装的更新运行时环境的工具。该报告一次性列出所有仓库中的这些步骤。
+- **每个映射，都进行扫描。** 扫描读取每个仓库的已提交映射以及所有其他内容，并报告哪些仓库没有映射，哪些仓库从未运行 `atlas check`，以及哪些仓库使用与组织中其他仓库使用的不同的引擎。
+- **红色运行失败的位置。** 当默认分支显示为红色时，该发现会显示失败的任务和步骤，并通过映射显示该步骤运行的命令，因此修复从正确的文件开始。
+- **从映射中获取部署事实。** 工作流部署到的环境是从映射中获取的，映射中记录了该环境，因此这两个工具以相同的方式读取工作流。
+- **整个组织中的警告。** Atlas 标记一个工作流步骤，该步骤将在运行之前失败，例如需要比任务安装的更新运行时环境的工具。该报告一次性列出所有仓库中的这些步骤。
-使用这两个服务器的代理从“这十二个仓库被阻止” (housekeeping) 变为“这是工作流、作业和更改将影响的文件” (Atlas)，而无需手动打开每个仓库。
+使用这两个服务器的代理可以从“这十二个仓库被阻止” (housekeeping) 变为“这是工作流、任务和更改将影响的文件” (Atlas)，而无需手动打开每个仓库。
 ## 为什么它具有这种结构
 | 层 | 选择 | 原因 |
 |---|---|---|
-| 传输 | `gh` CLI | 它已经持有您的令牌。该工具从不存储或请求任何凭据。 |
-| 收集 | GitHub GraphQL，分页 | 一个查询返回一个页面中仓库的元数据、未解决的问题、未解决的拉取请求、发布和文件树。如果一个页面持续超时，则将其减半并从相同的游标重新请求。 |
+| 传输 | `gh` CLI | 它已经拥有您的令牌。该工具从不存储或请求任何凭据。 |
+| 收集 | GitHub GraphQL，分页 | 一个查询返回元数据、未解决的问题、未解决的拉取请求、发布版本和文件树，用于一页仓库。如果一页的查询超时，则将其减半并从相同的游标重新查询。 |
 | Actions 运行 | REST | GraphQL 没有 Actions 接口。 |
-| 操作需要成本 | 计费 API 加上每个作业的持续时间 | 发票上会显示哪个仓库；只有作业会显示哪个工作流程。GitHub 的 `/timing` 端点返回零，因此会重新计算每个作业的总和，然后与发票进行核对。 |
-| 运行器费率 | 从发票中读取 | 已计费的费率可能与列表价格不同，并且源中的常量会错误地显示每个数字。 |
-| 存储 | 通过内置的 `node:sqlite` 使用 SQLite | 没有本地构建步骤。 |
-| 事实来源 | `data/snapshots/*.json` | 原始、可比较且仅可追加。数据库是派生的：`npm run rebuild` 在离线状态下重建它。 |
+| Actions 成本 | 计费 API 加上每个任务的持续时间 | 发票上会显示哪个仓库；只有作业会显示哪个工作流程。GitHub的`/timing`端点返回零，因此会重新计算每个作业的总和，然后与发票进行核对。 |
+| 运行器费率 | 从发票中读取 | 已结算的费率可能与定价表中的价格不同，并且源中的常量会错误地显示每个数字。 |
+| 存储 | 通过内置的`node:sqlite`，使用SQLite | 没有本地构建步骤。 |
+| 事实来源 | `data/snapshots/*.json` | 原始、可比较且仅追加。数据库是派生的：`npm run rebuild`会离线重建它。 |
 | 扫描日志 | `data/sweeps.jsonl` | 每条扫描记录一行，包括失败的扫描和未发现任何新内容的扫描。 |
-快照是不可变的且具有累积性，因此两个日期之间的差异是 `JOIN`。
+快照是不可变的且具有累积性，因此两个日期之间的差异是`JOIN`。
 ## 要求
 - Node.js 22.5 或更高版本。
-- [GitHub CLI](https://cli.github.com/)，已登录（`gh auth status`），并且是
-可以读取组织的帐户。读取计费和安全警报
-需要相应的权限；如果没有，扫描会记录“未测量”并
-继续。它绝不会将缺少权限记录为干净的结果。
-- Windows 或 Linux。它在 Windows 上开发，其测试在 Linux 上运行
-CI。macOS 应该可以工作，但未进行测试。
+- [GitHub CLI](https://cli.github.com/)，已登录（作为可以读取组织的账户），登录账户为`gh auth status`。读取计费和安全警报需要相应的权限；如果没有这些权限，扫描会记录“未测量”，然后继续。它绝不会将缺少权限记录为干净的结果。
+- Windows 或 Linux。它在 Windows 上开发，其测试在 CI 中在 Linux 上运行。macOS应该可以工作，但未进行测试。
 ## 使用方法
@@ -124,8 +124,7 @@ mkdir warehouse && cd warehouse            # housekeeping keeps its data here
 hk refresh your-org                        # collect, load, analyze, write reports/AUDIT-<date>.md
 ```
-为了在扫描之间保留设置，请在 `housekeeping.config.json` 目录中放置一个
-文件（请参阅“配置”）；然后 `hk refresh` 不需要任何参数。
+为了在扫描之间保留设置，请在该目录中放置一个`housekeeping.config.json`（参见“配置”）；然后`hk refresh`不需要任何参数。
 或者从克隆运行，这样它的数据将保存在克隆中：
@@ -147,6 +146,8 @@ hk findings              # findings grouped by severity and code
 hk health                # per-repository health score, worst first
 hk repo <name>           # one repository in full
 hk prs                   # every open pull request by age
+hk branches              # branches by state: merged, moved after merge, no PR
+hk watch                 # open PRs, alerts and branches for a short watch list
 hk versions              # package.json against git tag against npm
 hk actions               # every workflow and its rule flags
 hk cost                  # Actions cost, gross and net side by side
@@ -154,20 +155,17 @@ hk sql "SELECT ..."      # one read-only statement
 hk help                  # every command and flag
 ```
-在没有 `npm link` 的克隆中，每次 `hk <command>` 都是 `node src/cli.mjs <command>`。
+在没有`npm link`的克隆中，每次`hk <command>`都是`node src/cli.mjs <command>`。
-`npm run rebuild` 会重新派生数据库和报告，这些报告来自已
-存储在磁盘上的快照，无需网络访问。
+`npm run rebuild`会重新从已在磁盘上的快照中派生数据库和报告，无需网络访问。
-一次完整的扫描会进行数百次 API 调用。不要在循环中运行 `refresh`。
+一次完整的扫描会进行几百次 API 调用。请勿在循环中运行`refresh`。
-结果输出到标准输出；进度和错误输出到标准错误。每个
-错误都会打印一个代码和一个提示。退出代码：0 表示正常，1 表示用户错误，2 表示运行时
-错误，3 表示部分（扫描已完成，但存在差距）。
+结果输出到标准输出；进度和错误输出到标准错误。每个错误都会打印一个代码和一个提示。退出代码：0 表示正常，1 表示用户错误，2 表示运行时错误，3 表示部分完成（扫描已完成，但存在差距）。
 ## 配置
-`housekeeping.config.json`，位于 housekeeping 运行的目录中（请参阅下文）：
+`housekeeping.config.json`，位于 housekeeping 运行的目录中（参见下文）：
 ```json
 {
@@ -176,73 +174,58 @@ hk help                  # every command and flag
 }
 ```
-- `org` 是要扫描的组织。`hk refresh <org>` 会覆盖它。如果
-两者都没有，扫描将拒绝启动。
-- `metaRepos` 是包含组织默认设置、资源或
-工具的仓库，而不是已发布的最终产品。它们不适用于仅
-对最终产品有意义的发现：缺少 README、LICENSE 和类似文件，没有
-工作流程，以及没有发布。
+- `org`是要扫描的组织。`hk refresh <org>`会覆盖它。如果两者都没有，扫描将拒绝启动。
+- `metaRepos`是包含组织默认设置、资产或工具的仓库，而不是已发布的最终产品。它们不包括仅对最终产品有意义的发现：缺少 README、LICENSE 和类似文件，没有工作流程，没有发布。
-格式不正确的文件是一个错误，绝不会是无声的默认值：未知的键、错误的
-类型或损坏的 JSON 会停止运行。
+格式不正确的文件是一个错误，绝不会是无声的默认值：未知的键、错误的类型或损坏的 JSON 会停止运行。
-Run from a clone, housekeeping keeps `data/`, `reports/` and the config file
-in the clone. Run as an installed package, it keeps them in the directory you
-run it from, or in `HK_HOME` when that is set.
+从克隆运行，housekeeping 会将`data/`、`reports/`和配置文件保存在克隆中。作为已安装的软件包运行，它会将它们保存在您运行它的目录中，或者在设置了`HK_HOME`时保存在那里。
-环境：`HK_HOME`（数据、报告和配置所在的位置）、
-`HK_CONFIG`（配置路径）、`HK_DB`（数据库路径）、`HK_LOG`
-（`silent`、`normal`、`verbose` 或 `debug`）、`HK_COST_REPOS` 和
-`HK_COST_BUDGET`（每个作业成本的上限）、`GH_PATH`（`gh` 的路径）。
+环境：`HK_HOME`（数据、报告和配置所在的位置）、`HK_CONFIG`（配置路径）、`HK_DB`（数据库路径）、`HK_LOG`（`silent`、`normal`、`verbose`或`debug`）、`HK_COST_REPOS`和`HK_COST_BUDGET`（每个作业成本限制）、`GH_PATH`（`gh`的路径）。
 ## 保护数据
-**扫描写入的内容是敏感信息。请勿将 `data/` 或 `reports/` 提交到
-公共仓库。**
+**扫描写入的内容是敏感信息。请勿将`data/`或`reports/`提交到公共仓库。**
-快照会记录私有仓库的名称和描述、每个
-公开的安全警报以及它引用的软件包、工作流程文件和 Actions
-计费。GitHub 会故意将公共仓库的安全警报隐藏起来，只向其维护者显示；发布的快照会将该列表提供给所有人。
+快照会记录私有仓库的名称和描述、每个与该仓库关联的开放安全警报、工作流程文件和 Actions 计费。GitHub会故意将公共仓库的安全警报从所有人（包括其维护者）那里隐藏；发布的快照会将该列表提供给所有人。
-此仓库的 `.gitignore` 排除 `data/`、`reports/` 和
-`housekeeping.config.json`。为了保留历史记录，这是快照的目的，
-请从您自己的**私有**仓库运行该工具，并将它们提交到那里。
+此仓库的`.gitignore`不包括`data/`、`reports/`和`housekeeping.config.json`。为了保留历史记录（这是快照的目的），请从您自己的**私有**仓库运行该工具，并将它们提交到那里。
 ## 发现
-规则位于 `src/analyze.mjs` 中。每个规则都引用了它所执行的书面规则，
-因此可以针对标准而不是针对个人喜好来争论发现。此仓库提供的规则位于 [`rules/`](rules/) 中：
+规则位于`src/analyze.mjs`中。每个规则都引用了它所执行的书面规则，因此可以针对标准而不是针对个人喜好来争论发现结果。此仓库提供的规则位于[`rules/`](rules/)中：
 - [`rules/github-actions.md`](rules/github-actions.md)：路径过滤器、运行器、矩阵大小、工作流程文件限制、并发。
 - [`rules/shipcheck-product-standards.md`](rules/shipcheck-product-standards.md)：CI 必须通过、发布门控、版本。
 - [`rules/repo-first.md`](rules/repo-first.md)：默认分支。
 - [`rules/atlas-map.md`](rules/atlas-map.md)：每个仓库的已提交映射，在 CI 中进行检查。
-这些是一个组织的标准。如果您的标准不同，请同时更改规则文件
-和规则。
+这些是一个组织的标准。如果您的标准不同，请同时更改规则文件和规则。
 规则会注意区分看起来相似的事物，因为将它们合并会产生噪音：
-- **默认分支为红色的状态并不意味着拉取请求分支也为红色。** 如果 Dependabot 分支出现故障，则表示存在未处理的问题；如果在默认分支上出现 `push` 运行失败，则表示存在错误。运行的事件决定了是哪种情况。
-- **历史记录并不等同于错误。** 如果工作流程被移动到仅触发发布，则其最后一次在默认分支上的失败状态将永久保留。即使删除了工作流程，其运行记录也会保留。两者都不是当前存在的缺陷。
-- **如果某个必需的检查无法执行，这并不意味着该检查未在此处运行。** 一种情况是建议取消该要求；另一种情况是建议修复触发器。这两种修复方法相互矛盾。
-- **如果触发器跳过了一个拉取请求，这并不意味着该拉取请求存在冲突。** GitHub 不会对存在冲突的拉取请求运行任何拉取请求工作流程，因此，如果缺少检查，则说明该触发器没有问题。在这种情况下，需要重新进行基准测试。
-- **失败的运行并不等同于已取消的运行。** `cancel-in-progress` 的作用是终止过时的运行，因此，通常情况下，已取消的运行是并发规则在起作用。
-- **总成本不等于净成本。** GitHub 对公共仓库收取全部费用，然后将其折扣为零。总成本是实际的计算成本；净成本是实际的支出。两者不能简单地相加。
-- **未测量的数据并不意味着数据是干净的。** 如果 GitHub 未对某个仓库进行扫描，则报告的警报数量为零。如果成本评估未达到某个阈值，则该仓库不会显示任何成本行。两者都将报告为未知。
+- **红色默认分支与红色拉取请求分支不同。** 失败的 Dependabot 分支是积压；在默认分支上失败的`push`运行是中断。事件决定了哪种情况。
+- **历史记录不是中断。** 移动到仅发布触发器的工作流程会永久保留其上次默认分支的失败。删除的工作流程会保留其运行记录。两者都不是实时缺陷。
+- **无法发出任何内容的必需检查不是未运行的检查。** 一个表示删除该要求；另一个表示修复触发器。这些修复相互矛盾。
+- **触发器跳过的拉取请求不是冲突的请求。** GitHub不会在具有冲突的拉取请求上运行任何拉取请求工作流程，因此其缺失的检查不会说明触发器。后者需要重新提交。
+- **失败的运行不是已取消的运行。** `cancel-in-progress`用于终止过时的运行，因此取消的分钟通常是并发规则在起作用。
+- **总成本不是净成本。** GitHub以全价对公共仓库进行计量，然后将其折扣为零。总成本是实际的计算量；净成本是实际的支出。两者绝不会相加。
+- **未测量不是干净。** 仓库GitHub不会扫描报告零个警报。成本通行证未到达的仓库没有成本行。两者都报告为未知。
-严重程度决定了健康评分：严重 40，高 15，中 6，低 2，信息 0，从 100 中扣除。评分衡量的是需要关注的程度，而不是质量。
+严重程度会影响健康评分：严重 40，高 15，中等 6，低 2，信息 0，从 100 中扣除。评分衡量的是需要关注的程度，而不是质量。
-[手册](https://mcp-tool-shop-org.github.io/housekeeping/handbook/) 列出了所有发现、命令、错误代码和表格。
+[手册](https://mcp-tool-shop-org.github.io/housekeeping/handbook/)
+列出了所有发现、命令、错误代码和表格。
 ## 安全性
-- **只读。** 收集器会发出 GraphQL 查询和 REST `GET` 请求。它绝不会合并、推送、发布、公开或编辑任何设置。
-- **不存储凭据。** 身份验证使用 `gh` 中已有的凭据。不会将任何凭据写入磁盘。
-- **不收集遥测数据。** 唯一联系的主机是 GitHub API（通过 `gh`）和 npm 注册表，用于查找版本和安全建议。
+- **只读。** 收集器会发出 GraphQL 个查询和 REST `GET` 请求。它绝不会
+合并、推送、发布、公开或编辑任何设置。
+- **无需凭据。** 身份验证使用 `gh` 中已有的凭据。不会将任何信息写入磁盘。
+- **不收集遥测数据。** 唯一联系的主机是 GitHub API（通过 `gh`）以及 npm 注册表，用于版本和安全建议查询。
 - **它存储的内容** 是敏感部分：请参阅“保护数据”。
-如 [SECURITY.md](SECURITY.md) 中所述，报告漏洞。
+请按照 [SECURITY.md](SECURITY.md) 中描述的方式报告漏洞。
 ## 测试
@@ -250,9 +233,9 @@ run it from, or in `HK_HOME` when that is set.
 npm test
 ```
-每个规则都从两个方向进行测试：必须触发的模式，以及不应触发的相邻模式。一个单独的验证器会从实时 GitHub 中重新推导出样本发现，并通过其自身的传输方式进行验证，并在没有数据库或没有网络时发出明确的警告。
+每个规则都会进行双向测试：测试必须触发的模式，以及不应触发的相邻模式。一个独立的验证器会通过其自身的传输方式，从实时 GitHub 中重新推导出样本发现，并在没有数据库或没有网络时发出警告。
-## 许可证
+## 许可
 MIT。请参阅 [LICENSE](LICENSE)。