# @anonyjcy/dsh-j-space 中文文档 规范地址：https://npmcn.com/package/%40anonyjcy/dsh-j-space/ 版本：1\.2\.5 npm 元数据更新时间：2026-10-28T00:31:18.561Z 中文译文更新时间：2026-11-08T07:23:42.451Z 软件包许可：\(MIT AND Apache-2\.0\) 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40anonyjcy/dsh-j-space 原文对照：https://npmcn.com/package/%40anonyjcy/dsh-j-space/?lang=original 项目主页：https://github.com/AnonyJcy/dsh-j-space#readme 源码仓库：https://github.com/AnonyJcy/dsh-j-space ## 关键信息（来自 npm 元数据） - 包体积（解压后）：653 kB，47 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：0 个 - peer 依赖：@deepseek-ai/cordis \>=4\.0\.2 \<5 \|\| ~4\.0\.5-alpha\.1 \|\| ~4\.0\.6-alpha\.1 - 首次发布：2026-09-20T14:26:09.241Z - 最新版本发布：2026-10-28T00:31:18.376Z - 近 30 天下载量：1873（2026-10-06 至 2026-11-04，npm 官方下载统计） - 已发布版本数：8（近 12 个月 8 个） ## 中文简介 用于 DeepSeek Harness 的 J- Space 认知套件 SV1 本地代理预设和独立插件 ## 安装 ```sh npm install @anonyjcy/dsh-j-space ``` 也可以使用：`pnpm add @anonyjcy/dsh-j-space`、`yarn add @anonyjcy/dsh-j-space`、`bun add @anonyjcy/dsh-j-space` ## README # dsh-j-space [![DSH Market 收录](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-zh.svg)](https://dsh.market/?q=AnonyJcy%2Fdsh-j-space) [![npm](https://img.shields.io/npm/v/@anonyjcy/dsh-j-space.svg?color=blue)](https://www.npmjs.com/package/@anonyjcy/dsh-j-space) [![license](https://img.shields.io/badge/license-MIT%20%2B%20Apache--2.0-green.svg)](https://npmcn.com/package/%40anonyjcy/dsh-j-space/NOTICE.md) **简体中文** | [English](https://npmcn.com/package/%40anonyjcy/dsh-j-space/README.en.md) 在 DeepSeek Harness 中使用 [J-Space Cognition Suite](https://github.com/Tiger3807861189/J-Space-Cognition-Suite)。安装后，新建会话时选择 **J-Space Cognition Suite** 预设即可。 J-Space 提供一套拆解问题、分析仓库、记录任务进度和检查结果的方法。这个项目把它接入 DSH，保留原版的认知模块、控制器和工作区账本。模型、工具和权限沿用 DSH 的配置；需要多智能体协作时，使用 DSH 官方的「智能体团队」。 J-Space 本身由上游项目维护，这个仓库负责 DSH 适配。 ## 安装 1.2.5 的验证环境是 **DSH 0.2.1-rc.4 / Cordis 4.0.5**，另外在 `0.2.1-rc.3` 和 `0.2.2-alpha.2`（Cordis `4.0.6-alpha.1`）上验证过安装和预设加载。下面固定使用 rc.4 这个版本，不依赖 npm 标签的指向；`next` 标签现在也指向它，而 `latest` 仍是较早的 `0.2.1-rc.2`。更旧的 `0.2.0-rc.2` 缺少本预设需要的定时工具，不能完整加载，请先升级。 ```bash # 已使用对应 DSH 版本时，可以跳过这一条 npm install -g @deepseek-ai/dsh@0.2.1-rc.4 dsh plugin --profile web add @anonyjcy/dsh-j-space@1.2.5 ``` 已有 DSH 部署时，请在启动该部署的安装环境中升级，并先备份自定义配置。使用自定义 profile 的话，把 `web` 换成实际名称。 安装后重启 DSH Web，新建会话，在 **Agent Preset** 中选择 **J-Space Cognition Suite**。只在普通项目里安装 npm 包，不会把预设注册到 DSH；也不用再运行旧版 `install` 命令。 使用原版控制器或校验脚本需要 **Python 3.10+**。 从本地仓库安装 ```bash git clone https://github.com/AnonyJcy/dsh-j-space.git cd dsh-j-space dsh plugin --profile web add "$PWD" ``` DSH 通过 [bundle 配置](https://npmcn.com/package/%40anonyjcy/dsh-j-space/cordis.patch.yml) 注册预设，技能直接读取包内的 [技能目录](https://npmcn.com/package/%40anonyjcy/dsh-j-space/preset/skills/j-space/)，不用手动复制。 ## 和官方智能体团队一起使用 需要团队功能时，在同一个 profile 安装官方插件： ```bash dsh plugin --profile web add @deepseek-ai/dsh-experimental-agent-team-profile@0.2.1-rc.4 ``` 创建成员、发消息、分配任务和管理成员生命周期，都交给官方插件。J-Space 预设不再单独注册 `subagent`、`fork` 和成员控制工具，也不会自动启用团队；只有用户明确要求时才创建团队。不装团队插件，也可以单智能体使用。 原版 [orchestration 模块](https://npmcn.com/package/%40anonyjcy/dsh-j-space/preset/skills/j-space/modules/orchestration.md) 仍然保留。它记录参与者的工作和验收依据，不是另一套团队管理器：成员各自读取源文件、二次考量和独立验收的要求没有删除。控制器里的 `agent add` / `retire` 也只是记账，不会创建或停止 DSH 成员。 `workflow` 继续用于用户明确要求的批量编排，其中的子任务不算官方团队成员。具体对应关系见 [DSH 适配说明](https://npmcn.com/package/%40anonyjcy/dsh-j-space/preset/skills/j-space/integration/dsh.md)。 ## 从旧版升级 在同一个 profile 更新包，重启 DSH Web，再新建会话。 如果曾在 Web 编辑器中保存过 J-Space 的插件配置，请先备份，再重置该预设的覆盖配置，或手动移除旧的 `tool-subagent*`、Ralph 配置。否则，即使包已经更新，会话仍可能沿用旧的工具列表。官方团队层应放在 base / web 层之后加载。 已有的 `.jspace/control.json` 和任务记录不用删除。 [旧版 CLI](https://npmcn.com/package/%40anonyjcy/dsh-j-space/bin/cli.js) 仍随包保留，但只管理 `$DSH_HOME/.agent-presets/j-space` 中的文件副本。它的 `status` / `verify` 不能判断当前 DSH 是否已经注册预设；请以新建会话菜单为准。旧的独立 Cordis 部署插件也是文件复制用途，不是新版的注册方式。 版本变更见 [更新日志](https://npmcn.com/package/%40anonyjcy/dsh-j-space/CHANGELOG.md)。 ## 原版内容与校验 当前使用上游 SV1 的固定提交 [b2023124](https://github.com/Tiger3807861189/J-Space-Cognition-Suite/tree/b2023124a1fa08278e3ee82aefa8ed9faeade995)。13 个模块、7 个参考文档，以及原版控制器、示例和完整重读流程都保留。 26 个原版技能文件中，25 个逐字节不变；只有 [技能入口](https://npmcn.com/package/%40anonyjcy/dsh-j-space/preset/skills/j-space/SKILL.md) 加入了一段可移除的 DSH 说明，另附一份 [适配说明](https://npmcn.com/package/%40anonyjcy/dsh-j-space/preset/skills/j-space/integration/dsh.md)。原文和校验信息保存在 [压缩归档](https://npmcn.com/package/%40anonyjcy/dsh-j-space/vendor/j-space/canonical.tar.gz) 与 [清单](https://npmcn.com/package/%40anonyjcy/dsh-j-space/vendor/j-space/manifest.json) 中。 这里的压缩用于保存和还原源文件，不会减少解压后送给模型的 token，也不会用摘要代替原文。原版的重复提示和定期完整重读方式没有改。 在已安装包的根目录运行以下命令，可以校验文件或还原归档： ```bash python3 -B tools/upstream_integrity.py verify --runtime preset/skills/j-space --adapters vendor/j-space/adapters.json # 输出目录必须尚不存在 python3 -B tools/upstream_integrity.py expand --output /tmp/j-space-original-restored ``` 控制器仍需要智能体按协议调用；安装预设不会自动装上宿主事件拦截器。 ## 开发与测试 下面的命令在完整仓库中执行。npm 包包含运行文件和 [校验工具](https://npmcn.com/package/%40anonyjcy/dsh-j-space/tools/upstream_integrity.py)，不包含本仓库的开发测试脚本。 ```bash pnpm install pnpm run typecheck pnpm test pnpm run test:controller pnpm run test:integrity pnpm run test:lossless pnpm run test:upstream ``` 另行安装隔离的 DSH 宿主后，可以检查官方配置和真实安装流程： ```bash pnpm run test:host /path/to/isolated-host/node_modules 0.2.1-rc.4 pnpm run test:install /path/to/isolated-host/node_modules /absolute/plugin.tgz 0.2.1-rc.4 ``` 安装测试只创建新的临时 profile，不会修改正在使用的配置。1.2.5 已在 rc.3、rc.4 和 `0.2.2-alpha.2` 上验证原生安装、预设与技能加载，以及官方团队开关两种配置；没有做模型 A/B、真实团队对话、浏览器操作或定时投递测试。 ## 相关评测 上游作者发布了 [GLM-5.3-Flash 报告](https://github.com/Tiger3807861189/GLM-5.3-Flash-J-Space-Capability-Realization-Report) 和 [DeepSeek-V4 报告](https://github.com/Tiger3807861189/DeepSeek-V4-J-Space-Capability-Realization-Report)。这些是上游实验，不是这份 DSH 适配的实测成绩；本项目没有复现其中的性能或 token 收益。 ## 许可证 DSH 包装代码使用 [MIT](https://npmcn.com/package/%40anonyjcy/dsh-j-space/LICENSE)；上游编写的 J-Space 代码和文本使用 [Apache-2.0](https://npmcn.com/package/%40anonyjcy/dsh-j-space/vendor/j-space/LICENSE)。第三方引文和轨迹片段不包含在上述授权中，仍适用各自的权利与条款。来源和具体范围见 [NOTICE](https://npmcn.com/package/%40anonyjcy/dsh-j-space/NOTICE.md) 及 [上游第三方声明](https://npmcn.com/package/%40anonyjcy/dsh-j-space/vendor/j-space/THIRD_PARTY_NOTICES.md)。 ## 常见问题 ### @anonyjcy/dsh-j-space 是什么？ 用于 DeepSeek Harness 的 J- Space 认知套件 SV1 本地代理预设和独立插件 ### 如何安装 @anonyjcy/dsh-j-space？ 在项目目录运行 npm install @anonyjcy/dsh-j-space，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（\>=4\.0\.2 \<5 \|\| ~4\.0\.5-alpha\.1 \|\| ~4\.0\.6-alpha\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 dsh-j-space，可以用 npx dsh-j-space 直接运行。 ### @anonyjcy/dsh-j-space 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @anonyjcy/dsh-j-space 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @anonyjcy/dsh-j-space 可以商用吗？ @anonyjcy/dsh-j-space 使用 \(MIT AND Apache-2\.0\) 许可。声明的许可为 \(MIT AND Apache-2\.0\)，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。 ### @anonyjcy/dsh-j-space 的下载量有多少？ 根据 npm 官方下载统计，@anonyjcy/dsh-j-space 在 2026/10/06 – 2026/11/04 这 30 天内被下载 1,873 次，日均约 62 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @anonyjcy/dsh-j-space 还在维护吗？ 最新版本 1\.2\.5 发布于 2026/10/28（11 天前）；至今共发布 8 个版本，其中过去 12 个月发布了 8 个；首次发布于 2026/09/20。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。