mirror of https://github.com/deepseek-ai/deepseek-harness synced 2026-08-15 21:04:50 +00:00

Files

Yichen Jiang b0a2011d95 docs: bilingual credentials/settings-consumer documentation, catalogs, and gates

New credentials data-structure page (type-equiv manifested), group README,
rewritten llm-deepseek/llm-pi-ai READMEs (dynamic configuration, dict
profiles, credential chain), capability-seams/service-role registration,
Agent Note (bilingual), demo compositions mounting settings-local +
credentials-local with no inline key plumbing, installSettingsSection
consumer helper on the settings seam (deduplicating both adapters' wiring),
jscpd symmetry markers for the provider twins, runtime-closure additions for
python/sdk-runtime, and doc-budget ceilings AGENTS.md 1750→1755 /
packages/README.md 850→865 for the structural one-line group rows.

2026-07-29 14:20:06 +08:00

4.4 KiB

Raw Blame History

Headless Agent App Composition

The headless demo combines the real DeepSeek adapter and coding capabilities with the one-shot app package, format-pure stdout, and one fresh persisted top-level session.

flowchart LR
  cfg["examples/headless-agent<br/>cordis.yml"]
  plugin_headless_settings["settings<br/>@deepseek-ai/dsh-settings-local"]
  cfg --> plugin_headless_settings
  plugin_headless_credentials["credentials<br/>@deepseek-ai/dsh-credentials-local"]
  cfg --> plugin_headless_credentials
  plugin_headless_llm_deepseek["llm-deepseek<br/>@deepseek-ai/dsh-llm-deepseek"]
  cfg --> plugin_headless_llm_deepseek
  plugin_headless_subprocess["subprocess<br/>@deepseek-ai/dsh-subprocess-local"]
  cfg --> plugin_headless_subprocess
  plugin_headless_bash["bash<br/>@deepseek-ai/dsh-bash-local"]
  cfg --> plugin_headless_bash
  plugin_headless_cli_agent["cli-agent<br/>@deepseek-ai/dsh-cli-demo"]
  cfg --> plugin_headless_cli_agent
  plugin_headless_cli_agent --> bundle_agent_core["@deepseek-ai/dsh-agent-spine-demo"]
  plugin_headless_cli_agent --> bundle_jsonl["@deepseek-ai/dsh-session-persistence-jsonl"]
  plugin_headless_cli_agent --> frontdoor_cli["one-shot driver<br/>format-pure stdout<br/>fresh top-level agent"]
  bundle_agent_core --> spine_llm["ctx.llm"]
  bundle_agent_core --> spine_sessions["ctx.sessions"]
  bundle_agent_core --> spine_tools["ctx.tools + tool-bash"]
  bundle_agent_core --> spine_loop["ctx.agents + ctx.agentLoop"]
  plugin_headless_token_meter["token-meter<br/>@deepseek-ai/dsh-token-meter"]
  cfg --> plugin_headless_token_meter
  plugin_headless_compact_basic["compact-basic<br/>@deepseek-ai/dsh-compact-basic"]
  cfg --> plugin_headless_compact_basic
  plugin_headless_subagent["subagent<br/>@deepseek-ai/dsh-subagent"]
  cfg --> plugin_headless_subagent
  plugin_headless_subagent_spawn["subagent-spawn<br/>@deepseek-ai/dsh-subagent-spawn"]
  cfg --> plugin_headless_subagent_spawn
  plugin_headless_subagent_fork["subagent-fork<br/>@deepseek-ai/dsh-subagent-fork"]
  cfg --> plugin_headless_subagent_fork
  plugin_headless_tool_subagent["tool-subagent<br/>@deepseek-ai/dsh-tool-subagent"]
  cfg --> plugin_headless_tool_subagent
  plugin_headless_tool_subagent_fork["tool-subagent-fork<br/>@deepseek-ai/dsh-tool-subagent"]
  cfg --> plugin_headless_tool_subagent_fork
  plugin_headless_workflow_workerthread["workflow-workerthread<br/>@deepseek-ai/dsh-workflow-workerthread"]
  cfg --> plugin_headless_workflow_workerthread
  plugin_headless_tool_workflow["tool-workflow<br/>@deepseek-ai/dsh-tool-workflow"]
  cfg --> plugin_headless_tool_workflow
  plugin_headless_tool_ralph["tool-ralph<br/>@deepseek-ai/dsh-tool-ralph"]
  cfg --> plugin_headless_tool_ralph
  plugin_headless_tool_todo["tool-todo<br/>@deepseek-ai/dsh-tool-todo"]
  cfg --> plugin_headless_tool_todo
  plugin_headless_fs_local["fs-local<br/>@deepseek-ai/dsh-fs-local"]
  cfg --> plugin_headless_fs_local
  plugin_headless_fs_policy["fs-policy<br/>@deepseek-ai/dsh-fs-policy"]
  cfg --> plugin_headless_fs_policy
  plugin_headless_tool_fs["tool-fs<br/>@deepseek-ai/dsh-tool-fs"]
  cfg --> plugin_headless_tool_fs

Plugin id	Package / module
`settings`	`@deepseek-ai/dsh-settings-local`
`credentials`	`@deepseek-ai/dsh-credentials-local`
`llm-deepseek`	`@deepseek-ai/dsh-llm-deepseek`
`subprocess`	`@deepseek-ai/dsh-subprocess-local`
`bash`	`@deepseek-ai/dsh-bash-local`
`cli-agent`	`@deepseek-ai/dsh-cli-demo`
`token-meter`	`@deepseek-ai/dsh-token-meter`
`compact-basic`	`@deepseek-ai/dsh-compact-basic`
`subagent`	`@deepseek-ai/dsh-subagent`
`subagent-spawn`	`@deepseek-ai/dsh-subagent-spawn`
`subagent-fork`	`@deepseek-ai/dsh-subagent-fork`
`tool-subagent`	`@deepseek-ai/dsh-tool-subagent`
`tool-subagent-fork`	`@deepseek-ai/dsh-tool-subagent`
`workflow-workerthread`	`@deepseek-ai/dsh-workflow-workerthread`
`tool-workflow`	`@deepseek-ai/dsh-tool-workflow`
`tool-ralph`	`@deepseek-ai/dsh-tool-ralph`
`tool-todo`	`@deepseek-ai/dsh-tool-todo`
`fs-local`	`@deepseek-ai/dsh-fs-local`
`fs-policy`	`@deepseek-ai/dsh-fs-policy`
`tool-fs`	`@deepseek-ai/dsh-tool-fs`

Source config: examples/headless-agent/cordis.yml.

Maintenance mode: hybrid: the leaf plugin list is parsed from its cordis.yml; app package expansion is curated from package source.

4.4 KiB Raw Blame History

Headless Agent App Composition

4.4 KiB

Raw Blame History