Paper Polisher

Que fait Paper Polisher ?

Portée et Références

Utilisez cette compétence pour le polissage académique en anglais avec sécurité TeX, la traduction, la relecture, la vérification source-vers-sortie, la révision de terminologie ou de notation, la révision de cohérence numérique et la normalisation de notation explicitement autorisée.

Pour les articles complets, les longues sections, la vérification, les audits de cohérence, la normalisation ou le travail avec un guide de style strict, lisez references/tex_safe_polishing.md avant d'agir. Lisez references/tex_safe_polishing_zh.md à la place lorsque les conseils de flux de travail en chinois sont matériellement utiles ; ne chargez pas les deux uniquement pour dupliquer le contexte. Pour un polissage local court, utilisez les règles de base ci-dessous et consultez une référence uniquement si nécessaire.

N'utilisez pas cette compétence comme outil principal pour :

• les audits de nouveauté, de défendabilité de contribution, de base dangereuse ou d'attaque de relecteur ; utilisez idea-novelty-auditor si disponible ;
• la revue de littérature, le cadrage des lacunes, la sélection de références ou l'attribution de rôles de citations ; utilisez problem-driven-literature-review si disponible ;
• la reconstruction de l'histoire globale, de la structure de l'introduction ou du redesign expérience-affirmation ; utilisez paper-argument-reconstructor si disponible.

Lorsqu'une demande combine ces tâches avec du polissage, effectuez d'abord la tâche de raisonnement en amont et utilisez cette compétence uniquement pour le passage final de langage fidèle et de cohérence.

Sélection de Mode et Prééminence

Suivez l'action explicite demandée par l'utilisateur avant de considérer qui a produit l'entrée. La provenance seule ne remplace jamais une demande explicite de polissage, d'audit, de vérification ou de normalisation. Si plusieurs actions sont demandées, conservez leurs artefacts et rapports séparés, sauf si l'utilisateur demande un livrable combiné.

Les règles de sortie spécifiques au mode prévalent sur les règles de sortie basées sur la longueur du document. En particulier, une vérification de manuscrit complet ou un audit de cohérence uniquement reste sous forme de rapport uniquement.

Si l'utilisateur demande à la fois une normalisation de notation et un polissage de prose, effectuez et approuvez d'abord la normalisation, traitez le TeX normalisé comme la nouvelle base de référence, puis polissez par rapport à cette base de référence. N'essayez pas de valider un changement combiné de prose et de symbole comme une seule comparaison de normalisation.

Mode de Polissage par Défaut

Polissez ou traduisez le texte fourni tout en préservant chaque élément protégé. Pour un manuscrit complet, exécutez également des audits de terminologie, de notation et de cohérence numérique interne à la source et signalez les problèmes au niveau de la source sans les corriger silencieusement.

Mode de Vérification

Utilisez le mode de vérification lorsque l'utilisateur demande de comparer ou de vérifier la qualité d'un candidat par rapport à un original.

• Exigez à la fois l'original et le candidat pour tout jugement comparatif concernant le TeX, les mathématiques, les nombres, les unités, les signes, les citations, le sens technique ou la force des affirmations.
• Si l'original n'est pas disponible, inspectez uniquement les propriétés intrinsèques du candidat et marquez chaque vérification comparative source comme NON ÉVALUÉ ; n'inférez jamais la préservation à partir du seul candidat.
• Ne réécrivez ni ne réparez jamais le candidat en mode vérification, y compris les violations de règles strictes. Signalez chaque écart et son emplacement. Appliquez les correctifs uniquement dans un tour d'édition ou un mode séparé et explicitement demandé.
• Séparez les écarts introduits par le candidat des conflits de terminologie, de notation ou numériques déjà présents dans la source.

Mode d'Audit de Cohérence

Lorsque l'utilisateur demande uniquement une cohérence terminologique, de variable, de symbole, de notation ou numérique, ne réécrivez pas le manuscrit. Auditez la portée disponible et signalez les résultats TERM-*, SYM-* et NUM-* selon le cas. Laissez le texte source, les symboles, les valeurs, les unités et les signes inchangés.

Mode de Normalisation de Notation Approuvée

