Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 0 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,8 +30,6 @@ This repository owns WorkDSH Web and Desktop. The Desktop product runs an unmodi

- `deepseek-harness/` is a pinned upstream Git submodule. Never edit files inside it from a desktop feature branch.
- `dsh-plugin-desktop/` owns the Electron carrier, packaging, and release tests. DSH Host and Client code comes from the pinned upstream runtime Profile; WorkDSH features belong to the WorkDSH Profile packages.
- `dsh-community-fabric/` owns the community interoperability RFC. Until schemas and a reviewed reference adapter exist, it remains a private documentation scaffold and must not declare loadable DSH or package entry points.
- `dsh-community-market/` owns the community-market shell. Until its runtime is implemented, it remains a private documentation scaffold and must not declare loadable DSH or package entry points.
- The Desktop workspace uses the root Yarn release with `nodeLinker: node-modules`. The nested `workdsh-web/` workspace retains its own pinned pnpm lockfile and package manager; run its commands from that directory. Do not install it into the root Yarn workspace.
- The upstream submodule keeps its own pnpm workspace. Run upstream commands through the root `upstream:*` scripts, whose Yarn portable-shell commands enter the submodule before invoking Corepack.
- Keep presentation and WorkDSH feature changes in the Profile rather than adding a second Desktop Host or Client implementation.
Expand Down
4 changes: 1 addition & 3 deletions CONTRIBUTING.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,6 @@ DSH is built around plugins. If you write plugins, start with:

- [Plugin development](docs/plugin-development.en.md): how to write ordinary DSH plugins and Desktop plugins.
- [DSH plugin ecosystem manifesto](docs/plugin-ecosystem.en.md): our vision of an open, composable, sustainable ecosystem, and the three principles — composition first, declare clearly, compatibility first.
- [DSH Community Fabric Draft](dsh-community-fabric/README.md): join the public discussion of manifests, capabilities, Host Descriptors, and event contracts.
- [Community Market design](dsh-community-market/docs/market-shell.md): how the future market will discover plugins and why listing is not a security review.

Plugins that follow the manifesto coexist better with other plugins and will be easier to discover and trust in the marketplace when it ships.

Expand All @@ -35,7 +33,7 @@ corepack yarn dev # launch the application when a graphical session is avail
### Repository boundaries (please read before starting)

- `deepseek-harness/` is the pinned upstream submodule. **Desktop development never edits files inside it**; upstream updates land through separate pin commits.
- Desktop code lives in `dsh-plugin-desktop/`; `dsh-community-fabric/` owns the community-standard Draft and `dsh-community-market/` owns the market-shell design. Both community packages are currently documentation-only and not loadable; all three owned packages share the outer Yarn workspace.
- Desktop code lives in `dsh-plugin-desktop/`, and WorkDSH feature packages live in `workdsh-web/`. The former uses the root Yarn workspace; the latter retains its own pnpm workspace. The pinned upstream `deepseek-harness/` is a Git submodule.
- Builds, typechecks, unit tests, and smoke checks must stay headless-safe.

### Commits and pull requests
Expand Down
4 changes: 1 addition & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,6 @@ DSH 的核心是插件。如果你写插件,请先阅读:

- [插件开发](docs/plugin-development.md):如何编写普通 DSH 插件和 Desktop 插件。
- [DSH 插件生态倡议书](docs/plugin-ecosystem.md):开放、可组合、可持续的生态愿景,以及组合优先、声明清晰、兼容优先三条原则。
- [DSH Community Fabric Draft](dsh-community-fabric/README.zh.md):参与 Manifest、Capability、Host Descriptor 和事件 contract 的公开讨论。
- [Community Market 设计](dsh-community-market/docs/market-shell.zh.md):未来市场如何发现插件,以及为什么收录不等于安全审核。

遵循倡议书的插件更容易与其他插件共存,也会在未来上线时更容易在插件市场中被发现和信任。

