mirror of
https://github.com/langgenius/dify-docs.git
synced 2026-03-26 13:18:34 +07:00
809fc7f5eb
* feat: init translation prompts from Dify workflow Add translation prompt templates used by Dify workflow: - 1.md: New document translation - 2.md: Update existing translation - 3.md: Update with diff/checklist 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: add URL localization rule to prompt 1, fix lang codes in prompt 3 - prompt 1.md: Add Rule 3 URL Localization (was missing, causing /en/ URLs to not be mapped) - prompt 3.md: Fix language code comments (cn/jp → zh/ja to match actual folder structure) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * docs: add README for translation prompts Document prompt file mapping to Dify workflow nodes and testing workflow. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * refactor: move prompts to tools/translate/, add testing docs - Move prompt templates to tools/translate/prompt/ (closer to translation code) - Add prompt testing workflow to translate-test-dify/README.md - Document prompt-to-workflow mapping and URL localization rule 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> --------- Co-authored-by: Claude <noreply@anthropic.com>
Translation Testing Framework
A/B testing for Dify translation workflows. Primary user: Claude Code.
Important
- DO NOT commit test results -
results/is gitignored - DO NOT commit real API keys - always redact with
app-***before committing - DO NOT commit mock_docs/ - temporary files copied for testing
Quick Start
# Setup (first time)
./setup.sh
source venv/bin/activate
# Run test
python run_test.py <spec.md>
# Compare results
python compare.py results/<folder>/
Test Spec Format
# Test Title
## keys
app-xxx
Description A
app-yyy
Description B
## test_content
(Inline content - Claude Code generates this for each test)
# OR reference existing file:
## test_file
en/guides/workflow/some-doc.md
Workflow
- User describes test scenario
- Claude Code creates spec with
## test_contenttailored to the issue - Run:
source venv/bin/activate && python run_test.py spec.md - Analyze:
python compare.py results/<folder>/ - Redact API keys with
app-***before committing
Example: Punctuation Test
# Punctuation Test
## keys
app-***
Sonnet
app-***
Opus
## test_content
---
title: Test Doc
---
# Test
Sentence with commas, colons: semicolons; and more.
- Item one, comma
- Item two; semicolon
See example-model-comparison.md for a complete example.
Files
| File | Purpose |
|---|---|
| run_test.py | Test runner |
| compare.py | Generate comparison reports |
| example-model-comparison.md | Example test spec |
| results/ | Output (gitignored) |
| mock_docs/ | Temp test files (gitignored) |
Testing Prompt Changes
Prompts are stored in ../translate/prompt/ (1.md, 2.md, 3.md).
Prompt-to-Workflow Mapping
| File | Dify Workflow Node | Trigger |
|---|---|---|
1.md |
Template (1) | New doc (the_doc only) |
2.md |
Template (2) | Update (the_doc + the_doc_exist) |
3.md |
Template (3) | Update + diff (all three params) |
Test All Scenarios
# Scenario 1: New document
cat > test.md << 'EOF'
# Test
## keys
app-YOUR_KEY
test
## target_languages
zh
## test_file
en/use-dify/getting-started/introduction.mdx
EOF
python run_test.py test.md
# Scenario 2: Add existing_file section
# Scenario 3: Add diff_content section
# Verify URL mapping
grep -o 'href="[^"]*"' results/*/variant_A/*.md | head -10
Key Rule: URL Localization
All prompts must map internal links:
/en/→/zh/or/ja/plugin-dev-en/→plugin-dev-zh/orplugin-dev-ja/
API Parameters
curl -H "Authorization: Bearer $KEY" https://api.dify.ai/v1/parameters
Required: original_language, output_language1, the_doc, termbase
Optional: the_doc_exist (→ prompt 2), diff_original (→ prompt 3)
Language Policy
All code and documentation in English (international project).