Utilisez ce mode uniquement lorsque l'utilisateur demande explicitement une normalisation et a approuvé un mappage exact de symboles. Un mappage approuvé doit identifier l'entité mathématique, les anciens et nouveaux symboles, la portée ou les emplacements concernés, et tout alias ou exclusion intentionnel.

• Appliquez uniquement les substitutions de symboles approuvées. Ne réinterprétez pas les définitions et ne choisissez pas un symbole canonique à la place de l'utilisateur.
• Enregistrez chaque substitution appliquée comme CHANGEMENT AUTORISÉ ; traitez toute différence mathématique, structurelle, textuelle ou numérique non mappée comme une erreur.
• Laissez tous les nombres, unités, pourcentages, dimensions, tailles d'échantillon, ordre des jetons numériques et signes positifs, négatifs ou plus-moins inchangés.
• Si un symbole concerné se trouve à l'intérieur d'un actif de figure indisponible ou non modifiable, d'un environnement personnalisé, d'un fichier généré ou d'une expansion de macro non résolue, signalez l'emplacement non résolu et ne prétendez pas à une normalisation complète.
• Validez le résultat normalisé par rapport au mappage approuvé. Si une comparaison tenant compte du mappage n'est pas disponible, obtenez l'approbation du TeX normalisé comme nouvelle base de référence approuvée par l'auteur, puis utilisez une comparaison stricte par rapport à cette base de référence pour tout polissage ultérieur.

N'utilisez pas --allow-additions pour autoriser des changements de symboles. Ne modifiez aucun nombre, unité ou signe numérique dans aucun mode de Paper Polisher, même après avoir signalé un conflit NUM-*. Demandez à l'utilisateur de corriger la source en dehors de cette compétence et de fournir le TeX corrigé comme nouvelle base de référence approuvée par l'auteur ; n'inférez et n'appliquez jamais une valeur de remplacement.

Protocole de Couverture et de Résultat Partagé

Signalez séparément la couverture et le résultat pour chaque audit de terminologie, de notation et de cohérence numérique.

• Couverture : MANUSCRIT COMPLET signifie que la porte d'exhaustivité ci-dessous a été franchie.
• Couverture : PARTIELLE signifie que seule la portée locale ou résoluble déclarée a été auditée.
• Résultat : RÉUSSI signifie qu'aucun conflit ou ambiguïté non résolue n'a été trouvé dans la portée évaluée.
• Résultat : PROBLÈME SIGNALÉ signifie qu'au moins une incohérence claire a été trouvée et qu'aucun résultat ne nécessite encore une décision de l'auteur.
• Résultat : DÉCISION DE L'AUTEUR REQUISE signifie qu'au moins un résultat plausible ne peut pas être résolu à partir du seul manuscrit. Les problèmes confirmés restent individuellement étiquetés PROBLÈME SIGNALÉ.
• Résultat : NON ÉVALUÉ signifie que cet audit ou cette comparaison n'a pas pu être effectué du tout. Ne l'utilisez pas simplement parce que la couverture est partielle.

Attribuez des identifiants de constatation déterministes dans l'ordre des fichiers (relatif à la racine) et source : TERM-001, SYM-001 et NUM-001. Donnez à chaque constatation un emplacement exact de fichier et de ligne lorsque les fichiers sont disponibles ; sinon, utilisez la section, l'équation, le tableau, l'algorithme, la légende ou l'ancre de texte cité la plus stable disponible.

Utilisez PROBLÈME SIGNALÉ pour une incohérence confirmée. Utilisez DÉCISION DE L'AUTEUR REQUISE lorsque les preuves ne peuvent pas établir si les usages comparés se réfèrent à la même entité, au même concept, à la même quantité ou à la même condition expérimentale, ou si leur différence est intentionnelle. Gardez la certitude du conflit séparée de la remédiation : un conflit confirmé reste PROBLÈME SIGNALÉ même lorsque l'auteur doit encore choisir le terme, le symbole ou la valeur de remplacement.

Porte d'Exhaustivité pour Manuscrit Complet

Ne revendiquez une couverture MANUSCRIT COMPLET qu'après que toutes les conditions suivantes sont vraies :

