docs: rescan rebased documentation hierarchy

This commit is contained in:
Turtle
2026-08-05 12:46:38 +08:00
parent 012bb0a549
commit 8af3babaea
304 changed files with 1091 additions and 1983 deletions

View File

@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/sdk/README.md
README.md: 0dcf3655fc4d20452981f83000f9b9b586ede17b
README.zh.md: cc5927f56654ece0caef7d329798e581b3217eeb
README.md: 3f99d6d45ddc64ac068457b0d03e533d21451a5f
README.zh.md: 003383c5f6238b37893927813959d52d96350c3e

View File

@@ -2,18 +2,15 @@
[English](README.md) | 中文
用于创建、编辑、构建和运行 DeepSeek Harness 项目的开发者工具,外加从另一进程驱动 harness 运行时的客户端 SDK 栈。
[功能 Agent Note](../../.agents/notes/proposed/feature/2026-07-14-sdk-developer-projects.md)负责开发者工作流;[架构 Agent Note](../../.agents/notes/proposed/architecture/2026-07-15-sdk-project-editing-architecture.md)负责包与项目编辑边界;[TypeScript SDK Agent Note](../../.agents/notes/implemented/feature/2026-07-27-typescript-sdk-and-sdk-subagent-backend.md)负责客户端 SDK 栈。
本分组包含 Harness 项目的开发者工具,以及从另一进程驱动 Harness 运行时的客户端栈。
| 包 | 职责 |
|---|---|
| [`helper`](helper/README.md) | 项目聚合、编辑会话、内置功能、项目文档、模板、包管理器与提示词抽象 |
| [`scripts`](scripts/README.md) | `dsh-sdk` 启动器:`start``dev``build` 和交互式 `config` |
| [`create-sdk`](create-sdk/README.md) | `npm create @deepseek-ai/sdk` 初始化器 |
| [`sdk-protocol`](sdk-protocol/README.md) | 共享的 SDK 运行时通信协议:以换行符分隔的 JSON-RPC 传输 + 具名请求/通知类型 |
| [`sdk-client`](sdk-client/README.md) | TypeScript 客户端 SDK通过 stdio JSON-RPC 驱动 harness 运行时子进程Python SDK 的设计孪生) |
| [`helper/`](helper/README.md) | 提供共享的项目编辑领域 |
| [`scripts/`](scripts/README.md) | 提供 `dsh-sdk` 项目命令 |
| [`create-sdk/`](create-sdk/README.md) | 创建新的 SDK 项目 |
| [`sdk-protocol/`](sdk-protocol/README.md) | 定义 SDK 运行时协议格式 |
| [`sdk-client/`](sdk-client/README.md) | 通过 TypeScript 客户端 API 驱动 Harness 运行时 |
| [`telemetry/`](telemetry/README.md) | 提供启动器遥测、同意和脱敏原语 |
`@deepseek-ai/create-sdk` 仓库 `@deepseek-ai/dsh-*` 命名规则的唯一例外npm 的 scoped initializer 约定要求使用该名称,才能支持 `npm create @deepseek-ai/sdk`
生成的项目始终以 `cordis.yml` 作为唯一运行时插件树。`dsh-sdk dev` 只是围绕同一文件增加 TypeScript 与本地工作区解析,不会创建仅供开发环境使用的配置。
`@deepseek-ai/create-sdk` 遵循 npm 的 scoped initializer 命名约定;其他包遵循仓库 `@deepseek-ai/dsh-*` 约定。参见[开发者项目工作流](../../.agents/notes/proposed/feature/2026-07-14-sdk-developer-projects.md)、[项目编辑架构](../../.agents/notes/proposed/architecture/2026-07-15-sdk-project-editing-architecture.md)和 [TypeScript SDK 设计](../../.agents/notes/implemented/feature/2026-07-27-typescript-sdk-and-sdk-subagent-backend.md)。

View File

@@ -90,7 +90,7 @@ export class ProjectEditSession implements FeatureProjectView {
this.profile = source.profile
this.documents = source.cloneDocuments()
for (const feature of registry.all()) {
/* v8 ignore next -- no current builtin is interface-specific after TUI removal */
/* v8 ignore next -- no current built-in feature is interface-specific */
if (!feature.isApplicable(this.profile)) continue
const installation = feature.inspect(this)
this.states.set(feature.id, {
@@ -508,7 +508,7 @@ export class ProjectEditSession implements FeatureProjectView {
const view = this.projectView(profile)
for (const feature of this.registry.all()) {
const state = this.states.get(feature.id)
/* v8 ignore next 5 -- no current builtin is interface-specific after TUI removal */
/* v8 ignore next 5 -- no current built-in feature is interface-specific */
if (!feature.isApplicable(profile)) {
if (state?.state === 'enabled') {
throw new Error(`feature ${feature.id} is not available for ${profile.runInterface}`)

View File

@@ -135,7 +135,7 @@ export class ConfigWorkflow {
runInterface: targetRunInterface(project.profile.runInterface, desiredByTarget),
}
for (const feature of features) {
/* v8 ignore next -- no current builtin is interface-specific after TUI removal */
/* v8 ignore next -- no current built-in feature is interface-specific */
if (!feature.isApplicable(targetProfile)) desiredByTarget.delete(featureTarget(feature))
}

View File

@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/sdk/sdk-client/README.md
README.md: eb0387292fb0093b3ed9360e8aec087201b611f0
README.zh.md: c264557984f5067d65e7fc60c7afd855dcf26715
README.md: 5bce396aa36d32b0a3bd7716e1feea8ca9c9038c
README.zh.md: cf72caa669d05358c989be4ed3f084541615052f