Configuration reference

Option	Default	Meaning
`owner`	token's user	User or organization that owns the repository.
`repo`	`dsh-artifacts`	Repository that hosts artifacts.
`repository`	none	The shared repository as `owner/name` or a remote URL (`https://github.com/owner/name.git`, `git@github.com:owner/name.git`); overrides `owner`/`repo` for it. A repository linked at runtime overrides this.
`repoStrategy`	`shared`	`shared` (one repository) or `per-artifact` (a new repository for each new artifact). A runtime choice overrides this.
`repoPrefix`	`artifact-`	Name prefix of repositories the per-artifact strategy creates.
`repoVisibility`	`public`	Visibility of repositories the per-artifact strategy creates. Pages on private repositories needs a paid plan; the pages are public either way.
`registryDir`	`$DSH_HOME/gh-pages-artifacts`	Folder for the local registry and its `index.html`.
`branch`	`gh-pages`	Branch Pages publishes from. Created on first publish when missing.
`siteDir`	`''`	Pages source folder: `''` (root) or `docs`.
`pathPrefix`	`''`	Folder under the site root for artifacts, e.g. `a` → `/a//`.
`baseUrl`	from the Pages API	Public site URL. Set it for custom domains when the token lacks Pages read, and on GitHub Enterprise Server (required there unless the token can read Pages).
`tokenEnv`	`GH_PAGES_TOKEN`	Credential reference (environment variable name) holding the token.
`apiBaseUrl`	`https://api.github.com`	REST API base; change it only for GitHub Enterprise Server.
`approval`	`unless-full-access`	`unless-full-access`: ask before publish and delete, except in Full access sessions (danger-full-access sandbox with approval prompts turned off). `always`: always ask. `off`: never ask.
`hideFromPresets`	`['minimal']`	Agent modes that don't get the artifact tools.
`subagentAccess`	`read-only`	Delegated subagents: `read-only` (list, read, status), `full`, or `none`.
`noindex`	`true`	Add `` to pages, even if the page asks to be indexed.
`csp`	`object-src 'none'; base-uri 'none'`	Content-Security-Policy meta tag added to pages; `''` disables it.
`blockSecrets`	`true`	Refuse hidden and credential files (`.env`, keys, `.ssh/`, ...) and any title, description, page, or asset that looks like a credential (GitHub/AWS/Slack/npm/API keys, JWTs, private keys, passwords in URLs or assignments, the configured token in any common encoding).
`maxPublishBytes`	`10485760`	Maximum total bytes of one publish (page plus assets).
`commitAuthor`	token's user	`{ name, email }` used as commit author and committer.
`promptGuidance`	`true`	Add the short system-prompt section.
`bundledSkill`	`true`	Register the `artifact-pages` skill.

dsh-gh-pages-artifacts

安装

说明文档

Configuration reference