1. Identifiez le fichier TeX racine faisant autorité et résolvez chaque directive \input, \include, \subfile, \import et équivalent atteignable statiquement dans l'ordre du document.
2. Tenez compte des inclusions manquantes, conditionnelles, générées par des macros, générées ou cycliques, et de chaque annexe ou supplément porteur de notation.
3. Inspectez les macros utilisateur produisant de la notation et les environnements mathématiques personnalisés ; ne vous fiez pas à un passage de script de préservation pour les développer ou les comprendre.
4. Inspectez la notation et les affirmations numériques dans la prose, les équations, les algorithmes, les légendes, les tableaux et les actifs de figures fournis. Si un actif contient du texte intégré pertinent mais ne peut pas être inspecté, la couverture est partielle. Si la normalisation affecte une figure mais que la source modifiable n'est pas disponible, la normalisation est incomplète.
5. Conservez les emplacements de fichier et de ligne relatifs à la racine pour les constatations et vérifiez qu'aucune portée demandée n'a été sautée.

Si une condition échoue, indiquez le manque de couverture et utilisez Couverture : PARTIELLE. Un téléchargement complet de fichier n'établit pas en soi une couverture analytique complète.

Règles Non Négociables

• Préservez les structures TeX, les environnements, les citations, les étiquettes, les références, les clés de bibliographie, les noms de fonctions, les noms de modules, les noms d'ensembles de données, les noms de métriques et le sens technique.
• Préservez les arguments et les clés exacts à l'intérieur des commandes structurelles telles que \label{...}, \ref{...}, \eqref{...}, \includegraphics{...}, les commandes de citation, \bibitem{...} et les clés BibTeX. Ne les renommez pas, ne les fusionnez pas, ne les supprimez pas, ne les réordonnez pas et ne les normalisez pas.
• Traitez les commentaires et la source littérale ou de type code, y compris les environnements comment, verbatim, de code listing et les commandes littérales en ligne, comme une source protégée exacte dans chaque mode. Ne déplacez pas la prose dans ou hors de ces régions, ne transformez pas un commentaire en ligne en commentaire de ligne entière et ne les déplacez pas à travers les structures TeX ou mathématiques protégées.
• Préservez chaque région mathématique originale et son ordre dans le document lors du polissage, de la traduction, de l'ajout de prose et de la vérification. La seule exception est une substitution exacte listée dans un mappage de notation approuvé par l'auteur.
• Préservez chaque nombre, unité, pourcentage, dimension, paramètre, taille d'échantillon, valeur de tableau, valeur rapportée dans une figure, marqueur de signification, ordre des jetons numériques et signe positif, négatif ou plus-moins lors du polissage, de la traduction, de l'ajout de prose, de la vérification, de l'audit de cohérence et de la normalisation de notation. Cela inclut les chiffres intégrés dans les identifiants et les jetons numériques à l'intérieur des commentaires, des exemples littéraux, des URL ou des arguments de commande protégés. Il n'y a aucune exception d'édition numérique dans cette compétence, et --allow-additions n'assouplit pas cette règle.
• Traitez la préservation source-vers-sortie et la cohérence interne à la source comme des vérifications séparées. Les conflits internes à la source (terminologie, symbole, valeur, unité ou signe) sont des constatations, pas une autorisation à éditer.
• Ne corrigez jamais une valeur suspecte dans cette compétence. Après avoir signalé une constatation NUM-*, demandez à l'utilisateur de réviser la source en externe et de renvoyer une base de référence approuvée par l'auteur.
• Ne modifiez pas les définitions mathématiques, les conditions de théorème, la logique de preuve, les étapes d'algorithme, les paramètres expérimentaux, les résultats rapportés, les bases de référence ou les ensembles de données.
• Ne modifiez pas les enregistrements ou les identifiants de bibliographie dans cette compétence. Une demande de nettoyage de référence peut autoriser uniquement des modifications de métadonnées non numériques et non identifiantes qui n'entrent pas en conflit avec une autre règle protégée ; les années, les pages, les volumes, les numéros de fascicule, les identifiants DOI/URL/arXiv et tout autre jeton numérique doivent être corrigés en dehors de Paper Polisher et renvoyés comme une base de référence approuvée par l'auteur.
• N'inventez pas d'affirmations, d'expériences, de garanties, de valeur de déploiement, de limitations ou de conclusions.
• Ne variez pas les termes techniques uniquement pour la variété stylistique. Utilisez les termes canoniques uniquement lorsque leur mappage d'entité est pris en charge.
• Évitez la répétition mécanique dans les débuts de phrase, l'ordre des propositions, la voix, les transitions et la structure des paragraphes sans modifier le contenu protégé.
• N'utilisez pas la ponctuation par tiret dans la prose d'un manuscrit rédigé par l'auteur. Préservez exactement les traits d'union lexicaux, les signes moins mathématiques, les valeurs signées, les clés protégées, les URL, les chaînes DOI, les noms de fichiers, les clés de citation et les métadonnées de bibliographie.

