Changeset 3734482

Timestamp:

10/08/2026 12:03:11 PM (2 weeks ago)

Author:

muze233

Message:

Release 0.5.3: review-set adoption tally, inert DOMParser text extraction, review-workflow configuration guard, editor content-support restructure

Location:

npcink-workflow-toolbox

Files:

• tags/0.5.3 (copied) (copied from npcink-workflow-toolbox/trunk )
• tags/0.5.3/assets/admin.css (modified) (1 diff)
• tags/0.5.3/assets/admin.js (modified) (2 diffs)
• tags/0.5.3/assets/editor-content-support/text-utils.js (modified) (1 diff)
• tags/0.5.3/includes/Plugin.php (modified) (1 diff)
• tags/0.5.3/includes/Rest_Controller.php (modified) (3 diffs)
• tags/0.5.3/includes/Rest_Editor_Audio_Text.php (added)
• tags/0.5.3/includes/Rest_Editor_Content_Support.php (modified) (35 diffs)
• tags/0.5.3/includes/Rest_Editor_Flow_Cache.php (added)
• tags/0.5.3/includes/Rest_Editor_Paragraph_Check.php (added)
• tags/0.5.3/includes/Rest_Editor_Taxonomy_Shaping.php (added)
• tags/0.5.3/includes/Settings.php (modified) (2 diffs)
• tags/0.5.3/languages/npcink-workflow-toolbox-zh_CN-npcink-toolbox-admin.json (modified) (1 diff)
• tags/0.5.3/npcink-workflow-toolbox.php (modified) (2 diffs)
• tags/0.5.3/readme.txt (modified) (2 diffs)
• tags/0.5.3/uninstall.php (modified) (1 diff)
• trunk/assets/admin.css (modified) (1 diff)
• trunk/assets/admin.js (modified) (2 diffs)
• trunk/assets/editor-content-support/text-utils.js (modified) (1 diff)
• trunk/includes/Plugin.php (modified) (1 diff)
• trunk/includes/Rest_Controller.php (modified) (3 diffs)
• trunk/includes/Rest_Editor_Audio_Text.php (added)
• trunk/includes/Rest_Editor_Content_Support.php (modified) (35 diffs)
• trunk/includes/Rest_Editor_Flow_Cache.php (added)
• trunk/includes/Rest_Editor_Paragraph_Check.php (added)
• trunk/includes/Rest_Editor_Taxonomy_Shaping.php (added)
• trunk/includes/Settings.php (modified) (2 diffs)
• trunk/languages/npcink-workflow-toolbox-zh_CN-npcink-toolbox-admin.json (modified) (1 diff)
• trunk/npcink-workflow-toolbox.php (modified) (2 diffs)
• trunk/readme.txt (modified) (2 diffs)
• trunk/uninstall.php (modified) (1 diff)

npcink-workflow-toolbox/tags/0.5.3/assets/admin.css

@@ -4251 +4251 @@
         color: #b32d2e;
 }
+
+.npcink-toolbox__review-tally {
+        display: flex;
+        flex-wrap: wrap;
+        align-items: center;
+        gap: 6px 8px;
+        margin: 10px 0 0;
+        padding: 8px 10px;
+        background: #fff;
+        border: 1px solid #dcdcde;
+        border-left: 4px solid #72aee6;
+        border-radius: 4px;
+        font-size: 12px;
+}
+
+.npcink-toolbox__review-tally-summary {
+        font-weight: 600;
+}
+
+.npcink-toolbox__review-tally-note {
+        color: #50575e;
+}

npcink-workflow-toolbox/tags/0.5.3/assets/admin.js

@@ -415 +415 @@
                 }
 
+                maybeAttachReviewTally(form, result);
+
                 return result;
+        }
+
+        const REVIEW_TALLY_FORM_SETS = [
+                ['data-toolbox-comment-moderation-review', 'comment_moderation'],
+                ['data-toolbox-taxonomy-tag-review', 'taxonomy_tag'],
+                ['data-toolbox-internal-link-review', 'internal_link'],
+                ['data-toolbox-flagged-media-review', 'flagged_media'],
+                ['data-toolbox-media-alt-caption-review', 'media_alt'],
+        ];
+        let reviewTallySummaryPromise = null;
+
+        function reviewTallySummary() {
+                if (!reviewTallySummaryPromise) {
+                        reviewTallySummaryPromise = fetch(joinRestUrl(config.restUrl, 'review-tally/summary'), {
+                                headers: { 'X-WP-Nonce': config.nonce || '' },
+                        }).then((response) => (response.ok ? response.json() : null)).then((summary) => {
+                                // Neither a rejected fetch nor a non-ok response is cached:
+                                // the next attached bar retries instead of showing a stale
+                                // zero count that the decision gate could mistake for data.
+                                if (!summary) {
+                                        reviewTallySummaryPromise = null;
+                                }
+                                return summary;
+                        }).catch(() => {
+                                reviewTallySummaryPromise = null;
+                                return null;
+                        });
+                }
+                return reviewTallySummaryPromise;
+        }
+
+        function paintReviewTallyBars(summary) {
+                // Paint from live DOM state (no closure registry to leak when
+                // result nodes are re-rendered).
+                document.querySelectorAll('.npcink-toolbox__review-tally[data-review-set]').forEach((bar) => {
+                        const line = bar.querySelector('.npcink-toolbox__review-tally-summary');
+                        if (line) {
+                                line.textContent = summary ? reviewTallyLine(summary, bar.getAttribute('data-review-set')) : t('Counts unavailable. Try reloading.');
+                        }
+                });
+        }
+
+        function reviewTallyLine(summary, setKey) {
+                const set = summary && summary.sets && summary.sets[setKey] ? summary.sets[setKey] : { accepted: 0, ignored: 0 };
+                const windowDays = summary && summary.window_days ? Number(summary.window_days) : 7;
+                const label = 7 === windowDays ? t('Last 7 days') : t('Last %d days').replace('%d', String(windowDays));
+                return label + ': ' + Number(set.accepted || 0) + ' ' + t('accepted') + ' / ' + Number(set.ignored || 0) + ' ' + t('ignored');
+        }
+
+        function maybeAttachReviewTally(form, result) {
+                const match = REVIEW_TALLY_FORM_SETS.find(([attr]) => form.hasAttribute(attr));
+                if (!match || !result) {
+                        return;
+                }
+                const setKey = match[1];
+                if (result.querySelector('.npcink-toolbox__review-tally')) {
+                        return;
+                }
+                const bar = el('div', 'npcink-toolbox__review-tally');
+                bar.setAttribute('data-review-set', setKey);
+                const acceptButton = el('button', 'button button-small');
+                acceptButton.type = 'button';
+                acceptButton.textContent = t('Accept +1');
+                const ignoreButton = el('button', 'button button-small');
+                ignoreButton.type = 'button';
+                ignoreButton.textContent = t('Ignore +1');
+                const line = el('span', 'npcink-toolbox__review-tally-summary');
+                const note = el('span', 'npcink-toolbox__review-tally-note');
+                note.textContent = t('Local counts only. No content is written.');
+                bar.appendChild(acceptButton);
+                bar.appendChild(ignoreButton);
+                bar.appendChild(line);
+                bar.appendChild(note);
+                result.appendChild(bar);
+
+                line.textContent = t('Counts unavailable. Try reloading.');
+                const initialSummaryPromise = reviewTallySummary();
+                initialSummaryPromise.then((summary) => {
+                        // A mark may have completed while this fetch was pending and
+                        // already painted fresh counts; a stale read must not overwrite
+                        // them, so only paint if the shared cache still holds this
+                        // promise's result.
+                        if (reviewTallySummaryPromise === initialSummaryPromise) {
+                                line.textContent = summary ? reviewTallyLine(summary, setKey) : t('Counts unavailable. Try reloading.');
+                        }
+                });
+
+                function mark(decision) {
+                        // Both buttons lock for the whole flight: a concurrent click on
+                        // the sibling would append a second server-side mark.
+                        acceptButton.disabled = true;
+                        ignoreButton.disabled = true;
+                        line.textContent = '';
+                        fetch(joinRestUrl(config.restUrl, 'review-tally/mark'), {
+                                method: 'POST',
+                                headers: { 'Content-Type': 'application/json', 'X-WP-Nonce': config.nonce || '' },
+                                body: JSON.stringify({ review_set: setKey, decision }),
+                        }).then((response) => (response.ok ? response.json() : null)).then((summary) => {
+                                if (!summary) {
+                                        line.textContent = t('Could not save the tally mark. Try again.');
+                                        return;
+                                }
+                                reviewTallySummaryPromise = Promise.resolve(summary);
+                                paintReviewTallyBars(summary);
+                        }).catch(() => {
+                                line.textContent = t('Could not save the tally mark. Try again.');
+                        }).finally(() => {
+                                acceptButton.disabled = false;
+                                ignoreButton.disabled = false;
+                        });
+                }
+                acceptButton.addEventListener('click', () => mark('accepted'));
+                ignoreButton.addEventListener('click', () => mark('ignored'));
         }
 
@@ -595 +710 @@
                         result.appendChild(createRawDetails(error, 'Error payload'));
                 }
+                maybeAttachReviewTally(form, result);
         }
 

npcink-workflow-toolbox/tags/0.5.3/assets/editor-content-support/text-utils.js

@@ -21 +21 @@
                         return '';
                 }
-                if (typeof window !== 'undefined' && window.document) {
-                        const container = window.document.createElement('div');
-                        container.innerHTML = source;
-                        return String(container.textContent || container.innerText || '').replace(/\s+/g, ' ').trim();
+                // DOMParser documents are inert by specification: no script
+                // execution and no resource fetches, unlike innerHTML on a
+                // detached div, where inline handlers and image loads in block
+                // HTML can still fire while the text is extracted.
+                if (typeof window !== 'undefined' && typeof window.DOMParser === 'function') {
+                        const parsed = new window.DOMParser().parseFromString(source, 'text/html');
+                        return String(parsed.body.textContent || '').replace(/\s+/g, ' ').trim();
                 }
+                // Best-effort tag stripping for environments without DOMParser:
+                // malformed markup with '>' inside attribute values can leak tag text.
                 return source.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim();
         }

npcink-workflow-toolbox/tags/0.5.3/includes/Plugin.php

@@ -13 +13 @@
 
 final class Plugin {
-        public const OPTION_NAME           = 'npcink_toolbox_settings';
-        public const CONTEXT_OPTION_NAME   = 'npcink_toolbox_content_context';
-        public const MEDIA_OPTION_NAME     = 'npcink_toolbox_media_optimization_settings';
-        public const WATERMARK_OPTION_NAME = 'npcink_toolbox_watermark_templates';
-        public const REST_NAMESPACE        = 'npcink-toolbox/v1';
+        public const OPTION_NAME              = 'npcink_toolbox_settings';
+        public const CONTEXT_OPTION_NAME      = 'npcink_toolbox_content_context';
+        public const MEDIA_OPTION_NAME        = 'npcink_toolbox_media_optimization_settings';
+        public const WATERMARK_OPTION_NAME    = 'npcink_toolbox_watermark_templates';
+        public const REVIEW_TALLY_OPTION_NAME = 'npcink_toolbox_review_tally';
+        public const REST_NAMESPACE           = 'npcink-toolbox/v1';
 
         private static ?Plugin $instance = null;

npcink-workflow-toolbox/tags/0.5.3/includes/Rest_Controller.php

@@ -95 +95 @@
                 $this->post( '/nightly-inspection/cloud-batch/(?P<run_id>[A-Za-z0-9._:-]+)/result', 'nightly_inspection_cloud_batch_result' );
                 $this->post( '/nightly-inspection/cloud-batch/(?P<run_id>[A-Za-z0-9._:-]+)/retry', 'nightly_inspection_cloud_batch_retry' );
+                $this->post( '/review-tally/mark', 'review_tally_mark' );
+                $this->get( '/review-tally/summary', 'review_tally_summary' );
 
                 register_rest_route(
@@ -235 +237 @@
                         '/ai/content-support'                      => 'cap.toolbox.workflow_suggest',
                         '/ai/site-helpers'                         => 'cap.toolbox.workflow_suggest',
+                        '/review-tally/mark'                       => 'cap.toolbox.workflow_suggest',
+                        '/review-tally/summary'                    => 'cap.toolbox.workflow_suggest',
                         '/ai/image-generation'                     => 'cap.toolbox.image_source',
                         '/flows/article-plan'                      => 'cap.toolbox.workflow_suggest',
@@ -328 +332 @@
         public function nightly_inspection_cloud_batch_result( WP_REST_Request $request ) {
                 return $this->nightly_bridges->nightly_inspection_cloud_batch_result( $request );
+        }
+
+        public function review_tally_mark( WP_REST_Request $request ) {
+                $review_set = sanitize_key( (string) $request->get_param( 'review_set' ) );
+                $decision   = sanitize_key( (string) $request->get_param( 'decision' ) );
+                if ( ! array_key_exists( $review_set, Settings::REVIEW_TALLY_SETS ) ) {
+                        return new WP_Error(
+                                'npcink_toolbox_review_tally_unknown_set',
+                                __( 'A supported review set is required.', 'npcink-workflow-toolbox' ),
+                                array( 'status' => 400 )
+                        );
+                }
+                if ( ! in_array( $decision, array( 'accepted', 'ignored' ), true ) ) {
+                        return new WP_Error(
+                                'npcink_toolbox_review_tally_invalid_decision',
+                                __( 'The tally decision must be accepted or ignored.', 'npcink-workflow-toolbox' ),
+                                array( 'status' => 400 )
+                        );
+                }
+                $this->settings->record_review_tally_mark( $review_set, $decision );
+                return rest_ensure_response( $this->settings->review_tally_summary() );
+        }
+
+        public function review_tally_summary( WP_REST_Request $request ) {
+                $requested_days = absint( $request->get_param( 'days' ) );
+                $days           = $requested_days ? max( 1, min( 90, $requested_days ) ) : 7;
+                return rest_ensure_response( $this->settings->review_tally_summary( $days ) );
         }
 

npcink-workflow-toolbox/tags/0.5.3/includes/Rest_Editor_Content_Support.php

@@ -23 +23 @@
 defined( 'ABSPATH' ) || exit;
 
-final class Rest_Editor_Content_Support extends Rest_Controller_Support {
+final class Rest_Editor_Content_Support extends Rest_Editor_Flow_Cache {
 
         private const EDITOR_SUMMARY_FULL_CONTENT_MAX_CHARS = 30000;
-        private const EDITOR_AUDIO_TEXT_MAX_CHARS           = 5000;
         private const EDITOR_SELECTED_TEXT_MAX_CHARS        = 2000;
         private const EDITOR_COMMENT_TEXT_MAX_CHARS         = 1200;
-        private const EDITOR_FLOW_CACHE_TTL                 = 300;
         private const EDITOR_PROGRESSIVE_TARGET_MS          = 2500;
         private const EDITOR_PROGRESSIVE_CANDIDATE_LIMIT    = 8;
 
-        private Provider_Client $client;
         private Publish_Preflight_Service $publish_preflight;
 
@@ -210 +207 @@
         private function editor_post_context( WP_REST_Request $request ): array {
                 $content_raw         = (string) $request->get_param( 'content' );
-                $audio_preferences   = $this->editor_audio_preferences_from_request( $request );
+                $audio_preferences   = Rest_Editor_Audio_Text::editor_audio_preferences_from_request( $request );
                 $content             = trim( wp_strip_all_tags( $content_raw ) );
                 $selected_text       = trim( wp_strip_all_tags( (string) $request->get_param( 'selected_text' ) ) );
@@ -232 +229 @@
                         'excerpt'                    => sanitize_textarea_field( (string) $request->get_param( 'excerpt' ) ),
                         'content_text'               => wp_trim_words( $content, 220, '' ),
-                        'content_full_text'          => sanitize_textarea_field( $this->editor_trim_chars( $content, self::EDITOR_SUMMARY_FULL_CONTENT_MAX_CHARS ) ),
-                        'content_audio_text'         => sanitize_textarea_field( $this->editor_trim_chars( $this->editor_audio_text_from_raw_content( $content_raw, $audio_preferences ), self::EDITOR_AUDIO_TEXT_MAX_CHARS ) ),
+                        'content_full_text'          => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( $content, self::EDITOR_SUMMARY_FULL_CONTENT_MAX_CHARS ) ),
+                        'content_audio_text'         => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( Rest_Editor_Audio_Text::editor_audio_text_from_raw_content( $content_raw, $audio_preferences ), Rest_Editor_Audio_Text::EDITOR_AUDIO_TEXT_MAX_CHARS ) ),
                         'selected_text'              => wp_trim_words( sanitize_textarea_field( $selected_text ), 110, '' ),
                         'selected_block_text'        => wp_trim_words( sanitize_textarea_field( $selected_block_text ), 110, '' ),
-                        'selected_text_full'         => sanitize_textarea_field( $this->editor_trim_chars( $selected_text, self::EDITOR_SELECTED_TEXT_MAX_CHARS ) ),
-                        'selected_block_text_full'   => sanitize_textarea_field( $this->editor_trim_chars( $selected_block_text, self::EDITOR_SELECTED_TEXT_MAX_CHARS ) ),
+                        'selected_text_full'         => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( $selected_text, self::EDITOR_SELECTED_TEXT_MAX_CHARS ) ),
+                        'selected_block_text_full'   => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( $selected_block_text, self::EDITOR_SELECTED_TEXT_MAX_CHARS ) ),
                         'selected_block_name'        => sanitize_text_field( (string) $request->get_param( 'selected_block_name' ) ),
                         'user_instruction'           => wp_trim_words( sanitize_textarea_field( $user_instruction ), 60, '' ),
@@ -255 +252 @@
                         'comment_id'                 => absint( $request->get_param( 'comment_id' ) ),
                         'comment_author'             => sanitize_text_field( (string) $request->get_param( 'comment_author' ) ),
-                        'comment_text'               => sanitize_textarea_field( $this->editor_trim_chars( trim( wp_strip_all_tags( (string) $request->get_param( 'comment_text' ) ) ), self::EDITOR_COMMENT_TEXT_MAX_CHARS ) ),
-                );
-        }
-
-        private function editor_audio_preferences_from_request( WP_REST_Request $request ): array {
-                $raw = $request->get_param( 'audio_preferences' );
-                if ( ! is_array( $raw ) ) {
-                        $raw = array();
-                }
-
-                $defaults    = array(
-                        'tone'     => 'calm',
-                        'pace'     => 'normal',
-                        'handling' => 'skip_code',
-                        'focus'    => 'product_names',
-                );
-                $allowed     = array(
-                        'tone'     => array( 'calm', 'formal', 'casual', 'expressive' ),
-                        'pace'     => array( 'normal', 'slow', 'fast' ),
-                        'handling' => array( 'skip_code', 'read_code', 'skip_tables' ),
-                        'focus'    => array( 'product_names', 'numbers', 'headings' ),
-                );
-                $preferences = array();
-                foreach ( $defaults as $key => $default ) {
-                        $value               = sanitize_key( (string) ( $raw[ $key ] ?? $default ) );
-                        $preferences[ $key ] = in_array( $value, $allowed[ $key ], true ) ? $value : $default;
-                }
-                return $preferences;
+                        'comment_text'               => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( trim( wp_strip_all_tags( (string) $request->get_param( 'comment_text' ) ) ), self::EDITOR_COMMENT_TEXT_MAX_CHARS ) ),
+                );
         }
 
@@ -296 +267 @@
                         }
                         $client_id = sanitize_text_field( (string) ( $block['client_id'] ?? '' ) );