Expand All @@ -35,7 +33,7 @@ corepack yarn dev # 有图形环境时启动应用
### 仓库边界(开始前务必了解)

- `deepseek-harness/` 是固定版本的上游子模块,**桌面开发不修改其中的任何文件**;上游内容更新走独立的 pin 提交。
- 桌面代码位于 `dsh-plugin-desktop/`;`dsh-community-fabric/` 保存社区标准 Draft,`dsh-community-market/` 保存市场壳设计。两个社区 package 当前都只有文档、尚不可加载,三个自有 package 共用外层 Yarn workspace。
- 桌面代码位于 `dsh-plugin-desktop/`,WorkDSH 功能包位于 `workdsh-web/`;前者使用根目录 Yarn 工作区,后者保留独立 pnpm 工作区。上游 `deepseek-harness/` 是固定版本的 Git 子模块。
- 构建、类型检查、单元测试和冒烟检查必须保持 headless-safe。

### 提交与 PR
Expand Down
4 changes: 2 additions & 2 deletions README.i18n.yaml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Bilingual-pair consistency record: the git blob hash of each side as of the last
# confirmed-consistent state. Both languages carry equal authority. Update both files
# and re-record their hashes after editing either side.
README.md: edf952a3df8b27368ad5d342f51ca0e085f3f102
README.zh-CN.md: eb5a612277377505c32107e520e4ca46ec276037
README.md: 0d11f05e25608c5c34d30eb0b95d4e3212393f14
README.zh-CN.md: 6d7025fa93be348b50387f5ebb1606c465e5bab4
2 changes: 1 addition & 1 deletion docs/README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,6 @@ Start with the [user guide](user-guide.en.md) for installation and use. The [FAQ

Developers can read the [architecture](architecture.en.md), [Desktop ownership boundaries](desktop-boundaries.md), [plugin development](plugin-development.en.md), and [package build guide](../dsh-plugin-desktop/README.md). `deepseek-harness/` is the pinned, unmodified official upstream submodule. WorkDSH feature packages are composed by the runtime Profile.

The [Community Fabric draft](../dsh-community-fabric/README.md) and [Community Market draft](../dsh-community-market/README.md) currently contain design documents only; they do not imply runtime entry points in installers. The [plugin ecosystem manifesto](plugin-ecosystem.en.md) describes the longer-term direction.
The [plugin ecosystem manifesto](plugin-ecosystem.en.md) describes the longer-term direction; there is currently no separate community standard or online market runtime package.

The root [`README.md`](../README.md) is the default English product entry point, with [`README.zh-CN.md`](../README.zh-CN.md) as its Chinese counterpart. Each `.i18n.yaml` records the Git blob hashes of its bilingual documents; update both languages and the record together.
2 changes: 1 addition & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,6 @@

开发者可阅读[架构说明](architecture.md)、[Desktop 归属约束](desktop-boundaries.md)、[插件开发](plugin-development.md)和[包级构建说明](../dsh-plugin-desktop/README.zh.md)。`deepseek-harness/` 是固定版本且不修改的官方上游子模块;WorkDSH 的功能包由运行时 Profile 组合。

[社区 Fabric 草案](../dsh-community-fabric/README.zh.md)与[社区 Market 草案](../dsh-community-market/README.zh.md)目前只包含设计文档,不代表安装包已提供这些运行时入口。[插件生态倡议书](plugin-ecosystem.md)描述长期方向。
[插件生态倡议书](plugin-ecosystem.md)描述长期方向;当前没有独立的社区标准或在线市场运行包。

根目录的 [`README.md`](../README.md) 是默认英文产品入口,[`README.zh-CN.md`](../README.zh-CN.md) 是中文入口。各 `.i18n.yaml` 记录相应双语文件的 Git blob hash,修改文档时应同步更新两种语言和记录。
9 changes: 3 additions & 6 deletions docs/plugin-ecosystem.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,17 +30,14 @@ This manifesto is not a unilateral rulebook. It is a **living document**: it fol

Once the plugin marketplace ships, plugins that follow this manifesto will be easier to discover, install, and trust. We want convention-driven development to be the beneficial choice for every author, not an extra burden.

## From a manifesto to a testable contract
## Current boundary

[DSH Community Fabric](../dsh-community-fabric/README.md) is turning this vision into a public Draft for manifests, capabilities, Host Descriptors, and events. It currently contains documentation only, not a released standard or runtime; plugins still use existing DSH and Cordis APIs today.
Plugins currently use the published DSH/Cordis APIs. Any future shared manifest or catalog should first be validated against real plugins, compatibility tests, and user needs. Capability declarations can help with compatibility, consent, and audit, but cannot present in-process JavaScript as a security sandbox. Only a Host with evidence of real isolation may claim technical permission enforcement.

Fabric capabilities begin as compatibility, consent, and audit declarations. They do not present in-process JavaScript as a security sandbox. Only a Host with evidence of real isolation may claim technical permission enforcement.

The market is still in its [product and safety design phase](../dsh-community-market/README.md), with no usable page or installer yet. Catalog inclusion means that a project matched catalog rules; it is not a security review or endorsement.
There is no online market page or installer today. Future catalog inclusion would mean that a project met catalog rules, not that it passed a security review or received an endorsement.

## How to participate

- Learn how plugins are written in [plugin development](plugin-development.en.md).
- Read and comment on [Community Fabric RFC 0001](../dsh-community-fabric/docs/rfcs/0001-plugin-manifest-capabilities-events.md).
- Learn how to install and manage plugins in the [user guide](user-guide.en.md).
- Share your thoughts on this manifesto through issues and discussions.
9 changes: 3 additions & 6 deletions docs/plugin-ecosystem.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,17 +30,14 @@ WorkDSH Desktop 使用 Electron 承载固定版本的官方 DSH 运行时。桌

插件市场上线后,符合本倡议的插件将更容易被发现、安装和信任。我们希望让"按规范开发"成为对每个作者都有利的选择,而不是额外的负担。

## 从倡议走向可测试的 contract
## 当前边界

[DSH Community Fabric](../dsh-community-fabric/README.zh.md) 正在把这份愿景整理成可公开讨论的 Manifest、Capability、Host Descriptor 与事件 Draft。它目前只有文档,不是已经发布的标准或运行时;当前插件仍使用现有 DSH/Cordis 接口。
当前插件使用 DSH/Cordis 已发布的公开接口。未来若建立统一的插件声明或目录,应先以真实插件、兼容测试和用户需求验证;能力声明可辅助兼容判断、用户确认与审计,但不能把同进程 JavaScript 描述成安全沙箱。只有具备真实隔离证据的 Host 才能声称权限被技术强制执行。

Fabric 的 capability 首先用于兼容判断、用户确认和审计,不会把同进程 JavaScript 伪装成安全沙箱。只有具备真实隔离证据的 Host 才能声称权限被技术强制执行。

市场目前仍处于[产品与安全设计阶段](../dsh-community-market/README.zh.md),尚未提供可用页面或安装器。目录收录只代表符合目录规则,不等于安全审核或推荐。
目前没有在线市场页面或安装器。未来的目录收录只代表满足目录规则,不等于安全审核或推荐。

## 如何参与

- 在[插件开发](plugin-development.md)中了解插件如何编写。
- 阅读并评论 [Community Fabric RFC 0001](../dsh-community-fabric/docs/rfcs/0001-plugin-manifest-capabilities-events.zh.md)。
- 在[用户指南](user-guide.md)中了解如何安装和管理插件。
- 通过 issue 和讨论区提出你对本倡议的意见。
21 changes: 0 additions & 21 deletions dsh-community-fabric/LICENSE

This file was deleted.

4 changes: 0 additions & 4 deletions dsh-community-fabric/README.i18n.yaml

This file was deleted.

63 changes: 0 additions & 63 deletions dsh-community-fabric/README.md

This file was deleted.

Loading
Loading