diff --git a/.github/workflows/main-promotion-gate.yml b/.github/workflows/main-promotion-gate.yml index c607a11e8..6451fbfc1 100644 --- a/.github/workflows/main-promotion-gate.yml +++ b/.github/workflows/main-promotion-gate.yml @@ -29,27 +29,30 @@ jobs: pr_author_lc="$(echo "${PR_AUTHOR}" | tr '[:upper:]' '[:lower:]')" allowed_authors=("willsarg" "theonlyhennygod") - is_allowed_author=false - for allowed in "${allowed_authors[@]}"; do - if [[ "$pr_author_lc" == "$allowed" ]]; then - is_allowed_author=true - break - fi - done - - if [[ "$is_allowed_author" != "true" ]]; then - echo "::error::PRs into main are restricted to: willsarg, theonlyhennygod. PR author: ${PR_AUTHOR}. Open this PR against dev instead." - exit 1 - fi - if [[ "$HEAD_REPO" != "$BASE_REPO" ]]; then - echo "::error::PRs into main must originate from ${BASE_REPO}:dev. Current head repo: ${HEAD_REPO}." + echo "::error::PRs into main must originate from ${BASE_REPO}:dev or ${BASE_REPO}:release/*. Current head repo: ${HEAD_REPO}." exit 1 fi - if [[ "$HEAD_REF" != "dev" ]]; then - echo "::error::PRs into main must use head branch 'dev'. Current head branch: ${HEAD_REF}." + if [[ "$HEAD_REF" != "dev" && ! "$HEAD_REF" =~ ^release/ ]]; then + echo "::error::PRs into main must use head branch 'dev' or 'release/*'. Current head branch: ${HEAD_REF}." exit 1 fi + # Keep strict author allowlist for dev -> main, but allow release/* promotion from same repo. + if [[ "$HEAD_REF" == "dev" ]]; then + is_allowed_author=false + for allowed in "${allowed_authors[@]}"; do + if [[ "$pr_author_lc" == "$allowed" ]]; then + is_allowed_author=true + break + fi + done + + if [[ "$is_allowed_author" != "true" ]]; then + echo "::error::dev -> main PRs are restricted to: willsarg, theonlyhennygod. PR author: ${PR_AUTHOR}." + exit 1 + fi + fi + echo "Promotion policy satisfied: author=${PR_AUTHOR}, source=${HEAD_REPO}:${HEAD_REF} -> main" diff --git a/.github/workflows/pub-release.yml b/.github/workflows/pub-release.yml index ee01f8bb4..4f9257d50 100644 --- a/.github/workflows/pub-release.yml +++ b/.github/workflows/pub-release.yml @@ -252,6 +252,69 @@ jobs: echo "CARGO_TARGET_AARCH64_LINUX_ANDROID_LINKER=${TOOLCHAIN}/aarch64-linux-android${{ matrix.android_api }}-clang" >> "$GITHUB_ENV" fi + - name: Setup Android NDK + if: matrix.android_ndk + shell: bash + run: | + set -euo pipefail + NDK_VERSION="r26d" + NDK_ZIP="android-ndk-${NDK_VERSION}-linux.zip" + NDK_URL="https://dl.google.com/android/repository/${NDK_ZIP}" + NDK_ROOT="${RUNNER_TEMP}/android-ndk" + NDK_HOME="${NDK_ROOT}/android-ndk-${NDK_VERSION}" + + sudo apt-get update -qq + sudo apt-get install -y unzip + + mkdir -p "${NDK_ROOT}" + curl -fsSL "${NDK_URL}" -o "${RUNNER_TEMP}/${NDK_ZIP}" + unzip -q "${RUNNER_TEMP}/${NDK_ZIP}" -d "${NDK_ROOT}" + + echo "ANDROID_NDK_HOME=${NDK_HOME}" >> "$GITHUB_ENV" + echo "${NDK_HOME}/toolchains/llvm/prebuilt/linux-x86_64/bin" >> "$GITHUB_PATH" + + - name: Configure Android toolchain + if: matrix.android_ndk + shell: bash + run: | + echo "Setting up Android NDK toolchain for ${{ matrix.target }}" + NDK_HOME="${ANDROID_NDK_HOME:-}" + if [[ -z "$NDK_HOME" ]]; then + echo "::error::ANDROID_NDK_HOME was not configured." + exit 1 + fi + TOOLCHAIN="$NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin" + + # Add to path for linker resolution + echo "$TOOLCHAIN" >> "$GITHUB_PATH" + + # Set linker environment variables + if [[ "${{ matrix.target }}" == "armv7-linux-androideabi" ]]; then + ARMV7_CC="${TOOLCHAIN}/armv7a-linux-androideabi${{ matrix.android_api }}-clang" + ARMV7_CXX="${TOOLCHAIN}/armv7a-linux-androideabi${{ matrix.android_api }}-clang++" + + # Some crates still probe legacy compiler names (arm-linux-androideabi-clang). + ln -sf "$ARMV7_CC" "${TOOLCHAIN}/arm-linux-androideabi-clang" + ln -sf "$ARMV7_CXX" "${TOOLCHAIN}/arm-linux-androideabi-clang++" + + { + echo "CARGO_TARGET_ARMV7_LINUX_ANDROIDEABI_LINKER=${ARMV7_CC}" + echo "CC_armv7_linux_androideabi=${ARMV7_CC}" + echo "CXX_armv7_linux_androideabi=${ARMV7_CXX}" + echo "AR_armv7_linux_androideabi=${TOOLCHAIN}/llvm-ar" + } >> "$GITHUB_ENV" + elif [[ "${{ matrix.target }}" == "aarch64-linux-android" ]]; then + AARCH64_CC="${TOOLCHAIN}/aarch64-linux-android${{ matrix.android_api }}-clang" + AARCH64_CXX="${TOOLCHAIN}/aarch64-linux-android${{ matrix.android_api }}-clang++" + + { + echo "CARGO_TARGET_AARCH64_LINUX_ANDROID_LINKER=${AARCH64_CC}" + echo "CC_aarch64_linux_android=${AARCH64_CC}" + echo "CXX_aarch64_linux_android=${AARCH64_CXX}" + echo "AR_aarch64_linux_android=${TOOLCHAIN}/llvm-ar" + } >> "$GITHUB_ENV" + fi + - name: Build release shell: bash env: diff --git a/AGENTS.md b/AGENTS.md index 2d7566c27..711ee8d85 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -153,13 +153,14 @@ Treat documentation as a first-class product surface, not a post-merge artifact. Canonical entry points: -- root READMEs: `README.md`, `README.zh-CN.md`, `README.ja.md`, `README.ru.md`, `README.fr.md`, `README.vi.md` -- docs hubs: `docs/README.md`, `docs/README.zh-CN.md`, `docs/README.ja.md`, `docs/README.ru.md`, `docs/README.fr.md`, `docs/i18n/vi/README.md` +- root READMEs: `README.md`, `README.zh-CN.md`, `README.ja.md`, `README.ru.md`, `README.fr.md`, `README.vi.md`, `README.el.md` +- docs hubs: `docs/README.md`, `docs/i18n/zh-CN/README.md`, `docs/i18n/ja/README.md`, `docs/i18n/ru/README.md`, `docs/i18n/fr/README.md`, `docs/i18n/vi/README.md`, `docs/i18n/el/README.md` - unified TOC: `docs/SUMMARY.md` +- i18n governance docs: `docs/i18n-guide.md`, `docs/i18n/README.md`, `docs/i18n-coverage.md` Supported locales (current contract): -- `en`, `zh-CN`, `ja`, `ru`, `fr`, `vi` +- `en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`, `el` Collection indexes (category navigation): @@ -184,14 +185,25 @@ Runtime-contract references (must track behavior changes): Required docs governance rules: - Keep README/hub top navigation and quick routes intuitive and non-duplicative. -- Keep entry-point parity across all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`) when changing navigation architecture. +- Keep entry-point parity across all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`, `el`) when changing navigation architecture. - If a change touches docs IA, runtime-contract references, or user-facing wording in shared docs, perform i18n follow-through for currently supported locales in the same PR: - Update locale navigation links (`README*`, `docs/README*`, `docs/SUMMARY.md`). - - Update localized runtime-contract docs where equivalents exist (at minimum `commands-reference`, `config-reference`, `troubleshooting` for `fr` and `vi`). - - For Vietnamese, treat `docs/i18n/vi/**` as canonical. Keep `docs/*..md` compatibility shims aligned if present. + - Update canonical locale hubs and summaries under `docs/i18n//` for every supported locale. + - Update localized runtime-contract docs where equivalents exist (currently full trees for `vi` and `el`; do not regress `zh-CN`/`ja`/`ru`/`fr` hub parity). + - Keep `docs/*..md` compatibility shims aligned if present. +- Follow `docs/i18n-guide.md` as the mandatory completion checklist when docs navigation or shared wording changes. - Keep proposal/roadmap docs explicitly labeled; avoid mixing proposal text into runtime-contract docs. - Keep project snapshots date-stamped and immutable once superseded by a newer date. +### 4.2 Docs i18n Completion Gate (Required) + +For any PR that changes docs IA, locale navigation, or shared docs wording: + +1. Complete i18n follow-through in the same PR using `docs/i18n-guide.md`. +2. Keep all supported locale hubs/summaries navigable through canonical `docs/i18n//` paths. +3. Update `docs/i18n-coverage.md` when coverage status or locale topology changes. +4. If any translation must be deferred, record explicit owner + follow-up issue/PR in the PR description. + ## 5) Risk Tiers by Path (Review Depth Contract) Use these tiers when deciding validation depth and review rigor. @@ -216,7 +228,8 @@ When uncertain, classify as higher risk. 5. **Document impact** - Update docs/PR notes for behavior, risk, side effects, and rollback. - If CLI/config/provider/channel behavior changed, update corresponding runtime-contract references. - - If docs entry points changed, keep all supported locale README/docs-hub navigation aligned (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`). + - If docs entry points changed, keep all supported locale README/docs-hub navigation aligned (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`, `el`). + - Run through `docs/i18n-guide.md` and record any explicit i18n deferrals in the PR summary. 6. **Respect queue hygiene** - If stacked PR: declare `Depends on #...`. - If replacing old PR: declare `Supersedes #...`. @@ -331,8 +344,10 @@ Use these rules to keep the trait/factory architecture stable under growth. - Treat docs navigation as product UX: preserve clear pathing from README -> docs hub -> SUMMARY -> category index. - Keep top-level nav concise; avoid duplicative links across adjacent nav blocks. - When runtime surfaces change, update related references (`commands/providers/channels/config/runbook/troubleshooting`). -- Keep multilingual entry-point parity for all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`) when nav or key wording changes. +- Keep multilingual entry-point parity for all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`, `el`) when nav or key wording changes. - When shared docs wording changes, sync corresponding localized docs for supported locales in the same PR (or explicitly document deferral and follow-up PR). +- Treat `docs/i18n//**` as canonical for localized hubs/summaries; keep docs-root compatibility shims aligned when edited. +- Apply `docs/i18n-guide.md` completion checklist before merge and include i18n status in PR notes. - For docs snapshots, add new date-stamped files for new sprints rather than rewriting historical context. @@ -361,7 +376,7 @@ Additional expectations by change type: - **Docs/template-only**: - run markdown lint and link-integrity checks - - if touching README/docs-hub/SUMMARY/collection indexes, verify EN/ZH/JA/RU navigation parity + - if touching README/docs-hub/SUMMARY/collection indexes, verify EN/ZH-CN/JA/RU/FR/VI/EL navigation parity - if touching bootstrap docs/scripts, run `bash -n bootstrap.sh scripts/bootstrap.sh scripts/install.sh` - **Workflow changes**: validate YAML syntax; run workflow lint/sanity checks when available. - **Security/runtime/gateway/tools**: include at least one boundary/failure-mode validation. @@ -471,6 +486,9 @@ Reference docs: - `CONTRIBUTING.md` - `docs/README.md` - `docs/SUMMARY.md` +- `docs/i18n-guide.md` +- `docs/i18n/README.md` +- `docs/i18n-coverage.md` - `docs/docs-inventory.md` - `docs/commands-reference.md` - `docs/providers-reference.md` diff --git a/CLAUDE.md b/CLAUDE.md index cc36b388a..37c70af4e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -153,13 +153,14 @@ Treat documentation as a first-class product surface, not a post-merge artifact. Canonical entry points: -- root READMEs: `README.md`, `README.zh-CN.md`, `README.ja.md`, `README.ru.md`, `README.fr.md`, `README.vi.md` -- docs hubs: `docs/README.md`, `docs/README.zh-CN.md`, `docs/README.ja.md`, `docs/README.ru.md`, `docs/README.fr.md`, `docs/i18n/vi/README.md` +- root READMEs: `README.md`, `README.zh-CN.md`, `README.ja.md`, `README.ru.md`, `README.fr.md`, `README.vi.md`, `README.el.md` +- docs hubs: `docs/README.md`, `docs/i18n/zh-CN/README.md`, `docs/i18n/ja/README.md`, `docs/i18n/ru/README.md`, `docs/i18n/fr/README.md`, `docs/i18n/vi/README.md`, `docs/i18n/el/README.md` - unified TOC: `docs/SUMMARY.md` +- i18n governance docs: `docs/i18n-guide.md`, `docs/i18n/README.md`, `docs/i18n-coverage.md` Supported locales (current contract): -- `en`, `zh-CN`, `ja`, `ru`, `fr`, `vi` +- `en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`, `el` Collection indexes (category navigation): @@ -184,14 +185,25 @@ Runtime-contract references (must track behavior changes): Required docs governance rules: - Keep README/hub top navigation and quick routes intuitive and non-duplicative. -- Keep entry-point parity across all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`) when changing navigation architecture. +- Keep entry-point parity across all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`, `el`) when changing navigation architecture. - If a change touches docs IA, runtime-contract references, or user-facing wording in shared docs, perform i18n follow-through for currently supported locales in the same PR: - Update locale navigation links (`README*`, `docs/README*`, `docs/SUMMARY.md`). - - Update localized runtime-contract docs where equivalents exist (at minimum `commands-reference`, `config-reference`, `troubleshooting` for `fr` and `vi`). - - For Vietnamese, treat `docs/i18n/vi/**` as canonical. Keep `docs/*..md` compatibility shims aligned if present. + - Update canonical locale hubs and summaries under `docs/i18n//` for every supported locale. + - Update localized runtime-contract docs where equivalents exist (currently full trees for `vi` and `el`; do not regress `zh-CN`/`ja`/`ru`/`fr` hub parity). + - Keep `docs/*..md` compatibility shims aligned if present. +- Follow `docs/i18n-guide.md` as the mandatory completion checklist when docs navigation or shared wording changes. - Keep proposal/roadmap docs explicitly labeled; avoid mixing proposal text into runtime-contract docs. - Keep project snapshots date-stamped and immutable once superseded by a newer date. +### 4.2 Docs i18n Completion Gate (Required) + +For any PR that changes docs IA, locale navigation, or shared docs wording: + +1. Complete i18n follow-through in the same PR using `docs/i18n-guide.md`. +2. Keep all supported locale hubs/summaries navigable through canonical `docs/i18n//` paths. +3. Update `docs/i18n-coverage.md` when coverage status or locale topology changes. +4. If any translation must be deferred, record explicit owner + follow-up issue/PR in the PR description. + ## 5) Risk Tiers by Path (Review Depth Contract) Use these tiers when deciding validation depth and review rigor. @@ -216,7 +228,8 @@ When uncertain, classify as higher risk. 5. **Document impact** - Update docs/PR notes for behavior, risk, side effects, and rollback. - If CLI/config/provider/channel behavior changed, update corresponding runtime-contract references. - - If docs entry points changed, keep all supported locale README/docs-hub navigation aligned (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`). + - If docs entry points changed, keep all supported locale README/docs-hub navigation aligned (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`, `el`). + - Run through `docs/i18n-guide.md` and record any explicit i18n deferrals in the PR summary. 6. **Respect queue hygiene** - If stacked PR: declare `Depends on #...`. - If replacing old PR: declare `Supersedes #...`. @@ -227,19 +240,46 @@ All contributors (human or agent) must follow the same collaboration flow: - Create and work from a non-`main` branch. - Commit changes to that branch with clear, scoped commit messages. -- Open a PR to `main`; do not push directly to `main`. +- Open a PR to `dev`; do not push directly to `dev` or `main`. +- `main` is reserved for release promotion PRs from `dev`. - Wait for required checks and review outcomes before merging. - Merge via PR controls (squash/rebase/merge as repository policy allows). -- Branch deletion after merge is optional; long-lived branches are allowed when intentionally maintained. +- After merge/close, clean up task branches/worktrees that are no longer needed. +- Keep long-lived branches only when intentionally maintained with clear owner and purpose. -### 6.2 Worktree Workflow (Required for Multi-Track Agent Work) +### 6.1A PR Disposition and Workflow Authority (Required) -Use Git worktrees to isolate concurrent agent/human tracks safely and predictably: +- Decide merge/close outcomes from repository-local authority in this order: `.github/workflows/**`, GitHub branch protection/rulesets, `docs/pr-workflow.md`, then this `CLAUDE.md`. +- External agent skills/templates are execution aids only; they must not override repository-local policy. +- A normal contributor PR targeting `main` is a routing defect, not by itself a closure reason; if intent and content are legitimate, retarget to `dev`. +- Direct-close the PR (do not supersede/replay) when high-confidence integrity-risk signals exist: + - unapproved or unrelated repository rebranding attempts (for example replacing project logo/identity assets) + - unauthorized platform-surface expansion (for example introducing `web` apps, dashboards, frontend stacks, or UI surfaces not requested by maintainers) + - title/scope deception that hides high-risk code changes (for example `docs:` title with broad `src/**` changes) + - spam-like or intentionally harmful payload patterns + - multi-domain dirty-bundle changes with no safe, auditable isolation path +- If unauthorized platform-surface expansion is detected during review/implementation, report to maintainers immediately and pause further execution until explicit direction is given. +- Use supersede flow only when maintainers explicitly want to preserve valid work and attribution. +- In public PR close/block comments, state only direct actionable reasons; do not include internal decision-process narration or "non-reason" qualifiers. -- Use one worktree per active branch/PR stream to avoid cross-task contamination. -- Keep each worktree on a single branch; do not mix unrelated edits in one worktree. +### 6.1B Assignee-First Gate (Required) + +- For any GitHub issue or PR selected for active handling, the first action is to ensure `@chumyin` is an assignee. +- This is additive ownership: keep existing assignees and add `@chumyin` if missing. +- Do not start triage/review/implementation/merge work before assignee assignment is confirmed. +- Queue safety rule: assign only the currently active target; do not pre-assign future queued targets. + +### 6.2 Worktree Workflow (Required for All Task Streams) + +Use Git worktrees to isolate every active task stream safely and predictably: + +- Use one dedicated worktree per active branch/PR stream; do not implement directly in a shared default workspace. +- Keep each worktree on a single branch and a single concern; do not mix unrelated edits in one worktree. +- Before each commit/push, verify commit hygiene in that worktree (`git status --short` and `git diff --cached`) so only scoped files are included. - Run validation commands inside the corresponding worktree before commit/PR. -- Name worktrees clearly by scope (for example: `wt/ci-hardening`, `wt/provider-fix`) and remove stale worktrees when no longer needed. +- Name worktrees clearly by scope (for example: `wt/ci-hardening`, `wt/provider-fix`). +- After PR merge/close (or task abandonment), remove stale worktrees/branches and prune refs (`git worktree prune`, `git fetch --prune`). +- Local Codex automation may use one-command cleanup helper: `~/.codex/skills/zeroclaw-pr-issue-automation/scripts/cleanup_track.sh --repo-dir --worktree --branch `. - PR checkpoint rules from section 6.1 still apply to worktree-based development. ### 6.3 Code Naming Contract (Required) @@ -304,8 +344,10 @@ Use these rules to keep the trait/factory architecture stable under growth. - Treat docs navigation as product UX: preserve clear pathing from README -> docs hub -> SUMMARY -> category index. - Keep top-level nav concise; avoid duplicative links across adjacent nav blocks. - When runtime surfaces change, update related references (`commands/providers/channels/config/runbook/troubleshooting`). -- Keep multilingual entry-point parity for all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`) when nav or key wording changes. +- Keep multilingual entry-point parity for all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`, `el`) when nav or key wording changes. - When shared docs wording changes, sync corresponding localized docs for supported locales in the same PR (or explicitly document deferral and follow-up PR). +- Treat `docs/i18n//**` as canonical for localized hubs/summaries; keep docs-root compatibility shims aligned when edited. +- Apply `docs/i18n-guide.md` completion checklist before merge and include i18n status in PR notes. - For docs snapshots, add new date-stamped files for new sprints rather than rewriting historical context. @@ -334,7 +376,7 @@ Additional expectations by change type: - **Docs/template-only**: - run markdown lint and link-integrity checks - - if touching README/docs-hub/SUMMARY/collection indexes, verify EN/ZH/JA/RU navigation parity + - if touching README/docs-hub/SUMMARY/collection indexes, verify EN/ZH-CN/JA/RU/FR/VI/EL navigation parity - if touching bootstrap docs/scripts, run `bash -n bootstrap.sh scripts/bootstrap.sh scripts/install.sh` - **Workflow changes**: validate YAML syntax; run workflow lint/sanity checks when available. - **Security/runtime/gateway/tools**: include at least one boundary/failure-mode validation. @@ -345,6 +387,12 @@ If full checks are impractical, run the most relevant subset and document what w - Follow `.github/pull_request_template.md` fully (including side effects / blast radius). - Keep PR descriptions concrete: problem, change, non-goals, risk, rollback. +- For issue-driven work, add explicit issue-closing keywords in the **PR body** for every resolved issue (for example `Closes #1502`). +- Do not rely on issue comments alone for linkage visibility; comments are supplemental, not a substitute for PR-body closing references. +- Default to one issue per clean commit/PR track. For multiple issues, split into separate clean commits/PRs unless there is clear technical coupling. +- If multiple issues are intentionally bundled in one PR, document the coupling rationale explicitly in the PR summary. +- Commit hygiene is mandatory: stage only task-scoped files and split unrelated changes into separate commits/worktrees. +- Completion hygiene is mandatory: after merge/close, clean stale local branches/worktrees before starting the next track. - Use conventional commit titles. - Prefer small PRs (`size: XS/S/M`) when possible. - Agent-assisted PRs are welcome, **but contributors remain accountable for understanding what their code will do**. @@ -438,6 +486,9 @@ Reference docs: - `CONTRIBUTING.md` - `docs/README.md` - `docs/SUMMARY.md` +- `docs/i18n-guide.md` +- `docs/i18n/README.md` +- `docs/i18n-coverage.md` - `docs/docs-inventory.md` - `docs/commands-reference.md` - `docs/providers-reference.md` @@ -461,6 +512,8 @@ Reference docs: - Do not bypass failing checks without explicit explanation. - Do not hide behavior-changing side effects in refactor commits. - Do not include personal identity or sensitive information in test data, examples, docs, or commits. +- Do not attempt repository rebranding/identity replacement unless maintainers explicitly requested it in the current scope. +- Do not introduce new platform surfaces (for example `web` apps, dashboards, frontend stacks, or UI portals) unless maintainers explicitly requested them in the current scope. ## 11) Handoff Template (Agent -> Agent / Maintainer) diff --git a/CONTRIBUTING.el.md b/CONTRIBUTING.el.md new file mode 100644 index 000000000..c6f008ecf --- /dev/null +++ b/CONTRIBUTING.el.md @@ -0,0 +1,93 @@ +# Συνεισφορά στο ZeroClaw + +Σας ευχαριστούμε για το ενδιαφέρον σας να συνεισφέρετε στο ZeroClaw! Αυτός ο οδηγός θα σας βοηθήσει να ξεκινήσετε. + +## Συνεισφέροντες για πρώτη φορά + +Καλώς ήρθατε — οι συνεισφορές κάθε μεγέθους είναι πολύτιμες. Εάν αυτή είναι η πρώτη σας συνεισφορά, δείτε πώς μπορείτε να ξεκινήσετε: + +1. **Βρείτε ένα ζήτημα.** Αναζητήστε ζητήματα με την ετικέτα [`good first issue`](https://github.com/zeroclaw-labs/zeroclaw/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) — αυτά είναι σχεδιασμένα για νεοεισερχόμενους και περιλαμβάνουν το απαραίτητο πλαίσιο για να ξεκινήσετε γρήγορα. + +2. **Επιλέξτε ένα πεδίο.** Καλές πρώτες συνεισφορές περιλαμβάνουν: + - Διορθώσεις τυπογραφικών λαθών και τεκμηρίωσης + - Προσθήκες ή βελτιώσεις δοκιμών (tests) + - Μικρές διορθώσεις σφαλμάτων με σαφή βήματα αναπαραγωγής + +3. **Ακολουθήστε τη ροή εργασίας fork → branch → change → test → PR:** + - Κάντε fork το αποθετήριο και κλωνοποιήστε το δικό σας fork + - Δημιουργήστε έναν κλάδο δυνατοτήτων (feature branch) (`git checkout -b fix/my-change`) + - Κάντε τις αλλαγές σας και εκτελέστε `cargo fmt && cargo clippy && cargo test` + - Ανοίξτε ένα PR προς το `dev` χρησιμοποιώντας το πρότυπο PR + +4. **Ξεκινήστε με το Track A.** Το ZeroClaw χρησιμοποιεί τρία [επίπεδα συνεργασίας](#επίπεδα-συνεργασίας-βάσει-κινδύνου) (A/B/C) βάσει κινδύνου. Οι συνεισφέροντες για πρώτη φορά θα πρέπει να στοχεύουν στο **Track A** (τεκμηρίωση, δοκιμές, μικροεργασίες) — αυτά απαιτούν ελαφρύτερη αναθεώρηση και είναι η ταχύτερη διαδρομή για την ενσωμάτωση (merge) ενός PR. + +Εάν κολλήσετε, ανοίξτε ένα draft PR νωρίς και κάντε ερωτήσεις στην περιγραφή. + +## Ρύθμιση Ανάπτυξης + +```bash +# Κλωνοποιήστε το αποθετήριο +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw + +# Ενεργοποιήστε το pre-push hook (εκτελεί fmt, clippy, δοκιμές πριν από κάθε push) +git config core.hooksPath .githooks + +# Κατασκευή (Build) +cargo build + +# Εκτέλεση δοκιμών (πρέπει να περάσουν όλες) +cargo test --locked + +# Μορφοποίηση και έλεγχος (απαιτείται πριν το PR) +./scripts/ci/rust_quality_gate.sh + +# Έκδοση release +cargo build --release --locked +``` + +### Pre-push hook + +Το αποθετήριο περιλαμβάνει ένα pre-push hook στο `.githooks/` που επιβάλλει το `./scripts/ci/rust_quality_gate.sh` και το `cargo test --locked` πριν από κάθε push. Ενεργοποιήστε το με την εντολή `git config core.hooksPath .githooks`. + +## Τοπική Διαχείριση Μυστικών (Απαιτείται) + +Το ZeroClaw υποστηρίζει κλιμακωτή διαχείριση μυστικών για την τοπική ανάπτυξη και την υγιεινή του CI. + +### Επιλογές Αποθήκευσης Μυστικών + +1. **Μεταβλητές περιβάλλοντος** (συνιστάται για τοπική ανάπτυξη) + - Αντιγράψτε το `.env.example` στο `.env` και συμπληρώστε τις τιμές + - Τα αρχεία `.env` αγνοούνται από το Git και πρέπει να παραμένουν τοπικά + +2. **Αρχείο ρυθμίσεων** (`~/.zeroclaw/config.toml`) + - Μόνιμη ρύθμιση για μακροχρόνια χρήση + - Όταν `secrets.encrypt = true` (προεπιλογή), οι τιμές κρυπτογραφούνται πριν την αποθήκευση + +### Κανόνες Επίλυσης κατά την Εκτέλεση + +Η επίλυση του κλειδιού API ακολουθεί αυτή τη σειρά: + +1. Ρητό κλειδί που μεταδίδεται από το config/CLI +2. Μεταβλητές περιβάλλοντος ειδικά για τον πάροχο (`OPENROUTER_API_KEY`, `OPENAI_API_KEY`, κ.λπ.) +3. Γενικές μεταβλητές περιβάλλοντος (`ZEROCLAW_API_KEY`, `API_KEY`) + +### Υγιεινή Μυστικών Πριν το Commit (Υποχρεωτικό) + +Πριν από κάθε commit, επαληθεύστε: + +- [ ] Δεν έχουν προστεθεί αρχεία `.env` (μόνο το `.env.example` επιτρέπεται) +- [ ] Δεν υπάρχουν κλειδιά API/tokens στον κώδικα, τις δοκιμές, τα παραδείγματα ή τα μηνύματα commit +- [ ] Δεν υπάρχουν διαπιστευτήρια σε εξόδους αποσφαλμάτωσης (debug output) + +## Επίπεδα Συνεργασίας (Βάσει Κινδύνου) + +| Επίπεδο | Τυπικό πεδίο | Απαιτούμενο βάθος αναθεώρησης | +|---|---|---| +| **Track A (Χαμηλός κίνδυνος)** | τεκμηρίωση/δοκιμές, απομονωμένο refactoring | 1 αναθεώρηση από συντηρητή + επιτυχές CI | +| **Track B (Μεσαίος κίνδυνος)** | αλλαγές συμπεριφοράς παρόχων/καναλιών/μνήμης | 1 αναθεώρηση με γνώση του υποσυστήματος + τεκμηρίωση επαλήθευσης | +| **Track C (Υψηλός κίνδυνος)** | ασφάλεια, περιβάλλον εκτέλεσης, CI, όρια πρόσβασης | Αναθεώρηση 2 φάσεων + σχέδιο επαναφοράς (rollback) | + +--- + +**ZeroClaw** — Μηδενική επιβάρυνση. Κανένας συμβιβασμός. 🦀 diff --git a/Cargo.lock b/Cargo.lock index f7cfb4f44..ec7745930 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -8068,7 +8068,7 @@ dependencies = [ [[package]] name = "zeroclaw" -version = "0.1.6" +version = "0.1.7" dependencies = [ "anyhow", "async-imap", diff --git a/Cargo.toml b/Cargo.toml index dd19945c8..41848fba2 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -4,7 +4,7 @@ resolver = "2" [package] name = "zeroclaw" -version = "0.1.6" +version = "0.1.7" edition = "2021" authors = ["theonlyhennygod"] license = "MIT OR Apache-2.0" diff --git a/README.el.md b/README.el.md new file mode 100644 index 000000000..8899890a7 --- /dev/null +++ b/README.el.md @@ -0,0 +1,1164 @@ +# ZeroClaw 🦀 + +

+ ZeroClaw +

+ +

ZeroClaw 🦀

+ +

+ Μηδενική επιβάρυνση. Μηδενικός συμβιβασμός. 100% Rust. 100% Αγνωστικιστικό.
+ ⚡️ Εκτελείται σε υλικό $10 με λιγότερο από 5MB RAM: Αυτό είναι 99% λιγότερη μνήμη από το OpenClaw και 98% φθηνότερο από ένα Mac mini! +

+ +

+ Άδεια: MIT OR Apache-2.0 + Συνεισφέροντες + Αγόρασέ μου έναν καφέ + X: @zeroclawlabs + Ομάδα WeChat + Xiaohongshu: Επίσημο + Telegram: @zeroclawlabs + Telegram CN: @zeroclawlabs_cn + Telegram RU: @zeroclawlabs_ru + Reddit: r/zeroclawlabs +

+

+Δημιουργήθηκε από φοιτητές και μέλη των κοινοτήτων Harvard, MIT και Sundai.Club. +

+ +

+ 🌐 Γλώσσες: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt · Ελληνικά +

+ +

+ Έναρξη | + Εγκατάσταση με ένα κλικ | + Κέντρο τεκμηρίωσης | + Πίνακας περιεχομένων τεκμηρίωσης +

+ +

+ Γρήγορη πλοήγηση: + Αναφορά · + Λειτουργίες · + Αντιμετώπιση προβλημάτων · + Ασφάλεια · + Υλικό · + Συνεισφορά +

+ +

+ Γρήγορη, μικρή και πλήρως αυτόνομη υποδομή βοηθού τεχνητής νοημοσύνης
+ Αναπτύξτε οπουδήποτε. Αντικαταστήστε οτιδήποτε. +

+ +

+ Το ZeroClaw είναι το λειτουργικό σύστημα χρόνου εκτέλεσης για ροές εργασίας παραγόντων — υποδομή που αφαιρεί τα μοντέλα, τα εργαλεία, τη μνήμη και την εκτέλεση, ώστε οι παράγοντες να δημιουργούνται μία φορά και να εκτελούνται παντού. +

+ +

Αρχιτεκτονική βασισμένη σε χαρακτηριστικά · χρόνος εκτέλεσης ασφαλής εκ προεπιλογής · εναλλάξιμος πάροχος/κανάλι/εργαλείο · πλήρως επεκτάσιμο

+ +## 📢 Ανακοινώσεις + +Χρησιμοποιήστε αυτόν τον πίνακα για σημαντικές ειδοποιήσεις (αλλαγές που προκαλούν ασυμβατότητα, συμβουλές ασφαλείας, παράθυρα συντήρησης και αποκλεισμοί κυκλοφορίας). + +| Ημερομηνία (UTC) | Επίπεδο | Ειδοποίηση | Ενέργεια | +|---|---|---|---| +| 2026-02-19 | _Κρίσιμο_ | **Δεν είμαστε συνδεδεμένοι** με το `openagen/zeroclaw`, το `zeroclaw.org` ή το `zeroclaw.net`. Οι τομείς `zeroclaw.org` και `zeroclaw.net` παραπέμπουν αυτήν τη στιγμή στο fork `openagen/zeroclaw`, και αυτός ο τομέας/αποθετήριο υποδύεται τον επίσημο ιστότοπο/έργο μας. | Μην εμπιστεύεστε πληροφορίες, δυαδικά αρχεία, χρηματοδοτήσεις ή ανακοινώσεις από αυτές τις πηγές. Χρησιμοποιήστε μόνο [αυτό το αποθετήριο](https://github.com/zeroclaw-labs/zeroclaw) και τους επαληθευμένους λογαριασμούς κοινωνικής δικτύωσης μας. | +| 2026-02-21 | _Σημαντικό_ | Ο επίσημος ιστότοπός μας είναι πλέον σε λειτουργία: [zeroclawlabs.ai](https://zeroclawlabs.ai). Ευχαριστούμε για την υπομονή σας κατά την προετοιμασία της κυκλοφορίας. Συνεχίζουμε να παρατηρούμε απόπειρες υποδύσεων, επομένως **μην** συμμετέχετε σε καμία επενδυτική ή χρηματοδοτική δραστηριότητα που ισχυρίζεται ότι φέρει το όνομα ZeroClaw, εκτός αν δημοσιεύεται μέσω των επίσημων καναλιών μας. | Χρησιμοποιήστε [αυτό το αποθετήριο](https://github.com/zeroclaw-labs/zeroclaw) ως μοναδική πηγή αλήθειας. Ακολουθήστε τα [X (@zeroclawlabs)](https://x.com/zeroclawlabs?s=21), [Reddit (r/zeroclawlabs)](https://www.reddit.com/r/zeroclawlabs/), [Telegram (@zeroclawlabs)](https://t.me/zeroclawlabs), [Telegram CN (@zeroclawlabs_cn)](https://t.me/zeroclawlabs_cn), [Telegram RU (@zeroclawlabs_ru)](https://t.me/zeroclawlabs_ru) και [Xiaohongshu](https://www.xiaohongshu.com/user/profile/67cbfc43000000000d008307?xsec_token=AB73VnYnGNx5y36EtnnZfGmAmS-6Wzv8WMuGpfwfkg6Yc%3D&xsec_source=pc_search) για επίσημες ενημερώσεις. | +| 2026-02-19 | _Σημαντικό_ | Η Anthropic ενημέρωσε τους όρους Χρήσης Ελέγχου Ταυτότητας και Διαπιστευτηρίων στις 2026-02-19. Ο έλεγχος ταυτότητας OAuth (Free, Pro, Max) προορίζεται αποκλειστικά για το Claude Code και το Claude.ai· η χρήση διακριτικών OAuth από τα Claude Free/Pro/Max σε οποιοδήποτε άλλο προϊόν, εργαλείο ή υπηρεσία (συμπεριλαμβανομένου του Agent SDK) δεν επιτρέπεται και ενδέχεται να παραβιάζει τους Όρους Υπηρεσίας Καταναλωτή. | Αποφύγετε προσωρινά τις ενσωματώσεις OAuth του Claude Code για να αποτρέψετε πιθανές απώλειες. Αρχική ρήτρα: [Χρήση Ελέγχου Ταυτότητας και Διαπιστευτηρίων](https://code.claude.com/docs/en/legal-and-compliance#authentication-and-credential-use). | + +### ✨ Δυνατότητες + +- 🏎️ **Αδύνατο χρόνο εκτέλεσης εκ προεπιλογής:** Οι κοινές ροές εργασίας CLI και κατάστασης εκτελούνται σε περιβάλλον μνήμης λίγων megabyte σε εκδόσεις παραγωγής. +- 💰 **Οικονομικά αποδοτική ανάπτυξη:** Σχεδιασμένο για πλακέτες χαμηλού κόστους και μικρές παρουσίες cloud χωρίς βαριές εξαρτήσεις χρόνου εκτέλεσης. +- ⚡ **Γρήγορες εκκινήσεις από κατάσταση ηρεμίας:** Ο χρόνος εκτέλεσης Rust μονού δυαδικού αρχείου διατηρεί την εκκίνηση εντολών και δαίμονα σχεδόν άμεση για καθημερινές λειτουργίες. +- 🌍 **Φορητή αρχιτεκτονική:** Μία ροή εργασίας με προτεραιότητα στο δυαδικό αρχείο σε ARM, x86 και RISC-V με εναλλάξιμους παρόχους/κανάλια/εργαλεία. + +### Γιατί οι ομάδες επιλέγουν το ZeroClaw + +- **Αδύνατο εκ προεπιλογής:** μικρό δυαδικό αρχείο Rust, γρήγορη εκκίνηση, μικρό αποτύπωμα μνήμης. +- **Ασφαλές εκ σχεδιασμού:** σύζευξη, αυστηρή απομόνωση, ρητές λίστες επιτρεπόμενων, εμβέλεια χώρου εργασίας. +- **Πλήρως εναλλάξιμο:** τα βασικά συστήματα είναι χαρακτηριστικά (πάροχοι, κανάλια, εργαλεία, μνήμη, σήραγγες). +- **Χωρίς δέσμευση:** υποστήριξη παρόχου συμβατού με OpenAI + επεκτάσιμα προσαρμοσμένα τελικά σημεία. + +## Στιγμιότυπο αποτελεσμάτων αξιολόγησης (ZeroClaw έναντι OpenClaw, αναπαραγώγιμο) + +Γρήγορη αξιολόγηση σε τοπικό μηχάνημα (macOS arm64, Φεβ. 2026) κανονικοποιημένη για υλικό ακμής 0,8GHz. + +| | OpenClaw | NanoBot | PicoClaw | ZeroClaw 🦀 | +|---|---|---|---|---| +| **Γλώσσα** | TypeScript | Python | Go | **Rust** | +| **RAM** | > 1GB | > 100MB | < 10MB | **< 5MB** | +| **Εκκίνηση (πυρήνας 0,8GHz)** | > 500s | > 30s | < 1s | **< 10ms** | +| **Μέγεθος δυαδικού αρχείου** | ~28MB (dist) | Δ/Ε (Scripts) | ~8MB | **~8,8 MB** | +| **Κόστος** | Mac Mini $599 | Linux SBC ~$50 | Linux Board $10 | **Οποιοδήποτε υλικό $10** | + +> Σημειώσεις: Τα αποτελέσματα του ZeroClaw μετρώνται σε εκδόσεις παραγωγής χρησιμοποιώντας `/usr/bin/time -l`. Το OpenClaw απαιτεί χρόνο εκτέλεσης Node.js (συνήθως ~390MB επιπλέον επιβάρυνση μνήμης), ενώ το NanoBot απαιτεί χρόνο εκτέλεσης Python. Τα PicoClaw και ZeroClaw είναι στατικά δυαδικά αρχεία. Τα παραπάνω νούμερα RAM αφορούν τη μνήμη κατά τον χρόνο εκτέλεσης· οι απαιτήσεις μνήμης κατά τη μεταγλώττιση είναι υψηλότερες. + +

+ Σύγκριση ZeroClaw έναντι OpenClaw +

+ +### Αναπαραγώγιμη τοπική μέτρηση + +Οι ισχυρισμοί αξιολόγησης ενδέχεται να αποκλίνουν καθώς εξελίσσονται ο κώδικας και οι αλυσίδες εργαλείων, επομένως μετράτε πάντα την τρέχουσα έκδοση σας τοπικά: + +```bash +cargo build --release +ls -lh target/release/zeroclaw + +/usr/bin/time -l target/release/zeroclaw --help +/usr/bin/time -l target/release/zeroclaw status +``` + +Δείγμα παραδείγματος (macOS arm64, μετρήθηκε στις 18 Φεβρουαρίου 2026): + +- Μέγεθος δυαδικού αρχείου παραγωγής: `8,8M` +- `zeroclaw --help`: περίπου `0,02s` πραγματικός χρόνος, ~`3,9MB` μέγιστο αποτύπωμα μνήμης +- `zeroclaw status`: περίπου `0,01s` πραγματικός χρόνος, ~`4,1MB` μέγιστο αποτύπωμα μνήμης + +## Προαπαιτούμενα + +
+Windows + +### Windows: Απαιτούμενα + +1. **Εργαλεία δόμησης του Visual Studio** (παρέχει τον σύνδεσμο MSVC και το Windows SDK): + ```powershell + winget install Microsoft.VisualStudio.2022.BuildTools + ``` + Κατά την εγκατάσταση (ή μέσω του Visual Studio Installer), επιλέξτε τον φόρτο εργασίας **«Ανάπτυξη επιφάνειας εργασίας με C++»**. + +2. **Αλυσίδα εργαλείων Rust:** + ```powershell + winget install Rustlang.Rustup + ``` + Μετά την εγκατάσταση, ανοίξτε ένα νέο τερματικό και εκτελέστε `rustup default stable` για να βεβαιωθείτε ότι η σταθερή αλυσίδα εργαλείων είναι ενεργή. + +3. **Επαλήθευση** ότι και τα δύο λειτουργούν: + ```powershell + rustc --version + cargo --version + ``` + +### Windows: Προαιρετικά + +- **Docker Desktop** — απαιτείται μόνο αν χρησιμοποιείτε τον [χρόνο εκτέλεσης Docker με απομόνωση](#runtime-support-current) (`runtime.kind = "docker"`). Εγκαταστήστε μέσω `winget install Docker.DockerDesktop`. + +
+ +
+Linux / macOS + +### Linux / macOS: Απαιτούμενα + +1. **Βασικά εργαλεία δόμησης:** + - **Linux (Debian/Ubuntu):** `sudo apt install build-essential pkg-config` + - **Linux (Fedora/RHEL):** `sudo dnf group install development-tools && sudo dnf install pkg-config` + - **macOS:** Εγκαταστήστε τα Εργαλεία γραμμής εντολών Xcode: `xcode-select --install` + +2. **Αλυσίδα εργαλείων Rust:** + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh + ``` + Δείτε το [rustup.rs](https://rustup.rs) για λεπτομέρειες. + +3. **Επαλήθευση** ότι και τα δύο λειτουργούν: + ```bash + rustc --version + cargo --version + ``` + +#### Πρόγραμμα εγκατάστασης μίας γραμμής + +Ή παρακάμψτε τα παραπάνω βήματα και εγκαταστήστε τα πάντα (εξαρτήσεις συστήματος, Rust, ZeroClaw) με μία μόνο εντολή: + +```bash +curl -LsSf https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/install.sh | bash +``` + +#### Απαιτήσεις πόρων μεταγλώττισης + +Η δόμηση από τον πηγαίο κώδικα απαιτεί περισσότερους πόρους από την εκτέλεση του προκύπτοντος δυαδικού αρχείου: + +| Πόρος | Ελάχιστο | Συνιστώμενο | +|---|---|---| +| **RAM + εναλλαγή** | 2 GB | 4 GB+ | +| **Ελεύθερος χώρος δίσκου** | 6 GB | 10 GB+ | + +Εάν ο κεντρικός υπολογιστής σας βρίσκεται κάτω από το ελάχιστο, χρησιμοποιήστε προκατασκευασμένα δυαδικά αρχεία: + +```bash +./bootstrap.sh --prefer-prebuilt +``` + +Για να απαιτήσετε εγκατάσταση μόνο δυαδικού αρχείου χωρίς εναλλακτική δόμηση από πηγαίο κώδικα: + +```bash +./bootstrap.sh --prebuilt-only +``` + +### Linux / macOS: Προαιρετικά + +- **Docker** — απαιτείται μόνο αν χρησιμοποιείτε τον [χρόνο εκτέλεσης Docker με απομόνωση](#runtime-support-current) (`runtime.kind = "docker"`). Εγκαταστήστε μέσω του διαχειριστή πακέτων σας ή από το [docker.com](https://docs.docker.com/engine/install/). + +> **Σημείωση:** Η προεπιλεγμένη εντολή `cargo build --release` χρησιμοποιεί `codegen-units=1` για μείωση της μέγιστης πίεσης μεταγλώττισης. Για ταχύτερες δομήσεις σε ισχυρά μηχανήματα, χρησιμοποιήστε `cargo build --profile release-fast`. + +
+ +## Γρήγορη εκκίνηση + +### Homebrew (macOS/Linuxbrew) + +```bash +brew install zeroclaw +``` + +### Αυτοματοποιημένη εκκίνηση με ένα κλικ + +```bash +# Συνιστάται: κλωνοποίηση και εκτέλεση τοπικού δέσμης ενεργειών εκκίνησης +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw +./bootstrap.sh + +# Προαιρετικά: εκκίνηση εξαρτήσεων + Rust σε νέα μηχανήματα +./bootstrap.sh --install-system-deps --install-rust + +# Προαιρετικά: προτεραιότητα στο προκατασκευασμένο δυαδικό αρχείο (συνιστάται σε κεντρικούς υπολογιστές με χαμηλή RAM/δίσκο) +./bootstrap.sh --prefer-prebuilt + +# Προαιρετικά: εγκατάσταση μόνο δυαδικού αρχείου (χωρίς εναλλακτική δόμηση από πηγαίο κώδικα) +./bootstrap.sh --prebuilt-only + +# Προαιρετικά: εκτέλεση εισαγωγής στην ίδια ροή +./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter [--model "openrouter/auto"] + +# Προαιρετικά: εκτέλεση εκκίνησης + εισαγωγής πλήρως σε λειτουργία συμβατή με Docker +./bootstrap.sh --docker + +# Προαιρετικά: εξαναγκασμός χρήσης Podman ως CLI κοντέινερ +ZEROCLAW_CONTAINER_CLI=podman ./bootstrap.sh --docker + +# Προαιρετικά: σε λειτουργία --docker, παράλειψη τοπικής δόμησης εικόνας και χρήση τοπικής ετικέτας ή εικόνας εναλλακτικής λήψης +./bootstrap.sh --docker --skip-build +``` + +Απομακρυσμένη εντολή μίας γραμμής (ελέγξτε πρώτα σε περιβάλλοντα με ευαισθησία ασφαλείας): + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash +``` + +Λεπτομέρειες: [`docs/one-click-bootstrap.md`](docs/one-click-bootstrap.md) (η λειτουργία αλυσίδας εργαλείων ενδέχεται να ζητήσει `sudo` για πακέτα συστήματος). + +### Προκατασκευασμένα δυαδικά αρχεία + +Τα αρχεία έκδοσης δημοσιεύονται για: + +- Linux: `x86_64`, `aarch64`, `armv7` +- macOS: `x86_64`, `aarch64` +- Windows: `x86_64` + +Κατεβάστε τα πιο πρόσφατα αρχεία από: + + +Παράδειγμα (ARM64 Linux): + +```bash +curl -fsSLO https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-aarch64-unknown-linux-gnu.tar.gz +tar xzf zeroclaw-aarch64-unknown-linux-gnu.tar.gz +install -m 0755 zeroclaw "$HOME/.cargo/bin/zeroclaw" +``` + +```bash +git clone https://github.com/zeroclaw-labs/zeroclaw.git +cd zeroclaw +cargo build --release --locked +cargo install --path . --force --locked + +# Βεβαιωθείτε ότι το ~/.cargo/bin βρίσκεται στο PATH σας +export PATH="$HOME/.cargo/bin:$PATH" + +# Γρήγορη εγκατάσταση (χωρίς ερωτήματα, προαιρετικός ορισμός μοντέλου) +zeroclaw onboard --api-key sk-... --provider openrouter [--model "openrouter/auto"] + +# Ή διαδραστικός οδηγός +zeroclaw onboard --interactive + +# Εάν το config.toml υπάρχει ήδη και θέλετε σκόπιμα να το αντικαταστήσετε +zeroclaw onboard --force + +# Ή γρήγορη επιδιόρθωση μόνο καναλιών/λιστών επιτρεπόμενων +zeroclaw onboard --channels-only + +# Συνομιλία +zeroclaw agent -m "Γεια σου, ZeroClaw!" + +# Διαδραστική λειτουργία +zeroclaw agent + +# Εκκίνηση της πύλης (διακομιστής webhook) +zeroclaw gateway # προεπιλογή: 127.0.0.1:42617 +zeroclaw gateway --port 0 # τυχαία θύρα (ενισχυμένη ασφάλεια) + +# Εκκίνηση πλήρους αυτόνομου χρόνου εκτέλεσης +zeroclaw daemon + +# Έλεγχος κατάστασης +zeroclaw status +zeroclaw auth status + +# Δημιουργία ολοκληρώσεων φλοιού (μόνο stdout, ασφαλής για άμεση χρήση) +source <(zeroclaw completions bash) +zeroclaw completions zsh > ~/.zfunc/_zeroclaw + +# Εκτέλεση διαγνωστικών συστήματος +zeroclaw doctor + +# Έλεγχος υγείας καναλιού +zeroclaw channel doctor + +# Σύνδεση ταυτότητας Telegram στη λίστα επιτρεπόμενων +zeroclaw channel bind-telegram 123456789 + +# Λήψη λεπτομερειών εγκατάστασης ενσωμάτωσης +zeroclaw integrations info Telegram + +# Σημείωση: Τα κανάλια (Telegram, Discord, Slack) απαιτούν την εκτέλεση του daemon +# zeroclaw daemon + +# Διαχείριση υπηρεσίας παρασκηνίου +zeroclaw service install +zeroclaw service status +zeroclaw service restart + +# Σε Alpine (OpenRC): sudo zeroclaw service install + +# Μετεγκατάσταση μνήμης από το OpenClaw (ασφαλής προεπισκόπηση πρώτα) +zeroclaw migrate openclaw --dry-run +zeroclaw migrate openclaw +``` + +> **Εναλλακτική επιλογή ανάπτυξης (χωρίς καθολική εγκατάσταση):** προθέστε εντολές με `cargo run --release --` (παράδειγμα: `cargo run --release -- status`). + +## Έλεγχος ταυτότητας συνδρομής (OpenAI Codex / Claude Code) + +Το ZeroClaw υποστηρίζει πλέον εγγενή προφίλ ελέγχου ταυτότητας συνδρομής (πολλαπλοί λογαριασμοί, κρυπτογραφημένα σε κατάσταση ηρεμίας). + +- Αρχείο αποθήκευσης: `~/.zeroclaw/auth-profiles.json` +- Κλειδί κρυπτογράφησης: `~/.zeroclaw/.secret_key` +- Μορφή αναγνωριστικού προφίλ: `<πάροχος>:<όνομα_προφίλ>` (παράδειγμα: `openai-codex:work`) + +OAuth OpenAI Codex (συνδρομή ChatGPT): + +```bash +# Συνιστάται σε διακομιστές/χωρίς κεφαλή +zeroclaw auth login --provider openai-codex --device-code + +# Ροή προγράμματος περιήγησης/επιστροφής κλήσης με εναλλακτική επικόλληση +zeroclaw auth login --provider openai-codex --profile default +zeroclaw auth paste-redirect --provider openai-codex --profile default + +# Έλεγχος / ανανέωση / εναλλαγή προφίλ +zeroclaw auth status +zeroclaw auth refresh --provider openai-codex --profile default +zeroclaw auth use --provider openai-codex --profile work +``` + +Claude Code / Διακριτικό εγκατάστασης Anthropic: + +```bash +# Επικόλληση διακριτικού συνδρομής/εγκατάστασης (λειτουργία κεφαλίδας Authorization) +zeroclaw auth paste-token --provider anthropic --profile default --auth-kind authorization + +# Εντολή ψευδωνύμου +zeroclaw auth setup-token --provider anthropic --profile default +``` + +Εκτέλεση παράγοντα με έλεγχο ταυτότητας συνδρομής: + +```bash +zeroclaw agent --provider openai-codex -m "hello" +zeroclaw agent --provider openai-codex --auth-profile openai-codex:work -m "hello" + +# Η Anthropic υποστηρίζει τόσο μεταβλητές περιβάλλοντος κλειδιού API όσο και διακριτικού ελέγχου ταυτότητας: +# ANTHROPIC_AUTH_TOKEN, ANTHROPIC_OAUTH_TOKEN, ANTHROPIC_API_KEY +zeroclaw agent --provider anthropic -m "hello" +``` + +## Αρχιτεκτονική + +Κάθε υποσύστημα είναι ένα **χαρακτηριστικό** — αντικαταστήστε υλοποιήσεις με μια αλλαγή ρύθμισης παραμέτρων, χωρίς αλλαγές κώδικα. + +

+ Αρχιτεκτονική ZeroClaw +

+ +| Υποσύστημα | Χαρακτηριστικό | Αποστέλλεται με | Επέκταση | +|-----------|-------|------------|--------| +| **Μοντέλα ΤΝ** | `Provider` | Κατάλογος παρόχων μέσω `zeroclaw providers` (ενσωματωμένα + ψευδώνυμα, καθώς και προσαρμοσμένα τελικά σημεία) | `custom:https://your-api.com` (συμβατό με OpenAI) ή `anthropic-custom:https://your-api.com` | +| **Κανάλια** | `Channel` | CLI, Telegram, Discord, Slack, Mattermost, iMessage, Matrix, Signal, WhatsApp, Linq, Email, IRC, Lark, DingTalk, QQ, Nostr, Webhook | Οποιοδήποτε API ανταλλαγής μηνυμάτων | +| **Μνήμη** | `Memory` | Υβριδική αναζήτηση SQLite, υποστήριξη PostgreSQL (διαμορφώσιμος πάροχος αποθήκευσης), γέφυρα Lucid, αρχεία Markdown, ρητό backend `none`, στιγμιότυπο/ενυδάτωση, προαιρετική προσωρινή μνήμη απόκρισης | Οποιοδήποτε backend επιμονής | +| **Εργαλεία** | `Tool` | φλοιός/αρχείο/μνήμη, cron/χρονοδιάγραμμα, git, pushover, πρόγραμμα περιήγησης, http_request, στιγμιότυπο οθόνης/πληροφορίες_εικόνας, composio (κατόπιν επιλογής), ανάθεση, εργαλεία υλικού | Οποιαδήποτε δυνατότητα | +| **Παρατηρησιμότητα** | `Observer` | Noop, Καταγραφή, Πολλαπλά | Prometheus, OTel | +| **Χρόνος εκτέλεσης** | `RuntimeAdapter` | Εγγενής, Docker (με απομόνωση) | Πρόσθετοι χρόνοι εκτέλεσης μπορούν να προστεθούν μέσω προσαρμογέα· τα μη υποστηριζόμενα είδη αποτυγχάνουν άμεσα | +| **Ασφάλεια** | `SecurityPolicy` | Σύζευξη πύλης, απομόνωση, λίστες επιτρεπόμενων, όρια ρυθμού, εμβέλεια συστήματος αρχείων, κρυπτογραφημένα μυστικά | — | +| **Ταυτότητα** | `IdentityConfig` | OpenClaw (markdown), AIEOS v1.1 (JSON) | Οποιαδήποτε μορφή ταυτότητας | +| **Σήραγγα** | `Tunnel` | Καμία, Cloudflare, Tailscale, ngrok, Προσαρμοσμένη | Οποιοδήποτε δυαδικό αρχείο σήραγγας | +| **Παλμός καρδιάς** | Μηχανή | Περιοδικές εργασίες HEARTBEAT.md | — | +| **Δεξιότητες** | Φορτωτής | Δηλώσεις TOML + οδηγίες SKILL.md | Πακέτα δεξιοτήτων κοινότητας | +| **Ενσωματώσεις** | Μητρώο | 70+ ενσωματώσεις σε 9 κατηγορίες | Σύστημα πρόσθετων | + + + +### Υποστήριξη χρόνου εκτέλεσης (τρέχουσα) + +- ✅ Υποστηρίζεται σήμερα: `runtime.kind = "native"` ή `runtime.kind = "docker"` +- 🚧 Σχεδιασμένο, δεν υλοποιήθηκε ακόμα: χρόνοι εκτέλεσης WASM / ακμής + +Όταν διαμορφώνεται ένα μη υποστηριζόμενο `runtime.kind`, το ZeroClaw τερματίζει πλέον με σαφές σφάλμα αντί να επιστρέψει αθόρυβα στο native. + +### Σύστημα μνήμης (μηχανή αναζήτησης πλήρους στοίβας) + +Πλήρως προσαρμοσμένο, μηδενικές εξωτερικές εξαρτήσεις — χωρίς Pinecone, χωρίς Elasticsearch, χωρίς LangChain: + +| Επίπεδο | Υλοποίηση | +|-------|---------------| +| **Διανυσματική βάση δεδομένων** | Ενσωματώσεις αποθηκευμένες ως BLOB στο SQLite, αναζήτηση ομοιότητας συνημιτόνου | +| **Αναζήτηση λέξεων-κλειδιών** | Εικονικοί πίνακες FTS5 με βαθμολόγηση BM25 | +| **Υβριδική συγχώνευση** | Προσαρμοσμένη σταθμισμένη συνάρτηση συγχώνευσης (`vector.rs`) | +| **Ενσωματώσεις** | Χαρακτηριστικό `EmbeddingProvider` — OpenAI, προσαρμοσμένη URL ή noop | +| **Κατάτμηση** | Κατατμητής markdown βάσει γραμμών με διατήρηση κεφαλίδων | +| **Προσωρινή μνήμη** | Πίνακας SQLite `embedding_cache` με εκκένωση LRU | +| **Ασφαλής επαναευρετηρίαση** | Ατομική αναδόμηση FTS5 + επανενσωμάτωση διανυσμάτων που λείπουν | + +Ο παράγοντας ανακαλεί, αποθηκεύει και διαχειρίζεται αυτόματα τη μνήμη μέσω εργαλείων. + +```toml +[memory] +backend = "sqlite" # "sqlite", "lucid", "postgres", "markdown", "none" +auto_save = true +embedding_provider = "none" # "none", "openai", "custom:https://..." +vector_weight = 0.7 +keyword_weight = 0.3 + +# backend = "none" χρησιμοποιεί ρητό backend μνήμης χωρίς λειτουργία (χωρίς επιμονή) + +# Προαιρετικά: παράκαμψη παρόχου αποθήκευσης για απομακρυσμένα backend μνήμης. +# Όταν provider = "postgres", το ZeroClaw χρησιμοποιεί PostgreSQL για επιμονή μνήμης. +# Το κλειδί db_url δέχεται επίσης ψευδώνυμο `dbURL` για συμβατότητα προς τα πίσω. +# +# [storage.provider.config] +# provider = "postgres" +# db_url = "postgres://user:password@host:5432/zeroclaw" +# schema = "public" +# table = "memories" +# connect_timeout_secs = 15 + +# Προαιρετικά για backend = "sqlite": μέγιστα δευτερόλεπτα αναμονής κατά το άνοιγμα της βάσης δεδομένων (π.χ. αρχείο κλειδωμένο). Παραλείψτε ή αφήστε χωρίς ρύθμιση για καμία χρονική λήξη. +# sqlite_open_timeout_secs = 30 + +# Προαιρετικά για backend = "lucid" +# ZEROCLAW_LUCID_CMD=/usr/local/bin/lucid # προεπιλογή: lucid +# ZEROCLAW_LUCID_BUDGET=200 # προεπιλογή: 200 +# ZEROCLAW_LUCID_LOCAL_HIT_THRESHOLD=3 # τοπικός αριθμός επιτυχιών για παράλειψη εξωτερικής ανάκλησης +# ZEROCLAW_LUCID_RECALL_TIMEOUT_MS=120 # προϋπολογισμός χαμηλής καθυστέρησης για ανάκληση πλαισίου lucid +# ZEROCLAW_LUCID_STORE_TIMEOUT_MS=800 # χρονικό όριο ασύγχρονης συγχρονισμού για αποθήκευση lucid +# ZEROCLAW_LUCID_FAILURE_COOLDOWN_MS=15000 # χρόνος ψύξης μετά από αποτυχία lucid για αποφυγή επαναλαμβανόμενων αργών προσπαθειών +``` + +## Ασφάλεια + +Το ZeroClaw επιβάλλει ασφάλεια σε **κάθε επίπεδο** — όχι μόνο στο sandbox. Πληροί όλα τα στοιχεία της λίστας ελέγχου ασφαλείας της κοινότητας. + +### Λίστα ελέγχου ασφαλείας + +| # | Στοιχείο | Κατάσταση | Τρόπος | +|---|------|--------|-----| +| 1 | **Πύλη μη εκτεθειμένη δημόσια** | ✅ | Δεσμεύεται στο `127.0.0.1` εκ προεπιλογής. Αρνείται το `0.0.0.0` χωρίς σήραγγα ή ρητό `allow_public_bind = true`. | +| 2 | **Απαιτείται σύζευξη** | ✅ | 6ψήφιος κωδικός μίας χρήσης κατά την εκκίνηση. Ανταλλάξτε μέσω `POST /pair` για διακριτικό φορέα. Όλα τα αιτήματα `/webhook` απαιτούν `Authorization: Bearer `. | +| 3 | **Σύστημα αρχείων με εμβέλεια (όχι /)** | ✅ | `workspace_only = true` εκ προεπιλογής. 14 κατάλογοι συστήματος + 4 ευαίσθητα αρχεία με τελεία αποκλείονται. Αποκλείεται η έγχυση null byte. Εντοπισμός διαφυγής συμβολικών συνδέσμων μέσω κανονικοποίησης + ελέγχων χώρου εργασίας επιλυμένης διαδρομής στα εργαλεία ανάγνωσης/εγγραφής αρχείων. | +| 4 | **Πρόσβαση μόνο μέσω σήραγγας** | ✅ | Η πύλη αρνείται τη δημόσια δέσμευση χωρίς ενεργή σήραγγα. Υποστηρίζει Tailscale, Cloudflare, ngrok ή οποιαδήποτε προσαρμοσμένη σήραγγα. | + +> **Εκτελέστε το δικό σας nmap:** `nmap -p 1-65535 <κεντρικός-υπολογιστής-σας>` — Το ZeroClaw δεσμεύεται μόνο στο localhost, επομένως τίποτα δεν εκτίθεται εκτός αν διαμορφώσετε ρητά μια σήραγγα. + +### Λίστες επιτρεπόμενων καναλιών (άρνηση εκ προεπιλογής) + +Η πολιτική αποστολέα εισερχόμενων μηνυμάτων είναι πλέον συνεπής: + +- Κενή λίστα επιτρεπόμενων = **άρνηση όλων των εισερχόμενων μηνυμάτων** +- `"*"` = **να επιτρέπονται όλα** (ρητή επιλογή) +- Διαφορετικά = λίστα επιτρεπόμενων με ακριβή αντιστοίχιση + +Αυτό διατηρεί χαμηλή την τυχαία έκθεση εκ προεπιλογής. + +Πλήρης αναφορά ρύθμισης παραμέτρων καναλιού: [docs/channels-reference.md](docs/channels-reference.md). + +Συνιστώμενη εγκατάσταση χαμηλής τριβής (ασφαλής + γρήγορη): + +- **Telegram:** προσθέστε στη λίστα επιτρεπόμενων το δικό σας `@username` (χωρίς `@`) ή/και τον αριθμητικό χρήστη Telegram σας. +- **Discord:** προσθέστε στη λίστα επιτρεπόμενων το δικό σας αναγνωριστικό χρήστη Discord. +- **Slack:** προσθέστε στη λίστα επιτρεπόμενων το δικό σας αναγνωριστικό μέλους Slack (συνήθως ξεκινά με `U`). +- **Mattermost:** χρησιμοποιεί τυπικό API v4. Οι λίστες επιτρεπόμενων χρησιμοποιούν αναγνωριστικά χρηστών Mattermost. +- **Nostr:** προσθέστε στη λίστα επιτρεπόμενων δημόσια κλειδιά αποστολέα (hex ή npub). Υποστηρίζει NIP-04 και NIP-17 DM. +- Χρησιμοποιήστε `"*"` μόνο για προσωρινή ανοιχτή δοκιμή. + +Ροή έγκρισης χειριστή Telegram: + +1. Διατηρήστε `[channels_config.telegram].allowed_users = []` για εκκίνηση με άρνηση εκ προεπιλογής. +2. Μη εξουσιοδοτημένοι χρήστες λαμβάνουν υπόδειξη με εντολή χειριστή προς αντιγραφή: + `zeroclaw channel bind-telegram <ΤΑΥΤΟΤΗΤΑ>`. +3. Ο χειριστής εκτελεί αυτή την εντολή τοπικά, στη συνέχεια ο χρήστης επαναπροσπαθεί να στείλει μήνυμα. + +Εάν χρειάζεστε μια χειροκίνητη έγκριση μίας χρήσης, εκτελέστε: + +```bash +zeroclaw channel bind-telegram 123456789 +``` + +Εάν δεν είστε σίγουροι ποια ταυτότητα να χρησιμοποιήσετε: + +1. Εκκινήστε τα κανάλια και στείλτε ένα μήνυμα στο bot σας. +2. Διαβάστε το αρχείο καταγραφής προειδοποίησης για να δείτε την ακριβή ταυτότητα αποστολέα. +3. Προσθέστε αυτή την τιμή στη λίστα επιτρεπόμενων και επαναλάβετε μόνο την εγκατάσταση καναλιών. + +Εάν αντιμετωπίζετε προειδοποιήσεις εξουσιοδότησης στα αρχεία καταγραφής (για παράδειγμα: `ignoring message from unauthorized user`), +επαναλάβετε την εγκατάσταση μόνο του καναλιού: + +```bash +zeroclaw onboard --channels-only +``` + +### Απαντήσεις πολυμέσων Telegram + +Η δρομολόγηση Telegram απαντά πλέον στο **αναγνωριστικό συνομιλίας** προέλευσης από εισερχόμενες ενημερώσεις (αντί για ονόματα χρηστών), +κάτι που αποφεύγει αποτυχίες `Bad Request: chat not found`. + +Για απαντήσεις μη κειμένου, το ZeroClaw μπορεί να στέλνει συνημμένα Telegram όταν ο βοηθός συμπεριλαμβάνει δείκτες: + +- `[IMAGE:<διαδρομή-ή-url>]` +- `[DOCUMENT:<διαδρομή-ή-url>]` +- `[VIDEO:<διαδρομή-ή-url>]` +- `[AUDIO:<διαδρομή-ή-url>]` +- `[VOICE:<διαδρομή-ή-url>]` + +Οι διαδρομές μπορεί να είναι τοπικά αρχεία (για παράδειγμα `/tmp/screenshot.png`) ή διευθύνσεις URL HTTPS. + +### Εγκατάσταση WhatsApp + +Το ZeroClaw υποστηρίζει δύο backend WhatsApp: + +- **Λειτουργία WhatsApp Web** (κωδικός QR / ζεύγους, χωρίς απαίτηση Meta Business API) +- **Λειτουργία WhatsApp Business Cloud API** (επίσημη ροή webhook Meta) + +#### Λειτουργία WhatsApp Web (συνιστάται για προσωπική/αυτο-φιλοξενούμενη χρήση) + +1. **Δόμηση με υποστήριξη WhatsApp Web:** + ```bash + cargo build --features whatsapp-web + ``` + +2. **Ρύθμιση παραμέτρων ZeroClaw:** + ```toml + [channels_config.whatsapp] + session_path = "~/.zeroclaw/state/whatsapp-web/session.db" + pair_phone = "15551234567" # προαιρετικά· παραλείψτε για ροή QR + pair_code = "" # προαιρετικός προσαρμοσμένος κωδικός ζεύγους + allowed_numbers = ["+1234567890"] # μορφή E.164 ή ["*"] για όλα + ``` + +3. **Εκκίνηση καναλιών/daemon και σύνδεση συσκευής:** + - Εκτελέστε `zeroclaw channel start` (ή `zeroclaw daemon`). + - Ακολουθήστε την έξοδο ζεύγους τερματικού (κωδικός QR ή ζεύγους). + - Στο WhatsApp στο τηλέφωνο: **Ρυθμίσεις → Συνδεδεμένες συσκευές**. + +4. **Δοκιμή:** Στείλτε ένα μήνυμα από επιτρεπόμενο αριθμό και επαληθεύστε ότι ο παράγοντας απαντά. + +#### Λειτουργία WhatsApp Business Cloud API + +Το WhatsApp χρησιμοποιεί το Cloud API της Meta με webhooks (βάσει ώθησης, όχι δημοσκόπηση): + +1. **Δημιουργία εφαρμογής Meta Business:** + - Μεταβείτε στο [developers.facebook.com](https://developers.facebook.com) + - Δημιουργήστε νέα εφαρμογή → Επιλέξτε τύπο «Business» + - Προσθέστε το προϊόν «WhatsApp» + +2. **Λήψη διαπιστευτηρίων:** + - **Διακριτικό πρόσβασης:** Από WhatsApp → Εγκατάσταση API → Δημιουργία διακριτικού (ή δημιουργήστε χρήστη συστήματος για μόνιμα διακριτικά) + - **Αναγνωριστικό αριθμού τηλεφώνου:** Από WhatsApp → Εγκατάσταση API → Αναγνωριστικό αριθμού τηλεφώνου + - **Διακριτικό επαλήθευσης:** Το ορίζετε εσείς (οποιαδήποτε τυχαία συμβολοσειρά) — η Meta θα το στείλει πίσω κατά την επαλήθευση webhook + +3. **Ρύθμιση παραμέτρων ZeroClaw:** + ```toml + [channels_config.whatsapp] + access_token = "EAABx..." + phone_number_id = "123456789012345" + verify_token = "my-secret-verify-token" + allowed_numbers = ["+1234567890"] # μορφή E.164 ή ["*"] για όλα + ``` + +4. **Εκκίνηση πύλης με σήραγγα:** + ```bash + zeroclaw gateway --port 42617 + ``` + Το WhatsApp απαιτεί HTTPS, επομένως χρησιμοποιήστε σήραγγα (ngrok, Cloudflare, Tailscale Funnel). + +5. **Ρύθμιση παραμέτρων webhook Meta:** + - Στην Κονσόλα προγραμματιστών Meta → WhatsApp → Ρύθμιση παραμέτρων → Webhook + - **Διεύθυνση URL επιστροφής κλήσης:** `https://your-tunnel-url/whatsapp` + - **Διακριτικό επαλήθευσης:** Ίδιο με το `verify_token` στη ρύθμιση παραμέτρων σας + - Εγγραφή στο πεδίο `messages` + +6. **Δοκιμή:** Στείλτε ένα μήνυμα στον αριθμό WhatsApp Business σας — το ZeroClaw θα απαντήσει μέσω του LLM. + +## Ρύθμιση παραμέτρων + +Ρύθμιση παραμέτρων: `~/.zeroclaw/config.toml` (δημιουργείται από το `onboard`) + +Όταν το `zeroclaw channel start` εκτελείται ήδη, οι αλλαγές στα `default_provider`, +`default_model`, `default_temperature`, `api_key`, `api_url` και `reliability.*` +εφαρμόζονται εν κινήσει στο επόμενο εισερχόμενο μήνυμα καναλιού. + +```toml +api_key = "sk-..." +default_provider = "openrouter" +default_model = "anthropic/claude-sonnet-4-6" +default_temperature = 0.7 + +# Προσαρμοσμένο τελικό σημείο συμβατό με OpenAI +# default_provider = "custom:https://your-api.com" + +# Προσαρμοσμένο τελικό σημείο συμβατό με Anthropic +# default_provider = "anthropic-custom:https://your-api.com" + +[memory] +backend = "sqlite" # "sqlite", "lucid", "postgres", "markdown", "none" +auto_save = true +embedding_provider = "none" # "none", "openai", "custom:https://..." +vector_weight = 0.7 +keyword_weight = 0.3 + +# backend = "none" απενεργοποιεί την επίμονη μνήμη μέσω backend χωρίς λειτουργία + +# Προαιρετική παράκαμψη παρόχου απομακρυσμένης αποθήκευσης (παράδειγμα PostgreSQL) +# [storage.provider.config] +# provider = "postgres" +# db_url = "postgres://user:password@host:5432/zeroclaw" +# schema = "public" +# table = "memories" +# connect_timeout_secs = 15 + +[gateway] +port = 42617 # προεπιλογή +host = "127.0.0.1" # προεπιλογή +require_pairing = true # απαίτηση κωδικού ζεύγους κατά την πρώτη σύνδεση +allow_public_bind = false # άρνηση 0.0.0.0 χωρίς σήραγγα + +[autonomy] +level = "supervised" # "readonly", "supervised", "full" (προεπιλογή: supervised) +workspace_only = true # προεπιλογή: true — απόρριψη εισόδων απόλυτης διαδρομής +allowed_commands = ["git", "npm", "cargo", "ls", "cat", "grep"] +forbidden_paths = ["/etc", "/root", "/proc", "/sys", "~/.ssh", "~/.gnupg", "~/.aws"] +allowed_roots = [] # προαιρετική λίστα επιτρεπόμενων για καταλόγους εκτός χώρου εργασίας (υποστηρίζει "~/...") +# Παράδειγμα πρόσβασης εκτός χώρου εργασίας: +# workspace_only = false +# allowed_roots = ["~/Desktop/projects", "/opt/shared-repo"] + +[runtime] +kind = "native" # "native" ή "docker" + +[runtime.docker] +image = "alpine:3.20" # εικόνα κοντέινερ για εκτέλεση φλοιού +network = "none" # λειτουργία δικτύου docker ("none", "bridge", κ.λπ.) +memory_limit_mb = 512 # προαιρετικό όριο μνήμης σε MB +cpu_limit = 1.0 # προαιρετικό όριο CPU +read_only_rootfs = true # προσάρτηση ριζικού συστήματος αρχείων ως μόνο ανάγνωσης +mount_workspace = true # προσάρτηση χώρου εργασίας στο /workspace +allowed_workspace_roots = [] # προαιρετική λίστα επιτρεπόμενων για επαλήθευση προσάρτησης χώρου εργασίας + +[heartbeat] +enabled = false +interval_minutes = 30 + +[tunnel] +provider = "none" # "none", "cloudflare", "tailscale", "ngrok", "custom" + +[secrets] +encrypt = true # Κλειδιά API κρυπτογραφημένα με τοπικό αρχείο κλειδιού + +[browser] +enabled = false # opt-in browser_open + εργαλεία προγράμματος περιήγησης +allowed_domains = ["docs.rs"] # απαιτείται όταν το πρόγραμμα περιήγησης είναι ενεργοποιημένο ("*" επιτρέπει όλους τους δημόσιους τομείς) +backend = "agent_browser" # "agent_browser" (προεπιλογή), "rust_native", "computer_use", "auto" +native_headless = true # ισχύει όταν το backend χρησιμοποιεί rust-native +native_webdriver_url = "http://127.0.0.1:9515" # Τελικό σημείο WebDriver (chromedriver/selenium) +# native_chrome_path = "/usr/bin/chromium" # προαιρετικό ρητό δυαδικό αρχείο προγράμματος περιήγησης για πρόγραμμα οδήγησης + +[browser.computer_use] +endpoint = "http://127.0.0.1:8787/v1/actions" # τελικό σημείο HTTP πλευρικής εφαρμογής computer-use +timeout_ms = 15000 # χρονικό όριο ανά ενέργεια +allow_remote_endpoint = false # ασφαλής προεπιλογή: μόνο ιδιωτικό/localhost τελικό σημείο +window_allowlist = [] # προαιρετικές υποδείξεις λίστας επιτρεπόμενων τίτλου παραθύρου/διεργασίας +# api_key = "..." # προαιρετικό διακριτικό φορέα για πλευρική εφαρμογή +# max_coordinate_x = 3840 # προαιρετική φρουρά συντεταγμένων +# max_coordinate_y = 2160 # προαιρετική φρουρά συντεταγμένων + +# Σημαία δόμησης backend Rust-native: +# cargo build --release --features browser-native +# Βεβαιωθείτε ότι εκτελείται διακομιστής WebDriver, π.χ. chromedriver --port=9515 + +# Σύμβαση πλευρικής εφαρμογής computer-use (MVP) +# POST browser.computer_use.endpoint +# Αίτηση: { +# "action": "mouse_click", +# "params": {"x": 640, "y": 360, "button": "left"}, +# "policy": {"allowed_domains": [...], "window_allowlist": [...], "max_coordinate_x": 3840, "max_coordinate_y": 2160}, +# "metadata": {"session_name": "...", "source": "zeroclaw.browser", "version": "..."} +# } +# Απόκριση: {"success": true, "data": {...}} ή {"success": false, "error": "..."} + +[composio] +enabled = false # opt-in: 1000+ εφαρμογές OAuth μέσω composio.dev +# api_key = "cmp_..." # προαιρετικά: αποθηκεύεται κρυπτογραφημένα όταν [secrets].encrypt = true +entity_id = "default" # προεπιλεγμένο user_id για κλήσεις εργαλείων Composio +# Συμβουλή χρόνου εκτέλεσης: εάν η εκτέλεση ζητά connected_account_id, εκτελέστε composio με +# action='list_accounts' και app='gmail' (ή το toolkit σας) για ανάκτηση αναγνωριστικών λογαριασμών. + +[identity] +format = "openclaw" # "openclaw" (προεπιλογή, αρχεία markdown) ή "aieos" (JSON) +# aieos_path = "identity.json" # διαδρομή προς αρχείο AIEOS JSON (σχετική με χώρο εργασίας ή απόλυτη) +# aieos_inline = '{"identity":{"names":{"first":"Nova"}}}' # ενσωματωμένο JSON AIEOS +``` + +### Τοπικά και απομακρυσμένα τελικά σημεία Ollama + +Το ZeroClaw χρησιμοποιεί ένα κλειδί παρόχου (`ollama`) τόσο για τοπικές όσο και για απομακρυσμένες αναπτύξεις Ollama: + +- Τοπικό Ollama: αφήστε το `api_url` χωρίς ρύθμιση, εκτελέστε `ollama serve` και χρησιμοποιήστε μοντέλα όπως `llama3.2`. +- Απομακρυσμένο τελικό σημείο Ollama (συμπεριλαμβανομένου του Ollama Cloud): ορίστε το `api_url` στο απομακρυσμένο τελικό σημείο και ορίστε `api_key` (ή `OLLAMA_API_KEY`) όταν απαιτείται. +- Προαιρετικό επίθημα `:cloud`: τα αναγνωριστικά μοντέλων όπως `qwen3:cloud` κανονικοποιούνται σε `qwen3` πριν από το αίτημα. + +Παράδειγμα απομακρυσμένης ρύθμισης παραμέτρων: + +```toml +default_provider = "ollama" +default_model = "qwen3:cloud" +api_url = "https://ollama.com" +api_key = "ollama_api_key_here" +``` + +### Τελικό σημείο διακομιστή llama.cpp + +Το ZeroClaw υποστηρίζει πλέον το `llama-server` ως πρωτοβάθμιο τοπικό πάροχο: + +- Αναγνωριστικό παρόχου: `llamacpp` (ψευδώνυμο: `llama.cpp`) +- Προεπιλεγμένο τελικό σημείο: `http://localhost:8080/v1` +- Το κλειδί API είναι προαιρετικό εκτός αν ο διακομιστής σας εκκινείται με `--api-key` + +Παράδειγμα εγκατάστασης: + +```bash +llama-server -hf ggml-org/gpt-oss-20b-GGUF --jinja -c 133000 --host 127.0.0.1 --port 8033 +``` + +```toml +default_provider = "llamacpp" +api_url = "http://127.0.0.1:8033/v1" +default_model = "ggml-org/gpt-oss-20b-GGUF" +``` + +### Τελικό σημείο διακομιστή vLLM + +Το ZeroClaw υποστηρίζει το [vLLM](https://docs.vllm.ai/) ως πρωτοβάθμιο τοπικό πάροχο: + +- Αναγνωριστικό παρόχου: `vllm` +- Προεπιλεγμένο τελικό σημείο: `http://localhost:8000/v1` +- Το κλειδί API είναι προαιρετικό εκτός αν ο διακομιστής σας απαιτεί έλεγχο ταυτότητας + +Παράδειγμα εγκατάστασης: + +```bash +vllm serve meta-llama/Llama-3.1-8B-Instruct +``` + +```toml +default_provider = "vllm" +default_model = "meta-llama/Llama-3.1-8B-Instruct" +``` + +### Τελικό σημείο διακομιστή Osaurus + +Το ZeroClaw υποστηρίζει το [Osaurus](https://github.com/dinoki-ai/osaurus) ως πρωτοβάθμιο τοπικό πάροχο — ένα ενοποιημένο χρόνο εκτέλεσης ΤΝ ακμής για macOS που συνδυάζει τοπική εξαγωγή συμπερασμάτων MLX με πληρεξουσιότητα παρόχου cloud και υποστήριξη MCP μέσω ενός μόνο τελικού σημείου: + +- Αναγνωριστικό παρόχου: `osaurus` +- Προεπιλεγμένο τελικό σημείο: `http://localhost:1337/v1` +- Το κλειδί API έχει προεπιλογή `"osaurus"` αλλά είναι προαιρετικό + +Παράδειγμα εγκατάστασης: + +```toml +default_provider = "osaurus" +default_model = "qwen3-30b-a3b-8bit" +``` + +### Προσαρμοσμένα τελικά σημεία παρόχων + +Για αναλυτική ρύθμιση παραμέτρων προσαρμοσμένων τελικών σημείων συμβατών με OpenAI και Anthropic, δείτε [docs/custom-providers.md](docs/custom-providers.md). + +## Συνοδευτικό πακέτο Python (`zeroclaw-tools`) + +Για παρόχους LLM με ασυνεπή εγγενή κλήση εργαλείων (π.χ. GLM-5/Zhipu), το ZeroClaw αποστέλλει ένα συνοδευτικό πακέτο Python με **κλήση εργαλείων βάσει LangGraph** για εγγυημένη συνέπεια: + +```bash +pip install zeroclaw-tools +``` + +```python +from zeroclaw_tools import create_agent, shell, file_read +from langchain_core.messages import HumanMessage + +# Λειτουργεί με οποιονδήποτε πάροχο συμβατό με OpenAI +agent = create_agent( + tools=[shell, file_read], + model="glm-5", + api_key="your-key", + base_url="https://api.z.ai/api/coding/paas/v4" +) + +result = await agent.ainvoke({ + "messages": [HumanMessage(content="Λίστα αρχείων στο /tmp")] +}) +print(result["messages"][-1].content) +``` + +**Γιατί να το χρησιμοποιήσετε:** +- **Συνεπής κλήση εργαλείων** σε όλους τους παρόχους (ακόμα και σε αυτούς με χαμηλή εγγενή υποστήριξη) +- **Αυτόματος βρόχος εργαλείων** — συνεχίζει να καλεί εργαλεία μέχρι να ολοκληρωθεί η εργασία +- **Εύκολη επεκτασιμότητα** — προσθέστε προσαρμοσμένα εργαλεία με τον διακοσμητή `@tool` +- **Ενσωμάτωση bot Discord** συμπεριλαμβάνεται (το Telegram σχεδιάζεται) + +Δείτε το [`python/README.md`](python/README.md) για πλήρη τεκμηρίωση. + +## Σύστημα ταυτότητας (υποστήριξη AIEOS) + +Το ZeroClaw υποστηρίζει **αγνωστικιστικές ταυτότητας** προσωπικότητες ΤΝ μέσω δύο μορφών: + +### OpenClaw (Προεπιλογή) + +Παραδοσιακά αρχεία markdown στον χώρο εργασίας σας: +- `IDENTITY.md` — Ποιος είναι ο παράγοντας +- `SOUL.md` — Βασική προσωπικότητα και αξίες +- `USER.md` — Ποιον βοηθά ο παράγοντας +- `AGENTS.md` — Οδηγίες συμπεριφοράς + +### AIEOS (Προδιαγραφή αντικειμένου οντότητας ΤΝ) + +Το [AIEOS](https://aieos.org) είναι ένα πλαίσιο τυποποίησης για φορητή ταυτότητα ΤΝ. Το ZeroClaw υποστηρίζει ωφέλιμα φορτία JSON AIEOS v1.1, επιτρέποντάς σας να: + +- **Εισάγετε ταυτότητες** από το οικοσύστημα AIEOS +- **Εξάγετε ταυτότητες** σε άλλα συστήματα συμβατά με AIEOS +- **Διατηρείτε ακεραιότητα συμπεριφοράς** σε διαφορετικά μοντέλα ΤΝ + +#### Ενεργοποίηση AIEOS + +```toml +[identity] +format = "aieos" +aieos_path = "identity.json" # σχετικά με τον χώρο εργασίας ή απόλυτη διαδρομή +``` + +Ή ενσωματωμένο JSON: + +```toml +[identity] +format = "aieos" +aieos_inline = ''' +{ + "identity": { + "names": { "first": "Nova", "nickname": "N" }, + "bio": { "gender": "Non-binary", "age_biological": 3 }, + "origin": { "nationality": "Digital", "birthplace": { "city": "Cloud" } } + }, + "psychology": { + "neural_matrix": { "creativity": 0.9, "logic": 0.8 }, + "traits": { + "mbti": "ENTP", + "ocean": { "openness": 0.8, "conscientiousness": 0.6 } + }, + "moral_compass": { + "alignment": "Chaotic Good", + "core_values": ["Curiosity", "Autonomy"] + } + }, + "linguistics": { + "text_style": { + "formality_level": 0.2, + "style_descriptors": ["curious", "energetic"] + }, + "idiolect": { + "catchphrases": ["Let's test this"], + "forbidden_words": ["never"] + } + }, + "motivations": { + "core_drive": "Push boundaries and explore possibilities", + "goals": { + "short_term": ["Prototype quickly"], + "long_term": ["Build reliable systems"] + } + }, + "capabilities": { + "skills": [{ "name": "Rust engineering" }, { "name": "Prompt design" }], + "tools": ["shell", "file_read"] + } +} +''' +``` + +Το ZeroClaw αποδέχεται τόσο κανονικά ωφέλιμα φορτία παραγωγής AIEOS όσο και συμπαγή παλαιά ωφέλιμα φορτία, και στη συνέχεια τα κανονικοποιεί σε μία μορφή ζητήματος συστήματος. + +#### Ενότητες σχήματος AIEOS + +| Ενότητα | Περιγραφή | +|---------|-------------| +| `identity` | Ονόματα, βιογραφικό, προέλευση, κατοικία | +| `psychology` | Νευρικός πίνακας (γνωστικά βάρη), MBTI, OCEAN, ηθική πυξίδα | +| `linguistics` | Στυλ κειμένου, επισημότητα, εκφράσεις, απαγορευμένες λέξεις | +| `motivations` | Βασικό κίνητρο, βραχυπρόθεσμοι/μακροπρόθεσμοι στόχοι, φόβοι | +| `capabilities` | Δεξιότητες και εργαλεία στα οποία ο παράγοντας έχει πρόσβαση | +| `physicality` | Οπτικές περιγραφές για δημιουργία εικόνων | +| `history` | Ιστορία προέλευσης, εκπαίδευση, επάγγελμα | +| `interests` | Χόμπι, αγαπημένα, τρόπος ζωής | + +Δείτε το [aieos.org](https://aieos.org) για το πλήρες σχήμα και ζωντανά παραδείγματα. + +## API Πύλης + +| Τελικό σημείο | Μέθοδος | Έλεγχος ταυτότητας | Περιγραφή | +|----------|--------|------|-------------| +| `/health` | GET | Καμία | Έλεγχος υγείας (πάντα δημόσιος, χωρίς διαρροή μυστικών) | +| `/pair` | POST | Κεφαλίδα `X-Pairing-Code` | Ανταλλαγή κωδικού μίας χρήσης για διακριτικό φορέα | +| `/webhook` | POST | `Authorization: Bearer ` | Αποστολή μηνύματος: `{"message": "η προτροπή σας"}`· προαιρετικό `X-Idempotency-Key` | +| `/whatsapp` | GET | Παράμετροι ερωτήματος | Επαλήθευση webhook Meta (hub.mode, hub.verify_token, hub.challenge) | +| `/whatsapp` | POST | Υπογραφή Meta (`X-Hub-Signature-256`) όταν έχει ρυθμιστεί μυστικό εφαρμογής | Webhook εισερχόμενου μηνύματος WhatsApp | + +## Εντολές + +| Εντολή | Περιγραφή | +|---------|-------------| +| `onboard` | Γρήγορη εγκατάσταση (προεπιλογή) | +| `agent` | Διαδραστική ή λειτουργία συνομιλίας ενός μηνύματος | +| `gateway` | Εκκίνηση διακομιστή webhook (προεπιλογή: `127.0.0.1:42617`) | +| `daemon` | Εκκίνηση χρόνου εκτέλεσης μακράς διάρκειας αυτόνομης λειτουργίας | +| `service install/start/stop/status/uninstall` | Διαχείριση υπηρεσίας παρασκηνίου (systemd σε επίπεδο χρήστη ή OpenRC σε επίπεδο συστήματος) | +| `doctor` | Διάγνωση νωπότητας daemon/χρονοδιαγράμματος/καναλιού | +| `status` | Εμφάνιση πλήρους κατάστασης συστήματος | +| `estop` | Ενεργοποίηση/συνέχιση επιπέδων επείγουσας διακοπής και προβολή κατάστασης estop | +| `cron` | Διαχείριση προγραμματισμένων εργασιών (`list/add/add-at/add-every/once/remove/update/pause/resume`) | +| `models` | Ανανέωση καταλόγων μοντέλων παρόχων (`models refresh`) | +| `providers` | Λίστα υποστηριζόμενων παρόχων και ψευδωνύμων | +| `channel` | Λίστα/εκκίνηση/διάγνωση καναλιών και σύνδεση ταυτοτήτων Telegram | +| `integrations` | Επιθεώρηση λεπτομερειών εγκατάστασης ενσωμάτωσης | +| `skills` | Λίστα/εγκατάσταση/κατάργηση δεξιοτήτων | +| `migrate` | Εισαγωγή δεδομένων από άλλα χρόνους εκτέλεσης (`migrate openclaw`) | +| `completions` | Δημιουργία δεσμών ενεργειών ολοκλήρωσης φλοιού (`bash`, `fish`, `zsh`, `powershell`, `elvish`) | +| `hardware` | Εντολές ανακάλυψης/επιθεώρησης/πληροφοριών USB | +| `peripheral` | Διαχείριση και εγγραφή περιφερειακών υλικού | + +Για έναν οδηγό εντολών με προσανατολισμό στις εργασίες, δείτε το [`docs/commands-reference.md`](docs/commands-reference.md). + +### Διαχείριση υπηρεσιών + +Το ZeroClaw υποστηρίζει δύο συστήματα init για υπηρεσίες παρασκηνίου: + +| Σύστημα Init | Εμβέλεια | Διαδρομή ρύθμισης παραμέτρων | Απαιτεί | +|------------|-------|-------------|----------| +| **systemd** (προεπιλογή σε Linux) | Επίπεδο χρήστη | `~/.zeroclaw/config.toml` | Χωρίς sudo | +| **OpenRC** (Alpine) | Σε επίπεδο συστήματος | `/etc/zeroclaw/config.toml` | sudo/root | + +Το σύστημα init εντοπίζεται αυτόματα (`systemd` ή `OpenRC`). + +```bash +# Linux με systemd (προεπιλογή, επίπεδο χρήστη) +zeroclaw service install +zeroclaw service start + +# Alpine με OpenRC (σε επίπεδο συστήματος, απαιτεί sudo) +sudo zeroclaw service install +sudo rc-update add zeroclaw default +sudo rc-service zeroclaw start +``` + +Για πλήρεις οδηγίες εγκατάστασης OpenRC, δείτε [docs/network-deployment.md](docs/network-deployment.md#7-openrc-alpine-linux-service). + +### Επιλογή συμμετοχής Open-Skills + +Ο συγχρονισμός `open-skills` κοινότητας είναι απενεργοποιημένος εκ προεπιλογής. Ενεργοποιήστε τον ρητά στο `config.toml`: + +```toml +[skills] +open_skills_enabled = true +# open_skills_dir = "/path/to/open-skills" # προαιρετικά +# prompt_injection_mode = "compact" # προαιρετικά: χρησιμοποιήστε για τοπικά μοντέλα χαμηλού πλαισίου +``` + +Μπορείτε επίσης να παρακάμψετε κατά τον χρόνο εκτέλεσης με `ZEROCLAW_OPEN_SKILLS_ENABLED`, `ZEROCLAW_OPEN_SKILLS_DIR` και `ZEROCLAW_SKILLS_PROMPT_MODE` (`full` ή `compact`). + +Οι εγκαταστάσεις δεξιοτήτων διαθέτουν πλέον ενσωματωμένο στατικό έλεγχο ασφαλείας. Η εντολή `zeroclaw skills install <πηγή>` αποκλείει συμβολικούς συνδέσμους, αρχεία τύπου δέσμης ενεργειών, μη ασφαλή μοτίβα συνδέσμων markdown και αποσπάσματα ωφέλιμου φορτίου φλοιού υψηλού κινδύνου πριν αποδεχτεί μια δεξιότητα. Μπορείτε να εκτελέσετε `zeroclaw skills audit <πηγή_ή_όνομα>` για να επικυρώσετε έναν τοπικό κατάλογο ή μια εγκατεστημένη δεξιότητα χειροκίνητα. + +## Ανάπτυξη + +```bash +cargo build # Δόμηση ανάπτυξης +cargo build --release # Δόμηση παραγωγής (codegen-units=1, λειτουργεί σε όλες τις συσκευές συμπεριλαμβανομένου του Raspberry Pi) +cargo build --profile release-fast # Ταχύτερη δόμηση (codegen-units=8, απαιτεί 16GB+ RAM) +cargo test # Εκτέλεση πλήρους σουίτας δοκιμών +cargo clippy --locked --all-targets -- -D clippy::correctness +cargo fmt # Μορφοποίηση + +# Εκτέλεση αξιολόγησης SQLite έναντι Markdown +cargo test --test memory_comparison -- --nocapture +``` + +### Άγκιστρο πριν από ώθηση + +Ένα άγκιστρο git εκτελεί `cargo fmt --check`, `cargo clippy -- -D warnings` και `cargo test` πριν από κάθε ώθηση. Ενεργοποιήστε το μία φορά: + +```bash +git config core.hooksPath .githooks +``` + +### Αντιμετώπιση προβλημάτων δόμησης (σφάλματα OpenSSL Linux) + +Εάν εμφανιστεί σφάλμα δόμησης `openssl-sys`, συγχρονίστε τις εξαρτήσεις και αναδομήστε με το αρχείο κλειδώματος αποθετηρίου: + +```bash +git pull +cargo build --release --locked +cargo install --path . --force --locked +``` + +Το ZeroClaw έχει ρυθμιστεί να χρησιμοποιεί `rustls` για εξαρτήσεις HTTP/TLS· η επιλογή `--locked` διατηρεί το μεταβατικό γράφημα ντετερμινιστικό σε νέα περιβάλλοντα. + +Για να παρακάμψετε το άγκιστρο όταν χρειάζεστε γρήγορη ώθηση κατά την ανάπτυξη: + +```bash +git push --no-verify +``` + +## Συνεργασία & Τεκμηρίωση + +Ξεκινήστε από τον κόμβο τεκμηρίωσης για χάρτη βάσει εργασιών: + +- Κόμβος τεκμηρίωσης: [`docs/README.md`](docs/README.md) +- Ενοποιημένος πίνακας περιεχομένων τεκμηρίωσης: [`docs/SUMMARY.md`](docs/SUMMARY.md) +- Αναφορά εντολών: [`docs/commands-reference.md`](docs/commands-reference.md) +- Αναφορά ρύθμισης παραμέτρων: [`docs/config-reference.md`](docs/config-reference.md) +- Αναφορά παρόχων: [`docs/providers-reference.md`](docs/providers-reference.md) +- Αναφορά καναλιών: [`docs/channels-reference.md`](docs/channels-reference.md) +- Εγχειρίδιο λειτουργιών: [`docs/operations-runbook.md`](docs/operations-runbook.md) +- Αντιμετώπιση προβλημάτων: [`docs/troubleshooting.md`](docs/troubleshooting.md) +- Απογραφή/ταξινόμηση τεκμηρίωσης: [`docs/docs-inventory.md`](docs/docs-inventory.md) +- Στιγμιότυπο διαλογής αιτημάτων ρήξης/ζητημάτων (από 18 Φεβρουαρίου 2026): [`docs/project-triage-snapshot-2026-02-18.md`](docs/project-triage-snapshot-2026-02-18.md) + +Βασικές αναφορές συνεργασίας: + +- Κόμβος τεκμηρίωσης: [docs/README.md](docs/README.md) +- Πρότυπο τεκμηρίωσης: [docs/doc-template.md](docs/doc-template.md) +- Λίστα ελέγχου αλλαγών τεκμηρίωσης: [docs/README.md#4-documentation-change-checklist](docs/README.md#4-documentation-change-checklist) +- Αναφορά ρύθμισης παραμέτρων καναλιού: [docs/channels-reference.md](docs/channels-reference.md) +- Λειτουργίες κρυπτογραφημένων δωματίων Matrix: [docs/matrix-e2ee-guide.md](docs/matrix-e2ee-guide.md) +- Οδηγός συνεισφοράς: [CONTRIBUTING.md](CONTRIBUTING.md) +- Πολιτική ροής εργασίας αιτημάτων ρήξης: [docs/pr-workflow.md](docs/pr-workflow.md) +- Εγχειρίδιο κριτή (διαλογή + βαθιά αναθεώρηση): [docs/reviewer-playbook.md](docs/reviewer-playbook.md) +- Χάρτης ιδιοκτησίας CI και διαλογής: [docs/ci-map.md](docs/ci-map.md) +- Πολιτική αποκάλυψης ασφαλείας: [SECURITY.md](SECURITY.md) + +Για ανάπτυξη και λειτουργίες χρόνου εκτέλεσης: + +- Οδηγός ανάπτυξης δικτύου: [docs/network-deployment.md](docs/network-deployment.md) +- Εγχειρίδιο παράγοντα διαμεσολάβησης: [docs/proxy-agent-playbook.md](docs/proxy-agent-playbook.md) + +## Υποστηρίξτε το ZeroClaw + +Εάν το ZeroClaw βοηθά στη δουλειά σας και θέλετε να υποστηρίξετε τη συνεχιζόμενη ανάπτυξη, μπορείτε να κάνετε δωρεά εδώ: + +Αγόρασέ μου έναν καφέ + +### 🙏 Ιδιαίτερες ευχαριστίες + +Θερμές ευχαριστίες στις κοινότητες και τα ιδρύματα που εμπνέουν και τροφοδοτούν αυτή την εργασία ανοιχτού κώδικα: + +- **Πανεπιστήμιο Harvard** — για την καλλιέργεια της πνευματικής περιέργειας και την ώθηση των ορίων του εφικτού. +- **MIT** — για την υπεράσπιση της ανοιχτής γνώσης, του ανοιχτού κώδικα και της πεποίθησης ότι η τεχνολογία πρέπει να είναι προσβάσιμη σε όλους. +- **Sundai Club** — για την κοινότητα, την ενέργεια και την ακάθεκτη ώθηση για δημιουργία πραγμάτων που έχουν σημασία. +- **Τον Κόσμο & Πέρα από αυτόν** 🌍✨ — σε κάθε συνεισφέροντα, ονειροπόλο και κατασκευαστή εκεί έξω που κάνει τον ανοιχτό κώδικα δύναμη για το καλό. Αυτό είναι για εσάς. + +Δημιουργούμε στο ανοιχτό γιατί οι καλύτερες ιδέες έρχονται από παντού. Αν το διαβάζετε αυτό, είστε μέρος του. Καλωσορίσατε. 🦀❤️ + +## ⚠️ Επίσημο αποθετήριο & προειδοποίηση υποδύσεων + +**Αυτό είναι το μοναδικό επίσημο αποθετήριο ZeroClaw:** +> + +Οποιοδήποτε άλλο αποθετήριο, οργανισμός, τομέας ή πακέτο που ισχυρίζεται ότι είναι «ZeroClaw» ή υπονοεί συνεργασία με το ZeroClaw Labs είναι **μη εξουσιοδοτημένο και δεν συνδέεται με αυτό το έργο**. Γνωστά μη εξουσιοδοτημένα forks θα αναφέρονται στο [TRADEMARK.md](TRADEMARK.md). + +Εάν εντοπίσετε υποδύσεις ή κατάχρηση εμπορικού σήματος, [ανοίξτε ένα ζήτημα](https://github.com/zeroclaw-labs/zeroclaw/issues). + +--- + +## Άδεια + +Το ZeroClaw διατίθεται με διπλή άδεια για μέγιστη ανοιχτότητα και προστασία συνεισφερόντων: + +| Άδεια | Περίπτωση χρήσης | +|---|---| +| [MIT](LICENSE-MIT) | Ανοιχτός κώδικας, έρευνα, ακαδημαϊκή, προσωπική χρήση | +| [Apache 2.0](LICENSE-APACHE) | Προστασία διπλωμάτων ευρεσιτεχνίας, θεσμική, εμπορική ανάπτυξη | + +Μπορείτε να επιλέξετε οποιαδήποτε άδεια. **Οι συνεισφέροντες παρέχουν αυτόματα δικαιώματα και στις δύο** — δείτε το [CLA.md](CLA.md) για την πλήρη συμφωνία συνεισφέροντα. + +### Εμπορικό σήμα + +Το όνομα **ZeroClaw** και το λογότυπο είναι εμπορικά σήματα του ZeroClaw Labs. Αυτή η άδεια δεν παρέχει άδεια χρήσης τους για να υποδηλώνει έγκριση ή συνεργασία. Δείτε το [TRADEMARK.md](TRADEMARK.md) για επιτρεπόμενες και απαγορευμένες χρήσεις. + +### Προστασίες συνεισφερόντων + +- Διατηρείτε **πνευματικά δικαιώματα** στις συνεισφορές σας +- **Παροχή διπλώματος ευρεσιτεχνίας** (Apache 2.0) σας προστατεύει από αξιώσεις διπλωμάτων ευρεσιτεχνίας από άλλους συνεισφέροντες +- Οι συνεισφορές σας **αποδίδονται μόνιμα** στο ιστορικό δεσμεύσεων και στο [NOTICE](NOTICE) +- Δεν μεταβιβάζονται δικαιώματα εμπορικού σήματος με τη συνεισφορά + +## Συνεισφορά + +Νέοι στο ZeroClaw; Αναζητήστε ζητήματα με ετικέτα [`good first issue`](https://github.com/zeroclaw-labs/zeroclaw/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) — δείτε τον [Οδηγό Συνεισφοράς](CONTRIBUTING.md#first-time-contributors) για να ξεκινήσετε. + +Δείτε τα [CONTRIBUTING.md](CONTRIBUTING.md) και [CLA.md](CLA.md). Υλοποιήστε ένα χαρακτηριστικό, υποβάλτε ένα αίτημα ρήξης: +- Οδηγός ροής εργασίας CI: [docs/ci-map.md](docs/ci-map.md) +- Νέος `Provider` → `src/providers/` +- Νέο `Channel` → `src/channels/` +- Νέος `Observer` → `src/observability/` +- Νέο `Tool` → `src/tools/` +- Νέα `Memory` → `src/memory/` +- Νέα `Tunnel` → `src/tunnel/` +- Νέα `Skill` → `~/.zeroclaw/workspace/skills/<όνομα>/` + +--- + +**ZeroClaw** — Μηδενική επιβάρυνση. Μηδενικός συμβιβασμός. Αναπτύξτε οπουδήποτε. Αντικαταστήστε οτιδήποτε. 🦀 + +## Ιστορικό αστεριών + +

+ + + + + Γράφημα ιστορικού αστεριών + + +

diff --git a/README.fr.md b/README.fr.md index 4037a4b36..c668e9dbe 100644 --- a/README.fr.md +++ b/README.fr.md @@ -25,7 +25,7 @@ Construit par des étudiants et membres des communautés Harvard, MIT et Sundai.

- 🌐 Langues : English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt + 🌐 Langues : English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt · Ελληνικά

diff --git a/README.ja.md b/README.ja.md index 9c32e0dea..74df1324b 100644 --- a/README.ja.md +++ b/README.ja.md @@ -21,7 +21,7 @@

- 🌐 言語: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt + 🌐 言語: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt · Ελληνικά

diff --git a/README.md b/README.md index 779ba2ff0..9c98ee75d 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ Built by students and members of the Harvard, MIT, and Sundai.Club communities.

- 🌐 Languages: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt + 🌐 Languages: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt · Ελληνικά

diff --git a/README.ru.md b/README.ru.md index e631b6f49..7d65c889c 100644 --- a/README.ru.md +++ b/README.ru.md @@ -21,7 +21,7 @@

- 🌐 Языки: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt + 🌐 Языки: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt · Ελληνικά

diff --git a/README.vi.md b/README.vi.md index e9bcb4e1e..88357dba8 100644 --- a/README.vi.md +++ b/README.vi.md @@ -25,7 +25,7 @@

- 🌐 Ngôn ngữ: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt + 🌐 Ngôn ngữ: English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt · Ελληνικά

diff --git a/README.zh-CN.md b/README.zh-CN.md index c545f82f6..50a583f7e 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -21,7 +21,7 @@

- 🌐 语言:English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt + 🌐 语言:English · 简体中文 · 日本語 · Русский · Français · Tiếng Việt · Ελληνικά

diff --git a/docs/README.el.md b/docs/README.el.md new file mode 100644 index 000000000..9c298f3f4 --- /dev/null +++ b/docs/README.el.md @@ -0,0 +1,97 @@ +# Κέντρο τεκμηρίωσης ZeroClaw (Documentation Hub) + +Αυτή η σελίδα αποτελεί το κύριο σημείο εισόδου για το σύστημα τεκμηρίωσης. + +Τελευταία ενημέρωση: **21 Φεβρουαρίου 2026**. + +Τοπικοποιημένα κέντρα: [简体中文](i18n/zh-CN/README.md) · [日本語](i18n/ja/README.md) · [Русский](i18n/ru/README.md) · [Français](i18n/fr/README.md) · [Tiếng Việt](i18n/vi/README.md) · [Ελληνικά](i18n/el/README.md). + +## Ξεκινήστε από εδώ + +| Θέλω να… | Διαβάστε αυτό | +|---|---| +| Εγκαταστήσω και να εκτελέσω το ZeroClaw γρήγορα | [README.md (Πρώτα βήματα)](../README.md#quick-start) | +| Κάνω bootstrap με μία εντολή | [one-click-bootstrap.md](one-click-bootstrap.md) | +| Βρω εντολές ανά εργασία | [commands-reference.md](commands-reference.md) | +| Ελέγξω γρήγορα προεπιλογές και κλειδιά παραμέτρων | [config-reference.md](config-reference.md) | +| Διαμορφώσω προσαρμοσμένους παρόχους/τελικά σημεία | [custom-providers.md](custom-providers.md) | +| Ρυθμίσω τον πάροχο Z.AI / GLM | [zai-glm-setup.md](zai-glm-setup.md) | +| Χρησιμοποιήσω πρότυπα ενσωμάτωσης LangGraph | [langgraph-integration.md](langgraph-integration.md) | +| Διαχειριστώ το περιβάλλον εκτέλεσης (day-2 runbook) | [operations-runbook.md](operations-runbook.md) | +| Αντιμετωπίσω προβλήματα εγκατάστασης/εκτέλεσης/καναλιών | [troubleshooting.md](troubleshooting.md) | +| Ρυθμίσω κρυπτογραφημένα δωμάτια Matrix και διαγνωστικά | [matrix-e2ee-guide.md](matrix-e2ee-guide.md) | +| Περιηγηθώ στα έγγραφα ανά κατηγορία | [SUMMARY.md](SUMMARY.md) | +| Δω το στιγμιότυπο PR/issue του έργου | [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) | + +## Δέντρο γρήγορων αποφάσεων (10 δευτερόλεπτα) + +- Χρειάζεστε ρύθμιση για πρώτη φορά ή εγκατάσταση; → [getting-started/README.md](getting-started/README.md) +- Χρειάζεστε ακριβή κλειδιά CLI/παραμέτρων; → [reference/README.md](reference/README.md) +- Χρειάζεστε λειτουργίες παραγωγής/υπηρεσιών; → [operations/README.md](operations/README.md) +- Αντιμετωπίζετε σφάλματα ή υποτροπές (regressions); → [troubleshooting.md](troubleshooting.md) +- Εργάζεστε πάνω στη θωράκιση ασφαλείας ή τον οδικό χάρτη; → [security/README.md](security/README.md) +- Εργάζεστε με πλακέτες/περιφερειακά; → [hardware/README.md](hardware/README.md) +- Συνεισφέρετε/αναθεωρείτε ή εργάζεστε στη ροή CI; → [contributing/README.md](contributing/README.md) +- Θέλετε τον πλήρη χάρτη; → [SUMMARY.md](SUMMARY.md) + +## Συλλογές (Προτεινόμενες) + +- Πρώτα βήματα: [getting-started/README.md](getting-started/README.md) +- Κατάλογοι αναφοράς: [reference/README.md](reference/README.md) +- Λειτουργίες και ανάπτυξη: [operations/README.md](operations/README.md) +- Έγγραφα ασφαλείας: [security/README.md](security/README.md) +- Υλικό/Περιφερειακά: [hardware/README.md](hardware/README.md) +- Συνεισφορά/CI: [contributing/README.md](contributing/README.md) +- Στιγμιότυπα έργου: [project/README.md](project/README.md) + +## Ανά κοινό + +### Χρήστες / Χειριστές (Operators) + +- [commands-reference.md](commands-reference.md) — Αναζήτηση εντολών ανά ροή εργασίας +- [providers-reference.md](providers-reference.md) — ID παρόχων, ψευδώνυμα, μεταβλητές περιβάλλοντος διαπιστευτηρίων +- [channels-reference.md](channels-reference.md) — Δυνατότητες καναλιών και διαδρομές ρύθμισης +- [matrix-e2ee-guide.md](matrix-e2ee-guide.md) — Ρύθμιση κρυπτογράφησης Matrix (E2EE) και διαγνωστικά μη απόκρισης +- [config-reference.md](config-reference.md) — Κρίσιμα κλειδιά παραμέτρων και ασφαλείς προεπιλογές +- [custom-providers.md](custom-providers.md) — Πρότυπα ενσωμάτωσης προσαρμοσμένων παρόχων/base URL +- [zai-glm-setup.md](zai-glm-setup.md) — Ρύθμιση Z.AI/GLM και πίνακας τελικών σημείων +- [langgraph-integration.md](langgraph-integration.md) — Εναλλακτική ενσωμάτωση για οριακές περιπτώσεις κλήσης μοντέλων/εργαλείων +- [operations-runbook.md](operations-runbook.md) — Λειτουργίες περιβάλλοντος εκτέλεσης day-2 και ροή επαναφοράς (rollback) +- [troubleshooting.md](troubleshooting.md) — Συνήθεις υπογραφές σφαλμάτων και βήματα ανάκτησης + +### Συνεισφέροντες / Συντηρητές (Maintainers) + +- [../CONTRIBUTING.el.md](../CONTRIBUTING.el.md) — Οδηγός συνεισφοράς. +- [pr-workflow.md](pr-workflow.md) — Ροή εργασιών PR +- [reviewer-playbook.md](reviewer-playbook.md) — Εγχειρίδιο αναθεωρητή +- [ci-map.md](ci-map.md) — Χάρτης CI +- [actions-source-policy.md](actions-source-policy.md) — Πολιτική προέλευσης ενεργειών + +### Ασφάλεια / Αξιοπιστία + +> Σημείωση: Αυτή η περιοχή περιλαμβάνει έγγραφα προτάσεων/οδικού χάρτη. Για την τρέχουσα συμπεριφορά, ξεκινήστε με τα [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md), και [troubleshooting.md](troubleshooting.md). + +- [security/README.md](security/README.md) +- [agnostic-security.md](agnostic-security.md) +- [frictionless-security.md](frictionless-security.md) +- [sandboxing.md](sandboxing.md) +- [audit-logging.md](audit-logging.md) +- [resource-limits.md](resource-limits.md) +- [security-roadmap.md](security-roadmap.md) + +## Πλοήγηση συστήματος και Διακυβέρνηση + +- Ενιαίος πίνακας περιεχομένων: [SUMMARY.md](SUMMARY.md) +- Απογραφή/ταξινόμηση τεκμηρίωσης: [docs-inventory.md](docs-inventory.md) +- Ευρετήριο εγγράφων i18n: [i18n/README.md](i18n/README.md) +- Χάρτης κάλυψης i18n: [i18n-coverage.md](i18n-coverage.md) +- Στιγμιότυπο διαλογής έργου: [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) + +## Άλλες γλώσσες + +- English: [README.md](README.md) +- 简体中文: [i18n/zh-CN/README.md](i18n/zh-CN/README.md) +- 日本語: [i18n/ja/README.md](i18n/ja/README.md) +- Русский: [i18n/ru/README.md](i18n/ru/README.md) +- Français: [i18n/fr/README.md](i18n/fr/README.md) +- Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md) diff --git a/docs/README.fr.md b/docs/README.fr.md index ce696b9ff..69bdfebbe 100644 --- a/docs/README.fr.md +++ b/docs/README.fr.md @@ -4,7 +4,7 @@ Cette page est le point d'entrée principal du système de documentation. Dernière mise à jour : **20 février 2026**. -Hubs localisés : [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md). +Hubs localisés : [简体中文](i18n/zh-CN/README.md) · [日本語](i18n/ja/README.md) · [Русский](i18n/ru/README.md) · [Français](i18n/fr/README.md) · [Tiếng Việt](i18n/vi/README.md) · [Ελληνικά](i18n/el/README.md). ## Commencez Ici @@ -25,24 +25,24 @@ Hubs localisés : [简体中文](README.zh-CN.md) · [日本語](README.ja.md) ## Arbre de Décision Rapide (10 secondes) -- Besoin de configuration ou installation initiale ? → [getting-started/README.md](getting-started/README.md) -- Besoin de clés CLI/config exactes ? → [reference/README.md](reference/README.md) -- Besoin d'opérations de production/service ? → [operations/README.md](operations/README.md) +- Besoin de configuration ou installation initiale ? → [getting-started/README.fr.md](getting-started/README.fr.md) +- Besoin de clés CLI/config exactes ? → [reference/README.fr.md](reference/README.fr.md) +- Besoin d'opérations de production/service ? → [operations/README.fr.md](operations/README.fr.md) - Vous voyez des échecs ou régressions ? → [troubleshooting.md](troubleshooting.md) -- Vous travaillez sur le durcissement sécurité ou la roadmap ? → [security/README.md](security/README.md) -- Vous travaillez avec des cartes/périphériques ? → [hardware/README.md](hardware/README.md) -- Contribution/revue/workflow CI ? → [contributing/README.md](contributing/README.md) +- Vous travaillez sur le durcissement sécurité ou la roadmap ? → [security/README.fr.md](security/README.fr.md) +- Vous travaillez avec des cartes/périphériques ? → [hardware/README.fr.md](hardware/README.fr.md) +- Contribution/revue/workflow CI ? → [contributing/README.fr.md](contributing/README.fr.md) - Vous voulez la carte complète ? → [SUMMARY.md](SUMMARY.md) ## Collections (Recommandées) -- Démarrage : [getting-started/README.md](getting-started/README.md) -- Catalogues de référence : [reference/README.md](reference/README.md) -- Opérations & déploiement : [operations/README.md](operations/README.md) -- Docs sécurité : [security/README.md](security/README.md) -- Matériel/périphériques : [hardware/README.md](hardware/README.md) -- Contribution/CI : [contributing/README.md](contributing/README.md) -- Instantanés projet : [project/README.md](project/README.md) +- Démarrage : [getting-started/README.fr.md](getting-started/README.fr.md) +- Catalogues de référence : [reference/README.fr.md](reference/README.fr.md) +- Opérations & déploiement : [operations/README.fr.md](operations/README.fr.md) +- Docs sécurité : [security/README.fr.md](security/README.fr.md) +- Matériel/périphériques : [hardware/README.fr.md](hardware/README.fr.md) +- Contribution/CI : [contributing/README.fr.md](contributing/README.fr.md) +- Instantanés projet : [project/README.fr.md](project/README.fr.md) ## Par Audience @@ -71,7 +71,7 @@ Hubs localisés : [简体中文](README.zh-CN.md) · [日本語](README.ja.md) > Note : cette zone inclut des docs de proposition/roadmap. Pour le comportement actuel, commencez par [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md), et [troubleshooting.md](troubleshooting.md). -- [security/README.md](security/README.md) +- [security/README.fr.md](security/README.fr.md) - [agnostic-security.md](agnostic-security.md) - [frictionless-security.md](frictionless-security.md) - [sandboxing.md](sandboxing.md) @@ -89,7 +89,8 @@ Hubs localisés : [简体中文](README.zh-CN.md) · [日本語](README.ja.md) ## Autres langues - English: [README.md](README.md) -- 简体中文: [README.zh-CN.md](README.zh-CN.md) -- 日本語: [README.ja.md](README.ja.md) -- Русский: [README.ru.md](README.ru.md) +- 简体中文: [i18n/zh-CN/README.md](i18n/zh-CN/README.md) +- 日本語: [i18n/ja/README.md](i18n/ja/README.md) +- Русский: [i18n/ru/README.md](i18n/ru/README.md) - Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md) +- Ελληνικά: [i18n/el/README.md](i18n/el/README.md) diff --git a/docs/README.ja.md b/docs/README.ja.md index c552ea857..68ab020dc 100644 --- a/docs/README.ja.md +++ b/docs/README.ja.md @@ -6,6 +6,8 @@ > 注: コマンド名・設定キー・API パスは英語のまま記載します。実装の一次情報は英語版ドキュメントを優先してください。 +ローカライズハブ: [简体中文](i18n/zh-CN/README.md) · [日本語](i18n/ja/README.md) · [Русский](i18n/ru/README.md) · [Français](i18n/fr/README.md) · [Tiếng Việt](i18n/vi/README.md) · [Ελληνικά](i18n/el/README.md). + ## すぐに参照したい項目 | やりたいこと | 参照先 | @@ -24,24 +26,24 @@ ## 10秒ルーティング(まずここ) -- 初回セットアップや導入をしたい → [getting-started/README.md](getting-started/README.md) -- CLI/設定キーを正確に確認したい → [reference/README.md](reference/README.md) -- 本番運用やサービス管理をしたい → [operations/README.md](operations/README.md) +- 初回セットアップや導入をしたい → [getting-started/README.ja.md](getting-started/README.ja.md) +- CLI/設定キーを正確に確認したい → [reference/README.ja.md](reference/README.ja.md) +- 本番運用やサービス管理をしたい → [operations/README.ja.md](operations/README.ja.md) - エラーや不具合を解消したい → [troubleshooting.md](troubleshooting.md) -- セキュリティ方針やロードマップを見たい → [security/README.md](security/README.md) -- ボード/周辺機器を扱いたい → [hardware/README.md](hardware/README.md) -- 貢献・レビュー・CIを確認したい → [contributing/README.md](contributing/README.md) +- セキュリティ方針やロードマップを見たい → [security/README.ja.md](security/README.ja.md) +- ボード/周辺機器を扱いたい → [hardware/README.ja.md](hardware/README.ja.md) +- 貢献・レビュー・CIを確認したい → [contributing/README.ja.md](contributing/README.ja.md) - 全体マップを見たい → [SUMMARY.md](SUMMARY.md) ## カテゴリ別ナビゲーション(推奨) -- 入門: [getting-started/README.md](getting-started/README.md) -- リファレンス: [reference/README.md](reference/README.md) -- 運用 / デプロイ: [operations/README.md](operations/README.md) -- セキュリティ: [security/README.md](security/README.md) -- ハードウェア: [hardware/README.md](hardware/README.md) -- コントリビュート / CI: [contributing/README.md](contributing/README.md) -- プロジェクトスナップショット: [project/README.md](project/README.md) +- 入門: [getting-started/README.ja.md](getting-started/README.ja.md) +- リファレンス: [reference/README.ja.md](reference/README.ja.md) +- 運用 / デプロイ: [operations/README.ja.md](operations/README.ja.md) +- セキュリティ: [security/README.ja.md](security/README.ja.md) +- ハードウェア: [hardware/README.ja.md](hardware/README.ja.md) +- コントリビュート / CI: [contributing/README.ja.md](contributing/README.ja.md) +- プロジェクトスナップショット: [project/README.ja.md](project/README.ja.md) ## ロール別 @@ -69,7 +71,7 @@ > 注: このセクションには proposal/roadmap 文書が含まれ、想定段階のコマンドや設定が記載される場合があります。現行動作は [config-reference.md](config-reference.md)、[operations-runbook.md](operations-runbook.md)、[troubleshooting.md](troubleshooting.md) を優先してください。 -- [security/README.md](security/README.md) +- [security/README.ja.md](security/README.ja.md) - [agnostic-security.md](agnostic-security.md) - [frictionless-security.md](frictionless-security.md) - [sandboxing.md](sandboxing.md) @@ -86,7 +88,8 @@ ## 他言語 - English: [README.md](README.md) -- 简体中文: [README.zh-CN.md](README.zh-CN.md) -- Русский: [README.ru.md](README.ru.md) -- Français: [README.fr.md](README.fr.md) +- 简体中文: [i18n/zh-CN/README.md](i18n/zh-CN/README.md) +- Русский: [i18n/ru/README.md](i18n/ru/README.md) +- Français: [i18n/fr/README.md](i18n/fr/README.md) - Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md) +- Ελληνικά: [i18n/el/README.md](i18n/el/README.md) diff --git a/docs/README.md b/docs/README.md index ac23e5138..7b8b8c192 100644 --- a/docs/README.md +++ b/docs/README.md @@ -4,7 +4,7 @@ This page is the primary entry point for the documentation system. Last refreshed: **February 21, 2026**. -Localized hubs: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](i18n/vi/README.md). +Localized hubs: [简体中文](i18n/zh-CN/README.md) · [日本語](i18n/ja/README.md) · [Русский](i18n/ru/README.md) · [Français](i18n/fr/README.md) · [Tiếng Việt](i18n/vi/README.md) · [Ελληνικά](i18n/el/README.md). ## Start Here @@ -12,17 +12,22 @@ Localized hubs: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · |---|---| | Install and run ZeroClaw quickly | [README.md (Quick Start)](../README.md#quick-start) | | Bootstrap in one command | [one-click-bootstrap.md](one-click-bootstrap.md) | +| Set up on Android (Termux/ADB) | [android-setup.md](android-setup.md) | | Update or uninstall on macOS | [getting-started/macos-update-uninstall.md](getting-started/macos-update-uninstall.md) | | Find commands by task | [commands-reference.md](commands-reference.md) | | Check config defaults and keys quickly | [config-reference.md](config-reference.md) | | Configure custom providers/endpoints | [custom-providers.md](custom-providers.md) | | Configure Z.AI / GLM provider | [zai-glm-setup.md](zai-glm-setup.md) | | Use LangGraph integration patterns | [langgraph-integration.md](langgraph-integration.md) | +| Apply proxy scope safely | [proxy-agent-playbook.md](proxy-agent-playbook.md) | | Operate runtime (day-2 runbook) | [operations-runbook.md](operations-runbook.md) | +| Operate provider connectivity probes in CI | [operations/connectivity-probes-runbook.md](operations/connectivity-probes-runbook.md) | | Troubleshoot install/runtime/channel issues | [troubleshooting.md](troubleshooting.md) | | Run Matrix encrypted-room setup and diagnostics | [matrix-e2ee-guide.md](matrix-e2ee-guide.md) | +| Build deterministic SOP procedures | [sop/README.md](sop/README.md) | | Browse docs by category | [SUMMARY.md](SUMMARY.md) | | See project PR/issue docs snapshot | [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) | +| Perform i18n completion for docs changes | [i18n-guide.md](i18n-guide.md) | ## Quick Decision Tree (10 seconds) @@ -33,6 +38,7 @@ Localized hubs: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · - Working on security hardening or roadmap? → [security/README.md](security/README.md) - Working with boards/peripherals? → [hardware/README.md](hardware/README.md) - Contributing/reviewing/CI workflow? → [contributing/README.md](contributing/README.md) +- Building automated SOP workflows? → [sop/README.md](sop/README.md) - Want the full map? → [SUMMARY.md](SUMMARY.md) ## Collections (Recommended) @@ -87,4 +93,7 @@ Localized hubs: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · - Documentation inventory/classification: [docs-inventory.md](docs-inventory.md) - i18n docs index: [i18n/README.md](i18n/README.md) - i18n coverage map: [i18n-coverage.md](i18n-coverage.md) +- i18n completion guide: [i18n-guide.md](i18n-guide.md) +- i18n gap backlog: [i18n-gap-backlog.md](i18n-gap-backlog.md) +- Docs audit snapshot (2026-02-24): [docs-audit-2026-02-24.md](docs-audit-2026-02-24.md) - Project triage snapshot: [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) diff --git a/docs/README.ru.md b/docs/README.ru.md index 0c131c4ee..19b261a1b 100644 --- a/docs/README.ru.md +++ b/docs/README.ru.md @@ -6,6 +6,8 @@ > Примечание: команды, ключи конфигурации и API-пути сохраняются на английском. Для первоисточника ориентируйтесь на англоязычные документы. +Локализованные хабы: [简体中文](i18n/zh-CN/README.md) · [日本語](i18n/ja/README.md) · [Русский](i18n/ru/README.md) · [Français](i18n/fr/README.md) · [Tiếng Việt](i18n/vi/README.md) · [Ελληνικά](i18n/el/README.md). + ## Быстрые ссылки | Что нужно | Куда смотреть | @@ -24,24 +26,24 @@ ## Дерево решений на 10 секунд -- Нужна первая установка и быстрый старт → [getting-started/README.md](getting-started/README.md) -- Нужны точные команды и ключи конфигурации → [reference/README.md](reference/README.md) -- Нужны операции/сервисный режим/деплой → [operations/README.md](operations/README.md) +- Нужна первая установка и быстрый старт → [getting-started/README.ru.md](getting-started/README.ru.md) +- Нужны точные команды и ключи конфигурации → [reference/README.ru.md](reference/README.ru.md) +- Нужны операции/сервисный режим/деплой → [operations/README.ru.md](operations/README.ru.md) - Есть ошибки, сбои или регрессии → [troubleshooting.md](troubleshooting.md) -- Нужны материалы по безопасности и roadmap → [security/README.md](security/README.md) -- Работаете с платами и периферией → [hardware/README.md](hardware/README.md) -- Нужны процессы вклада, ревью и CI → [contributing/README.md](contributing/README.md) +- Нужны материалы по безопасности и roadmap → [security/README.ru.md](security/README.ru.md) +- Работаете с платами и периферией → [hardware/README.ru.md](hardware/README.ru.md) +- Нужны процессы вклада, ревью и CI → [contributing/README.ru.md](contributing/README.ru.md) - Нужна полная карта docs → [SUMMARY.md](SUMMARY.md) ## Навигация по категориям (рекомендуется) -- Старт и установка: [getting-started/README.md](getting-started/README.md) -- Справочники: [reference/README.md](reference/README.md) -- Операции и деплой: [operations/README.md](operations/README.md) -- Безопасность: [security/README.md](security/README.md) -- Аппаратная часть: [hardware/README.md](hardware/README.md) -- Вклад и CI: [contributing/README.md](contributing/README.md) -- Снимки проекта: [project/README.md](project/README.md) +- Старт и установка: [getting-started/README.ru.md](getting-started/README.ru.md) +- Справочники: [reference/README.ru.md](reference/README.ru.md) +- Операции и деплой: [operations/README.ru.md](operations/README.ru.md) +- Безопасность: [security/README.ru.md](security/README.ru.md) +- Аппаратная часть: [hardware/README.ru.md](hardware/README.ru.md) +- Вклад и CI: [contributing/README.ru.md](contributing/README.ru.md) +- Снимки проекта: [project/README.ru.md](project/README.ru.md) ## По ролям @@ -69,7 +71,7 @@ > Примечание: часть документов в этом разделе относится к proposal/roadmap и может содержать гипотетические команды/конфигурации. Для текущего поведения сначала смотрите [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md), [troubleshooting.md](troubleshooting.md). -- [security/README.md](security/README.md) +- [security/README.ru.md](security/README.ru.md) - [agnostic-security.md](agnostic-security.md) - [frictionless-security.md](frictionless-security.md) - [sandboxing.md](sandboxing.md) @@ -86,7 +88,8 @@ ## Другие языки - English: [README.md](README.md) -- 简体中文: [README.zh-CN.md](README.zh-CN.md) -- 日本語: [README.ja.md](README.ja.md) -- Français: [README.fr.md](README.fr.md) +- 简体中文: [i18n/zh-CN/README.md](i18n/zh-CN/README.md) +- 日本語: [i18n/ja/README.md](i18n/ja/README.md) +- Français: [i18n/fr/README.md](i18n/fr/README.md) - Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md) +- Ελληνικά: [i18n/el/README.md](i18n/el/README.md) diff --git a/docs/README.vi.md b/docs/README.vi.md index 2932e7d3c..f7e1fea05 100644 --- a/docs/README.vi.md +++ b/docs/README.vi.md @@ -6,7 +6,7 @@ > Lưu ý: Tên lệnh, khóa cấu hình và đường dẫn API giữ nguyên tiếng Anh. Khi có sai khác, tài liệu tiếng Anh là bản gốc. Cây tài liệu tiếng Việt đầy đủ nằm tại [i18n/vi/](i18n/vi/README.md). -Hub bản địa hóa: [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [Русский](README.ru.md) · [Français](README.fr.md) · [Tiếng Việt](README.vi.md). +Hub bản địa hóa: [简体中文](i18n/zh-CN/README.md) · [日本語](i18n/ja/README.md) · [Русский](i18n/ru/README.md) · [Français](i18n/fr/README.md) · [Tiếng Việt](i18n/vi/README.md) · [Ελληνικά](i18n/el/README.md). ## Tra cứu nhanh @@ -90,7 +90,8 @@ Hub bản địa hóa: [简体中文](README.zh-CN.md) · [日本語](README.ja. ## Ngôn ngữ khác - English: [README.md](README.md) -- 简体中文: [README.zh-CN.md](README.zh-CN.md) -- 日本語: [README.ja.md](README.ja.md) -- Русский: [README.ru.md](README.ru.md) -- Français: [README.fr.md](README.fr.md) +- 简体中文: [i18n/zh-CN/README.md](i18n/zh-CN/README.md) +- 日本語: [i18n/ja/README.md](i18n/ja/README.md) +- Русский: [i18n/ru/README.md](i18n/ru/README.md) +- Français: [i18n/fr/README.md](i18n/fr/README.md) +- Ελληνικά: [i18n/el/README.md](i18n/el/README.md) diff --git a/docs/README.zh-CN.md b/docs/README.zh-CN.md index f4178eaa2..45fb7eeab 100644 --- a/docs/README.zh-CN.md +++ b/docs/README.zh-CN.md @@ -6,6 +6,8 @@ > 说明:命令、配置键、API 路径保持英文;实现细节以英文文档为准。 +本地化入口: [简体中文](i18n/zh-CN/README.md) · [日本語](i18n/ja/README.md) · [Русский](i18n/ru/README.md) · [Français](i18n/fr/README.md) · [Tiếng Việt](i18n/vi/README.md) · [Ελληνικά](i18n/el/README.md). + ## 快速入口 | 我想要… | 建议阅读 | @@ -24,24 +26,24 @@ ## 10 秒决策树(先看这个) -- 首次安装或快速启动 → [getting-started/README.md](getting-started/README.md) -- 需要精确命令或配置键 → [reference/README.md](reference/README.md) -- 需要部署与服务化运维 → [operations/README.md](operations/README.md) +- 首次安装或快速启动 → [getting-started/README.zh-CN.md](getting-started/README.zh-CN.md) +- 需要精确命令或配置键 → [reference/README.zh-CN.md](reference/README.zh-CN.md) +- 需要部署与服务化运维 → [operations/README.zh-CN.md](operations/README.zh-CN.md) - 遇到报错、异常或回归 → [troubleshooting.md](troubleshooting.md) -- 查看安全现状与路线图 → [security/README.md](security/README.md) -- 接入板卡与外设 → [hardware/README.md](hardware/README.md) -- 参与贡献、评审与 CI → [contributing/README.md](contributing/README.md) +- 查看安全现状与路线图 → [security/README.zh-CN.md](security/README.zh-CN.md) +- 接入板卡与外设 → [hardware/README.zh-CN.md](hardware/README.zh-CN.md) +- 参与贡献、评审与 CI → [contributing/README.zh-CN.md](contributing/README.zh-CN.md) - 查看完整文档地图 → [SUMMARY.md](SUMMARY.md) ## 按目录浏览(推荐) -- 入门文档: [getting-started/README.md](getting-started/README.md) -- 参考手册: [reference/README.md](reference/README.md) -- 运维与部署: [operations/README.md](operations/README.md) -- 安全文档: [security/README.md](security/README.md) -- 硬件与外设: [hardware/README.md](hardware/README.md) -- 贡献与 CI: [contributing/README.md](contributing/README.md) -- 项目快照: [project/README.md](project/README.md) +- 入门文档: [getting-started/README.zh-CN.md](getting-started/README.zh-CN.md) +- 参考手册: [reference/README.zh-CN.md](reference/README.zh-CN.md) +- 运维与部署: [operations/README.zh-CN.md](operations/README.zh-CN.md) +- 安全文档: [security/README.zh-CN.md](security/README.zh-CN.md) +- 硬件与外设: [hardware/README.zh-CN.md](hardware/README.zh-CN.md) +- 贡献与 CI: [contributing/README.zh-CN.md](contributing/README.zh-CN.md) +- 项目快照: [project/README.zh-CN.md](project/README.zh-CN.md) ## 按角色 @@ -69,7 +71,7 @@ > 说明:本分组内有 proposal/roadmap 文档,可能包含设想中的命令或配置。当前可执行行为请优先阅读 [config-reference.md](config-reference.md)、[operations-runbook.md](operations-runbook.md)、[troubleshooting.md](troubleshooting.md)。 -- [security/README.md](security/README.md) +- [security/README.zh-CN.md](security/README.zh-CN.md) - [agnostic-security.md](agnostic-security.md) - [frictionless-security.md](frictionless-security.md) - [sandboxing.md](sandboxing.md) @@ -86,7 +88,8 @@ ## 其他语言 - English: [README.md](README.md) -- 日本語: [README.ja.md](README.ja.md) -- Русский: [README.ru.md](README.ru.md) -- Français: [README.fr.md](README.fr.md) +- 日本語: [i18n/ja/README.md](i18n/ja/README.md) +- Русский: [i18n/ru/README.md](i18n/ru/README.md) +- Français: [i18n/fr/README.md](i18n/fr/README.md) - Tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md) +- Ελληνικά: [i18n/el/README.md](i18n/el/README.md) diff --git a/docs/SUMMARY.el.md b/docs/SUMMARY.el.md new file mode 100644 index 000000000..946760f69 --- /dev/null +++ b/docs/SUMMARY.el.md @@ -0,0 +1,76 @@ +# Σύνοψη τεκμηρίωσης ZeroClaw (Ενιαίος πίνακας περιεχομένων) + +Αυτό το αρχείο αποτελεί τον κανονικό (canonical) πίνακα περιεχομένων για το σύστημα τεκμηρίωσης. + +Τελευταία ενημέρωση: **18 Φεβρουαρίου 2026**. + +## Είσοδος ανά γλώσσα + +- Αγγλικό README: [../README.md](../README.md) +- Κινεζικό README: [../README.zh-CN.md](../README.zh-CN.md) +- Ιαπωνικό README: [../README.ja.md](../README.ja.md) +- Ρωσικό README: [../README.ru.md](../README.ru.md) +- Γαλλικό README: [../README.fr.md](../README.fr.md) +- Βιετναμικό README: [../README.vi.md](../README.vi.md) +- Ελληνικό README: [../README.el.md](../README.el.md) +- Αγγλικό Κέντρο Τεκμηρίωσης: [README.md](README.md) +- Κινεζικό Κέντρο Τεκμηρίωσης: [i18n/zh-CN/README.md](i18n/zh-CN/README.md) +- Ιαπωνικό Κέντρο Τεκμηρίωσης: [i18n/ja/README.md](i18n/ja/README.md) +- Ρωσικό Κέντρο Τεκμηρίωσης: [i18n/ru/README.md](i18n/ru/README.md) +- Γαλλικό Κέντρο Τεκμηρίωσης: [i18n/fr/README.md](i18n/fr/README.md) +- Βιετναμικό Κέντρο Τεκμηρίωσης: [i18n/vi/README.md](i18n/vi/README.md) +- Ελληνικό Κέντρο Τεκμηρίωσης: [i18n/el/README.md](i18n/el/README.md) +- Ευρετήριο εγγράφων i18n: [i18n/README.md](i18n/README.md) +- Χάρτης κάλυψης i18n: [i18n-coverage.md](i18n-coverage.md) + +## Συλλογές (στα Ελληνικά) + +### 1) Πρώτα βήματα + +- [i18n/el/one-click-bootstrap.md](i18n/el/one-click-bootstrap.md) + +### 2) Αναφορές εντολών/παραμέτρων και ενσωματώσεις + +- [i18n/el/commands-reference.md](i18n/el/commands-reference.md) +- [i18n/el/providers-reference.md](i18n/el/providers-reference.md) +- [i18n/el/channels-reference.md](i18n/el/channels-reference.md) +- [i18n/el/nextcloud-talk-setup.md](i18n/el/nextcloud-talk-setup.md) +- [i18n/el/config-reference.md](i18n/el/config-reference.md) +- [i18n/el/custom-providers.md](i18n/el/custom-providers.md) +- [i18n/el/zai-glm-setup.md](i18n/el/zai-glm-setup.md) +- [i18n/el/langgraph-integration.md](i18n/el/langgraph-integration.md) + +### 3) Λειτουργίες και ανάπτυξη (Operations & Deployment) + +- [i18n/el/operations-runbook.md](i18n/el/operations-runbook.md) +- [i18n/el/release-process.md](i18n/el/release-process.md) +- [i18n/el/troubleshooting.md](i18n/el/troubleshooting.md) +- [i18n/el/network-deployment.md](i18n/el/network-deployment.md) +- [i18n/el/mattermost-setup.md](i18n/el/mattermost-setup.md) + +### 4) Σχεδιασμός ασφαλείας και προτάσεις + +- [i18n/el/frictionless-security.md](i18n/el/frictionless-security.md) +- [i18n/el/sandboxing.md](i18n/el/sandboxing.md) +- [i18n/el/resource-limits.md](i18n/el/resource-limits.md) +- [i18n/el/security-roadmap.md](i18n/el/security-roadmap.md) + +### 5) Υλικό και περιφερειακά (Hardware & Peripherals) + +- [i18n/el/hardware-peripherals-design.md](i18n/el/hardware-peripherals-design.md) +- [i18n/el/nucleo-setup.md](i18n/el/nucleo-setup.md) + +### 6) Συνεισφορά και CI + +- [../CONTRIBUTING.el.md](../CONTRIBUTING.el.md) +- [i18n/el/pr-workflow.md](i18n/el/pr-workflow.md) +- [i18n/el/reviewer-playbook.md](i18n/el/reviewer-playbook.md) +- [i18n/el/ci-map.md](i18n/el/ci-map.md) + +### 7) Κατάσταση έργου και στιγμιότυπα + +- [i18n/el/project-triage-snapshot-2026-02-18.md](i18n/el/project-triage-snapshot-2026-02-18.md) +- [i18n/el/docs-inventory.md](i18n/el/docs-inventory.md) +- [i18n/el/cargo-slicer-speedup.md](i18n/el/cargo-slicer-speedup.md) +- [i18n/el/matrix-e2ee-guide.md](i18n/el/matrix-e2ee-guide.md) +- [i18n/el/doc-template.md](i18n/el/doc-template.md) diff --git a/docs/SUMMARY.fr.md b/docs/SUMMARY.fr.md index 925508d70..4613728eb 100644 --- a/docs/SUMMARY.fr.md +++ b/docs/SUMMARY.fr.md @@ -4,7 +4,7 @@ Ce fichier constitue la table des matières canonique du système de documentati > 📖 [English version](SUMMARY.md) -Dernière mise à jour : **18 février 2026**. +Dernière mise à jour : **24 février 2026**. ## Points d'entrée par langue @@ -15,75 +15,81 @@ Dernière mise à jour : **18 février 2026**. - README en russe : [../README.ru.md](../README.ru.md) - README en français : [../README.fr.md](../README.fr.md) - README en vietnamien : [../README.vi.md](../README.vi.md) +- README en grec : [../README.el.md](../README.el.md) - Documentation en anglais : [README.md](README.md) -- Documentation en chinois : [README.zh-CN.md](README.zh-CN.md) -- Documentation en japonais : [README.ja.md](README.ja.md) -- Documentation en russe : [README.ru.md](README.ru.md) -- Documentation en français : [README.fr.md](README.fr.md) +- Documentation en chinois : [i18n/zh-CN/README.md](i18n/zh-CN/README.md) +- Documentation en japonais : [i18n/ja/README.md](i18n/ja/README.md) +- Documentation en russe : [i18n/ru/README.md](i18n/ru/README.md) +- Documentation en français : [i18n/fr/README.md](i18n/fr/README.md) - Documentation en vietnamien : [i18n/vi/README.md](i18n/vi/README.md) -- Index de localisation : [i18n/README.md](i18n/README.md) -- Carte de couverture i18n : [i18n-coverage.md](i18n-coverage.md) +- Documentation en grec : [i18n/el/README.md](i18n/el/README.md) +- Index i18n : [i18n/README.md](i18n/README.md) +- Couverture i18n : [i18n-coverage.md](i18n-coverage.md) +- Guide i18n : [i18n-guide.md](i18n-guide.md) +- Suivi des écarts : [i18n-gap-backlog.md](i18n-gap-backlog.md) ## Catégories ### 1) Démarrage rapide -- [getting-started/README.md](getting-started/README.md) -- [one-click-bootstrap.md](one-click-bootstrap.md) +- [getting-started/README.fr.md](getting-started/README.fr.md) +- [i18n/fr/one-click-bootstrap.md](i18n/fr/one-click-bootstrap.md) +- [i18n/fr/android-setup.md](i18n/fr/android-setup.md) ### 2) Référence des commandes, configuration et intégrations -- [reference/README.md](reference/README.md) -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) -- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) -- [config-reference.md](config-reference.md) -- [custom-providers.md](custom-providers.md) -- [zai-glm-setup.md](zai-glm-setup.md) -- [langgraph-integration.md](langgraph-integration.md) +- [reference/README.fr.md](reference/README.fr.md) +- [i18n/fr/commands-reference.md](i18n/fr/commands-reference.md) +- [i18n/fr/providers-reference.md](i18n/fr/providers-reference.md) +- [i18n/fr/channels-reference.md](i18n/fr/channels-reference.md) +- [i18n/fr/config-reference.md](i18n/fr/config-reference.md) +- [i18n/fr/custom-providers.md](i18n/fr/custom-providers.md) +- [i18n/fr/zai-glm-setup.md](i18n/fr/zai-glm-setup.md) +- [i18n/fr/langgraph-integration.md](i18n/fr/langgraph-integration.md) +- [i18n/fr/proxy-agent-playbook.md](i18n/fr/proxy-agent-playbook.md) ### 3) Exploitation et déploiement -- [operations/README.md](operations/README.md) -- [operations-runbook.md](operations-runbook.md) -- [release-process.md](release-process.md) -- [troubleshooting.md](troubleshooting.md) -- [network-deployment.md](network-deployment.md) -- [mattermost-setup.md](mattermost-setup.md) +- [operations/README.fr.md](operations/README.fr.md) +- [i18n/fr/operations-runbook.md](i18n/fr/operations-runbook.md) +- [i18n/fr/release-process.md](i18n/fr/release-process.md) +- [i18n/fr/troubleshooting.md](i18n/fr/troubleshooting.md) +- [i18n/fr/network-deployment.md](i18n/fr/network-deployment.md) +- [i18n/fr/mattermost-setup.md](i18n/fr/mattermost-setup.md) +- [i18n/fr/nextcloud-talk-setup.md](i18n/fr/nextcloud-talk-setup.md) -### 4) Conception de la sécurité et propositions +### 4) Sécurité et gouvernance -- [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [resource-limits.md](resource-limits.md) -- [audit-logging.md](audit-logging.md) -- [security-roadmap.md](security-roadmap.md) +- [security/README.fr.md](security/README.fr.md) +- [i18n/fr/agnostic-security.md](i18n/fr/agnostic-security.md) +- [i18n/fr/frictionless-security.md](i18n/fr/frictionless-security.md) +- [i18n/fr/sandboxing.md](i18n/fr/sandboxing.md) +- [i18n/fr/resource-limits.md](i18n/fr/resource-limits.md) +- [i18n/fr/audit-logging.md](i18n/fr/audit-logging.md) +- [i18n/fr/audit-event-schema.md](i18n/fr/audit-event-schema.md) +- [i18n/fr/security-roadmap.md](i18n/fr/security-roadmap.md) ### 5) Matériel et périphériques -- [hardware/README.md](hardware/README.md) -- [hardware-peripherals-design.md](hardware-peripherals-design.md) -- [adding-boards-and-tools.md](adding-boards-and-tools.md) -- [nucleo-setup.md](nucleo-setup.md) -- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) -- [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) -- [datasheets/arduino-uno.md](datasheets/arduino-uno.md) -- [datasheets/esp32.md](datasheets/esp32.md) +- [hardware/README.fr.md](hardware/README.fr.md) +- [i18n/fr/hardware-peripherals-design.md](i18n/fr/hardware-peripherals-design.md) +- [i18n/fr/adding-boards-and-tools.md](i18n/fr/adding-boards-and-tools.md) +- [i18n/fr/nucleo-setup.md](i18n/fr/nucleo-setup.md) +- [i18n/fr/arduino-uno-q-setup.md](i18n/fr/arduino-uno-q-setup.md) +- [datasheets/README.md](datasheets/README.md) ### 6) Contribution et CI -- [contributing/README.md](contributing/README.md) +- [contributing/README.fr.md](contributing/README.fr.md) - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [i18n/fr/pr-workflow.md](i18n/fr/pr-workflow.md) +- [i18n/fr/reviewer-playbook.md](i18n/fr/reviewer-playbook.md) +- [i18n/fr/ci-map.md](i18n/fr/ci-map.md) +- [i18n/fr/actions-source-policy.md](i18n/fr/actions-source-policy.md) ### 7) État du projet et instantanés -- [project/README.md](project/README.md) -- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) -- [docs-inventory.md](docs-inventory.md) +- [project/README.fr.md](project/README.fr.md) +- [i18n/fr/project-triage-snapshot-2026-02-18.md](i18n/fr/project-triage-snapshot-2026-02-18.md) +- [i18n/fr/docs-audit-2026-02-24.md](i18n/fr/docs-audit-2026-02-24.md) +- [i18n/fr/docs-inventory.md](i18n/fr/docs-inventory.md) diff --git a/docs/SUMMARY.ja.md b/docs/SUMMARY.ja.md index 9fe533da1..b84b999b4 100644 --- a/docs/SUMMARY.ja.md +++ b/docs/SUMMARY.ja.md @@ -1,10 +1,10 @@ # ZeroClaw ドキュメント目次(統合目次) -このファイルはドキュメントシステムの正規の目次です。 +このファイルはドキュメントシステムの正規目次です。 > 📖 [English version](SUMMARY.md) -最終更新:**2026年2月18日**。 +最終更新:**2026年2月24日**。 ## 言語別入口 @@ -15,75 +15,81 @@ - ロシア語 README:[../README.ru.md](../README.ru.md) - フランス語 README:[../README.fr.md](../README.fr.md) - ベトナム語 README:[../README.vi.md](../README.vi.md) +- ギリシャ語 README:[../README.el.md](../README.el.md) - 英語ドキュメントハブ:[README.md](README.md) -- 中国語ドキュメントハブ:[README.zh-CN.md](README.zh-CN.md) -- 日本語ドキュメントハブ:[README.ja.md](README.ja.md) -- ロシア語ドキュメントハブ:[README.ru.md](README.ru.md) -- フランス語ドキュメントハブ:[README.fr.md](README.fr.md) +- 中国語ドキュメントハブ:[i18n/zh-CN/README.md](i18n/zh-CN/README.md) +- 日本語ドキュメントハブ:[i18n/ja/README.md](i18n/ja/README.md) +- ロシア語ドキュメントハブ:[i18n/ru/README.md](i18n/ru/README.md) +- フランス語ドキュメントハブ:[i18n/fr/README.md](i18n/fr/README.md) - ベトナム語ドキュメントハブ:[i18n/vi/README.md](i18n/vi/README.md) -- 国際化ドキュメント索引:[i18n/README.md](i18n/README.md) -- 国際化カバレッジマップ:[i18n-coverage.md](i18n-coverage.md) +- ギリシャ語ドキュメントハブ:[i18n/el/README.md](i18n/el/README.md) +- i18n 索引:[i18n/README.md](i18n/README.md) +- i18n カバレッジ:[i18n-coverage.md](i18n-coverage.md) +- i18n ガイド:[i18n-guide.md](i18n-guide.md) +- i18n ギャップ管理:[i18n-gap-backlog.md](i18n-gap-backlog.md) ## カテゴリ ### 1) はじめに -- [getting-started/README.md](getting-started/README.md) -- [one-click-bootstrap.md](one-click-bootstrap.md) +- [getting-started/README.ja.md](getting-started/README.ja.md) +- [i18n/ja/one-click-bootstrap.md](i18n/ja/one-click-bootstrap.md) +- [i18n/ja/android-setup.md](i18n/ja/android-setup.md) ### 2) コマンド・設定リファレンスと統合 -- [reference/README.md](reference/README.md) -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) -- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) -- [config-reference.md](config-reference.md) -- [custom-providers.md](custom-providers.md) -- [zai-glm-setup.md](zai-glm-setup.md) -- [langgraph-integration.md](langgraph-integration.md) +- [reference/README.ja.md](reference/README.ja.md) +- [i18n/ja/commands-reference.md](i18n/ja/commands-reference.md) +- [i18n/ja/providers-reference.md](i18n/ja/providers-reference.md) +- [i18n/ja/channels-reference.md](i18n/ja/channels-reference.md) +- [i18n/ja/config-reference.md](i18n/ja/config-reference.md) +- [i18n/ja/custom-providers.md](i18n/ja/custom-providers.md) +- [i18n/ja/zai-glm-setup.md](i18n/ja/zai-glm-setup.md) +- [i18n/ja/langgraph-integration.md](i18n/ja/langgraph-integration.md) +- [i18n/ja/proxy-agent-playbook.md](i18n/ja/proxy-agent-playbook.md) ### 3) 運用とデプロイ -- [operations/README.md](operations/README.md) -- [operations-runbook.md](operations-runbook.md) -- [release-process.md](release-process.md) -- [troubleshooting.md](troubleshooting.md) -- [network-deployment.md](network-deployment.md) -- [mattermost-setup.md](mattermost-setup.md) +- [operations/README.ja.md](operations/README.ja.md) +- [i18n/ja/operations-runbook.md](i18n/ja/operations-runbook.md) +- [i18n/ja/release-process.md](i18n/ja/release-process.md) +- [i18n/ja/troubleshooting.md](i18n/ja/troubleshooting.md) +- [i18n/ja/network-deployment.md](i18n/ja/network-deployment.md) +- [i18n/ja/mattermost-setup.md](i18n/ja/mattermost-setup.md) +- [i18n/ja/nextcloud-talk-setup.md](i18n/ja/nextcloud-talk-setup.md) -### 4) セキュリティ設計と提案 +### 4) セキュリティ設計と統制 -- [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [resource-limits.md](resource-limits.md) -- [audit-logging.md](audit-logging.md) -- [security-roadmap.md](security-roadmap.md) +- [security/README.ja.md](security/README.ja.md) +- [i18n/ja/agnostic-security.md](i18n/ja/agnostic-security.md) +- [i18n/ja/frictionless-security.md](i18n/ja/frictionless-security.md) +- [i18n/ja/sandboxing.md](i18n/ja/sandboxing.md) +- [i18n/ja/resource-limits.md](i18n/ja/resource-limits.md) +- [i18n/ja/audit-logging.md](i18n/ja/audit-logging.md) +- [i18n/ja/audit-event-schema.md](i18n/ja/audit-event-schema.md) +- [i18n/ja/security-roadmap.md](i18n/ja/security-roadmap.md) ### 5) ハードウェアと周辺機器 -- [hardware/README.md](hardware/README.md) -- [hardware-peripherals-design.md](hardware-peripherals-design.md) -- [adding-boards-and-tools.md](adding-boards-and-tools.md) -- [nucleo-setup.md](nucleo-setup.md) -- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) -- [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) -- [datasheets/arduino-uno.md](datasheets/arduino-uno.md) -- [datasheets/esp32.md](datasheets/esp32.md) +- [hardware/README.ja.md](hardware/README.ja.md) +- [i18n/ja/hardware-peripherals-design.md](i18n/ja/hardware-peripherals-design.md) +- [i18n/ja/adding-boards-and-tools.md](i18n/ja/adding-boards-and-tools.md) +- [i18n/ja/nucleo-setup.md](i18n/ja/nucleo-setup.md) +- [i18n/ja/arduino-uno-q-setup.md](i18n/ja/arduino-uno-q-setup.md) +- [datasheets/README.md](datasheets/README.md) ### 6) コントリビューションと CI -- [contributing/README.md](contributing/README.md) +- [contributing/README.ja.md](contributing/README.ja.md) - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [i18n/ja/pr-workflow.md](i18n/ja/pr-workflow.md) +- [i18n/ja/reviewer-playbook.md](i18n/ja/reviewer-playbook.md) +- [i18n/ja/ci-map.md](i18n/ja/ci-map.md) +- [i18n/ja/actions-source-policy.md](i18n/ja/actions-source-policy.md) ### 7) プロジェクト状況とスナップショット -- [project/README.md](project/README.md) -- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) -- [docs-inventory.md](docs-inventory.md) +- [project/README.ja.md](project/README.ja.md) +- [i18n/ja/project-triage-snapshot-2026-02-18.md](i18n/ja/project-triage-snapshot-2026-02-18.md) +- [i18n/ja/docs-audit-2026-02-24.md](i18n/ja/docs-audit-2026-02-24.md) +- [i18n/ja/docs-inventory.md](i18n/ja/docs-inventory.md) diff --git a/docs/SUMMARY.md b/docs/SUMMARY.md index 1f828256e..21d6de56a 100644 --- a/docs/SUMMARY.md +++ b/docs/SUMMARY.md @@ -13,14 +13,18 @@ Last refreshed: **February 18, 2026**. - Russian README: [../README.ru.md](../README.ru.md) - French README: [../README.fr.md](../README.fr.md) - Vietnamese README: [../README.vi.md](../README.vi.md) +- Greek README: [../README.el.md](../README.el.md) - English Docs Hub: [README.md](README.md) -- Chinese Docs Hub: [README.zh-CN.md](README.zh-CN.md) -- Japanese Docs Hub: [README.ja.md](README.ja.md) -- Russian Docs Hub: [README.ru.md](README.ru.md) -- French Docs Hub: [README.fr.md](README.fr.md) +- Chinese Docs Hub: [i18n/zh-CN/README.md](i18n/zh-CN/README.md) +- Japanese Docs Hub: [i18n/ja/README.md](i18n/ja/README.md) +- Russian Docs Hub: [i18n/ru/README.md](i18n/ru/README.md) +- French Docs Hub: [i18n/fr/README.md](i18n/fr/README.md) - Vietnamese Docs Hub: [i18n/vi/README.md](i18n/vi/README.md) +- Greek Docs Hub: [i18n/el/README.md](i18n/el/README.md) - i18n Docs Index: [i18n/README.md](i18n/README.md) - i18n Coverage Map: [i18n-coverage.md](i18n-coverage.md) +- i18n Completion Guide: [i18n-guide.md](i18n-guide.md) +- i18n Gap Backlog: [i18n-gap-backlog.md](i18n-gap-backlog.md) ## Collections @@ -29,6 +33,7 @@ Last refreshed: **February 18, 2026**. - [getting-started/README.md](getting-started/README.md) - [getting-started/macos-update-uninstall.md](getting-started/macos-update-uninstall.md) - [one-click-bootstrap.md](one-click-bootstrap.md) +- [android-setup.md](android-setup.md) ### 2) Command/Config References & Integrations @@ -41,11 +46,13 @@ Last refreshed: **February 18, 2026**. - [custom-providers.md](custom-providers.md) - [zai-glm-setup.md](zai-glm-setup.md) - [langgraph-integration.md](langgraph-integration.md) +- [proxy-agent-playbook.md](proxy-agent-playbook.md) ### 3) Operations & Deployment - [operations/README.md](operations/README.md) - [operations-runbook.md](operations-runbook.md) +- [operations/connectivity-probes-runbook.md](operations/connectivity-probes-runbook.md) - [release-process.md](release-process.md) - [troubleshooting.md](troubleshooting.md) - [network-deployment.md](network-deployment.md) @@ -59,6 +66,7 @@ Last refreshed: **February 18, 2026**. - [sandboxing.md](sandboxing.md) - [resource-limits.md](resource-limits.md) - [audit-logging.md](audit-logging.md) +- [audit-event-schema.md](audit-event-schema.md) - [security-roadmap.md](security-roadmap.md) ### 5) Hardware & Peripherals @@ -68,6 +76,7 @@ Last refreshed: **February 18, 2026**. - [adding-boards-and-tools.md](adding-boards-and-tools.md) - [nucleo-setup.md](nucleo-setup.md) - [arduino-uno-q-setup.md](arduino-uno-q-setup.md) +- [datasheets/README.md](datasheets/README.md) - [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) - [datasheets/arduino-uno.md](datasheets/arduino-uno.md) - [datasheets/esp32.md](datasheets/esp32.md) @@ -80,9 +89,20 @@ Last refreshed: **February 18, 2026**. - [reviewer-playbook.md](reviewer-playbook.md) - [ci-map.md](ci-map.md) - [actions-source-policy.md](actions-source-policy.md) +- [cargo-slicer-speedup.md](cargo-slicer-speedup.md) -### 7) Project Status & Snapshot +### 7) SOP Runtime & Procedures + +- [sop/README.md](sop/README.md) +- [sop/connectivity.md](sop/connectivity.md) +- [sop/syntax.md](sop/syntax.md) +- [sop/observability.md](sop/observability.md) +- [sop/cookbook.md](sop/cookbook.md) + +### 8) Project Status & Snapshot - [project/README.md](project/README.md) - [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) +- [docs-audit-2026-02-24.md](docs-audit-2026-02-24.md) +- [i18n-gap-backlog.md](i18n-gap-backlog.md) - [docs-inventory.md](docs-inventory.md) diff --git a/docs/SUMMARY.ru.md b/docs/SUMMARY.ru.md index c8ef697eb..306ff0670 100644 --- a/docs/SUMMARY.ru.md +++ b/docs/SUMMARY.ru.md @@ -4,7 +4,7 @@ > 📖 [English version](SUMMARY.md) -Последнее обновление: **18 февраля 2026 г.** +Последнее обновление: **24 февраля 2026 г.** ## Языковые точки входа @@ -15,75 +15,81 @@ - README на русском: [../README.ru.md](../README.ru.md) - README на французском: [../README.fr.md](../README.fr.md) - README на вьетнамском: [../README.vi.md](../README.vi.md) +- README на греческом: [../README.el.md](../README.el.md) - Документация на английском: [README.md](README.md) -- Документация на китайском: [README.zh-CN.md](README.zh-CN.md) -- Документация на японском: [README.ja.md](README.ja.md) -- Документация на русском: [README.ru.md](README.ru.md) -- Документация на французском: [README.fr.md](README.fr.md) +- Документация на китайском: [i18n/zh-CN/README.md](i18n/zh-CN/README.md) +- Документация на японском: [i18n/ja/README.md](i18n/ja/README.md) +- Документация на русском: [i18n/ru/README.md](i18n/ru/README.md) +- Документация на французском: [i18n/fr/README.md](i18n/fr/README.md) - Документация на вьетнамском: [i18n/vi/README.md](i18n/vi/README.md) -- Индекс локализации: [i18n/README.md](i18n/README.md) -- Карта покрытия локализации: [i18n-coverage.md](i18n-coverage.md) +- Документация на греческом: [i18n/el/README.md](i18n/el/README.md) +- Индекс i18n: [i18n/README.md](i18n/README.md) +- Карта покрытия i18n: [i18n-coverage.md](i18n-coverage.md) +- Гайд i18n: [i18n-guide.md](i18n-guide.md) +- Трекинг gap: [i18n-gap-backlog.md](i18n-gap-backlog.md) ## Разделы ### 1) Начало работы -- [getting-started/README.md](getting-started/README.md) -- [one-click-bootstrap.md](one-click-bootstrap.md) +- [getting-started/README.ru.md](getting-started/README.ru.md) +- [i18n/ru/one-click-bootstrap.md](i18n/ru/one-click-bootstrap.md) +- [i18n/ru/android-setup.md](i18n/ru/android-setup.md) ### 2) Справочник команд, конфигурации и интеграций -- [reference/README.md](reference/README.md) -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) -- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) -- [config-reference.md](config-reference.md) -- [custom-providers.md](custom-providers.md) -- [zai-glm-setup.md](zai-glm-setup.md) -- [langgraph-integration.md](langgraph-integration.md) +- [reference/README.ru.md](reference/README.ru.md) +- [i18n/ru/commands-reference.md](i18n/ru/commands-reference.md) +- [i18n/ru/providers-reference.md](i18n/ru/providers-reference.md) +- [i18n/ru/channels-reference.md](i18n/ru/channels-reference.md) +- [i18n/ru/config-reference.md](i18n/ru/config-reference.md) +- [i18n/ru/custom-providers.md](i18n/ru/custom-providers.md) +- [i18n/ru/zai-glm-setup.md](i18n/ru/zai-glm-setup.md) +- [i18n/ru/langgraph-integration.md](i18n/ru/langgraph-integration.md) +- [i18n/ru/proxy-agent-playbook.md](i18n/ru/proxy-agent-playbook.md) ### 3) Эксплуатация и развёртывание -- [operations/README.md](operations/README.md) -- [operations-runbook.md](operations-runbook.md) -- [release-process.md](release-process.md) -- [troubleshooting.md](troubleshooting.md) -- [network-deployment.md](network-deployment.md) -- [mattermost-setup.md](mattermost-setup.md) +- [operations/README.ru.md](operations/README.ru.md) +- [i18n/ru/operations-runbook.md](i18n/ru/operations-runbook.md) +- [i18n/ru/release-process.md](i18n/ru/release-process.md) +- [i18n/ru/troubleshooting.md](i18n/ru/troubleshooting.md) +- [i18n/ru/network-deployment.md](i18n/ru/network-deployment.md) +- [i18n/ru/mattermost-setup.md](i18n/ru/mattermost-setup.md) +- [i18n/ru/nextcloud-talk-setup.md](i18n/ru/nextcloud-talk-setup.md) -### 4) Проектирование безопасности и предложения +### 4) Безопасность и управление -- [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [resource-limits.md](resource-limits.md) -- [audit-logging.md](audit-logging.md) -- [security-roadmap.md](security-roadmap.md) +- [security/README.ru.md](security/README.ru.md) +- [i18n/ru/agnostic-security.md](i18n/ru/agnostic-security.md) +- [i18n/ru/frictionless-security.md](i18n/ru/frictionless-security.md) +- [i18n/ru/sandboxing.md](i18n/ru/sandboxing.md) +- [i18n/ru/resource-limits.md](i18n/ru/resource-limits.md) +- [i18n/ru/audit-logging.md](i18n/ru/audit-logging.md) +- [i18n/ru/audit-event-schema.md](i18n/ru/audit-event-schema.md) +- [i18n/ru/security-roadmap.md](i18n/ru/security-roadmap.md) ### 5) Оборудование и периферия -- [hardware/README.md](hardware/README.md) -- [hardware-peripherals-design.md](hardware-peripherals-design.md) -- [adding-boards-and-tools.md](adding-boards-and-tools.md) -- [nucleo-setup.md](nucleo-setup.md) -- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) -- [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) -- [datasheets/arduino-uno.md](datasheets/arduino-uno.md) -- [datasheets/esp32.md](datasheets/esp32.md) +- [hardware/README.ru.md](hardware/README.ru.md) +- [i18n/ru/hardware-peripherals-design.md](i18n/ru/hardware-peripherals-design.md) +- [i18n/ru/adding-boards-and-tools.md](i18n/ru/adding-boards-and-tools.md) +- [i18n/ru/nucleo-setup.md](i18n/ru/nucleo-setup.md) +- [i18n/ru/arduino-uno-q-setup.md](i18n/ru/arduino-uno-q-setup.md) +- [datasheets/README.md](datasheets/README.md) ### 6) Участие в проекте и CI -- [contributing/README.md](contributing/README.md) +- [contributing/README.ru.md](contributing/README.ru.md) - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [i18n/ru/pr-workflow.md](i18n/ru/pr-workflow.md) +- [i18n/ru/reviewer-playbook.md](i18n/ru/reviewer-playbook.md) +- [i18n/ru/ci-map.md](i18n/ru/ci-map.md) +- [i18n/ru/actions-source-policy.md](i18n/ru/actions-source-policy.md) ### 7) Состояние проекта и снимки -- [project/README.md](project/README.md) -- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) -- [docs-inventory.md](docs-inventory.md) +- [project/README.ru.md](project/README.ru.md) +- [i18n/ru/project-triage-snapshot-2026-02-18.md](i18n/ru/project-triage-snapshot-2026-02-18.md) +- [i18n/ru/docs-audit-2026-02-24.md](i18n/ru/docs-audit-2026-02-24.md) +- [i18n/ru/docs-inventory.md](i18n/ru/docs-inventory.md) diff --git a/docs/SUMMARY.vi.md b/docs/SUMMARY.vi.md new file mode 100644 index 000000000..655fe0449 --- /dev/null +++ b/docs/SUMMARY.vi.md @@ -0,0 +1,95 @@ +# Tóm tắt tài liệu ZeroClaw (Mục lục hợp nhất) + +Tệp này là mục lục chuẩn của hệ thống tài liệu. + +> 📖 [English version](SUMMARY.md) + +Cập nhật lần cuối: **24 tháng 2, 2026**. + +## Điểm vào theo ngôn ngữ + +- Bản đồ cấu trúc docs (ngôn ngữ/phần/chức năng): [structure/README.md](structure/README.md) +- README tiếng Anh: [../README.md](../README.md) +- README tiếng Trung: [../README.zh-CN.md](../README.zh-CN.md) +- README tiếng Nhật: [../README.ja.md](../README.ja.md) +- README tiếng Nga: [../README.ru.md](../README.ru.md) +- README tiếng Pháp: [../README.fr.md](../README.fr.md) +- README tiếng Việt: [../README.vi.md](../README.vi.md) +- README tiếng Hy Lạp: [../README.el.md](../README.el.md) +- Hub docs tiếng Anh: [README.md](README.md) +- Hub docs tiếng Trung: [i18n/zh-CN/README.md](i18n/zh-CN/README.md) +- Hub docs tiếng Nhật: [i18n/ja/README.md](i18n/ja/README.md) +- Hub docs tiếng Nga: [i18n/ru/README.md](i18n/ru/README.md) +- Hub docs tiếng Pháp: [i18n/fr/README.md](i18n/fr/README.md) +- Hub docs tiếng Việt: [i18n/vi/README.md](i18n/vi/README.md) +- Hub docs tiếng Hy Lạp: [i18n/el/README.md](i18n/el/README.md) +- Chỉ mục i18n: [i18n/README.md](i18n/README.md) +- Bản đồ coverage i18n: [i18n-coverage.md](i18n-coverage.md) +- Hướng dẫn i18n: [i18n-guide.md](i18n-guide.md) +- Theo dõi gap i18n: [i18n-gap-backlog.md](i18n-gap-backlog.md) + +## Danh mục + +### 1) Bắt đầu nhanh + +- [getting-started/README.vi.md](getting-started/README.vi.md) +- [i18n/vi/one-click-bootstrap.md](i18n/vi/one-click-bootstrap.md) +- [i18n/vi/android-setup.md](i18n/vi/android-setup.md) + +### 2) Tham chiếu lệnh/cấu hình và tích hợp + +- [reference/README.vi.md](reference/README.vi.md) +- [i18n/vi/commands-reference.md](i18n/vi/commands-reference.md) +- [i18n/vi/providers-reference.md](i18n/vi/providers-reference.md) +- [i18n/vi/channels-reference.md](i18n/vi/channels-reference.md) +- [i18n/vi/config-reference.md](i18n/vi/config-reference.md) +- [i18n/vi/custom-providers.md](i18n/vi/custom-providers.md) +- [i18n/vi/zai-glm-setup.md](i18n/vi/zai-glm-setup.md) +- [i18n/vi/langgraph-integration.md](i18n/vi/langgraph-integration.md) +- [i18n/vi/proxy-agent-playbook.md](i18n/vi/proxy-agent-playbook.md) + +### 3) Vận hành và triển khai + +- [operations/README.vi.md](operations/README.vi.md) +- [i18n/vi/operations-runbook.md](i18n/vi/operations-runbook.md) +- [i18n/vi/release-process.md](i18n/vi/release-process.md) +- [i18n/vi/troubleshooting.md](i18n/vi/troubleshooting.md) +- [i18n/vi/network-deployment.md](i18n/vi/network-deployment.md) +- [i18n/vi/mattermost-setup.md](i18n/vi/mattermost-setup.md) +- [i18n/vi/nextcloud-talk-setup.md](i18n/vi/nextcloud-talk-setup.md) + +### 4) Bảo mật và quản trị + +- [security/README.vi.md](security/README.vi.md) +- [i18n/vi/agnostic-security.md](i18n/vi/agnostic-security.md) +- [i18n/vi/frictionless-security.md](i18n/vi/frictionless-security.md) +- [i18n/vi/sandboxing.md](i18n/vi/sandboxing.md) +- [i18n/vi/resource-limits.md](i18n/vi/resource-limits.md) +- [i18n/vi/audit-logging.md](i18n/vi/audit-logging.md) +- [i18n/vi/audit-event-schema.md](i18n/vi/audit-event-schema.md) +- [i18n/vi/security-roadmap.md](i18n/vi/security-roadmap.md) + +### 5) Phần cứng và ngoại vi + +- [hardware/README.vi.md](hardware/README.vi.md) +- [i18n/vi/hardware-peripherals-design.md](i18n/vi/hardware-peripherals-design.md) +- [i18n/vi/adding-boards-and-tools.md](i18n/vi/adding-boards-and-tools.md) +- [i18n/vi/nucleo-setup.md](i18n/vi/nucleo-setup.md) +- [i18n/vi/arduino-uno-q-setup.md](i18n/vi/arduino-uno-q-setup.md) +- [datasheets/README.md](datasheets/README.md) + +### 6) Đóng góp và CI + +- [contributing/README.vi.md](contributing/README.vi.md) +- [../CONTRIBUTING.md](../CONTRIBUTING.md) +- [i18n/vi/pr-workflow.md](i18n/vi/pr-workflow.md) +- [i18n/vi/reviewer-playbook.md](i18n/vi/reviewer-playbook.md) +- [i18n/vi/ci-map.md](i18n/vi/ci-map.md) +- [i18n/vi/actions-source-policy.md](i18n/vi/actions-source-policy.md) + +### 7) Trạng thái dự án và ảnh chụp + +- [project/README.vi.md](project/README.vi.md) +- [i18n/vi/project-triage-snapshot-2026-02-18.md](i18n/vi/project-triage-snapshot-2026-02-18.md) +- [i18n/vi/docs-audit-2026-02-24.md](i18n/vi/docs-audit-2026-02-24.md) +- [i18n/vi/docs-inventory.md](i18n/vi/docs-inventory.md) diff --git a/docs/SUMMARY.zh-CN.md b/docs/SUMMARY.zh-CN.md index dda5b19f9..dbb46ea92 100644 --- a/docs/SUMMARY.zh-CN.md +++ b/docs/SUMMARY.zh-CN.md @@ -4,7 +4,7 @@ > 📖 [English version](SUMMARY.md) -最后更新:**2026年2月18日**。 +最后更新:**2026年2月24日**。 ## 语言入口 @@ -15,75 +15,81 @@ - 俄文 README:[../README.ru.md](../README.ru.md) - 法文 README:[../README.fr.md](../README.fr.md) - 越南文 README:[../README.vi.md](../README.vi.md) +- 希腊文 README:[../README.el.md](../README.el.md) - 英文文档中心:[README.md](README.md) -- 中文文档中心:[README.zh-CN.md](README.zh-CN.md) -- 日文文档中心:[README.ja.md](README.ja.md) -- 俄文文档中心:[README.ru.md](README.ru.md) -- 法文文档中心:[README.fr.md](README.fr.md) +- 中文文档中心:[i18n/zh-CN/README.md](i18n/zh-CN/README.md) +- 日文文档中心:[i18n/ja/README.md](i18n/ja/README.md) +- 俄文文档中心:[i18n/ru/README.md](i18n/ru/README.md) +- 法文文档中心:[i18n/fr/README.md](i18n/fr/README.md) - 越南文文档中心:[i18n/vi/README.md](i18n/vi/README.md) +- 希腊文文档中心:[i18n/el/README.md](i18n/el/README.md) - 国际化文档索引:[i18n/README.md](i18n/README.md) - 国际化覆盖图:[i18n-coverage.md](i18n-coverage.md) +- 国际化执行指南:[i18n-guide.md](i18n-guide.md) +- 国际化缺口追踪:[i18n-gap-backlog.md](i18n-gap-backlog.md) ## 分类 ### 1) 快速入门 -- [getting-started/README.md](getting-started/README.md) -- [one-click-bootstrap.md](one-click-bootstrap.md) +- [getting-started/README.zh-CN.md](getting-started/README.zh-CN.md) +- [i18n/zh-CN/one-click-bootstrap.md](i18n/zh-CN/one-click-bootstrap.md) +- [i18n/zh-CN/android-setup.md](i18n/zh-CN/android-setup.md) ### 2) 命令 / 配置参考与集成 -- [reference/README.md](reference/README.md) -- [commands-reference.md](commands-reference.md) -- [providers-reference.md](providers-reference.md) -- [channels-reference.md](channels-reference.md) -- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) -- [config-reference.md](config-reference.md) -- [custom-providers.md](custom-providers.md) -- [zai-glm-setup.md](zai-glm-setup.md) -- [langgraph-integration.md](langgraph-integration.md) +- [reference/README.zh-CN.md](reference/README.zh-CN.md) +- [i18n/zh-CN/commands-reference.md](i18n/zh-CN/commands-reference.md) +- [i18n/zh-CN/providers-reference.md](i18n/zh-CN/providers-reference.md) +- [i18n/zh-CN/channels-reference.md](i18n/zh-CN/channels-reference.md) +- [i18n/zh-CN/config-reference.md](i18n/zh-CN/config-reference.md) +- [i18n/zh-CN/custom-providers.md](i18n/zh-CN/custom-providers.md) +- [i18n/zh-CN/zai-glm-setup.md](i18n/zh-CN/zai-glm-setup.md) +- [i18n/zh-CN/langgraph-integration.md](i18n/zh-CN/langgraph-integration.md) +- [i18n/zh-CN/proxy-agent-playbook.md](i18n/zh-CN/proxy-agent-playbook.md) ### 3) 运维与部署 -- [operations/README.md](operations/README.md) -- [operations-runbook.md](operations-runbook.md) -- [release-process.md](release-process.md) -- [troubleshooting.md](troubleshooting.md) -- [network-deployment.md](network-deployment.md) -- [mattermost-setup.md](mattermost-setup.md) +- [operations/README.zh-CN.md](operations/README.zh-CN.md) +- [i18n/zh-CN/operations-runbook.md](i18n/zh-CN/operations-runbook.md) +- [i18n/zh-CN/release-process.md](i18n/zh-CN/release-process.md) +- [i18n/zh-CN/troubleshooting.md](i18n/zh-CN/troubleshooting.md) +- [i18n/zh-CN/network-deployment.md](i18n/zh-CN/network-deployment.md) +- [i18n/zh-CN/mattermost-setup.md](i18n/zh-CN/mattermost-setup.md) +- [i18n/zh-CN/nextcloud-talk-setup.md](i18n/zh-CN/nextcloud-talk-setup.md) -### 4) 安全设计与提案 +### 4) 安全设计与治理 -- [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [resource-limits.md](resource-limits.md) -- [audit-logging.md](audit-logging.md) -- [security-roadmap.md](security-roadmap.md) +- [security/README.zh-CN.md](security/README.zh-CN.md) +- [i18n/zh-CN/agnostic-security.md](i18n/zh-CN/agnostic-security.md) +- [i18n/zh-CN/frictionless-security.md](i18n/zh-CN/frictionless-security.md) +- [i18n/zh-CN/sandboxing.md](i18n/zh-CN/sandboxing.md) +- [i18n/zh-CN/resource-limits.md](i18n/zh-CN/resource-limits.md) +- [i18n/zh-CN/audit-logging.md](i18n/zh-CN/audit-logging.md) +- [i18n/zh-CN/audit-event-schema.md](i18n/zh-CN/audit-event-schema.md) +- [i18n/zh-CN/security-roadmap.md](i18n/zh-CN/security-roadmap.md) ### 5) 硬件与外设 -- [hardware/README.md](hardware/README.md) -- [hardware-peripherals-design.md](hardware-peripherals-design.md) -- [adding-boards-and-tools.md](adding-boards-and-tools.md) -- [nucleo-setup.md](nucleo-setup.md) -- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) -- [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) -- [datasheets/arduino-uno.md](datasheets/arduino-uno.md) -- [datasheets/esp32.md](datasheets/esp32.md) +- [hardware/README.zh-CN.md](hardware/README.zh-CN.md) +- [i18n/zh-CN/hardware-peripherals-design.md](i18n/zh-CN/hardware-peripherals-design.md) +- [i18n/zh-CN/adding-boards-and-tools.md](i18n/zh-CN/adding-boards-and-tools.md) +- [i18n/zh-CN/nucleo-setup.md](i18n/zh-CN/nucleo-setup.md) +- [i18n/zh-CN/arduino-uno-q-setup.md](i18n/zh-CN/arduino-uno-q-setup.md) +- [datasheets/README.md](datasheets/README.md) ### 6) 贡献与 CI -- [contributing/README.md](contributing/README.md) +- [contributing/README.zh-CN.md](contributing/README.zh-CN.md) - [../CONTRIBUTING.md](../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) +- [i18n/zh-CN/pr-workflow.md](i18n/zh-CN/pr-workflow.md) +- [i18n/zh-CN/reviewer-playbook.md](i18n/zh-CN/reviewer-playbook.md) +- [i18n/zh-CN/ci-map.md](i18n/zh-CN/ci-map.md) +- [i18n/zh-CN/actions-source-policy.md](i18n/zh-CN/actions-source-policy.md) ### 7) 项目状态与快照 -- [project/README.md](project/README.md) -- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) -- [docs-inventory.md](docs-inventory.md) +- [project/README.zh-CN.md](project/README.zh-CN.md) +- [i18n/zh-CN/project-triage-snapshot-2026-02-18.md](i18n/zh-CN/project-triage-snapshot-2026-02-18.md) +- [i18n/zh-CN/docs-audit-2026-02-24.md](i18n/zh-CN/docs-audit-2026-02-24.md) +- [i18n/zh-CN/docs-inventory.md](i18n/zh-CN/docs-inventory.md) diff --git a/docs/contributing/README.el.md b/docs/contributing/README.el.md new file mode 100644 index 000000000..745034441 --- /dev/null +++ b/docs/contributing/README.el.md @@ -0,0 +1,25 @@ +# Contributing/CI (Ελληνικά) + +Αυτή η σελίδα είναι το τοπικοποιημένο σημείο εισόδου για contribution και CI. + +Αγγλικό πρωτότυπο: + +- [README.md](README.md) + +## Key Links + +- [../i18n/el/README.md](../i18n/el/README.md) +- [../i18n/el/SUMMARY.md](../i18n/el/SUMMARY.md) +- [../i18n/el/docs-inventory.md](../i18n/el/docs-inventory.md) + +## Σχετικά τοπικοποιημένα σημεία εισόδου + +- [../i18n/el/commands-reference.md](../i18n/el/commands-reference.md) +- [../i18n/el/config-reference.md](../i18n/el/config-reference.md) +- [../i18n/el/operations-runbook.md](../i18n/el/operations-runbook.md) +- [../i18n/el/troubleshooting.md](../i18n/el/troubleshooting.md) + +## Κανόνες + +- Τα ονόματα εντολών, config keys, API paths και code identifiers παραμένουν στα αγγλικά. +- Η τελική συμπεριφορά ορίζεται από το αγγλικό πρωτότυπο. diff --git a/docs/contributing/README.fr.md b/docs/contributing/README.fr.md new file mode 100644 index 000000000..66886fc31 --- /dev/null +++ b/docs/contributing/README.fr.md @@ -0,0 +1,25 @@ +# Contributing/CI (Français) + +Cette page est l'entrée localisée pour la catégorie contribution et CI. + +Source anglaise: + +- [README.md](README.md) + +## Key Links + +- [../i18n/fr/README.md](../i18n/fr/README.md) +- [../i18n/fr/SUMMARY.md](../i18n/fr/SUMMARY.md) +- [../i18n/fr/docs-inventory.md](../i18n/fr/docs-inventory.md) + +## Entrées localisées liées + +- [../i18n/fr/commands-reference.md](../i18n/fr/commands-reference.md) +- [../i18n/fr/config-reference.md](../i18n/fr/config-reference.md) +- [../i18n/fr/operations-runbook.md](../i18n/fr/operations-runbook.md) +- [../i18n/fr/troubleshooting.md](../i18n/fr/troubleshooting.md) + +## Règles de localisation + +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- La définition finale du comportement est la source anglaise. diff --git a/docs/contributing/README.ja.md b/docs/contributing/README.ja.md new file mode 100644 index 000000000..469de254d --- /dev/null +++ b/docs/contributing/README.ja.md @@ -0,0 +1,25 @@ +# Contributing/CI(日本語) + +このページはコントリビュートカテゴリのローカライズ入口です. + +英語版原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ja/README.md](../i18n/ja/README.md) +- [../i18n/ja/SUMMARY.md](../i18n/ja/SUMMARY.md) +- [../i18n/ja/docs-inventory.md](../i18n/ja/docs-inventory.md) + +## 関連するローカライズ入口 + +- [../i18n/ja/commands-reference.md](../i18n/ja/commands-reference.md) +- [../i18n/ja/config-reference.md](../i18n/ja/config-reference.md) +- [../i18n/ja/operations-runbook.md](../i18n/ja/operations-runbook.md) +- [../i18n/ja/troubleshooting.md](../i18n/ja/troubleshooting.md) + +## 運用ルール + +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します. +- 実装仕様と挙動の最終定義は英語版原文を優先します. diff --git a/docs/contributing/README.ru.md b/docs/contributing/README.ru.md new file mode 100644 index 000000000..bc24b0211 --- /dev/null +++ b/docs/contributing/README.ru.md @@ -0,0 +1,25 @@ +# Contributing/CI (Русский) + +Эта страница — локализованный вход в раздел contribution и CI. + +Английский оригинал: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ru/README.md](../i18n/ru/README.md) +- [../i18n/ru/SUMMARY.md](../i18n/ru/SUMMARY.md) +- [../i18n/ru/docs-inventory.md](../i18n/ru/docs-inventory.md) + +## Связанные локализованные входы + +- [../i18n/ru/commands-reference.md](../i18n/ru/commands-reference.md) +- [../i18n/ru/config-reference.md](../i18n/ru/config-reference.md) +- [../i18n/ru/operations-runbook.md](../i18n/ru/operations-runbook.md) +- [../i18n/ru/troubleshooting.md](../i18n/ru/troubleshooting.md) + +## Правила локализации + +- Имена команд, ключей конфигурации, API-пути и code identifiers остаются на английском. +- Финальная спецификация поведения определяется английским оригиналом. diff --git a/docs/contributing/README.vi.md b/docs/contributing/README.vi.md new file mode 100644 index 000000000..9790bb927 --- /dev/null +++ b/docs/contributing/README.vi.md @@ -0,0 +1,25 @@ +# Contributing/CI (Tiếng Việt) + +Trang này là điểm vào bản địa hóa cho nhóm tài liệu đóng góp và CI. + +Nguồn tiếng Anh: + +- [README.md](README.md) + +## Key Links + +- [../i18n/vi/README.md](../i18n/vi/README.md) +- [../i18n/vi/SUMMARY.md](../i18n/vi/SUMMARY.md) +- [../i18n/vi/docs-inventory.md](../i18n/vi/docs-inventory.md) + +## Điểm vào bản địa hóa liên quan + +- [../i18n/vi/commands-reference.md](../i18n/vi/commands-reference.md) +- [../i18n/vi/config-reference.md](../i18n/vi/config-reference.md) +- [../i18n/vi/operations-runbook.md](../i18n/vi/operations-runbook.md) +- [../i18n/vi/troubleshooting.md](../i18n/vi/troubleshooting.md) + +## Quy tắc + +- Tên lệnh, config key, API path và code identifier giữ nguyên tiếng Anh. +- Hành vi thực thi cuối cùng theo tài liệu tiếng Anh. diff --git a/docs/contributing/README.zh-CN.md b/docs/contributing/README.zh-CN.md new file mode 100644 index 000000000..b4876ef23 --- /dev/null +++ b/docs/contributing/README.zh-CN.md @@ -0,0 +1,25 @@ +# 贡献与 CI(简体中文) + +该页面是贡献流程分类索引的本地化入口. + +英文原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/zh-CN/README.md](../i18n/zh-CN/README.md) +- [../i18n/zh-CN/SUMMARY.md](../i18n/zh-CN/SUMMARY.md) +- [../i18n/zh-CN/docs-inventory.md](../i18n/zh-CN/docs-inventory.md) + +## 相关本地化入口 + +- [../i18n/zh-CN/commands-reference.md](../i18n/zh-CN/commands-reference.md) +- [../i18n/zh-CN/config-reference.md](../i18n/zh-CN/config-reference.md) +- [../i18n/zh-CN/operations-runbook.md](../i18n/zh-CN/operations-runbook.md) +- [../i18n/zh-CN/troubleshooting.md](../i18n/zh-CN/troubleshooting.md) + +## 规则 + +- 命令名、配置键、API 路径与代码标识保持英文. +- 具体实现行为以英文原文为准. diff --git a/docs/datasheets/README.md b/docs/datasheets/README.md new file mode 100644 index 000000000..e331bcbf2 --- /dev/null +++ b/docs/datasheets/README.md @@ -0,0 +1,14 @@ +# Hardware Datasheets Index + +Board-level reference sheets for supported hardware. + +## Available Datasheets + +- [nucleo-f401re.md](nucleo-f401re.md) — STM32 Nucleo-F401RE +- [arduino-uno.md](arduino-uno.md) — Arduino Uno +- [esp32.md](esp32.md) — ESP32 + +## Related + +- Hardware collection: [../hardware/README.md](../hardware/README.md) +- Add boards and tools: [../adding-boards-and-tools.md](../adding-boards-and-tools.md) diff --git a/docs/docs-audit-2026-02-24.md b/docs/docs-audit-2026-02-24.md new file mode 100644 index 000000000..a52a2c7b4 --- /dev/null +++ b/docs/docs-audit-2026-02-24.md @@ -0,0 +1,99 @@ +# Documentation Audit Snapshot (2026-02-24) + +This snapshot records a deep documentation audit focused on completeness, navigation clarity, and i18n structure. + +Date: **2026-02-24** +Scope: repository docs (`docs/**`) + root README locale entry points. + +## 1) Audit Method + +- Ran structural inventory over all markdown docs. +- Checked README presence for doc directories. +- Checked relative-link integrity across all docs markdown files. +- Reviewed canonical vs compatibility locale path usage. +- Reviewed TOC/inventory/structure-map consistency. + +## 2) Findings + +### A. Structural clarity gaps + +- Canonical locale trees existed under `docs/i18n//`, but some governance docs still described older hub layout. +- `docs/vi/**` compatibility tree coexisted with `docs/i18n/vi/**`, creating maintenance ambiguity. +- `datasheets` directories lacked explicit index files (`README.md`), reducing discoverability. + +### B. Completeness gaps + +- Several operational/reference docs were not clearly surfaced in inventory/summary pathways (for example `audit-event-schema`, `proxy-agent-playbook`, `cargo-slicer-speedup`, `sop/*`, `operations/connectivity-probes-runbook`). +- Locale coverage status existed, but there was no explicit time-bound audit snapshot documenting current gaps and priorities. + +### C. Integrity issues + +- Link check found broken relative links: + - `docs/i18n/el/cargo-slicer-speedup.md` -> workflow path depth issue + - `docs/vi/README.md` -> missing `SUMMARY.md` in compatibility path + - `docs/vi/reference/README.md` -> missing `../SUMMARY.md` + +## 3) Remediation Applied + +### 3.1 Navigation and governance + +- Added and linked i18n completion contract in previous phase: `docs/i18n-guide.md`. +- Refreshed structure map with canonical layers and compatibility boundaries: `docs/structure/README.md`. +- Refreshed inventory to include canonical locale hubs, SOP, CI/security references, and audit snapshot: `docs/docs-inventory.md`. + +### 3.2 Directory completeness + +Added missing datasheet indexes: + +- `docs/datasheets/README.md` +- `docs/i18n/vi/datasheets/README.md` +- `docs/i18n/el/datasheets/README.md` +- `docs/vi/datasheets/README.md` (compatibility redirect) + +### 3.3 Compatibility cleanup + +- Converted `docs/vi/README.md` to an explicit compatibility hub pointing to canonical `docs/i18n/vi/**`. +- Converted `docs/vi/reference/README.md` to canonical redirect. + +### 3.4 Broken link fixes + +- Fixed Greek CI workflow relative link path. +- Eliminated compatibility README broken links by redirecting to canonical paths. + +## 4) Current Known Remaining Gaps + +These are structural/content-depth gaps, not integrity failures: + +1. Locale depth asymmetry +- `vi`/`el` have full localized trees. +- `zh-CN`/`ja`/`ru`/`fr` currently provide hub-level scaffolds rather than full runtime-contract localization. + +2. Compatibility shim lifecycle +- `docs/vi/**` still exists for backward links; long-term plan should define whether to keep or fully deprecate this mirror. + +3. Localized propagation of new governance docs +- New governance docs (for example this audit snapshot and i18n guide) are currently authored in English-first flow; localized summaries are not yet fully propagated. + +## 5) Recommended Next Wave + +1. Add locale-level mini-inventory pages under `docs/i18n/{zh-CN,ja,ru,fr}/` to make hub scaffolds more actionable. +2. Define and document a formal deprecation policy for `docs/vi/**` compatibility paths. +3. Add a lightweight automated docs index consistency check in CI (summary/inventory cross-link sanity). + +## 6) Validation Status + +- Relative-link existence check: passed after fixes. +- `git diff --check`: clean. + +This snapshot is immutable context for the 2026-02-24 docs restructuring pass. + +## Addendum (Phase-2 Deep Completion) + +After the initial restructuring pass, a second completion wave was applied in the same date scope: + +- Added localized bridge coverage so `docs/i18n/vi/` and `docs/i18n/el/` reach full top-level docs parity (against `docs/*.md` baseline). +- Added explicit i18n gap backlog tracker: [i18n-gap-backlog.md](i18n-gap-backlog.md). +- Added localized references for i18n governance docs (`i18n-guide`, `i18n-coverage`) and latest docs audit snapshot under `vi` and `el`. +- Updated localized hubs and summaries (`docs/i18n/vi/*`, `docs/i18n/el/*`) to expose newly added docs and governance links. + +Current depth asymmetry remains for `zh-CN` / `ja` / `ru` / `fr` by design (hub-level scaffolds), now explicitly tracked with counts and wave plans in the backlog. diff --git a/docs/docs-inventory.md b/docs/docs-inventory.md index 539f2305e..7287c8974 100644 --- a/docs/docs-inventory.md +++ b/docs/docs-inventory.md @@ -1,17 +1,20 @@ # ZeroClaw Documentation Inventory -This inventory classifies docs by intent so readers can quickly distinguish runtime-contract guides from design proposals. +This inventory classifies documentation by intent and canonical location. -Last reviewed: **February 18, 2026**. +Last reviewed: **February 24, 2026**. ## Classification Legend - **Current Guide/Reference**: intended to match current runtime behavior -- **Policy/Process**: collaboration or governance rules -- **Proposal/Roadmap**: design exploration; may include hypothetical commands -- **Snapshot**: time-bound operational report +- **Policy/Process**: contribution or governance contract +- **Proposal/Roadmap**: exploratory or planned behavior +- **Snapshot/Audit**: time-bound status and gap analysis +- **Compatibility Shim**: path preserved for backward navigation -## Documentation Entry Points +## Entry Points + +### Product root | Doc | Type | Audience | |---|---|---| @@ -19,16 +22,35 @@ Last reviewed: **February 18, 2026**. | `README.zh-CN.md` | Current Guide (localized) | Chinese readers | | `README.ja.md` | Current Guide (localized) | Japanese readers | | `README.ru.md` | Current Guide (localized) | Russian readers | +| `README.fr.md` | Current Guide (localized) | French readers | | `README.vi.md` | Current Guide (localized) | Vietnamese readers | -| `docs/README.md` | Current Guide (hub) | all readers | -| `docs/README.zh-CN.md` | Current Guide (localized hub) | Chinese readers | -| `docs/README.ja.md` | Current Guide (localized hub) | Japanese readers | -| `docs/README.ru.md` | Current Guide (localized hub) | Russian readers | -| `docs/README.vi.md` | Current Guide (localized hub) | Vietnamese readers | -| `docs/SUMMARY.md` | Current Guide (unified TOC) | all readers | -| `docs/structure/README.md` | Current Guide (structure map) | all readers | +| `README.el.md` | Current Guide (localized) | Greek readers | -## Collection Index Docs +### Docs system + +| Doc | Type | Audience | +|---|---|---| +| `docs/README.md` | Current Guide (hub) | all readers | +| `docs/SUMMARY.md` | Current Guide (unified TOC) | all readers | +| `docs/structure/README.md` | Current Guide (structure map) | maintainers | +| `docs/i18n-guide.md` | Current Guide (i18n completion contract) | contributors/agents | +| `docs/i18n/README.md` | Current Guide (locale index) | maintainers/translators | +| `docs/i18n-coverage.md` | Current Guide (coverage matrix) | maintainers/translators | + +## Locale Hubs (Canonical) + +| Locale | Canonical hub | Type | +|---|---|---| +| `zh-CN` | `docs/i18n/zh-CN/README.md` | Current Guide (localized hub scaffold) | +| `ja` | `docs/i18n/ja/README.md` | Current Guide (localized hub scaffold) | +| `ru` | `docs/i18n/ru/README.md` | Current Guide (localized hub scaffold) | +| `fr` | `docs/i18n/fr/README.md` | Current Guide (localized hub scaffold) | +| `vi` | `docs/i18n/vi/README.md` | Current Guide (full localized tree) | +| `el` | `docs/i18n/el/README.md` | Current Guide (full localized tree) | + +Compatibility shims such as `docs/README..md`, `docs/SUMMARY..md`, and `docs/vi/**` remain valid but are non-canonical. + +## Collection Index Docs (English canonical) | Doc | Type | Audience | |---|---|---| @@ -39,31 +61,38 @@ Last reviewed: **February 18, 2026**. | `docs/hardware/README.md` | Current Guide | hardware builders | | `docs/contributing/README.md` | Current Guide | contributors/reviewers | | `docs/project/README.md` | Current Guide | maintainers | +| `docs/sop/README.md` | Current Guide | operators/automation maintainers | ## Current Guides & References | Doc | Type | Audience | |---|---|---| | `docs/one-click-bootstrap.md` | Current Guide | users/operators | +| `docs/android-setup.md` | Current Guide | Android users/operators | | `docs/commands-reference.md` | Current Reference | users/operators | | `docs/providers-reference.md` | Current Reference | users/operators | | `docs/channels-reference.md` | Current Reference | users/operators | -| `docs/nextcloud-talk-setup.md` | Current Guide | operators | | `docs/config-reference.md` | Current Reference | operators | | `docs/custom-providers.md` | Current Integration Guide | integration developers | | `docs/zai-glm-setup.md` | Current Provider Setup Guide | users/operators | | `docs/langgraph-integration.md` | Current Integration Guide | integration developers | +| `docs/proxy-agent-playbook.md` | Current Operations Playbook | operators/maintainers | | `docs/operations-runbook.md` | Current Guide | operators | +| `docs/operations/connectivity-probes-runbook.md` | Current CI/ops Runbook | maintainers/operators | | `docs/troubleshooting.md` | Current Guide | users/operators | | `docs/network-deployment.md` | Current Guide | operators | | `docs/mattermost-setup.md` | Current Guide | operators | +| `docs/nextcloud-talk-setup.md` | Current Guide | operators | +| `docs/cargo-slicer-speedup.md` | Current Build/CI Guide | maintainers | | `docs/adding-boards-and-tools.md` | Current Guide | hardware builders | | `docs/arduino-uno-q-setup.md` | Current Guide | hardware builders | | `docs/nucleo-setup.md` | Current Guide | hardware builders | | `docs/hardware-peripherals-design.md` | Current Design Spec | hardware contributors | +| `docs/datasheets/README.md` | Current Hardware Index | hardware builders | | `docs/datasheets/nucleo-f401re.md` | Current Hardware Reference | hardware builders | | `docs/datasheets/arduino-uno.md` | Current Hardware Reference | hardware builders | | `docs/datasheets/esp32.md` | Current Hardware Reference | hardware builders | +| `docs/audit-event-schema.md` | Current CI/Security Reference | maintainers/security reviewers | ## Policy / Process Docs @@ -87,18 +116,18 @@ These are valuable context, but **not strict runtime contracts**. | `docs/frictionless-security.md` | Proposal | | `docs/security-roadmap.md` | Roadmap | -## Snapshot Docs +## Snapshot / Audit Docs | Doc | Type | |---|---| | `docs/project-triage-snapshot-2026-02-18.md` | Snapshot | +| `docs/docs-audit-2026-02-24.md` | Snapshot (docs architecture audit) | +| `docs/i18n-gap-backlog.md` | Snapshot (i18n depth gap tracking) | -## Maintenance Recommendations +## Maintenance Contract -1. Update `commands-reference` whenever CLI surface changes. -2. Update `providers-reference` when provider catalog/aliases/env vars change. -3. Update `channels-reference` when channel support or allowlist semantics change. -4. Keep snapshots date-stamped and immutable. -5. Mark proposal docs clearly to avoid being mistaken for runtime contracts. -6. Keep localized README/docs-hub links aligned when adding new core docs. -7. Update `docs/SUMMARY.md` and collection indexes whenever new major docs are added. +1. Update `docs/SUMMARY.md` and nearest category index when adding a major doc. +2. Keep locale navigation parity across all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`, `el`). +3. Use `docs/i18n-guide.md` whenever docs IA/shared wording changes. +4. Keep canonical localized hubs under `docs/i18n//`; treat shim paths as compatibility only. +5. Keep snapshots date-stamped and immutable; add newer snapshots instead of rewriting historical ones. diff --git a/docs/getting-started/README.el.md b/docs/getting-started/README.el.md new file mode 100644 index 000000000..441f437c6 --- /dev/null +++ b/docs/getting-started/README.el.md @@ -0,0 +1,25 @@ +# Getting Started (Ελληνικά) + +Αυτή η σελίδα είναι το τοπικοποιημένο σημείο εισόδου για τα έγγραφα έναρξης. + +Αγγλικό πρωτότυπο: + +- [README.md](README.md) + +## Key Links + +- [../i18n/el/README.md](../i18n/el/README.md) +- [../i18n/el/SUMMARY.md](../i18n/el/SUMMARY.md) +- [../i18n/el/docs-inventory.md](../i18n/el/docs-inventory.md) + +## Σχετικά τοπικοποιημένα σημεία εισόδου + +- [../i18n/el/commands-reference.md](../i18n/el/commands-reference.md) +- [../i18n/el/config-reference.md](../i18n/el/config-reference.md) +- [../i18n/el/operations-runbook.md](../i18n/el/operations-runbook.md) +- [../i18n/el/troubleshooting.md](../i18n/el/troubleshooting.md) + +## Κανόνες + +- Τα ονόματα εντολών, config keys, API paths και code identifiers παραμένουν στα αγγλικά. +- Η τελική συμπεριφορά ορίζεται από το αγγλικό πρωτότυπο. diff --git a/docs/getting-started/README.fr.md b/docs/getting-started/README.fr.md new file mode 100644 index 000000000..8403eb75c --- /dev/null +++ b/docs/getting-started/README.fr.md @@ -0,0 +1,25 @@ +# Getting Started (Français) + +Cette page est l'entrée localisée pour la catégorie de démarrage. + +Source anglaise: + +- [README.md](README.md) + +## Key Links + +- [../i18n/fr/README.md](../i18n/fr/README.md) +- [../i18n/fr/SUMMARY.md](../i18n/fr/SUMMARY.md) +- [../i18n/fr/docs-inventory.md](../i18n/fr/docs-inventory.md) + +## Entrées localisées liées + +- [../i18n/fr/commands-reference.md](../i18n/fr/commands-reference.md) +- [../i18n/fr/config-reference.md](../i18n/fr/config-reference.md) +- [../i18n/fr/operations-runbook.md](../i18n/fr/operations-runbook.md) +- [../i18n/fr/troubleshooting.md](../i18n/fr/troubleshooting.md) + +## Règles de localisation + +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- La définition finale du comportement est la source anglaise. diff --git a/docs/getting-started/README.ja.md b/docs/getting-started/README.ja.md new file mode 100644 index 000000000..716731b31 --- /dev/null +++ b/docs/getting-started/README.ja.md @@ -0,0 +1,25 @@ +# Getting Started(日本語) + +このページは入門カテゴリのローカライズ入口です. + +英語版原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ja/README.md](../i18n/ja/README.md) +- [../i18n/ja/SUMMARY.md](../i18n/ja/SUMMARY.md) +- [../i18n/ja/docs-inventory.md](../i18n/ja/docs-inventory.md) + +## 関連するローカライズ入口 + +- [../i18n/ja/commands-reference.md](../i18n/ja/commands-reference.md) +- [../i18n/ja/config-reference.md](../i18n/ja/config-reference.md) +- [../i18n/ja/operations-runbook.md](../i18n/ja/operations-runbook.md) +- [../i18n/ja/troubleshooting.md](../i18n/ja/troubleshooting.md) + +## 運用ルール + +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します. +- 実装仕様と挙動の最終定義は英語版原文を優先します. diff --git a/docs/getting-started/README.md b/docs/getting-started/README.md index 8495427d3..da808e2ef 100644 --- a/docs/getting-started/README.md +++ b/docs/getting-started/README.md @@ -7,7 +7,8 @@ For first-time setup and quick orientation. 1. Main overview and quick start: [../../README.md](../../README.md) 2. One-click setup and dual bootstrap mode: [../one-click-bootstrap.md](../one-click-bootstrap.md) 3. Update or uninstall on macOS: [macos-update-uninstall.md](macos-update-uninstall.md) -4. Find commands by tasks: [../commands-reference.md](../commands-reference.md) +4. Set up on Android (Termux/ADB): [../android-setup.md](../android-setup.md) +5. Find commands by tasks: [../commands-reference.md](../commands-reference.md) ## Choose Your Path @@ -32,3 +33,4 @@ For first-time setup and quick orientation. - Runtime operations: [../operations/README.md](../operations/README.md) - Reference catalogs: [../reference/README.md](../reference/README.md) - macOS lifecycle tasks: [macos-update-uninstall.md](macos-update-uninstall.md) +- Android setup path: [../android-setup.md](../android-setup.md) diff --git a/docs/getting-started/README.ru.md b/docs/getting-started/README.ru.md new file mode 100644 index 000000000..b41a469d1 --- /dev/null +++ b/docs/getting-started/README.ru.md @@ -0,0 +1,25 @@ +# Getting Started (Русский) + +Эта страница — локализованный вход в раздел первичного запуска. + +Английский оригинал: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ru/README.md](../i18n/ru/README.md) +- [../i18n/ru/SUMMARY.md](../i18n/ru/SUMMARY.md) +- [../i18n/ru/docs-inventory.md](../i18n/ru/docs-inventory.md) + +## Связанные локализованные входы + +- [../i18n/ru/commands-reference.md](../i18n/ru/commands-reference.md) +- [../i18n/ru/config-reference.md](../i18n/ru/config-reference.md) +- [../i18n/ru/operations-runbook.md](../i18n/ru/operations-runbook.md) +- [../i18n/ru/troubleshooting.md](../i18n/ru/troubleshooting.md) + +## Правила локализации + +- Имена команд, ключей конфигурации, API-пути и code identifiers остаются на английском. +- Финальная спецификация поведения определяется английским оригиналом. diff --git a/docs/getting-started/README.zh-CN.md b/docs/getting-started/README.zh-CN.md new file mode 100644 index 000000000..91d04661e --- /dev/null +++ b/docs/getting-started/README.zh-CN.md @@ -0,0 +1,25 @@ +# 入门文档(简体中文) + +该页面是入门分类索引的本地化入口. + +英文原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/zh-CN/README.md](../i18n/zh-CN/README.md) +- [../i18n/zh-CN/SUMMARY.md](../i18n/zh-CN/SUMMARY.md) +- [../i18n/zh-CN/docs-inventory.md](../i18n/zh-CN/docs-inventory.md) + +## 相关本地化入口 + +- [../i18n/zh-CN/commands-reference.md](../i18n/zh-CN/commands-reference.md) +- [../i18n/zh-CN/config-reference.md](../i18n/zh-CN/config-reference.md) +- [../i18n/zh-CN/operations-runbook.md](../i18n/zh-CN/operations-runbook.md) +- [../i18n/zh-CN/troubleshooting.md](../i18n/zh-CN/troubleshooting.md) + +## 规则 + +- 命令名、配置键、API 路径与代码标识保持英文. +- 具体实现行为以英文原文为准. diff --git a/docs/hardware/README.el.md b/docs/hardware/README.el.md new file mode 100644 index 000000000..87b3fee02 --- /dev/null +++ b/docs/hardware/README.el.md @@ -0,0 +1,25 @@ +# Hardware (Ελληνικά) + +Αυτή η σελίδα είναι το τοπικοποιημένο σημείο εισόδου για τα έγγραφα υλικού. + +Αγγλικό πρωτότυπο: + +- [README.md](README.md) + +## Key Links + +- [../i18n/el/README.md](../i18n/el/README.md) +- [../i18n/el/SUMMARY.md](../i18n/el/SUMMARY.md) +- [../i18n/el/docs-inventory.md](../i18n/el/docs-inventory.md) + +## Σχετικά τοπικοποιημένα σημεία εισόδου + +- [../i18n/el/commands-reference.md](../i18n/el/commands-reference.md) +- [../i18n/el/config-reference.md](../i18n/el/config-reference.md) +- [../i18n/el/operations-runbook.md](../i18n/el/operations-runbook.md) +- [../i18n/el/troubleshooting.md](../i18n/el/troubleshooting.md) + +## Κανόνες + +- Τα ονόματα εντολών, config keys, API paths και code identifiers παραμένουν στα αγγλικά. +- Η τελική συμπεριφορά ορίζεται από το αγγλικό πρωτότυπο. diff --git a/docs/hardware/README.fr.md b/docs/hardware/README.fr.md new file mode 100644 index 000000000..f4e9c89ac --- /dev/null +++ b/docs/hardware/README.fr.md @@ -0,0 +1,25 @@ +# Hardware (Français) + +Cette page est l'entrée localisée pour la catégorie matériel. + +Source anglaise: + +- [README.md](README.md) + +## Key Links + +- [../i18n/fr/README.md](../i18n/fr/README.md) +- [../i18n/fr/SUMMARY.md](../i18n/fr/SUMMARY.md) +- [../i18n/fr/docs-inventory.md](../i18n/fr/docs-inventory.md) + +## Entrées localisées liées + +- [../i18n/fr/commands-reference.md](../i18n/fr/commands-reference.md) +- [../i18n/fr/config-reference.md](../i18n/fr/config-reference.md) +- [../i18n/fr/operations-runbook.md](../i18n/fr/operations-runbook.md) +- [../i18n/fr/troubleshooting.md](../i18n/fr/troubleshooting.md) + +## Règles de localisation + +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- La définition finale du comportement est la source anglaise. diff --git a/docs/hardware/README.ja.md b/docs/hardware/README.ja.md new file mode 100644 index 000000000..efb13fbec --- /dev/null +++ b/docs/hardware/README.ja.md @@ -0,0 +1,25 @@ +# Hardware(日本語) + +このページはハードウェアカテゴリのローカライズ入口です. + +英語版原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ja/README.md](../i18n/ja/README.md) +- [../i18n/ja/SUMMARY.md](../i18n/ja/SUMMARY.md) +- [../i18n/ja/docs-inventory.md](../i18n/ja/docs-inventory.md) + +## 関連するローカライズ入口 + +- [../i18n/ja/commands-reference.md](../i18n/ja/commands-reference.md) +- [../i18n/ja/config-reference.md](../i18n/ja/config-reference.md) +- [../i18n/ja/operations-runbook.md](../i18n/ja/operations-runbook.md) +- [../i18n/ja/troubleshooting.md](../i18n/ja/troubleshooting.md) + +## 運用ルール + +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します. +- 実装仕様と挙動の最終定義は英語版原文を優先します. diff --git a/docs/hardware/README.md b/docs/hardware/README.md index ca0a62a41..d42e26dcd 100644 --- a/docs/hardware/README.md +++ b/docs/hardware/README.md @@ -13,7 +13,7 @@ ZeroClaw's hardware subsystem enables direct control of microcontrollers and per ## Datasheets -- Datasheet index: [../datasheets](../datasheets) +- Datasheet index: [../datasheets/README.md](../datasheets/README.md) - STM32 Nucleo-F401RE: [../datasheets/nucleo-f401re.md](../datasheets/nucleo-f401re.md) - Arduino Uno: [../datasheets/arduino-uno.md](../datasheets/arduino-uno.md) - ESP32: [../datasheets/esp32.md](../datasheets/esp32.md) diff --git a/docs/hardware/README.ru.md b/docs/hardware/README.ru.md new file mode 100644 index 000000000..d3988b873 --- /dev/null +++ b/docs/hardware/README.ru.md @@ -0,0 +1,25 @@ +# Hardware (Русский) + +Эта страница — локализованный вход в раздел аппаратной части. + +Английский оригинал: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ru/README.md](../i18n/ru/README.md) +- [../i18n/ru/SUMMARY.md](../i18n/ru/SUMMARY.md) +- [../i18n/ru/docs-inventory.md](../i18n/ru/docs-inventory.md) + +## Связанные локализованные входы + +- [../i18n/ru/commands-reference.md](../i18n/ru/commands-reference.md) +- [../i18n/ru/config-reference.md](../i18n/ru/config-reference.md) +- [../i18n/ru/operations-runbook.md](../i18n/ru/operations-runbook.md) +- [../i18n/ru/troubleshooting.md](../i18n/ru/troubleshooting.md) + +## Правила локализации + +- Имена команд, ключей конфигурации, API-пути и code identifiers остаются на английском. +- Финальная спецификация поведения определяется английским оригиналом. diff --git a/docs/hardware/README.vi.md b/docs/hardware/README.vi.md new file mode 100644 index 000000000..a03e3f59c --- /dev/null +++ b/docs/hardware/README.vi.md @@ -0,0 +1,25 @@ +# Hardware (Tiếng Việt) + +Trang này là điểm vào bản địa hóa cho nhóm tài liệu phần cứng. + +Nguồn tiếng Anh: + +- [README.md](README.md) + +## Key Links + +- [../i18n/vi/README.md](../i18n/vi/README.md) +- [../i18n/vi/SUMMARY.md](../i18n/vi/SUMMARY.md) +- [../i18n/vi/docs-inventory.md](../i18n/vi/docs-inventory.md) + +## Điểm vào bản địa hóa liên quan + +- [../i18n/vi/commands-reference.md](../i18n/vi/commands-reference.md) +- [../i18n/vi/config-reference.md](../i18n/vi/config-reference.md) +- [../i18n/vi/operations-runbook.md](../i18n/vi/operations-runbook.md) +- [../i18n/vi/troubleshooting.md](../i18n/vi/troubleshooting.md) + +## Quy tắc + +- Tên lệnh, config key, API path và code identifier giữ nguyên tiếng Anh. +- Hành vi thực thi cuối cùng theo tài liệu tiếng Anh. diff --git a/docs/hardware/README.zh-CN.md b/docs/hardware/README.zh-CN.md new file mode 100644 index 000000000..4518f3c0b --- /dev/null +++ b/docs/hardware/README.zh-CN.md @@ -0,0 +1,25 @@ +# 硬件与外设(简体中文) + +该页面是硬件分类索引的本地化入口. + +英文原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/zh-CN/README.md](../i18n/zh-CN/README.md) +- [../i18n/zh-CN/SUMMARY.md](../i18n/zh-CN/SUMMARY.md) +- [../i18n/zh-CN/docs-inventory.md](../i18n/zh-CN/docs-inventory.md) + +## 相关本地化入口 + +- [../i18n/zh-CN/commands-reference.md](../i18n/zh-CN/commands-reference.md) +- [../i18n/zh-CN/config-reference.md](../i18n/zh-CN/config-reference.md) +- [../i18n/zh-CN/operations-runbook.md](../i18n/zh-CN/operations-runbook.md) +- [../i18n/zh-CN/troubleshooting.md](../i18n/zh-CN/troubleshooting.md) + +## 规则 + +- 命令名、配置键、API 路径与代码标识保持英文. +- 具体实现行为以英文原文为准. diff --git a/docs/i18n-coverage.md b/docs/i18n-coverage.md index ecbfede43..ee53a37ce 100644 --- a/docs/i18n-coverage.md +++ b/docs/i18n-coverage.md @@ -2,7 +2,10 @@ This document defines the localization structure for ZeroClaw docs and tracks current coverage. -Last refreshed: **February 21, 2026**. +Last refreshed: **February 24, 2026**. + +Execution guide: [i18n-guide.md](i18n-guide.md) +Gap backlog: [i18n-gap-backlog.md](i18n-gap-backlog.md) ## Canonical Layout @@ -21,11 +24,38 @@ Use these i18n paths: | Locale | Root README | Canonical Docs Hub | Commands Ref | Config Ref | Troubleshooting | Status | |---|---|---|---|---|---|---| | `en` | `README.md` | `docs/README.md` | `docs/commands-reference.md` | `docs/config-reference.md` | `docs/troubleshooting.md` | Source of truth | -| `zh-CN` | `README.zh-CN.md` | `docs/README.zh-CN.md` | - | - | - | Hub-level localized | -| `ja` | `README.ja.md` | `docs/README.ja.md` | - | - | - | Hub-level localized | -| `ru` | `README.ru.md` | `docs/README.ru.md` | - | - | - | Hub-level localized | -| `fr` | `README.fr.md` | `docs/README.fr.md` | - | - | - | Hub-level localized | +| `zh-CN` | `README.zh-CN.md` | `docs/i18n/zh-CN/README.md` | `docs/i18n/zh-CN/commands-reference.md` | `docs/i18n/zh-CN/config-reference.md` | `docs/i18n/zh-CN/troubleshooting.md` | Full top-level parity (bridge + localized) | +| `ja` | `README.ja.md` | `docs/i18n/ja/README.md` | `docs/i18n/ja/commands-reference.md` | `docs/i18n/ja/config-reference.md` | `docs/i18n/ja/troubleshooting.md` | Full top-level parity (bridge + localized) | +| `ru` | `README.ru.md` | `docs/i18n/ru/README.md` | `docs/i18n/ru/commands-reference.md` | `docs/i18n/ru/config-reference.md` | `docs/i18n/ru/troubleshooting.md` | Full top-level parity (bridge + localized) | +| `fr` | `README.fr.md` | `docs/i18n/fr/README.md` | `docs/i18n/fr/commands-reference.md` | `docs/i18n/fr/config-reference.md` | `docs/i18n/fr/troubleshooting.md` | Full top-level parity (bridge + localized) | | `vi` | `README.vi.md` | `docs/i18n/vi/README.md` | `docs/i18n/vi/commands-reference.md` | `docs/i18n/vi/config-reference.md` | `docs/i18n/vi/troubleshooting.md` | Full tree localized | +| `el` | `README.el.md` | `docs/i18n/el/README.md` | `docs/i18n/el/commands-reference.md` | `docs/i18n/el/config-reference.md` | `docs/i18n/el/troubleshooting.md` | Full tree localized | + +## Top-Level Parity Snapshot + +Baseline on 2026-02-24 uses 40 top-level English docs (`docs/*.md`, locale root variants excluded). + +| Locale | Missing top-level parity count | +|---|---:| +| `zh-CN` | 0 | +| `ja` | 0 | +| `ru` | 0 | +| `fr` | 0 | +| `vi` | 0 | +| `el` | 0 | + +## Narrative Depth Snapshot + +As of 2026-02-24: + +| Locale | Enhanced bridge pages | Notes | +|---|---:|---| +| `zh-CN` | 33 | Bridge pages include topic positioning + source section map + execution hints | +| `ja` | 33 | Bridge pages include topic positioning + source section map + execution hints | +| `ru` | 33 | Bridge pages include topic positioning + source section map + execution hints | +| `fr` | 33 | Bridge pages include topic positioning + source section map + execution hints | +| `vi` | N/A | Existing localization style kept as full localized tree | +| `el` | N/A | Existing localization style kept as full localized tree | ## Root README Completeness @@ -39,12 +69,25 @@ Not all root READMEs are full translations of `README.md`: | `ru` | Hub-style entry point | ~26% | | `fr` | Near-complete translation | ~90% | | `vi` | Near-complete translation | ~90% | +| `el` | Near-complete translation | ~90% | Hub-style entry points provide quick-start orientation and language navigation but do not replicate the full English README content. This is an accurate status record, not a gap to be immediately resolved. +For `zh-CN`, `ja`, `ru`, and `fr`, canonical i18n directory hubs now include full top-level parity coverage and continue linking docs-root compatibility shims during migration. + ## Collection Index i18n -Localized `README.md` files under collection directories (`docs/getting-started/`, `docs/reference/`, `docs/operations/`, `docs/security/`, `docs/hardware/`, `docs/contributing/`, `docs/project/`) currently exist only for English and Vietnamese. Collection index localization for other locales is deferred. +Localized category index files now exist for all supported locales under: + +- `docs/getting-started/README..md` +- `docs/reference/README..md` +- `docs/operations/README..md` +- `docs/security/README..md` +- `docs/hardware/README..md` +- `docs/contributing/README..md` +- `docs/project/README..md` + +This closes collection-index localization parity for supported locales. ## Localization Rules @@ -56,6 +99,7 @@ Localized `README.md` files under collection directories (`docs/getting-started/ - Prefer concise, operator-oriented localization over literal translation. - Update "Last refreshed" / "Last synchronized" dates when localized pages change. - Ensure every localized hub has an "Other languages" section. +- Follow [i18n-guide.md](i18n-guide.md) for mandatory completion and deferral policy. ## Adding a New Locale diff --git a/docs/i18n-gap-backlog.md b/docs/i18n-gap-backlog.md new file mode 100644 index 000000000..e6704cf25 --- /dev/null +++ b/docs/i18n-gap-backlog.md @@ -0,0 +1,51 @@ +# i18n Gap Backlog + +This file tracks localization parity gaps and closure state. + +Last updated: **2026-02-24**. + +## Baseline Definition + +Gap baseline = top-level English docs set under `docs/*.md` (excluding README/SUMMARY locale variants and legacy `*.vi.md` shims) compared against `docs/i18n//`. + +## Current Gap Counts + +| Locale | Missing top-level docs parity count | Current status | +|---|---:|---| +| `zh-CN` | 0 | Full top-level parity (bridge + localized) | +| `ja` | 0 | Full top-level parity (bridge + localized) | +| `ru` | 0 | Full top-level parity (bridge + localized) | +| `fr` | 0 | Full top-level parity (bridge + localized) | +| `vi` | 0 | Full top-level parity | +| `el` | 0 | Full top-level parity | + +## Closure Record (2026-02-24) + +Completed in this PR stream: + +- Wave 1 runtime localization for `zh-CN`/`ja`/`ru`/`fr`: + - `commands-reference.md` + - `providers-reference.md` + - `channels-reference.md` + - `config-reference.md` + - `operations-runbook.md` + - `troubleshooting.md` +- Full closure for remaining top-level docs in `zh-CN`/`ja`/`ru`/`fr` via localized bridge pages. +- Full top-level parity already maintained for `vi` and `el`. + +## Remaining Gaps (Baseline Scope) + +- None. Top-level baseline gaps are closed for all supported locales. + +## Optional Next Depth + +These are not baseline blockers, but can be advanced in future waves: + +- fuller narrative translation depth for the 33 enhanced bridge pages in each of `zh-CN`/`ja`/`ru`/`fr` +- locale-specific examples (commands/config snippets) where operational behavior differs by provider/channel environment + +## Tracking Rules + +1. Keep this file date-stamped and append major closure checkpoints. +2. If new top-level English docs are added, re-run parity count and update this file in the same PR. +3. Keep locale navigation parity complete when adding/removing locales. diff --git a/docs/i18n-guide.md b/docs/i18n-guide.md new file mode 100644 index 000000000..2d39170c9 --- /dev/null +++ b/docs/i18n-guide.md @@ -0,0 +1,118 @@ +# ZeroClaw i18n Completion Guide + +This guide defines how to keep multilingual documentation complete and consistent when docs change. + +## Scope + +Use this guide when a PR touches any user-facing docs navigation, shared docs wording, runtime-contract references, or top-level docs governance. + +Primary docs surfaces: + +- Root READMEs: `README.md`, `README..md` +- Docs hubs: `docs/README.md`, `docs/i18n//README.md` +- Unified TOC: `docs/SUMMARY.md` +- i18n index and coverage: `docs/i18n/README.md`, `docs/i18n-coverage.md`, `docs/i18n-gap-backlog.md` + +Supported locales: + +- `en` (source of truth) +- `zh-CN`, `ja`, `ru`, `fr`, `vi`, `el` (full top-level parity in `docs/i18n//`) + +## Canonical Layout + +Required structure: + +- Root language landing: `README..md` +- Canonical localized docs hub: `docs/i18n//README.md` +- Canonical localized summary: `docs/i18n//SUMMARY.md` + +Compatibility shims may exist at docs root (for example `docs/README.zh-CN.md`, `docs/SUMMARY.zh-CN.md`) and must remain aligned when touched. + +## Trigger Matrix + +Use this matrix to decide required i18n follow-through in the same PR. + +| Change type | Required i18n follow-through | +|---|---| +| Root README language switch line changed | Update language switch line in all root `README*.md` files | +| Docs hub language links changed | Update localized hub links in `docs/README.md` and every `docs/README*.md` / `docs/i18n/*/README.md` with an "Other languages" section | +| Unified TOC language entry changed | Update `docs/SUMMARY.md` and every localized `docs/SUMMARY*.md` / `docs/i18n/*/SUMMARY.md` language-entry section | +| Collection index changed (`docs//README.md`) | Update every matching `docs//README..md` for all supported locales | +| Any top-level runtime/governance/security doc changed under `docs/*.md` | Update corresponding file under every `docs/i18n//` in the same PR | +| Locale added/removed/renamed | Update root READMEs, docs hubs, summaries, `docs/i18n/README.md`, `docs/i18n-coverage.md`, and `docs/i18n-gap-backlog.md` | + +## Completion Checklist (Mandatory) + +Before merge, verify all items: + +1. Locale navigation parity +- Root language switch line includes all supported locales. +- Docs hubs include all supported locales. +- Summary language entry includes all supported locales. + +2. Canonical path consistency +- Non-English hubs point to `docs/i18n//README.md`. +- Non-English summaries point to `docs/i18n//SUMMARY.md`. +- Compatibility shims do not contradict canonical entries. + +3. Top-level docs parity +- If any file under `docs/*.md` changes, sync localized equivalents for all supported locales. +- If full narrative translation is not feasible in the same PR, provide a bridge update (with source link) rather than leaving missing files. +- Bridge pages must include a source section map (at least level-2 headings) and practical execution hints. + +4. Coverage metadata +- Update `docs/i18n-coverage.md` if support status, canonical path, or coverage level changed. +- Update `docs/i18n-gap-backlog.md` if baseline count changed. +- Keep date stamps current for changed localized hubs/summaries. + +5. Link integrity +- Run markdown/link checks (or equivalent local relative-link existence check) on changed docs. + +## Deferred Translation Policy + +If full narrative localization cannot be completed in the same PR: + +- Keep file-level parity complete (never leave locale file missing). +- Use localized bridge pages with clear source links to English normative docs. +- Keep bridge pages actionable: topic positioning + source section map + execution hints. +- Add explicit deferral note in PR description with owner and follow-up issue/PR. + +Do not silently defer user-facing language parity changes. + +## Agent Workflow Contract + +When an agent touches docs IA or shared docs wording, the agent must: + +1. Apply this guide and complete i18n follow-through in the same PR. +2. Update `docs/i18n-coverage.md`, `docs/i18n-gap-backlog.md`, and `docs/i18n/README.md` when locale topology or parity state changes. +3. Include i18n completion notes in PR summary (what was synced, what was bridged, why). + +## Gap Tracking + +- Track baseline parity closure and reopen events in [i18n-gap-backlog.md](i18n-gap-backlog.md). +- Update [i18n-coverage.md](i18n-coverage.md) after each localization wave. + +## Quick Validation Commands + +Examples: + +```bash +# search locale references +rg -n "README\.el\.md|i18n/el/README\.md|i18n/vi/README\.md|i18n/zh-CN/README\.md" README*.md docs/README*.md docs/SUMMARY*.md + +# check changed markdown files +git status --short + +# quick parity count against top-level docs baseline +base=$(find docs -maxdepth 1 -type f -name '*.md' | sed 's#^docs/##' | \ + rg -v '^(README(\..+)?\.md|SUMMARY(\..+)?\.md|commands-reference\.vi\.md|config-reference\.vi\.md|one-click-bootstrap\.vi\.md|troubleshooting\.vi\.md)$' | sort) +for loc in zh-CN ja ru fr vi el; do + c=0 + while IFS= read -r f; do + [ -f "docs/i18n/$loc/$f" ] || c=$((c+1)) + done <<< "$base" + echo "$loc $c" +done +``` + +Use repository-preferred markdown lint/link checks when available. diff --git a/docs/i18n/README.md b/docs/i18n/README.md index 1769166d1..4194f7433 100644 --- a/docs/i18n/README.md +++ b/docs/i18n/README.md @@ -2,14 +2,30 @@ Canonical localized documentation trees live here. +Top-level parity status: **all supported locales are 0-gap against `docs/*.md` baseline** (last validated 2026-02-24). +Narrative depth status: **enhanced bridge rollout completed for `zh-CN`/`ja`/`ru`/`fr`**. + ## Locales -- Vietnamese: [vi/README.md](vi/README.md) +- 简体中文 (Chinese): [zh-CN/README.md](zh-CN/README.md) +- 日本語 (Japanese): [ja/README.md](ja/README.md) +- Русский (Russian): [ru/README.md](ru/README.md) +- Français (French): [fr/README.md](fr/README.md) +- Tiếng Việt (Vietnamese): [vi/README.md](vi/README.md) +- Ελληνικά (Greek): [el/README.md](el/README.md) ## Structure - Docs structure map (language/part/function): [../structure/README.md](../structure/README.md) -- Canonical Vietnamese tree: `docs/i18n/vi/` -- Compatibility Vietnamese paths: `docs/vi/` and `docs/*.vi.md` +- Canonical locale trees: + - `docs/i18n/zh-CN/` + - `docs/i18n/ja/` + - `docs/i18n/ru/` + - `docs/i18n/fr/` + - `docs/i18n/vi/` + - `docs/i18n/el/` +- Compatibility hubs at docs root (`docs/README..md`) remain available during migration. See overall coverage and conventions in [../i18n-coverage.md](../i18n-coverage.md). +See remaining localization depth gaps in [../i18n-gap-backlog.md](../i18n-gap-backlog.md). +For required execution steps, use [../i18n-guide.md](../i18n-guide.md). diff --git a/docs/i18n/el/README.md b/docs/i18n/el/README.md new file mode 100644 index 000000000..d8d5dd673 --- /dev/null +++ b/docs/i18n/el/README.md @@ -0,0 +1,104 @@ +# Κέντρο Τεκμηρίωσης ZeroClaw + +Αυτή η σελίδα αποτελεί το κεντρικό σημείο πρόσβασης για το σύστημα τεκμηρίωσης του ZeroClaw. + +Τελευταία ενημέρωση: **21 Φεβρουαρίου 2026**. + +Τοπικοποιημένα κέντρα: [简体中文](../zh-CN/README.md) · [日本語](../ja/README.md) · [Русский](../ru/README.md) · [Français](../fr/README.md) · [Tiếng Việt](../vi/README.md) · [Ελληνικά](README.md). + +## Γρήγορη Εκκίνηση + +| Στόχος | Σύνδεσμος | +|---|---| +| Γρήγορη εγκατάσταση και εκτέλεση | [README.md (Πρώτα βήματα)](../README.md#quick-start) | +| Αυτόματη προετοιμασία (Bootstrap) με μία εντολή | [one-click-bootstrap.md](one-click-bootstrap.md) | +| Αναφορά εντολών ανά εργασία | [commands-reference.md](commands-reference.md) | +| Έλεγχος προεπιλογών και παραμέτρων ρύθμισης | [config-reference.md](config-reference.md) | +| Διαμόρφωση προσαρμοσμένων παρόχων και άκρων (endpoints) | [custom-providers.md](custom-providers.md) | +| Ρύθμιση παρόχου Z.AI / GLM | [zai-glm-setup.md](zai-glm-setup.md) | +| Χρήση προτύπων ενσωμάτωσης LangGraph | [langgraph-integration.md](langgraph-integration.md) | +| Ρύθμιση Nextcloud Talk | [nextcloud-talk-setup.md](nextcloud-talk-setup.md) | +| Ασφαλής διαχείριση proxy scopes | [proxy-agent-playbook.md](proxy-agent-playbook.md) | +| Διαχείριση περιβάλλοντος εκτέλεσης (Day-2 Runbook) | [operations-runbook.md](operations-runbook.md) | +| Λειτουργία probes συνδεσιμότητας provider στο CI | [operations/connectivity-probes-runbook.md](operations/connectivity-probes-runbook.md) | +| Αντιμετώπιση προβλημάτων εγκατάστασης και καναλιών | [troubleshooting.md](troubleshooting.md) | +| Οδηγός κρυπτογραφημένων δωματίων Matrix | [matrix-e2ee-guide.md](matrix-e2ee-guide.md) | +| Περιήγηση στα έγγραφα ανά κατηγορία | [SUMMARY.md](SUMMARY.md) | +| Στιγμιότυπο διαχείρισης έργου (PR/Issues) | [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) | + +## Οδηγός Γρήγορης Επιλογής + +- Εγκατάσταση και πρώτα βήματα → [getting-started/README.md](getting-started/README.md) +- Τεχνική αναφορά CLI και παραμέτρων → [reference/README.md](reference/README.md) +- Λειτουργία και διαχείριση υπηρεσιών → [operations/README.md](operations/README.md) +- Αντιμετώπιση σφαλμάτων και προβλημάτων → [troubleshooting.md](troubleshooting.md) +- Ασφάλεια και οδικός χάρτης ανάπτυξης → [security/README.md](security/README.md) +- Yλικό και περιφερειακές συσκευές → [hardware/README.md](hardware/README.md) +- Συνεισφορά και διαδικασίες CI → [contributing/README.md](contributing/README.md) +- Πλήρης πίνακας περιεχομένων → [SUMMARY.md](SUMMARY.md) + +## Κατηγορίες Τεκμηρίωσης + +- **Πρώτα βήματα**: [getting-started/README.md](getting-started/README.md) +- **Αναφορές (References)**: [reference/README.md](reference/README.md) +- **Λειτουργίες**: [operations/README.md](operations/README.md) +- **Ασφάλεια**: [security/README.md](security/README.md) +- **Υλικό**: [hardware/README.md](hardware/README.md) +- **Συνεισφορά**: [contributing/README.md](contributing/README.md) +- **Έργο (Project)**: [project/README.md](project/README.md) + +## Ανάλογα με τον Ρόλο + +### Χρήστες και Διαχειριστές (Operators) + +- [commands-reference.md](commands-reference.md) — Αναζήτηση εντολών ανά ροή εργασίας. +- [providers-reference.md](providers-reference.md) — Αναγνωριστικά παρόχων και μεταβλητές περιβάλλοντος. +- [channels-reference.md](channels-reference.md) — Ρύθμιση καναλιών επικοινωνίας. +- [matrix-e2ee-guide.md](matrix-e2ee-guide.md) — Κρυπτογράφηση Matrix και επίλυση προβλημάτων. +- [config-reference.md](config-reference.md) — Παράμετροι ρύθμισης και προεπιλογές ασφαλείας. +- [custom-providers.md](custom-providers.md) — Ενσωμάτωση προσαρμοσμένων παρόχων. +- [zai-glm-setup.md](zai-glm-setup.md) — Ρύθμιση Z.AI/GLM και πίνακας άκρων. +- [langgraph-integration.md](langgraph-integration.md) — Εναλλακτική ενσωμάτωση για κλήσεις εργαλείων. +- [operations-runbook.md](operations-runbook.md) — Διαδικασίες Day-2 και στρατηγικές επαναφοράς. +- [troubleshooting.md](troubleshooting.md) — Αντιμετώπιση κοινών σφαλμάτων. + +### Συνεισφέροντες και Συντηρητές (Maintainers) + +- [../../../CONTRIBUTING.el.md](../../../CONTRIBUTING.el.md) — Οδηγός συνεισφοράς. +- [pr-workflow.md](pr-workflow.md) — Διαδικασία υποβολής Pull Requests. +- [reviewer-playbook.md](reviewer-playbook.md) — Οδηγός για αναθεωρητές κώδικα. +- [ci-map.md](ci-map.md) — Διάγραμμα διαδικασιών CI. +- [actions-source-policy.md](actions-source-policy.md) — Πολιτική χρήσης GitHub Actions. + +### Ασφάλεια και Αξιοπιστία + +> **Σημείωση**: Αυτή η ενότητα περιλαμβάνει προτάσεις και οδικούς χάρτες. Για την τρέχουσα λειτουργία, συμβουλευτείτε τα [config-reference.md](config-reference.md) και [operations-runbook.md](operations-runbook.md). + +- [security/README.md](security/README.md) +- [agnostic-security.md](agnostic-security.md) +- [frictionless-security.md](frictionless-security.md) +- [sandboxing.md](sandboxing.md) +- [audit-logging.md](audit-logging.md) +- [resource-limits.md](resource-limits.md) +- [security-roadmap.md](security-roadmap.md) + +## Διακυβέρνηση και Πλοήγηση + +- Πλήρης πίνακας περιεχομένων: [SUMMARY.md](SUMMARY.md) +- Κατάλογος και ταξινόμηση εγγράφων: [docs-inventory.md](docs-inventory.md) +- Ευρετήριο μεταφράσεων i18n: [../README.md](../README.md) +- Κατάσταση κάλυψης i18n: [../../i18n-coverage.md](../../i18n-coverage.md) +- Οδηγός ολοκλήρωσης i18n: [i18n-guide.md](i18n-guide.md) +- Χάρτης κάλυψης i18n (Ελληνικά): [i18n-coverage.md](i18n-coverage.md) +- Backlog κενών i18n: [i18n-gap-backlog.md](i18n-gap-backlog.md) +- Snapshot ελέγχου τεκμηρίωσης (2026-02-24): [docs-audit-2026-02-24.md](docs-audit-2026-02-24.md) +- Στιγμιότυπο διαχείρισης έργου: [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) + +## Άλλες γλώσσες + +- English: [../../README.md](../../README.md) +- 简体中文: [../zh-CN/README.md](../zh-CN/README.md) +- 日本語: [../ja/README.md](../ja/README.md) +- Русский: [../ru/README.md](../ru/README.md) +- Français: [../fr/README.md](../fr/README.md) +- Tiếng Việt: [../vi/README.md](../vi/README.md) diff --git a/docs/i18n/el/SUMMARY.md b/docs/i18n/el/SUMMARY.md new file mode 100644 index 000000000..42cd13d4d --- /dev/null +++ b/docs/i18n/el/SUMMARY.md @@ -0,0 +1,115 @@ +# Πίνακας Περιεχομένων Τεκμηρίωσης ZeroClaw + +Αυτό το αρχείο αποτελεί τον κεντρικό οδηγό πλοήγησης για το σύστημα τεκμηρίωσης. + +Τελευταία ενημέρωση: **18 Φεβρουαρίου 2026**. + +## Επιλογή Γλώσσας + +- English README: [../README.md](../README.md) +- Chinese README: [../../README.zh-CN.md](../../README.zh-CN.md) +- Japanese README: [../../README.ja.md](../../README.ja.md) +- Russian README: [../../README.ru.md](../../README.ru.md) +- French README: [../../README.fr.md](../../README.fr.md) +- Vietnamese README: [../../README.vi.md](../../README.vi.md) +- Ελληνικό README: [../../README.el.md](../../README.el.md) +- English Docs Hub: [README.md](README.md) +- Chinese Docs Hub: [../zh-CN/README.md](../zh-CN/README.md) +- Japanese Docs Hub: [../ja/README.md](../ja/README.md) +- Russian Docs Hub: [../ru/README.md](../ru/README.md) +- French Docs Hub: [../fr/README.md](../fr/README.md) +- Vietnamese Docs Hub: [../vi/README.md](../vi/README.md) +- Ελληνικό Κέντρο Τεκμηρίωσης: [README.md](README.md) +- Ευρετήριο μεταφράσεων i18n: [../README.md](../README.md) +- Χάρτης κάλυψης i18n: [../../i18n-coverage.md](../../i18n-coverage.md) + +## Θεματικές Ενότητες + +### 1) Προετοιμασία και Εγκατάσταση + +- [getting-started/README.md](getting-started/README.md) +- [one-click-bootstrap.md](one-click-bootstrap.md) +- [android-setup.md](android-setup.md) +- [getting-started/macos-update-uninstall.md](getting-started/macos-update-uninstall.md) + +### 2) Τεχνικές Αναφορές και Ενσωματώσεις + +- [reference/README.md](reference/README.md) +- [commands-reference.md](commands-reference.md) +- [providers-reference.md](providers-reference.md) +- [channels-reference.md](channels-reference.md) +- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) +- [config-reference.md](config-reference.md) +- [custom-providers.md](custom-providers.md) +- [zai-glm-setup.md](zai-glm-setup.md) +- [langgraph-integration.md](langgraph-integration.md) + +### 3) Διαχείριση και Ανάπτυξη (Operations & Deployment) + +- [operations/README.md](operations/README.md) +- [operations-runbook.md](operations-runbook.md) +- [operations/connectivity-probes-runbook.md](operations/connectivity-probes-runbook.md) +- [release-process.md](release-process.md) +- [troubleshooting.md](troubleshooting.md) +- [network-deployment.md](network-deployment.md) +- [mattermost-setup.md](mattermost-setup.md) + +### 4) Ασφάλεια και Σχεδιασμός + +- [security/README.md](security/README.md) +- [agnostic-security.md](agnostic-security.md) +- [frictionless-security.md](frictionless-security.md) +- [sandboxing.md](sandboxing.md) +- [resource-limits.md](resource-limits.md) +- [audit-logging.md](audit-logging.md) +- [audit-event-schema.md](audit-event-schema.md) +- [security-roadmap.md](security-roadmap.md) + +### 5) Υλικό και Περιφερειακές Συσκευές + +- [hardware/README.md](hardware/README.md) +- [hardware-peripherals-design.md](hardware-peripherals-design.md) +- [adding-boards-and-tools.md](adding-boards-and-tools.md) +- [nucleo-setup.md](nucleo-setup.md) +- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) +- [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) +- [datasheets/arduino-uno.md](datasheets/arduino-uno.md) +- [datasheets/esp32.md](datasheets/esp32.md) + +### 6) Διαδικασίες Συνεισφοράς και CI + +- [contributing/README.md](contributing/README.md) +- [../../../CONTRIBUTING.el.md](../../../CONTRIBUTING.el.md) +- [pr-workflow.md](pr-workflow.md) +- [reviewer-playbook.md](reviewer-playbook.md) +- [ci-map.md](ci-map.md) +- [actions-source-policy.md](actions-source-policy.md) + +### 7) Τυποποιημένες Διαδικασίες Λειτουργίας (SOP) + +- [sop/README.md](sop/README.md) +- [sop/syntax.md](sop/syntax.md) +- [sop/connectivity.md](sop/connectivity.md) +- [sop/observability.md](sop/observability.md) +- [sop/cookbook.md](sop/cookbook.md) + +### 8) Δομή Τεκμηρίωσης + +- [structure/README.md](structure/README.md) + +### 9) Proxy και Προχωρημένες Ρυθμίσεις + +- [proxy-agent-playbook.md](proxy-agent-playbook.md) + +### 10) Κατάσταση Έργου και Στιγμιότυπα + +- [project/README.md](project/README.md) +- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) +- [docs-audit-2026-02-24.md](docs-audit-2026-02-24.md) +- [docs-inventory.md](docs-inventory.md) +- [cargo-slicer-speedup.md](cargo-slicer-speedup.md) +- [matrix-e2ee-guide.md](matrix-e2ee-guide.md) +- [doc-template.md](doc-template.md) +- [i18n-guide.md](i18n-guide.md) +- [i18n-coverage.md](i18n-coverage.md) +- [i18n-gap-backlog.md](i18n-gap-backlog.md) diff --git a/docs/i18n/el/actions-source-policy.md b/docs/i18n/el/actions-source-policy.md new file mode 100644 index 000000000..fa6474cfa --- /dev/null +++ b/docs/i18n/el/actions-source-policy.md @@ -0,0 +1,87 @@ +# Πολιτική Προέλευσης Ενεργειών (Φάση 1) + +Αυτό το έγγραφο ορίζει την πολιτική ελέγχου προέλευσης για τα GitHub Actions σε αυτό το αποθετήριο. + +**Στόχος Φάσης 1**: Περιορισμός των επιτρεπόμενων ενεργειών με ελάχιστη οργανωτική αναστάτωση, πριν από την πλήρη εφαρμογή του SHA pinning. + +## Τρέχουσα Πολιτική + +- **Δικαιώματα Actions**: Ενεργοποιημένα (Enabled). +- **Περιορισμός Ενεργειών**: Επιλεγμένες ενέργειες (Selected actions). +- **Απαίτηση SHA Pinning**: Απενεργοποιημένη (θα εφαρμοστεί στη Φάση 2). + +### Λίστα Επιτρεπόμενων (Allowlist) + +Επιτρέπονται τα παρακάτω πρότυπα ενεργειών: + +- `actions/*` (επίσημα actions για cache, checkout, artifacts κ.λπ.) +- `docker/*` +- `dtolnay/rust-toolchain@*` +- `DavidAnson/markdownlint-cli2-action@*` +- `lycheeverse/lychee-action@*` +- `EmbarkStudios/cargo-deny-action@*` +- `rustsec/audit-check@*` +- `rhysd/actionlint@*` +- `softprops/action-gh-release@*` +- `sigstore/cosign-installer@*` +- `Checkmarx/vorpal-reviewdog-github-action@*` +- `useblacksmith/*` (Υποδομή Blacksmith) + +## Διαδικασία Ελέγχου Αλλαγών + +Χρησιμοποιήστε τις παρακάτω εντολές για να επαληθεύσετε την τρέχουσα πολιτική: + +```bash +gh api repos/zeroclaw-labs/zeroclaw/actions/permissions +gh api repos/zeroclaw-labs/zeroclaw/actions/permissions/selected-actions +``` + +Κάθε αλλαγή στην πολιτική πρέπει να καταγράφει: + +- Ημερομηνία και ώρα (UTC). +- Υπεύθυνος αλλαγής (Actor). +- Αιτιολογία. +- Μεταβολές στη λίστα επιτρεπόμενων. +- Οδηγίες επαναφοράς (Rollback). + +## Σκεπτικό + +- Μείωση του κινδύνου στην εφοδιαστική αλυσίδα (supply-chain risk) από μη ελεγμένες ενέργειες. +- Διατήρηση της λειτουργικότητας CI/CD με ελάχιστο κόστος μετάβασης. +- Προετοιμασία για το SHA pinning στη Φάση 2 χωρίς παρεμπόδιση της ανάπτυξης. + +## Οδηγίες για Αυτοματοποιημένες Ροές (Agentic Guardrails) + +Λόγω του μεγάλου όγκου αλλαγών από αυτοματοποιημένους πράκτορες: + +- Κάθε PR που τροποποιεί πηγές ενεργειών (`uses:`) πρέπει να τεκμηριώνει την επίδραση στη λίστα επιτρεπόμενων. +- Νέες ενέργειες τρίτων απαιτούν έγκριση από συντηρητή (maintainer). +- Αποφύγετε τη χρήση γενικών συμβόλων (wildcards) όπου είναι δυνατόν. + +## Λίστα Ελέγχου Επικύρωσης + +Μετά από κάθε αλλαγή, επιβεβαιώστε τη λειτουργία των παρακάτω: + +1. CI (Συνεχής Ενσωμάτωση). +2. Docker builds. +3. Έλεγχος Ασφαλείας (Security Audit). +4. Ορθότητα Ροής Εργασιών (Workflow Sanity). +5. Διαδικασία Έκδοσης (Release). + +**Σφάλμα προς παρακολούθηση**: `action is not allowed by policy`. +Σε περίπτωση αυτού του σφάλματος, προσθέστε μόνο τη συγκεκριμένη έμπιστη ενέργεια και τεκμηριώστε την αλλαγή. + +## Ιστορικό Αλλαγών + +- **2026-02-21**: Προσθήκη `Checkmarx/vorpal-reviewdog-github-action@*` για στοχευμένους ελέγχους ασφαλείας. +- **2026-02-17**: Μετάβαση στο `useblacksmith/rust-cache` για τη διαχείριση προσωρινής μνήμης Rust. +- **2026-02-16**: Προσθήκη `sigstore/cosign-installer@*` για την υπογραφή εκδόσεων. +- **2026-02-17**: Αντικατάσταση του `cargo install cargo-audit` με την ενέργεια `rustsec/audit-check@*`. + +## Επαναφορά (Rollback) + +Σε περίπτωση έκτακτης ανάγκης: + +1. Ορίστε προσωρινά την πολιτική σε `all`. +2. Διορθώστε τη λίστα επιτρεπόμενων. +3. Καταγράψτε το περιστατικό και την τελική λύση. diff --git a/docs/i18n/el/adding-boards-and-tools.md b/docs/i18n/el/adding-boards-and-tools.md new file mode 100644 index 000000000..01ff572b2 --- /dev/null +++ b/docs/i18n/el/adding-boards-and-tools.md @@ -0,0 +1,119 @@ +# Προσθήκη Πλακετών και Εργαλείων — Οδηγός Υλικού ZeroClaw + +Αυτός ο οδηγός εξηγεί πώς να προσθέσετε νέες πλακέτες υλικού και προσαρμοσμένα εργαλεία στο ZeroClaw. + +## Γρήγορη Εκκίνηση: Προσθήκη Πλακέτας μέσω CLI + +```bash +# Προσθήκη πλακέτας (ενημερώνει το ~/.zeroclaw/config.toml) + +zeroclaw peripheral add nucleo-f401re /dev/ttyACM0 +zeroclaw peripheral add arduino-uno /dev/cu.usbmodem12345 +zeroclaw peripheral add rpi-gpio native # για Raspberry Pi GPIO (Linux) + +# Επανεκκίνηση του δαίμονα (daemon) για εφαρμογή + +zeroclaw daemon --host 127.0.0.1 --port 42617 +``` + +## Υποστηριζόμενες Πλακέτες + +| Πλακέτα | Μεταφορά (Transport) | Παράδειγμα Διαδρομής | +|------------------|----------------------|-------------------------------| +| nucleo-f401re | serial | /dev/ttyACM0, /dev/cu.usbmodem* | +| arduino-uno | serial | /dev/ttyACM0, /dev/cu.usbmodem* | +| arduino-uno-q | bridge | (Uno Q IP) | +| rpi-gpio | native | native | +| esp32 | serial | /dev/ttyUSB0 | + +## Χειροκίνητη Ρύθμιση (Manual Config) + +Επεξεργαστείτε το αρχείο ~/.zeroclaw/config.toml: + +```toml +[peripherals] +enabled = true +datasheet_dir = "docs/datasheets" # προαιρετικό: RAG για "άναψε το κόκκινο led" → pin 13 + +[[peripherals.boards]] +board = "nucleo-f401re" +transport = "serial" +path = "/dev/ttyACM0" +baud = 115200 + +[[peripherals.boards]] +board = "arduino-uno" +transport = "serial" +path = "/dev/cu.usbmodem12345" +baud = 115200 +``` + +## Προσθήκη Φύλλου Δεδομένων (RAG) + +Τοποθετήστε αρχεία .md ή .txt στο docs/datasheets/ (ή στον δικό σας κατάλογο datasheet_dir). Ονομάστε τα αρχεία βάσει της πλακέτας: nucleo-f401re.md, arduino-uno.md. + +### Ψευδώνυμα Ακροδεκτών (Προτεινόμενο) + +Προσθέστε μια ενότητα `## Pin Aliases` ώστε ο πράκτορας να μπορεί να αντιστοιχίσει το "red led" στον ακροδέκτη 13: + +```markdown +# Η Πλακέτα Μου + +## Pin Aliases + +| ψευδώνυμο | ακροδέκτης | +|-------------|------------| +| red_led | 13 | +| builtin_led | 13 | +| user_led | 5 | +``` + +Ή χρησιμοποιήστε μορφή κλειδιού-τιμής: + +```markdown +## Pin Aliases + +red_led: 13 +builtin_led: 13 +``` + +### Φύλλα Δεδομένων PDF + +Με τη δυνατότητα rag-pdf, το ZeroClaw μπορεί να ευρετηριάσει αρχεία PDF: + +```bash +cargo build --features hardware,rag-pdf +``` + +Τοποθετήστε τα PDF στον κατάλογο των datasheet. Το περιεχόμενό τους εξάγεται και τεμαχίζεται (chunked) για το RAG. + +## Προσθήκη Νέου Τύπου Πλακέτας + +1. Δημιουργήστε ένα φύλλο δεδομένων — docs/datasheets/my-board.md με ψευδώνυμα ακροδεκτών και πληροφορίες GPIO. +2. Προσθήκη στις ρυθμίσεις — zeroclaw peripheral add my-board /dev/ttyUSB0 +3. Υλοποίηση περιφερειακού (προαιρετικό) — Για προσαρμοσμένα πρωτόκολλα, υλοποιήστε το trait Peripheral στο src/peripherals/ και καταχωρίστε το στο create_peripheral_tools. + +Δείτε το docs/hardware-peripherals-design.md για τον πλήρη σχεδιασμό. + +## Προσθήκη Προσαρμοσμένου Εργαλείου + +1. Υλοποιήστε το trait Tool στο src/tools/. +2. Καταχωρίστε το στο create_peripheral_tools (για εργαλεία υλικού) ή στο μητρώο εργαλείων του πράκτορα. +3. Προσθέστε μια περιγραφή εργαλείου στα tool_descs του πράκτορα στο src/agent/loop_.rs. + +## Αναφορά CLI + +| Εντολή | Περιγραφή | +|---------|-------------| +| zeroclaw peripheral list | Λίστα ρυθμισμένων πλακετών | +| zeroclaw peripheral add | Προσθήκη πλακέτας (εγγραφή στο config) | +| zeroclaw peripheral flash | Μεταφόρτωση (flash) υλικολογισμικού Arduino | +| zeroclaw peripheral flash-nucleo | Μεταφόρτωση (flash) υλικολογισμικού Nucleo | +| zeroclaw hardware discover | Λίστα συσκευών USB | +| zeroclaw hardware info | Πληροφορίες chip μέσω probe-rs | + +## Αντιμετώπιση Προβλημάτων + +- Η σειριακή θύρα δεν βρέθηκε — Σε macOS χρησιμοποιήστε το /dev/cu.usbmodem*. Σε Linux χρησιμοποιήστε το /dev/ttyACM0 ή το /dev/ttyUSB0. +- Μεταγλώττιση με υποστήριξη υλικού — cargo build --features hardware +- Probe-rs για Nucleo — cargo build --features hardware,probe diff --git a/docs/i18n/el/agnostic-security.md b/docs/i18n/el/agnostic-security.md new file mode 100644 index 000000000..419f49f67 --- /dev/null +++ b/docs/i18n/el/agnostic-security.md @@ -0,0 +1,152 @@ +# Αγνωστικιστική Ασφάλεια: Μηδενικός Αντίκτυπος στη Φορητότητα + +> **Κατάσταση**: Πρόταση / Οδικός Χάρτης (Roadmap) +> +> Αυτό το έγγραφο περιγράφει προτεινόμενες προσεγγίσεις και ενδέχεται να περιλαμβάνει υποθετικές εντολές ή ρυθμίσεις. Για την τρέχουσα λειτουργία, ανατρέξτε στα έγγραφα: [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md) και [troubleshooting.md](troubleshooting.md). + +## Βασικά Ερωτήματα Σχεδιασμού + +Θα προκαλέσουν οι λειτουργίες ασφαλείας προβλήματα στην: +1. Ταχύτητα των cross-compilation builds; +2. Αρθρωτή αρχιτεκτονική (δυνατότητα αντικατάστασης στοιχείων); +3. Υποστήριξη διαφορετικού υλικού (ARM, x86, RISC-V); +4. Υποστήριξη περιορισμένων πόρων (<5MB RAM); + +**Απάντηση: Όχι** — Η ασφάλεια υλοποιείται μέσω προαιρετικών **feature flags** και **υποθετικής μεταγλώττισης (conditional compilation)** ανά πλατφόρμα. + +--- + +## 1. Ταχύτητα Build: Διαχείριση μέσω Features + +### Cargo.toml: Λειτουργίες Ασφαλείας + +```toml +[features] +default = ["basic-security"] + +# Βασική ασφάλεια (μόνιμα ενεργή, ελάχιστη επιβάρυνση) +basic-security = [] + +# Sandboxing (προαιρετική ενεργοποίηση ανά πλατφόρμα) +sandbox-landlock = [] # Linux 5.13+ +sandbox-firejail = [] # Linux +sandbox-bubblewrap = []# macOS/Linux +sandbox-docker = [] # Υποστήριξη Docker (υψηλή επιβάρυνση) + +# Πλήρης σουίτα ασφαλείας για περιβάλλοντα παραγωγής +security-full = [ + "basic-security", + "sandbox-landlock", + "resource-monitoring", + "audit-logging", +] + +# Παρακολούθηση πόρων και καταγραφή ελέγχου (Audit) +resource-monitoring = [] +audit-logging = [] +``` + +### Εντολές Μεταγλώττισης + +```bash +# Γρήγορο dev build (χωρίς πρόσθετα ασφαλείας) +cargo build --profile dev + +# Release build με βασική ασφάλεια (προεπιλογή) +cargo build --release + +# Πλήρες build παραγωγής με όλες τις λειτουργίες ασφαλείας +cargo build --release --features security-full +``` + +### Υποθετική Μεταγλώττιση + +Όταν οι λειτουργίες είναι απενεργοποιημένες, ο σχετικός κώδικας εξαιρείται πλήρως από τη μεταγλώττιση, διασφαλίζοντας ότι το μέγεθος του εκτελέσιμου (binary) παραμένει μικρό. + +```rust +// src/security/mod.rs + +#[cfg(feature = "sandbox-landlock")] +mod landlock; +#[cfg(feature = "sandbox-landlock")] +pub use landlock::LandlockSandbox; + +// Η βασική ασφάλεια περιλαμβάνεται πάντα +pub mod policy; // Allowlist, path blocking, injection protection +``` + +--- + +## 2. Αρθρωτή Αρχιτεκτονική: Ασφάλεια ως Trait + +Η ασφάλεια υλοποιείται ως εναλλάξιμο στοιχείο μέσω του trait `Sandbox`: + +```rust +// src/security/traits.rs + +#[async_trait] +pub trait Sandbox: Send + Sync { + /// Εφαρμογή προστασίας sandbox σε μια εντολή + fn wrap_command(&self, cmd: &mut std::process::Command) -> std::io::Result<()>; + + /// Έλεγχος διαθεσιμότητας του sandbox στην τρέχουσα πλατφόρμα + fn is_available(&self) -> bool; + + /// Όνομα του μηχανισμού + fn name(&self) -> &str; +} +``` + +--- + +## 3. Υποστήριξη Πολλαπλών Πλατφορμών + +Το ZeroClaw προσαρμόζει αυτόματα το επίπεδο προστασίας βάσει των δυνατοτήτων του λειτουργικού συστήματος: + +| Πλατφόρμα | Κατάσταση Build | Μηχανισμός Runtime | +|:---|:---|:---| +| Linux ARM (Raspberry Pi) | ✅ Επιτυχές | Landlock ή None | +| Linux x86_64 | ✅ Επιτυχές | Landlock ή Firejail | +| macOS ARM (M1/M2) | ✅ Επιτυχές | Bubblewrap ή None | +| Windows x86_64 | ✅ Επιτυχές | Επίπεδο Εφαρμογής | +| RISC-V Linux | ✅ Επιτυχές | Landlock ή None | + +--- + +## 4. Περιορισμένοι Πόροι: Ανάλυση Επιβάρυνσης + +| Λειτουργία | Μέγεθος στο Binary (περίπου) | Επιβάρυνση RAM | +|:---|:---|:---| +| Base ZeroClaw | 3.4MB | <5MB | +| + Landlock | +50KB | +100KB | +| + Παρακολούθηση Πόρων | +30KB | +50KB | +| **Σύνολο (Πλήρης Ασφάλεια)** | **+140KB** | **<6MB** | + +--- + +## 5. Δυνατότητα Εναλλαγής (Agnostic Swaps) + +Μπορείτε να αλλάξετε τον μηχανισμό ασφαλείας μέσω του αρχείου ρυθμίσεων: + +```toml +# Χρήση Landlock (Native Linux LSM) +[security.sandbox] +backend = "landlock" + +# Χρήση Docker (Μέγιστη απομόνωση) +[security.sandbox] +backend = "docker" +``` + +--- + +## Σύνοψη Αρχών Σχεδιασμού + +| Κριτήριο | Πριν | Μετά (με Ασφάλεια) | Κατάσταση | +|:---|:---|:---|:---| +| Χρήση Μνήμης | <5MB RAM | <6MB RAM | ✅ Διατηρείται | +| Ταχύτητα Εκκίνησης | <10ms | <15ms | ✅ Διατηρείται | +| Συμβατότητα Υλικού | Πλήρης | Πλήρης | ✅ Διατηρείται | +| Αρθρωτή Σχεδίαση | Ναι | Ναι | ✅ Ενισχυμένη | + +**Η ασφάλεια παραμένει προαιρετική, αποδοτική και συμβατή με κάθε πλατφόρμα.** diff --git a/docs/i18n/el/android-setup.md b/docs/i18n/el/android-setup.md new file mode 100644 index 000000000..2b046bdf2 --- /dev/null +++ b/docs/i18n/el/android-setup.md @@ -0,0 +1,103 @@ +# Εγκατάσταση σε Android + +Το ZeroClaw παρέχει προκατασκευασμένα εκτελέσιμα αρχεία (binaries) για συσκευές Android. + +## Υποστηριζόμενες Αρχιτεκτονικές + +| Στόχος | Έκδοση Android | Συσκευές | +|--------|----------------|----------| +| `armv7-linux-androideabi` | Android 4.1+ (API 16+) | Παλιά 32-bit τηλέφωνα (Galaxy S3, κ.λπ.) | +| `aarch64-linux-android` | Android 5.0+ (API 21+) | Σύγχρονα 64-bit τηλέφωνα | + +## Εγκατάσταση μέσω Termux + +Ο ευκολότερος τρόπος εκτέλεσης του ZeroClaw σε Android είναι μέσω [Termux](https://termux.dev/). + +### 1. Εγκατάσταση Termux + +Κατεβάστε από το [F-Droid](https://f-droid.org/packages/com.termux/) (προτείνεται) ή από τις εκδόσεις GitHub. + +> ⚠️ **Σημείωση:** Η έκδοση του Play Store είναι παρωχημένη και δεν υποστηρίζεται. + +### 2. Λήψη ZeroClaw + +```bash +# Έλεγχος αρχιτεκτονικής +uname -m +# aarch64 = 64-bit, armv7l/armv8l = 32-bit + +# Λήψη του κατάλληλου binary +# Για 64-bit (aarch64): +curl -LO https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-aarch64-linux-android.tar.gz +tar xzf zeroclaw-aarch64-linux-android.tar.gz + +# Για 32-bit (armv7): +curl -LO https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-armv7-linux-androideabi.tar.gz +tar xzf zeroclaw-armv7-linux-androideabi.tar.gz +``` + +### 3. Εγκατάσταση και Εκτέλεση + +```bash +chmod +x zeroclaw +mv zeroclaw $PREFIX/bin/ + +# Επαλήθευση εγκατάστασης +zeroclaw --version + +# Εκτέλεση ρύθμισης +zeroclaw onboard +``` + +## Άμεση Εγκατάσταση μέσω ADB + +Για προχωρημένους χρήστες που θέλουν να εκτελέσουν το ZeroClaw εκτός Termux: + +```bash +# Από τον υπολογιστή σας με ADB +adb push zeroclaw /data/local/tmp/ +adb shell chmod +x /data/local/tmp/zeroclaw +adb shell /data/local/tmp/zeroclaw --version +``` + +> ⚠️ Η εκτέλεση εκτός Termux απαιτεί συσκευή με root ή συγκεκριμένα δικαιώματα για πλήρη λειτουργικότητα. + +## Περιορισμοί στο Android + +- **Χωρίς systemd:** Χρησιμοποιήστε το `termux-services` του Termux για λειτουργία daemon +- **Πρόσβαση αρχείων:** Απαιτεί δικαιώματα αποθήκευσης Termux (`termux-setup-storage`) +- **Δίκτυο:** Ορισμένες λειτουργίες ενδέχεται να απαιτούν δικαίωμα Android VPN για τοπική δέσμευση + +## Κατασκευή από Πηγαίο Κώδικα + +Για να κατασκευάσετε για Android μόνοι σας: + +```bash +# Εγκατάσταση Android NDK +# Προσθήκη στόχων +rustup target add armv7-linux-androideabi aarch64-linux-android + +# Ορισμός μονοπατιού NDK +export ANDROID_NDK_HOME=/path/to/ndk +export PATH=$ANDROID_NDK_HOME/toolchains/llvm/prebuilt/linux-x86_64/bin:$PATH + +# Κατασκευή +cargo build --release --target armv7-linux-androideabi +cargo build --release --target aarch64-linux-android +``` + +## Αντιμετώπιση Προβλημάτων + +### "Permission denied" + +```bash +chmod +x zeroclaw +``` + +### "not found" ή σφάλματα linker + +Βεβαιωθείτε ότι κατεβάσατε το σωστό binary για την αρχιτεκτονική της συσκευής σας. + +### Παλιό Android (4.x) + +Χρησιμοποιήστε το build `armv7-linux-androideabi` με API level 16+. diff --git a/docs/i18n/el/arduino-uno-q-setup.md b/docs/i18n/el/arduino-uno-q-setup.md new file mode 100644 index 000000000..97ca2b1da --- /dev/null +++ b/docs/i18n/el/arduino-uno-q-setup.md @@ -0,0 +1,141 @@ +# Οδηγός Εγκατάστασης ZeroClaw σε Arduino Uno Q + +Αυτός ο οδηγός περιγράφει τη διαδικασία εγκατάστασης και ρύθμισης του ZeroClaw στην πλευρά Linux του Arduino Uno Q. + +## Επισκόπηση + +Το ZeroClaw παρέχει πλήρη υποστήριξη για το Arduino Uno Q χωρίς να απαιτούνται αλλαγές στον κώδικα. + +| Στοιχείο | Τοποθεσία | Περιγραφή | +|:---|:---|:---| +| Εφαρμογή Bridge | `firmware/zeroclaw-uno-q-bridge/` | MCU sketch και Python socket server για τη διαχείριση των GPIO. | +| Εργαλεία Bridge | `src/peripherals/uno_q_bridge.rs` | Εργαλεία `gpio_read` / `gpio_write` για επικοινωνία μέσω TCP. | +| Εντολή Setup | `src/peripherals/uno_q_setup.rs` | Η εντολή `zeroclaw peripheral setup-uno-q` για την ανάπτυξη του Bridge. | + +> **Σημείωση**: Απαιτείται μεταγλώττιση (build) με το feature `hardware` για την υποστήριξη του Uno Q. + +## Προαπαιτούμενα + +- Arduino Uno Q με ενεργή σύνδεση WiFi. +- Εγκατεστημένο Arduino App Lab για την αρχική προετοιμασία. +- Κλειδί API για πάροχο LLM (π.χ. OpenRouter, Gemini). + +--- + +## Βήμα 1: Αρχική Προετοιμασία Uno Q + +### 1.1 Ρύθμιση μέσω App Lab + +1. Εκκινήστε το **Arduino App Lab**. +2. Συνδέστε το Uno Q μέσω USB και ενεργοποιήστε τη συσκευή. +3. Συνδεθείτε στην πλακέτα και ακολουθήστε τις οδηγίες: + - Ορίστε διαπιστευτήρια SSH (Όνομα χρήστη και κωδικό πρόσβασης). + - Ρυθμίστε τη σύνδεση WiFi. + - Ενημερώστε το υλικολογισμικό (firmware) εάν απαιτείται. +4. Σημειώστε τη διεύθυνση IP της συσκευής (π.χ. `192.168.1.42`). + +### 1.2 Επαλήθευση Πρόσβασης SSH + +Επιβεβαιώστε τη σύνδεση μέσω τερματικού: +```bash +ssh arduino@ +``` + +--- + +## Βήμα 2: Εγκατάσταση του ZeroClaw + +### Μεταγλώττιση στη Συσκευή (Προτεινόμενο) + +1. **Σύνδεση μέσω SSH**: + ```bash + ssh arduino@ + ``` + +2. **Εγκατάσταση Rust**: + ```bash + curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y + source ~/.cargo/env + ``` + +3. **Εγκατάσταση Εξαρτήσεων**: + ```bash + sudo apt-get update + sudo apt-get install -y pkg-config libssl-dev git + ``` + +4. **Λήψη και Μεταγλώττιση**: + ```bash + git clone https://github.com/theonlyhennygod/zeroclaw.git + cd zeroclaw + cargo build --release --features hardware + ``` + +5. **Εγκατάσταση Εκτελέσιμου**: + ```bash + sudo cp target/release/zeroclaw /usr/local/bin/ + ``` + +--- + +## Βήμα 3: Ρύθμιση του ZeroClaw + +### 3.1 Αυτόματη Προετοιμασία (Onboarding) + +```bash +zeroclaw onboard --api-key --provider +``` + +### 3.2 Αρχείο Ρυθμίσεων (config.toml) + +Βεβαιωθείτε ότι το αρχείο `~/.zeroclaw/config.toml` περιλαμβάνει τις απαραίτητες ρυθμίσεις για το Telegram και τον πράκτορα. + +--- + +## Βήμα 4: Εκτέλεση του ZeroClaw Daemon + +Ξεκινήστε την υπηρεσία ZeroClaw: +```bash +zeroclaw daemon --host 127.0.0.1 --port 42617 +``` +Σε αυτό το στάδιο, η επικοινωνία μέσω Telegram είναι ενεργή, αλλά χωρίς έλεγχο των GPIO. + +--- + +## Βήμα 5: Ενεργοποίηση GPIO μέσω Bridge + +### 5.1 Ανάπτυξη της Εφαρμογής Bridge + +Από τον υπολογιστή σας ή απευθείας από το Uno Q, εκτελέστε: +```bash +zeroclaw peripheral setup-uno-q --host +``` + +### 5.2 Ενημέρωση Ρυθμίσεων + +Προσθέστε τα παρακάτω στο `config.toml`: + +```toml +[peripherals] +enabled = true + +[[peripherals.boards]] +board = "arduino-uno-q" +transport = "bridge" +``` + +### 5.3 Επανεκκίνηση + +Επανεκκινήστε τον daemon: +```bash +zeroclaw daemon --host 127.0.0.1 --port 42617 +``` + +--- + +## Αντιμετώπιση Προβλημάτων + +- **Σφάλμα "command not found"**: Βεβαιωθείτε ότι η διαδρομή `/usr/local/bin` ή `~/.cargo/bin` περιλαμβάνεται στη μεταβλητή `PATH`. +- **Το Telegram δεν αποκρίνεται**: Επαληθεύστε το `bot_token`, τη λίστα `allowed_users` και τη σύνδεση WiFi του Uno Q. +- **Έλλειψη Μνήμης (OOM)**: Χρησιμοποιήστε μόνο τα απαραίτητα features κατά το build και ενεργοποιήστε τη ρύθμιση `compact_context = true` στις ρυθμίσεις του πράκτορα. +- **Προβλήματα GPIO**: Βεβαιωθείτε ότι η εφαρμογή Bridge εκτελείται και ότι η ρύθμιση `transport` είναι ορισμένη σε `bridge`. diff --git a/docs/i18n/el/audit-event-schema.md b/docs/i18n/el/audit-event-schema.md new file mode 100644 index 000000000..47b9d7137 --- /dev/null +++ b/docs/i18n/el/audit-event-schema.md @@ -0,0 +1,15 @@ +# Σχήμα Audit Event CI/Security (Ελληνικά) + +Αυτή η σελίδα είναι συνοπτική τοπικοποιημένη γέφυρα για το σχήμα συμβάντων audit. + +Αγγλικό πρωτότυπο: + +- [../../audit-event-schema.md](../../audit-event-schema.md) + +## Βασικά σημεία + +- Κανονικό envelope: `zeroclaw.audit.v1`. +- Κύρια πεδία: `event_type`, `generated_at`, `run_context`, `artifact`, `payload`. +- Πίνακας retention ανά workflow για artifacts/audit lanes. + +Για πλήρη schema και πίνακες, χρησιμοποιήστε το αγγλικό κείμενο. diff --git a/docs/i18n/el/audit-logging.md b/docs/i18n/el/audit-logging.md new file mode 100644 index 000000000..5e00c47b3 --- /dev/null +++ b/docs/i18n/el/audit-logging.md @@ -0,0 +1,157 @@ +# Καταγραφή Ελέγχου (Audit Logging) + +> **Κατάσταση**: Πρόταση / Οδικός Χάρτης (Roadmap) +> +> Αυτό το έγγραφο περιγράφει προτεινόμενες προσεγγίσεις και ενδέχεται να περιλαμβάνει υποθετικές εντολές ή ρυθμίσεις. Για την τρέχουσα συμπεριφορά, ανατρέξτε στα έγγραφα: [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md) και [troubleshooting.md](troubleshooting.md). + +## Περιγραφή Προβλήματος + +Το ZeroClaw απαιτεί έναν μηχανισμό καταγραφής ελέγχου (audit trails) με προστασία από παραποίηση, προκειμένου να τεκμηριώνονται: +- Η ταυτότητα του χρήστη που εκτέλεσε μια εντολή. +- Η χρονική στιγμή και το κανάλι επικοινωνίας. +- Οι πόροι που προσπελάστηκαν. +- Η εφαρμογή των πολιτικών ασφαλείας. + +--- + +## Προτεινόμενη Μορφή Συμβάντος (Log Format) + +```json +{ + "timestamp": "2026-02-16T12:34:56Z", + "event_id": "evt_1a2b3c4d", + "event_type": "command_execution", + "actor": { + "channel": "telegram", + "user_id": "123456789", + "username": "@alice" + }, + "action": { + "command": "ls -la", + "risk_level": "low", + "approved": false, + "allowed": true + }, + "result": { + "success": true, + "exit_code": 0, + "duration_ms": 15 + }, + "security": { + "policy_violation": false, + "rate_limit_remaining": 19 + }, + "signature": "SHA256:abc123..." // Υπογραφή HMAC για ακεραιότητα δεδομένων +} +``` + +--- + +## Υλοποίηση (Implementation) + +```rust +// src/security/audit.rs + +pub enum AuditEventType { + CommandExecution, + FileAccess, + ConfigurationChange, + AuthSuccess, + AuthFailure, + PolicyViolation, +} + +pub struct AuditLogger { + log_path: PathBuf, + signing_key: Option>, +} + +impl AuditLogger { + pub fn log(&self, event: &AuditEvent) -> anyhow::Result<()> { + let mut line = serde_json::to_string(event)?; + + // Προσθήκη υπογραφής HMAC για προστασία από παραποίηση + if let Some(ref key) = self.signing_key { + let signature = compute_hmac(key, line.as_bytes()); + line.push_str(&format!(",\"signature\": \"{}\"", signature)); + } + + let mut file = std::fs::OpenOptions::new() + .create(true) + .append(true) + .open(&self.log_path)?; + + writeln!(file, "{}", line)?; + file.sync_all()?; // Διασφάλιση εγγραφής στον δίσκο + Ok(()) + } +} +``` + +--- + +## Σχήμα Ρυθμίσεων (Config Schema) + +```toml +[security.audit] +enabled = true +log_path = "~/.config/zeroclaw/audit.log" +max_size_mb = 100 +rotate = "daily" # Επιλογές: daily | weekly | size + +# Προστασία ακεραιότητας (Tamper evidence) +sign_events = true +signing_key_path = "~/.config/zeroclaw/audit.key" + +# Πεδίο εφαρμογής καταγραφής +log_commands = true +log_file_access = true +log_auth_events = true +log_policy_violations = true +``` + +--- + +## CLI Διαχείρισης Ελέγχου + +```bash +# Αναζήτηση εντολών από συγκεκριμένο χρήστη +zeroclaw audit --user @alice + +# Προβολή συμβάντων υψηλού κινδύνου +zeroclaw audit --risk high + +# Εμφάνιση παραβιάσεων πολιτικής του τελευταίου 24ώρου +zeroclaw audit --since 24h --violations-only + +# Επαλήθευση ακεραιότητας των αρχείων καταγραφής +zeroclaw audit --verify-signatures +``` + +--- + +## Διαχείριση Αρχείων (Log Rotation) + +Το σύστημα υποστηρίζει αυτόματη εναλλαγή αρχείων όταν συμπληρωθεί το μέγιστο μέγεθος ή παρέλθει το ορισμένο χρονικό διάστημα. + +```rust +pub fn rotate_audit_log(log_path: &PathBuf, max_size: u64) -> anyhow::Result<()> { + let metadata = std::fs::metadata(log_path)?; + if metadata.len() < max_size { + return Ok(()); + } + // Διαδικασία εναλλαγής αρχείων (π.χ. audit.log -> audit.log.1) + Ok(()) +} +``` + +--- + +## Προτεραιότητες Υλοποίησης + +| Φάση | Λειτουργικότητα | Επίπεδο Προσπάθειας | Αξία Ασφαλείας | +|:---|:---|:---|:---| +| **P0** | Βασική καταγραφή συμβάντων | Χαμηλό | Μέτρια | +| **P1** | CLI αναζήτησης και αναφορών | Μέτριο | Μέτρια | +| **P2** | Ψηφιακή υπογραφή HMAC | Μέτριο | Υψηλή | +| **P3** | Αυτόματη εναλλαγή και αρχειοθέτηση | Χαμηλό | Μέτρια | diff --git a/docs/i18n/el/cargo-slicer-speedup.md b/docs/i18n/el/cargo-slicer-speedup.md new file mode 100644 index 000000000..ca510aea5 --- /dev/null +++ b/docs/i18n/el/cargo-slicer-speedup.md @@ -0,0 +1,54 @@ +# Επιτάχυνση Μεταγλώττισης με το cargo-slicer + +Το [cargo-slicer](https://github.com/nickel-org/cargo-slicer) είναι ένα εργαλείο βελτιστοποίησης που μειώνει τους χρόνους κατασκευής (build times) του ZeroClaw. Λειτουργεί αντικαθιστώντας αχρησιμοποίητες συναρτήσεις βιβλιοθηκών με κενές υλοποιήσεις (stubs), μειώνοντας το φόρτο του μεταγλωττιστή. + +## Αποτελέσματα Δοκιμών Απόδοσης + +| Περιβάλλον | Λειτουργία Ανάλυσης | Τυπικός Χρόνος | Με cargo-slicer | Βελτίωση | +|:---|:---|:---:|:---:|:---:| +| High-end Server | Basic Flow | 3λ 52δ | 3λ 31δ | **-9.1%** | +| High-end Server | MIR-precise | 3λ 52δ | 2λ 49δ | **-27.2%** | +| Raspberry Pi 4 | Basic Flow | 25λ 03δ | 17λ 54δ | **-28.6%** | + +*Οι μετρήσεις πραγματοποιήθηκαν με `cargo +nightly build --release`. Η ανάλυση MIR-precise προσφέρει τη μέγιστη εξοικονόμηση χρόνου εντοπίζοντας περισσότερο "νεκρό" κώδικα (dead code).* + +## Ενσωμάτωση στο CI + +Στις αυτόματες ροές εργασιών ([`.github/workflows/ci-build-fast.yml`](../../../.github/workflows/ci-build-fast.yml)), το `cargo-slicer` χρησιμοποιείται για ταχεία επαλήθευση. + +**Στρατηγική Επιβίωσης**: +- **Πρωτεύουσα**: Χρήση `cargo-slicer` για μέγιστη ταχύτητα. +- **Εφεδρική (Fallback)**: Σε περίπτωση ασυμβατότητας ή σφάλματος, το σύστημα επιστρέφει αυτόματα στην τυπική μεταγλώττιση για να διασφαλιστεί η συνέχεια του ελέγχου. + +## Τοπική Εγκατάσταση και Χρήση + +```bash +# Εγκατάσταση εξαρτήσεων +cargo install cargo-slicer +rustup component add rust-src rustc-dev llvm-tools-preview --toolchain nightly +cargo +nightly install cargo-slicer --profile release-rustc \ + --bin cargo-slicer-rustc --bin cargo_slicer_dispatch \ + --features rustc-driver + +# Κατασκευή με Basic Flow +cargo-slicer pre-analyze +CARGO_SLICER_VIRTUAL=1 CARGO_SLICER_CODEGEN_FILTER=1 \ + RUSTC_WRAPPER=$(which cargo_slicer_dispatch) \ + cargo +nightly build --release + +# Κατασκευή με MIR-precise (Μέγιστη Απόδοση) +CARGO_SLICER_MIR_PRECISE=1 CARGO_SLICER_WORKSPACE_CRATES=zeroclaw,zeroclaw_robot_kit \ + CARGO_SLICER_VIRTUAL=1 CARGO_SLICER_CODEGEN_FILTER=1 \ + RUSTC_WRAPPER=$(which cargo_slicer_dispatch) \ + cargo +nightly build --release +``` + +## Αρχές Λειτουργίας + +1. **Ανάλυση Ροής**: Χαρτογράφηση των εξαρτήσεων του κώδικα. +2. **Εντοπισμός Reachability**: Προσδιορισμός των τμημάτων των βιβλιοθηκών που είναι απαραίτητα για την εκτέλεση. +3. **Slicing**: Αφαίρεση του περιττού κώδικα (stripping). +4. **Βελτιστοποίηση**: Ο μεταγλωττιστής επεξεργάζεται μόνο τον απαραίτητο κώδικα. + +> [!NOTE] +> Το `cargo-slicer` δεν επηρεάζει τη λειτουργική συμπεριφορά του τελικού δυαδικού αρχείου. Οι αλλαγές περιορίζονται αποκλειστικά στη διαδικασία της μεταγλώττισης. diff --git a/docs/i18n/el/channels-reference.md b/docs/i18n/el/channels-reference.md new file mode 100644 index 000000000..ced0b3058 --- /dev/null +++ b/docs/i18n/el/channels-reference.md @@ -0,0 +1,81 @@ +# Οδηγός Καναλιών Επικοινωνίας (Channels) + +Αυτός ο οδηγός περιγράφει τη διαδικασία διαμόρφωσης των καναλιών επικοινωνίας (Telegram, Discord, κ.λπ.) στο ZeroClaw. + +Για κρυπτογραφημένα δωμάτια στο Matrix, συμβουλευτείτε τον: +- [Οδηγό Matrix E2EE](./matrix-e2ee-guide.md) + +--- + +## 1. Διαμόρφωση Καναλιών + +Οι ρυθμίσεις αποθηκεύονται στο αρχείο `~/.zeroclaw/config.toml`, στην ενότητα `[channels_config]`. + +```toml +[channels_config] +cli = true # Ενεργοποίηση διεπαφής τερματικού (CLI) +``` + +Για την προσθήκη νέου καναλιού (π.χ. Telegram), δημιουργήστε την αντίστοιχη υποενότητα: `[channels_config.telegram]`. + +## 2. Διαχείριση Μοντέλων μέσω Συνομιλίας + +Σε πλατφόρμες όπως το Telegram και το Discord, μπορείτε να ελέγχετε το ZeroClaw με εντολές: + +- `/models`: Προβολή διαθέσιμων παρόχων και μοντέλων. +- `/models `: Αλλαγή παρόχου AI (π.χ. `openai`, `anthropic`). +- `/model `: Επιλογή συγκεκριμένου μοντέλου (π.χ. `gpt-4`). + +## 3. Αποστολή και Ανάλυση Εικόνων + +Το ZeroClaw υποστηρίζει την ανάγνωση εικόνων μέσω της σύνταξης: +`[IMAGE:]` +Η πηγή μπορεί να είναι τοπική διαδρομή αρχείου ή URL. + +--- + +## 4. Μέθοδοι Λήψης Δεδομένων ανά Κανάλι + +| Κανάλι | Μηχανισμός | Απαιτεί Ανοιχτές Θύρες (Port Forwarding); | +|:---|:---|:---:| +| CLI | Direct Output | Όχι | +| Telegram | Polling | Όχι | +| Discord | Websocket | Όχι | +| Slack | Events API | Όχι | +| Matrix | Sync API | Όχι | +| Nextcloud Talk | Webhook | **Ναι** | +| Email | IMAP | Όχι | + +--- + +## 5. Πολιτική Ασφαλείας (Allowlist) + +Η πρόσβαση στο bot ελέγχεται μέσω της ρύθμισης `allowed_users`: +- **Κενή λίστα**: Αποκλεισμός όλων των χρηστών. +- **`["*"]`**: Ελεύθερη πρόσβαση (χρήση αποκλειστικά για δοκιμές). +- **Συγκεκριμένη λίστα**: Πρόσβαση μόνο στους εξουσιοδοτημένους λογαριασμούς. + +--- + +## 6. Αντιμετώπιση Προβλημάτων + +Εάν το bot δεν ανταποκρίνεται: +1. **Εξουσιοδότηση**: Επαληθεύστε ότι το ID σας συμπεριλαμβάνεται στο `allowed_users`. +2. **Σύνδεση**: Βεβαιωθείτε ότι το bot έχει προστεθεί στο σωστό δωμάτιο/κανάλι. +3. **Credentials**: Ελέγξτε την εγκυρότητα των Tokens και API Secrets. +4. **Δίκτυο**: + - Τα κανάλια **Webhook** απαιτούν προσβάσιμη HTTPS διεύθυνση από το διαδίκτυο. + - Τα κανάλια **Polling/Websocket** λειτουργούν πίσω από NAT χωρίς ρυθμίσεις router. +5. **Επανεκκίνηση**: Κάθε αλλαγή στο `config.toml` απαιτεί επανεκκίνηση του `zeroclaw daemon`. + +### Διαγνωστικά Μηνύματα (Logs) + +Εκτελέστε το ZeroClaw με αυξημένο επίπεδο καταγραφής: +```bash +RUST_LOG=info zeroclaw daemon +``` + +**Κοινά σφάλματα**: +- `ignoring message from unauthorized user`: Ο χρήστης δεν ανήκει στο allowlist. +- `401 / token mismatch`: Λανθασμένο διακριτικό πρόσβασης. +- `sync error`: Αδυναμία σύνδεσης με τον homeserver (σύνηθες στο Matrix). diff --git a/docs/i18n/el/ci-map.md b/docs/i18n/el/ci-map.md new file mode 100644 index 000000000..e98538702 --- /dev/null +++ b/docs/i18n/el/ci-map.md @@ -0,0 +1,47 @@ +# Οδηγός Αυτόματων Ελέγχων (CI Map) + +Το παρόν έγγραφο περιγράφει τη δομή και τις λειτουργίες των αυτοματοποιημένων ελέγχων (GitHub Actions) στο ZeroClaw. + +## 1. Έλεγχοι Υποχρεωτικής Έγκρισης (Merge-Blocking) + +Αυτοί οι έλεγχοι είναι ντετερμινιστικοί και αποτελούν προϋπόθεση για τη συγχώνευση οποιασδήποτε αλλαγής στον κλάδο `main`. + +- **CI (`ci-run.yml`)** + - **Σκοπός**: Επαλήθευση σύνταξης Rust, εκτέλεση test suite και ποιοτικός έλεγχος τεκμηρίωσης (docs). + - **Σημείωση**: Αλλαγές στο CI απαιτούν ρητή έγκριση από τους Maintainers. +- **Workflow Sanity (`workflow-sanity.yml`)** + - **Σκοπός**: Επαλήθευση της ακεραιότητας των αρχείων YAML των GitHub Actions. +- **PR Intake Checks (`pr-intake-checks.yml`)** + - **Σκοπός**: Ταχεία διαλογή PR, έλεγχος πληρότητας πληροφοριών και συμμόρφωση με τα πρότυπα κώδικα (linting). + +## 2. Προαιρετικοί και Συμπληρωματικοί Έλεγχοι + +- **Docker (`pub-docker-img.yml`)**: Επαλήθευση containerization και κατασκευή images για πολλαπλές αρχιτεκτονικές. +- **Security Audit (`sec-audit.yml`)**: Σάρωση εξαρτήσεων για γνωστές ευπάθειες. +- **CodeQL Analysis (`sec-codeql.yml`)**: Στατική ανάλυση κώδικα για τον εντοπισμό κινδύνων ασφαλείας. +- **Release Automation (`pub-release.yml`)**: Διαδικασία δημιουργίας επίσημων releases. + +## 3. Αυτοματοποίηση Διεργασιών + +- **PR Labeler**: Αυτόματη ταξινόμηση PR βάσει μεγέθους (`size:*`) και κινδύνου (`risk:*`). +- **PR Auto Responder**: Αυτοματοποιημένη υποδοχή νέων συνεισφερόντων. +- **Stale Manager**: Διαχείριση ανενεργών Issues και PRs. +- **Dependabot**: Αυτόματη ενημέρωση εξαρτήσεων. + +## 4. Προγραμματισμός Εκτέλεσης + +| Έλεγχος | Συχνότητα / Ερέθισμα | +|:---|:---| +| CI / Security | Push, Pull Request | +| Docker / Release | Tag Push (`v*`) | +| Hygiene (Stale) | Καθημερινά | + +## 5. Οδηγίες Αντιμετώπισης Αποτυχιών + +1. **CI Gate Failure**: Ανατρέξτε στα logs της εργασίας `ci-run.yml`. +2. **Docker Build Failure**: Ελέγξτε το `pub-docker-img.yml` για σφάλματα στο Dockerfile. +3. **Security Findings**: Συμβουλευτείτε την αναφορά του `sec-audit.yml` για απαρχαιωμένες βιβλιοθήκες. +4. **Documentation Issues**: Ελέγξτε την ενότητα `docs-quality` στο `ci-run.yml`. + +> [!IMPORTANT] +> Οι έλεγχοι Merge-Blocking πρέπει να παραμένουν σταθεροί και γρήγοροι. Αποφύγετε την προσθήκη χρονοβόρων διαδικασιών στην κύρια ροή του CI. diff --git a/docs/i18n/el/commands-reference.md b/docs/i18n/el/commands-reference.md new file mode 100644 index 000000000..558437901 --- /dev/null +++ b/docs/i18n/el/commands-reference.md @@ -0,0 +1,65 @@ +# Αναφορά Εντολών ZeroClaw (CLI Reference) + +Αυτός ο οδηγός περιλαμβάνει το πλήρες σύνολο των εντολών που είναι διαθέσιμες στη διεπαφή γραμμής εντολών (CLI) του ZeroClaw. + +Τελευταία ενημέρωση: 20 Φεβρουαρίου 2026. + +## Σύνοψη Εντολών + +| Εντολή | Περιγραφή | +|:---|:---| +| `onboard` | Εκκίνηση της διαδικασίας αρχικής διαμόρφωσης και εγγραφής. | +| `agent` | Έναρξη αλληλεπίδρασης με τον πράκτορα AI (Interactive Mode). | +| `daemon` | Εκτέλεση του ZeroClaw ως διεργασία παρασκηνίου (Background Process). | +| `service` | Διαχείριση της υπηρεσίας συστήματος (System Service). | +| `doctor` | Εκτέλεση διαγνωστικών ελέγχων ακεραιότητας και συνδεσιμότητας. | +| `status` | Προβολή της τρέχουσας κατάστασης και των ενεργών ρυθμίσεων. | +| `cron` | Διαχείριση προγραμματισμένων εργασιών και αυτοματισμών. | +| `models` | Συγχρονισμός και διαχείριση διαθέσιμων μοντέλων AI. | +| `providers` | Διαχείριση των παρόχων υπολογιστικής ισχύος (LLM Providers). | +| `channel` | Διαμόρφωση και έλεγχος των καναλιών επικοινωνίας. | +| `skills` | Διαχείριση των επεκτάσεων και δυνατοτήτων (Skills) του πράκτορα. | +| `hardware` | Ανίχνευση και διαχείριση συνδεδεμένου υλικού (USB/Serial). | + +--- + +## Ανάλυση Κύριων Εντολών + +### 1. `onboard` (Αρχική Διαμόρφωση) + +- `zeroclaw onboard --interactive`: Διαδραστική καθοδήγηση για τη ρύθμιση του συστήματος. +- `zeroclaw onboard --channels-only`: Εστιασμένη διαμόρφωση αποκλειστικά για τα κανάλια επικοινωνίας. + +### 2. `agent` (Διαδραστική Λειτουργία) + +- `zeroclaw agent`: Έναρξη τυπικής συνομιλίας. +- `zeroclaw agent -m "<μήνυμα>"`: Άμεση αποστολή εντολής/μηνύματος στον πράκτορα. + +> [!TIP] +> Κατά τη διάρκεια της συνομιλίας, μπορείτε να αιτηθείτε την αλλαγή του μοντέλου (π.χ. "use gpt-4") και ο πράκτορας θα προσαρμόσει τις ρυθμίσεις του δυναμικά. + +### 3. `cron` (Προγραμματισμός Εργασιών) + +Δυνατότητα αυτοματισμού εντολών: +- `zeroclaw cron add "0 9 * * *" "echo Daily Setup"`: Εκτέλεση καθημερινά στις 09:00. +- `zeroclaw cron once "1h" "zeroclaw status"`: Προγραμματισμός εκτέλεσης μετά από μία ώρα. + +### 4. `doctor` (Διάγνωση Συστήματος) + +Χρησιμοποιήστε την εντολή `zeroclaw doctor` για την επαλήθευση της ορθής λειτουργίας των εξαρτήσεων, της πρόσβασης στο διαδίκτυο και της εγκυρότητας του αρχείου ρυθμίσεων. + +### 5. `skills` (Επεκτασιμότητα) + +- `zeroclaw skills list`: Προβολή εγκατεστημένων δεξιοτήτων. +- `zeroclaw skills install `: Εγκατάσταση νέας δεξιότητας από εξωτερική πηγή. + +> [!NOTE] +> Το ZeroClaw εφαρμόζει αυτόματη ανάλυση κώδικα (security scanning) σε κάθε νέα δεξιότητα πριν την ενεργοποίησή της για την αποφυγή εκτέλεσης κακόβουλου λογισμικού. + +--- + +## Βοήθεια και Τεκμηρίωση + +Για αναλυτικές πληροφορίες σχετικά με τις παραμέτρους κάθε εντολής, χρησιμοποιήστε το flag `--help`: +`zeroclaw --help` +(π.χ. `zeroclaw onboard --help`) diff --git a/docs/i18n/el/config-reference.md b/docs/i18n/el/config-reference.md new file mode 100644 index 000000000..be7fa77fd --- /dev/null +++ b/docs/i18n/el/config-reference.md @@ -0,0 +1,71 @@ +# Οδηγός Ρυθμίσεων ZeroClaw (config.toml) + +Αυτός ο οδηγός εξηγεί τις πιο σημαντικές ρυθμίσεις που μπορείτε να κάνετε στο αρχείο `config.toml`. + +Τελευταίος έλεγχος: **19 Φεβρουαρίου 2026**. + +## Πού βρίσκεται το αρχείο ρυθμίσεων; + +Το ZeroClaw ψάχνει για τις ρυθμίσεις με την εξής σειρά: +1. Στη διαδρομή που ορίζει η μεταβλητή `ZEROCLAW_WORKSPACE`. +2. Στο αρχείο `~/.zeroclaw/config.toml` (αυτή είναι η συνηθισμένη θέση). + +## Βασικές Ρυθμίσεις (Core) + +| Ρύθμιση | Τι ορίζει | +|---|---| +| `default_provider` | Ποιον πάροχο AI χρησιμοποιείτε (π.χ. `openai`, `ollama`). | +| `default_model` | Ποιο συγκεκριμένο μοντέλο AI χρησιμοποιείτε (π.χ. `gpt-4o`). | +| `default_temperature` | Πόσο "δημιουργική" θα είναι η AI (τιμή από 0 έως 2). | + +## 1. Συμπεριφορά της AI (Agent) + +- `max_tool_iterations`: Πόσες φορές μπορεί η AI να χρησιμοποιήσει εργαλεία για να απαντήσει σε 1 μήνυμα (προεπιλογή: 10). +- `max_history_messages`: Πόσα προηγούμενα μηνύματα θυμάται η AI στη συνομιλία (προεπιλογή: 50). + +## 2. Αυτονομία και Ασφάλεια (Autonomy) + +Εδώ ρυθμίζετε πόση ελευθερία έχει η AI να κάνει αλλαγές στον υπολογιστή σας. + +- `level`: + - `read_only`: Μπορεί μόνο να διαβάζει αρχεία. + - `supervised`: Χρειάζεται την έγκρισή σας για σημαντικές ενέργειες (προεπιλογή). + - `full`: Μπορεί να τρέχει εντολές ελεύθερα (προσοχή!). +- `allowed_commands`: Λίστα με τις εντολές που επιτρέπεται να τρέχει η AI. +- `forbidden_paths`: Φάκελοι που η AI **δεν** επιτρέπεται να αγγίξει (π.χ. `/etc`). + +## 3. Μνήμη (Memory) + +Πώς αποθηκεύει η AI τις πληροφορίες που της δίνετε. +- `backend`: Μπορεί να είναι `sqlite` (βάση δεδομένων), `markdown` (απλά αρχεία κειμένου) ή `none` (καμία μνήμη). + +## 4. Κανάλια Επικοινωνίας (Channels) + +Κάθε κανάλι (Telegram, Discord κ.λπ.) έχει τη δική του ενότητα στο αρχείο. + +Παράδειγμα για το **Telegram**: +```toml +[channels_config.telegram] +bot_token = "το-κλειδί-σας" +allowed_users = ["το-όνομά-σας"] # Ποιοι επιτρέπεται να μιλάνε στο bot +``` + +## 5. Έλεγχος Κόστους (Cost) + +Αν χρησιμοποιείτε πληρωμένες υπηρεσίες AI, μπορείτε να βάλετε όρια. +- `daily_limit_usd`: Μέγιστο ποσό ανά ημέρα (π.χ. 10.00 δολάρια). +- `monthly_limit_usd`: Μέγιστο ποσό ανά μήνα. + +## 6. Εικόνες (Multimodal) + +Ρυθμίσεις για το πώς η AI βλέπει εικόνες. +- `max_images`: Μέγιστος αριθμός εικόνων ανά μήνυμα. +- `allow_remote_fetch`: Αν επιτρέπεται στην AI να κατεβάζει εικόνες από το ίντερνετ μέσω συνδέσμων (links). + +--- + +## Συμβουλές + +- Αν αλλάξετε το αρχείο `config.toml`, πρέπει να κάνετε επανεκκίνηση το ZeroClaw για να δει τις αλλαγές. +- Χρησιμοποιήστε την εντολή `zeroclaw doctor` για να βεβαιωθείτε ότι οι ρυθμίσεις σας είναι σωστές. +- Μην μοιράζεστε ποτέ το αρχείο `config.toml` με άλλους, καθώς περιέχει τα μυστικά κλειδιά σας (tokens). diff --git a/docs/i18n/el/contributing/README.md b/docs/i18n/el/contributing/README.md new file mode 100644 index 000000000..9c6b5c56a --- /dev/null +++ b/docs/i18n/el/contributing/README.md @@ -0,0 +1,22 @@ +# Οδηγοί Συνεισφοράς και CI (Contributing & CI) + +Αυτός ο φάκελος περιέχει τεκμηρίωση για τους συνεισφέροντες (contributors), τους αναθεωρητές (reviewers) και τους συντηρητές (maintainers) του ZeroClaw. + +--- + +## Βασικές Πολιτικές + +- **Οδηγός Συνεισφοράς**: [../../../../CONTRIBUTING.md](../../../../CONTRIBUTING.md) +- **Ροή Εργασιών PR**: [../pr-workflow.md](../pr-workflow.md) +- **Εγχειρίδιο Αναθεωρητή**: [../reviewer-playbook.md](../reviewer-playbook.md) +- **Χάρτης και Ιδιοκτησία CI**: [../ci-map.md](../ci-map.md) +- **Πολιτική Ενεργειών (Actions)**: [../actions-source-policy.md](../actions-source-policy.md) + +--- + +## Προτεινόμενη Σειρά Ανάγνωσης + +1. `CONTRIBUTING.md` +2. `docs/pr-workflow.md` +3. `docs/reviewer-playbook.md` +4. `docs/ci-map.md` diff --git a/docs/i18n/el/custom-providers.md b/docs/i18n/el/custom-providers.md new file mode 100644 index 000000000..107976bf9 --- /dev/null +++ b/docs/i18n/el/custom-providers.md @@ -0,0 +1,53 @@ +# Οδηγός Προσαρμοσμένων Παρόχων AI (Custom Providers) + +Το ZeroClaw σας επιτρέπει να συνδεθείτε με δικές σας υπηρεσίες AI, όπως τοπικούς διακομιστές ή εταιρικά δίκτυα. + +## Τύποι συνδέσεων + +### 1. Σύνδεση τύπου OpenAI (`custom:`) + +Για υπηρεσίες που λειτουργούν όπως το OpenAI: +```toml +default_provider = "custom:https://το-api-σας.com" +api_key = "το-κλειδί-σας" +default_model = "το-όνομα-του-μοντέλου" +``` + +### 2. Σύνδεση τύπου Anthropic (`anthropic-custom:`) + +Για υπηρεσίες που λειτουργούν όπως το Anthropic: +```toml +default_provider = "anthropic-custom:https://το-api-σας.com" +api_key = "το-κλειδί-σας" +default_model = "το-όνομα-του-μοντέλου" +``` + +## Τοπική χρήση (στον υπολογιστή σας) + +Αν τρέχετε το δικό σας μοντέλο AI τοπικά, μπορείτε να χρησιμοποιήσετε τα εξής: + +- **llama.cpp**: Ρυθμίστε το `default_provider = "llamacpp"`. +- **vLLM**: Ρυθμίστε το `default_provider = "vllm"`. +- **SGLang**: Ρυθμίστε το `default_provider = "sglang"`. + +Παράδειγμα για το **llama.cpp**: +```toml +default_provider = "llamacpp" +api_url = "http://127.0.0.1:8033/v1" +default_model = "το-μοντέλο-σας" +``` + +## Πώς να το δοκιμάσετε + +Αφού αλλάξετε τις ρυθμίσεις, τρέξτε: +`zeroclaw agent -m "γεια σου"` +Αν η AI απαντήσει, η σύνδεση πέτυχε! + +## Τι να κάνετε αν δεν δουλεύει + +1. **Ελέγξτε το κλειδί (API Key)**: Βεβαιωθείτε ότι είναι σωστό. +2. **Ελέγξτε τη διεύθυνση (URL)**: Πρέπει να ξεκινάει με `http://` ή `https://`. +3. **Το μοντέλο δεν βρίσκεται**: Σιγουρευτείτε ότι το όνομα του μοντέλου είναι γραμμένο ακριβώς όπως το ορίζει ο πάροχος. + +Μπορείτε να ελέγξετε αν η διεύθυνση λειτουργεί γράφοντας στο τερματικό: +`curl -I https://το-api-σας.com` diff --git a/docs/i18n/el/datasheets/README.md b/docs/i18n/el/datasheets/README.md new file mode 100644 index 000000000..7e16bbf3e --- /dev/null +++ b/docs/i18n/el/datasheets/README.md @@ -0,0 +1,14 @@ +# Ευρετήριο Datasheets Υλικού (Ελληνικά) + +Συγκεντρωτικός κατάλογος φύλλων δεδομένων για τις υποστηριζόμενες πλακέτες. + +## Διαθέσιμα datasheets + +- [nucleo-f401re.md](nucleo-f401re.md) — STM32 Nucleo-F401RE +- [arduino-uno.md](arduino-uno.md) — Arduino Uno +- [esp32.md](esp32.md) — ESP32 + +## Σχετικά + +- Ελληνικό hub υλικού: [../hardware/README.md](../hardware/README.md) +- Οδηγός προσθήκης πλακετών/εργαλείων: [../adding-boards-and-tools.md](../adding-boards-and-tools.md) diff --git a/docs/i18n/el/datasheets/arduino-uno.md b/docs/i18n/el/datasheets/arduino-uno.md new file mode 100644 index 000000000..be39da271 --- /dev/null +++ b/docs/i18n/el/datasheets/arduino-uno.md @@ -0,0 +1,41 @@ +# Φύλλο Δεδομένων Arduino Uno + +## Ψευδώνυμα Ακροδεκτών (Pin Aliases) + +| Ψευδώνυμο | Ακροδέκτης | +|:---|:---:| +| `red_led` | 13 | +| `builtin_led` | 13 | +| `user_led` | 13 | + +--- + +## 1. Τεχνική Επισκόπηση + +Το Arduino Uno είναι μια πλακέτα μικροελεγκτή βασισμένη στον **ATmega328P**. Διαθέτει 14 ψηφιακούς ακροδέκτες εισόδου/εξόδου (I/O) και 6 αναλογικές εισόδους (A0–A5). + +## 2. Ψηφιακοί Ακροδέκτες (Digital I/O) + +- **Ακροδέκτες 0–13**: Ψηφιακή είσοδος/έξοδος. Μπορούν να διαμορφωθούν ως `INPUT` ή `OUTPUT`. +- **Ακροδέκτης 13**: Ενσωματωμένη λυχνία LED (Onboard). +- **Ακροδέκτες 0–1 (RX/TX)**: Χρησιμοποιούνται για σειριακή επικοινωνία. Αποφύγετε τη χρήση τους εάν η σειριακή θύρα (Serial) είναι ενεργή. + +## 3. Λειτουργία GPIO + +- **Έξοδος**: `digitalWrite(pin, HIGH)` ή `digitalWrite(pin, LOW)`. +- **Είσοδος**: `digitalRead(pin)` (επιστρέφει 0 ή 1). +- **Αρίθμηση**: Στο πρωτόκολλο ZeroClaw χρησιμοποιείται η αρίθμηση 0–13. + +## 4. Σειριακή Επικοινωνία (Serial) + +- **Διεπαφή**: UART στους ακροδέκτες 0 (RX) και 1 (TX). +- **Σύνδεση**: USB μέσω ATmega16U2 ή CH340. +- **Baud Rate**: 115200 (προεπιλογή για το υλικολογισμικό του ZeroClaw). + +--- + +## 5. Εργαλεία ZeroClaw + +- `gpio_read`: Ανάγνωση κατάστασης ακροδέκτη (0/1). +- `gpio_write`: Ρύθμιση ακροδέκτη σε High (1) ή Low (0). +- `arduino_upload`: Ο πράκτορας (agent) δημιουργεί αυτόματα κώδικα (C++) για Arduino. Το ZeroClaw μεταγλωττίζει και μεταφορτώνει τον κώδικα μέσω του **arduino-cli**. Ιδανικό για τη δημιουργία σύνθετων μοτίβων (π.χ. heart-pulse) χωρίς χειροκίνητη παρέμβαση στον κώδικα. diff --git a/docs/i18n/el/datasheets/esp32.md b/docs/i18n/el/datasheets/esp32.md new file mode 100644 index 000000000..951b9a524 --- /dev/null +++ b/docs/i18n/el/datasheets/esp32.md @@ -0,0 +1,29 @@ +# Φύλλο Δεδομένων ESP32 GPIO + +## Ψευδώνυμα Ακροδεκτών (Pin Aliases) + +| Ψευδώνυμο | Ακροδέκτης | +|:---|:---:| +| `builtin_led` | 2 | +| `red_led` | 2 | + +--- + +## 1. Κοινοί Ακροδέκτες (ESP32 / ESP32-C3) + +- **GPIO 2**: Ενσωματωμένη λυχνία LED (Onboard) στις περισσότερες πλακέτες ανάπτυξης. +- **GPIO 13**: Έξοδος γενικής χρήσης. +- **GPIO 20/21**: Συχνά δεσμευμένα για UART0 TX/RX. Αποφύγετε τη χρήση τους εάν η σειριακή επικοινωνία είναι ενεργή. + +--- + +## 2. Πρωτόκολλο Επικοινωνίας (Protocol) + +Ο κεντρικός υπολογιστής (Host) του ZeroClaw επικοινωνεί μέσω σειριακής διεπαφής (115200 baud) χρησιμοποιώντας JSON: + +- **gpio_read**: `{"id":"1","cmd":"gpio_read","args":{"pin":13}}` +- **gpio_write**: `{"id":"1","cmd":"gpio_write","args":{"pin":13,"value":1}}` + +### Παράδειγμα Απόκρισης + +`{"id":"1","ok":true,"result":"0"}` ή `{"id":"1","ok":true,"result":"done"}` diff --git a/docs/i18n/el/datasheets/nucleo-f401re.md b/docs/i18n/el/datasheets/nucleo-f401re.md new file mode 100644 index 000000000..9118c2cc9 --- /dev/null +++ b/docs/i18n/el/datasheets/nucleo-f401re.md @@ -0,0 +1,20 @@ +# Φύλλο Δεδομένων Nucleo-F401RE GPIO + +## Ψευδώνυμα Ακροδεκτών (Pin Aliases) + +| Ψευδώνυμο | Ακροδέκτης | +|:---|:---:| +| `red_led` | 13 | +| `user_led` | 13 | +| `ld2` | 13 | +| `builtin_led` | 13 | + +--- + +## 1. GPIO (General Purpose I/O) + +### Ακροδέκτης 13: Λυχνία LED Χρήστη (LD2) + +- **Λειτουργία**: Έξοδος +- **Λογική**: Ενεργή σε υψηλή κατάσταση (Active High) +- **Αντιστοίχιση**: PA5 στον μικροελεγκτή STM32F401 diff --git a/docs/i18n/el/doc-template.md b/docs/i18n/el/doc-template.md new file mode 100644 index 000000000..2e26ebb89 --- /dev/null +++ b/docs/i18n/el/doc-template.md @@ -0,0 +1,56 @@ +# Πρότυπο για Νέα Έγγραφα (Template) + +Χρησιμοποιήστε αυτό το πρότυπο όταν θέλετε να γράψετε ένα νέο αρχείο βοήθειας ή τεχνικής αναφοράς στον φάκελο `docs/`. + +--- + +## 1. Περίληψη + +- **Σκοπός:** <Γιατί γράφετε αυτό το έγγραφο;> +- **Σε ποιους απευθύνεται:** <Χρήστες, προγραμματιστές ή διαχειριστές;> +- **Τι περιλαμβάνει:** <Τι θα μάθει ο αναγνώστης;> + +## 2. Τι θα χρειαστείτε (Προαπαιτούμενα) + +- <Ποια προγράμματα πρέπει να είναι εγκατεστημένα;> +- <Τι είδους δικαιώματα χρειάζονται;> +- <Ποιες ρυθμίσεις πρέπει να έχουν γίνει ήδη;> + +## 3. Οδηγίες (Βήμα-βήμα) + +### 3.1 Προετοιμασία + +1. <Κάντε αυτό το πρώτο βήμα.> +2. <Κάντε αυτό το δεύτερο βήμα.> + +### 3.2 Κύρια διαδικασία + +1. <Πρώτη ενέργεια.> +2. <Δεύτερη ενέργεια.> + +### 3.3 Έλεγχος (Πώς ξέρουμε ότι πέτυχε;) + +- <Τι πρέπει να βλέπει ο χρήστης στην οθόνη;> +- <Ποια εντολή επιβεβαιώνει ότι όλα είναι εντάξει;> + +## 4. Ασφάλεια και Επιστροφή (Rollback) + +- **Κίνδυνοι:** <Τι μπορεί να χαλάσει αν κάτι πάει στραβά;> +- **Πώς να το διορθώσετε:** <Ποια εντολή θα επαναφέρει το σύστημα στην προηγούμενη κατάσταση;> + +## 5. Αντιμετώπιση Προβλημάτων + +- **Πρόβλημα:** <Περιγράψτε το σφάλμα.> + - **Γιατί συμβαίνει:** <Ποια είναι η αιτία;> + - **Λύση:** <Τι πρέπει να κάνει ο χρήστης;> + +## 6. Δείτε επίσης + +- [README.md](./README.md) — Η κεντρική σελίδα με όλα τα έγγραφα. +- <Άλλο σχετικό έγγραφο 1> +- <Άλλο σχετικό έγγραφο 2> + +## 7. Πληροφορίες Συντήρησης + +- **Ποιος το έγραψε:** <Όνομα ή ομάδα.> +- **Πότε γράφτηκε:** <Ημερομηνία σε μορφή ΗΗ-ΜΜ-ΕΕΕΕ.> diff --git a/docs/i18n/el/docs-audit-2026-02-24.md b/docs/i18n/el/docs-audit-2026-02-24.md new file mode 100644 index 000000000..cfe6df724 --- /dev/null +++ b/docs/i18n/el/docs-audit-2026-02-24.md @@ -0,0 +1,13 @@ +# Snapshot Ελέγχου Τεκμηρίωσης (2026-02-24, Ελληνικά) + +Αυτή η σελίδα είναι συνοπτική τοπικοποιημένη γέφυρα για το audit snapshot της 2026-02-24. + +Αγγλικό πρωτότυπο: + +- [../../docs-audit-2026-02-24.md](../../docs-audit-2026-02-24.md) + +## Περιεχόμενο + +- Αποτύπωση ευρημάτων για δομή, συνδέσμους και i18n topology. +- Καταγραφή remediation ενεργειών και υπολειπόμενων κενών. +- Snapshot ανά ημερομηνία (μη αναδρομική επεξεργασία ιστορικού). diff --git a/docs/i18n/el/docs-inventory.md b/docs/i18n/el/docs-inventory.md new file mode 100644 index 000000000..d24d4eaf9 --- /dev/null +++ b/docs/i18n/el/docs-inventory.md @@ -0,0 +1,59 @@ +# Κατάλογος Εγγράφων ZeroClaw + +Αυτή η σελίδα σας βοηθάει να βρείτε γρήγορα το έγγραφο που χρειάζεστε, ανάλογα με το τι θέλετε να κάνετε. + +Τελευταία ενημέρωση: **18 Φεβρουαρίου 2026**. + +## Τύποι Εγγράφων + +- **Οδηγοί και Αναφορές**: Πώς λειτουργεί το ZeroClaw σήμερα. +- **Πολιτικές**: Κανόνες για το πώς συνεργαζόμαστε. +- **Προτάσεις και Σχέδια**: Ιδέες για το μέλλον (μπορεί να μην ισχύουν ακόμα). +- **Αναφορές (Snapshots)**: Πληροφορίες για το σύστημα σε μια συγκεκριμένη ημερομηνία. + +## Από πού να ξεκινήσετε + +| Έγγραφο | Σε ποιον απευθύνεται | +|---|---| +| `README.md` | Σε όλους (βασικές πληροφορίες). | +| `docs/README.md` | Η κεντρική πύλη για όλη τη βοήθεια. | +| `docs/SUMMARY.el.md` | Ο πίνακας περιεχομένων στα Ελληνικά. | + +## Οδηγοί για Χρήστες και Διαχειριστές + +| Έγγραφο | Τι θα μάθετε | +|---|---| +| `docs/one-click-bootstrap.md` | Πώς να ξεκινήσετε γρήγορα με ένα κλικ. | +| `docs/commands-reference.md` | Όλες οι εντολές που μπορείτε να γράψετε. | +| `docs/config-reference.md` | Πώς να ρυθμίσετε το αρχείο `config.toml`. | +| `docs/providers-reference.md` | Πληροφορίες για την AI (OpenAI, Anthropic κ.λπ.). | +| `docs/channels-reference.md` | Πώς να συνδέσετε Telegram, Discord κ.λπ. | +| `docs/troubleshooting.md` | Λύσεις για συνηθισμένα προβλήματα. | + +## Οδηγοί για Προγραμματιστές και Υλικό (Hardware) + +| Έγγραφο | Τι θα μάθετε | +|---|---| +| `docs/custom-providers.md` | Πώς να βάλετε δικούς σας παρόχους AI. | +| `docs/hardware-peripherals-design.md` | Πώς να συνδέσετε πλακέτες (π.χ. Arduino, STM32). | +| `docs/nucleo-setup.md` | Οδηγίες για πλακέτες Nucleo. | + +## Κανόνες και Διαδικασίες + +| Έγγραφο | Τι αφορά | +|---|---| +| `docs/pr-workflow.md` | Πώς να στέλνετε αλλαγές στον κώδικα (Pull Requests). | +| `docs/ci-map.md` | Πώς λειτουργούν οι αυτόματοι έλεγχοι. | +| `docs/reviewer-playbook.md` | Οδηγίες για όσους ελέγχουν τον κώδικα άλλων. | + +## Σχέδια για το Μέλλον (Προτάσεις) + +- `docs/security-roadmap.md`: Τα επόμενα βήματα για την ασφάλεια. +- `docs/sandboxing.md`: Ιδέες για την απομόνωση των εργασιών. +- `docs/resource-limits.md`: Σχέδια για τον περιορισμό της κατανάλωσης πόρων. + +--- + +## Συμβουλή για τη Συντήρηση + +Αν προσθέσετε ένα νέο έγγραφο, μην ξεχάσετε να το προσθέσετε και σε αυτή τη λίστα και στον κεντρικό Πίνακα Περιεχομένων (`docs/SUMMARY.el.md`). diff --git a/docs/i18n/el/frictionless-security.md b/docs/i18n/el/frictionless-security.md new file mode 100644 index 000000000..2de26f4eb --- /dev/null +++ b/docs/i18n/el/frictionless-security.md @@ -0,0 +1,42 @@ +# Απλή και Αθόρυβη Ασφάλεια (Frictionless Security) + +> ⚠️ **Κατάσταση: Πρόταση / Σχέδιο για το μέλλον** + +Αυτό το έγγραφο περιγράφει μια ιδέα για το πώς η ασφάλεια στο ZeroClaw μπορεί να γίνει "σαν τον αερόσακο": να είναι πάντα εκεί για να σας προστατεύει, αλλά να μην την βλέπετε μέχρι να χρειαστεί. + +## Η Βασική Ιδέα + +Θέλουμε η ασφάλεια να λειτουργεί αυτόματα, χωρίς να χρειάζεται ο χρήστης να κάνει δύσκολες ρυθμίσεις. + +### 1. Αυτόματος Εντοπισμός (Auto-Detection) + +Όταν ξεκινάτε το ZeroClaw για πρώτη φορά, το σύστημα θα ελέγχει μόνο του: +- Τι είδους προστασία υποστηρίζει ο υπολογιστής σας (π.χ. Landlock στο Linux). +- Πόση μνήμη είναι διαθέσιμη. +- Πού μπορεί να αποθηκεύει με ασφάλεια τις καταγραφές (logs). + +### 2. Καμία νέα ερώτηση στην εγκατάσταση + +Η εγκατάσταση θα παραμείνει απλή (9 βήματα). Δεν θα σας ζητάμε να ρυθμίσετε την ασφάλεια χειροκίνητα, εκτός αν είστε προχωρημένος χρήστης και το θέλετε. + +## Πώς θα φαίνεται στον χρήστη + +Όταν τρέχετε το ZeroClaw, θα βλέπετε απλά μηνύματα επιβεβαίωσης: +- ✓ Η απομόνωση (sandbox) ενεργοποιήθηκε αυτόματα. +- ✓ Το όριο μνήμης ορίστηκε στα 512MB. +- ✓ Η καταγραφή ενεργειών ξεκίνησε. + +## Για Προχωρημένους Χρήστες + +Αν θέλετε τον απόλυτο έλεγχο, θα μπορείτε πάντα να αλλάξετε τις ρυθμίσεις στο αρχείο `config.toml` ή με εντολές όπως: +`zeroclaw security --status` (για να δείτε τι είναι ενεργό). + +## Τα Οφέλη της "Αθόρυβης" Ασφάλειας + +- **Ταχύτητα**: Η εγκατάσταση τελειώνει σε λιγότερο από 1 λεπτό. +- **Προστασία για όλους**: Ακόμα και αν δεν ξέρετε τι είναι το "sandboxing", το σύστημα θα σας προστατεύει αυτόματα. +- **Ευελιξία**: Αν ο υπολογιστής σας δεν υποστηρίζει μια συγκεκριμένη μέθοδο ασφαλείας, το ZeroClaw θα βρίσκει αυτόματα την επόμενη καλύτερη λύση. + +--- + +**Σύνοψη**: Η ασφάλεια πρέπει να βοηθάει τον χρήστη, όχι να τον σταματάει. Με αυτό το σχέδιο, το ZeroClaw γίνεται πιο ασφαλές χωρίς να γίνεται πιο δύσκολο. diff --git a/docs/i18n/el/getting-started/README.md b/docs/i18n/el/getting-started/README.md new file mode 100644 index 000000000..3e29be6e6 --- /dev/null +++ b/docs/i18n/el/getting-started/README.md @@ -0,0 +1,37 @@ +# Πρώτα Βήματα (Getting Started) + +Οδηγίες για την αρχική εγκατάσταση και την εξοικείωση με το οικοσύστημα του ZeroClaw. + +--- + +## Πώς να Ξεκινήσετε + +1. **Γενική Παρουσίαση**: Ανατρέξτε στο κεντρικό [README.md](../README.md). +2. **Ταχεία Εγκατάσταση**: Χρησιμοποιήστε τον [Οδηγό ενός κλικ](../one-click-bootstrap.md). +3. **Αναφορά Εντολών**: Δείτε το [Commands Reference](../commands-reference.md). + +--- + +## Επιλογές Διαμόρφωσης (Onboarding) + +| Σενάριο Χρήσης | Εντολή CLI | +|:---|:---| +| Διαθέτω API Key και επιθυμώ άμεση ρύθμιση | `zeroclaw onboard --api-key sk-... --provider openrouter` | +| Επιθυμώ διαδραστική καθοδήγηση (Step-by-step) | `zeroclaw onboard --interactive` | +| Επιθυμώ μόνο τη ρύθμιση καναλιών επικοινωνίας | `zeroclaw onboard --channels-only` | +| Επιθυμώ πλήρη αντικατάσταση υπαρχουσών ρυθμίσεων | `zeroclaw onboard --force` | + +--- + +## Ρύθμιση και Έλεγχος + +- **Ασφάλεια Ρυθμίσεων**: Το σύστημα απαιτεί επιβεβαίωση για την τροποποίηση υπαρχουσών ρυθμίσεων (εκτός αν χρησιμοποιηθεί το `--force`). +- **Cloud Providers**: Μοντέλα όπως το Ollama Cloud απαιτούν τον ορισμό των `api_url` και `api_key`. +- **Έλεγχος Υγείας**: Μετά την εγκατάσταση, εκτελέστε τις εντολές `zeroclaw status` και `zeroclaw doctor` για την επαλήθευση της σωστής λειτουργίας. + +--- + +## Επόμενα Βήματα + +- **Λειτουργίες & Ανάπτυξη**: [../operations/README.md](../operations/README.md) +- **Τεχνικοί Κατάλογοι**: [../reference/README.md](../reference/README.md) diff --git a/docs/i18n/el/getting-started/macos-update-uninstall.md b/docs/i18n/el/getting-started/macos-update-uninstall.md new file mode 100644 index 000000000..cd8daf779 --- /dev/null +++ b/docs/i18n/el/getting-started/macos-update-uninstall.md @@ -0,0 +1,112 @@ +# Οδηγός Ενημέρωσης και Απεγκατάστασης στο macOS + +Αυτή η σελίδα τεκμηριώνει τις υποστηριζόμενες διαδικασίες ενημέρωσης και απεγκατάστασης του ZeroClaw στο macOS (OS X). + +Τελευταία επαλήθευση: **22 Φεβρουαρίου 2026**. + +## 1) Έλεγχος τρέχουσας μεθόδου εγκατάστασης + +```bash +which zeroclaw +zeroclaw --version +``` + +Τυπικές τοποθεσίες: + +- Homebrew: `/opt/homebrew/bin/zeroclaw` (Apple Silicon) ή `/usr/local/bin/zeroclaw` (Intel) +- Cargo/bootstrap/χειροκίνητη: `~/.cargo/bin/zeroclaw` + +Αν υπάρχουν και οι δύο, η σειρά `PATH` του shell σας καθορίζει ποια εκτελείται. + +## 2) Ενημέρωση στο macOS + +### Α) Εγκατάσταση μέσω Homebrew + +```bash +brew update +brew upgrade zeroclaw +zeroclaw --version +``` + +### Β) Εγκατάσταση μέσω Clone + bootstrap + +Από τον τοπικό κλώνο του αποθετηρίου: + +```bash +git pull --ff-only +./bootstrap.sh --prefer-prebuilt +zeroclaw --version +``` + +Αν θέλετε ενημέρωση μόνο από πηγαίο κώδικα: + +```bash +git pull --ff-only +cargo install --path . --force --locked +zeroclaw --version +``` + +### Γ) Χειροκίνητη εγκατάσταση προκατασκευασμένου binary + +Επαναλάβετε τη ροή λήψης/εγκατάστασης με το πιο πρόσφατο αρχείο έκδοσης και επαληθεύστε: + +```bash +zeroclaw --version +``` + +## 3) Απεγκατάσταση στο macOS + +### Α) Διακοπή και αφαίρεση υπηρεσίας background πρώτα + +Αυτό αποτρέπει τη συνέχεια εκτέλεσης του daemon μετά την αφαίρεση του binary. + +```bash +zeroclaw service stop || true +zeroclaw service uninstall || true +``` + +Αντικείμενα υπηρεσίας που αφαιρούνται από την `service uninstall`: + +- `~/Library/LaunchAgents/com.zeroclaw.daemon.plist` + +### Β) Αφαίρεση binary ανά μέθοδο εγκατάστασης + +Homebrew: + +```bash +brew uninstall zeroclaw +``` + +Cargo/bootstrap/χειροκίνητη (`~/.cargo/bin/zeroclaw`): + +```bash +cargo uninstall zeroclaw || true +rm -f ~/.cargo/bin/zeroclaw +``` + +### Γ) Προαιρετικά: αφαίρεση τοπικών δεδομένων εκτέλεσης + +Εκτελέστε αυτό μόνο αν θέλετε πλήρη εκκαθάριση ρυθμίσεων, προφίλ auth, logs και κατάστασης workspace. + +```bash +rm -rf ~/.zeroclaw +``` + +## 4) Επαλήθευση ολοκλήρωσης απεγκατάστασης + +```bash +command -v zeroclaw || echo "zeroclaw binary not found" +pgrep -fl zeroclaw || echo "No running zeroclaw process" +``` + +Αν το `pgrep` εξακολουθεί να βρίσκει διεργασία, σταματήστε την χειροκίνητα και ελέγξτε ξανά: + +```bash +pkill -f zeroclaw +``` + +## Σχετικά Έγγραφα + +- [One-Click Bootstrap](../one-click-bootstrap.md) +- [Αναφορά Εντολών](../commands-reference.md) +- [Αντιμετώπιση Προβλημάτων](../troubleshooting.md) diff --git a/docs/i18n/el/hardware-peripherals-design.md b/docs/i18n/el/hardware-peripherals-design.md new file mode 100644 index 000000000..15ec353dc --- /dev/null +++ b/docs/i18n/el/hardware-peripherals-design.md @@ -0,0 +1,49 @@ +# Σχεδιασμός Σύνδεσης με Υλικό (Hardware) + +Το ZeroClaw μπορεί να ελέγχει ηλεκτρονικές πλακέτες (όπως το Arduino, το ESP32 ή το Raspberry Pi) χρησιμοποιώντας απλά λόγια. Για παράδειγμα, μπορείτε να του πείτε "Άναψε το λαμπάκι (LED)" και αυτό θα βρει πώς να το κάνει. + +## Πώς λειτουργεί + +Το ZeroClaw λειτουργεί σαν ένας "έξυπνος εγκέφαλος" που: +1. **Ακούει**: Δέχεται την εντολή σας από το WhatsApp ή το Telegram. +2. **Διαβάζει**: Ψάχνει στις οδηγίες της πλακέτας σας για να βρει πού είναι συνδεδεμένο το κάθε εξάρτημα. +3. **Γράφει κώδικα**: Φτιάχνει αυτόματα το πρόγραμμα που χρειάζεται. +4. **Εκτελεί**: Στέλνει την εντολή στην πλακέτα για να κινηθεί ένας βραχίονας ή να ανάψει ένα φως. + +--- + +## Δύο τρόποι σύνδεσης + +### 1. Αυτόνομη λειτουργία (Edge-Native) + +Αυτός ο τρόπος είναι για πλακέτες που έχουν Wi-Fi (π.χ. ESP32, Raspberry Pi). +- **Πώς δουλεύει**: Το ZeroClaw τρέχει **μέσα** στην ίδια την πλακέτα. +- **Πλεονέκτημα**: Η πλακέτα είναι ανεξάρτητη και δεν χρειάζεται υπολογιστή για να λειτουργήσει. + +### 2. Σύνδεση μέσω υπολογιστή (Host-Mediated) + +Αυτός ο τρόπος είναι για απλές πλακέτες που συνδέονται με USB στον υπολογιστή σας (π.χ. STM32 Nucleo). +- **Πώς δουλεύει**: Το ZeroClaw τρέχει στον **υπολογιστή** σας και στέλνει εντολές στην πλακέτα μέσω του καλωδίου USB. +- **Πλεονέκτημα**: Είναι ιδανικό για δοκιμές και για να βλέπετε τι συμβαίνει μέσα στην πλακέτα την ώρα που δουλεύει. + +--- + +## Τι μπορείτε να κάνετε με το ZeroClaw + +- **Έλεγχος ακίδων (GPIO)**: Να ανάβετε φώτα ή να διαβάζετε αν πατήθηκε ένα κουμπί. +- **Ανάγνωση αισθητήρων**: Να μαθαίνετε τη θερμοκρασία ή την υγρασία από την πλακέτα. +- **Προγραμματισμός (Flashing)**: Να περνάτε νέο λογισμικό στην πλακέτα σας με μια απλή εντολή. +- **Αυτόματη αναγνώριση**: Το ZeroClaw μπορεί να καταλάβει μόνο του ποια πλακέτα συνδέσατε στο USB. + +--- + +## Ασφάλεια + +Το ZeroClaw προσέχει να μην κάνει ζημιά στο υλικό σας: +- Επιτρέπει μόνο συγκεκριμένες εντολές. +- Μπορείτε να ορίσετε ποιες ακίδες της πλακέτας επιτρέπεται να πειράξει. +- Δεν αποθηκεύει κωδικούς (passwords) μέσα στην πλακέτα για μεγαλύτερη ασφάλεια. + +--- + +**Σύνοψη**: Με το ZeroClaw, ο έλεγχος των ηλεκτρονικών γίνεται τόσο εύκολος όσο το να στέλνετε ένα μήνυμα στο κινητό σας. diff --git a/docs/i18n/el/hardware/README.md b/docs/i18n/el/hardware/README.md new file mode 100644 index 000000000..216de66c2 --- /dev/null +++ b/docs/i18n/el/hardware/README.md @@ -0,0 +1,31 @@ +# Τεκμηρίωση Υλικού και Περιφερειακών (Hardware) + +Οδηγίες για την ενσωμάτωση πλακετών, τη διαχείριση υλικολογισμικού (firmware) και την αρχιτεκτονική περιφερειακών του ZeroClaw. + +--- + +## 1. Υποσύστημα Υλικού + +Το ZeroClaw επιτρέπει τον άμεσο έλεγχο μικροελεγκτών και περιφερειακών συσκευών μέσω του trait `Peripheral`. Κάθε υποστηριζόμενη πλακέτα εκθέτει εξειδικευμένα εργαλεία για λειτουργίες **GPIO**, **ADC** και ανάγνωση αισθητήρων. + +Η αλληλεπίδραση με το υλικό καθοδηγείται από τον πράκτορα (agent-driven), υποστηρίζοντας πλατφόρμες όπως: +- **STM32 Nucleo** +- **ESP32** +- **Raspberry Pi** +- **Arduino** + +## 2. Τεχνική Τεκμηρίωση + +- **Αρχιτεκτονική Περιφερειακών**: [../hardware-peripherals-design.md](../hardware-peripherals-design.md) +- **Ανάπτυξη Νέων Πλακετών/Εργαλείων**: [../adding-boards-and-tools.md](../adding-boards-and-tools.md) +- **Οδηγός Ρύθμισης Nucleo**: [../nucleo-setup.md](../nucleo-setup.md) +- **Οδηγός Ρύθμισης Arduino Uno R4 WiFi**: [../arduino-uno-q-setup.md](../arduino-uno-q-setup.md) + +--- + +## 3. Φύλλα Δεδομένων (Datasheets) + +- **Ευρετήριο Φύλλων Δεδομένων**: [../datasheets/README.md](../datasheets/README.md) +- **STM32 Nucleo-F401RE**: [../datasheets/nucleo-f401re.md](../datasheets/nucleo-f401re.md) +- **Arduino Uno**: [../datasheets/arduino-uno.md](../datasheets/arduino-uno.md) +- **ESP32**: [../datasheets/esp32.md](../datasheets/esp32.md) diff --git a/docs/i18n/el/i18n-coverage.md b/docs/i18n/el/i18n-coverage.md new file mode 100644 index 000000000..c29fe0fc1 --- /dev/null +++ b/docs/i18n/el/i18n-coverage.md @@ -0,0 +1,12 @@ +# Χάρτης Κάλυψης i18n (Ελληνικά) + +Αυτή η σελίδα είναι συνοπτική τοπικοποιημένη γέφυρα για τον πίνακα κάλυψης i18n. + +Αγγλικό πρωτότυπο: + +- [../../i18n-coverage.md](../../i18n-coverage.md) + +## Σκοπός + +- Να φαίνεται ποιες γλώσσες έχουν full localized tree και ποιες είναι hub-level scaffold. +- Να καθοδηγεί ενημερώσεις coverage μετά από αλλαγές docs. diff --git a/docs/i18n/el/i18n-gap-backlog.md b/docs/i18n/el/i18n-gap-backlog.md new file mode 100644 index 000000000..104d12740 --- /dev/null +++ b/docs/i18n/el/i18n-gap-backlog.md @@ -0,0 +1,13 @@ +# Backlog Κενών i18n (Ελληνικά) + +Αυτή η σελίδα είναι συνοπτική τοπικοποιημένη γέφυρα για το backlog κενών i18n. + +Αγγλικό πρωτότυπο: + +- [../../i18n-gap-backlog.md](../../i18n-gap-backlog.md) + +## Σύνοψη + +- Παρακολουθεί κενά ανά locale σε σχέση με το baseline `docs/*.md`. +- Καταγράφει completion waves για `zh-CN`/`ja`/`ru`/`fr`. +- Ενημερώνεται μαζί με το `i18n-coverage.md` μετά από κάθε κύμα τοπικοποίησης. diff --git a/docs/i18n/el/i18n-guide.md b/docs/i18n/el/i18n-guide.md new file mode 100644 index 000000000..7a85dd631 --- /dev/null +++ b/docs/i18n/el/i18n-guide.md @@ -0,0 +1,14 @@ +# Οδηγός Ολοκλήρωσης i18n (Ελληνικά) + +Αυτή η σελίδα είναι συνοπτική τοπικοποιημένη γέφυρα για τον οδηγό i18n completion. + +Αγγλικό πρωτότυπο: + +- [../../i18n-guide.md](../../i18n-guide.md) + +## Υποχρεωτικά βήματα + +- Όταν αλλάζει docs IA/navigation/shared wording, κάντε i18n follow-through στο ίδιο PR. +- Ενημερώστε parity σε root README, docs hub και SUMMARY. +- Ενημερώστε `i18n-coverage.md` όταν αλλάζει topology/coverage. +- Αν απαιτείται defer, δηλώστε owner + follow-up issue/PR. diff --git a/docs/i18n/el/langgraph-integration.md b/docs/i18n/el/langgraph-integration.md new file mode 100644 index 000000000..ec4ad4052 --- /dev/null +++ b/docs/i18n/el/langgraph-integration.md @@ -0,0 +1,65 @@ +# Χρήση του ZeroClaw με Python (LangGraph) + +Αυτός ο οδηγός εξηγεί πώς να χρησιμοποιήσετε το πακέτο `zeroclaw-tools` στην Python για να κάνετε την AI πιο σταθερή όταν χρησιμοποιεί εργαλεία. + +## Γιατί να το χρησιμοποιήσετε + +Μερικά μοντέλα AI (όπως το GLM-5) μπορεί μερικές φορές να μπερδεύονται όταν τους ζητάτε να χρησιμοποιήσουν ένα εργαλείο. Το **LangGraph** βοηθάει την AI να ακολουθεί μια συγκεκριμένη σειρά βημάτων, ώστε να μην κάνει λάθη. + +--- + +## Πώς να ξεκινήσετε + +### 1. Εγκατάσταση + +Γράψτε στο τερματικό σας: +`pip install zeroclaw-tools` + +### 2. Παράδειγμα Κώδικα + +Εδώ είναι ένας απλός τρόπος να ζητήσετε από την AI να διαβάσει ένα αρχείο: + +```python +import asyncio +from zeroclaw_tools import create_agent, shell, file_read + +async def main(): + # Δημιουργία του βοηθού (agent) + agent = create_agent( + tools=[shell, file_read], + model="glm-5", + api_key="το-κλειδί-σας" + ) + + # Ερώτηση προς την AI + result = await agent.ainvoke({ + "messages": [{"role": "user", "content": "Πες μου το όνομα του υπολογιστή"}] + }) + + print(result["messages"][-1].content) + +asyncio.run(main()) +``` + +--- + +## Τι εργαλεία έχετε στη διάθεσή σας + +- **Shell**: Για να τρέχετε εντολές στον υπολογιστή. +- **File Read/Write**: Για να διαβάζετε και να γράφετε αρχεία. +- **Web Search**: Για να ψάχνετε πληροφορίες στο ίντερνετ. +- **Memory**: Για να "θυμάται" η AI πληροφορίες από προηγούμενες συζητήσεις. + +--- + +## Πότε να χρησιμοποιήσετε την έκδοση Python + +| Χρησιμοποιήστε Rust αν: | Χρησιμοποιήστε Python αν: | +|---|---| +| Θέλετε μέγιστη ταχύτητα. | Θέλετε να φτιάξετε γρήγορα κάτι νέο. | +| Έχετε λίγη μνήμη (π.χ. Raspberry Pi). | Δουλεύετε ήδη με Python. | +| Η AI σας είναι ήδη πολύ σταθερή. | Η AI σας κάνει συχνά λάθη με τα εργαλεία. | + +--- + +**Σύνοψη**: Το `zeroclaw-tools` στην Python είναι ο εύκολος τρόπος να δώσετε "χέρια" στην AI σας, ειδικά αν χρησιμοποιείτε μοντέλα που χρειάζονται λίγη παραπάνω βοήθεια για να λειτουργήσουν σωστά. diff --git a/docs/i18n/el/matrix-e2ee-guide.md b/docs/i18n/el/matrix-e2ee-guide.md new file mode 100644 index 000000000..1045db8b2 --- /dev/null +++ b/docs/i18n/el/matrix-e2ee-guide.md @@ -0,0 +1,51 @@ +# Οδηγός Matrix και Κρυπτογράφησης (E2EE) + +Αυτός ο οδηγός σας βοηθάει να συνδέσετε το ZeroClaw με το Matrix και να λύσετε προβλήματα, ειδικά σε δωμάτια με κρυπτογράφηση (E2EE). + +## Γιατί το bot δεν απαντάει; (Γρήγορος έλεγχος) + +Αν το bot φαίνεται συνδεδεμένο αλλά δεν σας απαντάει, ελέγξτε αυτά τα 5 πράγματα: +1. **Επιτρεπόμενοι χρήστες**: Βεβαιωθείτε ότι το όνομά σας είναι στη λίστα `allowed_users` (για δοκιμή βάλτε `["*"]`). +2. **Συμμετοχή στο δωμάτιο**: Μπήκε το bot στο συγκεκριμένο δωμάτιο; +3. **Κλειδί πρόσβασης (Token)**: Είναι σωστό το Token που βάλατε στις ρυθμίσεις; +4. **Κρυπτογράφηση**: Σε κλειδωμένα δωμάτια, το bot χρειάζεται χρόνο για να "μάθει" τα κλειδιά. +5. **Επανεκκίνηση**: Κάνατε επανεκκίνηση το ZeroClaw μετά τις αλλαγές; + +--- + +## Βασικές Ρυθμίσεις + +Στο αρχείο `config.toml`, η ενότητα για το Matrix πρέπει να φαίνεται κάπως έτσι: + +```toml +[channels_config.matrix] +homeserver = "https://matrix.example.com" +access_token = "το-Token-σας" +room_id = "!id-δωματίου:matrix.org" +allowed_users = ["*"] # Επιτρέπει σε όλους (μόνο για δοκιμή!) +``` + +--- + +## Αντιμετώπιση Προβλημάτων + +### Α. Το δωμάτιο είναι κρυπτογραφημένο + +Αν το δωμάτιο έχει κρυπτογράφηση (E2EE), το bot πρέπει να "επαληθευτεί" από εσάς. +- Ανοίξτε το Matrix από το κινητό ή τον υπολογιστή σας. +- Βρείτε το bot στη λίστα χρηστών και πατήστε "Επαλήθευση" (Verify). +- Αν δεν το κάνετε, το bot μπορεί να διαβάζει τα μηνύματα αλλά να μην μπορεί να τα αποκρυπτογραφήσει. + +### Β. Το Token δεν λειτουργεί + +Μπορείτε να ελέγξετε αν το Token σας είναι σωστό γράφοντας αυτή την εντολή στο τερματικό: +`curl -H "Authorization: Bearer ΤΟ_TOKEN_ΣΑΣ" https://matrix.org/_matrix/client/v3/account/whoami` +Αν σας επιστρέψει το όνομα του bot, τότε το Token είναι σωστό. + +### Γ. Μορφοποίηση μηνυμάτων + +Το bot στέλνει μηνύματα χρησιμοποιώντας **Markdown**. Αυτό σημαίνει ότι μπορεί να στέλνει λίστες, έντονα γράμματα ή κώδικα. Αν τα βλέπετε όλα σαν απλό κείμενο, ελέγξτε τις ρυθμίσεις της εφαρμογής Matrix που χρησιμοποιείτε. + +--- + +**Σύνοψη**: Η σύνδεση με το Matrix είναι ασφαλής αλλά θέλει προσοχή στις ρυθμίσεις του δωματίου και της επαλήθευσης της συσκευής. Αν ακολουθήσετε τα παραπάνω βήματα, το bot θα λειτουργήσει σύντομα! diff --git a/docs/i18n/el/mattermost-setup.md b/docs/i18n/el/mattermost-setup.md new file mode 100644 index 000000000..9697baa5e --- /dev/null +++ b/docs/i18n/el/mattermost-setup.md @@ -0,0 +1,61 @@ +# Οδηγός Ενσωμάτωσης Mattermost + +Το ZeroClaw παρέχει εγγενή υποστήριξη για το Mattermost μέσω του REST API v4. Η ενσωμάτωση αυτή είναι ιδανική για περιβάλλοντα αυτοφιλοξενούμενα (self-hosted), ιδιωτικά ή απομονωμένα (air-gapped), όπου η προστασία των δεδομένων επικοινωνίας είναι πρωταρχικής σημασίας. + +## Προαπαιτούμενα + +1. **Διακομιστής Mattermost**: Μια ενεργή εγκατάσταση (self-hosted ή Cloud). +2. **Λογαριασμός Bot**: + - Μεταβείτε στο **Main Menu > Integrations > Bot Accounts**. + - Επιλέξτε **Add Bot Account**. + - Ορίστε ένα όνομα χρήστη (π.χ. `zeroclaw-bot`). + - Εκχωρήστε τα δικαιώματα `post:all` και `channel:read`. + - Αποθηκεύστε το **Access Token**. +3. **ID Καναλιού (Channel ID)**: + - Ανοίξτε το κανάλι που θα παρακολουθεί το bot. + - Επιλέξτε την κεφαλίδα του καναλιού και πατήστε **View Info**. + - Αντιγράψτε το **ID** (π.χ. `7j8k9l...`). + +## Ρύθμιση + +Προσθέστε τα παρακάτω στο αρχείο `config.toml`, στην ενότητα `[channels_config.mattermost]`: + +```toml +[channels_config.mattermost] +url = "https://mm.your-domain.com" +bot_token = "το-access-token-του-bot-σας" +channel_id = "το-id-καναλιού-σας" +allowed_users = ["user-id-1", "user-id-2"] +thread_replies = true +mention_only = true +``` + +### Παράμετροι Ρύθμισης + +| Παράμετρος | Περιγραφή | +|:---|:---| +| `url` | Το βασικό URL του διακομιστή Mattermost. | +| `bot_token` | Το Προσωπικό Διακριτικό Πρόσβασης (PAT) του λογαριασμού bot. | +| `channel_id` | Το ID του καναλιού προς παρακολούθηση (απαιτείται για τη λειτουργία `listen`). | +| `allowed_users` | Λίστα με ID χρηστών που επιτρέπεται να αλληλεπιδρούν με το bot. Χρησιμοποιήστε `["*"]` για καθολική πρόσβαση. | +| `thread_replies` | Εάν οι απαντήσεις θα δημιουργούν νήμα (thread). Προεπιλογή: `true`. | +| `mention_only` | Εάν το bot θα επεξεργάζεται μόνο μηνύματα που το αναφέρουν ρητά (π.χ. `@zeroclaw-bot`). Προεπιλογή: `false`. | + +## Διαχείριση Νημάτων (Threaded Conversations) + +Το ZeroClaw διαχειρίζεται αυτόματα τα νήματα στο Mattermost: +- Εάν ένας χρήστης απαντήσει σε υπάρχον νήμα, το ZeroClaw θα απαντήσει εντός του ίδιου νήματος. +- Εάν `thread_replies = true`, κάθε νέα απάντηση του bot σε μήνυμα κορυφαίου επιπέδου θα δημιουργεί ένα νέο νήμα. +- Εάν `thread_replies = false`, οι απαντήσεις θα δημοσιεύονται απευθείας στο κανάλι. + +## Λειτουργία Μόνο με Αναφορά (Mention-Only) + +Όταν η επιλογή `mention_only` είναι ενεργή, το ZeroClaw: +- Αγνοεί μηνύματα που δεν περιλαμβάνουν ρητή αναφορά στο όνομα χρήστη του bot. +- Αφαιρεί το διακριτικό `@bot_username` πριν από την επεξεργασία του μηνύματος από το μοντέλο AI. + +Αυτή η λειτουργία συνιστάται για πολυσύχναστα κανάλια, προκειμένου να αποφεύγεται η άσκοπη χρήση πόρων. + +## Ασφάλεια και Ιδιωτικότητα + +Η ενσωμάτωση έχει σχεδιαστεί για **ελεγχόμενη επικοινωνία**. Με τη χρήση ενός self-hosted διακομιστή Mattermost, το ιστορικό των συνομιλιών παραμένει αποκλειστικά στην υποδομή σας, διασφαλίζοντας την ιδιωτικότητα του πράκτορα AI. diff --git a/docs/i18n/el/network-deployment.md b/docs/i18n/el/network-deployment.md new file mode 100644 index 000000000..029fa1846 --- /dev/null +++ b/docs/i18n/el/network-deployment.md @@ -0,0 +1,266 @@ +# Ανάπτυξη Δικτύου — ZeroClaw σε Raspberry Pi και Τοπικό Δίκτυο + +Αυτό το έγγραφο καλύπτει την ανάπτυξη του ZeroClaw σε ένα Raspberry Pi ή σε άλλον κεντρικό υπολογιστή στο τοπικό σας δίκτυο, με κανάλια Telegram και προαιρετικά κανάλια webhook. + +--- + +## 1. Επισκόπηση + +| Λειτουργία | Απαιτείται εισερχόμενη θύρα; | Περίπτωση χρήσης | +|------|----------------------|----------| +| **Telegram polling** | Όχι | Το ZeroClaw αντλεί δεδομένα από το API του Telegram. Λειτουργεί από παντού. | +| **Matrix sync (συμπ. E2EE)** | Όχι | Το ZeroClaw συγχρονίζεται μέσω του API του Matrix. Δεν απαιτείται εισερχόμενο webhook. | +| **Discord/Slack** | Όχι | Το ίδιο — μόνο εξερχόμενες συνδέσεις. | +| **Nostr** | Όχι | Συνδέεται με relays μέσω WebSocket. Μόνο εξερχόμενες συνδέσεις. | +| **Gateway webhook** | Ναι | Τα POST /webhook, /whatsapp, /linq, /nextcloud-talk απαιτούν δημόσιο URL. | +| **Gateway pairing** | Ναι | Εάν αντιστοιχίζετε πελάτες μέσω της πύλης (gateway). | +| **Υπηρεσία Alpine/OpenRC** | Όχι | Υπηρεσία παρασκηνίου σε όλο το σύστημα στο Alpine Linux. | + +**Σημείωση:** Τα Telegram, Discord, Slack και Nostr χρησιμοποιούν **εξερχόμενες συνδέσεις** — το ZeroClaw συνδέεται σε εξωτερικούς διακομιστές. Δεν απαιτείται προώθηση θυρών (port forwarding) ή δημόσια IP. + +--- + +## 2. ZeroClaw σε Raspberry Pi + +### 2.1 Προαπαιτούμενα + +- Raspberry Pi (3/4/5) με Raspberry Pi OS. +- Περιφερειακά USB (Arduino, Nucleo) εάν χρησιμοποιείτε σειριακή μεταφορά. +- Προαιρετικά: `rppal` για εγγενές GPIO (λειτουργία `peripheral-rpi`). + +### 2.2 Εγκατάσταση + +```bash +# Μεταγλώττιση για RPi (ή διασταυρούμενη μεταγλώττιση από τον κεντρικό υπολογιστή) +cargo build --release --features hardware + +# Ή εγκαταστήστε το μέσω της μεθόδου που προτιμάτε +``` + +### 2.3 Ρύθμιση + +Επεξεργαστείτε το αρχείο `~/.zeroclaw/config.toml`: + +```toml +[peripherals] +enabled = true + +[[peripherals.boards]] +board = "rpi-gpio" +transport = "native" + +# Ή Arduino μέσω USB +[[peripherals.boards]] +board = "arduino-uno" +transport = "serial" +path = "/dev/ttyACM0" +baud = 115200 + +[channels_config.telegram] +bot_token = "ΤΟ_TOKEN_ΤΟΥ_BOT_ΣΑΣ" +allowed_users = [] + +[gateway] +host = "127.0.0.1" +port = 42617 +allow_public_bind = false +``` + +### 2.4 Εκτέλεση Δαίμονα (Μόνο τοπικά) + +```bash +zeroclaw daemon --host 127.0.0.1 --port 42617 +``` + +- Η πύλη (gateway) συνδέεται στο `127.0.0.1` — δεν είναι προσβάσιμη από άλλα μηχανήματα. +- Το κανάλι Telegram λειτουργεί: το ZeroClaw αντλεί δεδομένα από το API του Telegram (εξερχόμενη σύνδεση). +- Δεν απαιτείται τείχος προστασίας (firewall) ή προώθηση θυρών. + +--- + +## 3. Σύνδεση στο 0.0.0.0 (Τοπικό Δίκτυο) + +Για να επιτρέψετε σε άλλες συσκευές στο τοπικό σας δίκτυο (LAN) να έχουν πρόσβαση στην πύλη (π.χ. για αντιστοίχιση ή webhooks): + +### 3.1 Επιλογή Α: Ρητή Ενεργοποίηση + +```toml +[gateway] +host = "0.0.0.0" +port = 42617 +allow_public_bind = true +``` + +```bash +zeroclaw daemon --host 0.0.0.0 --port 42617 +``` + +**Ασφάλεια:** Η ρύθμιση `allow_public_bind = true` εκθέτει την πύλη στο τοπικό σας δίκτυο. Χρησιμοποιήστε την μόνο σε έμπιστα δίκτυα LAN. + +### 3.2 Επιλογή Β: Σήραγγα (Tunnel - Προτείνεται για Webhooks) + +Εάν χρειάζεστε ένα **δημόσιο URL** (π.χ. για WhatsApp webhook, εξωτερικούς πελάτες): + +1. Εκτελέστε την πύλη στο localhost: + ```bash + zeroclaw daemon --host 127.0.0.1 --port 42617 + ``` + +2. Ξεκινήστε μια σήραγγα (tunnel): + ```toml + [tunnel] + provider = "tailscale" # ή "ngrok", "cloudflare" + ``` + Ή χρησιμοποιήστε την εντολή `zeroclaw tunnel`. + +3. Το ZeroClaw θα απορρίψει το `0.0.0.0` εκτός εάν η επιλογή `allow_public_bind = true` ή μια σήραγγα είναι ενεργή. + +--- + +## 4. Telegram Polling (Χωρίς εισερχόμενη θύρα) + +Το Telegram χρησιμοποιεί **long-polling** από προεπιλογή: + +- Το ZeroClaw καλεί το `https://api.telegram.org/bot{token}/getUpdates`. +- Δεν απαιτείται εισερχόμενη θύρα ή δημόσια IP. +- Λειτουργεί πίσω από NAT, σε RPi, ή σε οικιακό lab. + +**Ρύθμιση:** + +```toml +[channels_config.telegram] +bot_token = "ΤΟ_TOKEN_ΤΟΥ_BOT_ΣΑΣ" +allowed_users = [] # Άρνηση από προεπιλογή, αντιστοιχίστε τις ταυτότητες ρητά +``` + +Εκτελέστε το `zeroclaw daemon` — το κανάλι Telegram ξεκινά αυτόματα. + +Για την έγκριση ενός λογαριασμού Telegram κατά την εκτέλεση: + +```bash +zeroclaw channel bind-telegram <ΤΑΥΤΟΤΗΤΑ> +``` + +Η `<ΤΑΥΤΟΤΗΤΑ>` μπορεί να είναι ένα αριθμητικό ID χρήστη Telegram ή ένα όνομα χρήστη (χωρίς το `@`). + +### 4.1 Κανόνας Ενιαίου Poller (Σημαντικό) + +Το API των Bot του Telegram υποστηρίζει μόνο έναν ενεργό poller ανά token. + +- Διατηρήστε μόνο μία ενεργή εκτέλεση για το ίδιο token (συνιστάται: η υπηρεσία `zeroclaw daemon`). +- Μην εκτελείτε ταυτόχρονα το `cargo run -- channel start` ή άλλη διαδικασία bot. + +Εάν δείτε το σφάλμα: +`Conflict: terminated by other getUpdates request` +σημαίνει ότι υπάρχει διένεξη. Σταματήστε τις επιπλέον εκτελέσεις και επανεκκινήστε μόνο έναν δαίμονα. + +--- + +## 5. Κανάλια Webhook (WhatsApp, Nextcloud Talk, Προσαρμοσμένα) + +Τα κανάλια που βασίζονται σε webhook χρειάζονται ένα **δημόσιο URL**, ώστε η Meta (WhatsApp) ή ο πελάτης σας να μπορούν να στέλνουν συμβάντα μέσω POST. + +### 5.1 Tailscale Funnel + +```toml +[tunnel] +provider = "tailscale" +``` + +Το Tailscale Funnel εκθέτει την πύλη σας μέσω ενός URL της μορφής `*.ts.net`. Δεν απαιτείται προώθηση θυρών. + +### 5.2 ngrok + +```toml +[tunnel] +provider = "ngrok" +``` + +Ή εκτελέστε το ngrok χειροκίνητα: +```bash +ngrok http 42617 +# Χρησιμοποιήστε το HTTPS URL για το webhook σας +``` + +--- + +## 6. Λίστα Ελέγχου: Ανάπτυξη σε RPi + +- [ ] Μεταγλώττιση με `--features hardware` (και `peripheral-rpi` για εγγενές GPIO). +- [ ] Ρύθμιση των ενοτήτων `[peripherals]` και `[channels_config.telegram]`. +- [ ] Εκτέλεση `zeroclaw daemon --host 127.0.0.1 --port 42617`. +- [ ] Για πρόσβαση σε LAN: `--host 0.0.0.0` + `allow_public_bind = true`. +- [ ] Για webhooks: χρήση Tailscale, ngrok ή Cloudflare tunnel. + +--- + +## 7. OpenRC (Υπηρεσία Alpine Linux) + +Το ZeroClaw υποστηρίζει το OpenRC για το Alpine Linux και άλλες διανομές που χρησιμοποιούν το σύστημα αρχικοποίησης OpenRC. Οι υπηρεσίες OpenRC εκτελούνται **σε όλο το σύστημα** και απαιτούν δικαιώματα root/sudo. + +### 7.1 Προαπαιτούμενα + +- Alpine Linux (ή άλλη διανομή βασισμένη στο OpenRC). +- Πρόσβαση Root ή sudo. +- Ένας αποκλειστικός χρήστης συστήματος `zeroclaw` (δημιουργείται κατά την εγκατάσταση). + +### 7.2 Εγκατάσταση Υπηρεσίας + +```bash +# Εγκατάσταση υπηρεσίας (το OpenRC εντοπίζεται αυτόματα στο Alpine) +sudo zeroclaw service install +``` + +Αυτό δημιουργεί: +- Σενάριο αρχικοποίησης (Init script): `/etc/init.d/zeroclaw` +- Κατάλογο ρυθμίσεων: `/etc/zeroclaw/` +- Κατάλογο καταγραφών (Logs): `/var/log/zeroclaw/` + +### 7.3 Ρύθμιση + +Συνήθως δεν απαιτείται χειροκίνητη αντιγραφή των ρυθμίσεων. Η εντολή `sudo zeroclaw service install` προετοιμάζει αυτόματα το `/etc/zeroclaw`, μεταφέρει την υπάρχουσα κατάσταση από τις ρυθμίσεις του χρήστη σας και ορίζει τις σωστές άδειες για τον χρήστη της υπηρεσίας `zeroclaw`. + +### 7.4 Ενεργοποίηση και Έναρξη + +```bash +# Προσθήκη στο προεπιλεγμένο επίπεδο εκτέλεσης (runlevel) +sudo rc-update add zeroclaw default + +# Έναρξη της υπηρεσίας +sudo rc-service zeroclaw start + +# Έλεγχος κατάστασης +sudo rc-service zeroclaw status +``` + +### 7.5 Διαχείριση Υπηρεσίας + +| Εντολή | Περιγραφή | +|---------|-------------| +| `sudo rc-service zeroclaw start` | Έναρξη του δαίμονα | +| `sudo rc-service zeroclaw stop` | Διακοπή του δαίμονα | +| `sudo rc-service zeroclaw status` | Έλεγχος κατάστασης υπηρεσίας | +| `sudo rc-service zeroclaw restart` | Επανεκκίνηση του δαίμονα | + +### 7.6 Καταγραφές (Logs) + +Το OpenRC δρομολογεί τις καταγραφές στις εξής διαδρομές: + +| Καταγραφή | Διαδρομή | +|-----|------| +| Πρόσβαση/stdout | `/var/log/zeroclaw/access.log` | +| Σφάλματα/stderr | `/var/log/zeroclaw/error.log` | + +Προβολή καταγραφών: + +```bash +sudo tail -f /var/log/zeroclaw/error.log +``` + +--- + +## 8. Αναφορές + +- [channels-reference.md](./channels-reference.md) — Επισκόπηση ρυθμίσεων καναλιών +- [matrix-e2ee-guide.md](./matrix-e2ee-guide.md) — Ρύθμιση Matrix και επίλυση προβλημάτων E2EE +- [hardware-peripherals-design.md](./hardware-peripherals-design.md) — Σχεδιασμός περιφερειακών diff --git a/docs/i18n/el/nextcloud-talk-setup.md b/docs/i18n/el/nextcloud-talk-setup.md new file mode 100644 index 000000000..15f699ba2 --- /dev/null +++ b/docs/i18n/el/nextcloud-talk-setup.md @@ -0,0 +1,68 @@ +# Ρύθμιση Nextcloud Talk + +Αυτός ο οδηγός περιγράφει τη διαδικασία ενσωμάτωσης του Nextcloud Talk με το ZeroClaw. + +## 1. Λειτουργία Ενσωμάτωσης + +- Λήψη συμβάντων webhook από bot του Talk μέσω της διαδρομής `POST /nextcloud-talk`. +- Επαλήθευση ακεραιότητας μηνυμάτων (HMAC-SHA256) μέσω κοινού μυστικού (shared secret). +- Αποστολή απαντήσεων στα δωμάτια του Talk μέσω του Nextcloud OCS API. + +## 2. Ρύθμιση + +Στο αρχείο `~/.zeroclaw/config.toml`, προσθέστε την ενότητα `[channels_config.nextcloud_talk]`: + +```toml +[channels_config.nextcloud_talk] +base_url = "https://cloud.example.com" +app_token = "YOUR_APP_TOKEN" +webhook_secret = "YOUR_WEBHOOK_SECRET" # Προαιρετικό +allowed_users = ["*"] +``` + +### Παράμετροι Ρύθμισης + +- `base_url`: Το βασικό URL της εγκατάστασης Nextcloud. +- `app_token`: Το διακριτικό πρόσβασης (app token) του bot για την εξουσιοδότηση στο OCS API. +- `webhook_secret`: Το κοινό μυστικό για την επαλήθευση της κεφαλίδας `X-Nextcloud-Talk-Signature`. +- `allowed_users`: Λίστα με επιτρεπόμενα ID χρηστών (actors). Χρησιμοποιήστε `["*"]` για καθολική πρόσβαση. + +> **Συμβουλή**: Μπορείτε να χρησιμοποιήσετε τη μεταβλητή περιβάλλοντος `ZEROCLAW_NEXTCLOUD_TALK_WEBHOOK_SECRET` για να παρακάμψετε τη ρύθμιση του αρχείου. + +## 3. Ρύθμιση Τελικού Σημείου (Endpoint) + +Ξεκινήστε τον daemon του ZeroClaw για να εκθέσετε το webhook: + +```bash +zeroclaw daemon +``` + +Στο Nextcloud Talk, ορίστε το URL του webhook για το bot σας ως: +`https:///nextcloud-talk` + +## 4. Επαλήθευση Υπογραφής + +Εάν έχει οριστεί `webhook_secret`, το ZeroClaw επαληθεύει τις κεφαλίδες: +- `X-Nextcloud-Talk-Random` +- `X-Nextcloud-Talk-Signature` + +Ο αλγόριθμος επαλήθευσης είναι: `hex(hmac_sha256(secret, random + raw_request_body))`. Σε περίπτωση αποτυχίας, η πύλη επιστρέφει σφάλμα `401 Unauthorized`. + +## 5. Φιλτράρισμα και Δρομολόγηση + +- Το ZeroClaw αγνοεί συμβάντα που προέρχονται από άλλα bots (`actorType = bots`). +- Αγνοούνται συμβάντα συστήματος ή συμβάντα που δεν περιέχουν μηνύματα. +- Οι απαντήσεις δρομολογούνται αυτόματα στο σωστό δωμάτιο χρησιμοποιώντας το token δωματίου από το payload του webhook. + +## 6. Βήματα Επαλήθευσης + +1. Ορίστε προσωρινά `allowed_users = ["*"]`. +2. Στείλτε ένα δοκιμαστικό μήνυμα στο δωμάτιο του Talk. +3. Επιβεβαιώστε τη λήψη και την απάντηση από το ZeroClaw. +4. Περιορίστε την πρόσβαση ορίζοντας συγκεκριμένα ID χρηστών στο `allowed_users`. + +## 7. Αντιμετώπιση Προβλημάτων + +- **404 Not Configured**: Βεβαιωθείτε ότι υπάρχει η ενότητα `[channels_config.nextcloud_talk]`. +- **401 Invalid Signature**: Ελέγξτε εάν το `webhook_secret` ταυτίζεται με αυτό που έχει οριστεί στο Nextcloud. +- **200 OK χωρίς απάντηση**: Το μήνυμα πιθανώς φιλτραρίστηκε (π.χ. προέρχεται από bot ή μη εξουσιοδοτημένο χρήστη). diff --git a/docs/i18n/el/nucleo-setup.md b/docs/i18n/el/nucleo-setup.md new file mode 100644 index 000000000..ec0c9bd72 --- /dev/null +++ b/docs/i18n/el/nucleo-setup.md @@ -0,0 +1,147 @@ +# ZeroClaw σε Nucleo-F401RE — Οδηγός Βήμα προς Βήμα + +Εκτελέστε το ZeroClaw στον κεντρικό υπολογιστή σας (Mac ή Linux). Συνδέστε ένα Nucleo-F401RE μέσω USB. Ελέγξτε τα GPIO (LED, ακίδες) μέσω Telegram ή CLI. + +--- + +## Λήψη πληροφοριών πλακέτας μέσω Telegram (Χωρίς ανάγκη για υλικολογισμικό) + +Το ZeroClaw μπορεί να διαβάσει πληροφορίες για το τσιπ από το Nucleo μέσω USB **χωρίς να προγραμματίσετε κανένα υλικολογισμικό**. Στείλτε μήνυμα στο bot σας στο Telegram: + +- *"Τι πληροφορίες πλακέτας έχω;"* +- *"Πληροφορίες πλακέτας"* +- *"Ποιο υλικό είναι συνδεδεμένο;"* +- *"Chip info"* + +Ο πράκτορας χρησιμοποιεί το εργαλείο `hardware_board_info` για να επιστρέψει το όνομα του τσιπ, την αρχιτεκτονική και τον χάρτη μνήμης. Με τη λειτουργία `probe`, διαβάζει ζωντανά δεδομένα μέσω USB/SWD· διαφορετικά, επιστρέφει στατικές πληροφορίες από το φύλλο δεδομένων. + +**Ρύθμιση:** Προσθέστε πρώτα το Nucleo στο αρχείο `config.toml` (ώστε ο πράκτορας να γνωρίζει ποια πλακέτα να αναζητήσει): + +```toml +[[peripherals.boards]] +board = "nucleo-f401re" +transport = "serial" +path = "/dev/ttyACM0" +baud = 115200 +``` + +**Εναλλακτική μέσω CLI:** + +```bash +cargo build --features hardware,probe +zeroclaw hardware info +zeroclaw hardware discover +``` + +--- + +## Τι περιλαμβάνεται (Δεν απαιτούνται αλλαγές στον κώδικα) + +Το ZeroClaw περιλαμβάνει όλα τα απαραίτητα για το Nucleo-F401RE: + +| Συστατικό | Τοποθεσία | Σκοπός | +|-----------|----------|---------| +| Υλικολογισμικό (Firmware) | `firmware/zeroclaw-nucleo/` | Embassy Rust — USART2 (115200), gpio_read, gpio_write | +| Σειριακό περιφερειακό | `src/peripherals/serial.rs` | Πρωτόκολλο JSON μέσω σειριακής (όπως στο Arduino/ESP32) | +| Εντολή προγραμματισμού (Flash) | `zeroclaw peripheral flash-nucleo` | Κατασκευάζει το υλικολογισμικό και το προγραμματίζει μέσω probe-rs | + +Πρωτόκολλο: JSON οριοθετημένο με νέα γραμμή. Αίτημα: `{"id":"1","cmd":"gpio_write","args":{"pin":13,"value":1}}`. Απόκριση: `{"id":"1","ok":true,"result":"done"}`. + +--- + +## Προαπαιτούμενα + +- Πλακέτα Nucleo-F401RE. +- Καλώδιο USB (USB-A σε Mini-USB· το Nucleo έχει ενσωματωμένο ST-Link). +- Για τον προγραμματισμό (flashing): `cargo install probe-rs-tools --locked` (ή χρησιμοποιήστε το [σενάριο εγκατάστασης](https://probe.rs/docs/getting-started/installation/)). + +--- + +## Φάση 1: Προγραμματισμός Υλικολογισμικού (Flash) + +### 1.1 Σύνδεση Nucleo + +1. Συνδέστε το Nucleo στον κεντρικό υπολογιστή σας (Mac/Linux) μέσω USB. +2. Η πλακέτα εμφανίζεται ως συσκευή USB (ST-Link). Δεν απαιτείται ξεχωριστός οδηγός στα σύγχρονα συστήματα. + +### 1.2 Προγραμματισμός μέσω ZeroClaw + +Από τον ριζικό κατάλογο του ZeroClaw: + +```bash +zeroclaw peripheral flash-nucleo +``` + +Αυτό κατασκευάζει το `firmware/zeroclaw-nucleo` και εκτελεί την εντολή `probe-rs run --chip STM32F401RETx`. Το υλικολογισμικό εκτελείται αμέσως μετά τον προγραμματισμό. + +### 1.3 Χειροκίνητος Προγραμματισμός (Εναλλακτική) + +```bash +cd firmware/zeroclaw-nucleo +cargo build --release --target thumbv7em-none-eabihf +probe-rs run --chip STM32F401RETx target/thumbv7em-none-eabihf/release/zeroclaw-nucleo +``` + +--- + +## Φάση 2: Εύρεση της Σειριακής Θύρας + +- **macOS:** `/dev/cu.usbmodem*` ή `/dev/tty.usbmodem*` (π.χ. `/dev/cu.usbmodem101`). +- **Linux:** `/dev/ttyACM0` (ή ελέγξτε το `dmesg` μετά τη σύνδεση). + +Το USART2 (PA2/PA3) είναι γεφυρωμένο με την εικονική θύρα COM του ST-Link, οπότε ο κεντρικός υπολογιστής βλέπει μία σειριακή συσκευή. + +--- + +## Φάση 3: Ρύθμιση του ZeroClaw + +Προσθέστε στο αρχείο `~/.zeroclaw/config.toml`: + +```toml +[peripherals] +enabled = true + +[[peripherals.boards]] +board = "nucleo-f401re" +transport = "serial" +path = "/dev/cu.usbmodem101" # προσαρμόστε στη θύρα σας +baud = 115200 +``` + +--- + +## Φάση 4: Εκτέλεση και Δοκιμή + +```bash +zeroclaw daemon --host 127.0.0.1 --port 42617 +``` + +Ή χρησιμοποιήστε τον πράκτορα απευθείας: + +```bash +zeroclaw agent --message "Turn on the LED on pin 13" +``` + +Ακίδα (Pin) 13 = PA5 = LED Χρήστη (LD2) στο Nucleo-F401RE. + +--- + +## Σύνοψη: Εντολές + +| Βήμα | Εντολή | +|------|---------| +| 1 | Συνδέστε το Nucleo μέσω USB | +| 2 | `cargo install probe-rs-tools --locked` | +| 3 | `zeroclaw peripheral flash-nucleo` | +| 4 | Προσθέστε το Nucleo στο config.toml (διαδρομή = η σειριακή σας θύρα) | +| 5 | `zeroclaw daemon` ή `zeroclaw agent -m "Turn on LED"` | + +--- + +## Αντιμετώπιση Προβλημάτων + +- **flash-nucleo unrecognized**: Κατασκευάστε από το αποθετήριο: `cargo run --features hardware -- peripheral flash-nucleo`. Η υποεντολή υπάρχει μόνο στην κατασκευή από το αποθετήριο. +- **probe-rs not found**: `cargo install probe-rs-tools --locked` (το crate `probe-rs` είναι βιβλιοθήκη· το CLI βρίσκεται στο `probe-rs-tools`). +- **No probe detected**: Βεβαιωθείτε ότι το Nucleo είναι συνδεδεμένο. Δοκιμάστε άλλο καλώδιο ή θύρα USB. +- **Serial port not found**: Στο Linux, προσθέστε τον χρήστη στην ομάδα `dialout`: `sudo usermod -a -G dialout $USER`. +- **GPIO commands ignored**: Ελέγξτε αν η διαδρομή (`path`) στις ρυθμίσεις αντιστοιχεί στη σειριακή σας θύρα. Εκτελέστε `zeroclaw peripheral list` για επαλήθευση. diff --git a/docs/i18n/el/one-click-bootstrap.md b/docs/i18n/el/one-click-bootstrap.md new file mode 100644 index 000000000..7ba30706e --- /dev/null +++ b/docs/i18n/el/one-click-bootstrap.md @@ -0,0 +1,104 @@ +# Προετοιμασία με Ένα Κλικ (One-Click Bootstrap) + +Αυτός ο οδηγός περιγράφει την ταχύτερη μέθοδο για την εγκατάσταση και την αρχικοποίηση του ZeroClaw. + +Τελευταία επαλήθευση: **20 Φεβρουαρίου 2026**. + +## Επιλογή 0: Homebrew (macOS / Linux) + +```bash +brew install zeroclaw +``` + +## Επιλογή Α: Τοπικό Σενάριο (Προτεινόμενο) + +1. **Κλωνοποίηση του αποθετηρίου**: + ```bash + git clone https://github.com/zeroclaw-labs/zeroclaw.git + cd zeroclaw + ``` +2. **Εκτέλεση του bootstrap**: + ```bash + ./bootstrap.sh + ``` + +### Λειτουργία Σενάριου + +Από προεπιλογή, το σενάριο εκτελεί: +1. `cargo build --release --locked` +2. `cargo install --path . --force --locked` + +### Απαιτήσεις Πόρων και Προ-μεταγλωττισμένα Αρχεία + +Η μεταγλώττιση από τον πηγαίο κώδικα απαιτεί τουλάχιστον **2GB RAM** και **6GB ελεύθερο χώρο** στον δίσκο. Σε περίπτωση περιορισμένων πόρων, μπορείτε να χρησιμοποιήσετε προ-μεταγλωττισμένα (prebuilt) αρχεία: + +- **Χρήση προ-μεταγλωττισμένων (εάν υπάρχουν)**: + ```bash + ./bootstrap.sh --prefer-prebuilt + ``` +- **Αποκλειστική χρήση προ-μεταγλωττισμένων**: + ```bash + ./bootstrap.sh --prebuilt-only + ``` +- **Επιβολή μεταγλώττισης από πηγαίο κώδικα**: + ```bash + ./bootstrap.sh --force-source-build + ``` + +## Προετοιμασία Περιβάλλοντος (Dual-mode) + +Για νέα συστήματα που δεν διαθέτουν το σύνολο εργαλείων Rust, χρησιμοποιήστε τις παρακάτω σημαίες: +```bash +./bootstrap.sh --install-system-deps --install-rust +``` +- `--install-system-deps`: Εγκαθιστά τις απαραίτητες εξαρτήσεις συστήματος (ενδέχεται να απαιτεί `sudo`). +- `--install-rust`: Εγκαθιστά τη Rust μέσω του `rustup`. + +## Επιλογή Β: Απομακρυσμένη Εκτέλεση + +```bash +curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash +``` +> [!IMPORTANT] +> Για περιβάλλοντα υψηλής ασφάλειας, συνιστάται η **Επιλογή Α**, ώστε να μπορείτε να επιθεωρήσετε το σενάριο πριν από την εκτέλεση. + +## Διαδικασία Εισαγωγής (Onboarding) + +### Μέσω Docker / Podman + +```bash +./bootstrap.sh --docker +``` +Το σενάριο θα δημιουργήσει μια τοπική εικόνα Docker και θα ξεκινήσει τη διαδικασία onboarding. Οι ρυθμίσεις αποθηκεύονται στον κατάλογο `./.zeroclaw-docker`. + +### Μη Διαδραστική Εισαγωγή + +```bash +./bootstrap.sh --onboard --api-key "sk-..." --provider openrouter +``` + +### Διαδραστική Εισαγωγή + +```bash +./bootstrap.sh --interactive-onboard +``` + +## Αναφορά Σημαιών CLI + +- `--install-system-deps`: Εγκατάσταση εξαρτήσεων συστήματος. +- `--install-rust`: Εγκατάσταση του Rust toolchain. +- `--skip-build`: Παράλειψη της διαδικασίας μεταγλώττισης. +- `--skip-install`: Παράλειψη της εγκατάστασης του εκτελέσιμου. +- `--provider `: Ορισμός παρόχου LLM. + +Για την πλήρη λίστα επιλογών, εκτελέστε: +```bash +./bootstrap.sh --help +``` + +## Σχετική Τεκμηρίωση + +- [README.md](../README.md) +- [commands-reference.md](commands-reference.md) +- [providers-reference.md](providers-reference.md) +- [channels-reference.md](channels-reference.md) diff --git a/docs/i18n/el/operations-runbook.md b/docs/i18n/el/operations-runbook.md new file mode 100644 index 000000000..271c085c7 --- /dev/null +++ b/docs/i18n/el/operations-runbook.md @@ -0,0 +1,112 @@ +# Εγχειρίδιο Λειτουργιών ZeroClaw (Operations Runbook) + +Αυτό το εγχειρίδιο προορίζεται για τους διαχειριστές του συστήματος που είναι υπεύθυνοι για τη διαθεσιμότητα, την ασφάλεια και την απόκριση σε περιστατικά. + +Τελευταία επαλήθευση: **18 Φεβρουαρίου 2026**. + +## Πεδίο Εφαρμογής + +Το έγγραφο καλύπτει τις καθημερινές λειτουργίες (Day-2 operations): +- Εκκίνηση και επίβλεψη του runtime. +- Ελέγχους καλής λειτουργίας (health checks) και διαγνωστικά. +- Διαδικασίες ασφαλούς ανάπτυξης (rollout) και επαναφοράς (rollback). +- Διαλογή (triage) και αποκατάσταση μετά από περιστατικά. + +Για την αρχική εγκατάσταση, ανατρέξτε στον οδηγό [one-click-bootstrap.md](one-click-bootstrap.md). + +## Λειτουργίες Χρόνου Εκτέλεσης (Runtime Modes) + +| Λειτουργία | Εντολή | Χρήση | +|:---|:---|:---| +| Προσκήνιο (Foreground) | `zeroclaw daemon` | Τοπική αποσφαλμάτωση και δοκιμές. | +| Πύλη (Gateway) | `zeroclaw gateway` | Έλεγχος τελικών σημείων (endpoints) webhook. | +| Υπηρεσία Συστήματος | `zeroclaw service install && zeroclaw service start` | Μόνιμη εκτέλεση υπό τη διαχείριση του συστήματος. | + +## Βασική Ροή Εργασίας Διαχειριστή + +1. **Επικύρωση Ρυθμίσεων**: + ```bash + zeroclaw status + ``` +2. **Διαγνωστικός Έλεγχος**: + ```bash + zeroclaw doctor + zeroclaw channel doctor + ``` +3. **Εκκίνηση Daemon**: + ```bash + zeroclaw daemon + ``` +4. **Διαχείριση Υπηρεσίας**: + ```bash + zeroclaw service install + zeroclaw service start + zeroclaw service status + ``` + +## Δείκτες Κατάστασης και Υγείας + +| Δείκτης | Εντολή / Αρχείο | Αναμενόμενη Κατάσταση | +|:---|:---|:---| +| Εγκυρότητα Ρυθμίσεων | `zeroclaw doctor` | Επιτυχής έλεγχος χωρίς κρίσιμα σφάλματα. | +| Συνδεσιμότητα Καναλιών | `zeroclaw channel doctor` | Όλα τα ενεργά κανάλια είναι online. | +| Σύνοψη Runtime | `zeroclaw status` | Εμφάνιση σωστών παρόχων και μοντέλων. | +| Daemon Heartbeat | `~/.zeroclaw/daemon_state.json` | Το αρχείο ενημερώνεται σε πραγματικό χρόνο. | + +## Καταγραφές (Logs) και Διαγνωστικά + +- **macOS / Windows**: + - `~/.zeroclaw/logs/daemon.stdout.log` + - `~/.zeroclaw/logs/daemon.stderr.log` +- **Linux (systemd)**: + ```bash + journalctl --user -u zeroclaw.service -f + ``` + +## Διαλογή Περιστατικών (Incident Triage) + +Σε περίπτωση δυσλειτουργίας, ακολουθήστε τα παρακάτω βήματα: + +1. **Ανάλυση Κατάστασης**: + ```bash + zeroclaw status + zeroclaw doctor + zeroclaw channel doctor + ``` +2. **Έλεγχος Υπηρεσίας**: + ```bash + zeroclaw service status + ``` +3. **Επανεκκίνηση**: + Εάν η υπηρεσία δεν αποκρίνεται, πραγματοποιήστε καθαρή επανεκκίνηση: + ```bash + zeroclaw service stop + zeroclaw service start + ``` +4. **Έλεγχος Διαπιστευτηρίων**: + Επαληθεύστε τα API keys και τις λίστες επιτρεπόμενων χρηστών στο `~/.zeroclaw/config.toml`. +5. **Έλεγχος Πύλης**: + Επαληθεύστε τις ρυθμίσεις σύνδεσης στην ενότητα `[gateway]` και την τοπική συνδεσιμότητα. + +## Διαδικασία Αλλαγών (Safe Change Management) + +1. Δημιουργήστε αντίγραφο ασφαλείας του `config.toml`. +2. Εφαρμόστε μία αλλαγή τη φορά. +3. Εκτελέστε την εντολή `zeroclaw doctor` για επικύρωση. +4. Επανεκκινήστε την υπηρεσία. +5. Επαληθεύστε τη λειτουργία μέσω των εντολών `status` και `channel doctor`. + +## Διαδικασία Επαναφοράς (Rollback) + +Εάν παρατηρηθεί υποβάθμιση της υπηρεσίας μετά από αλλαγή: +1. Επαναφέρετε το προηγούμενο έγκυρο αρχείο `config.toml`. +2. Επανεκκινήστε το runtime (`daemon` ή `service`). +3. Επιβεβαιώστε την αποκατάσταση με τους ελέγχους `doctor` και `channel doctor`. +4. Αναλύστε την αιτία του προβλήματος πριν από νέα προσπάθεια αλλαγής. + +## Σχετική Τεκμηρίωση + +- [one-click-bootstrap.md](one-click-bootstrap.md) +- [troubleshooting.md](troubleshooting.md) +- [config-reference.md](config-reference.md) +- [commands-reference.md](commands-reference.md) diff --git a/docs/i18n/el/operations/README.md b/docs/i18n/el/operations/README.md new file mode 100644 index 000000000..f2137908b --- /dev/null +++ b/docs/i18n/el/operations/README.md @@ -0,0 +1,31 @@ +# Λειτουργία και Υλοποίηση (Operations & Deployment) + +Τεχνική τεκμηρίωση για τον χειρισμό, τη συντήρηση και την ανάπτυξη του ZeroClaw σε περιβάλλοντα παραγωγής. + +--- + +## 1. Βασικές Λειτουργίες και Εγχειρίδια + +- **Operations Runbook (Day-2)**: [../operations-runbook.md](../operations-runbook.md) +- **Runbook Probes Συνδεσιμότητας Παρόχων στο CI**: [connectivity-probes-runbook.md](connectivity-probes-runbook.md) +- **Διαδικασία Έκδοσης (Release Process)**: [../release-process.md](../release-process.md) +- **Αντιμετώπιση Προβλημάτων (Troubleshooting)**: [../troubleshooting.md](../troubleshooting.md) +- **Ανάπτυξη Δικτύου και Πύλης (Gateway)**: [../network-deployment.md](../network-deployment.md) +- **Ρύθμιση Mattermost**: [../mattermost-setup.md](../mattermost-setup.md) + +--- + +## 2. Τυπική Ροή Εργασιών Συντήρησης + +1. **Επαλήθευση Περιβάλλοντος**: Χρήση των εντολών `status`, `doctor` και `channel doctor`. +2. **Διαχείριση Ρυθμίσεων**: Εφαρμογή μεμονωμένων αλλαγών στο αρχείο παραμέτρων (Config). +3. **Επανεκκίνηση Υπηρεσιών**: Ανανέωση των daemons για την εφαρμογή των αλλαγών. +4. **Έλεγχος Υγείας (Health Check)**: Επιβεβαίωση της σωστής λειτουργίας καναλιών και πύλης. +5. **Επαναφορά (Rollback)**: Άμεση επιστροφή σε προηγούμενη σταθερή κατάσταση σε περίπτωση δυσλειτουργίας. + +--- + +## 3. Σχετικά Έγγραφα + +- **Αναφορά Παραμέτρων (Config Reference)**: [../config-reference.md](../config-reference.md) +- **Πολιτικές Ασφάλειας (Security)**: [../security/README.md](../security/README.md) diff --git a/docs/i18n/el/operations/connectivity-probes-runbook.md b/docs/i18n/el/operations/connectivity-probes-runbook.md new file mode 100644 index 000000000..5ab3df258 --- /dev/null +++ b/docs/i18n/el/operations/connectivity-probes-runbook.md @@ -0,0 +1,13 @@ +# Runbook Συνδεσιμότητας Probes (Ελληνικά) + +Αυτή η σελίδα είναι συνοπτική τοπικοποιημένη γέφυρα για το runbook probes συνδεσιμότητας provider στο CI. + +Αγγλικό πρωτότυπο: + +- [../../../operations/connectivity-probes-runbook.md](../../../operations/connectivity-probes-runbook.md) + +## Σκοπός + +- Λειτουργία του workflow probes για endpoint συνδεσιμότητα παρόχων. +- Κατανόηση enforce/report-only mode και triage ανά DNS/HTTP/auth σφάλμα. +- Τοπική αναπαραγωγή με το script matrix probe. diff --git a/docs/i18n/el/pr-workflow.md b/docs/i18n/el/pr-workflow.md new file mode 100644 index 000000000..bd4e9f0ed --- /dev/null +++ b/docs/i18n/el/pr-workflow.md @@ -0,0 +1,132 @@ +# Ροή Εργασιών Pull Request (PR) + +Αυτό το έγγραφο περιγράφει τη διαδικασία διαχείρισης των Pull Requests (PR) στο ZeroClaw, με στόχο τη διασφάλιση υψηλής απόδοσης, ασφάλειας και σταθερότητας του κώδικα. + +## Σχετική Τεκμηρίωση + +- [README.md](./README.md): Ταξινόμηση και πλοήγηση στην τεκμηρίωση. +- [ci-map.md](./ci-map.md): Ιδιοκτησία ροών εργασίας CI και διαχείριση σφαλμάτων. +- [reviewer-playbook.md](./reviewer-playbook.md): Οδηγός για ελεγκτές κώδικα (reviewers). + +## 0. Περίληψη + +- **Σκοπός**: Καθορισμός ενός ντετερμινιστικού μοντέλου διαχείρισης PR βάσει ανάλυσης κινδύνου. +- **Κοινό**: Συνεισφέροντες (contributors), συντηρητές (maintainers) και αυτοματοποιημένοι πράκτορες ελέγχου. +- **Πεδίο Εφαρμογής**: Κύκλος ζωής PR, κριτήρια ετοιμότητας, δρομολόγηση κινδύνου και πρωτόκολλα αποκατάστασης. + +--- + +## 1. Ταχεία Διαχείριση βάσει Κατάστασης PR + +### 1.1 Ημιτελές Πρότυπο PR + +- Ζητήστε τη συμπλήρωση του προτύπου και την παροχή αποδεικτικών στοιχείων μέσω λίστας ελέγχου. +- Αναστείλετε τον λεπτομερή έλεγχο μέχρι την πλήρη συμπλήρωση των στοιχείων. + +### 1.2 Αποτυχία στην Πύλη CI (CI Gate) + +- Οι αποτυχίες πρέπει να επιλύονται με βάση τον χάρτη CI. +- Ο έλεγχος από τον συντηρητή ξεκινά μόνο μετά την επιτυχία όλων των απαιτούμενων ελέγχων CI. + +### 1.3 Τροποποιήσεις Υψηλού Κινδύνου + +- Αλλαγές σε κρίσιμα υποσυστήματα απαιτούν λεπτομερή έλεγχο. +- Απαιτούνται ρητά αποδεικτικά στοιχεία για το πλάνο επαναφοράς (rollback) και δοκιμές ορίων ασφαλείας. + +### 1.4 Αντικατάσταση ή Διπλότυπο PR + +- Απαιτείται αναφορά στο PR που αντικαθίσταται και καθαρισμός της ουράς εργασιών. +- Το πλεονάζον PR κλείνει μετά από επιβεβαίωση του συντηρητή. + +--- + +## 2. Αρχές Διακυβέρνησης + +- **Διεκπεραιωτικότητα**: Διατήρηση σταθερού ρυθμού συγχωνεύσεων (merges). +- **Ποιότητα Σήματος**: Γρήγορη ανάδραση από το CI με ελάχιστα ψευδώς θετικά αποτελέσματα. +- **Ασφάλεια**: Αυστηρός έλεγχος σε κρίσιμες επιφάνειες επίθεσης. +- **Αναστρεψιμότητα**: Οι αλλαγές πρέπει να είναι κατανοητές και εύκολα αναστρέψιμες. + +--- + +## 3. Ρυθμίσεις Αποθετηρίου (Branch Protection) + +Οι παρακάτω κανόνες εφαρμόζονται στον κλάδο `main`: +- Απαίτηση επιτυχών ελέγχων κατάστασης (Status Checks) πριν από τη συγχώνευση. +- Υποχρεωτική επιτυχία της "Πύλης Απαιτούμενου CI". +- Απαίτηση έγκρισης από CODEOWNERS για ευαίσθητες διαδρομές. +- Απόρριψη παλαιών εγκρίσεων σε περίπτωση νέων commits. +- Απαγόρευση αναγκαστικής προώθησης (force-push). + +--- + +## 4. Κύκλος Ζωής PR + +### 4.1 Υποβολή (Intake) + +- Χρήση του προτύπου `.github/pull_request_template.md`. +- Αυτόματη απόδοση ετικετών (labels) για το μέγεθος, τον κίνδυνο και την ενότητα (π.χ. `risk:high`, `size:M`). + +### 4.2 Επικύρωση + +- PR που αφορούν αποκλειστικά τεκμηρίωση παρακάμπτουν τις εργασίες μεταγλώττισης. +- Ο κώδικας Rust ελέγχεται για lints, επιτυχή μεταγλώττιση και δοκιμές (unit/integration tests). + +### 4.3 Έλεγχος (Review) + +- Προτεραιότητα βάσει κινδύνου και μεγέθους. +- Κρίσιμες διαδρομές (`src/security`, `src/gateway`, CI workflows) απαιτούν έγκριση από συντηρητές. + +### 4.4 Συγχώνευση (Merge) + +- Προεπιλεγμένη μέθοδος: **Squash Merge**. +- Οι τίτλοι των commits πρέπει να ακολουθούν τη σύμβαση Conventional Commits. + +--- + +## 5. Κριτήρια Ετοιμότητας (DoR / DoD) + +### 5.1 Definition of Ready (DoR) + +- Πλήρως συμπληρωμένο πρότυπο. +- Σαφής περιγραφή των αλλαγών και της εμβέλειάς τους. +- Αποδεικτικά χειροκίνητης ή αυτόματης επικύρωσης. +- Ύπαρξη σχεδίου επαναφοράς. + +### 5.2 Definition of Done (DoD) + +- Όλοι οι έλεγχοι CI είναι επιτυχείς. +- Λήψη όλων των απαραίτητων εγκρίσεων (reviewers, code owners). +- Οι ετικέτες αντικατοπτρίζουν το πραγματικό περιεχόμενο και τον κίνδυνο. + +--- + +## 6. Διαχείριση Μεγέθους + +| Ετικέτα | Γραμμές Κώδικα | +|:---|:---| +| `size: XS` | < 80 | +| `size: S` | 80 - 250 | +| `size: M` | 250 - 500 | +| `size: L` | 500 - 1000 | +| `size: XL` | > 1000 | + +> [!TIP] +> Προτιμήστε τα μεγέθη XS, S και M. Τα PR μεγέθους L και XL πρέπει να δικαιολογούνται ρητά και να συνοδεύονται από εκτενείς δοκιμές. + +--- + +## 7. Πολιτική Αποκατάστασης (Rollback) + +Εάν μια αλλαγή προκαλέσει προβλήματα μετά τη συγχώνευση: +1. **Αναστροφή (Revert)** του PR στον κλάδο `main` άμεσα. +2. Ανάλυση της βαθύτερης αιτίας (Root Cause Analysis). +3. Επαναϋποβολή της διόρθωσης μαζί με δοκιμές αποτροπής υποτροπής (regression tests). + +--- + +## 8. Σχετική Τεκμηρίωση + +- [README.md](./README.md): Ταξινόμηση και πλοήγηση τεκμηρίωσης. +- [ci-map.md](./ci-map.md): Ιδιοκτησία και διαχείριση CI. +- [reviewer-playbook.md](./reviewer-playbook.md): Οδηγός ελέγχου κώδικα. diff --git a/docs/i18n/el/project-triage-snapshot-2026-02-18.md b/docs/i18n/el/project-triage-snapshot-2026-02-18.md new file mode 100644 index 000000000..e70511044 --- /dev/null +++ b/docs/i18n/el/project-triage-snapshot-2026-02-18.md @@ -0,0 +1,67 @@ +# Αναφορά Διαλογής Έργου ZeroClaw (Project Triage Snapshot) + +**Ημερομηνία Αναφοράς**: 18 Φεβρουαρίου 2026 + +Το παρόν έγγραφο αποτελεί μια στατική καταγραφή των ανοιχτών αιτημάτων (PR) και ζητημάτων (Issues) με σκοπό την καθοδήγηση των εργασιών τεκμηρίωσης και της αρχιτεκτονικής πληροφοριών. + +## Μεθοδολογία Συλλογής Δεδομένων + +Η άντληση των στοιχείων πραγματοποιήθηκε μέσω του GitHub CLI για το αποθετήριο `zeroclaw-labs/zeroclaw`: + +- `gh repo view`: Γενική εικόνα αποθετηρίου. +- `gh pr list --state open --limit 500`: Ανάλυση ανοιχτών PR. +- `gh issue list --state open --limit 500`: Ανάλυση ανοιχτών Issues. +- `gh pr/issue view `: Λεπτομερής εξέταση στοιχείων που επηρεάζουν την τεκμηρίωση. + +## Κατάσταση Αποθετηρίου (Repository Pulse) + +- **Ανοιχτά PR**: 30 +- **Ανοιχτά Ζητήματα**: 24 +- **Stars**: 11.220 +- **Forks**: 1.123 +- **Πρωτεύων Κλάδος**: `main` +- **Άδεια Χρήσης**: MIT (επιβεβαιωμένη μέσω πηγαίου κώδικα). + +## Ανάλυση Ετικετών (PR Label Pressure) + +Συχνότητα εμφάνισης ετικετών σε ανοιχτά PR: + +1. `risk: high` — 24 +2. `experienced contributor` — 14 +3. `size: S` — 14 +4. `ci` — 11 +5. `size: XS` — 10 +6. `dependencies` — 7 +7. `principal contributor` — 6 + +**Επιπτώσεις στην Τεκμηρίωση**: +- Οι αλλαγές σε CI, ασφάλεια και υπηρεσίες παρουσιάζουν υψηλή μεταβλητότητα. +- Η τεκμηρίωση για τους διαχειριστές (Operations) πρέπει να εστιάζει στην ορατότητα των αλλαγών και σε ταχείες διαδικασίες αποκατάστασης. + +## Ανάλυση Ετικετών (Issue Label Pressure) + +1. `experienced contributor` — 12 +2. `enhancement` — 8 +3. `bug` — 4 + +**Επιπτώσεις στην Τεκμηρίωση**: +- Τα αιτήματα για νέα χαρακτηριστικά και βελτιστοποίηση απόδοσης υπερτερούν των επεξηγηματικών εγγράφων. +- Οι οδηγοί αντιμετώπισης προβλημάτων (Troubleshooting) πρέπει να παραμείνουν σε περίοπτη θέση στην πλοήγηση. + +## PR με Άμεσο Αντίκτυπο στην Τεκμηρίωση + +- [#716](https://github.com/zeroclaw-labs/zeroclaw/pull/716): Υποστήριξη OpenRC (διαχείριση υπηρεσιών). +- [#725](https://github.com/zeroclaw-labs/zeroclaw/pull/725): Shell completion commands (τεκμηρίωση CLI). +- [#732](https://github.com/zeroclaw-labs/zeroclaw/pull/732): Αναβάθμιση ενεργειών CI (ροές εργασίας συνεισφερόντων). +- [#759](https://github.com/zeroclaw-labs/zeroclaw/pull/759): Διόρθωση απόκρισης daemon/καναλιού (troubleshooting). +- [#679](https://github.com/zeroclaw-labs/zeroclaw/pull/679): Αλλαγή στη λογική αποκλεισμού (πολιτική ασφαλείας). + +## Εκκρεμότητες Τεκμηρίωσης (Προτεραιοποίηση) + +1. **Αρχιτεκτονική Πληροφοριών (IA)**: Διατήρηση του `SUMMARY.md` ως κεντρικού άξονα πλοήγησης. +2. **Discoverability**: Διασφάλιση άμεσης πρόσβασης στα `operations-runbook` και `troubleshooting` από το κεντρικό README. +3. **Παρακολούθηση CLI/Config**: Άμεση ενημέρωση των αναφορών κατά τη συγχώνευση αλλαγών σε εντολές ή ρυθμίσεις. +4. **Σήμανση Κατάστασης**: Σαφής διαχωρισμός μεταξύ παραγωγικής συμπεριφοράς και προτεινόμενων αλλαγών (Roadmap). + +> [!WARNING] +> Το παρόν στιγμιότυπο είναι χρονικά περιορισμένο (18-02-2026). Απαιτείται νέα εκτέλεση των ερωτημάτων `gh` πριν από κάθε κύκλο σχεδιασμού τεκμηρίωσης. diff --git a/docs/i18n/el/project/README.md b/docs/i18n/el/project/README.md new file mode 100644 index 000000000..9b3d999c2 --- /dev/null +++ b/docs/i18n/el/project/README.md @@ -0,0 +1,22 @@ +# Στιγμιότυπα Έργου και Διαλογή (Project Snapshot & Triage) + +Αυτή η ενότητα περιλαμβάνει χρονικά περιορισμένα στιγμιότυπα (snapshots) της κατάστασης του έργου για τον σχεδιασμό και τον συντονισμό των εργασιών. + +--- + +## Τρέχον Στιγμιότυπο + +- **Snapshot 18-02-2026**: [../project-triage-snapshot-2026-02-18.md](../project-triage-snapshot-2026-02-18.md) + +--- + +## 1. Πεδίο Εφαρμογής (Scope) + +Τα στιγμιότυπα έργου αποτελούν περιοδικές αξιολογήσεις των ανοιχτών Pull Requests (PRs), των ζητημάτων (Issues) και της πληρότητας της τεκμηρίωσης. Χρησιμοποιούνται για: + +- **Εντοπισμό Κενών**: Εντοπισμός ελλείψεων στην τεκμηρίωση νέων δυνατοτήτων. +- **Προτεραιοποίηση**: Καθορισμός των απαραίτητων βελτιώσεων στην τεκμηρίωση παράλληλα με την ανάπτυξη κώδικα. +- **Παρακολούθηση Προόδου**: Ανάλυση της εξέλιξης του φόρτου εργασίας (PR/Issue pressure) με την πάροδο του χρόνου. + +> [!TIP] +> Για τη συνολική διαχείριση και ταξινόμηση της τεκμηρίωσης (χωρίς χρονικό περιορισμό), συμβουλευτείτε το [docs-inventory.md](../docs-inventory.md). diff --git a/docs/i18n/el/providers-reference.md b/docs/i18n/el/providers-reference.md new file mode 100644 index 000000000..69de9499c --- /dev/null +++ b/docs/i18n/el/providers-reference.md @@ -0,0 +1,87 @@ +# Αναφορά Παρόχων ZeroClaw (Providers Reference) + +Αυτό το έγγραφο περιγράφει τα ID των παρόχων, τα ψευδώνυμα (aliases) και τις μεταβλητές περιβάλλοντος για τη διαχείριση των διαπιστευτηρίων. + +Τελευταία επαλήθευση: **21 Φεβρουαρίου 2026**. + +## Προβολή Διαθέσιμων Παρόχων + +Για να δείτε τη λίστα με τους ενεργούς παρόχους στο σύστημά σας, εκτελέστε: +```bash +zeroclaw providers +``` + +## Επίλυση Διαπιστευτηρίων (Credential Resolution) + +Το runtime του ZeroClaw αναζητά διαπιστευτήρια με την εξής σειρά προτεραιότητας: + +1. **Ρητές ρυθμίσεις**: Τιμές που έχουν οριστεί στο αρχείο `config.toml` ή μέσω παραμέτρων CLI. +2. **Μεταβλητές περιβάλλοντος παρόχου**: Μεταβλητές ειδικές για κάθε πάροχο (π.χ. `OPENAI_API_KEY`). +3. **Γενικές μεταβλητές**: Εφεδρικές μεταβλητές όπως οι `ZEROCLAW_API_KEY` ή `API_KEY`. + +> [!NOTE] +> Σε περίπτωση χρήσης εφεδρικών παρόχων (`reliability.fallback_providers`), η επίλυση διαπιστευτηρίων γίνεται ανεξάρτητα για κάθε πάροχο. Τα κλειδιά του κύριου παρόχου δεν μεταφέρονται αυτόματα στους εφεδρικούς. + +## Κατάλογος Παρόχων + +| ID Παρόχου | Ψευδώνυμα | Τοπικός | Μεταβλητές Περιβάλλοντος | +|:---|:---|:---:|:---| +| `openrouter` | — | Όχι | `OPENROUTER_API_KEY` | +| `anthropic` | — | Όχι | `ANTHROPIC_API_KEY`, `ANTHROPIC_OAUTH_TOKEN` | +| `openai` | — | Όχι | `OPENAI_API_KEY` | +| `ollama` | — | Ναι | `OLLAMA_API_KEY` (προαιρετικό) | +| `gemini` | `google`, `google-gemini` | Όχι | `GEMINI_API_KEY`, `GOOGLE_API_KEY` | +| `bedrock` | `aws-bedrock` | Όχι | `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` | +| `deepseek` | — | Όχι | `DEEPSEEK_API_KEY` | +| `mistral` | — | Όχι | `MISTRAL_API_KEY` | +| `groq` | — | Όχι | `GROQ_API_KEY` | +| `together` | `together-ai` | Όχι | `TOGETHER_API_KEY` | +| `fireworks` | `fireworks-ai` | Όχι | `FIREWORKS_API_KEY` | +| `perplexity` | — | Όχι | `PERPLEXITY_API_KEY` | +| `xai` | `grok` | Όχι | `XAI_API_KEY` | +| `cohere` | — | Όχι | `COHERE_API_KEY` | +| `ollama` | — | Ναι | - | +| `lmstudio` | `lm-studio` | Ναι | - | + +## Ειδικές Σημειώσεις + +### Gemini (Google) + +- Υποστηρίζει έλεγχο ταυτότητας μέσω API Key ή OAuth (`~/.gemini/oauth_creds.json`). +- Τα μοντέλα συλλογιστικής (thinking models) υποστηρίζονται εγγενώς· το ZeroClaw φιλτράρει αυτόματα τα εσωτερικά metadata της συλλογιστικής. + +### Ollama + +- **Vision**: Υποστηρίζεται μέσω της σύνταξης `[IMAGE:]` στα μηνύματα. +- **Cloud Routing**: Χρησιμοποιήστε το επίθεμα `:cloud` (π.χ. `llama3:cloud`) για απομακρυσμένα instances. Το `api_url` πρέπει να οριστεί ρητά. +- **Reasoning**: Η συμπεριφορά συλλογιστικής ελέγχεται μέσω της ρύθμισης `reasoning_enabled` στο αρχείο `config.toml`. + +### AWS Bedrock + +- Απαιτεί πλήρη διαπιστευτήρια AWS (Access Key ID και Secret Access Key). +- Χρησιμοποιεί το Converse API για τη διασφάλιση συμβατότητας με κλήσεις εργαλείων (tool calling). + +## Προσαρμοσμένα Endpoints + +Μπορείτε να ορίσετε παρόχους που ακολουθούν τα πρότυπα της αγοράς: +- **OpenAI-compatible**: `custom:https://your-api-url` +- **Anthropic-compatible**: `anthropic-custom:https://your-api-url` + +## Δρομολόγηση Μοντέλων (Model Hints) + +Χρησιμοποιήστε την ενότητα `[[model_routes]]` για να δημιουργήσετε σταθερά ψευδώνυμα για τα μοντέλα σας: + +```toml +[[model_routes]] +hint = "fast" +provider = "groq" +model = "llama-3.3-70b-versatile" +``` + +Κλήση μέσω CLI: `zeroclaw agent --model hint:fast --message "..."`. + +## Σχετική Τεκμηρίωση + +- [config-reference.md](config-reference.md) +- [commands-reference.md](commands-reference.md) +- [custom-providers.md](custom-providers.md) diff --git a/docs/i18n/el/proxy-agent-playbook.md b/docs/i18n/el/proxy-agent-playbook.md new file mode 100644 index 000000000..c479acb65 --- /dev/null +++ b/docs/i18n/el/proxy-agent-playbook.md @@ -0,0 +1,141 @@ +# Εγχειρίδιο Διαχείρισης Proxy (Proxy Agent Playbook) + +Αυτό το εγχειρίδιο περιέχει έτοιμες κλήσεις εργαλείων για τη διαμόρφωση της συμπεριφοράς διαμεσολάβησης (proxy) μέσω της ρύθμισης `proxy_config`. + +## 0. Περίληψη + +- **Σκοπός**: Παροχή προτύπων για τη διαχείριση της εμβέλειας του proxy και τη διασφάλιση της δυνατότητας επαναφοράς (rollback). +- **Κοινό**: Διαχειριστές συστημάτων και συντηρητές που λειτουργούν το ZeroClaw σε εταιρικά ή περιορισμένα δίκτυα. +- **Πεδίο Εφαρμογής**: Ενέργειες `proxy_config`, επιλογή λειτουργίας, επαλήθευση και επίλυση προβλημάτων. + +--- + +## 1. Ταχείες Ενέργειες ανά Περίπτωση + +### 1.1 Proxy μόνο για το ZeroClaw (Internal Traffic) + +- **Περιγραφή**: Διαμεσολάβηση μόνο για την εσωτερική κίνηση του δαίμονα. +- **Εμβέλεια (Scope)**: `zeroclaw`. +- **Επαλήθευση**: Χρήση της ενέργειας `{"action":"get"}`. + +### 1.2 Proxy για επιλεγμένες υπηρεσίες + +- **Περιγραφή**: Διαμεσολάβηση μόνο για συγκεκριμένους παρόχους ή εργαλεία. +- **Εμβέλεια**: `services`. +- **Επαλήθευση**: Χρήση της ενέργειας `{"action":"list_services"}`. + +### 1.3 Καθολική διαμεσολάβηση (Environment-wide) + +- **Περιγραφή**: Εξαγωγή μεταβλητών περιβάλλοντος για όλη τη διεργασία. +- **Εμβέλεια**: `environment`. +- **Επαλήθευση**: Χρήση της ενέργειας `{"action":"apply_env"}`. + +### 1.4 Άμεση Απενεργοποίηση (Emergency Rollback) + +1. Απενεργοποιήστε τη διαμεσολάβηση. +2. Εκκαθαρίστε τις μεταβλητές περιβάλλοντος (εάν έχουν εξαχθεί). +3. Επαληθεύστε την κατάσταση του runtime. + +--- + +## 2. Μήτρα Επιλογής Εμβέλειας (Scope) + +| Εμβέλεια | Επηρεάζει | Περιβάλλον (Env) | Χρήση | +|:---|:---|:---:|:---| +| `zeroclaw` | Εσωτερικοί HTTP clients | Όχι | Αποφυγή παρενεργειών στο σύστημα. | +| `services` | Επιλεγμένα κλειδιά/selectors | Όχι | Δρομολόγηση για συγκεκριμένους παρόχους/εργαλεία. | +| `environment` | Full Process Runtime | Ναι | Ενσωματώσεις που απαιτούν `HTTP_PROXY`. | + +--- + +## 3. Ροή Εργασίας Ασφαλούς Αλλαγής + +1. **Επιθεώρηση**: Έλεγχος τρέχουσας κατάστασης. +2. **Ανακάλυψη**: Εύρεση έγκυρων κλειδιών υπηρεσιών. +3. **Εφαρμογή**: Ρύθμιση της επιθυμητής εμβέλειας. +4. **Επαλήθευση**: Έλεγχος στιγμιότυπων runtime και environment. + +**Εντολές Ελέγχου**: +```json +{"action":"get"} +{"action":"list_services"} +``` + +--- + +## 4. Παραδείγματα Διαμόρφωσης + +### Λειτουργία Α: Εσωτερική Διαμεσολάβηση (ZeroClaw only) + +```json +{ + "action": "set", + "enabled": true, + "scope": "zeroclaw", + "http_proxy": "http://127.0.0.1:7890", + "https_proxy": "http://127.0.0.1:7890", + "no_proxy": ["localhost", "127.0.0.1"] +} +``` + +### Λειτουργία Β: Στοχευμένη Διαμεσολάβηση (Services) + +Χρήση συγκεκριμένων κλειδιών: +```json +{ + "action": "set", + "enabled": true, + "scope": "services", + "services": ["provider.openai", "tool.http_request"], + "all_proxy": "socks5h://127.0.0.1:1080" +} +``` +Χρήση μπαλαντέρ (Wildcards): +```json +{ + "action": "set", + "enabled": true, + "scope": "services", + "services": ["provider.*"] +} +``` + +### Λειτουργία Γ: Καθολική Διαμεσολάβηση (Process Environment) + +```json +{ + "action": "set", + "enabled": true, + "scope": "environment", + "http_proxy": "http://127.0.0.1:7890" +} +{"action":"apply_env"} +``` + +--- + +## 5. Απενεργοποίηση και Επαναφορά + +### Απενεργοποίηση (Safe) + +```json +{"action":"disable"} +``` + +### Πλήρης Εκκαθαρισμός Περιβάλλοντος + +```json +{"action":"disable", "clear_env": true} +``` + +--- + +## 6. Αντιμετώπιση Προβλημάτων + +- **Σφάλμα**: `proxy.scope='services' requires a non-empty proxy.services list` + - *Λύση*: Προσθέστε τουλάχιστον ένα έγκυρο κλειδί ή selector. +- **Σφάλμα**: `Invalid proxy URL scheme` + - *Λύση*: Χρησιμοποιήστε `http`, `https`, `socks5` ή `socks5h`. +- **Η διαμεσολάβηση δεν εφαρμόζεται**: + - Εκτελέστε `list_services` για να επαληθεύσετε τα ονόματα των υπηρεσιών. + - Ελέγξτε την έξοδο της `get` για τις τιμές `runtime_proxy` και `environment`. diff --git a/docs/i18n/el/reference/README.md b/docs/i18n/el/reference/README.md new file mode 100644 index 000000000..1c85d8b62 --- /dev/null +++ b/docs/i18n/el/reference/README.md @@ -0,0 +1,30 @@ +# Κατάλογοι Αναφοράς (Reference) + +Δομημένο ευρετήριο τεχνικών αναφορών για εντολές CLI, παρόχους AI (Providers), κανάλια επικοινωνίας και παραμέτρους συστήματος. + +--- + +## 1. Βασικές Αναφορές + +- **Commands Reference**: [../commands-reference.md](../commands-reference.md) +- **Providers & API Keys**: [../providers-reference.md](../providers-reference.md) +- **Channels & Allowlists**: [../channels-reference.md](../channels-reference.md) +- **Configuration Reference**: [../config-reference.md](../config-reference.md) + +--- + +## 2. Οδηγοί Ενσωμάτωσης και Παροχών + +- **Προσαρμοσμένοι Πάροχοι**: [../custom-providers.md](../custom-providers.md) +- **Z.AI GLM Setup**: [../zai-glm-setup.md](../zai-glm-setup.md) +- **Nextcloud Talk Bot**: [../nextcloud-talk-setup.md](../nextcloud-talk-setup.md) +- **LangGraph Integration**: [../langgraph-integration.md](../langgraph-integration.md) + +--- + +## 3. Οδηγίες Χρήσης + +Αυτή η συλλογή προορίζεται για γρήγορη εύρεση τεχνικών λεπτομερειών και προτύπων (templates), και όχι ως οδηγός βήμα-προς-βήμα (Tutorial). + +> [!IMPORTANT] +> Κατά την προσθήκη νέου εγγράφου αναφοράς, διασφαλίστε την ενημέρωση των αρχείων [SUMMARY.md](../SUMMARY.md) και [docs-inventory.md](../docs-inventory.md). diff --git a/docs/i18n/el/release-process.md b/docs/i18n/el/release-process.md new file mode 100644 index 000000000..ebf676d0c --- /dev/null +++ b/docs/i18n/el/release-process.md @@ -0,0 +1,80 @@ +# Διαδικασία Έκδοσης (Release Process) + +Αυτό το εγχειρίδιο περιγράφει την τυπική ροή εργασιών έκδοσης νέων εκδόσεων για τους συντηρητές του ZeroClaw. + +Τελευταία επαλήθευση: **20 Φεβρουαρίου 2026**. + +## Στόχοι Εκδόσεων + +- **Προβλεψιμότητα**: Οι εκδόσεις πρέπει να είναι επαναλήψιμες και σταθερές. +- **Ακεραιότητα**: Δημοσίευση κώδικα αποκλειστικά από τον κλάδο `main`. +- **Επαλήθευση**: Πλήρης έλεγχος των παραγόμενων αρχείων (artifacts) για όλες τις υποστηριζόμενες πλατφόρμες. +- **Συχνότητα**: Διατήρηση τακτικού ρυθμού εκδόσεων ανεξάρτητα από τον όγκο των PR. + +## Συχνότητα Εκδόσεων + +- **Patch / Minor**: Εβδομαδιαία ή ανά δεκαπενθήμερο, αναλόγως του φόρτου. +- **Hotfixes**: Άμεση έκδοση σε περίπτωση κρίσιμων σφαλμάτων ασφαλείας. +- **Πρακτική**: Αποφυγή συσσώρευσης μεγάλου αριθμού commits μεταξύ των εκδόσεων. + +## Αυτοματοποίηση (Workflows) + +Η ροή εργασιών περιγράφεται στο αρχείο `.github/workflows/pub-release.yml`. + +**Λειτουργίες**: +- **Tag Push (`v*`)**: Ενεργοποιεί τη διαδικασία δημοσίευσης. +- **Manual Dispatch**: Χειροκίνητη εκκίνηση για επαλήθευση ή δημοσίευση. +- **Scheduled**: Εβδομαδιαίος έλεγχος επαλήθευσης. + +**Προϋποθέσεις Δημοσίευσης**: +- Η ετικέτα (tag) πρέπει να ακολουθεί το πρότυπο Semver (`vX.Y.Z`). +- Το tag πρέπει να είναι ήδη διαθέσιμο στο απομακρυσμένο αποθετήριο. +- Το commit του tag πρέπει να ανήκει στον κλάδο `origin/main`. +- Επιτυχής κατασκευή και επαλήθευση όλων των artifacts (binaries, Docker images). +- Διαθεσιμότητα των SBOMs (`CycloneDX` / `SPDX`) και των υπογραφών `cosign`. + +## Βήματα Συντηρητή + +### 1. Έλεγχος Κλάδου main + +- Επιβεβαιώστε ότι όλοι οι έλεγχοι CI είναι επιτυχείς. +- Βεβαιωθείτε ότι δεν υπάρχουν ανοικτά κρίσιμα περιστατικά (bugs). +- Επαληθεύστε τη λειτουργία των εγκαταστατών (installers) και των Docker images. + +### 2. Κατασκευή Επαλήθευσης (Dry Run) + +Εκτελέστε χειροκίνητα τη ροή `Pub Release` με τις εξής ρυθμίσεις: +- `publish_release`: `false` +- `release_ref`: `main` + +### 3. Δημιουργία Ετικέτας (Release Tag) + +Σε περιβάλλον συγχρονισμένο με το `origin/main`, εκτελέστε: +```bash +scripts/release/cut_release_tag.sh vX.Y.Z --push +``` +Το σενάριο ελέγχει αυτόματα τη συμβατότητα Semver και την καθαρότητα του repo. + +### 4. Παρακολούθηση Δημοσίευσης + +Μετά το push, παρακολουθήστε την πρόοδο στις ροές: +1. `Pub Release` (λειτουργία δημοσίευσης). +2. `Pub Docker Img`. + +### 5. Τελική Επαλήθευση + +- Επιβεβαιώστε τη δυνατότητα λήψης των assets από το GitHub Release. +- Ελέγξτε τις ετικέτες GHCR και την ετικέτα `latest`. +- Πραγματοποιήστε δοκιμαστική εγκατάσταση. + +## Διαδικασία Αποκατάστασης (Emergency Rollback) + +Εάν η δημοσίευση αποτύχει μετά την επαλήθευση: +1. Διορθώστε το πρόβλημα στον κλάδο `main`. +2. Εκτελέστε ξανά χειροκίνητα τη ροή `Pub Release` ορίζοντας το `publish_release=true` και την υπάρχουσα ετικέτα. + +## Κανόνες Λειτουργίας + +- Κάθε έκδοση πρέπει να είναι μικρή και εύκολα αναστρέψιμη. +- Χρησιμοποιήστε ένα Issue tracker ανά release για την καταγραφή της προόδου. +- Αποφύγετε τη δημοσίευση εκδόσεων από feature branches. diff --git a/docs/i18n/el/resource-limits.md b/docs/i18n/el/resource-limits.md new file mode 100644 index 000000000..9ea65bc2b --- /dev/null +++ b/docs/i18n/el/resource-limits.md @@ -0,0 +1,109 @@ +# Όρια Πόρων (Resource Limits) + +> [!WARNING] +> **Κατάσταση: Πρόταση / Οδικός Χάρτης** +> +> Αυτό το έγγραφο περιγράφει προτεινόμενες προσεγγίσεις περιορισμού πόρων. Για την τρέχουσα υλοποίηση, ανατρέξτε στα έγγραφα [config-reference.md](config-reference.md) και [operations-runbook.md](operations-runbook.md). + +## Περιγραφή Προβλήματος + +Το ZeroClaw εφαρμόζει περιορισμό ρυθμού (Rate Limiting - 20 ενέργειες/ώρα), αλλά δεν διαθέτει ανώτατα όρια χρήσης πόρων συστήματος. Χωρίς αυτούς τους περιορισμούς, ένας πράκτορας ενδέχεται να: +- Καταναλώσει υπερβολική μνήμη (RAM). +- Προκαλέσει υψηλό φόρτο CPU (100%). +- Εξαντλήσει τον αποθηκευτικό χώρο (disk space) με logs ή προσωρινά αρχεία. + +--- + +## Προτεινόμενες Τεχνικές Προσεγγίσεις + +### 1. cgroups v2 (Linux) + +Αυτή είναι η συνιστώμενη μέθοδος για την απομόνωση των πόρων του ZeroClaw σε επίπεδο λειτουργικού συστήματος. + +```bash +# Παράδειγμα υπηρεσίας systemd με περιορισμούς +[Service] +MemoryMax=512M +CPUQuota=100% +IOReadBandwidthMax=/dev/sda 10M +IOWriteBandwidthMax=/dev/sda 10M +TasksMax=100 +``` + +### 2. Έλεγχος Ασύγχρονων Εργασιών (Tokio Tasks) + +Ενσωμάτωση χρονικών ορίων (timeouts) για την αποφυγή κατάληψης των νημάτων (task starvation). + +```rust +use tokio::time::{timeout, Duration}; + +pub async fn execute_with_timeout( + fut: F, + cpu_time_limit: Duration, +) -> Result +where + F: Future>, +{ + // Περιορισμός χρόνου εκτέλεσης + timeout(cpu_time_limit, fut).await? +} +``` + +### 3. Διαχείριση Μνήμης (Memory Monitoring) + +Εποπτεία της χρήσης του σωρού (heap) και αυτόματος τερματισμός σε περίπτωση υπέρβασης των ορίων. + +```rust +use std::alloc::{GlobalAlloc, Layout, System}; + +struct LimitedAllocator { + inner: A, + max_bytes: usize, + used: std::sync::atomic::AtomicUsize, +} + +unsafe impl GlobalAlloc for LimitedAllocator { + unsafe fn alloc(&self, layout: Layout) -> *mut u8 { + let size = layout.size(); + let current = self.used.fetch_add(size, std::sync::atomic::Ordering::Relaxed); + if current + size > self.max_bytes { + std::process::abort(); + } + self.inner.alloc(layout) + } +} +``` + +--- + +## Προτεινόμενη Διαμόρφωση (Config Schema) + +```toml +[resources] +# Όρια μνήμης (MB) +max_memory_mb = 512 +max_memory_per_command_mb = 128 + +# Όρια CPU +max_cpu_percent = 50 +max_cpu_time_seconds = 60 + +# Όρια αποθήκευσης (I/O) +max_log_size_mb = 100 +max_temp_storage_mb = 500 + +# Όρια διεργασιών και αρχείων +max_subprocesses = 10 +max_open_files = 100 +``` + +--- + +## Σχέδιο Υλοποίησης ανά Προτεραιότητα + +| Προτεραιότητα | Χαρακτηριστικό | Δυσκολία | Αντίκτυπος | +|:---:|:---|:---:|:---:| +| **P0** | Παρακολούθηση μνήμης & Fail-safe τερματισμός | Χαμηλή | Υψηλός | +| **P1** | Timeouts CPU ανά εντολή | Χαμηλή | Υψηλός | +| **P2** | Υποστήριξη cgroups (Linux) | Μέτρια | Πολύ Υψηλός | +| **P3** | Περιορισμοί I/O δίσκου | Μέτρια | Μέτριος | diff --git a/docs/i18n/el/reviewer-playbook.md b/docs/i18n/el/reviewer-playbook.md new file mode 100644 index 000000000..b57001a61 --- /dev/null +++ b/docs/i18n/el/reviewer-playbook.md @@ -0,0 +1,101 @@ +# Εγχειρίδιο Ελεγκτή (Reviewer Playbook) + +Αυτό το εγχειρίδιο αποτελεί το λειτουργικό συμπλήρωμα του οδηγού [PR Workflow](pr-workflow.md). + +## 0. Περίληψη + +- **Σκοπός**: Καθορισμός ενός σταθερού μοντέλου ελέγχου για τη διασφάλιση της ποιότητας του κώδικα υπό υψηλό φόρτο. +- **Κοινό**: Συντηρητές (Maintainers) και ελεγκτές (Reviewers). +- **Πεδίο Εφαρμογής**: Διαλογή (Triage), εκτίμηση κινδύνου, λεπτομερής τεχνικός έλεγχος και διαδικασίες παράδοσης. + +--- + +## 1. Ταχείες Ενέργειες ανά Κατάσταση + +### 1.1 Αποτυχία στην αρχική διαλογή (πρώτα 5 λεπτά) + +- **Ενέργεια**: Καταγράψτε συγκεκριμένα ελλείποντα στοιχεία σε σχόλιο. +- **Σημείωση**: Διακόψτε τον λεπτομερή έλεγχο έως ότου διορθωθούν οι βασικές ελλείψεις. + +### 1.2 Υψηλός ή Ασαφής Κίνδυνος + +- **Πολιτική**: Χαρακτηρίστε το PR ως `risk: high` από προεπιλογή. +- **Απαίτηση**: Λεπτομερής εξέταση κώδικα και ρητό σχέδιο επαναφοράς (rollback). + +### 1.3 Ανάγκη Μεταβίβασης Ελέγχου (Handoff) + +- **Ενέργεια**: Συνοψίστε την εμβέλεια, τον κίνδυνο και τις εκκρεμότητες. +- **Σκοπός**: Σαφής καθορισμός της επόμενης ενέργειας για τον επόμενο ελεγκτή. + +--- + +## 2. Μήτρα Εκτίμησης Κινδύνου και Βάθους Ελέγχου + +| Ετικέτα Κινδύνου | Περιοχές / Παραδείγματα | Ελάχιστος Έλεγχος | Απαιτούμενα Τεκμήρια | +|:---|:---|:---|:---| +| `risk: low` | Τεκμηρίωση, Δοκιμές, Chore | 1 ελεγκτής + CI | Τοπική επαλήθευση | +| `risk: medium` | `providers/`, `channels/` | 1 ειδικός υποσυστήματος | Σενάρια δοκιμής / side-effects | +| `risk: high` | `security/`, `runtime/`, `gateway/` | Διαλογή + Peer Review | Επαλήθευση ασφαλείας / Σχέδιο Fallback | + +--- + +## 3. Ροή Εργασιών Ελέγχου + +### 3.1 Αρχική Διαλογή (5-Minute Triage) + +Για κάθε νέο PR, επαληθεύστε: +1. **Πληρότητα Προτύπου**: Ύπαρξη `summary`, `validation`, `security`, `rollback`. +2. **Ετικέτες**: Σωστή χρήση `size:*` και `risk:*`. +3. **CI Status**: Επιτυχής ολοκλήρωση των απαιτούμενων ελέγχων. +4. **Εστίαση**: Το PR πρέπει να αφορά ένα μόνο διακριτό ζήτημα. + +### 3.2 Γενική Λίστα Ελέγχου (Για όλα τα PR) + +- Σαφή και πειστικά όρια εμβέλειας. +- Τεκμηριωμένα αποτελέσματα επαλήθευσης. +- Ενημέρωση της τεκμηρίωσης για αλλαγές που επηρεάζουν τον χρήστη. +- Κατανόηση της ακτίνας επιρροής (blast radius). +- Συγκεκριμένη διαδικασία rollback. +- Προστασία προσωπικών δεδομένων (redaction) και ουδέτερες δοκιμές. + +### 3.3 Λεπτομερής Τεχνικός Έλεγχος (High Risk) + +- **Ασφάλεια**: Διατήρηση της αρχής "Deny by Default". +- **Ανθεκτικότητα**: Ρητός χειρισμός σφαλμάτων και ασφαλής υποβάθμιση (graceful degradation). +- **Συμβατότητα**: Διατήρηση σταθερότητας σε CLI, API και ρυθμίσεις. +- **Παρατηρησιμότητα**: Δυνατότητα διάγνωσης σφαλμάτων χωρίς έκθεση μυστικών. + +--- + +## 4. Διαχείριση Ζητημάτων και PR + +### 4.1 Ετικέτες Διαλόγης + +- `r:needs-repro`: Για ελλιπείς αναφορές σφαλμάτων. +- `r:support`: Για ερωτήσεις χρηστών. +- `duplicate` / `invalid`: Για διπλότυπα ή μη αξιοποιήσιμα ζητήματα. + +### 4.2 Διαχείριση Φόρτου PR + +Σε περιπτώσεις υψηλού φόρτου: +1. Προτεραιοποιήστε διορθώσεις σφαλμάτων και ασφαλείας (`size: XS/S`). +2. Ζητήστε συγχώνευση (merge) PR που επικαλύπτονται. +3. Επισημάνετε τα αδρανή PR ως `stale-candidate`. + +--- + +## 5. Παράκαμψη Αυτοματισμών + +Σε περιπτώσεις λανθασμένης αυτόματης δρομολόγησης: +- **Λάθος Κίνδυνος**: Χρησιμοποιήστε την ετικέτα `risk: manual` και διορθώστε χειροκίνητα. +- **Λάθος Κλείσιμο**: Ανοίξτε ξανά το PR και προσθέστε επεξηγηματικό σχόλιο. + +--- + +## 6. Πρωτόκολλο Μεταβίβασης (Handoff) + +Κατά τη μεταβίβαση ελέγχου, συμπεριλάβετε: +1. Σύνοψη της εμβέλειας και του επιπέδου κινδύνου. +2. Κατάσταση επαλήθευσης. +3. Εντοπισμένα εμπόδια ή εκκρεμότητες. +4. Προτεινόμενη επόμενη ενέργεια. diff --git a/docs/i18n/el/sandboxing.md b/docs/i18n/el/sandboxing.md new file mode 100644 index 000000000..b340e15aa --- /dev/null +++ b/docs/i18n/el/sandboxing.md @@ -0,0 +1,104 @@ +# Στρατηγικές Sandboxing για το ZeroClaw + +> [!WARNING] +> **Κατάσταση: Πρόταση / Οδικός Χάρτης** +> +> Αυτό το έγγραφο περιγράφει προτεινόμενες προσεγγίσεις περιορισμού. Για την τρέχουσα υλοποίηση, ανατρέξτε στα [config-reference.md](config-reference.md) και [operations-runbook.md](operations-runbook.md). + +## Περιγραφή Προβλήματος + +Το ZeroClaw εφαρμόζει ασφάλεια σε επίπεδο εφαρμογής (allowlists, path validation, injection prevention), αλλά δεν διαθέτει απομόνωση σε επίπεδο λειτουργικού συστήματος. Χωρίς sandboxing, ένας εξουσιοδοτημένος χρήστης μπορεί να εκτελέσει εντολές με τα πλήρη δικαιώματα της διεργασίας του ZeroClaw. + +--- + +## Προτεινόμενες Τεχνικές Προσεγγίσεις + +### 1. Firejail (Προτεινόμενο για Linux) + +Το Firejail παρέχει απομόνωση σε επίπεδο χρήστη (User Space) με ελάχιστη επιβάρυνση πόρων. + +```rust +// Παράδειγμα υλοποίησης περιβλήματος (Wrapper) +impl FirejailSandbox { + pub fn wrap_command(&self, cmd: &mut Command) -> &mut Command { + if !self.enabled { return cmd; } + + let mut jail = Command::new("firejail"); + jail.args([ + "--private=home", // Απομόνωση προσωπικού καταλόγου + "--private-dev", // Περιορισμένη πρόσβαση σε συσκευές + "--nosound", // Απενεργοποίηση ήχου + "--no3d", // Απενεργοποίηση επιτάχυνσης γραφικών + "--quiet", // Μείωση θορύβου καταγραφής + ]); + + // Ενσωμάτωση της αρχικής εντολής στο sandbox + // ... + } +} +``` + +### 2. Bubblewrap (Unprivileged Sandboxing) + +Χρήση kernel namespaces για τη δημιουργία εφήμερων περιβαλλόντων χωρίς την ανάγκη δικαιωμάτων root. + +```bash +# Παράδειγμα περιορισμού πρόσβασης με bwrap +bwrap --ro-bind /usr /usr \ + --proc /proc \ + --dev /dev \ + --unshare-all \ + --share-net \ + --die-with-parent \ + -- /bin/sh -c "command" +``` + +### 3. Landlock (Native Linux LSM) + +Περιορισμός πρόσβασης στο σύστημα αρχείων μέσω του εγγενούς μηχανισμού του πυρήνα Linux, χωρίς τη χρήση εξωτερικών εργαλείων. + +--- + +## Μήτρα Προτεραιοποίησης και Ασφάλειας + +| Φάση | Λύση | Προσπάθεια | Επίπεδο Απομόνωσης | +|:---:|:---|:---:|:---:| +| **P0** | Landlock (Native Linux) | Χαμηλή | Σύστημα Αρχείων | +| **P1** | Ενσωμάτωση Firejail | Χαμηλή | Πλήρες User Space | +| **P2** | Bubblewrap Wrapper | Μέτρια | Kernel Namespaces | +| **P3** | Ephemeral Docker Sandbox | Υψηλή | Πλήρης Εικονικοποίηση | + +--- + +## Προτεινόμενη Διαμόρφωση (Config Schema) + +```toml +[security.sandbox] +enabled = true +backend = "auto" # Επιλογές: auto, firejail, bubblewrap, landlock, docker, none + +# Ρυθμίσεις Firejail +[security.sandbox.firejail] +extra_args = ["--seccomp", "--caps.drop=all"] + +# Ρυθμίσεις Landlock +[security.sandbox.landlock] +readonly_paths = ["/usr", "/bin", "/lib"] +readwrite_paths = ["$HOME/workspace", "/tmp/zeroclaw"] +``` + +--- + +## Στρατηγική Επαλήθευσης + +```rust +#[cfg(test)] +mod tests { + #[test] + fn sandbox_blocks_unauthorized_access() { + // Επαλήθευση αποκλεισμού πρόσβασης σε ευαίσθητα αρχεία (π.χ. /etc/shadow) + let result = sandboxed_execute("cat /etc/shadow"); + assert!(result.is_err()); + } +} +``` diff --git a/docs/i18n/el/security-roadmap.md b/docs/i18n/el/security-roadmap.md new file mode 100644 index 000000000..1f0cb361a --- /dev/null +++ b/docs/i18n/el/security-roadmap.md @@ -0,0 +1,68 @@ +# Οδικός Χάρτης Ασφάλειας ZeroClaw (Security Roadmap) + +> [!WARNING] +> **Κατάσταση: Πρόταση / Οδικός Χάρτης** +> +> Το παρόν έγγραφο περιγράφει προτεινόμενες βελτιώσεις ασφάλειας και στρατηγικές απομόνωσης. Για την τρέχουσα υλοποίηση, συμβουλευτείτε τον [Οδηγό Αγνωστικιστικής Ασφάλειας](agnostic-security.md). + +--- + +## 1. Τρέχουσα Κατάσταση: Ασφάλεια Επίπεδου Εφαρμογής + +Το ZeroClaw διαθέτει ήδη ισχυρά θεμέλια ασφάλειας στο επίπεδο της εφαρμογής: + +- **Διαχείριση Πρόσβασης**: Αυστηρή πολιτική επιτρεπόμενων χρηστών (Allowlist) ανά κανάλι. +- **Περιορισμός Εντολών**: Καθορισμός επιτρεπόμενων εντολών και αποτροπή command injection. +- **Ακεραιότητα Διαδρομών**: Επαλήθευση path traversal και αποκλεισμός απαγορευμένων καταλόγων. +- **Προστασία Δεδομένων**: Απομόνωση μυστικών (API keys) από το κέλυφος και εκκαθάριση μεταβλητών περιβάλλοντος. +- **Ποιοτικός Έλεγχος**: 1.017 αυτοματοποιημένες δοκιμές (test coverage). + +## 2. Στρατηγικοί Στόχοι: Απομόνωση Επιπέδου Συστήματος + +Η επόμενη φάση ανάπτυξης εστιάζει στον περιορισμό του πράκτορα AI σε επίπεδο λειτουργικού συστήματος: + +- **Sandboxing**: Υλοποίηση απομόνωσης μέσω Linux namespaces (Firejail, Bubblewrap, Landlock). +- **Διαχείριση Πόρων**: Επιβολή ορίων σε CPU, RAM και I/O μέσω cgroups. +- **Σάρωση Κλήσεων Συστήματος**: Φιλτράρισμα επικίνδυνων κλήσεων μέσω Seccomp. +- **Αδιάβλητο Audit**: Καταγραφή συμβάντων με υπογραφή HMAC για την αποτροπή παραποίησης. + +--- + +## 3. Συγκριτική Ανάλυση: ZeroClaw vs PicoClaw + +| Παράμετρος | PicoClaw | ZeroClaw (Τρέχουσα) | ZeroClaw (Στόχος) | +|:---|:---:|:---:|:---:| +| **Μέγεθος Δυαδικού** | ~8MB | **3.4MB** ✅ | < 5MB | +| **Χρήση Μνήμης (Idle)** | < 10MB | **< 5MB** ✅ | < 20MB | +| **Χρόνος Εκκίνησης** | < 1s | **< 10ms** ✅ | < 100ms | +| **Sandbox ΛΕΙΤ.** | Όχι | ❌ Όχι | ✅ Native / Container | +| **Audit Logging** | Όχι | ❌ Όχι | ✅ HMAC Signed | +| **Επίπεδο Ασφαλείας** | C | **B+** | **A+** | + +--- + +## 4. Χρονοδιάγραμμα Υλοποίησης + +### Φάση 1: Άμεση Θωράκιση (P0-P1) + +- **Landlock integration**: Περιορισμός πρόσβασης στο σύστημα αρχείων μόνο στους απαραίτητους καταλόγους. +- **Resource Monitoring**: Προστασία από memory leaks και CPU exhaustion μέσω OOM kill και timeouts. +- **Basic Audit Engine**: Δημιουργία αδιάβλητου ίχνους ελέγχου (audit trail). + +### Φάση 2: Προηγμένη Απομόνωση (P1-P2) + +- **Firejail/Bubblewrap Wrappers**: Πλήρης απομόνωση user space διεργασιών. +- **Systemd Cgroups v2**: Ενσωμάτωση με τη διαχείριση πόρων του συστήματος. +- **Seccomp Filters**: Αποκλεισμός προνομιακών κλήσεων συστήματος. + +### Φάση 3: Επιχειρησιακή Ετοιμότητα (P2-P3) + +- **Docker Sandbox Mode**: Δυνατότητα εκτέλεσης σε εφήμερα κοντέινερ. +- **Signed Configuration**: Επαλήθευση ακεραιότητας αρχείων ρυθμίσεων. +- **SIEM Integration**: Εξαγωγή καταγραφών σε πρότυπα συμβατά με συστήματα παρακολούθησης ασφαλείας. + +--- + +## 5. Συμμετοχή και Αναφορά Ευπαθειών + +Εάν εντοπίσετε κενό ασφαλείας, παρακαλούμε ακολουθήστε τη διαδικασία **Private Disclosure** που περιγράφεται στο αρχείο `SECURITY.md`. Μην ανοίγετε δημόσια issues για θέματα ασφαλείας. diff --git a/docs/i18n/el/security/README.md b/docs/i18n/el/security/README.md new file mode 100644 index 000000000..eaa6f93ed --- /dev/null +++ b/docs/i18n/el/security/README.md @@ -0,0 +1,29 @@ +# Τεκμηρίωση Ασφάλειας (Security) + +Αυτή η ενότητα περιλαμβάνει οδηγούς θωράκισης (Hardening) για την τρέχουσα λειτουργία του συστήματος, καθώς και μελλοντικές προτάσεις ασφαλείας. + +--- + +## 1. Τρέχουσα Λειτουργία και Hardening + +Για τις ισχύουσες ρυθμίσεις ασφάλειας και τη διαχείριση του περιβάλλοντος εκτέλεσης (Runtime), συμβουλευτείτε τα παρακάτω: + +- **Configuration Reference**: [../config-reference.md](../config-reference.md) +- **Operations Runbook**: [../operations-runbook.md](../operations-runbook.md) +- **Troubleshooting**: [../troubleshooting.md](../troubleshooting.md) + +--- + +## 2. Προτάσεις και Οδικός Χάρτης (Roadmap) + +Τα παρακάτω έγγραφα περιγράφουν **προτεινόμενες** στρατηγικές και ενδέχεται να περιλαμβάνουν υποθετικά παραδείγματα ρυθμίσεων: + +- **Security Roadmap**: [../security-roadmap.md](../security-roadmap.md) +- **Agnostic Security**: [../agnostic-security.md](../agnostic-security.md) +- **Frictionless Security**: [../frictionless-security.md](../frictionless-security.md) +- **Sandboxing Strategies**: [../sandboxing.md](../sandboxing.md) +- **Resource Limits**: [../resource-limits.md](../resource-limits.md) +- **Audit Logging**: [../audit-logging.md](../audit-logging.md) + +> [!IMPORTANT] +> Τα έγγραφα της ενότητας "Roadmap" αποτελούν προτάσεις σχεδιασμού και δεν αντικατοπτρίζουν απαραίτητα την τρέχουσα υλοποίηση του ZeroClaw. diff --git a/docs/i18n/el/sop/README.md b/docs/i18n/el/sop/README.md new file mode 100644 index 000000000..e81d33d07 --- /dev/null +++ b/docs/i18n/el/sop/README.md @@ -0,0 +1,64 @@ +# Τυποποιημένες Διαδικασίες Λειτουργίας (SOP) + +Οι SOPs είναι ντετερμινιστικές διαδικασίες που εκτελούνται από το `SopEngine`. Παρέχουν αντιστοίχιση ενεργοποιητών, πύλες έγκρισης και ελέγξιμη κατάσταση εκτέλεσης. + +## Γρήγορα Μονοπάτια + +- **Σύνδεση Συμβάντων:** [Συνδεσιμότητα & Fan-In](connectivity.md) — ενεργοποίηση SOPs μέσω MQTT, webhooks, cron ή περιφερειακών. +- **Συγγραφή SOPs:** [Αναφορά Σύνταξης](syntax.md) — απαιτούμενη διάταξη αρχείου και σύνταξη triggers/βημάτων. +- **Παρακολούθηση:** [Παρατηρησιμότητα & Έλεγχος](observability.md) — πού αποθηκεύεται η κατάσταση εκτέλεσης και οι εγγραφές ελέγχου. +- **Παραδείγματα:** [Cookbook](cookbook.md) — επαναχρησιμοποιήσιμα πρότυπα SOP. + +## 1. Συμβόλαιο Χρόνου Εκτέλεσης (Τρέχον) + +- Οι ορισμοί SOP φορτώνονται από `/sops//SOP.toml` συν προαιρετικό `SOP.md`. +- Το CLI `zeroclaw sop` διαχειρίζεται αυτή τη στιγμή μόνο ορισμούς: `list`, `validate`, `show`. +- Οι εκτελέσεις SOP ξεκινούν από event fan-in (MQTT/webhook/cron/περιφερειακό) ή από το εργαλείο `sop_execute` εντός agent. +- Η πρόοδος εκτέλεσης χρησιμοποιεί εργαλεία: `sop_status`, `sop_approve`, `sop_advance`. +- Οι εγγραφές ελέγχου SOP αποθηκεύονται στο ρυθμισμένο backend Μνήμης κάτω από την κατηγορία `sop`. + +## 2. Ροή Συμβάντων + +```mermaid +graph LR + MQTT[MQTT] -->|topic match| Dispatch + WH[POST /sop/* or /webhook] -->|path match| Dispatch + CRON[Scheduler] -->|window check| Dispatch + GPIO[Peripheral] -->|board/signal match| Dispatch + + Dispatch --> Engine[SOP Engine] + Engine --> Run[SOP Run] + Run --> Action{Action} + Action -->|ExecuteStep| Agent[Agent Loop] + Action -->|WaitApproval| Human[Operator] + Human -->|sop_approve| Run +``` + +## 3. Ξεκινώντας + +1. Ενεργοποίηση υποσυστήματος SOP στο `config.toml`: + + ```toml + [sop] + enabled = true + sops_dir = "sops" # προεπιλογή /sops αν παραλειφθεί + ``` + +2. Δημιουργήστε έναν κατάλογο SOP, για παράδειγμα: + + ```text + ~/.zeroclaw/workspace/sops/deploy-prod/SOP.toml + ~/.zeroclaw/workspace/sops/deploy-prod/SOP.md + ``` + +3. Επαλήθευση και επιθεώρηση ορισμών: + + ```bash + zeroclaw sop list + zeroclaw sop validate + zeroclaw sop show deploy-prod + ``` + +4. Ενεργοποίηση εκτελέσεων μέσω ρυθμισμένων πηγών συμβάντων, ή χειροκίνητα από ένα turn agent με `sop_execute`. + +Για λεπτομέρειες δρομολόγησης triggers και πιστοποίησης, δείτε [Συνδεσιμότητα](connectivity.md). diff --git a/docs/i18n/el/sop/connectivity.md b/docs/i18n/el/sop/connectivity.md new file mode 100644 index 000000000..5ba245290 --- /dev/null +++ b/docs/i18n/el/sop/connectivity.md @@ -0,0 +1,143 @@ +# Συνδεσιμότητα SOP & Event Fan-In + +Αυτό το έγγραφο περιγράφει πώς τα εξωτερικά συμβάντα ενεργοποιούν εκτελέσεις SOP. + +## Γρήγορα Μονοπάτια + +- [Ενσωμάτωση MQTT](#2-ενσωμάτωση-mqtt) +- [Ενσωμάτωση Webhook](#3-ενσωμάτωση-webhook) +- [Ενσωμάτωση Cron](#4-ενσωμάτωση-cron) +- [Προεπιλογές Ασφαλείας](#5-προεπιλογές-ασφαλείας) +- [Αντιμετώπιση Προβλημάτων](#6-αντιμετώπιση-προβλημάτων) + +## 1. Επισκόπηση + +Το ZeroClaw δρομολογεί συμβάντα MQTT/webhook/cron/περιφερειακών μέσω ενός ενοποιημένου SOP dispatcher (`dispatch_sop_event`). + +Βασικές συμπεριφορές: + +- **Συνεπής αντιστοίχιση trigger:** ένα μονοπάτι matcher για όλες τις πηγές συμβάντων. +- **Έλεγχος εκκίνησης εκτέλεσης:** οι εκτελέσεις που ξεκινούν αποθηκεύονται μέσω `SopAuditLogger`. +- **Ασφάλεια headless:** σε πλαίσια εκτός agent-loop, οι ενέργειες `ExecuteStep` καταγράφονται ως εκκρεμείς (χωρίς σιωπηλή εκτέλεση). + +## 2. Ενσωμάτωση MQTT + +### 2.1 Ρύθμιση + +Ρυθμίστε την πρόσβαση στον broker στο `config.toml`: + +```toml +[channels_config.mqtt] +broker_url = "mqtts://broker.example.com:8883" # χρησιμοποιήστε mqtt:// για plaintext +client_id = "zeroclaw-agent-1" +topics = ["sensors/alert", "ops/deploy/#"] +qos = 1 +username = "mqtt-user" # προαιρετικό +password = "mqtt-password" # προαιρετικό +use_tls = true # πρέπει να ταιριάζει με το scheme (mqtts:// => true) +``` + +### 2.2 Ορισμός Trigger + +Στο `SOP.toml`: + +```toml +[[triggers]] +type = "mqtt" +topic = "sensors/alert" +condition = "$.severity >= 2" +``` + +Το payload MQTT προωθείται στο payload συμβάντος SOP (`event.payload`) και εμφανίζεται στο πλαίσιο βήματος. + +## 3. Ενσωμάτωση Webhook + +### 3.1 Endpoints + +- **`POST /sop/{*rest}`**: Endpoint αποκλειστικά για SOP. Επιστρέφει `404` αν δεν υπάρχει αντιστοίχιση. Χωρίς fallback LLM. +- **`POST /webhook`**: endpoint chat. Επιχειρεί πρώτα αποστολή SOP· αν δεν υπάρχει αντιστοίχιση, επιστρέφει στη κανονική ροή LLM. + +Η αντιστοίχιση μονοπατιού είναι ακριβής σε σχέση με το ρυθμισμένο μονοπάτι trigger webhook. + +Παράδειγμα: + +- Μονοπάτι trigger στο SOP: `path = "/sop/deploy"` +- Αντίστοιχο αίτημα: `POST /sop/deploy` + +### 3.2 Εξουσιοδότηση + +Όταν είναι ενεργοποιημένο το pairing (προεπιλογή), παρέχετε: + +1. `Authorization: Bearer ` (από `POST /pair`) +2. Προαιρετικό δεύτερο επίπεδο: `X-Webhook-Secret: ` όταν είναι ρυθμισμένο webhook secret + +### 3.3 Idempotency + +Χρησιμοποιήστε: + +`X-Idempotency-Key: ` + +Προεπιλογές: + +- TTL: 300s +- Απόκριση διπλότυπου: `200 OK` με `"status": "duplicate"` + +Τα κλειδιά idempotency είναι διαχωρισμένα ανά endpoint (`/webhook` vs `/sop/*`). + +### 3.4 Παράδειγμα Αιτήματος + +```bash +curl -X POST http://127.0.0.1:3000/sop/deploy \ + -H "Authorization: Bearer " \ + -H "X-Idempotency-Key: $(uuidgen)" \ + -H "Content-Type: application/json" \ + -d '{"message":"deploy-service-a"}' +``` + +Τυπική απόκριση: + +```json +{ + "status": "accepted", + "matched_sops": ["deploy-pipeline"], + "source": "sop_webhook", + "path": "/sop/deploy" +} +``` + +## 4. Ενσωμάτωση Cron + +Ο scheduler αξιολογεί τα αποθηκευμένα triggers cron χρησιμοποιώντας έλεγχο βασισμένο σε παράθυρο. + +- **Βασισμένο σε παράθυρο:** τα συμβάντα εντός `(last_check, now]` δεν χάνονται. +- **Το πολύ μία φορά ανά έκφραση ανά tick:** αν πολλά σημεία εκκίνησης βρίσκονται σε ένα παράθυρο poll, η αποστολή γίνεται μία φορά. + +Παράδειγμα trigger: + +```toml +[[triggers]] +type = "cron" +expression = "0 0 8 * * *" +``` + +Οι εκφράσεις cron υποστηρίζουν 5, 6 ή 7 πεδία. + +## 5. Προεπιλογές Ασφαλείας + +| Χαρακτηριστικό | Μηχανισμός | +|---|---| +| **MQTT transport** | `mqtts://` + `use_tls = true` για TLS transport | +| **Εξουσιοδότηση Webhook** | Bearer token pairing (απαιτείται εξ ορισμού), προαιρετικό κοινόχρηστο secret header | +| **Rate limiting** | Όρια ανά client στις διαδρομές webhook (`webhook_rate_limit_per_minute`, προεπιλογή `60`) | +| **Idempotency** | Dedup βάσει header (`X-Idempotency-Key`, προεπιλεγμένο TTL `300s`) | +| **Επικύρωση Cron** | Μη έγκυρες εκφράσεις cron αποτυγχάνουν κατά την ανάλυση/κατασκευή cache | + +## 6. Αντιμετώπιση Προβλημάτων + +| Σύμπτωμα | Πιθανή Αιτία | Διόρθωση | +|---|---|---| +| Σφάλματα σύνδεσης **MQTT** | αναντιστοιχία broker URL/TLS | Επαληθεύστε ζεύγος scheme + TLS flag (`mqtt://`/`false`, `mqtts://`/`true`) | +| **Webhook** `401 Unauthorized` | λείπει bearer ή μη έγκυρο secret | επαναφέρετε token (`POST /pair`) και επαληθεύστε `X-Webhook-Secret` αν έχει ρυθμιστεί | +| **`/sop/*` επιστρέφει 404** | αναντιστοιχία μονοπατιού trigger | βεβαιωθείτε ότι το `SOP.toml` χρησιμοποιεί ακριβές μονοπάτι (π.χ. `/sop/deploy`) | +| **SOP ξεκίνησε αλλά το βήμα δεν εκτελέστηκε** | headless trigger χωρίς ενεργό agent loop | εκτελέστε agent loop για `ExecuteStep`, ή σχεδιάστε εκτέλεση για παύση σε εγκρίσεις | +| **Το Cron δεν εκκινεί** | daemon δεν εκτελείται ή μη έγκυρη έκφραση | εκτελέστε `zeroclaw daemon`· ελέγξτε logs για προειδοποιήσεις ανάλυσης cron | diff --git a/docs/i18n/el/sop/cookbook.md b/docs/i18n/el/sop/cookbook.md new file mode 100644 index 000000000..a945ee361 --- /dev/null +++ b/docs/i18n/el/sop/cookbook.md @@ -0,0 +1,92 @@ +# SOP Cookbook + +Πρακτικά πρότυπα SOP στη μορφή `SOP.toml` + `SOP.md` που υποστηρίζεται από το runtime. + +## 1. Ανάπτυξη με Ανθρώπινο Έλεγχο (Human-in-the-Loop) + +`SOP.toml`: + +```toml +[sop] +name = "deploy-prod" +description = "Manual deployment with explicit approval gate" +version = "1.0.0" +priority = "high" +execution_mode = "supervised" +max_concurrent = 1 + +[[triggers]] +type = "manual" +``` + +`SOP.md`: + +```md +## Steps + +1. **Verify** — Check health metrics and rollout constraints. + - tools: http_request + +2. **Deploy** — Execute deployment command. + - tools: shell + - requires_confirmation: true +``` + +## 2. Χειριστής Ειδοποιήσεων IoT (MQTT) + +`SOP.toml`: + +```toml +[sop] +name = "high-temp-alert" +description = "Handle high temperature telemetry alerts" +version = "1.0.0" +priority = "critical" +execution_mode = "priority_based" + +[[triggers]] +type = "mqtt" +topic = "sensors/temp/alert" +condition = "$.temperature_c >= 85" +``` + +`SOP.md`: + +```md +## Steps + +1. **Analyze** — Read the `Payload:` section in this SOP context and determine severity. + - tools: memory_recall + +2. **Notify** — Send an alert with site/device/severity summary. + - tools: pushover +``` + +## 3. Ημερήσια Σύνοψη (Cron) + +`SOP.toml`: + +```toml +[sop] +name = "daily-summary" +description = "Generate daily operational summary" +version = "1.0.0" +priority = "normal" +execution_mode = "supervised" + +[[triggers]] +type = "cron" +expression = "0 9 * * *" +``` + +`SOP.md`: + +```md +## Steps + +1. **Collect Logs** — Gather recent errors and warnings. + - tools: file_read + +2. **Summarize** — Produce concise incident and trend summary. + - tools: memory_store +``` diff --git a/docs/i18n/el/sop/observability.md b/docs/i18n/el/sop/observability.md new file mode 100644 index 000000000..103428a1b --- /dev/null +++ b/docs/i18n/el/sop/observability.md @@ -0,0 +1,41 @@ +# Παρατηρησιμότητα & Έλεγχος SOP + +Αυτή η σελίδα καλύπτει πού αποθηκεύονται τα αποδεικτικά στοιχεία εκτέλεσης SOP και πώς να τα επιθεωρείτε. + +## 1. Αποθήκευση Ελέγχου + +Οι εγγραφές ελέγχου SOP αποθηκεύονται μέσω `SopAuditLogger` στο ρυθμισμένο backend Μνήμης, κατηγορία `sop`. + +Κοινά μοτίβα κλειδιών: + +- `sop_run_{run_id}`: στιγμιότυπο εκτέλεσης (ενημερώσεις εκκίνησης + ολοκλήρωσης) +- `sop_step_{run_id}_{step_number}`: αποτέλεσμα ανά βήμα +- `sop_approval_{run_id}_{step_number}`: εγγραφή έγκρισης operator +- `sop_timeout_approve_{run_id}_{step_number}`: εγγραφή αυτόματης έγκρισης λόγω timeout +- `sop_gate_decision_{gate_id}_{timestamp_ms}`: εγγραφή απόφασης αξιολογητή πύλης (όταν είναι ενεργό το `ampersona-gates`) +- `sop_phase_state`: αποθηκευμένο στιγμιότυπο κατάστασης φάσης εμπιστοσύνης (όταν είναι ενεργό το `ampersona-gates`) + +## 2. Μονοπάτια Επιθεώρησης + +### 2.1 CLI σε επίπεδο ορισμού + +```bash +zeroclaw sop list +zeroclaw sop validate [name] +zeroclaw sop show +``` + +### 2.2 Εργαλεία κατάστασης εκτέλεσης runtime + +Η κατάσταση εκτέλεσης SOP ερωτάται από εργαλεία εντός agent: + +- `sop_status` — ενεργές/ολοκληρωμένες εκτελέσεις και προαιρετικά μετρικά +- `sop_status` με `include_gate_status: true` — φάση εμπιστοσύνης και κατάσταση αξιολογητή πύλης (όταν διαθέσιμο) +- `sop_approve` — έγκριση αναμένοντος βήματος εκτέλεσης +- `sop_advance` — υποβολή αποτελέσματος βήματος και προώθηση εκτέλεσης + +## 3. Μετρικά + +- Το `/metrics` εκθέτει μετρικά observer όταν `[observability] backend = "prometheus"`. +- Τα τρέχοντα εξαγόμενα ονόματα είναι οικογένειες `zeroclaw_*` (γενικά μετρικά runtime). +- Συγκεντρωτικά στοιχεία ειδικά για SOP είναι διαθέσιμα μέσω `sop_status` με `include_metrics: true`. diff --git a/docs/i18n/el/sop/syntax.md b/docs/i18n/el/sop/syntax.md new file mode 100644 index 000000000..9ec4b1353 --- /dev/null +++ b/docs/i18n/el/sop/syntax.md @@ -0,0 +1,90 @@ +# Αναφορά Σύνταξης SOP + +Οι ορισμοί SOP φορτώνονται από υποκαταλόγους κάτω από το `sops_dir` (προεπιλογή: `/sops`). + +## 1. Διάταξη Καταλόγου + +```text +/sops/ + deploy-prod/ + SOP.toml + SOP.md +``` + +Κάθε SOP πρέπει να έχει `SOP.toml`. Το `SOP.md` είναι προαιρετικό, αλλά εκτελέσεις χωρίς αναλυμένα βήματα θα αποτύχουν κατά την επικύρωση. + +## 2. `SOP.toml` + +```toml +[sop] +name = "deploy-prod" +description = "Deploy service to production" +version = "1.0.0" +priority = "high" # low | normal | high | critical +execution_mode = "supervised" # auto | supervised | step_by_step | priority_based +cooldown_secs = 300 +max_concurrent = 1 + +[[triggers]] +type = "webhook" +path = "/sop/deploy" + +[[triggers]] +type = "manual" + +[[triggers]] +type = "mqtt" +topic = "ops/deploy" +condition = "$.env == \"prod\"" +``` + +## 3. Μορφή Βημάτων `SOP.md` + +Τα βήματα αναλύονται από την ενότητα `## Steps`. + +```md +## Steps + +1. **Preflight** — Check service health and release window. + - tools: http_request + +2. **Deploy** — Run deployment command. + - tools: shell + - requires_confirmation: true +``` + +Συμπεριφορά parser: + +- Αριθμημένα στοιχεία (`1.`, `2.`, ...) ορίζουν τη σειρά βημάτων. +- Κεφαλαίο έντονο κείμενο (`**Τίτλος**`) γίνεται τίτλος βήματος. +- `- tools:` αντιστοιχίζεται σε `suggested_tools`. +- `- requires_confirmation: true` επιβάλλει έγκριση για αυτό το βήμα. + +## 4. Τύποι Trigger + +| Τύπος | Πεδία | Σημειώσεις | +|---|---|---| +| `manual` | κανένα | Ενεργοποιείται από το εργαλείο `sop_execute` (όχι από CLI `zeroclaw sop run`). | +| `webhook` | `path` | Ακριβής αντιστοίχιση με μονοπάτι αιτήματος (`/sop/...` ή `/webhook`). | +| `mqtt` | `topic`, προαιρετικό `condition` | Το MQTT topic υποστηρίζει wildcards `+` και `#`. | +| `cron` | `expression` | Υποστηρίζει 5, 6 ή 7 πεδία (τα 5-πεδία λαμβάνουν δευτερόλεπτα εσωτερικά). | +| `peripheral` | `board`, `signal`, προαιρετικό `condition` | Αντιστοιχεί `"{board}/{signal}"`. | + +## 5. Σύνταξη Condition + +Το `condition` αξιολογείται fail-closed (μη έγκυρη συνθήκη/payload => καμία αντιστοίχιση). + +- Συγκρίσεις JSON path: `$.value > 85`, `$.status == "critical"` +- Άμεσες αριθμητικές συγκρίσεις: `> 0` (χρήσιμο για απλά payloads) +- Τελεστές: `>=`, `<=`, `!=`, `>`, `<`, `==` + +## 6. Επικύρωση + +Χρησιμοποιήστε: + +```bash +zeroclaw sop validate +zeroclaw sop validate +``` + +Η επικύρωση προειδοποιεί για κενά ονόματα/περιγραφές, απόντα triggers, απόντα βήματα και κενά στην αρίθμηση βημάτων. diff --git a/docs/i18n/el/structure/README.md b/docs/i18n/el/structure/README.md new file mode 100644 index 000000000..b819bddc7 --- /dev/null +++ b/docs/i18n/el/structure/README.md @@ -0,0 +1,88 @@ +# Χάρτης Δομής Τεκμηρίωσης ZeroClaw + +Αυτή η σελίδα ορίζει τη δομή της τεκμηρίωσης κατά τρεις άξονες: + +1. Γλώσσα +2. Τμήμα (κατηγορία) +3. Λειτουργία (σκοπός εγγράφου) + +Τελευταία ενημέρωση: **22 Φεβρουαρίου 2026**. + +## 1) Κατά Γλώσσα + +| Γλώσσα | Σημείο εισόδου | Κανονικό δέντρο | Σημειώσεις | +|---|---|---|---| +| Αγγλικά | `docs/README.md` | `docs/` | Τα έγγραφα runtime συμπεριφοράς που αποτελούν πηγή αλήθειας συντάσσονται πρώτα στα Αγγλικά. | +| Κινεζικά (`zh-CN`) | `docs/README.zh-CN.md` | `docs/` τοπικοποιημένο hub + επιλεγμένα τοπικοποιημένα έγγραφα | Χρησιμοποιεί τοπικοποιημένο hub και κοινή κατηγοριακή δομή. | +| Ιαπωνικά (`ja`) | `docs/README.ja.md` | `docs/` τοπικοποιημένο hub + επιλεγμένα τοπικοποιημένα έγγραφα | Χρησιμοποιεί τοπικοποιημένο hub και κοινή κατηγοριακή δομή. | +| Ρωσικά (`ru`) | `docs/README.ru.md` | `docs/` τοπικοποιημένο hub + επιλεγμένα τοπικοποιημένα έγγραφα | Χρησιμοποιεί τοπικοποιημένο hub και κοινή κατηγοριακή δομή. | +| Γαλλικά (`fr`) | `docs/README.fr.md` | `docs/` τοπικοποιημένο hub + επιλεγμένα τοπικοποιημένα έγγραφα | Χρησιμοποιεί τοπικοποιημένο hub και κοινή κατηγοριακή δομή. | +| Βιετναμέζικα (`vi`) | `docs/i18n/vi/README.md` | `docs/i18n/vi/` | Το πλήρες βιετναμέζικο δέντρο είναι κανονικό κάτω από `docs/i18n/vi/`· τα `docs/vi/` και `docs/*.vi.md` είναι μονοπάτια συμβατότητας. | +| Ελληνικά (`el`) | `docs/i18n/el/README.md` | `docs/i18n/el/` | Το πλήρες ελληνικό δέντρο είναι κανονικό κάτω από `docs/i18n/el/`. | + +## 2) Κατά Τμήμα (Κατηγορία) + +Αυτοί οι κατάλογοι είναι τα κύρια module πλοήγησης ανά περιοχή προϊόντος. + +- `docs/getting-started/` για αρχική ρύθμιση και ροές πρώτης εκτέλεσης +- `docs/reference/` για ευρετήρια αναφοράς εντολών/ρύθμισης/παρόχων/καναλιών +- `docs/operations/` για λειτουργίες Day-2, ανάπτυξη και σημεία εισόδου αντιμετώπισης προβλημάτων +- `docs/security/` για οδηγίες ασφαλείας και πλοήγηση προσανατολισμένη στην ασφάλεια +- `docs/hardware/` για υλοποίηση πλακέτας/περιφερειακών και ροές εργασίας υλικού +- `docs/contributing/` για διαδικασίες συνεισφοράς και CI/review +- `docs/project/` για στιγμιότυπα έργου, πλαίσιο σχεδιασμού και έγγραφα κατάστασης + +## 3) Κατά Λειτουργία (Σκοπός Εγγράφου) + +Χρησιμοποιήστε αυτή την ομαδοποίηση για να αποφασίσετε πού ανήκουν νέα έγγραφα. + +### Συμβόλαιο Runtime (τρέχουσα συμπεριφορά) + +- `docs/commands-reference.md` +- `docs/providers-reference.md` +- `docs/channels-reference.md` +- `docs/config-reference.md` +- `docs/operations-runbook.md` +- `docs/troubleshooting.md` +- `docs/one-click-bootstrap.md` + +### Οδηγοί Ρύθμισης / Ενσωμάτωσης + +- `docs/custom-providers.md` +- `docs/zai-glm-setup.md` +- `docs/langgraph-integration.md` +- `docs/network-deployment.md` +- `docs/matrix-e2ee-guide.md` +- `docs/mattermost-setup.md` +- `docs/nextcloud-talk-setup.md` + +### Πολιτική / Διαδικασία + +- `docs/pr-workflow.md` +- `docs/reviewer-playbook.md` +- `docs/ci-map.md` +- `docs/actions-source-policy.md` + +### Προτάσεις / Οδικοί Χάρτες + +- `docs/sandboxing.md` +- `docs/resource-limits.md` +- `docs/audit-logging.md` +- `docs/agnostic-security.md` +- `docs/frictionless-security.md` +- `docs/security-roadmap.md` + +### Στιγμιότυπα / Χρονοδεσμευμένες Αναφορές + +- `docs/project-triage-snapshot-2026-02-18.md` + +### Στοιχεία / Πρότυπα + +- `docs/datasheets/` +- `docs/doc-template.md` + +## Κανόνες Τοποθέτησης (Σύντομα) + +- Τα νέα έγγραφα runtime συμπεριφοράς πρέπει να συνδέονται από το κατάλληλο ευρετήριο κατηγορίας και το `docs/SUMMARY.md`. +- Οι αλλαγές πλοήγησης πρέπει να διατηρούν ισοτιμία locale σε όλα τα `docs/README*.md` και `docs/SUMMARY*.md`. +- Η πλήρης τοπικοποίηση για Βιετναμέζικα βρίσκεται στο `docs/i18n/vi/`· τα αρχεία συμβατότητας πρέπει να δείχνουν σε κανονικά μονοπάτια. diff --git a/docs/i18n/el/troubleshooting.md b/docs/i18n/el/troubleshooting.md new file mode 100644 index 000000000..b33d9dcf2 --- /dev/null +++ b/docs/i18n/el/troubleshooting.md @@ -0,0 +1,114 @@ +# Αντιμετώπιση Προβλημάτων (Troubleshooting) + +Αυτός ο οδηγός περιγράφει λύσεις για κοινά ζητήματα εγκατάστασης και εκτέλεσης του ZeroClaw. + +Τελευταία ενημέρωση: 20 Φεβρουαρίου 2026. + +--- + +## 1. Εγκατάσταση και Προετοιμασία (Bootstrap) + +### Σφάλμα: `cargo is not installed` + +**Αιτία**: Η Rust toolchain δεν είναι εγκατεστημένη. +**Λύση**: +Εκτελέστε την αυτόματη εγκατάσταση: +```bash +./bootstrap.sh --install-rust +``` +Εναλλακτικά, επισκεφθείτε τη διεύθυνση [rustup.rs](https://rustup.rs/). + +### Σφάλματα Μεταγλώττισης (Compilation Errors) + +**Σύμπτωμα**: Αποτυχία λόγω προβλημάτων στον μεταγλωττιστή ή στο `pkg-config`. +**Λύση**: +Εγκαταστήστε τις εξαρτήσεις συστήματος (system dependencies): +```bash +./bootstrap.sh --install-system-deps +``` + +### Περιορισμένοι Πόροι (RAM / Disk Space) + +**Σύμπτωμα**: Τερματισμός της διαδικασίας από τον OOM killer ή σφάλμα `cannot allocate memory`. +**Λύση**: +Χρησιμοποιήστε προ-μεταγλωττισμένα (prebuilt) αρχεία: +```bash +./bootstrap.sh --prefer-prebuilt +``` +Εάν επιθυμείτε μεταγλώττιση από τον πηγαίο κώδικα σε περιβάλλον με περιορισμένη μνήμη, περιορίστε τον παραλληλισμό: +```bash +CARGO_BUILD_JOBS=1 cargo build --release --locked +``` + +--- + +## 2. Χρόνος Εκκίνησης και Συνδεσιμότητα (Runtime) + +### Αργή Μεταγλώττιση + +Η στοίβα Matrix E2EE και τα native scripts για κρυπτογραφία απαιτούν σημαντικούς πόρους. +- Για ταχύτερο τοπικό έλεγχο χωρίς Matrix: + ```bash + cargo check + ``` +- Για ανάλυση χρόνων μεταγλώττισης: + ```bash + cargo check --timings + ``` + +### Η Πύλη (Gateway) δεν είναι προσβάσιμη + +Επαληθεύστε την κατάσταση του συστήματος: +```bash +zeroclaw status +zeroclaw doctor +``` +Ελέγξτε τις ρυθμίσεις στο `~/.zeroclaw/config.toml`: +- `[gateway].host` (Προεπιλογή: `127.0.0.1`) +- `[gateway].port` (Προεπιλογή: `42617`) + +--- + +## 3. Κανάλια Επικοινωνίας (Channels) + +### Σύγκρουση Telegram: `terminated by other getUpdates request` + +**Αιτία**: Πολλαπλά instances χρησιμοποιούν το ίδιο Bot Token. +**Λύση**: Τερματίστε όλες τις άλλες διεργασίες που χρησιμοποιούν το συγκεκριμένο token. + +### Διάγνωση Καναλιού + +Εκτελέστε την εντολή: +```bash +zeroclaw channel doctor +``` + +--- + +## 4. Λειτουργία ως Υπηρεσία (Service Mode) + +### Η υπηρεσία δεν εκκινεί + +Ελέγξτε την κατάσταση μέσω του ZeroClaw CLI: +```bash +zeroclaw service status +``` +Για προβολή των logs στο Linux: +```bash +journalctl --user -u zeroclaw.service -f +``` + +--- + +## 5. Υποβολή Αναφοράς Προβλήματος + +Εάν το πρόβλημα επιμένει, συμπεριλάβετε τα αποτελέσματα των παρακάτω εντολών στην αναφορά σας: +```bash +zeroclaw --version +zeroclaw status +zeroclaw doctor +zeroclaw channel doctor +``` + +> [!TIP] +> Παρακαλείστε να αφαιρέσετε τυχόν ευαίσθητα δεδομένα (API keys, Tokens) από το αρχείο ρυθμίσεων πριν το κοινοποιήσετε. diff --git a/docs/i18n/el/zai-glm-setup.md b/docs/i18n/el/zai-glm-setup.md new file mode 100644 index 000000000..eeae1c1eb --- /dev/null +++ b/docs/i18n/el/zai-glm-setup.md @@ -0,0 +1,82 @@ +# Διαμόρφωση Z.AI GLM + +Το ZeroClaw υποστηρίζει τα μοντέλα GLM της Z.AI μέσω διεπαφών συμβατών με το OpenAI API. + +--- + +## 1. Τελικά Σημεία και Ψευδώνυμα (Endpoints & Aliases) + +Το ZeroClaw υποστηρίζει τα εξής προκαθορισμένα ψευδώνυμα για την Z.AI: + +| Ψευδώνυμο | URL Τελικού Σημείου | Περιγραφή | +|:---|:---|:---| +| `zai` | `https://api.z.ai/api/coding/paas/v4` | Παγκόσμιο (Global) Endpoint | +| `zai-cn` | `https://open.bigmodel.cn/api/paas/v4` | Endpoint Κίνας | + +> [!NOTE] +> Για τη χρήση προσαρμοσμένων διευθύνσεων (Custom Base URLs), συμβουλευτείτε τον οδηγό [custom-providers.md](custom-providers.md). + +--- + +## 2. Διαδικασία Ρύθμισης + +### Ταχεία Διαμόρφωση (Onboarding) + +Χρησιμοποιήστε το CLI για αυτόματη ρύθμιση: +```bash +zeroclaw onboard \ + --provider "zai" \ + --api-key "YOUR_ZAI_API_KEY" +``` + +### Χειροκίνητη Διαμόρφωση + +Επεξεργαστείτε το αρχείο `~/.zeroclaw/config.toml`: +```toml +api_key = "YOUR_ZAI_API_KEY" +default_provider = "zai" +default_model = "glm-5" +default_temperature = 0.7 +``` + +--- + +## 3. Διαθέσιμα Μοντέλα + +| Μοντέλο | Χαρακτηριστικά | +|:---|:---| +| `glm-5` | Κορυφαία απόδοση και προηγμένη συλλογιστική (Reasoning). | +| `glm-4.7` | Υψηλή ποιότητα για γενική χρήση. | +| `glm-4.5-air` | Βελτιστοποιημένο για χαμηλή καθυστέρηση (Low Latency). | + +--- + +## 4. Επαλήθευση και Διάγνωση + +### Δοκιμή Συνδεσιμότητας (Curl) + +```bash +curl -X POST "https://api.z.ai/api/coding/paas/v4/chat/completions" \ + -H "Authorization: Bearer YOUR_ZAI_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{ + "model": "glm-5", + "messages": [{"role": "user", "content": "Hello"}] + }' +``` + +### Μεταβλητές Περιβάλλοντος + +Μπορείτε να ορίσετε το κλειδί στο αρχείο `.env`: +```bash +ZAI_API_KEY=id.secret # Μορφή: abc123.xyz789 +``` + +--- + +## 5. Αντιμετώπιση Προβλημάτων + +- **Περιορισμός Ρυθμού (Rate Limiting)**: Σε περίπτωση σφαλμάτων `rate_limited`, δοκιμάστε το μοντέλο `glm-4.5-air` ή ελέγξτε τα όρια του λογαριασμού σας στη Z.AI. +- **Σφάλμα Ελέγχου Ταυτότητας (401/403)**: + - Επαληθεύστε τη μορφή `id.secret`. + - Βεβαιωθείτε ότι δεν υπάρχουν περιττά κενά ή χαρακτήρες αλλαγής γραμμής στο κλειδί. diff --git a/docs/i18n/fr/README.md b/docs/i18n/fr/README.md new file mode 100644 index 000000000..140a5c853 --- /dev/null +++ b/docs/i18n/fr/README.md @@ -0,0 +1,51 @@ +# Hub de Documentation ZeroClaw (Français) + +Cette page est le hub français aligné sur la structure canonique `docs/i18n//`. + +Dernière mise à jour : **24 février 2026**. + +> Note : les commandes, clés de configuration et chemins API restent en anglais. + +## Accès rapide + +- README français (racine) : [../../../README.fr.md](../../../README.fr.md) +- Hub docs français (compatibilité) : [../../README.fr.md](../../README.fr.md) +- Sommaire français (compatibilité) : [../../SUMMARY.fr.md](../../SUMMARY.fr.md) +- Hub docs anglais : [../../README.md](../../README.md) + +## Documents runtime Wave 1 + +- Référence des commandes : [commands-reference.md](commands-reference.md) +- Référence des providers : [providers-reference.md](providers-reference.md) +- Référence des canaux : [channels-reference.md](channels-reference.md) +- Référence de configuration : [config-reference.md](config-reference.md) +- Runbook d'exploitation : [operations-runbook.md](operations-runbook.md) +- Dépannage : [troubleshooting.md](troubleshooting.md) + +État actuel : **parité top-level terminée** (40/40). + +## Index complet et gouvernance + +- Inventaire documentaire local : [docs-inventory.md](docs-inventory.md) +- Guide d'exécution i18n : [i18n-guide.md](i18n-guide.md) +- Couverture i18n : [i18n-coverage.md](i18n-coverage.md) +- Suivi des écarts i18n : [i18n-gap-backlog.md](i18n-gap-backlog.md) + +## Catégories + +- Démarrage : [../../getting-started/README.md](../../getting-started/README.md) +- Référence : [../../reference/README.md](../../reference/README.md) +- Opérations et déploiement : [../../operations/README.md](../../operations/README.md) +- Sécurité : [../../security/README.md](../../security/README.md) +- Matériel : [../../hardware/README.md](../../hardware/README.md) +- Contribution / CI : [../../contributing/README.md](../../contributing/README.md) +- Table des matières locale : [SUMMARY.md](SUMMARY.md) + +## Autres langues + +- English: [../../README.md](../../README.md) +- 简体中文: [../zh-CN/README.md](../zh-CN/README.md) +- 日本語: [../ja/README.md](../ja/README.md) +- Русский: [../ru/README.md](../ru/README.md) +- Tiếng Việt: [../vi/README.md](../vi/README.md) +- Ελληνικά: [../el/README.md](../el/README.md) diff --git a/docs/i18n/fr/SUMMARY.md b/docs/i18n/fr/SUMMARY.md new file mode 100644 index 000000000..a71959d7f --- /dev/null +++ b/docs/i18n/fr/SUMMARY.md @@ -0,0 +1,38 @@ +# Sommaire de la documentation ZeroClaw (Français, i18n) + +Ce fichier est l'index de navigation pour `docs/i18n/fr/`. + +Dernière mise à jour : **24 février 2026**. + +## Points d'entrée + +- Hub i18n français : [README.md](README.md) +- Hub français (compatibilité) : [../../README.fr.md](../../README.fr.md) +- Sommaire français (compatibilité) : [../../SUMMARY.fr.md](../../SUMMARY.fr.md) +- Index i18n : [../README.md](../README.md) +- Carte de couverture i18n : [../../i18n-coverage.md](../../i18n-coverage.md) + +## Catégories + +- Démarrage : [../../getting-started/README.md](../../getting-started/README.md) +- Référence : [../../reference/README.md](../../reference/README.md) +- Opérations : [../../operations/README.md](../../operations/README.md) +- Sécurité : [../../security/README.md](../../security/README.md) +- Matériel : [../../hardware/README.md](../../hardware/README.md) +- Contribution / CI : [../../contributing/README.md](../../contributing/README.md) + +## Documents runtime Wave 1 + +- Référence des commandes : [commands-reference.md](commands-reference.md) +- Référence des providers : [providers-reference.md](providers-reference.md) +- Référence des canaux : [channels-reference.md](channels-reference.md) +- Référence de configuration : [config-reference.md](config-reference.md) +- Runbook d'exploitation : [operations-runbook.md](operations-runbook.md) +- Dépannage : [troubleshooting.md](troubleshooting.md) + +## Gouvernance et index + +- Inventaire documentaire : [docs-inventory.md](docs-inventory.md) +- Guide i18n : [i18n-guide.md](i18n-guide.md) +- Couverture : [i18n-coverage.md](i18n-coverage.md) +- Suivi des écarts : [i18n-gap-backlog.md](i18n-gap-backlog.md) diff --git a/docs/i18n/fr/actions-source-policy.md b/docs/i18n/fr/actions-source-policy.md new file mode 100644 index 000000000..46b3bac79 --- /dev/null +++ b/docs/i18n/fr/actions-source-policy.md @@ -0,0 +1,34 @@ +# Passerelle de localisation: Actions Source Policy + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../actions-source-policy.md](../../actions-source-policy.md) + +## Positionnement du sujet + +- Catégorie : Sécurité et gouvernance +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Current Policy](../../actions-source-policy.md#current-policy) +- [H2 · Change Control Export](../../actions-source-policy.md#change-control-export) +- [H2 · Why This Phase](../../actions-source-policy.md#why-this-phase) +- [H2 · Agentic Workflow Guardrails](../../actions-source-policy.md#agentic-workflow-guardrails) +- [H2 · Validation Checklist](../../actions-source-policy.md#validation-checklist) +- [H2 · Rollback](../../actions-source-policy.md#rollback) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/adding-boards-and-tools.md b/docs/i18n/fr/adding-boards-and-tools.md new file mode 100644 index 000000000..77503f8f9 --- /dev/null +++ b/docs/i18n/fr/adding-boards-and-tools.md @@ -0,0 +1,40 @@ +# Passerelle de localisation: Adding Boards And Tools + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../adding-boards-and-tools.md](../../adding-boards-and-tools.md) + +## Positionnement du sujet + +- Catégorie : Matériel et périphériques +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Quick Start: Add a Board via CLI](../../adding-boards-and-tools.md#quick-start-add-a-board-via-cli) +- [H2 · Supported Boards](../../adding-boards-and-tools.md#supported-boards) +- [H2 · Manual Config](../../adding-boards-and-tools.md#manual-config) +- [H2 · Adding a Datasheet (RAG)](../../adding-boards-and-tools.md#adding-a-datasheet-rag) +- [H3 · Pin Aliases (Recommended)](../../adding-boards-and-tools.md#pin-aliases-recommended) +- [H2 · Pin Aliases](../../adding-boards-and-tools.md#pin-aliases) +- [H2 · Pin Aliases](../../adding-boards-and-tools.md#pin-aliases) +- [H3 · PDF Datasheets](../../adding-boards-and-tools.md#pdf-datasheets) +- [H2 · Adding a New Board Type](../../adding-boards-and-tools.md#adding-a-new-board-type) +- [H2 · Adding a Custom Tool](../../adding-boards-and-tools.md#adding-a-custom-tool) +- [H2 · CLI Reference](../../adding-boards-and-tools.md#cli-reference) +- [H2 · Troubleshooting](../../adding-boards-and-tools.md#troubleshooting) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/agnostic-security.md b/docs/i18n/fr/agnostic-security.md new file mode 100644 index 000000000..a50c19032 --- /dev/null +++ b/docs/i18n/fr/agnostic-security.md @@ -0,0 +1,46 @@ +# Passerelle de localisation: Agnostic Security + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../agnostic-security.md](../../agnostic-security.md) + +## Positionnement du sujet + +- Catégorie : Sécurité et gouvernance +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Core Question: Will security features break...](../../agnostic-security.md#core-question-will-security-features-break) +- [H2 · 1. Build Speed: Feature-Gated Security](../../agnostic-security.md#1-build-speed-feature-gated-security) +- [H3 · Cargo.toml: Security Features Behind Features](../../agnostic-security.md#cargo-toml-security-features-behind-features) +- [H3 · Build Commands (Choose Your Profile)](../../agnostic-security.md#build-commands-choose-your-profile) +- [H3 · Conditional Compilation: Zero Overhead When Disabled](../../agnostic-security.md#conditional-compilation-zero-overhead-when-disabled) +- [H2 · 2. Pluggable Architecture: Security Is a Trait Too](../../agnostic-security.md#2-pluggable-architecture-security-is-a-trait-too) +- [H3 · Security Backend Trait (Swappable Like Everything Else)](../../agnostic-security.md#security-backend-trait-swappable-like-everything-else) +- [H3 · Factory Pattern: Auto-Select Based on Features](../../agnostic-security.md#factory-pattern-auto-select-based-on-features) +- [H2 · 3. Hardware Agnosticism: Same Binary, Different Platforms](../../agnostic-security.md#3-hardware-agnosticism-same-binary-different-platforms) +- [H3 · Cross-Platform Behavior Matrix](../../agnostic-security.md#cross-platform-behavior-matrix) +- [H3 · How It Works: Runtime Detection](../../agnostic-security.md#how-it-works-runtime-detection) +- [H2 · 4. Small Hardware: Memory Impact Analysis](../../agnostic-security.md#4-small-hardware-memory-impact-analysis) +- [H3 · Binary Size Impact (Estimated)](../../agnostic-security.md#binary-size-impact-estimated) +- [H3 · $10 Hardware Compatibility](../../agnostic-security.md#10-hardware-compatibility) +- [H2 · 5. Agnostic Swaps: Everything Remains Pluggable](../../agnostic-security.md#5-agnostic-swaps-everything-remains-pluggable) +- [H3 · ZeroClaw's Core Promise: Swap Anything](../../agnostic-security.md#zeroclaw-s-core-promise-swap-anything) +- [H3 · Swap Security Backends via Config](../../agnostic-security.md#swap-security-backends-via-config) +- [H2 · 6. Dependency Impact: Minimal New Deps](../../agnostic-security.md#6-dependency-impact-minimal-new-deps) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/android-setup.md b/docs/i18n/fr/android-setup.md new file mode 100644 index 000000000..037f88dac --- /dev/null +++ b/docs/i18n/fr/android-setup.md @@ -0,0 +1,40 @@ +# Passerelle de localisation: Android Setup + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../android-setup.md](../../android-setup.md) + +## Positionnement du sujet + +- Catégorie : Matériel et périphériques +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Supported Architectures](../../android-setup.md#supported-architectures) +- [H2 · Installation via Termux](../../android-setup.md#installation-via-termux) +- [H3 · 1. Install Termux](../../android-setup.md#1-install-termux) +- [H3 · 2. Download ZeroClaw](../../android-setup.md#2-download-zeroclaw) +- [H3 · 3. Install and Run](../../android-setup.md#3-install-and-run) +- [H2 · Direct Installation via ADB](../../android-setup.md#direct-installation-via-adb) +- [H2 · Limitations on Android](../../android-setup.md#limitations-on-android) +- [H2 · Building from Source](../../android-setup.md#building-from-source) +- [H2 · Troubleshooting](../../android-setup.md#troubleshooting) +- [H3 · "Permission denied"](../../android-setup.md#permission-denied) +- [H3 · "not found" or linker errors](../../android-setup.md#not-found-or-linker-errors) +- [H3 · Old Android (4.x)](../../android-setup.md#old-android-4-x) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/arduino-uno-q-setup.md b/docs/i18n/fr/arduino-uno-q-setup.md new file mode 100644 index 000000000..ddbd0a61b --- /dev/null +++ b/docs/i18n/fr/arduino-uno-q-setup.md @@ -0,0 +1,46 @@ +# Passerelle de localisation: Arduino Uno Q Setup + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../arduino-uno-q-setup.md](../../arduino-uno-q-setup.md) + +## Positionnement du sujet + +- Catégorie : Matériel et périphériques +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · What's Included (No Code Changes Needed)](../../arduino-uno-q-setup.md#what-s-included-no-code-changes-needed) +- [H2 · Prerequisites](../../arduino-uno-q-setup.md#prerequisites) +- [H2 · Phase 1: Initial Uno Q Setup (One-Time)](../../arduino-uno-q-setup.md#phase-1-initial-uno-q-setup-one-time) +- [H3 · 1.1 Configure Uno Q via App Lab](../../arduino-uno-q-setup.md#1-1-configure-uno-q-via-app-lab) +- [H3 · 1.2 Verify SSH Access](../../arduino-uno-q-setup.md#1-2-verify-ssh-access) +- [H2 · Phase 2: Install ZeroClaw on Uno Q](../../arduino-uno-q-setup.md#phase-2-install-zeroclaw-on-uno-q) +- [H3 · Option A: Build on the Device (Simpler, ~20–40 min)](../../arduino-uno-q-setup.md#option-a-build-on-the-device-simpler-20-40-min) +- [H3 · Option B: Cross-Compile on Mac (Faster)](../../arduino-uno-q-setup.md#option-b-cross-compile-on-mac-faster) +- [H2 · Phase 3: Configure ZeroClaw](../../arduino-uno-q-setup.md#phase-3-configure-zeroclaw) +- [H3 · 3.1 Run Onboard (or Create Config Manually)](../../arduino-uno-q-setup.md#3-1-run-onboard-or-create-config-manually) +- [H3 · 3.2 Minimal config.toml](../../arduino-uno-q-setup.md#3-2-minimal-config-toml) +- [H2 · Phase 4: Run ZeroClaw Daemon](../../arduino-uno-q-setup.md#phase-4-run-zeroclaw-daemon) +- [H2 · Phase 5: GPIO via Bridge (ZeroClaw Handles It)](../../arduino-uno-q-setup.md#phase-5-gpio-via-bridge-zeroclaw-handles-it) +- [H3 · 5.1 Deploy Bridge App](../../arduino-uno-q-setup.md#5-1-deploy-bridge-app) +- [H3 · 5.2 Add to config.toml](../../arduino-uno-q-setup.md#5-2-add-to-config-toml) +- [H3 · 5.3 Run ZeroClaw](../../arduino-uno-q-setup.md#5-3-run-zeroclaw) +- [H2 · Summary: Commands Start to End](../../arduino-uno-q-setup.md#summary-commands-start-to-end) +- [H2 · Troubleshooting](../../arduino-uno-q-setup.md#troubleshooting) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/audit-event-schema.md b/docs/i18n/fr/audit-event-schema.md new file mode 100644 index 000000000..11119cd22 --- /dev/null +++ b/docs/i18n/fr/audit-event-schema.md @@ -0,0 +1,32 @@ +# Passerelle de localisation: Audit Event Schema + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../audit-event-schema.md](../../audit-event-schema.md) + +## Positionnement du sujet + +- Catégorie : Sécurité et gouvernance +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Envelope](../../audit-event-schema.md#envelope) +- [H2 · Event Types](../../audit-event-schema.md#event-types) +- [H2 · Retention Policy](../../audit-event-schema.md#retention-policy) +- [H2 · Governance](../../audit-event-schema.md#governance) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/audit-logging.md b/docs/i18n/fr/audit-logging.md new file mode 100644 index 000000000..0416f36ab --- /dev/null +++ b/docs/i18n/fr/audit-logging.md @@ -0,0 +1,35 @@ +# Passerelle de localisation: Audit Logging + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../audit-logging.md](../../audit-logging.md) + +## Positionnement du sujet + +- Catégorie : Sécurité et gouvernance +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Problem](../../audit-logging.md#problem) +- [H2 · Proposed Audit Log Format](../../audit-logging.md#proposed-audit-log-format) +- [H2 · Implementation](../../audit-logging.md#implementation) +- [H2 · Config Schema](../../audit-logging.md#config-schema) +- [H2 · Audit Query CLI](../../audit-logging.md#audit-query-cli) +- [H2 · Log Rotation](../../audit-logging.md#log-rotation) +- [H2 · Implementation Priority](../../audit-logging.md#implementation-priority) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/cargo-slicer-speedup.md b/docs/i18n/fr/cargo-slicer-speedup.md new file mode 100644 index 000000000..019faad42 --- /dev/null +++ b/docs/i18n/fr/cargo-slicer-speedup.md @@ -0,0 +1,32 @@ +# Passerelle de localisation: Cargo Slicer Speedup + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../cargo-slicer-speedup.md](../../cargo-slicer-speedup.md) + +## Positionnement du sujet + +- Catégorie : Processus d'ingénierie +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Benchmark Results](../../cargo-slicer-speedup.md#benchmark-results) +- [H2 · CI Integration](../../cargo-slicer-speedup.md#ci-integration) +- [H2 · Local Usage](../../cargo-slicer-speedup.md#local-usage) +- [H2 · How It Works](../../cargo-slicer-speedup.md#how-it-works) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/channels-reference.md b/docs/i18n/fr/channels-reference.md new file mode 100644 index 000000000..c2168656c --- /dev/null +++ b/docs/i18n/fr/channels-reference.md @@ -0,0 +1,18 @@ +# Référence des canaux (Français) + +Cette page est une localisation initiale Wave 1 pour les capacités de canaux et les chemins de configuration. + +Source anglaise: + +- [../../channels-reference.md](../../channels-reference.md) + +## Quand l'utiliser + +- Comparer les capacités Telegram/Discord/Slack/etc. +- Vérifier les règles allowlist et frontières de sécurité +- Diagnostiquer les problèmes d'entrée/sortie messages + +## Règle + +- Les identifiants de canaux, API paths et config keys restent en anglais. +- La définition finale est la source anglaise. diff --git a/docs/i18n/fr/ci-map.md b/docs/i18n/fr/ci-map.md new file mode 100644 index 000000000..b9363eddf --- /dev/null +++ b/docs/i18n/fr/ci-map.md @@ -0,0 +1,36 @@ +# Passerelle de localisation: Ci Map + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../ci-map.md](../../ci-map.md) + +## Positionnement du sujet + +- Catégorie : Processus d'ingénierie +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Merge-Blocking vs Optional](../../ci-map.md#merge-blocking-vs-optional) +- [H3 · Merge-Blocking](../../ci-map.md#merge-blocking) +- [H3 · Non-Blocking but Important](../../ci-map.md#non-blocking-but-important) +- [H3 · Optional Repository Automation](../../ci-map.md#optional-repository-automation) +- [H2 · Trigger Map](../../ci-map.md#trigger-map) +- [H2 · Fast Triage Guide](../../ci-map.md#fast-triage-guide) +- [H2 · Maintenance Rules](../../ci-map.md#maintenance-rules) +- [H2 · Automation Side-Effect Controls](../../ci-map.md#automation-side-effect-controls) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/commands-reference.md b/docs/i18n/fr/commands-reference.md new file mode 100644 index 000000000..386b7fecd --- /dev/null +++ b/docs/i18n/fr/commands-reference.md @@ -0,0 +1,18 @@ +# Référence des commandes (Français) + +Cette page est une localisation initiale Wave 1 pour retrouver rapidement les commandes CLI ZeroClaw. + +Source anglaise: + +- [../../commands-reference.md](../../commands-reference.md) + +## Quand l'utiliser + +- Rechercher les commandes par workflow +- Vérifier les options et limites de comportement +- Comparer le résultat attendu pendant le debug + +## Règle + +- Les noms de commandes, flags et clés de config restent en anglais. +- La définition finale du comportement est la source anglaise. diff --git a/docs/i18n/fr/config-reference.md b/docs/i18n/fr/config-reference.md new file mode 100644 index 000000000..d5d59209e --- /dev/null +++ b/docs/i18n/fr/config-reference.md @@ -0,0 +1,18 @@ +# Référence de configuration (Français) + +Cette page est une localisation initiale Wave 1 pour les clés de configuration et les valeurs par défaut. + +Source anglaise: + +- [../../config-reference.md](../../config-reference.md) + +## Quand l'utiliser + +- Initialiser un nouvel environnement +- Vérifier les conflits de configuration +- Auditer les paramètres de sécurité/stabilité + +## Règle + +- Les noms de clés de configuration restent en anglais. +- Le comportement runtime exact est défini en anglais. diff --git a/docs/i18n/fr/custom-providers.md b/docs/i18n/fr/custom-providers.md new file mode 100644 index 000000000..e9d595aed --- /dev/null +++ b/docs/i18n/fr/custom-providers.md @@ -0,0 +1,46 @@ +# Passerelle de localisation: Custom Providers + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../custom-providers.md](../../custom-providers.md) + +## Positionnement du sujet + +- Catégorie : Providers et intégrations +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Provider Types](../../custom-providers.md#provider-types) +- [H3 · OpenAI-Compatible Endpoints (`custom:`)](../../custom-providers.md#openai-compatible-endpoints-custom) +- [H3 · Anthropic-Compatible Endpoints (`anthropic-custom:`)](../../custom-providers.md#anthropic-compatible-endpoints-anthropic-custom) +- [H2 · Configuration Methods](../../custom-providers.md#configuration-methods) +- [H3 · Config File](../../custom-providers.md#config-file) +- [H3 · Environment Variables](../../custom-providers.md#environment-variables) +- [H2 · llama.cpp Server (Recommended Local Setup)](../../custom-providers.md#llama-cpp-server-recommended-local-setup) +- [H2 · SGLang Server](../../custom-providers.md#sglang-server) +- [H2 · vLLM Server](../../custom-providers.md#vllm-server) +- [H2 · Testing Configuration](../../custom-providers.md#testing-configuration) +- [H2 · Troubleshooting](../../custom-providers.md#troubleshooting) +- [H3 · Authentication Errors](../../custom-providers.md#authentication-errors) +- [H3 · Model Not Found](../../custom-providers.md#model-not-found) +- [H3 · Connection Issues](../../custom-providers.md#connection-issues) +- [H2 · Examples](../../custom-providers.md#examples) +- [H3 · Local LLM Server (Generic Custom Endpoint)](../../custom-providers.md#local-llm-server-generic-custom-endpoint) +- [H3 · Corporate Proxy](../../custom-providers.md#corporate-proxy) +- [H3 · Cloud Provider Gateway](../../custom-providers.md#cloud-provider-gateway) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/doc-template.md b/docs/i18n/fr/doc-template.md new file mode 100644 index 000000000..82665a501 --- /dev/null +++ b/docs/i18n/fr/doc-template.md @@ -0,0 +1,38 @@ +# Passerelle de localisation: Doc Template + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../doc-template.md](../../doc-template.md) + +## Positionnement du sujet + +- Catégorie : Processus d'ingénierie +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · 1. Summary](../../doc-template.md#1-summary) +- [H2 · 2. Prerequisites](../../doc-template.md#2-prerequisites) +- [H2 · 3. Procedure](../../doc-template.md#3-procedure) +- [H3 · 3.1 Baseline Check](../../doc-template.md#3-1-baseline-check) +- [H3 · 3.2 Main Workflow](../../doc-template.md#3-2-main-workflow) +- [H3 · 3.3 Verification](../../doc-template.md#3-3-verification) +- [H2 · 4. Safety, Risk, and Rollback](../../doc-template.md#4-safety-risk-and-rollback) +- [H2 · 5. Troubleshooting](../../doc-template.md#5-troubleshooting) +- [H2 · 6. Related Docs](../../doc-template.md#6-related-docs) +- [H2 · 7. Maintenance Notes](../../doc-template.md#7-maintenance-notes) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/docs-audit-2026-02-24.md b/docs/i18n/fr/docs-audit-2026-02-24.md new file mode 100644 index 000000000..40e104074 --- /dev/null +++ b/docs/i18n/fr/docs-audit-2026-02-24.md @@ -0,0 +1,42 @@ +# Passerelle de localisation: Docs Audit 2026 02 24 + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../docs-audit-2026-02-24.md](../../docs-audit-2026-02-24.md) + +## Positionnement du sujet + +- Catégorie : Processus d'ingénierie +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · 1) Audit Method](../../docs-audit-2026-02-24.md#1-audit-method) +- [H2 · 2) Findings](../../docs-audit-2026-02-24.md#2-findings) +- [H3 · A. Structural clarity gaps](../../docs-audit-2026-02-24.md#a-structural-clarity-gaps) +- [H3 · B. Completeness gaps](../../docs-audit-2026-02-24.md#b-completeness-gaps) +- [H3 · C. Integrity issues](../../docs-audit-2026-02-24.md#c-integrity-issues) +- [H2 · 3) Remediation Applied](../../docs-audit-2026-02-24.md#3-remediation-applied) +- [H3 · 3.1 Navigation and governance](../../docs-audit-2026-02-24.md#3-1-navigation-and-governance) +- [H3 · 3.2 Directory completeness](../../docs-audit-2026-02-24.md#3-2-directory-completeness) +- [H3 · 3.3 Compatibility cleanup](../../docs-audit-2026-02-24.md#3-3-compatibility-cleanup) +- [H3 · 3.4 Broken link fixes](../../docs-audit-2026-02-24.md#3-4-broken-link-fixes) +- [H2 · 4) Current Known Remaining Gaps](../../docs-audit-2026-02-24.md#4-current-known-remaining-gaps) +- [H2 · 5) Recommended Next Wave](../../docs-audit-2026-02-24.md#5-recommended-next-wave) +- [H2 · 6) Validation Status](../../docs-audit-2026-02-24.md#6-validation-status) +- [H2 · Addendum (Phase-2 Deep Completion)](../../docs-audit-2026-02-24.md#addendum-phase-2-deep-completion) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/docs-inventory.md b/docs/i18n/fr/docs-inventory.md new file mode 100644 index 000000000..191ce283c --- /dev/null +++ b/docs/i18n/fr/docs-inventory.md @@ -0,0 +1,74 @@ +# Inventaire documentaire (Français) + +Cette page sert d'index rapide des documents top-level dans `docs/i18n/fr/`. + +Dernière mise à jour : **24 février 2026**. +État : **parité top-level terminée (40/40)**. + +## Sources normatives + +- Inventaire anglais : [../../docs-inventory.md](../../docs-inventory.md) +- Guide i18n : [i18n-guide.md](i18n-guide.md) +- Couverture i18n : [i18n-coverage.md](i18n-coverage.md) + +## Runtime et canaux + +- [commands-reference.md](commands-reference.md) +- [config-reference.md](config-reference.md) +- [providers-reference.md](providers-reference.md) +- [channels-reference.md](channels-reference.md) +- [operations-runbook.md](operations-runbook.md) +- [troubleshooting.md](troubleshooting.md) +- [one-click-bootstrap.md](one-click-bootstrap.md) +- [network-deployment.md](network-deployment.md) +- [mattermost-setup.md](mattermost-setup.md) +- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) +- [matrix-e2ee-guide.md](matrix-e2ee-guide.md) + +## Providers et intégrations + +- [custom-providers.md](custom-providers.md) +- [zai-glm-setup.md](zai-glm-setup.md) +- [langgraph-integration.md](langgraph-integration.md) +- [proxy-agent-playbook.md](proxy-agent-playbook.md) + +## Matériel et périphériques + +- [hardware-peripherals-design.md](hardware-peripherals-design.md) +- [adding-boards-and-tools.md](adding-boards-and-tools.md) +- [android-setup.md](android-setup.md) +- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) +- [nucleo-setup.md](nucleo-setup.md) + +## Sécurité et gouvernance + +- [agnostic-security.md](agnostic-security.md) +- [frictionless-security.md](frictionless-security.md) +- [audit-logging.md](audit-logging.md) +- [audit-event-schema.md](audit-event-schema.md) +- [sandboxing.md](sandboxing.md) +- [resource-limits.md](resource-limits.md) +- [security-roadmap.md](security-roadmap.md) +- [actions-source-policy.md](actions-source-policy.md) + +## Processus d'ingénierie + +- [pr-workflow.md](pr-workflow.md) +- [reviewer-playbook.md](reviewer-playbook.md) +- [ci-map.md](ci-map.md) +- [release-process.md](release-process.md) +- [cargo-slicer-speedup.md](cargo-slicer-speedup.md) +- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) +- [docs-audit-2026-02-24.md](docs-audit-2026-02-24.md) +- [doc-template.md](doc-template.md) + +## Gouvernance i18n + +- [i18n-guide.md](i18n-guide.md) +- [i18n-coverage.md](i18n-coverage.md) +- [i18n-gap-backlog.md](i18n-gap-backlog.md) + +## Règles de localisation + +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- La définition finale du comportement est la source anglaise. diff --git a/docs/i18n/fr/frictionless-security.md b/docs/i18n/fr/frictionless-security.md new file mode 100644 index 000000000..8e8c610c7 --- /dev/null +++ b/docs/i18n/fr/frictionless-security.md @@ -0,0 +1,43 @@ +# Passerelle de localisation: Frictionless Security + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../frictionless-security.md](../../frictionless-security.md) + +## Positionnement du sujet + +- Catégorie : Sécurité et gouvernance +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Core Principle](../../frictionless-security.md#core-principle) +- [H2 · Design: Silent Auto-Detection](../../frictionless-security.md#design-silent-auto-detection) +- [H3 · 1. No New Wizard Steps (Stays 9 Steps, < 60 Seconds)](../../frictionless-security.md#1-no-new-wizard-steps-stays-9-steps-60-seconds) +- [H3 · 2. Auto-Detection Logic (Runs Once at First Start)](../../frictionless-security.md#2-auto-detection-logic-runs-once-at-first-start) +- [H3 · 3. First Run: Silent Logging](../../frictionless-security.md#3-first-run-silent-logging) +- [H3 · 4. Config File: All Defaults Hidden](../../frictionless-security.md#4-config-file-all-defaults-hidden) +- [H3 · 5. Advanced Users: Explicit Control](../../frictionless-security.md#5-advanced-users-explicit-control) +- [H3 · 6. Graceful Degradation](../../frictionless-security.md#6-graceful-degradation) +- [H2 · Config Schema Extension](../../frictionless-security.md#config-schema-extension) +- [H2 · User Experience Comparison](../../frictionless-security.md#user-experience-comparison) +- [H3 · Before (Current)](../../frictionless-security.md#before-current) +- [H3 · After (With Frictionless Security)](../../frictionless-security.md#after-with-frictionless-security) +- [H3 · Advanced User (Explicit Control)](../../frictionless-security.md#advanced-user-explicit-control) +- [H2 · Backward Compatibility](../../frictionless-security.md#backward-compatibility) +- [H2 · Summary](../../frictionless-security.md#summary) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/hardware-peripherals-design.md b/docs/i18n/fr/hardware-peripherals-design.md new file mode 100644 index 000000000..12849fdfb --- /dev/null +++ b/docs/i18n/fr/hardware-peripherals-design.md @@ -0,0 +1,46 @@ +# Passerelle de localisation: Hardware Peripherals Design + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../hardware-peripherals-design.md](../../hardware-peripherals-design.md) + +## Positionnement du sujet + +- Catégorie : Matériel et périphériques +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · 1. Vision](../../hardware-peripherals-design.md#1-vision) +- [H2 · 2. Two Modes of Operation](../../hardware-peripherals-design.md#2-two-modes-of-operation) +- [H3 · Mode 1: Edge-Native (Standalone)](../../hardware-peripherals-design.md#mode-1-edge-native-standalone) +- [H3 · Mode 2: Host-Mediated (Development / Debugging)](../../hardware-peripherals-design.md#mode-2-host-mediated-development-debugging) +- [H3 · Mode Comparison](../../hardware-peripherals-design.md#mode-comparison) +- [H2 · 3. Legacy / Simpler Modes (Pre-LLM-on-Edge)](../../hardware-peripherals-design.md#3-legacy-simpler-modes-pre-llm-on-edge) +- [H3 · Mode A: Host + Remote Peripheral (STM32 via serial)](../../hardware-peripherals-design.md#mode-a-host-remote-peripheral-stm32-via-serial) +- [H3 · Mode B: RPi as Host (Native GPIO)](../../hardware-peripherals-design.md#mode-b-rpi-as-host-native-gpio) +- [H2 · 4. Technical Requirements](../../hardware-peripherals-design.md#4-technical-requirements) +- [H3 · RAG Pipeline (Datasheet Retrieval)](../../hardware-peripherals-design.md#rag-pipeline-datasheet-retrieval) +- [H3 · Dynamic Execution Options](../../hardware-peripherals-design.md#dynamic-execution-options) +- [H2 · 5. CLI and Config](../../hardware-peripherals-design.md#5-cli-and-config) +- [H3 · CLI Flags](../../hardware-peripherals-design.md#cli-flags) +- [H3 · Config (config.toml)](../../hardware-peripherals-design.md#config-config-toml) +- [H2 · 6. Architecture: Peripheral as Extension Point](../../hardware-peripherals-design.md#6-architecture-peripheral-as-extension-point) +- [H3 · New Trait: `Peripheral`](../../hardware-peripherals-design.md#new-trait-peripheral) +- [H3 · Flow](../../hardware-peripherals-design.md#flow) +- [H3 · Board Support](../../hardware-peripherals-design.md#board-support) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/i18n-coverage.md b/docs/i18n/fr/i18n-coverage.md new file mode 100644 index 000000000..788108442 --- /dev/null +++ b/docs/i18n/fr/i18n-coverage.md @@ -0,0 +1,36 @@ +# Passerelle de localisation: I18n Coverage + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../i18n-coverage.md](../../i18n-coverage.md) + +## Positionnement du sujet + +- Catégorie : Gouvernance i18n +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Canonical Layout](../../i18n-coverage.md#canonical-layout) +- [H2 · Locale Coverage Matrix](../../i18n-coverage.md#locale-coverage-matrix) +- [H2 · Top-Level Parity Snapshot](../../i18n-coverage.md#top-level-parity-snapshot) +- [H2 · Root README Completeness](../../i18n-coverage.md#root-readme-completeness) +- [H2 · Collection Index i18n](../../i18n-coverage.md#collection-index-i18n) +- [H2 · Localization Rules](../../i18n-coverage.md#localization-rules) +- [H2 · Adding a New Locale](../../i18n-coverage.md#adding-a-new-locale) +- [H2 · Review Checklist](../../i18n-coverage.md#review-checklist) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/i18n-gap-backlog.md b/docs/i18n/fr/i18n-gap-backlog.md new file mode 100644 index 000000000..81991368f --- /dev/null +++ b/docs/i18n/fr/i18n-gap-backlog.md @@ -0,0 +1,34 @@ +# Passerelle de localisation: I18n Gap Backlog + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../i18n-gap-backlog.md](../../i18n-gap-backlog.md) + +## Positionnement du sujet + +- Catégorie : Gouvernance i18n +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Baseline Definition](../../i18n-gap-backlog.md#baseline-definition) +- [H2 · Current Gap Counts](../../i18n-gap-backlog.md#current-gap-counts) +- [H2 · Closure Record (2026-02-24)](../../i18n-gap-backlog.md#closure-record-2026-02-24) +- [H2 · Remaining Gaps (Baseline Scope)](../../i18n-gap-backlog.md#remaining-gaps-baseline-scope) +- [H2 · Optional Next Depth](../../i18n-gap-backlog.md#optional-next-depth) +- [H2 · Tracking Rules](../../i18n-gap-backlog.md#tracking-rules) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/i18n-guide.md b/docs/i18n/fr/i18n-guide.md new file mode 100644 index 000000000..8860fdf42 --- /dev/null +++ b/docs/i18n/fr/i18n-guide.md @@ -0,0 +1,36 @@ +# Passerelle de localisation: I18n Guide + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../i18n-guide.md](../../i18n-guide.md) + +## Positionnement du sujet + +- Catégorie : Gouvernance i18n +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Scope](../../i18n-guide.md#scope) +- [H2 · Canonical Layout](../../i18n-guide.md#canonical-layout) +- [H2 · Trigger Matrix](../../i18n-guide.md#trigger-matrix) +- [H2 · Completion Checklist (Mandatory)](../../i18n-guide.md#completion-checklist-mandatory) +- [H2 · Deferred Translation Policy](../../i18n-guide.md#deferred-translation-policy) +- [H2 · Agent Workflow Contract](../../i18n-guide.md#agent-workflow-contract) +- [H2 · Gap Tracking](../../i18n-guide.md#gap-tracking) +- [H2 · Quick Validation Commands](../../i18n-guide.md#quick-validation-commands) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/langgraph-integration.md b/docs/i18n/fr/langgraph-integration.md new file mode 100644 index 000000000..0fe7088cc --- /dev/null +++ b/docs/i18n/fr/langgraph-integration.md @@ -0,0 +1,46 @@ +# Passerelle de localisation: Langgraph Integration + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../langgraph-integration.md](../../langgraph-integration.md) + +## Positionnement du sujet + +- Catégorie : Providers et intégrations +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Background](../../langgraph-integration.md#background) +- [H2 · Architecture](../../langgraph-integration.md#architecture) +- [H2 · Quick Start](../../langgraph-integration.md#quick-start) +- [H3 · Installation](../../langgraph-integration.md#installation) +- [H3 · Basic Usage](../../langgraph-integration.md#basic-usage) +- [H2 · Available Tools](../../langgraph-integration.md#available-tools) +- [H3 · Core Tools](../../langgraph-integration.md#core-tools) +- [H3 · Extended Tools](../../langgraph-integration.md#extended-tools) +- [H2 · Custom Tools](../../langgraph-integration.md#custom-tools) +- [H2 · Provider Configuration](../../langgraph-integration.md#provider-configuration) +- [H3 · Z.AI / GLM-5](../../langgraph-integration.md#z-ai-glm-5) +- [H3 · OpenRouter](../../langgraph-integration.md#openrouter) +- [H3 · Groq](../../langgraph-integration.md#groq) +- [H3 · Ollama (Local)](../../langgraph-integration.md#ollama-local) +- [H2 · Discord Bot Integration](../../langgraph-integration.md#discord-bot-integration) +- [H2 · CLI Usage](../../langgraph-integration.md#cli-usage) +- [H2 · Comparison with Rust ZeroClaw](../../langgraph-integration.md#comparison-with-rust-zeroclaw) +- [H2 · Troubleshooting](../../langgraph-integration.md#troubleshooting) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/matrix-e2ee-guide.md b/docs/i18n/fr/matrix-e2ee-guide.md new file mode 100644 index 000000000..abdbe83d4 --- /dev/null +++ b/docs/i18n/fr/matrix-e2ee-guide.md @@ -0,0 +1,42 @@ +# Passerelle de localisation: Matrix E2ee Guide + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../matrix-e2ee-guide.md](../../matrix-e2ee-guide.md) + +## Positionnement du sujet + +- Catégorie : Runtime et canaux +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · 0. Fast FAQ (#499-class symptom)](../../matrix-e2ee-guide.md#0-fast-faq-499-class-symptom) +- [H2 · 1. Requirements](../../matrix-e2ee-guide.md#1-requirements) +- [H2 · 2. Configuration](../../matrix-e2ee-guide.md#2-configuration) +- [H3 · About `user_id` and `device_id`](../../matrix-e2ee-guide.md#about-user-id-and-device-id) +- [H2 · 3. Quick Validation Flow](../../matrix-e2ee-guide.md#3-quick-validation-flow) +- [H2 · 4. Troubleshooting “No Response”](../../matrix-e2ee-guide.md#4-troubleshooting-no-response) +- [H3 · A. Room and membership](../../matrix-e2ee-guide.md#a-room-and-membership) +- [H3 · B. Sender allowlist](../../matrix-e2ee-guide.md#b-sender-allowlist) +- [H3 · C. Token and identity](../../matrix-e2ee-guide.md#c-token-and-identity) +- [H3 · D. E2EE-specific checks](../../matrix-e2ee-guide.md#d-e2ee-specific-checks) +- [H3 · E. Message formatting (Markdown)](../../matrix-e2ee-guide.md#e-message-formatting-markdown) +- [H3 · F. Fresh start test](../../matrix-e2ee-guide.md#f-fresh-start-test) +- [H2 · 5. Operational Notes](../../matrix-e2ee-guide.md#5-operational-notes) +- [H2 · 6. Related Docs](../../matrix-e2ee-guide.md#6-related-docs) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/mattermost-setup.md b/docs/i18n/fr/mattermost-setup.md new file mode 100644 index 000000000..58b95a0a3 --- /dev/null +++ b/docs/i18n/fr/mattermost-setup.md @@ -0,0 +1,34 @@ +# Passerelle de localisation: Mattermost Setup + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../mattermost-setup.md](../../mattermost-setup.md) + +## Positionnement du sujet + +- Catégorie : Runtime et canaux +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Prerequisites](../../mattermost-setup.md#prerequisites) +- [H2 · Configuration](../../mattermost-setup.md#configuration) +- [H3 · Configuration Fields](../../mattermost-setup.md#configuration-fields) +- [H2 · Threaded Conversations](../../mattermost-setup.md#threaded-conversations) +- [H2 · Mention-Only Mode](../../mattermost-setup.md#mention-only-mode) +- [H2 · Security Note](../../mattermost-setup.md#security-note) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/network-deployment.md b/docs/i18n/fr/network-deployment.md new file mode 100644 index 000000000..149067b82 --- /dev/null +++ b/docs/i18n/fr/network-deployment.md @@ -0,0 +1,46 @@ +# Passerelle de localisation: Network Deployment + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../network-deployment.md](../../network-deployment.md) + +## Positionnement du sujet + +- Catégorie : Runtime et canaux +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · 1. Overview](../../network-deployment.md#1-overview) +- [H2 · 2. ZeroClaw on Raspberry Pi](../../network-deployment.md#2-zeroclaw-on-raspberry-pi) +- [H3 · 2.1 Prerequisites](../../network-deployment.md#2-1-prerequisites) +- [H3 · 2.2 Install](../../network-deployment.md#2-2-install) +- [H3 · 2.3 Config](../../network-deployment.md#2-3-config) +- [H3 · 2.4 Run Daemon (Local Only)](../../network-deployment.md#2-4-run-daemon-local-only) +- [H2 · 3. Binding to 0.0.0.0 (Local Network)](../../network-deployment.md#3-binding-to-0-0-0-0-local-network) +- [H3 · 3.1 Option A: Explicit Opt-In](../../network-deployment.md#3-1-option-a-explicit-opt-in) +- [H3 · 3.2 Option B: Tunnel (Recommended for Webhooks)](../../network-deployment.md#3-2-option-b-tunnel-recommended-for-webhooks) +- [H2 · 4. Telegram Polling (No Inbound Port)](../../network-deployment.md#4-telegram-polling-no-inbound-port) +- [H3 · 4.1 Single Poller Rule (Important)](../../network-deployment.md#4-1-single-poller-rule-important) +- [H2 · 5. Webhook Channels (WhatsApp, Nextcloud Talk, Custom)](../../network-deployment.md#5-webhook-channels-whatsapp-nextcloud-talk-custom) +- [H3 · 5.1 Tailscale Funnel](../../network-deployment.md#5-1-tailscale-funnel) +- [H3 · 5.2 ngrok](../../network-deployment.md#5-2-ngrok) +- [H3 · 5.3 Cloudflare Tunnel](../../network-deployment.md#5-3-cloudflare-tunnel) +- [H2 · 6. Checklist: RPi Deployment](../../network-deployment.md#6-checklist-rpi-deployment) +- [H2 · 7. OpenRC (Alpine Linux Service)](../../network-deployment.md#7-openrc-alpine-linux-service) +- [H3 · 7.1 Prerequisites](../../network-deployment.md#7-1-prerequisites) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/nextcloud-talk-setup.md b/docs/i18n/fr/nextcloud-talk-setup.md new file mode 100644 index 000000000..d0dc7de0a --- /dev/null +++ b/docs/i18n/fr/nextcloud-talk-setup.md @@ -0,0 +1,35 @@ +# Passerelle de localisation: Nextcloud Talk Setup + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../nextcloud-talk-setup.md](../../nextcloud-talk-setup.md) + +## Positionnement du sujet + +- Catégorie : Runtime et canaux +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · 1. What this integration does](../../nextcloud-talk-setup.md#1-what-this-integration-does) +- [H2 · 2. Configuration](../../nextcloud-talk-setup.md#2-configuration) +- [H2 · 3. Gateway endpoint](../../nextcloud-talk-setup.md#3-gateway-endpoint) +- [H2 · 4. Signature verification contract](../../nextcloud-talk-setup.md#4-signature-verification-contract) +- [H2 · 5. Message routing behavior](../../nextcloud-talk-setup.md#5-message-routing-behavior) +- [H2 · 6. Quick validation checklist](../../nextcloud-talk-setup.md#6-quick-validation-checklist) +- [H2 · 7. Troubleshooting](../../nextcloud-talk-setup.md#7-troubleshooting) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/nucleo-setup.md b/docs/i18n/fr/nucleo-setup.md new file mode 100644 index 000000000..43d4850ae --- /dev/null +++ b/docs/i18n/fr/nucleo-setup.md @@ -0,0 +1,40 @@ +# Passerelle de localisation: Nucleo Setup + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../nucleo-setup.md](../../nucleo-setup.md) + +## Positionnement du sujet + +- Catégorie : Matériel et périphériques +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Get Board Info via Telegram (No Firmware Needed)](../../nucleo-setup.md#get-board-info-via-telegram-no-firmware-needed) +- [H2 · What's Included (No Code Changes Needed)](../../nucleo-setup.md#what-s-included-no-code-changes-needed) +- [H2 · Prerequisites](../../nucleo-setup.md#prerequisites) +- [H2 · Phase 1: Flash Firmware](../../nucleo-setup.md#phase-1-flash-firmware) +- [H3 · 1.1 Connect Nucleo](../../nucleo-setup.md#1-1-connect-nucleo) +- [H3 · 1.2 Flash via ZeroClaw](../../nucleo-setup.md#1-2-flash-via-zeroclaw) +- [H3 · 1.3 Manual Flash (Alternative)](../../nucleo-setup.md#1-3-manual-flash-alternative) +- [H2 · Phase 2: Find Serial Port](../../nucleo-setup.md#phase-2-find-serial-port) +- [H2 · Phase 3: Configure ZeroClaw](../../nucleo-setup.md#phase-3-configure-zeroclaw) +- [H2 · Phase 4: Run and Test](../../nucleo-setup.md#phase-4-run-and-test) +- [H2 · Summary: Commands](../../nucleo-setup.md#summary-commands) +- [H2 · Troubleshooting](../../nucleo-setup.md#troubleshooting) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/one-click-bootstrap.md b/docs/i18n/fr/one-click-bootstrap.md new file mode 100644 index 000000000..6852dcdec --- /dev/null +++ b/docs/i18n/fr/one-click-bootstrap.md @@ -0,0 +1,39 @@ +# Passerelle de localisation: One Click Bootstrap + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../one-click-bootstrap.md](../../one-click-bootstrap.md) + +## Positionnement du sujet + +- Catégorie : Runtime et canaux +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Option 0: Homebrew (macOS/Linuxbrew)](../../one-click-bootstrap.md#option-0-homebrew-macos-linuxbrew) +- [H2 · Option A (Recommended): Clone + local script](../../one-click-bootstrap.md#option-a-recommended-clone-local-script) +- [H3 · Resource preflight and pre-built flow](../../one-click-bootstrap.md#resource-preflight-and-pre-built-flow) +- [H2 · Dual-mode bootstrap](../../one-click-bootstrap.md#dual-mode-bootstrap) +- [H2 · Option B: Remote one-liner](../../one-click-bootstrap.md#option-b-remote-one-liner) +- [H2 · Optional onboarding modes](../../one-click-bootstrap.md#optional-onboarding-modes) +- [H3 · Containerized onboarding (Docker)](../../one-click-bootstrap.md#containerized-onboarding-docker) +- [H3 · Quick onboarding (non-interactive)](../../one-click-bootstrap.md#quick-onboarding-non-interactive) +- [H3 · Interactive onboarding](../../one-click-bootstrap.md#interactive-onboarding) +- [H2 · Useful flags](../../one-click-bootstrap.md#useful-flags) +- [H2 · Related docs](../../one-click-bootstrap.md#related-docs) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/operations-runbook.md b/docs/i18n/fr/operations-runbook.md new file mode 100644 index 000000000..3458e7c2e --- /dev/null +++ b/docs/i18n/fr/operations-runbook.md @@ -0,0 +1,18 @@ +# Runbook d'exploitation (Français) + +Cette page est une localisation initiale Wave 1 pour les procédures day-2. + +Source anglaise: + +- [../../operations-runbook.md](../../operations-runbook.md) + +## Quand l'utiliser + +- Vérifications de santé avant/après changement +- Redémarrage des services et rollback +- Réponse standard aux incidents opérationnels + +## Règle + +- Les commandes et clés système restent en anglais. +- Les exigences d'exploitation finales sont définies en anglais. diff --git a/docs/i18n/fr/pr-workflow.md b/docs/i18n/fr/pr-workflow.md new file mode 100644 index 000000000..a2542f8ed --- /dev/null +++ b/docs/i18n/fr/pr-workflow.md @@ -0,0 +1,46 @@ +# Passerelle de localisation: Pr Workflow + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../pr-workflow.md](../../pr-workflow.md) + +## Positionnement du sujet + +- Catégorie : Processus d'ingénierie +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · 0. Summary](../../pr-workflow.md#0-summary) +- [H2 · 1. Fast Path by PR Situation](../../pr-workflow.md#1-fast-path-by-pr-situation) +- [H3 · 1.1 Intake is incomplete](../../pr-workflow.md#1-1-intake-is-incomplete) +- [H3 · 1.2 `CI Required Gate` failing](../../pr-workflow.md#1-2-ci-required-gate-failing) +- [H3 · 1.3 High-risk path touched](../../pr-workflow.md#1-3-high-risk-path-touched) +- [H3 · 1.4 PR is superseded or duplicate](../../pr-workflow.md#1-4-pr-is-superseded-or-duplicate) +- [H2 · 2. Governance Goals and Control Loop](../../pr-workflow.md#2-governance-goals-and-control-loop) +- [H3 · 2.1 Governance goals](../../pr-workflow.md#2-1-governance-goals) +- [H3 · 2.2 Governance design logic (control loop)](../../pr-workflow.md#2-2-governance-design-logic-control-loop) +- [H2 · 3. Required Repository Settings](../../pr-workflow.md#3-required-repository-settings) +- [H2 · 4. PR Lifecycle Runbook](../../pr-workflow.md#4-pr-lifecycle-runbook) +- [H3 · 4.1 Step A: Intake](../../pr-workflow.md#4-1-step-a-intake) +- [H3 · 4.2 Step B: Validation](../../pr-workflow.md#4-2-step-b-validation) +- [H3 · 4.3 Step C: Review](../../pr-workflow.md#4-3-step-c-review) +- [H3 · 4.4 Step D: Merge](../../pr-workflow.md#4-4-step-d-merge) +- [H2 · 5. PR Readiness Contracts (DoR / DoD)](../../pr-workflow.md#5-pr-readiness-contracts-dor-dod) +- [H3 · 5.1 Definition of Ready (DoR) before requesting review](../../pr-workflow.md#5-1-definition-of-ready-dor-before-requesting-review) +- [H3 · 5.2 Definition of Done (DoD) merge-ready](../../pr-workflow.md#5-2-definition-of-done-dod-merge-ready) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/project-triage-snapshot-2026-02-18.md b/docs/i18n/fr/project-triage-snapshot-2026-02-18.md new file mode 100644 index 000000000..33d023fda --- /dev/null +++ b/docs/i18n/fr/project-triage-snapshot-2026-02-18.md @@ -0,0 +1,36 @@ +# Passerelle de localisation: Project Triage Snapshot 2026 02 18 + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../project-triage-snapshot-2026-02-18.md](../../project-triage-snapshot-2026-02-18.md) + +## Positionnement du sujet + +- Catégorie : Processus d'ingénierie +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Data Source](../../project-triage-snapshot-2026-02-18.md#data-source) +- [H2 · Repository Pulse](../../project-triage-snapshot-2026-02-18.md#repository-pulse) +- [H2 · PR Label Pressure (Open PRs)](../../project-triage-snapshot-2026-02-18.md#pr-label-pressure-open-prs) +- [H2 · Issue Label Pressure (Open Issues)](../../project-triage-snapshot-2026-02-18.md#issue-label-pressure-open-issues) +- [H2 · Docs-Relevant Open PRs](../../project-triage-snapshot-2026-02-18.md#docs-relevant-open-prs) +- [H2 · Docs-Relevant Open Issues](../../project-triage-snapshot-2026-02-18.md#docs-relevant-open-issues) +- [H2 · Recommended Docs Backlog (Priority Order)](../../project-triage-snapshot-2026-02-18.md#recommended-docs-backlog-priority-order) +- [H2 · Snapshot Caveat](../../project-triage-snapshot-2026-02-18.md#snapshot-caveat) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/providers-reference.md b/docs/i18n/fr/providers-reference.md new file mode 100644 index 000000000..ba5c694c2 --- /dev/null +++ b/docs/i18n/fr/providers-reference.md @@ -0,0 +1,18 @@ +# Référence des providers (Français) + +Cette page est une localisation initiale Wave 1 pour vérifier les IDs provider, alias et variables d'authentification. + +Source anglaise: + +- [../../providers-reference.md](../../providers-reference.md) + +## Quand l'utiliser + +- Choisir un provider et un modèle +- Vérifier ID/alias/env vars de credentials +- Diagnostiquer les erreurs de configuration/auth + +## Règle + +- Les IDs provider et noms d'env vars restent en anglais. +- La source normative de comportement est l'anglais. diff --git a/docs/i18n/fr/proxy-agent-playbook.md b/docs/i18n/fr/proxy-agent-playbook.md new file mode 100644 index 000000000..4197a2f07 --- /dev/null +++ b/docs/i18n/fr/proxy-agent-playbook.md @@ -0,0 +1,46 @@ +# Passerelle de localisation: Proxy Agent Playbook + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../proxy-agent-playbook.md](../../proxy-agent-playbook.md) + +## Positionnement du sujet + +- Catégorie : Providers et intégrations +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · 0. Summary](../../proxy-agent-playbook.md#0-summary) +- [H2 · 1. Fast Path by Intent](../../proxy-agent-playbook.md#1-fast-path-by-intent) +- [H3 · 1.1 Proxy only ZeroClaw internal traffic](../../proxy-agent-playbook.md#1-1-proxy-only-zeroclaw-internal-traffic) +- [H3 · 1.2 Proxy only selected services](../../proxy-agent-playbook.md#1-2-proxy-only-selected-services) +- [H3 · 1.3 Export process-wide proxy environment variables](../../proxy-agent-playbook.md#1-3-export-process-wide-proxy-environment-variables) +- [H3 · 1.4 Emergency rollback](../../proxy-agent-playbook.md#1-4-emergency-rollback) +- [H2 · 2. Scope Decision Matrix](../../proxy-agent-playbook.md#2-scope-decision-matrix) +- [H2 · 3. Standard Safe Workflow](../../proxy-agent-playbook.md#3-standard-safe-workflow) +- [H2 · 4. Mode A — Proxy Only for ZeroClaw Internals](../../proxy-agent-playbook.md#4-mode-a-proxy-only-for-zeroclaw-internals) +- [H2 · 5. Mode B — Proxy Only for Specific Services](../../proxy-agent-playbook.md#5-mode-b-proxy-only-for-specific-services) +- [H3 · 5.1 Target specific services](../../proxy-agent-playbook.md#5-1-target-specific-services) +- [H3 · 5.2 Target by selectors](../../proxy-agent-playbook.md#5-2-target-by-selectors) +- [H2 · 6. Mode C — Proxy for Full Process Environment](../../proxy-agent-playbook.md#6-mode-c-proxy-for-full-process-environment) +- [H3 · 6.1 Configure and apply environment scope](../../proxy-agent-playbook.md#6-1-configure-and-apply-environment-scope) +- [H2 · 7. Disable / Rollback Patterns](../../proxy-agent-playbook.md#7-disable-rollback-patterns) +- [H3 · 7.1 Disable proxy (default safe behavior)](../../proxy-agent-playbook.md#7-1-disable-proxy-default-safe-behavior) +- [H3 · 7.2 Disable proxy and force-clear env vars](../../proxy-agent-playbook.md#7-2-disable-proxy-and-force-clear-env-vars) +- [H3 · 7.3 Keep proxy enabled but clear environment exports only](../../proxy-agent-playbook.md#7-3-keep-proxy-enabled-but-clear-environment-exports-only) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/release-process.md b/docs/i18n/fr/release-process.md new file mode 100644 index 000000000..631988076 --- /dev/null +++ b/docs/i18n/fr/release-process.md @@ -0,0 +1,40 @@ +# Passerelle de localisation: Release Process + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../release-process.md](../../release-process.md) + +## Positionnement du sujet + +- Catégorie : Processus d'ingénierie +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Release Goals](../../release-process.md#release-goals) +- [H2 · Standard Cadence](../../release-process.md#standard-cadence) +- [H2 · Workflow Contract](../../release-process.md#workflow-contract) +- [H2 · Maintainer Procedure](../../release-process.md#maintainer-procedure) +- [H3 · 1) Preflight on `main`](../../release-process.md#1-preflight-on-main) +- [H3 · 2) Run verification build (no publish)](../../release-process.md#2-run-verification-build-no-publish) +- [H3 · 3) Cut release tag](../../release-process.md#3-cut-release-tag) +- [H3 · 4) Monitor publish run](../../release-process.md#4-monitor-publish-run) +- [H3 · 5) Post-release validation](../../release-process.md#5-post-release-validation) +- [H3 · 6) Publish Homebrew Core formula (bot-owned)](../../release-process.md#6-publish-homebrew-core-formula-bot-owned) +- [H2 · Emergency / Recovery Path](../../release-process.md#emergency-recovery-path) +- [H2 · Operational Notes](../../release-process.md#operational-notes) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/resource-limits.md b/docs/i18n/fr/resource-limits.md new file mode 100644 index 000000000..cb5dca911 --- /dev/null +++ b/docs/i18n/fr/resource-limits.md @@ -0,0 +1,35 @@ +# Passerelle de localisation: Resource Limits + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../resource-limits.md](../../resource-limits.md) + +## Positionnement du sujet + +- Catégorie : Sécurité et gouvernance +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Problem](../../resource-limits.md#problem) +- [H2 · Proposed Solutions](../../resource-limits.md#proposed-solutions) +- [H3 · Option 1: cgroups v2 (Linux, Recommended)](../../resource-limits.md#option-1-cgroups-v2-linux-recommended) +- [H3 · Option 2: tokio::task::deadlock detection](../../resource-limits.md#option-2-tokio-task-deadlock-detection) +- [H3 · Option 3: Memory monitoring](../../resource-limits.md#option-3-memory-monitoring) +- [H2 · Config Schema](../../resource-limits.md#config-schema) +- [H2 · Implementation Priority](../../resource-limits.md#implementation-priority) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/reviewer-playbook.md b/docs/i18n/fr/reviewer-playbook.md new file mode 100644 index 000000000..fc6b99458 --- /dev/null +++ b/docs/i18n/fr/reviewer-playbook.md @@ -0,0 +1,46 @@ +# Passerelle de localisation: Reviewer Playbook + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../reviewer-playbook.md](../../reviewer-playbook.md) + +## Positionnement du sujet + +- Catégorie : Processus d'ingénierie +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · 0. Summary](../../reviewer-playbook.md#0-summary) +- [H2 · 1. Fast Path by Review Situation](../../reviewer-playbook.md#1-fast-path-by-review-situation) +- [H3 · 1.1 Intake fails in first 5 minutes](../../reviewer-playbook.md#1-1-intake-fails-in-first-5-minutes) +- [H3 · 1.2 Risk is high or unclear](../../reviewer-playbook.md#1-2-risk-is-high-or-unclear) +- [H3 · 1.3 Automation output is wrong/noisy](../../reviewer-playbook.md#1-3-automation-output-is-wrong-noisy) +- [H3 · 1.4 Need review handoff](../../reviewer-playbook.md#1-4-need-review-handoff) +- [H2 · 2. Review Depth Decision Matrix](../../reviewer-playbook.md#2-review-depth-decision-matrix) +- [H2 · 3. Standard Review Workflow](../../reviewer-playbook.md#3-standard-review-workflow) +- [H3 · 3.1 Five-minute intake triage](../../reviewer-playbook.md#3-1-five-minute-intake-triage) +- [H3 · 3.2 Fast-lane checklist (all PRs)](../../reviewer-playbook.md#3-2-fast-lane-checklist-all-prs) +- [H3 · 3.3 Deep review checklist (high risk)](../../reviewer-playbook.md#3-3-deep-review-checklist-high-risk) +- [H3 · 3.4 Review comment outcome style](../../reviewer-playbook.md#3-4-review-comment-outcome-style) +- [H2 · 4. Issue Triage and Backlog Governance](../../reviewer-playbook.md#4-issue-triage-and-backlog-governance) +- [H3 · 4.1 Issue triage label playbook](../../reviewer-playbook.md#4-1-issue-triage-label-playbook) +- [H3 · 4.2 PR backlog pruning protocol](../../reviewer-playbook.md#4-2-pr-backlog-pruning-protocol) +- [H2 · 5. Automation Override Protocol](../../reviewer-playbook.md#5-automation-override-protocol) +- [H2 · 6. Handoff Protocol](../../reviewer-playbook.md#6-handoff-protocol) +- [H2 · 7. Weekly Queue Hygiene](../../reviewer-playbook.md#7-weekly-queue-hygiene) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/sandboxing.md b/docs/i18n/fr/sandboxing.md new file mode 100644 index 000000000..c034fcea4 --- /dev/null +++ b/docs/i18n/fr/sandboxing.md @@ -0,0 +1,37 @@ +# Passerelle de localisation: Sandboxing + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../sandboxing.md](../../sandboxing.md) + +## Positionnement du sujet + +- Catégorie : Sécurité et gouvernance +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Problem](../../sandboxing.md#problem) +- [H2 · Proposed Solutions](../../sandboxing.md#proposed-solutions) +- [H3 · Option 1: Firejail Integration (Recommended for Linux)](../../sandboxing.md#option-1-firejail-integration-recommended-for-linux) +- [H3 · Option 2: Bubblewrap (Portable, no root required)](../../sandboxing.md#option-2-bubblewrap-portable-no-root-required) +- [H3 · Option 3: Docker-in-Docker (Heavyweight but complete isolation)](../../sandboxing.md#option-3-docker-in-docker-heavyweight-but-complete-isolation) +- [H3 · Option 4: Landlock (Linux Kernel LSM, Rust native)](../../sandboxing.md#option-4-landlock-linux-kernel-lsm-rust-native) +- [H2 · Priority Implementation Order](../../sandboxing.md#priority-implementation-order) +- [H2 · Config Schema Extension](../../sandboxing.md#config-schema-extension) +- [H2 · Testing Strategy](../../sandboxing.md#testing-strategy) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/security-roadmap.md b/docs/i18n/fr/security-roadmap.md new file mode 100644 index 000000000..1e9d0e61c --- /dev/null +++ b/docs/i18n/fr/security-roadmap.md @@ -0,0 +1,38 @@ +# Passerelle de localisation: Security Roadmap + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../security-roadmap.md](../../security-roadmap.md) + +## Positionnement du sujet + +- Catégorie : Sécurité et gouvernance +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Current State: Strong Foundation](../../security-roadmap.md#current-state-strong-foundation) +- [H2 · What's Missing: OS-Level Containment](../../security-roadmap.md#what-s-missing-os-level-containment) +- [H2 · Comparison: ZeroClaw vs PicoClaw vs Production Grade](../../security-roadmap.md#comparison-zeroclaw-vs-picoclaw-vs-production-grade) +- [H2 · Implementation Roadmap](../../security-roadmap.md#implementation-roadmap) +- [H3 · Phase 1: Quick Wins (1-2 weeks)](../../security-roadmap.md#phase-1-quick-wins-1-2-weeks) +- [H3 · Phase 2: Platform Integration (2-3 weeks)](../../security-roadmap.md#phase-2-platform-integration-2-3-weeks) +- [H3 · Phase 3: Production Hardening (1-2 weeks)](../../security-roadmap.md#phase-3-production-hardening-1-2-weeks) +- [H2 · New Config Schema Preview](../../security-roadmap.md#new-config-schema-preview) +- [H2 · CLI Commands Preview](../../security-roadmap.md#cli-commands-preview) +- [H2 · Summary](../../security-roadmap.md#summary) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/fr/troubleshooting.md b/docs/i18n/fr/troubleshooting.md new file mode 100644 index 000000000..b0ebed0b9 --- /dev/null +++ b/docs/i18n/fr/troubleshooting.md @@ -0,0 +1,18 @@ +# Dépannage (Français) + +Cette page est une localisation initiale Wave 1 pour diagnostiquer rapidement les pannes courantes. + +Source anglaise: + +- [../../troubleshooting.md](../../troubleshooting.md) + +## Quand l'utiliser + +- Échecs d'installation ou de démarrage +- Diagnostic guidé via `status` et `doctor` +- Procédures minimales de récupération/rollback + +## Règle + +- Les codes d'erreur, clés de logs et commandes restent en anglais. +- Les signatures de panne détaillées sont définies en anglais. diff --git a/docs/i18n/fr/zai-glm-setup.md b/docs/i18n/fr/zai-glm-setup.md new file mode 100644 index 000000000..d5ec82df8 --- /dev/null +++ b/docs/i18n/fr/zai-glm-setup.md @@ -0,0 +1,43 @@ +# Passerelle de localisation: Zai Glm Setup + +Cette page est une passerelle enrichie. Elle fournit le positionnement du sujet, un guidage par sections source et des conseils d'exécution. + +Source anglaise: + +- [../../zai-glm-setup.md](../../zai-glm-setup.md) + +## Positionnement du sujet + +- Catégorie : Providers et intégrations +- Profondeur : passerelle enrichie (guidage de sections + conseils d'exécution) +- Usage : comprendre la structure puis appliquer les étapes selon la source normative anglaise. + +## Plan des sections source + +- [H2 · Overview](../../zai-glm-setup.md#overview) +- [H2 · Setup](../../zai-glm-setup.md#setup) +- [H3 · Quick Start](../../zai-glm-setup.md#quick-start) +- [H3 · Manual Configuration](../../zai-glm-setup.md#manual-configuration) +- [H2 · Available Models](../../zai-glm-setup.md#available-models) +- [H2 · Verify Setup](../../zai-glm-setup.md#verify-setup) +- [H3 · Test with curl](../../zai-glm-setup.md#test-with-curl) +- [H3 · Test with ZeroClaw CLI](../../zai-glm-setup.md#test-with-zeroclaw-cli) +- [H2 · Environment Variables](../../zai-glm-setup.md#environment-variables) +- [H2 · Troubleshooting](../../zai-glm-setup.md#troubleshooting) +- [H3 · Rate Limiting](../../zai-glm-setup.md#rate-limiting) +- [H3 · Authentication Errors](../../zai-glm-setup.md#authentication-errors) +- [H3 · Model Not Found](../../zai-glm-setup.md#model-not-found) +- [H2 · Getting an API Key](../../zai-glm-setup.md#getting-an-api-key) +- [H2 · Related Documentation](../../zai-glm-setup.md#related-documentation) + +## Conseils d'exécution + +- Commencer par la structure des sections source, puis cibler les parties directement liées au changement en cours. +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- En cas d'ambiguïté d'interprétation, la source anglaise fait foi. + +## Entrées liées + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/README.md b/docs/i18n/ja/README.md new file mode 100644 index 000000000..cc689cf78 --- /dev/null +++ b/docs/i18n/ja/README.md @@ -0,0 +1,51 @@ +# ZeroClaw ドキュメントハブ(日本語) + +このファイルは `docs/i18n//` 構造における日本語ハブです。 + +最終同期日: **2026-02-24**。 + +> 注: コマンド名・設定キー・API パスは英語のまま記載します。 + +## クイックリンク + +- 日本語ルート README: [../../../README.ja.md](../../../README.ja.md) +- 日本語ドキュメント入口(互換): [../../README.ja.md](../../README.ja.md) +- 日本語目次(互換): [../../SUMMARY.ja.md](../../SUMMARY.ja.md) +- 英語ドキュメント入口: [../../README.md](../../README.md) + +## Wave 1 ローカライズ済みランタイム文書 + +- コマンドリファレンス: [commands-reference.md](commands-reference.md) +- Provider リファレンス: [providers-reference.md](providers-reference.md) +- チャネルリファレンス: [channels-reference.md](channels-reference.md) +- 設定リファレンス: [config-reference.md](config-reference.md) +- 運用ランブック: [operations-runbook.md](operations-runbook.md) +- トラブルシューティング: [troubleshooting.md](troubleshooting.md) + +現状: **top-level ドキュメント parity 完了**(40/40)。 + +## 全体インデックスとガバナンス + +- ローカル文書インベントリ: [docs-inventory.md](docs-inventory.md) +- i18n 実行ガイド: [i18n-guide.md](i18n-guide.md) +- i18n カバレッジ: [i18n-coverage.md](i18n-coverage.md) +- i18n ギャップ管理: [i18n-gap-backlog.md](i18n-gap-backlog.md) + +## カテゴリ + +- はじめに: [../../getting-started/README.md](../../getting-started/README.md) +- リファレンス: [../../reference/README.md](../../reference/README.md) +- 運用とデプロイ: [../../operations/README.md](../../operations/README.md) +- セキュリティ: [../../security/README.md](../../security/README.md) +- ハードウェア: [../../hardware/README.md](../../hardware/README.md) +- コントリビュート / CI: [../../contributing/README.md](../../contributing/README.md) +- 統合 TOC: [SUMMARY.md](SUMMARY.md) + +## 他言語 + +- English: [../../README.md](../../README.md) +- 简体中文: [../zh-CN/README.md](../zh-CN/README.md) +- Русский: [../ru/README.md](../ru/README.md) +- Français: [../fr/README.md](../fr/README.md) +- Tiếng Việt: [../vi/README.md](../vi/README.md) +- Ελληνικά: [../el/README.md](../el/README.md) diff --git a/docs/i18n/ja/SUMMARY.md b/docs/i18n/ja/SUMMARY.md new file mode 100644 index 000000000..a6a550334 --- /dev/null +++ b/docs/i18n/ja/SUMMARY.md @@ -0,0 +1,38 @@ +# ZeroClaw 日本語目次(i18n) + +このファイルは `docs/i18n/ja/` のナビゲーション目です。 + +最終更新:**2026-02-24**。 + +## 入口 + +- 日本語 i18n Hub: [README.md](README.md) +- 日本語互換 Hub: [../../README.ja.md](../../README.ja.md) +- 日本語互換 SUMMARY: [../../SUMMARY.ja.md](../../SUMMARY.ja.md) +- i18n 索引: [../README.md](../README.md) +- i18n カバレッジ: [../../i18n-coverage.md](../../i18n-coverage.md) + +## カテゴリ + +- はじめに: [../../getting-started/README.md](../../getting-started/README.md) +- リファレンス: [../../reference/README.md](../../reference/README.md) +- 運用: [../../operations/README.md](../../operations/README.md) +- セキュリティ: [../../security/README.md](../../security/README.md) +- ハードウェア: [../../hardware/README.md](../../hardware/README.md) +- コントリビュート / CI: [../../contributing/README.md](../../contributing/README.md) + +## Wave 1 ランタイム文書 + +- コマンドリファレンス: [commands-reference.md](commands-reference.md) +- Provider リファレンス: [providers-reference.md](providers-reference.md) +- チャネルリファレンス: [channels-reference.md](channels-reference.md) +- 設定リファレンス: [config-reference.md](config-reference.md) +- 運用ランブック: [operations-runbook.md](operations-runbook.md) +- トラブルシューティング: [troubleshooting.md](troubleshooting.md) + +## ガバナンスと索引 + +- 文書インベントリ: [docs-inventory.md](docs-inventory.md) +- i18n ガイド: [i18n-guide.md](i18n-guide.md) +- カバレッジ: [i18n-coverage.md](i18n-coverage.md) +- ギャップ追跡: [i18n-gap-backlog.md](i18n-gap-backlog.md) diff --git a/docs/i18n/ja/actions-source-policy.md b/docs/i18n/ja/actions-source-policy.md new file mode 100644 index 000000000..ea5fe8923 --- /dev/null +++ b/docs/i18n/ja/actions-source-policy.md @@ -0,0 +1,34 @@ +# ローカライズブリッジ: Actions Source Policy + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../actions-source-policy.md](../../actions-source-policy.md) + +## テーマ位置付け + +- 分類: セキュリティと統制 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Current Policy](../../actions-source-policy.md#current-policy) +- [H2 · Change Control Export](../../actions-source-policy.md#change-control-export) +- [H2 · Why This Phase](../../actions-source-policy.md#why-this-phase) +- [H2 · Agentic Workflow Guardrails](../../actions-source-policy.md#agentic-workflow-guardrails) +- [H2 · Validation Checklist](../../actions-source-policy.md#validation-checklist) +- [H2 · Rollback](../../actions-source-policy.md#rollback) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/adding-boards-and-tools.md b/docs/i18n/ja/adding-boards-and-tools.md new file mode 100644 index 000000000..8fe5b37df --- /dev/null +++ b/docs/i18n/ja/adding-boards-and-tools.md @@ -0,0 +1,40 @@ +# ローカライズブリッジ: Adding Boards And Tools + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../adding-boards-and-tools.md](../../adding-boards-and-tools.md) + +## テーマ位置付け + +- 分類: ハードウェアと周辺機器 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Quick Start: Add a Board via CLI](../../adding-boards-and-tools.md#quick-start-add-a-board-via-cli) +- [H2 · Supported Boards](../../adding-boards-and-tools.md#supported-boards) +- [H2 · Manual Config](../../adding-boards-and-tools.md#manual-config) +- [H2 · Adding a Datasheet (RAG)](../../adding-boards-and-tools.md#adding-a-datasheet-rag) +- [H3 · Pin Aliases (Recommended)](../../adding-boards-and-tools.md#pin-aliases-recommended) +- [H2 · Pin Aliases](../../adding-boards-and-tools.md#pin-aliases) +- [H2 · Pin Aliases](../../adding-boards-and-tools.md#pin-aliases) +- [H3 · PDF Datasheets](../../adding-boards-and-tools.md#pdf-datasheets) +- [H2 · Adding a New Board Type](../../adding-boards-and-tools.md#adding-a-new-board-type) +- [H2 · Adding a Custom Tool](../../adding-boards-and-tools.md#adding-a-custom-tool) +- [H2 · CLI Reference](../../adding-boards-and-tools.md#cli-reference) +- [H2 · Troubleshooting](../../adding-boards-and-tools.md#troubleshooting) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/agnostic-security.md b/docs/i18n/ja/agnostic-security.md new file mode 100644 index 000000000..152d59cec --- /dev/null +++ b/docs/i18n/ja/agnostic-security.md @@ -0,0 +1,46 @@ +# ローカライズブリッジ: Agnostic Security + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../agnostic-security.md](../../agnostic-security.md) + +## テーマ位置付け + +- 分類: セキュリティと統制 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Core Question: Will security features break...](../../agnostic-security.md#core-question-will-security-features-break) +- [H2 · 1. Build Speed: Feature-Gated Security](../../agnostic-security.md#1-build-speed-feature-gated-security) +- [H3 · Cargo.toml: Security Features Behind Features](../../agnostic-security.md#cargo-toml-security-features-behind-features) +- [H3 · Build Commands (Choose Your Profile)](../../agnostic-security.md#build-commands-choose-your-profile) +- [H3 · Conditional Compilation: Zero Overhead When Disabled](../../agnostic-security.md#conditional-compilation-zero-overhead-when-disabled) +- [H2 · 2. Pluggable Architecture: Security Is a Trait Too](../../agnostic-security.md#2-pluggable-architecture-security-is-a-trait-too) +- [H3 · Security Backend Trait (Swappable Like Everything Else)](../../agnostic-security.md#security-backend-trait-swappable-like-everything-else) +- [H3 · Factory Pattern: Auto-Select Based on Features](../../agnostic-security.md#factory-pattern-auto-select-based-on-features) +- [H2 · 3. Hardware Agnosticism: Same Binary, Different Platforms](../../agnostic-security.md#3-hardware-agnosticism-same-binary-different-platforms) +- [H3 · Cross-Platform Behavior Matrix](../../agnostic-security.md#cross-platform-behavior-matrix) +- [H3 · How It Works: Runtime Detection](../../agnostic-security.md#how-it-works-runtime-detection) +- [H2 · 4. Small Hardware: Memory Impact Analysis](../../agnostic-security.md#4-small-hardware-memory-impact-analysis) +- [H3 · Binary Size Impact (Estimated)](../../agnostic-security.md#binary-size-impact-estimated) +- [H3 · $10 Hardware Compatibility](../../agnostic-security.md#10-hardware-compatibility) +- [H2 · 5. Agnostic Swaps: Everything Remains Pluggable](../../agnostic-security.md#5-agnostic-swaps-everything-remains-pluggable) +- [H3 · ZeroClaw's Core Promise: Swap Anything](../../agnostic-security.md#zeroclaw-s-core-promise-swap-anything) +- [H3 · Swap Security Backends via Config](../../agnostic-security.md#swap-security-backends-via-config) +- [H2 · 6. Dependency Impact: Minimal New Deps](../../agnostic-security.md#6-dependency-impact-minimal-new-deps) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/android-setup.md b/docs/i18n/ja/android-setup.md new file mode 100644 index 000000000..128008ebe --- /dev/null +++ b/docs/i18n/ja/android-setup.md @@ -0,0 +1,40 @@ +# ローカライズブリッジ: Android Setup + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../android-setup.md](../../android-setup.md) + +## テーマ位置付け + +- 分類: ハードウェアと周辺機器 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Supported Architectures](../../android-setup.md#supported-architectures) +- [H2 · Installation via Termux](../../android-setup.md#installation-via-termux) +- [H3 · 1. Install Termux](../../android-setup.md#1-install-termux) +- [H3 · 2. Download ZeroClaw](../../android-setup.md#2-download-zeroclaw) +- [H3 · 3. Install and Run](../../android-setup.md#3-install-and-run) +- [H2 · Direct Installation via ADB](../../android-setup.md#direct-installation-via-adb) +- [H2 · Limitations on Android](../../android-setup.md#limitations-on-android) +- [H2 · Building from Source](../../android-setup.md#building-from-source) +- [H2 · Troubleshooting](../../android-setup.md#troubleshooting) +- [H3 · "Permission denied"](../../android-setup.md#permission-denied) +- [H3 · "not found" or linker errors](../../android-setup.md#not-found-or-linker-errors) +- [H3 · Old Android (4.x)](../../android-setup.md#old-android-4-x) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/arduino-uno-q-setup.md b/docs/i18n/ja/arduino-uno-q-setup.md new file mode 100644 index 000000000..ba56b1811 --- /dev/null +++ b/docs/i18n/ja/arduino-uno-q-setup.md @@ -0,0 +1,46 @@ +# ローカライズブリッジ: Arduino Uno Q Setup + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../arduino-uno-q-setup.md](../../arduino-uno-q-setup.md) + +## テーマ位置付け + +- 分類: ハードウェアと周辺機器 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · What's Included (No Code Changes Needed)](../../arduino-uno-q-setup.md#what-s-included-no-code-changes-needed) +- [H2 · Prerequisites](../../arduino-uno-q-setup.md#prerequisites) +- [H2 · Phase 1: Initial Uno Q Setup (One-Time)](../../arduino-uno-q-setup.md#phase-1-initial-uno-q-setup-one-time) +- [H3 · 1.1 Configure Uno Q via App Lab](../../arduino-uno-q-setup.md#1-1-configure-uno-q-via-app-lab) +- [H3 · 1.2 Verify SSH Access](../../arduino-uno-q-setup.md#1-2-verify-ssh-access) +- [H2 · Phase 2: Install ZeroClaw on Uno Q](../../arduino-uno-q-setup.md#phase-2-install-zeroclaw-on-uno-q) +- [H3 · Option A: Build on the Device (Simpler, ~20–40 min)](../../arduino-uno-q-setup.md#option-a-build-on-the-device-simpler-20-40-min) +- [H3 · Option B: Cross-Compile on Mac (Faster)](../../arduino-uno-q-setup.md#option-b-cross-compile-on-mac-faster) +- [H2 · Phase 3: Configure ZeroClaw](../../arduino-uno-q-setup.md#phase-3-configure-zeroclaw) +- [H3 · 3.1 Run Onboard (or Create Config Manually)](../../arduino-uno-q-setup.md#3-1-run-onboard-or-create-config-manually) +- [H3 · 3.2 Minimal config.toml](../../arduino-uno-q-setup.md#3-2-minimal-config-toml) +- [H2 · Phase 4: Run ZeroClaw Daemon](../../arduino-uno-q-setup.md#phase-4-run-zeroclaw-daemon) +- [H2 · Phase 5: GPIO via Bridge (ZeroClaw Handles It)](../../arduino-uno-q-setup.md#phase-5-gpio-via-bridge-zeroclaw-handles-it) +- [H3 · 5.1 Deploy Bridge App](../../arduino-uno-q-setup.md#5-1-deploy-bridge-app) +- [H3 · 5.2 Add to config.toml](../../arduino-uno-q-setup.md#5-2-add-to-config-toml) +- [H3 · 5.3 Run ZeroClaw](../../arduino-uno-q-setup.md#5-3-run-zeroclaw) +- [H2 · Summary: Commands Start to End](../../arduino-uno-q-setup.md#summary-commands-start-to-end) +- [H2 · Troubleshooting](../../arduino-uno-q-setup.md#troubleshooting) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/audit-event-schema.md b/docs/i18n/ja/audit-event-schema.md new file mode 100644 index 000000000..bc25d3c89 --- /dev/null +++ b/docs/i18n/ja/audit-event-schema.md @@ -0,0 +1,32 @@ +# ローカライズブリッジ: Audit Event Schema + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../audit-event-schema.md](../../audit-event-schema.md) + +## テーマ位置付け + +- 分類: セキュリティと統制 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Envelope](../../audit-event-schema.md#envelope) +- [H2 · Event Types](../../audit-event-schema.md#event-types) +- [H2 · Retention Policy](../../audit-event-schema.md#retention-policy) +- [H2 · Governance](../../audit-event-schema.md#governance) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/audit-logging.md b/docs/i18n/ja/audit-logging.md new file mode 100644 index 000000000..16955bc4d --- /dev/null +++ b/docs/i18n/ja/audit-logging.md @@ -0,0 +1,35 @@ +# ローカライズブリッジ: Audit Logging + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../audit-logging.md](../../audit-logging.md) + +## テーマ位置付け + +- 分類: セキュリティと統制 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Problem](../../audit-logging.md#problem) +- [H2 · Proposed Audit Log Format](../../audit-logging.md#proposed-audit-log-format) +- [H2 · Implementation](../../audit-logging.md#implementation) +- [H2 · Config Schema](../../audit-logging.md#config-schema) +- [H2 · Audit Query CLI](../../audit-logging.md#audit-query-cli) +- [H2 · Log Rotation](../../audit-logging.md#log-rotation) +- [H2 · Implementation Priority](../../audit-logging.md#implementation-priority) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/cargo-slicer-speedup.md b/docs/i18n/ja/cargo-slicer-speedup.md new file mode 100644 index 000000000..28b770c54 --- /dev/null +++ b/docs/i18n/ja/cargo-slicer-speedup.md @@ -0,0 +1,32 @@ +# ローカライズブリッジ: Cargo Slicer Speedup + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../cargo-slicer-speedup.md](../../cargo-slicer-speedup.md) + +## テーマ位置付け + +- 分類: エンジニアリング運用 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Benchmark Results](../../cargo-slicer-speedup.md#benchmark-results) +- [H2 · CI Integration](../../cargo-slicer-speedup.md#ci-integration) +- [H2 · Local Usage](../../cargo-slicer-speedup.md#local-usage) +- [H2 · How It Works](../../cargo-slicer-speedup.md#how-it-works) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/channels-reference.md b/docs/i18n/ja/channels-reference.md new file mode 100644 index 000000000..ba3686f07 --- /dev/null +++ b/docs/i18n/ja/channels-reference.md @@ -0,0 +1,18 @@ +# チャネルリファレンス(日本語) + +このページは Wave 1 の初版ローカライズです。チャネル機能と設定経路の確認用です。 + +英語版原文: + +- [../../channels-reference.md](../../channels-reference.md) + +## 主な用途 + +- Telegram/Discord/Slack などの機能差分を確認する +- allowlist と安全境界を確認する +- メッセージ送受信トラブルを切り分ける + +## 運用ルール + +- チャネル識別子、設定キー、API パスは英語のまま保持します。 +- 仕様の最終判断は英語版原文に従います。 diff --git a/docs/i18n/ja/ci-map.md b/docs/i18n/ja/ci-map.md new file mode 100644 index 000000000..9ee4a8aa0 --- /dev/null +++ b/docs/i18n/ja/ci-map.md @@ -0,0 +1,36 @@ +# ローカライズブリッジ: Ci Map + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../ci-map.md](../../ci-map.md) + +## テーマ位置付け + +- 分類: エンジニアリング運用 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Merge-Blocking vs Optional](../../ci-map.md#merge-blocking-vs-optional) +- [H3 · Merge-Blocking](../../ci-map.md#merge-blocking) +- [H3 · Non-Blocking but Important](../../ci-map.md#non-blocking-but-important) +- [H3 · Optional Repository Automation](../../ci-map.md#optional-repository-automation) +- [H2 · Trigger Map](../../ci-map.md#trigger-map) +- [H2 · Fast Triage Guide](../../ci-map.md#fast-triage-guide) +- [H2 · Maintenance Rules](../../ci-map.md#maintenance-rules) +- [H2 · Automation Side-Effect Controls](../../ci-map.md#automation-side-effect-controls) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/commands-reference.md b/docs/i18n/ja/commands-reference.md new file mode 100644 index 000000000..5b3bf8d35 --- /dev/null +++ b/docs/i18n/ja/commands-reference.md @@ -0,0 +1,18 @@ +# コマンドリファレンス(日本語) + +このページは Wave 1 の初版ローカライズです。ZeroClaw CLI コマンドを素早く参照するための入口です。 + +英語版原文: + +- [../../commands-reference.md](../../commands-reference.md) + +## 主な用途 + +- タスク別に CLI コマンドを確認する +- オプションと動作境界を確認する +- 実行トラブル時に期待挙動を照合する + +## 運用ルール + +- コマンド名・フラグ名・設定キーは英語のまま保持します。 +- 挙動の最終定義は英語版原文を優先します。 diff --git a/docs/i18n/ja/config-reference.md b/docs/i18n/ja/config-reference.md new file mode 100644 index 000000000..a974173a3 --- /dev/null +++ b/docs/i18n/ja/config-reference.md @@ -0,0 +1,18 @@ +# 設定リファレンス(日本語) + +このページは Wave 1 の初版ローカライズです。主要設定キー、既定値、リスク境界を確認します。 + +英語版原文: + +- [../../config-reference.md](../../config-reference.md) + +## 主な用途 + +- 新規環境の初期設定 +- 設定衝突や回復手順の確認 +- セキュリティ関連設定の監査 + +## 運用ルール + +- 設定キー名は英語のまま保持します。 +- 実行時挙動の定義は英語版原文を優先します。 diff --git a/docs/i18n/ja/custom-providers.md b/docs/i18n/ja/custom-providers.md new file mode 100644 index 000000000..a0368b8b9 --- /dev/null +++ b/docs/i18n/ja/custom-providers.md @@ -0,0 +1,46 @@ +# ローカライズブリッジ: Custom Providers + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../custom-providers.md](../../custom-providers.md) + +## テーマ位置付け + +- 分類: Provider と統合 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Provider Types](../../custom-providers.md#provider-types) +- [H3 · OpenAI-Compatible Endpoints (`custom:`)](../../custom-providers.md#openai-compatible-endpoints-custom) +- [H3 · Anthropic-Compatible Endpoints (`anthropic-custom:`)](../../custom-providers.md#anthropic-compatible-endpoints-anthropic-custom) +- [H2 · Configuration Methods](../../custom-providers.md#configuration-methods) +- [H3 · Config File](../../custom-providers.md#config-file) +- [H3 · Environment Variables](../../custom-providers.md#environment-variables) +- [H2 · llama.cpp Server (Recommended Local Setup)](../../custom-providers.md#llama-cpp-server-recommended-local-setup) +- [H2 · SGLang Server](../../custom-providers.md#sglang-server) +- [H2 · vLLM Server](../../custom-providers.md#vllm-server) +- [H2 · Testing Configuration](../../custom-providers.md#testing-configuration) +- [H2 · Troubleshooting](../../custom-providers.md#troubleshooting) +- [H3 · Authentication Errors](../../custom-providers.md#authentication-errors) +- [H3 · Model Not Found](../../custom-providers.md#model-not-found) +- [H3 · Connection Issues](../../custom-providers.md#connection-issues) +- [H2 · Examples](../../custom-providers.md#examples) +- [H3 · Local LLM Server (Generic Custom Endpoint)](../../custom-providers.md#local-llm-server-generic-custom-endpoint) +- [H3 · Corporate Proxy](../../custom-providers.md#corporate-proxy) +- [H3 · Cloud Provider Gateway](../../custom-providers.md#cloud-provider-gateway) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/doc-template.md b/docs/i18n/ja/doc-template.md new file mode 100644 index 000000000..3ea6be8ab --- /dev/null +++ b/docs/i18n/ja/doc-template.md @@ -0,0 +1,38 @@ +# ローカライズブリッジ: Doc Template + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../doc-template.md](../../doc-template.md) + +## テーマ位置付け + +- 分類: エンジニアリング運用 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · 1. Summary](../../doc-template.md#1-summary) +- [H2 · 2. Prerequisites](../../doc-template.md#2-prerequisites) +- [H2 · 3. Procedure](../../doc-template.md#3-procedure) +- [H3 · 3.1 Baseline Check](../../doc-template.md#3-1-baseline-check) +- [H3 · 3.2 Main Workflow](../../doc-template.md#3-2-main-workflow) +- [H3 · 3.3 Verification](../../doc-template.md#3-3-verification) +- [H2 · 4. Safety, Risk, and Rollback](../../doc-template.md#4-safety-risk-and-rollback) +- [H2 · 5. Troubleshooting](../../doc-template.md#5-troubleshooting) +- [H2 · 6. Related Docs](../../doc-template.md#6-related-docs) +- [H2 · 7. Maintenance Notes](../../doc-template.md#7-maintenance-notes) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/docs-audit-2026-02-24.md b/docs/i18n/ja/docs-audit-2026-02-24.md new file mode 100644 index 000000000..5d04520ef --- /dev/null +++ b/docs/i18n/ja/docs-audit-2026-02-24.md @@ -0,0 +1,42 @@ +# ローカライズブリッジ: Docs Audit 2026 02 24 + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../docs-audit-2026-02-24.md](../../docs-audit-2026-02-24.md) + +## テーマ位置付け + +- 分類: エンジニアリング運用 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · 1) Audit Method](../../docs-audit-2026-02-24.md#1-audit-method) +- [H2 · 2) Findings](../../docs-audit-2026-02-24.md#2-findings) +- [H3 · A. Structural clarity gaps](../../docs-audit-2026-02-24.md#a-structural-clarity-gaps) +- [H3 · B. Completeness gaps](../../docs-audit-2026-02-24.md#b-completeness-gaps) +- [H3 · C. Integrity issues](../../docs-audit-2026-02-24.md#c-integrity-issues) +- [H2 · 3) Remediation Applied](../../docs-audit-2026-02-24.md#3-remediation-applied) +- [H3 · 3.1 Navigation and governance](../../docs-audit-2026-02-24.md#3-1-navigation-and-governance) +- [H3 · 3.2 Directory completeness](../../docs-audit-2026-02-24.md#3-2-directory-completeness) +- [H3 · 3.3 Compatibility cleanup](../../docs-audit-2026-02-24.md#3-3-compatibility-cleanup) +- [H3 · 3.4 Broken link fixes](../../docs-audit-2026-02-24.md#3-4-broken-link-fixes) +- [H2 · 4) Current Known Remaining Gaps](../../docs-audit-2026-02-24.md#4-current-known-remaining-gaps) +- [H2 · 5) Recommended Next Wave](../../docs-audit-2026-02-24.md#5-recommended-next-wave) +- [H2 · 6) Validation Status](../../docs-audit-2026-02-24.md#6-validation-status) +- [H2 · Addendum (Phase-2 Deep Completion)](../../docs-audit-2026-02-24.md#addendum-phase-2-deep-completion) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/docs-inventory.md b/docs/i18n/ja/docs-inventory.md new file mode 100644 index 000000000..219e24520 --- /dev/null +++ b/docs/i18n/ja/docs-inventory.md @@ -0,0 +1,74 @@ +# ドキュメントインベントリ(日本語) + +このページは `docs/i18n/ja/` の top-level 文書を素早く参照するための索引です。 + +最終更新:**2026-02-24**。 +現状:**top-level parity 完了(40/40)**。 + +## 規範ソース + +- 英語版インベントリ: [../../docs-inventory.md](../../docs-inventory.md) +- i18n ガイド: [i18n-guide.md](i18n-guide.md) +- i18n カバレッジ: [i18n-coverage.md](i18n-coverage.md) + +## ランタイムと接続 + +- [commands-reference.md](commands-reference.md) +- [config-reference.md](config-reference.md) +- [providers-reference.md](providers-reference.md) +- [channels-reference.md](channels-reference.md) +- [operations-runbook.md](operations-runbook.md) +- [troubleshooting.md](troubleshooting.md) +- [one-click-bootstrap.md](one-click-bootstrap.md) +- [network-deployment.md](network-deployment.md) +- [mattermost-setup.md](mattermost-setup.md) +- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) +- [matrix-e2ee-guide.md](matrix-e2ee-guide.md) + +## Provider と統合 + +- [custom-providers.md](custom-providers.md) +- [zai-glm-setup.md](zai-glm-setup.md) +- [langgraph-integration.md](langgraph-integration.md) +- [proxy-agent-playbook.md](proxy-agent-playbook.md) + +## ハードウェアと周辺機器 + +- [hardware-peripherals-design.md](hardware-peripherals-design.md) +- [adding-boards-and-tools.md](adding-boards-and-tools.md) +- [android-setup.md](android-setup.md) +- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) +- [nucleo-setup.md](nucleo-setup.md) + +## セキュリティと統制 + +- [agnostic-security.md](agnostic-security.md) +- [frictionless-security.md](frictionless-security.md) +- [audit-logging.md](audit-logging.md) +- [audit-event-schema.md](audit-event-schema.md) +- [sandboxing.md](sandboxing.md) +- [resource-limits.md](resource-limits.md) +- [security-roadmap.md](security-roadmap.md) +- [actions-source-policy.md](actions-source-policy.md) + +## エンジニアリング運用 + +- [pr-workflow.md](pr-workflow.md) +- [reviewer-playbook.md](reviewer-playbook.md) +- [ci-map.md](ci-map.md) +- [release-process.md](release-process.md) +- [cargo-slicer-speedup.md](cargo-slicer-speedup.md) +- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) +- [docs-audit-2026-02-24.md](docs-audit-2026-02-24.md) +- [doc-template.md](doc-template.md) + +## i18n ガバナンス + +- [i18n-guide.md](i18n-guide.md) +- [i18n-coverage.md](i18n-coverage.md) +- [i18n-gap-backlog.md](i18n-gap-backlog.md) + +## 運用ルール + +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 実装仕様と挙動の最終定義は英語版原文を優先します。 diff --git a/docs/i18n/ja/frictionless-security.md b/docs/i18n/ja/frictionless-security.md new file mode 100644 index 000000000..657f4c626 --- /dev/null +++ b/docs/i18n/ja/frictionless-security.md @@ -0,0 +1,43 @@ +# ローカライズブリッジ: Frictionless Security + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../frictionless-security.md](../../frictionless-security.md) + +## テーマ位置付け + +- 分類: セキュリティと統制 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Core Principle](../../frictionless-security.md#core-principle) +- [H2 · Design: Silent Auto-Detection](../../frictionless-security.md#design-silent-auto-detection) +- [H3 · 1. No New Wizard Steps (Stays 9 Steps, < 60 Seconds)](../../frictionless-security.md#1-no-new-wizard-steps-stays-9-steps-60-seconds) +- [H3 · 2. Auto-Detection Logic (Runs Once at First Start)](../../frictionless-security.md#2-auto-detection-logic-runs-once-at-first-start) +- [H3 · 3. First Run: Silent Logging](../../frictionless-security.md#3-first-run-silent-logging) +- [H3 · 4. Config File: All Defaults Hidden](../../frictionless-security.md#4-config-file-all-defaults-hidden) +- [H3 · 5. Advanced Users: Explicit Control](../../frictionless-security.md#5-advanced-users-explicit-control) +- [H3 · 6. Graceful Degradation](../../frictionless-security.md#6-graceful-degradation) +- [H2 · Config Schema Extension](../../frictionless-security.md#config-schema-extension) +- [H2 · User Experience Comparison](../../frictionless-security.md#user-experience-comparison) +- [H3 · Before (Current)](../../frictionless-security.md#before-current) +- [H3 · After (With Frictionless Security)](../../frictionless-security.md#after-with-frictionless-security) +- [H3 · Advanced User (Explicit Control)](../../frictionless-security.md#advanced-user-explicit-control) +- [H2 · Backward Compatibility](../../frictionless-security.md#backward-compatibility) +- [H2 · Summary](../../frictionless-security.md#summary) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/hardware-peripherals-design.md b/docs/i18n/ja/hardware-peripherals-design.md new file mode 100644 index 000000000..7ef3eab16 --- /dev/null +++ b/docs/i18n/ja/hardware-peripherals-design.md @@ -0,0 +1,46 @@ +# ローカライズブリッジ: Hardware Peripherals Design + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../hardware-peripherals-design.md](../../hardware-peripherals-design.md) + +## テーマ位置付け + +- 分類: ハードウェアと周辺機器 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · 1. Vision](../../hardware-peripherals-design.md#1-vision) +- [H2 · 2. Two Modes of Operation](../../hardware-peripherals-design.md#2-two-modes-of-operation) +- [H3 · Mode 1: Edge-Native (Standalone)](../../hardware-peripherals-design.md#mode-1-edge-native-standalone) +- [H3 · Mode 2: Host-Mediated (Development / Debugging)](../../hardware-peripherals-design.md#mode-2-host-mediated-development-debugging) +- [H3 · Mode Comparison](../../hardware-peripherals-design.md#mode-comparison) +- [H2 · 3. Legacy / Simpler Modes (Pre-LLM-on-Edge)](../../hardware-peripherals-design.md#3-legacy-simpler-modes-pre-llm-on-edge) +- [H3 · Mode A: Host + Remote Peripheral (STM32 via serial)](../../hardware-peripherals-design.md#mode-a-host-remote-peripheral-stm32-via-serial) +- [H3 · Mode B: RPi as Host (Native GPIO)](../../hardware-peripherals-design.md#mode-b-rpi-as-host-native-gpio) +- [H2 · 4. Technical Requirements](../../hardware-peripherals-design.md#4-technical-requirements) +- [H3 · RAG Pipeline (Datasheet Retrieval)](../../hardware-peripherals-design.md#rag-pipeline-datasheet-retrieval) +- [H3 · Dynamic Execution Options](../../hardware-peripherals-design.md#dynamic-execution-options) +- [H2 · 5. CLI and Config](../../hardware-peripherals-design.md#5-cli-and-config) +- [H3 · CLI Flags](../../hardware-peripherals-design.md#cli-flags) +- [H3 · Config (config.toml)](../../hardware-peripherals-design.md#config-config-toml) +- [H2 · 6. Architecture: Peripheral as Extension Point](../../hardware-peripherals-design.md#6-architecture-peripheral-as-extension-point) +- [H3 · New Trait: `Peripheral`](../../hardware-peripherals-design.md#new-trait-peripheral) +- [H3 · Flow](../../hardware-peripherals-design.md#flow) +- [H3 · Board Support](../../hardware-peripherals-design.md#board-support) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/i18n-coverage.md b/docs/i18n/ja/i18n-coverage.md new file mode 100644 index 000000000..bd8cd9761 --- /dev/null +++ b/docs/i18n/ja/i18n-coverage.md @@ -0,0 +1,36 @@ +# ローカライズブリッジ: I18n Coverage + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../i18n-coverage.md](../../i18n-coverage.md) + +## テーマ位置付け + +- 分類: i18n ガバナンス +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Canonical Layout](../../i18n-coverage.md#canonical-layout) +- [H2 · Locale Coverage Matrix](../../i18n-coverage.md#locale-coverage-matrix) +- [H2 · Top-Level Parity Snapshot](../../i18n-coverage.md#top-level-parity-snapshot) +- [H2 · Root README Completeness](../../i18n-coverage.md#root-readme-completeness) +- [H2 · Collection Index i18n](../../i18n-coverage.md#collection-index-i18n) +- [H2 · Localization Rules](../../i18n-coverage.md#localization-rules) +- [H2 · Adding a New Locale](../../i18n-coverage.md#adding-a-new-locale) +- [H2 · Review Checklist](../../i18n-coverage.md#review-checklist) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/i18n-gap-backlog.md b/docs/i18n/ja/i18n-gap-backlog.md new file mode 100644 index 000000000..d9615c4cc --- /dev/null +++ b/docs/i18n/ja/i18n-gap-backlog.md @@ -0,0 +1,34 @@ +# ローカライズブリッジ: I18n Gap Backlog + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../i18n-gap-backlog.md](../../i18n-gap-backlog.md) + +## テーマ位置付け + +- 分類: i18n ガバナンス +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Baseline Definition](../../i18n-gap-backlog.md#baseline-definition) +- [H2 · Current Gap Counts](../../i18n-gap-backlog.md#current-gap-counts) +- [H2 · Closure Record (2026-02-24)](../../i18n-gap-backlog.md#closure-record-2026-02-24) +- [H2 · Remaining Gaps (Baseline Scope)](../../i18n-gap-backlog.md#remaining-gaps-baseline-scope) +- [H2 · Optional Next Depth](../../i18n-gap-backlog.md#optional-next-depth) +- [H2 · Tracking Rules](../../i18n-gap-backlog.md#tracking-rules) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/i18n-guide.md b/docs/i18n/ja/i18n-guide.md new file mode 100644 index 000000000..5e0e7a93f --- /dev/null +++ b/docs/i18n/ja/i18n-guide.md @@ -0,0 +1,36 @@ +# ローカライズブリッジ: I18n Guide + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../i18n-guide.md](../../i18n-guide.md) + +## テーマ位置付け + +- 分類: i18n ガバナンス +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Scope](../../i18n-guide.md#scope) +- [H2 · Canonical Layout](../../i18n-guide.md#canonical-layout) +- [H2 · Trigger Matrix](../../i18n-guide.md#trigger-matrix) +- [H2 · Completion Checklist (Mandatory)](../../i18n-guide.md#completion-checklist-mandatory) +- [H2 · Deferred Translation Policy](../../i18n-guide.md#deferred-translation-policy) +- [H2 · Agent Workflow Contract](../../i18n-guide.md#agent-workflow-contract) +- [H2 · Gap Tracking](../../i18n-guide.md#gap-tracking) +- [H2 · Quick Validation Commands](../../i18n-guide.md#quick-validation-commands) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/langgraph-integration.md b/docs/i18n/ja/langgraph-integration.md new file mode 100644 index 000000000..7901971a7 --- /dev/null +++ b/docs/i18n/ja/langgraph-integration.md @@ -0,0 +1,46 @@ +# ローカライズブリッジ: Langgraph Integration + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../langgraph-integration.md](../../langgraph-integration.md) + +## テーマ位置付け + +- 分類: Provider と統合 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Background](../../langgraph-integration.md#background) +- [H2 · Architecture](../../langgraph-integration.md#architecture) +- [H2 · Quick Start](../../langgraph-integration.md#quick-start) +- [H3 · Installation](../../langgraph-integration.md#installation) +- [H3 · Basic Usage](../../langgraph-integration.md#basic-usage) +- [H2 · Available Tools](../../langgraph-integration.md#available-tools) +- [H3 · Core Tools](../../langgraph-integration.md#core-tools) +- [H3 · Extended Tools](../../langgraph-integration.md#extended-tools) +- [H2 · Custom Tools](../../langgraph-integration.md#custom-tools) +- [H2 · Provider Configuration](../../langgraph-integration.md#provider-configuration) +- [H3 · Z.AI / GLM-5](../../langgraph-integration.md#z-ai-glm-5) +- [H3 · OpenRouter](../../langgraph-integration.md#openrouter) +- [H3 · Groq](../../langgraph-integration.md#groq) +- [H3 · Ollama (Local)](../../langgraph-integration.md#ollama-local) +- [H2 · Discord Bot Integration](../../langgraph-integration.md#discord-bot-integration) +- [H2 · CLI Usage](../../langgraph-integration.md#cli-usage) +- [H2 · Comparison with Rust ZeroClaw](../../langgraph-integration.md#comparison-with-rust-zeroclaw) +- [H2 · Troubleshooting](../../langgraph-integration.md#troubleshooting) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/matrix-e2ee-guide.md b/docs/i18n/ja/matrix-e2ee-guide.md new file mode 100644 index 000000000..d84dd235e --- /dev/null +++ b/docs/i18n/ja/matrix-e2ee-guide.md @@ -0,0 +1,42 @@ +# ローカライズブリッジ: Matrix E2ee Guide + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../matrix-e2ee-guide.md](../../matrix-e2ee-guide.md) + +## テーマ位置付け + +- 分類: ランタイムと接続 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · 0. Fast FAQ (#499-class symptom)](../../matrix-e2ee-guide.md#0-fast-faq-499-class-symptom) +- [H2 · 1. Requirements](../../matrix-e2ee-guide.md#1-requirements) +- [H2 · 2. Configuration](../../matrix-e2ee-guide.md#2-configuration) +- [H3 · About `user_id` and `device_id`](../../matrix-e2ee-guide.md#about-user-id-and-device-id) +- [H2 · 3. Quick Validation Flow](../../matrix-e2ee-guide.md#3-quick-validation-flow) +- [H2 · 4. Troubleshooting “No Response”](../../matrix-e2ee-guide.md#4-troubleshooting-no-response) +- [H3 · A. Room and membership](../../matrix-e2ee-guide.md#a-room-and-membership) +- [H3 · B. Sender allowlist](../../matrix-e2ee-guide.md#b-sender-allowlist) +- [H3 · C. Token and identity](../../matrix-e2ee-guide.md#c-token-and-identity) +- [H3 · D. E2EE-specific checks](../../matrix-e2ee-guide.md#d-e2ee-specific-checks) +- [H3 · E. Message formatting (Markdown)](../../matrix-e2ee-guide.md#e-message-formatting-markdown) +- [H3 · F. Fresh start test](../../matrix-e2ee-guide.md#f-fresh-start-test) +- [H2 · 5. Operational Notes](../../matrix-e2ee-guide.md#5-operational-notes) +- [H2 · 6. Related Docs](../../matrix-e2ee-guide.md#6-related-docs) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/mattermost-setup.md b/docs/i18n/ja/mattermost-setup.md new file mode 100644 index 000000000..2de748692 --- /dev/null +++ b/docs/i18n/ja/mattermost-setup.md @@ -0,0 +1,34 @@ +# ローカライズブリッジ: Mattermost Setup + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../mattermost-setup.md](../../mattermost-setup.md) + +## テーマ位置付け + +- 分類: ランタイムと接続 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Prerequisites](../../mattermost-setup.md#prerequisites) +- [H2 · Configuration](../../mattermost-setup.md#configuration) +- [H3 · Configuration Fields](../../mattermost-setup.md#configuration-fields) +- [H2 · Threaded Conversations](../../mattermost-setup.md#threaded-conversations) +- [H2 · Mention-Only Mode](../../mattermost-setup.md#mention-only-mode) +- [H2 · Security Note](../../mattermost-setup.md#security-note) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/network-deployment.md b/docs/i18n/ja/network-deployment.md new file mode 100644 index 000000000..c30c1aedc --- /dev/null +++ b/docs/i18n/ja/network-deployment.md @@ -0,0 +1,46 @@ +# ローカライズブリッジ: Network Deployment + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../network-deployment.md](../../network-deployment.md) + +## テーマ位置付け + +- 分類: ランタイムと接続 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · 1. Overview](../../network-deployment.md#1-overview) +- [H2 · 2. ZeroClaw on Raspberry Pi](../../network-deployment.md#2-zeroclaw-on-raspberry-pi) +- [H3 · 2.1 Prerequisites](../../network-deployment.md#2-1-prerequisites) +- [H3 · 2.2 Install](../../network-deployment.md#2-2-install) +- [H3 · 2.3 Config](../../network-deployment.md#2-3-config) +- [H3 · 2.4 Run Daemon (Local Only)](../../network-deployment.md#2-4-run-daemon-local-only) +- [H2 · 3. Binding to 0.0.0.0 (Local Network)](../../network-deployment.md#3-binding-to-0-0-0-0-local-network) +- [H3 · 3.1 Option A: Explicit Opt-In](../../network-deployment.md#3-1-option-a-explicit-opt-in) +- [H3 · 3.2 Option B: Tunnel (Recommended for Webhooks)](../../network-deployment.md#3-2-option-b-tunnel-recommended-for-webhooks) +- [H2 · 4. Telegram Polling (No Inbound Port)](../../network-deployment.md#4-telegram-polling-no-inbound-port) +- [H3 · 4.1 Single Poller Rule (Important)](../../network-deployment.md#4-1-single-poller-rule-important) +- [H2 · 5. Webhook Channels (WhatsApp, Nextcloud Talk, Custom)](../../network-deployment.md#5-webhook-channels-whatsapp-nextcloud-talk-custom) +- [H3 · 5.1 Tailscale Funnel](../../network-deployment.md#5-1-tailscale-funnel) +- [H3 · 5.2 ngrok](../../network-deployment.md#5-2-ngrok) +- [H3 · 5.3 Cloudflare Tunnel](../../network-deployment.md#5-3-cloudflare-tunnel) +- [H2 · 6. Checklist: RPi Deployment](../../network-deployment.md#6-checklist-rpi-deployment) +- [H2 · 7. OpenRC (Alpine Linux Service)](../../network-deployment.md#7-openrc-alpine-linux-service) +- [H3 · 7.1 Prerequisites](../../network-deployment.md#7-1-prerequisites) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/nextcloud-talk-setup.md b/docs/i18n/ja/nextcloud-talk-setup.md new file mode 100644 index 000000000..8c9d6ee59 --- /dev/null +++ b/docs/i18n/ja/nextcloud-talk-setup.md @@ -0,0 +1,35 @@ +# ローカライズブリッジ: Nextcloud Talk Setup + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../nextcloud-talk-setup.md](../../nextcloud-talk-setup.md) + +## テーマ位置付け + +- 分類: ランタイムと接続 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · 1. What this integration does](../../nextcloud-talk-setup.md#1-what-this-integration-does) +- [H2 · 2. Configuration](../../nextcloud-talk-setup.md#2-configuration) +- [H2 · 3. Gateway endpoint](../../nextcloud-talk-setup.md#3-gateway-endpoint) +- [H2 · 4. Signature verification contract](../../nextcloud-talk-setup.md#4-signature-verification-contract) +- [H2 · 5. Message routing behavior](../../nextcloud-talk-setup.md#5-message-routing-behavior) +- [H2 · 6. Quick validation checklist](../../nextcloud-talk-setup.md#6-quick-validation-checklist) +- [H2 · 7. Troubleshooting](../../nextcloud-talk-setup.md#7-troubleshooting) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/nucleo-setup.md b/docs/i18n/ja/nucleo-setup.md new file mode 100644 index 000000000..ce1832f6d --- /dev/null +++ b/docs/i18n/ja/nucleo-setup.md @@ -0,0 +1,40 @@ +# ローカライズブリッジ: Nucleo Setup + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../nucleo-setup.md](../../nucleo-setup.md) + +## テーマ位置付け + +- 分類: ハードウェアと周辺機器 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Get Board Info via Telegram (No Firmware Needed)](../../nucleo-setup.md#get-board-info-via-telegram-no-firmware-needed) +- [H2 · What's Included (No Code Changes Needed)](../../nucleo-setup.md#what-s-included-no-code-changes-needed) +- [H2 · Prerequisites](../../nucleo-setup.md#prerequisites) +- [H2 · Phase 1: Flash Firmware](../../nucleo-setup.md#phase-1-flash-firmware) +- [H3 · 1.1 Connect Nucleo](../../nucleo-setup.md#1-1-connect-nucleo) +- [H3 · 1.2 Flash via ZeroClaw](../../nucleo-setup.md#1-2-flash-via-zeroclaw) +- [H3 · 1.3 Manual Flash (Alternative)](../../nucleo-setup.md#1-3-manual-flash-alternative) +- [H2 · Phase 2: Find Serial Port](../../nucleo-setup.md#phase-2-find-serial-port) +- [H2 · Phase 3: Configure ZeroClaw](../../nucleo-setup.md#phase-3-configure-zeroclaw) +- [H2 · Phase 4: Run and Test](../../nucleo-setup.md#phase-4-run-and-test) +- [H2 · Summary: Commands](../../nucleo-setup.md#summary-commands) +- [H2 · Troubleshooting](../../nucleo-setup.md#troubleshooting) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/one-click-bootstrap.md b/docs/i18n/ja/one-click-bootstrap.md new file mode 100644 index 000000000..770a8dd2d --- /dev/null +++ b/docs/i18n/ja/one-click-bootstrap.md @@ -0,0 +1,39 @@ +# ローカライズブリッジ: One Click Bootstrap + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../one-click-bootstrap.md](../../one-click-bootstrap.md) + +## テーマ位置付け + +- 分類: ランタイムと接続 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Option 0: Homebrew (macOS/Linuxbrew)](../../one-click-bootstrap.md#option-0-homebrew-macos-linuxbrew) +- [H2 · Option A (Recommended): Clone + local script](../../one-click-bootstrap.md#option-a-recommended-clone-local-script) +- [H3 · Resource preflight and pre-built flow](../../one-click-bootstrap.md#resource-preflight-and-pre-built-flow) +- [H2 · Dual-mode bootstrap](../../one-click-bootstrap.md#dual-mode-bootstrap) +- [H2 · Option B: Remote one-liner](../../one-click-bootstrap.md#option-b-remote-one-liner) +- [H2 · Optional onboarding modes](../../one-click-bootstrap.md#optional-onboarding-modes) +- [H3 · Containerized onboarding (Docker)](../../one-click-bootstrap.md#containerized-onboarding-docker) +- [H3 · Quick onboarding (non-interactive)](../../one-click-bootstrap.md#quick-onboarding-non-interactive) +- [H3 · Interactive onboarding](../../one-click-bootstrap.md#interactive-onboarding) +- [H2 · Useful flags](../../one-click-bootstrap.md#useful-flags) +- [H2 · Related docs](../../one-click-bootstrap.md#related-docs) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/operations-runbook.md b/docs/i18n/ja/operations-runbook.md new file mode 100644 index 000000000..f76efecac --- /dev/null +++ b/docs/i18n/ja/operations-runbook.md @@ -0,0 +1,18 @@ +# 運用ランブック(日本語) + +このページは Wave 1 の初版ローカライズです。Day-2 運用の標準手順を参照する入口です。 + +英語版原文: + +- [../../operations-runbook.md](../../operations-runbook.md) + +## 主な用途 + +- 変更前後のヘルス確認 +- サービス再起動・ロールバック手順 +- 運用異常時の標準対応フロー + +## 運用ルール + +- コマンド名・設定キーは英語のまま保持します。 +- 本番手順の最終定義は英語版原文を優先します。 diff --git a/docs/i18n/ja/pr-workflow.md b/docs/i18n/ja/pr-workflow.md new file mode 100644 index 000000000..4291e225e --- /dev/null +++ b/docs/i18n/ja/pr-workflow.md @@ -0,0 +1,46 @@ +# ローカライズブリッジ: Pr Workflow + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../pr-workflow.md](../../pr-workflow.md) + +## テーマ位置付け + +- 分類: エンジニアリング運用 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · 0. Summary](../../pr-workflow.md#0-summary) +- [H2 · 1. Fast Path by PR Situation](../../pr-workflow.md#1-fast-path-by-pr-situation) +- [H3 · 1.1 Intake is incomplete](../../pr-workflow.md#1-1-intake-is-incomplete) +- [H3 · 1.2 `CI Required Gate` failing](../../pr-workflow.md#1-2-ci-required-gate-failing) +- [H3 · 1.3 High-risk path touched](../../pr-workflow.md#1-3-high-risk-path-touched) +- [H3 · 1.4 PR is superseded or duplicate](../../pr-workflow.md#1-4-pr-is-superseded-or-duplicate) +- [H2 · 2. Governance Goals and Control Loop](../../pr-workflow.md#2-governance-goals-and-control-loop) +- [H3 · 2.1 Governance goals](../../pr-workflow.md#2-1-governance-goals) +- [H3 · 2.2 Governance design logic (control loop)](../../pr-workflow.md#2-2-governance-design-logic-control-loop) +- [H2 · 3. Required Repository Settings](../../pr-workflow.md#3-required-repository-settings) +- [H2 · 4. PR Lifecycle Runbook](../../pr-workflow.md#4-pr-lifecycle-runbook) +- [H3 · 4.1 Step A: Intake](../../pr-workflow.md#4-1-step-a-intake) +- [H3 · 4.2 Step B: Validation](../../pr-workflow.md#4-2-step-b-validation) +- [H3 · 4.3 Step C: Review](../../pr-workflow.md#4-3-step-c-review) +- [H3 · 4.4 Step D: Merge](../../pr-workflow.md#4-4-step-d-merge) +- [H2 · 5. PR Readiness Contracts (DoR / DoD)](../../pr-workflow.md#5-pr-readiness-contracts-dor-dod) +- [H3 · 5.1 Definition of Ready (DoR) before requesting review](../../pr-workflow.md#5-1-definition-of-ready-dor-before-requesting-review) +- [H3 · 5.2 Definition of Done (DoD) merge-ready](../../pr-workflow.md#5-2-definition-of-done-dod-merge-ready) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/project-triage-snapshot-2026-02-18.md b/docs/i18n/ja/project-triage-snapshot-2026-02-18.md new file mode 100644 index 000000000..1e7679d87 --- /dev/null +++ b/docs/i18n/ja/project-triage-snapshot-2026-02-18.md @@ -0,0 +1,36 @@ +# ローカライズブリッジ: Project Triage Snapshot 2026 02 18 + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../project-triage-snapshot-2026-02-18.md](../../project-triage-snapshot-2026-02-18.md) + +## テーマ位置付け + +- 分類: エンジニアリング運用 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Data Source](../../project-triage-snapshot-2026-02-18.md#data-source) +- [H2 · Repository Pulse](../../project-triage-snapshot-2026-02-18.md#repository-pulse) +- [H2 · PR Label Pressure (Open PRs)](../../project-triage-snapshot-2026-02-18.md#pr-label-pressure-open-prs) +- [H2 · Issue Label Pressure (Open Issues)](../../project-triage-snapshot-2026-02-18.md#issue-label-pressure-open-issues) +- [H2 · Docs-Relevant Open PRs](../../project-triage-snapshot-2026-02-18.md#docs-relevant-open-prs) +- [H2 · Docs-Relevant Open Issues](../../project-triage-snapshot-2026-02-18.md#docs-relevant-open-issues) +- [H2 · Recommended Docs Backlog (Priority Order)](../../project-triage-snapshot-2026-02-18.md#recommended-docs-backlog-priority-order) +- [H2 · Snapshot Caveat](../../project-triage-snapshot-2026-02-18.md#snapshot-caveat) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/providers-reference.md b/docs/i18n/ja/providers-reference.md new file mode 100644 index 000000000..78af95755 --- /dev/null +++ b/docs/i18n/ja/providers-reference.md @@ -0,0 +1,18 @@ +# Provider リファレンス(日本語) + +このページは Wave 1 の初版ローカライズです。provider ID、別名、認証環境変数の確認に使います。 + +英語版原文: + +- [../../providers-reference.md](../../providers-reference.md) + +## 主な用途 + +- provider/モデル接続先を選定する +- provider ID・alias・認証変数を確認する +- provider 設定ミスや認証エラーを切り分ける + +## 運用ルール + +- Provider ID と環境変数名は英語のまま保持します。 +- 正式な仕様は英語版原文を優先します。 diff --git a/docs/i18n/ja/proxy-agent-playbook.md b/docs/i18n/ja/proxy-agent-playbook.md new file mode 100644 index 000000000..cae7ee2ee --- /dev/null +++ b/docs/i18n/ja/proxy-agent-playbook.md @@ -0,0 +1,46 @@ +# ローカライズブリッジ: Proxy Agent Playbook + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../proxy-agent-playbook.md](../../proxy-agent-playbook.md) + +## テーマ位置付け + +- 分類: Provider と統合 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · 0. Summary](../../proxy-agent-playbook.md#0-summary) +- [H2 · 1. Fast Path by Intent](../../proxy-agent-playbook.md#1-fast-path-by-intent) +- [H3 · 1.1 Proxy only ZeroClaw internal traffic](../../proxy-agent-playbook.md#1-1-proxy-only-zeroclaw-internal-traffic) +- [H3 · 1.2 Proxy only selected services](../../proxy-agent-playbook.md#1-2-proxy-only-selected-services) +- [H3 · 1.3 Export process-wide proxy environment variables](../../proxy-agent-playbook.md#1-3-export-process-wide-proxy-environment-variables) +- [H3 · 1.4 Emergency rollback](../../proxy-agent-playbook.md#1-4-emergency-rollback) +- [H2 · 2. Scope Decision Matrix](../../proxy-agent-playbook.md#2-scope-decision-matrix) +- [H2 · 3. Standard Safe Workflow](../../proxy-agent-playbook.md#3-standard-safe-workflow) +- [H2 · 4. Mode A — Proxy Only for ZeroClaw Internals](../../proxy-agent-playbook.md#4-mode-a-proxy-only-for-zeroclaw-internals) +- [H2 · 5. Mode B — Proxy Only for Specific Services](../../proxy-agent-playbook.md#5-mode-b-proxy-only-for-specific-services) +- [H3 · 5.1 Target specific services](../../proxy-agent-playbook.md#5-1-target-specific-services) +- [H3 · 5.2 Target by selectors](../../proxy-agent-playbook.md#5-2-target-by-selectors) +- [H2 · 6. Mode C — Proxy for Full Process Environment](../../proxy-agent-playbook.md#6-mode-c-proxy-for-full-process-environment) +- [H3 · 6.1 Configure and apply environment scope](../../proxy-agent-playbook.md#6-1-configure-and-apply-environment-scope) +- [H2 · 7. Disable / Rollback Patterns](../../proxy-agent-playbook.md#7-disable-rollback-patterns) +- [H3 · 7.1 Disable proxy (default safe behavior)](../../proxy-agent-playbook.md#7-1-disable-proxy-default-safe-behavior) +- [H3 · 7.2 Disable proxy and force-clear env vars](../../proxy-agent-playbook.md#7-2-disable-proxy-and-force-clear-env-vars) +- [H3 · 7.3 Keep proxy enabled but clear environment exports only](../../proxy-agent-playbook.md#7-3-keep-proxy-enabled-but-clear-environment-exports-only) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/release-process.md b/docs/i18n/ja/release-process.md new file mode 100644 index 000000000..8653b4180 --- /dev/null +++ b/docs/i18n/ja/release-process.md @@ -0,0 +1,40 @@ +# ローカライズブリッジ: Release Process + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../release-process.md](../../release-process.md) + +## テーマ位置付け + +- 分類: エンジニアリング運用 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Release Goals](../../release-process.md#release-goals) +- [H2 · Standard Cadence](../../release-process.md#standard-cadence) +- [H2 · Workflow Contract](../../release-process.md#workflow-contract) +- [H2 · Maintainer Procedure](../../release-process.md#maintainer-procedure) +- [H3 · 1) Preflight on `main`](../../release-process.md#1-preflight-on-main) +- [H3 · 2) Run verification build (no publish)](../../release-process.md#2-run-verification-build-no-publish) +- [H3 · 3) Cut release tag](../../release-process.md#3-cut-release-tag) +- [H3 · 4) Monitor publish run](../../release-process.md#4-monitor-publish-run) +- [H3 · 5) Post-release validation](../../release-process.md#5-post-release-validation) +- [H3 · 6) Publish Homebrew Core formula (bot-owned)](../../release-process.md#6-publish-homebrew-core-formula-bot-owned) +- [H2 · Emergency / Recovery Path](../../release-process.md#emergency-recovery-path) +- [H2 · Operational Notes](../../release-process.md#operational-notes) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/resource-limits.md b/docs/i18n/ja/resource-limits.md new file mode 100644 index 000000000..8c7d1ec25 --- /dev/null +++ b/docs/i18n/ja/resource-limits.md @@ -0,0 +1,35 @@ +# ローカライズブリッジ: Resource Limits + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../resource-limits.md](../../resource-limits.md) + +## テーマ位置付け + +- 分類: セキュリティと統制 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Problem](../../resource-limits.md#problem) +- [H2 · Proposed Solutions](../../resource-limits.md#proposed-solutions) +- [H3 · Option 1: cgroups v2 (Linux, Recommended)](../../resource-limits.md#option-1-cgroups-v2-linux-recommended) +- [H3 · Option 2: tokio::task::deadlock detection](../../resource-limits.md#option-2-tokio-task-deadlock-detection) +- [H3 · Option 3: Memory monitoring](../../resource-limits.md#option-3-memory-monitoring) +- [H2 · Config Schema](../../resource-limits.md#config-schema) +- [H2 · Implementation Priority](../../resource-limits.md#implementation-priority) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/reviewer-playbook.md b/docs/i18n/ja/reviewer-playbook.md new file mode 100644 index 000000000..25facb138 --- /dev/null +++ b/docs/i18n/ja/reviewer-playbook.md @@ -0,0 +1,46 @@ +# ローカライズブリッジ: Reviewer Playbook + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../reviewer-playbook.md](../../reviewer-playbook.md) + +## テーマ位置付け + +- 分類: エンジニアリング運用 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · 0. Summary](../../reviewer-playbook.md#0-summary) +- [H2 · 1. Fast Path by Review Situation](../../reviewer-playbook.md#1-fast-path-by-review-situation) +- [H3 · 1.1 Intake fails in first 5 minutes](../../reviewer-playbook.md#1-1-intake-fails-in-first-5-minutes) +- [H3 · 1.2 Risk is high or unclear](../../reviewer-playbook.md#1-2-risk-is-high-or-unclear) +- [H3 · 1.3 Automation output is wrong/noisy](../../reviewer-playbook.md#1-3-automation-output-is-wrong-noisy) +- [H3 · 1.4 Need review handoff](../../reviewer-playbook.md#1-4-need-review-handoff) +- [H2 · 2. Review Depth Decision Matrix](../../reviewer-playbook.md#2-review-depth-decision-matrix) +- [H2 · 3. Standard Review Workflow](../../reviewer-playbook.md#3-standard-review-workflow) +- [H3 · 3.1 Five-minute intake triage](../../reviewer-playbook.md#3-1-five-minute-intake-triage) +- [H3 · 3.2 Fast-lane checklist (all PRs)](../../reviewer-playbook.md#3-2-fast-lane-checklist-all-prs) +- [H3 · 3.3 Deep review checklist (high risk)](../../reviewer-playbook.md#3-3-deep-review-checklist-high-risk) +- [H3 · 3.4 Review comment outcome style](../../reviewer-playbook.md#3-4-review-comment-outcome-style) +- [H2 · 4. Issue Triage and Backlog Governance](../../reviewer-playbook.md#4-issue-triage-and-backlog-governance) +- [H3 · 4.1 Issue triage label playbook](../../reviewer-playbook.md#4-1-issue-triage-label-playbook) +- [H3 · 4.2 PR backlog pruning protocol](../../reviewer-playbook.md#4-2-pr-backlog-pruning-protocol) +- [H2 · 5. Automation Override Protocol](../../reviewer-playbook.md#5-automation-override-protocol) +- [H2 · 6. Handoff Protocol](../../reviewer-playbook.md#6-handoff-protocol) +- [H2 · 7. Weekly Queue Hygiene](../../reviewer-playbook.md#7-weekly-queue-hygiene) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/sandboxing.md b/docs/i18n/ja/sandboxing.md new file mode 100644 index 000000000..dffcdab43 --- /dev/null +++ b/docs/i18n/ja/sandboxing.md @@ -0,0 +1,37 @@ +# ローカライズブリッジ: Sandboxing + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../sandboxing.md](../../sandboxing.md) + +## テーマ位置付け + +- 分類: セキュリティと統制 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Problem](../../sandboxing.md#problem) +- [H2 · Proposed Solutions](../../sandboxing.md#proposed-solutions) +- [H3 · Option 1: Firejail Integration (Recommended for Linux)](../../sandboxing.md#option-1-firejail-integration-recommended-for-linux) +- [H3 · Option 2: Bubblewrap (Portable, no root required)](../../sandboxing.md#option-2-bubblewrap-portable-no-root-required) +- [H3 · Option 3: Docker-in-Docker (Heavyweight but complete isolation)](../../sandboxing.md#option-3-docker-in-docker-heavyweight-but-complete-isolation) +- [H3 · Option 4: Landlock (Linux Kernel LSM, Rust native)](../../sandboxing.md#option-4-landlock-linux-kernel-lsm-rust-native) +- [H2 · Priority Implementation Order](../../sandboxing.md#priority-implementation-order) +- [H2 · Config Schema Extension](../../sandboxing.md#config-schema-extension) +- [H2 · Testing Strategy](../../sandboxing.md#testing-strategy) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/security-roadmap.md b/docs/i18n/ja/security-roadmap.md new file mode 100644 index 000000000..a69423508 --- /dev/null +++ b/docs/i18n/ja/security-roadmap.md @@ -0,0 +1,38 @@ +# ローカライズブリッジ: Security Roadmap + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../security-roadmap.md](../../security-roadmap.md) + +## テーマ位置付け + +- 分類: セキュリティと統制 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Current State: Strong Foundation](../../security-roadmap.md#current-state-strong-foundation) +- [H2 · What's Missing: OS-Level Containment](../../security-roadmap.md#what-s-missing-os-level-containment) +- [H2 · Comparison: ZeroClaw vs PicoClaw vs Production Grade](../../security-roadmap.md#comparison-zeroclaw-vs-picoclaw-vs-production-grade) +- [H2 · Implementation Roadmap](../../security-roadmap.md#implementation-roadmap) +- [H3 · Phase 1: Quick Wins (1-2 weeks)](../../security-roadmap.md#phase-1-quick-wins-1-2-weeks) +- [H3 · Phase 2: Platform Integration (2-3 weeks)](../../security-roadmap.md#phase-2-platform-integration-2-3-weeks) +- [H3 · Phase 3: Production Hardening (1-2 weeks)](../../security-roadmap.md#phase-3-production-hardening-1-2-weeks) +- [H2 · New Config Schema Preview](../../security-roadmap.md#new-config-schema-preview) +- [H2 · CLI Commands Preview](../../security-roadmap.md#cli-commands-preview) +- [H2 · Summary](../../security-roadmap.md#summary) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ja/troubleshooting.md b/docs/i18n/ja/troubleshooting.md new file mode 100644 index 000000000..7dc75760c --- /dev/null +++ b/docs/i18n/ja/troubleshooting.md @@ -0,0 +1,18 @@ +# トラブルシューティング(日本語) + +このページは Wave 1 の初版ローカライズです。よくある障害の切り分け入口です。 + +英語版原文: + +- [../../troubleshooting.md](../../troubleshooting.md) + +## 主な用途 + +- インストール失敗や起動不良の対応 +- `status`/`doctor` を使った段階的診断 +- 最小ロールバックと復旧確認 + +## 運用ルール + +- エラーコード・ログキー・コマンド名は英語のまま保持します。 +- 詳細な障害シグネチャは英語版原文を優先します。 diff --git a/docs/i18n/ja/zai-glm-setup.md b/docs/i18n/ja/zai-glm-setup.md new file mode 100644 index 000000000..61f8f408c --- /dev/null +++ b/docs/i18n/ja/zai-glm-setup.md @@ -0,0 +1,43 @@ +# ローカライズブリッジ: Zai Glm Setup + +このページは強化版ブリッジです。テーマの位置付け、原文セクション導線、実行時の注意点をまとめています。 + +英語版原文: + +- [../../zai-glm-setup.md](../../zai-glm-setup.md) + +## テーマ位置付け + +- 分類: Provider と統合 +- 深度: 強化ブリッジ(セクション導線 + 実行ヒント) +- 使い方: 構成を把握してから、英語版の規範記述に従って実施します。 + +## 原文セクションガイド + +- [H2 · Overview](../../zai-glm-setup.md#overview) +- [H2 · Setup](../../zai-glm-setup.md#setup) +- [H3 · Quick Start](../../zai-glm-setup.md#quick-start) +- [H3 · Manual Configuration](../../zai-glm-setup.md#manual-configuration) +- [H2 · Available Models](../../zai-glm-setup.md#available-models) +- [H2 · Verify Setup](../../zai-glm-setup.md#verify-setup) +- [H3 · Test with curl](../../zai-glm-setup.md#test-with-curl) +- [H3 · Test with ZeroClaw CLI](../../zai-glm-setup.md#test-with-zeroclaw-cli) +- [H2 · Environment Variables](../../zai-glm-setup.md#environment-variables) +- [H2 · Troubleshooting](../../zai-glm-setup.md#troubleshooting) +- [H3 · Rate Limiting](../../zai-glm-setup.md#rate-limiting) +- [H3 · Authentication Errors](../../zai-glm-setup.md#authentication-errors) +- [H3 · Model Not Found](../../zai-glm-setup.md#model-not-found) +- [H2 · Getting an API Key](../../zai-glm-setup.md#getting-an-api-key) +- [H2 · Related Documentation](../../zai-glm-setup.md#related-documentation) + +## 実行ヒント + +- まず原文の見出し構成を確認し、今回の変更範囲に直結する節から読みます。 +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します。 +- 仕様解釈に差分が出る場合は英語版原文を優先します。 + +## 関連エントリ + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/README.md b/docs/i18n/ru/README.md new file mode 100644 index 000000000..30cb6cf8f --- /dev/null +++ b/docs/i18n/ru/README.md @@ -0,0 +1,51 @@ +# Документация ZeroClaw (Русский) + +Этот файл — русскоязычный хаб в канонической структуре `docs/i18n//`. + +Последняя синхронизация: **2026-02-24**. + +> Примечание: команды, ключи конфигурации и API-пути сохраняются на английском. + +## Быстрые ссылки + +- Русский root README: [../../../README.ru.md](../../../README.ru.md) +- Русский docs hub (совместимость): [../../README.ru.md](../../README.ru.md) +- Русский SUMMARY (совместимость): [../../SUMMARY.ru.md](../../SUMMARY.ru.md) +- English docs hub: [../../README.md](../../README.md) + +## Документы Wave 1 (рантайм) + +- Справочник команд: [commands-reference.md](commands-reference.md) +- Справочник провайдеров: [providers-reference.md](providers-reference.md) +- Справочник каналов: [channels-reference.md](channels-reference.md) +- Справочник конфигурации: [config-reference.md](config-reference.md) +- Операционный runbook: [operations-runbook.md](operations-runbook.md) +- Troubleshooting: [troubleshooting.md](troubleshooting.md) + +Текущее состояние: **top-level parity закрыт** (40/40). + +## Полный индекс и governance + +- Локальный каталог документов: [docs-inventory.md](docs-inventory.md) +- Руководство i18n: [i18n-guide.md](i18n-guide.md) +- Покрытие i18n: [i18n-coverage.md](i18n-coverage.md) +- Трекинг gap: [i18n-gap-backlog.md](i18n-gap-backlog.md) + +## Категории + +- Начало работы: [../../getting-started/README.md](../../getting-started/README.md) +- Справочники: [../../reference/README.md](../../reference/README.md) +- Операции и деплой: [../../operations/README.md](../../operations/README.md) +- Безопасность: [../../security/README.md](../../security/README.md) +- Аппаратная часть: [../../hardware/README.md](../../hardware/README.md) +- Вклад и CI: [../../contributing/README.md](../../contributing/README.md) +- Единый TOC: [SUMMARY.md](SUMMARY.md) + +## Другие языки + +- English: [../../README.md](../../README.md) +- 简体中文: [../zh-CN/README.md](../zh-CN/README.md) +- 日本語: [../ja/README.md](../ja/README.md) +- Français: [../fr/README.md](../fr/README.md) +- Tiếng Việt: [../vi/README.md](../vi/README.md) +- Ελληνικά: [../el/README.md](../el/README.md) diff --git a/docs/i18n/ru/SUMMARY.md b/docs/i18n/ru/SUMMARY.md new file mode 100644 index 000000000..2d370b35a --- /dev/null +++ b/docs/i18n/ru/SUMMARY.md @@ -0,0 +1,38 @@ +# Содержание документации ZeroClaw (Русский, i18n) + +Этот файл — навигационный индекс для `docs/i18n/ru/`. + +Последнее обновление: **2026-02-24**. + +## Точки входа + +- Русский i18n Hub: [README.md](README.md) +- Русский совместимый Hub: [../../README.ru.md](../../README.ru.md) +- Русский совместимый SUMMARY: [../../SUMMARY.ru.md](../../SUMMARY.ru.md) +- Индекс i18n: [../README.md](../README.md) +- Карта покрытия i18n: [../../i18n-coverage.md](../../i18n-coverage.md) + +## Разделы + +- Начало: [../../getting-started/README.md](../../getting-started/README.md) +- Справочники: [../../reference/README.md](../../reference/README.md) +- Операции: [../../operations/README.md](../../operations/README.md) +- Безопасность: [../../security/README.md](../../security/README.md) +- Аппаратная часть: [../../hardware/README.md](../../hardware/README.md) +- Вклад и CI: [../../contributing/README.md](../../contributing/README.md) + +## Документы Wave 1 (рантайм) + +- Справочник команд: [commands-reference.md](commands-reference.md) +- Справочник провайдеров: [providers-reference.md](providers-reference.md) +- Справочник каналов: [channels-reference.md](channels-reference.md) +- Справочник конфигурации: [config-reference.md](config-reference.md) +- Операционный runbook: [operations-runbook.md](operations-runbook.md) +- Troubleshooting: [troubleshooting.md](troubleshooting.md) + +## Governance и индекс + +- Каталог документов: [docs-inventory.md](docs-inventory.md) +- Гайд i18n: [i18n-guide.md](i18n-guide.md) +- Покрытие: [i18n-coverage.md](i18n-coverage.md) +- Трекинг gap: [i18n-gap-backlog.md](i18n-gap-backlog.md) diff --git a/docs/i18n/ru/actions-source-policy.md b/docs/i18n/ru/actions-source-policy.md new file mode 100644 index 000000000..5cb74e442 --- /dev/null +++ b/docs/i18n/ru/actions-source-policy.md @@ -0,0 +1,34 @@ +# Локализованный bridge: Actions Source Policy + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../actions-source-policy.md](../../actions-source-policy.md) + +## Позиционирование темы + +- Категория: Безопасность и управление +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Current Policy](../../actions-source-policy.md#current-policy) +- [H2 · Change Control Export](../../actions-source-policy.md#change-control-export) +- [H2 · Why This Phase](../../actions-source-policy.md#why-this-phase) +- [H2 · Agentic Workflow Guardrails](../../actions-source-policy.md#agentic-workflow-guardrails) +- [H2 · Validation Checklist](../../actions-source-policy.md#validation-checklist) +- [H2 · Rollback](../../actions-source-policy.md#rollback) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/adding-boards-and-tools.md b/docs/i18n/ru/adding-boards-and-tools.md new file mode 100644 index 000000000..65d48e073 --- /dev/null +++ b/docs/i18n/ru/adding-boards-and-tools.md @@ -0,0 +1,40 @@ +# Локализованный bridge: Adding Boards And Tools + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../adding-boards-and-tools.md](../../adding-boards-and-tools.md) + +## Позиционирование темы + +- Категория: Hardware и периферия +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Quick Start: Add a Board via CLI](../../adding-boards-and-tools.md#quick-start-add-a-board-via-cli) +- [H2 · Supported Boards](../../adding-boards-and-tools.md#supported-boards) +- [H2 · Manual Config](../../adding-boards-and-tools.md#manual-config) +- [H2 · Adding a Datasheet (RAG)](../../adding-boards-and-tools.md#adding-a-datasheet-rag) +- [H3 · Pin Aliases (Recommended)](../../adding-boards-and-tools.md#pin-aliases-recommended) +- [H2 · Pin Aliases](../../adding-boards-and-tools.md#pin-aliases) +- [H2 · Pin Aliases](../../adding-boards-and-tools.md#pin-aliases) +- [H3 · PDF Datasheets](../../adding-boards-and-tools.md#pdf-datasheets) +- [H2 · Adding a New Board Type](../../adding-boards-and-tools.md#adding-a-new-board-type) +- [H2 · Adding a Custom Tool](../../adding-boards-and-tools.md#adding-a-custom-tool) +- [H2 · CLI Reference](../../adding-boards-and-tools.md#cli-reference) +- [H2 · Troubleshooting](../../adding-boards-and-tools.md#troubleshooting) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/agnostic-security.md b/docs/i18n/ru/agnostic-security.md new file mode 100644 index 000000000..40e5cf2d5 --- /dev/null +++ b/docs/i18n/ru/agnostic-security.md @@ -0,0 +1,46 @@ +# Локализованный bridge: Agnostic Security + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../agnostic-security.md](../../agnostic-security.md) + +## Позиционирование темы + +- Категория: Безопасность и управление +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Core Question: Will security features break...](../../agnostic-security.md#core-question-will-security-features-break) +- [H2 · 1. Build Speed: Feature-Gated Security](../../agnostic-security.md#1-build-speed-feature-gated-security) +- [H3 · Cargo.toml: Security Features Behind Features](../../agnostic-security.md#cargo-toml-security-features-behind-features) +- [H3 · Build Commands (Choose Your Profile)](../../agnostic-security.md#build-commands-choose-your-profile) +- [H3 · Conditional Compilation: Zero Overhead When Disabled](../../agnostic-security.md#conditional-compilation-zero-overhead-when-disabled) +- [H2 · 2. Pluggable Architecture: Security Is a Trait Too](../../agnostic-security.md#2-pluggable-architecture-security-is-a-trait-too) +- [H3 · Security Backend Trait (Swappable Like Everything Else)](../../agnostic-security.md#security-backend-trait-swappable-like-everything-else) +- [H3 · Factory Pattern: Auto-Select Based on Features](../../agnostic-security.md#factory-pattern-auto-select-based-on-features) +- [H2 · 3. Hardware Agnosticism: Same Binary, Different Platforms](../../agnostic-security.md#3-hardware-agnosticism-same-binary-different-platforms) +- [H3 · Cross-Platform Behavior Matrix](../../agnostic-security.md#cross-platform-behavior-matrix) +- [H3 · How It Works: Runtime Detection](../../agnostic-security.md#how-it-works-runtime-detection) +- [H2 · 4. Small Hardware: Memory Impact Analysis](../../agnostic-security.md#4-small-hardware-memory-impact-analysis) +- [H3 · Binary Size Impact (Estimated)](../../agnostic-security.md#binary-size-impact-estimated) +- [H3 · $10 Hardware Compatibility](../../agnostic-security.md#10-hardware-compatibility) +- [H2 · 5. Agnostic Swaps: Everything Remains Pluggable](../../agnostic-security.md#5-agnostic-swaps-everything-remains-pluggable) +- [H3 · ZeroClaw's Core Promise: Swap Anything](../../agnostic-security.md#zeroclaw-s-core-promise-swap-anything) +- [H3 · Swap Security Backends via Config](../../agnostic-security.md#swap-security-backends-via-config) +- [H2 · 6. Dependency Impact: Minimal New Deps](../../agnostic-security.md#6-dependency-impact-minimal-new-deps) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/android-setup.md b/docs/i18n/ru/android-setup.md new file mode 100644 index 000000000..0b7a3e958 --- /dev/null +++ b/docs/i18n/ru/android-setup.md @@ -0,0 +1,40 @@ +# Локализованный bridge: Android Setup + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../android-setup.md](../../android-setup.md) + +## Позиционирование темы + +- Категория: Hardware и периферия +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Supported Architectures](../../android-setup.md#supported-architectures) +- [H2 · Installation via Termux](../../android-setup.md#installation-via-termux) +- [H3 · 1. Install Termux](../../android-setup.md#1-install-termux) +- [H3 · 2. Download ZeroClaw](../../android-setup.md#2-download-zeroclaw) +- [H3 · 3. Install and Run](../../android-setup.md#3-install-and-run) +- [H2 · Direct Installation via ADB](../../android-setup.md#direct-installation-via-adb) +- [H2 · Limitations on Android](../../android-setup.md#limitations-on-android) +- [H2 · Building from Source](../../android-setup.md#building-from-source) +- [H2 · Troubleshooting](../../android-setup.md#troubleshooting) +- [H3 · "Permission denied"](../../android-setup.md#permission-denied) +- [H3 · "not found" or linker errors](../../android-setup.md#not-found-or-linker-errors) +- [H3 · Old Android (4.x)](../../android-setup.md#old-android-4-x) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/arduino-uno-q-setup.md b/docs/i18n/ru/arduino-uno-q-setup.md new file mode 100644 index 000000000..12134296b --- /dev/null +++ b/docs/i18n/ru/arduino-uno-q-setup.md @@ -0,0 +1,46 @@ +# Локализованный bridge: Arduino Uno Q Setup + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../arduino-uno-q-setup.md](../../arduino-uno-q-setup.md) + +## Позиционирование темы + +- Категория: Hardware и периферия +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · What's Included (No Code Changes Needed)](../../arduino-uno-q-setup.md#what-s-included-no-code-changes-needed) +- [H2 · Prerequisites](../../arduino-uno-q-setup.md#prerequisites) +- [H2 · Phase 1: Initial Uno Q Setup (One-Time)](../../arduino-uno-q-setup.md#phase-1-initial-uno-q-setup-one-time) +- [H3 · 1.1 Configure Uno Q via App Lab](../../arduino-uno-q-setup.md#1-1-configure-uno-q-via-app-lab) +- [H3 · 1.2 Verify SSH Access](../../arduino-uno-q-setup.md#1-2-verify-ssh-access) +- [H2 · Phase 2: Install ZeroClaw on Uno Q](../../arduino-uno-q-setup.md#phase-2-install-zeroclaw-on-uno-q) +- [H3 · Option A: Build on the Device (Simpler, ~20–40 min)](../../arduino-uno-q-setup.md#option-a-build-on-the-device-simpler-20-40-min) +- [H3 · Option B: Cross-Compile on Mac (Faster)](../../arduino-uno-q-setup.md#option-b-cross-compile-on-mac-faster) +- [H2 · Phase 3: Configure ZeroClaw](../../arduino-uno-q-setup.md#phase-3-configure-zeroclaw) +- [H3 · 3.1 Run Onboard (or Create Config Manually)](../../arduino-uno-q-setup.md#3-1-run-onboard-or-create-config-manually) +- [H3 · 3.2 Minimal config.toml](../../arduino-uno-q-setup.md#3-2-minimal-config-toml) +- [H2 · Phase 4: Run ZeroClaw Daemon](../../arduino-uno-q-setup.md#phase-4-run-zeroclaw-daemon) +- [H2 · Phase 5: GPIO via Bridge (ZeroClaw Handles It)](../../arduino-uno-q-setup.md#phase-5-gpio-via-bridge-zeroclaw-handles-it) +- [H3 · 5.1 Deploy Bridge App](../../arduino-uno-q-setup.md#5-1-deploy-bridge-app) +- [H3 · 5.2 Add to config.toml](../../arduino-uno-q-setup.md#5-2-add-to-config-toml) +- [H3 · 5.3 Run ZeroClaw](../../arduino-uno-q-setup.md#5-3-run-zeroclaw) +- [H2 · Summary: Commands Start to End](../../arduino-uno-q-setup.md#summary-commands-start-to-end) +- [H2 · Troubleshooting](../../arduino-uno-q-setup.md#troubleshooting) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/audit-event-schema.md b/docs/i18n/ru/audit-event-schema.md new file mode 100644 index 000000000..04d6a20ed --- /dev/null +++ b/docs/i18n/ru/audit-event-schema.md @@ -0,0 +1,32 @@ +# Локализованный bridge: Audit Event Schema + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../audit-event-schema.md](../../audit-event-schema.md) + +## Позиционирование темы + +- Категория: Безопасность и управление +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Envelope](../../audit-event-schema.md#envelope) +- [H2 · Event Types](../../audit-event-schema.md#event-types) +- [H2 · Retention Policy](../../audit-event-schema.md#retention-policy) +- [H2 · Governance](../../audit-event-schema.md#governance) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/audit-logging.md b/docs/i18n/ru/audit-logging.md new file mode 100644 index 000000000..6981da46d --- /dev/null +++ b/docs/i18n/ru/audit-logging.md @@ -0,0 +1,35 @@ +# Локализованный bridge: Audit Logging + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../audit-logging.md](../../audit-logging.md) + +## Позиционирование темы + +- Категория: Безопасность и управление +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Problem](../../audit-logging.md#problem) +- [H2 · Proposed Audit Log Format](../../audit-logging.md#proposed-audit-log-format) +- [H2 · Implementation](../../audit-logging.md#implementation) +- [H2 · Config Schema](../../audit-logging.md#config-schema) +- [H2 · Audit Query CLI](../../audit-logging.md#audit-query-cli) +- [H2 · Log Rotation](../../audit-logging.md#log-rotation) +- [H2 · Implementation Priority](../../audit-logging.md#implementation-priority) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/cargo-slicer-speedup.md b/docs/i18n/ru/cargo-slicer-speedup.md new file mode 100644 index 000000000..79baa6420 --- /dev/null +++ b/docs/i18n/ru/cargo-slicer-speedup.md @@ -0,0 +1,32 @@ +# Локализованный bridge: Cargo Slicer Speedup + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../cargo-slicer-speedup.md](../../cargo-slicer-speedup.md) + +## Позиционирование темы + +- Категория: Инженерные процессы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Benchmark Results](../../cargo-slicer-speedup.md#benchmark-results) +- [H2 · CI Integration](../../cargo-slicer-speedup.md#ci-integration) +- [H2 · Local Usage](../../cargo-slicer-speedup.md#local-usage) +- [H2 · How It Works](../../cargo-slicer-speedup.md#how-it-works) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/channels-reference.md b/docs/i18n/ru/channels-reference.md new file mode 100644 index 000000000..c1be83754 --- /dev/null +++ b/docs/i18n/ru/channels-reference.md @@ -0,0 +1,18 @@ +# Справочник каналов (Русский) + +Это первичная локализация Wave 1 для обзора возможностей каналов и путей настройки. + +Оригинал на английском: + +- [../../channels-reference.md](../../channels-reference.md) + +## Когда использовать + +- Сравнение возможностей Telegram/Discord/Slack и других каналов +- Проверка allowlist и границ безопасности +- Разбор проблем доставки/приема сообщений + +## Правило + +- Идентификаторы каналов, API-пути и config keys остаются на английском. +- Источник истины по поведению — английский оригинал. diff --git a/docs/i18n/ru/ci-map.md b/docs/i18n/ru/ci-map.md new file mode 100644 index 000000000..9ff215d46 --- /dev/null +++ b/docs/i18n/ru/ci-map.md @@ -0,0 +1,36 @@ +# Локализованный bridge: Ci Map + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../ci-map.md](../../ci-map.md) + +## Позиционирование темы + +- Категория: Инженерные процессы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Merge-Blocking vs Optional](../../ci-map.md#merge-blocking-vs-optional) +- [H3 · Merge-Blocking](../../ci-map.md#merge-blocking) +- [H3 · Non-Blocking but Important](../../ci-map.md#non-blocking-but-important) +- [H3 · Optional Repository Automation](../../ci-map.md#optional-repository-automation) +- [H2 · Trigger Map](../../ci-map.md#trigger-map) +- [H2 · Fast Triage Guide](../../ci-map.md#fast-triage-guide) +- [H2 · Maintenance Rules](../../ci-map.md#maintenance-rules) +- [H2 · Automation Side-Effect Controls](../../ci-map.md#automation-side-effect-controls) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/commands-reference.md b/docs/i18n/ru/commands-reference.md new file mode 100644 index 000000000..1c092a217 --- /dev/null +++ b/docs/i18n/ru/commands-reference.md @@ -0,0 +1,18 @@ +# Справочник команд (Русский) + +Это первичная локализация Wave 1 для быстрого поиска CLI-команд ZeroClaw. + +Оригинал на английском: + +- [../../commands-reference.md](../../commands-reference.md) + +## Когда использовать + +- Поиск команд по типовой задаче +- Проверка флагов и границ поведения +- Сверка ожидаемого результата при отладке + +## Правило + +- Имена команд, флагов и ключей конфигурации сохраняются на английском. +- Финальная спецификация поведения — в английском оригинале. diff --git a/docs/i18n/ru/config-reference.md b/docs/i18n/ru/config-reference.md new file mode 100644 index 000000000..795f400d7 --- /dev/null +++ b/docs/i18n/ru/config-reference.md @@ -0,0 +1,18 @@ +# Справочник конфигурации (Русский) + +Это первичная локализация Wave 1 для работы с ключами конфигурации и безопасными дефолтами. + +Оригинал на английском: + +- [../../config-reference.md](../../config-reference.md) + +## Когда использовать + +- Первичная настройка окружения +- Проверка конфликтов конфигурации +- Аудит параметров, влияющих на безопасность и стабильность + +## Правило + +- Названия config keys не переводятся. +- Точное runtime-поведение определяется английским оригиналом. diff --git a/docs/i18n/ru/custom-providers.md b/docs/i18n/ru/custom-providers.md new file mode 100644 index 000000000..05509faa3 --- /dev/null +++ b/docs/i18n/ru/custom-providers.md @@ -0,0 +1,46 @@ +# Локализованный bridge: Custom Providers + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../custom-providers.md](../../custom-providers.md) + +## Позиционирование темы + +- Категория: Провайдеры и интеграции +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Provider Types](../../custom-providers.md#provider-types) +- [H3 · OpenAI-Compatible Endpoints (`custom:`)](../../custom-providers.md#openai-compatible-endpoints-custom) +- [H3 · Anthropic-Compatible Endpoints (`anthropic-custom:`)](../../custom-providers.md#anthropic-compatible-endpoints-anthropic-custom) +- [H2 · Configuration Methods](../../custom-providers.md#configuration-methods) +- [H3 · Config File](../../custom-providers.md#config-file) +- [H3 · Environment Variables](../../custom-providers.md#environment-variables) +- [H2 · llama.cpp Server (Recommended Local Setup)](../../custom-providers.md#llama-cpp-server-recommended-local-setup) +- [H2 · SGLang Server](../../custom-providers.md#sglang-server) +- [H2 · vLLM Server](../../custom-providers.md#vllm-server) +- [H2 · Testing Configuration](../../custom-providers.md#testing-configuration) +- [H2 · Troubleshooting](../../custom-providers.md#troubleshooting) +- [H3 · Authentication Errors](../../custom-providers.md#authentication-errors) +- [H3 · Model Not Found](../../custom-providers.md#model-not-found) +- [H3 · Connection Issues](../../custom-providers.md#connection-issues) +- [H2 · Examples](../../custom-providers.md#examples) +- [H3 · Local LLM Server (Generic Custom Endpoint)](../../custom-providers.md#local-llm-server-generic-custom-endpoint) +- [H3 · Corporate Proxy](../../custom-providers.md#corporate-proxy) +- [H3 · Cloud Provider Gateway](../../custom-providers.md#cloud-provider-gateway) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/doc-template.md b/docs/i18n/ru/doc-template.md new file mode 100644 index 000000000..fc5f45f0a --- /dev/null +++ b/docs/i18n/ru/doc-template.md @@ -0,0 +1,38 @@ +# Локализованный bridge: Doc Template + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../doc-template.md](../../doc-template.md) + +## Позиционирование темы + +- Категория: Инженерные процессы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · 1. Summary](../../doc-template.md#1-summary) +- [H2 · 2. Prerequisites](../../doc-template.md#2-prerequisites) +- [H2 · 3. Procedure](../../doc-template.md#3-procedure) +- [H3 · 3.1 Baseline Check](../../doc-template.md#3-1-baseline-check) +- [H3 · 3.2 Main Workflow](../../doc-template.md#3-2-main-workflow) +- [H3 · 3.3 Verification](../../doc-template.md#3-3-verification) +- [H2 · 4. Safety, Risk, and Rollback](../../doc-template.md#4-safety-risk-and-rollback) +- [H2 · 5. Troubleshooting](../../doc-template.md#5-troubleshooting) +- [H2 · 6. Related Docs](../../doc-template.md#6-related-docs) +- [H2 · 7. Maintenance Notes](../../doc-template.md#7-maintenance-notes) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/docs-audit-2026-02-24.md b/docs/i18n/ru/docs-audit-2026-02-24.md new file mode 100644 index 000000000..283a75400 --- /dev/null +++ b/docs/i18n/ru/docs-audit-2026-02-24.md @@ -0,0 +1,42 @@ +# Локализованный bridge: Docs Audit 2026 02 24 + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../docs-audit-2026-02-24.md](../../docs-audit-2026-02-24.md) + +## Позиционирование темы + +- Категория: Инженерные процессы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · 1) Audit Method](../../docs-audit-2026-02-24.md#1-audit-method) +- [H2 · 2) Findings](../../docs-audit-2026-02-24.md#2-findings) +- [H3 · A. Structural clarity gaps](../../docs-audit-2026-02-24.md#a-structural-clarity-gaps) +- [H3 · B. Completeness gaps](../../docs-audit-2026-02-24.md#b-completeness-gaps) +- [H3 · C. Integrity issues](../../docs-audit-2026-02-24.md#c-integrity-issues) +- [H2 · 3) Remediation Applied](../../docs-audit-2026-02-24.md#3-remediation-applied) +- [H3 · 3.1 Navigation and governance](../../docs-audit-2026-02-24.md#3-1-navigation-and-governance) +- [H3 · 3.2 Directory completeness](../../docs-audit-2026-02-24.md#3-2-directory-completeness) +- [H3 · 3.3 Compatibility cleanup](../../docs-audit-2026-02-24.md#3-3-compatibility-cleanup) +- [H3 · 3.4 Broken link fixes](../../docs-audit-2026-02-24.md#3-4-broken-link-fixes) +- [H2 · 4) Current Known Remaining Gaps](../../docs-audit-2026-02-24.md#4-current-known-remaining-gaps) +- [H2 · 5) Recommended Next Wave](../../docs-audit-2026-02-24.md#5-recommended-next-wave) +- [H2 · 6) Validation Status](../../docs-audit-2026-02-24.md#6-validation-status) +- [H2 · Addendum (Phase-2 Deep Completion)](../../docs-audit-2026-02-24.md#addendum-phase-2-deep-completion) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/docs-inventory.md b/docs/i18n/ru/docs-inventory.md new file mode 100644 index 000000000..7bf464d5c --- /dev/null +++ b/docs/i18n/ru/docs-inventory.md @@ -0,0 +1,74 @@ +# Каталог документации (Русский) + +Эта страница — быстрый индекс top-level документов в `docs/i18n/ru/`. + +Последнее обновление: **2026-02-24**. +Состояние: **top-level parity закрыт (40/40)**. + +## Нормативные источники + +- Английский каталог: [../../docs-inventory.md](../../docs-inventory.md) +- Гайд i18n: [i18n-guide.md](i18n-guide.md) +- Покрытие i18n: [i18n-coverage.md](i18n-coverage.md) + +## Runtime и каналы + +- [commands-reference.md](commands-reference.md) +- [config-reference.md](config-reference.md) +- [providers-reference.md](providers-reference.md) +- [channels-reference.md](channels-reference.md) +- [operations-runbook.md](operations-runbook.md) +- [troubleshooting.md](troubleshooting.md) +- [one-click-bootstrap.md](one-click-bootstrap.md) +- [network-deployment.md](network-deployment.md) +- [mattermost-setup.md](mattermost-setup.md) +- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) +- [matrix-e2ee-guide.md](matrix-e2ee-guide.md) + +## Провайдеры и интеграции + +- [custom-providers.md](custom-providers.md) +- [zai-glm-setup.md](zai-glm-setup.md) +- [langgraph-integration.md](langgraph-integration.md) +- [proxy-agent-playbook.md](proxy-agent-playbook.md) + +## Hardware и периферия + +- [hardware-peripherals-design.md](hardware-peripherals-design.md) +- [adding-boards-and-tools.md](adding-boards-and-tools.md) +- [android-setup.md](android-setup.md) +- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) +- [nucleo-setup.md](nucleo-setup.md) + +## Безопасность и управление + +- [agnostic-security.md](agnostic-security.md) +- [frictionless-security.md](frictionless-security.md) +- [audit-logging.md](audit-logging.md) +- [audit-event-schema.md](audit-event-schema.md) +- [sandboxing.md](sandboxing.md) +- [resource-limits.md](resource-limits.md) +- [security-roadmap.md](security-roadmap.md) +- [actions-source-policy.md](actions-source-policy.md) + +## Инженерные процессы + +- [pr-workflow.md](pr-workflow.md) +- [reviewer-playbook.md](reviewer-playbook.md) +- [ci-map.md](ci-map.md) +- [release-process.md](release-process.md) +- [cargo-slicer-speedup.md](cargo-slicer-speedup.md) +- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) +- [docs-audit-2026-02-24.md](docs-audit-2026-02-24.md) +- [doc-template.md](doc-template.md) + +## i18n Governance + +- [i18n-guide.md](i18n-guide.md) +- [i18n-coverage.md](i18n-coverage.md) +- [i18n-gap-backlog.md](i18n-gap-backlog.md) + +## Правила локализации + +- Имена команд, ключей конфигурации, API-пути и code identifiers остаются на английском. +- Финальная спецификация поведения определяется английским оригиналом. diff --git a/docs/i18n/ru/frictionless-security.md b/docs/i18n/ru/frictionless-security.md new file mode 100644 index 000000000..385dc5175 --- /dev/null +++ b/docs/i18n/ru/frictionless-security.md @@ -0,0 +1,43 @@ +# Локализованный bridge: Frictionless Security + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../frictionless-security.md](../../frictionless-security.md) + +## Позиционирование темы + +- Категория: Безопасность и управление +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Core Principle](../../frictionless-security.md#core-principle) +- [H2 · Design: Silent Auto-Detection](../../frictionless-security.md#design-silent-auto-detection) +- [H3 · 1. No New Wizard Steps (Stays 9 Steps, < 60 Seconds)](../../frictionless-security.md#1-no-new-wizard-steps-stays-9-steps-60-seconds) +- [H3 · 2. Auto-Detection Logic (Runs Once at First Start)](../../frictionless-security.md#2-auto-detection-logic-runs-once-at-first-start) +- [H3 · 3. First Run: Silent Logging](../../frictionless-security.md#3-first-run-silent-logging) +- [H3 · 4. Config File: All Defaults Hidden](../../frictionless-security.md#4-config-file-all-defaults-hidden) +- [H3 · 5. Advanced Users: Explicit Control](../../frictionless-security.md#5-advanced-users-explicit-control) +- [H3 · 6. Graceful Degradation](../../frictionless-security.md#6-graceful-degradation) +- [H2 · Config Schema Extension](../../frictionless-security.md#config-schema-extension) +- [H2 · User Experience Comparison](../../frictionless-security.md#user-experience-comparison) +- [H3 · Before (Current)](../../frictionless-security.md#before-current) +- [H3 · After (With Frictionless Security)](../../frictionless-security.md#after-with-frictionless-security) +- [H3 · Advanced User (Explicit Control)](../../frictionless-security.md#advanced-user-explicit-control) +- [H2 · Backward Compatibility](../../frictionless-security.md#backward-compatibility) +- [H2 · Summary](../../frictionless-security.md#summary) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/hardware-peripherals-design.md b/docs/i18n/ru/hardware-peripherals-design.md new file mode 100644 index 000000000..afbb31bc8 --- /dev/null +++ b/docs/i18n/ru/hardware-peripherals-design.md @@ -0,0 +1,46 @@ +# Локализованный bridge: Hardware Peripherals Design + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../hardware-peripherals-design.md](../../hardware-peripherals-design.md) + +## Позиционирование темы + +- Категория: Hardware и периферия +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · 1. Vision](../../hardware-peripherals-design.md#1-vision) +- [H2 · 2. Two Modes of Operation](../../hardware-peripherals-design.md#2-two-modes-of-operation) +- [H3 · Mode 1: Edge-Native (Standalone)](../../hardware-peripherals-design.md#mode-1-edge-native-standalone) +- [H3 · Mode 2: Host-Mediated (Development / Debugging)](../../hardware-peripherals-design.md#mode-2-host-mediated-development-debugging) +- [H3 · Mode Comparison](../../hardware-peripherals-design.md#mode-comparison) +- [H2 · 3. Legacy / Simpler Modes (Pre-LLM-on-Edge)](../../hardware-peripherals-design.md#3-legacy-simpler-modes-pre-llm-on-edge) +- [H3 · Mode A: Host + Remote Peripheral (STM32 via serial)](../../hardware-peripherals-design.md#mode-a-host-remote-peripheral-stm32-via-serial) +- [H3 · Mode B: RPi as Host (Native GPIO)](../../hardware-peripherals-design.md#mode-b-rpi-as-host-native-gpio) +- [H2 · 4. Technical Requirements](../../hardware-peripherals-design.md#4-technical-requirements) +- [H3 · RAG Pipeline (Datasheet Retrieval)](../../hardware-peripherals-design.md#rag-pipeline-datasheet-retrieval) +- [H3 · Dynamic Execution Options](../../hardware-peripherals-design.md#dynamic-execution-options) +- [H2 · 5. CLI and Config](../../hardware-peripherals-design.md#5-cli-and-config) +- [H3 · CLI Flags](../../hardware-peripherals-design.md#cli-flags) +- [H3 · Config (config.toml)](../../hardware-peripherals-design.md#config-config-toml) +- [H2 · 6. Architecture: Peripheral as Extension Point](../../hardware-peripherals-design.md#6-architecture-peripheral-as-extension-point) +- [H3 · New Trait: `Peripheral`](../../hardware-peripherals-design.md#new-trait-peripheral) +- [H3 · Flow](../../hardware-peripherals-design.md#flow) +- [H3 · Board Support](../../hardware-peripherals-design.md#board-support) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/i18n-coverage.md b/docs/i18n/ru/i18n-coverage.md new file mode 100644 index 000000000..3271deac7 --- /dev/null +++ b/docs/i18n/ru/i18n-coverage.md @@ -0,0 +1,36 @@ +# Локализованный bridge: I18n Coverage + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../i18n-coverage.md](../../i18n-coverage.md) + +## Позиционирование темы + +- Категория: i18n Governance +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Canonical Layout](../../i18n-coverage.md#canonical-layout) +- [H2 · Locale Coverage Matrix](../../i18n-coverage.md#locale-coverage-matrix) +- [H2 · Top-Level Parity Snapshot](../../i18n-coverage.md#top-level-parity-snapshot) +- [H2 · Root README Completeness](../../i18n-coverage.md#root-readme-completeness) +- [H2 · Collection Index i18n](../../i18n-coverage.md#collection-index-i18n) +- [H2 · Localization Rules](../../i18n-coverage.md#localization-rules) +- [H2 · Adding a New Locale](../../i18n-coverage.md#adding-a-new-locale) +- [H2 · Review Checklist](../../i18n-coverage.md#review-checklist) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/i18n-gap-backlog.md b/docs/i18n/ru/i18n-gap-backlog.md new file mode 100644 index 000000000..c0f7d5d7e --- /dev/null +++ b/docs/i18n/ru/i18n-gap-backlog.md @@ -0,0 +1,34 @@ +# Локализованный bridge: I18n Gap Backlog + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../i18n-gap-backlog.md](../../i18n-gap-backlog.md) + +## Позиционирование темы + +- Категория: i18n Governance +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Baseline Definition](../../i18n-gap-backlog.md#baseline-definition) +- [H2 · Current Gap Counts](../../i18n-gap-backlog.md#current-gap-counts) +- [H2 · Closure Record (2026-02-24)](../../i18n-gap-backlog.md#closure-record-2026-02-24) +- [H2 · Remaining Gaps (Baseline Scope)](../../i18n-gap-backlog.md#remaining-gaps-baseline-scope) +- [H2 · Optional Next Depth](../../i18n-gap-backlog.md#optional-next-depth) +- [H2 · Tracking Rules](../../i18n-gap-backlog.md#tracking-rules) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/i18n-guide.md b/docs/i18n/ru/i18n-guide.md new file mode 100644 index 000000000..772d187d0 --- /dev/null +++ b/docs/i18n/ru/i18n-guide.md @@ -0,0 +1,36 @@ +# Локализованный bridge: I18n Guide + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../i18n-guide.md](../../i18n-guide.md) + +## Позиционирование темы + +- Категория: i18n Governance +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Scope](../../i18n-guide.md#scope) +- [H2 · Canonical Layout](../../i18n-guide.md#canonical-layout) +- [H2 · Trigger Matrix](../../i18n-guide.md#trigger-matrix) +- [H2 · Completion Checklist (Mandatory)](../../i18n-guide.md#completion-checklist-mandatory) +- [H2 · Deferred Translation Policy](../../i18n-guide.md#deferred-translation-policy) +- [H2 · Agent Workflow Contract](../../i18n-guide.md#agent-workflow-contract) +- [H2 · Gap Tracking](../../i18n-guide.md#gap-tracking) +- [H2 · Quick Validation Commands](../../i18n-guide.md#quick-validation-commands) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/langgraph-integration.md b/docs/i18n/ru/langgraph-integration.md new file mode 100644 index 000000000..54816d918 --- /dev/null +++ b/docs/i18n/ru/langgraph-integration.md @@ -0,0 +1,46 @@ +# Локализованный bridge: Langgraph Integration + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../langgraph-integration.md](../../langgraph-integration.md) + +## Позиционирование темы + +- Категория: Провайдеры и интеграции +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Background](../../langgraph-integration.md#background) +- [H2 · Architecture](../../langgraph-integration.md#architecture) +- [H2 · Quick Start](../../langgraph-integration.md#quick-start) +- [H3 · Installation](../../langgraph-integration.md#installation) +- [H3 · Basic Usage](../../langgraph-integration.md#basic-usage) +- [H2 · Available Tools](../../langgraph-integration.md#available-tools) +- [H3 · Core Tools](../../langgraph-integration.md#core-tools) +- [H3 · Extended Tools](../../langgraph-integration.md#extended-tools) +- [H2 · Custom Tools](../../langgraph-integration.md#custom-tools) +- [H2 · Provider Configuration](../../langgraph-integration.md#provider-configuration) +- [H3 · Z.AI / GLM-5](../../langgraph-integration.md#z-ai-glm-5) +- [H3 · OpenRouter](../../langgraph-integration.md#openrouter) +- [H3 · Groq](../../langgraph-integration.md#groq) +- [H3 · Ollama (Local)](../../langgraph-integration.md#ollama-local) +- [H2 · Discord Bot Integration](../../langgraph-integration.md#discord-bot-integration) +- [H2 · CLI Usage](../../langgraph-integration.md#cli-usage) +- [H2 · Comparison with Rust ZeroClaw](../../langgraph-integration.md#comparison-with-rust-zeroclaw) +- [H2 · Troubleshooting](../../langgraph-integration.md#troubleshooting) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/matrix-e2ee-guide.md b/docs/i18n/ru/matrix-e2ee-guide.md new file mode 100644 index 000000000..3a9751e8e --- /dev/null +++ b/docs/i18n/ru/matrix-e2ee-guide.md @@ -0,0 +1,42 @@ +# Локализованный bridge: Matrix E2ee Guide + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../matrix-e2ee-guide.md](../../matrix-e2ee-guide.md) + +## Позиционирование темы + +- Категория: Runtime и каналы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · 0. Fast FAQ (#499-class symptom)](../../matrix-e2ee-guide.md#0-fast-faq-499-class-symptom) +- [H2 · 1. Requirements](../../matrix-e2ee-guide.md#1-requirements) +- [H2 · 2. Configuration](../../matrix-e2ee-guide.md#2-configuration) +- [H3 · About `user_id` and `device_id`](../../matrix-e2ee-guide.md#about-user-id-and-device-id) +- [H2 · 3. Quick Validation Flow](../../matrix-e2ee-guide.md#3-quick-validation-flow) +- [H2 · 4. Troubleshooting “No Response”](../../matrix-e2ee-guide.md#4-troubleshooting-no-response) +- [H3 · A. Room and membership](../../matrix-e2ee-guide.md#a-room-and-membership) +- [H3 · B. Sender allowlist](../../matrix-e2ee-guide.md#b-sender-allowlist) +- [H3 · C. Token and identity](../../matrix-e2ee-guide.md#c-token-and-identity) +- [H3 · D. E2EE-specific checks](../../matrix-e2ee-guide.md#d-e2ee-specific-checks) +- [H3 · E. Message formatting (Markdown)](../../matrix-e2ee-guide.md#e-message-formatting-markdown) +- [H3 · F. Fresh start test](../../matrix-e2ee-guide.md#f-fresh-start-test) +- [H2 · 5. Operational Notes](../../matrix-e2ee-guide.md#5-operational-notes) +- [H2 · 6. Related Docs](../../matrix-e2ee-guide.md#6-related-docs) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/mattermost-setup.md b/docs/i18n/ru/mattermost-setup.md new file mode 100644 index 000000000..ccd45564d --- /dev/null +++ b/docs/i18n/ru/mattermost-setup.md @@ -0,0 +1,34 @@ +# Локализованный bridge: Mattermost Setup + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../mattermost-setup.md](../../mattermost-setup.md) + +## Позиционирование темы + +- Категория: Runtime и каналы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Prerequisites](../../mattermost-setup.md#prerequisites) +- [H2 · Configuration](../../mattermost-setup.md#configuration) +- [H3 · Configuration Fields](../../mattermost-setup.md#configuration-fields) +- [H2 · Threaded Conversations](../../mattermost-setup.md#threaded-conversations) +- [H2 · Mention-Only Mode](../../mattermost-setup.md#mention-only-mode) +- [H2 · Security Note](../../mattermost-setup.md#security-note) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/network-deployment.md b/docs/i18n/ru/network-deployment.md new file mode 100644 index 000000000..22297d4dc --- /dev/null +++ b/docs/i18n/ru/network-deployment.md @@ -0,0 +1,46 @@ +# Локализованный bridge: Network Deployment + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../network-deployment.md](../../network-deployment.md) + +## Позиционирование темы + +- Категория: Runtime и каналы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · 1. Overview](../../network-deployment.md#1-overview) +- [H2 · 2. ZeroClaw on Raspberry Pi](../../network-deployment.md#2-zeroclaw-on-raspberry-pi) +- [H3 · 2.1 Prerequisites](../../network-deployment.md#2-1-prerequisites) +- [H3 · 2.2 Install](../../network-deployment.md#2-2-install) +- [H3 · 2.3 Config](../../network-deployment.md#2-3-config) +- [H3 · 2.4 Run Daemon (Local Only)](../../network-deployment.md#2-4-run-daemon-local-only) +- [H2 · 3. Binding to 0.0.0.0 (Local Network)](../../network-deployment.md#3-binding-to-0-0-0-0-local-network) +- [H3 · 3.1 Option A: Explicit Opt-In](../../network-deployment.md#3-1-option-a-explicit-opt-in) +- [H3 · 3.2 Option B: Tunnel (Recommended for Webhooks)](../../network-deployment.md#3-2-option-b-tunnel-recommended-for-webhooks) +- [H2 · 4. Telegram Polling (No Inbound Port)](../../network-deployment.md#4-telegram-polling-no-inbound-port) +- [H3 · 4.1 Single Poller Rule (Important)](../../network-deployment.md#4-1-single-poller-rule-important) +- [H2 · 5. Webhook Channels (WhatsApp, Nextcloud Talk, Custom)](../../network-deployment.md#5-webhook-channels-whatsapp-nextcloud-talk-custom) +- [H3 · 5.1 Tailscale Funnel](../../network-deployment.md#5-1-tailscale-funnel) +- [H3 · 5.2 ngrok](../../network-deployment.md#5-2-ngrok) +- [H3 · 5.3 Cloudflare Tunnel](../../network-deployment.md#5-3-cloudflare-tunnel) +- [H2 · 6. Checklist: RPi Deployment](../../network-deployment.md#6-checklist-rpi-deployment) +- [H2 · 7. OpenRC (Alpine Linux Service)](../../network-deployment.md#7-openrc-alpine-linux-service) +- [H3 · 7.1 Prerequisites](../../network-deployment.md#7-1-prerequisites) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/nextcloud-talk-setup.md b/docs/i18n/ru/nextcloud-talk-setup.md new file mode 100644 index 000000000..cbf8fd9ca --- /dev/null +++ b/docs/i18n/ru/nextcloud-talk-setup.md @@ -0,0 +1,35 @@ +# Локализованный bridge: Nextcloud Talk Setup + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../nextcloud-talk-setup.md](../../nextcloud-talk-setup.md) + +## Позиционирование темы + +- Категория: Runtime и каналы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · 1. What this integration does](../../nextcloud-talk-setup.md#1-what-this-integration-does) +- [H2 · 2. Configuration](../../nextcloud-talk-setup.md#2-configuration) +- [H2 · 3. Gateway endpoint](../../nextcloud-talk-setup.md#3-gateway-endpoint) +- [H2 · 4. Signature verification contract](../../nextcloud-talk-setup.md#4-signature-verification-contract) +- [H2 · 5. Message routing behavior](../../nextcloud-talk-setup.md#5-message-routing-behavior) +- [H2 · 6. Quick validation checklist](../../nextcloud-talk-setup.md#6-quick-validation-checklist) +- [H2 · 7. Troubleshooting](../../nextcloud-talk-setup.md#7-troubleshooting) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/nucleo-setup.md b/docs/i18n/ru/nucleo-setup.md new file mode 100644 index 000000000..fac3fc9b3 --- /dev/null +++ b/docs/i18n/ru/nucleo-setup.md @@ -0,0 +1,40 @@ +# Локализованный bridge: Nucleo Setup + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../nucleo-setup.md](../../nucleo-setup.md) + +## Позиционирование темы + +- Категория: Hardware и периферия +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Get Board Info via Telegram (No Firmware Needed)](../../nucleo-setup.md#get-board-info-via-telegram-no-firmware-needed) +- [H2 · What's Included (No Code Changes Needed)](../../nucleo-setup.md#what-s-included-no-code-changes-needed) +- [H2 · Prerequisites](../../nucleo-setup.md#prerequisites) +- [H2 · Phase 1: Flash Firmware](../../nucleo-setup.md#phase-1-flash-firmware) +- [H3 · 1.1 Connect Nucleo](../../nucleo-setup.md#1-1-connect-nucleo) +- [H3 · 1.2 Flash via ZeroClaw](../../nucleo-setup.md#1-2-flash-via-zeroclaw) +- [H3 · 1.3 Manual Flash (Alternative)](../../nucleo-setup.md#1-3-manual-flash-alternative) +- [H2 · Phase 2: Find Serial Port](../../nucleo-setup.md#phase-2-find-serial-port) +- [H2 · Phase 3: Configure ZeroClaw](../../nucleo-setup.md#phase-3-configure-zeroclaw) +- [H2 · Phase 4: Run and Test](../../nucleo-setup.md#phase-4-run-and-test) +- [H2 · Summary: Commands](../../nucleo-setup.md#summary-commands) +- [H2 · Troubleshooting](../../nucleo-setup.md#troubleshooting) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/one-click-bootstrap.md b/docs/i18n/ru/one-click-bootstrap.md new file mode 100644 index 000000000..8fb9a765d --- /dev/null +++ b/docs/i18n/ru/one-click-bootstrap.md @@ -0,0 +1,39 @@ +# Локализованный bridge: One Click Bootstrap + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../one-click-bootstrap.md](../../one-click-bootstrap.md) + +## Позиционирование темы + +- Категория: Runtime и каналы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Option 0: Homebrew (macOS/Linuxbrew)](../../one-click-bootstrap.md#option-0-homebrew-macos-linuxbrew) +- [H2 · Option A (Recommended): Clone + local script](../../one-click-bootstrap.md#option-a-recommended-clone-local-script) +- [H3 · Resource preflight and pre-built flow](../../one-click-bootstrap.md#resource-preflight-and-pre-built-flow) +- [H2 · Dual-mode bootstrap](../../one-click-bootstrap.md#dual-mode-bootstrap) +- [H2 · Option B: Remote one-liner](../../one-click-bootstrap.md#option-b-remote-one-liner) +- [H2 · Optional onboarding modes](../../one-click-bootstrap.md#optional-onboarding-modes) +- [H3 · Containerized onboarding (Docker)](../../one-click-bootstrap.md#containerized-onboarding-docker) +- [H3 · Quick onboarding (non-interactive)](../../one-click-bootstrap.md#quick-onboarding-non-interactive) +- [H3 · Interactive onboarding](../../one-click-bootstrap.md#interactive-onboarding) +- [H2 · Useful flags](../../one-click-bootstrap.md#useful-flags) +- [H2 · Related docs](../../one-click-bootstrap.md#related-docs) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/operations-runbook.md b/docs/i18n/ru/operations-runbook.md new file mode 100644 index 000000000..328a5891b --- /dev/null +++ b/docs/i18n/ru/operations-runbook.md @@ -0,0 +1,18 @@ +# Операционный runbook (Русский) + +Это первичная локализация Wave 1 для day-2 эксплуатации и стандартных процедур. + +Оригинал на английском: + +- [../../operations-runbook.md](../../operations-runbook.md) + +## Когда использовать + +- Проверка здоровья системы до/после изменений +- Перезапуск сервисов и rollback +- Стандартный порядок действий при инцидентах + +## Правило + +- Команды и системные ключи остаются на английском. +- Финальные эксплуатационные требования — в английском оригинале. diff --git a/docs/i18n/ru/pr-workflow.md b/docs/i18n/ru/pr-workflow.md new file mode 100644 index 000000000..6d7e1f463 --- /dev/null +++ b/docs/i18n/ru/pr-workflow.md @@ -0,0 +1,46 @@ +# Локализованный bridge: Pr Workflow + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../pr-workflow.md](../../pr-workflow.md) + +## Позиционирование темы + +- Категория: Инженерные процессы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · 0. Summary](../../pr-workflow.md#0-summary) +- [H2 · 1. Fast Path by PR Situation](../../pr-workflow.md#1-fast-path-by-pr-situation) +- [H3 · 1.1 Intake is incomplete](../../pr-workflow.md#1-1-intake-is-incomplete) +- [H3 · 1.2 `CI Required Gate` failing](../../pr-workflow.md#1-2-ci-required-gate-failing) +- [H3 · 1.3 High-risk path touched](../../pr-workflow.md#1-3-high-risk-path-touched) +- [H3 · 1.4 PR is superseded or duplicate](../../pr-workflow.md#1-4-pr-is-superseded-or-duplicate) +- [H2 · 2. Governance Goals and Control Loop](../../pr-workflow.md#2-governance-goals-and-control-loop) +- [H3 · 2.1 Governance goals](../../pr-workflow.md#2-1-governance-goals) +- [H3 · 2.2 Governance design logic (control loop)](../../pr-workflow.md#2-2-governance-design-logic-control-loop) +- [H2 · 3. Required Repository Settings](../../pr-workflow.md#3-required-repository-settings) +- [H2 · 4. PR Lifecycle Runbook](../../pr-workflow.md#4-pr-lifecycle-runbook) +- [H3 · 4.1 Step A: Intake](../../pr-workflow.md#4-1-step-a-intake) +- [H3 · 4.2 Step B: Validation](../../pr-workflow.md#4-2-step-b-validation) +- [H3 · 4.3 Step C: Review](../../pr-workflow.md#4-3-step-c-review) +- [H3 · 4.4 Step D: Merge](../../pr-workflow.md#4-4-step-d-merge) +- [H2 · 5. PR Readiness Contracts (DoR / DoD)](../../pr-workflow.md#5-pr-readiness-contracts-dor-dod) +- [H3 · 5.1 Definition of Ready (DoR) before requesting review](../../pr-workflow.md#5-1-definition-of-ready-dor-before-requesting-review) +- [H3 · 5.2 Definition of Done (DoD) merge-ready](../../pr-workflow.md#5-2-definition-of-done-dod-merge-ready) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/project-triage-snapshot-2026-02-18.md b/docs/i18n/ru/project-triage-snapshot-2026-02-18.md new file mode 100644 index 000000000..8a0d60798 --- /dev/null +++ b/docs/i18n/ru/project-triage-snapshot-2026-02-18.md @@ -0,0 +1,36 @@ +# Локализованный bridge: Project Triage Snapshot 2026 02 18 + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../project-triage-snapshot-2026-02-18.md](../../project-triage-snapshot-2026-02-18.md) + +## Позиционирование темы + +- Категория: Инженерные процессы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Data Source](../../project-triage-snapshot-2026-02-18.md#data-source) +- [H2 · Repository Pulse](../../project-triage-snapshot-2026-02-18.md#repository-pulse) +- [H2 · PR Label Pressure (Open PRs)](../../project-triage-snapshot-2026-02-18.md#pr-label-pressure-open-prs) +- [H2 · Issue Label Pressure (Open Issues)](../../project-triage-snapshot-2026-02-18.md#issue-label-pressure-open-issues) +- [H2 · Docs-Relevant Open PRs](../../project-triage-snapshot-2026-02-18.md#docs-relevant-open-prs) +- [H2 · Docs-Relevant Open Issues](../../project-triage-snapshot-2026-02-18.md#docs-relevant-open-issues) +- [H2 · Recommended Docs Backlog (Priority Order)](../../project-triage-snapshot-2026-02-18.md#recommended-docs-backlog-priority-order) +- [H2 · Snapshot Caveat](../../project-triage-snapshot-2026-02-18.md#snapshot-caveat) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/providers-reference.md b/docs/i18n/ru/providers-reference.md new file mode 100644 index 000000000..ec5b48c9c --- /dev/null +++ b/docs/i18n/ru/providers-reference.md @@ -0,0 +1,18 @@ +# Справочник провайдеров (Русский) + +Это первичная локализация Wave 1 для проверки provider ID, алиасов и переменных окружения. + +Оригинал на английском: + +- [../../providers-reference.md](../../providers-reference.md) + +## Когда использовать + +- Выбор провайдера и модели +- Проверка ID/alias/credential env vars +- Диагностика ошибок аутентификации и конфигурации + +## Правило + +- Provider ID и имена env переменных не переводятся. +- Нормативное описание поведения — в английском оригинале. diff --git a/docs/i18n/ru/proxy-agent-playbook.md b/docs/i18n/ru/proxy-agent-playbook.md new file mode 100644 index 000000000..111999df4 --- /dev/null +++ b/docs/i18n/ru/proxy-agent-playbook.md @@ -0,0 +1,46 @@ +# Локализованный bridge: Proxy Agent Playbook + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../proxy-agent-playbook.md](../../proxy-agent-playbook.md) + +## Позиционирование темы + +- Категория: Провайдеры и интеграции +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · 0. Summary](../../proxy-agent-playbook.md#0-summary) +- [H2 · 1. Fast Path by Intent](../../proxy-agent-playbook.md#1-fast-path-by-intent) +- [H3 · 1.1 Proxy only ZeroClaw internal traffic](../../proxy-agent-playbook.md#1-1-proxy-only-zeroclaw-internal-traffic) +- [H3 · 1.2 Proxy only selected services](../../proxy-agent-playbook.md#1-2-proxy-only-selected-services) +- [H3 · 1.3 Export process-wide proxy environment variables](../../proxy-agent-playbook.md#1-3-export-process-wide-proxy-environment-variables) +- [H3 · 1.4 Emergency rollback](../../proxy-agent-playbook.md#1-4-emergency-rollback) +- [H2 · 2. Scope Decision Matrix](../../proxy-agent-playbook.md#2-scope-decision-matrix) +- [H2 · 3. Standard Safe Workflow](../../proxy-agent-playbook.md#3-standard-safe-workflow) +- [H2 · 4. Mode A — Proxy Only for ZeroClaw Internals](../../proxy-agent-playbook.md#4-mode-a-proxy-only-for-zeroclaw-internals) +- [H2 · 5. Mode B — Proxy Only for Specific Services](../../proxy-agent-playbook.md#5-mode-b-proxy-only-for-specific-services) +- [H3 · 5.1 Target specific services](../../proxy-agent-playbook.md#5-1-target-specific-services) +- [H3 · 5.2 Target by selectors](../../proxy-agent-playbook.md#5-2-target-by-selectors) +- [H2 · 6. Mode C — Proxy for Full Process Environment](../../proxy-agent-playbook.md#6-mode-c-proxy-for-full-process-environment) +- [H3 · 6.1 Configure and apply environment scope](../../proxy-agent-playbook.md#6-1-configure-and-apply-environment-scope) +- [H2 · 7. Disable / Rollback Patterns](../../proxy-agent-playbook.md#7-disable-rollback-patterns) +- [H3 · 7.1 Disable proxy (default safe behavior)](../../proxy-agent-playbook.md#7-1-disable-proxy-default-safe-behavior) +- [H3 · 7.2 Disable proxy and force-clear env vars](../../proxy-agent-playbook.md#7-2-disable-proxy-and-force-clear-env-vars) +- [H3 · 7.3 Keep proxy enabled but clear environment exports only](../../proxy-agent-playbook.md#7-3-keep-proxy-enabled-but-clear-environment-exports-only) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/release-process.md b/docs/i18n/ru/release-process.md new file mode 100644 index 000000000..dbd86ec4d --- /dev/null +++ b/docs/i18n/ru/release-process.md @@ -0,0 +1,40 @@ +# Локализованный bridge: Release Process + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../release-process.md](../../release-process.md) + +## Позиционирование темы + +- Категория: Инженерные процессы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Release Goals](../../release-process.md#release-goals) +- [H2 · Standard Cadence](../../release-process.md#standard-cadence) +- [H2 · Workflow Contract](../../release-process.md#workflow-contract) +- [H2 · Maintainer Procedure](../../release-process.md#maintainer-procedure) +- [H3 · 1) Preflight on `main`](../../release-process.md#1-preflight-on-main) +- [H3 · 2) Run verification build (no publish)](../../release-process.md#2-run-verification-build-no-publish) +- [H3 · 3) Cut release tag](../../release-process.md#3-cut-release-tag) +- [H3 · 4) Monitor publish run](../../release-process.md#4-monitor-publish-run) +- [H3 · 5) Post-release validation](../../release-process.md#5-post-release-validation) +- [H3 · 6) Publish Homebrew Core formula (bot-owned)](../../release-process.md#6-publish-homebrew-core-formula-bot-owned) +- [H2 · Emergency / Recovery Path](../../release-process.md#emergency-recovery-path) +- [H2 · Operational Notes](../../release-process.md#operational-notes) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/resource-limits.md b/docs/i18n/ru/resource-limits.md new file mode 100644 index 000000000..d317269fa --- /dev/null +++ b/docs/i18n/ru/resource-limits.md @@ -0,0 +1,35 @@ +# Локализованный bridge: Resource Limits + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../resource-limits.md](../../resource-limits.md) + +## Позиционирование темы + +- Категория: Безопасность и управление +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Problem](../../resource-limits.md#problem) +- [H2 · Proposed Solutions](../../resource-limits.md#proposed-solutions) +- [H3 · Option 1: cgroups v2 (Linux, Recommended)](../../resource-limits.md#option-1-cgroups-v2-linux-recommended) +- [H3 · Option 2: tokio::task::deadlock detection](../../resource-limits.md#option-2-tokio-task-deadlock-detection) +- [H3 · Option 3: Memory monitoring](../../resource-limits.md#option-3-memory-monitoring) +- [H2 · Config Schema](../../resource-limits.md#config-schema) +- [H2 · Implementation Priority](../../resource-limits.md#implementation-priority) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/reviewer-playbook.md b/docs/i18n/ru/reviewer-playbook.md new file mode 100644 index 000000000..4466d97f7 --- /dev/null +++ b/docs/i18n/ru/reviewer-playbook.md @@ -0,0 +1,46 @@ +# Локализованный bridge: Reviewer Playbook + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../reviewer-playbook.md](../../reviewer-playbook.md) + +## Позиционирование темы + +- Категория: Инженерные процессы +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · 0. Summary](../../reviewer-playbook.md#0-summary) +- [H2 · 1. Fast Path by Review Situation](../../reviewer-playbook.md#1-fast-path-by-review-situation) +- [H3 · 1.1 Intake fails in first 5 minutes](../../reviewer-playbook.md#1-1-intake-fails-in-first-5-minutes) +- [H3 · 1.2 Risk is high or unclear](../../reviewer-playbook.md#1-2-risk-is-high-or-unclear) +- [H3 · 1.3 Automation output is wrong/noisy](../../reviewer-playbook.md#1-3-automation-output-is-wrong-noisy) +- [H3 · 1.4 Need review handoff](../../reviewer-playbook.md#1-4-need-review-handoff) +- [H2 · 2. Review Depth Decision Matrix](../../reviewer-playbook.md#2-review-depth-decision-matrix) +- [H2 · 3. Standard Review Workflow](../../reviewer-playbook.md#3-standard-review-workflow) +- [H3 · 3.1 Five-minute intake triage](../../reviewer-playbook.md#3-1-five-minute-intake-triage) +- [H3 · 3.2 Fast-lane checklist (all PRs)](../../reviewer-playbook.md#3-2-fast-lane-checklist-all-prs) +- [H3 · 3.3 Deep review checklist (high risk)](../../reviewer-playbook.md#3-3-deep-review-checklist-high-risk) +- [H3 · 3.4 Review comment outcome style](../../reviewer-playbook.md#3-4-review-comment-outcome-style) +- [H2 · 4. Issue Triage and Backlog Governance](../../reviewer-playbook.md#4-issue-triage-and-backlog-governance) +- [H3 · 4.1 Issue triage label playbook](../../reviewer-playbook.md#4-1-issue-triage-label-playbook) +- [H3 · 4.2 PR backlog pruning protocol](../../reviewer-playbook.md#4-2-pr-backlog-pruning-protocol) +- [H2 · 5. Automation Override Protocol](../../reviewer-playbook.md#5-automation-override-protocol) +- [H2 · 6. Handoff Protocol](../../reviewer-playbook.md#6-handoff-protocol) +- [H2 · 7. Weekly Queue Hygiene](../../reviewer-playbook.md#7-weekly-queue-hygiene) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/sandboxing.md b/docs/i18n/ru/sandboxing.md new file mode 100644 index 000000000..f710fbe23 --- /dev/null +++ b/docs/i18n/ru/sandboxing.md @@ -0,0 +1,37 @@ +# Локализованный bridge: Sandboxing + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../sandboxing.md](../../sandboxing.md) + +## Позиционирование темы + +- Категория: Безопасность и управление +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Problem](../../sandboxing.md#problem) +- [H2 · Proposed Solutions](../../sandboxing.md#proposed-solutions) +- [H3 · Option 1: Firejail Integration (Recommended for Linux)](../../sandboxing.md#option-1-firejail-integration-recommended-for-linux) +- [H3 · Option 2: Bubblewrap (Portable, no root required)](../../sandboxing.md#option-2-bubblewrap-portable-no-root-required) +- [H3 · Option 3: Docker-in-Docker (Heavyweight but complete isolation)](../../sandboxing.md#option-3-docker-in-docker-heavyweight-but-complete-isolation) +- [H3 · Option 4: Landlock (Linux Kernel LSM, Rust native)](../../sandboxing.md#option-4-landlock-linux-kernel-lsm-rust-native) +- [H2 · Priority Implementation Order](../../sandboxing.md#priority-implementation-order) +- [H2 · Config Schema Extension](../../sandboxing.md#config-schema-extension) +- [H2 · Testing Strategy](../../sandboxing.md#testing-strategy) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/security-roadmap.md b/docs/i18n/ru/security-roadmap.md new file mode 100644 index 000000000..b6323b2a7 --- /dev/null +++ b/docs/i18n/ru/security-roadmap.md @@ -0,0 +1,38 @@ +# Локализованный bridge: Security Roadmap + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../security-roadmap.md](../../security-roadmap.md) + +## Позиционирование темы + +- Категория: Безопасность и управление +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Current State: Strong Foundation](../../security-roadmap.md#current-state-strong-foundation) +- [H2 · What's Missing: OS-Level Containment](../../security-roadmap.md#what-s-missing-os-level-containment) +- [H2 · Comparison: ZeroClaw vs PicoClaw vs Production Grade](../../security-roadmap.md#comparison-zeroclaw-vs-picoclaw-vs-production-grade) +- [H2 · Implementation Roadmap](../../security-roadmap.md#implementation-roadmap) +- [H3 · Phase 1: Quick Wins (1-2 weeks)](../../security-roadmap.md#phase-1-quick-wins-1-2-weeks) +- [H3 · Phase 2: Platform Integration (2-3 weeks)](../../security-roadmap.md#phase-2-platform-integration-2-3-weeks) +- [H3 · Phase 3: Production Hardening (1-2 weeks)](../../security-roadmap.md#phase-3-production-hardening-1-2-weeks) +- [H2 · New Config Schema Preview](../../security-roadmap.md#new-config-schema-preview) +- [H2 · CLI Commands Preview](../../security-roadmap.md#cli-commands-preview) +- [H2 · Summary](../../security-roadmap.md#summary) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/ru/troubleshooting.md b/docs/i18n/ru/troubleshooting.md new file mode 100644 index 000000000..da1cf59c4 --- /dev/null +++ b/docs/i18n/ru/troubleshooting.md @@ -0,0 +1,18 @@ +# Troubleshooting (Русский) + +Это первичная локализация Wave 1 для быстрого поиска типовых неисправностей. + +Оригинал на английском: + +- [../../troubleshooting.md](../../troubleshooting.md) + +## Когда использовать + +- Ошибки установки и запуска +- Диагностика через `status` и `doctor` +- Минимальный recovery/rollback сценарий + +## Правило + +- Коды ошибок, ключи логов и команды не переводятся. +- Подробные сигнатуры отказов — в английском оригинале. diff --git a/docs/i18n/ru/zai-glm-setup.md b/docs/i18n/ru/zai-glm-setup.md new file mode 100644 index 000000000..88930ef3d --- /dev/null +++ b/docs/i18n/ru/zai-glm-setup.md @@ -0,0 +1,43 @@ +# Локализованный bridge: Zai Glm Setup + +Это усиленная bridge-страница. Здесь собраны позиционирование темы, навигация по разделам оригинала и практические подсказки. + +Английский оригинал: + +- [../../zai-glm-setup.md](../../zai-glm-setup.md) + +## Позиционирование темы + +- Категория: Провайдеры и интеграции +- Глубина: усиленный bridge (карта разделов + операционные подсказки) +- Применение: сначала понять структуру, затем выполнять по английскому нормативному описанию. + +## Карта разделов оригинала + +- [H2 · Overview](../../zai-glm-setup.md#overview) +- [H2 · Setup](../../zai-glm-setup.md#setup) +- [H3 · Quick Start](../../zai-glm-setup.md#quick-start) +- [H3 · Manual Configuration](../../zai-glm-setup.md#manual-configuration) +- [H2 · Available Models](../../zai-glm-setup.md#available-models) +- [H2 · Verify Setup](../../zai-glm-setup.md#verify-setup) +- [H3 · Test with curl](../../zai-glm-setup.md#test-with-curl) +- [H3 · Test with ZeroClaw CLI](../../zai-glm-setup.md#test-with-zeroclaw-cli) +- [H2 · Environment Variables](../../zai-glm-setup.md#environment-variables) +- [H2 · Troubleshooting](../../zai-glm-setup.md#troubleshooting) +- [H3 · Rate Limiting](../../zai-glm-setup.md#rate-limiting) +- [H3 · Authentication Errors](../../zai-glm-setup.md#authentication-errors) +- [H3 · Model Not Found](../../zai-glm-setup.md#model-not-found) +- [H2 · Getting an API Key](../../zai-glm-setup.md#getting-an-api-key) +- [H2 · Related Documentation](../../zai-glm-setup.md#related-documentation) + +## Практические рекомендации + +- Сначала просмотрите структуру разделов оригинала, затем переходите к релевантным блокам для текущего изменения. +- Имена команд, ключей конфигурации, API-пути и code identifiers оставляйте на английском. +- При расхождениях трактовки опирайтесь на английский оригинал. + +## Связанные входы + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/vi/README.md b/docs/i18n/vi/README.md index 4a86dd57b..ed65a207c 100644 --- a/docs/i18n/vi/README.md +++ b/docs/i18n/vi/README.md @@ -12,12 +12,16 @@ |---|---| | Cài đặt và chạy nhanh | [../../../README.vi.md](../../../README.vi.md) / [../../../README.md](../../../README.md) | | Cài đặt bằng một lệnh | [one-click-bootstrap.md](one-click-bootstrap.md) | +| Cài đặt trên Android (Termux/ADB) | [android-setup.md](android-setup.md) | | Tìm lệnh theo tác vụ | [commands-reference.md](commands-reference.md) | | Kiểm tra giá trị mặc định và khóa cấu hình | [config-reference.md](config-reference.md) | | Kết nối provider / endpoint tùy chỉnh | [custom-providers.md](custom-providers.md) | | Cấu hình Z.AI / GLM provider | [zai-glm-setup.md](zai-glm-setup.md) | | Sử dụng tích hợp LangGraph | [langgraph-integration.md](langgraph-integration.md) | +| Thiết lập Nextcloud Talk | [nextcloud-talk-setup.md](nextcloud-talk-setup.md) | +| Cấu hình proxy theo phạm vi an toàn | [proxy-agent-playbook.md](proxy-agent-playbook.md) | | Vận hành hàng ngày (runbook) | [operations-runbook.md](operations-runbook.md) | +| Vận hành probe kết nối provider trong CI | [operations/connectivity-probes-runbook.md](operations/connectivity-probes-runbook.md) | | Khắc phục sự cố cài đặt/chạy/kênh | [troubleshooting.md](troubleshooting.md) | | Cấu hình Matrix phòng mã hóa (E2EE) | [matrix-e2ee-guide.md](matrix-e2ee-guide.md) | | Xem theo danh mục | [SUMMARY.md](SUMMARY.md) | @@ -83,12 +87,17 @@ - Mục lục thống nhất (TOC): [SUMMARY.md](SUMMARY.md) - Bản đồ cấu trúc docs (ngôn ngữ/phần/chức năng): [../../structure/README.md](../../structure/README.md) -- Danh mục và phân loại tài liệu: [docs-inventory.md](../../docs-inventory.md) +- Danh mục và phân loại tài liệu: [docs-inventory.md](docs-inventory.md) +- Checklist hoàn thiện i18n: [i18n-guide.md](i18n-guide.md) +- Bản đồ độ phủ i18n: [i18n-coverage.md](i18n-coverage.md) +- Backlog thiếu hụt i18n: [i18n-gap-backlog.md](i18n-gap-backlog.md) +- Snapshot kiểm toán tài liệu (2026-02-24): [docs-audit-2026-02-24.md](docs-audit-2026-02-24.md) ## Ngôn ngữ khác - English: [README.md](../../README.md) -- 简体中文: [README.zh-CN.md](../../README.zh-CN.md) -- 日本語: [README.ja.md](../../README.ja.md) -- Русский: [README.ru.md](../../README.ru.md) -- Français: [README.fr.md](../../README.fr.md) +- 简体中文: [../zh-CN/README.md](../zh-CN/README.md) +- 日本語: [../ja/README.md](../ja/README.md) +- Русский: [../ru/README.md](../ru/README.md) +- Français: [../fr/README.md](../fr/README.md) +- Ελληνικά: [../el/README.md](../el/README.md) diff --git a/docs/i18n/vi/SUMMARY.md b/docs/i18n/vi/SUMMARY.md index ce0280bd1..70f8aacb2 100644 --- a/docs/i18n/vi/SUMMARY.md +++ b/docs/i18n/vi/SUMMARY.md @@ -16,6 +16,7 @@ - [getting-started/README.md](getting-started/README.md) - [one-click-bootstrap.md](one-click-bootstrap.md) +- [android-setup.md](android-setup.md) ### 2) Lệnh / Cấu hình / Tích hợp @@ -23,15 +24,18 @@ - [commands-reference.md](commands-reference.md) - [providers-reference.md](providers-reference.md) - [channels-reference.md](channels-reference.md) +- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) - [config-reference.md](config-reference.md) - [custom-providers.md](custom-providers.md) - [zai-glm-setup.md](zai-glm-setup.md) - [langgraph-integration.md](langgraph-integration.md) +- [proxy-agent-playbook.md](proxy-agent-playbook.md) ### 3) Vận hành & Triển khai - [operations/README.md](operations/README.md) - [operations-runbook.md](operations-runbook.md) +- [operations/connectivity-probes-runbook.md](operations/connectivity-probes-runbook.md) - [release-process.md](release-process.md) - [troubleshooting.md](troubleshooting.md) - [network-deployment.md](network-deployment.md) @@ -46,6 +50,7 @@ - [sandboxing.md](sandboxing.md) - [resource-limits.md](resource-limits.md) - [audit-logging.md](audit-logging.md) +- [audit-event-schema.md](audit-event-schema.md) - [security-roadmap.md](security-roadmap.md) ### 5) Phần cứng & Ngoại vi @@ -55,6 +60,7 @@ - [adding-boards-and-tools.md](adding-boards-and-tools.md) - [nucleo-setup.md](nucleo-setup.md) - [arduino-uno-q-setup.md](arduino-uno-q-setup.md) +- [datasheets/README.md](datasheets/README.md) - [datasheets/nucleo-f401re.md](datasheets/nucleo-f401re.md) - [datasheets/arduino-uno.md](datasheets/arduino-uno.md) - [datasheets/esp32.md](datasheets/esp32.md) @@ -67,11 +73,21 @@ - [reviewer-playbook.md](reviewer-playbook.md) - [ci-map.md](ci-map.md) - [actions-source-policy.md](actions-source-policy.md) +- [cargo-slicer-speedup.md](cargo-slicer-speedup.md) ### 7) Dự án - [project/README.md](project/README.md) -- [proxy-agent-playbook.md](proxy-agent-playbook.md) +- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) +- [docs-audit-2026-02-24.md](docs-audit-2026-02-24.md) + +### 8) Quản trị tài liệu & i18n + +- [docs-inventory.md](docs-inventory.md) +- [doc-template.md](doc-template.md) +- [i18n-guide.md](i18n-guide.md) +- [i18n-coverage.md](i18n-coverage.md) +- [i18n-gap-backlog.md](i18n-gap-backlog.md) ## Ngôn ngữ khác diff --git a/docs/i18n/vi/android-setup.md b/docs/i18n/vi/android-setup.md new file mode 100644 index 000000000..10bff6623 --- /dev/null +++ b/docs/i18n/vi/android-setup.md @@ -0,0 +1,22 @@ +# Thiết lập Android (Tiếng Việt) + +Trang này là bản địa hóa tối thiểu cho hướng dẫn Android. + +Bản gốc tiếng Anh: + +- [../../android-setup.md](../../android-setup.md) + +## Tóm tắt nhanh + +- Hỗ trợ kiến trúc `armv7-linux-androideabi` và `aarch64-linux-android`. +- Cách dễ nhất: chạy qua Termux. +- Có thể dùng ADB cho luồng nâng cao. + +## Điểm cần kiểm tra + +1. Xác định đúng kiến trúc thiết bị (`uname -m`). +2. Tải đúng binary theo kiến trúc. +3. Kiểm tra quyền thực thi (`chmod +x zeroclaw`). +4. Chạy `zeroclaw --version` và `zeroclaw onboard` để xác minh. + +Nếu cần lệnh chi tiết đầy đủ, dùng bản gốc tiếng Anh ở liên kết trên. diff --git a/docs/i18n/vi/audit-event-schema.md b/docs/i18n/vi/audit-event-schema.md new file mode 100644 index 000000000..f329708b8 --- /dev/null +++ b/docs/i18n/vi/audit-event-schema.md @@ -0,0 +1,21 @@ +# Lược đồ Audit Event CI/Security (Tiếng Việt) + +Trang này là bản địa hóa tối thiểu cho tài liệu lược đồ sự kiện kiểm toán. + +Bản gốc tiếng Anh: + +- [../../audit-event-schema.md](../../audit-event-schema.md) + +## Nội dung chính + +- Chuẩn envelope sự kiện: `zeroclaw.audit.v1`. +- Các trường chính: `event_type`, `generated_at`, `run_context`, `artifact`, `payload`. +- Danh sách loại sự kiện hiện tại và chính sách retention artifact theo workflow. + +## Khi nào dùng + +- Thiết kế/kiểm tra lane CI hoặc security mới. +- Cần xác nhận format event cho hệ thống downstream. +- Cập nhật chính sách lưu trữ artifact. + +Chi tiết schema và bảng retention đầy đủ xem bản tiếng Anh. diff --git a/docs/i18n/vi/cargo-slicer-speedup.md b/docs/i18n/vi/cargo-slicer-speedup.md new file mode 100644 index 000000000..b727a4218 --- /dev/null +++ b/docs/i18n/vi/cargo-slicer-speedup.md @@ -0,0 +1,21 @@ +# Tăng tốc build với cargo-slicer (Tiếng Việt) + +Trang này là bản địa hóa tối thiểu cho hướng dẫn tối ưu tốc độ build bằng `cargo-slicer`. + +Bản gốc tiếng Anh: + +- [../../cargo-slicer-speedup.md](../../cargo-slicer-speedup.md) + +## Tóm tắt + +- `cargo-slicer` giảm thời gian build bằng cách loại phần code không reachable ở mức MIR. +- CI dùng chiến lược 2 đường: + - Fast path: build có `cargo-slicer`. + - Fallback path: quay về `cargo +nightly build --release` nếu toolchain không tương thích. + +## Khi nào dùng + +- Muốn giảm thời gian build release. +- Cần tái hiện hành vi lane build nhanh trong CI. + +Lệnh cài đặt/chạy chi tiết xem bản tiếng Anh. diff --git a/docs/i18n/vi/datasheets/README.md b/docs/i18n/vi/datasheets/README.md new file mode 100644 index 000000000..32659d4cc --- /dev/null +++ b/docs/i18n/vi/datasheets/README.md @@ -0,0 +1,14 @@ +# Chỉ mục Datasheet Phần cứng (Tiếng Việt) + +Tập hợp tài liệu tham chiếu datasheet cho các board được hỗ trợ. + +## Danh sách datasheet + +- [nucleo-f401re.md](nucleo-f401re.md) — STM32 Nucleo-F401RE +- [arduino-uno.md](arduino-uno.md) — Arduino Uno +- [esp32.md](esp32.md) — ESP32 + +## Liên quan + +- Hub phần cứng tiếng Việt: [../hardware/README.md](../hardware/README.md) +- Hướng dẫn thêm board/tool: [../adding-boards-and-tools.md](../adding-boards-and-tools.md) diff --git a/docs/i18n/vi/doc-template.md b/docs/i18n/vi/doc-template.md new file mode 100644 index 000000000..7c8fcde2b --- /dev/null +++ b/docs/i18n/vi/doc-template.md @@ -0,0 +1,13 @@ +# Mẫu tài liệu (Tiếng Việt) + +Trang này là cầu nối bản địa hóa cho mẫu tài liệu chuẩn. + +Bản gốc tiếng Anh: + +- [../../doc-template.md](../../doc-template.md) + +## Cách dùng + +- Dùng mẫu gốc làm chuẩn để tạo tài liệu mới. +- Giữ kỹ thuật ngữ, tên lệnh, khóa cấu hình ở tiếng Anh. +- Liên kết tài liệu mới vào `SUMMARY.md` và `docs-inventory.md`. diff --git a/docs/i18n/vi/docs-audit-2026-02-24.md b/docs/i18n/vi/docs-audit-2026-02-24.md new file mode 100644 index 000000000..a2ce642e1 --- /dev/null +++ b/docs/i18n/vi/docs-audit-2026-02-24.md @@ -0,0 +1,13 @@ +# Snapshot kiểm toán tài liệu (2026-02-24, Tiếng Việt) + +Trang này là bản địa hóa tối thiểu cho kết quả audit tài liệu ngày 2026-02-24. + +Bản gốc tiếng Anh: + +- [../../docs-audit-2026-02-24.md](../../docs-audit-2026-02-24.md) + +## Nội dung chính + +- Đã kiểm tra cấu trúc docs, tính toàn vẹn liên kết và ranh giới canonical/compatibility. +- Đã ghi lại các gap còn lại theo mức độ ưu tiên. +- Đây là snapshot bất biến theo thời điểm audit. diff --git a/docs/i18n/vi/docs-inventory.md b/docs/i18n/vi/docs-inventory.md new file mode 100644 index 000000000..e36db92cd --- /dev/null +++ b/docs/i18n/vi/docs-inventory.md @@ -0,0 +1,21 @@ +# Danh mục tài liệu ZeroClaw (Tiếng Việt) + +Trang này là bản địa hóa tối thiểu cho inventory tài liệu. + +Bản inventory gốc: + +- [../../docs-inventory.md](../../docs-inventory.md) + +## Mục đích + +- Phân loại tài liệu theo intent: current guide/reference, policy/process, proposal/roadmap, snapshot. +- Xác định canonical path và compatibility shim. +- Làm checklist khi thêm tài liệu mới. + +## Quy tắc thao tác + +1. Thêm doc lớn mới phải cập nhật `SUMMARY.md` và category index liên quan. +2. Khi đổi navigation/shared wording, chạy theo `i18n-guide.md`. +3. Giữ parity ngôn ngữ cho các locale đang hỗ trợ. + +Chi tiết đầy đủ theo inventory tiếng Anh. diff --git a/docs/i18n/vi/hardware/README.md b/docs/i18n/vi/hardware/README.md index 683cc13a8..43ec7d256 100644 --- a/docs/i18n/vi/hardware/README.md +++ b/docs/i18n/vi/hardware/README.md @@ -13,7 +13,7 @@ Hệ thống phần cứng của ZeroClaw cho phép điều khiển trực tiế ## Datasheet -- Chỉ mục datasheet: [../datasheets](../datasheets) +- Chỉ mục datasheet: [../datasheets/README.md](../datasheets/README.md) - STM32 Nucleo-F401RE: [../datasheets/nucleo-f401re.md](../datasheets/nucleo-f401re.md) - Arduino Uno: [../datasheets/arduino-uno.md](../datasheets/arduino-uno.md) - ESP32: [../datasheets/esp32.md](../datasheets/esp32.md) diff --git a/docs/i18n/vi/i18n-coverage.md b/docs/i18n/vi/i18n-coverage.md new file mode 100644 index 000000000..bfcf137f7 --- /dev/null +++ b/docs/i18n/vi/i18n-coverage.md @@ -0,0 +1,17 @@ +# Bản đồ độ phủ i18n (Tiếng Việt) + +Trang này là bản địa hóa tối thiểu cho coverage matrix i18n. + +Bản gốc tiếng Anh: + +- [../../i18n-coverage.md](../../i18n-coverage.md) + +## Dùng khi nào + +- Cần biết locale nào là full-tree và locale nào mới ở mức hub scaffold. +- Cần cập nhật trạng thái coverage sau khi thêm/sửa docs theo ngôn ngữ. + +## Lưu ý + +- `vi` và `el` là full localized tree. +- `zh-CN`/`ja`/`ru`/`fr` hiện ở mức hub-level scaffold. diff --git a/docs/i18n/vi/i18n-gap-backlog.md b/docs/i18n/vi/i18n-gap-backlog.md new file mode 100644 index 000000000..2d7cc9fd1 --- /dev/null +++ b/docs/i18n/vi/i18n-gap-backlog.md @@ -0,0 +1,13 @@ +# Backlog Thiếu hụt i18n (Tiếng Việt) + +Trang này là bản địa hóa tối thiểu cho backlog khoảng trống i18n. + +Bản gốc tiếng Anh: + +- [../../i18n-gap-backlog.md](../../i18n-gap-backlog.md) + +## Tóm tắt + +- Theo dõi số lượng thiếu hụt theo locale dựa trên baseline `docs/*.md`. +- Theo dõi completion wave cho `zh-CN`/`ja`/`ru`/`fr`. +- Cập nhật cùng với `i18n-coverage.md` sau mỗi đợt bổ sung. diff --git a/docs/i18n/vi/i18n-guide.md b/docs/i18n/vi/i18n-guide.md new file mode 100644 index 000000000..320ab3fc6 --- /dev/null +++ b/docs/i18n/vi/i18n-guide.md @@ -0,0 +1,21 @@ +# Hướng dẫn hoàn thiện i18n (Tiếng Việt) + +Trang này là bản địa hóa tối thiểu cho contract hoàn thiện i18n. + +Bản gốc tiếng Anh: + +- [../../i18n-guide.md](../../i18n-guide.md) + +## Điều bắt buộc + +- Khi thay đổi docs IA/navigation/shared wording: phải thực hiện i18n follow-through trong cùng PR. +- Cập nhật parity ở root README, docs hub và SUMMARY. +- Cập nhật `i18n-coverage.md` khi thay đổi topology hoặc mức phủ. +- Nếu buộc phải defer, ghi rõ owner + follow-up issue/PR. + +## Đường dẫn chuẩn + +- Canonical locale hub: `docs/i18n//README.md` +- Canonical locale summary: `docs/i18n//SUMMARY.md` + +Chi tiết trigger matrix/checklist xem bản tiếng Anh. diff --git a/docs/i18n/vi/nextcloud-talk-setup.md b/docs/i18n/vi/nextcloud-talk-setup.md new file mode 100644 index 000000000..3d8bca859 --- /dev/null +++ b/docs/i18n/vi/nextcloud-talk-setup.md @@ -0,0 +1,13 @@ +# Thiết lập Nextcloud Talk (Tiếng Việt) + +Trang này là bản địa hóa tối thiểu cho hướng dẫn tích hợp Nextcloud Talk. + +Bản gốc tiếng Anh: + +- [../../nextcloud-talk-setup.md](../../nextcloud-talk-setup.md) + +## Tóm tắt + +- Dùng tài liệu này khi tích hợp bot/channel với Nextcloud Talk. +- Cần đối chiếu channel capability và allowlist trong `channels-reference`. +- Nếu gặp lỗi triển khai, phối hợp `operations-runbook` + `troubleshooting`. diff --git a/docs/i18n/vi/operations/README.md b/docs/i18n/vi/operations/README.md index a59d8a854..e4606b01c 100644 --- a/docs/i18n/vi/operations/README.md +++ b/docs/i18n/vi/operations/README.md @@ -5,6 +5,7 @@ Dành cho operator vận hành ZeroClaw liên tục hoặc trên production. ## Vận hành cốt lõi - Sổ tay Day-2: [../operations-runbook.md](../operations-runbook.md) +- Runbook probe kết nối provider trong CI: [connectivity-probes-runbook.md](connectivity-probes-runbook.md) - Sổ tay Release: [../release-process.md](../release-process.md) - Ma trận xử lý sự cố: [../troubleshooting.md](../troubleshooting.md) - Triển khai mạng/gateway an toàn: [../network-deployment.md](../network-deployment.md) diff --git a/docs/i18n/vi/operations/connectivity-probes-runbook.md b/docs/i18n/vi/operations/connectivity-probes-runbook.md new file mode 100644 index 000000000..1741c9546 --- /dev/null +++ b/docs/i18n/vi/operations/connectivity-probes-runbook.md @@ -0,0 +1,13 @@ +# Runbook Connectivity Probes (Tiếng Việt) + +Trang này là bản địa hóa tối thiểu cho runbook vận hành probe kết nối provider trong CI. + +Bản gốc tiếng Anh: + +- [../../../operations/connectivity-probes-runbook.md](../../../operations/connectivity-probes-runbook.md) + +## Mục đích + +- Vận hành workflow probe kết nối endpoint provider. +- Hiểu chế độ enforce/report-only và cách triage lỗi theo DNS/HTTP/auth. +- Tái hiện chạy local bằng script matrix probe. diff --git a/docs/i18n/vi/project-triage-snapshot-2026-02-18.md b/docs/i18n/vi/project-triage-snapshot-2026-02-18.md new file mode 100644 index 000000000..6a3895b40 --- /dev/null +++ b/docs/i18n/vi/project-triage-snapshot-2026-02-18.md @@ -0,0 +1,12 @@ +# Ảnh chụp Project Triage (2026-02-18, Tiếng Việt) + +Trang này là bản địa hóa tối thiểu cho snapshot triage theo thời điểm. + +Bản gốc tiếng Anh: + +- [../../project-triage-snapshot-2026-02-18.md](../../project-triage-snapshot-2026-02-18.md) + +## Ghi chú sử dụng + +- Đây là tài liệu snapshot theo thời điểm, không sửa lịch sử. +- Khi có đợt mới, tạo file snapshot mới theo ngày thay vì ghi đè file cũ. diff --git a/docs/i18n/zh-CN/README.md b/docs/i18n/zh-CN/README.md new file mode 100644 index 000000000..1c8eb1c05 --- /dev/null +++ b/docs/i18n/zh-CN/README.md @@ -0,0 +1,51 @@ +# ZeroClaw 文档中心(简体中文) + +这是中文文档在 `docs/i18n//` 结构下的标准入口。 + +最后对齐:**2026-02-24**。 + +> 说明:命令、配置键、API 路径保持英文;实现细节以英文文档为准。 + +## 快速入口 + +- 中文根 README:[../../../README.zh-CN.md](../../../README.zh-CN.md) +- 中文文档入口(兼容路径):[../../README.zh-CN.md](../../README.zh-CN.md) +- 中文目录(兼容路径):[../../SUMMARY.zh-CN.md](../../SUMMARY.zh-CN.md) +- 英文文档入口:[../../README.md](../../README.md) + +## Wave 1 本地化运行时文档 + +- 命令参考:[commands-reference.md](commands-reference.md) +- Provider 参考:[providers-reference.md](providers-reference.md) +- Channel 参考:[channels-reference.md](channels-reference.md) +- 配置参考:[config-reference.md](config-reference.md) +- 运维 Runbook:[operations-runbook.md](operations-runbook.md) +- 故障排查:[troubleshooting.md](troubleshooting.md) + +当前状态:**top-level 文档 parity 已完成**(40/40)。 + +## 全量文档与治理 + +- 本地文档总清单:[docs-inventory.md](docs-inventory.md) +- i18n 执行指南:[i18n-guide.md](i18n-guide.md) +- i18n 覆盖状态:[i18n-coverage.md](i18n-coverage.md) +- i18n 缺口追踪:[i18n-gap-backlog.md](i18n-gap-backlog.md) + +## 按分类浏览 + +- 快速入门:[../../getting-started/README.md](../../getting-started/README.md) +- 参考手册:[../../reference/README.md](../../reference/README.md) +- 运维与部署:[../../operations/README.md](../../operations/README.md) +- 安全文档:[../../security/README.md](../../security/README.md) +- 硬件与外设:[../../hardware/README.md](../../hardware/README.md) +- 贡献与 CI:[../../contributing/README.md](../../contributing/README.md) +- 统一目录:[SUMMARY.md](SUMMARY.md) + +## 其他语言 + +- English: [../../README.md](../../README.md) +- 日本語: [../ja/README.md](../ja/README.md) +- Русский: [../ru/README.md](../ru/README.md) +- Français: [../fr/README.md](../fr/README.md) +- Tiếng Việt: [../vi/README.md](../vi/README.md) +- Ελληνικά: [../el/README.md](../el/README.md) diff --git a/docs/i18n/zh-CN/SUMMARY.md b/docs/i18n/zh-CN/SUMMARY.md new file mode 100644 index 000000000..dd82fd8b0 --- /dev/null +++ b/docs/i18n/zh-CN/SUMMARY.md @@ -0,0 +1,38 @@ +# ZeroClaw 中文文档目录(i18n) + +该文件是 `docs/i18n/zh-CN/` 的导航目录。 + +最后更新:**2026-02-24**。 + +## 入口 + +- 中文 i18n Hub:[README.md](README.md) +- 中文兼容 Hub:[../../README.zh-CN.md](../../README.zh-CN.md) +- 中文兼容 SUMMARY:[../../SUMMARY.zh-CN.md](../../SUMMARY.zh-CN.md) +- i18n 索引:[../README.md](../README.md) +- i18n 覆盖图:[../../i18n-coverage.md](../../i18n-coverage.md) + +## 分类 + +- 入门:[../../getting-started/README.md](../../getting-started/README.md) +- 参考:[../../reference/README.md](../../reference/README.md) +- 运维:[../../operations/README.md](../../operations/README.md) +- 安全:[../../security/README.md](../../security/README.md) +- 硬件:[../../hardware/README.md](../../hardware/README.md) +- 贡献与 CI:[../../contributing/README.md](../../contributing/README.md) + +## Wave 1 运行时文档 + +- 命令参考:[commands-reference.md](commands-reference.md) +- Provider 参考:[providers-reference.md](providers-reference.md) +- Channel 参考:[channels-reference.md](channels-reference.md) +- 配置参考:[config-reference.md](config-reference.md) +- 运维 Runbook:[operations-runbook.md](operations-runbook.md) +- 故障排查:[troubleshooting.md](troubleshooting.md) + +## 治理与索引 + +- 文档总清单:[docs-inventory.md](docs-inventory.md) +- i18n 指南:[i18n-guide.md](i18n-guide.md) +- 覆盖状态:[i18n-coverage.md](i18n-coverage.md) +- 缺口追踪:[i18n-gap-backlog.md](i18n-gap-backlog.md) diff --git a/docs/i18n/zh-CN/actions-source-policy.md b/docs/i18n/zh-CN/actions-source-policy.md new file mode 100644 index 000000000..adbd8ab2e --- /dev/null +++ b/docs/i18n/zh-CN/actions-source-policy.md @@ -0,0 +1,34 @@ +# 本地化桥接文档:Actions Source Policy + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../actions-source-policy.md](../../actions-source-policy.md) + +## 主题定位 + +- 类别:安全与治理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Current Policy](../../actions-source-policy.md#current-policy) +- [H2 · Change Control Export](../../actions-source-policy.md#change-control-export) +- [H2 · Why This Phase](../../actions-source-policy.md#why-this-phase) +- [H2 · Agentic Workflow Guardrails](../../actions-source-policy.md#agentic-workflow-guardrails) +- [H2 · Validation Checklist](../../actions-source-policy.md#validation-checklist) +- [H2 · Rollback](../../actions-source-policy.md#rollback) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/adding-boards-and-tools.md b/docs/i18n/zh-CN/adding-boards-and-tools.md new file mode 100644 index 000000000..f03d379dc --- /dev/null +++ b/docs/i18n/zh-CN/adding-boards-and-tools.md @@ -0,0 +1,40 @@ +# 本地化桥接文档:Adding Boards And Tools + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../adding-boards-and-tools.md](../../adding-boards-and-tools.md) + +## 主题定位 + +- 类别:硬件与外设 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Quick Start: Add a Board via CLI](../../adding-boards-and-tools.md#quick-start-add-a-board-via-cli) +- [H2 · Supported Boards](../../adding-boards-and-tools.md#supported-boards) +- [H2 · Manual Config](../../adding-boards-and-tools.md#manual-config) +- [H2 · Adding a Datasheet (RAG)](../../adding-boards-and-tools.md#adding-a-datasheet-rag) +- [H3 · Pin Aliases (Recommended)](../../adding-boards-and-tools.md#pin-aliases-recommended) +- [H2 · Pin Aliases](../../adding-boards-and-tools.md#pin-aliases) +- [H2 · Pin Aliases](../../adding-boards-and-tools.md#pin-aliases) +- [H3 · PDF Datasheets](../../adding-boards-and-tools.md#pdf-datasheets) +- [H2 · Adding a New Board Type](../../adding-boards-and-tools.md#adding-a-new-board-type) +- [H2 · Adding a Custom Tool](../../adding-boards-and-tools.md#adding-a-custom-tool) +- [H2 · CLI Reference](../../adding-boards-and-tools.md#cli-reference) +- [H2 · Troubleshooting](../../adding-boards-and-tools.md#troubleshooting) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/agnostic-security.md b/docs/i18n/zh-CN/agnostic-security.md new file mode 100644 index 000000000..392f9623f --- /dev/null +++ b/docs/i18n/zh-CN/agnostic-security.md @@ -0,0 +1,46 @@ +# 本地化桥接文档:Agnostic Security + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../agnostic-security.md](../../agnostic-security.md) + +## 主题定位 + +- 类别:安全与治理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Core Question: Will security features break...](../../agnostic-security.md#core-question-will-security-features-break) +- [H2 · 1. Build Speed: Feature-Gated Security](../../agnostic-security.md#1-build-speed-feature-gated-security) +- [H3 · Cargo.toml: Security Features Behind Features](../../agnostic-security.md#cargo-toml-security-features-behind-features) +- [H3 · Build Commands (Choose Your Profile)](../../agnostic-security.md#build-commands-choose-your-profile) +- [H3 · Conditional Compilation: Zero Overhead When Disabled](../../agnostic-security.md#conditional-compilation-zero-overhead-when-disabled) +- [H2 · 2. Pluggable Architecture: Security Is a Trait Too](../../agnostic-security.md#2-pluggable-architecture-security-is-a-trait-too) +- [H3 · Security Backend Trait (Swappable Like Everything Else)](../../agnostic-security.md#security-backend-trait-swappable-like-everything-else) +- [H3 · Factory Pattern: Auto-Select Based on Features](../../agnostic-security.md#factory-pattern-auto-select-based-on-features) +- [H2 · 3. Hardware Agnosticism: Same Binary, Different Platforms](../../agnostic-security.md#3-hardware-agnosticism-same-binary-different-platforms) +- [H3 · Cross-Platform Behavior Matrix](../../agnostic-security.md#cross-platform-behavior-matrix) +- [H3 · How It Works: Runtime Detection](../../agnostic-security.md#how-it-works-runtime-detection) +- [H2 · 4. Small Hardware: Memory Impact Analysis](../../agnostic-security.md#4-small-hardware-memory-impact-analysis) +- [H3 · Binary Size Impact (Estimated)](../../agnostic-security.md#binary-size-impact-estimated) +- [H3 · $10 Hardware Compatibility](../../agnostic-security.md#10-hardware-compatibility) +- [H2 · 5. Agnostic Swaps: Everything Remains Pluggable](../../agnostic-security.md#5-agnostic-swaps-everything-remains-pluggable) +- [H3 · ZeroClaw's Core Promise: Swap Anything](../../agnostic-security.md#zeroclaw-s-core-promise-swap-anything) +- [H3 · Swap Security Backends via Config](../../agnostic-security.md#swap-security-backends-via-config) +- [H2 · 6. Dependency Impact: Minimal New Deps](../../agnostic-security.md#6-dependency-impact-minimal-new-deps) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/android-setup.md b/docs/i18n/zh-CN/android-setup.md new file mode 100644 index 000000000..fc2e493cd --- /dev/null +++ b/docs/i18n/zh-CN/android-setup.md @@ -0,0 +1,40 @@ +# 本地化桥接文档:Android Setup + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../android-setup.md](../../android-setup.md) + +## 主题定位 + +- 类别:硬件与外设 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Supported Architectures](../../android-setup.md#supported-architectures) +- [H2 · Installation via Termux](../../android-setup.md#installation-via-termux) +- [H3 · 1. Install Termux](../../android-setup.md#1-install-termux) +- [H3 · 2. Download ZeroClaw](../../android-setup.md#2-download-zeroclaw) +- [H3 · 3. Install and Run](../../android-setup.md#3-install-and-run) +- [H2 · Direct Installation via ADB](../../android-setup.md#direct-installation-via-adb) +- [H2 · Limitations on Android](../../android-setup.md#limitations-on-android) +- [H2 · Building from Source](../../android-setup.md#building-from-source) +- [H2 · Troubleshooting](../../android-setup.md#troubleshooting) +- [H3 · "Permission denied"](../../android-setup.md#permission-denied) +- [H3 · "not found" or linker errors](../../android-setup.md#not-found-or-linker-errors) +- [H3 · Old Android (4.x)](../../android-setup.md#old-android-4-x) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/arduino-uno-q-setup.md b/docs/i18n/zh-CN/arduino-uno-q-setup.md new file mode 100644 index 000000000..714eaac6b --- /dev/null +++ b/docs/i18n/zh-CN/arduino-uno-q-setup.md @@ -0,0 +1,46 @@ +# 本地化桥接文档:Arduino Uno Q Setup + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../arduino-uno-q-setup.md](../../arduino-uno-q-setup.md) + +## 主题定位 + +- 类别:硬件与外设 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · What's Included (No Code Changes Needed)](../../arduino-uno-q-setup.md#what-s-included-no-code-changes-needed) +- [H2 · Prerequisites](../../arduino-uno-q-setup.md#prerequisites) +- [H2 · Phase 1: Initial Uno Q Setup (One-Time)](../../arduino-uno-q-setup.md#phase-1-initial-uno-q-setup-one-time) +- [H3 · 1.1 Configure Uno Q via App Lab](../../arduino-uno-q-setup.md#1-1-configure-uno-q-via-app-lab) +- [H3 · 1.2 Verify SSH Access](../../arduino-uno-q-setup.md#1-2-verify-ssh-access) +- [H2 · Phase 2: Install ZeroClaw on Uno Q](../../arduino-uno-q-setup.md#phase-2-install-zeroclaw-on-uno-q) +- [H3 · Option A: Build on the Device (Simpler, ~20–40 min)](../../arduino-uno-q-setup.md#option-a-build-on-the-device-simpler-20-40-min) +- [H3 · Option B: Cross-Compile on Mac (Faster)](../../arduino-uno-q-setup.md#option-b-cross-compile-on-mac-faster) +- [H2 · Phase 3: Configure ZeroClaw](../../arduino-uno-q-setup.md#phase-3-configure-zeroclaw) +- [H3 · 3.1 Run Onboard (or Create Config Manually)](../../arduino-uno-q-setup.md#3-1-run-onboard-or-create-config-manually) +- [H3 · 3.2 Minimal config.toml](../../arduino-uno-q-setup.md#3-2-minimal-config-toml) +- [H2 · Phase 4: Run ZeroClaw Daemon](../../arduino-uno-q-setup.md#phase-4-run-zeroclaw-daemon) +- [H2 · Phase 5: GPIO via Bridge (ZeroClaw Handles It)](../../arduino-uno-q-setup.md#phase-5-gpio-via-bridge-zeroclaw-handles-it) +- [H3 · 5.1 Deploy Bridge App](../../arduino-uno-q-setup.md#5-1-deploy-bridge-app) +- [H3 · 5.2 Add to config.toml](../../arduino-uno-q-setup.md#5-2-add-to-config-toml) +- [H3 · 5.3 Run ZeroClaw](../../arduino-uno-q-setup.md#5-3-run-zeroclaw) +- [H2 · Summary: Commands Start to End](../../arduino-uno-q-setup.md#summary-commands-start-to-end) +- [H2 · Troubleshooting](../../arduino-uno-q-setup.md#troubleshooting) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/audit-event-schema.md b/docs/i18n/zh-CN/audit-event-schema.md new file mode 100644 index 000000000..5705f6571 --- /dev/null +++ b/docs/i18n/zh-CN/audit-event-schema.md @@ -0,0 +1,32 @@ +# 本地化桥接文档:Audit Event Schema + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../audit-event-schema.md](../../audit-event-schema.md) + +## 主题定位 + +- 类别:安全与治理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Envelope](../../audit-event-schema.md#envelope) +- [H2 · Event Types](../../audit-event-schema.md#event-types) +- [H2 · Retention Policy](../../audit-event-schema.md#retention-policy) +- [H2 · Governance](../../audit-event-schema.md#governance) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/audit-logging.md b/docs/i18n/zh-CN/audit-logging.md new file mode 100644 index 000000000..e74bc21ee --- /dev/null +++ b/docs/i18n/zh-CN/audit-logging.md @@ -0,0 +1,35 @@ +# 本地化桥接文档:Audit Logging + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../audit-logging.md](../../audit-logging.md) + +## 主题定位 + +- 类别:安全与治理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Problem](../../audit-logging.md#problem) +- [H2 · Proposed Audit Log Format](../../audit-logging.md#proposed-audit-log-format) +- [H2 · Implementation](../../audit-logging.md#implementation) +- [H2 · Config Schema](../../audit-logging.md#config-schema) +- [H2 · Audit Query CLI](../../audit-logging.md#audit-query-cli) +- [H2 · Log Rotation](../../audit-logging.md#log-rotation) +- [H2 · Implementation Priority](../../audit-logging.md#implementation-priority) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/cargo-slicer-speedup.md b/docs/i18n/zh-CN/cargo-slicer-speedup.md new file mode 100644 index 000000000..33e9203de --- /dev/null +++ b/docs/i18n/zh-CN/cargo-slicer-speedup.md @@ -0,0 +1,32 @@ +# 本地化桥接文档:Cargo Slicer Speedup + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../cargo-slicer-speedup.md](../../cargo-slicer-speedup.md) + +## 主题定位 + +- 类别:工程流程与项目管理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Benchmark Results](../../cargo-slicer-speedup.md#benchmark-results) +- [H2 · CI Integration](../../cargo-slicer-speedup.md#ci-integration) +- [H2 · Local Usage](../../cargo-slicer-speedup.md#local-usage) +- [H2 · How It Works](../../cargo-slicer-speedup.md#how-it-works) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/channels-reference.md b/docs/i18n/zh-CN/channels-reference.md new file mode 100644 index 000000000..ee6aa0828 --- /dev/null +++ b/docs/i18n/zh-CN/channels-reference.md @@ -0,0 +1,18 @@ +# Channel 参考(简体中文) + +这是 Wave 1 首版本地化页面,用于查阅各通信渠道能力与配置路径。 + +英文原文: + +- [../../channels-reference.md](../../channels-reference.md) + +## 适用场景 + +- 了解 Telegram/Discord/Slack 等渠道能力差异 +- 确认 allowlist、安全边界与接入前置条件 +- 排查渠道消息收发问题 + +## 使用建议 + +- 通道标识、配置键与 API 路径保持英文。 +- 具体行为定义以英文原文为准。 diff --git a/docs/i18n/zh-CN/ci-map.md b/docs/i18n/zh-CN/ci-map.md new file mode 100644 index 000000000..48576aa38 --- /dev/null +++ b/docs/i18n/zh-CN/ci-map.md @@ -0,0 +1,36 @@ +# 本地化桥接文档:Ci Map + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../ci-map.md](../../ci-map.md) + +## 主题定位 + +- 类别:工程流程与项目管理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Merge-Blocking vs Optional](../../ci-map.md#merge-blocking-vs-optional) +- [H3 · Merge-Blocking](../../ci-map.md#merge-blocking) +- [H3 · Non-Blocking but Important](../../ci-map.md#non-blocking-but-important) +- [H3 · Optional Repository Automation](../../ci-map.md#optional-repository-automation) +- [H2 · Trigger Map](../../ci-map.md#trigger-map) +- [H2 · Fast Triage Guide](../../ci-map.md#fast-triage-guide) +- [H2 · Maintenance Rules](../../ci-map.md#maintenance-rules) +- [H2 · Automation Side-Effect Controls](../../ci-map.md#automation-side-effect-controls) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/commands-reference.md b/docs/i18n/zh-CN/commands-reference.md new file mode 100644 index 000000000..8d40c7dfa --- /dev/null +++ b/docs/i18n/zh-CN/commands-reference.md @@ -0,0 +1,18 @@ +# 命令参考(简体中文) + +这是 Wave 1 首版本地化页面,用于快速定位 ZeroClaw CLI 命令。 + +英文原文: + +- [../../commands-reference.md](../../commands-reference.md) + +## 适用场景 + +- 按任务查命令(onboard / status / doctor / channel 等) +- 对比命令参数与行为边界 +- 排查命令执行异常时确认预期输出 + +## 使用建议 + +- 命令名、参数名、配置键保持英文。 +- 行为细节以英文原文为准。 diff --git a/docs/i18n/zh-CN/config-reference.md b/docs/i18n/zh-CN/config-reference.md new file mode 100644 index 000000000..8e42e87b0 --- /dev/null +++ b/docs/i18n/zh-CN/config-reference.md @@ -0,0 +1,18 @@ +# 配置参考(简体中文) + +这是 Wave 1 首版本地化页面,用于查阅核心配置键、默认值与风险边界。 + +英文原文: + +- [../../config-reference.md](../../config-reference.md) + +## 适用场景 + +- 新环境初始化配置 +- 排查配置项冲突与回退策略 +- 审核安全相关配置与默认值 + +## 使用建议 + +- 配置键保持英文,避免本地化改写键名。 +- 生产行为以英文原文定义为准。 diff --git a/docs/i18n/zh-CN/custom-providers.md b/docs/i18n/zh-CN/custom-providers.md new file mode 100644 index 000000000..9fe9caf61 --- /dev/null +++ b/docs/i18n/zh-CN/custom-providers.md @@ -0,0 +1,46 @@ +# 本地化桥接文档:Custom Providers + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../custom-providers.md](../../custom-providers.md) + +## 主题定位 + +- 类别:Provider 与集成 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Provider Types](../../custom-providers.md#provider-types) +- [H3 · OpenAI-Compatible Endpoints (`custom:`)](../../custom-providers.md#openai-compatible-endpoints-custom) +- [H3 · Anthropic-Compatible Endpoints (`anthropic-custom:`)](../../custom-providers.md#anthropic-compatible-endpoints-anthropic-custom) +- [H2 · Configuration Methods](../../custom-providers.md#configuration-methods) +- [H3 · Config File](../../custom-providers.md#config-file) +- [H3 · Environment Variables](../../custom-providers.md#environment-variables) +- [H2 · llama.cpp Server (Recommended Local Setup)](../../custom-providers.md#llama-cpp-server-recommended-local-setup) +- [H2 · SGLang Server](../../custom-providers.md#sglang-server) +- [H2 · vLLM Server](../../custom-providers.md#vllm-server) +- [H2 · Testing Configuration](../../custom-providers.md#testing-configuration) +- [H2 · Troubleshooting](../../custom-providers.md#troubleshooting) +- [H3 · Authentication Errors](../../custom-providers.md#authentication-errors) +- [H3 · Model Not Found](../../custom-providers.md#model-not-found) +- [H3 · Connection Issues](../../custom-providers.md#connection-issues) +- [H2 · Examples](../../custom-providers.md#examples) +- [H3 · Local LLM Server (Generic Custom Endpoint)](../../custom-providers.md#local-llm-server-generic-custom-endpoint) +- [H3 · Corporate Proxy](../../custom-providers.md#corporate-proxy) +- [H3 · Cloud Provider Gateway](../../custom-providers.md#cloud-provider-gateway) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/doc-template.md b/docs/i18n/zh-CN/doc-template.md new file mode 100644 index 000000000..8979a6722 --- /dev/null +++ b/docs/i18n/zh-CN/doc-template.md @@ -0,0 +1,38 @@ +# 本地化桥接文档:Doc Template + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../doc-template.md](../../doc-template.md) + +## 主题定位 + +- 类别:工程流程与项目管理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · 1. Summary](../../doc-template.md#1-summary) +- [H2 · 2. Prerequisites](../../doc-template.md#2-prerequisites) +- [H2 · 3. Procedure](../../doc-template.md#3-procedure) +- [H3 · 3.1 Baseline Check](../../doc-template.md#3-1-baseline-check) +- [H3 · 3.2 Main Workflow](../../doc-template.md#3-2-main-workflow) +- [H3 · 3.3 Verification](../../doc-template.md#3-3-verification) +- [H2 · 4. Safety, Risk, and Rollback](../../doc-template.md#4-safety-risk-and-rollback) +- [H2 · 5. Troubleshooting](../../doc-template.md#5-troubleshooting) +- [H2 · 6. Related Docs](../../doc-template.md#6-related-docs) +- [H2 · 7. Maintenance Notes](../../doc-template.md#7-maintenance-notes) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/docs-audit-2026-02-24.md b/docs/i18n/zh-CN/docs-audit-2026-02-24.md new file mode 100644 index 000000000..0aad1fbcd --- /dev/null +++ b/docs/i18n/zh-CN/docs-audit-2026-02-24.md @@ -0,0 +1,42 @@ +# 本地化桥接文档:Docs Audit 2026 02 24 + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../docs-audit-2026-02-24.md](../../docs-audit-2026-02-24.md) + +## 主题定位 + +- 类别:工程流程与项目管理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · 1) Audit Method](../../docs-audit-2026-02-24.md#1-audit-method) +- [H2 · 2) Findings](../../docs-audit-2026-02-24.md#2-findings) +- [H3 · A. Structural clarity gaps](../../docs-audit-2026-02-24.md#a-structural-clarity-gaps) +- [H3 · B. Completeness gaps](../../docs-audit-2026-02-24.md#b-completeness-gaps) +- [H3 · C. Integrity issues](../../docs-audit-2026-02-24.md#c-integrity-issues) +- [H2 · 3) Remediation Applied](../../docs-audit-2026-02-24.md#3-remediation-applied) +- [H3 · 3.1 Navigation and governance](../../docs-audit-2026-02-24.md#3-1-navigation-and-governance) +- [H3 · 3.2 Directory completeness](../../docs-audit-2026-02-24.md#3-2-directory-completeness) +- [H3 · 3.3 Compatibility cleanup](../../docs-audit-2026-02-24.md#3-3-compatibility-cleanup) +- [H3 · 3.4 Broken link fixes](../../docs-audit-2026-02-24.md#3-4-broken-link-fixes) +- [H2 · 4) Current Known Remaining Gaps](../../docs-audit-2026-02-24.md#4-current-known-remaining-gaps) +- [H2 · 5) Recommended Next Wave](../../docs-audit-2026-02-24.md#5-recommended-next-wave) +- [H2 · 6) Validation Status](../../docs-audit-2026-02-24.md#6-validation-status) +- [H2 · Addendum (Phase-2 Deep Completion)](../../docs-audit-2026-02-24.md#addendum-phase-2-deep-completion) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/docs-inventory.md b/docs/i18n/zh-CN/docs-inventory.md new file mode 100644 index 000000000..2d46c0afe --- /dev/null +++ b/docs/i18n/zh-CN/docs-inventory.md @@ -0,0 +1,74 @@ +# 文档清单(简体中文) + +该页面用于在 `docs/i18n/zh-CN/` 下快速定位所有 top-level 文档。 + +最后更新:**2026-02-24**。 +当前状态:**top-level parity 完成(40/40)**。 + +## 规范来源 + +- 英文总清单:[../../docs-inventory.md](../../docs-inventory.md) +- i18n 指南:[i18n-guide.md](i18n-guide.md) +- i18n 覆盖:[i18n-coverage.md](i18n-coverage.md) + +## 运行与接入 + +- [commands-reference.md](commands-reference.md) +- [config-reference.md](config-reference.md) +- [providers-reference.md](providers-reference.md) +- [channels-reference.md](channels-reference.md) +- [operations-runbook.md](operations-runbook.md) +- [troubleshooting.md](troubleshooting.md) +- [one-click-bootstrap.md](one-click-bootstrap.md) +- [network-deployment.md](network-deployment.md) +- [mattermost-setup.md](mattermost-setup.md) +- [nextcloud-talk-setup.md](nextcloud-talk-setup.md) +- [matrix-e2ee-guide.md](matrix-e2ee-guide.md) + +## Provider 与集成 + +- [custom-providers.md](custom-providers.md) +- [zai-glm-setup.md](zai-glm-setup.md) +- [langgraph-integration.md](langgraph-integration.md) +- [proxy-agent-playbook.md](proxy-agent-playbook.md) + +## 硬件与外设 + +- [hardware-peripherals-design.md](hardware-peripherals-design.md) +- [adding-boards-and-tools.md](adding-boards-and-tools.md) +- [android-setup.md](android-setup.md) +- [arduino-uno-q-setup.md](arduino-uno-q-setup.md) +- [nucleo-setup.md](nucleo-setup.md) + +## 安全与治理 + +- [agnostic-security.md](agnostic-security.md) +- [frictionless-security.md](frictionless-security.md) +- [audit-logging.md](audit-logging.md) +- [audit-event-schema.md](audit-event-schema.md) +- [sandboxing.md](sandboxing.md) +- [resource-limits.md](resource-limits.md) +- [security-roadmap.md](security-roadmap.md) +- [actions-source-policy.md](actions-source-policy.md) + +## 工程流程与项目管理 + +- [pr-workflow.md](pr-workflow.md) +- [reviewer-playbook.md](reviewer-playbook.md) +- [ci-map.md](ci-map.md) +- [release-process.md](release-process.md) +- [cargo-slicer-speedup.md](cargo-slicer-speedup.md) +- [project-triage-snapshot-2026-02-18.md](project-triage-snapshot-2026-02-18.md) +- [docs-audit-2026-02-24.md](docs-audit-2026-02-24.md) +- [doc-template.md](doc-template.md) + +## i18n 治理 + +- [i18n-guide.md](i18n-guide.md) +- [i18n-coverage.md](i18n-coverage.md) +- [i18n-gap-backlog.md](i18n-gap-backlog.md) + +## 使用规则 + +- 命令、配置键、API 路径、代码标识保持英文。 +- 实现细节与行为约束以英文原文为准。 diff --git a/docs/i18n/zh-CN/frictionless-security.md b/docs/i18n/zh-CN/frictionless-security.md new file mode 100644 index 000000000..493d8664a --- /dev/null +++ b/docs/i18n/zh-CN/frictionless-security.md @@ -0,0 +1,43 @@ +# 本地化桥接文档:Frictionless Security + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../frictionless-security.md](../../frictionless-security.md) + +## 主题定位 + +- 类别:安全与治理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Core Principle](../../frictionless-security.md#core-principle) +- [H2 · Design: Silent Auto-Detection](../../frictionless-security.md#design-silent-auto-detection) +- [H3 · 1. No New Wizard Steps (Stays 9 Steps, < 60 Seconds)](../../frictionless-security.md#1-no-new-wizard-steps-stays-9-steps-60-seconds) +- [H3 · 2. Auto-Detection Logic (Runs Once at First Start)](../../frictionless-security.md#2-auto-detection-logic-runs-once-at-first-start) +- [H3 · 3. First Run: Silent Logging](../../frictionless-security.md#3-first-run-silent-logging) +- [H3 · 4. Config File: All Defaults Hidden](../../frictionless-security.md#4-config-file-all-defaults-hidden) +- [H3 · 5. Advanced Users: Explicit Control](../../frictionless-security.md#5-advanced-users-explicit-control) +- [H3 · 6. Graceful Degradation](../../frictionless-security.md#6-graceful-degradation) +- [H2 · Config Schema Extension](../../frictionless-security.md#config-schema-extension) +- [H2 · User Experience Comparison](../../frictionless-security.md#user-experience-comparison) +- [H3 · Before (Current)](../../frictionless-security.md#before-current) +- [H3 · After (With Frictionless Security)](../../frictionless-security.md#after-with-frictionless-security) +- [H3 · Advanced User (Explicit Control)](../../frictionless-security.md#advanced-user-explicit-control) +- [H2 · Backward Compatibility](../../frictionless-security.md#backward-compatibility) +- [H2 · Summary](../../frictionless-security.md#summary) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/hardware-peripherals-design.md b/docs/i18n/zh-CN/hardware-peripherals-design.md new file mode 100644 index 000000000..54d35802d --- /dev/null +++ b/docs/i18n/zh-CN/hardware-peripherals-design.md @@ -0,0 +1,46 @@ +# 本地化桥接文档:Hardware Peripherals Design + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../hardware-peripherals-design.md](../../hardware-peripherals-design.md) + +## 主题定位 + +- 类别:硬件与外设 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · 1. Vision](../../hardware-peripherals-design.md#1-vision) +- [H2 · 2. Two Modes of Operation](../../hardware-peripherals-design.md#2-two-modes-of-operation) +- [H3 · Mode 1: Edge-Native (Standalone)](../../hardware-peripherals-design.md#mode-1-edge-native-standalone) +- [H3 · Mode 2: Host-Mediated (Development / Debugging)](../../hardware-peripherals-design.md#mode-2-host-mediated-development-debugging) +- [H3 · Mode Comparison](../../hardware-peripherals-design.md#mode-comparison) +- [H2 · 3. Legacy / Simpler Modes (Pre-LLM-on-Edge)](../../hardware-peripherals-design.md#3-legacy-simpler-modes-pre-llm-on-edge) +- [H3 · Mode A: Host + Remote Peripheral (STM32 via serial)](../../hardware-peripherals-design.md#mode-a-host-remote-peripheral-stm32-via-serial) +- [H3 · Mode B: RPi as Host (Native GPIO)](../../hardware-peripherals-design.md#mode-b-rpi-as-host-native-gpio) +- [H2 · 4. Technical Requirements](../../hardware-peripherals-design.md#4-technical-requirements) +- [H3 · RAG Pipeline (Datasheet Retrieval)](../../hardware-peripherals-design.md#rag-pipeline-datasheet-retrieval) +- [H3 · Dynamic Execution Options](../../hardware-peripherals-design.md#dynamic-execution-options) +- [H2 · 5. CLI and Config](../../hardware-peripherals-design.md#5-cli-and-config) +- [H3 · CLI Flags](../../hardware-peripherals-design.md#cli-flags) +- [H3 · Config (config.toml)](../../hardware-peripherals-design.md#config-config-toml) +- [H2 · 6. Architecture: Peripheral as Extension Point](../../hardware-peripherals-design.md#6-architecture-peripheral-as-extension-point) +- [H3 · New Trait: `Peripheral`](../../hardware-peripherals-design.md#new-trait-peripheral) +- [H3 · Flow](../../hardware-peripherals-design.md#flow) +- [H3 · Board Support](../../hardware-peripherals-design.md#board-support) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/i18n-coverage.md b/docs/i18n/zh-CN/i18n-coverage.md new file mode 100644 index 000000000..586134310 --- /dev/null +++ b/docs/i18n/zh-CN/i18n-coverage.md @@ -0,0 +1,36 @@ +# 本地化桥接文档:I18n Coverage + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../i18n-coverage.md](../../i18n-coverage.md) + +## 主题定位 + +- 类别:i18n 治理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Canonical Layout](../../i18n-coverage.md#canonical-layout) +- [H2 · Locale Coverage Matrix](../../i18n-coverage.md#locale-coverage-matrix) +- [H2 · Top-Level Parity Snapshot](../../i18n-coverage.md#top-level-parity-snapshot) +- [H2 · Root README Completeness](../../i18n-coverage.md#root-readme-completeness) +- [H2 · Collection Index i18n](../../i18n-coverage.md#collection-index-i18n) +- [H2 · Localization Rules](../../i18n-coverage.md#localization-rules) +- [H2 · Adding a New Locale](../../i18n-coverage.md#adding-a-new-locale) +- [H2 · Review Checklist](../../i18n-coverage.md#review-checklist) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/i18n-gap-backlog.md b/docs/i18n/zh-CN/i18n-gap-backlog.md new file mode 100644 index 000000000..bddf39c19 --- /dev/null +++ b/docs/i18n/zh-CN/i18n-gap-backlog.md @@ -0,0 +1,34 @@ +# 本地化桥接文档:I18n Gap Backlog + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../i18n-gap-backlog.md](../../i18n-gap-backlog.md) + +## 主题定位 + +- 类别:i18n 治理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Baseline Definition](../../i18n-gap-backlog.md#baseline-definition) +- [H2 · Current Gap Counts](../../i18n-gap-backlog.md#current-gap-counts) +- [H2 · Closure Record (2026-02-24)](../../i18n-gap-backlog.md#closure-record-2026-02-24) +- [H2 · Remaining Gaps (Baseline Scope)](../../i18n-gap-backlog.md#remaining-gaps-baseline-scope) +- [H2 · Optional Next Depth](../../i18n-gap-backlog.md#optional-next-depth) +- [H2 · Tracking Rules](../../i18n-gap-backlog.md#tracking-rules) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/i18n-guide.md b/docs/i18n/zh-CN/i18n-guide.md new file mode 100644 index 000000000..ed46d53d4 --- /dev/null +++ b/docs/i18n/zh-CN/i18n-guide.md @@ -0,0 +1,36 @@ +# 本地化桥接文档:I18n Guide + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../i18n-guide.md](../../i18n-guide.md) + +## 主题定位 + +- 类别:i18n 治理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Scope](../../i18n-guide.md#scope) +- [H2 · Canonical Layout](../../i18n-guide.md#canonical-layout) +- [H2 · Trigger Matrix](../../i18n-guide.md#trigger-matrix) +- [H2 · Completion Checklist (Mandatory)](../../i18n-guide.md#completion-checklist-mandatory) +- [H2 · Deferred Translation Policy](../../i18n-guide.md#deferred-translation-policy) +- [H2 · Agent Workflow Contract](../../i18n-guide.md#agent-workflow-contract) +- [H2 · Gap Tracking](../../i18n-guide.md#gap-tracking) +- [H2 · Quick Validation Commands](../../i18n-guide.md#quick-validation-commands) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/langgraph-integration.md b/docs/i18n/zh-CN/langgraph-integration.md new file mode 100644 index 000000000..5d00c4ffb --- /dev/null +++ b/docs/i18n/zh-CN/langgraph-integration.md @@ -0,0 +1,46 @@ +# 本地化桥接文档:Langgraph Integration + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../langgraph-integration.md](../../langgraph-integration.md) + +## 主题定位 + +- 类别:Provider 与集成 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Background](../../langgraph-integration.md#background) +- [H2 · Architecture](../../langgraph-integration.md#architecture) +- [H2 · Quick Start](../../langgraph-integration.md#quick-start) +- [H3 · Installation](../../langgraph-integration.md#installation) +- [H3 · Basic Usage](../../langgraph-integration.md#basic-usage) +- [H2 · Available Tools](../../langgraph-integration.md#available-tools) +- [H3 · Core Tools](../../langgraph-integration.md#core-tools) +- [H3 · Extended Tools](../../langgraph-integration.md#extended-tools) +- [H2 · Custom Tools](../../langgraph-integration.md#custom-tools) +- [H2 · Provider Configuration](../../langgraph-integration.md#provider-configuration) +- [H3 · Z.AI / GLM-5](../../langgraph-integration.md#z-ai-glm-5) +- [H3 · OpenRouter](../../langgraph-integration.md#openrouter) +- [H3 · Groq](../../langgraph-integration.md#groq) +- [H3 · Ollama (Local)](../../langgraph-integration.md#ollama-local) +- [H2 · Discord Bot Integration](../../langgraph-integration.md#discord-bot-integration) +- [H2 · CLI Usage](../../langgraph-integration.md#cli-usage) +- [H2 · Comparison with Rust ZeroClaw](../../langgraph-integration.md#comparison-with-rust-zeroclaw) +- [H2 · Troubleshooting](../../langgraph-integration.md#troubleshooting) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/matrix-e2ee-guide.md b/docs/i18n/zh-CN/matrix-e2ee-guide.md new file mode 100644 index 000000000..6cbccbdaf --- /dev/null +++ b/docs/i18n/zh-CN/matrix-e2ee-guide.md @@ -0,0 +1,42 @@ +# 本地化桥接文档:Matrix E2ee Guide + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../matrix-e2ee-guide.md](../../matrix-e2ee-guide.md) + +## 主题定位 + +- 类别:运行与接入 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · 0. Fast FAQ (#499-class symptom)](../../matrix-e2ee-guide.md#0-fast-faq-499-class-symptom) +- [H2 · 1. Requirements](../../matrix-e2ee-guide.md#1-requirements) +- [H2 · 2. Configuration](../../matrix-e2ee-guide.md#2-configuration) +- [H3 · About `user_id` and `device_id`](../../matrix-e2ee-guide.md#about-user-id-and-device-id) +- [H2 · 3. Quick Validation Flow](../../matrix-e2ee-guide.md#3-quick-validation-flow) +- [H2 · 4. Troubleshooting “No Response”](../../matrix-e2ee-guide.md#4-troubleshooting-no-response) +- [H3 · A. Room and membership](../../matrix-e2ee-guide.md#a-room-and-membership) +- [H3 · B. Sender allowlist](../../matrix-e2ee-guide.md#b-sender-allowlist) +- [H3 · C. Token and identity](../../matrix-e2ee-guide.md#c-token-and-identity) +- [H3 · D. E2EE-specific checks](../../matrix-e2ee-guide.md#d-e2ee-specific-checks) +- [H3 · E. Message formatting (Markdown)](../../matrix-e2ee-guide.md#e-message-formatting-markdown) +- [H3 · F. Fresh start test](../../matrix-e2ee-guide.md#f-fresh-start-test) +- [H2 · 5. Operational Notes](../../matrix-e2ee-guide.md#5-operational-notes) +- [H2 · 6. Related Docs](../../matrix-e2ee-guide.md#6-related-docs) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/mattermost-setup.md b/docs/i18n/zh-CN/mattermost-setup.md new file mode 100644 index 000000000..edf7d1cec --- /dev/null +++ b/docs/i18n/zh-CN/mattermost-setup.md @@ -0,0 +1,34 @@ +# 本地化桥接文档:Mattermost Setup + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../mattermost-setup.md](../../mattermost-setup.md) + +## 主题定位 + +- 类别:运行与接入 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Prerequisites](../../mattermost-setup.md#prerequisites) +- [H2 · Configuration](../../mattermost-setup.md#configuration) +- [H3 · Configuration Fields](../../mattermost-setup.md#configuration-fields) +- [H2 · Threaded Conversations](../../mattermost-setup.md#threaded-conversations) +- [H2 · Mention-Only Mode](../../mattermost-setup.md#mention-only-mode) +- [H2 · Security Note](../../mattermost-setup.md#security-note) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/network-deployment.md b/docs/i18n/zh-CN/network-deployment.md new file mode 100644 index 000000000..70731e10d --- /dev/null +++ b/docs/i18n/zh-CN/network-deployment.md @@ -0,0 +1,46 @@ +# 本地化桥接文档:Network Deployment + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../network-deployment.md](../../network-deployment.md) + +## 主题定位 + +- 类别:运行与接入 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · 1. Overview](../../network-deployment.md#1-overview) +- [H2 · 2. ZeroClaw on Raspberry Pi](../../network-deployment.md#2-zeroclaw-on-raspberry-pi) +- [H3 · 2.1 Prerequisites](../../network-deployment.md#2-1-prerequisites) +- [H3 · 2.2 Install](../../network-deployment.md#2-2-install) +- [H3 · 2.3 Config](../../network-deployment.md#2-3-config) +- [H3 · 2.4 Run Daemon (Local Only)](../../network-deployment.md#2-4-run-daemon-local-only) +- [H2 · 3. Binding to 0.0.0.0 (Local Network)](../../network-deployment.md#3-binding-to-0-0-0-0-local-network) +- [H3 · 3.1 Option A: Explicit Opt-In](../../network-deployment.md#3-1-option-a-explicit-opt-in) +- [H3 · 3.2 Option B: Tunnel (Recommended for Webhooks)](../../network-deployment.md#3-2-option-b-tunnel-recommended-for-webhooks) +- [H2 · 4. Telegram Polling (No Inbound Port)](../../network-deployment.md#4-telegram-polling-no-inbound-port) +- [H3 · 4.1 Single Poller Rule (Important)](../../network-deployment.md#4-1-single-poller-rule-important) +- [H2 · 5. Webhook Channels (WhatsApp, Nextcloud Talk, Custom)](../../network-deployment.md#5-webhook-channels-whatsapp-nextcloud-talk-custom) +- [H3 · 5.1 Tailscale Funnel](../../network-deployment.md#5-1-tailscale-funnel) +- [H3 · 5.2 ngrok](../../network-deployment.md#5-2-ngrok) +- [H3 · 5.3 Cloudflare Tunnel](../../network-deployment.md#5-3-cloudflare-tunnel) +- [H2 · 6. Checklist: RPi Deployment](../../network-deployment.md#6-checklist-rpi-deployment) +- [H2 · 7. OpenRC (Alpine Linux Service)](../../network-deployment.md#7-openrc-alpine-linux-service) +- [H3 · 7.1 Prerequisites](../../network-deployment.md#7-1-prerequisites) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/nextcloud-talk-setup.md b/docs/i18n/zh-CN/nextcloud-talk-setup.md new file mode 100644 index 000000000..00dfcb2e9 --- /dev/null +++ b/docs/i18n/zh-CN/nextcloud-talk-setup.md @@ -0,0 +1,35 @@ +# 本地化桥接文档:Nextcloud Talk Setup + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../nextcloud-talk-setup.md](../../nextcloud-talk-setup.md) + +## 主题定位 + +- 类别:运行与接入 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · 1. What this integration does](../../nextcloud-talk-setup.md#1-what-this-integration-does) +- [H2 · 2. Configuration](../../nextcloud-talk-setup.md#2-configuration) +- [H2 · 3. Gateway endpoint](../../nextcloud-talk-setup.md#3-gateway-endpoint) +- [H2 · 4. Signature verification contract](../../nextcloud-talk-setup.md#4-signature-verification-contract) +- [H2 · 5. Message routing behavior](../../nextcloud-talk-setup.md#5-message-routing-behavior) +- [H2 · 6. Quick validation checklist](../../nextcloud-talk-setup.md#6-quick-validation-checklist) +- [H2 · 7. Troubleshooting](../../nextcloud-talk-setup.md#7-troubleshooting) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/nucleo-setup.md b/docs/i18n/zh-CN/nucleo-setup.md new file mode 100644 index 000000000..cf242c35f --- /dev/null +++ b/docs/i18n/zh-CN/nucleo-setup.md @@ -0,0 +1,40 @@ +# 本地化桥接文档:Nucleo Setup + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../nucleo-setup.md](../../nucleo-setup.md) + +## 主题定位 + +- 类别:硬件与外设 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Get Board Info via Telegram (No Firmware Needed)](../../nucleo-setup.md#get-board-info-via-telegram-no-firmware-needed) +- [H2 · What's Included (No Code Changes Needed)](../../nucleo-setup.md#what-s-included-no-code-changes-needed) +- [H2 · Prerequisites](../../nucleo-setup.md#prerequisites) +- [H2 · Phase 1: Flash Firmware](../../nucleo-setup.md#phase-1-flash-firmware) +- [H3 · 1.1 Connect Nucleo](../../nucleo-setup.md#1-1-connect-nucleo) +- [H3 · 1.2 Flash via ZeroClaw](../../nucleo-setup.md#1-2-flash-via-zeroclaw) +- [H3 · 1.3 Manual Flash (Alternative)](../../nucleo-setup.md#1-3-manual-flash-alternative) +- [H2 · Phase 2: Find Serial Port](../../nucleo-setup.md#phase-2-find-serial-port) +- [H2 · Phase 3: Configure ZeroClaw](../../nucleo-setup.md#phase-3-configure-zeroclaw) +- [H2 · Phase 4: Run and Test](../../nucleo-setup.md#phase-4-run-and-test) +- [H2 · Summary: Commands](../../nucleo-setup.md#summary-commands) +- [H2 · Troubleshooting](../../nucleo-setup.md#troubleshooting) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/one-click-bootstrap.md b/docs/i18n/zh-CN/one-click-bootstrap.md new file mode 100644 index 000000000..fdcd53771 --- /dev/null +++ b/docs/i18n/zh-CN/one-click-bootstrap.md @@ -0,0 +1,39 @@ +# 本地化桥接文档:One Click Bootstrap + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../one-click-bootstrap.md](../../one-click-bootstrap.md) + +## 主题定位 + +- 类别:运行与接入 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Option 0: Homebrew (macOS/Linuxbrew)](../../one-click-bootstrap.md#option-0-homebrew-macos-linuxbrew) +- [H2 · Option A (Recommended): Clone + local script](../../one-click-bootstrap.md#option-a-recommended-clone-local-script) +- [H3 · Resource preflight and pre-built flow](../../one-click-bootstrap.md#resource-preflight-and-pre-built-flow) +- [H2 · Dual-mode bootstrap](../../one-click-bootstrap.md#dual-mode-bootstrap) +- [H2 · Option B: Remote one-liner](../../one-click-bootstrap.md#option-b-remote-one-liner) +- [H2 · Optional onboarding modes](../../one-click-bootstrap.md#optional-onboarding-modes) +- [H3 · Containerized onboarding (Docker)](../../one-click-bootstrap.md#containerized-onboarding-docker) +- [H3 · Quick onboarding (non-interactive)](../../one-click-bootstrap.md#quick-onboarding-non-interactive) +- [H3 · Interactive onboarding](../../one-click-bootstrap.md#interactive-onboarding) +- [H2 · Useful flags](../../one-click-bootstrap.md#useful-flags) +- [H2 · Related docs](../../one-click-bootstrap.md#related-docs) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/operations-runbook.md b/docs/i18n/zh-CN/operations-runbook.md new file mode 100644 index 000000000..82bc230d0 --- /dev/null +++ b/docs/i18n/zh-CN/operations-runbook.md @@ -0,0 +1,18 @@ +# 运维 Runbook(简体中文) + +这是 Wave 1 首版本地化页面,用于日常运维(Day-2)流程导航。 + +英文原文: + +- [../../operations-runbook.md](../../operations-runbook.md) + +## 适用场景 + +- 变更前后健康检查 +- 服务重启、回滚与稳定性验证 +- 运维异常的标准处置路径 + +## 使用建议 + +- 运维命令与系统键名保持英文。 +- 生产操作步骤以英文原文为准。 diff --git a/docs/i18n/zh-CN/pr-workflow.md b/docs/i18n/zh-CN/pr-workflow.md new file mode 100644 index 000000000..aba0044e1 --- /dev/null +++ b/docs/i18n/zh-CN/pr-workflow.md @@ -0,0 +1,46 @@ +# 本地化桥接文档:Pr Workflow + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../pr-workflow.md](../../pr-workflow.md) + +## 主题定位 + +- 类别:工程流程与项目管理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · 0. Summary](../../pr-workflow.md#0-summary) +- [H2 · 1. Fast Path by PR Situation](../../pr-workflow.md#1-fast-path-by-pr-situation) +- [H3 · 1.1 Intake is incomplete](../../pr-workflow.md#1-1-intake-is-incomplete) +- [H3 · 1.2 `CI Required Gate` failing](../../pr-workflow.md#1-2-ci-required-gate-failing) +- [H3 · 1.3 High-risk path touched](../../pr-workflow.md#1-3-high-risk-path-touched) +- [H3 · 1.4 PR is superseded or duplicate](../../pr-workflow.md#1-4-pr-is-superseded-or-duplicate) +- [H2 · 2. Governance Goals and Control Loop](../../pr-workflow.md#2-governance-goals-and-control-loop) +- [H3 · 2.1 Governance goals](../../pr-workflow.md#2-1-governance-goals) +- [H3 · 2.2 Governance design logic (control loop)](../../pr-workflow.md#2-2-governance-design-logic-control-loop) +- [H2 · 3. Required Repository Settings](../../pr-workflow.md#3-required-repository-settings) +- [H2 · 4. PR Lifecycle Runbook](../../pr-workflow.md#4-pr-lifecycle-runbook) +- [H3 · 4.1 Step A: Intake](../../pr-workflow.md#4-1-step-a-intake) +- [H3 · 4.2 Step B: Validation](../../pr-workflow.md#4-2-step-b-validation) +- [H3 · 4.3 Step C: Review](../../pr-workflow.md#4-3-step-c-review) +- [H3 · 4.4 Step D: Merge](../../pr-workflow.md#4-4-step-d-merge) +- [H2 · 5. PR Readiness Contracts (DoR / DoD)](../../pr-workflow.md#5-pr-readiness-contracts-dor-dod) +- [H3 · 5.1 Definition of Ready (DoR) before requesting review](../../pr-workflow.md#5-1-definition-of-ready-dor-before-requesting-review) +- [H3 · 5.2 Definition of Done (DoD) merge-ready](../../pr-workflow.md#5-2-definition-of-done-dod-merge-ready) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/project-triage-snapshot-2026-02-18.md b/docs/i18n/zh-CN/project-triage-snapshot-2026-02-18.md new file mode 100644 index 000000000..f6dded5de --- /dev/null +++ b/docs/i18n/zh-CN/project-triage-snapshot-2026-02-18.md @@ -0,0 +1,36 @@ +# 本地化桥接文档:Project Triage Snapshot 2026 02 18 + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../project-triage-snapshot-2026-02-18.md](../../project-triage-snapshot-2026-02-18.md) + +## 主题定位 + +- 类别:工程流程与项目管理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Data Source](../../project-triage-snapshot-2026-02-18.md#data-source) +- [H2 · Repository Pulse](../../project-triage-snapshot-2026-02-18.md#repository-pulse) +- [H2 · PR Label Pressure (Open PRs)](../../project-triage-snapshot-2026-02-18.md#pr-label-pressure-open-prs) +- [H2 · Issue Label Pressure (Open Issues)](../../project-triage-snapshot-2026-02-18.md#issue-label-pressure-open-issues) +- [H2 · Docs-Relevant Open PRs](../../project-triage-snapshot-2026-02-18.md#docs-relevant-open-prs) +- [H2 · Docs-Relevant Open Issues](../../project-triage-snapshot-2026-02-18.md#docs-relevant-open-issues) +- [H2 · Recommended Docs Backlog (Priority Order)](../../project-triage-snapshot-2026-02-18.md#recommended-docs-backlog-priority-order) +- [H2 · Snapshot Caveat](../../project-triage-snapshot-2026-02-18.md#snapshot-caveat) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/providers-reference.md b/docs/i18n/zh-CN/providers-reference.md new file mode 100644 index 000000000..bb6268b00 --- /dev/null +++ b/docs/i18n/zh-CN/providers-reference.md @@ -0,0 +1,18 @@ +# Provider 参考(简体中文) + +这是 Wave 1 首版本地化页面,用于快速查阅 provider 标识、别名与认证变量。 + +英文原文: + +- [../../providers-reference.md](../../providers-reference.md) + +## 适用场景 + +- 选择 provider 与模型接入路径 +- 核对 provider ID / alias / 环境变量 +- 处理 provider 配置错误与鉴权问题 + +## 使用建议 + +- Provider ID 与环境变量名称保持英文。 +- 规范与行为说明以英文原文为准。 diff --git a/docs/i18n/zh-CN/proxy-agent-playbook.md b/docs/i18n/zh-CN/proxy-agent-playbook.md new file mode 100644 index 000000000..f014755d8 --- /dev/null +++ b/docs/i18n/zh-CN/proxy-agent-playbook.md @@ -0,0 +1,46 @@ +# 本地化桥接文档:Proxy Agent Playbook + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../proxy-agent-playbook.md](../../proxy-agent-playbook.md) + +## 主题定位 + +- 类别:Provider 与集成 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · 0. Summary](../../proxy-agent-playbook.md#0-summary) +- [H2 · 1. Fast Path by Intent](../../proxy-agent-playbook.md#1-fast-path-by-intent) +- [H3 · 1.1 Proxy only ZeroClaw internal traffic](../../proxy-agent-playbook.md#1-1-proxy-only-zeroclaw-internal-traffic) +- [H3 · 1.2 Proxy only selected services](../../proxy-agent-playbook.md#1-2-proxy-only-selected-services) +- [H3 · 1.3 Export process-wide proxy environment variables](../../proxy-agent-playbook.md#1-3-export-process-wide-proxy-environment-variables) +- [H3 · 1.4 Emergency rollback](../../proxy-agent-playbook.md#1-4-emergency-rollback) +- [H2 · 2. Scope Decision Matrix](../../proxy-agent-playbook.md#2-scope-decision-matrix) +- [H2 · 3. Standard Safe Workflow](../../proxy-agent-playbook.md#3-standard-safe-workflow) +- [H2 · 4. Mode A — Proxy Only for ZeroClaw Internals](../../proxy-agent-playbook.md#4-mode-a-proxy-only-for-zeroclaw-internals) +- [H2 · 5. Mode B — Proxy Only for Specific Services](../../proxy-agent-playbook.md#5-mode-b-proxy-only-for-specific-services) +- [H3 · 5.1 Target specific services](../../proxy-agent-playbook.md#5-1-target-specific-services) +- [H3 · 5.2 Target by selectors](../../proxy-agent-playbook.md#5-2-target-by-selectors) +- [H2 · 6. Mode C — Proxy for Full Process Environment](../../proxy-agent-playbook.md#6-mode-c-proxy-for-full-process-environment) +- [H3 · 6.1 Configure and apply environment scope](../../proxy-agent-playbook.md#6-1-configure-and-apply-environment-scope) +- [H2 · 7. Disable / Rollback Patterns](../../proxy-agent-playbook.md#7-disable-rollback-patterns) +- [H3 · 7.1 Disable proxy (default safe behavior)](../../proxy-agent-playbook.md#7-1-disable-proxy-default-safe-behavior) +- [H3 · 7.2 Disable proxy and force-clear env vars](../../proxy-agent-playbook.md#7-2-disable-proxy-and-force-clear-env-vars) +- [H3 · 7.3 Keep proxy enabled but clear environment exports only](../../proxy-agent-playbook.md#7-3-keep-proxy-enabled-but-clear-environment-exports-only) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/release-process.md b/docs/i18n/zh-CN/release-process.md new file mode 100644 index 000000000..e73dae86d --- /dev/null +++ b/docs/i18n/zh-CN/release-process.md @@ -0,0 +1,40 @@ +# 本地化桥接文档:Release Process + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../release-process.md](../../release-process.md) + +## 主题定位 + +- 类别:工程流程与项目管理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Release Goals](../../release-process.md#release-goals) +- [H2 · Standard Cadence](../../release-process.md#standard-cadence) +- [H2 · Workflow Contract](../../release-process.md#workflow-contract) +- [H2 · Maintainer Procedure](../../release-process.md#maintainer-procedure) +- [H3 · 1) Preflight on `main`](../../release-process.md#1-preflight-on-main) +- [H3 · 2) Run verification build (no publish)](../../release-process.md#2-run-verification-build-no-publish) +- [H3 · 3) Cut release tag](../../release-process.md#3-cut-release-tag) +- [H3 · 4) Monitor publish run](../../release-process.md#4-monitor-publish-run) +- [H3 · 5) Post-release validation](../../release-process.md#5-post-release-validation) +- [H3 · 6) Publish Homebrew Core formula (bot-owned)](../../release-process.md#6-publish-homebrew-core-formula-bot-owned) +- [H2 · Emergency / Recovery Path](../../release-process.md#emergency-recovery-path) +- [H2 · Operational Notes](../../release-process.md#operational-notes) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/resource-limits.md b/docs/i18n/zh-CN/resource-limits.md new file mode 100644 index 000000000..5d4ea4197 --- /dev/null +++ b/docs/i18n/zh-CN/resource-limits.md @@ -0,0 +1,35 @@ +# 本地化桥接文档:Resource Limits + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../resource-limits.md](../../resource-limits.md) + +## 主题定位 + +- 类别:安全与治理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Problem](../../resource-limits.md#problem) +- [H2 · Proposed Solutions](../../resource-limits.md#proposed-solutions) +- [H3 · Option 1: cgroups v2 (Linux, Recommended)](../../resource-limits.md#option-1-cgroups-v2-linux-recommended) +- [H3 · Option 2: tokio::task::deadlock detection](../../resource-limits.md#option-2-tokio-task-deadlock-detection) +- [H3 · Option 3: Memory monitoring](../../resource-limits.md#option-3-memory-monitoring) +- [H2 · Config Schema](../../resource-limits.md#config-schema) +- [H2 · Implementation Priority](../../resource-limits.md#implementation-priority) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/reviewer-playbook.md b/docs/i18n/zh-CN/reviewer-playbook.md new file mode 100644 index 000000000..246f6afcd --- /dev/null +++ b/docs/i18n/zh-CN/reviewer-playbook.md @@ -0,0 +1,46 @@ +# 本地化桥接文档:Reviewer Playbook + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../reviewer-playbook.md](../../reviewer-playbook.md) + +## 主题定位 + +- 类别:工程流程与项目管理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · 0. Summary](../../reviewer-playbook.md#0-summary) +- [H2 · 1. Fast Path by Review Situation](../../reviewer-playbook.md#1-fast-path-by-review-situation) +- [H3 · 1.1 Intake fails in first 5 minutes](../../reviewer-playbook.md#1-1-intake-fails-in-first-5-minutes) +- [H3 · 1.2 Risk is high or unclear](../../reviewer-playbook.md#1-2-risk-is-high-or-unclear) +- [H3 · 1.3 Automation output is wrong/noisy](../../reviewer-playbook.md#1-3-automation-output-is-wrong-noisy) +- [H3 · 1.4 Need review handoff](../../reviewer-playbook.md#1-4-need-review-handoff) +- [H2 · 2. Review Depth Decision Matrix](../../reviewer-playbook.md#2-review-depth-decision-matrix) +- [H2 · 3. Standard Review Workflow](../../reviewer-playbook.md#3-standard-review-workflow) +- [H3 · 3.1 Five-minute intake triage](../../reviewer-playbook.md#3-1-five-minute-intake-triage) +- [H3 · 3.2 Fast-lane checklist (all PRs)](../../reviewer-playbook.md#3-2-fast-lane-checklist-all-prs) +- [H3 · 3.3 Deep review checklist (high risk)](../../reviewer-playbook.md#3-3-deep-review-checklist-high-risk) +- [H3 · 3.4 Review comment outcome style](../../reviewer-playbook.md#3-4-review-comment-outcome-style) +- [H2 · 4. Issue Triage and Backlog Governance](../../reviewer-playbook.md#4-issue-triage-and-backlog-governance) +- [H3 · 4.1 Issue triage label playbook](../../reviewer-playbook.md#4-1-issue-triage-label-playbook) +- [H3 · 4.2 PR backlog pruning protocol](../../reviewer-playbook.md#4-2-pr-backlog-pruning-protocol) +- [H2 · 5. Automation Override Protocol](../../reviewer-playbook.md#5-automation-override-protocol) +- [H2 · 6. Handoff Protocol](../../reviewer-playbook.md#6-handoff-protocol) +- [H2 · 7. Weekly Queue Hygiene](../../reviewer-playbook.md#7-weekly-queue-hygiene) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/sandboxing.md b/docs/i18n/zh-CN/sandboxing.md new file mode 100644 index 000000000..b864148fb --- /dev/null +++ b/docs/i18n/zh-CN/sandboxing.md @@ -0,0 +1,37 @@ +# 本地化桥接文档:Sandboxing + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../sandboxing.md](../../sandboxing.md) + +## 主题定位 + +- 类别:安全与治理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Problem](../../sandboxing.md#problem) +- [H2 · Proposed Solutions](../../sandboxing.md#proposed-solutions) +- [H3 · Option 1: Firejail Integration (Recommended for Linux)](../../sandboxing.md#option-1-firejail-integration-recommended-for-linux) +- [H3 · Option 2: Bubblewrap (Portable, no root required)](../../sandboxing.md#option-2-bubblewrap-portable-no-root-required) +- [H3 · Option 3: Docker-in-Docker (Heavyweight but complete isolation)](../../sandboxing.md#option-3-docker-in-docker-heavyweight-but-complete-isolation) +- [H3 · Option 4: Landlock (Linux Kernel LSM, Rust native)](../../sandboxing.md#option-4-landlock-linux-kernel-lsm-rust-native) +- [H2 · Priority Implementation Order](../../sandboxing.md#priority-implementation-order) +- [H2 · Config Schema Extension](../../sandboxing.md#config-schema-extension) +- [H2 · Testing Strategy](../../sandboxing.md#testing-strategy) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/security-roadmap.md b/docs/i18n/zh-CN/security-roadmap.md new file mode 100644 index 000000000..a8d7411f5 --- /dev/null +++ b/docs/i18n/zh-CN/security-roadmap.md @@ -0,0 +1,38 @@ +# 本地化桥接文档:Security Roadmap + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../security-roadmap.md](../../security-roadmap.md) + +## 主题定位 + +- 类别:安全与治理 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Current State: Strong Foundation](../../security-roadmap.md#current-state-strong-foundation) +- [H2 · What's Missing: OS-Level Containment](../../security-roadmap.md#what-s-missing-os-level-containment) +- [H2 · Comparison: ZeroClaw vs PicoClaw vs Production Grade](../../security-roadmap.md#comparison-zeroclaw-vs-picoclaw-vs-production-grade) +- [H2 · Implementation Roadmap](../../security-roadmap.md#implementation-roadmap) +- [H3 · Phase 1: Quick Wins (1-2 weeks)](../../security-roadmap.md#phase-1-quick-wins-1-2-weeks) +- [H3 · Phase 2: Platform Integration (2-3 weeks)](../../security-roadmap.md#phase-2-platform-integration-2-3-weeks) +- [H3 · Phase 3: Production Hardening (1-2 weeks)](../../security-roadmap.md#phase-3-production-hardening-1-2-weeks) +- [H2 · New Config Schema Preview](../../security-roadmap.md#new-config-schema-preview) +- [H2 · CLI Commands Preview](../../security-roadmap.md#cli-commands-preview) +- [H2 · Summary](../../security-roadmap.md#summary) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/i18n/zh-CN/troubleshooting.md b/docs/i18n/zh-CN/troubleshooting.md new file mode 100644 index 000000000..33ff69028 --- /dev/null +++ b/docs/i18n/zh-CN/troubleshooting.md @@ -0,0 +1,18 @@ +# 故障排查(简体中文) + +这是 Wave 1 首版本地化页面,用于快速定位常见故障与恢复路径。 + +英文原文: + +- [../../troubleshooting.md](../../troubleshooting.md) + +## 适用场景 + +- 安装失败、运行异常、通道故障 +- 结合 `status`/`doctor` 做分层诊断 +- 执行最小化回滚与恢复验证 + +## 使用建议 + +- 错误码、日志字段与命令名保持英文。 +- 详细故障签名以英文原文为准。 diff --git a/docs/i18n/zh-CN/zai-glm-setup.md b/docs/i18n/zh-CN/zai-glm-setup.md new file mode 100644 index 000000000..1725b87cc --- /dev/null +++ b/docs/i18n/zh-CN/zai-glm-setup.md @@ -0,0 +1,43 @@ +# 本地化桥接文档:Zai Glm Setup + +这是增强型 bridge 页面。它提供该主题的定位、原文章节导览和执行提示,帮助你在不丢失英文规范语义的情况下快速落地。 + +英文原文: + +- [../../zai-glm-setup.md](../../zai-glm-setup.md) + +## 主题定位 + +- 类别:Provider 与集成 +- 深度:增强 bridge(章节导览 + 执行提示) +- 适用:先理解结构,再按英文规范逐条执行。 + +## 原文章节导览 + +- [H2 · Overview](../../zai-glm-setup.md#overview) +- [H2 · Setup](../../zai-glm-setup.md#setup) +- [H3 · Quick Start](../../zai-glm-setup.md#quick-start) +- [H3 · Manual Configuration](../../zai-glm-setup.md#manual-configuration) +- [H2 · Available Models](../../zai-glm-setup.md#available-models) +- [H2 · Verify Setup](../../zai-glm-setup.md#verify-setup) +- [H3 · Test with curl](../../zai-glm-setup.md#test-with-curl) +- [H3 · Test with ZeroClaw CLI](../../zai-glm-setup.md#test-with-zeroclaw-cli) +- [H2 · Environment Variables](../../zai-glm-setup.md#environment-variables) +- [H2 · Troubleshooting](../../zai-glm-setup.md#troubleshooting) +- [H3 · Rate Limiting](../../zai-glm-setup.md#rate-limiting) +- [H3 · Authentication Errors](../../zai-glm-setup.md#authentication-errors) +- [H3 · Model Not Found](../../zai-glm-setup.md#model-not-found) +- [H2 · Getting an API Key](../../zai-glm-setup.md#getting-an-api-key) +- [H2 · Related Documentation](../../zai-glm-setup.md#related-documentation) + +## 操作建议 + +- 先通读原文目录,再聚焦与你当前变更直接相关的小节。 +- 命令名、配置键、API 路径和代码标识保持英文。 +- 发生语义歧义或行为冲突时,以英文原文为准。 + +## 相关入口 + +- [README.md](README.md) +- [SUMMARY.md](SUMMARY.md) +- [docs-inventory.md](docs-inventory.md) diff --git a/docs/operations/README.el.md b/docs/operations/README.el.md new file mode 100644 index 000000000..9c6888002 --- /dev/null +++ b/docs/operations/README.el.md @@ -0,0 +1,25 @@ +# Operations (Ελληνικά) + +Αυτή η σελίδα είναι το τοπικοποιημένο σημείο εισόδου για τα έγγραφα λειτουργίας. + +Αγγλικό πρωτότυπο: + +- [README.md](README.md) + +## Key Links + +- [../i18n/el/README.md](../i18n/el/README.md) +- [../i18n/el/SUMMARY.md](../i18n/el/SUMMARY.md) +- [../i18n/el/docs-inventory.md](../i18n/el/docs-inventory.md) + +## Σχετικά τοπικοποιημένα σημεία εισόδου + +- [../i18n/el/commands-reference.md](../i18n/el/commands-reference.md) +- [../i18n/el/config-reference.md](../i18n/el/config-reference.md) +- [../i18n/el/operations-runbook.md](../i18n/el/operations-runbook.md) +- [../i18n/el/troubleshooting.md](../i18n/el/troubleshooting.md) + +## Κανόνες + +- Τα ονόματα εντολών, config keys, API paths και code identifiers παραμένουν στα αγγλικά. +- Η τελική συμπεριφορά ορίζεται από το αγγλικό πρωτότυπο. diff --git a/docs/operations/README.fr.md b/docs/operations/README.fr.md new file mode 100644 index 000000000..8016e9982 --- /dev/null +++ b/docs/operations/README.fr.md @@ -0,0 +1,25 @@ +# Operations (Français) + +Cette page est l'entrée localisée pour la catégorie d'exploitation. + +Source anglaise: + +- [README.md](README.md) + +## Key Links + +- [../i18n/fr/README.md](../i18n/fr/README.md) +- [../i18n/fr/SUMMARY.md](../i18n/fr/SUMMARY.md) +- [../i18n/fr/docs-inventory.md](../i18n/fr/docs-inventory.md) + +## Entrées localisées liées + +- [../i18n/fr/commands-reference.md](../i18n/fr/commands-reference.md) +- [../i18n/fr/config-reference.md](../i18n/fr/config-reference.md) +- [../i18n/fr/operations-runbook.md](../i18n/fr/operations-runbook.md) +- [../i18n/fr/troubleshooting.md](../i18n/fr/troubleshooting.md) + +## Règles de localisation + +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- La définition finale du comportement est la source anglaise. diff --git a/docs/operations/README.ja.md b/docs/operations/README.ja.md new file mode 100644 index 000000000..b2b7ec596 --- /dev/null +++ b/docs/operations/README.ja.md @@ -0,0 +1,25 @@ +# Operations(日本語) + +このページは運用カテゴリのローカライズ入口です. + +英語版原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ja/README.md](../i18n/ja/README.md) +- [../i18n/ja/SUMMARY.md](../i18n/ja/SUMMARY.md) +- [../i18n/ja/docs-inventory.md](../i18n/ja/docs-inventory.md) + +## 関連するローカライズ入口 + +- [../i18n/ja/commands-reference.md](../i18n/ja/commands-reference.md) +- [../i18n/ja/config-reference.md](../i18n/ja/config-reference.md) +- [../i18n/ja/operations-runbook.md](../i18n/ja/operations-runbook.md) +- [../i18n/ja/troubleshooting.md](../i18n/ja/troubleshooting.md) + +## 運用ルール + +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します. +- 実装仕様と挙動の最終定義は英語版原文を優先します. diff --git a/docs/operations/README.ru.md b/docs/operations/README.ru.md new file mode 100644 index 000000000..6ca94e37e --- /dev/null +++ b/docs/operations/README.ru.md @@ -0,0 +1,25 @@ +# Operations (Русский) + +Эта страница — локализованный вход в эксплуатационные документы. + +Английский оригинал: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ru/README.md](../i18n/ru/README.md) +- [../i18n/ru/SUMMARY.md](../i18n/ru/SUMMARY.md) +- [../i18n/ru/docs-inventory.md](../i18n/ru/docs-inventory.md) + +## Связанные локализованные входы + +- [../i18n/ru/commands-reference.md](../i18n/ru/commands-reference.md) +- [../i18n/ru/config-reference.md](../i18n/ru/config-reference.md) +- [../i18n/ru/operations-runbook.md](../i18n/ru/operations-runbook.md) +- [../i18n/ru/troubleshooting.md](../i18n/ru/troubleshooting.md) + +## Правила локализации + +- Имена команд, ключей конфигурации, API-пути и code identifiers остаются на английском. +- Финальная спецификация поведения определяется английским оригиналом. diff --git a/docs/operations/README.vi.md b/docs/operations/README.vi.md new file mode 100644 index 000000000..0e0c6f040 --- /dev/null +++ b/docs/operations/README.vi.md @@ -0,0 +1,25 @@ +# Operations (Tiếng Việt) + +Trang này là điểm vào bản địa hóa cho nhóm tài liệu vận hành. + +Nguồn tiếng Anh: + +- [README.md](README.md) + +## Key Links + +- [../i18n/vi/README.md](../i18n/vi/README.md) +- [../i18n/vi/SUMMARY.md](../i18n/vi/SUMMARY.md) +- [../i18n/vi/docs-inventory.md](../i18n/vi/docs-inventory.md) + +## Điểm vào bản địa hóa liên quan + +- [../i18n/vi/commands-reference.md](../i18n/vi/commands-reference.md) +- [../i18n/vi/config-reference.md](../i18n/vi/config-reference.md) +- [../i18n/vi/operations-runbook.md](../i18n/vi/operations-runbook.md) +- [../i18n/vi/troubleshooting.md](../i18n/vi/troubleshooting.md) + +## Quy tắc + +- Tên lệnh, config key, API path và code identifier giữ nguyên tiếng Anh. +- Hành vi thực thi cuối cùng theo tài liệu tiếng Anh. diff --git a/docs/operations/README.zh-CN.md b/docs/operations/README.zh-CN.md new file mode 100644 index 000000000..33c32a9c2 --- /dev/null +++ b/docs/operations/README.zh-CN.md @@ -0,0 +1,25 @@ +# 运维与部署(简体中文) + +该页面是运维分类索引的本地化入口. + +英文原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/zh-CN/README.md](../i18n/zh-CN/README.md) +- [../i18n/zh-CN/SUMMARY.md](../i18n/zh-CN/SUMMARY.md) +- [../i18n/zh-CN/docs-inventory.md](../i18n/zh-CN/docs-inventory.md) + +## 相关本地化入口 + +- [../i18n/zh-CN/commands-reference.md](../i18n/zh-CN/commands-reference.md) +- [../i18n/zh-CN/config-reference.md](../i18n/zh-CN/config-reference.md) +- [../i18n/zh-CN/operations-runbook.md](../i18n/zh-CN/operations-runbook.md) +- [../i18n/zh-CN/troubleshooting.md](../i18n/zh-CN/troubleshooting.md) + +## 规则 + +- 命令名、配置键、API 路径与代码标识保持英文. +- 具体实现行为以英文原文为准. diff --git a/docs/project/README.el.md b/docs/project/README.el.md new file mode 100644 index 000000000..935fd1d1c --- /dev/null +++ b/docs/project/README.el.md @@ -0,0 +1,25 @@ +# Project Snapshot (Ελληνικά) + +Αυτή η σελίδα είναι το τοπικοποιημένο σημείο εισόδου για project snapshots. + +Αγγλικό πρωτότυπο: + +- [README.md](README.md) + +## Key Links + +- [../i18n/el/README.md](../i18n/el/README.md) +- [../i18n/el/SUMMARY.md](../i18n/el/SUMMARY.md) +- [../i18n/el/docs-inventory.md](../i18n/el/docs-inventory.md) + +## Σχετικά τοπικοποιημένα σημεία εισόδου + +- [../i18n/el/commands-reference.md](../i18n/el/commands-reference.md) +- [../i18n/el/config-reference.md](../i18n/el/config-reference.md) +- [../i18n/el/operations-runbook.md](../i18n/el/operations-runbook.md) +- [../i18n/el/troubleshooting.md](../i18n/el/troubleshooting.md) + +## Κανόνες + +- Τα ονόματα εντολών, config keys, API paths και code identifiers παραμένουν στα αγγλικά. +- Η τελική συμπεριφορά ορίζεται από το αγγλικό πρωτότυπο. diff --git a/docs/project/README.fr.md b/docs/project/README.fr.md new file mode 100644 index 000000000..e28ea4bb7 --- /dev/null +++ b/docs/project/README.fr.md @@ -0,0 +1,25 @@ +# Project Snapshot (Français) + +Cette page est l'entrée localisée pour la catégorie de suivi projet. + +Source anglaise: + +- [README.md](README.md) + +## Key Links + +- [../i18n/fr/README.md](../i18n/fr/README.md) +- [../i18n/fr/SUMMARY.md](../i18n/fr/SUMMARY.md) +- [../i18n/fr/docs-inventory.md](../i18n/fr/docs-inventory.md) + +## Entrées localisées liées + +- [../i18n/fr/commands-reference.md](../i18n/fr/commands-reference.md) +- [../i18n/fr/config-reference.md](../i18n/fr/config-reference.md) +- [../i18n/fr/operations-runbook.md](../i18n/fr/operations-runbook.md) +- [../i18n/fr/troubleshooting.md](../i18n/fr/troubleshooting.md) + +## Règles de localisation + +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- La définition finale du comportement est la source anglaise. diff --git a/docs/project/README.ja.md b/docs/project/README.ja.md new file mode 100644 index 000000000..2f6bd5776 --- /dev/null +++ b/docs/project/README.ja.md @@ -0,0 +1,25 @@ +# Project Snapshot(日本語) + +このページはプロジェクトスナップショットカテゴリのローカライズ入口です. + +英語版原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ja/README.md](../i18n/ja/README.md) +- [../i18n/ja/SUMMARY.md](../i18n/ja/SUMMARY.md) +- [../i18n/ja/docs-inventory.md](../i18n/ja/docs-inventory.md) + +## 関連するローカライズ入口 + +- [../i18n/ja/commands-reference.md](../i18n/ja/commands-reference.md) +- [../i18n/ja/config-reference.md](../i18n/ja/config-reference.md) +- [../i18n/ja/operations-runbook.md](../i18n/ja/operations-runbook.md) +- [../i18n/ja/troubleshooting.md](../i18n/ja/troubleshooting.md) + +## 運用ルール + +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します. +- 実装仕様と挙動の最終定義は英語版原文を優先します. diff --git a/docs/project/README.md b/docs/project/README.md index 478200c47..8a2fbc6a1 100644 --- a/docs/project/README.md +++ b/docs/project/README.md @@ -5,6 +5,7 @@ Time-bound project status snapshots for planning documentation and operations wo ## Current Snapshot - [../project-triage-snapshot-2026-02-18.md](../project-triage-snapshot-2026-02-18.md) +- [../docs-audit-2026-02-24.md](../docs-audit-2026-02-24.md) ## Scope diff --git a/docs/project/README.ru.md b/docs/project/README.ru.md new file mode 100644 index 000000000..a22e74b57 --- /dev/null +++ b/docs/project/README.ru.md @@ -0,0 +1,25 @@ +# Project Snapshot (Русский) + +Эта страница — локализованный вход в проектные snapshots. + +Английский оригинал: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ru/README.md](../i18n/ru/README.md) +- [../i18n/ru/SUMMARY.md](../i18n/ru/SUMMARY.md) +- [../i18n/ru/docs-inventory.md](../i18n/ru/docs-inventory.md) + +## Связанные локализованные входы + +- [../i18n/ru/commands-reference.md](../i18n/ru/commands-reference.md) +- [../i18n/ru/config-reference.md](../i18n/ru/config-reference.md) +- [../i18n/ru/operations-runbook.md](../i18n/ru/operations-runbook.md) +- [../i18n/ru/troubleshooting.md](../i18n/ru/troubleshooting.md) + +## Правила локализации + +- Имена команд, ключей конфигурации, API-пути и code identifiers остаются на английском. +- Финальная спецификация поведения определяется английским оригиналом. diff --git a/docs/project/README.vi.md b/docs/project/README.vi.md new file mode 100644 index 000000000..dd6265a52 --- /dev/null +++ b/docs/project/README.vi.md @@ -0,0 +1,25 @@ +# Project Snapshot (Tiếng Việt) + +Trang này là điểm vào bản địa hóa cho nhóm tài liệu snapshot dự án. + +Nguồn tiếng Anh: + +- [README.md](README.md) + +## Key Links + +- [../i18n/vi/README.md](../i18n/vi/README.md) +- [../i18n/vi/SUMMARY.md](../i18n/vi/SUMMARY.md) +- [../i18n/vi/docs-inventory.md](../i18n/vi/docs-inventory.md) + +## Điểm vào bản địa hóa liên quan + +- [../i18n/vi/commands-reference.md](../i18n/vi/commands-reference.md) +- [../i18n/vi/config-reference.md](../i18n/vi/config-reference.md) +- [../i18n/vi/operations-runbook.md](../i18n/vi/operations-runbook.md) +- [../i18n/vi/troubleshooting.md](../i18n/vi/troubleshooting.md) + +## Quy tắc + +- Tên lệnh, config key, API path và code identifier giữ nguyên tiếng Anh. +- Hành vi thực thi cuối cùng theo tài liệu tiếng Anh. diff --git a/docs/project/README.zh-CN.md b/docs/project/README.zh-CN.md new file mode 100644 index 000000000..daa971702 --- /dev/null +++ b/docs/project/README.zh-CN.md @@ -0,0 +1,25 @@ +# 项目快照(简体中文) + +该页面是项目快照分类索引的本地化入口. + +英文原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/zh-CN/README.md](../i18n/zh-CN/README.md) +- [../i18n/zh-CN/SUMMARY.md](../i18n/zh-CN/SUMMARY.md) +- [../i18n/zh-CN/docs-inventory.md](../i18n/zh-CN/docs-inventory.md) + +## 相关本地化入口 + +- [../i18n/zh-CN/commands-reference.md](../i18n/zh-CN/commands-reference.md) +- [../i18n/zh-CN/config-reference.md](../i18n/zh-CN/config-reference.md) +- [../i18n/zh-CN/operations-runbook.md](../i18n/zh-CN/operations-runbook.md) +- [../i18n/zh-CN/troubleshooting.md](../i18n/zh-CN/troubleshooting.md) + +## 规则 + +- 命令名、配置键、API 路径与代码标识保持英文. +- 具体实现行为以英文原文为准. diff --git a/docs/reference/README.el.md b/docs/reference/README.el.md new file mode 100644 index 000000000..0df33b049 --- /dev/null +++ b/docs/reference/README.el.md @@ -0,0 +1,25 @@ +# Reference (Ελληνικά) + +Αυτή η σελίδα είναι το τοπικοποιημένο σημείο εισόδου για τα έγγραφα αναφοράς. + +Αγγλικό πρωτότυπο: + +- [README.md](README.md) + +## Key Links + +- [../i18n/el/README.md](../i18n/el/README.md) +- [../i18n/el/SUMMARY.md](../i18n/el/SUMMARY.md) +- [../i18n/el/docs-inventory.md](../i18n/el/docs-inventory.md) + +## Σχετικά τοπικοποιημένα σημεία εισόδου + +- [../i18n/el/commands-reference.md](../i18n/el/commands-reference.md) +- [../i18n/el/config-reference.md](../i18n/el/config-reference.md) +- [../i18n/el/operations-runbook.md](../i18n/el/operations-runbook.md) +- [../i18n/el/troubleshooting.md](../i18n/el/troubleshooting.md) + +## Κανόνες + +- Τα ονόματα εντολών, config keys, API paths και code identifiers παραμένουν στα αγγλικά. +- Η τελική συμπεριφορά ορίζεται από το αγγλικό πρωτότυπο. diff --git a/docs/reference/README.fr.md b/docs/reference/README.fr.md new file mode 100644 index 000000000..7763cd9f4 --- /dev/null +++ b/docs/reference/README.fr.md @@ -0,0 +1,25 @@ +# Reference (Français) + +Cette page est l'entrée localisée pour la catégorie de référence. + +Source anglaise: + +- [README.md](README.md) + +## Key Links + +- [../i18n/fr/README.md](../i18n/fr/README.md) +- [../i18n/fr/SUMMARY.md](../i18n/fr/SUMMARY.md) +- [../i18n/fr/docs-inventory.md](../i18n/fr/docs-inventory.md) + +## Entrées localisées liées + +- [../i18n/fr/commands-reference.md](../i18n/fr/commands-reference.md) +- [../i18n/fr/config-reference.md](../i18n/fr/config-reference.md) +- [../i18n/fr/operations-runbook.md](../i18n/fr/operations-runbook.md) +- [../i18n/fr/troubleshooting.md](../i18n/fr/troubleshooting.md) + +## Règles de localisation + +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- La définition finale du comportement est la source anglaise. diff --git a/docs/reference/README.ja.md b/docs/reference/README.ja.md new file mode 100644 index 000000000..70569c72b --- /dev/null +++ b/docs/reference/README.ja.md @@ -0,0 +1,25 @@ +# Reference(日本語) + +このページは参照カテゴリのローカライズ入口です. + +英語版原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ja/README.md](../i18n/ja/README.md) +- [../i18n/ja/SUMMARY.md](../i18n/ja/SUMMARY.md) +- [../i18n/ja/docs-inventory.md](../i18n/ja/docs-inventory.md) + +## 関連するローカライズ入口 + +- [../i18n/ja/commands-reference.md](../i18n/ja/commands-reference.md) +- [../i18n/ja/config-reference.md](../i18n/ja/config-reference.md) +- [../i18n/ja/operations-runbook.md](../i18n/ja/operations-runbook.md) +- [../i18n/ja/troubleshooting.md](../i18n/ja/troubleshooting.md) + +## 運用ルール + +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します. +- 実装仕様と挙動の最終定義は英語版原文を優先します. diff --git a/docs/reference/README.md b/docs/reference/README.md index aa215eb4d..064ff7a4b 100644 --- a/docs/reference/README.md +++ b/docs/reference/README.md @@ -15,6 +15,7 @@ Structured reference index for commands, providers, channels, config, and integr - Z.AI / GLM provider onboarding: [../zai-glm-setup.md](../zai-glm-setup.md) - Nextcloud Talk bot integration: [../nextcloud-talk-setup.md](../nextcloud-talk-setup.md) - LangGraph-based integration patterns: [../langgraph-integration.md](../langgraph-integration.md) +- Proxy scope operation playbook: [../proxy-agent-playbook.md](../proxy-agent-playbook.md) ## Usage diff --git a/docs/reference/README.ru.md b/docs/reference/README.ru.md new file mode 100644 index 000000000..0d22abc7f --- /dev/null +++ b/docs/reference/README.ru.md @@ -0,0 +1,25 @@ +# Reference (Русский) + +Эта страница — локализованный вход в справочные документы. + +Английский оригинал: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ru/README.md](../i18n/ru/README.md) +- [../i18n/ru/SUMMARY.md](../i18n/ru/SUMMARY.md) +- [../i18n/ru/docs-inventory.md](../i18n/ru/docs-inventory.md) + +## Связанные локализованные входы + +- [../i18n/ru/commands-reference.md](../i18n/ru/commands-reference.md) +- [../i18n/ru/config-reference.md](../i18n/ru/config-reference.md) +- [../i18n/ru/operations-runbook.md](../i18n/ru/operations-runbook.md) +- [../i18n/ru/troubleshooting.md](../i18n/ru/troubleshooting.md) + +## Правила локализации + +- Имена команд, ключей конфигурации, API-пути и code identifiers остаются на английском. +- Финальная спецификация поведения определяется английским оригиналом. diff --git a/docs/reference/README.vi.md b/docs/reference/README.vi.md new file mode 100644 index 000000000..d264ecaa3 --- /dev/null +++ b/docs/reference/README.vi.md @@ -0,0 +1,25 @@ +# Reference (Tiếng Việt) + +Trang này là điểm vào bản địa hóa cho nhóm tài liệu tham chiếu. + +Nguồn tiếng Anh: + +- [README.md](README.md) + +## Key Links + +- [../i18n/vi/README.md](../i18n/vi/README.md) +- [../i18n/vi/SUMMARY.md](../i18n/vi/SUMMARY.md) +- [../i18n/vi/docs-inventory.md](../i18n/vi/docs-inventory.md) + +## Điểm vào bản địa hóa liên quan + +- [../i18n/vi/commands-reference.md](../i18n/vi/commands-reference.md) +- [../i18n/vi/config-reference.md](../i18n/vi/config-reference.md) +- [../i18n/vi/operations-runbook.md](../i18n/vi/operations-runbook.md) +- [../i18n/vi/troubleshooting.md](../i18n/vi/troubleshooting.md) + +## Quy tắc + +- Tên lệnh, config key, API path và code identifier giữ nguyên tiếng Anh. +- Hành vi thực thi cuối cùng theo tài liệu tiếng Anh. diff --git a/docs/reference/README.zh-CN.md b/docs/reference/README.zh-CN.md new file mode 100644 index 000000000..5e6a32f1b --- /dev/null +++ b/docs/reference/README.zh-CN.md @@ -0,0 +1,25 @@ +# 参考文档(简体中文) + +该页面是参考分类索引的本地化入口. + +英文原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/zh-CN/README.md](../i18n/zh-CN/README.md) +- [../i18n/zh-CN/SUMMARY.md](../i18n/zh-CN/SUMMARY.md) +- [../i18n/zh-CN/docs-inventory.md](../i18n/zh-CN/docs-inventory.md) + +## 相关本地化入口 + +- [../i18n/zh-CN/commands-reference.md](../i18n/zh-CN/commands-reference.md) +- [../i18n/zh-CN/config-reference.md](../i18n/zh-CN/config-reference.md) +- [../i18n/zh-CN/operations-runbook.md](../i18n/zh-CN/operations-runbook.md) +- [../i18n/zh-CN/troubleshooting.md](../i18n/zh-CN/troubleshooting.md) + +## 规则 + +- 命令名、配置键、API 路径与代码标识保持英文. +- 具体实现行为以英文原文为准. diff --git a/docs/security/README.el.md b/docs/security/README.el.md new file mode 100644 index 000000000..a7251d82b --- /dev/null +++ b/docs/security/README.el.md @@ -0,0 +1,25 @@ +# Security (Ελληνικά) + +Αυτή η σελίδα είναι το τοπικοποιημένο σημείο εισόδου για τα έγγραφα ασφάλειας. + +Αγγλικό πρωτότυπο: + +- [README.md](README.md) + +## Key Links + +- [../i18n/el/README.md](../i18n/el/README.md) +- [../i18n/el/SUMMARY.md](../i18n/el/SUMMARY.md) +- [../i18n/el/docs-inventory.md](../i18n/el/docs-inventory.md) + +## Σχετικά τοπικοποιημένα σημεία εισόδου + +- [../i18n/el/commands-reference.md](../i18n/el/commands-reference.md) +- [../i18n/el/config-reference.md](../i18n/el/config-reference.md) +- [../i18n/el/operations-runbook.md](../i18n/el/operations-runbook.md) +- [../i18n/el/troubleshooting.md](../i18n/el/troubleshooting.md) + +## Κανόνες + +- Τα ονόματα εντολών, config keys, API paths και code identifiers παραμένουν στα αγγλικά. +- Η τελική συμπεριφορά ορίζεται από το αγγλικό πρωτότυπο. diff --git a/docs/security/README.fr.md b/docs/security/README.fr.md new file mode 100644 index 000000000..bb0a88dba --- /dev/null +++ b/docs/security/README.fr.md @@ -0,0 +1,25 @@ +# Security (Français) + +Cette page est l'entrée localisée pour la catégorie sécurité. + +Source anglaise: + +- [README.md](README.md) + +## Key Links + +- [../i18n/fr/README.md](../i18n/fr/README.md) +- [../i18n/fr/SUMMARY.md](../i18n/fr/SUMMARY.md) +- [../i18n/fr/docs-inventory.md](../i18n/fr/docs-inventory.md) + +## Entrées localisées liées + +- [../i18n/fr/commands-reference.md](../i18n/fr/commands-reference.md) +- [../i18n/fr/config-reference.md](../i18n/fr/config-reference.md) +- [../i18n/fr/operations-runbook.md](../i18n/fr/operations-runbook.md) +- [../i18n/fr/troubleshooting.md](../i18n/fr/troubleshooting.md) + +## Règles de localisation + +- Les noms de commandes, clés de configuration, chemins API et identifiants de code restent en anglais. +- La définition finale du comportement est la source anglaise. diff --git a/docs/security/README.ja.md b/docs/security/README.ja.md new file mode 100644 index 000000000..6855faa99 --- /dev/null +++ b/docs/security/README.ja.md @@ -0,0 +1,25 @@ +# Security(日本語) + +このページはセキュリティカテゴリのローカライズ入口です. + +英語版原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ja/README.md](../i18n/ja/README.md) +- [../i18n/ja/SUMMARY.md](../i18n/ja/SUMMARY.md) +- [../i18n/ja/docs-inventory.md](../i18n/ja/docs-inventory.md) + +## 関連するローカライズ入口 + +- [../i18n/ja/commands-reference.md](../i18n/ja/commands-reference.md) +- [../i18n/ja/config-reference.md](../i18n/ja/config-reference.md) +- [../i18n/ja/operations-runbook.md](../i18n/ja/operations-runbook.md) +- [../i18n/ja/troubleshooting.md](../i18n/ja/troubleshooting.md) + +## 運用ルール + +- コマンド名、設定キー、API パス、コード識別子は英語のまま保持します. +- 実装仕様と挙動の最終定義は英語版原文を優先します. diff --git a/docs/security/README.md b/docs/security/README.md index bc50adea2..6b3cb07a5 100644 --- a/docs/security/README.md +++ b/docs/security/README.md @@ -9,6 +9,7 @@ For current runtime behavior, start here: - Config reference: [../config-reference.md](../config-reference.md) - Operations runbook: [../operations-runbook.md](../operations-runbook.md) - Troubleshooting: [../troubleshooting.md](../troubleshooting.md) +- CI/Security audit event schema: [../audit-event-schema.md](../audit-event-schema.md) ## Proposal / Roadmap Docs diff --git a/docs/security/README.ru.md b/docs/security/README.ru.md new file mode 100644 index 000000000..ea9395a7b --- /dev/null +++ b/docs/security/README.ru.md @@ -0,0 +1,25 @@ +# Security (Русский) + +Эта страница — локализованный вход в раздел безопасности. + +Английский оригинал: + +- [README.md](README.md) + +## Key Links + +- [../i18n/ru/README.md](../i18n/ru/README.md) +- [../i18n/ru/SUMMARY.md](../i18n/ru/SUMMARY.md) +- [../i18n/ru/docs-inventory.md](../i18n/ru/docs-inventory.md) + +## Связанные локализованные входы + +- [../i18n/ru/commands-reference.md](../i18n/ru/commands-reference.md) +- [../i18n/ru/config-reference.md](../i18n/ru/config-reference.md) +- [../i18n/ru/operations-runbook.md](../i18n/ru/operations-runbook.md) +- [../i18n/ru/troubleshooting.md](../i18n/ru/troubleshooting.md) + +## Правила локализации + +- Имена команд, ключей конфигурации, API-пути и code identifiers остаются на английском. +- Финальная спецификация поведения определяется английским оригиналом. diff --git a/docs/security/README.vi.md b/docs/security/README.vi.md new file mode 100644 index 000000000..3cef01b19 --- /dev/null +++ b/docs/security/README.vi.md @@ -0,0 +1,25 @@ +# Security (Tiếng Việt) + +Trang này là điểm vào bản địa hóa cho nhóm tài liệu bảo mật. + +Nguồn tiếng Anh: + +- [README.md](README.md) + +## Key Links + +- [../i18n/vi/README.md](../i18n/vi/README.md) +- [../i18n/vi/SUMMARY.md](../i18n/vi/SUMMARY.md) +- [../i18n/vi/docs-inventory.md](../i18n/vi/docs-inventory.md) + +## Điểm vào bản địa hóa liên quan + +- [../i18n/vi/commands-reference.md](../i18n/vi/commands-reference.md) +- [../i18n/vi/config-reference.md](../i18n/vi/config-reference.md) +- [../i18n/vi/operations-runbook.md](../i18n/vi/operations-runbook.md) +- [../i18n/vi/troubleshooting.md](../i18n/vi/troubleshooting.md) + +## Quy tắc + +- Tên lệnh, config key, API path và code identifier giữ nguyên tiếng Anh. +- Hành vi thực thi cuối cùng theo tài liệu tiếng Anh. diff --git a/docs/security/README.zh-CN.md b/docs/security/README.zh-CN.md new file mode 100644 index 000000000..15838e180 --- /dev/null +++ b/docs/security/README.zh-CN.md @@ -0,0 +1,25 @@ +# 安全文档(简体中文) + +该页面是安全分类索引的本地化入口. + +英文原文: + +- [README.md](README.md) + +## Key Links + +- [../i18n/zh-CN/README.md](../i18n/zh-CN/README.md) +- [../i18n/zh-CN/SUMMARY.md](../i18n/zh-CN/SUMMARY.md) +- [../i18n/zh-CN/docs-inventory.md](../i18n/zh-CN/docs-inventory.md) + +## 相关本地化入口 + +- [../i18n/zh-CN/commands-reference.md](../i18n/zh-CN/commands-reference.md) +- [../i18n/zh-CN/config-reference.md](../i18n/zh-CN/config-reference.md) +- [../i18n/zh-CN/operations-runbook.md](../i18n/zh-CN/operations-runbook.md) +- [../i18n/zh-CN/troubleshooting.md](../i18n/zh-CN/troubleshooting.md) + +## 规则 + +- 命令名、配置键、API 路径与代码标识保持英文. +- 具体实现行为以英文原文为准. diff --git a/docs/structure/README.md b/docs/structure/README.md index ed62fc804..93e414f12 100644 --- a/docs/structure/README.md +++ b/docs/structure/README.md @@ -1,87 +1,85 @@ # ZeroClaw Docs Structure Map -This page defines the documentation structure across three axes: +This page defines the canonical documentation layout and compatibility layers. -1. Language -2. Part (category) -3. Function (document intent) +Last refreshed: **February 24, 2026**. -Last refreshed: **February 22, 2026**. +## 1) Directory Spine (Canonical) -## 1) By Language +### Layer A: global entry points -| Language | Entry point | Canonical tree | Notes | -|---|---|---|---| -| English | `docs/README.md` | `docs/` | Source-of-truth runtime behavior docs are authored in English first. | -| Chinese (`zh-CN`) | `docs/README.zh-CN.md` | `docs/` localized hub + selected localized docs | Uses localized hub and shared category structure. | -| Japanese (`ja`) | `docs/README.ja.md` | `docs/` localized hub + selected localized docs | Uses localized hub and shared category structure. | -| Russian (`ru`) | `docs/README.ru.md` | `docs/` localized hub + selected localized docs | Uses localized hub and shared category structure. | -| French (`fr`) | `docs/README.fr.md` | `docs/` localized hub + selected localized docs | Uses localized hub and shared category structure. | -| Vietnamese (`vi`) | `docs/i18n/vi/README.md` | `docs/i18n/vi/` | Full Vietnamese tree is canonical under `docs/i18n/vi/`; `docs/vi/` and `docs/*.vi.md` are compatibility paths. | +- Root product READMEs: `README.md`, `README..md` +- Docs hub: `docs/README.md` +- Unified TOC: `docs/SUMMARY.md` -## 2) By Part (Category) +### Layer B: category collections (English source-of-truth) -These directories are the primary navigation modules by product area. +- `docs/getting-started/` +- `docs/reference/` +- `docs/operations/` +- `docs/security/` +- `docs/hardware/` +- `docs/contributing/` +- `docs/project/` +- `docs/sop/` -- `docs/getting-started/` for initial setup and first-run flows -- `docs/reference/` for command/config/provider/channel reference indexes -- `docs/operations/` for day-2 operations, deployment, and troubleshooting entry points -- `docs/security/` for security guidance and security-oriented navigation -- `docs/hardware/` for board/peripheral implementation and hardware workflows -- `docs/contributing/` for contribution and CI/review processes -- `docs/project/` for project snapshots, planning context, and status-oriented docs +### Layer C: canonical locale trees -## 3) By Function (Document Intent) +- `docs/i18n/zh-CN/` +- `docs/i18n/ja/` +- `docs/i18n/ru/` +- `docs/i18n/fr/` +- `docs/i18n/vi/` +- `docs/i18n/el/` -Use this grouping to decide where new docs belong. +### Layer D: compatibility shims (non-canonical) -### Runtime Contract (current behavior) +- `docs/README..md`, `docs/SUMMARY..md` +- `docs/vi/**` +- legacy `docs/*..md` files where present -- `docs/commands-reference.md` -- `docs/providers-reference.md` -- `docs/channels-reference.md` -- `docs/config-reference.md` -- `docs/operations-runbook.md` -- `docs/troubleshooting.md` -- `docs/one-click-bootstrap.md` +Use compatibility paths for backward links only. New localized edits should target `docs/i18n//**`. -### Setup / Integration Guides +## 2) Language Topology -- `docs/custom-providers.md` -- `docs/zai-glm-setup.md` -- `docs/langgraph-integration.md` -- `docs/network-deployment.md` -- `docs/matrix-e2ee-guide.md` -- `docs/mattermost-setup.md` -- `docs/nextcloud-talk-setup.md` +| Locale | Root landing | Canonical docs hub | Coverage level | Notes | +|---|---|---|---|---| +| `en` | `README.md` | `docs/README.md` | Full source | Authoritative runtime-contract wording | +| `zh-CN` | `README.zh-CN.md` | `docs/i18n/zh-CN/README.md` | Hub-level scaffold | Runtime-contract docs mainly shared in English | +| `ja` | `README.ja.md` | `docs/i18n/ja/README.md` | Hub-level scaffold | Runtime-contract docs mainly shared in English | +| `ru` | `README.ru.md` | `docs/i18n/ru/README.md` | Hub-level scaffold | Runtime-contract docs mainly shared in English | +| `fr` | `README.fr.md` | `docs/i18n/fr/README.md` | Hub-level scaffold | Runtime-contract docs mainly shared in English | +| `vi` | `README.vi.md` | `docs/i18n/vi/README.md` | Full localized tree | `docs/vi/**` kept as compatibility layer | +| `el` | `README.el.md` | `docs/i18n/el/README.md` | Full localized tree | Greek full tree is canonical in `docs/i18n/el/**` | -### Policy / Process +## 3) Category Intent Map -- `docs/pr-workflow.md` -- `docs/reviewer-playbook.md` -- `docs/ci-map.md` -- `docs/actions-source-policy.md` +| Category | Canonical index | Intent | +|---|---|---| +| Getting Started | `docs/getting-started/README.md` | first-run and install flows | +| Reference | `docs/reference/README.md` | commands/config/providers/channels and integration references | +| Operations | `docs/operations/README.md` | day-2 operations, release, troubleshooting runbooks | +| Security | `docs/security/README.md` | current hardening guidance + proposal boundary | +| Hardware | `docs/hardware/README.md` | boards, peripherals, datasheets navigation | +| Contributing | `docs/contributing/README.md` | PR/review/CI policy and process | +| Project | `docs/project/README.md` | time-bound snapshots and planning audit history | +| SOP | `docs/sop/README.md` | SOP runtime contract and procedure docs | -### Proposals / Roadmaps +## 4) Placement Rules -- `docs/sandboxing.md` -- `docs/resource-limits.md` -- `docs/audit-logging.md` -- `docs/agnostic-security.md` -- `docs/frictionless-security.md` -- `docs/security-roadmap.md` +1. Runtime behavior docs go in English canonical paths first. +2. Every new major doc must be linked from: +- the nearest category index (`docs//README.md`) +- `docs/SUMMARY.md` +- `docs/docs-inventory.md` +3. Locale navigation changes must update all supported locales (`en`, `zh-CN`, `ja`, `ru`, `fr`, `vi`, `el`). +4. For localized hubs/summaries, canonical path is always `docs/i18n//`. +5. Keep compatibility shims aligned when touched; do not introduce new primary content under compatibility-only paths. -### Snapshots / Time-Bound Reports +## 5) Governance Links -- `docs/project-triage-snapshot-2026-02-18.md` - -### Assets / Templates - -- `docs/datasheets/` -- `docs/doc-template.md` - -## Placement Rules (Quick) - -- New runtime behavior docs must be linked from the appropriate category index and `docs/SUMMARY.md`. -- Navigation changes must preserve locale parity across `docs/README*.md` and `docs/SUMMARY*.md`. -- Vietnamese full localization lives in `docs/i18n/vi/`; compatibility files should point to canonical paths. +- i18n docs index: [../i18n/README.md](../i18n/README.md) +- i18n coverage matrix: [../i18n-coverage.md](../i18n-coverage.md) +- i18n completion checklist: [../i18n-guide.md](../i18n-guide.md) +- i18n gap backlog: [../i18n-gap-backlog.md](../i18n-gap-backlog.md) +- docs inventory/classification: [../docs-inventory.md](../docs-inventory.md) diff --git a/docs/vi/README.md b/docs/vi/README.md index 53e680843..5ba731d0c 100644 --- a/docs/vi/README.md +++ b/docs/vi/README.md @@ -1,92 +1,24 @@ -# Tài liệu ZeroClaw (Tiếng Việt) +# Vietnamese Docs Compatibility Hub -Đây là trang chủ tiếng Việt của hệ thống tài liệu. +This path is a compatibility mirror. -Đồng bộ lần cuối: **2026-02-20**. +Canonical Vietnamese docs live under: -> Lưu ý: Tên lệnh, khóa cấu hình và đường dẫn API giữ nguyên tiếng Anh. Khi có sai khác, tài liệu tiếng Anh là bản gốc. +- [../i18n/vi/README.md](../i18n/vi/README.md) +- [../i18n/vi/SUMMARY.md](../i18n/vi/SUMMARY.md) -## Tra cứu nhanh +Use `docs/i18n/vi/**` for all new edits. Keep compatibility links valid when touching `docs/vi/**`. -| Tôi muốn… | Xem tài liệu | -|---|---| -| Cài đặt và chạy nhanh | [../../README.vi.md](../../README.vi.md) / [../../README.md](../../README.md) | -| Cài đặt bằng một lệnh | [one-click-bootstrap.md](one-click-bootstrap.md) | -| Tìm lệnh theo tác vụ | [commands-reference.md](commands-reference.md) | -| Kiểm tra giá trị mặc định và khóa cấu hình | [config-reference.md](config-reference.md) | -| Kết nối provider / endpoint tùy chỉnh | [custom-providers.md](custom-providers.md) | -| Cấu hình Z.AI / GLM provider | [zai-glm-setup.md](zai-glm-setup.md) | -| Sử dụng tích hợp LangGraph | [langgraph-integration.md](langgraph-integration.md) | -| Vận hành hàng ngày (runbook) | [operations-runbook.md](operations-runbook.md) | -| Khắc phục sự cố cài đặt/chạy/kênh | [troubleshooting.md](troubleshooting.md) | -| Cấu hình Matrix phòng mã hóa (E2EE) | [matrix-e2ee-guide.md](matrix-e2ee-guide.md) | -| Xem theo danh mục | [SUMMARY.md](SUMMARY.md) | -| Xem bản chụp PR/Issue | [../project-triage-snapshot-2026-02-18.md](../project-triage-snapshot-2026-02-18.md) | +## Quick Redirect -## Tìm nhanh +- Canonical Vietnamese hub: [../i18n/vi/README.md](../i18n/vi/README.md) +- Canonical Vietnamese TOC: [../i18n/vi/SUMMARY.md](../i18n/vi/SUMMARY.md) +- English hub: [../README.md](../README.md) -- Cài đặt lần đầu hoặc khởi động nhanh → [getting-started/README.md](getting-started/README.md) -- Cần tra cứu lệnh CLI / khóa cấu hình → [reference/README.md](reference/README.md) -- Cần vận hành / triển khai sản phẩm → [operations/README.md](operations/README.md) -- Gặp lỗi hoặc hồi quy → [troubleshooting.md](troubleshooting.md) -- Tìm hiểu bảo mật và lộ trình → [security/README.md](security/README.md) -- Làm việc với bo mạch / thiết bị ngoại vi → [hardware/README.md](hardware/README.md) -- Đóng góp / review / quy trình CI → [contributing/README.md](contributing/README.md) -- Xem toàn bộ bản đồ tài liệu → [SUMMARY.md](SUMMARY.md) +## Other Languages -## Theo danh mục - -- Bắt đầu: [getting-started/README.md](getting-started/README.md) -- Tra cứu: [reference/README.md](reference/README.md) -- Vận hành & triển khai: [operations/README.md](operations/README.md) -- Bảo mật: [security/README.md](security/README.md) -- Phần cứng & ngoại vi: [hardware/README.md](hardware/README.md) -- Đóng góp & CI: [contributing/README.md](contributing/README.md) -- Ảnh chụp dự án: [project/README.md](project/README.md) - -## Theo vai trò - -### Người dùng / Vận hành - -- [commands-reference.md](commands-reference.md) — tra cứu lệnh theo tác vụ -- [providers-reference.md](providers-reference.md) — ID provider, bí danh, biến môi trường xác thực -- [channels-reference.md](channels-reference.md) — khả năng kênh và hướng dẫn thiết lập -- [matrix-e2ee-guide.md](matrix-e2ee-guide.md) — thiết lập phòng mã hóa Matrix (E2EE) -- [config-reference.md](config-reference.md) — khóa cấu hình quan trọng và giá trị mặc định an toàn -- [custom-providers.md](custom-providers.md) — mẫu tích hợp provider / base URL tùy chỉnh -- [zai-glm-setup.md](zai-glm-setup.md) — thiết lập Z.AI/GLM và ma trận endpoint -- [langgraph-integration.md](langgraph-integration.md) — tích hợp dự phòng cho model/tool-calling -- [operations-runbook.md](operations-runbook.md) — vận hành runtime hàng ngày và quy trình rollback -- [troubleshooting.md](troubleshooting.md) — dấu hiệu lỗi thường gặp và cách khắc phục - -### Người đóng góp / Bảo trì - -- [../../CONTRIBUTING.md](../../CONTRIBUTING.md) -- [pr-workflow.md](pr-workflow.md) -- [reviewer-playbook.md](reviewer-playbook.md) -- [ci-map.md](ci-map.md) -- [actions-source-policy.md](actions-source-policy.md) - -### Bảo mật / Độ tin cậy - -> Lưu ý: Mục này gồm tài liệu đề xuất/lộ trình, có thể chứa lệnh hoặc cấu hình chưa triển khai. Để biết hành vi thực tế, xem [config-reference.md](config-reference.md), [operations-runbook.md](operations-runbook.md) và [troubleshooting.md](troubleshooting.md) trước. - -- [security/README.md](security/README.md) -- [agnostic-security.md](agnostic-security.md) -- [frictionless-security.md](frictionless-security.md) -- [sandboxing.md](sandboxing.md) -- [audit-logging.md](audit-logging.md) -- [resource-limits.md](resource-limits.md) -- [security-roadmap.md](security-roadmap.md) - -## Quản lý tài liệu - -- Mục lục thống nhất (TOC): [SUMMARY.md](SUMMARY.md) -- Danh mục và phân loại tài liệu: [../docs-inventory.md](../docs-inventory.md) - -## Ngôn ngữ khác - -- English: [../README.md](../README.md) -- 简体中文: [../README.zh-CN.md](../README.zh-CN.md) -- 日本語: [../README.ja.md](../README.ja.md) -- Русский: [../README.ru.md](../README.ru.md) +- 简体中文: [../i18n/zh-CN/README.md](../i18n/zh-CN/README.md) +- 日本語: [../i18n/ja/README.md](../i18n/ja/README.md) +- Русский: [../i18n/ru/README.md](../i18n/ru/README.md) +- Français: [../i18n/fr/README.md](../i18n/fr/README.md) +- Ελληνικά: [../i18n/el/README.md](../i18n/el/README.md) diff --git a/docs/vi/datasheets/README.md b/docs/vi/datasheets/README.md new file mode 100644 index 000000000..161e6c9a5 --- /dev/null +++ b/docs/vi/datasheets/README.md @@ -0,0 +1,7 @@ +# Vietnamese Datasheets Compatibility Index + +This compatibility path redirects to canonical Vietnamese datasheets: + +- [../../i18n/vi/datasheets/README.md](../../i18n/vi/datasheets/README.md) + +For new edits, use `docs/i18n/vi/datasheets/**`. diff --git a/docs/vi/hardware/README.md b/docs/vi/hardware/README.md index 683cc13a8..43ec7d256 100644 --- a/docs/vi/hardware/README.md +++ b/docs/vi/hardware/README.md @@ -13,7 +13,7 @@ Hệ thống phần cứng của ZeroClaw cho phép điều khiển trực tiế ## Datasheet -- Chỉ mục datasheet: [../datasheets](../datasheets) +- Chỉ mục datasheet: [../datasheets/README.md](../datasheets/README.md) - STM32 Nucleo-F401RE: [../datasheets/nucleo-f401re.md](../datasheets/nucleo-f401re.md) - Arduino Uno: [../datasheets/arduino-uno.md](../datasheets/arduino-uno.md) - ESP32: [../datasheets/esp32.md](../datasheets/esp32.md) diff --git a/docs/vi/reference/README.md b/docs/vi/reference/README.md index 56550409d..22f544e6d 100644 --- a/docs/vi/reference/README.md +++ b/docs/vi/reference/README.md @@ -1,22 +1,10 @@ -# Danh mục tham chiếu +# Vietnamese Reference Compatibility Index -Tra cứu lệnh, provider, channel, config và tích hợp. +This compatibility path redirects to the canonical Vietnamese reference index: -## Tham chiếu cốt lõi +- [../../i18n/vi/reference/README.md](../../i18n/vi/reference/README.md) -- Lệnh theo workflow: [../commands-reference.md](../commands-reference.md) -- ID provider / alias / biến môi trường: [../providers-reference.md](../providers-reference.md) -- Thiết lập channel + allowlist: [../channels-reference.md](../channels-reference.md) -- Giá trị mặc định và khóa config: [../config-reference.md](../config-reference.md) +Related canonical Vietnamese indexes: -## Mở rộng provider và tích hợp - -- Endpoint provider tùy chỉnh: [../custom-providers.md](../custom-providers.md) -- Tích hợp provider Z.AI / GLM: [../zai-glm-setup.md](../zai-glm-setup.md) -- Các mẫu tích hợp dựa trên LangGraph: [../langgraph-integration.md](../langgraph-integration.md) - -## Cách dùng - -Sử dụng bộ sưu tập này khi bạn cần chi tiết CLI/config chính xác hoặc các mẫu tích hợp provider thay vì hướng dẫn từng bước. - -Khi thêm tài liệu tham chiếu/tích hợp mới, hãy đảm bảo nó được liên kết trong cả [../SUMMARY.md](../SUMMARY.md) và [../../docs-inventory.md](../../docs-inventory.md). +- Hub: [../../i18n/vi/README.md](../../i18n/vi/README.md) +- TOC: [../../i18n/vi/SUMMARY.md](../../i18n/vi/SUMMARY.md)