-                        $text      = sanitize_textarea_field( $this->editor_trim_chars( wp_strip_all_tags( (string) ( $block['text'] ?? '' ) ), 1600 ) );
+                        $text      = sanitize_textarea_field( Rest_Editor_Audio_Text::trim( wp_strip_all_tags( (string) ( $block['text'] ?? '' ) ), 1600 ) );
                         if ( '' !== $client_id && '' !== $text ) {
                                 $items[] = array(
@@ -306 +277 @@
                 }
                 return $items;
-        }
-
-        private function editor_audio_text_from_raw_content( string $content, array $audio_preferences ): string {
-                $source   = $content;
-                $handling = sanitize_key( (string) ( $audio_preferences['handling'] ?? 'skip_code' ) );
-                if ( 'skip_code' === $handling ) {
-                        $source = preg_replace( '/<!--\s*wp:code\b.*?<!--\s*\/wp:code\s*-->/is', ' ', $source );
-                        $source = preg_replace( '/<pre\b[^>]*>.*?<\/pre>/is', ' ', $source );
-                        $source = preg_replace( '/<code\b[^>]*>.*?<\/code>/is', ' ', $source );
-                }
-                if ( 'skip_tables' === $handling ) {
-                        $source = preg_replace( '/<!--\s*wp:table\b.*?<!--\s*\/wp:table\s*-->/is', ' ', $source );
-                        $source = preg_replace( '/<table\b[^>]*>.*?<\/table>/is', ' ', $source );
-                }
-                return trim( wp_strip_all_tags( (string) $source ) );
-        }
-
-        private function editor_trim_chars( string $value, int $max_chars ): string {
-                $value     = trim( $value );
-                $max_chars = max( 1, $max_chars );
-                if ( function_exists( 'mb_strlen' ) && function_exists( 'mb_substr' ) ) {
-                        return mb_strlen( $value, 'UTF-8' ) > $max_chars ? mb_substr( $value, 0, $max_chars, 'UTF-8' ) : $value;
-                }
-
-                return strlen( $value ) > $max_chars ? substr( $value, 0, $max_chars ) : $value;
         }
 
@@ -555 +501 @@
                         $candidate = trim( preg_replace( '/\s+/u', ' ', (string) $candidate ) ?: '' );
                         if ( '' !== $candidate ) {
-                                return $this->editor_trim_chars( $candidate, 120 );
+                                return Rest_Editor_Audio_Text::trim( $candidate, 120 );
                         }
                 }
@@ -675 +621 @@
                 }
 
-                $trimmed = $this->editor_trim_chars( $summary, 120 );
+                $trimmed = Rest_Editor_Audio_Text::trim( $summary, 120 );
                 if ( $trimmed !== $summary && preg_match( '/\s/u', $trimmed ) ) {
                         $trimmed = preg_replace( '/\s+\S*$/u', '', $trimmed ) ?: $trimmed;
@@ -770 +716 @@
 
                 return wp_trim_words( $query, 80, '' );
-        }
-
-        private function editor_input_scope( array $context ): array {
-                $scope     = sanitize_key( (string) ( $context['context_scope'] ?? 'auto' ) );
-                $selection = trim( (string) ( $context['selected_text'] ?? '' ) . ' ' . (string) ( $context['selected_block_text'] ?? '' ) );
-                if ( 'auto' === $scope ) {
-                        $scope = '' !== $selection ? 'selected_text' : ( '' !== trim( (string) ( $context['content_text'] ?? '' ) ) ? 'full_article' : 'topic_only' );
-                }
-
-                $labels = array(
-                        'selected_text' => __( 'Selected text or supplied snippet', 'npcink-workflow-toolbox' ),
-                        'full_article'  => __( 'Full article context', 'npcink-workflow-toolbox' ),
-                        'topic_only'    => __( 'Topic or short brief', 'npcink-workflow-toolbox' ),
-                );
-
-                $fields = array();
-                foreach ( array( 'title', 'excerpt', 'content_text', 'selected_text', 'selected_block_text', 'post_id' ) as $field ) {
-                        if ( ! empty( $context[ $field ] ) ) {
-                                $fields[] = $field;
-                        }
-                }
-
-                return array(
-                        'id'                     => $scope,
-                        'label'                  => $labels[ $scope ] ?? __( 'Current context', 'npcink-workflow-toolbox' ),
-                        'source_fields'          => $fields,
-                        'operator_selected_mode' => sanitize_key( (string) ( $context['context_scope'] ?? 'auto' ) ),
-                        'detail'                 => __( 'This scope controls ranking context only. Toolbox still returns suggestions and does not write WordPress data.', 'npcink-workflow-toolbox' ),
-                );
         }
 
@@ -1094 +1011 @@
                 $taxonomy_recommendations = '' !== trim( $query )
                         ? array_merge(
-                                $this->editor_taxonomy_recommendation_candidates( 'category_suggestions', $category_items, array(), $this->empty_proposed_new_terms_review() ),
-                                $this->editor_taxonomy_recommendation_candidates( 'tag_suggestions', array(), $tag_items, $this->empty_proposed_new_terms_review() )
+                                Rest_Editor_Taxonomy_Shaping::editor_taxonomy_recommendation_candidates( 'category_suggestions', $category_items, array(), $this->empty_proposed_new_terms_review() ),
+                                Rest_Editor_Taxonomy_Shaping::editor_taxonomy_recommendation_candidates( 'tag_suggestions', array(), $tag_items, $this->empty_proposed_new_terms_review() )
                         )
                         : array();
@@ -1513 +1430 @@
                         $match_score   = (int) ( $item['score'] ?? 0 );
                         $quality_score = min( 95, 55 + $match_score * 8 );
