mirror of https://github.com/deepseek-ai/deepseek-harness.git synced 2026-09-28 13:12:59 +08:00

Files

T

History

Turtle e7def469e1 feat(i18n): key translation pairing records by heading section (#5036 )

* feat(i18n): key translation pairing records by heading section

Replace the whole-file blob hashes in *.i18n.yaml with one entry per
heading section that still holds language-specific content, keyed by the
English heading-slug path. Blocks identical across the pair (generated
table rows, code blocks, shared regions) stay out of the hash, so edits to
different sections and identical regenerations merge with Git's default
text merge, including on GitHub.

Remove the dsh-translation-pairing merge driver, its resolver command and
installer wiring; gen-translation-brief recovers last-confirmed text from
commit history. Migrate all active records, archive the superseded Agent
Note, and record the replayed conflict reduction in the new one.

* test(i18n): refresh translation prompt snapshot for the terminology note

* feat(i18n): exclude only code blocks and generated regions from pairing records

Replace byte-equality masking with an explicit rule: a record hash skips
fenced code blocks and BEGIN/END GENERATED regions, the two kinds of
content the pairing gate already requires to be identical on both sides.

Move generated data into regions written into both pages:
gen-config-catalog renders both languages and the record with per-package
regions labelled by code identifiers; gen-module-graph keeps its table in a
region; gen-doc-graphs splices the event matrix regions into the Chinese
page. Add a generic region splice beside the region grammar.

2026-09-23 22:32:06 +08:00

minimal.py

refactor(repo): retire top-level examples

2026-08-24 22:02:44 +08:00

README.i18n.yaml

feat(i18n): key translation pairing records by heading section (#5036 )

2026-09-23 22:32:06 +08:00

README.md

feat(minimal): remove str_replace_editor from minimal profiles

2026-09-03 16:03:59 +08:00

README.zh.md

docs(i18n): fix targeted README review findings

2026-09-10 03:04:19 +08:00

README.md

Python SDK example

English | 中文

Runnable Python SDK example over the sole application launcher, dsh --profile sdk-minimal. The Python client owns JSON-RPC stdio; the profile owns the agent composition, persistence, execution policy, and plugins.

Run the minimal agent

Install deepseek-harness-sdk, export a model credential, then supply an isolated Harness home and workspace:

export DEEPSEEK_API_KEY=sk-your-key-here
python python/sdk/examples/minimal.py \
  --dsh-home /absolute/path/to/example-dsh-home \
  --workspace /absolute/path/to/disposable-workspace \
  --session-id example-001 \
  "Inspect the repository and fix the failing tests."

Set DEEPSEEK_BASE_URL for a compatible proxy, DSH_MODEL for the script's default model, or DSH_SYSTEM_PROMPT for the deployment persona. --model is the single runtime model selection; no matching environment variable is required. --profile can select another SDK-serving profile. The selected home stores the generated sdk-minimal profile and uncompressed JSONL session logs under sessions/; the script never reads ~/.dsh implicitly.

The shipped @deepseek-ai/dsh-sdk-minimal bundle is the complete explicit Cordis tree for this mode. It exposes exactly:

owner-scoped persistent bash on Linux/macOS or pwsh on Windows

The bundle does not include dsh-base, so every additional row is an explicit profile change. Runtime context, filesystem tools, local instruction discovery, compaction, settings, managed credentials, telemetry, Web tools, subagents, and the full default tool roster are absent. The tree retains SDK startup and JSON-RPC serving, one environment-configured DeepSeek adapter, local execution, and JSONL persistence.

The persistent PTY can modify any path available to the runtime process, so use a disposable checkout or container.

Add plugins

Use the runtime wheel's dsh command against the same explicit home for persistent profile changes:

export DSH_HOME=/absolute/path/to/example-dsh-home
dsh plugin --profile sdk-minimal add file:/absolute/path/to/my-plugin-bundle

Use sdk-minimal in that command to extend this example, or sdk to extend the full base-backed SDK profile. The Python call can also pass additional absolute patch paths in patches=(...); later files win. A selected profile must retain @deepseek-ai/dsh-sdk-app or another JSON-RPC server row. The example accepts no complete Cordis file or arbitrary process argv.

The same runtime wheel packages the web profile and its frontend assets for direct CLI use: dsh web starts that separate application. A Python SDK client cannot select web because it has no JSON-RPC server row.

See the Python SDK tutorial and SDK reference.