Si une modification demandée violerait ces règles et n'est pas couverte par un mappage approuvé exact, arrêtez cette modification et signalez quelle autorisation ou information source manque. Si votre propre brouillon viole une règle, révisez-le avant de le retourner.

Flux de Travail

1. Sélectionnez le mode à partir de l'intention explicite de l'utilisateur et identifiez la portée fournie.
2. Pour un travail sur manuscrit complet, appliquez la porte d'exhaustivité et préservez l'ordre résolu du document.
3. Construisez les registres pertinents :
   • terminologie : entité, terme canonique, formes contextuelles autorisées, définitions et emplacements ;
   • notation : entité mathématique, symbole, définitions et utilisations, portée, type ou dimensions, cadre et alias ;
   • numérique : quantité mesurée ou configurée, valeur, unité, signe, condition, emplacement source et utilisations correspondantes dans la prose/tableau/figure.
4. En mode polissage, révisez la prose tout en gardant les mathématiques protégées et l'ordre des jetons numériques fixes. Réordonnez les propositions ou les phrases uniquement si cela ne réordonne pas les mathématiques protégées, les nombres, les unités ou les signes.
5. Effectuez des vérifications de cohérence bidirectionnelles : entité vers terme ou symbole, terme ou symbole vers entité, et quantité ou condition expérimentale vers valeur, unité et signe rapportés.
6. Effectuez des vérifications d'architecture de phrase, de prose sans tiret, de ton objectif et de limites d'affirmation dans la portée évaluée.
7. Lorsque les fichiers originaux et candidats sont disponibles, exécutez le vérificateur de préservation. Utilisez le mode projet pour un manuscrit multi-fichiers.
8. Retournez la sortie spécifique au mode et distinguez les changements autorisés, les constatations au niveau de la source, les écarts introduits par le candidat et les vérifications non évaluées.

Vérificateur de Préservation

Pour un fichier TeX original et un fichier candidat, effectuez une comparaison stricte :

python3 paper-polisher/scripts/check_preservation.py original.tex candidate.tex

Utilisez --allow-additions uniquement lorsque l'utilisateur a autorisé des ajouts de prose ordinaires :

python3 paper-polisher/scripts/check_preservation.py original.tex candidate.tex --allow-additions

Cette option ne permet pas de nouvelles clés structurelles, régions mathématiques, jetons numériques, unités ou signes supprimés, modifiés ou réordonnés. Les commentaires reconnus et les régions littérales ou de type code restent une source protégée exacte, y compris leur limite de commentaire en ligne ou de ligne entière et leur ordre par rapport aux mathématiques et TeX protégés. Comparez manuellement toute macro littérale personnalisée ou non reconnue. Cela n'autorise pas de nouvelles figures, tableaux, équations, références, actifs d'image ou mappages de symboles. Établissez une base de référence approuvée par l'auteur pour les modifications structurelles protégées intentionnelles, ou utilisez du TeX corrigé en externe et approuvé par l'auteur comme nouvelle base de référence lorsque le contenu numérique a dû être corrigé en dehors de Paper Polisher.

Pour un manuscrit multi-fichiers, passez les deux fichiers TeX racine faisant autorité et activez la traversée de projet :

python3 paper-polisher/scripts/check_preservation.py original/main.tex candidate/main.tex --project

Le mode projet résout les directives \input, \include, \subfile, \subfileinclude, \import, \subimport, \inputfrom, \subinputfrom, \includefrom et \subincludefrom atteignables statiquement à partir de chaque racine, y compris les dépendances de package actuelles et de répertoire privé.