-                        $candidates[]  = $this->editor_recommendation_candidate(
+                        $candidates[]  = Rest_Editor_Flow_Cache::editor_recommendation_candidate(
                                 array(
                                         'id'                   => 'media_library_' . $attachment_id,
@@ -1596 +1513 @@
                         $status       = sanitize_key( (string) ( $item['status'] ?? 'warning' ) );
                         $score        = 'error' === $status ? 35 : 55;
-                        $candidates[] = $this->editor_recommendation_candidate(
+                        $candidates[] = Rest_Editor_Flow_Cache::editor_recommendation_candidate(
                                 array(
                                         'id'             => 'preflight_' . $id,
@@ -1616 +1533 @@
                 return $candidates;
         }
-
-        private function editor_cached_site_knowledge( array $input ) {
-                return $this->editor_cached_client_result(
-                        'site_knowledge',
-                        $input,
-                        function () use ( $input ) {
-                                return $this->client->search_site_knowledge( $input );
-                        }
-                );
-        }
-
-        private function editor_cached_content_discoverability( array $input ) {
-                return $this->editor_cached_client_result(
-                        'content_discoverability',
-                        $input,
-                        function () use ( $input ) {
-                                return $this->client->build_content_discoverability_brief( $input );
-                        }
-                );
-        }
-
-        private function editor_cached_hosted_ai_content_support( array $input, bool $force_refresh = false ) {
-                return $this->editor_cached_client_result(
-                        'hosted_ai_content_support',
-                        $input,
-                        function () use ( $input ) {
-                                return $this->client->run_hosted_ai_content_support( $input );
-                        },
-                        $force_refresh
-                );
-        }
-
-        private function editor_cached_audio_generation( array $input, bool $force_refresh = false ) {
-                return $this->editor_cached_client_result(
-                        'audio_generation',
-                        $input,
-                        function () use ( $input ) {
-                                return $this->client->run_audio_generation( $input );
-                        },
-                        $force_refresh
-                );
-        }
-
-        private function editor_cached_cloud_web_search( array $input, bool $force_refresh = false ) {
-                return $this->editor_cached_client_result(
-                        'cloud_web_search',
-                        $input,
-                        function () use ( $input ) {
-                                return $this->client->test_cloud_web_search( $input );
-                        },
-                        $force_refresh,
-                        function ( array $result ) use ( $input ): bool {
-                                return $this->editor_source_extraction_cacheable( $input, $result );
-                        },
-                        true
-                );
-        }
-
-        private function editor_source_extraction_cacheable( array $input, array $result ): bool {
-                if ( 'source_extraction_preview' !== sanitize_key( (string) ( $input['intent'] ?? '' ) ) ) {
-                        return true;
-                }
-
-                return 'ready' === sanitize_key( (string) ( $result['status'] ?? '' ) )
-                        && 'matched' === sanitize_key( (string) ( $result['url_match'] ?? '' ) )
-                        && ! empty( $result['results'][0]['reader_excerpt'] ?? '' );
-        }
-
-        private function editor_cached_client_result( string $namespace, array $input, callable $callback, bool $force_refresh = false, ?callable $should_cache = null, bool $replace_cache_on_force = false ) {
-                $cache_key = $this->editor_flow_cache_key( $namespace, $input );
-                $cached    = $force_refresh ? false : get_transient( $cache_key );
-                if ( false !== $cached && is_array( $cached ) ) {
-                        if ( null === $should_cache || $should_cache( $cached ) ) {
-                                $cached['cache_status'] = 'hit';
-                                return $cached;
-                        }
-                        delete_transient( $cache_key );
-                }
-
-                $result = $callback();
-                if ( ! is_wp_error( $result ) && is_array( $result ) ) {
-                        $result['cache_status'] = $force_refresh ? 'bypass' : 'miss';
-                        $cacheable              = null === $should_cache || $should_cache( $result );
-                        if ( $cacheable && ( ! $force_refresh || $replace_cache_on_force ) ) {
-                                set_transient( $cache_key, $result, self::EDITOR_FLOW_CACHE_TTL );
-                        } elseif ( $force_refresh && $replace_cache_on_force ) {
-                                delete_transient( $cache_key );
-                        }
-                }
-
-                return $result;
-        }
-
-        private function editor_flow_cache_key( string $namespace, array $input ): string {
-                $json = wp_json_encode( $input );
-                if ( ! is_string( $json ) ) {
-                        $json = serialize( $input );
-                }
-
-                return 'npcink_toolbox_editor_' . sanitize_key( $namespace ) . '_' . md5( $json );
-        }
-
-        /**
-         * Validates one public source URL before Cloud research is requested.
-         *
-         * @param string $value Raw URL.
-         * @return string|WP_Error
-         */
 
         private function editor_source_adaptation_url( string $value ) {
@@ -2556 +2365 @@
 
         private function editor_writing_pack_related_articles( array $knowledge ): array {
-                $items  = $this->editor_related_content_items( $knowledge );
+                $items  = Rest_Editor_Flow_Cache::editor_related_content_items( $knowledge );
                 $result = array();
                 foreach ( array_slice( $items, 0, 6 ) as $index => $item ) {
@@ -2712 +2521 @@
                         'final_write_path'       => 'core_proposal_required',
                         'direct_wordpress_write' => false,
-                        'input_scope'            => $this->editor_input_scope( $context ),
+                        'input_scope'            => Rest_Editor_Flow_Cache::editor_input_scope( $context ),
                         'summary_candidates'     => $summary_ai,
                         'summary_layers'         => $summary_layers,
@@ -2779 +2588 @@
                         'diagnosis'              => array(
                                 'summary_quality'   => $this->editor_summary_quality( $context ),
-                                'taxonomy_quality'  => $this->editor_taxonomy_quality( $context, $categories, $tags, $proposed_new_terms ),
+                                'taxonomy_quality'  => Rest_Editor_Taxonomy_Shaping::editor_taxonomy_quality( $context, $categories, $tags, $proposed_new_terms ),
                                 'hypotheses'        => array(
                                         __( 'A clearer excerpt can improve archive, social, and answer-summary presentation without rewriting the article body.', 'npcink-workflow-toolbox' ),
@@ -2875 +2684 @@
         }
 
-        private function editor_taxonomy_quality( array $context, array $categories, array $tags, array $proposed_new_terms ): string {
-                $current_categories = is_array( $context['category_ids'] ?? null ) ? array_filter( array_map( 'absint', $context['category_ids'] ) ) : array();
-                $current_tags       = is_array( $context['tag_ids'] ?? null ) ? array_filter( array_map( 'absint', $context['tag_ids'] ) ) : array();
-                if ( empty( $current_categories ) && empty( $current_tags ) ) {
-                        return 'missing';
-                }
-                if ( ! empty( $proposed_new_terms['items'] ) || 12 < count( $current_tags ) ) {
-                        return 'noisy';
-                }
-                if ( empty( $categories ) && empty( $tags ) ) {
-                        return 'acceptable';
-                }
-
-                return 'weak';
-        }
-
-        private function editor_related_content_items( array $related_content ): array {
-                $items = is_array( $related_content['results'] ?? null )
-                        ? $related_content['results']
-                        : ( is_array( $related_content['items'] ?? null ) ? $related_content['items'] : array() );
-
-                return array_values(
-                        array_filter(
-                                $items,
-                                static fn( $item ): bool => is_array( $item )
-                        )
-                );
-        }
-
         private function editor_related_content_summary( array $related_content ): array {
-                $items        = $this->editor_related_content_items( $related_content );
+                $items        = Rest_Editor_Flow_Cache::editor_related_content_items( $related_content );
                 $evidence_ids = array();
                 $titles       = array();
@@ -2928 +2708 @@
 
         private function editor_related_content_context_for_ai( array $related_content ): array {
-                $items         = $this->editor_related_content_items( $related_content );
+                $items         = Rest_Editor_Flow_Cache::editor_related_content_items( $related_content );
                 $context_items = array();
 
@@ -3018 +2798 @@
                 $items                                 = is_array( $artifact['items'] ?? null ) ? $artifact['items'] : array();
                 $items                                 = $this->editor_internal_link_merge_cloud_relevance( $items, $related_content_evidence );
-                $artifact['input_scope']               = $this->editor_input_scope( $context );
+                $artifact['input_scope']               = Rest_Editor_Flow_Cache::editor_input_scope( $context );
                 $artifact['source_ability_id']         = 'npcink-abilities-toolkit/resolve-internal-link-targets';
                 $artifact['source_knowledge']          = $source_knowledge;
@@ -3109 +2889 @@
         private function editor_internal_link_related_content_evidence( array $source_knowledge ): array {
                 $evidence = array();
-                foreach ( array_slice( $this->editor_related_content_items( $source_knowledge ), 0, 8 ) as $index => $item ) {
+                foreach ( array_slice( Rest_Editor_Flow_Cache::editor_related_content_items( $source_knowledge ), 0, 8 ) as $index => $item ) {
                         $post_id             = absint( $item['post_id'] ?? ( $item['id'] ?? 0 ) );
                         $candidate_relevance = sanitize_key( (string) ( $item['candidate_relevance'] ?? '' ) );
@@ -3143 +2923 @@
                                 continue;
                         }
-                        $text = trim( sanitize_textarea_field( $this->editor_trim_chars( wp_strip_all_tags( (string) ( $block['text'] ?? '' ) ), 1200 ) ) );
+                        $text = trim( sanitize_textarea_field( Rest_Editor_Audio_Text::trim( wp_strip_all_tags( (string) ( $block['text'] ?? '' ) ), 1200 ) ) );
                         if ( '' === $text ) {
                                 continue;
@@ -3300 +3080 @@
                         }
 
-                        $candidates[] = $this->editor_recommendation_candidate(
+                        $candidates[] = Rest_Editor_Flow_Cache::editor_recommendation_candidate(
                                 array(
                                         'id'                    => 'internal_link_' . ( $index + 1 ),
@@ -3401 +3181 @@
                                 )
                         );
-                        $script                          = $this->editor_audio_summary_script_text( $summary_ai );
+                        $script                          = Rest_Editor_Audio_Text::editor_audio_summary_script_text( $summary_ai );
                         $script_source['summary_script'] = $summary_ai;
                 } else {
-                        $script                       = $this->editor_audio_source_text( $source_text );
+                        $script                       = Rest_Editor_Audio_Text::editor_audio_source_text( $source_text );
                         $script_source['source_mode'] = 'article_text';
                 }
@@ -3466 +3246 @@
         }
 
-        private function editor_audio_source_text( string $text ): string {
-                $plain = trim( wp_strip_all_tags( $text ) );
-                if ( '' === $plain ) {
-                        return '';
-                }
-                if ( function_exists( 'mb_strlen' ) && function_exists( 'mb_substr' ) ) {
-                        return mb_strlen( $plain, 'UTF-8' ) > self::EDITOR_AUDIO_TEXT_MAX_CHARS ? mb_substr( $plain, 0, self::EDITOR_AUDIO_TEXT_MAX_CHARS, 'UTF-8' ) : $plain;
-                }
-                return strlen( $plain ) > self::EDITOR_AUDIO_TEXT_MAX_CHARS ? substr( $plain, 0, self::EDITOR_AUDIO_TEXT_MAX_CHARS ) : $plain;
-        }
-
-        private function editor_audio_summary_script_text( array $summary_ai ): string {
-                $output_json = is_array( $summary_ai['output_json'] ?? null ) ? $summary_ai['output_json'] : array();
-                $parts       = array();
-                foreach ( array( 'opening', 'script', 'closing' ) as $key ) {
-                        $value = trim( sanitize_textarea_field( (string) ( $output_json[ $key ] ?? '' ) ) );
-                        if ( '' !== $value ) {
-                                $parts[] = $value;
-                        }
-                }
-                if ( is_array( $output_json['key_points'] ?? null ) ) {
-                        foreach ( array_slice( $output_json['key_points'], 0, 5 ) as $point ) {
-                                $value = trim( sanitize_textarea_field( (string) $point ) );
-                                if ( '' !== $value ) {
-                                        $parts[] = $value;
-                                }
-                        }
-                }
-                $script = trim( implode( "\n\n", array_values( array_unique( $parts ) ) ) );
-                if ( '' === $script ) {
-                        $script = trim( sanitize_textarea_field( (string) ( $summary_ai['output_text'] ?? '' ) ) );
-                }
-                if ( function_exists( 'mb_strlen' ) && function_exists( 'mb_substr' ) ) {
-                        return mb_strlen( $script, 'UTF-8' ) > self::EDITOR_AUDIO_TEXT_MAX_CHARS ? mb_substr( $script, 0, self::EDITOR_AUDIO_TEXT_MAX_CHARS, 'UTF-8' ) : $script;
-                }
-                return strlen( $script ) > self::EDITOR_AUDIO_TEXT_MAX_CHARS ? substr( $script, 0, self::EDITOR_AUDIO_TEXT_MAX_CHARS ) : $script;
-        }
-
         private function editor_article_checkup_section( array $context ): array {
                 $text       = trim( (string) ( $context['content_full_text'] ?? $context['content_text'] ?? '' ) );
@@ -3680 +3422 @@
                 $signals = array();
 
-                if ( $this->editor_text_has_heading_label_glue( $paragraph ) ) {
+                if ( Rest_Editor_Paragraph_Check::editor_text_has_heading_label_glue( $paragraph ) ) {
                         $signals[] = __( '标题式标签直接黏在正文前', 'npcink-workflow-toolbox' );
                 }
-                if ( $this->editor_text_has_phrase_cluster_glue( $paragraph ) ) {
+                if ( Rest_Editor_Paragraph_Check::editor_text_has_phrase_cluster_glue( $paragraph ) ) {
                         $signals[] = __( '短语组之间缺少分隔', 'npcink-workflow-toolbox' );
                 }
-                if ( $this->editor_text_has_alnum_cjk_glue( $paragraph ) ) {
+                if ( Rest_Editor_Paragraph_Check::editor_text_has_alnum_cjk_glue( $paragraph ) ) {
                         $signals[] = __( '字母、数字或方案标签与中文黏连', 'npcink-workflow-toolbox' );
                 }
@@ -3926 +3668 @@
         }
 
-        private function editor_text_has_heading_label_glue( string $text ): bool {
-                return 1 === preg_match( '/(核心要点|评估维度|主要差异|适用建议|常见问题|方案\s*[A-Za-zＡ-Ｚ])(?=[\p{Han}A-Za-z0-9])/u', $text );
-        }
-
-        private function editor_text_has_phrase_cluster_glue( string $text ): bool {
-                return 1 === preg_match( '/可维护性编辑体验响应式表现治理边界/u', $text )
-                        || 1 === preg_match( '/(可维护性|编辑体验|响应式表现|治理边界)(可维护性|编辑体验|响应式表现|治理边界)(可维护性|编辑体验|响应式表现|治理边界)/u', $text );
-        }
-
-        private function editor_text_has_alnum_cjk_glue( string $text ): bool {
-                return 1 === preg_match( '/(?:[A-Za-z0-9][\x{4e00}-\x{9fff}]|[\x{4e00}-\x{9fff}][A-Za-z0-9]{2,})/u', $text );
-        }
-
-        private function editor_text_has_structural_glue( string $text ): bool {
-                return $this->editor_text_has_heading_label_glue( $text )
-                        || $this->editor_text_has_phrase_cluster_glue( $text )
-                        || $this->editor_text_has_alnum_cjk_glue( $text );
-        }
-
         private function editor_article_checkup_issue( string $id, string $type, string $severity, string $location, string $evidence, string $issue, string $edit_direction ): array {
                 return array(
@@ -3951 +3674 @@
                         'severity'       => sanitize_key( $severity ),
                         'location'       => sanitize_text_field( $location ),
-                        'evidence'       => sanitize_text_field( $this->editor_trim_chars( $evidence, 120 ) ),
+                        'evidence'       => sanitize_text_field( Rest_Editor_Audio_Text::trim( $evidence, 120 ) ),
                         'issue'          => sanitize_text_field( $issue ),
                         'edit_direction' => sanitize_textarea_field( $edit_direction ),
@@ -4007 +3730 @@
                 $section['write_posture']      = 'suggestion_only';
                 if ( 'polish_notes' === $provider_intent ) {
-                        if ( ! $this->editor_paragraph_check_has_output( $section ) ) {
-                                $section = $this->editor_paragraph_check_local_fallback_section( $section, $content );
+                        if ( ! Rest_Editor_Paragraph_Check::editor_paragraph_check_has_output( $section ) ) {
+                                $section = Rest_Editor_Paragraph_Check::editor_paragraph_check_local_fallback_section( $section, $content );
                         } else {
-                                $section = $this->editor_paragraph_check_local_overlay_section( $section, $content );
+                                $section = Rest_Editor_Paragraph_Check::editor_paragraph_check_local_overlay_section( $section, $content );
                         }
                 }
 
                 return $section;
-        }
-
-        private function editor_paragraph_check_has_output( array $section ): bool {
-                if ( ! empty( $section['items'] ) && is_array( $section['items'] ) ) {
-                        return true;
-                }
-                if ( '' !== trim( sanitize_textarea_field( (string) ( $section['output_text'] ?? '' ) ) ) ) {
-                        return true;
-                }
-                $output_json = is_array( $section['output_json'] ?? null ) ? $section['output_json'] : array();
-                foreach ( array( 'clarity_check', 'fact_gaps', 'tone_consistency', 'editing_suggestions', 'assumptions_to_verify' ) as $key ) {
-                        if ( ! empty( $output_json[ $key ] ) ) {
-                                return true;
-                        }
-                }
-                $result = is_array( $section['result'] ?? null ) ? $section['result'] : array();
-                foreach ( array( 'clarity_check', 'fact_gaps', 'tone_consistency', 'editing_suggestions', 'assumptions_to_verify' ) as $key ) {
-                        if ( ! empty( $result[ $key ] ) ) {
-                                return true;
-                        }
-                }
-                return false;
-        }
-
-        private function editor_paragraph_check_local_fallback_section( array $section, string $selected_text ): array {
-                $output = $this->editor_paragraph_check_local_output( $selected_text );
-                $status = sanitize_key( (string) ( $section['status'] ?? 'unknown' ) );
-
-                $section['provider_execution']      = 'hosted_ai_with_local_empty_fallback';
-                $section['hosted_ai_status']        = $status;
-                $section['fallback_reason']         = 'local_paragraph_check_after_hosted_ai_empty';
-                $section['fallback_source']         = 'current_selected_paragraph_only';
-                $section['fallback_write_posture']  = 'suggestion_only_no_replacement_text';
-                $section['fallback_signal_profile'] = is_array( $output['signal_profile'] ?? null )
-                        ? array_map( 'boolval', $output['signal_profile'] )
-                        : array();
-                $section['output_json']             = $output;
-                $section['items']                   = array(
-                        array(
-                                'name'          => __( 'Clarity check', 'npcink-workflow-toolbox' ),
-                                'detail'        => $output['clarity_check'],
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:paragraph' ),
-                        ),
-                        array(
-                                'name'          => __( 'Fact gaps', 'npcink-workflow-toolbox' ),
-                                'detail'        => $output['fact_gaps'],
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:paragraph' ),
-                        ),
-                        array(
-                                'name'          => __( 'Tone consistency', 'npcink-workflow-toolbox' ),
-                                'detail'        => $output['tone_consistency'],
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:paragraph' ),
-                        ),
-                        array(
-                                'name'          => __( 'Editing suggestions', 'npcink-workflow-toolbox' ),
-                                'detail'        => $output['editing_suggestions'],
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:paragraph' ),
-                        ),
-                );
-
-                return $section;
-        }
-
-        private function editor_paragraph_check_local_overlay_section( array $section, string $selected_text ): array {
-                $output  = $this->editor_paragraph_check_local_output( $selected_text, false );
-                $overlay = array(
-                        'artifact_type'      => 'paragraph_local_review_overlay.v1',
-                        'source'             => 'current_selected_paragraph_only',
-                        'write_posture'      => 'suggestion_only_no_replacement_text',
-                        'action_policy'      => 'operator_review_only_no_insert',
-                        'status'             => 'ready',
-                        'provider_execution' => 'local_signal_overlay_after_hosted_ai_output',
-                        'signal_profile'     => is_array( $output['signal_profile'] ?? null )
-                                ? array_map( 'boolval', $output['signal_profile'] )
-                                : array(),
-                        'output_json'        => $output,
-                        'items'              => $this->editor_paragraph_check_local_overlay_items( $output ),
-                );
-
-                $section['local_review_overlay'] = $overlay;
-                $section['local_signal_profile'] = $overlay['signal_profile'];
-
-                $output_json                         = is_array( $section['output_json'] ?? null ) ? $section['output_json'] : array();
-                $output_json['local_review_overlay'] = $overlay;
-                $section['output_json']              = $output_json;
-
-                return $section;
-        }
-
-        private function editor_paragraph_check_local_overlay_items( array $output ): array {
-                $signals = is_array( $output['signal_profile'] ?? null ) ? $output['signal_profile'] : array();
-                $items   = array();
-
-                if ( ! empty( $signals['has_structural_glue'] ) ) {
-                        $items[] = array(
-                                'name'          => __( 'Local structure cross-check', 'npcink-workflow-toolbox' ),
-                                'detail'        => (string) ( $output['clarity_check'] ?? '' ),
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:local_overlay' ),
-                        );
-                        $items[] = array(
-                                'name'          => __( 'Local fact-boundary check', 'npcink-workflow-toolbox' ),
-                                'detail'        => (string) ( $output['fact_gaps'] ?? '' ),
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:local_overlay' ),
-                        );
-                } elseif ( ! empty( $signals['has_metric_claim'] ) || ! empty( $signals['has_comparison_claim'] ) || ! empty( $signals['long_or_dense'] ) ) {
-                        $items[] = array(
-                                'name'          => __( 'Local fact-boundary check', 'npcink-workflow-toolbox' ),
-                                'detail'        => (string) ( $output['fact_gaps'] ?? '' ),
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:local_overlay' ),
-                        );
-                } elseif ( ! empty( $signals['has_scope_claim'] ) || ! empty( $signals['has_causal_transition'] ) ) {
-                        $items[] = array(
-                                'name'          => __( 'Local scope check', 'npcink-workflow-toolbox' ),
-                                'detail'        => (string) ( $output['tone_consistency'] ?? '' ),
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:local_overlay' ),
-                        );
-                }
-
-                if ( ! empty( $items ) ) {
-                        $items[] = array(
-                                'name'          => __( 'Local editing guardrail', 'npcink-workflow-toolbox' ),
-                                'detail'        => (string) ( $output['editing_suggestions'] ?? '' ),
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:local_overlay' ),
-                        );
-                }
-
-                return array_values(
-                        array_filter(
-                                $items,
-                                static function ( $item ): bool {
-                                        return is_array( $item ) && '' !== trim( (string) ( $item['detail'] ?? '' ) );
-                                }
-                        )
-                );
-        }
-
-        private function editor_paragraph_check_signal_profile( string $text, int $length, int $punctuation_count ): array {
-                $has_performance_claim = 1 === preg_match( '/(快|慢|耗时|性能|经测试|同等服务器|相当|无明显|明显性能|读取|保存)/u', $text );
-                $has_metric_claim      = 1 === preg_match( '/(\d|万|倍|%|百分|测试|经测试|数量|规模|id|ID|attachment)/u', $text );
-                $has_scope_claim       = 1 === preg_match( '/(可用于|适合|场景|条件|范围|限制|边界|因此|所以|由于|因为)/u', $text );
-                $has_comparison_claim  = 1 === preg_match( '/(比|相比|对比|相较|优于|弱于|快于|慢于|高于|低于)/u', $text );
-                $has_causal_transition = 1 === preg_match( '/(因此|所以|由于|因为|从而|导致)/u', $text );
-
-                return array(
-                        'long_or_dense'         => $length > 150 || $punctuation_count >= 3,
-                        'has_performance_claim' => $has_performance_claim,
-                        'has_metric_claim'      => $has_metric_claim,
-                        'has_scope_claim'       => $has_scope_claim,
-                        'has_comparison_claim'  => $has_comparison_claim,
-                        'has_causal_transition' => $has_causal_transition,
-                        'has_structural_glue'   => $this->editor_text_has_structural_glue( $text ),
-                );
-        }
-
-        private function editor_paragraph_check_local_output( string $selected_text, bool $hosted_ai_empty = true ): array {
-                $text              = trim( preg_replace( '/\s+/u', ' ', wp_strip_all_tags( $selected_text ) ) ?: '' );
-                $length            = function_exists( 'mb_strlen' ) ? mb_strlen( $text, 'UTF-8' ) : strlen( $text );
-                $punctuation_count = preg_match_all( '/[。！？!?；;]/u', $text );
-                $signals           = $this->editor_paragraph_check_signal_profile( $text, $length, (int) $punctuation_count );
-
-                if ( $signals['has_structural_glue'] ) {
-                        $clarity = __( '选中段落疑似存在标题词、选项标签或短语串与正文黏连的问题，建议先检查分隔、标点、列表或小标题结构。', 'npcink-workflow-toolbox' );
-                } elseif ( $signals['long_or_dense'] && $signals['has_metric_claim'] ) {
-                        $clarity = __( '段落信息量偏高，建议人工检查测试条件、对比结论和适用边界是否需要拆开呈现，避免读者把多个结论混在一起。', 'npcink-workflow-toolbox' );
-                } elseif ( $signals['long_or_dense'] ) {
-                        $clarity = __( '段落信息量偏高，建议人工检查主语、原因、结论和适用边界是否需要拆开呈现，避免读者把多个判断混在一起。', 'npcink-workflow-toolbox' );
-                } else {
-                        $clarity = __( '段落结构基本清楚；重点检查判断对象、原因和适用边界是否已经在上下文中交代。', 'npcink-workflow-toolbox' );
-                }
-
-                $fact_gaps = $signals['has_structural_glue']
-                        ? __( '结构黏连会影响读者判断事实边界；发布前需要确认每个标签、维度、方案、ID 或问答对应的正文是否清楚分开。', 'npcink-workflow-toolbox' )
-                        : ( $signals['has_performance_claim']
-                                ? __( '包含测试、数量、速度或耗时类结论；发布前需要确认测试条件、数据规模、对比对象和结论来源，避免把单次测试写成通用事实。', 'npcink-workflow-toolbox' )
-                                : ( $signals['has_metric_claim']
-                                        ? __( '包含数字、ID、数量或范围类表述；发布前需要确认这些数字对应的对象、条件和来源，避免把局部证据写成通用事实。', 'npcink-workflow-toolbox' )
-                                        : ( $signals['has_comparison_claim']
-                                                ? __( '包含比较性判断；发布前需要确认比较对象、比较条件和依据是否在上下文中明确。', 'npcink-workflow-toolbox' )
-                                                : __( '未发现明显数字或比较结论；仍需人工确认段落中的判断是否有上下文依据。', 'npcink-workflow-toolbox' ) ) ) );
-
-                $tone = $signals['has_scope_claim']
-                        ? __( '语气整体偏说明性；涉及“适合/因此/场景”等判断时，建议保持审慎，不要超过已验证范围。', 'npcink-workflow-toolbox' )
-                        : ( $signals['has_causal_transition']
-                                ? __( '语气整体偏推论式；建议确认原因和结论之间的关系是否足够明确。', 'npcink-workflow-toolbox' )
-                                : __( '语气整体中性；保持事实说明，并避免加入选中段落没有承载的新判断。', 'npcink-workflow-toolbox' ) );
-
-                $editing_parts = array( __( '不要直接替换正文。', 'npcink-workflow-toolbox' ) );
-                if ( $signals['has_structural_glue'] ) {
-                        $editing_parts[] = __( '优先拆开标题词、选项标签、短语串和正文说明。', 'npcink-workflow-toolbox' );
-                } elseif ( $signals['has_performance_claim'] ) {
-                        $editing_parts[] = __( '优先核对测试条件、性能口径和对比对象。', 'npcink-workflow-toolbox' );
-                } elseif ( $signals['has_metric_claim'] ) {
-                        $editing_parts[] = __( '优先核对数字、ID、数量口径和对应对象。', 'npcink-workflow-toolbox' );
-                } elseif ( $signals['has_comparison_claim'] ) {
-                        $editing_parts[] = __( '优先核对比较对象和比较条件。', 'npcink-workflow-toolbox' );
-                } else {
-                        $editing_parts[] = __( '优先核对该段判断是否有上下文依据。', 'npcink-workflow-toolbox' );
-                }
-                if ( $signals['has_scope_claim'] ) {
-                        $editing_parts[] = __( '必要时缩小适用范围，或把原因和边界分开审阅。', 'npcink-workflow-toolbox' );
-                } else {
-                        $editing_parts[] = __( '必要时补充限定条件，或把原因和结论分开审阅。', 'npcink-workflow-toolbox' );
-                }
-                $editing = implode( '', $editing_parts );
-
-                return array(
-                        'clarity_check'         => $clarity,
-                        'fact_gaps'             => $fact_gaps,
-                        'tone_consistency'      => $tone,
-                        'editing_suggestions'   => $editing,
-                        'assumptions_to_verify' => $hosted_ai_empty
-                                ? __( '托管 AI 本次未返回建议，以上为本地兜底检查；仍以人工编辑和原始测试记录为准。', 'npcink-workflow-toolbox' )
-                                : __( '本地复核只检查结构、事实口径和语气风险；托管 AI 建议仍需人工审阅。', 'npcink-workflow-toolbox' ),
-                        'signal_profile'        => $signals,
-                );
-        }
-
-        private function editor_recommendation_candidate( array $args ): array {
-                $candidate = array(
-                        'contract'               => 'recommendation_candidate.v1',
-                        'id'                     => sanitize_key( (string) ( $args['id'] ?? 'candidate' ) ),
-                        'kind'                   => sanitize_key( (string) ( $args['kind'] ?? 'generic' ) ),
-                        'label'                  => sanitize_text_field( (string) ( $args['label'] ?? __( 'Recommendation candidate', 'npcink-workflow-toolbox' ) ) ),
-                        'value'                  => sanitize_text_field( (string) ( $args['value'] ?? '' ) ),
-                        'reason'                 => sanitize_text_field( (string) ( $args['reason'] ?? '' ) ),
-                        'confidence'             => is_numeric( $args['confidence'] ?? null ) ? max( 0, min( 1, (float) $args['confidence'] ) ) : null,
-                        'quality_status'         => sanitize_key( (string) ( $args['quality_status'] ?? 'review' ) ),
-                        'quality_score'          => absint( $args['quality_score'] ?? 0 ),
-                        'quality_issues'         => is_array( $args['quality_issues'] ?? null ) ? array_values( array_map( 'sanitize_text_field', $args['quality_issues'] ) ) : array(),
-                        'action_policy'          => sanitize_key( (string) ( $args['action_policy'] ?? 'suggestion_only' ) ),
-                        'target_field'           => sanitize_key( (string) ( $args['target_field'] ?? '' ) ),
-                        'write_posture'          => 'suggestion_only',
-                        'direct_wordpress_write' => false,
-                        'evidence_refs'          => is_array( $args['evidence_refs'] ?? null ) ? array_values( array_map( 'sanitize_text_field', $args['evidence_refs'] ) ) : array(),
-                );
-
-                if ( '' !== (string) ( $args['source_candidate_ref'] ?? '' ) ) {
-                        $candidate['source_candidate_ref'] = sanitize_text_field( (string) $args['source_candidate_ref'] );
-                }
-                if ( '' !== (string) ( $args['candidate_source'] ?? '' ) ) {
-                        $candidate['candidate_source'] = sanitize_key( (string) $args['candidate_source'] );
-                }
-                if ( in_array( (string) ( $args['candidate_relevance'] ?? '' ), array( 'strong', 'review', 'weak' ), true ) ) {
-                        $candidate['candidate_relevance'] = (string) $args['candidate_relevance'];
-                }
-                if ( is_array( $args['target_ref'] ?? null ) ) {
-                        $target_ref              = $args['target_ref'];
-                        $candidate['target_ref'] = array(
-                                'post_id'   => absint( $target_ref['post_id'] ?? 0 ),
-                                'title'     => sanitize_text_field( (string) ( $target_ref['title'] ?? '' ) ),
-                                'url'       => esc_url_raw( (string) ( $target_ref['url'] ?? '' ) ),
-                                'status'    => sanitize_key( (string) ( $target_ref['status'] ?? '' ) ),
-                                'post_type' => sanitize_key( (string) ( $target_ref['post_type'] ?? '' ) ),
-                        );
-                }
-                if ( '' !== (string) ( $args['anchor_or_context'] ?? '' ) ) {
-                        $candidate['anchor_or_context'] = sanitize_text_field( (string) $args['anchor_or_context'] );
-                }
-                if ( array_key_exists( 'can_apply_to_editor', $args ) ) {
-                        $candidate['can_apply_to_editor'] = true === $args['can_apply_to_editor'];
-                }
-                if ( '' !== (string) ( $args['anchor_quality_status'] ?? '' ) ) {
-                        $candidate['anchor_quality_status'] = sanitize_key( (string) $args['anchor_quality_status'] );
-                }
-                if ( '' !== (string) ( $args['evidence_note'] ?? '' ) ) {
-                        $candidate['evidence_note'] = sanitize_text_field( (string) $args['evidence_note'] );
-                }
-                if ( '' !== (string) ( $args['owner_label'] ?? '' ) ) {
-                        $candidate['owner_label'] = sanitize_key( (string) $args['owner_label'] );
-                }
-                if ( '' !== (string) ( $args['next_safe_action'] ?? '' ) ) {
-                        $candidate['next_safe_action'] = sanitize_key( (string) $args['next_safe_action'] );
-                }
-                if ( is_array( $args['source_match'] ?? null ) ) {
-                        $source_match  = $args['source_match'];
-                        $client_id     = sanitize_text_field( (string) ( $source_match['block_client_id'] ?? '' ) );
-                        $matched_text  = sanitize_text_field( (string) ( $source_match['matched_text'] ?? '' ) );
-                        $expected_text = sanitize_textarea_field( $this->editor_trim_chars( wp_strip_all_tags( (string) ( $source_match['expected_text'] ?? '' ) ), 1600 ) );
-                        if ( '' !== $client_id && '' !== $matched_text && '' !== $expected_text ) {
-                                $candidate['source_match'] = array(
-                                        'block_client_id' => $client_id,
-                                        'block_name'      => sanitize_text_field( (string) ( $source_match['block_name'] ?? '' ) ),
-                                        'matched_text'    => $matched_text,
-                                        'text_offset'     => absint( $source_match['text_offset'] ?? 0 ),
-                                        'expected_text'   => $expected_text,
-                                        'match_basis'     => sanitize_key( (string) ( $source_match['match_basis'] ?? '' ) ),
-                                );
-                        }
-                }
-                if ( '' !== (string) ( $args['priority_reason'] ?? '' ) ) {
-                        $candidate['priority_reason'] = sanitize_text_field( (string) $args['priority_reason'] );
-                }
-                if ( is_array( $args['link_graph_issues'] ?? null ) ) {
-                        $candidate['link_graph_issues'] = array_values( array_filter( array_map( 'sanitize_key', $args['link_graph_issues'] ) ) );
-                }
-                if ( is_array( $args['shared_terms'] ?? null ) ) {
-                        $candidate['shared_terms'] = array_slice( array_values( array_filter( array_map( 'sanitize_text_field', $args['shared_terms'] ) ) ), 0, 3 );
-                }
-                $candidate['incoming_count'] = absint( $args['incoming_count'] ?? 0 );
-
-                return $candidate;
         }
 
@@ -4337 +3750 @@
                 );
 
-                return $this->editor_taxonomy_only_suggestion_section(
+                return Rest_Editor_Taxonomy_Shaping::editor_taxonomy_only_suggestion_section(
                         'category_suggestions',
                         $categories,
@@ -4358 +3771 @@
                 $proposed_new_terms = $this->empty_proposed_new_terms_review();
 
-                return $this->editor_taxonomy_only_suggestion_section(
+                return Rest_Editor_Taxonomy_Shaping::editor_taxonomy_only_suggestion_section(
                         'tag_suggestions',
                         array(),
@@ -4368 +3781 @@
         }
 
-        private function editor_taxonomy_only_suggestion_section( string $candidate_type, array $categories, array $tags, array $proposed_new_terms, array $taxonomy_terms, array $context ): array {
-                return array(
-                        'artifact_type'             => 'article_taxonomy_suggestions.v1',
-                        'composition_role'          => 'taxonomy_candidates_only',
-                        'candidate_type'            => sanitize_key( $candidate_type ),
-                        'candidate_contract'        => 'recommendation_candidate.v1',
-                        'write_posture'             => 'suggestion_only',
-                        'final_write_path'          => 'core_proposal_required',
-                        'direct_wordpress_write'    => false,
-                        'input_scope'               => $this->editor_input_scope( $context ),
-                        'category_candidates'       => array_slice( $categories, 0, 5 ),
-                        'tag_candidates'            => array_slice( $tags, 0, 8 ),
-                        'proposed_new_terms'        => $proposed_new_terms,
-                        'taxonomy_terms'            => $taxonomy_terms,
-                        'recommendation_candidates' => $this->editor_taxonomy_recommendation_candidates( $candidate_type, $categories, $tags, $proposed_new_terms ),
-                        'quality_gate'              => array(
-                                'name'           => 'runtime_taxonomy_candidate_rerank',
-                                'policy'         => 'existing_terms_first_current_draft_match_then_related_history',
-                                'candidate_sort' => 'score_desc_then_existing_term_order',
-                        ),
-                        'selection_policy'          => array(
-                                'prefer_existing_terms'    => true,
-                                'new_terms_deferred'       => true,
-                                'no_toolbox_term_creation' => true,
-                                'accepted_write_path'      => 'core_proposal_required',
-                        ),
-                );
-        }
-
-        private function editor_taxonomy_recommendation_candidates( string $candidate_type, array $categories, array $tags, array $proposed_new_terms ): array {
-                $items  = 'category_suggestions' === $candidate_type ? array_slice( $categories, 0, 5 ) : array_slice( $tags, 0, 8 );
-                $result = array();
-                foreach ( $items as $index => $item ) {
-                        $taxonomy = sanitize_key( (string) ( $item['taxonomy'] ?? '' ) );
-                        $term_id  = absint( $item['term_id'] ?? 0 );
-                        $name     = sanitize_text_field( (string) ( $item['name'] ?? '' ) );
-                        if ( '' === $name || 0 >= $term_id ) {
-                                continue;
-                        }
-                        $quality  = $this->editor_taxonomy_candidate_quality( $item );
-                        $result[] = $this->editor_recommendation_candidate(
-                                array(
-                                        'id'             => ( 'category' === $taxonomy ? 'category_' : 'tag_' ) . $term_id,
-                                        'kind'           => 'category' === $taxonomy ? 'category' : 'tag',
-                                        'label'          => 'category' === $taxonomy ? __( 'Existing category', 'npcink-workflow-toolbox' ) : __( 'Existing tag', 'npcink-workflow-toolbox' ),
-                                        'value'          => $name,
-                                        'reason'         => sanitize_text_field( (string) ( $item['reason'] ?? '' ) ),
-                                        'confidence'     => $quality['confidence'],
-                                        'target_field'   => 'category' === $taxonomy ? 'category' : 'post_tag',
-                                        'action_policy'  => 'core_proposal_required',
-                                        'quality_status' => $quality['status'],
-                                        'quality_score'  => $quality['score'],
-                                        'quality_issues' => $quality['issues'],
-                                        'evidence_refs'  => is_array( $item['evidence_refs'] ?? null ) ? $item['evidence_refs'] : array(),
-                                )
-                        );
-                }
-
-                return $result;
-        }
-
-        private function editor_taxonomy_candidate_quality( array $item ): array {
-                $score           = is_numeric( $item['score'] ?? null ) ? (float) $item['score'] : 0.0;
-                $match_signals   = is_array( $item['match_signals'] ?? null ) ? $item['match_signals'] : array();
-                $related_context = is_array( $item['related_context'] ?? null ) ? $item['related_context'] : array();
-                $quality_score   = max( 0, min( 100, 45 + (int) round( $score * 10 ) ) );
-                $quality_issues  = array();
-                if ( in_array( 'current_draft_match', $match_signals, true ) ) {
-                        $quality_issues[] = __( '匹配当前草稿中的标题、摘要或正文词。', 'npcink-workflow-toolbox' );
-                }
-                if ( in_array( 'title_term_name_match', $match_signals, true ) ) {
-                        $quality_issues[] = __( '词条名称在标题中完整出现，优先级更高。', 'npcink-workflow-toolbox' );
-                }
-                if ( in_array( 'slug_alias_match', $match_signals, true ) ) {
-                        $quality_issues[] = __( '词条 slug 或别名与当前编辑上下文匹配。', 'npcink-workflow-toolbox' );
-                }
-                if ( in_array( 'related_site_knowledge_term', $match_signals, true ) ) {
-                        $quality_issues[] = __( '历史相关文章使用过该词汇，可作为站内词库证据。', 'npcink-workflow-toolbox' );
-                }
-                if ( in_array( 'description_only_match', $match_signals, true ) ) {
-                        $quality_score   -= 20;
-                        $quality_issues[] = __( '仅描述字段匹配，避免把弱说明文字当作强分类依据。', 'npcink-workflow-toolbox' );
-                }
-                if ( in_array( 'low_specificity_match', $match_signals, true ) ) {
-                        $quality_score   -= 15;
-                        $quality_issues[] = __( '只有一个较弱 token 匹配，需人工确认是否为标题党或泛化词。', 'npcink-workflow-toolbox' );
-                }
-                if ( empty( $quality_issues ) ) {
-                        $quality_issues[] = __( '仅作为现有 WordPress 词条候选，采用人工审查。', 'npcink-workflow-toolbox' );
-                }
-                if ( 0 === absint( $related_context['source_count'] ?? 0 ) && ! in_array( 'current_draft_match', $match_signals, true ) ) {
-                        $quality_score   -= 15;
-                        $quality_issues[] = __( '缺少当前草稿或历史文章的强匹配证据。', 'npcink-workflow-toolbox' );
-                }
-
-                $status = 'good';
-                if ( $quality_score < 70 ) {
-                        $status = 'review';
-                }
-                if ( $quality_score < 55 ) {
-                        $status = 'weak';
-                }
-
-                return array(
-                        'score'      => max( 0, min( 100, $quality_score ) ),
-                        'status'     => $status,
-                        'confidence' => max( 0.0, min( 1.0, $score / 5 ) ),
-                        'issues'     => array_values( array_unique( $quality_issues ) ),
-                );
-        }
-
         private function editor_related_post_terms_for_context( int $post_id ): array {
                 if ( 0 >= $post_id || ! function_exists( 'get_the_terms' ) ) {
@@ -4505 +3807 @@
         private function editor_related_content_term_evidence( array $related_content ): array {
                 $evidence = array();
-                foreach ( array_slice( $this->editor_related_content_items( $related_content ), 0, 20 ) as $index => $item ) {
+                foreach ( array_slice( Rest_Editor_Flow_Cache::editor_related_content_items( $related_content ), 0, 20 ) as $index => $item ) {
                         $post_id = absint( $item['post_id'] ?? 0 );
                         if ( 0 >= $post_id ) {
@@ -4947 +4249 @@
                 $review_set_result                                        = $this->editor_toolkit_taxonomy_review_set( $input );
                 if ( is_wp_error( $review_set_result ) ) {
-                        $taxonomy_terms['taxonomy_tag_review_set'] = $this->editor_taxonomy_review_set_from_suggestions( $taxonomy_terms, $review_set_result );
+                        $taxonomy_terms['taxonomy_tag_review_set'] = Rest_Editor_Taxonomy_Shaping::editor_taxonomy_review_set_from_suggestions( $taxonomy_terms, $review_set_result );
                 } else {
                         $review_set_data                           = is_array( $review_set_result['data'] ?? null ) ? $review_set_result['data'] : $review_set_result;
                         $taxonomy_terms['taxonomy_tag_review_set'] = is_array( $review_set_data ) && 'taxonomy_tag_review_set' === (string) ( $review_set_data['artifact_type'] ?? '' )
                                 ? $review_set_data
-                                : $this->editor_taxonomy_review_set_from_suggestions(
+                                : Rest_Editor_Taxonomy_Shaping::editor_taxonomy_review_set_from_suggestions(
                                         $taxonomy_terms,
                                         new WP_Error(
@@ -5035 +4337 @@
 
                 return $result;
-        }
-
-        private function editor_taxonomy_review_set_from_suggestions( array $taxonomy_terms, WP_Error $fallback_reason ): array {
-                $items            = is_array( $taxonomy_terms['items'] ?? null ) ? array_values( array_filter( $taxonomy_terms['items'], 'is_array' ) ) : array();
-                $review_set_limit = 8;
-                $selected         = array();
-                $blocked          = array();
-
-                foreach ( $items as $item ) {
-                        $quality = $this->editor_taxonomy_candidate_quality( $item );
-                        $row     = array(
-                                'candidate_id'               => ( 'category' === (string) ( $item['taxonomy'] ?? '' ) ? 'category_' : 'tag_' ) . absint( $item['term_id'] ?? 0 ),
-                                'candidate_contract'         => 'taxonomy_tag_review_candidate.v1',
-                                'taxonomy'                   => sanitize_key( (string) ( $item['taxonomy'] ?? '' ) ),
-                                'term_id'                    => absint( $item['term_id'] ?? 0 ),
-                                'name'                       => sanitize_text_field( (string) ( $item['name'] ?? '' ) ),
-                                'slug'                       => sanitize_title( (string) ( $item['slug'] ?? '' ) ),
-                                'score'                      => is_numeric( $item['score'] ?? null ) ? (float) $item['score'] : 0.0,
-                                'quality'                    => $quality,
-                                'reason'                     => sanitize_text_field( (string) ( $item['reason'] ?? '' ) ),
-                                'evidence_refs'              => is_array( $item['evidence_refs'] ?? null ) ? array_values( array_map( 'sanitize_text_field', $item['evidence_refs'] ) ) : array(),
-                                'proposed_action'            => 'append_existing_term',
-                                'needs_operator_review'      => true,
-                                'direct_wordpress_write'     => false,
-                                'term_creation_allowed'      => false,
-                                'term_assignment_authorized' => false,
-                        );
-                        if ( '' === $row['name'] || 0 >= $row['term_id'] ) {
-                                $row['blocked_reason'] = 'invalid_existing_term_candidate';
-                                $blocked[]             = $row;
-                                continue;
-                        }
-                        if ( 'weak' === (string) $quality['status'] ) {
-                                $row['blocked_reason'] = 'weak_taxonomy_evidence';
-                                $blocked[]             = $row;
-                                continue;
-                        }
-                        if ( count( $selected ) >= $review_set_limit ) {
-                                $row['blocked_reason'] = 'review_set_limit_reached';
-                                $blocked[]             = $row;
-                                continue;
-                        }
-                        $row['review_status'] = 'good' === (string) $quality['status'] ? 'ready_for_review' : 'review_recommended';
-                        $selected[]           = $row;
-                }
-
-                return array(
-                        'contract_version'            => 'taxonomy_tag_review_set.v1',
-                        'artifact_type'               => 'taxonomy_tag_review_set',
-                        'mode'                        => 'governed_review_set',
-                        'write_posture'               => 'suggestion_only',
-                        'final_write_path'            => 'core_proposal_required',
-                        'direct_wordpress_write'      => false,
-                        'proposal_created'            => false,
-                        'execution_created'           => false,
-                        'commit_execution'            => false,
-                        'source_ability_id'           => 'npcink-abilities-toolkit/suggest-post-taxonomy-terms',
-                        'preferred_source_ability_id' => 'npcink-abilities-toolkit/build-taxonomy-tag-review-set',
-                        'runtime_owner'               => 'npcink-workflow-toolbox',
-                        'fallback_reason'             => sanitize_key( $fallback_reason->get_error_code() ),
-                        'fallback_message'            => sanitize_text_field( $fallback_reason->get_error_message() ),
-                        'review_set_limit'            => $review_set_limit,
-                        'eligibility_summary'         => array(
-                                'scanned'  => count( $items ),
-                                'selected' => count( $selected ),
-                                'blocked'  => count( $blocked ),
-                        ),
-                        'selected_items'              => $selected,
-                        'blocked_items'               => $blocked,
-                        'safety'                      => array(
-                                'term_creation_allowed'    => false,
-                                'term_assignment_allowed'  => false,
-                                'proposal_created'         => false,
-                                'direct_wordpress_write'   => false,
-                                'provider_runtime_used'    => false,
-                                'cloud_runtime_dependency' => false,
-                        ),
-                        'handoff'                     => array(
-                                'accepted_selection_target' => 'npcink-abilities-toolkit/build-content-metadata-apply-plan',
-                                'term_assignment_target'    => 'npcink-abilities-toolkit/set-post-terms',
-                                'final_write_path'          => 'core_proposal_required',
-                                'operator_review_required'  => true,
-                        ),
-                );
         }
 
@@ -5198 +4416 @@
                         'occurrence_index' => absint( $item['occurrence_index'] ?? 0 ),
                         'context_heading'  => sanitize_text_field( (string) ( $item['context_heading'] ?? '' ) ),
-                        'context_before'   => sanitize_textarea_field( $this->editor_trim_chars( (string) ( $item['context_before'] ?? '' ), 240 ) ),
-                        'context_after'    => sanitize_textarea_field( $this->editor_trim_chars( (string) ( $item['context_after'] ?? '' ), 240 ) ),
-                        'context_caption'  => sanitize_textarea_field( $this->editor_trim_chars( (string) ( $item['context_caption'] ?? '' ), 220 ) ),
-                        'context_summary'  => sanitize_textarea_field( $this->editor_trim_chars( (string) ( $item['context_summary'] ?? '' ), 360 ) ),
+                        'context_before'   => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( (string) ( $item['context_before'] ?? '' ), 240 ) ),
+                        'context_after'    => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( (string) ( $item['context_after'] ?? '' ), 240 ) ),
+                        'context_caption'  => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( (string) ( $item['context_caption'] ?? '' ), 220 ) ),
+                        'context_summary'  => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( (string) ( $item['context_summary'] ?? '' ), 360 ) ),
                         'decorative'       => ! empty( $item['decorative'] ),
                         'target_scope'     => 'post_block_alt',

npcink-workflow-toolbox/tags/0.5.3/includes/Settings.php

@@ -11 +11 @@
 
 final class Settings {
+
+        public const REVIEW_TALLY_SETS = array(
+                'media_alt'          => 'media_alt_caption_review_set.v1',
+                'taxonomy_tag'       => 'taxonomy_tag_review_set.v1',
+                'internal_link'      => 'internal_link_review_set.v1',
+                'comment_moderation' => 'comment_moderation_review_set.v1',
+                'flagged_media'      => 'flagged_media_review_set.v1',
+        );
         public function register(): void {
                 register_setting(
@@ -895 +903 @@
                 return '' !== trim( (string) $value );
         }
+
+        /**
+         * Review-set adoption tally: the operator's own accept/ignore counts per
+         * review set, feeding the batch-apply decision gate. Counts and bounded
+         * timestamps only - no suggestion content, no Cloud data, no WordPress
+         * content writes.
+         */
+        public function get_review_tally(): array {
+                $value = get_option( Plugin::REVIEW_TALLY_OPTION_NAME, array() );
+                return is_array( $value ) ? $value : array();
+        }
+
+        public function record_review_tally_mark( string $review_set, string $decision ): array {
+                if ( ! array_key_exists( $review_set, self::REVIEW_TALLY_SETS ) ) {
+                        return array();
+                }
+                if ( ! in_array( $decision, array( 'accepted', 'ignored' ), true ) ) {
+                        return array();
+                }
+                $tally   = $this->get_review_tally();
+                $marks   = is_array( $tally['marks'] ?? null ) ? $tally['marks'] : array();
+                $marks[] = array(
+                        'set'       => $review_set,
+                        'decision'  => $decision,
+                        'timestamp' => time(),
+                );
+                // Bounded log: 2000 marks covers months of single-operator use; a
+                // 7-day window reaching the cap means 250+ marks/day - far past the
+                // batch-apply gate threshold, where undercounting is immaterial.
+                //
+                // Accepted residual (recorded 2026-10-08, raised four advisory
+                // rounds): the get_option -> append -> update_option sequence has
+                // no cross-request mutual exclusion, so two truly concurrent marks
+                // can lose one count. The WordPress options API offers no compare-
+                // and-swap; single-operator admin usage makes the window negligible
+                // and the tally is advisory decision data, not accounting truth.
+                $tally['marks'] = array_slice( $marks, -2000 );
+                update_option( Plugin::REVIEW_TALLY_OPTION_NAME, $tally, false );
+                return $tally;
+        }
+
+        public function review_tally_summary( int $days = 7 ): array {
+                $tally   = $this->get_review_tally();
+                $marks   = is_array( $tally['marks'] ?? null ) ? $tally['marks'] : array();
+                $cutoff  = time() - ( $days * DAY_IN_SECONDS );
+                $summary = array(
+                        'window_days' => $days,
+                        'total'       => array(
+                                'accepted' => 0,
+                                'ignored'  => 0,
+                        ),
+                        'sets'        => array(),
+                );
+                foreach ( array_keys( self::REVIEW_TALLY_SETS ) as $set_key ) {
+                        $summary['sets'][ $set_key ] = array(
+                                'accepted' => 0,
+                                'ignored'  => 0,
+                        );
+                }
+                foreach ( $marks as $mark ) {
+                        if ( ! is_array( $mark ) || (int) ( $mark['timestamp'] ?? 0 ) < $cutoff ) {
+                                continue;
+                        }
+                        $set      = sanitize_key( (string) ( $mark['set'] ?? '' ) );
+                        $decision = sanitize_key( (string) ( $mark['decision'] ?? '' ) );
+                        if ( ! isset( $summary['sets'][ $set ] ) || ! in_array( $decision, array( 'accepted', 'ignored' ), true ) ) {
+                                continue;
+                        }
+                        ++$summary['sets'][ $set ][ $decision ];
+                        ++$summary['total'][ $decision ];
+                }
+                return $summary;
+        }
 }

npcink-workflow-toolbox/tags/0.5.3/languages/npcink-workflow-toolbox-zh_CN-npcink-toolbox-admin.json

@@ -909 +909 @@
       "Check that Npcink Cloud is connected, then start the optimization again. Already completed images in this batch are kept.": ["请确认 Npcink Cloud 已连接，然后重新开始优化。本批次中已完成的图片会保留。"],
       "Review the failed rows, then choose Retry failed previews again or deselect those rows. Successful previews remain unchanged.": ["请检查失败的行，然后选择再次重试失败预览或取消选中这些行。成功的预览保持不变。"],
-      "Keep the current selection, resolve the reported issue, then use the same preview action again. Toolbox will not retry automatically.": ["请保持当前选择，解决报告的问题后重新执行同一预览操作。Toolbox 不会自动重试。"]
+      "Keep the current selection, resolve the reported issue, then use the same preview action again. Toolbox will not retry automatically.": ["请保持当前选择，解决报告的问题后重新执行同一预览操作。Toolbox 不会自动重试。"],
+      "Accept +1": ["接受 +1"],
+      "Ignore +1": ["忽略 +1"],
+      "Last 7 days": ["近 7 天"],
+      "accepted": ["已接受"],
+      "ignored": ["已忽略"],
+      "Local counts only. No content is written.": ["仅本地计数，不写入任何内容。"],
+      "Could not save the tally mark. Try again.": ["无法保存计数标记，请重试。"],
+      "Counts unavailable. Try reloading.": ["计数不可用，请刷新重试。"],
+      "Last %d days": ["近 %d 天"]
     }
   }

npcink-workflow-toolbox/tags/0.5.3/npcink-workflow-toolbox.php

@@ -3 +3 @@
  * Plugin Name: Npcink Workflow Toolbox
  * Description: Fixed AI workflow buttons for WordPress operators, with review-only suggestions and governed handoff plans.
- * Version: 0.5.2
+ * Version: 0.5.3
  * Requires at least: 6.9
  * Requires PHP: 8.0
@@ -63 +63 @@
 require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Surface_Bridges.php';
 require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Local_Admin_Consent.php';
+require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Editor_Flow_Cache.php';
+require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Editor_Paragraph_Check.php';
+require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Editor_Audio_Text.php';
+require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Editor_Taxonomy_Shaping.php';
 require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Editor_Content_Support.php';
 require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Controller.php';

npcink-workflow-toolbox/tags/0.5.3/readme.txt

@@ -5 +5 @@
 Requires PHP: 8.0
 Tested up to: 7.1
-Stable tag: 0.5.2
+Stable tag: 0.5.3
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -230 +230 @@
 == Changelog ==
 
+= 0.5.3 =
+
+* Added the review-set adoption tally: every review-set result panel
+  carries local Accept/Ignore +1 buttons with a Last-7-days line, so the
+  batch-apply decision data builds itself during normal use (Toolbox
+  settings counts only; no suggestion content is stored).
+* Hardened editor plain-text extraction to the inert DOMParser path
+  (inline handlers and resource fetches in block HTML can no longer
+  execute during text extraction).
+* Guarded the advisory review workflow against missing LLM configuration
+  and fixed the form that briefly stopped all review rounds.
+* Restructured the editor content-support service into five cohesive
+  units behind one facade (paragraph check, audio text, flow cache,
+  taxonomy shaping) with unchanged behavior.
+
 = 0.5.2 =
 

npcink-workflow-toolbox/tags/0.5.3/uninstall.php

@@ -16 +16 @@
                         'npcink_toolbox_media_optimization_settings',
                         'npcink_toolbox_watermark_templates',
+                        'npcink_toolbox_review_tally',
                         'npcink_toolbox_zhihu_hot_topic_pool_backup_v1',
                         'npcink_toolbox_media_optimization_batches',

npcink-workflow-toolbox/trunk/assets/admin.css

@@ -4251 +4251 @@
         color: #b32d2e;
 }
+
+.npcink-toolbox__review-tally {
+        display: flex;
+        flex-wrap: wrap;
+        align-items: center;
+        gap: 6px 8px;
+        margin: 10px 0 0;
+        padding: 8px 10px;
+        background: #fff;
+        border: 1px solid #dcdcde;
+        border-left: 4px solid #72aee6;
+        border-radius: 4px;
+        font-size: 12px;
+}
+
+.npcink-toolbox__review-tally-summary {
+        font-weight: 600;
+}
+
+.npcink-toolbox__review-tally-note {
+        color: #50575e;
+}

npcink-workflow-toolbox/trunk/assets/admin.js

@@ -415 +415 @@
                 }
 
+                maybeAttachReviewTally(form, result);
+
                 return result;
+        }
+
+        const REVIEW_TALLY_FORM_SETS = [
+                ['data-toolbox-comment-moderation-review', 'comment_moderation'],
+                ['data-toolbox-taxonomy-tag-review', 'taxonomy_tag'],
+                ['data-toolbox-internal-link-review', 'internal_link'],
+                ['data-toolbox-flagged-media-review', 'flagged_media'],
+                ['data-toolbox-media-alt-caption-review', 'media_alt'],
+        ];
+        let reviewTallySummaryPromise = null;
+
+        function reviewTallySummary() {
+                if (!reviewTallySummaryPromise) {
+                        reviewTallySummaryPromise = fetch(joinRestUrl(config.restUrl, 'review-tally/summary'), {
+                                headers: { 'X-WP-Nonce': config.nonce || '' },
+                        }).then((response) => (response.ok ? response.json() : null)).then((summary) => {
+                                // Neither a rejected fetch nor a non-ok response is cached:
+                                // the next attached bar retries instead of showing a stale
+                                // zero count that the decision gate could mistake for data.
+                                if (!summary) {
+                                        reviewTallySummaryPromise = null;
+                                }
+                                return summary;
+                        }).catch(() => {
+                                reviewTallySummaryPromise = null;
+                                return null;
+                        });
+                }
+                return reviewTallySummaryPromise;
+        }
+
+        function paintReviewTallyBars(summary) {
+                // Paint from live DOM state (no closure registry to leak when
+                // result nodes are re-rendered).
+                document.querySelectorAll('.npcink-toolbox__review-tally[data-review-set]').forEach((bar) => {
+                        const line = bar.querySelector('.npcink-toolbox__review-tally-summary');
+                        if (line) {
+                                line.textContent = summary ? reviewTallyLine(summary, bar.getAttribute('data-review-set')) : t('Counts unavailable. Try reloading.');
+                        }
+                });
+        }
+
+        function reviewTallyLine(summary, setKey) {
+                const set = summary && summary.sets && summary.sets[setKey] ? summary.sets[setKey] : { accepted: 0, ignored: 0 };
+                const windowDays = summary && summary.window_days ? Number(summary.window_days) : 7;
+                const label = 7 === windowDays ? t('Last 7 days') : t('Last %d days').replace('%d', String(windowDays));
+                return label + ': ' + Number(set.accepted || 0) + ' ' + t('accepted') + ' / ' + Number(set.ignored || 0) + ' ' + t('ignored');
+        }
+
+        function maybeAttachReviewTally(form, result) {
+                const match = REVIEW_TALLY_FORM_SETS.find(([attr]) => form.hasAttribute(attr));
+                if (!match || !result) {
+                        return;
+                }
+                const setKey = match[1];
+                if (result.querySelector('.npcink-toolbox__review-tally')) {
+                        return;
+                }
+                const bar = el('div', 'npcink-toolbox__review-tally');
+                bar.setAttribute('data-review-set', setKey);
+                const acceptButton = el('button', 'button button-small');
+                acceptButton.type = 'button';
+                acceptButton.textContent = t('Accept +1');
+                const ignoreButton = el('button', 'button button-small');
+                ignoreButton.type = 'button';
+                ignoreButton.textContent = t('Ignore +1');
+                const line = el('span', 'npcink-toolbox__review-tally-summary');
+                const note = el('span', 'npcink-toolbox__review-tally-note');
+                note.textContent = t('Local counts only. No content is written.');
+                bar.appendChild(acceptButton);
+                bar.appendChild(ignoreButton);
+                bar.appendChild(line);
+                bar.appendChild(note);
+                result.appendChild(bar);
+
+                line.textContent = t('Counts unavailable. Try reloading.');
+                const initialSummaryPromise = reviewTallySummary();
+                initialSummaryPromise.then((summary) => {
+                        // A mark may have completed while this fetch was pending and
+                        // already painted fresh counts; a stale read must not overwrite
+                        // them, so only paint if the shared cache still holds this
+                        // promise's result.
+                        if (reviewTallySummaryPromise === initialSummaryPromise) {
+                                line.textContent = summary ? reviewTallyLine(summary, setKey) : t('Counts unavailable. Try reloading.');
+                        }
+                });
+
+                function mark(decision) {
+                        // Both buttons lock for the whole flight: a concurrent click on
+                        // the sibling would append a second server-side mark.
+                        acceptButton.disabled = true;
+                        ignoreButton.disabled = true;
+                        line.textContent = '';
+                        fetch(joinRestUrl(config.restUrl, 'review-tally/mark'), {
+                                method: 'POST',
+                                headers: { 'Content-Type': 'application/json', 'X-WP-Nonce': config.nonce || '' },
+                                body: JSON.stringify({ review_set: setKey, decision }),
+                        }).then((response) => (response.ok ? response.json() : null)).then((summary) => {
+                                if (!summary) {
+                                        line.textContent = t('Could not save the tally mark. Try again.');
+                                        return;
+                                }
+                                reviewTallySummaryPromise = Promise.resolve(summary);
+                                paintReviewTallyBars(summary);
+                        }).catch(() => {
+                                line.textContent = t('Could not save the tally mark. Try again.');
+                        }).finally(() => {
+                                acceptButton.disabled = false;
+                                ignoreButton.disabled = false;
+                        });
+                }
+                acceptButton.addEventListener('click', () => mark('accepted'));
+                ignoreButton.addEventListener('click', () => mark('ignored'));
         }
 
@@ -595 +710 @@
                         result.appendChild(createRawDetails(error, 'Error payload'));
                 }
+                maybeAttachReviewTally(form, result);
         }
 

npcink-workflow-toolbox/trunk/assets/editor-content-support/text-utils.js

@@ -21 +21 @@
                         return '';
                 }
-                if (typeof window !== 'undefined' && window.document) {
-                        const container = window.document.createElement('div');
-                        container.innerHTML = source;
-                        return String(container.textContent || container.innerText || '').replace(/\s+/g, ' ').trim();
+                // DOMParser documents are inert by specification: no script
+                // execution and no resource fetches, unlike innerHTML on a
+                // detached div, where inline handlers and image loads in block
+                // HTML can still fire while the text is extracted.
+                if (typeof window !== 'undefined' && typeof window.DOMParser === 'function') {
+                        const parsed = new window.DOMParser().parseFromString(source, 'text/html');
+                        return String(parsed.body.textContent || '').replace(/\s+/g, ' ').trim();
                 }
+                // Best-effort tag stripping for environments without DOMParser:
+                // malformed markup with '>' inside attribute values can leak tag text.
                 return source.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim();
         }

npcink-workflow-toolbox/trunk/includes/Plugin.php

@@ -13 +13 @@
 
 final class Plugin {
-        public const OPTION_NAME           = 'npcink_toolbox_settings';
-        public const CONTEXT_OPTION_NAME   = 'npcink_toolbox_content_context';
-        public const MEDIA_OPTION_NAME     = 'npcink_toolbox_media_optimization_settings';
-        public const WATERMARK_OPTION_NAME = 'npcink_toolbox_watermark_templates';
-        public const REST_NAMESPACE        = 'npcink-toolbox/v1';
+        public const OPTION_NAME              = 'npcink_toolbox_settings';
+        public const CONTEXT_OPTION_NAME      = 'npcink_toolbox_content_context';
+        public const MEDIA_OPTION_NAME        = 'npcink_toolbox_media_optimization_settings';
+        public const WATERMARK_OPTION_NAME    = 'npcink_toolbox_watermark_templates';
+        public const REVIEW_TALLY_OPTION_NAME = 'npcink_toolbox_review_tally';
+        public const REST_NAMESPACE           = 'npcink-toolbox/v1';
 
         private static ?Plugin $instance = null;

npcink-workflow-toolbox/trunk/includes/Rest_Controller.php

@@ -95 +95 @@
                 $this->post( '/nightly-inspection/cloud-batch/(?P<run_id>[A-Za-z0-9._:-]+)/result', 'nightly_inspection_cloud_batch_result' );
                 $this->post( '/nightly-inspection/cloud-batch/(?P<run_id>[A-Za-z0-9._:-]+)/retry', 'nightly_inspection_cloud_batch_retry' );
+                $this->post( '/review-tally/mark', 'review_tally_mark' );
+                $this->get( '/review-tally/summary', 'review_tally_summary' );
 
                 register_rest_route(
@@ -235 +237 @@
                         '/ai/content-support'                      => 'cap.toolbox.workflow_suggest',
                         '/ai/site-helpers'                         => 'cap.toolbox.workflow_suggest',
+                        '/review-tally/mark'                       => 'cap.toolbox.workflow_suggest',
+                        '/review-tally/summary'                    => 'cap.toolbox.workflow_suggest',
                         '/ai/image-generation'                     => 'cap.toolbox.image_source',
                         '/flows/article-plan'                      => 'cap.toolbox.workflow_suggest',
@@ -328 +332 @@
         public function nightly_inspection_cloud_batch_result( WP_REST_Request $request ) {
                 return $this->nightly_bridges->nightly_inspection_cloud_batch_result( $request );
+        }
+
+        public function review_tally_mark( WP_REST_Request $request ) {
+                $review_set = sanitize_key( (string) $request->get_param( 'review_set' ) );
+                $decision   = sanitize_key( (string) $request->get_param( 'decision' ) );
+                if ( ! array_key_exists( $review_set, Settings::REVIEW_TALLY_SETS ) ) {
+                        return new WP_Error(
+                                'npcink_toolbox_review_tally_unknown_set',
+                                __( 'A supported review set is required.', 'npcink-workflow-toolbox' ),
+                                array( 'status' => 400 )
+                        );
+                }
+                if ( ! in_array( $decision, array( 'accepted', 'ignored' ), true ) ) {
+                        return new WP_Error(
+                                'npcink_toolbox_review_tally_invalid_decision',
+                                __( 'The tally decision must be accepted or ignored.', 'npcink-workflow-toolbox' ),
+                                array( 'status' => 400 )
+                        );
+                }
+                $this->settings->record_review_tally_mark( $review_set, $decision );
+                return rest_ensure_response( $this->settings->review_tally_summary() );
+        }
+
+        public function review_tally_summary( WP_REST_Request $request ) {
+                $requested_days = absint( $request->get_param( 'days' ) );
+                $days           = $requested_days ? max( 1, min( 90, $requested_days ) ) : 7;
+                return rest_ensure_response( $this->settings->review_tally_summary( $days ) );
         }
 

npcink-workflow-toolbox/trunk/includes/Rest_Editor_Content_Support.php

@@ -23 +23 @@
 defined( 'ABSPATH' ) || exit;
 
-final class Rest_Editor_Content_Support extends Rest_Controller_Support {
+final class Rest_Editor_Content_Support extends Rest_Editor_Flow_Cache {
 
         private const EDITOR_SUMMARY_FULL_CONTENT_MAX_CHARS = 30000;
-        private const EDITOR_AUDIO_TEXT_MAX_CHARS           = 5000;
         private const EDITOR_SELECTED_TEXT_MAX_CHARS        = 2000;
         private const EDITOR_COMMENT_TEXT_MAX_CHARS         = 1200;
-        private const EDITOR_FLOW_CACHE_TTL                 = 300;
         private const EDITOR_PROGRESSIVE_TARGET_MS          = 2500;
         private const EDITOR_PROGRESSIVE_CANDIDATE_LIMIT    = 8;
 
-        private Provider_Client $client;
         private Publish_Preflight_Service $publish_preflight;
 
@@ -210 +207 @@
         private function editor_post_context( WP_REST_Request $request ): array {
                 $content_raw         = (string) $request->get_param( 'content' );
-                $audio_preferences   = $this->editor_audio_preferences_from_request( $request );
+                $audio_preferences   = Rest_Editor_Audio_Text::editor_audio_preferences_from_request( $request );
                 $content             = trim( wp_strip_all_tags( $content_raw ) );
                 $selected_text       = trim( wp_strip_all_tags( (string) $request->get_param( 'selected_text' ) ) );
@@ -232 +229 @@
                         'excerpt'                    => sanitize_textarea_field( (string) $request->get_param( 'excerpt' ) ),
                         'content_text'               => wp_trim_words( $content, 220, '' ),
-                        'content_full_text'          => sanitize_textarea_field( $this->editor_trim_chars( $content, self::EDITOR_SUMMARY_FULL_CONTENT_MAX_CHARS ) ),
-                        'content_audio_text'         => sanitize_textarea_field( $this->editor_trim_chars( $this->editor_audio_text_from_raw_content( $content_raw, $audio_preferences ), self::EDITOR_AUDIO_TEXT_MAX_CHARS ) ),
+                        'content_full_text'          => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( $content, self::EDITOR_SUMMARY_FULL_CONTENT_MAX_CHARS ) ),
+                        'content_audio_text'         => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( Rest_Editor_Audio_Text::editor_audio_text_from_raw_content( $content_raw, $audio_preferences ), Rest_Editor_Audio_Text::EDITOR_AUDIO_TEXT_MAX_CHARS ) ),
                         'selected_text'              => wp_trim_words( sanitize_textarea_field( $selected_text ), 110, '' ),
                         'selected_block_text'        => wp_trim_words( sanitize_textarea_field( $selected_block_text ), 110, '' ),
-                        'selected_text_full'         => sanitize_textarea_field( $this->editor_trim_chars( $selected_text, self::EDITOR_SELECTED_TEXT_MAX_CHARS ) ),
-                        'selected_block_text_full'   => sanitize_textarea_field( $this->editor_trim_chars( $selected_block_text, self::EDITOR_SELECTED_TEXT_MAX_CHARS ) ),
+                        'selected_text_full'         => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( $selected_text, self::EDITOR_SELECTED_TEXT_MAX_CHARS ) ),
+                        'selected_block_text_full'   => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( $selected_block_text, self::EDITOR_SELECTED_TEXT_MAX_CHARS ) ),
                         'selected_block_name'        => sanitize_text_field( (string) $request->get_param( 'selected_block_name' ) ),
                         'user_instruction'           => wp_trim_words( sanitize_textarea_field( $user_instruction ), 60, '' ),
@@ -255 +252 @@
                         'comment_id'                 => absint( $request->get_param( 'comment_id' ) ),
                         'comment_author'             => sanitize_text_field( (string) $request->get_param( 'comment_author' ) ),
-                        'comment_text'               => sanitize_textarea_field( $this->editor_trim_chars( trim( wp_strip_all_tags( (string) $request->get_param( 'comment_text' ) ) ), self::EDITOR_COMMENT_TEXT_MAX_CHARS ) ),
-                );
-        }
-
-        private function editor_audio_preferences_from_request( WP_REST_Request $request ): array {
-                $raw = $request->get_param( 'audio_preferences' );
-                if ( ! is_array( $raw ) ) {
-                        $raw = array();
-                }
-
-                $defaults    = array(
-                        'tone'     => 'calm',
-                        'pace'     => 'normal',
-                        'handling' => 'skip_code',
-                        'focus'    => 'product_names',
-                );
-                $allowed     = array(
-                        'tone'     => array( 'calm', 'formal', 'casual', 'expressive' ),
-                        'pace'     => array( 'normal', 'slow', 'fast' ),
-                        'handling' => array( 'skip_code', 'read_code', 'skip_tables' ),
-                        'focus'    => array( 'product_names', 'numbers', 'headings' ),
-                );
-                $preferences = array();
-                foreach ( $defaults as $key => $default ) {
-                        $value               = sanitize_key( (string) ( $raw[ $key ] ?? $default ) );
-                        $preferences[ $key ] = in_array( $value, $allowed[ $key ], true ) ? $value : $default;
-                }
-                return $preferences;
+                        'comment_text'               => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( trim( wp_strip_all_tags( (string) $request->get_param( 'comment_text' ) ) ), self::EDITOR_COMMENT_TEXT_MAX_CHARS ) ),
+                );
         }
 
@@ -296 +267 @@
                         }
                         $client_id = sanitize_text_field( (string) ( $block['client_id'] ?? '' ) );
-                        $text      = sanitize_textarea_field( $this->editor_trim_chars( wp_strip_all_tags( (string) ( $block['text'] ?? '' ) ), 1600 ) );
+                        $text      = sanitize_textarea_field( Rest_Editor_Audio_Text::trim( wp_strip_all_tags( (string) ( $block['text'] ?? '' ) ), 1600 ) );
                         if ( '' !== $client_id && '' !== $text ) {
                                 $items[] = array(
@@ -306 +277 @@
                 }
                 return $items;
-        }
-
-        private function editor_audio_text_from_raw_content( string $content, array $audio_preferences ): string {
-                $source   = $content;
-                $handling = sanitize_key( (string) ( $audio_preferences['handling'] ?? 'skip_code' ) );
-                if ( 'skip_code' === $handling ) {
-                        $source = preg_replace( '/<!--\s*wp:code\b.*?<!--\s*\/wp:code\s*-->/is', ' ', $source );
-                        $source = preg_replace( '/<pre\b[^>]*>.*?<\/pre>/is', ' ', $source );
-                        $source = preg_replace( '/<code\b[^>]*>.*?<\/code>/is', ' ', $source );
-                }
-                if ( 'skip_tables' === $handling ) {
-                        $source = preg_replace( '/<!--\s*wp:table\b.*?<!--\s*\/wp:table\s*-->/is', ' ', $source );
-                        $source = preg_replace( '/<table\b[^>]*>.*?<\/table>/is', ' ', $source );
-                }
-                return trim( wp_strip_all_tags( (string) $source ) );
-        }
-
-        private function editor_trim_chars( string $value, int $max_chars ): string {
-                $value     = trim( $value );
-                $max_chars = max( 1, $max_chars );
-                if ( function_exists( 'mb_strlen' ) && function_exists( 'mb_substr' ) ) {
-                        return mb_strlen( $value, 'UTF-8' ) > $max_chars ? mb_substr( $value, 0, $max_chars, 'UTF-8' ) : $value;
-                }
-
-                return strlen( $value ) > $max_chars ? substr( $value, 0, $max_chars ) : $value;
         }
 
@@ -555 +501 @@
                         $candidate = trim( preg_replace( '/\s+/u', ' ', (string) $candidate ) ?: '' );
                         if ( '' !== $candidate ) {
-                                return $this->editor_trim_chars( $candidate, 120 );
+                                return Rest_Editor_Audio_Text::trim( $candidate, 120 );
                         }
                 }
@@ -675 +621 @@
                 }
 
-                $trimmed = $this->editor_trim_chars( $summary, 120 );
+                $trimmed = Rest_Editor_Audio_Text::trim( $summary, 120 );
                 if ( $trimmed !== $summary && preg_match( '/\s/u', $trimmed ) ) {
                         $trimmed = preg_replace( '/\s+\S*$/u', '', $trimmed ) ?: $trimmed;
@@ -770 +716 @@
 
                 return wp_trim_words( $query, 80, '' );
-        }
-
-        private function editor_input_scope( array $context ): array {
-                $scope     = sanitize_key( (string) ( $context['context_scope'] ?? 'auto' ) );
-                $selection = trim( (string) ( $context['selected_text'] ?? '' ) . ' ' . (string) ( $context['selected_block_text'] ?? '' ) );
-                if ( 'auto' === $scope ) {
-                        $scope = '' !== $selection ? 'selected_text' : ( '' !== trim( (string) ( $context['content_text'] ?? '' ) ) ? 'full_article' : 'topic_only' );
-                }
-
-                $labels = array(
-                        'selected_text' => __( 'Selected text or supplied snippet', 'npcink-workflow-toolbox' ),
-                        'full_article'  => __( 'Full article context', 'npcink-workflow-toolbox' ),
-                        'topic_only'    => __( 'Topic or short brief', 'npcink-workflow-toolbox' ),
-                );
-
-                $fields = array();
-                foreach ( array( 'title', 'excerpt', 'content_text', 'selected_text', 'selected_block_text', 'post_id' ) as $field ) {
-                        if ( ! empty( $context[ $field ] ) ) {
-                                $fields[] = $field;
-                        }
-                }
-
-                return array(
-                        'id'                     => $scope,
-                        'label'                  => $labels[ $scope ] ?? __( 'Current context', 'npcink-workflow-toolbox' ),
-                        'source_fields'          => $fields,
-                        'operator_selected_mode' => sanitize_key( (string) ( $context['context_scope'] ?? 'auto' ) ),
-                        'detail'                 => __( 'This scope controls ranking context only. Toolbox still returns suggestions and does not write WordPress data.', 'npcink-workflow-toolbox' ),
-                );
         }
 
@@ -1094 +1011 @@
                 $taxonomy_recommendations = '' !== trim( $query )
                         ? array_merge(
-                                $this->editor_taxonomy_recommendation_candidates( 'category_suggestions', $category_items, array(), $this->empty_proposed_new_terms_review() ),
-                                $this->editor_taxonomy_recommendation_candidates( 'tag_suggestions', array(), $tag_items, $this->empty_proposed_new_terms_review() )
+                                Rest_Editor_Taxonomy_Shaping::editor_taxonomy_recommendation_candidates( 'category_suggestions', $category_items, array(), $this->empty_proposed_new_terms_review() ),
+                                Rest_Editor_Taxonomy_Shaping::editor_taxonomy_recommendation_candidates( 'tag_suggestions', array(), $tag_items, $this->empty_proposed_new_terms_review() )
                         )
                         : array();
@@ -1513 +1430 @@
                         $match_score   = (int) ( $item['score'] ?? 0 );
                         $quality_score = min( 95, 55 + $match_score * 8 );
-                        $candidates[]  = $this->editor_recommendation_candidate(
+                        $candidates[]  = Rest_Editor_Flow_Cache::editor_recommendation_candidate(
                                 array(
                                         'id'                   => 'media_library_' . $attachment_id,
@@ -1596 +1513 @@
                         $status       = sanitize_key( (string) ( $item['status'] ?? 'warning' ) );
                         $score        = 'error' === $status ? 35 : 55;
-                        $candidates[] = $this->editor_recommendation_candidate(
+                        $candidates[] = Rest_Editor_Flow_Cache::editor_recommendation_candidate(
                                 array(
                                         'id'             => 'preflight_' . $id,
@@ -1616 +1533 @@
                 return $candidates;
         }
-
-        private function editor_cached_site_knowledge( array $input ) {
-                return $this->editor_cached_client_result(
-                        'site_knowledge',
-                        $input,
-                        function () use ( $input ) {
-                                return $this->client->search_site_knowledge( $input );
-                        }
-                );
-        }
-
-        private function editor_cached_content_discoverability( array $input ) {
-                return $this->editor_cached_client_result(
-                        'content_discoverability',
-                        $input,
-                        function () use ( $input ) {
-                                return $this->client->build_content_discoverability_brief( $input );
-                        }
-                );
-        }
-
-        private function editor_cached_hosted_ai_content_support( array $input, bool $force_refresh = false ) {
-                return $this->editor_cached_client_result(
-                        'hosted_ai_content_support',
-                        $input,
-                        function () use ( $input ) {
-                                return $this->client->run_hosted_ai_content_support( $input );
-                        },
-                        $force_refresh
-                );
-        }
-
-        private function editor_cached_audio_generation( array $input, bool $force_refresh = false ) {
-                return $this->editor_cached_client_result(
-                        'audio_generation',
-                        $input,
-                        function () use ( $input ) {
-                                return $this->client->run_audio_generation( $input );
-                        },
-                        $force_refresh
-                );
-        }
-
-        private function editor_cached_cloud_web_search( array $input, bool $force_refresh = false ) {
-                return $this->editor_cached_client_result(
-                        'cloud_web_search',
-                        $input,
-                        function () use ( $input ) {
-                                return $this->client->test_cloud_web_search( $input );
-                        },
-                        $force_refresh,
-                        function ( array $result ) use ( $input ): bool {
-                                return $this->editor_source_extraction_cacheable( $input, $result );
-                        },
-                        true
-                );
-        }
-
-        private function editor_source_extraction_cacheable( array $input, array $result ): bool {
-                if ( 'source_extraction_preview' !== sanitize_key( (string) ( $input['intent'] ?? '' ) ) ) {
-                        return true;
-                }
-
-                return 'ready' === sanitize_key( (string) ( $result['status'] ?? '' ) )
-                        && 'matched' === sanitize_key( (string) ( $result['url_match'] ?? '' ) )
-                        && ! empty( $result['results'][0]['reader_excerpt'] ?? '' );
-        }
-
-        private function editor_cached_client_result( string $namespace, array $input, callable $callback, bool $force_refresh = false, ?callable $should_cache = null, bool $replace_cache_on_force = false ) {
-                $cache_key = $this->editor_flow_cache_key( $namespace, $input );
-                $cached    = $force_refresh ? false : get_transient( $cache_key );
-                if ( false !== $cached && is_array( $cached ) ) {
-                        if ( null === $should_cache || $should_cache( $cached ) ) {
-                                $cached['cache_status'] = 'hit';
-                                return $cached;
-                        }
-                        delete_transient( $cache_key );
-                }
-
-                $result = $callback();
-                if ( ! is_wp_error( $result ) && is_array( $result ) ) {
-                        $result['cache_status'] = $force_refresh ? 'bypass' : 'miss';
-                        $cacheable              = null === $should_cache || $should_cache( $result );
-                        if ( $cacheable && ( ! $force_refresh || $replace_cache_on_force ) ) {
-                                set_transient( $cache_key, $result, self::EDITOR_FLOW_CACHE_TTL );
-                        } elseif ( $force_refresh && $replace_cache_on_force ) {
-                                delete_transient( $cache_key );
-                        }
-                }
-
-                return $result;
-        }
-
-        private function editor_flow_cache_key( string $namespace, array $input ): string {
-                $json = wp_json_encode( $input );
-                if ( ! is_string( $json ) ) {
-                        $json = serialize( $input );
-                }
-
-                return 'npcink_toolbox_editor_' . sanitize_key( $namespace ) . '_' . md5( $json );
-        }
-
-        /**
-         * Validates one public source URL before Cloud research is requested.
-         *
-         * @param string $value Raw URL.
-         * @return string|WP_Error
-         */
 
         private function editor_source_adaptation_url( string $value ) {
@@ -2556 +2365 @@
 
         private function editor_writing_pack_related_articles( array $knowledge ): array {
-                $items  = $this->editor_related_content_items( $knowledge );
+                $items  = Rest_Editor_Flow_Cache::editor_related_content_items( $knowledge );
                 $result = array();
                 foreach ( array_slice( $items, 0, 6 ) as $index => $item ) {
@@ -2712 +2521 @@
                         'final_write_path'       => 'core_proposal_required',
                         'direct_wordpress_write' => false,
-                        'input_scope'            => $this->editor_input_scope( $context ),
+                        'input_scope'            => Rest_Editor_Flow_Cache::editor_input_scope( $context ),
                         'summary_candidates'     => $summary_ai,
                         'summary_layers'         => $summary_layers,
@@ -2779 +2588 @@
                         'diagnosis'              => array(
                                 'summary_quality'   => $this->editor_summary_quality( $context ),
-                                'taxonomy_quality'  => $this->editor_taxonomy_quality( $context, $categories, $tags, $proposed_new_terms ),
+                                'taxonomy_quality'  => Rest_Editor_Taxonomy_Shaping::editor_taxonomy_quality( $context, $categories, $tags, $proposed_new_terms ),
                                 'hypotheses'        => array(
                                         __( 'A clearer excerpt can improve archive, social, and answer-summary presentation without rewriting the article body.', 'npcink-workflow-toolbox' ),
@@ -2875 +2684 @@
         }
 
-        private function editor_taxonomy_quality( array $context, array $categories, array $tags, array $proposed_new_terms ): string {
-                $current_categories = is_array( $context['category_ids'] ?? null ) ? array_filter( array_map( 'absint', $context['category_ids'] ) ) : array();
-                $current_tags       = is_array( $context['tag_ids'] ?? null ) ? array_filter( array_map( 'absint', $context['tag_ids'] ) ) : array();
-                if ( empty( $current_categories ) && empty( $current_tags ) ) {
-                        return 'missing';
-                }
-                if ( ! empty( $proposed_new_terms['items'] ) || 12 < count( $current_tags ) ) {
-                        return 'noisy';
-                }
-                if ( empty( $categories ) && empty( $tags ) ) {
-                        return 'acceptable';
-                }
-
-                return 'weak';
-        }
-
-        private function editor_related_content_items( array $related_content ): array {
-                $items = is_array( $related_content['results'] ?? null )
-                        ? $related_content['results']
-                        : ( is_array( $related_content['items'] ?? null ) ? $related_content['items'] : array() );
-
-                return array_values(
-                        array_filter(
-                                $items,
-                                static fn( $item ): bool => is_array( $item )
-                        )
-                );
-        }
-
         private function editor_related_content_summary( array $related_content ): array {
-                $items        = $this->editor_related_content_items( $related_content );
+                $items        = Rest_Editor_Flow_Cache::editor_related_content_items( $related_content );
                 $evidence_ids = array();
                 $titles       = array();
@@ -2928 +2708 @@
 
         private function editor_related_content_context_for_ai( array $related_content ): array {
-                $items         = $this->editor_related_content_items( $related_content );
+                $items         = Rest_Editor_Flow_Cache::editor_related_content_items( $related_content );
                 $context_items = array();
 
@@ -3018 +2798 @@
                 $items                                 = is_array( $artifact['items'] ?? null ) ? $artifact['items'] : array();
                 $items                                 = $this->editor_internal_link_merge_cloud_relevance( $items, $related_content_evidence );
-                $artifact['input_scope']               = $this->editor_input_scope( $context );
+                $artifact['input_scope']               = Rest_Editor_Flow_Cache::editor_input_scope( $context );
                 $artifact['source_ability_id']         = 'npcink-abilities-toolkit/resolve-internal-link-targets';
                 $artifact['source_knowledge']          = $source_knowledge;
@@ -3109 +2889 @@
         private function editor_internal_link_related_content_evidence( array $source_knowledge ): array {
                 $evidence = array();
-                foreach ( array_slice( $this->editor_related_content_items( $source_knowledge ), 0, 8 ) as $index => $item ) {
+                foreach ( array_slice( Rest_Editor_Flow_Cache::editor_related_content_items( $source_knowledge ), 0, 8 ) as $index => $item ) {
                         $post_id             = absint( $item['post_id'] ?? ( $item['id'] ?? 0 ) );
                         $candidate_relevance = sanitize_key( (string) ( $item['candidate_relevance'] ?? '' ) );
@@ -3143 +2923 @@
                                 continue;
                         }
-                        $text = trim( sanitize_textarea_field( $this->editor_trim_chars( wp_strip_all_tags( (string) ( $block['text'] ?? '' ) ), 1200 ) ) );
+                        $text = trim( sanitize_textarea_field( Rest_Editor_Audio_Text::trim( wp_strip_all_tags( (string) ( $block['text'] ?? '' ) ), 1200 ) ) );
                         if ( '' === $text ) {
                                 continue;
@@ -3300 +3080 @@
                         }
 
-                        $candidates[] = $this->editor_recommendation_candidate(
+                        $candidates[] = Rest_Editor_Flow_Cache::editor_recommendation_candidate(
                                 array(
                                         'id'                    => 'internal_link_' . ( $index + 1 ),
@@ -3401 +3181 @@
                                 )
                         );
-                        $script                          = $this->editor_audio_summary_script_text( $summary_ai );
+                        $script                          = Rest_Editor_Audio_Text::editor_audio_summary_script_text( $summary_ai );
                         $script_source['summary_script'] = $summary_ai;
                 } else {
-                        $script                       = $this->editor_audio_source_text( $source_text );
+                        $script                       = Rest_Editor_Audio_Text::editor_audio_source_text( $source_text );
                         $script_source['source_mode'] = 'article_text';
                 }
@@ -3466 +3246 @@
         }
 
-        private function editor_audio_source_text( string $text ): string {
-                $plain = trim( wp_strip_all_tags( $text ) );
-                if ( '' === $plain ) {
-                        return '';
-                }
-                if ( function_exists( 'mb_strlen' ) && function_exists( 'mb_substr' ) ) {
-                        return mb_strlen( $plain, 'UTF-8' ) > self::EDITOR_AUDIO_TEXT_MAX_CHARS ? mb_substr( $plain, 0, self::EDITOR_AUDIO_TEXT_MAX_CHARS, 'UTF-8' ) : $plain;
-                }
-                return strlen( $plain ) > self::EDITOR_AUDIO_TEXT_MAX_CHARS ? substr( $plain, 0, self::EDITOR_AUDIO_TEXT_MAX_CHARS ) : $plain;
-        }
-
-        private function editor_audio_summary_script_text( array $summary_ai ): string {
-                $output_json = is_array( $summary_ai['output_json'] ?? null ) ? $summary_ai['output_json'] : array();
-                $parts       = array();
-                foreach ( array( 'opening', 'script', 'closing' ) as $key ) {
-                        $value = trim( sanitize_textarea_field( (string) ( $output_json[ $key ] ?? '' ) ) );
-                        if ( '' !== $value ) {
-                                $parts[] = $value;
-                        }
-                }
-                if ( is_array( $output_json['key_points'] ?? null ) ) {
-                        foreach ( array_slice( $output_json['key_points'], 0, 5 ) as $point ) {
-                                $value = trim( sanitize_textarea_field( (string) $point ) );
-                                if ( '' !== $value ) {
-                                        $parts[] = $value;
-                                }
-                        }
-                }
-                $script = trim( implode( "\n\n", array_values( array_unique( $parts ) ) ) );
-                if ( '' === $script ) {
-                        $script = trim( sanitize_textarea_field( (string) ( $summary_ai['output_text'] ?? '' ) ) );
-                }
-                if ( function_exists( 'mb_strlen' ) && function_exists( 'mb_substr' ) ) {
-                        return mb_strlen( $script, 'UTF-8' ) > self::EDITOR_AUDIO_TEXT_MAX_CHARS ? mb_substr( $script, 0, self::EDITOR_AUDIO_TEXT_MAX_CHARS, 'UTF-8' ) : $script;
-                }
-                return strlen( $script ) > self::EDITOR_AUDIO_TEXT_MAX_CHARS ? substr( $script, 0, self::EDITOR_AUDIO_TEXT_MAX_CHARS ) : $script;
-        }
-
         private function editor_article_checkup_section( array $context ): array {
                 $text       = trim( (string) ( $context['content_full_text'] ?? $context['content_text'] ?? '' ) );
@@ -3680 +3422 @@
                 $signals = array();
 
-                if ( $this->editor_text_has_heading_label_glue( $paragraph ) ) {
+                if ( Rest_Editor_Paragraph_Check::editor_text_has_heading_label_glue( $paragraph ) ) {
                         $signals[] = __( '标题式标签直接黏在正文前', 'npcink-workflow-toolbox' );
                 }
-                if ( $this->editor_text_has_phrase_cluster_glue( $paragraph ) ) {
+                if ( Rest_Editor_Paragraph_Check::editor_text_has_phrase_cluster_glue( $paragraph ) ) {
                         $signals[] = __( '短语组之间缺少分隔', 'npcink-workflow-toolbox' );
                 }
-                if ( $this->editor_text_has_alnum_cjk_glue( $paragraph ) ) {
+                if ( Rest_Editor_Paragraph_Check::editor_text_has_alnum_cjk_glue( $paragraph ) ) {
                         $signals[] = __( '字母、数字或方案标签与中文黏连', 'npcink-workflow-toolbox' );
                 }
@@ -3926 +3668 @@
         }
 
-        private function editor_text_has_heading_label_glue( string $text ): bool {
-                return 1 === preg_match( '/(核心要点|评估维度|主要差异|适用建议|常见问题|方案\s*[A-Za-zＡ-Ｚ])(?=[\p{Han}A-Za-z0-9])/u', $text );
-        }
-
-        private function editor_text_has_phrase_cluster_glue( string $text ): bool {
-                return 1 === preg_match( '/可维护性编辑体验响应式表现治理边界/u', $text )
-                        || 1 === preg_match( '/(可维护性|编辑体验|响应式表现|治理边界)(可维护性|编辑体验|响应式表现|治理边界)(可维护性|编辑体验|响应式表现|治理边界)/u', $text );
-        }
-
-        private function editor_text_has_alnum_cjk_glue( string $text ): bool {
-                return 1 === preg_match( '/(?:[A-Za-z0-9][\x{4e00}-\x{9fff}]|[\x{4e00}-\x{9fff}][A-Za-z0-9]{2,})/u', $text );
-        }
-
-        private function editor_text_has_structural_glue( string $text ): bool {
-                return $this->editor_text_has_heading_label_glue( $text )
-                        || $this->editor_text_has_phrase_cluster_glue( $text )
-                        || $this->editor_text_has_alnum_cjk_glue( $text );
-        }
-
         private function editor_article_checkup_issue( string $id, string $type, string $severity, string $location, string $evidence, string $issue, string $edit_direction ): array {
                 return array(
@@ -3951 +3674 @@
                         'severity'       => sanitize_key( $severity ),
                         'location'       => sanitize_text_field( $location ),
-                        'evidence'       => sanitize_text_field( $this->editor_trim_chars( $evidence, 120 ) ),
+                        'evidence'       => sanitize_text_field( Rest_Editor_Audio_Text::trim( $evidence, 120 ) ),
                         'issue'          => sanitize_text_field( $issue ),
                         'edit_direction' => sanitize_textarea_field( $edit_direction ),
@@ -4007 +3730 @@
                 $section['write_posture']      = 'suggestion_only';
                 if ( 'polish_notes' === $provider_intent ) {
-                        if ( ! $this->editor_paragraph_check_has_output( $section ) ) {
-                                $section = $this->editor_paragraph_check_local_fallback_section( $section, $content );
+                        if ( ! Rest_Editor_Paragraph_Check::editor_paragraph_check_has_output( $section ) ) {
+                                $section = Rest_Editor_Paragraph_Check::editor_paragraph_check_local_fallback_section( $section, $content );
                         } else {
-                                $section = $this->editor_paragraph_check_local_overlay_section( $section, $content );
+                                $section = Rest_Editor_Paragraph_Check::editor_paragraph_check_local_overlay_section( $section, $content );
                         }
                 }
 
                 return $section;
-        }
-
-        private function editor_paragraph_check_has_output( array $section ): bool {
-                if ( ! empty( $section['items'] ) && is_array( $section['items'] ) ) {
-                        return true;
-                }
-                if ( '' !== trim( sanitize_textarea_field( (string) ( $section['output_text'] ?? '' ) ) ) ) {
-                        return true;
-                }
-                $output_json = is_array( $section['output_json'] ?? null ) ? $section['output_json'] : array();
-                foreach ( array( 'clarity_check', 'fact_gaps', 'tone_consistency', 'editing_suggestions', 'assumptions_to_verify' ) as $key ) {
-                        if ( ! empty( $output_json[ $key ] ) ) {
-                                return true;
-                        }
-                }
-                $result = is_array( $section['result'] ?? null ) ? $section['result'] : array();
-                foreach ( array( 'clarity_check', 'fact_gaps', 'tone_consistency', 'editing_suggestions', 'assumptions_to_verify' ) as $key ) {
-                        if ( ! empty( $result[ $key ] ) ) {
-                                return true;
-                        }
-                }
-                return false;
-        }
-
-        private function editor_paragraph_check_local_fallback_section( array $section, string $selected_text ): array {
-                $output = $this->editor_paragraph_check_local_output( $selected_text );
-                $status = sanitize_key( (string) ( $section['status'] ?? 'unknown' ) );
-
-                $section['provider_execution']      = 'hosted_ai_with_local_empty_fallback';
-                $section['hosted_ai_status']        = $status;
-                $section['fallback_reason']         = 'local_paragraph_check_after_hosted_ai_empty';
-                $section['fallback_source']         = 'current_selected_paragraph_only';
-                $section['fallback_write_posture']  = 'suggestion_only_no_replacement_text';
-                $section['fallback_signal_profile'] = is_array( $output['signal_profile'] ?? null )
-                        ? array_map( 'boolval', $output['signal_profile'] )
-                        : array();
-                $section['output_json']             = $output;
-                $section['items']                   = array(
-                        array(
-                                'name'          => __( 'Clarity check', 'npcink-workflow-toolbox' ),
-                                'detail'        => $output['clarity_check'],
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:paragraph' ),
-                        ),
-                        array(
-                                'name'          => __( 'Fact gaps', 'npcink-workflow-toolbox' ),
-                                'detail'        => $output['fact_gaps'],
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:paragraph' ),
-                        ),
-                        array(
-                                'name'          => __( 'Tone consistency', 'npcink-workflow-toolbox' ),
-                                'detail'        => $output['tone_consistency'],
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:paragraph' ),
-                        ),
-                        array(
-                                'name'          => __( 'Editing suggestions', 'npcink-workflow-toolbox' ),
-                                'detail'        => $output['editing_suggestions'],
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:paragraph' ),
-                        ),
-                );
-
-                return $section;
-        }
-
-        private function editor_paragraph_check_local_overlay_section( array $section, string $selected_text ): array {
-                $output  = $this->editor_paragraph_check_local_output( $selected_text, false );
-                $overlay = array(
-                        'artifact_type'      => 'paragraph_local_review_overlay.v1',
-                        'source'             => 'current_selected_paragraph_only',
-                        'write_posture'      => 'suggestion_only_no_replacement_text',
-                        'action_policy'      => 'operator_review_only_no_insert',
-                        'status'             => 'ready',
-                        'provider_execution' => 'local_signal_overlay_after_hosted_ai_output',
-                        'signal_profile'     => is_array( $output['signal_profile'] ?? null )
-                                ? array_map( 'boolval', $output['signal_profile'] )
-                                : array(),
-                        'output_json'        => $output,
-                        'items'              => $this->editor_paragraph_check_local_overlay_items( $output ),
-                );
-
-                $section['local_review_overlay'] = $overlay;
-                $section['local_signal_profile'] = $overlay['signal_profile'];
-
-                $output_json                         = is_array( $section['output_json'] ?? null ) ? $section['output_json'] : array();
-                $output_json['local_review_overlay'] = $overlay;
-                $section['output_json']              = $output_json;
-
-                return $section;
-        }
-
-        private function editor_paragraph_check_local_overlay_items( array $output ): array {
-                $signals = is_array( $output['signal_profile'] ?? null ) ? $output['signal_profile'] : array();
-                $items   = array();
-
-                if ( ! empty( $signals['has_structural_glue'] ) ) {
-                        $items[] = array(
-                                'name'          => __( 'Local structure cross-check', 'npcink-workflow-toolbox' ),
-                                'detail'        => (string) ( $output['clarity_check'] ?? '' ),
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:local_overlay' ),
-                        );
-                        $items[] = array(
-                                'name'          => __( 'Local fact-boundary check', 'npcink-workflow-toolbox' ),
-                                'detail'        => (string) ( $output['fact_gaps'] ?? '' ),
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:local_overlay' ),
-                        );
-                } elseif ( ! empty( $signals['has_metric_claim'] ) || ! empty( $signals['has_comparison_claim'] ) || ! empty( $signals['long_or_dense'] ) ) {
-                        $items[] = array(
-                                'name'          => __( 'Local fact-boundary check', 'npcink-workflow-toolbox' ),
-                                'detail'        => (string) ( $output['fact_gaps'] ?? '' ),
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:local_overlay' ),
-                        );
-                } elseif ( ! empty( $signals['has_scope_claim'] ) || ! empty( $signals['has_causal_transition'] ) ) {
-                        $items[] = array(
-                                'name'          => __( 'Local scope check', 'npcink-workflow-toolbox' ),
-                                'detail'        => (string) ( $output['tone_consistency'] ?? '' ),
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:local_overlay' ),
-                        );
-                }
-
-                if ( ! empty( $items ) ) {
-                        $items[] = array(
-                                'name'          => __( 'Local editing guardrail', 'npcink-workflow-toolbox' ),
-                                'detail'        => (string) ( $output['editing_suggestions'] ?? '' ),
-                                'action_policy' => 'operator_review_only_no_insert',
-                                'evidence_refs' => array( 'current_selection:local_overlay' ),
-                        );
-                }
-
-                return array_values(
-                        array_filter(
-                                $items,
-                                static function ( $item ): bool {
-                                        return is_array( $item ) && '' !== trim( (string) ( $item['detail'] ?? '' ) );
-                                }
-                        )
-                );
-        }
-
-        private function editor_paragraph_check_signal_profile( string $text, int $length, int $punctuation_count ): array {
-                $has_performance_claim = 1 === preg_match( '/(快|慢|耗时|性能|经测试|同等服务器|相当|无明显|明显性能|读取|保存)/u', $text );
-                $has_metric_claim      = 1 === preg_match( '/(\d|万|倍|%|百分|测试|经测试|数量|规模|id|ID|attachment)/u', $text );
-                $has_scope_claim       = 1 === preg_match( '/(可用于|适合|场景|条件|范围|限制|边界|因此|所以|由于|因为)/u', $text );
-                $has_comparison_claim  = 1 === preg_match( '/(比|相比|对比|相较|优于|弱于|快于|慢于|高于|低于)/u', $text );
-                $has_causal_transition = 1 === preg_match( '/(因此|所以|由于|因为|从而|导致)/u', $text );
-
-                return array(
-                        'long_or_dense'         => $length > 150 || $punctuation_count >= 3,
-                        'has_performance_claim' => $has_performance_claim,
-                        'has_metric_claim'      => $has_metric_claim,
-                        'has_scope_claim'       => $has_scope_claim,
-                        'has_comparison_claim'  => $has_comparison_claim,
-                        'has_causal_transition' => $has_causal_transition,
-                        'has_structural_glue'   => $this->editor_text_has_structural_glue( $text ),
-                );
-        }
-
-        private function editor_paragraph_check_local_output( string $selected_text, bool $hosted_ai_empty = true ): array {
-                $text              = trim( preg_replace( '/\s+/u', ' ', wp_strip_all_tags( $selected_text ) ) ?: '' );
-                $length            = function_exists( 'mb_strlen' ) ? mb_strlen( $text, 'UTF-8' ) : strlen( $text );
-                $punctuation_count = preg_match_all( '/[。！？!?；;]/u', $text );
-                $signals           = $this->editor_paragraph_check_signal_profile( $text, $length, (int) $punctuation_count );
-
-                if ( $signals['has_structural_glue'] ) {
-                        $clarity = __( '选中段落疑似存在标题词、选项标签或短语串与正文黏连的问题，建议先检查分隔、标点、列表或小标题结构。', 'npcink-workflow-toolbox' );
-                } elseif ( $signals['long_or_dense'] && $signals['has_metric_claim'] ) {
-                        $clarity = __( '段落信息量偏高，建议人工检查测试条件、对比结论和适用边界是否需要拆开呈现，避免读者把多个结论混在一起。', 'npcink-workflow-toolbox' );
-                } elseif ( $signals['long_or_dense'] ) {
-                        $clarity = __( '段落信息量偏高，建议人工检查主语、原因、结论和适用边界是否需要拆开呈现，避免读者把多个判断混在一起。', 'npcink-workflow-toolbox' );
-                } else {
-                        $clarity = __( '段落结构基本清楚；重点检查判断对象、原因和适用边界是否已经在上下文中交代。', 'npcink-workflow-toolbox' );
-                }
-
-                $fact_gaps = $signals['has_structural_glue']
-                        ? __( '结构黏连会影响读者判断事实边界；发布前需要确认每个标签、维度、方案、ID 或问答对应的正文是否清楚分开。', 'npcink-workflow-toolbox' )
-                        : ( $signals['has_performance_claim']
-                                ? __( '包含测试、数量、速度或耗时类结论；发布前需要确认测试条件、数据规模、对比对象和结论来源，避免把单次测试写成通用事实。', 'npcink-workflow-toolbox' )
-                                : ( $signals['has_metric_claim']
-                                        ? __( '包含数字、ID、数量或范围类表述；发布前需要确认这些数字对应的对象、条件和来源，避免把局部证据写成通用事实。', 'npcink-workflow-toolbox' )
-                                        : ( $signals['has_comparison_claim']
-                                                ? __( '包含比较性判断；发布前需要确认比较对象、比较条件和依据是否在上下文中明确。', 'npcink-workflow-toolbox' )
-                                                : __( '未发现明显数字或比较结论；仍需人工确认段落中的判断是否有上下文依据。', 'npcink-workflow-toolbox' ) ) ) );
-
-                $tone = $signals['has_scope_claim']
-                        ? __( '语气整体偏说明性；涉及“适合/因此/场景”等判断时，建议保持审慎，不要超过已验证范围。', 'npcink-workflow-toolbox' )
-                        : ( $signals['has_causal_transition']
-                                ? __( '语气整体偏推论式；建议确认原因和结论之间的关系是否足够明确。', 'npcink-workflow-toolbox' )
-                                : __( '语气整体中性；保持事实说明，并避免加入选中段落没有承载的新判断。', 'npcink-workflow-toolbox' ) );
-
-                $editing_parts = array( __( '不要直接替换正文。', 'npcink-workflow-toolbox' ) );
-                if ( $signals['has_structural_glue'] ) {
-                        $editing_parts[] = __( '优先拆开标题词、选项标签、短语串和正文说明。', 'npcink-workflow-toolbox' );
-                } elseif ( $signals['has_performance_claim'] ) {
-                        $editing_parts[] = __( '优先核对测试条件、性能口径和对比对象。', 'npcink-workflow-toolbox' );
-                } elseif ( $signals['has_metric_claim'] ) {
-                        $editing_parts[] = __( '优先核对数字、ID、数量口径和对应对象。', 'npcink-workflow-toolbox' );
-                } elseif ( $signals['has_comparison_claim'] ) {
-                        $editing_parts[] = __( '优先核对比较对象和比较条件。', 'npcink-workflow-toolbox' );
-                } else {
-                        $editing_parts[] = __( '优先核对该段判断是否有上下文依据。', 'npcink-workflow-toolbox' );
-                }
-                if ( $signals['has_scope_claim'] ) {
-                        $editing_parts[] = __( '必要时缩小适用范围，或把原因和边界分开审阅。', 'npcink-workflow-toolbox' );
-                } else {
-                        $editing_parts[] = __( '必要时补充限定条件，或把原因和结论分开审阅。', 'npcink-workflow-toolbox' );
-                }
-                $editing = implode( '', $editing_parts );
-
-                return array(
-                        'clarity_check'         => $clarity,
-                        'fact_gaps'             => $fact_gaps,
-                        'tone_consistency'      => $tone,
-                        'editing_suggestions'   => $editing,
-                        'assumptions_to_verify' => $hosted_ai_empty
-                                ? __( '托管 AI 本次未返回建议，以上为本地兜底检查；仍以人工编辑和原始测试记录为准。', 'npcink-workflow-toolbox' )
-                                : __( '本地复核只检查结构、事实口径和语气风险；托管 AI 建议仍需人工审阅。', 'npcink-workflow-toolbox' ),
-                        'signal_profile'        => $signals,
-                );
-        }
-
-        private function editor_recommendation_candidate( array $args ): array {
-                $candidate = array(
-                        'contract'               => 'recommendation_candidate.v1',
-                        'id'                     => sanitize_key( (string) ( $args['id'] ?? 'candidate' ) ),
-                        'kind'                   => sanitize_key( (string) ( $args['kind'] ?? 'generic' ) ),
-                        'label'                  => sanitize_text_field( (string) ( $args['label'] ?? __( 'Recommendation candidate', 'npcink-workflow-toolbox' ) ) ),
-                        'value'                  => sanitize_text_field( (string) ( $args['value'] ?? '' ) ),
-                        'reason'                 => sanitize_text_field( (string) ( $args['reason'] ?? '' ) ),
-                        'confidence'             => is_numeric( $args['confidence'] ?? null ) ? max( 0, min( 1, (float) $args['confidence'] ) ) : null,
-                        'quality_status'         => sanitize_key( (string) ( $args['quality_status'] ?? 'review' ) ),
-                        'quality_score'          => absint( $args['quality_score'] ?? 0 ),
-                        'quality_issues'         => is_array( $args['quality_issues'] ?? null ) ? array_values( array_map( 'sanitize_text_field', $args['quality_issues'] ) ) : array(),
-                        'action_policy'          => sanitize_key( (string) ( $args['action_policy'] ?? 'suggestion_only' ) ),
-                        'target_field'           => sanitize_key( (string) ( $args['target_field'] ?? '' ) ),
-                        'write_posture'          => 'suggestion_only',
-                        'direct_wordpress_write' => false,
-                        'evidence_refs'          => is_array( $args['evidence_refs'] ?? null ) ? array_values( array_map( 'sanitize_text_field', $args['evidence_refs'] ) ) : array(),
-                );
-
-                if ( '' !== (string) ( $args['source_candidate_ref'] ?? '' ) ) {
-                        $candidate['source_candidate_ref'] = sanitize_text_field( (string) $args['source_candidate_ref'] );
-                }
-                if ( '' !== (string) ( $args['candidate_source'] ?? '' ) ) {
-                        $candidate['candidate_source'] = sanitize_key( (string) $args['candidate_source'] );
-                }
-                if ( in_array( (string) ( $args['candidate_relevance'] ?? '' ), array( 'strong', 'review', 'weak' ), true ) ) {
-                        $candidate['candidate_relevance'] = (string) $args['candidate_relevance'];
-                }
-                if ( is_array( $args['target_ref'] ?? null ) ) {
-                        $target_ref              = $args['target_ref'];
-                        $candidate['target_ref'] = array(
-                                'post_id'   => absint( $target_ref['post_id'] ?? 0 ),
-                                'title'     => sanitize_text_field( (string) ( $target_ref['title'] ?? '' ) ),
-                                'url'       => esc_url_raw( (string) ( $target_ref['url'] ?? '' ) ),
-                                'status'    => sanitize_key( (string) ( $target_ref['status'] ?? '' ) ),
-                                'post_type' => sanitize_key( (string) ( $target_ref['post_type'] ?? '' ) ),
-                        );
-                }
-                if ( '' !== (string) ( $args['anchor_or_context'] ?? '' ) ) {
-                        $candidate['anchor_or_context'] = sanitize_text_field( (string) $args['anchor_or_context'] );
-                }
-                if ( array_key_exists( 'can_apply_to_editor', $args ) ) {
-                        $candidate['can_apply_to_editor'] = true === $args['can_apply_to_editor'];
-                }
-                if ( '' !== (string) ( $args['anchor_quality_status'] ?? '' ) ) {
-                        $candidate['anchor_quality_status'] = sanitize_key( (string) $args['anchor_quality_status'] );
-                }
-                if ( '' !== (string) ( $args['evidence_note'] ?? '' ) ) {
-                        $candidate['evidence_note'] = sanitize_text_field( (string) $args['evidence_note'] );
-                }
-                if ( '' !== (string) ( $args['owner_label'] ?? '' ) ) {
-                        $candidate['owner_label'] = sanitize_key( (string) $args['owner_label'] );
-                }
-                if ( '' !== (string) ( $args['next_safe_action'] ?? '' ) ) {
-                        $candidate['next_safe_action'] = sanitize_key( (string) $args['next_safe_action'] );
-                }
-                if ( is_array( $args['source_match'] ?? null ) ) {
-                        $source_match  = $args['source_match'];
-                        $client_id     = sanitize_text_field( (string) ( $source_match['block_client_id'] ?? '' ) );
-                        $matched_text  = sanitize_text_field( (string) ( $source_match['matched_text'] ?? '' ) );
-                        $expected_text = sanitize_textarea_field( $this->editor_trim_chars( wp_strip_all_tags( (string) ( $source_match['expected_text'] ?? '' ) ), 1600 ) );
-                        if ( '' !== $client_id && '' !== $matched_text && '' !== $expected_text ) {
-                                $candidate['source_match'] = array(
-                                        'block_client_id' => $client_id,
-                                        'block_name'      => sanitize_text_field( (string) ( $source_match['block_name'] ?? '' ) ),
-                                        'matched_text'    => $matched_text,
-                                        'text_offset'     => absint( $source_match['text_offset'] ?? 0 ),
-                                        'expected_text'   => $expected_text,
-                                        'match_basis'     => sanitize_key( (string) ( $source_match['match_basis'] ?? '' ) ),
-                                );
-                        }
-                }
-                if ( '' !== (string) ( $args['priority_reason'] ?? '' ) ) {
-                        $candidate['priority_reason'] = sanitize_text_field( (string) $args['priority_reason'] );
-                }
-                if ( is_array( $args['link_graph_issues'] ?? null ) ) {
-                        $candidate['link_graph_issues'] = array_values( array_filter( array_map( 'sanitize_key', $args['link_graph_issues'] ) ) );
-                }
-                if ( is_array( $args['shared_terms'] ?? null ) ) {
-                        $candidate['shared_terms'] = array_slice( array_values( array_filter( array_map( 'sanitize_text_field', $args['shared_terms'] ) ) ), 0, 3 );
-                }
-                $candidate['incoming_count'] = absint( $args['incoming_count'] ?? 0 );
-
-                return $candidate;
         }
 
@@ -4337 +3750 @@
                 );
 
-                return $this->editor_taxonomy_only_suggestion_section(
+                return Rest_Editor_Taxonomy_Shaping::editor_taxonomy_only_suggestion_section(
                         'category_suggestions',
                         $categories,
@@ -4358 +3771 @@
                 $proposed_new_terms = $this->empty_proposed_new_terms_review();
 
-                return $this->editor_taxonomy_only_suggestion_section(
+                return Rest_Editor_Taxonomy_Shaping::editor_taxonomy_only_suggestion_section(
                         'tag_suggestions',
                         array(),
@@ -4368 +3781 @@
         }
 
-        private function editor_taxonomy_only_suggestion_section( string $candidate_type, array $categories, array $tags, array $proposed_new_terms, array $taxonomy_terms, array $context ): array {
-                return array(
-                        'artifact_type'             => 'article_taxonomy_suggestions.v1',
-                        'composition_role'          => 'taxonomy_candidates_only',
-                        'candidate_type'            => sanitize_key( $candidate_type ),
-                        'candidate_contract'        => 'recommendation_candidate.v1',
-                        'write_posture'             => 'suggestion_only',
-                        'final_write_path'          => 'core_proposal_required',
-                        'direct_wordpress_write'    => false,
-                        'input_scope'               => $this->editor_input_scope( $context ),
-                        'category_candidates'       => array_slice( $categories, 0, 5 ),
-                        'tag_candidates'            => array_slice( $tags, 0, 8 ),
-                        'proposed_new_terms'        => $proposed_new_terms,
-                        'taxonomy_terms'            => $taxonomy_terms,
-                        'recommendation_candidates' => $this->editor_taxonomy_recommendation_candidates( $candidate_type, $categories, $tags, $proposed_new_terms ),
-                        'quality_gate'              => array(
-                                'name'           => 'runtime_taxonomy_candidate_rerank',
-                                'policy'         => 'existing_terms_first_current_draft_match_then_related_history',
-                                'candidate_sort' => 'score_desc_then_existing_term_order',
-                        ),
-                        'selection_policy'          => array(
-                                'prefer_existing_terms'    => true,
-                                'new_terms_deferred'       => true,
-                                'no_toolbox_term_creation' => true,
-                                'accepted_write_path'      => 'core_proposal_required',
-                        ),
-                );
-        }
-
-        private function editor_taxonomy_recommendation_candidates( string $candidate_type, array $categories, array $tags, array $proposed_new_terms ): array {
-                $items  = 'category_suggestions' === $candidate_type ? array_slice( $categories, 0, 5 ) : array_slice( $tags, 0, 8 );
-                $result = array();
-                foreach ( $items as $index => $item ) {
-                        $taxonomy = sanitize_key( (string) ( $item['taxonomy'] ?? '' ) );
-                        $term_id  = absint( $item['term_id'] ?? 0 );
-                        $name     = sanitize_text_field( (string) ( $item['name'] ?? '' ) );
-                        if ( '' === $name || 0 >= $term_id ) {
-                                continue;
-                        }
-                        $quality  = $this->editor_taxonomy_candidate_quality( $item );
-                        $result[] = $this->editor_recommendation_candidate(
-                                array(
-                                        'id'             => ( 'category' === $taxonomy ? 'category_' : 'tag_' ) . $term_id,
-                                        'kind'           => 'category' === $taxonomy ? 'category' : 'tag',
-                                        'label'          => 'category' === $taxonomy ? __( 'Existing category', 'npcink-workflow-toolbox' ) : __( 'Existing tag', 'npcink-workflow-toolbox' ),
-                                        'value'          => $name,
-                                        'reason'         => sanitize_text_field( (string) ( $item['reason'] ?? '' ) ),
-                                        'confidence'     => $quality['confidence'],
-                                        'target_field'   => 'category' === $taxonomy ? 'category' : 'post_tag',
-                                        'action_policy'  => 'core_proposal_required',
-                                        'quality_status' => $quality['status'],
-                                        'quality_score'  => $quality['score'],
-                                        'quality_issues' => $quality['issues'],
-                                        'evidence_refs'  => is_array( $item['evidence_refs'] ?? null ) ? $item['evidence_refs'] : array(),
-                                )
-                        );
-                }
-
-                return $result;
-        }
-
-        private function editor_taxonomy_candidate_quality( array $item ): array {
-                $score           = is_numeric( $item['score'] ?? null ) ? (float) $item['score'] : 0.0;
-                $match_signals   = is_array( $item['match_signals'] ?? null ) ? $item['match_signals'] : array();
-                $related_context = is_array( $item['related_context'] ?? null ) ? $item['related_context'] : array();
-                $quality_score   = max( 0, min( 100, 45 + (int) round( $score * 10 ) ) );
-                $quality_issues  = array();
-                if ( in_array( 'current_draft_match', $match_signals, true ) ) {
-                        $quality_issues[] = __( '匹配当前草稿中的标题、摘要或正文词。', 'npcink-workflow-toolbox' );
-                }
-                if ( in_array( 'title_term_name_match', $match_signals, true ) ) {
-                        $quality_issues[] = __( '词条名称在标题中完整出现，优先级更高。', 'npcink-workflow-toolbox' );
-                }
-                if ( in_array( 'slug_alias_match', $match_signals, true ) ) {
-                        $quality_issues[] = __( '词条 slug 或别名与当前编辑上下文匹配。', 'npcink-workflow-toolbox' );
-                }
-                if ( in_array( 'related_site_knowledge_term', $match_signals, true ) ) {
-                        $quality_issues[] = __( '历史相关文章使用过该词汇，可作为站内词库证据。', 'npcink-workflow-toolbox' );
-                }
-                if ( in_array( 'description_only_match', $match_signals, true ) ) {
-                        $quality_score   -= 20;
-                        $quality_issues[] = __( '仅描述字段匹配，避免把弱说明文字当作强分类依据。', 'npcink-workflow-toolbox' );
-                }
-                if ( in_array( 'low_specificity_match', $match_signals, true ) ) {
-                        $quality_score   -= 15;
-                        $quality_issues[] = __( '只有一个较弱 token 匹配，需人工确认是否为标题党或泛化词。', 'npcink-workflow-toolbox' );
-                }
-                if ( empty( $quality_issues ) ) {
-                        $quality_issues[] = __( '仅作为现有 WordPress 词条候选，采用人工审查。', 'npcink-workflow-toolbox' );
-                }
-                if ( 0 === absint( $related_context['source_count'] ?? 0 ) && ! in_array( 'current_draft_match', $match_signals, true ) ) {
-                        $quality_score   -= 15;
-                        $quality_issues[] = __( '缺少当前草稿或历史文章的强匹配证据。', 'npcink-workflow-toolbox' );
-                }
-
-                $status = 'good';
-                if ( $quality_score < 70 ) {
-                        $status = 'review';
-                }
-                if ( $quality_score < 55 ) {
-                        $status = 'weak';
-                }
-
-                return array(
-                        'score'      => max( 0, min( 100, $quality_score ) ),
-                        'status'     => $status,
-                        'confidence' => max( 0.0, min( 1.0, $score / 5 ) ),
-                        'issues'     => array_values( array_unique( $quality_issues ) ),
-                );
-        }
-
         private function editor_related_post_terms_for_context( int $post_id ): array {
                 if ( 0 >= $post_id || ! function_exists( 'get_the_terms' ) ) {
@@ -4505 +3807 @@
         private function editor_related_content_term_evidence( array $related_content ): array {
                 $evidence = array();
-                foreach ( array_slice( $this->editor_related_content_items( $related_content ), 0, 20 ) as $index => $item ) {
+                foreach ( array_slice( Rest_Editor_Flow_Cache::editor_related_content_items( $related_content ), 0, 20 ) as $index => $item ) {
                         $post_id = absint( $item['post_id'] ?? 0 );
                         if ( 0 >= $post_id ) {
@@ -4947 +4249 @@
                 $review_set_result                                        = $this->editor_toolkit_taxonomy_review_set( $input );
                 if ( is_wp_error( $review_set_result ) ) {
-                        $taxonomy_terms['taxonomy_tag_review_set'] = $this->editor_taxonomy_review_set_from_suggestions( $taxonomy_terms, $review_set_result );
+                        $taxonomy_terms['taxonomy_tag_review_set'] = Rest_Editor_Taxonomy_Shaping::editor_taxonomy_review_set_from_suggestions( $taxonomy_terms, $review_set_result );
                 } else {
                         $review_set_data                           = is_array( $review_set_result['data'] ?? null ) ? $review_set_result['data'] : $review_set_result;
                         $taxonomy_terms['taxonomy_tag_review_set'] = is_array( $review_set_data ) && 'taxonomy_tag_review_set' === (string) ( $review_set_data['artifact_type'] ?? '' )
                                 ? $review_set_data
-                                : $this->editor_taxonomy_review_set_from_suggestions(
+                                : Rest_Editor_Taxonomy_Shaping::editor_taxonomy_review_set_from_suggestions(
                                         $taxonomy_terms,
                                         new WP_Error(
@@ -5035 +4337 @@
 
                 return $result;
-        }
-
-        private function editor_taxonomy_review_set_from_suggestions( array $taxonomy_terms, WP_Error $fallback_reason ): array {
-                $items            = is_array( $taxonomy_terms['items'] ?? null ) ? array_values( array_filter( $taxonomy_terms['items'], 'is_array' ) ) : array();
-                $review_set_limit = 8;
-                $selected         = array();
-                $blocked          = array();
-
-                foreach ( $items as $item ) {
-                        $quality = $this->editor_taxonomy_candidate_quality( $item );
-                        $row     = array(
-                                'candidate_id'               => ( 'category' === (string) ( $item['taxonomy'] ?? '' ) ? 'category_' : 'tag_' ) . absint( $item['term_id'] ?? 0 ),
-                                'candidate_contract'         => 'taxonomy_tag_review_candidate.v1',
-                                'taxonomy'                   => sanitize_key( (string) ( $item['taxonomy'] ?? '' ) ),
-                                'term_id'                    => absint( $item['term_id'] ?? 0 ),
-                                'name'                       => sanitize_text_field( (string) ( $item['name'] ?? '' ) ),
-                                'slug'                       => sanitize_title( (string) ( $item['slug'] ?? '' ) ),
-                                'score'                      => is_numeric( $item['score'] ?? null ) ? (float) $item['score'] : 0.0,
-                                'quality'                    => $quality,
-                                'reason'                     => sanitize_text_field( (string) ( $item['reason'] ?? '' ) ),
-                                'evidence_refs'              => is_array( $item['evidence_refs'] ?? null ) ? array_values( array_map( 'sanitize_text_field', $item['evidence_refs'] ) ) : array(),
-                                'proposed_action'            => 'append_existing_term',
-                                'needs_operator_review'      => true,
-                                'direct_wordpress_write'     => false,
-                                'term_creation_allowed'      => false,
-                                'term_assignment_authorized' => false,
-                        );
-                        if ( '' === $row['name'] || 0 >= $row['term_id'] ) {
-                                $row['blocked_reason'] = 'invalid_existing_term_candidate';
-                                $blocked[]             = $row;
-                                continue;
-                        }
-                        if ( 'weak' === (string) $quality['status'] ) {
-                                $row['blocked_reason'] = 'weak_taxonomy_evidence';
-                                $blocked[]             = $row;
-                                continue;
-                        }
-                        if ( count( $selected ) >= $review_set_limit ) {
-                                $row['blocked_reason'] = 'review_set_limit_reached';
-                                $blocked[]             = $row;
-                                continue;
-                        }
-                        $row['review_status'] = 'good' === (string) $quality['status'] ? 'ready_for_review' : 'review_recommended';
-                        $selected[]           = $row;
-                }
-
-                return array(
-                        'contract_version'            => 'taxonomy_tag_review_set.v1',
-                        'artifact_type'               => 'taxonomy_tag_review_set',
-                        'mode'                        => 'governed_review_set',
-                        'write_posture'               => 'suggestion_only',
-                        'final_write_path'            => 'core_proposal_required',
-                        'direct_wordpress_write'      => false,
-                        'proposal_created'            => false,
-                        'execution_created'           => false,
-                        'commit_execution'            => false,
-                        'source_ability_id'           => 'npcink-abilities-toolkit/suggest-post-taxonomy-terms',
-                        'preferred_source_ability_id' => 'npcink-abilities-toolkit/build-taxonomy-tag-review-set',
-                        'runtime_owner'               => 'npcink-workflow-toolbox',
-                        'fallback_reason'             => sanitize_key( $fallback_reason->get_error_code() ),
-                        'fallback_message'            => sanitize_text_field( $fallback_reason->get_error_message() ),
-                        'review_set_limit'            => $review_set_limit,
-                        'eligibility_summary'         => array(
-                                'scanned'  => count( $items ),
-                                'selected' => count( $selected ),
-                                'blocked'  => count( $blocked ),
-                        ),
-                        'selected_items'              => $selected,
-                        'blocked_items'               => $blocked,
-                        'safety'                      => array(
-                                'term_creation_allowed'    => false,
-                                'term_assignment_allowed'  => false,
-                                'proposal_created'         => false,
-                                'direct_wordpress_write'   => false,
-                                'provider_runtime_used'    => false,
-                                'cloud_runtime_dependency' => false,
-                        ),
-                        'handoff'                     => array(
-                                'accepted_selection_target' => 'npcink-abilities-toolkit/build-content-metadata-apply-plan',
-                                'term_assignment_target'    => 'npcink-abilities-toolkit/set-post-terms',
-                                'final_write_path'          => 'core_proposal_required',
-                                'operator_review_required'  => true,
-                        ),
-                );
         }
 
@@ -5198 +4416 @@
                         'occurrence_index' => absint( $item['occurrence_index'] ?? 0 ),
                         'context_heading'  => sanitize_text_field( (string) ( $item['context_heading'] ?? '' ) ),
-                        'context_before'   => sanitize_textarea_field( $this->editor_trim_chars( (string) ( $item['context_before'] ?? '' ), 240 ) ),
-                        'context_after'    => sanitize_textarea_field( $this->editor_trim_chars( (string) ( $item['context_after'] ?? '' ), 240 ) ),
-                        'context_caption'  => sanitize_textarea_field( $this->editor_trim_chars( (string) ( $item['context_caption'] ?? '' ), 220 ) ),
-                        'context_summary'  => sanitize_textarea_field( $this->editor_trim_chars( (string) ( $item['context_summary'] ?? '' ), 360 ) ),
+                        'context_before'   => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( (string) ( $item['context_before'] ?? '' ), 240 ) ),
+                        'context_after'    => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( (string) ( $item['context_after'] ?? '' ), 240 ) ),
+                        'context_caption'  => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( (string) ( $item['context_caption'] ?? '' ), 220 ) ),
+                        'context_summary'  => sanitize_textarea_field( Rest_Editor_Audio_Text::trim( (string) ( $item['context_summary'] ?? '' ), 360 ) ),
                         'decorative'       => ! empty( $item['decorative'] ),
                         'target_scope'     => 'post_block_alt',

npcink-workflow-toolbox/trunk/includes/Settings.php

@@ -11 +11 @@
 
 final class Settings {
+
+        public const REVIEW_TALLY_SETS = array(
+                'media_alt'          => 'media_alt_caption_review_set.v1',
+                'taxonomy_tag'       => 'taxonomy_tag_review_set.v1',
+                'internal_link'      => 'internal_link_review_set.v1',
+                'comment_moderation' => 'comment_moderation_review_set.v1',
+                'flagged_media'      => 'flagged_media_review_set.v1',
+        );
         public function register(): void {
                 register_setting(
@@ -895 +903 @@
                 return '' !== trim( (string) $value );
         }
+
+        /**
+         * Review-set adoption tally: the operator's own accept/ignore counts per
+         * review set, feeding the batch-apply decision gate. Counts and bounded
+         * timestamps only - no suggestion content, no Cloud data, no WordPress
+         * content writes.
+         */
+        public function get_review_tally(): array {
+                $value = get_option( Plugin::REVIEW_TALLY_OPTION_NAME, array() );
+                return is_array( $value ) ? $value : array();
+        }
+
+        public function record_review_tally_mark( string $review_set, string $decision ): array {
+                if ( ! array_key_exists( $review_set, self::REVIEW_TALLY_SETS ) ) {
+                        return array();
+                }
+                if ( ! in_array( $decision, array( 'accepted', 'ignored' ), true ) ) {
+                        return array();
+                }
+                $tally   = $this->get_review_tally();
+                $marks   = is_array( $tally['marks'] ?? null ) ? $tally['marks'] : array();
+                $marks[] = array(
+                        'set'       => $review_set,
+                        'decision'  => $decision,
+                        'timestamp' => time(),
+                );
+                // Bounded log: 2000 marks covers months of single-operator use; a
+                // 7-day window reaching the cap means 250+ marks/day - far past the
+                // batch-apply gate threshold, where undercounting is immaterial.
+                //
+                // Accepted residual (recorded 2026-10-08, raised four advisory
+                // rounds): the get_option -> append -> update_option sequence has
+                // no cross-request mutual exclusion, so two truly concurrent marks
+                // can lose one count. The WordPress options API offers no compare-
+                // and-swap; single-operator admin usage makes the window negligible
+                // and the tally is advisory decision data, not accounting truth.
+                $tally['marks'] = array_slice( $marks, -2000 );
+                update_option( Plugin::REVIEW_TALLY_OPTION_NAME, $tally, false );
+                return $tally;
+        }
+
+        public function review_tally_summary( int $days = 7 ): array {
+                $tally   = $this->get_review_tally();
+                $marks   = is_array( $tally['marks'] ?? null ) ? $tally['marks'] : array();
+                $cutoff  = time() - ( $days * DAY_IN_SECONDS );
+                $summary = array(
+                        'window_days' => $days,
+                        'total'       => array(
+                                'accepted' => 0,
+                                'ignored'  => 0,
+                        ),
+                        'sets'        => array(),
+                );
+                foreach ( array_keys( self::REVIEW_TALLY_SETS ) as $set_key ) {
+                        $summary['sets'][ $set_key ] = array(
+                                'accepted' => 0,
+                                'ignored'  => 0,
+                        );
+                }
+                foreach ( $marks as $mark ) {
+                        if ( ! is_array( $mark ) || (int) ( $mark['timestamp'] ?? 0 ) < $cutoff ) {
+                                continue;
+                        }
+                        $set      = sanitize_key( (string) ( $mark['set'] ?? '' ) );
+                        $decision = sanitize_key( (string) ( $mark['decision'] ?? '' ) );
+                        if ( ! isset( $summary['sets'][ $set ] ) || ! in_array( $decision, array( 'accepted', 'ignored' ), true ) ) {
+                                continue;
+                        }
+                        ++$summary['sets'][ $set ][ $decision ];
+                        ++$summary['total'][ $decision ];
+                }
+                return $summary;
+        }
 }

npcink-workflow-toolbox/trunk/languages/npcink-workflow-toolbox-zh_CN-npcink-toolbox-admin.json

@@ -909 +909 @@
       "Check that Npcink Cloud is connected, then start the optimization again. Already completed images in this batch are kept.": ["请确认 Npcink Cloud 已连接，然后重新开始优化。本批次中已完成的图片会保留。"],
       "Review the failed rows, then choose Retry failed previews again or deselect those rows. Successful previews remain unchanged.": ["请检查失败的行，然后选择再次重试失败预览或取消选中这些行。成功的预览保持不变。"],
-      "Keep the current selection, resolve the reported issue, then use the same preview action again. Toolbox will not retry automatically.": ["请保持当前选择，解决报告的问题后重新执行同一预览操作。Toolbox 不会自动重试。"]
+      "Keep the current selection, resolve the reported issue, then use the same preview action again. Toolbox will not retry automatically.": ["请保持当前选择，解决报告的问题后重新执行同一预览操作。Toolbox 不会自动重试。"],
+      "Accept +1": ["接受 +1"],
+      "Ignore +1": ["忽略 +1"],
+      "Last 7 days": ["近 7 天"],
+      "accepted": ["已接受"],
+      "ignored": ["已忽略"],
+      "Local counts only. No content is written.": ["仅本地计数，不写入任何内容。"],
+      "Could not save the tally mark. Try again.": ["无法保存计数标记，请重试。"],
+      "Counts unavailable. Try reloading.": ["计数不可用，请刷新重试。"],
+      "Last %d days": ["近 %d 天"]
     }
   }

npcink-workflow-toolbox/trunk/npcink-workflow-toolbox.php

@@ -3 +3 @@
  * Plugin Name: Npcink Workflow Toolbox
  * Description: Fixed AI workflow buttons for WordPress operators, with review-only suggestions and governed handoff plans.
- * Version: 0.5.2
+ * Version: 0.5.3
  * Requires at least: 6.9
  * Requires PHP: 8.0
@@ -63 +63 @@
 require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Surface_Bridges.php';
 require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Local_Admin_Consent.php';
+require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Editor_Flow_Cache.php';
+require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Editor_Paragraph_Check.php';
+require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Editor_Audio_Text.php';
+require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Editor_Taxonomy_Shaping.php';
 require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Editor_Content_Support.php';
 require_once NPCINK_TOOLBOX_DIR . 'includes/Rest_Controller.php';

npcink-workflow-toolbox/trunk/readme.txt

@@ -5 +5 @@
 Requires PHP: 8.0
 Tested up to: 7.1
-Stable tag: 0.5.2
+Stable tag: 0.5.3
 License: GPLv2 or later
 License URI: https://www.gnu.org/licenses/gpl-2.0.html
@@ -230 +230 @@
 == Changelog ==
 
+= 0.5.3 =
+
+* Added the review-set adoption tally: every review-set result panel
+  carries local Accept/Ignore +1 buttons with a Last-7-days line, so the
+  batch-apply decision data builds itself during normal use (Toolbox
+  settings counts only; no suggestion content is stored).
+* Hardened editor plain-text extraction to the inert DOMParser path
+  (inline handlers and resource fetches in block HTML can no longer
+  execute during text extraction).
+* Guarded the advisory review workflow against missing LLM configuration
+  and fixed the form that briefly stopped all review rounds.
+* Restructured the editor content-support service into five cohesive
+  units behind one facade (paragraph check, audio text, flow cache,
+  taxonomy shaping) with unchanged behavior.
+
 = 0.5.2 =
 

npcink-workflow-toolbox/trunk/uninstall.php

@@ -16 +16 @@
                         'npcink_toolbox_media_optimization_settings',
                         'npcink_toolbox_watermark_templates',
+                        'npcink_toolbox_review_tally',
                         'npcink_toolbox_zhihu_hot_topic_pool_backup_v1',
                         'npcink_toolbox_media_optimization_batches',